sds_osnap

int sds_osnap (const sds_point point, const char *mode, sds_point answer);


Find a point based on this snap mode and point.


This function uses the specified object snap mode(s) to determine the resulting point, given a 3-D point.

The argument point is a 3-D point, which is the center of a square area defined by the system variable APERTURE. Sds_osnap looks for the object selected by this point.

The mode argument is the snap mode or modes used to find the resulting point :

Mode Meaning
"nea" NEArest
"end" ENDpoint
"mid" MIDpoint
"cen" CENter
"per" PERpendicular
"tan" TANgent
"qua" QUAdrant
"ins" INSertion
"po" POint
"int" INTersection (3D intersection)
"pla" PLAnview (2D intersection)
"vis" VISible (apparent intersection)
"off" Off

NOTE Separate multiple object snap modes with a comma, such as: "tan, qua, cen".

The argument answer is the 3-D point determined by the original point and the snap mode, such as the end of a line.

This function returns RTNORM (when it finds a point); otherwise, it returns an error code.

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)