SelectionSet Values

Value > Collections > Collection Types > SelectionSet Values

 

   

Values and Collections - Quick Navigation

A SelectionSet represents the named scene node selection sets in the Named Selection Sets drop-down list in the 3ds Max toolbar.

Also see SelectionSetArray Values.

SelectionSet values are mappable.

   

Constructors

selectionSets[<set_name>]

Set by string or name value

   

selectionSets[<index>]

Set by order in drop-down list

   

Operators

<selectionset>[<integer>]

Retrieve the n-th object in set.

   

Properties

<selectionset>.center : Point3, read-only

Returns center of bounding box of all objects in set.

   

<selectionset>.max : Point3, read-only

Returns maximum corner of bounding box.

   

<selectionset>.min : Point3, read-only

Returns minimum corner of bounding box.

   

<selectionset>.count : Integer, read-only

Returns number of objects in set.

   

<selectionset>.name : String

Get/Set the name of the selection set. This means that you can now rename an existing named selection set instead of destroying it and creating it again.

Available in 3ds Max 9 and higher.

   

Methods

isDeleted <selectionset>

Returns true if the selection set is deleted, false of it exists.

Available in 3ds Max 9 and higher.

FOR EXAMPLE

b = box()
--> $Box:Box01 @ [0.000000,0.000000,0.000000]
 
selectionSets["boxes"] = #(b)
--> #($Box:Box01 @ [0.000000,0.000000,0.000000])
 
nss = selectionSets["boxes"] 
--> SelectionSet:boxes
 
nss.name 
--> "boxes"
isdeleted nss 
--> false
nss.name = "one box" 
--> "one box"
nss.name 
--> "one box"
deleteItem selectionsets nss 
--> OK
isDeleted nss 
--> true
NOTE:

Unlike ObjectSet, you cannot use SelectionSet as the root of a pathname!

The order of sequencing is consistent in a stable scene but somewhat arbitrary - it depends on how 3ds Max stores its object hierarchy internally which is effected mostly by order of additions and deletions to and from the scene.

See Also