Houdini 18.0 Nodes TOP nodes

Attribute Rename TOP node

Renames attributes on work items.

This node renames a list of attributes from incoming work items. (More correctly, it generates clones of the incoming work items, but with several attributes renamed).

Parameters

Rename

Work Item Generation

Whether this node generates static or dynamic work items. You should generally leave this set to "Automatic" unless you know the node’s work items can be computed statically, or that they need to be generated dynamically.

Dynamic

This node always creates dynamic work items: it waits until the upstream work items are known, and generates new work items from the upstream work items.

Static

This node always creates static work items: it creates the number of work items it thinks it needs based on the parameters (and any upstream static items) before the network runs.

Automatic

If the input is static (a static processor, or a partitioner with only static inputs, or a mapper), this node generates static work items, otherwise it generates dynamic work items.

Rename When

If you turn this on, the node only renames the attribute(s) below from work items where the given expression evaluates to a non-zero value. The expression does not have to involve the attributes being renamed. For example, to rename attributes from any work items whose tile_x attribute is greater than 5, turn on Rename When and set the expression to @tile_x > 5.

Attributes

Number of Renames

A multiparm of attribute rename operations.

Attribute From/To

The name of the existing attribute to rename, and the new name to be assigned.

Overwrite Existing Attributes

If the new attribute name matches an existing attribute the existing attribute will be replaced if this is checked. If this is unchecked, an error will be reported.

On Attribute Not Found

Determines what happens when the given attribute name does not exist.

Report Error: An error is reported if the attribute is not found.

Report Warning: A warning is reported if the attribute is not found.

Ignore: The rename operation is skipped.

See also

TOP nodes