Type Alias

ARBlendShapeLocation

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

Declaration

typedef NSString *ARBlendShapeLocation;

Discussion

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 ARBlendShapeLocationJawOpen, ARBlendShapeLocationEyeBlinkLeft, and ARBlendShapeLocationEyeBlinkRight 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

ARBlendShapeLocationEyeBlinkLeft

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

ARBlendShapeLocationEyeLookDownLeft

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

ARBlendShapeLocationEyeLookInLeft

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

ARBlendShapeLocationEyeLookOutLeft

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

ARBlendShapeLocationEyeLookUpLeft

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

ARBlendShapeLocationEyeSquintLeft

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

ARBlendShapeLocationEyeWideLeft

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

Right Eye

ARBlendShapeLocationEyeBlinkRight

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

ARBlendShapeLocationEyeLookDownRight

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

ARBlendShapeLocationEyeLookInRight

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

ARBlendShapeLocationEyeLookOutRight

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

ARBlendShapeLocationEyeLookUpRight

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

ARBlendShapeLocationEyeSquintRight

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

ARBlendShapeLocationEyeWideRight

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

Mouth and Jaw

ARBlendShapeLocationJawForward

The coefficient describing forward movement of the lower jaw.

ARBlendShapeLocationJawLeft

The coefficient describing leftward movement of the lower jaw.

ARBlendShapeLocationJawRight

The coefficient describing rightward movement of the lower jaw.

ARBlendShapeLocationJawOpen

The coefficient describing an opening of the lower jaw.

ARBlendShapeLocationMouthClose

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

ARBlendShapeLocationMouthFunnel

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

ARBlendShapeLocationMouthPucker

The coefficient describing contraction and compression of both closed lips.

ARBlendShapeLocationMouthLeft

The coefficient describing leftward movement of both lips together.

ARBlendShapeLocationMouthRight

The coefficient describing rightward movement of both lips together.

ARBlendShapeLocationMouthSmileLeft

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

ARBlendShapeLocationMouthSmileRight

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

ARBlendShapeLocationMouthFrownLeft

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

ARBlendShapeLocationMouthFrownRight

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

ARBlendShapeLocationMouthDimpleLeft

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

ARBlendShapeLocationMouthDimpleRight

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

ARBlendShapeLocationMouthStretchLeft

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

ARBlendShapeLocationMouthStretchRight

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

ARBlendShapeLocationMouthRollLower

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

ARBlendShapeLocationMouthRollUpper

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

ARBlendShapeLocationMouthShrugLower

The coefficient describing outward movement of the lower lip.

ARBlendShapeLocationMouthShrugUpper

The coefficient describing outward movement of the upper lip.

ARBlendShapeLocationMouthPressLeft

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

ARBlendShapeLocationMouthPressRight

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

ARBlendShapeLocationMouthLowerDownLeft

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

ARBlendShapeLocationMouthLowerDownRight

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

ARBlendShapeLocationMouthUpperUpLeft

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

ARBlendShapeLocationMouthUpperUpRight

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

Eyebrows, Cheeks, and Nose

ARBlendShapeLocationBrowDownLeft

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

ARBlendShapeLocationBrowDownRight

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

ARBlendShapeLocationBrowInnerUp

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

ARBlendShapeLocationBrowOuterUpLeft

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

ARBlendShapeLocationBrowOuterUpRight

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

ARBlendShapeLocationCheekPuff

The coefficient describing outward movement of both cheeks.

ARBlendShapeLocationCheekSquintLeft

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

ARBlendShapeLocationCheekSquintRight

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

ARBlendShapeLocationNoseSneerLeft

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

ARBlendShapeLocationNoseSneerRight

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

Tongue

ARBlendShapeLocationTongueOut

The coefficient describing extension of the tongue.

See Also

Using Blend Shapes

blendShapes

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