|
|
| (2 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{FilterCat|Plugins|External_filters|Adjustment_filters|Blurring}}
| + | #REDIRECT [[VariableBlur]] |
| − | Name: variableblur<br>
| + | [[Category:Redirects]] |
| − | Author: Tritical<br>
| + | |
| − | Version: 0.50<br>
| + | |
| − | Date: 2011-03-14<br>
| + | |
| − | Architecture: x86<br>
| + | |
| − | Dll: variableblur.dll<br>
| + | |
| − | MD5: f6237fc5b1570ae99fa1d689222c2607<br>
| + | |
| − | FilterType: plugin<br>
| + | |
| − | Homepage: http://forum.doom9.org/showthread.php?p=1484911#post1484911<br>
| + | |
| − | Support: http://forum.doom9.org/showthread.php?p=1484911#post1484911<br>
| + | |
| − | Download: http://bengal.missouri.edu/~kes25c/variableblur.zip<br>
| + | |
| − | Downloadx64: http://www.mediafire.com/?0z0hl43za6bwlb4<br>
| + | |
| − | Dependencies: fftw3.dll<br>
| + | |
| − | Type: blur<br>
| + | |
| − | Colorspaces: YV12<br>
| + | |
| − | Gamma-Aware: yes<br>
| + | |
| − | Functions: binomialBlur(float varY,float varC,int Y,int U,int V,bool usemmx)<br>
| + | |
| − | Functions: averageblur(int radY,int radC,int Y,int U,int V)<br>
| + | |
| − | Functions: gaussianblur(float varY,float varC,int border,bool integrate,int Y,int U,int V, int gfunc, int gfuncc, int pcr, int pcrc)<br>
| + | |
| − | Functions: unsharp(float varY,float varC,float strength,int border,bool integrate,int Y,int U,int V, int gfunc, int gfuncc, int pcr, int pcrc)<br>
| + | |
| − | | + | |
| − | Readme:
| + | |
| − | <pre>
| + | |
| − | VariableBlur version 0.5 - (March 14, 2011 - tritical)
| + | |
| − | | + | |
| − | Modified from version 0.4 by Tonny Petersen(C)2005 (tsp@person.dk)
| + | |
| − | (specifically http://forum.doom9.org/showthread.php?p=1177210#post1177210 which included some fixes from Neuron2)
| + | |
| − | | + | |
| − | | + | |
| − | Variableblur is a gaussian, binomial or average blur filter with a variable radius(variance).
| + | |
| − | The binomial filter part is based on a paper by Frederick M. Waltz and John W. V. Miller. An efficient algorithm for Gaussian blur using finite-state machines.
| + | |
| − | SPIE Conf. on Machine Vision Systems for Inspection and Metrology VII page 3521-37
| + | |
| − | | + | |
| − | The gaussian filter uses fftw version 3(http://www.fftw.org) available from ftp://ftp.fftw.org/pub/fftw/fftw3win32mingw.zip and wouldn't run without it.
| + | |
| − | If you have fft3ffilter or defreq installed you already have it.
| + | |
| − | | + | |
| − | Also includes an unsharp mask filter based on the gaussian filter meaning it is fast for big variance.
| + | |
| − | | + | |
| − | | + | |
| − | USAGE:
| + | |
| − | | + | |
| − | -------------------------------------------------------------------
| + | |
| − | binomialBlur(float varY,float varC,int Y,int U,int V,bool usemmx)
| + | |
| − | | + | |
| − | 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).
| + | |
| − | | + | |
| − | | + | |
| − | varY,varC: variance to use. 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
| + | |
| − | | + | |
| − | Y,U,V: Controls which planes the filter is applied to. If set to 3 the plane will be filtered, if 2 the plane will be copied from the source, if 1 the plane
| + | |
| − | will be ignored and from 0 to -255 the plane will be assigned the absolute value. Default Y 3,U=2, V=2
| + | |
| − | | + | |
| − | useMMX: If true MMX instructions will be used. Default true for variance>1 else false.
| + | |
| − | | + | |
| − | | + | |
| − | -------------------------------------------------------------------
| + | |
| − | averageblur(int radY,int radC,int Y,int U,int V)
| + | |
| − | | + | |
| − | averageblur works by taken the average value of the pixels inside the radius.
| + | |
| − | | + | |
| − | radY,radC: radius of the kernel. default 3.
| + | |
| − | | + | |
| − | Y,U,V: same as binomialblur
| + | |
| − | | + | |
| − | | + | |
| − | -------------------------------------------------------------------
| + | |
| − | gaussianblur(float varY,float varC,int border,bool integrate,int Y,int U,int V, int gfunc, int gfuncc, int pcr, int pcrc)
| + | |
| − | | + | |
| − | gaussianblur works by converting the image to the frequency domain using fftw and complex multiplying it with the gaussian kernel in the frequency domain
| + | |
| − | before converting the result back to the spatial domain giving the same result as doing a convolution in the spatial domain just faster for large kernelsizes.
| + | |
| − | | + | |
| − | varY,varC: Variance to use. This will not be rounded. default 1.5
| + | |
| − | | + | |
| − | border: Setup how the border of the image is threated. Posible values:
| + | |
| − | -255 - 0: the area outside the image is filled with the absolute value
| + | |
| − | 1: Wrap around. The right border will be blured with the left border and the top border with the bottom border.
| + | |
| − | This is the default behaivior when doing convolution in the frequency domain so this will be the fastest option. Default value
| + | |
| − | 2: Don't process borders.
| + | |
| − | 3: fill the area outside the border with the border value. Slowest but produces the nicest result.
| + | |
| − | | + | |
| − | integrate: if true the coefficient used will be a mean value of the area the pixel covers. Use this if you consider each pixel to be made of an infinite number
| + | |
| − | of infinite small pixels or if you like the result :-). If integration is used the image will be softer. Default false.
| + | |
| − | | + | |
| − | Y,U,V: same as binomialblur
| + | |
| − | | + | |
| − | gfunc,gfuncc: set the gamma function to use for Y and U/V planes. Default (-1,-1). Possible values:
| + | |
| − | | + | |
| − | -1 = do not correct gamma (same processing as version 0.4) - Default
| + | |
| − | 0 = sRGB
| + | |
| − | 1 = BT.709, SMPTE 170M
| + | |
| − | 2 = SMPTE 240M
| + | |
| − | 3 = BT.470-2 System M (straight 2.2 gamma, no linear segment)
| + | |
| − | 4 = BT.470-2 System B,G (straight 2.8 gamma, no linear segment)
| + | |
| − | 5 = (straight 2.22222 gamma, no linear segment)
| + | |
| − | 6 = (straight 1.8 gamma, no linear segment)
| + | |
| − | 7 = linear, no gamma compensation
| + | |
| − | | + | |
| − | Gamma-correction will be undone (forward gamma transfer function) prior to filtering, and then reapplied (inverse gamma transfer function) after filtering.
| + | |
| − | | + | |
| − | pcr/pcrc: set the pixel value range for Y and U/V planes. Only used if gfunc or gfuncc >= 0. Default(0,0). Possible values:
| + | |
| − | | + | |
| − | 0 = [0,255]
| + | |
| − | 1 = [16,235]
| + | |
| − | 2 = [16,240]
| + | |
| − |
| + | |
| − | | + | |
| − | -------------------------------------------------------------------
| + | |
| − | unsharp(float varY,float varC,float strength,int border,bool integrate,int Y,int U,int V, int gfunc, int gfuncc, int pcr, int pcrc)
| + | |
| − | | + | |
| − | Sharpens the image using unsharp filtering (http://homepages.inf.ed.ac.uk/rbf/HIPR2/unsharp.htm for an explanation).
| + | |
| − | | + | |
| − | strength: Strength of the sharpener best values is between 0(no sharpen) to 1(more sharpen). Values outside this will produce strange results.
| + | |
| − | | + | |
| − | Rest of the options is the same as for gaussianblur
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | EXAMPLE:
| + | |
| − | | + | |
| − | binomialBlur(radY=0.5,RadC=0.5) #nearly the same as Blur(1)
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | #Unsharpen (it will sharpen the image)
| + | |
| − | | + | |
| − | function unsharpen(clip c,float variance,float k)
| + | |
| − | {
| + | |
| − | blr=gaussianblur(c,vary=variance,varc=2,Y=3,U=2,V=2,border=1)
| + | |
| − | return yv12lutxy(blr,c,"y x - "+string(k)+" * y +",y=3,u=2,v=2)
| + | |
| − | }
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | CHANGELOG:
| + | |
| − | | + | |
| − | 0.1 Initial release
| + | |
| − | | + | |
| − | 0.2 optimization of the gaussian blur (now uses a 5x5 mask instead of 3x3) and the average blur(smarter algorithm resulting in a factor 20 to 100 speed increase)
| + | |
| − | | + | |
| − | 0.3 GaussianBlur is included old gaussian is renamed to binomialblur.
| + | |
| − | | + | |
| − | 0.4 Fixed bug with converting float to unsigned char without proper clamping. Also included an unsharp filter and optional integrated gaussian coefficients
| + | |
| − | | + | |
| − | 0.5 Add gfunc/gfuncc/pcr/pcrc parameters to gaussianblur/unsharp (tritical)
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | LICENSE:
| + | |
| − | | + | |
| − | This filter is released under GPL se copying.txt
| + | |
| − | </pre>
| + | |
