LEADTOOLS Image Processing (Leadtools.ImageProcessing.SpecialEffects assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ColoredPencilExtendedCommand Constructor(Int32,Int32,Int32,Int32,Int32,Int32,Int32,ColoredPencilExtendedCommandFlags)
See Also  Example
Leadtools.ImageProcessing.SpecialEffects Namespace > ColoredPencilExtendedCommand Class > ColoredPencilExtendedCommand Constructor : ColoredPencilExtendedCommand Constructor(Int32,Int32,Int32,Int32,Int32,Int32,Int32,ColoredPencilExtendedCommandFlags)



size
Size of the neighborhood used to determine the width of the outlines.
strength
Strength factor used to create the "outline". This can be any number that is 0 or greater.
threshold
Threshold value used to determine which pixels are edge pixels (outlines). If the difference determined for a pixel is greater than this value, the pixel is an edge pixel. Valid values range from 0 through 65535 for 64-bit, 48-bit and 16-bit grayscale images and from 0 through 4095 for 12-bit grayscale images. Otherwise, it is from 0 to 255. Use this parameter to control the number of edge pixels found.
pencilRoughness
Percentage of coloring coverage (colored pencil roughness), expressed in tenths of a percent. Valid values are 0 to 1000.
strokeLength
Length of the colored pencil stroke, in pixels.
paperRoughness
Percentage of paper surface roughness, expressed in tenths of a percent. Valid values are 0 to 1000.
angle
Value that represents the direction of the coloring motion, in hundredths of a degree (+/-) This value can be a number from -18000 to 18000. This parameter is ignored when flags = ColoredPencilExtendedCommandFlags.Artistic.
flags
Flags that determine which the type of direction to use and whether to combine the resulted image with the original one or not. For valid values, refer to ColoredPencilExtendedCommandFlags.
Initializes a new Leadtools.ImageProcessing.SpecialEffects.ColoredPencilExtendedCommand class object with explicit parameters.

Syntax

Visual Basic (Declaration) 
Public Function New( _
   ByVal size As Integer, _
   ByVal strength As Integer, _
   ByVal threshold As Integer, _
   ByVal pencilRoughness As Integer, _
   ByVal strokeLength As Integer, _
   ByVal paperRoughness As Integer, _
   ByVal angle As Integer, _
   ByVal flags As ColoredPencilExtendedCommandFlags _
)
Visual Basic (Usage)Copy Code
Dim size As Integer
Dim strength As Integer
Dim threshold As Integer
Dim pencilRoughness As Integer
Dim strokeLength As Integer
Dim paperRoughness As Integer
Dim angle As Integer
Dim flags As ColoredPencilExtendedCommandFlags
 
Dim instance As New ColoredPencilExtendedCommand(size, strength, threshold, pencilRoughness, strokeLength, paperRoughness, angle, flags)
C# 
public ColoredPencilExtendedCommand( 
   int size,
   int strength,
   int threshold,
   int pencilRoughness,
   int strokeLength,
   int paperRoughness,
   int angle,
   ColoredPencilExtendedCommandFlags flags
)
C++/CLI 
public:
ColoredPencilExtendedCommand( 
   int size,
   int strength,
   int threshold,
   int pencilRoughness,
   int strokeLength,
   int paperRoughness,
   int angle,
   ColoredPencilExtendedCommandFlags flags
)

Parameters

size
Size of the neighborhood used to determine the width of the outlines.
strength
Strength factor used to create the "outline". This can be any number that is 0 or greater.
threshold
Threshold value used to determine which pixels are edge pixels (outlines). If the difference determined for a pixel is greater than this value, the pixel is an edge pixel. Valid values range from 0 through 65535 for 64-bit, 48-bit and 16-bit grayscale images and from 0 through 4095 for 12-bit grayscale images. Otherwise, it is from 0 to 255. Use this parameter to control the number of edge pixels found.
pencilRoughness
Percentage of coloring coverage (colored pencil roughness), expressed in tenths of a percent. Valid values are 0 to 1000.
strokeLength
Length of the colored pencil stroke, in pixels.
paperRoughness
Percentage of paper surface roughness, expressed in tenths of a percent. Valid values are 0 to 1000.
angle
Value that represents the direction of the coloring motion, in hundredths of a degree (+/-) This value can be a number from -18000 to 18000. This parameter is ignored when flags = ColoredPencilExtendedCommandFlags.Artistic.
flags
Flags that determine which the type of direction to use and whether to combine the resulted image with the original one or not. For valid values, refer to ColoredPencilExtendedCommandFlags.

Example

Visual BasicCopy Code
' Run the ColoredPencilExtendedCommand on an image and applies the Colored Pencil Extended filter.
Public Sub ColoredPencilExtendedConstructorExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

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

   ' Prepare the command
   Dim command As ColoredPencilExtendedCommand = New ColoredPencilExtendedCommand(5, 4, 0, 250, 15, 100, 0, ColoredPencilExtendedCommandFlags.Artistic)
   command.Run(leadImage)

   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "ImageProcessingDemo\Result - ColoredPencilExtendedConstructorVB.jpg"), RasterImageFormat.Jpeg, 24)
End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
// Run the ColoredPencilExtendedCommand on an image and applies the Colored Pencil Extended filter.
   public void ColoredPencilExtendedConstructorExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\NaturalFruits.jpg"));

      // Prepare the command
      ColoredPencilExtendedCommand command = new ColoredPencilExtendedCommand(5, 4, 0, 250, 15, 100, 0, ColoredPencilExtendedCommandFlags.Artistic);
      command.Run(image);
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\Result - ColoredPencilExtendedConstructorCS.jpg"), RasterImageFormat.Jpeg, 24);

   }

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

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also