DBcopyObject

Top  Previous  Next

An object copy in another segment.

With DBcopyElement a copy of any object is put on in another (or to the same) segment 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 object can be changed while copying in the size and receive a new position. Last first the dimensions change, then the rotation takes place, the movement. DBcopyObject calls for this purpose only in a loop DBcopyElement.

Parametre

obj (POBJECT) [IN]

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

flat (PPLANS) [IN]

The trading of the plan in which the new object is inserted. If here ZERO is given, the object belongs to no plan.

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, however, before the translation with the offset.

offsetX (STANDS IN) [IN]

offsetY (STANDS IN) [IN]

offsetZ (STANDS IN) [IN]

After the rotation all co-ordinates are shifted around the offset. 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

(POBJECT) [OUT]

The trading of the anew generated object 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"

 

POBJECT DLLENTRY DBcopyObject (

POBJECT obj,

PPLANS flat,

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

DBcopyElement

DBcopyPoint