Blur

Revision as of 18:43, 16 March 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.

Developer notes

Blur uses 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 (1/3,1/3,1/3) kernel. A value of 1.0 gets you a (1/4,1/2,1/4) kernel for example. Likewise Blur(1.0).Blur(1.0) is a convolution of the kernel (1/4,1/2,1/4) with itself, that is a (1/4,1/2,1/4)*(1/4,1/2,1/4) = (1/16,4/16,6/16,4/16,1/16) kernel. It can be read of Pascal's triangle.

Changes