AutoMovie API
    Preparing search index...

    Interface IAutoMovieCompilePracticalLightMotion

    Bake a staged point or spot source at a prop's model-local emitter.

    interface IAutoMovieCompilePracticalLightMotion {
        duration: number;
        emitter: Pick<IAutoMovieAffordance, "frame">;
        id: string;
        light: IAutoMoviePointLight | IAutoMovieSpotLight;
        objectMotions?: readonly IAutoMovieClip[];
        on?: readonly [number, number];
        prop: Pick<IAutoMovieSceneNode, "id" | "transform">;
        sampleTimes?: readonly number[];
    }
    Index
    duration: number

    Positive finite shot duration in seconds.

    emitter: Pick<IAutoMovieAffordance, "frame">

    The prop's fixed model-local emitter, such as the torch's lens or the lamp's light affordance. A spot shines along the emitter's local +Y. Supply the frame from the model as staged, including any fixed articulation.

    id: string

    Unique id for the returned clip within the shot's lightMotions.

    The staged practical light. Its intensity is the on-state value.

    objectMotions?: readonly IAutoMovieClip[]

    The shot's admitted object-motion clips in playback order. Each started prop TRS channel follows the engine's own per-channel clip authority. Omit for a placed prop at rest.

    on?: readonly [number, number]

    Shot-local [start, end) interval in seconds, 0 <= start < end <= duration. Omit to preserve staged intensity across the shot, including its endpoint.

    prop: Pick<IAutoMovieSceneNode, "id" | "transform">

    Placed prop root. Its staged world TRS fills channels before they start.

    sampleTimes?: readonly number[]

    Shot-local sample times in seconds within [0, duration]. Include every output frame that needs exact alignment. A prop with TRS tracks requires at least one explicit sample time. Position and aim interpolate between samples, including around held or delayed source keys. The bake samples both shot endpoints and switch boundaries, and canonicalizes order and duplicates.