←Select platform

GrayScaleToMultitoneCommand Class

Summary

Converts a grayscale image into a colored one by mixing or replacing the original values of the pixels with one or more new colors. This class is available in the Imaging Pro and above toolkits.

Syntax

C#
VB
Java
Objective-C
C++
public class GrayScaleToMultitoneCommand : RasterCommand 
@interface LTGrayscaleToMultitoneCommand : LTRasterCommand 
public class GrayScaleToMultitoneCommand extends RasterCommand 

Remarks
  • This class was designed for use with grayscale images. If the image being used is not grayscale, this class only affects those pixels or areas of the image where Red = Green = Blue.
  • Monotone conversion is possible by setting Type to Replace, which clears the palette.
  • This class gives you the option of having the toolkit generate the array of colors to use or creating the array of colors to use yourself.
  • To have the toolkit generate the array of colors:

  • To use a user-defined array of colors:

  • This class supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
  • This class does not support signed data images.
  • This command does not support 32-bit grayscale images.

For more information, refer to Introduction to Image Processing With LEADTOOLS. For more information, refer to Grayscale Images.

Example

Run the GrayScaleToMultitoneCommand on an image.

C#
VB
Silverlight C#
Silverlight VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
public void GrayScaleToMultitoneCommandExample() 
{ 
   // 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 
   GrayScaleToMultitoneCommand command = new GrayScaleToMultitoneCommand(); 
   command.Colors = new RasterColor[2]; 
   command.Colors[0].R = 255; 
   command.Colors[0].G = 255; 
   command.Colors[0].B = 0; 
   command.Colors[1].R = 255; 
   command.Colors[1].G = 0; 
   command.Colors[1].B = 0; 
   command.Gradient = null; 
   command.Distribution = GrayScaleToMultitoneCommandDistributionType.Linear; 
   command.Tone = GrayScaleToMultitoneCommandToneType.Duotone; 
   command.Type = GrayScaleToDuotoneCommandMixingType.ReplaceOldWithNew; 
   command.Run(image); 
   codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Color 
      Leadtools.Examples.Support.SetLicense() 
 
Public Sub GrayScaleToMultitoneCommandExample() 
   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 Colors() As RasterColor 
   ReDim Colors(1) 
 
   Dim command As GrayScaleToMultitoneCommand = New GrayScaleToMultitoneCommand 
   command.Colors = Colors 
   command.Colors(0).R = 255 
   command.Colors(0).G = 255 
   command.Colors(0).B = 0 
   command.Colors(1).R = 255 
   command.Colors(1).G = 0 
   command.Colors(1).B = 0 
   command.Gradient = Nothing 
   command.Distribution = GrayScaleToMultitoneCommandDistributionType.Linear 
   command.Tone = GrayScaleToMultitoneCommandToneType.Duotone 
   command.Type = GrayScaleToDuotoneCommandMixingType.ReplaceOldWithNew 
   command.Run(leadImage) 
   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 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.Color; 
using Leadtools.Examples; 
 
public void GrayScaleToMultitoneCommandExample(RasterImage image, Stream outStream) 
{ 
   // Prepare the command 
   GrayScaleToMultitoneCommand command = new GrayScaleToMultitoneCommand(); 
   command.Colors = new RasterColor[2]; 
   command.Colors[0].R = 255; 
   command.Colors[0].G = 255; 
   command.Colors[0].B = 0; 
   command.Colors[1].R = 255; 
   command.Colors[1].G = 0; 
   command.Colors[1].B = 0; 
   command.Gradient = null; 
   command.Distribution = GrayScaleToMultitoneCommandDistributionType.Linear; 
   command.Tone = GrayScaleToMultitoneCommandToneType.Duotone; 
   command.Type = GrayScaleToDuotoneCommandMixingType.ReplaceOldWithNew; 
   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.Color 
 
Public Sub GrayScaleToMultitoneCommandExample(ByVal image As RasterImage, ByVal outStream As Stream) 
   ' Prepare the command 
   Dim command As GrayScaleToMultitoneCommand = New GrayScaleToMultitoneCommand() 
   command.Colors = New RasterColor(1) {} 
   command.Colors(0).R = 255 
   command.Colors(0).G = 255 
   command.Colors(0).B = 0 
   command.Colors(1).R = 255 
   command.Colors(1).G = 0 
   command.Colors(1).B = 0 
   command.Gradient = Nothing 
   command.Distribution = GrayScaleToMultitoneCommandDistributionType.Linear 
   command.Tone = GrayScaleToMultitoneCommandToneType.Duotone 
   command.Type = GrayScaleToDuotoneCommandMixingType.ReplaceOldWithNew 
   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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Color Assembly