Editing Blend Spaces

The Blend Space Editor provides the ability to set up the Blend Parameters of the BlendSpace as well as graphically edit the positions of Sample poses and interactively see the results of blending between those Sample poses.

Interface

TestBlendShape.png

  1. Parameters - Blend Parameters property section for setting up the BlendSpace.

  2. Samples - Editable list of all Samples in the BlendSpace.

  3. Options - Preview options for the BlendSpace.

  4. Graph - 2D graph for placing Samples and previewing blending between them.

Setting up Parameters

Parameters for the BlendSpace are set up in the Parameters section of the UI.

Blendspace Parameters

The Blend Parameters of a Blend Space represent the input values used to drive the blending between sample poses. Each Blend Space has two Blend Parameters (X and Y) and each Blend Parameter has the following properties:

Property Description
Label The readable name displayed in the BlendSpace Editor along the axis for this input and on the data pin for this input on the BlendSpace node in the AnimGraph of a Animation Blueprint.
Range The minimum and maximum values to which any input data will be clamped.
Divisions The number of sampled points from the animation data used for interpolating. Higher values give more precise results. Displayed as grid lines in the BlendSpace Editor along the axis for this input.

Once the appropriate values have been set for each of the Blend Parameters, pressing the Apply Parameter Changes button will apply the values to the BlendSpace, updating the Graph.

BlendSpaceSetup.png

Working with Sample Poses

The Sample Data for the Blend Space is a collection of animations and sample values. The sample values are used to determine the weight of that particular animation. For instance, using the directional movement example above, a Run_Fwd animation with a sample value of (0.0, 250.0, 0.0) would be fully blended to when the direction input was 0.0 and the speed input was 250.0.

Adding Samples

Samples are added to a BlendSpace by dragging an AnimationSequence from the Asset Browser into the Graph.

When working with AimOffset BlendSpaces, the AnimationSequences must have Additive Anim Type set to AAT_RotationOffsetMeshSpace in order to be added as Samples.

BlendShapeDragDrop.png

A node is placed at the location in the Graph:

Sample node

Positioning Samples

Samples can be moved to different positions interactively or manually. Moving Samples interactively is very intuitive, but does not provide the preciseness of manually setting the Sample's position.

To interactively move a sample:

Click and dragging the node in the Graph:

Move Sample by Dragging

To move a sample manually:

Click the node and then specify the X and Y values to place the node at:

Move Node Manually

Replacing Samples

Samples placed in the BlendSpace can be replaced with another Sample in the Graph via drag and drop or using the Samples section of the UI.

To replace by drag and drop:

To replace a sample in the Graph, drag a new AnimationSequence from the Asset Browser directly on to the existing node.

Replace Sample by Dragging

Original Sample Replaced Sample
Original Sample Replaced Sample

To replace manually:

To replace a sample in the Samples section, select a new AnimationSequence in the Content Browser and press the Use Selected Asset button for the Sample in the list.

In this case, you must select your AnimationSequence from the Content Browser. This operation will not read any assets selected in Persona's Asset Browser.

Select New Animation

Replace Sample Manually

Removing Samples

Samples can be deleted directly in the Graph or using the Samples section of the UI.

To delete in the Graph:

Select the Sample node in the Graph to display the edit dialog and press the Delete button to remove the Sample.

Remove Sample in Graph

To delete in the Samples section:

Press the Remove Sample button for the Sample to be removed from the list.

Remove Sample Manually

Previewing

The result of the blending between poses can be previewed interactively in the Viewport panel of Persona using the Graph. The position of the cursor determines the values of the X and Y parameters used for performing the blending and the resulting pose is displayed in the Viewport panel.

To enable previewing for the BlendSpace, check the Enable Preview BlendSpace option in the Options section of the UI.

Enable Preview Blendspace Option

Once previewing is enabled, moving the cursor around in the Graph will cause the Viewport panel to display the blended pose corresponding to the position of the cursor. The grid block the cursor is within is shaded and values representing the blending between the sample points making up the block are displayed.

Graph Grid Block

Detailed information about the cursor location and the Samples being blended can be viewed by checking the Enable Tooltip Display option.

Enable Tooltip Display Option

Graph Tooltip

An example of a previewing a Blend Space is illustrated below.