Biped Footprints

Methods

biped.addFootprint <biped_ctrl> <matrix3> [append:<boolean>]

Specifies the position and rotation of the footstep. The scale portion of the matrix3 should always be the identity matrix ([1,1,1]).

Creates a single footprint for the biped, where matrix3 specifies the position and rotation of the footstep. The scale portion of the matrix3 should always by unity ([1,1,1]).

Notes

Creates a single footprint for the Biped.

Global Properties

biped.fsAddSide Integer Default:0

0 - Start Right

1 - Start Left

Notes

For multiple footstep creation, the starting foot needs to be identified. There is a UI radio button in the Multiple Footstep Creation dialog "Start Right/Start Left". The biped global property, fsAddSide, exposes access to this UI element.

This property also effects the start foot when manually creating footsteps in the viewports and when using biped.addFootprint. If the biped.fsAddSide is 1, a left footstep is created. If 0, a right footstep is created. When you create a footstep in the viewports or by using biped.addFootprint, the value of biped.fsAddSide is flipped, resulting in alternating footsteps being created by default.

Methods

biped.multipleFSDlg <biped_ctrl>

Displays the Multiple Footstep Creation dialog

biped.getMultipleFSParams <gait_type_name>

Returns an instance of MultFprintParams, gait_type_name can be #walk, #run or #jump. For information on MultFprintParams and gait_type_name see Biped MultFprintParams ClassBiped_MultFprintParams_Class.

The following example will obtain the MultipleFSParams for a walk cycle, set several of its values and then show all of the properties.

Example:

walk = biped.getMultipleFSParams #walk

walk.numFootsteps = 5

walk.actualStrideWidth = 2.5

walk.paramStrideWidth = 2.5

walk.actualStrideLength1 = .6

walk.paramStrideLength1 = .6

walk.actualStrideHeight1 = .6

walk.cycle1 = 6

walk.actualStrideLength2 = .7

walk.paramStrideLength2 = .7

walk.actualStrideHeight2 = .7

walk.cycle2 = 7

walk.autoTiming = true

walk.interpTiming = true

walk.alternate = true

walk.multiInsertInTime = true

showProperties walk

Method

biped.addMultipleFootprints <biped_ctrl> <MultFprintParams>

Create footsteps for a Biped based on the MultFprintParams value

biped.newFootprintKeys <biped_ctrl>

Activates all inactive footsteps. Activation creates default keys for any footsteps that do not have them. If a footstep does not have keys, it is displayed as bright green (right foot) or bright blue (left foot). After keys are created for the footsteps, the footsteps change color to pastel green and pastel blue.

Create Biped keys for inactive footsteps on the Biped

The following example will create a biped, create 10 footsteps and then have Biped create default keys for the footsteps.

Example:

-- create a Biped

bipObj = biped.createNew 100 100 [0,0,0]

-- get the transform controller for the Biped

bip = bipObj.transform.controller

-- get the multiple footstep parameters interface

mfsp=biped.getMultipleFSParams #walk

-- set the number of footsteps to 10

mfsp.numFootsteps=10

-- create the inactive footsteps

biped.addMultipleFootprints bip mfsp

-- create the Biped keys for inactive footsteps

biped.newFootprintKeys bip

See also