Reel.Deal: Auto_Gamma (2020/09/04)

2020-11-09T06:15:38Z

Auto_Gamma (2020/09/04)

New page

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters|Deep_color_tools}}
{{Filter3
|[https://github.com/crabshank crabshank]
|2020-09-04
|3=[https://github.com/crabshank/Avisynth-filters/blob/master/C_Auto_Gamma_x64.dll C_Auto_Gamma_x64.dll]
|4=Adjustment Filters
|5=Open source
|6=[https://forum.doom9.org/showthread.php?t=177046 Doom9 Forum]
}}
== Description ==
[[Auto_Gamma]] calculates gamma values to manage the brightness and contrast of a whole video based on the range set by parameters "a" and "b", where lower "b" values output a brighter image.

There is also a parameter to apply a gamma transform first if you feel the image is under/overexposed and one to ensure that it can display the original pixel if it's brighter so no dark details are lost.

There is accurate xy colorimetry and transfer functions for 11 colour spaces as of now, and more could be easily added.
 
 

== Requirements ==
* [[AviSynth+]] (x64 only)
* Supported color formats: [[RGB32]], [[RGB64]]
 

== [[Script variables|Syntax and Parameters]] ==

:{{Template:FuncDef|Auto_Gamma (clip, float "a", float "b", int "tolerance", int "crush", bool "limitedRange", int "mode", int "linear", bool "sixtyFour")}}
 
::{{Par2| |clip| }}
:::Input clip, must be RGB32 or RGB64.
 
::{{Par2|a|float|0.0}}
::{{Par2|b|float|4.3}}
:::Upper and lower bounds of gamma values to search between (lower => brighter)
:::Range: 0.00 to 20.00 by 0.01
 
::{{Par2|tolerance|int|4}}
:::Number of decimal places of accuracy to use in calculation.
:::Range: 1 to 7 by 1
 
::{{Par2|crush|int|0}}
:::*0 - Take gamma-adjusted colour if lighter than the input (default).
:::*1 - Take gamma-adjusted colour if darker than the input.
:::*2 - Take all gamma-adjusted colours.
 
::{{Par2|limitedRange|bool|false}}
:::*True : limited range
:::*False : full range
 
::{{Par2|mode|int|0}}
:::*0 - sRGB (default)
:::*1 - Rec. 601 NTSC
:::*2 - Rec. 601 PAL
:::*3 - Rec. 709
:::*4 - Rec. 2020
:::*5 - DCI-P3
:::*6 - Display P3
:::*7 - Orginal NTSC (47 CFR § 73.682 - TV transmission standards)
:::*8 - Rec. 601 D93 (Use for Japanese media)
:::*9 - Rec. 709 D93 (Some Japanese media may use this)
:::*10 - DCI-P3 (D60/ACES)
:::*11 - Rec. 2100/2020 Hybrid Log-Gamma
 
::{{Par2|linear|int|0}}
:::*0 - Uses raw input RGB (default).
:::*1 - Uses sRGB -> linear RGB converted values.
:::*2 - Uses linear RGB -> sRGB converted values.
:::*3 - Uses Rec.(2020/601/709) RGB -> linear RGB converted values.
:::*4 - Uses linear RGB -> Rec.(2020/601/709) RGB converted values.
:::*5 - Uses gamma=2.2 -> linear RGB converted values.
:::*6 - Uses linear RGB -> gamma=2.2 converted values.
:::*7 - Uses gamma=2.6 -> linear RGB converted values.
:::*8 - Uses linear RGB -> gamma=2.6 converted values
:::*9 - Hybrid Log-Gamma -> linear RGB
:::*10 - linear RGB -> Hybrid Log-Gamma
 
::{{Par2|sixtyFour|bool|false}}
:::It's not necessary to set this argument, because the plugin will automatically detect if RGB64 is used.
:::True (not recommended) - Force 64-bit processing in plugin.
 
::'''Note:''' It's important to use D93 modes where appropriate.
 
== Examples ==
[[TODO]]

 
==External Links ==
*[https://github.com/crabshank/Avisynth-filters GitHub] - Source code repository.
 
 
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] ←'''

Auto Gamma - Revision history

Reel.Deal: Auto_Gamma (2020/09/04)