Created and last modified by shapiro on Oct 30, 2013

Description

SmartBody blends consist of one or more animations that can be parameterized in multiple ways. For example, a blend could consist of a set of walking, jogging and running motions, or several animation of the character pointing in different directions. Such blendscan be controlled programmatically (such as through the locomotion controllers) or directly via BML. This can be used, for example, for controlling a character's locomotion interactively.

Requirements

The single animation, one-, two- or three- dimensional blendmust be created first. Please see the section on Creating Blends for more details.

Usage

<blend name="allJump"/>
<blend name="allLocomotion" x="100" y="2" z="-20"/>

Parameters

ParameterDescriptionExample
name

Name of the blend to use. (Required)

<blend name="allJump"/>
mode

Whether a new blend is being scheduled, or the

current one is being updated.

Options:

  • update
  • schedule

Default: schedule

<blend mode="schedule" name="allJump"/>
sbm:wrap-mode

Wrap mode of the blend .

Options:

  • Loop
  • Once

Default: Loop

<blend name="allJump" sbm:wrap-mode="Loop"/>
sbm:schedule-mode

Schedule mode of the blend .

Options:

  • Now
  • Queued

Default: Queued

<blend name="allJump" sbm:schedule-mode="Now"/>
sbm:blend-mode

Blend mode of the blend .

Options:

  • Overwrite
  • Additive

Default: Overwrite

<blend name="allHeadTilt" sbm:blend-mode="Additive"/>
sbm:partial-jointStarting joint inside skeleton hierarchy that defines the affected blending joints
<blend name="allHeadTilt" sbm:partial-joint="spine4"/>
x

First parameter value of the blend .

The only parameter for a 1D blend , or the

first parameter for a 2D or a 3D blend

<blend mode="schedule" 
name="allStartingLeft" x="90"/>
y

Second parameter value of the blend .

Second parameter for a 2D or a 3D blend
<blend mode="schedule" 
name="allStep" x="22" y="45"/>
z

Third parameter value of a 3D blend .

<blend mode="schedule" 
name="allLocomotion" x="100" y="2" z="-20"/>
startTime offset to schedule the blend .
<blend name="allJump" start="3.0"/>