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

Synopsis

isolateSelect [-addDagObject name] [-addSelected] [-addSelectedObjects] [-loadSelected] [-removeDagObject name] [-removeSelected] [-state boolean] [-update] [-viewObjects] string

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.

Return value

booleanWhen used with query

In query mode, return type is based on queried flag.

Flags

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(-as)
Add the currently active objects to the set of objects to be displayed in the view.
-addSelectedObjects(-aso)
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)
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)
Remove the currently active objects to the set of objects to be displayed in the view.
-state(-s) boolean query
Turns isolate select mode on/off.
-update(-u)
Update the view's list of objects due to a change to the set of objects to be displayed.
-viewObjects(-vo) query
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 be used more than once in a command.

MEL examples

// create some primitives and go into component selection mode
sphere -n sphere1;
cone -n cone1;
selectMode -component;

// Use the current modelPanel for isolation
string $isolated_panel = `paneLayout -q -pane1 viewPanes`;

// turn on isolate select mode for a particular 3d view. Only
// the sphere and the selected CVs will be displayed.
select "sphere1.cv[0:2][*]";
// Connect the selected objects with editor and
// locks the current list of objects within the mainConnection
editor -edit -lockMainConnection -mainListConnection "activeList" $isolated_panel;
isolateSelect -state 1 $isolated_panel;

// add the cone to the list of objects to be viewed
select cone1;
isolateSelect -addSelected $isolated_panel;

// make just the sphere the object to be viewed
select sphere1;
// Unlock the current list of objects within the editor
editor -edit -mainListConnection "activeList" $isolated_panel;
isolateSelect -loadSelected $isolated_panel;