DBsignaturAddAreakeyEntry

Top Previous Next

Entry for surface key insert in the signature table.

Within the signature tables there are entries for the appearance of lines and the appearance of surfaces. With DBsignaturAddAreakeyEntry the appearance is influenced by surfaces if the first object key of the accompanying object lies between key_low and key_high and the shading / surface key between dkaLow and dkaHigh. Before an entry must have been put on with DBsignaturAddKeygroupEntry for exactly this area key_low to key_high. Then the qualities of the surface become effective according to issue device. During on pencil plotters usually the information toolNr, stood off (of the lines for the shading), winkel (the shading) and linienart are effective, becomes on the screen farbe and flag uses. In flag if the line kinds of the screen and their visibility are hidden, besides.

Parametre

root (PROOT) [IN]

The trading of the data bank.

tabelle (int) [IN]

The number of the table which should be manipulated. For the tables constants have been defined: ORIGINAL_BILDSCHIRM_SIGNATUR_TABELLE, PLOTTER_SIGNATUR_TABELLE, BILDSCHIRM_SIGNATUR_TABELLE. Of wide tables can lie in the area of from 4 to 10.

key_low (KEY) [IN]

Within by the parametre tabelle certain signature table the untertable of the object keys is determined by key_low and key_high. An untertable must have been put on with DBsignaturAddKeygroupEntry for exactly this area, so that the procedure works successfully. Then in this untertable a new entry is put on for the sign keys dkyLow to dkyHigh.

key_high (KEY) [IN]

dkaLow (surface-key) [IN]

The appearance of an element, e.g., of a line train, is determined exactly by this new entry when the object key lies in the area key_low to key_high and the surface key of the concerning element lies in the area dkaLow to dkaHigh.

dkaHigh (surface-key) [IN]

The appearance of an element, e.g., of a line train is determined exactly by this new entry when the object key lies in the area key_low to key_high and the surface key of the concerning element lies in the area dkaLow to dkaHigh.

toolNr (USHORT) [IN]

If it concerns the plotter signature table, herewith it is fixed which tools are used to the issue of the shading element. The real pencil is determined again with the help of the tool table.

farbe (USHORT) [IN]

Herewith on the screen and by the issue devices which do not work with pencils the colour of a surface is fixed. Then the value 0 must stand in stift.

wide (USHORT) [IN]

With wide ones the width which should have the lines with shadings is given.

stood off (USHORT) [IN]

This entry determines the distance of the lines in 1/100 mm with shadings.

winkel (USHORT) [IN]

This is the corner in degree to the legal Saxon with shadings.

flag (USHORT) [IN]

With this variable it is fixed which line type of a line on the screen is assigned. This is valid only for with shadings. As possible types are by the following constants defined intended:

DRAW_LINETYPE_DEFAULT,

DRAW_LINETYPE_DOT,

DRAW_LINETYPE_SHORTDASH,

DRAW_LINETYPE_DASHDOT,

DRAW_LINETYPE_DOUBLEDOT,

DRAW_LINETYPE_LONGDASH,

DRAW_LINETYPE_DASHDOUBLEDOT,

DRAW_LINETYPE_SOLID,

SCHRAFFUR_X,

SCHRAFFUR_LINE,

SCHRAFFUR_CROSS,

SCHRAFFUR_OFF.

symbol (SYMBOL) [IN]

If here one of 0 different values stands, the shading not with a line, but with symbols is carried out. The distance of the symbols is from symbolAbstand. The minimum distance from the end of the shading is to be taken from symbolAbstandMin.

symbolAbstand (USHORT) [IN]

If the shading is carried out with the help of symbols, become these symbols with a distance from symbolAbstand drawn. The information is in 1/100 mm.

symbolAbstandMin (USHORT) [IN]

So that the shading with symbols does not stretch beyond the end of the shading, a least distance can be given from the end, namely symbolAbstandMin. A symbol is drawn only if the distance is up to the edge of the surface even greater than this value. The information is carried out in 1/100 mm.

numLinienArtSegmente (USHORT) [IN]

This variable brags how many entries the field linienArt owns. It has to go concern a just number. This becomes not abgeprüft and can lead to unforeseen results in the plot.

linienArt (USHORT *) [IN]

This is a field with the information as long the lines and gaps of a line type are. The information occurs in 1/100 mm. A line-dotted line with line length 2 mm and point length 0.5 mm with 1 mm of space has 4 entries 200 100 50 100.

stift (UHSORT) [IN]

If stift a value has incomparably 0, it is drawn to the representation by surfaces with the pencil. With stift the colour is also defined at the same time.

Result

(T_ERROR) [OUT]

ERROR_OK by perfect implementation, but one of the error messages defined in ERROR.H.

Declaration

#include "database.h"

T_ERROR DLLENTRY DBsignaturAddAreakeyEntry (

PROOT root,

int tabelle,

KEY key_low,

KEY key_high,

Surface-key dkaLow,

Surface-key dkaHigh,