OptionalcolorsOptional linear RGB multipliers [r,g,b,...], one triple per vertex. Components are finite in [0,1]. Omission means white, without a buffer. These multiply material and texture base colour, never opacity or light.
Triangle indices into the vertex arrays (every 3 form one triangle). null for a non-indexed mesh (vertices taken in order).
Flat vertex normals [x,y,z,...], aligned to positions. null if absent.
OptionalphysicalOptional physical source correspondence, aligned with render vertices. A numeric entry in vertices references sources; null retains current position welding. Omission makes every vertex position-derived. Source IDs are nonnegative safe integers and domains are nonblank strings naming an actual physical instance's equivalence context. Equal domain/ID pairs identify one point duplicated for attributes; contact alone never identifies two points. Every alias must occupy the same topology-grid cell. Domains are not biological-source names or normal islands. Reusing one pair across placed meshes asserts the same actual point in their shared frame. A producer owns incidence and must rebind newly created vertices. The table survives composition; indices into it have no physical meaning. This correspondence supplies topology, not geometry-validity exemptions.
Flat vertex positions [x,y,z,...] in meters. Length is 3 * vertexCount.
OptionalreliefOptional factor on the slopes of the material's normal map, one per vertex, finite and nonnegative: a relief that deepens or flattens across the surface, such as the wrinkles over a joint that flatten as it bends and stretch the skin. It scales normalTexture alone, not the detail map or an overlay's. glTF has no ratified attribute for it, so an exported asset omits it. Omission means one, without a buffer.
Skeletal binding for deformation, or null for rigid/static geometry.
OptionaltargetsOptional morph targets, displacements added before skinning by weight. Omission means none, without morph buffers.
Flat texture coordinates [u,v,...], aligned to positions. null if absent.
Explicit triangle-mesh geometry: imported, baked, or deterministically generated.
Unlike a IAutoMoviePrimitiveShape with compact named dimensions, a mesh carries explicit bulk vertex data. Supported ingest reads glTF, GLB or VRM appearance; this repository implements no FBX importer. An engine may bake triangles, or ordinary production TypeScript may generate them from authored equations and inputs. An authoring agent authors the named generator rather than transcribing opaque bulk arrays.
Attributes follow the glTF convention of parallel flat arrays indexed by vertex:
positionsis[x0,y0,z0, x1,y1,z1, ...], sopositions.lengthis3 * vertexCount.normalsanduvs(when present) align to the same vertex order.skinbinds vertices to skeleton bones for deformation, andtargetsdisplace them before skinning.Reference: glTF 2.0 mesh primitive attributes.