CreateGrayscaleImageCommand Class

Summary

Converts a 1-bit, 4-bit, 8-bit, 16-bit, 24-bit, or 32-bit RasterImage to an 8-bit, 12-bit, or 16-bit grayscale image.

Syntax

Objective-C

C++/CLI

Java

Python

public class CreateGrayscaleImageCommand : RasterCommand

@interface LTCreateGrayScaleImageCommand : LTRasterCommand

public class CreateGrayscaleImageCommand extends RasterCommand

public ref class CreateGrayscaleImageCommand : public RasterCommand

class CreateGrayscaleImageCommand(RasterCommand):

Remarks

The CreateGrayscaleImageCommand command works by creating a new image in the DestinationImage property from the image passed to the Run method.

The destination image will have either 8, 12, or 16 bits/pixel grayscale values.

When converting to 12-bit or 16-bit grayscale, a Lookup table (LUT) is not used. When converting to 8-bit grayscale, a LUT is used to get the RGB for each input pixel. The grayscale value corresponding to that RGB triple is used in the destination image

LowBit and HighBit are used when converting to 12-bit or 16-bit grayscale, So the appropriate values must set before calling the Run method.

This command does not support 32-bit grayscale images.

This command does not support signed images.

Example

This example loads an image and changes it to 16-bit grayscale.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
 
 
public void CreateGrayscaleImageCommandExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
 
	string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
	string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_CreateGrayscaleImage.bmp"); 
 
	// Load the source image from disk 
	RasterImage srcImage = codecs.Load(srcFileName); 
 
	// Create a grayscale image 
	CreateGrayscaleImageCommand cmd = new CreateGrayscaleImageCommand(); 
	cmd.BitsPerPixel = 16; 
	cmd.LowBit = 0; 
	cmd.HighBit = 15; 
	cmd.Run(srcImage); 
 
	RasterImage destImage = cmd.DestinationImage; 
 
	// Save the image to disk 
	codecs.Save( 
	   destImage, 
	   destFileName, 
	   RasterImageFormat.Bmp, 
	   16); 
 
	// Clean up 
	destImage.Dispose(); 
	srcImage.Dispose(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}