Go to: Synopsis. Return value. Flags. Python examples.
isolateSelect(
string
, [addDagObject=name], [addSelected=boolean], [addSelectedObjects=boolean], [loadSelected=boolean], [removeDagObject=name], [removeSelected=boolean], [state=boolean], [update=boolean], [viewObjects=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
isolateSelect is undoable, queryable, and NOT editable.
This command turns on/off isolate select mode in a specified modeling
view, specified as the argument. Isolate select mode is a display mode
where the currently selected objects are added to a list and only
those objects are displayed in the view. It allows for selective
viewing of specific objects and object components.
| boolean | When used with query |
In query mode, return type is based on queried flag.
addDagObject, addSelected, addSelectedObjects, loadSelected, removeDagObject, removeSelected, state, update, viewObjects
| Long name (short name) |
Argument types |
Properties |
|
addDagObject(ado)
|
name
|
|
|
Add the specified object to the set of objects to be
displayed in the view.
|
|
addSelected(addSelected)
|
boolean
|
|
|
Add the currently active objects to the set of
objects to be displayed in the view.
|
|
addSelectedObjects(aso)
|
boolean
|
|
|
Add selected objects to the set of objects to be displayed in the view.
This flag differs from addSelected in that it will ignore selected components
and add the entire object.
|
|
loadSelected(ls)
|
boolean
|
|
|
Replace the objects being displayed with the currently
active objects.
|
|
removeDagObject(rdo)
|
name
|
|
|
Remove the specified object from the set of objects to be
displayed in the view.
|
|
removeSelected(rs)
|
boolean
|
|
|
Remove the currently active objects to the set of
objects to be displayed in the view.
|
|
state(s)
|
boolean
|
|
|
Turns isolate select mode on/off.
|
|
update(u)
|
boolean
|
|
|
Update the view's list of objects due to a change
to the set of objects to be displayed.
|
|
viewObjects(vo)
|
boolean
|
|
|
Returns the name (if any) of the objectSet which contains
the list of objects visible in the view if isolate select mode
is on. If isolate select mode is off, an empty string is
returned.
|
|
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
# create some primitives and go into component selection mode
cmds.sphere( n='sphere1' )
cmds.cone( n='cone1' )
cmds.selectMode( component=True )
# to query the current modelPanel, you can use the command
#
cmds.paneLayout('viewPanes', q=True, pane1=True)
# turn on isolate select mode for a particular 3d view. Only
# the sphere and the selected CVs will be displayed.
cmds.select( 'sphere1.cv[0:2][*]' )
cmds.isolateSelect( 'modelPanel1', state=1 )
# add the code to the list of objects to be viewed
cmds.select( 'cone1' )
cmds.isolateSelect( 'modelPanel1', addSelected=True )
# make just the sphere the object to be viewed
cmds.select( 'sphere1' )
cmds.isolateSelect( 'modelPanel1', loadSelected=True )