postprocessing

Requires three ≥ 0.102.0 < 0.111.0

Changelog

Passes

• Fixed backward compatibility issue in Pass. See 113a35e.

Requires three ≥ 0.102.0 < 0.111.0

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Materials

• DepthMaskMaterial
  • Added support for packed depth. See #154.

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Effects

• SelectiveBloomEffect
  • Fixed render target size update via height and width. See f998248.

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Passes

• EffectPass
  • Only request a depth texture if none has been provided yet.

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Passes

• EffectPass
  • Made getFullscreenMaterial more reliable. The fullscreen material will now be instantiated in the constructor. Calling recompile will update this material instead of creating a new one. See #152.

Materials

• EffectMaterial
  • Added utility methods setShaderParts, setUniforms and setDefines.

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Core

• EffectComposer
  • Added optional updateStyle parameter to setSize method. See #150.

Requires three ≥ 0.102.0 < 0.110.0

Changelog

Core

• Selection
  • Selected objects will now be updated instead of being cleared when the layer is changed.

Passes

• EffectPass
  • The final shader material will now be created after all effects have been initialized. This allows effects to change macros and shader code before the final shader is created.

Effects

• ChromaticAberrationEffect
  • Improved alpha handling.

Requires three ≥ 0.102.0 < 0.109.0

Changelog

Core

• Added Selection for easier selective rendering.

Effects

• Added SelectiveBloomEffect. See #142.
• BloomEffect
  • Changed visibility of luminancePass to public.
  • The luminance pass can now be disabled.
• OutlineEffect
  • Deprecated setSelection(objects). Use selection.set(objects) instead.
  • Deprecated clearSelection(). Use selection.clear() instead.
  • Deprecated selectObject(object). Use selection.add(object) instead.
  • Deprecated deselectObject(object). Use selection.remove(object) instead.
  • Deprecated selectionLayer. Use selection.layer instead.

Miscellaneous

• Removed assets from demo folder.
• Removed cpx dev dependency and deploy script.
• Updated OutlineDemo, SSAODemo and BloomDemo.

Requires three ≥ 0.102.0 < 0.109.0

Requires three ≥ 0.102.0 < 0.108.0

Notice

If you're using BlurPass, BloomEffect, GodRaysEffect or OutlineEffect, update your setup to use height or width instead of resolutionScale. It's recommended to set the height to 480. The width will be calculated automatically based on the aspect ratio. Using a fixed size instead of a relative resolution scale produces consistent results across different devices and resolutions.

Changelog

EffectComposer

• Added an additional parameter to replaceRenderer that controls whether the DOM elements of the renderers should be swapped. Default is true.
• Updated the render method to use WebGLRenderer.getContext().

Passes

• BlurPass
  • Added width and height constructor parameters and setters for fixed size rendering with automatic aspect correction. See #141.
  • Added AUTO_SIZE constant.
  • Added scale factor.
  • Deprecated resolutionScale. Use height or width instead.
  • Added temporary getOriginalSize method for internal use only.
