AutoMovie API
    Preparing search index...

    Borrowed world-space facts for one instant. detectFreeFall considers a nonnull body unsupported when its XZ center lies farther than margin from the support hull, or support is empty, and neither attached nor falling is true. It does not discover contacts or validate the body's mass.

    Invalid margin or duration returns a finding immediately. An unsupported candidate emits a time-zero event whose point borrows centerOfMass; absent physicsIntent it also warns and builds a fresh projectile clip. Vector, fps and allocation errors can propagate from trajectory generation. No motion is applied to inputs.

    type IProps = {
        attached: boolean;
        body: IAutoMovieBody | null;
        centerOfMass: IAutoMovieVector3;
        fallDuration?: number;
        falling: boolean;
        fps?: number;
        gravity?: IAutoMovieVector3;
        margin?: number;
        node?: string;
        path?: string;
        physicsIntent?: string;
        support: readonly IAutoMovieVector3[];
        velocity?: IAutoMovieVector3;
    }
    Index
    attached: boolean

    True when another object holds or attaches this body, suppressing the candidate fall.

    body: IAutoMovieBody | null

    Declared physical body; null skips fall advice, while a nonnull record is used only as a presence test here.

    centerOfMass: IAutoMovieVector3

    World center in metres; borrowed directly by a fall event and read as trajectory origin. Finite representable geometry is a caller premise for support queries.

    fallDuration?: number

    Proposed clip duration in seconds, default 1; finite positive admission runs even when no fall would occur.

    falling: boolean

    True when a fall is already authored/in progress, preventing duplicate advice.

    fps?: number

    Proposed trajectory samples per second, default 30; delegated trajectory admission can throw.

    World acceleration in m/s^2, default AutoMovieGravity.DOWN; checked by trajectory generation only if a trajectory is requested.

    margin?: number

    Allowed horizontal distance beyond support in metres, default 0.02; must be finite and nonnegative, with equality treated as supported.

    node?: string

    Scene node id for the event and proposed clip; omission gives a null event actor and clip target "object".

    path?: string

    Finding-path prefix, default "$input"; unrelated to the node lookup id.

    physicsIntent?: string

    Any defined string suppresses the warning and trajectory but keeps the candidate event; its content is not interpreted.

    support: readonly IAutoMovieVector3[]

    Borrowed world support points in metres, projected to XZ; empty means unsupported, and point heights do not affect that decision.

    Initial world velocity in m/s, default zero; checked when the proposed trajectory is built.