Skip to main content

Twist Modifier

Last Updated Time: 01/08/2024

Overview

Twist Modifier can rotate the specified bone chain around the specified axis.

Using Nodes

In Anim Tree Editor, right-click in the blank area of the editing area to open the Node Selection panel, expand Skeleton Control category, and select Twist Modifier to create a Twist Modifier node.

image-20231227133213283

After creation:

image-20231227133043172

Configure the appropriate input/output for the Twist Modifier node.

Both the input and output pose of the Twist Modifier node are in the Mesh Space, Space Conversion node will be automatically added when nodes are connected. As shown below:

Example

Node Properties

After selecting the Twist Modifier node, we can see the properties of the specified node in the Property Window.

image-20231227133548873

PropertyDescription
Rotation Interp SpeedIf this property value is greater than 0, when the Angle is modified, it will interpolate to the target Angle at the set speed. The greater the value, the faster the speed.
Start BoneUsed to specify Bone Chain, the Start Bone and the End Bone must be on the same Bone Chain, otherwise there is no effect.
End BoneUsed to specify Bone Chain, the Start Bone and the End Bone must be on the same Bone Chain, otherwise there is no effect.
Rotation AxisSpecify the axis of rotation, and each bone point in the chain rotates around the specified axis.
Check the box to allow the property to use the animation vector parameter, and specifies which parameter to get the parameter control from in the drop-down list.
AngleRotating Angle
Check the box to allow the property to use animated floating-point parameter, and specifies which parameter to get the parameter control from in the drop-down list.
Blend AlphaThe greater this property value, the stronger the Twist modifier effect, and 0 represents no effect at all.
Check the box to allow the property to use animated floating-point parameter, and specifies which parameter to get the parameter control from in the drop-down list.

:::Tips

Specified steps to set the Start Bone and End Bone:

Click onimage-20231228161126714,in the pop-up Skeleton Tree window, double-click on the specified bone.

SelectBone

:::

Examples

Here is a simple example of using Twist Modifier node.

Creating Actors

Please refer to Assembling Actor document,create an Actor(.actor) that contains the SK_Human_tpose and default_stand animation assets.

image-20231227135754576

Configuring Animation Tree

Double-click on a skeleton asset in the Action List of the Actor Editor to open the Animation Editor.

image-20231227162009858

Create an Animation Tree. In the Animation Editor, click on File-> Create in the menu bar, select AnimTree in the drop-down box of the pop-up window, name it and select File Path for it, click on Yes to finish creation and go to the Anim Tree Editor.

image-20231227170941061

Add a Twist Modifier node and a default_stand sequence player node in the Animation Tree, link the default_stand node to the Twist Modifier node, and link the Twist Modifier node to Final Animation Pose node.

image-20231227172335215

Select the Twist Modifier node, set the node property in the Property Window. For example, set the specified bone chain for the Start Bone and the End Bone, set the Angle to 60.

image-20231228132335953

Click on Apply to see the character specified bone chain rotation effect in the Preview panel.

image-20231228161752675

Below is the effect of specifying the same bone chain with the same rotation axis, but different rotation angles:

Angle:60°Angle:-45°