Class
FaceControls
The FaceControls object defines a set of properties for controlling
the facial expressions of a Dynamic Head.
The FaceControls object defines a set of properties for controlling
the facial expressions of a character head capable of animation.
The FaceControls properties are based on the Facial Action Coding System
(FACS), a comprehensive system for describing all visually discernible facial
movement based on anatomy. FaceControls properties can only be set
between 0 and 1. Different combinations of the FaceControls property
values create different facial expressions. Recording multiple facial
expressions over time creates facial animation.
What is an Animatable Head?#
An animatable head is a MeshPart that implements a facial rig and is
capable of playing facial animations and triggering facial expressions. A
FaceControls object that is a child of a head MeshPart can
change the facial expressions of the head.
A head consists of the following three components:
- Skinned MeshPart instance for the head geometry with an internal rig that deforms this skinned MeshPart
- FaceControls instance that drives the internal rig when properties such as FaceControls.JawDrop are changed.
- Cage
WrapTargetinstance for tight fitting facial accessories
In a third-party modeling tool, such as Blender or Maya, an artist can create
a joint-driven facial rig, pose the joints to match each of the individual
FACS controls, and save as an FBX. When a head .FBX is imported in Studio, a
facs-to-joint mapping is created. This mapping deforms the mesh geometry when
FaceControls properties are changed. The mapping and the facial rig (including
Bone instances) are not exposed to developers and can only be accessed
through the FaceControls instance. The MeshPart for a Dynamic Head
looks and behaves the same as a regular MeshPart except when a
FaceControls instance is a child of the MeshPart. Editing the properties of
the FaceControls deforms the MeshPart's geometry. These properties are
available to animate in the Animation Editor.
See Facial animation for more information on usage and creation of an animatable head.
Animatable Heads in the Marketplace#
If you are publishing your head to the Marketplace, your head asset must include a minimum subset of face controls. Roblox's publishing validation rejects assets without the following required poses:
- EyesLookDown
- EyesLookLeft
- EyesLookRight
- EyesLookUp
- JawDrop
- LeftEyeClosed
- LeftLipCornerPuller
- LeftLipStretcher
- LeftLowerLipDepressor
- LeftUpperLipRaiser
- LipsTogether
- Pucker
- RightEyeClosed
- RightLipCornerPuller
- RightLipStretcher
- RightLowerLipDepressor
- RightUpperLipRaiser
See FACS poses reference for more information on usage and creation of an animatable head.
Properties 50#
ChinRaiserfloat | Raises the chin up; moves the lower lip upwards.ReadSafeNotReplicated |
ChinRaiserUpperLipfloat | Moves the upper lip when ChinRaiser is engaged and touching the upper lip.ReadSafeNotReplicated |
Corrugatorfloat | Brings the left and right brows inward together.ReadSafeNotReplicated |
EyesLookDownfloat | Moves gaze down. This is a required pose for avatars.ReadSafeNotReplicated |
EyesLookLeftfloat | Moves gaze left. This is a required pose for avatars.ReadSafeNotReplicated |
EyesLookRightfloat | Moves gaze right. This is a required pose for avatars.ReadSafeNotReplicated |
EyesLookUpfloat | Moves gaze up. This is a required pose for avatars.ReadSafeNotReplicated |
FlatPuckerfloat | Also known as lip tightener; brings the corners of the mouth inward and pressing the lips back against the teeth.ReadSafeNotReplicated |
Funnelerfloat | Makes a 'O' shape with the mouth.ReadSafeNotReplicated |
JawDropfloat | Lowers the jaw downward opening the mouth. This is a required pose for avatars.ReadSafeNotReplicated |
JawLeftfloat | Moves mouth and jaw to the left (character left).ReadSafeNotReplicated |
JawRightfloat | Moves mouth and jaw to the right (character right).ReadSafeNotReplicated |
LeftBrowLowererfloat | Lowers the left brow down.ReadSafeNotReplicated |
LeftCheekPufffloat | Puffs up the left cheek.ReadSafeNotReplicated |
LeftCheekRaiserfloat | Squints the left eye.ReadSafeNotReplicated |
LeftDimplerfloat | Moves the corners of the mouth back in Z.ReadSafeNotReplicated |
LeftEyeClosedfloat | Closes the left eyelid. This is a required pose for avatars.ReadSafeNotReplicated |
LeftEyeUpperLidRaiserfloat | Raises the left eyelid upwards to reveal more of the eye white above the iris.ReadSafeNotReplicated |
LeftInnerBrowRaiserfloat | Raises the interior half of the left brow upwards.ReadSafeNotReplicated |
LeftLipCornerDownfloat | Lowers the corners of the mouth downwards in a frown.ReadSafeNotReplicated |
LeftLipCornerPullerfloat | Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.ReadSafeNotReplicated |
LeftLipStretcherfloat | Stretches the corners of the mouth apart. This is a required pose for avatars.ReadSafeNotReplicated |
LeftLowerLipDepressorfloat | Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.ReadSafeNotReplicated |
LeftNoseWrinklerfloat | Raise the left nostril, pulls the brow down slightly, and wrinkles on the side of the nose.ReadSafeNotReplicated |
LeftOuterBrowRaiserfloat | Raises the outer part of the left brow upwards.ReadSafeNotReplicated |
LeftUpperLipRaiserfloat | Raises the left upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.ReadSafeNotReplicated |
LipPresserfloat | Presses the lips together.ReadSafeNotReplicated |
LipsTogetherfloat | Brings the lips together relative to JawDrop. This is a required pose for avatars.ReadSafeNotReplicated |
LowerLipSuckfloat | Rolls the lower lip up over the teeth.ReadSafeNotReplicated |
MouthLeftfloat | Moves the mouth left.ReadSafeNotReplicated |
MouthRightfloat | Moves the mouth right.ReadSafeNotReplicated |
Puckerfloat | Makes a kiss-like shape with the mouth. This is a required pose for avatars.ReadSafeNotReplicated |
RightBrowLowererfloat | Lowers the right brow down.ReadSafeNotReplicated |
RightCheekPufffloat | Puffs up the right cheek.ReadSafeNotReplicated |
RightCheekRaiserfloat | Squints the right eye.ReadSafeNotReplicated |
RightDimplerfloat | Moves the corners of the mouth back in Z.ReadSafeNotReplicated |
RightEyeClosedfloat | Closes the right eyelid. This is a required pose for avatars.ReadSafeNotReplicated |
RightEyeUpperLidRaiserfloat | Raises the right eyelid upwards to reveal more of the eye white above the iris.ReadSafeNotReplicated |
RightInnerBrowRaiserfloat | Raises the interior half of the right brow upwards.ReadSafeNotReplicated |
RightLipCornerDownfloat | Lowers the corners of the mouth downwards in a frown.ReadSafeNotReplicated |
RightLipCornerPullerfloat | Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.ReadSafeNotReplicated |
RightLipStretcherfloat | Stretches the corners of the mouth apart. This is a required pose for avatars.ReadSafeNotReplicated |
RightLowerLipDepressorfloat | Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.ReadSafeNotReplicated |
RightNoseWrinklerfloat | Raises the right nostril, pulls the brow down slightly, and wrinkles on the side of the nose.ReadSafeNotReplicated |
RightOuterBrowRaiserfloat | Raises the outer part of the right brow upwards.ReadSafeNotReplicated |
RightUpperLipRaiserfloat | Raises the right upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.ReadSafeNotReplicated |
TongueDownfloat | Bends the tongue down.ReadSafeNotReplicated |
TongueOutfloat | Extends the tip of the tongue out of the mouth.ReadSafeNotReplicated |
TongueUpfloat | Bends the tongue up.ReadSafeNotReplicated |
UpperLipSuckfloat | Rolls the upper lip around the teeth.ReadSafeNotReplicated |
ChinRaiser: float#
NotReplicatedReadSafe
Raises the chin up; moves the lower lip upwards
ChinRaiserUpperLip: float#
NotReplicatedReadSafe
Moves the upper lip when ChinRaiser is engaged and touching the upper lip
Corrugator: float#
NotReplicatedReadSafe
Brings the left and right brows inward together
EyesLookDown: float#
NotReplicatedReadSafe
Moves gaze down. This is a required pose for avatars.
EyesLookLeft: float#
NotReplicatedReadSafe
Moves gaze left. This is a required pose for avatars.
EyesLookRight: float#
NotReplicatedReadSafe
Moves gaze right. This is a required pose for avatars.
EyesLookUp: float#
NotReplicatedReadSafe
Moves gaze up. This is a required pose for avatars.
FlatPucker: float#
NotReplicatedReadSafe
Also known as lip tightener; brings the corners of the mouth inward and pressing the lips back against the teeth
Funneler: float#
NotReplicatedReadSafe
Makes a 'O' shape with the mouth
JawDrop: float#
NotReplicatedReadSafe
Lowers the jaw downward opening the mouth. This is a required pose for avatars.
JawLeft: float#
NotReplicatedReadSafe
Moves the mouth and jaw to the character's left. Like all
FaceControls properties, this value is clamped between 0 and 1 and
defaults to 0, meaning no displacement. FaceControls.JawRight
applies the opposite displacement, moving the mouth and jaw to the
character's right.
JawRight: float#
NotReplicatedReadSafe
Moves mouth and jaw to the right (character right)
LeftBrowLowerer: float#
NotReplicatedReadSafe
Lowers the left brow down
LeftCheekPuff: float#
NotReplicatedReadSafe
Puffs up the left cheek
LeftCheekRaiser: float#
NotReplicatedReadSafe
Squints the left eye
LeftDimpler: float#
NotReplicatedReadSafe
Moves the corners of the mouth back in Z
LeftEyeClosed: float#
NotReplicatedReadSafe
Closes the left eyelid. This is a required pose for avatars.
LeftEyeUpperLidRaiser: float#
NotReplicatedReadSafe
Raises the left eyelid upwards to reveal more of the eye white above the iris
LeftInnerBrowRaiser: float#
NotReplicatedReadSafe
Raises the interior half of the left brow upwards
LeftLipCornerDown: float#
NotReplicatedReadSafe
Lowers the corners of the mouth downwards in a frown
LeftLipCornerPuller: float#
NotReplicatedReadSafe
Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.
LeftLipStretcher: float#
NotReplicatedReadSafe
Stretches the corners of the mouth apart. This is a required pose for avatars.
LeftLowerLipDepressor: float#
NotReplicatedReadSafe
Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.
LeftNoseWrinkler: float#
NotReplicatedReadSafe
Raise the left nostril, pulls the brow down slightly, and wrinkles on the side of the nose
LeftOuterBrowRaiser: float#
NotReplicatedReadSafe
Raises the outer part of the left brow upwards
LeftUpperLipRaiser: float#
NotReplicatedReadSafe
Raises the left upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.
LipPresser: float#
NotReplicatedReadSafe
Presses the lips together
LipsTogether: float#
NotReplicatedReadSafe
Brings the lips together relative to JawDrop. This is a required pose for avatars.
LowerLipSuck: float#
NotReplicatedReadSafe
Rolls the lower lip up over the teeth
MouthLeft: float#
NotReplicatedReadSafe
Moves the mouth left
MouthRight: float#
NotReplicatedReadSafe
Moves the mouth right
Pucker: float#
NotReplicatedReadSafe
Makes a kiss-like shape with the mouth. This is a required pose for avatars.
RightBrowLowerer: float#
NotReplicatedReadSafe
Lowers the right brow down
RightCheekPuff: float#
NotReplicatedReadSafe
Puffs up the right cheek
RightCheekRaiser: float#
NotReplicatedReadSafe
Squints the right eye
RightDimpler: float#
NotReplicatedReadSafe
Moves the corners of the mouth back in Z
RightEyeClosed: float#
NotReplicatedReadSafe
Closes the right eyelid. This is a required pose for avatars.
RightEyeUpperLidRaiser: float#
NotReplicatedReadSafe
Raises the right eyelid upwards to reveal more of the eye white above the iris
RightInnerBrowRaiser: float#
NotReplicatedReadSafe
Raises the interior half of the right brow upwards
RightLipCornerDown: float#
NotReplicatedReadSafe
Lowers the corners of the mouth downwards in a frown
RightLipCornerPuller: float#
NotReplicatedReadSafe
Raises the corners of the mouth upwards in a smile. This is a required pose for avatars.
RightLipStretcher: float#
NotReplicatedReadSafe
Stretches the corners of the mouth apart. This is a required pose for avatars.
RightLowerLipDepressor: float#
NotReplicatedReadSafe
Lowers the lower lip down away from the upper lip revealing the lower teeth. This is a required pose for avatars.
RightNoseWrinkler: float#
NotReplicatedReadSafe
Raises the right nostril, pulls the brow down slightly, and wrinkles on the side of the nose
RightOuterBrowRaiser: float#
NotReplicatedReadSafe
Raises the outer part of the right brow upwards
RightUpperLipRaiser: float#
NotReplicatedReadSafe
Raises the right upper lip away from the lower lip revealing the upper teeth. This is a required pose for avatars.
TongueDown: float#
NotReplicatedReadSafe
Bends the tongue down
TongueOut: float#
NotReplicatedReadSafe
Extends the tip of the tongue out of the mouth
TongueUp: float#
NotReplicatedReadSafe
Bends the tongue up
UpperLipSuck: float#
NotReplicatedReadSafe
Rolls the upper lip around the teeth
Inherited members#
Inherited from Instance 58
Properties (10)
Archivable, archivable, Capabilities, IsInSandbox, Name, Parent, PredictionMode, RobloxLocked, Sandboxed, UniqueId
Methods (39)
AddTag, children, ClearAllChildren, Clone, clone, Destroy, destroy, FindFirstAncestor, FindFirstAncestorOfClass, FindFirstAncestorWhichIsA, FindFirstChild, findFirstChild, FindFirstChildOfClass, FindFirstChildWhichIsA, FindFirstDescendant, GetActor, GetAttribute, GetAttributeChangedSignal, GetAttributes, GetChildren, getChildren, GetDebugId, GetDescendants, GetFullName, GetStyled, GetStyledPropertyChangedSignal, GetTags, HasTag, IsAncestorOf, IsDescendantOf, isDescendantOf, IsPropertyModified, QueryDescendants, Remove, remove, RemoveTag, ResetPropertyToDefault, SetAttribute, WaitForChild