Asset

Loads a whole 3D model from a file — a glTF scene or an OBJ mesh — and brings the recovered node tree into the scene under one transform.

Declarative element: <sk-asset>

Global: available as sk.Asset inside a scene <script>.

Remarks

The asset is a SceneNode that stands in for an externally-authored model: it fetches its src, parses it, and expands the recovered subtree so it renders as part of the scene. This is how you drop a model exported from a modelling tool into a Skenra scene.

Key attributes. src is the file URL; the format is chosen by extension. A glTF file (the default) recovers its groups and meshes as a renderable hierarchy. Where one glTF mesh splits into several compatible per-material primitives, they merge into a single mesh whose per-primitive face groups become named selections; a single-primitive mesh keeps its whole-mesh base-color paint, while a merged mesh preserves each region's base color as its selection grouping. Only base color is imported from a glTF material — never textures or the metallic/roughness/emissive PBR terms. An .obj file recovers a single mesh — each o/g object group becomes a named face selection on it — and one spline per polyline, carrying no materials of its own (assign appearance by targeting the recovered mesh, and its object groups by name via a selection binding). Because the loaded tree renders under this node, the asset's own transform (x/y/z, s, rotation) moves and scales the whole model as one unit. Loading is asynchronous, so a load event fires on success and an error event on failure; a failed re-load leaves any prior content intact.

Normalizing. A loaded model arrives at whatever scale and position it was exported at. normalize-scale="N" rescales it (aspect-preserving) so its largest extent fits [-N, N], and anchor picks the reference point translated to the origin first (anchor="center" recenters it) — so a bare scene frames the model naturally under the default camera. The transform is applied to the loaded content only; the asset's own transform and any nested annotations are untouched. Omit normalize-scale to keep the authored coordinates (and fit the camera yourself in an onload handler from the asset's computed bounds).

Related. For a single piece of imported geometry rather than a whole hierarchy, use sk-mesh; to stamp a loaded model across many positions, make it the content of a sk-cloner.

Constructor

constructor(config?: { src?: string; normalizeScale?: number | 'none'; anchor?: AnchorValue3D; id?: string; x?: number; y?: number; z?: number; h?: number; p?: number; b?: number; quaternion?: Quaternion; sx?: number; sy?: number; sz?: number; s?: number; class?: string; style?: string })

Inherited from: SceneNode, SkenraAnimatable — see those pages for inherited members.

Properties

Config Properties

Other Properties

Methods

Example

import { Asset } from '/js/skenra/scene-graph/asset.js';

const rig = new Asset({ id: 'rig', src: 'assets/character.gltf', normalizeScale: 3, anchor: 'center' });
scene.appendChild(rig);
rig.addEventListener('load', () => console.log('rig ready'));

↑ Documentation home · ← All classes