ColorizeGrayCommandData Class

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

public class ColorizeGrayCommandData

'Declaration
 
Public Class ColorizeGrayCommandData

'Usage
 
Dim instance As ColorizeGrayCommandData

public sealed class ColorizeGrayCommandData

function Leadtools.ImageProcessing.Core.ColorizeGrayCommandData()

public ref class ColorizeGrayCommandData

The ColorizeGrayCommand class uses an array of ColorizeGrayCommand class objects with its length being a user-defined number. If the array has N entries, then:

Intensity Range	Color
0 ~ Threshold[0]	Color[0]
Threshold[0] ~ Threshold[1]	Color[1]
Threshold[1] ~ Threshold[2]	Color[2]
...	...
Threshold[N - 3] ~ Threshold[N - 2]	Color[N - 2]
Threshold[N - 2] ~ Threshold[N - 1]	Color[N - 1]

Notice that the Threshold[N-1] value will be ignored and instead will be treated as a value equal to 255, 4095 and 65535 for 8, 12 and 16-bit images respectively.

Although it is not a requirement, it is recommended that Threshold[0] is less than Threshold[1], which is less than Threshold[2], ..., which is less than Threshold[N-1]. Consider the following example with a ColorizeGrayCommandData class of 4 entries for a 12-Bit gray image, where this recommendation is not followed:

Threshold[0] = 1000	Color[0] is Red
Threshold[1] = 3000	Color[1] is Green
Threshold[2] = 2000 // Notice the threshold here.	Color[2] is Blue
Threshold[3] = 4000	Color[3] is Yellow

In this case, pixel intensities from 0 to 1000 will be Red, pixels 1001 to 3000 will be Green, pixels 3001 to 4000 will be Yellow, and pixels from 4001 to the last possible intensity will be Yellow too.

For more information, refer to Correcting Colors.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public Sub ColorizeGrayCommandDataExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

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

   ' Prepare the command
   Dim i As Integer
   Dim pGrayColors() As ColorizeGrayCommandData
   ReDim pGrayColors(5)

   For i = 0 To 5
      pGrayColors(i) = New ColorizeGrayCommandData
   Next

   pGrayColors(0).Threshold = 9999
   pGrayColors(1).Threshold = 19999
   pGrayColors(2).Threshold = 29999
   pGrayColors(3).Threshold = 39999
   pGrayColors(4).Threshold = 49999
   pGrayColors(5).Threshold = 59999

   pGrayColors(0).Color = New RasterColor(255, 0, 0)
   pGrayColors(1).Color = New RasterColor(0, 255, 0)
   pGrayColors(2).Color = New RasterColor(0, 0, 255)
   pGrayColors(3).Color = New RasterColor(0, 255, 255)
   pGrayColors(4).Color = New RasterColor(255, 0, 255)
   pGrayColors(5).Color = New RasterColor(255, 255, 0)

   Dim command As ColorizeGrayCommand = New ColorizeGrayCommand
   command.GrayColors = pGrayColors
   'Call the command
   command.Run(leadImage)

   ' Save the resulted Image
   codecs.Save(command.DestinationImage, Path.Combine(LEAD_VARS.ImagesDir, "ColorizeGrayResult.Bmp"), RasterImageFormat.Bmp, 24)

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public void ColorizeGrayCommandDataExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

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

      // Prepare the command
      ColorizeGrayCommandData[] pGrayColors = new ColorizeGrayCommandData[6];
      for (int i = 0; i < 6; i++)
         pGrayColors[i] = new ColorizeGrayCommandData();
      pGrayColors[0].Threshold   = 9999;
      pGrayColors[1].Threshold   = 19999;
      pGrayColors[2].Threshold   = 29999;
      pGrayColors[3].Threshold   = 39999;
      pGrayColors[4].Threshold   = 49999;
      pGrayColors[5].Threshold   = 59999;

      pGrayColors[0].Color       = new RasterColor(255, 0, 0);
      pGrayColors[1].Color       = new RasterColor(0, 255, 0);
      pGrayColors[2].Color       = new RasterColor(0, 0, 255);
      pGrayColors[3].Color       = new RasterColor(0, 255, 255);
      pGrayColors[4].Color       = new RasterColor(255, 0, 255);
      pGrayColors[5].Color       = new RasterColor(255, 255, 0);

      ColorizeGrayCommand command = new ColorizeGrayCommand();
      command.GrayColors = pGrayColors;
      //Call the command
      command.Run(image);

      // Save the resulted image
      codecs.Save(command.DestinationImage, Path.Combine(LEAD_VARS.ImagesDir, "ColorizeGrayResult.Bmp"), RasterImageFormat.Bmp, 24);

   }

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

