Go to: Synopsis. Return value. Related. Flags. MEL examples.
partition [-addSet name] [-name string] [-removeSet name] [-render]
[string] [string...]
partition is undoable, queryable, and editable.
This command is used to create, query or add/remove sets to a
partition. If a partition name needs to be specified, it is the first
argument, other arguments represent the set names.
Without any flags, the command will create a
partition with a default name. Any sets which are arguments
to the command will be added to the partition.
A set can be added to a partition only if none of its members
are in any of the other sets in the partition. If the -re/render
flag is specified when the partition is created, only 'renderable'
sets can be added to the partition.
Sets can be added and removed from a partition by using the
-addSet or -removeSet flags.
Note: If a set is already selected, and the partition command is
executed, the set will be added to the created partition.
| string | Name of the partition that was created or edited |
In query mode, return type is based on queried flag.
character, sets
addSet, name, removeSet, render
| Long name (short name) |
Argument types |
Properties |
-name(-n)
|
string
|
|
|
Assigns the given name to new partition. Valid only for create mode.
|
|
-render(-re)
|
|
|
|
New partition can contain render sets.
For use in creation mode only. Default is false. Can also
be used with query flag - returns boolean.
|
|
-addSet(-add)
|
name
|
|
|
Adds the list of sets to the named partition.
|
|
-removeSet(-rm)
|
name
|
|
|
Removes the list of sets from the named partition.
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
|
Flag can appear in Query mode of command
|
Flag can be used more than once in a command.
|
// To create a partition called p1 which contains set1 and set2 ...
partition -n "p1" set1 set2;
// To create an empty render partition ...
partition -render;
// To add/remove sets from partition p1 ...
partition -add p1 set3;
partition -rm p1 set1;
// To get a list of all sets in a partition ...
partition -q p1;
// To check if the partition is a render partition
partition -q -re p1;