View source for VariableBlur/BinomialBlur

[[Category:Plugin_Filters]]
[[Category:Blurring]]
'''Back to [[VariableBlur#Filters|VariableBlur]] &larr;'''
== Description ==
:BinomialBlur works by repeating a 5x5 or 3x3 kernel based on pascals triangle multiple times to blur the image. 
:With a variance above 1 the result is very close to a true Gaussian blur and much faster (for variance below ~30). 
<br>

== Requirements ==
:- [[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: [[YV12]]
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|BinomialBlur (clip, float "varY", float "varC", int Y, int U, int V, bool "useMMX")}}
<br>
::{{Par2||clip| }}
:::Input clip
<br>
::{{Par2|varY|float|1.5}}
::{{Par2|varC|float|1.5}}
:::Variance to use; {{Template:FuncDef|<tt>varY</tt>}} for luma, {{Template:FuncDef|<tt>varC</tt>}} for chroma (U/V).
:::Remember variance=sd^2. The variance is rounded down to the nearest half integer(0.5,1.0,1.5 etc). 
:::Radius 1 in version <=0.2 is equal to variance 0.5. Default 1.5

<br>
::{{Par2|Y|int|3}}
::{{Par2|U|int|2}}
::{{Par2|V|int|2}}
:::Controls which planes the filter is applied to:
::::*3 : corresponding plane will be filtered
::::*2 : corresponding plane will be copied from the source
::::*1 : corresponding plane will be ignored
::::*from 0 to -255 : corresponding plane will be assigned the absolute value. 
<br>
::{{Par2|useMMX|bool|true}}
:::If true [[MMX]] instructions will be used. Default true for variance>1 else false.
<br>
== Examples ==
BinomialBlur with default values:
 [[AviSource]]("Blah.avi")
 BinomialBlur(varY=1.5, varC=1.5, Y=3, U=2, V=2, useMMX=true)

<br>
<br>
<br>
-----------------------------------------------
'''Back to [[VariableBlur#Filters|VariableBlur]] &larr;'''