pymel.core.general.snapMode

snapMode(*args, **kwargs)

The snapMode command is used to control snapping. It toggles the snapping modes in effect and sets information used for snapping.

Flags:

• curve : c (bool) [create,query]

  Set curve snap mode

• distanceIncrement : dsi (float) [create,query]

  Set the distance for the snapping to objects such as a lines or planes. Flag can have multiple arguments, passed either as a tuple or a list.

• edgeMagnet : em (int) [create,query]

  Number of extra magnets to snap onto, regularly spaced along the edge.

• edgeMagnetTolerance : emt (float) [create,query]

  Precision for edge magnet snapping.

• grid : gr (bool) [create,query]

  Set grid snap mode

• liveFaceCenter : lfc (bool) [create,query]

  While moving on live polygon objects, snap to its face centers.

• livePoint : lp (bool) [create,query]

  While moving on live polygon objects, snap to its vertices.

• pixelCenter : pc (bool) [create,query]

  Snap UV to the center of the pixel instead of the corner.

• pixelSnap : ps (bool) [create,query]

  Snap UVs to the nearest pixel center or corner.

• point : p (bool) [create,query]

  Set point snap mode

• tolerance : t (int) [create,query]

  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).

• useTolerance : ut (bool) [create,query]

  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.

• uvTolerance : uvt (int) [create,query]

  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).

• viewPlane : vp (bool) [create,query]

  Set view-plane snap mode

Derived from mel command maya.cmds.snapMode