View source for DctFilter v0.0.1.5

{{FilterCat|External_filters|Plugins|Other_filters}}
{{Filter3
| {{Author/Tom Barry}}
| v0.0.1.5 
|[https://web.archive.org/web/20200627224103if_/https://files.videohelp.com/u/223002/DctFilter_015.zip DctFilter_015.zip]
| 4=Other filters
| 5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
| 6=[http://forum.doom9.org/showthread.php?t=38539 Doom9 Thread]}}
== Description ==
DctFiler is an experimental filter that, for each 8x8 block, will do a [http://en.wikipedia.org/wiki/Discrete_cosine_transform Discrete Cosine Transform] (DCT), scale down the selected frequency values, and then reverse the process with an Inverse Discrete Cosine Transform (IDCT).


<span style="color:red">'''Note: DctFilter v0.0.1.5 is deprecated. Use the latest [[DctFilter]] by Chikuzen.'''</span>
<br>
<br>

== Requirements ==
* AviSynth 2.5.8 or [http://forum.doom9.org/showthread.php?t=168764 greater]
* Supported color formats: [[YUY2]], [[YV12]]
* Width and height need to be a multiple of 16 ([[Modulo|mod16]])

* [[MMX]], [[ISSE]] or [[SSE2]] capable CPU
<br>
== Known Issues ==
* [http://forum.doom9.org/showthread.php?p=1191185#post1191185 Stripe bug] - both variants are buggy at calculating DC, additional information [http://forum.doom9.org/showthread.php?p=1346201#post1346201 here] and [http://forum.doom9.org/showthread.php?p=1051452#post1051452 here].
<br>
== [[Script variables|Syntax and Parameters]] ==
<br>
=== DctFilter ===
For each 8x8 block it will do a Discrete Cosine Transform (DCT), scale down the selected frequency values, and then reverse the process with an Inverse Discrete Cosine Transform (IDCT).<br>
In the following example the highest frequency components in each row and column will be zeroed while the 2nd highest would be cut in half.
:<code>DctFilter(1,1,1,1,1,1,.5,0)</code>
The row &amp; column parameters are multiplied together to get the scale factor for each of the 64 values in a block. So if the top left value was V[0,0] then in the example above the we would scale row 6, col 6 (V[6,6]) by .5 * .5 = .25.<br/>
Note that while they look like floating point parameters above they really now only
have 3 bit accuracy so the only actual values used are 0, {{Frac|1|8}}, {{Frac|1|4}}, {{Frac|3|8}} ... 1.0. But you can specify any value and it will be rounded to the nearest one.
<br>
<br>
:{{Template:FuncDef|DctFilter (clip, float, float, float, float, float, float, float, float, int "chroma", int "fdct", int "idct", int "offx", int "offy")}}
<br>
::{{Par2| |clip| }}
:::Input clip.

::{{Par2| |float| }}
:::There are 8 positional floating point parameters, all of which must be specified as in the range (0.0 <= x <= 1.0). These correspond to scaling factors for the 8 rows and columns of the 8x8 DCT blocks.
:::The leftmost parameter corresponds to the top row, left column. This would be the DC component of the transform and should always be left as 1.0.

::{{Par2|chroma|int|1}}
:::Chroma processing:
::::*0 : do not process nor copy, output will be trash
::::*1 : process

::{{Par2|fdct|int|-1}}
::{{Par2|idct|int|-1}}
:::Choose which DCT to use (if you want to compare). Do not use fdct=2 or idct=3, it may crash!

::::*-1 : default
::::*0 : integer (does not work correctly)
::::*1 : [[MMX]]
::::*2 : [[iSSE]]
::::*3 : [[SSE2]]

::{{Par2|offx|int|0}}
::{{Par2|offy|int|0}}
:::Specify offsets, only use when the input clip's dimensions are mod16, otherwise it may crash.
<br>
::<span style="color:red">'''Note:'''</span> the first 9 parameters are unnamed and do not have a default so they must be specified. The last 5 parameters are only available in <tt>DctFilter v0.0.1.5</tt>, consider them as experimental so use with caution (except for {{Template:FuncDef3|chroma}}).
<br>
-------------
<br>

=== DctFilterD ===
DctFilterD works similar to DctFilter but will zero out DiagCt number of the lower right diagonals of the DCT, leaving other values unchanged. <br/>
In an 8x8 DCT result matrix there are 15 possible diagonals (visualize a chess board), so if you specify <code>DctFilterD(4)</code> then the 4 diagonals in the lower right corner of the DCT result will be set to 0. <br/>I haven't tested this much but, like my results with custom quant tables, it appears if you set DiagCt very large you will start to get edge noise, something like ringing.[http://forum.doom9.org/showpost.php?p=266216&postcount=145]
<br>
<br>
:{{Template:FuncDef|DctFilterD (clip, int)}}
<br>
::{{Par2| |clip| }}
:::Input clip.

::{{Par2| |int| }}
:::<tt>'''DiagCt'''</tt>: must be an integer from 1-14 saying how many of these diagonals must be zeroed, starting from the lower right hand corner.

:::'''Note:''' all parameters are unnamed and do not have a default so they must be specified.
<br>
-------------
<br>
=== DctAddConstant ===
Not much is known about this filter...
<br/>
<br/>
:{{Template:FuncDef|DctAddConstant (clip, float, float, float, float)}}
<br>
::{{Par2| |clip| }}
:::Input clip.

::{{Par2| |float| }}
::{{Par2| |float| }}
::{{Par2| |float| }}
::{{Par2| |float| }}

:::'''Note:''' all parameters are unnamed and do not have a default so they must be specified.
<br>

== Examples == 
====DctFilter====
The following example should effectively do nothing, due to a possible bug that's not the case.[http://forum.doom9.org/showthread.php?p=1191208#post1191208]
 [[AviSource]]("blah.avi")
 DctFilter(1,1,1,1,1,1,1,1)
<br> 
Subtle softening:
 DctFilter(1,1,1,1,1,0.75,0.25,0) 
<br>
Remove high frequency components:[http://forum.doom9.org/showpost.php?p=298519&postcount=31]
 DctFilter(1,1,1,.8,.4,0,0,0) #these settings may be prone to slight blocking
<br>
Measure luma variance within block (e.g. 8x8) of pixels?[http://forum.doom9.org/showthread.php?p=1689130#post1689130]<br/>
The easiest somewhat correct "amount of variation for each block" you can get is using STD for each pixel and applying DctFilter to it (adjust the radius of STD calculation area for possibly better results).
 mt_luts(last, "std", mt_square(1), "y").mt_lut("x 15 *")
 DctFilter(1,0,0,0,0,0,0,0).[[GreyScale|Greyscale]]()
A reasonably close approximation with a lot better performance is an edge mask:
 mt_edge("min/max", 0, 255, 0, 255).mt_lut("x 5 *")
 DctFilter(1,0,0,0,0,0,0,0).[[GreyScale|Greyscale]]()
<br>
====DctFilterD====
DctFilterD can be used as a fast way to average 8x8 blocks:[http://forum.doom9.org/showthread.php?p=1051452#post1051452]
 DCTFilterD(14)<br/>
 #DctFilter(1,0,0,0,0,0,0,0)  #keeps the topmost line and leftmost row.[http://forum.doom9.org/showthread.php?p=626365#post626365]
<br>
Very easy way to get the normalized SAD over 8x8 blocks:[http://forum.doom9.org/showthread.php?t=150923]
 mt_lutxy(clip1,clip2,"x y - abs")
 DctFilterD(14)
<br>

== Changelog ==
 Version      Date            Developer       Changes<br>
 v0.0.1.5     2007/02/09      foxyshadis      - Better memory management in DctFilter, chroma=0 to disable chroma.
 v0.0.1.4     2003/02/21      Tom Barry       - Add DctFilterD, diagonal support
 v0.0.1.3     2003/01/30      Tom Barry       - Avisynth 2.5 beta, plugininit2, vs6
 v0.0.1.2     2002/11/2?      SansGrip        - YUY2 support
 v ?          2002/11/25      Tom Barry       - Initial test release for Avisynth 2.5 alpha only
<br>

== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
!!width="150px"| Mirror 2
|-
!v0.0.1.5
|[https://web.archive.org/web/20200627224103if_/https://files.videohelp.com/u/223002/DctFilter_015.zip DctFilter_015.zip]
|
|-
!v0.0.1.4
|[http://web.archive.org/web/20130207143129if_/http://neuron2.net/trbarry/DctFilter.zip DctFilter.zip]
|[http://www.avisynth.nl/users/warpenterprises/files/dctfilter_5F25_dll_20030221.zip dctfilter_dll_20030221.zip]
|
|}
<br>

== External Links ==
*[http://www.aquilinestudios.org/avsfilters/spatial.html#dct AquilineStudios] - Additional information on usage.
*[http://forum.doom9.org/showthread.php?p=763059#post763059 Doom9Forum] - Another advanced usage example.
*[http://forum.doom9.org/showthread.php?t=38539 Doom9 Forum] - Original DctFilter discussion.
*[http://forum.doom9.org/showthread.php?p=951432#post951432 Doom9 Forum] - DctFilter v0.0.1.5 discussion.
*[http://forum.doom9.org/showthread.php?t=171039 Doom9 Forum] - DctFilter VapourSynth port.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Edge_Detection|External Filters]] &larr;'''
<!-- <pre>
DCTFilter(v1,v2,v3,v4,v5,v6,v7,v8) then:

       0     1     2     3     4     5     6     7 
    ┌─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┐
 0  │v1*v1│v2*v1│v3*v1│v4*v1│v5*v1│v6*v1│v7*v1│v8*v1│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 1  │v1*v2│v2*v2│v3*v2│v4*v2│v5*v2│v6*v2│v7*v2│v8*v2│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 2  │v1*v3│v2*v3│v3*v3│v4*v3│v5*v3│v6*v3│v7*v3│v8*v3│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 3  │v1*v4│v2*v4│v3*v4│v4*v4│v5*v4│v6*v4│v7*v4│v8*v4│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 4  │v1*v5│v2*v5│v3*v5│v4*v5│v5*v5│v6*v5│v7*v5│v8*v5│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 5  │v1*v6│v2*v6│v3*v6│v4*v6│v5*v6│v6*v6│v7*v6│v8*v6│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 6  │v1*v7│v2*v7│v3*v7│v4*v7│v5*v7│v6*v7│v7*v7│v8*v7│
    ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
 7  │v1*v8│v2*v8│v3*v8│v4*v8│v5*v8│v6*v8│v7*v8│v8*v8│
    └─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘


so DctFilter(1,1,1,1,1,1,.5,0) becomes:

    ┌───┬───┬───┬───┬───┬───┬───┬───┐
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 1 │ 1 │ 1 │ 1 │ 1 │ 1 │0.5│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │0.5│0.5│0.5│0.5│0.5│0.5│.25│ 0 │
    ├───┼───┼───┼───┼───┼───┼───┼───┤
    │ 0 │ 0 │ 0 │ 0 │ 0 │ 0 │ 0 │ 0 │
    └───┴───┴───┴───┴───┴───┴───┴───┘ 
</pre>
In the example above the highest frequency components in each row and column are zeroed while the 2nd highest are cut in half.<br>
The row &amp; column parameters are multiplied together to get the scale factor for each of the 64 values in a block. So if the top left value was V[0,0] then in the example above the we would scale row 6, col 6 (V[6,6]) by .5 * .5 = .25.<br/>
Note that while they look like floating point parameters above they really now only
have 3 bit accuracy so the only actual values used are 0, {{Frac|1|8}}, {{Frac|1|4}}, {{Frac|3|8}} ... 1.0. But you can specify any value and it will be rounded to the nearest one.
-->