BlindDeHalo3 - Revision history

Reel.Deal: update link

2022-12-26T21:53:50Z

update link

Reel.Deal: minor edits

2015-02-22T04:59:51Z

minor edits

Reel.Deal: /* External Links */

2014-09-21T20:51:21Z

‎External Links

Reel.Deal: minor reformatting, category

2014-09-20T14:01:59Z

minor reformatting, category

Reel.Deal: /* Syntax and Parameters */

2014-09-08T02:13:24Z

‎Syntax and Parameters

Reel.Deal: /* Syntax and Parameters */ minor

2014-09-08T02:04:01Z

‎Syntax and Parameters: minor

Reel.Deal: reformat

2014-09-08T01:58:35Z

reformat

Reel.Deal: /* Changelog */

2014-02-02T02:30:23Z

‎Changelog

Reel.Deal: /* Changelog */

2014-02-02T02:18:28Z

‎Changelog

Reel.Deal: /* Requirements: */

2014-01-27T15:53:03Z

‎Requirements:

@@ Line 1: / Line 1: @@
 {{FilterCat4|External_filters|Scripts|Restoration_filters|Dehalo}}
 {{Filter3
-|{{Author/Didée}}
+|1={{Author/Didée}}
-|3_MT2
+|2=3_MT2
-|[http://home.arcor.de/dhanselmann/_stuff/BlindDeHalo3_MT2.zip BlindDeHalo3_MT2.zip]
+|3=[https://forum.doom9.org/attachment.php?attachmentid=5599&d=1143030001 BlindDeHalo3_MT2.zip]
-|Dehalo
+|4=Dehalo
+|5=
 |6=[http://forum.doom9.org/showthread.php?t=74003 Doom9 Thread]}}
 == Description ==

@@ Line 7: / Line 7: @@
+|
 |6=[http://forum.doom9.org/showthread.php?t=74003 Doom9 Thread]}}
 == Description ==
 This script removes the light & dark halos from too strong "Edge Enhancement".<br>
@@ Line 14: / Line 13: @@
 * AviSynth 2.5.8 or later
 * Supported color formats: [[YV12]]
-<br>
-==== Required Plugins ====
+=== Required Plugins ===
-*[[MaskTools2]] 2.0a48+
+Latest versions of the following filters are recommended unless stated otherwise.<br>
-*[[RemoveGrain v1.0b/RemoveGrain|RemoveGrain]] - part of the [[RemoveGrain v1.0b]] package.
+*[[MaskTools2]]
 <br>

@@ Line 122: / Line 122: @@
 == External Links ==
 *[http://forum.doom9.org/showthread.php?t=74003 Doom9 Forum] - BlindDeHalo Discussion.
 <br>
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Dehaloing|External Filters]] &larr;'''

@@ Line 1: / Line 1: @@
-{{FilterCat|External_filters|Restoration_filters|Dehalo}}
+{{FilterCat4|External_filters|Scripts|Restoration_filters|Dehalo}}
 {{Filter3
 |{{Author/Didée}}
@@ Line 9: / Line 9: @@
 <br>
 == Description ==
-:This script removes the light & dark halos from too strong "Edge Enhancement".
+This script removes the light & dark halos from too strong "Edge Enhancement".<br>
 <br>
 == Requirements ==
-:- AviSynth 2.5.8 or later
+* AviSynth 2.5.8 or later
-:- Supported color formats: [[YV12]]
+* Supported color formats: [[YV12]]
+<br>
 ==== Required Plugins ====
-:*[[MaskTools2]] 2.0a48+
+*[[MaskTools2]] 2.0a48+
-:*[[RemoveGrain v1.0b/RemoveGrain|RemoveGrain]] - part of the [[RemoveGrain v1.0b]] package.
+*[[RemoveGrain v1.0b/RemoveGrain|RemoveGrain]] - part of the [[RemoveGrain v1.0b]] package.
 <br>
@@ Line 76: / Line 76: @@
 Additional information for optimal usage. Written by [http://forum.doom9.org/showpost.php?p=622289&postcount=70 Didée]
 <br>
-:*'''Regarding "strength" & "sharpness" & "tweaker"'''
+*'''Regarding "strength" & "sharpness" & "tweaker"'''
-::These three behave somewhat similar, but not the same. A bigger value for "sharpness" is similar to reducing "strength". A bigger value for "tweaker" is similar to increasing "strength" value -- and vice versa for both. Also the other way round: when increasing "sharpness", you probably have to increase "strength" a little as well, to get the same removal effect. Usage of "sharpness" works in particular good when bigger radii (say, >2.5) are used for dehaloing. Usage of "tweaker" is more useful when working with sources containing thin, weak halos. In the end, it comes down again to trial & error.
+:These three behave somewhat similar, but not the same.
-:*'''Lodamp and Hidamp'''
+:"hidamp" tries to do the opposite: protect small detail that is very bright or very dark from being toned down too much. But its usability is much more restricted: it seems to work OK when the actual halos of the source are rather weak, and/or when not too small radii are used - in this case, the protection of very prominent detail works out, mostly. In case the source contains strong haloing, it's better to not use "hidamp" at all: in this case, the halos itself would be considered to be "prominent detail" and be protected ... no go.
-::Technically, these two are the "n" constants in two scaling factors of the form "x/(x+n)", which are used when creating a LUT from the difference between input clip and its Gaussian blurred version. As described above, "lodamp" deals for better protection of areas where this difference is already small. Effectively, it preserves some more of weak detail in areas of high contrast. A value of 4.0 seems a good starting point. One can also try to use bigger values like 16.0 or so, along with a bigger "strength" value. By this, one can somewhat change the characteristics of "what-is-processed-how-strongly". "hidamp" tries to do the opposite: protect small detail that is very bright or very dark from being toned down too much. But its usability is much more restricted: it seems to work OK when the actual halos of the source are rather weak, and/or when not too small radii are used - in this case, the protection of very prominent detail works out, mostly. In case the source contains strong haloing, it's better to not use "hidamp" at all: in this case, the halos itself would be considered to be "prominent detail" and be protected ... no go.
 <br>

@@ Line 23: / Line 23: @@
 :{|
 |-
-|{{Template:FuncDef|BlindDeHalo3 }}
+| {{Template:FuncDef|BlindDeHalo3}}
 |{{Template:FuncDef|(''clip'' clp, ''float'' "rx", ''float'' "ry", ''int'' "strength", ''float'' "lodamp", ''float'' "hidamp", ''float'' "sharpness", ''float'' "tweaker", ''int'' "PPmode", ''int'' "PPlimit", ''bool'' "interlaced")}}
 |}

@@ Line 21: / Line 21: @@
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|BlindDeHalo3 (''clip'' clp, ''float'' "rx", ''float'' "ry", ''int'' "strength", ''float'' "lodamp", ''float'' "hidamp", ''float'' "sharpness", ''float'' "tweaker", ''int'' "PPmode", ''int'' "PPlimit", ''bool'' "interlaced")}}
+:{|
 <br>
 ::{{Par2|clp|clip| }}
@@ Line 67: / Line 71: @@
 :::I'm not sure if this makes much sense in this context. However the option is there - you never know what it might be good for.
 <br>
 == Comments & Tips ==
 Additional information for optimal usage. Written by [http://forum.doom9.org/showpost.php?p=622289&postcount=70 Didée]

@@ Line 1: / Line 1: @@
 {{FilterCat|External_filters|Restoration_filters|Dehalo}}
-{{Filter
+{{Filter3
 |{{Author/Didée}}
 |3_MT2
-|[http://home.arcor.de/dhanselmann/_stuff/BlindDeHalo3_MT2.zip BlindDeHalo3_MT2]
+|[http://home.arcor.de/dhanselmann/_stuff/BlindDeHalo3_MT2.zip BlindDeHalo3_MT2.zip]
 |Dehalo
+|
-|}}
+|6=[http://forum.doom9.org/showthread.php?t=74003 Doom9 Thread]}}
 <br>
 == Description ==
@@ Line 16: / Line 15: @@
 :- Supported color formats: [[YV12]]
-==== Required Plugins: ====
+==== Required Plugins ====
 :*[[MaskTools2]] 2.0a48+
 :*[[RemoveGrain v1.0b/RemoveGrain|RemoveGrain]] - part of the [[RemoveGrain v1.0b]] package.
 <br>
-== Syntax and Parameters ==
+== [[Script variables|Syntax and Parameters]] ==
 :{{Template:FuncDef|BlindDeHalo3 (''clip'' clp, ''float'' "rx", ''float'' "ry", ''int'' "strength", ''float'' "lodamp", ''float'' "hidamp", ''float'' "sharpness", ''float'' "tweaker", ''int'' "PPmode", ''int'' "PPlimit", ''bool'' "interlaced")}}
 <br>
@@ Line 36: / Line 35: @@
 ::{{Par2|lodamp|float|0.0}}
 ::{{Par2|hidamp|float|0.0}}
-:::Range: 0.0 - ??? (try 4.0 as a start)
+:::With these two values, one can reduce the basic effect on areas that would change only little anyway ({{Template:FuncDef|lodamp}}), and/or on areas that would change very much ({{Template:FuncDef|hidamp}}).
-::::With these two values, one can reduce the basic effect on areas that would change only little anyway ({{Template:FuncDef|lodamp}}), and/or on areas that would change very much ({{Template:FuncDef|hidamp}}).
+:::{{Template:FuncDef|lodamp}} does a reasonable job in keeping more detail in affected areas. {{Template:FuncDef|hidamp}} is intended to keep rather small areas that are very bright or very dark from getting processed too strong.
-::::{{Template:FuncDef|lodamp}} does a reasonable job in keeping more detail in affected areas.
+:::Works OK on sources that contain only weak haloing - for sources with strong over sharpening, it should not be used, mostly. (Usage has zero impact on speed.)
-::::{{Template:FuncDef|hidamp}} is intended to keep rather small areas that are very bright or very dark from getting processed too strong.
-::::Works OK on sources that contain only weak haloing - for sources with strong over sharpening, it should not be used, mostly.
+:::*Range: 0.0 to ??? (try 4.0 as a start)
-::::(Usage has zero impact on speed.)
 <br>
 ::{{Par2|sharpness|float|0.0}}
-:::Range: 0.0 - 1.58
+:::By setting this bigger than 0.0, the affected areas will come out with better sharpness. However, strength must be chosen somewhat bigger as well, then, to get the same effect than without.
-::::By setting this bigger than 0.0, the affected areas will come out with better sharpness.
+:::(This is the same as initial version's "maskblur" option.)
-::::However, strength must be chosen somewhat bigger as well, then, to get the same effect than without.
-::::(This is the same as initial version's "maskblur" option.)
+:::*Range: 0.0 to 1.58
 <br>
 ::{{Par2|tweaker|float|0.0}}
-:::Range: 0.0 - 1.00
+:::May be used to get a stronger effect, separately from altering "strength". (Also in accordance to initial version's working methodology. I had no better idea for naming this parameter.)
-::::May be used to get a stronger effect, separately from altering "strength".
-::::(Also in accordance to initial version's working methodology. I had no better idea for naming this parameter.)
+:::*Range: 0.0 - 1.00
 <br>
 ::{{Par2|interlaced|bool|false}}
-::::As formerly, this is intended for sources that were originally interlaced, but then made progressive by deinterlacing.
+:::As formerly, this is intended for sources that were originally interlaced, but then made progressive by deinterlacing. It aims in particular at clips that made their way through [[Restore24]].
-::::It aims in particular at clips that made their way through [[Restore24]].
 <br>
 ::{{Par2|PPmode|int|0}}
-::::When set to "1" or "2", a second cleaning operation after the basic halo removal is done. This deals with:
+:::When set to "1" or "2", a second cleaning operation after the basic halo removal is done. This deals with:
-:::::a) Removing/reducing those corona lines that sometimes are left over by BlindDeHalo
+::::a) Removing/reducing those corona lines that sometimes are left over by BlindDeHalo
-:::::b) Improving on mosquito noise, if some is present.
+::::b) Improving on mosquito noise, if some is present.
 :::{{Template:FuncDef|PPmode}}=1 uses a simple Gaussian blur for post-cleaning. {{Template:FuncDef|PPmode}}=2 uses a 3*3 average, with zero weighting of the center pixel.
-::::{{Template:FuncDef|PPmode}}=1 uses a simple Gaussian blur for post-cleaning.
+:::Also, {{Template:FuncDef|PPmode}} can be "-1" or "-2". In this case, the main dehaloing step is completely discarded, and *only* the PP cleaning is done.
-::::{{Template:FuncDef|PPmode}}=2 uses a 3*3 average, with zero weighting of the center pixel.
+:::This has less effect on halos, but can deal for sources containing more mosquito noise than halos.
-−
-::::Also, {{Template:FuncDef|PPmode}} can be "-1" or "-2". In this case, the main dehaloing step is completely discarded, and *only* the PP cleaning is done.
-::::This has less effect on halos, but can deal for sources containing more mosquito noise than halos.
 <br>
 ::{{Par2|PPlimit|int|0}}
@@ Line 73: / Line 67: @@
 :::I'm not sure if this makes much sense in this context. However the option is there - you never know what it might be good for.
 <br>
 == Comments & Tips ==
-:Additional information for optimal usage. Written by [http://forum.doom9.org/showpost.php?p=622289&postcount=70 Didée]
+Additional information for optimal usage. Written by [http://forum.doom9.org/showpost.php?p=622289&postcount=70 Didée]
 <br>
 :*'''Regarding "strength" & "sharpness" & "tweaker"'''
-::These three behave somewhat similar, but not the same.
+::These three behave somewhat similar, but not the same. A bigger value for "sharpness" is similar to reducing "strength". A bigger value for "tweaker" is similar to increasing "strength" value -- and vice versa for both. Also the other way round: when increasing "sharpness", you probably have to increase "strength" a little as well, to get the same removal effect. Usage of "sharpness" works in particular good when bigger radii (say, >2.5) are used for dehaloing. Usage of "tweaker" is more useful when working with sources containing thin, weak halos. In the end, it comes down again to trial & error.
-::A bigger value for "sharpness" is similar to reducing "strength".
-::A bigger value for "tweaker" is similar to increasing "strength" value -- and vice versa for both.
+:*'''Lodamp and Hidamp'''
-::Also the other way round: when increasing "sharpness", you probably have to increase "strength" a little as well, to get the same removal effect.
+::Technically, these two are the "n" constants in two scaling factors of the form "x/(x+n)", which are used when creating a LUT from the difference between input clip and its Gaussian blurred version. As described above, "lodamp" deals for better protection of areas where this difference is already small. Effectively, it preserves some more of weak detail in areas of high contrast. A value of 4.0 seems a good starting point. One can also try to use bigger values like 16.0 or so, along with a bigger "strength" value. By this, one can somewhat change the characteristics of "what-is-processed-how-strongly". "hidamp" tries to do the opposite: protect small detail that is very bright or very dark from being toned down too much. But its usability is much more restricted: it seems to work OK when the actual halos of the source are rather weak, and/or when not too small radii are used - in this case, the protection of very prominent detail works out, mostly. In case the source contains strong haloing, it's better to not use "hidamp" at all: in this case, the halos itself would be considered to be "prominent detail" and be protected ... no go.
-::Usage of "sharpness" works in particular good when bigger radii (say, >2.5) are used for dehaloing.
-::Usage of "tweaker" is more useful when working with sources containing thin, weak halos.
-::In the end, it comes down again to trial & error.
 <br>
 == Examples ==
 Full function call with default values:

@@ Line 123: / Line 123: @@
                                  - The "PP" modes, which act somewhat similar to [[HQDering]] ...
                                    ... where "PP" < 0 runs *only* these routines, without the main dehaloing one<br>
-  [http://forum.doom9.org/showpost.php?p=579853&postcount=16 2]           2004-12-10     - BlindDeHalo2
+  [http://forum.doom9.org/showpost.php?p=579853&postcount=16 2]           2004/12/10     - BlindDeHalo2
                                - Added interlaced parameter
                                - Changed rx, ry, and strength default
                                - Removed parameters<br>
-  [http://forum.doom9.org/showpost.php?p=471158&postcount=1 v0.1]        2004-04-07     - BlindDeHalo
+  [http://forum.doom9.org/showpost.php?p=471158&postcount=1 v0.1]        2004/04/07     - BlindDeHalo
                                - Initial release
 <br>

@@ Line 111: / Line 111: @@
 == Changelog ==
-  Changes [http://forum.doom9.org/showpost.php?p=803275&postcount=82 2006-03-22:]
+ Version      Date            Changes<br>
-     - BlindDeHalo3_MT2
+ [http://forum.doom9.org/showpost.php?p=803275&postcount=82 3MT2]        2006/03/22     - BlindDeHalo3_MT2
-      - Changed syntax to use [[MaskTools2]]
+                              - Changed syntax to use MaskTools2
-      - Replaced some things with RemoveGrain-modes ([[RemoveGrain]].dll newer than v0.9 required)
+                              - Replaced some things with RemoveGrain-modes (RemoveGrain.dll newer than v0.9 required)
-      - Fixed some oddities
+                              - Fixed some oddities
-      - New PPmode (3 and -3): shouldn't blur, but still remove mosquitos and leftover halo borders<br>
+                              - New PPmode (3 and -3): shouldn't blur, but still remove mosquitos and leftover halo borders<br>
-  Changes [http://forum.doom9.org/showpost.php?p=622289&postcount=70 2005-03-09:]
+ [http://forum.doom9.org/showpost.php?p=622289&postcount=70 3]           2005/03/09     - BlindDeHalo3
-     - BlindDeHalo3
+                              - [http://forum.doom9.org/showpost.php?p=737387&postcount=32 Added parameters]
-      - [http://forum.doom9.org/showpost.php?p=737387&postcount=32 Added parameters]
+                                - "sharpness" parameter (and "tweak" counterpart)
-          - "sharpness" parameter (and "tweak" counterpart)
+                                - "lodamp" (and "hidamp" (!) ) parameter
-          - "lodamp" (and "hidamp" (!) ) parameter
+                                - The "PP" modes, which act somewhat similar to [[HQDering]] ...
-          - The "PP" modes, which act somewhat similar to HQdering ...
+                                  ... where "PP" < 0 runs *only* these routines, without the main dehaloing one<br>
-          - ... where "PP" < 0 runs *only* these routines, without the main dehaloing one<br>
+ [http://forum.doom9.org/showpost.php?p=579853&postcount=16 2]           2004-12-10     - BlindDeHalo2
-  Changes [http://forum.doom9.org/showpost.php?p=579853&postcount=16 2004-12-10:]
+                              - Added interlaced parameter
-     - BlindDeHalo2
+                              - Changed rx, ry, and strength default
-      - Added interlaced parameter
+                              - Removed parameters<br>
-      - Changed rx, ry, and strength default
+ [http://forum.doom9.org/showpost.php?p=471158&postcount=1 v0.1]        2004-04-07     - BlindDeHalo
-      - Removed parameters<br>
+                              - Initial release
-  Changes [http://forum.doom9.org/showpost.php?p=471158&postcount=1 2004-04-07:]
-     - BlindDeHalo1
-      - Initial release
 <br>