SmoothLevels

Latest revision as of 23:22, 11 December 2015

see SmoothAdjust, SmoothLevels' successor

SmoothLevels(clip input, int "input_low", float "gamma", int "input_high", int "output_low", int "output_high", int "chroma", int "limiter", int "Lmode", int "DarkSTR", int "BrightSTR", int "Ecenter", int "protect", int "Ecurve", int "Smode", int "Mfactor", int "RGmode", bool "useGF", bool "show", string "preset")

[edit] Abstract

Advanced levels adjustment function, with limiting & smoothing parameters.

[edit] Description

Some of this information may be outdated and/or incomplete, check the Doom9 Thread for up-to-date version !!!

[edit] Required Filters

• Masktools (v2.0a35)
• Removegrain (v1.0PR)
• GradFun2db (v1.0)

[edit] Parameters

• General

Levels options:
---------------
input_low, gamma, input_high, output_low, output_high [default: 0, 1.0, 255, 0, 255]

chroma [default: 50]
---------------------
0   = no chroma processing     (similar as Ylevels)
xx  = intermediary
100 = normal chroma processing (similar as Levels)

limiter [default: 0]
--------------------
0 = no limiter             (similar as Ylevels)
1 = input limiter
2 = output limiter         (similar as Levels: coring=false)
3 = input & output limiter (similar as Levels: coring=true)

• Limiting

Lmode [default: 0]
------------------
0 = no limit
1 = limit conversion on dark & bright areas (apply conversion @0%   at luma=0 & @100% at luma=Ecenter & @0% at luma=255)
2 = limit conversion on dark areas          (apply conversion @0%   at luma=0 & @100% at luma=255)
3 = limit conversion on bright areas        (apply conversion @100% at luma=0 & @0%   at luma=255)

DarkSTR [default: 100]
----------------------
Strength for limiting: the higher, the more conversion are reduced on dark areas (for Lmode=1&2)

BrightSTR [default: 100]
------------------------
Strength for limiting: the higher, the more conversion are reduced on bright areas (for Lmode=1&3)

Ecenter [default: 128]
----------------------
Center of expression for Lmode=1
 
protect [default: -1]
---------------------
-1  = protect off
>=0 = pure black protection
      ---> don't apply conversion on pixels egal or below this value 
           (ex: with 16, the black areas like borders 
                and generic are untouched so they don't look washed out)

Ecurve [default: 0]
-------------------
Curve used for limit & protect:
0 = use sine curve
1 = use linear curve

• Smoothing

Smode [default: -2]
-------------------
2  = smooth on, maxdiff must be < to "255/Mfactor"
1  = smooth on, maxdiff must be < to "128/Mfactor"
0  = smooth off
-1 = smooth on if maxdiff < "128/Mfactor", else off
-2 = smooth on if maxdiff < "255/Mfactor", else off

Mfactor [default: 2]
--------------------
The higher, the more precise but the less maxdiff alowed: 
maxdiff=128/Mfactor for Smode1&-1 and maxdiff=255/Mfactor for Smode2&-2

RGmode [default: 12]
--------------------
In strength order: + 19 > 12 >> 20 > 11 -

useGF [default: true]
---------------------
Use gradfun2db on top of removegrain: prevent posterize when doing levels conversion

• Others

show [default: false]
---------------------
Show the debug clip

preset: 
-------
pc2tv = "PC -> TV" conversion
tv2pc = "TV -> PC" conversion

[edit] Links

Doom9 Thread