MAXScript Extensions > MAXScript Extensions for character studio > Biped MAXScript Extensions > Biped Motion Capture >

# Biped Motion Capture

| Character Studio - Quick Navigation

All motion capture properties in Biped are global parameters and cannot be varied from Biped to Biped. Hence they are exposed as system globals residing in the mocap struct.

Properties

    mocap.		fsExtractionMode Integer Default: 0

0 - None: Freeform - No footsteps are extracted.

1 - On - Extract footsteps.

2 - Fit to existing - For motion data that has both footstep motion and flying, swimming, falling, or tumbling motions.

    mocap.fsConversionMode Integer Default: 0

0 - No Key Reduction - Do not reduce keys. Use this on files that are already key reduced or if you want to work with all the data in a raw motion capture file.

1 - Use Key Reduction - Reduce keys for simpler key editing.

2 - Load Buffer Only - Do not apply the data to the biped, load the data to the motion capture buffer only. Use this to either compare your edited version with the original or to paste postures from the motion capture buffer to the biped in the scene.

    mocap.upVector Integer Default: 2

Set the vertical axis used in the motion capture data.

0 - X

1 - Y

2 - Z

    mocap.scaleFactor Float Default: 1.0 -- range: 0+

Multiply the stored talent size by this value and size the biped accordingly.

## Footstep Extraction

    mocap.fsExtractionTol Float Default: 0.07 -- range: 0+

Set the sensitivity of footstep extraction. Biped determines if the footstep is there by checking that the foot does not move beyond the distance determined by the Extraction Tolerance value. Smaller numbers are more sensitive and extract more footsteps. Value is a percentage of foot length.

    mocap.fsSlidingDist Float Default: 25.0 -- range: 0+

Create a sliding footstep when positional tolerance is reached. This value is a percentage of foot length. By default the foot must slide its own distance (100), before a sliding footstep is created.

    mocap.fsSlidingAngle Float Default: 0.0 -- range: 0-360

Create a sliding footstep when rotational tolerance is reached. This value is in degrees. If this is set high (360 degrees), the foot must make a complete turn before a sliding footstep is created.

    mocap.fsUseVerticalTol Boolean Default: False

Turn on Z-axis Tolerance. The control filters out footsteps that do not fall within a given range of the ground plane. Use this when filtering motions, such as hopping or pitching a baseball, in which a foot may come off the ground and remain stationary, but its position is not intended as a footstep.

    mocap.fsVerticalTol Float Default: 0.5 -- range: 0+

Value is a percentage of leg length

    mocap.fsZLevel Float Default: 0.0

Set a Z value (ground).

    mocap.fsUseFlatten Boolean Default: False

Extracted footsteps are moved to Z=0. Use this to flatten out minor differences in the height of the extracted footsteps.

## Load Frames

    mocap.startFrame Integer Default: 0

Start importing at this frame. Default is frame 0, the first frame.

    mocap.endFrame Integer Default:0

Stop importing at this frame. Default is the last frame of the clip.

    mocap.loop Boolean Default: False

Loop the data by the value set here.

This is relative. Succeeding loops start where the previous loop left off. The clips are not blended and may require editing unless the original clip was designed to loop.

Use this for clips designed to loop.

Note

This often works best if Footstep Extraction is tuned off.

    mocap.loopFrameCount IntegerDefault: 0 -- range: 0+

Key Reduction Settings

Tolerance: Set the maximum angular or positional deviation for a track.

Values are in degrees for rotation tracks. Values are in units of translation for position tracks.

Minimum Key Spacing: Set the minimum number of frames between keys.

Tolerance is computed first, then Minimum Key Spacing computes further key reduction.

A Minimum Key Spacing value of 10 for the head track ensures that no two keys are closer than 10 frames for this track.

Set All: Force all tracks to the values set in these fields.

Higher values here can determine how much key reduction is possible while preserving the original motion.

