| Since | 22.0 |
This component connects and disconnects ports on the nodes of an existing rig. Each entry in the connection table describes one source port and the target ports it drives. Use it to hook up components that were built separately, to re-parent parts of a rig, or to remove connections that an earlier component made.
Nodes are named with APEX path patterns rather than literal names, and those patterns are rewritten before they are resolved. This means one authored table can be replayed across every segment of a character and mirrored onto the opposite side, instead of being duplicated per limb.
Two rewrites are available, and they can be combined:
-
Segments loops the whole table over a set of tags. Write
{segment}inside a node pattern and it is replaced with the name of the segment currently being built, so{segment}_fkresolves toL_arm_fk,R_leg_fk, and so on. -
Mirror applies every entry twice, once exactly as authored and once with the names renamed from From to To.
Note
Mirror and Segments work together. When both are used, segments that already match the To pattern are dropped from the loop, because mirroring generates them from their From counterparts. Without this, the right side would be built twice.
An entry whose node pattern or port name is empty is skipped rather than reported as an error, so a single table can be shared across segments that do not all contain the same nodes.
This component is a wrapper around the 
component::ConnectPorts subgraph.
Parameters ¶
Settings ¶
Segments
The tags identifying the segments to loop the connection table over, for example, *_arm. The tags are resolved with the find segments node. Write {segment} in a Source Node or Target Node pattern to substitute the name of the segment currently being built. When this parameter is empty, the table is applied once and the node patterns are used exactly as written.
Mirror
When turned on, applies every entry in the connection table twice: once exactly as authored, then again with the node names renamed from From to To. This lets you author the table for one side only.
From
When Mirror is turned on, this is the wildcard pattern matching the side the table is authored on, for example, L_*. The pattern is matched against the whole node name, so a bare L_ matches nothing.
To
When Mirror is turned on, this is the wildcard pattern the names are renamed to, for example, R_*.
Addconnections
The number of connections to make. Each entry describes one source port and the target ports it drives.
Source Node
The node whose output port drives the connection. This parameter accepts APEX path patterns, so you can specify tags in this field, for example, #fk. Only the first matching node is used. Leave this field empty for an entry that only disconnects a target.
Port
The name of the Source Node output port, for example, xform. Do not include the [out] qualifier.
Sub-Port
The alias to use when the source port is variadic, that is, when it holds a named list of sub-ports. Leave this field empty to wire the port itself.
Disconnect Source Port
When turned on, removes every connection on the source port and makes no new connection. The target side of the entry is ignored and its parameters are disabled.
Target Node
The node being driven. This parameter accepts APEX path patterns, so you can specify tags in this field, for example, #bind. Unlike Source Node, every matching node is wired, not just the first.
Port
The name of the Target Node input port, for example, parent. Do not include the [in] qualifier.
Sub-Port
The alias to use when the target port is variadic, for example, the per-driver alias on a 
set point transforms node. Leave this field empty to wire the port itself.
Disconnect Target Port
When turned on, removes every connection on the target ports and makes no new connection. The source side of the entry is ignored and its parameters are disabled.
| See also |
APEX AutoRig Component