←Select platform

RotateCommand Class

Summary
Rotates an image by the number of degrees specified.
Syntax
C#
Objective-C
C++/CLI
Java
Python
public class RotateCommand : RasterCommand 
@interface LTRotateCommand : LTRasterCommand 
public class RotateCommand extends RasterCommand 
public ref class RotateCommand : public RasterCommand   
class RotateCommand(RasterCommand): 
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.

Example

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

C#
Java
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
 
 
public void RotateCommandExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
 
	string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
	string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "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(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 
 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.*; 
 
 
public void rotateCommandExample() { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   RasterCodecs codecs = new RasterCodecs(); 
   String srcFileName = combine(LEAD_VARS_IMAGES_DIR, "rgsref.cmp"); 
   String destFileName = combine(LEAD_VARS_IMAGES_DIR, "RotateCommand.bmp"); 
 
   // Load the source image from disk 
   RasterImage image = codecs.load(srcFileName); 
 
   // Rotate the image by 45 degrees 
   RotateCommand command = new RotateCommand(); 
   command.setAngle(45 * 100); 
   command.setFillColor(new RasterColor(255, 255, 255)); 
   command.setFlags(RotateCommandFlags.BICUBIC.getValue()); 
   command.run(image); 
 
   // Save it to disk 
   codecs.save(image, destFileName, RasterImageFormat.BMP, 24); 
   assertTrue("file unsuccessfully saved to " + destFileName, (new File(destFileName)).exists()); 
   System.out.printf("File saved successfully to %s%n", destFileName); 
 
   // Clean Up 
   image.dispose(); 
   codecs.dispose(); 
} 
Requirements

Target Platforms

Help Version 23.0.2024.5.22
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.