Structure

ARFaceAnchor.BlendShapeLocation

Identifiers for specific facial features, for use with coefficients describing the relative movements of those features.

Overview

The blendShapes dictionary provided by an ARFaceAnchor object describes the facial expression of a detected face in terms of the movements of specific facial features. For each key in the dictionary, the corresponding value is a floating point number indicating the current position of that feature relative to its neutral configuration, ranging from 0.0 (neutral) to 1.0 (maximum movement).

ARKit provides many blend shape coefficients, resulting in a detailed model of a facial expression; however, you can use as many or as few of the coefficients as you desire to create a visual effect. For example, you might animate a simple cartoon character using only the jawOpen, eyeBlinkLeft, and eyeBlinkRight coefficients. A professional 3D artist could create a detailed character model rigged for realistic animation using a larger set, or the entire set, of coefficients.

Topics

Left Eye

static let eyeBlinkLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing closure of the eyelids over the left eye.

static let eyeLookDownLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the left eyelids consistent with a downward gaze.

static let eyeLookInLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the left eyelids consistent with a rightward gaze.

static let eyeLookOutLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the left eyelids consistent with a leftward gaze.

static let eyeLookUpLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the left eyelids consistent with an upward gaze.

static let eyeSquintLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing contraction of the face around the left eye.

static let eyeWideLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing a widening of the eyelids around the left eye.

Right Eye

static let eyeBlinkRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing closure of the eyelids over the right eye.

static let eyeLookDownRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the right eyelids consistent with a downward gaze.

static let eyeLookInRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the right eyelids consistent with a leftward gaze.

static let eyeLookOutRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the right eyelids consistent with a rightward gaze.

static let eyeLookUpRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the right eyelids consistent with an upward gaze.

static let eyeSquintRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing contraction of the face around the right eye.

static let eyeWideRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing a widening of the eyelids around the right eye.

Mouth and Jaw

static let jawForward: ARFaceAnchor.BlendShapeLocation

The coefficient describing forward movement of the lower jaw.

static let jawLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing leftward movement of the lower jaw.

static let jawRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing rightward movement of the lower jaw.

static let jawOpen: ARFaceAnchor.BlendShapeLocation

The coefficient describing an opening of the lower jaw.

static let mouthClose: ARFaceAnchor.BlendShapeLocation

The coefficient describing closure of the lips independent of jaw position.

static let mouthFunnel: ARFaceAnchor.BlendShapeLocation

The coefficient describing contraction of both lips into an open shape.

static let mouthPucker: ARFaceAnchor.BlendShapeLocation

The coefficient describing contraction and compression of both closed lips.

static let mouthLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing leftward movement of both lips together.

static let mouthRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing rightward movement of both lips together.

static let mouthSmileLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the left corner of the mouth.

static let mouthSmileRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the right corner of the mouth.

static let mouthFrownLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the left corner of the mouth.

static let mouthFrownRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the right corner of the mouth.

static let mouthDimpleLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing backward movement of the left corner of the mouth.

static let mouthDimpleRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing backward movement of the right corner of the mouth.

static let mouthStretchLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing leftward movement of the left corner of the mouth.

static let mouthStretchRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing rightward movement of the left corner of the mouth.

static let mouthRollLower: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the lower lip toward the inside of the mouth.

static let mouthRollUpper: ARFaceAnchor.BlendShapeLocation

The coefficient describing movement of the upper lip toward the inside of the mouth.

static let mouthShrugLower: ARFaceAnchor.BlendShapeLocation

The coefficient describing outward movement of the lower lip.

static let mouthShrugUpper: ARFaceAnchor.BlendShapeLocation

The coefficient describing outward movement of the upper lip.

static let mouthPressLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward compression of the lower lip on the left side.

static let mouthPressRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward compression of the lower lip on the right side.

static let mouthLowerDownLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the lower lip on the left side.

static let mouthLowerDownRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the lower lip on the right side.

static let mouthUpperUpLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the upper lip on the left side.

static let mouthUpperUpRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the upper lip on the right side.

Eyebrows, Cheeks, and Nose

static let browDownLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the outer portion of the left eyebrow.

static let browDownRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing downward movement of the outer portion of the right eyebrow.

static let browInnerUp: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the inner portion of both eyebrows.

static let browOuterUpLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the outer portion of the left eyebrow.

static let browOuterUpRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the outer portion of the right eyebrow.

static let cheekPuff: ARFaceAnchor.BlendShapeLocation

The coefficient describing outward movement of both cheeks.

static let cheekSquintLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the cheek around and below the left eye.

static let cheekSquintRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing upward movement of the cheek around and below the right eye.

static let noseSneerLeft: ARFaceAnchor.BlendShapeLocation

The coefficient describing a raising of the left side of the nose around the nostril.

static let noseSneerRight: ARFaceAnchor.BlendShapeLocation

The coefficient describing a raising of the right side of the nose around the nostril.

Relationships

See Also

Using Blend Shapes

var blendShapes: [ARFaceAnchor.BlendShapeLocation : NSNumber]

A dictionary of named coefficients representing the detected facial expression in terms of the movement of specific facial features.