Skip to content

Biped guide

The biped in examples/biped demonstrates layered body and face rigging, pose correctives, a control picker, and touch regions. Its eye shader is under its own EULA; see third-party notices.

Open a stage

bin\launch_usdview.bat examples\biped\Biped_stack.usda

On Linux or macOS, use bin/usdview.sh with the same stage path. Biped_stack.usda composes the face and body branches. Open Biped_body.usda for the body branch alone, or Biped.usda for the body rig flattened into one file. The asset README lists the available layers and their composition.

Controls

Area Controls
Root M_Body moves the body, under the Main, Shot, and Aux masters
Spine and neck Root, middle, and end controls shape the spline chains
Girdles Clavicle and pelvis controls carry their limbs
Limbs IK effectors and poles, plus FK controls
IK/FK blend avars:ikfk on L_Arm, R_Arm, L_Leg, and R_Leg; 0 is FK, 1 is IK
Feet Heel, toe, ball-roll, and bank controls beneath the leg IK controls
Face Skull, upper/lower face, jaw, nose, eyes, brows, and mouth layers

Switch a limb between IK and FK with its button in the Control Picker, or by right-clicking any of its controls in usdview and choosing Switch ... to IK (or FK). The switch first matches the half that takes over to the limb's current joints, so the limb does not move, and the whole change is one undo step. In animation write mode the switch keys the channels it sets.

Space switches (avars:space, in Biped_spaces.usda):

Control Spaces (index order) Default
L_ArmIK, R_ArmIK world, chest, head, hip_swivel, hips world
L_LegIK, R_LegIK world, hip_swivel, hips world
L_ArmPV, R_ArmPV world, chest, hand world
L_LegPV, R_LegPV world, pelvis, foot foot
L_UpArmSwing, R_UpArmSwing local, world, hips world
M_Neck, M_Head local, world, hips local
M_Look local, world local

The IK, pole and look spaces are full parent spaces. The shoulder swing, neck and head world and hips spaces are rotation-only (orient): the control keeps its rotation in that space while its position still rides on the body. "world" is the Aux master. A space button in the Control Picker switches without moving the control: it solves the control's translate and rotate channels in the new space, and the whole change is one undo step that keys in animation write mode.

The clavicles follow the arms (Biped_autoclav.usda): raising or swinging an arm turns its shoulder point about the clavicle by a fraction of the arm's swing, weighted by how far the arm is up, down, forward or back, so the shoulder lifts with a raised arm. In FK the swing is read from the FK upper arm; in IK it is estimated from the IK hand and pole. The arm itself keeps its orientation; only its root moves, and the skinned clavicle follows. The dial is avars:autoClav on L_Shldr and R_Shldr: 1 (the default) is the full effect and 0 turns it off. A matched IK/FK switch still leaves the arm where it is.

Use the RigExec viewport tools and graph editor to edit controls and animate scalar channels. Keep edits in a separate layer when comparing against the reference stage. Native transform controls, solver output joints, and corrective-shape drivers serve different purposes; moving an output joint does not replace the solver that drives it.

Composition and evaluation

The layered body separates center, left, and right data. Face and corrective layers add opinions over that body. Keep the relative file layout intact so sublayers and asset references resolve. Picker buttons and touch regions are USD prims and can be overridden in a stronger layer.

For command-line evaluation:

build\rigExecPose.exe examples\biped\Biped_anim.usda --frames 1,50,100,150,200 --joints

Conversion utilities used to produce these assets are not distributed with the repository. The checked-in stages are the supported starting point for this example; regenerate procedural examples through their own generators.