Blur: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
← Older editNewer edit →

Raffriff42 (talk | contribs)

3,315 edits
Raffriff42 (talk | contribs)
3,315 edits
m added category
Raffriff42 (talk | contribs)
3,315 edits
formatting, links, phrasing *** see talk page ***
Line 1: Line 1:
{{Template:Func4Def|Blur(clip ''clip'', float ''amount'', bool ''MMX'')|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}
{{Func2Def
|Blur(clip ''clip'', float ''amount'', bool ''MMX'')
|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')
}}


This is a simple 3x3-kernel blurring filter using the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac|1|3}}, {{Frac|1|3}}, {{Frac|1|3}}) kernel. A value of 1.0 gets you a ({{Frac|1|4}}, {{Frac|1|2}}, {{Frac|1|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)
:A 3×3 [[Wikipedia:Kernel_(image_processing)|kernel]] blurring filter.  


Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.


You can use 2 arguments to set independent Vertical and Horizontal amounts. Like this, you can use Blur(0,1) to filter only Vertically, for example to blend interlaced lines together. By default ''amountV''=''amountH''.
{{Func2Def
|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')
|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')
}}


'''Changes'''
:A 3×3 kernel sharpening filter; the inverse of '''Blur'''.


{{Par2|amount|float|(required)}}
:The allowable range for '''Blur''' is from -1.0 to +1.58
:The allowable range for '''Sharpen''' is from -1.58 to +1.0
:Negative '''Blur''' actually ''sharpens'' the image; in fact Sharpen(''n'') is just an alias for Blur(''-n'').
{{Par2|amountH|float|(required)}}
{{Par2|amountV|float|(amountH)}}
:You can use 2 arguments to set independent vertical and horizontal blurring or sharpening: for example,
::<code>Blur(0,1) </code>
:will blur vertical only, perhaps to blend interlaced lines together.
{{Par2|MMX|bool|true}}
:This option should always be ''true''.
==== Notes ====
If you need a larger radius Gaussian blur, try chaining several '''Blur'''s together:
:<code>Blur(1.0).Blur(1.0).Blur(1.0)</code>
Chaining calls to '''Sharpen''' is not a good idea, as the image quickly deteriorates.
==== Changes ====
{| border=1 cellspacing=1 cellpadding=4
{| border=1 cellspacing=1 cellpadding=4
| v2.58
| v2.58

Revision as of 07:49, 28 January 2016

Blur(clip clip, float amount, bool MMX)
Blur(clip, float amountH, float amountV, bool MMX)

A 3×3 kernel blurring filter.


Sharpen(clip clip, float amount, bool MMX)
Sharpen(clip, float amountH, float amountV, bool MMX)

A 3×3 kernel sharpening filter; the inverse of Blur.


float  amount = (required)

The allowable range for Blur is from -1.0 to +1.58
The allowable range for Sharpen is from -1.58 to +1.0
Negative Blur actually sharpens the image; in fact Sharpen(n) is just an alias for Blur(-n).


float  amountH = (required)
float  amountV = (amountH)

You can use 2 arguments to set independent vertical and horizontal blurring or sharpening: for example,
Blur(0,1)
will blur vertical only, perhaps to blend interlaced lines together.


bool  MMX = true

This option should always be true.


Notes

If you need a larger radius Gaussian blur, try chaining several Blurs together:

Blur(1.0).Blur(1.0).Blur(1.0)

Chaining calls to Sharpen is not a good idea, as the image quickly deteriorates.


Changes

v2.58 MMX routines fixed (have full 8 bit precision now); mmx=true by default
v2.57 added MMX option
Retrieved from "http://www.avisynth.nl/index.php?title=Blur&oldid=8487"