←Select platform

ColorizeGrayCommandData Class

Summary
The ColorizeGrayCommandData class contains information about gray color intensities (Threshold) and the associated colors (Color) used in the coloration methods of the ColorizeGrayCommand class.
Syntax
C#
Objective-C
C++/CLI
Java
Python
public class ColorizeGrayCommandData 
@interface LTColorizeGrayCommandData : NSObject 
public class ColorizeGrayCommandData 
public ref class ColorizeGrayCommandData  
class ColorizeGrayCommandData: 
Remarks
  • 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.

Example

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

C#
Java
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
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:\LEADTOOLS23\Resources\Images"; 
} 
 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.core.*; 
 
 
public void colorizeGrayCommandDataExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "beauty16.jpg")); 
 
   // Prepare the command 
   ColorizeGrayCommandData[] pGrayColors = new ColorizeGrayCommandData[6]; 
   for (int index = 0; index < 6; index++) 
      pGrayColors[index] = new ColorizeGrayCommandData(); 
 
   pGrayColors[0].setThreshold(9999); 
   pGrayColors[1].setThreshold(19999); 
   pGrayColors[2].setThreshold(29999); 
   pGrayColors[3].setThreshold(39999); 
   pGrayColors[4].setThreshold(49999); 
   pGrayColors[5].setThreshold(59999); 
 
   pGrayColors[0].setColor(new RasterColor(255, 0, 0)); 
   pGrayColors[1].setColor(new RasterColor(0, 255, 0)); 
   pGrayColors[2].setColor(new RasterColor(0, 0, 255)); 
   pGrayColors[3].setColor(new RasterColor(0, 255, 255)); 
   pGrayColors[4].setColor(new RasterColor(255, 0, 255)); 
   pGrayColors[5].setColor(new RasterColor(255, 255, 0)); 
 
   ColorizeGrayCommand command = new ColorizeGrayCommand(); 
   command.setGrayColors(pGrayColors); 
 
   // Call the command 
   command.run(image); 
 
   // Save the resulted image 
   codecs.save(command.getDestinationImage(), combine(LEAD_VARS_IMAGES_DIR, "ColorizeGrayResult.Bmp"), 
         RasterImageFormat.BMP, 24); 
 
   System.out.println("Command run and image saved to " + combine(LEAD_VARS_IMAGES_DIR, "ColorizeGrayResult.Bmp")); 
   assertTrue(new File(combine(LEAD_VARS_IMAGES_DIR, "ColorizeGrayResult.Bmp")).exists()); 
} 
Requirements

Target Platforms

Help Version 23.0.2024.3.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Core Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.