Port bevy_gltf to pipelined-rendering (#2537)

# Objective

Port bevy_gltf to the pipelined-rendering branch.

## Solution

crates/bevy_gltf has been copied and pasted into pipelined/bevy_gltf2 and modifications were made to work with the pipelined-rendering branch. Notably vertex tangents and vertex colours are not supported.

Cargo.toml

@@ -25,7 +25,7 @@ default = [
  "bevy_core_pipeline",
  "bevy_dynamic_plugin",
  "bevy_gilrs",
- "bevy_gltf",
+ "bevy_gltf2",
  "bevy_wgpu",
  "bevy_sprite2",
  "bevy_render2",
@@ -56,6 +56,7 @@ bevy_core_pipeline = ["bevy_internal/bevy_core_pipeline"]
 bevy_render2 = ["bevy_internal/bevy_render2"]
 bevy_sprite2 = ["bevy_internal/bevy_sprite2"]
 bevy_pbr2 = ["bevy_internal/bevy_pbr2"]
+bevy_gltf2 = ["bevy_internal/bevy_gltf2"]
 
 trace_chrome = ["bevy_internal/trace_chrome"]
 trace = ["bevy_internal/trace"]
@@ -156,6 +157,10 @@ path = "examples/3d/cornell_box_pipelined.rs"
 name = "load_gltf"
 path = "examples/3d/load_gltf.rs"
 
+[[example]]
+name = "load_gltf_pipelined"
+path = "examples/3d/load_gltf_pipelined.rs"
+
 [[example]]
 name = "msaa"
 path = "examples/3d/msaa.rs"

crates/bevy_internal/Cargo.toml

@@ -68,6 +68,7 @@ bevy_tasks = { path = "../bevy_tasks", version = "0.5.0" }
 bevy_audio = { path = "../bevy_audio", optional = true, version = "0.5.0" }
 bevy_core_pipeline = { path = "../../pipelined/bevy_core_pipeline", optional = true, version = "0.5.0" }
 bevy_gltf = { path = "../bevy_gltf", optional = true, version = "0.5.0" }
+bevy_gltf2 = { path = "../../pipelined/bevy_gltf2", optional = true, version = "0.5.0" }
 bevy_pbr = { path = "../bevy_pbr", optional = true, version = "0.5.0" }
 bevy_pbr2 = { path = "../../pipelined/bevy_pbr2", optional = true, version = "0.5.0" }
 bevy_render = { path = "../bevy_render", optional = true, version = "0.5.0" }

crates/bevy_internal/src/default_plugins.rs

@@ -117,6 +117,7 @@ impl PluginGroup for PipelinedDefaultPlugins {
  group.add(bevy_input::InputPlugin::default());
  group.add(bevy_window::WindowPlugin::default());
  group.add(bevy_asset::AssetPlugin::default());
+ group.add(bevy_scene::ScenePlugin::default());
 
  #[cfg(feature = "bevy_render2")]
  {
@@ -132,6 +133,9 @@ impl PluginGroup for PipelinedDefaultPlugins {
 
  #[cfg(feature = "bevy_pbr2")]
  group.add(bevy_pbr2::PbrPlugin::default());
+
+ #[cfg(feature = "bevy_gltf2")]
+ group.add(bevy_gltf2::GltfPlugin::default());
  }
 
  #[cfg(feature = "bevy_winit")]

crates/bevy_internal/src/lib.rs

@@ -99,6 +99,12 @@ pub mod gltf {
  pub use bevy_gltf::*;
 }
 
+#[cfg(feature = "bevy_gltf2")]
+pub mod gltf2 {
+ //! Support for GLTF file loading.
+ pub use bevy_gltf2::*;
+}
+
 #[cfg(feature = "bevy_pbr")]
 pub mod pbr {
  //! Physically based rendering.

examples/3d/load_gltf_pipelined.rs

@@ -0,0 +1,62 @@
+use bevy::{
+ core::Time,
+ ecs::prelude::*,
+ math::{EulerRot, Quat, Vec3},
+ pbr2::{AmbientLight, DirectionalLight, DirectionalLightBundle},
+ prelude::{App, AssetServer, SpawnSceneCommands, Transform},
+ render2::{
+ camera::{OrthographicProjection, PerspectiveCameraBundle},
+ color::Color,
+ },
+ PipelinedDefaultPlugins,
+};
+
+fn main() {
+ App::new()
+ .insert_resource(AmbientLight {
+ color: Color::WHITE,
+ brightness: 1.0 / 5.0f32,
+ })
+ .add_plugins(PipelinedDefaultPlugins)
+ .add_startup_system(setup.system())
+ .add_system(animate_light_direction.system())
+ .run();
+}
+
+fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
+ commands.spawn_scene(asset_server.load("models/FlightHelmet/FlightHelmet.gltf#Scene0"));
+ commands.spawn_bundle(PerspectiveCameraBundle {
+ transform: Transform::from_xyz(0.7, 0.7, 1.0).looking_at(Vec3::new(0.0, 0.3, 0.0), Vec3::Y),
+ ..Default::default()
+ });
+ const HALF_SIZE: f32 = 1.0;
+ commands.spawn_bundle(DirectionalLightBundle {
+ directional_light: DirectionalLight {
+ shadow_projection: OrthographicProjection {
+ left: -HALF_SIZE,
+ right: HALF_SIZE,
+ bottom: -HALF_SIZE,
+ top: HALF_SIZE,
+ near: -10.0 * HALF_SIZE,
+ far: 10.0 * HALF_SIZE,
+ ..Default::default()
+ },
+ ..Default::default()
+ },
+ ..Default::default()
+ });
+}
+
+fn animate_light_direction(
+ time: Res<Time>,
+ mut query: Query<&mut Transform, With<DirectionalLight>>,
+) {
+ for mut transform in query.iter_mut() {
+ transform.rotation = Quat::from_euler(
+ EulerRot::ZYX,
+ 0.0,
+ time.seconds_since_startup() as f32 * std::f32::consts::TAU / 10.0,
+ -std::f32::consts::FRAC_PI_4,
+ );
+ }
+}

examples/README.md

@@ -99,6 +99,7 @@ Example | File | Description
 `3d_scene_pipelined` | [`3d/3d_scene_pipelined.rs`](./3d/3d_scene_pipelined.rs) | Simple 3D scene with basic shapes and lighting
 `cornell_box_pipelined` | [`3d/cornell_box_pipelined.rs`](./3d/cornell_box_pipelined.rs) | Re-production of the cornell box
 `load_gltf` | [`3d/load_gltf.rs`](./3d/load_gltf.rs) | Loads and renders a gltf file as a scene
+`load_gltf_pipelined` | [`3d/load_gltf_pipelined.rs`](./3d/load_gltf_pipelined.rs) | Loads and renders a gltf file as a scene
 `msaa` | [`3d/msaa.rs`](./3d/msaa.rs) | Configures MSAA (Multi-Sample Anti-Aliasing) for smoother edges
 `orthographic` | [`3d/orthographic.rs`](./3d/orthographic.rs) | Shows how to create a 3D orthographic view (for isometric-look games or CAD applications)
 `parenting` | [`3d/parenting.rs`](./3d/parenting.rs) | Demonstrates parent->child relationships and relative transformations

pipelined/bevy_gltf2/Cargo.toml

@@ -0,0 +1,35 @@
+[package]
+name = "bevy_gltf2"
+version = "0.5.0"
+edition = "2018"
+authors = [
+ "Bevy Contributors <[email protected]>",
+ "Carter Anderson <[email protected]>",
+]
+description = "Bevy Engine GLTF loading"
+homepage = "https://bevyengine.org"
+repository = "https:/bevyengine/bevy"
+license = "MIT OR Apache-2.0"
+keywords = ["bevy"]
+
+[dependencies]
+# bevy
+bevy_app = { path = "../../crates/bevy_app", version = "0.5.0" }
+bevy_asset = { path = "../../crates/bevy_asset", version = "0.5.0" }
+bevy_core = { path = "../../crates/bevy_core", version = "0.5.0" }
+bevy_ecs = { path = "../../crates/bevy_ecs", version = "0.5.0" }
+bevy_pbr2 = { path = "../bevy_pbr2", version = "0.5.0" }
+bevy_reflect = { path = "../../crates/bevy_reflect", version = "0.5.0", features = ["bevy"] }
+bevy_render2 = { path = "../bevy_render2", version = "0.5.0" }
+bevy_transform = { path = "../../crates/bevy_transform", version = "0.5.0" }
+bevy_math = { path = "../../crates/bevy_math", version = "0.5.0" }
+bevy_scene = { path = "../../crates/bevy_scene", version = "0.5.0" }
+bevy_log = { path = "../../crates/bevy_log", version = "0.5.0" }
+
+# other
+gltf = { version = "0.16.0", default-features = false, features = ["utils", "names", "KHR_materials_unlit"] }
+thiserror = "1.0"
+anyhow = "1.0.4"
+base64 = "0.13.0"
+percent-encoding = "2.1"
+wgpu = "0.9"

pipelined/bevy_gltf2/src/lib.rs

@@ -0,0 +1,60 @@
+use std::collections::HashMap;
+
+mod loader;
+pub use loader::*;
+
+use bevy_app::prelude::*;
+use bevy_asset::{AddAsset, Handle};
+use bevy_pbr2::StandardMaterial;
+use bevy_reflect::TypeUuid;
+use bevy_render2::mesh::Mesh;
+use bevy_scene::Scene;
+
+/// Adds support for GLTF file loading to Apps
+#[derive(Default)]
+pub struct GltfPlugin;
+
+impl Plugin for GltfPlugin {
+ fn build(&self, app: &mut App) {
+ app.init_asset_loader::<GltfLoader>()
+ .add_asset::<Gltf>()
+ .add_asset::<GltfNode>()
+ .add_asset::<GltfPrimitive>()
+ .add_asset::<GltfMesh>();
+ }
+}
+
+#[derive(Debug, TypeUuid)]
+#[uuid = "5c7d5f8a-f7b0-4e45-a09e-406c0372fea2"]
+pub struct Gltf {
+ pub scenes: Vec<Handle<Scene>>,
+ pub named_scenes: HashMap<String, Handle<Scene>>,
+ pub meshes: Vec<Handle<GltfMesh>>,
+ pub named_meshes: HashMap<String, Handle<GltfMesh>>,
+ pub materials: Vec<Handle<StandardMaterial>>,
+ pub named_materials: HashMap<String, Handle<StandardMaterial>>,
+ pub nodes: Vec<Handle<GltfNode>>,
+ pub named_nodes: HashMap<String, Handle<GltfNode>>,
+ pub default_scene: Option<Handle<Scene>>,
+}
+
+#[derive(Debug, Clone, TypeUuid)]
+#[uuid = "dad74750-1fd6-460f-ac51-0a7937563865"]
+pub struct GltfNode {
+ pub children: Vec<GltfNode>,
+ pub mesh: Option<Handle<GltfMesh>>,
+ pub transform: bevy_transform::prelude::Transform,
+}
+
+#[derive(Debug, Clone, TypeUuid)]
+#[uuid = "8ceaec9a-926a-4f29-8ee3-578a69f42315"]
+pub struct GltfMesh {
+ pub primitives: Vec<GltfPrimitive>,
+}
+
+#[derive(Debug, Clone, TypeUuid)]
+#[uuid = "cbfca302-82fd-41cb-af77-cab6b3d50af1"]
+pub struct GltfPrimitive {
+ pub mesh: Handle<Mesh>,
+ pub material: Option<Handle<StandardMaterial>>,
+}