Houdini 20.5 Nodes APEX nodes

graph::PromoteNodeOutputs

Promotes multiple output ports to the graph’s output node.

On this page
Since 20.5

Promotes multiple output ports to the graph’s output node. The ports to promote are specified in portnames, with the individual ports separated with a space, for example, “t r s”. The promoted ports on the output node are named using the prefix as the base name, and the portnames as a suffix, for example, prefix_t, prefix_r, and prefix_s.

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 node with the output ports to promote.

nodeid: ApexNodeID

The node with the output ports to promote.

portnames: String

The output ports to promote, for example, “t r s”.

outputnodeid: ApexNodeID

The node ID of the graph’s output node.

prefix: String

The base name of the promoted ports on the graph’s output node.

removeportsuffix: Bool

If set to True, removes the port name suffix from the name of the promoted port on the graph’s output node, for example, from “prefix_r” to “prefix”.

Outputs

*graph: ApexGraphHandle

The updated graph with the newly promoted ports.

graphoutputs: ApexPortIDArray

An array of the newly created port IDs on the output node.

See also

APEX nodes