Skip to content

Cinematic effects

Cinematic effects animate material and texture properties in the render loop. They work with meshes, lines, and point clouds.

Built-in effects

EffectTypical result
cosmic-pulseEmissive, color, opacity, point-size, and PBR breathing
texture-vortexRotating and shifting UV transforms with material energy
hologram-scanScanning transparency and cool emissive tint
chrome-breatheOscillating high-metalness, low-roughness surface
noneRestores captured original values

Viewer usage

tsx
<ModelLabViewer
  src="/models/galaxy.glb"
  effect={{
    type: 'texture-vortex',
    intensity: 1.1,
    speed: 0.15,
    color: '#67e8f9',
  }}
/>

Deterministic progress

Pass progress from zero to one to synchronize the effect with scrolling or another timeline:

tsx
effect={{
  type: 'hologram-scan',
  progress: scrollProgress,
  intensity: 0.8,
}}

Headless usage

tsx
<CinematicEffectDriver
  modelRef={modelRef}
  effect={effect}
  progressRef={sequenceProgressRef}
/>

The driver captures original material state and restores it when the effect changes or unmounts.

Released under the MIT License.