snapMode Struct

The snapMode struct provides system globals and functions to access and control the snapping options through MAXScript.

System Globals:

snapMode.active 

A 3ds Max System Global that lets you get and set whether Snap is active.

A Boolean value.

snapMode.type 

Get/Set the current snap type as a name. Possible names are #2D , #2_5D , and #3D .

The snapMode structure has been extended in 3ds Max 7 to provide access to all Snap settings and Snap results. Prior to 3ds Max 7, these properties were available in the third-party Avguard Extensions.

snapMode.snapPreviewRadius 

A System Global that lets you get and set the Snap Preview Radius value.

Default value is 30.

Available in 3ds Max 7 and higher.

snapMode.snapRadius 

A System Global that lets you get and set the Snap Radius value.

Default value is 20.

Available in 3ds Max 7 and higher.

snapMode.hilite 

A System Global that lets you get and set the color value of the Snap Marker.

Available in 3ds Max 7 and higher.

snapMode.markSize 

A System Global that lets you get and set the Snap Marker Size.

An integer value.

Available in 3ds Max 7 and higher.

snapMode.toFrozen 

A System Global that lets you get and set whether to snap to frozen objects.

A Boolean value.

Available in 3ds Max 7 and higher.

snapMode.axisConstraint 

A System Global that lets you get and set whether the snap must use axis constraints as Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher.

snapMode.displayRubberBand 

A System Global that lets you get and set whether to display rubber band as a Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher.

snapMode.useAxisCenterAsStartSnapPoint 

A System Global that lets you get and set the state of the "Use Axis Center As Start Snap Point" option as Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher up to 3ds Max 2010.

Deprecated in 3ds Max 2011.

Attempting to access this property will result in:

-- Runtime error: Cannot set this snap option. It has been deprecated as of 3ds Max 2011.

snapMode.display 

A System Global that lets you get and set whether the Snap Marker is displayed.

A Boolean value.

Available in 3ds Max 7 and higher.

snapMode.strength 

A System Global that lets you get and set the Snap Strength as an integer value.

Available in 3ds Max 7 and higher.

snapMode.hit 

A System Global that contains true if the Marker is currently snapped to something, false if not snapped.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.node 

A System Global that contains the node currently being snapped to.

Contains undefined if not snapped to a node or if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.flags 

A System Global that contains the Snap System Flags as an integer.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.hitPoint 

A System Global that contains the last Snap Point as Point3 coordinate in local coordinates of the node snapped to.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.worldHitpoint 

A System Global that contains the last Snap Point as Point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.screenHitPoint 

A System Global that contains the last Snap Point as a Point3 screen coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.screenHitPointUnscaled 

NEW in 3ds Max 2017: A System Global that contains the last Snap Point as an unscaled Point3 screen coordinate.

Contains undefined if Snaps are not active.

Read only.

Contains undefined if Snaps are not active.

snapMode.OKForRelativeSnap 

A System Global that contains true if at least one Snap Point has been recorded.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.refPoint 

A System Global that contains the last Snap Point as point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.topRefPoint 

A System Global that contains the first snap point as point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

snapMode.numOSnaps 

A System Global that contains the number of OSnaps as an integer.

Read only.

Currently there are 6 sets of OSnaps - see below of details.

Available in 3ds Max 7 and higher.

Methods:

snapMode.getOSnapName <int osnap_index> 

Returns the name of the indexed OSnap as string.

Currently, the results are:

1 - "Body" - Available in 3ds Max 2011 and higher.

2 - "NURBS"

3 - "Point Cloud Objects" - Available in 3ds Max 2015 and higher.

4 - "Standard"

5 - "Standard"

6 - "Standard"

7 - "Standard"

All others available in 3ds Max 7 and higher.

snapMode.getOSnapNumItems <int osnap_index> 

Returns the number of OSnap items in the indexed OSnap as <integer>.

Available in 3ds Max 7 and higher.

Possible osnap_index values are:

snapMode.getOSnapItemName <int osnap_index> <int osnap_item_index> 

Returns the name of the indexed OSnap item in the indexed OSnap as string.

See table above for currently implemented names.

Available in 3ds Max 7 and higher.

snapMode.getOSnapItemToolTip <int osnap_index> <int osnap_item_index> 

Returns the tooltip of the indexed OSnap item in the indexed OSnap as string.

Available in 3ds Max 7 and higher.

snapMode.getOSnapItemActive <int osnap_index> <int osnap_item_index> 

Returns true if the indexed OSnap item in the indexed OSnap is active, false otherwise.

