Requires three ≥ 0.102.0 < 0.104.0

Changelog

Effects

• Added ColorDepthEffect.

Requires three ≥ 0.102.0 < 0.104.0

Changelog

Fixed the peer dependency version requirement.

Requires three 0.103.x

Requires three 0.102.x

Changelog

Passes

• ClearPass
  • Treat clear color and clear alpha separately.

Effects

• OutlineEffect
  • Fixed alpha compatibility. See #114.

Miscellaneous

• Demos
  • Added a polyfill for IE11.
• Bundles
  • Renamed main bundle:
    build/postprocessing.umd.js → build/postprocessing.js

Requires three 0.102.x

Changelog

EffectComposer

• Fixed a potential depth texture bug.

Requires three 0.102.x

Changelog

EffectComposer

• Enhanced depth texture management.
• Added getRenderer method and marked renderer as private.

Passes

• ClearPass
  • Added color, depth and stencil constructor parameters to provide more control over which buffers should be cleared.
    The new signature is constructor(color = true, depth = true, stencil = false).
  • The override clear color and alpha can be set via the overrideClearColor and overrideClearAlpha properties.
• RenderPass
  • Removed clear options from the constructor.
    The new signature is constructor(scene, camera, overrideMaterial = null).
  • Added getClearPass method and marked clearPass as private.
• MaskPass
  • Now uses a ClearPass to clear the stencil buffer.
  • Renamed property clearStencil to clear.
• DepthPass
  • Changed default resolution scale to 1.0.
• NormalPass
  • Changed default resolution scale to 1.0.

Effects

• GodRaysEffect
  • Changed signature to constructor(camera, lightSource, options).
  • Improved performance. See #99.
  • The type of the lightSource must now be Mesh or Points (was Object3D). The depthWrite property of its material will be set to false and the transparent flag will be set to true.

Miscellaneous

• Renamed all occurances of delta to deltaTime to be more descriptive. See 90d5fec.
• Use destructuring for optional constructor parameters. See 5ed4c0a.
• Updated the code base to support three r102.
  • All passes now explicitly use WebGLRenderer.setRenderTarget instead of passing render targets to WebGLRenderer.render. This change breaks compatibility with older versions of three.

Requires three ≥ 0.87.0 < 0.102.0

Changelog

Effects

• BlendFunction
  • Added DIVIDE function.
• RealisticBokehEffect
  • Minor optimizations.

Passes

• EffectPass
  • Skip rendering when possible. See 4451c79.

Materials

• Reduced shader code redundancy.

Miscellaneous

• Modified the build setup.

Requires three ≥ 0.87.0 < 0.101.0

Changelog

Effects

• Added WebGLExtension.
  • Allow effects to enable optional WebGL extensions.

Requires three ≥ 0.87.0 < 0.101.0

Requires three ≥ 0.87.0 < 0.100.0

Changelog

Effects

• OutlineEffect
  • Fixed a bug that could corrupt the mask texture. See #101.
  • Minor optimizations.

Documentation

• Removed old files. See #100.

Requires three ≥ 0.87.0 < 0.100.0

Relaxed the peer dependency version range to include patch releases.

Requires three ≥ 0.87.0 ≤ 0.99.0

Requires three ≥ 0.87.0 ≤ 0.98.0

Changelog

Effects

• GodRaysEffect
  • Added support for morph targets and skinning.

Requires three ≥ 0.87.0 ≤ 0.98.0

Changelog

Effects

• SSAOEffect
  • Tweaks and optimizations.

Requires three ≥ 0.87.0 ≤ 0.98.0

Changelog

Effects

• SSAOEffect
  • Added distance cutoff parameters distanceThreshold and distanceFalloff.
  • Added method setDistanceCutoff(threshold, falloff).
  • Replaced the hard range check threshold with a smooth local proximity cutoff (rangeFalloff).
  • Added method setProximityCutoff(threshold, falloff).

Requires three ≥ 0.87.0 ≤ 0.98.0

Requires three ≥ 0.87.0 ≤ 0.97.0

🎃 Halloween Release 👻

Changelog

Passes

• Added NormalPass for convenient scene normal rendering.
• Added DepthPass for convenient depth rendering.

Effects

• Added SSAOEffect 🔅
• Effect
  • Removed an incorrect depth conversion. See 6af42d6. 💀
  • Effects with the DEPTH EffectAttribute no longer have to use the depth information in their main fragment shader.
  • Added Effect.setDepthTexture(texture, depthPacking). Effects may override this method if they require direct access to the depth texture that is bound to the associated EffectPass.
• Improved ChromaticAberrationEffect, SMAAEffect, GlitchEffect and OutlineEffect.

Materials

• EffectMaterial
  • Renamed setResolution to setSize.

Requires three ≥ 0.87.0 ≤ 0.97.0

Changelog

EffectComposer

Removed the depthTexture constructor option. A depth texture will now be created automatically when a pass is added that relies on it. The depth texture mechanism can be controlled via the new Pass.needsDepthTexture flag.

Passes

• ShaderPass
  • Changed default input uniform name to "inputBuffer".
• Pass
  • Removed material getter and setter.
  • Added needsDepthTexture flag.
  • Added getDepthTexture().
  • Added setDepthTexture(depthTexture, depthPacking).
• Added EffectPass

The EffectPass creates a compound fullscreen shader to render many effects with one render operation. It replaces all fullscreen passes except for ShaderPass.

If you did new BloomPass() before, you now do new EffectPass(camera, new BloomEffect())

Effects

• Added Effect and converted most passes into effects.
• Added BlendMode and BlendFunction.
• OutlineEffect
  • Removed alphaBlending option. Use BlendFunction.ALPHA for dark outlines instead.
• Split DotScreenPass up into
  • DotScreenEffect
  • ColorAverageEffect
• Split FilmPass up into
  • GridEffect
  • NoiseEffect
  • ScanlineEffect
  • SepiaEffect
  • VignetteEffect
• Added BrigtnessContrastEffect.
• Added ChromaticAberrationEffect.
• Added DepthEffect (mainly for debugging).
• Added GammaCorrectionEffect.
• Added HueSaturationEffect.

Materials

• Renamed AdaptiveLuminosityMaterial to AdaptiveLuminanceMaterial.
• Renamed LuminosityMaterial to LuminanceMaterial.

Requires three ≥ 0.89.0 ≤ 0.96.0

Requires three ≥ 0.89.0 ≤ 0.95.0