AutoMovie API
    Preparing search index...

    Interface IAutoMovieFormationDesign

    A unit-level formation whose members are deterministic derived slots.

    interface IAutoMovieFormationDesign {
        anchor: IAutoMovieVector3;
        blocks?: IAutoMovieFormationBlock[];
        capabilities: AutoMovieFormationCapability[];
        count: number;
        facingDeg: number;
        heroOverrides: { actor: string; slot: number }[];
        id: string;
        layout: IAutoMovieFormationLayout;
        lod?: IAutoMovieModelLod[];
        model: string;
        seed: number;
    }
    Index

    Formation origin in world-space meters.

    Blocks of slots in place of the one layout: slot i is block k's slot i minus the counts of the blocks before it, laid by the block's layout and placed by its offset and facing in the design's frame (IAutoMovieFormationBlock); the counts sum to count. The one layout lays every slot when absent, and a reader that does not know blocks reads the design as that layout.

    Unique intended formation behaviors for source/review coordination.

    These labels are not a builder permission boundary and do not prove that source implemented or avoided a motion.

    count: number

    Integer number of derived slots from 1 through 100,000. Generated output stores bounded chunks and hero exceptions; anonymous slots are regenerated from index and seed and rendered through instancing.

    facingDeg: number

    Finite world-space heading in degrees.

    heroOverrides: { actor: string; slot: number }[]

    Slots promoted to named hero actors.

    Type Declaration

    • actor: string

      Non-blank actor id, unique among this formation's hero overrides.

    • slot: number

      Unique zero-based slot strictly below this formation's count.

    id: string

    Non-blank stable formation id, unique under portable case folding.

    Compact layout with only the parameters its algorithm consumes. Line, column and wedge own explicit spacing; arc separation follows radius and angle, while scatter density follows count and radius.

    Ordered distance tiers for anonymous members; omitted or empty draws model as one unbounded near tier. Tiers must be ordered hero, near, far with increasing positive distances and an unbounded tier only at the end; compilation drops a hero tier because named hero nodes draw themselves.

    model: string

    Existing model group id enforced on every derived slot, including heroes.

    seed: number

    Integer deterministic seed from zero through MAX_SAFE_INTEGER.