Houdini 20.5 Nodes APEX Nodes

graph::AddOrUpdateNode

Adds or updates a node.

On this page
Since 20.5

Adds or updates a node in the graph. If the node name is not found, it will be created. If the name matches an existing node in the graph, only the node’s metadata will be updated if the metadata is supplied in properties.

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 the node is added to.

name: String

The name of the node to add or update in the graph.

callback: String

The callback name of the node to add or update in the graph.

pos: Vector3

The position of the new or updated node in the graph.

color: Vector3

The color of the new or updated node.

parms: Dict

The parameter to set for the node’s ports. The key-value pairs of the dictionary entries are:

  • key: port name on the new node

  • value: parameter value of the port

tags: StringArray

String values associated with the new or updated node. Tags can be used to filter nodes independently from the name.

properties: Dict

The custom metadata dictionary for the new or updated node.

Outputs

*graph: ApexGraphHandle

The updated graph with the new or updated node.

nodeid: ApexNodeID

The node ID of the newly created or updated node. This ID is the identifier for the node within the graph.

exists_on_input: Bool

Returns True if the node already exists.

See also

APEX Nodes