Houdini 21.0 Nodes APEX nodes

component::GetRig 1.0

Loads a rig graph and its invert graph from a packed character geometry.

On this page
Since 21.0

Extracts and loads an APEX rig graph from a character’s packed folder structure. The function normalizes the graph name, unpacks the corresponding geometry, and loads both the main rig graph.

This subgraph is used in all rig components to fetch the rig graph. It serves as the standard method for connecting rig components together, particularly for the AutoRig Builder workflow.

Inputs

character: Geometry

The packed character geometry containing the rig graphs in its folder structure.

graph_name: String

The name of the rig graph to load. Can include or exclude the '.rig' extension and leading slashes - these are normalized automatically. For example, 'Base', '/Base', 'Base.rig', and '/Base.rig' all resolve to the same graph.

graph: ApexGraphHandle

An existing graph handle to use when bypass is True. When bypass is False, this input is ignored and replaced with the loaded graph.

bypass: Bool

If True, skips loading and returns the input graph and invert_graph unchanged. This is useful for passing through pre-loaded graphs if you want to daisychain multiple components together, this happens for example in the autorig builder and significantly improves the performance of the rig builder. If False, loads the graphs from the character geometry.

Outputs

character: Geometry

The input character geometry (unchanged).

graph_name: String

The normalized graph name with '.rig' extension and leading slash (e.g., '/Base.rig').

graph: ApexGraphHandle

The loaded rig graph from the character, or the input graph if bypass is True.

See also

APEX nodes