AutoMovie API
    Preparing search index...

    Interface IAutoMovieFramedSubject

    What a frame action points the camera at, resolved by the caller: the bottom centre of what the subject draws, its height, its horizontal radius, and, when the subject moves during the shot, that base over shot time.

    performShot builds one per frame or coverage subject. A group is measured as the box its members and named formations fill; a node is measured from its model's rest box, else its rig span, else the stand-in height, carried through its placement; a bone or point subject is a stand-in-height segment at the resolved point. compileCameraMove reads it: height and radius fix the distance, height the aim, and at the path of a follow or truck move.

    interface IAutoMovieFramedSubject {
        at: ((seconds: number) => IAutoMovieVector3) | null;
        base: IAutoMovieVector3;
        height: number;
        radius?: number;
    }
    Index
    at: ((seconds: number) => IAutoMovieVector3) | null

    Animated base over shot-local seconds, in the same bottom-centre convention as base, or null when the subject holds still. With null, a follow move keys one static framing and a truck move slides past the fixed base.

    World bottom-centre point of the subject at the move's start, in metres.

    height: number

    Subject height in metres, which sets the vertical fit and the aim height. performShot substitutes the stand-in height when what it measured is below 0.1 m.

    radius?: number

    Half the subject's widest horizontal span about base, in metres.

    performShot measures it on every subject that draws something: a group from the union of its members' boxes, a single node from its model's own rest box (computeModelRestExtent) carried through its placement. Absent or zero means nothing horizontal was measured, as for a rig span, a stand-in, a bone or a point, and height alone sets the distance.

    The fit takes the larger of the vertical and horizontal distances, so for a raster of aspect a the radius changes the framing only where 2 * radius > height * a. A standing figure in a landscape raster stays below that, so its distance comes from its height; a field of two thousand figures a hundred metres across, or a 60 m facade 24 m high, crosses it and is framed from its width.