Houdini 21.0 Nodes APEX nodes

graph::ConnectInput

Connects two APEX node ports given the port IDs.

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. srcport is the output port of one node, and dstport is the input port of another node. 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.

Note

A port ID is unique within a graph, including the ports within nested subnets.

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.

srcport: ApexPortID

The output port of a node. Connecting this port to another input port results in srcport's calculated result being forwarded to the next node.

If srcport is invalid, dstport will be disconnected.

dstport: ApexPortID

The input port of a node. Connecting an output port to this port results in dstport using the calculated result of the source as its input value.

name: String

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

Outputs

*graph: ApexGraphHandle

The updated graph with the added wire connection.

See also

APEX nodes