Skip to content

Pose

Supported Class Animation & Avatar

Holds the CFrame applied to the Motor6D connected to its associated BasePart. The part which is controlled depends on the name of the Pose.

6 Nova members · 2 modern Roblox members not implemented yet

Description

A Pose holds the CFrame applied to the Motor6D connected to its associated BasePart. The part which is controlled depends on the name of the Pose.

Poses are the fundamental building blocks of animations and, with Keyframes, make up KeyframeSequences.

Poses, joints and hierarchy

Although a Pose is assigned to a BasePart by name, the object manipulated during animation playback is actually the Motor6D connected to this part. Animation rigs branch out from the model's root part through such joints.

In an R15 character rig, the root part is the HumanoidRootPart. The LowerTorso is connected to the HumanoidRootPart by the a motor named 'Root'. Therefore, the CFrame of a Pose named 'LowerTorso' in a Keyframe would be applied to the motor named 'Root', and not the LowerTorso itself.

Poses are arranged in a Keyframe based on joint hierarchy. This means, the Pose's CFrame is applied to the motor connecting the part associated with the pose to the part associated with the pose's parent. See below for a visual example of the structure of Poses on a R15 character.

Pose CFrame

The Roblox animation system applies Pose.CFrame to the corresponding Motor6D by manipulating the relative transformation of the motor, the Motor6D.Transform property. The original C0 and C1 values are not changed.

Inheritance

Object → Instance → PoseBase → Pose

Nova inheritance: Instance → Pose

Properties

CFrame Supported Property This CFrame applies to the Motor6D corresponding with the Pose when the Motor6D.Transform is changed.
CFrame: CoordinateFrame

This CFrame applies to the Motor6D corresponding with the Pose when the Motor6D.Transform is changed. The original Motor6D.C0 and Motor6D.C1 values are not changed.

Pose objects are arranged in a Keyframe based on joint hierarchy. This means, that the Pose.CFrame is applied to the motor connecting the part associated with the pose to the part associated with the pose's parent.

Roblox reference signature
CFrame: CFrame

Roblox documentation

MaskWeight Supported Property Deprecated
MaskWeight: float

No description available.

Roblox documentation

Weight Supported Property Deprecated
Weight: float

No description available.

Roblox documentation

Methods

AddSubPose Supported Function Adds a sub Pose to the Pose by parenting it.
Pose:AddSubPose(Instance pose)

Adds a sub Pose to the Pose by parenting it.

Adds a sub Pose to the Pose by parenting it to it. It is functionally identical to setting the new pose's Instance.Parent to the pose.

Note, this function will not error when an instance other than a Pose is given as the pose parameter and will parent it successfully.

Roblox reference signature
Pose:AddSubPose(pose: Instance): null

Roblox documentation

GetSubPoses Supported Function Returns an array containing all sub Poses that have been added to a Pose.
Pose:GetSubPoses(): Objects

Returns an array containing all sub Poses that have been added to a Pose. This is functionally the same as using the Instance.GetChildren() function on the Pose.

Note: this function returns all children of the Pose, including non Pose Instances if any are present.

Roblox reference signature
Pose:GetSubPoses(): Instances

Roblox documentation

RemoveSubPose Supported Function Removes a sub Pose from the Pose by parenting it to nil.
Pose:RemoveSubPose(Instance pose)

Removes a sub Pose from the Pose by parenting it to nil. This is functionally identical to setting the new pose's Instance.Parent to nil.

Note: If an Instance other than Pose is used as a Pose parameter, this function removes that Instance and does not provide an error.

Roblox reference signature
Pose:RemoveSubPose(pose: Instance): null

Roblox documentation

Inherited members

Inherited from Instance: 8 properties, 36 methods, 7 events. They are documented on the base class page.

2 modern Roblox member(s) are not implemented yet — expand to inspect

Members declared by Roblox's Pose class (or by a missing base class) that Nova does not expose. Use this list to scope a migration; the compatibility guide has the recommended workaround.

Properties

Member Signature Status Notes Flags
EasingDirection EasingDirection: PoseEasingDirection Not yet Inherited from PoseBase. —
EasingStyle EasingStyle: PoseEasingStyle Not yet Inherited from PoseBase. —

Roblox reference: Pose

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.