ImageGear .NET v25.0 - Updated
HighDensityRangeEffect Method




ImageGear.Processing.Advanced Assembly > ImageGear.Processing Namespace > ImGearEffects Class : HighDensityRangeEffect Method
Page to process.
Start intensity for the shadow range. Valid values are from 0.0 to shadowEnd. Set this parameter to a non-zero value if there are no black pixels in the image.
End intensity for the shadow range. Valid values are from 0.0 to 1.0, but the typical range is between 0.0 and 0.5. ShadowStart and shadowEnd parameters define the range of pixels that will be brightened.
Maximum brightness for brightened shadow pixels, at which they will be included into the result image. Brighter pixels will be blended as semi-transparent with the result image.
Start intensity for the highlight range. Valid values are from 0.0 to 1.0, but the typical range is between 0.5 and 1.0. HighlightStart and highlightEnd parameters define the range of pixels that will be darkened.
End intensity for the highlight range. Valid values are from highlightStart to 1.0. Set this parameter to a value that is less than 1.0 if there are no pixels with maximal brightness in the image.
Minimum brightness for darkened highlight pixels, at which they will be included into the result image. Darker pixels will be blended as semi-transparent with the result image.
Start intensity for the midtone range. Valid values are from 0.0 to 1.0, but the typical range is between 0.0 and 0.5.
End intensity for the midtone range. Valid values are from 0.0 to 1.0, but the typical range is between 0.5 and 1.0. MidtoneStart and midtoneEnd parameters define increase contrast for the midtone range.
Radius that defines the width of the edge between highlight and midtone areas. Smaller values make the details sharper, but may result in too frequent changes between shadow and highlight areas, actually reducing image contrast and resulting in possible artifacts. Greater values make shadow and highlight areas bigger and smoother, but may result in halos between the shadow and highlight areas. Greater values also result in longer processing. Useful values are in range from 1.0 to 1/4 of the image's smaller dimension.
Makes the image look as if it was taken in a High Density Range mode, by adding bright colors to image edges.
Syntax
'Declaration
 
Public Shared Sub HighDensityRangeEffect( _
   ByVal page As ImGearRasterPage, _
   ByVal shadowStart As Double, _
   ByVal shadowEnd As Double, _
   ByVal shadowThreshold As Double, _
   ByVal highlightStart As Double, _
   ByVal highlightEnd As Double, _
   ByVal highlightThreshold As Double, _
   ByVal midtoneStart As Double, _
   ByVal midtoneEnd As Double, _
   ByVal radius As Double _
) 
'Usage
 
Dim page As ImGearRasterPage
Dim shadowStart As Double
Dim shadowEnd As Double
Dim shadowThreshold As Double
Dim highlightStart As Double
Dim highlightEnd As Double
Dim highlightThreshold As Double
Dim midtoneStart As Double
Dim midtoneEnd As Double
Dim radius As Double
 
ImGearEffects.HighDensityRangeEffect(page, shadowStart, shadowEnd, shadowThreshold, highlightStart, highlightEnd, highlightThreshold, midtoneStart, midtoneEnd, radius)
public static void HighDensityRangeEffect( 
   ImGearRasterPage page,
   double shadowStart,
   double shadowEnd,
   double shadowThreshold,
   double highlightStart,
   double highlightEnd,
   double highlightThreshold,
   double midtoneStart,
   double midtoneEnd,
   double radius
)
public: static void HighDensityRangeEffect( 
   ImGearRasterPage* page,
   double shadowStart,
   double shadowEnd,
   double shadowThreshold,
   double highlightStart,
   double highlightEnd,
   double highlightThreshold,
   double midtoneStart,
   double midtoneEnd,
   double radius
) 
public:
static void HighDensityRangeEffect( 
   ImGearRasterPage^ page,
   double shadowStart,
   double shadowEnd,
   double shadowThreshold,
   double highlightStart,
   double highlightEnd,
   double highlightThreshold,
   double midtoneStart,
   double midtoneEnd,
   double radius
) 

Parameters

page
Page to process.
shadowStart
Start intensity for the shadow range. Valid values are from 0.0 to shadowEnd. Set this parameter to a non-zero value if there are no black pixels in the image.
shadowEnd
End intensity for the shadow range. Valid values are from 0.0 to 1.0, but the typical range is between 0.0 and 0.5. ShadowStart and shadowEnd parameters define the range of pixels that will be brightened.
shadowThreshold
Maximum brightness for brightened shadow pixels, at which they will be included into the result image. Brighter pixels will be blended as semi-transparent with the result image.
highlightStart
Start intensity for the highlight range. Valid values are from 0.0 to 1.0, but the typical range is between 0.5 and 1.0. HighlightStart and highlightEnd parameters define the range of pixels that will be darkened.
highlightEnd
End intensity for the highlight range. Valid values are from highlightStart to 1.0. Set this parameter to a value that is less than 1.0 if there are no pixels with maximal brightness in the image.
highlightThreshold
Minimum brightness for darkened highlight pixels, at which they will be included into the result image. Darker pixels will be blended as semi-transparent with the result image.
midtoneStart
Start intensity for the midtone range. Valid values are from 0.0 to 1.0, but the typical range is between 0.0 and 0.5.
midtoneEnd
End intensity for the midtone range. Valid values are from 0.0 to 1.0, but the typical range is between 0.5 and 1.0. MidtoneStart and midtoneEnd parameters define increase contrast for the midtone range.
radius
Radius that defines the width of the edge between highlight and midtone areas. Smaller values make the details sharper, but may result in too frequent changes between shadow and highlight areas, actually reducing image contrast and resulting in possible artifacts. Greater values make shadow and highlight areas bigger and smoother, but may result in halos between the shadow and highlight areas. Greater values also result in longer processing. Useful values are in range from 1.0 to 1/4 of the image's smaller dimension.
Remarks
This method applies a High Density Range effect on the image. It increases contrast separately in shadow, highlight, and midtone areas, imitating the human eye's ability to adapt for light conditions at the point of interest.
See Also

Reference

ImGearEffects Class
ImGearEffects Members
ImGearRasterPage Class