Command: snap

Syntax

snap <point> { ,<elist> ... }

Description

Snap to a position on a graphic primitive (entity) nearest to a seed position.

Parameters

• <point>
  A seed position for the snap operation.

• <elist>
  A group/entity list defining which entities are to be searched during the snap operation. If omitted, the current contents of the all group are searched.

Switches

• -op=<ident>
  Record the successful snap position in a point identifier. If <ident> does not exist it will be created using current scope rules. If the snap operation is unsuccessful, no point value will be recorded.

• -q
  When a successful snap to an entity results, confirmation of the entity is displayed in the monitor window. Use of this switch suppresses the confirmation message.

• -sm=<num>
  The snap mode: which indicates which entity location points should be considered. Possible values are:
  

  Value	Description
  1	Snap to entity vertices only
  2	Snap to entity edges and vertices (default behavior)
  4	Snap to entity lugs only

• -tol=<num>
  The snap tolerance: only entities which are within this distance of the seed position are examined. It is advisable to always provide such a tolerance, measured in world units.

Notes

A successful snap to an entity will set the value of the system epointer this. An unsuccessful snap will set the value of this to null.

Examples

Snap to a position on a polygon. The seed point is derived interactively. Record the position in a point identifier.

point pseed = pcur, panswer
snap pseed,polygon_filter,-op=panswer,-tol=1,-q
if (this) tell <'Successful snap to',this,'at',panswer>
else tell 'Snap failed'

See Also