Click above to get retro games delivered to your door ever month!

OBJ_SNAPNT()                                               C_EXAM11,C_DEMO
   Moves a point guided by a line to a new position.

   Syntax
         nIndex = OBJ_SNAPNT(nIndex)

   Arguments
         nIndex      Object number.

   Returns
         nIndex      Returns the object number if successful, a 0 if there was
                     no object with that number or the move was cancelled, or
                     a negative of the object number if it overlaps another
                     object.

   Description
         OBJ_SNAPNT() will move a point by drawing a line from the point
         where the mouse cursor was last pressed until the operation is
         finished when the DrawButton (the default is the left mouse button,
         see CAD_SETUP()) is pressed. This type of moving function is called a
         snap because the object is not seen moving on the screen.

         If CHECK_OLAP() was set on, it will also check to see if the point
         coordinates directly overlay another of its same type. If it does,
         OBJ_SNAPNT() will return the negative of the object number snapped.