Go to: Synopsis. Return value. Flags. Python examples.
makeLive(
[surface...]
, [addObjects=boolean], [none=boolean], [registry=int], [registryCount=boolean], [registryReset=boolean], [registrySize=int], [removeObjects=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
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)
|
boolean
|
|
|
Add the listed object(s) to the current live list.
If an object is already in the live list, it is ignored.
|
|
none(n)
|
boolean
|
|
|
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)
|
boolean
|
|
|
Return the actual number of registry entries.
This number ranges from 0 to 'registrySize' - 1.
|
|
registryReset(rr)
|
boolean
|
|
|
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)
|
boolean
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
cmds.makeLive( 'surface1' )
cmds.makeLive( none=True )