UnFilter: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
← Older edit

Reel.Deal (talk | contribs)

1 user group
5,521 edits
m 1 revision
make parameter description a bit more compact and add a couple of things
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{FilterCat|Plugins|External_filters|Adjustment_filters|Sharpeners}}
{{FilterCat4|Plugins|External_filters|Adjustment_filters|Sharpeners}}
{{Template:FuncDef|UnFilter(clip source,  int ''HSharp'', int ''VSharp'') }}
{{Filter3
{{Filter
|{{Author/Tom Barry}}
|[http://www.trbarry.com Tom Barry]
|0.0.1.5
|0.0.1.5
|[http://www.trbarry.com/UnFilter.zip UnFilter.zip]
|[{{N2Archived}}/trbarry/UnFilter.zip UnFilter.zip]
|Adjustment filters
|Adjustment filters
|[[YV12]]
|[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|GPL
|6=[http://forum.doom9.org/showthread.php?t=28197 Doom9 Thread]}}
}}
 
== Abstract ==
== Description ==
UnFilter is a simple and reasonably fast Avisynth Soften/Sharpen filter.
UnFilter is a simple and reasonably fast Avisynth Soften/Sharpen filter.


It implements 5-tap user adjustable horizontal and vertical filters designed to  
It implements 5-tap user adjustable horizontal and vertical filters designed to (slightly) reverse previous efforts at softening or edge enhancement that are common (but ugly) in DVD mastering. Since DVDs were intended originally for interlaced displays this has caused content providers to vertically filter them even a bit more to hide interlacing artifacts.  They sometimes overdo the edge enhancement.
(slightly) reverse previous efforts at softening or edge enhancement that are
common (but ugly) in DVD mastering. Since DVDs were intended originally
for interlaced displays this has caused content providers to vertically filter
them even a bit more to hide interlacing artifacts.  They sometimes overdo
the edge enhancement.
 
When softening it will attempt to approximate the inverse of a simple 3-tap edge
enhancement filter. When sharpening it will attempt to approximate the inverse
of a simple 3-tap softening filter.  For the math and logic involved see
the comments in the UnFilterALL.inc member included in zip file.
 
The effects are fairly mild but be aware that excessive sharpening makes things
harder to compress and may bring about the dreaded "edge enhancement artifacts"
the people complain about in DVDs from some studios.  And while excessive
softness may hide noise it loses detail and generally just looks ugly. So it is
probably best to just try to reverse whatever has already been done to your source.
 
UnFilter should run on all MMX machines or higher. It has also has some added code
for 3DNOW instructions for when it is running on a K6-II or higher and some SSEMMX
for P3 & Athlon.
 
==Known issues and limitations==
 
Assumes YUV (YUY2) or YV12 Frame Based input. Use an AVIsynth function to convert first if  needed.       
 
Currently still requires the pixel width to be a multiple of 2.
 
YV12 support for Avisynth 2.5 alpha release only.
 
== Requires Filters ==
[http://www.trbarry.com/UnFilter.zip Unfilter.dll]
 


==Parameters==
When softening it will attempt to approximate the inverse of a simple 3-tap edge enhancement filter. When sharpening it will attempt to approximate the inverse of a simple 3-tap softening filter.  For the math and logic involved see the comments in the UnFilterALL.inc member included in zip file.


{{ParR|HSharp|int|0|-100-100}}
The effects are fairly mild but be aware that excessive sharpening makes things harder to compress and may bring about the dreaded "edge enhancement artifacts" the people complain about in DVDs from some studios. And while excessive softness may hide noise it loses detail and generally just looks ugly. So it is probably best to just try to reverse whatever has already been done to your source.
Horizontal sharpness.  Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).


{{ParR|VSharp|int|0|-100-100}}
UnFilter should run on all [[MMX]] machines or higher. It has also has some added code for 3DNOW instructions for when it is running on a K6-II or higher and some SSEMMX for P3 & Athlon.
Vertical sharpness. Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).
<br>
<br>
== Requirements ==
*AviSynth 2.5.8 or later
* [[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: [[YUY2]], [[YV12]]
*[[MMX]] capable CPU
<br>
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|UnFilter (clip, int, int)}}
<br>
::{{Par| |clip| }}
:::Input clip.
<br>
::{{Par| |int| }}
::{{Par| |int| }}
:::<tt>'''HSharp, VSharp'''</tt>: horizontal and vertical sharpness. Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).


:::'''Note:''' all parameters are unnamed and do not have a default so they must be specified.
<br>
== Examples==  
== Examples==  
 
Extreme sharpening:
Extreme sharpening
  [[AviSource]]("blah.avi")
  LoadPlugin("F:\UnFilter\UnFilter.dll")
  UnFilter(100, 100) # (HSharp, VSharp)
  Avisource("D:\wherever\myfile.avi")
<br>
  UnFilter(100,100)
== Changelog==
 
2003/01/18  V 0.0.1.5  - Use AvisynthPluginInit2
2002/11/25  V 0.0.1.4  - YV12 support - Don't mess with chroma
2002/11/13  V 0.0.1.3  - YV12 support
2002/06/29  V 0.0.1.2  - Fix more brain dead mistakes relating to low parm vals
  2002/06/29  V 0.0.1.1  - Added version info
                          - Fixed bug on UnFilter(30,30)
                          - Fixed bug that might crash MMX machines
2002/06/28  V 0.0.1.0  - Initial test release V 0.1 (had no version info)
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v0.0.1.5
|[http://web.archive.org/web/20111205012101/http://neuron2.net/trbarry/UnFilter.zip UnFilter.zip]
|[http://web.archive.org/web/20050211040116/http://home.comcast.net/~trbarry/UnFilter.zip UnFilter.zip]
|}
<br>
==External Links==
==External Links==
*[http://www.trbarry.com Tom Barry's Avisynth filters]
*[http://web.archive.org/web/20051127014249/http://home.comcast.net/~trbarry/ Tom Barry's homepage] | [{{N2Archived}}/trbarry/trbarry.html Neuron2's mirror]
*[http://forum.doom9.org/showthread.php?s=&threadid=28197&pagenumber=3 Doom9 discussion]
*[http://forum.doom9.org/showthread.php?t=28197 Doom9 discussion]
*[http://avisynth.org.ru/docs/english/externalfilters/unfilter.htm avisynth.org.ru] - UnFilter documentation, [http://avisynth.org.ru/docs/russian/externalfilters/unfilter.htm Russian].
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Sharpeners|External Filters]] &larr;'''

Latest revision as of 14:36, 30 March 2015

Abstract
Author Tom Barry
Version 0.0.1.5
Download UnFilter.zip
Category Adjustment filters
License GPLv2
Discussion Doom9 Thread

Description

UnFilter is a simple and reasonably fast Avisynth Soften/Sharpen filter.

It implements 5-tap user adjustable horizontal and vertical filters designed to (slightly) reverse previous efforts at softening or edge enhancement that are common (but ugly) in DVD mastering. Since DVDs were intended originally for interlaced displays this has caused content providers to vertically filter them even a bit more to hide interlacing artifacts. They sometimes overdo the edge enhancement.

When softening it will attempt to approximate the inverse of a simple 3-tap edge enhancement filter. When sharpening it will attempt to approximate the inverse of a simple 3-tap softening filter. For the math and logic involved see the comments in the UnFilterALL.inc member included in zip file.

The effects are fairly mild but be aware that excessive sharpening makes things harder to compress and may bring about the dreaded "edge enhancement artifacts" the people complain about in DVDs from some studios. And while excessive softness may hide noise it loses detail and generally just looks ugly. So it is probably best to just try to reverse whatever has already been done to your source.

UnFilter should run on all MMX machines or higher. It has also has some added code for 3DNOW instructions for when it is running on a K6-II or higher and some SSEMMX for P3 & Athlon.

Requirements


Syntax and Parameters

UnFilter (clip, int, int)


clip =
Input clip.


int =
int =
HSharp, VSharp: horizontal and vertical sharpness. Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).
Note: all parameters are unnamed and do not have a default so they must be specified.


Examples

Extreme sharpening: 

AviSource("blah.avi")
UnFilter(100, 100) # (HSharp, VSharp)


Changelog

2003/01/18   V 0.0.1.5   - Use AvisynthPluginInit2
2002/11/25   V 0.0.1.4   - YV12 support - Don't mess with chroma
2002/11/13   V 0.0.1.3   - YV12 support
2002/06/29   V 0.0.1.2   - Fix more brain dead mistakes relating to low parm vals
2002/06/29   V 0.0.1.1   - Added version info
                         - Fixed bug on UnFilter(30,30)
                         - Fixed bug that might crash MMX machines
2002/06/28   V 0.0.1.0   - Initial test release V 0.1 (had no version info)


Archived Downloads

Version Download Mirror
v0.0.1.5 UnFilter.zip UnFilter.zip




Back to External Filters ←

Retrieved from "http://www.avisynth.nl/index.php?title=UnFilter&oldid=5495"