QPx_RotateAreaImage
| 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.
Example
// Rotate area image by 90 degrees counter-clockwise C_LONGINT($error) $error:=QPx_RotateAreaImage (gQPixArea;-90)