Houdini 22.0 Character KineFX

Set Driven Keys

Drives transforms and channels on multiple nodes with a single driver value or animation clip.

Since 22.0

This component reads animation stored in a clip and plays it back according to the value of a driver. As the driver moves between Fit Min and Fit Max, that range is remapped onto the clip’s frame range (Start Frame to End Frame), and the evaluated translate, rotate, and scale (as well as float, vector, bool, and int channels) are applied to the driven nodes.

The driver can be an existing control, a new control created by this component, or a slider added to the component’s menu. Add a setup for each driver relationship you want to create.

For a step-by-step walkthrough of using this component with the APEX Rig Pose SOP, see working with set driven keys. The APEX SetDrivenKey recipe provides a ready-made example setup.

Parameters

Name

The name to add to the nodes created by this component.

Setups

Each setup defines one driven-key relationship: a driver, the nodes it drives, the animation clip, and how the driver value is remapped onto the clip. Add a setup for each driver you want to set up.

Settings

Animation Layer

The animation layer in the clip to read channels from. If Driver is empty, the animation layer name is used as the driver name.

T

When turned on, the translation channels from the clip are applied to the driven nodes.

R

When turned on, the rotation channels from the clip are applied to the driven nodes.

S

When turned on, the scale channels from the clip are applied to the driven nodes.

Start Frame

The frame the driver’s Fit Min value maps to.

End Frame

The frame the driver’s Fit Max value maps to.

Clip Path

The path to the animation clip that stores the channels used to drive the nodes.

Driven

Nodes

A pattern that selects the TransformObject nodes to drive. This parameter accepts APEX path patterns, so you can specify tags in this field, for example #<tag>.

Driver

Driver

The control whose value drives the animation. If the control doesn’t exist, it is created by this component. If left empty, the Animation Layer name is used. Append a channel name to drive a single channel, for example myControl:ry.

Fit Min

The driver value that maps to the Start Frame of the clip.

Fit Max

The driver value that maps to the End Frame of the clip.

Parent

Parent

The parent of the driver control when a new control is created by this component. This parameter accepts APEX path patterns, so you can specify tags in this field.

Tags

Tags

The tags to add to the driver controls created by this component.

Shape

The APEX Configure Controls SOP provides more options for changing the look of the controls.

Shape

The shape of the controls. It can be set to any of the built-in APEX control shapes.

Color

The color of the control shapes.

Translate

The translation of the control shapes.

Rotate

The rotation of the control shapes.

Scale

The scale of the control shapes.

See also

KineFX

Overview

Preparing character elements

Rigging with APEX graphs

Building rig graphs with APEX Script

Rigging with rig components

Animating in the viewport

Customizing the animate state

SOP-based animation

Deformation

Animation retargeting

Pre-H20

Panes

Appendix