AutoMovie API
    Preparing search index...

    Interface IAutoMovieFormationCadenceSegment

    One interval of a unit's shot over which one action runs at one rate.

    A unit's cadence is not a property of a moment: how fast a member's cycle turns follows the ground its unit has covered since the shot opened, and that ground is spread over every cue the unit has performed so far. So the question "where in its cycle is this member now" is answered by walking the whole interval [0, time] once and adding up what each part of it did, which is what these segments are.

    Nothing accumulates between frames: the same cue list and the same time always produce the same segments, so a re-render is byte-identical and a seek is exact.

    interface IAutoMovieFormationCadenceSegment {
        distance: number;
        gait: string | null;
        seconds: number;
        turn: number;
    }
    Index
    distance: number

    Ground meters the unit's own origin covers over this interval, measured in the horizontal x-z plane; zero for a gap between cues.

    gait: string | null

    Gait the cue owning this interval calls for, or null before the first cue.

    This is the cue's own request (IAutoMovieFormationMotion.gait, or its action label when the cue named no gait), not a resolved figure gait. Which figure can perform it is a question about a runtime model, and a unit can hold several of them at once across its LOD tiers. A gap after a cue keeps that cue's gait.

    seconds: number

    Seconds this interval lasts; a zero-length gap is never emitted, and with non-overlapping cues no cue interval is zero-length either.

    turn: number

    Unsigned radians the unit turns about its own origin over this interval; the turn direction is not kept.