LEADTOOLS WCF Image Processing (Leadtools.Services.ImageProcessing.ServiceContracts assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.30
Halftone Method
See Also 
Leadtools.Services.ImageProcessing.ServiceContracts Namespace > IColorProcessingService Interface : Halftone Method



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

The Halftone Method is available in LEADTOOLS Document and Medical Imaging toolkits.

request
A System.Runtime.Serialization.DataContractAttribute containing the data that will be used in this Halftone operation.
Converts a 1-, 4-, 8-, 16-, 24-, or 32-bit image to a halftoned image, with a specified pattern rotation. A halftoned image is a 1-bit image that has been dithered for black and white printing or display.

Syntax

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

Parameters

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

Return Value

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

Example

Visual BasicCopy Code
Public Sub HalftoneExample()
      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 HalftoneRequest = New HalftoneRequest()

      request.ConvertOptions = convertOptions
      request.RegionData = Nothing
      request.Angle = 0
      request.Dimension = 2
      request.Type = HalftoneCommandType.View

      Dim response As CommandResponse = client.Halftone(request)
      If Not response.Destination Is Nothing Then
         If TypeOf response.Destination Is RawBinaryData Then
            File.WriteAllBytes(Path.Combine(LEAD_VARS.ImagesDir, "Halftone.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
C#Copy Code
public void HalftoneExample()
   {
      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;

      HalftoneRequest request = new HalftoneRequest();

      request.ConvertOptions = convertOptions;
      request.RegionData = null;
      request.Angle = 0;
      request.Dimension = 2;
      request.Type = HalftoneCommandType.View;

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

      client.Close();
   }

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

Remarks

  • For the Leadtools.Services.ImageProcessing.DataContracts.HalftoneCommandType.UserDefined option, the number of images in the list must be at least equal to (Dimension * Dimension + 1). Images with higher indexes correspond to higher intensity values.
  • This command can process the whole image or a region of the image.
  • This command does not support 12 and 16-bit grayscale and 48 and 64-bit color images.
  • This command does not support signed data images.
  • This command supports 32-bit grayscale images.

Requirements

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

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