Houdini 22.0 Character KineFX

Importing animation and character data

Bring animation and character data into KineFX.

On this page

To perform an animation retargeting operation, you first need to bring in the source animation skeleton or character you want to retarget from, and the character you want to retarget to. This page describes several ways to import animation skeletons, captures (skins), and characters into KineFX.

Unpack SOP characters or import from disk

  • If you have a stashed or bundled animation skeleton or character (stored in a Stash SOP or Object Merge SOP), you can unpack the character data with a Character Unpack SOP.

  • If you want to unpack a SOP character’s data stream that is saved on disk and then have the option of using the sequence on disk or in a live stream, you can use a Character I/O SOP.

  • If you want to import a SOP animation skeleton or character that is saved in a file on disk, use a File SOP.

Bring in motion capture data

You can bring motion capture data into KineFX in the following ways:

  • Import Acclaim, BioVision, or Motion Analysis motion capture animation files with a Mocap Import SOP or through Houdini’s File ▸ Import ▸ Motion Capture.

  • Stream live motion capture data directly from Faceware Studio, Live Link Face, Optitrack Motive, Perception Neuron, Rokoko Studio, Vicon Shogun, or Xsens MVN with a Mocap Stream SOP.

  • Stream live raw motion capture data (UDP or TCP) with a Mocap Stream SOP.

For more information on importing and streaming motion capture to KineFX, see working with motion capture.

Bring in agents from Crowds

You can bring agents or agent clips into KineFX for use with SOP characters and MotionClips in the following ways:

Tip

If the animation skeleton generated by the Agent Animation Unpack SOP has a different joint hierarchy than the SOP character you want to retarget to, you can constrain the animation skeleton’s joints to the target character using a Rig Copy Transforms SOP.

Bring in USD data from Solaris or other sources

You can bring in the animation skeleton, character, or capture (skin) from a UsdSkel character (the Skeleton primitive underneath the SkelRoot primitive in a Solaris stage) in the following ways:

Import FBX data

You can import FBX files into KineFX in the following ways:

Import glTF data

You can import glTF files into KineFX in the following ways:

Bring in object-level character data or HDAs

You can use the Scene Character Import SOP to import object-level characters or HDAs into KineFX.

Imported object-level Simple Female character

For best results, do the following:

  1. Select the Scene Character Import SOP.

  2. In the Import tab, turn off every Type except Geometry. This imports only the geometry responsible for the skin deformation.

If there are issues with your character once it is imported into KineFX, see troubleshooting your characters.

Bring in character data from other DCCs

Troubleshooting your characters after importing into KineFX

Character’s global scale is off

If your imported animation skeleton or character is dramatically larger or smaller than it should be, your animation skeleton or character may come from a source that uses different world units than Houdini (for example, meters vs. centimeters). To fix this issue, turn on the Convert Units parameter on the KineFX import node you used to bring in your character or motion data.

If your source and target characters are dramatically different sizes, you can use the Rig Match Pose SOP’s bounding box matching to automatically resize and conform their skeletons.

Skeleton is broken into separate joint chains

If you import an animation skeleton or character into KineFX and parts of the hierarchy are no longer attached, you need to reattach the broken joint chains using a Skeleton SOP or Parent Joints SOP.

Reconnect joints using the Skeleton SOP
Reconnect joints using the Parent Joints SOP

Control objects are missing or garbled

If you import a character rig and the control objects don’t come through or the links between the control geometry and joints are broken, you need to reattach the control geometry to your character or attach new controls. For more information, see setting up control geometry.

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