ChangeIntensityCommand Class

Summary

Changes the intensity (brightness) of the image.

Syntax

Objective-C

C++/CLI

Java

Python

public class ChangeIntensityCommand : RasterCommand

@interface LTChangeIntensityCommand : LTRasterCommand

public class ChangeIntensityCommand 
    extends RasterCommand

public ref class ChangeIntensityCommand : public RasterCommand

class ChangeIntensityCommand(RasterCommand):

Remarks

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 32-bit grayscale images.
This command supports signed/unsigned data images.

If the image has a LUT and you want to work on the image data, set RasterImage.UseLookupTable to false. Then, after calling the method, reset the UselookupTable property to true, as follows:

rasterImage.UseLookupTable = false; 
Method(rasterImage); 
rasterImage.UseLookupTable = true;

For more information, refer to Correcting Colors.

For more information, refer to Changing Brightness and Contrast.

Change Intensity Function - Before

Change Intensity Function - After

View additional platform support for this Change Intensity function.

Example

Run the ChangeIntensityCommand on an image and increase its intensity.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
 
public void ChangeIntensityCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "ImageProcessingDemo\\Image1.jpg")); 
 
   // Prepare the command 
   ChangeIntensityCommand command = new ChangeIntensityCommand(); 
   //Increase the brightness by 25 percent  of the possible range. 
   command.Brightness = 250; 
   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.ChangeIntensityCommand; 
 
 
public void changeIntensityCommandExample() { 
 
    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, "Image1.jpg")); 
 
    // Prepare the command 
    ChangeIntensityCommand command = new ChangeIntensityCommand(); 
 
    // Increase the brightness by 25 percent of the possible range 
    command.setBrightness(250); 
    command.run(image); 
    codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
 
    assertTrue(new File(combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")).exists()); 
    System.out.println("Command run and image saved to " + combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")); 
 
}