←Select platform

Rotate Method

Summary

Rotates an image by the number of degrees specified.

Syntax

C++

[OperationContractAttribute(Action="Rotate", 
   AsyncPattern=false, 
   IsOneWay=false, 
   IsInitiating=true, 
   IsTerminating=false)] 
[FaultContractAttribute(System.Type)] 
public CommandResponse Rotate( 
   RotateRequest request 
)

  
<OperationContractAttribute("Rotate")> 
<FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault,  
   Action="",  
   Name="",  
   Namespace="",  
   ProtectionLevel=ProtectionLevel.None,  
   HasProtectionLevel=False)> 
Function Rotate( _ 
   ByVal request As Leadtools.Services.Imageprocessing.Datacontracts.RotateRequest _ 
) As Leadtools.Services.Imageprocessing.Datacontracts.CommandResponse

[OperationContractAttribute("Rotate")] 
[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault,  
   Action="",  
   Name="",  
   Namespace="",  
   ProtectionLevel=ProtectionLevel.None,  
   HasProtectionLevel=false)] 
Leadtools.Services.Imageprocessing.Datacontracts.CommandResponse^ Rotate(  
   Leadtools.Services.Imageprocessing.Datacontracts.RotateRequest^ request 
)

Parameters

request
A System.Runtime.Serialization.DataContractAttribute containing the data that will be used in this Rotate operation.

Return Value

A System.Runtime.Serialization.DataContractAttribute containing the modified image resulting from the Rotate operation.

Remarks

This operation 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 of a 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 Leadtools.Services.ImageProcessing.DataContracts.RotateRequest.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 RotateRequest.Angle is not a multiple of 9000).

Example

using Leadtools.Services; 
 
public void RotateExample() 
{ 
   ImageProcessingServiceClient client = new ImageProcessingServiceClient(); 
 
   RawBinaryData sourceBinaryData = new RawBinaryData(); 
   sourceBinaryData.Data = File.ReadAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "image1.cmp")); 
 
   RasterConvertOptions convertOptions = new RasterConvertOptions(); 
 
   convertOptions.Source = sourceBinaryData; 
   convertOptions.Destination = null; 
   convertOptions.Format = RasterImageFormat.Bmp; 
   convertOptions.FirstPage = 1; 
   convertOptions.LastPage = 1; 
   convertOptions.BitsPerPixel = 24; 
   convertOptions.QualityFactor = 2; 
 
   RotateRequest request = new RotateRequest(); 
 
   request.ConvertOptions = convertOptions; 
   request.FillColor = "White"; 
   request.Flags = RotateCommandFlags.Resize; 
   request.Angle = 45 * 100; 
   request.RegionData = null; 
 
   CommandResponse response = client.Rotate(request); 
   if (response.Destination != null) 
   { 
      if (response.Destination is RawBinaryData) 
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "Rotate.bmp"), (response.Destination as RawBinaryData).Data); 
   } 
 
   client.Close(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools.Services 
Imports Leadtools.Services.datacontracts._2009._01 
Imports Leadtools.Services.raster.datacontracts._2009._01 
Imports Leadtools.Services.ImageProcessing.datacontracts._2009._01 
 
Public Sub RotateExample() 
   Dim client As ImageProcessingServiceClient = New ImageProcessingServiceClient() 
 
   Dim sourceBinaryData As RawBinaryData = New RawBinaryData() 
   sourceBinaryData.Data = File.ReadAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "image1.cmp")) 
 
   Dim convertOptions As RasterConvertOptions = New RasterConvertOptions() 
 
   convertOptions.Source = sourceBinaryData 
   convertOptions.Destination = Nothing 
   convertOptions.Format = RasterImageFormat.Bmp 
   convertOptions.FirstPage = 1 
   convertOptions.LastPage = 1 
   convertOptions.BitsPerPixel = 24 
   convertOptions.QualityFactor = 2 
 
   Dim request As RotateRequest = New RotateRequest() 
 
   request.ConvertOptions = convertOptions 
   request.FillColor = "White" 
   request.Flags = RotateCommandFlags.Resize 
   request.Angle = 45 * 100 
   request.RegionData = Nothing 
 
   Dim response As CommandResponse = client.Rotate(request) 
   If Not response.Destination Is Nothing Then 
      If TypeOf response.Destination Is RawBinaryData Then 
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "Rotate.bmp"), (TryCast(response.Destination, RawBinaryData)).Data) 
      End If 
   End If 
 
   client.Close() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

Requirements

Target Platforms

Reference

IImageProcessingService Interface

IImageProcessingService Members

Help Version 19.0.2017.10.27

Leadtools.Services.ImageProcessing.ServiceContracts Assembly

Introduction

Getting Started

Namespaces

Leadtools.Services.ImageProcessing.ServiceContracts Namespace

Assemblies