In this example, we add a control shape to a character’s spine joint:

1. We start with a character’s skeleton and add it to a character folder structure using the APEX Pack Character SOP.

2. Create an FK rig graph - on the APEX Autorig Component SOP, fk, set Component Source to FK Transform. See rigging a simple geometry and rigging a character for more information about the FK transform component.

   The FK rig graph can be seen in the APEX network view. The green nodes are the TransformObject nodes that represent the skeleton joints:

   

3. Build the fuse graph in the APEX Graph SOP. The APEX Graph SOP can take in a character folder structure and automatically find the rig graph in the folder structure. You can also tell the APEX Graph SOP to find a specific rig in the character folder structure by setting the Graph Path parameter. Once the APEX Graph SOP has a starting graph, you can edit the graph manually in the APEX network view.

   In this example, the APEX Graph SOP contains a copy of the entire FK rig graph as a starting point. From here, you have the option of simplifying the graph to make it easier to work with in the APEX network view.

4. Select the APEX Graph SOP and go to the APEX network view to manually update the graph. Add a control shape to the spine joint by connecting a new rig::ControlShape node to one of the spine’s TransformObject nodes:

   

5. Select the rig::ControlShape node and press P over the APEX network view to open the node parameter window. Set color to (1,0,0) and shapetype to box_wires.

6. In the animate state, you can see a visual representation of the rig in the viewport as you update the graph in the APEX network view. To enter the animate state, select the APEX Graph SOP, turn on its display flag, and click Animate on the left toolbar:

   

7. Merge the graph from the APEX Graph SOP into the original FK rig graph - on the second APEX Autorig Component SOP, merge_graph, set Component Source to Fuse Graph. The fuse graph operation finds the new node and connects it into the original graph.

   See the merged graph in the APEX network view. On the APEX Autorig Component SOP, merge_graph, the rig::ControlShape node is added to the FK rig graph from the first APEX Autorig Component SOP, fk. The new node is in green:

   

The fuse graph operation allows you to create flexible tools that can be applied to different parts of a character’s rig. In this example, we manually construct a fuse graph that adds IK functionality to a character’s leg. We then mirror and transfer the IK functionality to the character’s arms:

1. In the APEX Graph SOP, we manually build a fuse graph that contains IK functionality for the character’s leg.

   Note

   The TransformObject node names in the fuse graph should match the joint names of the input skeleton.

   Select the APEX Graph SOP, turn on its display flag, and enter the animate state:

2. On the APEX Autorig Component SOP, merge_graph, set Component Source to Fuse Graph. The fuse graph operation adds the new IK functionality to the original FK rig graph.

3. Select the APEX Autorig Component SOP, merge_graph, turn on its display flag, and enter the animate state.

4. Set the IK functionality to be mirrored on both sides of the rig. On our rig, the joints are named <joint>_l and <joint>_r, so change the From and To parameters to *_l and *_r. The Mirror parameter is already turned on, so mirroring is performed by default once the correct joint name mappings are set:

   

5. We can now transfer the IK functionality to other joint chains like the arms. Click beside Mapping and add three mappings, one for each of the root, mid, and tip joints in the IK chain. Mappings are performed between TransformObject nodes, which represent the skeleton joints.

6. For each joint to map:

   • Click the icon beside the From parameter. This is the joint that has the existing functionality.

   • Select the joint in the viewport and press Enter. This populates the From parameter with the joint name.

     Note

     Select the joint, not the control that’s on the joint.

   • Click the icon beside the To parameter. This is the joint you want to put the functionality on.

   • Select the joint in the viewport and press Enter. This populates the To parameter with the joint name.

   In our example, the three mappings are:

   • From = thigh_l, To = upperarm_l

   • From = calf_l, To = lowerarm_l

   • From = foot_l, To = hand_l

7. The IK functionality is placed on the arms:

   

On the APEX Autorig Component SOP, you can make a custom component available as an interactive tool for the Autorig Builder using the parameters in the Rig Builder tab. The Rig Builder tab is available when Use with Rig Builder is turned on in the Save tab.

To prepare a custom component for use in the Autorig Builder:

1. If applicable, define a “segments” parameter that specifies where to apply the component. The Autorig Builder picks up on the “segments” keyword and allows the user to apply the component to different parts of the character in the drag-and-drop interaction. In APEX Script, you could define the “segments” parameter with something like:

   segments: String = BindInput('', preset='tags')
   

   If you create the component using an APEX graph, you would have “segments” as an input parameter.

2. In the Rig Builder tab, specify the component’s input parameters that you want to appear in the Autorig Builder’s gear menu:

   • Click Generate from Component Parms to automatically populate the Config Control Parms multiparm with the component’s parameters that are in the parameter interface. For APEX Script, define the input parameters with BindInput(), then click the button to have the parameters appear in the parameter editor. See creating graph interfaces for more information.

     or

   • Manually add the parameters to the Config Control Parms multiparm.

   For the component parameters that are not specified in Config Control Parms, the Autorig Builder uses the default values that are set on the parameter (for example, when defining the parameter using BindInput()).

3. Set Drag Drop Interaction to Skeleton.

4. Set the Skeleton Source.

5. In the Joint Group parameter, select the joints in the Skeleton Source that are relevent to the component. For example, if you build a component that adds functonality to the arm, only the arm joints of the left side of the character should be included in this parameter. These joints are used as a reference skeleton when performing the drag-and-drop interaction in the Autorig Builder.

6. Set the Remove Side Indicator. This pattern is removed from the joint names so that the component can be used on both sides of the character.

7. Save the component.

8. On the APEX Autorig Builder SOP, click the icon to update your library of rig components. Your new component will appear in the component catalog HUD, and you can drag and drop it onto your guide character like any other component.

In this example, we prepare the previous IK leg functionality for use in the Autorig Builder:

1. On the APEX Autorig Component SOP, Save tab, turn on Use with Rig Builder.

2. Set Drag Drop Interaction to Skeleton.

3. Set Skeleton Source to From Guide Skeleton. This uses the skeleton specified in Guide Skeleton.

4. In the Joint Group parameter, select the joints that the component applies to. These joints provide default positions for the fuse graph’s TransformObject nodes. The TransformObject node names in the fuse graph should match the joint names of the input skeleton:

   • Click the button beside Joint Group.

   • In the rig tree view, select the joints, in our case, thigh_l, calf_l, and foot_l.

   • Click Accept.

   The Joint Group parameter is populated with the selected joints.

5. Set Remove Side Indicator to *_l. This removes *_l from the joint names so that the component can be used on both sides of the character.

6. Save the component.

7. On the APEX Autorig Builder SOP, click the icon to update your library of rig components. Your new component will appear in the component catalog HUD, and you can drag and drop it onto your guide character.