QPx_RotateAreaImage

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

Rotates the image in a QPix plug-in 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, while negative values rotate the picture counter-clockwise.

The rotateOptions paramater 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.

Example

  `Rotate area image by 90 degrees counter-clockwise
 
C_LONGINT($error)
 
$error:=QPx_RotateAreaImage (gQPixArea;-90)
 

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:44:25