|On this page|
This node takes multiple inputs (each of which represents a "stack" of one or more USD layers) and merges them into a stage containing one layer stack in the output. This is useful when you want to combine separate pieces of a scene graph, each authored by a different chain of LOP nodes, into a unified whole.
The order of inputs matters. Layers in earlier inputs are weaker than layers in later inputs when combined in the output.
This node has different styles for combining layers from the inputs. See the Merge style parameter. Some styles flatten the contents of input layers into one or more output layers.
This node is like sublayering but for in-memory trees. Similarly, the Graft LOP is like referencing but for in-memory trees. It combines scene graph trees by choosing the locations at which each input stage’s tree is attached on the output tree.
Styles that simply merge layers are fast. Styles that flatten layers are more expensive, but you may need them to generate a particular arrangement of layers when saving the stage to disk with USD render node.
If an input has a Layer Break node further up the chain, the sublayers from above the Layer Break will not be stripped out when using separate layers mode, but will be in the other modes, which may result in a loss of context.
Separate Layers: Each layer from each input is merged into a new sublayer stack in the output, sorted by strongest to weakest from the strongest (last) input, then strongest to weakest from the next strongest (second-to-last) input, and so on.
Separate Layers, File Layers Weakest
Separate Layers, File and SOP Layers Weakest