ImageEn, unit imageenproc

TImageEnProc.Rotate

TImageEnProc.Rotate


Declaration

procedure Rotate(Angle: Double; AntiAliasMode: TIEAntialiasMode = ierFast; BackgroundColor: TColor = -1);


Description

Rotate the current image by the specified angle (negative or positive degrees counter-clockwise).

AntialiasMode specifies the algorithm used to improve rotation quality (only used when angle is NOT 90, 180 or 270):
Bicubic, highest quality
Value Description
ierNone No anti-aliasing (lowest quality)
ierFast Fast, but lower quality
ierBilinear Bilinear, high quality
ierBicubic  

BackgroundColor specifies an alternative background color to fill new regions (i.e. when not rotating at a 90 degree angle). It is not used if the image contains an alpha channel.
If -1, Rotate uses the default background. If clNone, then an alpha channel is applied to the image and the non-image area will become transparent.

This is a common image from a digital camera that was not held correctly causing the horizon not to be level.



After calling ImageEnView1.Proc.Rotate( 5 ):



Note:
- If the image has an alpha channel then the null area is filled with transparency (so you will not see the background color). To prevent the transparent area, and force a background color fill, remove the alpha channel
- To crop the image caused by rotation, use RotateAndCrop
- To crop and rotate an ROI, use Crop
- To allow the user to interactively rotate the image, use RotateTool
- If PdfViewer is enabled, this will redirect to PageRotation
- A UI for this is available to your users in the Image Processing dialog


Anti-alias Modes





Demos

Demo  Demos\ImageEditing\CompleteEditor\PhotoEn.dpr
Demo  Demos\ImageEditing\EveryMethod\EveryMethod.dpr


Examples

// Rotate the image 45 clockwise at highest quality and using the ImageEnView background color
ImageEnView1.Proc.Rotate( 315, ierBicubic, -1 );

// Rotate the image 90 clockwise (Note: AntialiasMode is irrelevant for 90 deg. rotations)
ImageEnView1.Proc.Rotate( 270 );

// Rotate the image 180 clockwise
ImageEnView1.Proc.Rotate( 180 );

// Rotate the image 90 counter-clockwise
ImageEnView1.Proc.Rotate( 90 );

// Rotate the image 45 clockwise at highest quality and make the non-image area transparent
ImageEnView1.Proc.Rotate( 315, ierBicubic, clNone );

// Which is the same as...

// Rotate the image 45 clockwise, with good quality, and the null area created by the rotation set as transparent
ImageEnView1.IEBitmap.AlphaChannel; // Create an alpha channel if one does not exist
ImageEnView1.Proc.Rotate( -45, ierBicubic );

// Rotate the image 45 clockwise, with good quality, and the null area created by the rotation set as black
ImageEnView1.IEBitmap.RemoveAlphaChannel; // Remove alpha channel if there is one
ImageEnView1.Proc.Rotate( -45, ierBicubic, clBlack );


// Load and rotate an image 90 counter-clockwise
ImageEnView1.IO.LoadFromFile( 'D:\TestImage.jpg' );



ImageEnView1.Proc.Rotate( 90 );




See Also

- Global Image Methods
- AngleToImageEnRotateAngle