AutoMovie API
    Preparing search index...

    Interface IAutoMoviePropSpec

    One authored prop: a primitive proxy whose meaning is stated as data. The geometry stays simple parts, while the physics body (IAutoMovieModel.body), the contact points (IAutoMovieModel.affordances), the articulation and the placement carry what the engine validates and simulates.

    forgeProp gates one spec and returns every violation at once: node is non-blank and equals model.id, because the staged scene joins on it; the model is skeleton-less, because a rigged performer goes through forgeCast; origin is "generated" unless modelRef is stated; validateModel passes; and an articulation binds its profile onto declared nodes without a dangling reference or cycle. validatePropPlacements forges every prop of a shot, requires exactly one staged set piece drawing the prop's model, and then judges its placement.

    interface IAutoMoviePropSpec {
        articulation: IAutoMoviePropArticulation | null;
        model: IAutoMovieModel;
        modelRef?: string | null;
        node: string;
        placement?: IAutoMoviePropPlacement;
    }
    Index
    articulation: IAutoMoviePropArticulation | null

    Self-declared moving parts, or null for a rigid prop.

    The prop model, with skeleton: null, parts that serve as the measured proxy, and an optional body and affordances. origin is "generated" for a prop drawn from its parts and "imported" for one drawing the external appearance modelRef names.

    modelRef?: string | null

    Registered external appearance drawing this prop, or absent or null for a prop drawn from its own generated parts.

    The reference buys appearance only. Authored proxy parts, explicit footprint/clearance boxes and affordances remain the inputs to occupancy, bearing, clearance, containment and passage measurements. Body, articulation and placement remain this spec's own data; this path does not infer mass, a seat face, a hinge or a keep-out volume from imported bytes.

    The value names a model group id or runtime model id the production registry owns, as a built environment's modelReferences entries do. It means "forge me as an imported appearance", unlike a cast member's modelRef, which skips forging because an imported rig carries the bones a performer is driven through.

    Stating it makes forgeProp require a non-blank value, origin: "imported", a non-null asset, and a sealed imported closure: unique asset paths with sha256: digests of 64 lowercase hex digits, the rigid gltf-static-v1 profile on the closure and every LOD with no humanoid bones, unique LOD levels whose asset and digest match the ledger, and a hero LOD binding asset. The production shot runtime then refuses a reference that does not resolve to a registered glTF, GLB or VRM appearance, a closure other than the one it sealed, and an asset other than the registered one.

    node: string

    Scene node this prop occupies; non-blank and equal to model.id.

    Building relations, footprint and clearances checked against the staged piece. Omitted, the prop makes no relation, containment, pairwise-overlap or passage claim of its own, but other props may still cite its affordances and must clear its staged occupancy. Forging and the unique staged-model join remain required.