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.
Long name (short name) | Argument types | Properties | ||
---|---|---|---|---|
-addSet(-add)
|
name
|
|||
|
||||
-name(-n)
|
string
|
|||
|
||||
-removeSet(-rm)
|
name
|
|||
|
||||
-render(-re)
|
|
|||
|
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;