Available in 3ds Max 7 and higher.

snapMode.setOSnapItemActive <int osnap_index> <int osnap_item_index> <boolean> 

Sets whether the indexed OSnap item in the indexed OSnap is active.

Available in 3ds Max 7 and higher.

--The following example prints information about the state of
--all Snap options to the Listener:
for i = 1 to snapmode.numOSnaps do
(
format "%: name: \"%\"\n" i (snapmode.getOSnapName i)
for j = 1 to (snapmode.getOSnapNumItems i) do
format " %: name: \"%\"; tooltip: \"%\"; state: %\n" j \
(snapmode.getOSnapItemName i j) \
(snapmode.getOSnapItemToolTip i j) \
(snapmode.getOSnapItemActive i j)
)

1: name: "Body Snaps"
 1: name: "Vertex"; tooltip: ""; state: false
 2: name: "End Edge"; tooltip: ""; state: false
 3: name: "Edge"; tooltip: ""; state: false
 4: name: "Edge Midpoint"; tooltip: ""; state: false
 5: name: "Face"; tooltip: ""; state: false
2: name: "NURBS"
 1: name: "CV"; tooltip: ""; state: false
 2: name: "Point"; tooltip: ""; state: false
 3: name: "Curve Center"; tooltip: ""; state: false
 4: name: "Curve Normal"; tooltip: ""; state: false
 5: name: "Curve Tangent"; tooltip: ""; state: false
 6: name: "Curve Edge"; tooltip: ""; state: false
 7: name: "Curve End"; tooltip: ""; state: false
 8: name: "Surf Center"; tooltip: ""; state: false
 9: name: "Surf Normal"; tooltip: ""; state: false
 10: name: "Surf Edge"; tooltip: ""; state: false
3: name: "Point Cloud Objects"
 1: name: "Point Cloud Vertex"; tooltip: ""; state: false
4: name: "Standard"
 1: name: "Grid Points"; tooltip: ""; state: true
 2: name: "Grid Lines"; tooltip: ""; state: false
5: name: "Standard"
 1: name: "Pivot"; tooltip: ""; state: true
 2: name: "Bounding Box"; tooltip: ""; state: false
6: name: "Standard"
 1: name: "Perpendicular"; tooltip: ""; state: false
 2: name: "Tangent"; tooltip: ""; state: false
7: name: "Standard"
 1: name: "Vertex"; tooltip: ""; state: false
 2: name: "Endpoint"; tooltip: ""; state: false
 3: name: "Edge/Segment"; tooltip: ""; state: false
 4: name: "Midpoint"; tooltip: ""; state: false
 5: name: "Face"; tooltip: ""; state: false
 6: name: "Center Face"; tooltip: ""; state: false
OK

--The Snaps dialog must not necessarily be open,
--but in this example we will toggle it on to be able to see
--what is happening to the checkboxes:
max drawingaids --toggle on the Snaps dialog
-->OK --if it was closed, it should be open now
snapmode.getOSnapItemActive 7 1 --print the state of the Object>Vertex snap
-->false --it is off
--now toggle the vertex snap:
snapmode.setOSnapItemActive 7 1 (not(snapmode.getOSnapItemActive 5 1))
-->OK
max drawingaids; max drawingaids --toggle the Snaps dialog twice to refresh
-->OK
-->OK --the Vertex checkbox should be checked now
snapmode.getOSnapItemActive 7 1 --get the current Vertex snap state
-->true --it is now on

format "type: %; hilite: %; marksize: %; toFrozen: %\n" snapmode.type snapmode.hilite \
snapmode.markSize snapmode.toFrozen
format "axisConstraint: %; active: %; strength: %\n" snapmode.axisConstraint snapmode.active \
snapmode.strength

--This function can be registered as a RedrawViews Callback
--It will print information about the current snap state to the Listener
fn snapinfo =
(
local snapinfo
if snapmode.active do
(
struct snapinfo (hit, flags, hitpoint, worldhitpoint, screenHitPoint, OKForRelativeSnap, topRefPoint, refPoint, node)
local out = snapinfo snapmode.hit (bit.intAsHex snapmode.flags) snapmode.hitPoint \
snapmode.worldHitpoint snapmode.screenHitPoint snapmode.OKForRelativeSnap \
snapmode.refPoint snapmode.topRefPoint snapmode.node
print out
)
ok
)
unregisterRedrawViewsCallback snapinfo
registerRedrawViewsCallback snapinfo

 Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.