Description

Automatically assigns the appropriate side (left, right, or center) and part (for example, knee, head, etc) to each bone that has active DoFs. Note that:

It operates on the current subject's retargeting setup.
It sets sides and parts for bones that have 1 or more active DoFs.

For the command to run without errors, ensure the following:

There is a current subject.
The current subject has a retargeting setup.
Map mode is enabled.
The facing direction of the target skeleton is +- Y or Z.

You are warned if the sides and parts could not be set.

Functional area

Data Manipulators

Command syntax

Syntax

autoSetSideAndParts [-tolerance float]

Arguments

None

Flags

Name	Flag arguments	Argument type	Comments
`tolerance`		float	The tolerance (in mm) controls the distance from the root at which bones are not considered to be center and are assigned to the left or right side. If a skeleton's spine and neck aren't perfectly aligned with the root, you can set the tolerance to account for this. Default: 1 mm, range 0–∞

Return value

void

Examples

// Run autoSetSideAndParts with an increased tolerance because the skeleton has 
// a spine that is not well aligned with the root.
autoSetSideAndParts -tolerance 5.0;