ColorReplaceCommand Class

Summary

Replaces the specified color by adjusting values of hue, saturation and brightness.

Syntax

Objective-C

C++/CLI

Java

Python

public class ColorReplaceCommand : RasterCommand

@interface LTColorReplaceCommand : LTRasterCommand

public class ColorReplaceCommand 
    extends RasterCommand

public ref class ColorReplaceCommand : public RasterCommand

class ColorReplaceCommand(RasterCommand):

Remarks

This command replaces the specified color by adjusting value of hue, saturation and brightness. The value of the Fuzziness property of the ColorReplaceCommandColor class determines the range around each color where the pixels will be changed according to Hue, Saturation and Brightness.
This command 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 command 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 Correcting Colors.

Color Replace Function - Before

Color Replace Function - After

View additional platform support for this Color Replace function.

Example

Run the ColorReplaceCommand on an image to change the red color by rotating its hue 90 degree.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
 
public void ColorReplaceCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "cannon.jpg")); 
 
   // Prepare the command 
   ColorReplaceCommand command = new ColorReplaceCommand(); 
   ColorReplaceCommandColor[] data = new ColorReplaceCommandColor[1]; 
   data[0] = new ColorReplaceCommandColor(); 
   data[0].Color = new RasterColor(200, 0, 35); 
   data[0].Fuzziness = 100; 
   command.Colors = data; 
   command.Hue = 9000; 
   command.Saturation = 0; 
   command.Brightness = 0; 
   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:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.color.*; 
 
 
public void colorReplaceCommandExample() { 
 
    final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
    // Load an image 
    RasterCodecs codecs = new RasterCodecs(); 
    codecs.setThrowExceptionsOnInvalidImages(true); 
 
    RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "cannon.jpg")); 
 
    // Prepare the command 
    ColorReplaceCommand command = new ColorReplaceCommand(); 
    ColorReplaceCommandColor[] data = new ColorReplaceCommandColor[1]; 
    data[0] = new ColorReplaceCommandColor(); 
    data[0].setColor(new RasterColor(200, 0, 35)); 
    data[0].setFuzziness(100); 
    command.setColors(data); 
    command.setHue(9000); 
    command.setSaturation(0); 
    command.setBrightness(0); 
    command.run(image); 
    codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
 
    System.out.println("Command run, image saved to " + combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")); 
    assertTrue(new File(combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")).exists()); 
 
}