DBinsertPoint

A point in the middle of a string insert.

Every string element exists of any number of points which exist, among the rest, 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 DBinsertPoint another point is inserted in a string at any place.

Parametre

point (T_PPOINT) [IN]

Behind this point the new point is inserted. If instead of the Handles for a point the trading of a string element is given, the new point is inserted before the first available point.

pbuf [3] (STANDS IN) [IN]

This is the position of the new point in the space. If is given as a format FORMAT_2D, only the first both 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 does not connect, 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 pbuf is ignored.

Result

(T_PPOINT) [OUT]

If the base could be put on, a trading becomes on it zurückgeliefert, but ZERO.

Declaration

#include "database.h"

T_PPOINT DLLENTRY DBinsertPoint (

T_PPOINT point,

STAND-IN pbuf [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

Related functions

DBdeletePoint

DBaddPointElement

Marker element in the object generate.

While line trains must contain at least one base, single points can be accommodated with point elements in the data bank. Besides, every point element exists of a single point with all qualities of a point from a string. On the screen point elements appear in a special form. Point elements with point classes between 1 and 15 are shown according to the markers by Gradis, i.e. as not scaled geometrical marks. All the other point elements do not become visible. This can become from the user with the help of own sign function umdefiniert. All the other qualities of the point are not considered with the drawing. However, they are stored consistently in the point element.

Parametre

object (POBJECT) [IN]

The new point element should be inserted in this object. If the object is selected, the new element is shown immediately.

pbuf [3] (STANDS IN) [IN]

This field contains the co-ordinates of the new point element. If as format FORMAT_2D is given, only the first both values are considered.

linkage (int) [IN]

This value becomes as a LINK _? however, put down in the point element, points no effect, because only a single point exists. This can be badly connected with a predecessor.

symbol (int) [IN]

If at this point one of 0 different numbers stands, the suitable symbol is drawn here instead of the point element.

first-class (int) [IN]

As long as symbol 0 are, the appearance of the point element determines first-class. For values between 1 and 15 the mark symbol known from Gradis is drawn, but the point element remains invisible.

format (int) [IN]

As possible values exist here FORMAT_2D and FORMAT_3D. With FORMAT_2D the third co-ordinate (z value) is accepted as 0 and is not taken over from pbuf.

Result

(PPOINT_ELEMENT) [OUT]

The trading of the element inserted anew. With this trading the element can be questioned and manipulated.

Declaration

#include "database.h"

[****]

PPOINT_ELEMENT DLLENTRY BaddPointElement (

POBJECT object,

STAND-IN pbuf [3],

int linkage,

int symbol,

int first-class,

int format

);

[****]