snapMode

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

Synopsis

snapMode [-curve boolean] [-distanceIncrement linear] [-edgeMagnet uint] [-edgeMagnetTolerance float] [-grid boolean] [-liveFaceCenter boolean] [-livePoint boolean] [-meshCenter boolean] [-pixelCenter boolean] [-pixelSnap boolean] [-point boolean] [-tolerance uint] [-useTolerance boolean] [-uvTolerance uint] [-viewPlane boolean]

snapMode is undoable, queryable, and NOT editable.

Return value

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

Flags

Long name (short name)	Argument types	Properties
-curve(-c)	boolean
Set curve snap mode
-point(-p)	boolean
Set point snap mode
-grid(-gr)	boolean
Set grid snap mode
-viewPlane(-vp)	boolean
Set view-plane snap mode
-livePoint(-lp)	boolean
While moving on live polygon objects, snap to its vertices.
-liveFaceCenter(-lfc)	boolean
While moving on live polygon objects, snap to its face centers.
-useTolerance(-ut)	boolean
If useTolerance is set, then point snapping is limited to points that are within a square region surrounding the cursor position. The size of the square is determined by the tolerance value.
-tolerance(-t)	uint
Tolerance defines the size of the square region in which points must lie in order to be snapped to. The tolerance value is the distance from the cursor position to the boundary of the square (in all four directions).
-uvTolerance(-uvt)	uint
uvTolerance defines the size of the square region in which points must lie in order to be snapped to, in the UV Texture Editor. The tolerance value is the distance from the cursor position to the boundary of the square (in all four directions).
-edgeMagnet(-em)	uint
Number of extra magnets to snap onto, regularly spaced along the edge.
-edgeMagnetTolerance(-emt)	float
Precision for edge magnet snapping.
-pixelCenter(-pc)	boolean
Snap UV to the center of the pixel instead of the corner.
-meshCenter(-mc)	boolean
While moving, snap on the center of the mesh that intersect the line from the camera to the cursor.
-pixelSnap(-ps)	boolean
Snap UVs to the nearest pixel center or corner.
-distanceIncrement(-dsi)	linear
Set the distance for the snapping to objects such as a lines or planes.

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

// Turn curve snapping on
snapMode -curve true;

// Returns true if point snapping is on
snapMode -q -point;