Editing FineDehalo

{{FilterCat4|External_filters|Scripts|Restoration_filters|Dehalo}}
{{Filter3
|{{Author/cretindesalpes}}
|1.1
|[[Media:FineDehalo.avsi|FineDehalo.avsi]]
|4=Dehalo
|5=[http://en.wikipedia.org/wiki/WTFPL WTFPL]
|6=}}
== Description ==
Halo removal script that uses DeHalo_alpha with a few masks and optional contra-sharpening to try remove halos without removing important details (like line edges). It also includes [[FineDehalo#FineDehalo2|FineDehalo2]], this function tries to remove 2nd order halos. See script for extensive information.
<br>
<br>
== Requirements ==
* [http://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0] or greater
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only 
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]
==== Required Plugins ====
*[[MaskTools2]]
*[[MedianBlur2]]
*[[RgTools]]
==== Required Scripts ====
*[[DeHalo_alpha]]
*mt_xxpand_multi - included in the [[Dither]] package. 
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|FineDehalo (clip src, float "rx", float "ry", int "thmi", int "thma", int "thlimi", int "thlima", float "darkstr", float "brightstr", int "showmask", float "contra", bool "excl", float "edgeproc")}}
<br>
::{{Par2|src|clip| }}
:::Input clip.
<br>
::{{Par2|rx|float|2.0}}
::{{Par2|ry|float|rx}}

:::The radii for halo removal in [[DeHalo_alpha]].
:::<span style="color:red">'''Note:'''</span> This function is rather sensitive to the radius settings. Set it as low as possible! If radius is set too high, it will start missing small spots.<br>

:::Range: 1.0 to 3.0
<br>
::{{Par2|thmi|int|80}}
::{{Par2|thma|int|128}}
:::Minimum and maximum threshold for sharp edges; keep only the sharpest edges (line edges). To see the effects of these settings take a look at the strong mask (<code>{{Template:FuncDef|showmask}}=4</code>).
<br>
::{{Par2|thlimi|int|50}}
::{{Par2|thlima|int|100}}
:::Minimum and maximum limiting threshold; includes more edges than previously, but ignores simple details.
<br>
::{{Par2|darkstr|float|1.0}}
::{{Par2|brightstr|float|1.0}}

:::[[DeHalo_alpha]] strength factors for processing dark and bright halos. Default 1.0 both for symmetrical processing. 
:::On Comics/Anime, {{Template:FuncDef|darkstr}}=0.4~0.8 sometimes might be better ... sometimes. In general, the function seems to preserve dark lines rather well.<br>

:::Range: 0.0 to 1.0 [<0.0 and >1.0 possible]
<br>
::{{Par2|showmask|int|0}}
::: Shows mask; useful for adjusting settings.
::::*0 : none
::::*1 : outside mask
::::*2 : shrink mask
::::*3 : edge mask
::::*4 : strong mask
<br>
::{{Par2|contra|float|0.0}}
:::contra-sharpening; 
::::*0.0 : bypass
::::*1.0 : normal contra-sharp
<br>
::{{Par2|excl|bool|true}}
::::*false : bypass
::::*true : will activate an additional step (exclusion zones) to make sure that the main edges are really excluded. We do not want them to be smoothed by the halo removal.
<br>
-----
<br>
===FineDehalo2===
:{{Template:FuncDef|FineDehalo2 (clip src, string "hconv", string "vconv", int "showmask")}}
<br>
::{{Par2|src|clip| }}
:::Input clip.
<br>
::{{Par2|hconv|string|"-1 -2 0 0 40 0 0 -2 -1"}}
::{{Par2|vconv|string|"-2 -1 0 0 40 0 0 -1 -2"}}
:::Horizontal and vertical convolutions.
<br>
::{{Par2|showmask|int|0}}
:::*0 : no
:::*1 : yes
<br>
== Examples ==
FineDehalo with default values:
 [[AviSource]]("Blah.avi")
 FineDehalo(rx=2.0, ry=2.0, thmi=80, thma=128, thlimi=50, thlima=100, \
            darkstr=1.0, brightstr=1.0, showmask=0, contra=0.0, excl=true)
<br>
== Changelog ==
  Changes 200?-??-??:
      - Initial release
<br>
== External Links ==
The original source is from this script posted here: [http://pastebin.com/iWx6a907 Pastebin] - [http://web.archive.org/web/20150113051210/http://pastebin.com/iWx6a907 archived] 

mod for script to use an external dehalo filter and has other features posted here: [http://pastebin.com/ipsPe3PW Pastebin]

The following script is missing FineDehalo2: [http://pastebin.com/raw.php?i=DVhdy6uS Pastebin] - [http://web.archive.org/web/20150113034358/http://pastebin.com/DVhdy6uS archived]
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Dehaloing|External Filters]] &larr;'''
-----------------------------------------------