View source for HDRAGC

{{FilterCat4|External_filters|Plugins|Adjustment_filters|Levels and Chroma filters}}
{{Filter3
|{{Author/paviko}}
|v1.8.7
|[http://web.archive.org/web/20130812061301/http://strony.aster.pl/paviko/Hdragc-1.8.7.zip Hdragc-1.8.7.zip]
|Levels and Chroma
|Closed source
|6=[http://forum.doom9.org/showthread.php?t=93571  Doom9 Thread]}}

== Description ==
'''High Dynamic Range Automatic Gain Control''' - this plugin increase dynamic range of video clips (enhance shadows). It's "simply" gaining (brightening) dark areas of image without causing blow of highlights and is doing it by simulating the work of our eyes. Amount of gain is calculated automatically but you can also influence on it by parameters.
<br>
<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
* Supported color formats: [[YUY2]], [[YV12]]

<br>
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|HDRAGC (clip, float "max_gain", float "min_gain", float "coef_gain", float "max_sat", float "min_sat", float "coef_sat", int "avg_window", int "response", int "debug", int "mode", int "protect", int "passes", int "shift", bool "shadows", int "shift_u", int "shift_v", float "corrector", float "reducer", int "corrector_mode", int "avg_lum", float "black_clip", int "freezer")}}
<br>
::{{Par2| |clip| }}
:::Input clip.
<br>
::{{Par2|max_gain|float|3.0}}
:::Maximum gain value which can't be passed by auto control. 
<br>
::{{Par2|min_gain|float|1.0}}
:::Minimum gain.
<br>
::{{Par2|coef_gain|float|1.5}}
:::How to change auto calculation of gain. Default is 1.0, if you set 1.5 then if previously plugin was finding 2.0 gain, now it will 2.5 (1.0 + (2.0 - 1.0) * coef_gain).
<br>
::{{Par2|max_sat|float|9.0}}
:::Maximum gain for saturation (default 9.0, 1.0 means no saturation enhancement, below 1.0 - desaturation).
<br>
::{{Par2|min_sat |float|0.0}}
:::Minimum saturation enhancement.
<br>
::{{Par2|coef_sat|float|1.0}}
:::How saturation control is connected with gain control, sat = (gain - 1.0) * coef_sat (default 1.0 - means that if pixel is gained by factor 2.0, saturation is also gained 2.0). When setting coef_sat below 1.0, look also at min_sat parameter
<br>
::{{Par2|avg_window|int|}}
:::Number of frames for averaging gain value (default one second = 25 frames for PAL, 30 frames for NTSC, etc).
<br>
::{{Par2|response|int|100}}
:::How much gain value can differ between frames (default 100%, there is no pumping effect, so it's needed only in special cases).
<br>
::{{Par2|debug|int|0}}
:::Value 1 displays calculated gain value for frame (default 0).
<br>
::{{Par2|mode|int|2}}
:::Algorithm to use:
:::*0 : algorithm from 0.2 version
:::*1 : new algorithm
:::*2 : new algorithm with some float precision (default), 30% slower than mode = 1
<br>
::{{Par2|protect|int|2}}
:::Protection mode:
:::*0 : no protection for highlights
:::*1 : protects highlights from blowing
:::*2 : plugin automatically choose between 0 (off) and 1 (on) - (default)
<br>
::{{Par2|passes|int|4}}
:::Number of iterations for mode 0 (values from 1 to 9, default 4).
<br>
::{{Par2|shift|int|0}}
:::every luminance value x is shifted down by shift (x = x - shift), helpful in low-light, some camcorders brighten image by getting black more gray (default 0).
<br>
::{{Par2|shadows|bool|true}}
:::Default true - not only gain but also enhance shadows.
<br>
::{{Par2|shift_u|int|0}}
::{{Par2|shift_v|int|0}}
:::Parameters for sublte white balance correction, shift_u < 0 - removes blue tint, shift_u > 0 - removes yellow tint, shift_v < 0 - removes red tint, shift_v > 0 - removes green tint (default 0).
<br>
::{{Par2|corrector|float|0.0}}
:::Auto correction, recommended values 0.8 - 1.0, default 0.0. The lower value then less bright parts of image are gained (help for high values of gain).
<br>
::{{Par2|reducer|float|0.5}}
:::Default 0.5, values from 0.0 to 2.0. The higher value the more noise is removed from gained shadows.
<br>
::{{Par2|corrector_mode|int|}}
:::Undocumented parameter.
<br>
::{{Par2|avg_lum|int|128}}
:::Average luminance to which video should be gained.
<br>
::{{Par2|black_clip|float|0.0}}
:::Value in percents, that force to treat first x% darkest pixels as black pixels (works as auto shift), recommended values 0.0 - 1.0 (default 0.0).
<br>
::{{Par2|freezer|int|-1}}
:::Number of the frame (from 0), that will be taken to calculate all parameters, the parameters are then constant in time (default -1, which means that parameters will be calculated for every frame).
<br>
===Most Important Parameters===
*<code>coef_gain</code> (default 1.0) - increase parameter to get brighter image, decrease to limit auto brightening
*<code>coef_sat</code> (1.0) - increase to bring more saturation

====Tips====
1. I'd like to have brigther results.
*Try increasing coef_gain and/or min_gain
2. Image lacks colours saturation after brightening
*Try increasing coef_sat parameter
3. I would like to operate only in luma (without changing chrominance channels)
*Set max_sat to 1.0
4. When I set coef_sat lower that 1.0, bright area of image are loosing saturation
*Set min_sat to 1.0 (default value id 0.0)
5. Bright areas of image are too much gained
*Try corrector parameter - recommended values are (0.8 - 1.0), the lower value then less gain is applied to brighter part of image
6. Gained parts have too much noise
*Try increasing reducer parameter. Default value is 0.5, max is 2.0
<br>
== Examples ==
 [[AviSource]]("blah.avi")
 HDRAGC()
<br>
== Changelog ==
<pre>
Version 1.8.7 - 10.09.2006
    - fixed crash when black_clip is not used
Version 1.8.6 - 09.09.2006
    - added 'freezer' parameter - number of frame that is chosen to calculate gain parameters
Version 1.8.5 - 10.06.2006
    - added auto shifting (black_clip parameter)
    - avg_lum parameter is back
    - new mode (mode = 2), which is using float precision for some calculations (best quality, now mode = 2 as default)
    - fixed behaviour of coef_gain (for coef_gain > 1.0 it works as in previous versions)
    - tweaked corrector (by default it's not a bit lower, so if you were using previously x, now try x + 0.1)
Version 1.8.1 - 13.05.2006
    - fixed crash for black frame (thanks to Boulder)
Version 1.8 - 13.05.2006
    - huge jump in version, huge jump in quality ;)
    - improved old algorithm from version 0.2.1 (mode = 0), new algorithm (mode = 1) that even for high gains give natural picture
    - added support for YV12 and YUY2, removed RGB32
    - 3 times faster (but still without MMX, SSE, SSE2 optimizations)
    - 10 times less memory usage
    - better handling of saturation
    - new parameters for sublte color correction (shift_u, shift_v)
Version 0.2.1 - alpha - 25.10.2005:
     - fixed sharpening/denoising (they were turned off when gain was not applied to image)
    - fixed protect mode
Version 0.2.0 - alpha - 23.10.2005:
    - completely new lighting routine (sigma parameter not needed)
    - new mode (mode = 2) in which radius is deceptively chosen, this removes artifacts as much as I was able to do ;). 
      Slow, but faster and much, much better than mode = 0
    - mode = 1 is again 2 times faster (and will be faster later, still no MMX, SSE  optimization)
    - new parameter - protect - for value = 1 it can help in some situation with blowing highlights (default on)
    - new parameters - contrast, limit - for denoising/sharpening, almost for free - no slow down (experimental)
Version 0.1.5 alpha - 21.05.2005:
    - improvements - 4 times faster with significantly reduced halo artifacts (if you want old behaviour use parameter mode = 0)
Version 0.1.2 alpha - 30.04.2005:
    - changed lightness distribution routine (less plastic look - midtones have higher contrast)
    - new value for auto control of saturation
    - calculated gain is independent of avg_lum parameter
Version 0.1.1 alpha - 29.04.2005:
    - fixed bug with avg_lum (thanks to AVIL)
    - small c optimization (thanks to tsp)
    - new parameters (coef_gain, min_sat, circle)
Version 0.1 alpha - 25.04.2005 - first release
</pre>
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="400px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.8.7
|[http://web.archive.org/web/20130812061301/http://strony.aster.pl/paviko/Hdragc-1.8.7.zip Hdragc-1.8.7.zip]
|
|-
!v0.1.2 alpha
|[http://www.avisynth.nl/users/warpenterprises/files/hdragc_5F25_dll_20050521.zip hdragc_5F25_dll_20050521.zip]
|[https://web.archive.org/web/20061221175235if_/http://www.avisynth.org:80/warpenterprises/files/hdragc_25_dll_20050521.zip hdragc_25_dll_20050521.zip]
|}
* v0.1.2 alpha includes source code.
<br>

==External Links ==
*[http://web.archive.org/web/20130812061301/http://strony.aster.pl/paviko/hdragc.htm hdragc.htm] - official archived documentation (note: some parameters are listed out of order).
<br>
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] &larr;'''
-----------------------------------------------