LEADTOOLS Image Processing (Leadtools.ImageProcessing.Core assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
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. Supported in Silverlight, Windows Phone 7

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 New 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()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   ' Prepare the command
   Try
      Dim images() As RasterImage
      ReDim images(1)
      images(0) = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "ImageProcessingDemo\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

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 HalfToneConstructorExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"));

      // Prepare the command
      RasterImage[] images = new RasterImage[2];
      images[0] = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\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);

   }

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

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also