Go to: Synopsis. Return value. Flags. MEL examples.
makeLive [-addObjects] [-none] [-registry int] [-registryCount] [-registryReset] [-registrySize int] [-removeObjects]
[surface...]
makeLive is undoable, queryable, and editable.
This commmand makes one or several objects live. A live object defines the
surface on which to create objects and to move objects relative to.
Only construction planes, nurbs surfaces and polygon meshes can be made live.
The makeLive command expects one of these types of objects as an explicit
argument. If no argument is explicitly specified, then there are a number
of default behaviours based on what is currently active. The command will
fail if the active object(s) is/are not one of the valid types of objects.
If there is nothing active, the current live object(s) will become dormant.
Otherwise, the active object(s) will become the live object(s).
The command allows for a limited number of objects collections to be saved
in a registry entry. These collections can be queried and/or made live.
None
In query mode, return type is based on queried flag.
addObjects, none, registry, registryCount, registryReset, registrySize, removeObjects
| Long name (short name) |
Argument types |
Properties |
|
-addObjects(-ao)
|
|
|
|
Add the listed object(s) to the current live list.
If an object is already in the live list, it is ignored.
|
|
-none(-n)
|
|
|
|
If the -n/none flag, the live object(s) will become dormant.
Use of this flag causes any arguments to be ignored.
|
|
-registry(-r)
|
int
|
|
|
Make live the objects defined in the specified registry entry.
In Query mode, return the list of objects defined in the specified registry entry.
|
|
-registryCount(-rc)
|
|
|
|
Return the actual number of registry entries.
This number ranges from 0 to 'registrySize' - 1.
|
|
-registryReset(-rr)
|
|
|
|
Reset the maximum number of registry entries to the default value and clear all stored data.
|
|
-registrySize(-rs)
|
int
|
|
|
Defines the maximum number of registry entries that are remembered by the command.
In Query mode, returns the maximum number currently set.
|
|
-removeObjects(-ro)
|
|
|
|
Remove the listed object(s) from the current live list.
If an object is not in the list, it is ignored.
|
|
|
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.
|
// get the registry size
makeLive -q -registrySize;
// set surface1 as the live object
makeLive surface1;
// make surface1 the dormant object
makeLive -none;
// make both surface1 and surface2 the live objects.
makeLive surface1 surface2
// Get the active number of registry entries and the stored collection
int $nbReg = `makeLive -q -registryCount`;
for ($i = 0; $i < $nbReg; $i++) {
string $liveObjs[] = `makeLive -q -registry $i`;
print $liveObjs;
print "\n";
}
// make live the objects collection stored in registry entry 1
makeLive -registry 1;
// clears all the registry and reset the data stucture to the defaults.
makeLive -registryReset
// add both surface1 and surface2 to the registry list that is currently live
makeLive -addObjects surface1 surface2
// remove surface1 from the registry list that is currently live
makeLive -removeObjects surface1