DBcopyElement

Top  Previous  Next

An element in another object copy

With DBcopyElement a copy of any element is put on in another (or to the same) object if this is permitted according to the data bank rules. While copying the resolution and the text graduation are converted if this is necessary. Also the element can be changed while copying in the size and receive a new position. Then first the dimensions change takes place, the rotation and last the movement.

Parametre

element (PELEMENT) [IN]

The trading of the element to be copied. The element can also belong to one of the special segments to disassemble, e.g., a symbol in his components.

zielObject (POBJECT) [IN]

The trading of the object in which the new element is inserted.

scaleX (STANDS IN) [IN]

scaleY (STANDS IN) [IN]

scaleZ (STANDS IN) [IN]

The co-ordinates are multiplied before copying by these factors. This is independent of converting the resolutions and happens on applying the rotation, before the translation with the offset.

offsetX (STANDS IN) [IN]

offsetY (STANDS IN) [IN]

offsetZ (STANDS IN) [IN]

After the rotation all co-ordinates with offset are shifted. The values are given in metre, so regardless of the resolution of the source element or aim element.

rotation (STANDS IN) [IN]

As the second reshaping a rotation becomes around the zero with the corner rotation carried out, so after the dimensions change and before the translation. The information is in, so 2*PI are a full circle.

transformTextscale (int) [IN]

With TRUE the text height is adapted in copied texts in the new Textscale.

Result

(PELEMENT) [OUT]

The trading of the anew generated element is returned as a result. If a mistake has appeared, ZERO is delivered instead of this as a result.

Remarks

Master elements are copied and all Member of the original master also become Member of the new master.

Member elements become, in addition, Member of the master to which the original Member belongs.

If a text element owns a state line, this is automatically cocopied and inserted as an element in the aim object.

Declaration

#include "database.h"

 

PELEMENT DLLENTRY DBcopyElement (

PELEMENT element,

POBJECT zielObject,

STAND-IN scaleX,

STAND-IN scaleY,

STAND-IN scaleZ,

STAND-IN offsetX,

STAND-IN offsetY,

STAND-IN offsetZ,

STAND-IN rotation,

int transformTextscale

);

Related functions

DBcopyObject

DBcopyPoint