AutoMovie API
    Preparing search index...

    Interface IAutoMovieMesh

    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: positions is [x0,y0,z0, x1,y1,z1, ...], so positions.length is 3 * vertexCount. normals and uvs (when present) align to the same vertex order. skin binds vertices to skeleton bones for deformation, and targets displace them before skinning.

    Reference: glTF 2.0 mesh primitive attributes.

    interface IAutoMovieMesh {
        colors?: number[];
        indices: number[] | null;
        normals: number[] | null;
        physicalVertices?: IAutoMovieMeshPhysicalVertices;
        positions: number[];
        reliefWeights?: number[];
        skin: IAutoMovieMeshSkin | null;
        targets?: IAutoMovieMeshMorphTarget[];
        uvs: number[] | null;
    }
    Index
    colors?: number[]

    Optional 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.

    indices: number[] | null

    Triangle indices into the vertex arrays (every 3 form one triangle). null for a non-indexed mesh (vertices taken in order).

    normals: number[] | null

    Flat vertex normals [x,y,z,...], aligned to positions. null if absent.

    Optional 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.

    positions: number[]

    Flat vertex positions [x,y,z,...] in meters. Length is 3 * vertexCount.

    reliefWeights?: number[]

    Optional 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.

    skin: IAutoMovieMeshSkin | null

    Skeletal binding for deformation, or null for rigid/static geometry.

    Optional morph targets, displacements added before skinning by weight. Omission means none, without morph buffers.

    uvs: number[] | null

    Flat texture coordinates [u,v,...], aligned to positions. null if absent.