AutoMovie API
    Preparing search index...

    Interface IAutoMovieFramingGoal

    What a camera must show, by subjects rather than coordinates: the named subjects fill a share of the frame height, seen from a bearing and an elevation about their common centre. resolveAutoMovieFraming turns it into a camera pose from the subjects' actual bounds. The resolver checks nonempty subjects and the fill, elevation and field-of-view intervals, and rejects unknown ids. The caller supplies finite bearing and finite nonnegative subject bounds; those quantities are not admitted here.

    interface IAutoMovieFramingGoal {
        bearing: number;
        elevation: number;
        fieldOfView: number;
        fill: number;
        subjects: readonly string[];
    }
    Index
    bearing: number

    Horizontal bearing from the subjects' centre to the camera, radians from +Z toward +X.

    elevation: number

    Elevation of the camera above the horizontal, radians, in (-pi/2, pi/2).

    fieldOfView: number

    Vertical field of view, radians, in (0, pi).

    fill: number

    Perspective height fraction in (0, 1] used to size the enclosing-radius framing estimate; distance is radius / (fill * tan(fieldOfView / 2)).

    subjects: readonly string[]

    Stable ids of the subjects to show; at least one.