|On this page
In USD a payload is essentially a reference you can choose not to load.
Often when working with a very complex scene, you want to leave payloads unloaded to improve performance.
It is helpful to display unloaded payloads as bounding boxes. To support this, Houdini needs to get metadata (the prim type, and the bounding box expressed in the
extentsHintattribute) from the prim that holds the payload specification, because the data from within the payload is not loaded.
To copy this metadata from inside the payload onto the primitive with the payload specification, run this node with payloads loaded. It descends into the selected prims and finds any payloads. It then records metadata about the payloads on the ancestor prims so the information is still available when the payloads are not loaded.
Tips and notes
You can load/unload payloads interactively in the Scene Graph Tree pane.
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