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
If you turn this on, the node only removes 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 deleted. For example, to remove attributes from any work items whose tile_x
attribute is greater than 5, turn on Delete when and set the 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 or by using a mulitparm list of attribute names.
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 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.
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 |