Skip to content

Support · Resources

Blendshape guidelines

Required blendshapes and naming conventions, based on the ARKit 52 standard.

BEFORE YOU BEGIN

Most of the workflow within this document will match the ARKit 52 blendshape standard with the exception of eye rotations. See the end of this document for the specific shapes excluded. For a tech overview of ARKit’s Face Anchoring, please refer to this document: ARFaceAnchor.BlendShapeLocation

Required Blendshapes

Note: it is essential to follow the naming conventions provided with each image example.

Left Eye Shapes

eyeBlinkLeft example — eyeBlinkLeft
Closure of the eyelids over the left eye

eyeSquintLeft example — eyeSquintLeft
Contraction of the face around the left eye

eyeWideLeft example — eyeWideLeft
Widening of the eyelids around the left eye

Right Eye Shapes

eyeBlinkRight example — eyeBlinkRight
Closure of the eyelids over the right eye

eyeSquintRight example — eyeSquintRight
Contraction of the face around the right eye

eyeWideRight example — eyeWideRight
Widening of the eyelids around the right eye

Mouth and Jaw

jawForward example — jawForward
Forward movement of the lower jaw

jawLeft example — jawLeft
Leftward movement of the lower jaw

jawRight example — jawRight
Rightward movement of the lower jaw

jawOpen example — jawOpen
An opening of the lower jaw

mouthClose example — mouthClose
Closure of the lips independent of jaw position

mouthFunnel example — mouthFunnel
Contraction of both lips into an open shape

mouthPucker example — mouthPucker
Contraction and compression of both closed lips

mouthLeft example — mouthLeft
Leftward movement of both lips together

mouthRight example — mouthRight
Rightward movement of both lips together

mouthSmileLeft example — mouthSmileLeft
Upward movement of the left corner of the mouth

mouthSmileRight example — mouthSmileRight
Upward movement of the right corner of the mouth

mouthFrownLeft example — mouthFrownLeft
Downward movement of the left corner of the mouth

mouthFrownRight example — mouthFrownRight
Downward movement of the right corner of the mouth

mouthDimpleLeft example — mouthDimpleLeft
Backward movement of the left corner of the mouth

mouthDimpleRight example — mouthDimpleRight
Backward movement of the right corner of the mouth

mouthStretchLeft example — mouthStretchLeft
Leftward movement of the left corner of the mouth

mouthStretchRight example — mouthStretchRight
Rightward movement of the left corner of the mouth

mouthRollLower example — mouthRollLower
Movement of the lower lip toward the inside of the mouth

mouthRollUpper example — mouthRollUpper
Movement of the upper lip toward the inside of the mouth

mouthShrugLower example — mouthShrugLower
Outward movement of the lower lip

mouthShrugUpper example — mouthShrugUpper
Outward movement of the upper lip

mouthPressLeft example — mouthPressLeft
Upward compression of the lower lip on the left side

mouthPressRight example — mouthPressRight
Upward compression of the lower lip on the right side

mouthLowerDownLeft example — mouthLowerDownLeft
Downward movement of the lower lip on the left side

mouthLowerDownRight example — mouthLowerDownRight
Downward movement of the lower lip on the right side

mouthUpperUpLeft example — mouthUpperUpLeft
Upward movement of the upper lip on the left side

mouthUpperUpRight example — mouthUpperUpRight
Upward movement of the upper lip on the right side

Eyebrows, Cheeks and Nose

browDownLeft example — browDownLeft
Downward movement of the outer portion of the left eyebrow

browDownRight example — browDownRight
Downward movement of the outer portion of the right eyebrow

browInnerUp example — browInnerUp
Upward movement of the inner portion of both eyebrows

browOuterUpLeft example — browOuterUpLeft
Upward movement of the outer portion of the left eyebrow

browOuterUpRight example — browOuterUpRight
Upward movement of the outer portion of the right eyebrow

cheekPuff example — cheekPuff
Outward movement of both cheeks

cheekSquintLeft example — cheekSquintLeft
Upward movement of the cheek around and below the left eye

cheekSquintRight example — cheekSquintRight
Upward movement of the cheek around and below the right eye

noseSneerLeft example — noseSneerLeft
A raising of the left side of the nose around the nostril

noseSneerRight example — noseSneerRight
A raising of the right side of the nose around the nostril

Tongue

tongueOut 0.0 to 1.0 + jawOpen 0.6

Extension of the tongue and mouth open

tongueOut 0.0 to 1.0 + jawOpen 0.6

*Side view for better depiction

Shapes we’ve excluded due to non-use of those particular blendshapes from within STAGE.KIT:

Left Eye:

eyeLookDownLeft
eyeLookInLeft
eyeLookOutLeft
eyeLookUpLeft

Right Eye:

eyeLookDownRight
eyeLookInRight
eyeLookOutRight
eyeLookUpRight