beet_core 0.0.8

Core utilities and types for other beet crates
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use crate::prelude::*;
use bevy::ecs::query::QueryData;
use bevy::ecs::query::QueryFilter;
use bevy::ecs::system::SystemParam;
use bevy::prelude::*;


/// Utilities for working with ancestors
#[derive(SystemParam)]
pub struct AncestorQuery<
	'w,
	's,
	D: 'static + QueryData,
	F: 'static + QueryFilter = (),
> {
	commands: Commands<'w, 's>,
	query: Query<'w, 's, D, F>,
	ancestors: Query<'w, 's, &'static ChildOf>,
}

impl<'w, 's, D: 'static + QueryData, F: 'static + QueryFilter>
	AncestorQuery<'w, 's, D, F>
{
	/// Get the first ancestor of the given entity that matches the query,
	/// inclusive of the given entity.
	pub fn get(
		&self,
		entity: Entity,
	) -> Result<<<D as QueryData>::ReadOnly as QueryData>::Item<'_, '_>> {
		for entity in self.ancestors.iter_ancestors_inclusive(entity) {
			if let Ok(entity_data) = self.query.get(entity) {
				return Ok(entity_data);
			}
		}
		bevybail!("No ancestor found matching query for entity {:?}", entity);
	}
	/// Get the first ancestor of the given entity that matches the query,
	/// inclusive of the given entity.
	pub fn get_mut<'a>(
		&'a mut self,
		entity: Entity,
	) -> Result<<D as QueryData>::Item<'a, 's>>
	where
		'w: 'a,
	{
		// First find the matching entity without borrowing mutably
		let matching_entity = self
			.ancestors
			.iter_ancestors_inclusive(entity)
			.find(|&e| self.query.get(e).is_ok());

		if let Some(e) = matching_entity {
			// Now get mutable access to the found entity
			return self.query.get_mut(e).map_err(|e| e.into());
		}
		bevybail!("No ancestor found matching query for entity {:?}", entity);
	}

	/// Get the first ancestor of the given entity that matches the query,
	/// exclusive of the given entity.
	pub fn get_exclusive(
		&self,
		entity: Entity,
	) -> Result<<<D as QueryData>::ReadOnly as QueryData>::Item<'_, '_>> {
		for entity in self.ancestors.iter_ancestors(entity) {
			if let Ok(entity_data) = self.query.get(entity) {
				return Ok(entity_data);
			}
		}
		bevybail!("No ancestor found matching query for entity {:?}", entity);
	}

	/// Get the first ancestor of the given entity that matches the query,
	/// exclusive of the given entity.
	pub fn get_mut_exclusive<'a>(
		&'a mut self,
		entity: Entity,
	) -> Result<<D as QueryData>::Item<'a, 's>>
	where
		'w: 'a,
	{
		// First find the matching entity without borrowing mutably
		let matching_entity = self
			.ancestors
			.iter_ancestors(entity)
			.find(|&e| self.query.get(e).is_ok());

		if let Some(e) = matching_entity {
			// Now get mutable access to the found entity
			return self.query.get_mut(e).map_err(|e| e.into());
		}
		bevybail!("No ancestor found matching query for entity {:?}", entity);
	}

	/// insert into the root ancestor
	pub fn insert(
		&mut self,
		entity: Entity,
		component: impl Bundle,
	) -> Result<()>
	where
		'w: 's,
	{
		let root = self.ancestors.root_ancestor(entity);
		self.commands.entity(root).insert(component);
		Ok(())
	}
}