Interface: IsolateSelection

Interfaces > Core Interfaces > IsolateSelection

Viewport Shading - Quick Navigation

Core Interfaces - Quick Navigation

This Core Interface exposes the Isolate Selection feature to MAXScript.

In versions prior to 3ds Max 2013 the Isolate Selection was implemented using MAXScript.

In 3ds Max 2013, the functionality was reimplemented as integral part of the User Interface.

Methods:

<boolean>IsolateSelection.EnterIsolateSelectionMode()

Enters Isolate Selection mode.

Returns True on success, False if already in Isolate Selection mode.

<boolean>IsolateSelection.ExitIsolateSelectionMode()

Exits Isolate Selection mode.

Returns True on success, False if not in Isolate Selection mode.

<boolean>IsolateSelection.IsolateSelectionModeActive()

Returns True if in Isolate Selection mode, False if not.

<boolean>IsolateSelection.IsNodeIsolated <node>node

Returns True if the specified node is isolated (3ds Max is in Isolate Selection mode and the specified node was selected when the mode was invoked).

Returns False if the Isolate Selection mode is not active or the node was not selected and was thus hidden in the Isolate Selection process.

<void>IsolateSelection.SuppressIsolateSelectionWarningDialogue <boolean>bSuppress

When the argument is True, the Isolate Selection warning will be suppressed.

When the argument is False, the Isolate Selection warning will be issued when opening a scene with isolated objects.

EXAMPLE:

s = Sphere() --create a sphere
-->$Sphere:Sphere001 @ [0.000000,0.000000,0.000000]
b = Box pos:[50,0,0] --create a box
-->$Box:Box001 @ [50.000000,0.000000,0.000000]
c = Cone pos:[-50,0,0] --create a cone
-->$Cone:Cone001 @ [-50.000000,0.000000,0.000000]
select s --select the sphere
-->OK
IsolateSelection.EnterIsolateSelectionMode() --isolate it - it works!
-->true
IsolateSelection.EnterIsolateSelectionMode() --cannot isolate again
-->false
IsolateSelection.IsolateSelectionModeActive() --check if in Isolate Mode
-->true
IsolateSelection.IsNodeIsolated s --check if the sphere is isolated
-->true
IsolateSelection.IsNodeIsolated b --check if the box is isolated
-->false
IsolateSelection.IsNodeIsolated c --check if the cone is isolated
-->false
holdMaxFile() --hold the scene
-->OK
IsolateSelection.SuppressIsolateSelectionWarningDialogue false --enable warning
-->OK
fetchMaxFile() --fetch, answer prompt with Yes - an Isolation warning will follow
-->OK
--NOTE that 'fetchMaxFile quiet:true' will suppress both the prompt and the warning
IsolateSelection.SuppressIsolateSelectionWarningDialogue true --suppress the warning
-->OK
fetchMaxFile() --fetch, answer prompt with Yes - no Isolation warning will follow.
-->OK
IsolateSelection.ExitIsolateSelectionMode() --exist the Isolate Mode
-->true
IsolateSelection.ExitIsolateSelectionMode() --can't exit again, already off
-->false