AutoMovie API
    Preparing search index...

    Function markAutoMovieSupportWrenches

    • Turn the support wrenches governing one second into inspection marks: the force the controller allocated to actual floor witnesses, and any shortfall from what it requested.

      A body's wrench governs seconds when it is that body's latest record at or before seconds and seconds lies before its instant plus interval, the cache step the controller allocated it for. Its allocated force is an arrow from the recorded centre of mass, metresPerNewton times the force; a zero allocation draws no such arrow. When the residual force exceeds the optimisation error the allocator itself admits, 1e-6 of its scale, taken here as the larger of 1 N and the requested force because the record keeps no lever to restore the moment term, a second arrow starts at the allocated arrow's tip, so the two arrows add up to the requested force. A body with no witnesses therefore draws only its whole request as shortfall. Moments are not drawn. Both quantities are motor demand before native caps and integration, not measured load; markAutoMovieContacts draws the force contacts actually transferred.

      The allocated mark has kind support/allocated, label allocated support force, colour slate blue 7b68ee and path <body>/support/allocated. The shortfall mark has kind support/shortfall, label support force shortfall, colour dark orange ff8c00, path <body>/support/shortfall and is flagged, because a request the floor witnesses could not carry is an anomaly. Both are in world metres and unanchored, in the order each body's first record appears.

      It throws for an interval or a scale that is not positive and finite.

      Parameters

      • props: IAutoMovieMarkSupportWrenches.IProps

        Turn the support wrenches governing one second into inspection marks.

        A body's wrench governs seconds when it is the body's latest record at or before seconds and seconds lies within one cache interval of it, because the controller allocates it before integrating that step. Its allocated force is drawn from the recorded centre of mass; a residual force beyond the allocator's admitted optimisation error is drawn, flagged, from the allocated arrow's tip, so the two arrows sum to the requested force. These are motor-demand diagnostics, not achieved load: contact receipts measure the force a floor actually transferred.

        • interval: number

          Cache step each record governs, seconds: the reciprocal of the cache rate; markAutoMovieSupportWrenches rejects nonfinite or nonpositive values.

        • metresPerNewton: number

          Arrow length per newton, metres/newton; markAutoMovieSupportWrenches rejects nonfinite or nonpositive values.

        • seconds: number

          Drawn local film second on the wrenches' clock. A record governs from its instant (with 1e-9-second tolerance) until, but not including, its instant plus interval.

        • wrenches: readonly IAutoMoviePhysicalSupportWrench[]

          Borrowed wrench records of a physics cache or playback, ordered by time per body. Empty input returns no marks.

      Returns IAutoMovieMark[]

      Up to two marks per governed body.