MergeScenes

Merges multiple input scenes into a single output scene. Merging is performed left to right, starting with in[0].

By default, when more than one input contains the same scene location, the location’s properties from the leftmost input are kept. In this mode, only new locations are merged in from the additional inputs. Optionally, the properties can be replaced by or merged with the properties of the subsequent inputs.

Sets are always merged from all inputs. Where multiple inputs have sets with the same name, the sets are merged into a union.

Caution

When transformMode and/or objectMode is not Keep, bounding box computations have significant overhead. Consider not using these operations, or turning off adjustBounds.

user

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

out

The processed output scene.

enabled

The on/off state of the node. When it is off, the node outputs the input scene unchanged.

in

The input scenes

transformMode

The method used to merge transforms when the same location exists in multiple input scenes. Keep mode keeps the transform from the first input, and Replace mode replaces it with the transform of the last input.

attributesMode

The method used to merge attributes when the same location exists in multiple input scenes. Keep mode keeps the attributes from the first input, Replace mode replaces them with the attributes from the last input, and Merge mode merges all attributes together from first to last.

objectMode

The method used to merge objects when the same location exists in multiple input scenes. Keep mode keeps the object from the first input, and Replace mode replaces it with the object from the last input which has one.

globalsMode

The method used to merge scene globals. Keep mode keeps the globals from the first input, Replace mode replaces them with the globals from the last input, and Merge mode merges all globals together from first to last.

adjustBounds

Adjusts bounding boxes to take account of the merging operation.

Caution

This has considerable overhead when the objectsMode and/or transformsMode is not Keep.