|On this page|
This node copies property values and metadata to a new property name on the same primitive, or to other primitives. Both attributes and relationships are supported. Both the source and destination primitives can be specified with patterns, allowing a single attribute values to be spread onto many other primitives, or to allow a set of attributes to be renamed on all primitives matching a pattern. The destination pattern is reevaluated for each source primitive, which would allow complex actions like copying an attribute on all root primitives to all of their child primitives.
When copying attribute values, the default value and all time sampled values will be copied as well.
Source property can be “blocked”, which clears all values and is as close as USD comes to supporting the “deletion” of an property.
The primitive(s) the node should operate on. You can drag primitives from the scene graph tree pane into this textbox to add their paths, or click the Reselect button beside the text box to select the primitives in the viewer, or ⌃ Ctrl-click the Reselect button to choose prims from a pop-up tree window. You can also use primitive patterns for advanced matching, including matching all prims in a collection (using
If this parameter is not enabled, each source primitive is used as its one and only destination primitive. Enabling this parameter causes the resulting primitive pattern to be evaluated for each source primitive, with the following local variables available to generate different destination patterns for each source primitive:
$NPRIM is deprecated)
The total number of primitives being modified by this node.
$PRIM is deprecated)
Index of the primitive being modified. This value
$PRIMPATH is deprecated)
The path of the primitive being modified.
Number of Properties to Copy
Controls the number of properties that should be copied for each destination primitive for each source primitive.
The name of the property that should be copied. If the source property doesn’t exist on a particular source primitive, that primitive is silently ignored.
The name of the property that should be created on the destination primitives by the copy operation.
Enable this parameter to copy all metadata from the source property to the destination. This option should normally be left off, which will cause the destination property to be marked as “custom” unless the destination property is defined in a schema.
Enable this parameter to block the source properties after copying them, clearing all values. This is as close as USD allows to “deleting” a property. Properties defined in a schema will revert to their fallback values authored in the schema.