ColoredPencilExtendedCommand Constructor(Int32,Int32,Int32,Int32,Int32,Int32,Int32,ColoredPencilExtendedCommandFlags)

Initializes a new ColoredPencilExtendedCommand class object with explicit parameters.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public ColoredPencilExtendedCommand( 
   int size,
   int strength,
   int threshold,
   int pencilRoughness,
   int strokeLength,
   int paperRoughness,
   int angle,
   ColoredPencilExtendedCommandFlags flags
)

'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 _
)

'Usage
 
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)

public ColoredPencilExtendedCommand( 
   int size,
   int strength,
   int threshold,
   int pencilRoughness,
   int strokeLength,
   int paperRoughness,
   int angle,
   ColoredPencilExtendedCommandFlags flags
)

function ColoredPencilExtendedCommand( 
   size ,
   strength ,
   threshold ,
   pencilRoughness ,
   strokeLength ,
   paperRoughness ,
   angle ,
   flags 
)

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 Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

' 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

// 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";
}

// Run the ColoredPencilExtendedCommand on an image and applies the Colored Pencil Extended filter.
[TestMethod]
public async Task ColoredPencilExtendedConstructorExample()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   string srcFileName = @"Assets\Image1.cmp";
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   RasterImage image = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile));

   // Prepare the command
   ColoredPencilExtendedCommand command = new ColoredPencilExtendedCommand(5, 4, 0, 250, 15, 100, 0, ColoredPencilExtendedCommandFlags.Artistic);
   command.Run(image);

   string destFileName = @"result.bmp";
   StorageFile saveFile = await Tools.AppLocalFolder.CreateFileAsync(destFileName);
   await codecs.SaveAsync(image, LeadStreamFactory.Create(saveFile), RasterImageFormat.Bmp, 24);
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ColoredPencilExtendedCommand Class
ColoredPencilExtendedCommand Members
Overload List