ColorizeGrayCommand Class

Colors an 8, 12 or 16-bit grayscale image. The class changes the color bits/pixel of the image from the specified formats into 24-bit RGB format. This class is available in the Raster Pro and above toolkits.

Object Model

Syntax

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

public class ColorizeGrayCommand : Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

'Declaration
 
Public Class ColorizeGrayCommand 
   Inherits Leadtools.ImageProcessing.RasterCommand
   Implements Leadtools.ImageProcessing.IRasterCommand

'Usage
 
Dim instance As ColorizeGrayCommand

public sealed class ColorizeGrayCommand : Leadtools.ImageProcessing.IRasterCommand

@interface LTColorizeGrayCommand : LTRasterCommand

public class ColorizeGrayCommand extends RasterCommand

function Leadtools.ImageProcessing.Core.ColorizeGrayCommand()

public ref class ColorizeGrayCommand : public Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

Remarks

The class can be used as a visualization aid. More precisely, this class can be used to show variations in an image's intensity values.
This class colors the grayscale image (colorizes) by converting specified ranges of grayscale intensities into corresponding RGB values. Use the GrayColors property to set the intensity ranges and the RGB values.
Using this class you can show details that were never seen in the original image. In 12 and 16-bit grayscale images, only the 8 most significant bits are displayed, whereas the rest are discarded. So by coloring these discarded bits you can make them visible instead.
The class will allocate and store a 24-bit image in DestinationImage.
If you set the GrayColors property to null then the class colors the image automatically using an algorithm that generates unique output colors. The output image will contain 256 colors if the input image is 8-bit, 4096 colors if the input image is 12-bit and 65535 colors if the input image is 16-bit.
The sample below shows you how to color a 16-bit grayscale image using the GrayColors property.
In a 16-bit grayscale image, the lowest pixel value is 0 and the highest pixel value is 65535.
The colors from the input images will be colored as follows:

Pixel intensities from 0 - 9999 will be Red.
Pixel intensities from 10000 - 19999 will be Green.
Pixel intensities from 20000 - 29999 will be Blue.
Pixel intensities from 30000 - 39999 will be Cyan.
Pixel intensities from 40000 - 49999 will be Magenta.
Pixel intensities from 50000 - 65535 will be Yellow. (Note: the Threshold value is ignored for the last entry in the GrayColors array.)
For more information on filling the GrayColors array to obtain this result, refer to the example.
This class supports 8, 12 and 16-bit grayscale images only. Support for 12 and 16-bit grayscale images are available only in the Document/Medical toolkits. It also can process the whole image or a region of the image. If an image has a region, the effect is applied only to the region.
This command does not support 32-bit grayscale images.

For more information, refer to Grayscale Images.

In Silverlight and Windows Phone versions of LEADTOOLS, this image processing command will fail if the image data for the RasterImage object is stored internally using a Silverlight WriteableBitmap object. For more information, refer to Image Processing Command Limitations in Silverlight.

Example

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

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing.Core

Public Sub ColorizeGrayCommandExample()
   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

using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

public void ColorizeGrayCommandExample()
{
   // 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 ColorizeGrayCommandExample() {
   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);
   });
}

using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

      
public async Task ColorizeGrayCommandExample()
{
   // 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);
}

using Leadtools;
using Leadtools.Examples;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

public void ColorizeGrayCommandExample(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();
}

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing.Core

Public Sub ColorizeGrayCommandExample(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

Requirements

Target Platforms

Reference

ColorizeGrayCommand Members
Leadtools.ImageProcessing.Core Namespace
Grayscale Images
WindowLevelCommand Class
WindowLevelCommand Class
Leadtools.ImageProcessing.Color.GrayScaleToDuotoneCommand
Leadtools.ImageProcessing.Color.GrayScaleToMultitoneCommand
ShiftDataCommand Class
SelectDataCommand Class
Leadtools.ImageProcessing.Color.AdjustTintCommand
Leadtools.ImageProcessing.Effects.ColorHalftoneCommand