←Select platform

Deskew Method

Summary

Rotates the specified image to straighten it. This operation is typically used to automatically straighten scanned images. This operation is available in the Document\Medical Toolkits.

Syntax

C++

[FaultContractAttribute(System.Type)] 
[OperationContractAttribute(Action="Deskew", 
   AsyncPattern=false, 
   IsOneWay=false, 
   IsInitiating=true, 
   IsTerminating=false)] 
public DeskewResponse Deskew( 
   DeskewRequest request 
)

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

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

Parameters

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

Return Value

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

Remarks

If the Leadtools.Services.ImageProcessing.DataContracts.DeskewRequest.Flags property contains Leadtools.Services.ImageProcessing.DataContracts.DeskewCommandFlagsDeskewCommandFlags.ReturnAngleOnly, the operation will update the Leadtools.Services.ImageProcessing.DataContracts.DeskewResponse.Angle property without rotating the image.
The calculated rotation is limited to 20 degrees in either direction. This operation is intended for images, such as scanned documents, that are mainly horizontal lines of text. The results are less predictable with other types of images.
This operation includes an option to skip deskewing if the angle is very small.
This operation does not support 12 and 16-bit grayscale and 48 and 64-bit color images. If the image is 12 and 16-bit grayscale and 48 and 64-bit color, the operation will not throw an exception.
This operation does not support signed data images.
This operation does not support 32-bit grayscale images.

Example

using Leadtools.Services; 
 
public void DeskewExample() 
{ 
   DocumentProcessingServiceClient client = new DocumentProcessingServiceClient(); 
 
   RawBinaryData sourceBinaryData = new RawBinaryData(); 
   sourceBinaryData.Data = File.ReadAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "clean.tif")); 
 
   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; 
 
   DeskewRequest request = new DeskewRequest(); 
 
   request.ConvertOptions = convertOptions; 
   request.RegionData = null; 
   request.FillColor = "Red"; 
   request.Flags = DeskewCommandFlags.DeskewImage | DeskewCommandFlags.DoNotFillExposedArea; 
 
   CommandResponse response = client.Deskew(request); 
   if (response.Destination != null) 
   { 
      if (response.Destination is RawBinaryData) 
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "Deskew.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 
 
Public Sub DeskewExample() 
   Dim client As DocumentProcessingServiceClient = New DocumentProcessingServiceClient() 
 
   Dim sourceBinaryData As RawBinaryData = New RawBinaryData() 
   sourceBinaryData.Data = File.ReadAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "clean.tif")) 
 
   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 DeskewRequest = New DeskewRequest() 
 
   request.ConvertOptions = convertOptions 
   request.RegionData = Nothing 
   request.FillColor = "Red" 
   request.Flags = DeskewCommandFlags.DeskewImage Or DeskewCommandFlags.DoNotFillExposedArea 
 
   Dim response As CommandResponse = client.Deskew(request) 
   If Not response.Destination Is Nothing Then 
      If TypeOf response.Destination Is RawBinaryData Then 
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "Deskew.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

IDocumentProcessingService Interface

IDocumentProcessingService Members

Help Version 19.0.2017.10.27

Leadtools.Services.ImageProcessing.ServiceContracts Assembly

Introduction

Getting Started

Namespaces

Leadtools.Services.ImageProcessing.ServiceContracts Namespace

Assemblies