component::UpdateRig

Saves the modified rig and invert graphs back into a packed character geometry.

On this page	Inputs Outputs
Since	21.0

This subgraph is the counterpart to component::GetRig. After fetching and modifying a rig graph with component::GetRig, this node saves the changes back into the character’s packed folder structure. It serializes both the main rig graph and invert graph (if present) to geometry and packs them into the character folder structure.

This subgraph is used in all rig components to persist graph modifications. It works together with component::GetRig to enable daisy chaining multiple rig components, in particular for the AutoRig Builder workflow.

The character ports of this node are in-place ports, which means the character geometry is updated without creating a copy.

Inputs ¶


                *character:
                    Geometry

Required

The character folder structure to update with the modified rig graphs.


                graph_name:
                    String

The name of the rig graph that is updated. This is used to determine the folder path and file name for packing. It can include the .rig extension.


                graph:
                    ApexGraphHandle

The modified rig graph to save into the character folder structure.


                bypass:
                    Bool

If set to True, returns the character input unchanged. This is useful when daisy chaining multiple components in the AutoRig Builder, where only the final component needs to perform the actual save. If set to False, saves the graph and invert_graph inputs to the character folder structure.


                invert_graph:
                    ApexGraphHandle

The modified invert graph to save into the character folder structure. This is saved only if the graph contains a parms node, indicating that it has valid content.

Outputs ¶


                *character:
                    Geometry

The updated character folder structure with the packed rig graphs, or a pass-through of the character input if bypass is set to True. The rig graph is added to the character folder structure with the .rig extension, and the invert graph is added with the .invert extension. Both graphs are set to invisible in the character folder structure (they are not visible in the viewport, see the Pack Folder SOP for more information).


                graph_name:
                    String

Pass-through of the graph_name input.


                graph:
                    ApexGraphHandle

Pass-through of the rig graph input.


                invert_graph:
                    ApexGraphHandle

Pass-through of the invert_graph input.

Inputs ¶

Outputs ¶

APEX nodes