Leadtools.ImageProcessing.Core Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
ColorizeGrayCommand Class
See Also  Members   Example 
Leadtools.ImageProcessing.Core Namespace : 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

Visual Basic (Declaration) 
Public Class ColorizeGrayCommand 
   Inherits RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As ColorizeGrayCommand
C# 
public class ColorizeGrayCommand : RasterCommand, IRasterCommand 
C++/CLI 
public ref class ColorizeGrayCommand : public RasterCommand, IRasterCommand 

Example

This example loads a 16-bit grayscale image and then colors it.

Visual BasicCopy Code
Public Sub ColorizeGrayCommandExample()
   RasterCodecs.Startup()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "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, LeadtoolsExamples.Common.ImagesPath.Path + "ColorizeGrayResult.Bmp", RasterImageFormat.Bmp, 24)

   RasterCodecs.Shutdown()
End Sub
C#Copy Code
public void ColorizeGrayCommandExample() 
{ 
   // Load an image 
 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "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, LeadtoolsExamples.Common.ImagesPath.Path + "ColorizeGrayResult.Bmp", RasterImageFormat.Bmp, 24); 
 
   RasterCodecs.Shutdown(); 
}

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.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Core.ColorizeGrayCommand

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also