HalfToneCommand Class

Summary

Converts a 1-bit, 4-bit, 8-bit, 16-bit, 24-bit, 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

Objective-C

C++

Java

public class HalfToneCommand : RasterCommand

Public Class HalfToneCommand  
   Inherits RasterCommand

@interface LTHalftoneCommand : LTRasterCommand

public class HalfToneCommand extends RasterCommand

public ref class HalfToneCommand : public RasterCommand

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.

For more information, refer to Introduction to Image Processing With LEADTOOLS.

Example

Run the HalfToneCommand on an image.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void HalfToneCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "sample5.cmp")); 
 
   // Prepare the command 
   HalfToneCommand command = new HalfToneCommand(); 
   command.Angle = 0; 
   command.Dimension = 2; 
   command.Type = HalfToneCommandType.View; 
   //Halftone the image. 
   command.Run(image); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub HalfToneCommandExample() 
   Dim codecs As New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
 
   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "sample5.cmp")) 
 
   ' Prepare the command 
   Try 
      Dim command As HalfToneCommand = New HalfToneCommand 
      command.Angle = 0 
      command.Dimension = 2 
      command.Type = HalfToneCommandType.View 
      'Halftone the image. 
      command.Run(leadImage) 
   Catch ex As Exception 
      MessageBox.Show(ex.Message, "HalfToneTest", MessageBoxButtons.OK, MessageBoxIcon.Exclamation) 
   End Try 
 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class