Language Reference Guide : 4. System Classes : BitmapObject Class : OrientBitmap Method
 
Share this page                  
OrientBitmap Method
The OrientBitmap method rotates or reflects a bitmap geometrically.
This method has the following syntax:
BitmapObject = BitmapObject.OrientBitmap(angle = integer | reflection = integer
          [, backcolor = integer][, asnewobject = integer])
This method has the following parameters:
angle
(Either this parameter or reflection is required.) Specifies the angle of rotation to apply, in degrees.
Rotations other than 90, 180, 270, and 360 increase the size of the BitmapObject. The additional areas will be given the color specified by the backcolor parameter.
reflection
(Either this parameter or angle is required.) Specifies the type of reflection to apply to the image. Valid values are:
FO_VERTICAL
Applies top-to-bottom reflection to the bitmap
FO_HORIZONTAL
Applies left-to-right reflection to the bitmap
Descriptions of system constant values and their numeric equivalents are listed in Orientation Settings for TableField, StackField, SliderField, ScrollbarField, RadioField, and PaletteField.
backcolor
Specifies the RGB color to change exposed areas of background to, for rotations that are not multiples of 90 degrees.
Default: RGB(0,0,0)
asnewobject
Specifies whether to create a new object with the changes applied, rather than apply them to the host BitmapObject.
Default: FALSE
The method returns a reference to the bitmap object itself, unless asnewobject is set to TRUE, in which case a new object with the changes is returned, and the original BitmapObject is unchanged.
The method returns NULL on failure, and the bitmap object’s errorstatus is set to a non-zero value. Descriptions of system constant values and their numeric equivalents are listed in Error Codes.