Changes the value of a pixel by an amount determined by the input Red, Green and Blue channel RGB values individually, or as an averaged value.
The change is graduated starting from LoLimit, with a maximum change applied to the midpoint between LoLimit and HiLimit, then reduced again to HiLimit.
Typically this method can be used to effectively progressively brighten or darken any range of colors as requested without affecting colors outside the range.
RGB values in the range of 0 to 127 are considered as darker, and 128 to 255 as lighter.
Assembly: IEvolution2 (in IEvolution2.dll) Version: 10.1.0.0
Syntax
C# | Visual Basic | Visual C++ |
public void Intensity( int loLimit, int hiLimit, int change, bool useAverageRGB, bool doRed, bool doGreen, bool doBlue )
Public Sub Intensity ( _ loLimit As Integer, _ hiLimit As Integer, _ change As Integer, _ useAverageRGB As Boolean, _ doRed As Boolean, _ doGreen As Boolean, _ doBlue As Boolean _ )
public: void Intensity( int loLimit, int hiLimit, int change, bool useAverageRGB, bool doRed, bool doGreen, bool doBlue )
Parameters
- loLimit
- Int32
An integer between 0 and 255 that indicates the start point of the range.
- hiLimit
- Int32
An integer between 0 and 255 that indicates the end point of the range.
- change
- Int32
An integer between -255 and 255 that indicates the maximum or minimum value to be applied to the midpoint, and used to determine the slope of the increment/decrement used over the range.
- useAverageRGB
- Boolean
If True, uses the average value of the input Red, Green and Blue channels to determine the amount to change all RGB channels in the pixel.
- doRed
- Boolean
If True, applies the change to this RGB channel.
- doGreen
- Boolean
If True, applies the change to this RGB channel.
- doBlue
- Boolean
If True, applies the change to this RGB channel.
Examples
CopyC#
// Apply an Intensity gradient peaking at +40 to all RGB values between 80 and 255 ieViewer1.Image.Intensity( 80, 255, 40, false, true, true, true ); // Apply an Intensity gradient dropping to -24, to the Red RGB channel only, when Red values are between 20 and 127 ieViewer1.Image.Intensity( 20, 127, -24, false, true, false, false );