DBaddSymbol

Top  Previous  Next

Add of a new symbol in the object.

With this call it is added to the object with the trading object a new symbol. A symbol is a geometrical element which is taken from a table. This table can be changed on generating the symbols and then influences the appearance of existing symbols in the drawing. A symbol exists of the symbolic number, so to the index in the symbolic list, a position and a rotation. The rotation is described across two corners alpha and beta which turn the symbol in the x Y level (alpha) and in the perpendiculars in addition.

Parametre

object (POBJECT) [IN]

This is the trading of the object in which a new attribute should be used.

symbolNum (SYMBOL) [IN]

With this number the appearance of the symbol is determined in the symbolic table. All symbols with this entry are influenced by changing an entry in the symbolic table in her appearance.

x (STANDS IN) [IN]

(x, y, z) gives the position of the symbol in the space.

y (STANDS IN) [IN]

Also with two-dimensional representation...

z (STANDS IN) [IN]

... if the z value is necessary. Then here it is easy to put down 0.

alpha (CORNER) [IN]

With alpha the rotation of the symbol is determined in the x Y level.

beta (CORNER) [IN]

With beta the inclination of the symbol is given in the too x-y vertical level.

Result

(PSYMBOL_ELEMENT) [OUT]

The trading of the anew generated element becomes as a result zurückgeliefert. If a mistake has appeared, ZERO is delivered as a result. Possible mistakes are a memory lack and invalid Objekthandle.

Declaration

#include "database.h“

 

PSYMBOL_ELEMENT DLLENTRY DBaddSymbol (

POBJECT object,

USHORT symbolNum,

STAND-IN x,

STAND-IN y,

STAND-IN z,

CORNER alpha,

CORNER beta

);