Houdini 22.0 Character KineFX

Working with motion capture

Import and stream motion capture data.

On this page

You can import saved or live-streamed motion capture data from disk in addition to more traditional ways of bringing animation into KineFX (like FBX).

Import motion capture data

  1. Import the rigged character you want to use motion capture animation data with.

    For information on how to import your rig into KineFX, see Bringing animation and character data into KineFX.

  2. Set-up an animation retarget network for your rigged character in the traditional manner, but at the bring in your source and target stage stage of the process, use a Mocap Import SOP node as the source for the animation.

    For information on how to set-up an animation retarget network, see Transferring animation.

  3. Create the Mocap Import SOP node, connect it to your retargeting network, and then open the Parameter Editor.

  4. In the Parameter Editor, do the following:

    • Select a file type that matches your motion capture data from the File Type parameter drop-down menu. You can choose from: Acclaim (.amc; .asf), BioVision (.bvh), and Motion Analysis (.trc).

    • In the File menu for your motion capture data type, specify the network path to the motion capture data file you want to use as the source animation for your retarget.

    Example: Mocap Import SOP parameters
  5. Set any other node parameter settings that you desire.

  6. Most motion capture data does not come with a rest pose (rest_transform attribute). If you motion capture file does not have a rest pose, then you need to create a rest pose for it.

    Create a Rig Stash Pose SOP node.

    The Rig Stash Pose SOP node will replace the rest pose in the source with a new rest pose.

  7. Select the Rig Stash Pose SOP and open the Parameter Editor.

  8. In the Parameter Editor, do the following:

    • Set the Mode to Store.

    • Make sure that the rest_transform attribute name is present in the Attribute Name parameter field.

    Example: Rig Stash Pose SOP parameters
  9. Connect the output of the source’s KineFX character import node to the rig input (input 1) of the Rig Stash Pose SOP.

    Example: Mocap Import SOP retarget network
  10. Select the Rig Stash Pose SOP node, click in the viewport, and then press Enter. You are now in the Rig Stash Pose viewport state.

  11. In the viewport, use the transform handles to pose your motion capture’s skeleton into a t-pose.

    Example: Motion capture skeleton’s new pose in the viewport
  12. Connect the output of the Rig Stash Pose SOP node to the input of your retarget network’s Rig Match Pose SOP node.

    The new rest_transform attribute will be passed downstream to the rest of the retarget network’s nodes and the Rig Match Pose SOP in your retarget network will now use the new rest pose.

    Example: Erik with source mocap animation. Character model courtesy of Christophe Desse.

Stream motion capture data

  1. Import the rigged character you want to drive with streaming motion capture animation data.

    For information on how to import your rig into KineFX, see Bringing animation and character data into KineFX.

  2. Set-up an animation retarget network for your rigged character in the traditional manner, but at the bring in your source and target stage stage of the process, use a Mocap Stream SOP node as the source for the animation.

    For information on how to set-up an animation retarget network, see Transferring animation.

  3. Create the Mocap Stream SOP node, connect it to your retargeting network, and then open the Parameter Editor.

    Example: Mocap Stream SOP retarget network
  4. In the Parameter Editor, go to the Device section and set the node parameter settings that you need to be able to see your actor’s movements drive your retargeted character in the viewport.

    • Select the mocap device that you want to use with the Mocap Stream SOP from the Mocap Device parameter’s drop-down menu.

    • Specify the Port to which the motion capture device’s client will connect to send its data.

    • Select any other motion capture streaming settings you desire.

    • Ensure that your motion capture device’s client software is streaming and then click Connect to start.

    Example: Mocap Stream SOP Device parameters
    Example: Rokoko live stream driving Erik’s animation in Houdini. Rokoko example scene courtesy of Rokoko Studio. Erik character model courtesy of Christophe Desse.
  5. To record your motion capture session, go to the Recording section in the Mocap Stream SOP node’s parameters, set or use the recording settings as needed.

    Example: Mocap Stream SOP Recording parameters

