There are different ways to perform blur and this is one of the most common way to do it in a shader. It’s a two step method with first a horizontal blur and then a vertical blur. By splitting the work in two directions (two passes) you can save a lot of computation.
The method can be divided in the following parts:
- Render the scene you want to blur to a texture (could be downsampled)
- Render a screen aligned quad with the horizontal blur shader to a texture
- Render a screen aligned quad with the vertical blur shader to the screen or texture depending on what you want to use it for
The following image shows how the blur works when splitted up in two directions.
Here’s the horizontal blur shader.
Vertex Shader (GLSL) . This shader screen align a quad with width 1. Any method to render a screen aligned quad will work. So you’re free to use other shaders.
varying vec2 vTexCoord; // remember that you should draw a screen aligned quad void main(void) { gl_Position = ftransform();; // Clean up inaccuracies vec2 Pos; Pos = sign(gl_Vertex.xy); gl_Position = vec4(Pos, 0.0, 1.0); // Image-space vTexCoord = Pos * 0.5 + 0.5; } |
Fragment Shader (GLSL)
uniform sampler2D RTScene; // the texture with the scene you want to blur varying vec2 vTexCoord; const float blurSize = 1.0/512.0; // I've chosen this size because this will result in that every step will be one pixel wide if the RTScene texture is of size 512x512 void main(void) { vec4 sum = vec4(0.0); // blur in y (vertical) // take nine samples, with the distance blurSize between them sum += texture2D(RTScene, vec2(vTexCoord.x - 4.0*blurSize, vTexCoord.y)) * 0.05; sum += texture2D(RTScene, vec2(vTexCoord.x - 3.0*blurSize, vTexCoord.y)) * 0.09; sum += texture2D(RTScene, vec2(vTexCoord.x - 2.0*blurSize, vTexCoord.y)) * 0.12; sum += texture2D(RTScene, vec2(vTexCoord.x - blurSize, vTexCoord.y)) * 0.15; sum += texture2D(RTScene, vec2(vTexCoord.x, vTexCoord.y)) * 0.16; sum += texture2D(RTScene, vec2(vTexCoord.x + blurSize, vTexCoord.y)) * 0.15; sum += texture2D(RTScene, vec2(vTexCoord.x + 2.0*blurSize, vTexCoord.y)) * 0.12; sum += texture2D(RTScene, vec2(vTexCoord.x + 3.0*blurSize, vTexCoord.y)) * 0.09; sum += texture2D(RTScene, vec2(vTexCoord.x + 4.0*blurSize, vTexCoord.y)) * 0.05; gl_FragColor = sum; } |
And here’s the vertical blur shader.
Vertex Shader (GLSL) (the same as for the blur in horizontal direction)
varying vec2 vTexCoord; // remember that you should draw a screen aligned quad void main(void) { gl_Position = ftransform();; // Clean up inaccuracies vec2 Pos; Pos = sign(gl_Vertex.xy); gl_Position = vec4(Pos, 0.0, 1.0); // Image-space vTexCoord = Pos * 0.5 + 0.5; } |
Fragment Shader (GLSL)
uniform sampler2D RTBlurH; // this should hold the texture rendered by the horizontal blur pass varying vec2 vTexCoord; const float blurSize = 1.0/512.0; void main(void) { vec4 sum = vec4(0.0); // blur in y (vertical) // take nine samples, with the distance blurSize between them sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y - 4.0*blurSize)) * 0.05; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y - 3.0*blurSize)) * 0.09; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y - 2.0*blurSize)) * 0.12; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y - blurSize)) * 0.15; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y)) * 0.16; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y + blurSize)) * 0.15; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y + 2.0*blurSize)) * 0.12; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y + 3.0*blurSize)) * 0.09; sum += texture2D(RTBlurH, vec2(vTexCoord.x, vTexCoord.y + 4.0*blurSize)) * 0.05; gl_FragColor = sum; } |
And this is a scene without blur.
And this is the same scene but with gaussian blur.
You can tweak the blur radius to change the size of the blur and change the number of samples in each direction.
Cost for separable blur shader : 9+9 = 18 (number of texture samples)
Cost for shader if blured in one pass: 9*9 = 81 (number of texture samples)
So splitting up in two directions saves a lot.
The gaussian weights are calculated accordingly to the gaussian function with standard deviation of 2.7. These calculations were done in the excel document found [2].
Here’s a description of blur shaders and other image processing shaders in DirectX:
[1] http://ati.amd.com/developer/shaderx/ShaderX2_AdvancedImageProcessing.pdf
More info about calculating weights for separable gaussian blur:
[2] http://theinstructionlimit.com/?p=40




















