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

DBdeletePoint

DBinsertPoint

DBaddPointExisting

Remarks

The function is a macrodefinition of DBaddPointExisting