Houdini 20.5 Nodes APEX nodes

graph::GetSubPort

Finds or adds a subport to a variadic port.

On this page
Since 20.0

Finds a subport or adds a subport to a variadic port. When creating a new subport, the name for the subport must be set.

Certain nodes like dict::Build or skel::SetPointTransforms require you to associate a specific functionality with the subport name. For example, skel::SetPointTransforms associates the subport names of its transforms variadic input with the TransformObject nodes that represent the joints in a skeleton joint hierarchy. See geometry deformation for more information.

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 subport to find or create.

portid: ApexPortID

The parent port of the subport portname.

portname: String

The name of the subport to find or create.

Outputs

*graph: ApexGraphHandle

The updated graph that contains the found or created subport.

subportid: ApexPortID

The unique port identifier, created at run time, that represents the subport in the graph.

See also

APEX nodes