AutoMovie API
    Preparing search index...

    Function gatePerformShotActions

    • Gate every action of a beat's performance against the staged world and sort the list into the plan the later stages of performShot read.

      Each action, at <base>[i], is checked for:

      • its actor: a non-blank id or a non-empty list of distinct ids, each a staged node or camera, and a camera only for a frame action;
      • its timing: a start inside [0, duration], a positive finite duration or "auto", a span inside the shot, an "auto" span that is not empty because it starts at the shot's end, and a positive integer repeat.

      A frame action must also state a usable framing and move, name exactly one staged camera, and frame a subject that resolves. Only a follow move admits finite nonnegative aim lookahead seconds. Ordinary focus and focal length are gated as lens intents. Timed focus pulls resolve after object motion is available. The first camera a frame action names becomes the live camera, and a second camera is refused, because a take has one live camera. Every other action joins the stage list and is gated by gatePerformShotStageAction. Violations go into the context's collector; the plan can still contain actions with violations. performShot consumes it only after the collector is clean.

      Parameters

      Returns IAutoMovieEnginePerformShotActionPlan

      The plan: live camera, stage list and its paths, and the jobs.