partition

Go to: Synopsis. Flags. Return value. Related. MEL examples.

Synopsis

partition [-addSet partitionNamelist of sets] [-name string] [-removeSet namelist of sets] [-render] [partition] [list of sets]

partition is undoable, queryable, and editable.

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.

See also: sets

Flags

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. In query mode, this flag needs a value.
-addSet(-add)	partitionNamelist of sets
Adds the list of sets to the named partition.
-removeSet(-rm)	namelist of sets
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

Return value

Related

MEL examples

// To create a partition calls 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;