| Herd Software Development
|=
DaVinci Graphics Library
|==
DaVinci Documentation Home Search Order


Leonardo: The RotateEnhMetaFile function

Rotates an enhanced metafile in multiples of 90 degrees. (A separate routine is provided for standard metafiles.)

HENHMETAFILE API RotateEnhMetaFile(
HENHMETAFILE hEnhMetaFile,
int iAngle);

hEnhMetaFile HENHMETAFILE Handle of the source enhanced metafile on which the rotated copy is based.

iAngle int Angle of rotation. Must be specified as one of the three following values:
900 : Rotate 90° to the left
-900 : Rotate 90° to the right
1800 : Rotate 180° onto the heading.

Returns

If successful, the return value is a handle to a rotated copy of the source enhanced metafile, otherwise it is NULL. Failure is generally due to insufficient memory. The handle can be passed to PlayEnhMetaFile for playing immediately upon return. Applications must release this handle using DeleteEnhMetaFile.

Remarks

Enhanced metafiles can be highly complex data structures. Whether this function produces a pleasing result depends a greead deal on the quality of the original file.

Enhanced metafiles produced via DXF file import (DaVinci) can be rotated using this function.

Enhanced metafiles generated via EPS import (DaVinci) cannot be rotated using this function.