Leadtools.Services.ImageProcessing.ServiceContracts Requires Document/Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
Rotate Method
See Also  Example
Leadtools.Services.ImageProcessing.ServiceContracts Namespace > IImageProcessingService Interface : Rotate Method



request
A DataContractAttribute containing the data that will be used in this IImageProcessingService.Rotate operation.
request
A DataContractAttribute containing the data that will be used in this IImageProcessingService.Rotate operation.
Rotates an image by the number of degrees specified.

Syntax

Visual Basic (Declaration) 
<FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=False)>
<OperationContractAttribute("Rotate")>
Overridable Function Rotate( _
   ByVal request As RotateRequest _
) As CommandResponse
Visual Basic (Usage)Copy Code
Dim instance As IImageProcessingService
Dim request As RotateRequest
Dim value As CommandResponse
 
value = instance.Rotate(request)
C# 
[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=false)]
[OperationContractAttribute("Rotate")]
virtual CommandResponse Rotate( 
   RotateRequest request
)
C++/CLI 
[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=false)]
[OperationContractAttribute("Rotate")]
virtual CommandResponse Rotate( 
   RotateRequest request
)

Parameters

request
A DataContractAttribute containing the data that will be used in this IImageProcessingService.Rotate operation.

Return Value

A DataContractAttribute containing the modified image resulting from the Rotate operation.

Example

Visual BasicCopy Code
Public Sub RotateExample()
  Dim client As ImageProcessingServiceClient = New ImageProcessingServiceClient()
  Dim sourceBinaryData As RawBinaryData = New RawBinaryData()
  sourceBinaryData.Data = File.ReadAllBytes(LeadtoolsExamples.Common.ImagesPath.Path & "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(LeadtoolsExamples.Common.ImagesPath.Path & "Rotate.bmp", (TryCast(response.Destination, RawBinaryData)).Data)
    End If
  End If

  client.Close()
End Sub
C#Copy Code
public void RotateExample() 
{ 
   ImageProcessingServiceClient client = new ImageProcessingServiceClient(); 
   RawBinaryData sourceBinaryData = new RawBinaryData(); 
   sourceBinaryData.Data = File.ReadAllBytes(LeadtoolsExamples.Common.ImagesPath.Path + "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(LeadtoolsExamples.Common.ImagesPath.Path + "Rotate.bmp", (response.Destination as RawBinaryData).Data); 
   } 
 
   client.Close(); 
}

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 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).

Requirements

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

See Also

Applications developed with LEADTOOLS WCF components require runtime licenses. Server licensing is required for applications on a server. For more information, refer to: Imaging Pro/Document/Medical Features