Converts a 1-bit, 4-bit, 8-bit, 16-bit, 24-bit, or 32-bit image to an 8-bit, 12-bit, or 16-bit grayscale image.
public class GrayscaleCommand : RasterCommand
Public Class GrayscaleCommand
Inherits RasterCommand
@interface LTGrayscaleCommand : LTRasterCommand
public class GrayscaleCommand extends RasterCommand
public ref class GrayscaleCommand : public RasterCommand
Support for 12 and 16-bit grayscale images is available only in the Document/Medical Imaging editions.
The resulting image can be an 8-bit, 12-bit, or 16-bit grayscale image. Once the function is complete, the RasterImage.GrayscaleMode property will indicate the type of grayscale image.
When converting to 12-bit or 16-bit grayscale, the RasterImage.GetLookupTable is not used. When converting to 8-bit grayscale, the RasterImage.GetLookupTable is used to get the RGB for each input pixel. The grayscale value corresponding to that RGB triple is used in the destination image.
For more information, refer to Introduction to Image Processing With LEADTOOLS.
For more information, refer to Grayscale Images.
This example will load a 24-bit image then convert it to a grayscale image with 8, 12 and 16 bits/pixel
using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing;
using LeadtoolsExamples.Common;
public void GrayscaleCommandExample()
{
RasterCodecs codecs = new RasterCodecs();
string srcFileName = Path.Combine(ImagesPath.Path, "Image1.cmp");
string destFileName8 = Path.Combine(ImagesPath.Path, "Image1_grayscale8.jpg");
string destFileName12 = Path.Combine(ImagesPath.Path, "Image1_grayscale12.jpg");
string destFileName16 = Path.Combine(ImagesPath.Path, "Image1_grayscale16.jpg");
// Load the source image from disk as 24-bits/pixel
RasterImage image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1);
// Check the grayscale mode
Console.WriteLine("Grsyscale mode of original image = {0}", image.GrayscaleMode);
// Convert to 8-bit grayscale
GrayscaleCommand command = new GrayscaleCommand();
command.BitsPerPixel = 8;
command.Run(image);
// Check the grayscale mode
Console.WriteLine("Grsyscale mode after grayscale command with 8 bpp = {0}", image.GrayscaleMode);
// Save it to disk
codecs.Options.Jpeg.Save.QualityFactor = 2;
codecs.Save(image, destFileName8, RasterImageFormat.Jpeg, 8);
image.Dispose();
// Load the image again this time grayscale to 12-bits/pixel
image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1);
command.BitsPerPixel = 12;
command.Run(image);
Console.WriteLine("Grsyscale mode after grayscale command with 12 bpp = {0}", image.GrayscaleMode);
codecs.Options.Jpeg.Save.QualityFactor = 2;
codecs.Save(image, destFileName12, RasterImageFormat.Jpeg, 12);
image.Dispose();
// Load the image again this time grayscale to 16-bits/pixel
image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1);
command.BitsPerPixel = 16;
command.Run(image);
Console.WriteLine("Grsyscale mode after grayscale command with 16 bpp = {0}", image.GrayscaleMode);
// When saving 16-bit jpegs, you must use lossless quality factor
codecs.Options.Jpeg.Save.QualityFactor = 0;
codecs.Save(image, destFileName16, RasterImageFormat.Jpeg, 16);
image.Dispose();
// Clean Up
codecs.Dispose();
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing
Public Sub GrayscaleCommandExample()
Dim codecs As RasterCodecs = New RasterCodecs()
Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")
Dim destFileName8 As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_grayscale8.jpg")
Dim destFileName12 As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_grayscale12.jpg")
Dim destFileName16 As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_grayscale16.jpg")
' Load the source image from disk as 24-bits/pixel
Dim image As RasterImage = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1)
' Check the grayscale mode
Console.WriteLine("Grsyscale mode of original image = {0}", image.GrayscaleMode)
' Convert to 8-bit grayscale
Dim command As GrayscaleCommand = New GrayscaleCommand()
command.BitsPerPixel = 8
command.Run(image)
' Check the grayscale mode
Console.WriteLine("Grsyscale mode after grayscale command with 8 bpp = {0}", image.GrayscaleMode)
' Save it to disk
codecs.Options.Jpeg.Save.QualityFactor = 2
codecs.Save(image, destFileName8, RasterImageFormat.Jpeg, 8)
image.Dispose()
' Load the image again this time grayscale to 12-bits/pixel
image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1)
command.BitsPerPixel = 12
command.Run(image)
Console.WriteLine("Grsyscale mode after grayscale command with 12 bpp = {0}", image.GrayscaleMode)
codecs.Options.Jpeg.Save.QualityFactor = 2
codecs.Save(image, destFileName12, RasterImageFormat.Jpeg, 12)
image.Dispose()
' Load the image again this time grayscale to 16-bits/pixel
image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1)
command.BitsPerPixel = 16
command.Run(image)
Console.WriteLine("Grsyscale mode after grayscale command with 16 bpp = {0}", image.GrayscaleMode)
' When saving 16-bit jpegs, you must use lossless quality factor
codecs.Options.Jpeg.Save.QualityFactor = 0
codecs.Save(image, destFileName16, RasterImageFormat.Jpeg, 16)
image.Dispose()
' Clean Up
image.Dispose()
End Sub
Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
c#[Silverlight C# Example]
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Examples;
using Leadtools.ImageProcessing;
using Leadtools.Windows.Media;
public void GrayscaleCommandExample(RasterImage image, Stream destStream8, Stream destStream12, Stream destStream16)
{
RasterCodecs codecs = new RasterCodecs();
RasterImage temp = image.Clone();
// Check the grayscale mode
Debug.WriteLine("Grsyscale mode of original image = {0}", image.GrayscaleMode);
// Convert to 8-bit grayscale
GrayscaleCommand command = new GrayscaleCommand();
command.BitsPerPixel = 8;
command.Run(image);
// Check the grayscale mode
Debug.WriteLine("Grsyscale mode after grayscale command with 8 bpp = {0}", image.GrayscaleMode);
Debug.Assert(image.GrayscaleMode == RasterGrayscaleMode.OrderedInverse || image.GrayscaleMode == RasterGrayscaleMode.OrderedNormal);
// Save it to disk
codecs.Options.Jpeg.Save.QualityFactor = 2;
codecs.Save(image, destStream8, RasterImageFormat.Jpeg, 8);
image.Dispose();
// this time grayscale to 12-bits/pixel
image = temp.Clone();
command.BitsPerPixel = 12;
command.Run(image);
Debug.WriteLine("Grsyscale mode after grayscale command with 12 bpp = {0}", image.GrayscaleMode);
codecs.Options.Jpeg.Save.QualityFactor = 2;
codecs.Save(image, destStream12, RasterImageFormat.Jpeg, 12);
image.Dispose();
// this time grayscale to 16-bits/pixel
image = temp.Clone();
command.BitsPerPixel = 16;
command.Run(image);
Debug.WriteLine("Grsyscale mode after grayscale command with 16 bpp = {0}", image.GrayscaleMode);
// When saving 16-bit jpegs, you must use lossless quality factor
codecs.Options.Jpeg.Save.QualityFactor = 0;
codecs.Save(image, destStream16, RasterImageFormat.Jpeg, 16);
image.Dispose();
// Clean Up
temp.Dispose();
}
vb[Silverlight VB Example]
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing
Imports Leadtools.Windows.Media
Public Sub GrayscaleCommandExample(ByVal image As RasterImage, ByVal destStream8 As Stream, ByVal destStream12 As Stream, ByVal destStream16 As Stream)
Dim codecs As RasterCodecs = New RasterCodecs()
Dim temp As RasterImage = image.Clone()
' Check the grayscale mode
Debug.WriteLine("Grsyscale mode of original image = {0}", image.GrayscaleMode)
' Convert to 8-bit grayscale
Dim command As GrayscaleCommand = New GrayscaleCommand()
command.BitsPerPixel = 8
command.Run(image)
' Check the grayscale mode
Debug.WriteLine("Grsyscale mode after grayscale command with 8 bpp = {0}", image.GrayscaleMode)
Debug.Assert(image.GrayscaleMode = RasterGrayscaleMode.OrderedInverse OrElse image.GrayscaleMode = RasterGrayscaleMode.OrderedNormal)
' Save it to disk
codecs.Options.Jpeg.Save.QualityFactor = 2
codecs.Save(image, destStream8, RasterImageFormat.Jpeg, 8)
image.Dispose()
' this time grayscale to 12-bits/pixel
image = temp.Clone()
command.BitsPerPixel = 12
command.Run(image)
Debug.WriteLine("Grsyscale mode after grayscale command with 12 bpp = {0}", image.GrayscaleMode)
codecs.Options.Jpeg.Save.QualityFactor = 2
codecs.Save(image, destStream12, RasterImageFormat.Jpeg, 12)
image.Dispose()
' this time grayscale to 16-bits/pixel
image = temp.Clone()
command.BitsPerPixel = 16
command.Run(image)
Debug.WriteLine("Grsyscale mode after grayscale command with 16 bpp = {0}", image.GrayscaleMode)
' When saving 16-bit jpegs, you must use lossless quality factor
codecs.Options.Jpeg.Save.QualityFactor = 0
codecs.Save(image, destStream16, RasterImageFormat.Jpeg, 16)
image.Dispose()
' Clean Up
temp.Dispose()
End Sub
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document