Why vertex shader?
Why vTexCoord = Pos * 0.5 + 0.5;
Sorry for confusing you, this vertex shader might not be useful for everyone since it’s goal is to align a simple quad to the view and stretch it to cover the entire screen. If you’re already sending in a screen aligned quad, you can skip the vertex shader!
Picture is wrong!
middle pixel is too dark. blur = 5/25
Sorry for my bad english
Isn’t this just a box filter blur? Gaussian blurs are weighted based on their distance from the center. In your pixel shader you just take the average of all the pixels. This works fine in practice, but calling it a Gaussian blur is misleading.
I take that back. You ARE weighting the neighbors based on their distance. Sorry about that. However, their weight is based on a linear decay, not a Gaussian function.
Yes, I’m using the distance, but as you say, the weights are not really gaussian weights. But they are actually close enough to look good. I will add the “true” gaussian weights to this example since it’s more correct that way.
Thanks for the feedback!
Your filter weights are wrong somewhere.
2 * (0.05 + 0.09 + 0.12 + 0.15) + 0.16 = 0.98
This is probably the reason for #2′s darkness problem, and if you try to use this blur with VSM for example the results will be completely wrong.
Thanks for this, I’m looking for a good blur effect to blur a particle system so that I can make stuff like fire, fireworks, pulsating clouds etc …. I reckon this might do the trick!
I am a student and doing Image Processing Coursework
Do you apply the Gaussian mask to the RGB components ot the YCbCr components of the image?
I have tried and both seem to produce the same result.
What if i need to use different radius size?
In both vertical and horizontal fragment shaders you have written:
// blur in y (vertical)
You should change that to avoid confusion
What happens at the borders when texture2D is trying to read pixels outside the image? For example when vTexCoord.x is 0 and you call texture2D to access pixels at vTexCoord.x – 4 * blursize? What is the texture2D return value in this case and how does it contribute to the filter kernel?
Pingback: ND2D – Blur - nulldesign // lars gerckens
I am so grateful for your blog post.Much thanks again. Cool.
RTBlurH? ussless article. incomplte!
cheap viagra online – cheap viagra , http://cheapqualityviagra.com/#9110 buy generic viagra
Pingback: Faster Gaussian Blur in GLSL | xissburg
Hey there! I know this is kinda off topic however , I’d figured I’d
ask. Would you be interested in exchanging links
or maybe guest writing a blog article or vice-versa? My website covers a lot of the same subjects as yours and
I believe we could greatly benefit from each other.
If you are interested feel free to send me an e-mail. I look forward to
hearing from you! Fantastic blog by the way!
rloaqhbnfsfoefsjoh, Weight loss drug, aqHkmOz, [url=http://aboutweightloss.co.uk/]Weight loss herbal[/url], uQxXJcr, http://aboutweightloss.co.uk/ Weight loss healthy, EWdclVK.
Hi admin,
You mentioned that vertex shaders are not necessary if you’re already passing in a screen-aligned quad. In that case, how would you make the draw call? As you surely do not need to pass any geometry in for the blur passes?
Thanks,
Nick
Not to worry, I’m just being silly. Of course I will be passing in the fullscreen quad’s geometry via glDrawElements.
Pingback: Desfoque Gaussiano Mais Rápido em GLSL | xissburg
Pingback: Custom Blur Shader for Unity3D | Ana Todor Blog Journey | blur shader
Hi there this is kinda of off topic but I was wondering if blogs use WYSIWYG editors or if you have
to manually code with HTML. I’m starting a blog soon but have no coding know-how so I wanted to get guidance from someone with experience. Any help would be greatly appreciated!
Pingback: Magic in-depth | Harmony & Rainbow Factory