AutoMovie API
    Preparing search index...

    Function buildHumanCartoonFace

    • Build a deliberately exaggerated cartoon face for a posed polygon head. The caller adds the returned object to the already posed head group once. Bounds use that group's metres, +X forward, +Y up and +Z anatomical left. Eyes, brows, nose and mouth are dimensioned marks, not anatomical skin. Supported units are AU1/2/4/5/6/7/12/15/20/23/24/25/26/27/41/43; named lip fields reuse those units. Other actions, tongue and visemes are reported as unsupported. Head orientation stays with the parent; gaze moves pupils and jaw millimetres move the mouth marks. Marks follow the actual polygon front; the silhouette limits exaggerated brow and jaw travel. Pose values must be finite and already admitted by the caller; this drawing applies no second clinical range limit, including when clamping is disabled.

      Parameters

      • head: {
            frontAt: (y: number, z: number) => number | undefined;
            max: [number, number, number];
            min: [number, number, number];
        }

        Actual local bounds of the polygon head, metres.

        • frontAt: (y: number, z: number) => number | undefined

          Most anterior local triangle X at Y/Z; undefined outside its silhouette.

        • max: [number, number, number]

          Actual head-local maximum in metres.

        • min: [number, number, number]

          Actual head-local minimum in metres.

      • Optionalexpression: AutoMovieHumanCartoon.IExpression

        Existing public action-unit input; omission means neutral.

      • Optionalpose: IHeadPose

        Admitted finite eye/jaw pose; neck motion is already on the parent.

      Returns { dispose: () => void; object: Group; unsupported: readonly string[] }

      Owned face geometry, explicit unsupported fields and its disposer.

      • dispose: () => void

        Release every created geometry and material.

      • object: Group

        Add once to the polygon head's already posed group.

      • unsupported: readonly string[]

        Requested fields outside this cartoon's supported subset.