Dering - Revision history

Reel.Deal: add x64 category

2022-11-16T16:30:35Z

add x64 category

Reel.Deal: doc update and link to working plugin

2022-11-16T16:27:35Z

doc update and link to working plugin

Reel.Deal: Dering documentation

2021-03-28T00:44:03Z

Dering documentation

New page

{{FilterCat4|External_filters|Plugins|Restoration_filters|Deringing & Mosquito Noise}}
{{Filter3
|1=[https://sourceforge.net/u/alexrayne/profile/ alexrayne]
|2=Release 4
|3=[https://sourceforge.net/projects/avisynth-dering/ deringing-sample.zip]
|4=Deringing & Mosquito Noise
|5=[https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html LGPLv2.1]
|6=
}}

== Description ==
This plugin removes halo\ringing occurred after sharp edges on VHS captured video
 
 
'''Note:''' [[Dering]] is a C-plugin so it must be loaded using [[Plugins#LoadCPlugin|LoadCPlugin]], except if you're using AviSynth+, it allows autoloading of C-plugins.
 
 
== Requirements ==
* [x86] [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
* Supported color formats: [[YUY2]], [[YV12]]
 

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|Dering (clip src, float "A", float "W", float "RelVisibleTh", float "AbsVisibleTh", int "PostFilterArea", string "PostFilter", float "Dump", int "Edges", string "PreFilter", bool "SkipAlonePeaks", bool "UseEmphasis", string "OutPlane")}}
 
::{{Par2| |clip| }}
:::Input clip; must be YUY2 or YV12.
 
::{{Par2|A|float|0.3}}
:::Ringing amplitude relative to edge size.
 
::{{Par2|W|float|0.35}}
:::Ringing frequency - distance between ringing peaks.
 
::{{Par2|RelVisibleTh|float|0.005}}
:::Value of (ringing amplitude)/(steady signal value).
:::If detected amplitude < VisibleTh, this ringing area skip from correction.
:::Range 0.0 to 1.0
 
::{{Par2|AbsVisibleTh|float|0.01}}
:::Value of (ringing amplitude)/(full dynamic luma range = 255).
:::If detected amplitude < VisibleTh, this ringing area skip from correction.
:::Range 0.0 to 1.0
 
::{{Par2|PostFilterArea|int|1000}}
:::Limit of filtering area length on ringing.
 
::{{Par2|PostFilter|string|"median"}}
:::Type of smoothing post filter applied after deringing:
:::*"median" - median filter y=(2*x[n]-x[n-1]-x[n+1])/2
:::*"median2" - 2nd order median filter y=(2*x[n]-x[n-1]-x[n+1])/2
:::*"backiir" - back direction IIR2 filter (see D parameter)
:::*"iir" - forward direction IIR2 filter (see D parameter)
 
::{{Par2|Dump|float|0.3}}
:::Dumping of PostFilter.
 
::{{Par2|Edges|int|0}}
:::Which polarity of edges to process: 0 - both, <0 - falling only, >0 rising only.
 
::{{Par2|PreFilter|string|"FIR2"}}
:::Type of main deringer filter:
:::*"FIR2" - ordinary fir2 filter
:::*"deltaFIR" - compensator by pre-rendered ringing G-respondents
:::*Any other use FIR2 on resampled x2 inputs
 
::{{Par2|SkipAlonePeaks|bool|true}}
:::Alone peaks can be lost unfiltered if true, or filter as usual peak if false.
 
::{{Par2|UseEmphasis|bool|false}}
:::If true, it tries to enhance the front edge when the deltaFIR filter is used.
 
::{{Par2|OutPlane|string|"filter"}}
:::Type of output:
:::*"filter'" - filtered image
:::*"AllPeaks" - detected peaks in input image
:::*"Peaks" - peaks in image selected for filtering
 

== Examples ==
Dering with default settings:
[[AviSource]]("Blah.avi")
Dering(A=0.3, W=0.35, RelVisibleTh=0.005, AbsVisibleTh=0.01, PostFilterArea=1000, PostFilter="median", \
Dump=0.3, Edges=0, PreFilter="FIR2", SkipAlonePeaks=true, UseEmphasis=false, OutPlane="filtered")
 

==External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Deringing_.26_Mosquito_Noise|External Filters]] ←'''

@@ Line 1: / Line 1: @@
-{{FilterCat4|External_filters|Plugins|Restoration_filters|Deringing & Mosquito Noise}}
+{{FilterCat5|External_filters|Plugins|Plugins_x64|Restoration_filters|Deringing & Mosquito Noise}}
 {{Filter3
 |1=[https://sourceforge.net/u/alexrayne/profile/ alexrayne]

@@ Line 3: / Line 3: @@
 |1=[https://sourceforge.net/u/alexrayne/profile/ alexrayne]
 |2=Release 4
-|3=[https://sourceforge.net/projects/avisynth-dering/ deringing-sample.zip]
+|3=[https://files.videohelp.com/u/223002/dering_32_64.7z dering_32_64.7z]
 |4=Deringing & Mosquito Noise
 |5=[https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html LGPLv2.1]
-|6=
+|6=[https://forum.doom9.org/showthread.php?t=184570 Doom9 Forum]
 }}
 == Description ==
-This plugin removes halo\ringing occurred after sharp edges on VHS captured video
+This plugin removes halo\ringing occurred after sharp edges on VHS captured video.
 <br>
 <br>
@@ Line 17: / Line 17: @@
 <br>
 == Requirements ==
-* [x86] [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
+* [x86] [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0] - <span style="color:red">'''Note:'''</span> does not work for 32-bit AviSynth+.
 * Supported color formats: [[YUY2]], [[YV12]]
 <br>
@@ Line 26: / Line 27: @@
 ::{{Par2| |clip| }}
 :::Input clip; must be YUY2 or YV12.
 <br>
 ::{{Par2|A|float|0.3}}
-:::Ringing amplitude relative to edge size.
+:::Ringing amplitude relative to edge size. Must be < 1.0
 <br>
-::{{Par2|W|float|0.35}}
+::{{Par2|W|float|3.5}}
-:::Ringing frequency - distance between ringing peaks.
+:::Ringing frequency - distance between ringing peaks. Must be >= 1.5
 <br>
-::{{Par2|RelVisibleTh|float|0.005}}
+::{{Par2|RelVisibleTh|float|0.01}}
 :::Value of (ringing amplitude)/(steady signal value).
 :::If detected amplitude < VisibleTh, this ringing area skip from correction.
 :::Range 0.0 to 1.0
 <br>
-::{{Par2|AbsVisibleTh|float|0.01}}
+::{{Par2|AbsVisibleTh|float|0.005}}
 :::Value of (ringing amplitude)/(full dynamic luma range = 255).
 :::If detected amplitude < VisibleTh, this ringing area skip from correction.
@@ Line 45: / Line 47: @@
 ::{{Par2|PostFilterArea|int|1000}}
 :::Limit of filtering area length on ringing.
 <br>
-::{{Par2|PostFilter|string|"median"}}
+::{{Par2|PostFilter|string|"median2"}}
 :::Type of smoothing post filter applied after deringing:
 :::*"median" - median filter y=(2*x[n]-x[n-1]-x[n+1])/2
 :::*"median2" - 2nd order median filter y=(2*x[n]-x[n-1]-x[n+1])/2
 :::*"backiir" - back direction IIR2 filter (see D parameter)
 <br>
 ::{{Par2|Dump|float|0.3}}
 :::Dumping of PostFilter.
 <br>
 ::{{Par2|Edges|int|0}}
 :::Which polarity of edges to process: 0 - both, <0 - falling only, >0 rising only.
 <br>
 ::{{Par2|PreFilter|string|"FIR2"}}
@@ Line 63: / Line 67: @@
 :::*"FIR2" - ordinary fir2 filter
 :::*"deltaFIR" - compensator by pre-rendered ringing G-respondents
-:::*Any other use FIR2 on resampled x2 inputs
+:::*Any other name uses FIR2 on resampled x2 inputs
 <br>
 ::{{Par2|SkipAlonePeaks|bool|true}}
@@ Line 70: / Line 74: @@
 ::{{Par2|UseEmphasis|bool|false}}
 :::If true, it tries to enhance the front edge when the deltaFIR filter is used.
 <br>
-::{{Par2|OutPlane|string|"filter"}}
+::{{Par2|OutPlane|string|"filtered"}}
 :::Type of output:
-:::*"filter'" - filtered image
+:::*"filtered" - filtered image
 :::*"AllPeaks" - detected peaks in input image
 :::*"Peaks"   - peaks in image selected for filtering
 <br>
@@ Line 81: / Line 87: @@
 Dering with default settings:
   [[AviSource]]("Blah.avi")
-  Dering(A=0.3, W=0.35, RelVisibleTh=0.005, AbsVisibleTh=0.01, PostFilterArea=1000, PostFilter="median", \
+  Dering(last, A=0.3, W=3.5, RelVisibleTh=0.01, AbsVisibleTh=0.005, \
-         Dump=0.3, Edges=0, PreFilter="FIR2", SkipAlonePeaks=true, UseEmphasis=false, OutPlane="filtered")
+        PostFilter="median2", PreFilter="FIR2", SkipAlonePeaks=true)
 <br>