59 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			59 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
| //! This example illustrates how to react to component change.
 | |
| 
 | |
| use bevy::{ecs::world::Ref, prelude::*};
 | |
| use rand::Rng;
 | |
| 
 | |
| fn main() {
 | |
|     App::new()
 | |
|         .add_plugins(DefaultPlugins)
 | |
|         .add_systems(Startup, setup)
 | |
|         .add_systems(
 | |
|             Update,
 | |
|             (change_component, change_detection, tracker_monitoring),
 | |
|         )
 | |
|         .run();
 | |
| }
 | |
| 
 | |
| #[derive(Component, PartialEq, Debug)]
 | |
| struct MyComponent(f32);
 | |
| 
 | |
| fn setup(mut commands: Commands) {
 | |
|     commands.spawn(MyComponent(0.));
 | |
|     commands.spawn(Transform::IDENTITY);
 | |
| }
 | |
| 
 | |
| fn change_component(time: Res<Time>, mut query: Query<(Entity, &mut MyComponent)>) {
 | |
|     for (entity, mut component) in &mut query {
 | |
|         if rand::thread_rng().gen_bool(0.1) {
 | |
|             info!("changing component {:?}", entity);
 | |
|             let new_component = MyComponent(time.elapsed_seconds().round());
 | |
|             // Change detection occurs on mutable dereference,
 | |
|             // and does not consider whether or not a value is actually equal.
 | |
|             // To avoid triggering change detection when nothing has actually changed,
 | |
|             // you can use the `set_if_neq` method on any component or resource that implements PartialEq
 | |
|             component.set_if_neq(new_component);
 | |
|         }
 | |
|     }
 | |
| }
 | |
| 
 | |
| // There are query filters for `Changed<T>` and `Added<T>`
 | |
| // Only entities matching the filters will be in the query
 | |
| fn change_detection(query: Query<(Entity, &MyComponent), Changed<MyComponent>>) {
 | |
|     for (entity, component) in &query {
 | |
|         info!("{:?} changed: {:?}", entity, component,);
 | |
|     }
 | |
| }
 | |
| 
 | |
| // By using `Ref`, the query is not filtered but the information is available
 | |
| fn tracker_monitoring(query: Query<(Entity, Ref<MyComponent>)>) {
 | |
|     for (entity, component) in &query {
 | |
|         info!(
 | |
|             "{:?}: {:?} -> {{is_added: {}, is_changed: {}}}",
 | |
|             entity,
 | |
|             component,
 | |
|             component.is_added(),
 | |
|             component.is_changed()
 | |
|         );
 | |
|     }
 | |
| }
 | 
