TranslateColor(RasterImage,int) Method

Summary

Translates the specified color in the image, and returns the nearest matching color in the destination image.

Syntax

Objective-C

C++

Java

public int TranslateColor( 
   RasterImage destImage, 
   int rgb 
)

Public Overloads Function TranslateColor( _ 
   ByVal destImage As RasterImage, _ 
   ByVal rgb As Integer _ 
) As Integer

- (unsigned int)translateColorRgb:(LTRasterImage *)dstImage  
                              rgb:(unsigned int)rgb

public int translateColor( 
  RasterImage destImage,  
  int rgb 
)

public: 
int TranslateColor(  
   RasterImage^ destImage, 
   int rgb 
)

Parameters

destImage
Destination RasterImage object.

rgb
Value that specifies the color in the image to be translated.

Return Value

The color value or the palette index of the nearest matching color in the destination image. If the destination image is 8 bits per pixel or less, this is always the palette index. Otherwise, it is the color value.

Remarks

When creating a target image for animation, you can use this method to ensure that the correct color is specified as the background color.

The reverse of this method (to get a true RGB color value from a palette index color), use GetTrueColorValue.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void TranslateColorExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
 
	// load an 8 bpp image and a 24 bpp image 
	RasterImage myImage1 = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Ulay1.bmp")); 
	RasterImage myImage2 = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Sample1.cmp")); 
 
	// translate the top-left pixel of the 24 bpp image to a palette index in the first 
	int win32Color = ColorTranslator.ToWin32(RasterColorConverter.ToColor(myImage2.GetPixelColor(0, 0))); 
	int index = myImage2.TranslateColor(myImage1, win32Color) & 0x0EFFFFFF; 
	Console.WriteLine(string.Format("Palette index: {0}", index)); 
 
	myImage2.Dispose(); 
	myImage1.Dispose(); 
 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Core 
Imports Leadtools.ImageProcessing.Color 
Imports Leadtools.Controls 
Imports Leadtools.Dicom 
Imports Leadtools.Drawing 
Imports Leadtools.Svg 
 
Public Sub TranslateColorExample() 
   Dim codecs As RasterCodecs = New RasterCodecs() 
 
   ' load an 8 bpp image and a 24 bpp image 
   Dim myImage1 As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Ulay1.bmp")) 
   Dim myImage2 As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Sample1.cmp")) 
 
   ' translate the top-left pixel of the 24 bpp image to a palette index in the first 
   Dim win32Color As Integer = ColorTranslator.ToWin32(RasterColorConverter.ToColor(myImage2.GetPixelColor(0, 0))) 
   Dim index As Integer = myImage2.TranslateColor(myImage1, win32Color) And &HEFFFFFF 
   Console.WriteLine(String.Format("Palette index: {0}", index)) 
 
   myImage2.Dispose() 
   myImage1.Dispose() 
 
   codecs.Dispose() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class