Houdini 21.0 Nodes APEX nodes

graph::FindAndConnectInput

Connects two APEX node ports given the node IDs and port names.

On this page
Since 20.0

Connects two APEX node ports with a series of wires that could traverse subnets if necessary. The ports must be from two different nodes. The output port srcname of node srcnode is connected to the input port dstname of node dstnode. It must be possible to connect the nodes either directly or through a series of subnet inputs and outputs. Subnet inputs and outputs are reused wherever possible.

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

Inputs

*graph: ApexGraphHandle Required

The graph that contains the two ports to connect together.

dstnode: ApexNodeID

The node associated with the dstname input port.

dstname: String

The name of the input port on dstnode. Connecting an output port to dstname results in dstname using the calculated result of the source as its input value.

dstalias: String

Deprecated

srcnode: ApexNodeID

The node associated with the srcname output port.

srcname: String

The name of the output port on srcnode. Connecting srcname to another input port results in srcname's calculated result being forwarded to the next node.

srcalias: String

Deprecated

variadic: Int

Deprecated

name: String

The name for the subnet ports that are added to complete the wire path from srcname to dstname. If name is an empty string, srcename is used as the port name that is added on the subnets.

Outputs

*graph: ApexGraphHandle

The updated graph with the added wire.

success: Bool

Returns True if the connection is created.

See also

APEX nodes