Leadtools.ImageProcessing.Core Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
HalfToneCommand Constructor(HalfToneCommandType,Int32,Int32,RasterImage)
See Also  Example
Leadtools.ImageProcessing.Core Namespace > HalfToneCommand Class > HalfToneCommand Constructor : HalfToneCommand Constructor(HalfToneCommandType,Int32,Int32,RasterImage)



type
Value that indicates the type of halftoning to perform.
angle
The angle of rotation, expressed in hundredths of degrees. A value of 0 produces a horizontal halftone pattern. This parameter specifies the number of degrees to change the pattern. Positive values rotate the pattern clockwise; negative values rotate the pattern counterclockwise. This value is ignored if the selected halftone pattern is HalfToneCommandType.Rectangle, HalfToneCommandType.Circle or HalfToneCommandType.Random or HalfToneCommandType.UserDefined.
dimension
Value that indicates the size of the grain. This value is ignored if the selected halftone pattern is HalfToneCommandType.View or HalfToneCommandType.Print. If the pattern is not HalfToneCommandType.View or HalfToneCommandType.Print, dimension should be >= 1. If this parameter is < 1 this command will return ERROR_INV_PARAMETER.
userDefinedImage
List of images that will be used in half toning if the HalfToneCommandType.UserDefined option is selected.
Initializes a new HalfToneCommand class object with explicit parameters.

Syntax

Visual Basic (Declaration) 
Public Function New( _
   ByVal type As HalfToneCommandType, _
   ByVal angle As Integer, _
   ByVal dimension As Integer, _
   ByVal userDefinedImage As RasterImage _
)
Visual Basic (Usage)Copy Code
Dim type As HalfToneCommandType
Dim angle As Integer
Dim dimension As Integer
Dim userDefinedImage As RasterImage
 
Dim instance As HalfToneCommand(type, angle, dimension, userDefinedImage)
C# 
public HalfToneCommand( 
   HalfToneCommandType type,
   int angle,
   int dimension,
   RasterImage userDefinedImage
)
C++/CLI 
public:
HalfToneCommand( 
   HalfToneCommandType type,
   int angle,
   int dimension,
   RasterImage userDefinedImage
)

Parameters

type
Value that indicates the type of halftoning to perform.
angle
The angle of rotation, expressed in hundredths of degrees. A value of 0 produces a horizontal halftone pattern. This parameter specifies the number of degrees to change the pattern. Positive values rotate the pattern clockwise; negative values rotate the pattern counterclockwise. This value is ignored if the selected halftone pattern is HalfToneCommandType.Rectangle, HalfToneCommandType.Circle or HalfToneCommandType.Random or HalfToneCommandType.UserDefined.
dimension
Value that indicates the size of the grain. This value is ignored if the selected halftone pattern is HalfToneCommandType.View or HalfToneCommandType.Print. If the pattern is not HalfToneCommandType.View or HalfToneCommandType.Print, dimension should be >= 1. If this parameter is < 1 this command will return ERROR_INV_PARAMETER.
userDefinedImage
List of images that will be used in half toning if the HalfToneCommandType.UserDefined option is selected.

Example

Run the HalfToneCommand on an image.

Visual BasicCopy Code
Public Sub HalfToneConstructorExample()
   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 images() As RasterImage
      ReDim images(1)
      images(0) = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Ulay3.bmp", 24, CodecsLoadByteOrder.Bgr, 1, 1)
      images(1) = images(0)
      images(0).AddPage(images(1))
      Dim command As HalfToneCommand = New HalfToneCommand(HalfToneCommandType.UserDefined, 0, 1, images(0))
      '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 HalfToneConstructorExample() 

   // 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 
   RasterImage[] images = new RasterImage[2]; 
   images[0] = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Ulay3.bmp", 24, CodecsLoadByteOrder.Bgr, 1, 1); 
   images[1] = images[0]; 
   images[0].AddPage(images[1]); 
   HalfToneCommand command = new HalfToneCommand(HalfToneCommandType.UserDefined, 0, 1, images[0]); 
   // Halftone the image. 
   command.Run(image); 
 
   RasterCodecs.Shutdown(); 
}

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