5.0

Makes a copy of the specified entity using the entity's settings and the current properties for layer, color, line type, and line width, while allowing for scaling, translation, and rotation of the copied entity. The copy's draw order is set to immediately follow the original entity.

extern "C" void WINAPI VCDuplicateWithTransformInDrawOrder(short* iError, ENTITYHANDLE lH, Point2D* dpTrans, Point2D* dpScale, double dAngle);

procedure VCDuplicateWithTransformInDrawOrder(var iError: Smallint; lH: Longint; var dpTrans: Point2D; var dpScale: Point2D; dAngle: Double); stdcall;

Sub DuplicateWithTransformInDrawOrder(ByVal lH As Long, dpTrans As IVCPoint2D, dpScale As IVCPoint2D, ByVal dAngle As Double)

lH - the handle of the entity to be duplicated.

dpTrans - the coordinate pair distance to move the duplicated entity. Use 0,0 to keep same position.

dpScale - the X and Y scale factors to apply to the duplicated entity. Use X=1, Y=1 to keep the same scale.

dAngle - the angle to rotate the duplicate entity from the horizontal

None

0 - Success
1 - Invalid world
2 - Entity handle out of range
3 - Unable to set entity as current

Normally when adding new entities to the database using VCDuplicate... functions or VCAdd...Entity functions, the new entity is added at the end of the database and at the end of the draw order. VCDuplicateWithTransformInDrawOrder performs the same entity duplication as VCDuplicateWithTransform and additionally sets the draw order of the new entity immediately after the original entity without the need to separately use VCDrawCurrentEntityAfter.

VCDuplicateWithTransform, VCDrawCurrentEntityAfter, VCDuplicate, VCDuplicateInDrawOrder