QPx_RotateAreaImage(areaRef; areaRef; areaRef; areaRef):error
areaRef Longint QPix area reference
numDegrees Real Rotation degrees
rotateOptions Longint Options
backColor Longint Background color
error Longint Error result

Rotate the image in a QPix area by a number of degrees

The QPix plug-in area is specified by areaRef. If areaRef is not a valid QPix plug-in area reference, qpx_paramErr is returned.

The number of degrees is specified in the numDegrees parameter. Positive values cause clockwise rotation, negative values rotate the picture counter-clockwise.

The rotateOptions parameter is optional. It can be used to specify options for the rotation operation. The following constants can be combined with bitwise "or".

qpx_RotateHighQuality 0x0004 High quality rotation
qpx_RotateFillBackground 0x0800 Fill background with specified color

Parameter backColor is also optional and is meaningful only when the qpx_RotateFillBackground is specified in rotateOptions. It specifies the fill color of the background area when rotating by non-multiples of 90 degrees. 4D's 0xRRGGBB notation is used.


   // Rotate area image by 90 degrees counter-clockwise


$error:=QPx_RotateAreaImage (gQPixArea;-90)