Houdini 22.0 Nodes Geometry nodes

APEX Scene Import Animation geometry node

Imports multiple animations from files, animation catalogs, or SOPs into an animation scene.

On this page
Since 22.0

This node imports multiple animations into an animation scene, where the scene is in a character folder structure. This node can perform multiple imports using file patterns, and provides the same features as the APEX Scene Copy Animation SOP.

You can drag and drop animation from the animation catalog into the APEX Scene Import Animation viewer state, which automatically creates an entry in the Imports multiparm for the animation.

See the animation workflow page for an example of how to import animation from an animation catalog.

Parameters

Reload Files

Forces a reload of the animation and catalog files.

Active Clip

Sets the active clip of the scene after importing the animation clips. Leave this empty to keep the active clip from the input scene.

Imports

The files to import. When the checkbox beside each multiparm entry is turned on, the file is imported.

Mode

Specifies how the file is processed.

Files with Single Clip

Copies a single clip per file to the scene.

Files with Multiple Clips

Copies all the clips in the file to the scene.

Animation Catalog

The files are animation catalog files, and the animation catalog metadata is used to select which animation is copied to the scene. The original character path and animation name are used.

SOPs with Single Clip

Imports from SOPs inside the current Houdini scene.

Copy Existing Clip

Copies from a clip in the current scene.

Create Empty Clip

Create an empty clip.

Files Pattern

When Mode is set to Files with Single Clip, Files with Multiple Clips, or Animation Catalog, this is a pattern that specifies the geometry files to import. For Files with Single Clip and Files with Multiple Clips, the geometry must contain the /animation folder structure with the clips. For Animation Catalog, the file must be an animation catalog geometry file.

The pattern can contain wildcards, for example, $HIP/animation/*.bgeo.sc imports from all the files in the animation folder. You can separate patterns with “;”.

SOPs Pattern

When Mode is set to SOPs with Single Clip, this is a pattern that specifies the SOP node paths to import. The pattern can contain wildcards, for example, ../ANIMS_* imports from all the SOP nodes that start with the ANIMS_ prefix. You can separate patterns with spaces.

From

When Mode is set to Files with Single Clip, Files with Multiple Clips, SOPs with Single Clip, or Copy Existing Clip, this is the clip path to import. For Files with Multiple Clips, this can be multiple clip paths, for example, “/animation/*.clip ^/animation/default.clip” imports all the .clip animations, but not default.clip.

Clips

When Mode is set to Animation Catalog, these are the clips to import. The clip name comes from the name of the animation in the animation catalog, where spaces in the animation name are replaced with underscores, for example, wave hi becomes wave_hi. You can separate multiple clip patterns with spaces.

To

The target clip path. The {} token is replaced with the appropriate name based on the Mode.

When Mode is set to Files with Single Clip, the {} token is replaced with the filename, excluding the folder name and file extension. Spaces are replaced with underscores.

When Mode is set to Files with Multiple Clips, the {} token is replaced with the original animation .clip name.

When Mode is set to Animation Catalog, the {} token is replaced with the animation name from the catalog. Spaces are replaced with underscores.

When Mode is set to SOPs with Single Clip, the {} token is replaced with the node name.

Rig

The path to the rig that contains the animation being copied, for example, /Electra_Jump.char/Base.rig. Populate this field along with Rename Rig to rename the rig path. This field is optional.

Rename Rig

The renamed path to the rig that contains the copied animation, for example, Electra.char/Base.rig. Populate this field along with Rig to rename the rig path. This field is optional.

Copies

When Mode is set to Copy Existing Clip, this is the number of copies to create.

Copy

The name for the copied clip. The {} token in the name is replaced with the original clip name.

New Clips

When Mode is set to Create Empty Clips, this is the number of new clips to create.

New Clip

The name for the new clip. The {} token is replaced with an index.

Inputs

APEX Scene

The animation scene to add the animation to.

Outputs

APEX Scene

The animation scene with the added animation.

See also

Geometry nodes