mirror of
https://github.com/bevyengine/bevy.git
synced 2026-05-06 06:06:42 -04:00
Carter Anderson
535cf401cc
Part 2 of #23619 In **Bevy 0.19** we are landing a subset of Bevy's Next Generation Scene system (often known as BSN), which now lives in the `bevy_scene` / `bevy::scene` crate. However the old `bevy_scene` system still needs to stick around for a bit longer, as it provides some features that Bevy's Next Generation Scene system doesn't (yet!): 1. It is not _yet_ possible to write a World _to_ BSN, so the old system is still necessary for "round trip World serialization". 2. The GLTF scene loader has not yet been ported to BSN, so the old system is still necessary to spawn GLTF scenes in Bevy. For this reason, we have renamed the old `bevy_scene` crate to `bevy_world_serialization`. If you were referencing `bevy_scene::*` or `bevy::scene::*` types, rename those paths to `bevy_world_serialization::*` and `bevy::world_serialization::*` respectively. Additionally, to avoid confusion / conflicts with the new scene system, all "scene" terminology / types have been reframed as "world serialization": - `Scene` -> `WorldAsset` (as this was always just a World wrapper) - `SceneRoot` -> `WorldAssetRoot` - `DynamicScene` -> `DynamicWorld` - `DynamicScene::from_scene` -> `DynamicWorld::from_world_asset` - `DynamicSceneBuilder` -> `DynamicWorldBuilder` - `DynamicSceneRoot` -> `DynamicWorldRoot` - `SceneInstanceReady` -> `WorldInstanceReady` - `SceneLoader` -> `WorldAssetLoader` - `ScenePlugin` -> `WorldSerializationPlugin` - `SceneRootTemplate` -> `WorldAssetRootTemplate` - `SceneSpawner` -> `WorldInstanceSpawner` - `SceneFilter` -> `WorldFilter` - `SceneLoaderError` -> `WorldAssetLoaderError` - `SceneSpawnError` -> `WorldInstanceSpawnError` Note that I went with `bevy_world_serialization` over `bevy_ecs_serialization`, as that is what all of the internal features described themselves as. I think it is both more specific and does a better job of making itself decoupled from `bevy_ecs` proper.
72 lines
2.5 KiB
Rust
72 lines
2.5 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::*;
|
|
|
|
use bevy::{math::ops, mesh::skinning::SkinnedMesh, prelude::*};
|
|
|
|
fn main() {
|
|
App::new()
|
|
.add_plugins(DefaultPlugins)
|
|
.insert_resource(GlobalAmbientLight {
|
|
brightness: 750.0,
|
|
..default()
|
|
})
|
|
.add_systems(Startup, setup)
|
|
.add_systems(Update, joint_animation)
|
|
.run();
|
|
}
|
|
|
|
fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
|
|
// Create a camera
|
|
commands.spawn((
|
|
Camera3d::default(),
|
|
Transform::from_xyz(-2.0, 2.5, 5.0).looking_at(Vec3::new(0.0, 1.0, 0.0), Vec3::Y),
|
|
));
|
|
|
|
// Spawn the first scene in `models/SimpleSkin/SimpleSkin.gltf`
|
|
commands.spawn(WorldAssetRoot(asset_server.load(
|
|
GltfAssetLabel::Scene(0).from_asset("models/SimpleSkin/SimpleSkin.gltf"),
|
|
)));
|
|
}
|
|
|
|
/// The scene hierarchy currently looks somewhat like this:
|
|
///
|
|
/// ```text
|
|
/// <Parent entity>
|
|
/// + Mesh node (without `Mesh3d` or `SkinnedMesh` component)
|
|
/// + Skinned mesh entity (with `Mesh3d` 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>,
|
|
children: Query<&ChildOf, With<SkinnedMesh>>,
|
|
parents: Query<&Children>,
|
|
mut transform_query: Query<&mut Transform>,
|
|
) {
|
|
// Iter skinned mesh entity
|
|
for child_of in &children {
|
|
// Mesh node is the parent of the skinned mesh entity.
|
|
let mesh_node_entity = child_of.parent();
|
|
// Get `Children` in the mesh node.
|
|
let mesh_node_parent = parents.get(mesh_node_entity).unwrap();
|
|
|
|
// First joint is the second child of the mesh node.
|
|
let first_joint_entity = mesh_node_parent[1];
|
|
// Get `Children` in the first joint.
|
|
let first_joint_children = parents.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_rotation_z(FRAC_PI_2 * ops::sin(time.elapsed_secs()));
|
|
}
|
|
}
|