 8eb0440f1e
			
		
	
	
		8eb0440f1e
		
	
	
	
	
		
			
			## Objective Implement absolute minimum viable product for the changes proposed in bevyengine/rfcs#53. ## Solution - Remove public mutative access to `Parent` (Children is already publicly read-only). This includes public construction methods like `Copy`, `Clone`, and `Default`. - Remove `PreviousParent` - Remove `parent_update_system` - Update all hierarchy related commands to immediately update both `Parent` and `Children` references. ## Remaining TODOs - [ ] Update documentation for both `Parent` and `Children`. Discourage using `EntityCommands::remove` - [x] Add `HierarchyEvent` to notify listeners of hierarchy updates. This is meant to replace listening on `PreviousParent` ## Followup - These changes should be best moved to the hooks mentioned in #3742. - Backing storage for both might be best moved to indexes mentioned in the same relations.
		
			
				
	
	
		
			75 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			75 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
| //! Skinned mesh example with mesh and joints data loaded from a glTF file.
 | |
| //! Example taken from <https://github.com/KhronosGroup/glTF-Tutorials/blob/master/gltfTutorial/gltfTutorial_019_SimpleSkin.md>
 | |
| 
 | |
| use std::f32::consts::PI;
 | |
| 
 | |
| use bevy::{pbr::AmbientLight, prelude::*, render::mesh::skinning::SkinnedMesh};
 | |
| 
 | |
| fn main() {
 | |
|     App::new()
 | |
|         .add_plugins(DefaultPlugins)
 | |
|         .insert_resource(AmbientLight {
 | |
|             brightness: 1.0,
 | |
|             ..default()
 | |
|         })
 | |
|         .add_startup_system(setup)
 | |
|         .add_system(joint_animation)
 | |
|         .run();
 | |
| }
 | |
| 
 | |
| fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
 | |
|     // Create a camera
 | |
|     commands.spawn_bundle(Camera3dBundle {
 | |
|         transform: Transform::from_xyz(-2.0, 2.5, 5.0).looking_at(Vec3::ZERO, Vec3::Y),
 | |
|         ..default()
 | |
|     });
 | |
| 
 | |
|     // Spawn the first scene in `models/SimpleSkin/SimpleSkin.gltf`
 | |
|     commands.spawn_bundle(SceneBundle {
 | |
|         scene: asset_server.load("models/SimpleSkin/SimpleSkin.gltf#Scene0"),
 | |
|         ..default()
 | |
|     });
 | |
| }
 | |
| 
 | |
| /// The scene hierarchy currently looks somewhat like this:
 | |
| ///
 | |
| /// ```ignore
 | |
| /// <Parent entity>
 | |
| ///   + Mesh node (without `PbrBundle` or `SkinnedMesh` component)
 | |
| ///     + Skinned mesh entity (with `PbrBundle` and `SkinnedMesh` component, created by glTF loader)
 | |
| ///     + First joint
 | |
| ///       + Second joint
 | |
| /// ```
 | |
| ///
 | |
| /// In this example, we want to get and animate the second joint.
 | |
| /// It is similar to the animation defined in `models/SimpleSkin/SimpleSkin.gltf`.
 | |
| fn joint_animation(
 | |
|     time: Res<Time>,
 | |
|     parent_query: Query<&Parent, With<SkinnedMesh>>,
 | |
|     children_query: Query<&Children>,
 | |
|     mut transform_query: Query<&mut Transform>,
 | |
| ) {
 | |
|     // Iter skinned mesh entity
 | |
|     for skinned_mesh_parent in parent_query.iter() {
 | |
|         // Mesh node is the parent of the skinned mesh entity.
 | |
|         let mesh_node_entity = skinned_mesh_parent.get();
 | |
|         // Get `Children` in the mesh node.
 | |
|         let mesh_node_children = children_query.get(mesh_node_entity).unwrap();
 | |
| 
 | |
|         // First joint is the second child of the mesh node.
 | |
|         let first_joint_entity = mesh_node_children[1];
 | |
|         // Get `Children` in the first joint.
 | |
|         let first_joint_children = children_query.get(first_joint_entity).unwrap();
 | |
| 
 | |
|         // Second joint is the first child of the first joint.
 | |
|         let second_joint_entity = first_joint_children[0];
 | |
|         // Get `Transform` in the second joint.
 | |
|         let mut second_joint_transform = transform_query.get_mut(second_joint_entity).unwrap();
 | |
| 
 | |
|         second_joint_transform.rotation = Quat::from_axis_angle(
 | |
|             Vec3::Z,
 | |
|             0.5 * PI * time.time_since_startup().as_secs_f32().sin(),
 | |
|         );
 | |
|     }
 | |
| }
 |