AutoMovie API
    Preparing search index...

    Function gateAuthoredObjectMotions

    • Gate the object clips a shot's source authored, so a moving thing that is not a performer can reach a compiled shot.

      builtOpeningPanelPlacements promises that a door which swings on screen is an objectMotions clip over the panel node ids it answers with, and IAutoMoviePropArticulation promises that a prop's hinge is a lowered joint a clip drives. Both are one thing, a node in the staged graph turned over the shot's own clock: a building's panel is a staged set piece (<environment>/<element>) and a prop's leaf is a lowered articulation joint (<placement>/<joint>), so one channel serves both.

      Every clip first passes the transform-clip artifact rule with a channel gate that refuses, each with its own path and reason:

      • a node no shot staged, or a joint no staged prop declares, because a clip addressing nothing would be stored and rendered as silence;
      • a node a performance already drives, because a transform clip written over a rig would fight the pose every frame;
      • a channel a baked clip already drives, and an id a baked clip or an earlier authored clip already carries, because each channel and each clip id has one authority;
      • a key outside [0, duration], which no frame reads;
      • cubicspline interpolation, because a spline's tangents can overshoot a travel bound between two keys that both satisfy it, and nothing downstream clamps an object clip.

      A scene whose lowered graph carries one id twice is refused at the gate's path, since no frame can be resolved for it. Only a prop forgeProp accepts contributes joints; its own refusals belong to forgeProp and the placement gate. When all of that passes and a staged prop binds an articulation profile, the clips resolve through resolveFrame at time 0, at every authored key, at analytical quaternion-component extrema and just inside key boundaries. Periodic direct curves share their first-cycle bound. Profiles bind at their placement prefix, and a channel the clips drive past its declared travel is reported once, naming the profile. A channel a clip does not drive is never blamed, even if its rest pose breaches. An empty clip list answers no violations. The critical clock bounds directly interpolated components; it does not derive additional extrema for nonlinear channel-space driver combinations.

      Parameters

      Returns IAutoMovieConstraintViolation[]

      The violations, empty when every clip is admitted.