Houdini 20.5 Nodes APEX nodes

guide::ControlsFromGuides

Adds or updates the TransformObject nodes for the joints in a guide skeleton.

On this page
Since 20.5

Adds or updates the TransformObject nodes that correspond to the guide joints (the joints on the guide skeleton) specified in group. The properties dictionary on the guide joints store information that is used to configure the properties on the corresponding TransformObject nodes, including the control behavior, shape, color, and the ports to promote.

The properties dictionary can be set using guide::SetGuideProperties, guide::FindOrAddGuide, or by setting the properties dictionary directly on the skeleton.

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 to update.

geo: Geometry

The guide skeleton with the properties dictionary metadata.

group: String

A pattern that specifies the joints to use for adding/updating the TransformObject nodes in the graph. The pattern format is the same as that used by the group parameters on various SOP nodes. Elements in the pattern are separated by spaces, and can be point numbers, point number ranges, or group names, for example, @name=point_0 @name=point_1. See group syntax for more information.

parmprefix: String

The prefix for the promoted ports on the graph’s parms node.

Outputs

*graph: ApexGraphHandle

The graph with the new/updated TransformObject nodes.

geo: Geometry

Pass-through of the guide geometry.

nodeids: ApexNodeIDArray

The new/updated nodes.

See also

APEX nodes