AutoBinary Method

Visual Basic
C#
Objective-C
Java
C++

[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   ProtectionLevel=ProtectionLevel.None, 
   HasProtectionLevel=false)]
[OperationContractAttribute("AutoBinary")]
CommandResponse AutoBinary( 
   AutoBinaryRequest request
)

'Declaration
 
<FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   ProtectionLevel=ProtectionLevel.None, 
   HasProtectionLevel=False)>
<OperationContractAttribute("AutoBinary")>
Function AutoBinary( _
   ByVal request As AutoBinaryRequest _
) As CommandResponse

'Usage
 
Dim instance As IColorProcessingService
Dim request As AutoBinaryRequest
Dim value As CommandResponse
 
value = instance.AutoBinary(request)

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

Parameters

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

Return Value

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

The image is transformed into a binary image using a threshold calculated automatically based on statistical features of the image. Best results are obtained with grayscale images.
This operation supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
If the image has a region, the effect will be applied on the region only.
This operation does not support signed data images.
This operation does not support 32-bit grayscale images.

Use the AutoBinary when you simply want to apply binary segmentation to the bitmap using an automatically calculated threshold based on a two-peak method of statistical analysis on its histogram. Use the DynamicBinary to convert an image into a black and white image without changing its bits per pixel.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

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 AutoBinaryExample()
   Dim client As ColorProcessingServiceClient = New ColorProcessingServiceClient()
   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 AutoBinaryRequest = New AutoBinaryRequest()

   request.ConvertOptions = convertOptions
   request.RegionData = Nothing

   Dim response As CommandResponse = client.AutoBinary(request)
   If Not response.Destination Is Nothing Then
      If TypeOf response.Destination Is RawBinaryData Then
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "AutoBinary.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

using Leadtools.Services;
using leadtools.services.datacontracts._2009._01;
using leadtools.services.raster.datacontracts._2009._01;
using leadtools.services.imageprocessing.datacontracts._2009._01;

public void AutoBinaryExample()
{
   ColorProcessingServiceClient client = new ColorProcessingServiceClient();
   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;

   AutoBinaryRequest request = new AutoBinaryRequest();

   request.ConvertOptions = convertOptions;
   request.RegionData = null;

   CommandResponse response = client.AutoBinary(request);
   if (response.Destination != null)
   {
      if (response.Destination is RawBinaryData)
         File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir,"AutoBinary.bmp"), (response.Destination as RawBinaryData).Data);
   }

   client.Close();
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Target Platforms

Reference

IColorProcessingService Interface
IColorProcessingService Members