←Select platform

HalfToneCommand Constructor(HalfToneCommandType,int,int,RasterImage)

Summary

Initializes a new HalfToneCommand class object with explicit parameters.

Syntax
C#
VB
Objective-C
C++
Java
Public Function New( _ 
   ByVal type As HalfToneCommandType, _ 
   ByVal angle As Integer, _ 
   ByVal dimension As Integer, _ 
   ByVal userDefinedImage As RasterImage _ 
) 
- (instancetype)initWithType:(LTHalfToneCommandType)type 
                       angle:(NSInteger)angle 
                   dimension:(NSUInteger)dimension 
            userDefinedImage:(nullable LTRasterImage *)userDefinedImage 
public HalfToneCommand( 
   HalfToneCommandType type,  
   int angle,  
   int dimension,  
   RasterImage userDefinedImage 
) 
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.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void HalfToneConstructorExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "sample5.cmp")); 
 
   // 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].Clone(); 
   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"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub HalfToneConstructorExample() 
   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 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 

Requirements

Target Platforms

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Core Assembly