Houdini 20.5 Nodes Geometry nodes

Agent Animation Unpack geometry node

Extracts animation or MotionClips from an agent primitive.

On this page
Since 18.5

This SOP creates animated skeleton geometry from an agent primitive’s pose, and is equivalent to the third output of Agent Character Unpack. Alternatively, the SOP can also create MotionClips from an agent’s animation clips.

Parameters

Unpack

Group

Specifies the input agent(s) to unpack.

Group Type

The type of group that Group specifies.

Guess from Group

Infers the type of group that is specified based on the contents of Group.

Points

Unpacks the agents from the specified point group.

Primitives

Unpacks the agents from the specified primitive group.

Output

Specifies whether to output animated skeleton geometry or MotionClips.

Current Pose

Creates skeleton geometry from the agent’s transform hierarchy and current pose.

Agent Clip Pose

Creates skeleton geometry from the agent’s transform hierarchy and a pose sampled from the specified agent clip.

Rest Pose

Creates skeleton geometry from the agent’s transform hierarchy and rest pose.

MotionClip

Creates a MotionClip from one of the agent’s clips.

Packed MotionClips

Creates several MotionClips from the agent’s clips. Each MotionClip is contained inside a packed geometry primitive.

New Clip Name

Specifies a name for the animation clip. This is saved to the clipinfo detail attribute.

Agent Clip Name

When Output is Agent Clip Pose or MotionClip, specifies which of the agent’s clips to use.

Agent Clip Names

When Output is Packed MotionClips, specifies a list or pattern of the agent’s clips to convert to MotionClips.

Rig Color

When Output is set to Skeleton or MotionClips, this is the point color to use for the skeleton joints.

Transfer Attributes

Specifies a list or pattern of attributes to transfer from the agent primitive to the skeleton geometry.

Transfer Groups

Specifies a list or pattern of groups to transfer from the agent primitive to the skeleton geometry.

Timing

Method

The time units for specifying animation parameters.

By Time

The timing parameters below will be specified in seconds.

By Frame

The timing parameters below will be specified in frames.

Time

The time (in seconds) to import the animated pose from.

Animation Start

The time at which the source animation starts, when Method is set to By Time. Earlier poses will be clamped to this value. When turned off, this value is taken from the source animation where available. If it has no range information, Houdini’s scene start ($TSTART) value will be used.

Note that no clamping is done when this is turned off.

Animation End

The time at which the source animation ends, when Method is set to By Time. Later poses will be clamped to this value. When turned off, this value is taken from the source animation where available. If it has no range information, Houdini’s scene end ($TEND) value will be used.

Note that no clamping is done when this is turned off.

Playback Start

The destination time at which the specified animation will begin to playback, when Method is set to By Time. When turned off, Houdini’s scene start ($TSTART) value is used.

Frame

The frame number to import the animated pose from.

Animation Start

The frame at which the source animation starts, when Method is set to By Frame. Earlier poses will be clamped to this value. When turned off, this value is taken from the source animation where available. If it has no range information, Houdini’s scene start ($FSTART) value will be used.

Note that no clamping is done when this is turned off.

Animation End

The frame at which the source animation ends, when Method is set to By Frame. Later poses will be clamped to this value. When turned off, this value is taken from the source animation where available. If it has no range information, Houdini’s scene end ($FEND) value will be used.

Note that no clamping is done when this is turned off.

Playback Start

The destination frame at which the specified animation will begin to playback, when Method is set to By Frame. When turned off, Houdini’s scene start ($FSTART) value is used.

Speed

Sets the speed factor for the playback of the animation. This is applied after any clamping is performed by the Animation Start and Animation End parameters.

Attributes

clipinfo

This detail attribute records the current animation range and sample rate, as well as the original animation range and sample rate of the imported animation.

Inputs

Agents

Agent primitive(s) to unpack.

Outputs

Animated Pose

The character’s animated pose or MotionClip.

Examples

AgentClipToMotionClip Example for Agent Animation Unpack geometry node

This example demonstrates converting agent clips into SOP MotionClips, editing the animations using MotionClip tools, and then importing the modified MotionClips into the agent definition.

See also

Geometry nodes