DBaddString

New line train in the object insert

Every object can contain any number of line trains. A line train is not necessarily coherent. He exists rather of a result of lines, cuttings of a circle and Splines which own a sign key and a shading as common qualities. The sign key gives the kind of the bordering line trains, the shading gives the filling of the inner surface. If the shading 0 is, it concerns not a surface, but a line train. With DBaddString such becomes, suspended empty line train to the given object. The procedure delivers the trading of the line train as a result. Then with the function DBaddPoint points can be added to the line train.

Parametre

object (POBJECT) [IN]

The string (line train) is added to this object.

format (int) [IN]

Gives whether it concerns with this element one with 2-dimenionalen or 3-dimensional co-ordinates. There are predefined constants FORMAT_2D and FORMAT_3D. However, the values 0 can be also used for 2-dimensional and 1 for 3-dimensional.

zeichenschluessel (int) [IN]

With this value the appearance of the border of the surface, or the line train becomes certainly. The value serves as an index in the table of the sign keys, so that all line trains with the same sign key by change to this table a new appearance can receive.

schraffur (int) [IN]

How the sign key determines the border, the inside of the line train is determined with the shading. As a special case, on this occasion, serves the value 0. If is the sign key of a string 0, it concerns a line train, he has passed away of 0, it concerns a surface. With surfaces the filling pattern and the kind of the filling is also fixed by a table. schraffur the index is in this table.

Declaration

#include "database.h"

PSTRING_ELEMENT DLLENTRY DBaddString (

POBJECT object,

int format,

int zeichenschluessel,

int schraffur

);

Constants

#define FORMAT_2D 0

#define FORMAT_3D 1