DBaddPoint |
Top Previous Next |
Base add, ID is not known. Every string element exists of any number of points which exist above all of a position and a connecting kind to the predecessor. As connections are possible for no (invisible) connection (P), just line (L), circle (R) and Spline (C). With DBaddPoint another point is added to a string behind. Parametre string (PSTRING_ELEMENT) [IN] The point is suspended to this string element. pos [3] (STANDS IN) [IN] This is the position of the new point in the space. If in format FORMAT_2D is given, only the first both values are used. With FORMAT_3D all three values are used. linkage (int) [IN] With this value the kind of the connection with the preceding point is fixed. As possible values the LINK_L defined below, LINK_R, LINK_C and LINK_P are allowed here. The first point of a string must have the Linkagetyp LINK_P. This is not checked, but is simply accepted with the processing procedures. LINK_L connects with a distance, LINK_P connects invisibly, LINK_C connects with a Spline and LINK_R connects with a segment of a circle. symbol (int) [IN] The real point can be shown with a symbol obviously. If in symbol 0 are given, no symbol is used. Otherwise the symbol with the given number is taken from the symbolic table. first-class (int) [IN] Points are divided into point classes which can be used, e.g., for the search. Herewith this class is fixed. format (int) [IN] Possible values are FORMAT_2D and FORMAT_3D. Herewith it is fixed whether the point owns a height or not. In case of FORMAT_2D the 3rd co-ordinate from position is ignored. Result (T_PPOINT) [OUT] The trading of the point which was anew put on in the given string. If a mistake has appeared ZERO is returned instead of this.
Declaration #include "database.h"
T_PPOINT DLLENTRY DBaddPoint ( PSTRING_ELEMENT string, STAND-IN pos [3], int linkage, int symbol, int first-class, int format ); Constants #define LINK_L 1 #define LINK_R 2 #define LINK_P 3 #define LINK_C 4 #define LINK_CON 5 #define LINK_RPT 6 #define LINK_CLS 7 #define LINK_EBD 8 Related functions Remarks The function is a macrodefinition of DBaddPointExisting
|