zckri / threex.sslensflare

three.js extension to get screen space lens flare

threex.sslensflare

It is a three.js extension to get screen space lens flare as described in "pseudo lens flare" post by John Chapman.

Show Don't Tell

• examples/basic.html [view source] : It shows a basic usage of the extension on a skymap. There is a Dat.GUI for find tuning.

How To Install It

You can install it via script tag

<script src='threex.sslensflare.js'></script>

Or you can install with bower, as you wish.

bower install threex.sslensflare

How To Use It

First you need to render the scene

var colorRenderTarget = new THREE.WebGLRenderTarget(window.innerWidth, window.innerHeight, {
	minFilter : THREE.LinearFilter,
	magFilter : THREE.LinearFilter,
	format    : THREE.RGBFormat,
});
updateFcts.push(function(){
	renderer.render( scene, camera, colorRenderTarget );    
})

Then you generate the lens flare base on colorRenderTarget

var ssLensFlare	= new THREEx.SsLensFlare(renderer, colorRenderTarget)
updateFcts.push(function(delta, now){
	ssLensFlare.update(delta, now)
})

then it is up to you to blend them together. here is an example which add camera dirt and stardust on top.

var composer	= new THREE.EffectComposer(renderer);

// add Render Pass
var effect	= new THREE.TexturePass(colorRenderTarget);
composer.addPass( effect );

// add blend with lensflare
var effect	= new THREE.ShaderPass(THREEx.SsLensFlare.BlendShader);
effect.uniforms['tLensDirt' ].value	= THREE.ImageUtils.loadTexture( "../images/lensdirt.png" )
effect.uniforms['tLensStar' ].value	= THREE.ImageUtils.loadTexture( "../images/lensstar.png" )
effect.uniforms['tLensColor' ].value	= ssLensFlare.lensRenderTarget
composer.addPass( effect );	

// mark the last pass as ```renderToScreen```
composer.passes[composer.passes.length-1].renderToScreen	= true;

updateFcts.push(function(delta, now){
	composer.render(delta);
})	

TODO

• rotationZ for diffraction starburst
  • with a rotationZ based on camera position