GammaCorrectCommand Class

Summary

Adjusts the intensity of colors in an image by changing the gamma constant that is used to map the intensity values.

Syntax

Objective-C

C++/CLI

Java

Python

public class GammaCorrectCommand : RasterCommand

@interface LTGammaCorrectCommand : LTRasterCommand

public class GammaCorrectCommand 
    extends RasterCommand

public ref class GammaCorrectCommand : public RasterCommand

class GammaCorrectCommand(RasterCommand):

Remarks

Intensity values ideally follow a logarithmic progression, because the eye perceives changes in intensity as being equal when the ratio of change is equal. For example, we would see a change from 0.1 to 0.2 as being equal to a change from 0.2 to 0.4.
Gamma is a standard constant that is used to calculate the progression. For most CRTs the gamma constant is in the range of 2.2 to 2.5.
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 command does not support 32-bit grayscale images.

For more information, refer to Changing Brightness and Contrast.

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;

Gamma Correct Function - Before

Gamma Correct Function - After

View additional platform support for this Gamma Correct function.

Example

Run the GammaCorrectCommand on an image and apply gamma correction.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
 
public void GammaCorrectCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "sample5.cmp")); 
 
   // Prepare the command 
   GammaCorrectCommand command = new GammaCorrectCommand(); 
   //Set a gamma value of 2.5. 
   command.Gamma = 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:\LEADTOOLS22\Resources\Images"; 
}