One Line 3D for the Web

All-in-one: creates a viewer, loads Filament.js from CDN, loads your glTF/GLB model, sets up orbit camera and auto-rotation. Returns a viewer instance.

Creates an empty viewer without loading a model. Call loadModel(url) later. Useful when the model URL is dynamic. Options include transparent (alpha canvas over the page), renderMode, autoRotate, fov, backgroundColor (sRGB 0–1, as displayed) and iblUrl.

Loads a glTF or GLB model from any URL. Replaces the current model. Returns a promise that resolves when the model is ready.

Enables or disables automatic Y-axis rotation. Pauses on user interaction, resumes after idle.

Sets the orbit camera distance from the model center. Useful for controlling the initial zoom level.

Reads or moves the orbit camera: azimuth in radians, eye height, distance, look-at point and vertical FOV. Every field is optional. Chainable.

Re-centres the camera so the model covers at most a fraction of the view at any orbit angle, for example { fill: 0.8 }. Without options, reuses the on-load framing.

'onDemand' stops drawing once nothing moves and wakes on input, camera calls, scene changes or requestRender(). Saves battery on pages with several viewers.

Calls callback(canvas) after every drawn frame, while the image is still readable: copy it with drawImage for reflections or thumbnails.

Loads a KTX IBL environment for physically-based lighting and reflections. Works with any KTX2 cubemap exported from cmgen or a baked HDR.

Adds a directional, point, or spot light to the scene. Returns an entity handle you can pass to removeLight().

Removes every light from the scene, including the default 3-point studio rig. Use this when you want a fully custom lighting setup.

Procedural primitives built as inline glTF — no external model file needed. Perfect for quick prototypes, physics placeholders, or ground planes.

Plays a glTF keyframe animation with full skinning and morph-target support. Use stopAnimation() to return to the rest pose.

Toggles the bloom post-processing effect for cinematic highlights on emissive materials. Fine-tune strength and threshold for dramatic looks.

In-scene HUD elements: rich text billboards, 2D images, and looping videos rendered as world-space quads.

Removes all loaded models, primitives, and media nodes from the scene. Lights, IBL, and camera are preserved.

Cleans up all GPU resources, removes event listeners, and stops the render loop. Call when removing the viewer. Safe to call more than once; loads still in flight are cancelled and their promises reject with an AbortError.