request: A 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="", HasProtectionLevel=False)> Overridable Function Halftone( _ ByVal request As HalftoneRequest _ ) As CommandResponse

Visual Basic (Declaration)

<OperationContractAttribute("Halftone")>
<FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=False)>
Overridable 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="", HasProtectionLevel=false)] virtual CommandResponse Halftone( HalftoneRequest request )

[OperationContractAttribute("Halftone")]
[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=false)]
virtual CommandResponse Halftone( 
   HalftoneRequest request
)

C++/CLI
[OperationContractAttribute("Halftone")] [FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, Action="", Name="", Namespace="", HasProtectionLevel=false)] virtual CommandResponse Halftone( HalftoneRequest request )

C++/CLI

[OperationContractAttribute("Halftone")]
[FaultContractAttribute(DetailType=Leadtools.Services.Raster.FaultContracts.RasterFault, 
   Action="", 
   Name="", 
   Namespace="", 
   HasProtectionLevel=false)]
virtual CommandResponse Halftone( 
   HalftoneRequest request
)

Parameters

request: A DataContractAttribute containing the data that will be used in this Halftone operation.

Return Value

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

Example

Visual Basic Copy Code

Visual Basic	Copy Code
Public Sub HalftoneExample() Dim client As ColorProcessingServiceClient = New ColorProcessingServiceClient() 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 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(LeadtoolsExamples.Common.ImagesPath.Path & "Halftone.bmp", (TryCast(response.Destination, RawBinaryData)).Data) End If End If client.Close() End Sub

Public Sub HalftoneExample()

  Dim client As ColorProcessingServiceClient = New ColorProcessingServiceClient()

  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 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(LeadtoolsExamples.Common.ImagesPath.Path & "Halftone.bmp", (TryCast(response.Destination, RawBinaryData)).Data)

    End If

  End If



  client.Close()

End Sub

C# Copy Code

C#	Copy Code
public void HalftoneExample() { ColorProcessingServiceClient client = new ColorProcessingServiceClient(); 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; 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(LeadtoolsExamples.Common.ImagesPath.Path + "Halftone.bmp", (response.Destination as RawBinaryData).Data); } client.Close(); }

public void HalftoneExample() 
{ 
   ColorProcessingServiceClient client = new ColorProcessingServiceClient(); 
   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; 
 
   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(LeadtoolsExamples.Common.ImagesPath.Path + "Halftone.bmp", (response.Destination as RawBinaryData).Data); 
   } 
 
   client.Close(); 
}

Remarks

For the 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 XP, Windows Server 2003 family, Windows Server 2008 family

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
Halftone Method
See Also Example