SmoothLevels

see SmoothAdjust, SmoothLevels' successor

Abstract
Author	LaTo
Version	v1.02 - Update 2009/01/28
Download	SmoothLevels
Category	Levels and Chroma
Requirements	YV12
License
Discussion

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")

Abstract

Advanced levels adjustment function, with limiting & smoothing parameters.

Description

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

Required Filters

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

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

Links

Doom9 Thread