6.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 skewing the copy about a specified reference point by a given angle and optionally setting the draw order of the duplicated entity.

extern "C" void WINAPI VCDuplicateWithSkew(short* iError, ENTITYHANDLE lH, Point2D* dpRef, double dAngle, ENTITYHANDLE lHDrawAfter);

procedure VCDuplicateWithSkew (var iError: Smallint; lH: Longint; var dpRef: Point2D; dAngle: Double; lHDrawAfter: Longint); stdcall;

Sub DuplicateWithSkew(ByVal lH As Long, dpRef As IVCPoint2D, ByVal dAngle As Double, ByVal lHDrawAfter As Long)

lH - the handle of the entity to be duplicated.
dpRef - the point about which to skew the duplicated entity. Use 0.0,0.0 to skew about the origin.
dAngle - the angle to skew the duplicate entityin radians.
lHDrawAfter - the handle of the entity after which to draw the duplicated entity.  Use -1 to not set the draw order and to draw the entity at the end of the database.

None.

0 - Success
1 - Invalid world
2 - Invalid entity handle to be duplicated

Normally when changing or editing entities in Visual CADD™ it would be necessary to first query for each of the coordinates of the entity and then reintroduce the entity into the database using the VCAdd...Entity functions after skewing those points. VCDuplicateWithSkew allows for skewing of the copied entity without the need for other mathematical routines. VCDuplicateWithSkew uses the entity's transformed settings, in contrast to VCDuplicate which uses current settings, except that VCDuplicateWithSkew uses the current properties for layer, color, line type, and line width. The reason for the exception is that settings can include length, position, and rotation settings which can be affected by the transformation, thus VCDuplicateWithSkew uses the entity's transformed settings.

In comparison, VCDuplicate does this by copying the specified entity with all its data points while still adopting all the current applicable settings.

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. VCDuplicateWithSkew can optionally set the new entity to be drawn after any valid entity without the need to separately use VCDrawCurrentEntityAfter. For example, if it were desired that the duplicate be drawn after the entity it is copying, then use lHDrawAfter equal to lH. If setting draw order is not desired, then use lHDrawAfter equal to -1.

With various combinations and sequences of VCDuplicateWithRotate, VCDuplicateWithSkew, VCDuplicateWithScale, and VCDuplicateWithMove, it is possible to duplicate entities with any possible linear transformation.

VCDrawCurrentEntityAfter, VCDuplicateWithTransform, VCDuplicateWithRotate, VCDuplicateWithScale, VCDuplicateWithMove