» Spatial Edge Blend shader
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.

Spatial Edge Blend shader

effect dx11 texture-projection shader edge-blend projection-mapping sugokuGENKI
Credits: elliotwoods, colorsound, catweasel


This shader enables you to edge blend in 3D, which is especially useful for projection mapping. This is a bit of a 'kitchen sink' shader which includes some other useful bits for mapping as well.

Edge blending (aka Soft Edge) features

  • Blend region size / position
  • Blend direction unit vector input
  • RGB gamma adjustment

Other features

  • Bicubic filtering
  • Texture projection (for viewpoint matching)


  • Bicubic.fxh (needs to be in same dir as effect)
  • BicubicFilterKernel.hdr

To use

You need to edit the shader dependin on how many projectors you have.

Edit line #7 in the shader:

#define nRegions 3

and set nRegions to your number of projectors


Set your blend vector to be the unit vector in the direction you want to blend in, e.g. if you're blending across the width of your sculpture, then chances are that you want the blend vector to be (1,0,0). This means that blends are cast across the x dimension.

Then set 'yBlends' (called 'Edge Blend Line' in the help patch) to the places where you want to blend.

Your renderer will need to have seperate viewports for each projector.
Check the help patch!

Also, if you want to project a texture onto the object using a projection matrix, then input your projection matrix into 'tProjection' as set 'useProjection' to 1.


23.03.16 [11:54 UTC] by colorsound | 661 downloads
Manual Slicing by T,B,L,R,Polar Version,Independent blend width per side,new help patches,Spanmode&DualMode versions
Show 4 older revisions

Older Revisions

SpatialEdgeBlend (DX11).zip
04.04.13 [12:06 UTC] by colorsound | 760 downloads
DX11 Version
SpatialEdgeBlend (EX9.Effect).zip
08.08.12 [12:54 UTC] by colorsound | 620 downloads
some bugfixes, tidying up code , updated help patch
15.01.12 [23:19 UTC] by u7angel | 527 downloads
fixed for beta27
25.09.10 [12:45 UTC] by elliotwoods | 912 downloads
Shader file and help patch

sugokuGENKI 25/09/2010 - 12:57

P.S. for calibration,
it's good to input a grid texture, set useProjection to 1, and not use anyting on tProjector.
That way, your grid will be projected directly in x,y onto your object, so you can calibrate.

P.S. This shader generally presumes that all your projectors are in a line facing towards your target.
It doesn't deal with multiple projectors that inwards / outwards onto a scene.

sunep 15/01/2012 - 17:30

I get the error "failed to open 'Bucubic.fxh'"

woei 15/01/2012 - 20:03

correcting line 57 from

#include "Bicubic.fxh"


#include <effects\Bicubic.fxh>

will reference the vvvv included .fxh file and thus throw no error

io 29/10/2012 - 21:20

ATI HD6970 the Gamma settings don t seem to have any effect. Didn t have the time to look into the shader for the usual suspects, any take on this?

io 31/10/2012 - 13:12

yay! There a commented out line which works for ATI :

//return factorbottom * factortop;
    return pow(factortop * factorbottom, gammaRGB);
io 02/11/2012 - 00:19

Now, the next step would be a dynamic gamma correction.
Not sure but you should be able to input 4 RGB parameters, for RGB and probably for full white, that would be a projector/lamp color footprint. Based on this footprint a gamma correction should be calculated for every pixel that is shared among more than one viewport.

isdzaurov 24/03/2016 - 16:05

eeeeh cool!

anonymous user login


~1d ago

~4d ago

domj: Stuck in your patching or eager to share what you made or came across? Join Midweek Patch Therapy at 17:30 https://therapy.domj.net/

~5d ago

david: vvvv meetup 3. new stream link. again youtube made us nuts.. please send everybody to https://youtu.be/pa3HRQ7kj6w

~5d ago

joreg: Reminder: Join us this evening, 8pm CET for the 3rd worldwide #vvvv meetup: 3.-worldwide-vvvv-meetup

~5d ago

sinus: @evvvvil: very impressive stuff! keep on marching the rays!You´ll never walk alone!

~6d ago

evvvvil: @mediadog, thankx for pointing it out broski. Wicked.

~7d ago

domj: Catching up with the Midweek Patch Therapy excerpts, expect more videos over the week. https://youtu.be/36r8LnHaS7g

~8d ago

mediadog: @evvvvil hey you made the webgl-dev-list cool stuff list: http://gfxprose.blogspot.com/2020/05/cool-webgl-stuff-2020-05-21.html

~9d ago

evvvvil: Yo I'm live doing a VJ set made in vvvv for OUTLINE demoparty with OddJohn DJing! Come see us play here: https://www.twitch.tv/outlinedemoparty/

~10d ago

domj: A blast to read with great references. Thoughts on how to make programming more learnable and understandable. http://worrydream.com/LearnableProgramming/