Leadtools.ImageProcessing.Core Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
HalfToneCommand Class
See Also  Members   Example 
Leadtools.ImageProcessing.Core Namespace : HalfToneCommand Class



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) 
Public Class HalfToneCommand 
   Inherits RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As HalfToneCommand
C# 
public class HalfToneCommand : RasterCommand, IRasterCommand 
C++/CLI 
public ref class HalfToneCommand : public RasterCommand, IRasterCommand 

Example

Run the HalfToneCommand on an image.

Visual BasicCopy Code
Public Sub HalfToneCommandExample()
   RasterCodecs.Startup()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg")

   ' 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

   RasterCodecs.Shutdown()
End Sub
C#Copy Code
public void HalfToneCommandExample() 
{ 
   // Load an image 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg"); 
 
   // Prepare the command 
   HalfToneCommand command = new HalfToneCommand(); 
   command.Angle = 0; 
   command.Dimension = 2; 
   command.Type = HalfToneCommandType.View; 
   //Halftone the image. 
   command.Run(image); 
 
   RasterCodecs.Shutdown(); 
}

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.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Core.HalfToneCommand

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also