# Set

Creates and edits sets of objects. Each set contains a list of paths to locations within the scene. After creation, sets can be used by the SetFilter to limit scene operations to only the members of a particular set.

## 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.

The input scene

## filter

Defines the locations to be added to or removed from the set.

## mode

Create mode creates a new set containing only the specified paths. If a set with the same name already exists, it is replaced.

Add mode adds the specified paths to an existing set, keeping the paths already in the set. If the set does not exist yet, this is the same as create mode.

Remove mode removes the specified paths from an existing set. If the set does not exist yet, nothing is done.

## name

The name of the set that will be created or edited. Multiple sets may be created or modified by entering their names separated by spaces. Wildcards may also be used to match multiple input sets to be modified.

## setVariable

A context variable created to pass the name of the set being processed to the nodes connected to the filter plug. This can be used to vary the filter for each set.

## paths

The paths to be added to or removed from the set.

Caution

This plug is deprecated and will be removed in a future release. No validity checks are performed on these paths, so it is possible to accidentally generate invalid sets.