←Select platform

ContrastBrightnessIntensityCommand Class

Summary

Applies contrast, brightness and intensity adjustments to enhance the image tonal range. This class is available in the Imaging Pro and above toolkits.

Syntax
C#
VB
Objective-C
C++
Java
public class ContrastBrightnessIntensityCommand : RasterCommand 
Public Class ContrastBrightnessIntensityCommand  
   Inherits RasterCommand 
@interface LTContrastBrightnessIntensityCommand : LTRasterCommand 
public class ContrastBrightnessIntensityCommand extends RasterCommand 
public ref class ContrastBrightnessIntensityCommand : public RasterCommand   

Remarks
  • The transformations are applied in this order: Contrast, Brightness then Intensity. Were the three commands to be called separately, then after each method was applied calculated values less than 0 and more than 255 (for 8 bits per component for example) would be clamped to 0 and 255 respectively. Using this method, the values are accumulative and the final result would be clamped. In addition, this command is faster than calling each method separately.
  • It also can process the whole image or a region of the image. If an image has a region, the effect is applied only to the region.
  • 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 Changing Brightness and Contrast.

Example

Run the ContrastBrightnessIntensityCommand on an image.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
public void ContrastBrightnessIntensityCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")); 
 
   // Prepare the command 
   ContrastBrightnessIntensityCommand command = new ContrastBrightnessIntensityCommand(); 
   command.Contrast = -146; 
   command.Brightness = 358; 
   command.Intensity = 240; 
   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:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Color 
 
Public Sub ContrastBrightnessIntensityCommandExample() 
   Dim codecs As New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
 
   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")) 
 
   ' Prepare the command 
   Dim command As ContrastBrightnessIntensityCommand = New ContrastBrightnessIntensityCommand 
   command.Contrast = -146 
   command.Brightness = 358 
   command.Intensity = 240 
   command.Run(leadImage) 
   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24) 
 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 
c#[Silverlight C# Example] 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Examples; 
 
public void ContrastBrightnessIntensityCommandExample(RasterImage image, Stream outStream) 
{ 
   // Prepare the command 
   ContrastBrightnessIntensityCommand command = new ContrastBrightnessIntensityCommand(); 
   command.Contrast = -146; 
   command.Brightness = 358; 
   command.Intensity = 240; 
   command.Run(image); 
 
   // Save result image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24); 
   image.Dispose(); 
} 
vb[Silverlight VB Example] 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Color 
 
Public Sub ContrastBrightnessIntensityCommandExample(ByVal image As RasterImage, ByVal outStream As Stream) 
   ' Prepare the command 
   Dim command As ContrastBrightnessIntensityCommand = New ContrastBrightnessIntensityCommand() 
   command.Contrast = -146 
   command.Brightness = 358 
   command.Intensity = 240 
   command.Run(image) 
 
   ' Save result image 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24) 
   image.Dispose() 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Color Assembly