postprocessing

Requires three.js 0.87.x

Changelog

• EffectComposer
  • Replaced internal pixel ratio calculations with getDrawingBufferSize calls.
• Passes
  • The SMAAPass constructor now expects two parameters: searchImage, areaImage. The user must preload these images asynchronously by using the base64-encoded image data urls SMAAPass.searchImagaDataUrl and SMAAPass.areaImageDataUrl. Please refer to the SMAADemo for an example setup.
    Previously, the loading process of these images was unsafe (see Should setting an image src to data URL be available immediately? and the related issue report #62).
  • Removed DepthPass. There was no real purpose behind this pass.
  • Added Depth of Field setting to BokehPass. This lets the user define an area in front of and behind the focus point that remains sharp. See 99519cb.
• Materials
  • Removed DepthMaterial. This material was not useful.
  • Use linearToRelativeLuminance function from common. See 220d490.
  • Ported SMAA image generation scripts for reference purposes. See 18968fb.
  • Replaced the SMAA area look-up image. The previous area image did not match the area image from the official SMAA project.

Requires three.js 0.87.x

Changelog

• Misc
  • Removed an unnecessary peer dependency.

Requires three.js 0.87.x

Changelog

• Materials
  • Use appropriate luminance coefficients in Bokeh2Material, FilmMaterial, LuminosityMaterial and ToneMappingMaterial. Coefficients are now uniforms and can be adjusted by the user. See 0157077.
• Passes
  • Minor improvements in ShockWavePass.
• Misc
  • Reorganised demo, docs and public files.
  • Refactored file names.

Requires three.js 0.86.x

Changelog

• Passes
  • Added getters for width and height to BlurPass to avoid abuse of private render targets.
  • Removed a render target from BloomPass as it only needs one.

Requires three.js 0.85.x

Requires three.js 0.85.x

Changelog

• Passes
  • Added missing needsSwap flag to BloomPass and GodRaysPass.
• Documentation
  • Switched to ESDoc.

Requires three.js 0.85.x

Requires three.js 0.84.x

Changelog

• Materials
  • Avoid null uniform in LuminosityMaterial. See #55.
• Passes
  • Fixed division by zero bug in ToneMappingPass. See 57d86b5.
  • Optimised PixelationPass.

Requires three.js 0.84.x

Changelog

• Materials
  • Added screen blend mode to FilmMaterial for noise and scanlines.
• Passes
  • Fixed mipmap settings. See aa58e97.
  • Fixed incorrect use of undefined clear flag. See d2d401b.
  • Fixed MaskPass. See e7e364d and 4cbcee6.
  • Added clearDepth flag to RenderPass.
  • Moved main clear logic into separate ClearPass.
  • Refactored GodRaysPass to use a RenderPass for its masked scene.
  • Added a ShockWavePass.
  • Added a PixelationPass.
• Misc
  • Improved documentation.

Requires three.js 0.84.x

Changelog

• EffectComposer
  • Pass.setSize is now called before Pass.initialise when a pass is added.
  • The constructor now accepts an options object instead of individual parameters. The renderer remains the first parameter.
  • Added EffectComposer.replaceRenderer method.
  • Pixel ratio will now affect the size of render targets created by the composer. The pixel ratio will also affect the size passed into Pass.setSize.
  • EffectComposer.reset will now properly rebuild the current render targets by reusing depth buffer, stencil buffer and depth texture settings.
  • The signature of EffectComposer.createBuffer is now (depthBuffer, stencilBuffer, depthTexture).
• Materials
  • Added screen blend mode to CombineMaterial for better texture blending.
  • Removed option to invert textures in CombineMaterial.
  • The ConvolutionMaterial has been reworked.
  • Added support for logarithmic depth in BokehMaterial.
• Passes
  • Added a compact BlurPass that can be used by other passes.
  • The GodRaysPass no longer requires an overrideMaterial hack for rendering a masked scene.
  • Added a TexturePass.
  • Added a DepthPass.

Requires three.js 0.82.x

Use with caution! There might be bugs, that have yet to be uncovered.
Nonetheless, the demos show that this library is more or less fit for production.