isolateSelect

Go to: Synopsis. Flags. Return value. Python examples.

Synopsis

isolateSelect( <modelPane> , [addDagObject=string], [addSelected=boolean], [loadSelected=boolean], [removeSelected=boolean], [state=boolean], [update=boolean], [viewedObjects=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 editable.

Flags

Long name (short name)	[argument types]	Properties
state(s)	boolean
Turns isolate select mode on/off. In query mode, this flag needs a value.
viewedObjects(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. In query mode, this flag needs a value.
addDagObject(ado)	string
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.

Return value

Python examples

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 )