Filter: Clear to prevent filtering of the motion capture data into a track. If this is cleared, there will be no key reduction for the track.

    mocap.allTol Float Default: 0.0 -- range: 0+

    mocap.allSpacing Integer Default: 3 -- range: 0+

    mocap.allFilter Boolean Default: False

    mocap.horzTol Float Default: 1.0 -- range: 0+

    mocap.horzSpacing Integer Default: 3 -- range: 0+

    mocap.horzFilter Boolean Default: True

    mocap.rotTol Float Default: 1.0 -- range: 0+

    mocap.rotSpacing Integer Default: 3 -- range: 0+

    mocap.rotFilter Boolean Default: True

    mocap.vertTol Float Default: 1.0 -- range: 0+

    mocap.vertSpacing Integer Default: 4 -- range: 0+

    mocap.vertFilter Boolean Default: True

    mocap.pelvisTol Float Default: 6.0 -- range: 0+

    mocap.pelvisSpacing Integer Default: 3 -- range: 0+

    mocap.pelvisFilter Boolean Default: True

    mocap.spineTol Float Default: 6.0 -- range: 0+

    mocap.spineSpacing Integer Default: 3 -- range: 0+

    mocap.spineFilter Boolean Default: True

    mocap.neckTol Float Default: 6.0 -- range: 0+

    mocap.neckSpacing Integer Default: 3 -- range: 0+

    mocap.neckFilter Boolean Default: True

    mocap.leftArmTol Float Default: 6.0 -- range: 0+

    mocap.leftArmSpacing Integer Default: 3 -- range: 0+

    mocap.leftArmFilter Boolean Default: True

    mocap.rightArmTol Float Default: 6.0 -- range: 0+

    mocap.rightArmSpacing Integer Default: 3 -- range: 0+

    mocap.rightArmFilter Boolean Default: True

    mocap.leftLegTol Float Default: 6.0 -- range: 0+

    mocap.leftLegSpacing Integer Default: 3 -- range: 0+

    mocap.leftLegFilter Boolean Default: True

    mocap.rightLegTol Float Default: 6.0 -- range: 0+

    mocap.rightLegSpacing Integer Default: 3 -- range: 0+

    mocap.rightLegFilter Boolean Default: True

    mocap.tailTol Float Default: 6.0 -- range: 0+

    mocap.tailSpacing Integer Default: 3 -- range: 0+

    mocap.tailFilter Boolean Default: True

## Limb orientation

Angle: Move the knee or Elbowposition to create the biped joint key.

Point:Rotate the shoulder-elbow-wrist or hip-knee-ankle to create the biped joint key.

Auto: Auto reads exact hand and foot positions from the motion capture data, character studio then places the knees and elbows in a natural position. For marker files involving running and walking, this option can clean up the data nearly instantly, regardless of how many markers were used (and where they were placed).

    mocap.kneeOrient Integer Default: 1

0 - angle

1 - point

2 - auto

The biped knee hinge joints are perpendicular to the triangles formed by the hip-knee-ankle. Resolve errors in the motion capture data that break this rule by using either the angle or point method.

    mocap.elbowOrient Integer Default: 1

0 - angle

1 - point

2 - auto

The biped elbow hinge joints are perpendicular to the triangles formed by the shoulder-elbow-wrist. Resolve errors in the motion capture data that break this rule by using either the angle or point method.

    mocap.footOrient Integer Default: 0

0 - angle

1 - auto

The biped foot hinge joints are perpendicular to the triangles formed by the hip-knee-ankle respectively. Resolve errors in the motion capture data that break this rule by using either the angle or point method.

    mocap.handOrient Integer Default: 0

0 - angle

1 - auto

The biped hand hinge joints are perpendicular to the triangles formed by the shoulder-elbow-wrist. Resolve errors in the motion capture data that break this rule by using either the angle or point method.

## Talent Definition

    mocap.talentFigStrucFile String Default: ""--figure structure file (.fig)

A .figfile containing changes made to the biped scale while in Talent Figure mode.

    mocap.useTalentFigStrucFile Boolean Default: False

Turn on useTalentFigStrucFile to use the file whose string is defined in mocap.talentFigStrucFile.

    mocap.talentPoseAdjFile String Default: "" -- pose adjustment file (.cal)

A .cal file containing changes made to the biped while in Adjust Talent Pose mode.

    mocap.useTalentPoseAdjFile Boolean Default: False

Turn on useTalentPoseAdjFile to use the file whose string is defined in mocap .talentPoseAdjFile.

## Marker Name Files

    mocap.markerNameFile String Default: "" -- csm marker name file (.mnm)

A Marker Name file to map incoming marker names in motion capture files (.bvhor .csm) to the character studio marker naming convention.

    mocap.useMarkerNameFile Boolean Default: False

When set to true, use the file defined in mocap.markerNameFile.

    mocap.jointNameFile String Default: "" --bvh marker name file (.mnm)

A Marker Name file to map incoming marker names in motion capture files (.bvhor .csm) to the character studio marker naming convention.

    mocap.useJointNameFile Boolean Default: False

When set to true, use the file defined in mocap.jointNameFile.

## Marker Display Options

Marker and marker names are displayed around the biped. Discrepencies like the biped elbow position relative to the elbow marker can be spotted and adjusted.

    mocap.dispKnownMarkers Boolean Default: False
    mocap.dispKnownMarkersType Boolean Default: False

true - on all props

false - on selected props

    mocap.dispPropMarkers Boolean Default: False
    mocap.dispUnKnownMarkers Boolean Default: False

## Load Save Methods

    mocap.loadParameters <file_name> mocap.saveParameters <file_name>

Load/Save a motion capture parameter (.MOC) file

#### See Also

- MAXScript Extensions in character studio