Go to: Synopsis. Return value. Flags. Python examples.
isolateSelect( string , [addDagObject=name], [addSelected=boolean], [loadSelected=boolean], [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, loadSelected, removeSelected, state, update, viewObjects
| Long name (short name) |
Argument types |
Properties |
state(s) |
boolean |
 |
|
Turns isolate select mode on/off. |
|
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. |
|
addDagObject(ado) |
name |
|
|
Add the specified object to the set of objects to be displayed
in the view. |
|
loadSelected(ls) |
boolean |
|
|
Replace the objects being displayed with the currently active
objects. |
|
addSelected(addSelected) |
boolean |
|
|
Add the currently active objects to 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. |
|
update(u) |
boolean |
|
|
Update the view's list of objects due to a change to the set of
objects to be displayed. |
|
 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 )