Skip to content

Embedded glTF animations

Embedded clips are animations authored in DCC tools and stored in the GLB/GLTF. They are separate from Model Lab immersive sequences.

Configuration

tsx
<ModelLabViewer
  src="/models/robot.glb"
  config={{
    animation: {
      clipName: 'Walk',
      playing: true,
      speed: 1,
      loop: true,
    },
  }}
/>

Reverse playback

Use a negative speed to play an embedded clip backward:

ts
animation: { speed: -1 }

Combining clip and sequence animation

An embedded clip animates nodes inside the imported scene. An immersive sequence animates the outer pivot root, camera, exposure, and lights. They can run together because they operate at different hierarchy levels.

Pivot compatibility

The pivot system does not rewrite model geometry or animation tracks. Existing node paths remain below the content root.

Clip naming

Unnamed clips are assigned display names such as Animation 1. Stable clip names from the source asset are preferred for production presets.

Released under the MIT License.