AutoMovie API
    Preparing search index...

    Function QuadrupedHeadAttachment

    • Seat a real appendage's complete root cross-section inside its actual head.

      The shared head is the capsule with cap centres poll/nose and headRadius. Eroding that solid by the positive root radius leaves the same finite axis and radius R-r. A centre inside this eroded capsule carries a whole ball of radius r inside the head, hence the actual root disk in every orientation. This is authored neutral construction, not a measured anatomical insertion. Stem length/direction and any branches remain the producer's responsibility.

      Parameters

      • head: Pick<QuadrupedBody.IRig, "poll" | "nose" | "headRadius">

        Actual generating head capsule, neutral model-space metres.

      • hint: IAutoMovieVector3

        Authored root-centre hint in that same frame; an already seated centre stays unchanged.

      • stemRadius: number

        Positive finite radius enclosing the actual root cross-section, metres; for a box use its root rectangle's half-diagonal.

      Returns IAutoMovieVector3

      A fresh seated centre, preserving an outside hint's nearest-axis bearing. Radius equality seats on the actual capsule axis.

      For nonfinite/degenerate head geometry, invalid radius, a root larger than the head or an unrepresentable inset/output.

      When the shared closest-segment owner cannot represent its finite query.