Enum bevy::gltf::GltfAssetLabel

pub enum GltfAssetLabel {
    Scene(usize),
    Node(usize),
    Mesh(usize),
    Primitive {
        mesh: usize,
        primitive: usize,
    },
    MorphTarget {
        mesh: usize,
        primitive: usize,
    },
    Texture(usize),
    Material {
        index: usize,
        is_scale_inverted: bool,
    },
    DefaultMaterial,
    Animation(usize),
    Skin(usize),
}

Labels that can be used to load part of a glTF

You can use GltfAssetLabel::from_asset to add it to an asset path

fn load_gltf_scene(asset_server: Res<AssetServer>) {
    let gltf_scene: Handle<Scene> = asset_server.load(GltfAssetLabel::Scene(0).from_asset("models/FlightHelmet/FlightHelmet.gltf"));
}

Or when formatting a string for the path

fn load_gltf_scene(asset_server: Res<AssetServer>) {
    let gltf_scene: Handle<Scene> = asset_server.load(format!("models/FlightHelmet/FlightHelmet.gltf#{}", GltfAssetLabel::Scene(0)));
}

Variants

Scene(usize)

Scene{}: glTF Scene as a Bevy Scene

Node(usize)

Node{}: glTF Node as a GltfNode

Mesh(usize)

Mesh{}: glTF Mesh as a GltfMesh

Primitive

Mesh{}/Primitive{}: glTF Primitive as a Bevy Mesh

Fields

mesh: usize

Index of the mesh for this primitive

primitive: usize

Index of this primitive in its parent mesh

MorphTarget

Mesh{}/Primitive{}/MorphTargets: Morph target animation data for a glTF Primitive

Fields

mesh: usize

Index of the mesh for this primitive

primitive: usize

Index of this primitive in its parent mesh

Texture(usize)

Texture{}: glTF Texture as a Bevy Image

Material

Material{}: glTF Material as a Bevy StandardMaterial

Fields

index: usize

Index of this material

is_scale_inverted: bool

Used to set the Face of the material, useful if it is used with negative scale

DefaultMaterial

DefaultMaterial: as above, if the glTF file contains a default material with no index

Animation(usize)

Animation{}: glTF Animation as Bevy AnimationClip

Skin(usize)

Skin{}: glTF mesh skin as Bevy SkinnedMeshInverseBindposes

Implementations

impl GltfAssetLabel

pub fn from_asset( &self, path: impl Into<AssetPath<'static>>, ) -> AssetPath<'static>

Add this label to an asset path

fn load_gltf_scene(asset_server: Res<AssetServer>) {
    let gltf_scene: Handle<Scene> = asset_server.load(GltfAssetLabel::Scene(0).from_asset("models/FlightHelmet/FlightHelmet.gltf"));
}

Examples found in repository

examples/3d/reflection_probes.rs (line 101)

fn spawn_scene(commands: &mut Commands, asset_server: &AssetServer) {
    commands.spawn(SceneBundle {
        scene: asset_server.load(GltfAssetLabel::Scene(0).from_asset("models/cubes/Cubes.glb")),
        ..SceneBundle::default()
    });
}

examples/3d/lightmaps.rs (line 18)

fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
    commands.spawn(SceneBundle {
        scene: asset_server
            .load(GltfAssetLabel::Scene(0).from_asset("models/CornellBox/CornellBox.glb")),
        ..default()
    });

    commands.spawn(Camera3dBundle {
        transform: Transform::from_xyz(-278.0, 273.0, 800.0),
        ..default()
    });
}

examples/3d/clearcoat.rs (line 153)

fn spawn_golf_ball(commands: &mut Commands, asset_server: &AssetServer) {
    commands
        .spawn(SceneBundle {
            scene: asset_server
                .load(GltfAssetLabel::Scene(0).from_asset("models/GolfBall/GolfBall.glb")),
            transform: Transform::from_xyz(1.0, 1.0, 0.0).with_scale(Vec3::splat(SPHERE_SCALE)),
            ..default()
        })
        .insert(ExampleSphere);
}

examples/3d/ssr.rs (line 168)

fn spawn_flight_helmet(commands: &mut Commands, asset_server: &AssetServer) {
    commands
        .spawn(SceneBundle {
            scene: asset_server
                .load(GltfAssetLabel::Scene(0).from_asset("models/FlightHelmet/FlightHelmet.gltf")),
            transform: Transform::from_scale(Vec3::splat(2.5)),
            ..default()
        })
        .insert(FlightHelmetModel)
        .insert(Visibility::Hidden);
}

examples/animation/gltf_skinned_mesh.rs (line 31)

fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
    // Create a camera
    commands.spawn(Camera3dBundle {
        transform: Transform::from_xyz(-2.0, 2.5, 5.0)
            .looking_at(Vec3::new(0.0, 1.0, 0.0), Vec3::Y),
        ..default()
    });

    // Spawn the first scene in `models/SimpleSkin/SimpleSkin.gltf`
    commands.spawn(SceneBundle {
        scene: asset_server
            .load(GltfAssetLabel::Scene(0).from_asset("models/SimpleSkin/SimpleSkin.gltf")),
        ..default()
    });
}

examples/2d/custom_gltf_vertex_attribute.rs (line 50)

fn setup(
    mut commands: Commands,
    asset_server: Res<AssetServer>,
    mut materials: ResMut<Assets<CustomMaterial>>,
) {
    // Add a mesh loaded from a glTF file. This mesh has data for `ATTRIBUTE_BARYCENTRIC`.
    let mesh = asset_server.load(
        GltfAssetLabel::Primitive {
            mesh: 0,
            primitive: 0,
        }
        .from_asset("models/barycentric/barycentric.gltf"),
    );
    commands.spawn(MaterialMesh2dBundle {
        mesh: Mesh2dHandle(mesh),
        material: materials.add(CustomMaterial {}),
        transform: Transform::from_scale(150.0 * Vec3::ONE),
        ..default()
    });

    // Add a camera
    commands.spawn(Camera2dBundle { ..default() });
}

Additional examples can be found in:

• examples/asset/hot_asset_reloading.rs
• examples/animation/morph_targets.rs
• examples/games/loading_screen.rs
• examples/3d/color_grading.rs
• examples/3d/depth_of_field.rs
• examples/3d/load_gltf.rs
• examples/3d/irradiance_volumes.rs
• examples/3d/update_gltf_scene.rs
• examples/3d/tonemapping.rs
• examples/3d/atmospheric_fog.rs
• examples/3d/volumetric_fog.rs
• examples/animation/animation_graph.rs
• examples/window/multiple_windows.rs
• examples/3d/visibility_range.rs
• examples/animation/animated_fox.rs
• examples/transforms/align.rs
• examples/3d/anti_aliasing.rs
• examples/games/alien_cake_addict.rs
• examples/asset/asset_loading.rs
• examples/stress_tests/many_foxes.rs
• examples/3d/split_screen.rs
• examples/3d/deferred_rendering.rs

Trait Implementations

impl Clone for GltfAssetLabel

fn clone(&self) -> GltfAssetLabel

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GltfAssetLabel

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for GltfAssetLabel

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Copy for GltfAssetLabel