• MaskPass
  • Lock and unlock the stencil buffer to play nicely with Material Stencil Parameters (broken in [email protected]. See https://github.com/mrdoob/three.js/issues/17175).

Effects

• BloomEffect
  • Added luminanceThreshold and luminanceSmoothing constructor parameters.
  • Added width and height constructor parameters.
  • Deprecated resolutionScale constructor parameter.
  • Added luminanceMaterial getter for convenient luminance control.
  • Added width and height.
  • Changed visibility of blurPass to public.
  • Deprecated distinction. Adjust threshold and smoothing of the luminanceMaterial instead.
  • Deprecated resolutionScale. Use height or width instead.
  • Deprecated dithering. Use blurPass.dithering instead.
  • Deprecated kernelSize. Use blurPass.kernelSize instead.
• GodRaysEffect
  • Added width and height constructor parameters.
  • Deprecated resolutionScale constructor parameter.
  • Added width and height.
  • Changed visibility of blurPass to public.
  • Deprecated resolutionScale. Use height or width instead.
  • Deprecated kernelSize. Use blurPass.kernelSize instead.
• OutlineEffect
  • Added width and height constructor parameters.
  • Deprecated resolutionScale constructor parameter.
  • Added width and height.
  • Changed visibility of blurPass to public.
  • Deprecated resolutionScale. Use height or width instead.
  • Deprecated dithering. Use blurPass.dithering instead.
  • Deprecated kernelSize. Use blurPass.kernelSize instead.
• ToneMappingEffect
  • Replaced LinearMipMapLinearFilter with LinearMipmapLinearFilter.
  • Deprecated distinction. This factor was not appropriate for this effect.
• BlendFunction
  • Enhanced alpha blending.

Materials

• LuminanceMaterial
  • Luminance is now also stored in the alpha channel. See #133.
  • Removed distinction uniform.
  • Added threshold. Range is [0.0, 1.0].
  • Added smoothing. Range is [0.0, 1.0].
  • Added useThreshold.
  • Added useRange.
  • Deprecated luminanceRange. Use useRange instead.

Miscellaneous

• Changed the GodRaysDemo and PerformanceDemo to use a sphere mesh instead of a sprite for the visual representation of the light source because sprites render inconsistently at different resolutions.

Requires three ≥ 0.102.0 < 0.107.0

Requires three ≥ 0.102.0 < 0.106.0

Changelog

Effects

• SMAAEffect
  • Added missing features thanks to @dmnsgn's https://github.com/dmnsgn/glsl-smaa.
  • Added quality presets via the SMAAPreset enum.
  • Added an optional third constructor parameter to set the initial preset.
  • Added applyPreset(SMAAPreset) method.
  • Added colorEdgesMaterial getter.
  • Added weightsMaterial getter.
  • Deprecated setEdgeDetectionThreshold method.
  • Deprecated setOrthogonalSearchSteps method.
  • Removed hacky gamma correction.
  • Updated shaders to match the official code base.

See #132 for details.

Materials

• ColorEdgesMaterial

  • Made local contrast adaptation configurable.
  • Updated shaders.

• SMAAWeightsMaterial

  • Added diagonal pattern detection.
  • Added corner rounding.
  • Switched to the cropped version of the search texture.
  • Flipped the area texture in code.
  • Updated shaders.

• LuminanceMaterial

  • Added colorOutput getter and setter.
  • Added luminanceRange getter and setter.
  • Deprecated setColorOutputEnabled method.
  • Deprecated setLuminanceRangeEnabled method.

Requires three ≥ 0.102.0 < 0.105.0

Changelog

Passes

• Pass
  • Replaced the internal fullscreen quad with a single triangle. See GCN Execution Patterns in Full Screen Passes for details. The triangle geometry will also be shared between fullscreen passes.

Materials

• Custom fullscreen materials should calculate screen coordinates and gl_Position as shown in the common vertex shader. The uv attribute is still available, but should be avoided as it may get removed in a future release.

Effects

• Custom effects should not use the uv attribute inside the vertex shader. Use the new optional function signature void mainSupport(const in vec2 uv); instead.

Requires three ≥ 0.102.0 < 0.105.0

Changelog

Effects

• SMAAEffect
  • Improved compatibility with WebGL2. See #127 and dc8f8b5.

Materials

• The varying vUv is now calculated based on position. See a99906b.
• LuminanceMaterial
  • Set depthWrite and depthTest to false.

Effects

• Effect vertex shaders now rely on the vUv varying instead of the uv attribute. See 25fd704.

Requires three ≥ 0.102.0 < 0.105.0

Changelog

Effects

• GodRaysEffect
  • Use updateWorldMatrix instead of updateMatrixWorld. See fa1b238.

Miscellaneous

• Compress GLSL code.

Requires three ≥ 0.102.0 < 0.105.0

Changelog

Passes

• EffectPass
  • Don't discard depth flags when the blend function is set to SKIP. See #123.

Requires three ≥ 0.102.0 < 0.105.0

Requires three ≥ 0.102.0 < 0.104.0

Changelog

Effects

• GodRaysEffect
  • Use the world transformation of the light source. See #122.
• ColorDepthEffect
  • Added a missing field declaration.

Miscellaneous

• Added performance demo. See #96.

Requires three ≥ 0.102.0 < 0.104.0

Changelog

Effects

• Made parameters of ColorDepthEffect optional.