Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
RotateCommand Class
See Also  Members   Example 
Leadtools.ImageProcessing Namespace : RotateCommand Class



Rotates an image by the number of degrees specified.

Object Model


Syntax

Visual Basic (Declaration)  
Public Class RotateCommand 
   Inherits RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage) Copy Code
Dim instance As RotateCommand
C#  
public class RotateCommand : RasterCommand, IRasterCommand 
C++/CLI  
public ref class RotateCommand : public RasterCommand, IRasterCommand 

Example

This example will load an image, rotate it by 45 degrees and then save it back to disk

Visual Basic Copy Code
Public Sub RotateCommandExample()
 RasterCodecs.Startup()
 Dim codecs As RasterCodecs = New RasterCodecs()

 Dim srcFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"
 Dim destFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "RotateCommand.bmp"

 ' Load the source image from disk
 Dim image As RasterImage = codecs.Load(srcFileName)

 ' Rotate the image by 45 degrees
 Dim command As RotateCommand = New RotateCommand()
 command.Angle = 45 * 100
 command.FillColor = New RasterColor(255, 255, 255)
 command.Flags = RotateCommandFlags.Bicubic
 command.Run(image)

 ' Save it to disk
 codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24)

 ' Clean Up
 image.Dispose()
 RasterCodecs.Shutdown()
      End Sub
C# Copy Code
public void RotateCommandExample() 
{ 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"; 
   string destFileName = LeadtoolsExamples.Common.ImagesPath.Path + "RotateCommand.bmp"; 
 
   // Load the source image from disk 
   RasterImage image = codecs.Load(srcFileName); 
 
   // Rotate the image by 45 degrees 
   RotateCommand command = new RotateCommand(); 
   command.Angle = 45 * 100; 
   command.FillColor = new RasterColor(255, 255, 255); 
   command.Flags = RotateCommandFlags.Bicubic; 
   command.Run(image); 
 
   // Save it to disk 
   codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24); 
 
   // Clean Up 
   image.Dispose(); 
   RasterCodecs.Shutdown(); 
}

Remarks

This command has the following features:

  • It uses the center of the image as the center of rotation.
  • It can rotate the image clockwise or counterclockwise up to 360 degrees in 100th-degree increments.
  • It can resize the image to accommodate the rotated height and width, or it can retain the original height and width, cropping the image as necessary.
  • It uses FillColor as the background color to fill any new area created by the rotation.

RotateCommandFlags.Resample and RotateCommandFlags.Bicubic can be combined with RotateCommandFlags.Resize, but they can not be combined with each other.

If RotateCommandFlags.Resize is set, then the image is resized. Otherwise, the image is cropped.

Interpolation can be done while rotating certain images. This produces superior output, eliminating the jaggedness occurring when rotating images at angles that are not multiples of 90. (ie when RotateCommand.Angle is not a multiple of 9000).

The only images that are interpolated are:

For all other images, RotateCommand ignores the resampling flags and the rotate is performed without interpolation.

For more information, refer to Processing an Image.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.RotateCommand

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also