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++/CLI

Java

Python

public int TranslateColor( 
   RasterImage destImage, 
   int rgb 
)

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

public int translateColor( 
   RasterImage destImage, 
   int rgb 
);

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

def TranslateColor(self,destImage,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:\LEADTOOLS22\Resources\Images"; 
}