KineFX

Overview

Preparing character elements

Rigging with APEX graphs

  • APEX graph basics

    Introduction to the APEX graph evaluation framework.

  • APEX graph debugger

    Inspect the values of an APEX graph’s ports within the APEX network view.

  • APEX Script basics for graph building

    An overview of APEX Script, a code interface for building APEX graphs.

  • Graphs for numerical operations

    Example graphs of numerical operations like adding two values, fetching multiple results, and retrieving information from geometry.

  • Graphs for viewport animation

    Example graphs of animate state functionality like creating controls and constraints, and defining joint hierarchies.

  • Graphs for deforming geometry

    Example of a SOP network and APEX graph for deforming a 3-joint tube geometry.

  • Graph metadata

    Information added to graph nodes and ports.

  • APEX path pattern

    A set of rules that allow you to filter and select elements within graphs, skeletons, geometry, and the character folder structure.

  • APEX graph nodes

    APEX nodes provide operations for building up the functionality of APEX graphs, which are used in KineFX to create character rigs and perform other geometry manipulation.

  • APEX updates for H22

    New and updated APEX graph nodes for Houdini 22.

Building rig graphs with APEX Script

Rigging with rig components

Animating in the viewport

  • Animation workflow

    Example networks of adding characters, props, characters, and animation to a scene.

  • Animating in LOPs

    Rig and animate characters and props in the context of a USD stage.

  • Working in the animate state

    Select and manipulate controls, define transform limits for controls, and add skin controls to a character.

  • Animate state menus and HUDs

    Menus, HUDs, toolbars, and options in the animate state.

  • Animate state hotkeys

    Hotkeys available in the animate state.

  • Posing

    Pose characters in the animation scene by using locators, copying and pasting controls, and mirroring poses.

  • Motion paths

    Visualize the motion of controls as curves in 3D space.

  • Constraints

    Create relationships between controls in the animate state.

  • Dynamic motion

    Add physically-accurate projectile motion to your animation in the animate state.

  • Ragdoll

    Add a ragdoll simulation to your animation in the animate state.

  • Full body IK

    Apply full body inverse kinematics to pose the character using high-level targets rather than manipulating individual joints.

  • Secondary motion

    Add physically-accurate effects like lag/overshoot, jiggle, and spring to your animation in the animate state.

  • Control selection sets

    A tree view of controls, selections, and selection sets for the animate state. Allows management of control selection and visibility.

  • Motion mixer

    Combine and edit the animation clips of multiple characters in a timeline-based view.

  • Character picker

    Create a 2D layout with simple buttons for selecting character controls in an animation scene.

  • Animation catalog

    Save, manage, and apply animations and single-frame poses to an animation scene.

  • Animation layers

    Create multiple layers of animation without affecting the original animation.

  • Animation toolbar

    A customizable toolbar consisting of simple slider tools that quickly apply modifications to animation controls and curves.

  • Animation bookmarks

    Frame markers that help organize and identify the different parts of your animation.

Customizing the animate state

SOP-based animation

  • Physics-based motion

    Add physically-accurate motion to your animation using the Projectile Motion and Pendulum Motion SOPs.

  • Ragdoll simulations

    Add a ragdoll simulation to your animation using the Ragdoll Solver SOP.

Deformation

  • Blend shapes

    Create blend shapes using blend shape SOP nodes.

Animation retargeting

Pre-H20

Panes

  • Motion mixer

    A timeline-based view of the animation clips and motion effects of multiple characters.

  • Character picker

    Create a 2D layout with simple buttons to select character controls in an animation scene.

  • Rig tree view

    A hierarchical view of character components, including packed character folders, KineFX rigs, and Object node rigs.

  • Animation editor

    View and edit animated parameters and their transitions between keyframes.

  • Geometry spreadsheet

    Displays details about the geometry selected in the network editor.

Appendix