Houdini 20.5 Nodes TOP nodes

Attribute Delete TOP node

Removes attributes from work items.

On this page
Since 17.5

This node deletes a list of attributes (or all attributes) from incoming work items. (More correctly, it outputs clones of the incoming work items, but filters out matching attributes).

Parameters

Generate When

Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.

All Upstream Items are Generated

This node will generate work items once all of the input nodes have generated their work items.

All Upstream Items are Cooked

This node will generate work items once all of the input nodes have cooked their work items.

Each Upstream Item is Cooked

This node will generate work items each time a work item in an input node is cooked.

Automatic

The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.

Delete When

When this parameter is on, you can set it to an expression that’s evaluated for each work item. Attributes will only be deleted from a work item if this parameter’s expression returns to a non-zero value for that item. The expression does not need to include the attributes being deleted.

For example, to only delete attributes from work items whose tile_x attribute is greater than 5, enable this parameter and set its expression to @tile_x > 5.

Delete All Attributes

Delete all custom attributes. This does not affect internal attributes such as pdg_index.

Copy Inputs to Outputs

When on, work items in the node will copy input files to their output file list. When off, work items will not have any output files.

Delete Using

Set this parameter to choose how you want to delete attributes. Attributes can be removed using an attribute pattern, by using a multiparm list of attribute names, or by specifying the name of a string attribute that stores a list of attributes to delete.

Missing Attribute

Determines what happens if an work item is missing one of the attributes from the Attribute List.

Attribute Pattern

When Delete Using is set to Attribute Pattern, this parameter is used to specify the pattern that determines which attributes are deleted.

Attribute Scope

When Delete Using is set to Attribute Pattern, this parameter is used to specify whether the pattern should be applied to input work items or to attributes on the graph itself.

Attribute Name

The name of a string attribute that contains a list of attributes to delete.

Attribute List

A multi-parm allowing you to delete one or more attributes by name. This parameter is used when Delete Using is set to Attribute List.

Attribute Name

The name of the attribute to delete.

Index

When this is on, instead of removing the attribute, the node will truncate the attribute value after a certain position. For example, if you set this to 1, the node will delete any vector components after the first, effectively setting the vector size to 1.

Attribute Scope

Determines if the attribute should be deleted from work items or the graph.

Examples

DeleteAttributes Example for Attribute Delete TOP node

This example demonstrates how to delete work item attributes.

DeletePattern Example for Attribute Delete TOP node

This example demonstrates how to delete work item attributes using the Attribute Pattern syntax.

See also

TOP nodes