Houdini 20.5 Nodes APEX nodes

graph::FindFirstPort

Returns the first matched port in an APEX graph based on a pattern.

On this page
Since 20.5

This is a convenience wrapper that returns the first matched result of graph::FindPorts. The pattern used to match the port must follow the rules of the APEX path pattern, which allows you to find ports based on various criteria such as port paths in combination with wildcards, or other port data such as the value type of a port or its connection status. See graph::FindPorts for an example.

If no port is found, an invalid port ID is returned. The Convert<ApexPortID, Bool> node can be used to determine whether or not a port ID is valid.

Inputs

graph: ApexGraphHandle

The graph that contains the port to find.

pattern: String

The pattern used to match the port. The pattern must follow the rules of the APEX path pattern.

Outputs

ports: ApexPortID

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

See also

APEX nodes