function ColorizeGrayCommandDataExample() {
   var codecs = new Leadtools.Codecs.RasterCodecs();
   codecs.throwExceptionsOnInvalidImages = true;

   // Load the image
   var srcFileName = "Assets\\Beauty16.jpg";
   var destFileName = "ColorizeGrayResult.bmp";
   var saveImage;

   return Tools.AppInstallFolder().getFileAsync(srcFileName).then(function (loadFile) {
      return codecs.loadAsync(Leadtools.LeadStreamFactory.create(loadFile));
   }).then(function (image) {
      // Prepare the command
      with (Leadtools.ImageProcessing.Core) {
         var pGrayColors = new Array();
         for (var i = 0; i < 6; i++)
            pGrayColors[i] = new ColorizeGrayCommandData();

         pGrayColors[0].threshold = 9999;
         pGrayColors[1].threshold = 19999;
         pGrayColors[2].threshold = 29999;
         pGrayColors[3].threshold = 39999;
         pGrayColors[4].threshold = 49999;
         pGrayColors[5].threshold = 59999;

         pGrayColors[0].color = Leadtools.RasterColorHelper.create(255, 0, 0);
         pGrayColors[1].color = Leadtools.RasterColorHelper.create(0, 255, 0);
         pGrayColors[2].color = Leadtools.RasterColorHelper.create(0, 0, 255);
         pGrayColors[3].color = Leadtools.RasterColorHelper.create(0, 255, 255);
         pGrayColors[4].color = Leadtools.RasterColorHelper.create(255, 0, 255);
         pGrayColors[5].color = Leadtools.RasterColorHelper.create(255, 255, 0);

         var command = new ColorizeGrayCommand();
         command.grayColors = pGrayColors;
         //Call the command
         command.run(image);
         saveImage = command.destinationImage;

         return Tools.AppLocalFolder().createFileAsync(destFileName);
      }
   })
   .then(function (saveFile) {
      // Save the resulted image
      return codecs.saveAsync(saveImage, Leadtools.LeadStreamFactory.create(saveFile), Leadtools.RasterImageFormat.bmp, 24);
   });

[TestMethod]
public async Task ColorizeGrayCommandDataExample()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   // Load the image
   string srcFileName = @"Assets\Beauty16.jpg";
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   RasterImage image = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile));

   // Prepare the command
   ColorizeGrayCommandData[] pGrayColors = new ColorizeGrayCommandData[6];
   for (int i = 0; i < 6; i++)
      pGrayColors[i] = new ColorizeGrayCommandData();
   pGrayColors[0].Threshold   = 9999;
   pGrayColors[1].Threshold   = 19999;
   pGrayColors[2].Threshold   = 29999;
   pGrayColors[3].Threshold   = 39999;
   pGrayColors[4].Threshold   = 49999;
   pGrayColors[5].Threshold   = 59999;

   pGrayColors[0].Color       = RasterColorHelper.Create(255, 0, 0);
   pGrayColors[1].Color       = RasterColorHelper.Create(0, 255, 0);
   pGrayColors[2].Color       = RasterColorHelper.Create(0, 0, 255);
   pGrayColors[3].Color       = RasterColorHelper.Create(0, 255, 255);
   pGrayColors[4].Color       = RasterColorHelper.Create(255, 0, 255);
   pGrayColors[5].Color       = RasterColorHelper.Create(255, 255, 0);

   ColorizeGrayCommand command = new ColorizeGrayCommand();
   command.GrayColors = pGrayColors;
   //Call the command
   command.Run(image);

   // Save the resulted image
   string destFileName = @"ColorizeGrayResult.bmp";
   StorageFile saveFile = await Tools.AppLocalFolder.CreateFileAsync(destFileName);
   await codecs.SaveAsync(command.DestinationImage, LeadStreamFactory.Create(saveFile), RasterImageFormat.Bmp, 24);
}

public void ColorizeGrayCommandDataExample(RasterImage image, Stream outStream)
{
   // Prepare the command
   ColorizeGrayCommandData[] pGrayColors = new ColorizeGrayCommandData[6];
   for (int i = 0; i < 6; i++)
      pGrayColors[i] = new ColorizeGrayCommandData();
   pGrayColors[0].Threshold   = 9999;
   pGrayColors[1].Threshold   = 19999;
   pGrayColors[2].Threshold   = 29999;
   pGrayColors[3].Threshold   = 39999;
   pGrayColors[4].Threshold   = 49999;
   pGrayColors[5].Threshold   = 59999;
   pGrayColors[0].Color       = new RasterColor(255, 0, 0);
   pGrayColors[1].Color       = new RasterColor(0, 255, 0);
   pGrayColors[2].Color       = new RasterColor(0, 0, 255);
   pGrayColors[3].Color       = new RasterColor(0, 255, 255);
   pGrayColors[4].Color       = new RasterColor(255, 0, 255);
   pGrayColors[5].Color       = new RasterColor(255, 255, 0);

   ColorizeGrayCommand command = new ColorizeGrayCommand();
   command.GrayColors = pGrayColors;
   //Call the command
   command.Run(image);

   // Save result image
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24);
   image.Dispose();
}

Public Sub ColorizeGrayCommandDataExample(ByVal image As RasterImage, ByVal outStream As Stream)
   ' Prepare the command
   Dim pGrayColors As ColorizeGrayCommandData() = New ColorizeGrayCommandData(5){}
   For i As Integer = 0 To 5
      pGrayColors(i) = New ColorizeGrayCommandData()
   Next i
   pGrayColors(0).Threshold = 9999
   pGrayColors(1).Threshold = 19999
   pGrayColors(2).Threshold = 29999
   pGrayColors(3).Threshold = 39999
   pGrayColors(4).Threshold = 49999
   pGrayColors(5).Threshold = 59999
   pGrayColors(0).Color = New RasterColor(255, 0, 0)
   pGrayColors(1).Color = New RasterColor(0, 255, 0)
   pGrayColors(2).Color = New RasterColor(0, 0, 255)
   pGrayColors(3).Color = New RasterColor(0, 255, 255)
   pGrayColors(4).Color = New RasterColor(255, 0, 255)
   pGrayColors(5).Color = New RasterColor(255, 255, 0)

   Dim command As ColorizeGrayCommand = New ColorizeGrayCommand()
   command.GrayColors = pGrayColors
   'Call the command
   command.Run(image)

   ' Save result image
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24)
   image.Dispose()
End Sub

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

ColorizeGrayCommandData Members
Leadtools.ImageProcessing.Core Namespace
Correcting Colors