3ds Max C++ API Reference
Snap Flags

Macros

#define SNAP_IN_3D   (0)
 Snap to all points. More...
 
#define SNAP_IN_PLANE   (1<<0)
 Snap only to points on the construction (or optionally specified) plane. More...
 
#define SNAP_UNSEL_OBJS_ONLY   (1<<1)
 Ignore selected nodes when considering snap points. More...
 
#define SNAP_SEL_OBJS_ONLY   (1<<2)
 Ignore unselected nodes when considering snap points. More...
 
#define SNAP_UNSEL_SUBOBJ_ONLY   (1<<3)
 Ignore selected sub-object geometry when considering snap points. More...
 
#define SNAP_SEL_SUBOBJ_ONLY   (1<<4)
 Ignore unselected sub-object geometry when considering snap points. More...
 
#define SNAP_FORCE_3D_RESULT   (1<<5)
 Override user settings to force snap in 3D. More...
 
#define SNAP_OFF_PLANE   (1<<6)
 
#define SNAP_TRANSPARENTLY   (1<<7)
 
#define SNAP_APPLY_CONSTRAINTS   (1<<8)
 
#define SNAP_PROJ_XAXIS   (1<<9)
 
#define SNAP_PROJ_YAXIS   (1<<10)
 
#define SNAP_PROJ_ZAXIS   (1<<11)
 
#define SNAP_XFORM_AXIS   (1<<12)
 Informs the osnapmanager to invalidate the com axis. More...
 
#define SNAP_BEGIN_SEQ   (1<<13)
 
#define SNAP_END_SEQ   (1<<14)
 
#define SNAP_USE_XFORM_AXIS_IF_NO_SNAP_POINT_FOUND   (1<<15)
 If set, the origin of the selection's transform matrix is used as start snap point if no snap point candidates are found. More...
 
#define SNAP_USE_XFORM_AXIS_AS_START_SNAP_POINT   (1<<16)
 If set, the origin of the selection's transform matrix is used as start snap point. More...
 
#define SNAP_OVERRIDE_UNSEL_OBJS_ONLY   (1<<17)
 If set, this overrides the SNAP_UNSEL_OBJS_ONLY flag to allow snap to selected objects. More...
 
#define SNAP_DURING_CREATION   (1<<18)
 If set, this allows snaps to objects while they are being created (A_OBJ_LONG_CREATE flag set). More...
 

Detailed Description

Macro Definition Documentation

◆ SNAP_IN_3D

#define SNAP_IN_3D   (0)

Snap to all points.

◆ SNAP_IN_PLANE

#define SNAP_IN_PLANE   (1<<0)

Snap only to points on the construction (or optionally specified) plane.

◆ SNAP_UNSEL_OBJS_ONLY

#define SNAP_UNSEL_OBJS_ONLY   (1<<1)

Ignore selected nodes when considering snap points.

◆ SNAP_SEL_OBJS_ONLY

#define SNAP_SEL_OBJS_ONLY   (1<<2)

Ignore unselected nodes when considering snap points.

◆ SNAP_UNSEL_SUBOBJ_ONLY

#define SNAP_UNSEL_SUBOBJ_ONLY   (1<<3)

Ignore selected sub-object geometry when considering snap points.

◆ SNAP_SEL_SUBOBJ_ONLY

#define SNAP_SEL_SUBOBJ_ONLY   (1<<4)

Ignore unselected sub-object geometry when considering snap points.

◆ SNAP_FORCE_3D_RESULT

#define SNAP_FORCE_3D_RESULT   (1<<5)

Override user settings to force snap in 3D.

◆ SNAP_OFF_PLANE

#define SNAP_OFF_PLANE   (1<<6)

Used internally to snap only to points off the plane. Many of the objects call GetCPDisp() when they want to snap lenghts etc. This method knew nothing about the snapping that was added in 3ds Max 2.0 so it had to be retrofited to call SnapPoint(). This is where SNAP_OFF_PLANE is called. It forces the osnapmanager to only consider points which are OFF the current construction plane.

◆ SNAP_TRANSPARENTLY

#define SNAP_TRANSPARENTLY   (1<<7)

Used internally to suppresses any display in the viewports. This can be used to provide a way of snapping to arbitrary screen points without giving feedback.

◆ SNAP_APPLY_CONSTRAINTS

#define SNAP_APPLY_CONSTRAINTS   (1<<8)

Used internally to suppresses any display in the viewports.

◆ SNAP_PROJ_XAXIS

#define SNAP_PROJ_XAXIS   (1<<9)

Used internally to suppresses any display in the viewports.

◆ SNAP_PROJ_YAXIS

#define SNAP_PROJ_YAXIS   (1<<10)

Used internally to suppresses any display in the viewports.

◆ SNAP_PROJ_ZAXIS

#define SNAP_PROJ_ZAXIS   (1<<11)

Used internally to suppresses any display in the viewports.

◆ SNAP_XFORM_AXIS

#define SNAP_XFORM_AXIS   (1<<12)

Informs the osnapmanager to invalidate the com axis.

◆ SNAP_BEGIN_SEQ

#define SNAP_BEGIN_SEQ   (1<<13)

◆ SNAP_END_SEQ

#define SNAP_END_SEQ   (1<<14)

◆ SNAP_USE_XFORM_AXIS_IF_NO_SNAP_POINT_FOUND

#define SNAP_USE_XFORM_AXIS_IF_NO_SNAP_POINT_FOUND   (1<<15)

If set, the origin of the selection's transform matrix is used as start snap point if no snap point candidates are found.

◆ SNAP_USE_XFORM_AXIS_AS_START_SNAP_POINT

#define SNAP_USE_XFORM_AXIS_AS_START_SNAP_POINT   (1<<16)

If set, the origin of the selection's transform matrix is used as start snap point.

No other snap point candidates that fall into the snap point radius is displayed or used as start snap point.

◆ SNAP_OVERRIDE_UNSEL_OBJS_ONLY

#define SNAP_OVERRIDE_UNSEL_OBJS_ONLY   (1<<17)

If set, this overrides the SNAP_UNSEL_OBJS_ONLY flag to allow snap to selected objects.

This is used by shape objects so that they can snap to other selected shapes during creation when "Start New Shape" is off.

◆ SNAP_DURING_CREATION

#define SNAP_DURING_CREATION   (1<<18)

If set, this allows snaps to objects while they are being created (A_OBJ_LONG_CREATE flag set).

Used by Spline object so that users can snap to other points in the shape during creation, if desired.