AutoMovie API
    Preparing search index...

    Function nodeSubjectExtent

    • The model-space box a node subject is framed and graded from: its supplied portable rest extent when measured, otherwise the horizontally degenerate segment of its rig span or stand-in height. External asset bytes and renderer-only deformation are not measured by this rule.

      extent is the drawn box computeModelRestExtent measured, or null when the model measured nothing; rigHeight is the joint span standing in for it, or null when there is no rig either. Without an extent the result is a segment on the node's own vertical axis from y = 0, exactly zero wide, which nodeSubjectBox recognizes as unmeasured.

      A height below MIN_MEASURED_SUBJECT_HEIGHT is replaced by DEFAULT_SUBJECT_HEIGHT. A measured model keeps its own floor and its own width even then: a plaza slab 60 m across and 20 mm thick is a real horizontal extent even where its vertical one is unusable. The result is stated once because performShot measures a node for the framing solve and realizeShotContract measures it again for the grade.

      Parameters

      • extent: IAutoMovieSubjectBox | null

        Measured model-space box in metres, or null.

      • rigHeight: number | null

        Rig joint span in metres, or null.

      Returns IAutoMovieSubjectBox

      The model-space box to frame and grade, in metres.