postprocessing

Requires three ≥ 0.102.0 < 0.129.0

Changelog

Core

• OverrideMaterialManager
  • Added support for flatShading. See #292.

Requires three ≥ 0.102.0 < 0.129.0

Changelog

Effects

• DepthOfFieldEffect
  • Fixed a bug that prevented the effect from working with a transparent canvas. See #288.

Requires three ≥ 0.102.0 < 0.128.0

Note: EffectComposer.multisampling does not work in r127. Please use the latest dev version of three instead, or wait for r128. See https://github.com/mrdoob/three.js/issues/21569 for details.

Changelog

All texture samplers are now declared with explicit precision qualifiers.

Effects & Materials

• SSAOEffect & DepthDownsamplingMaterial
  • Avoid GLSL array constructors to improve compatibility with mobile devices.

Demo

• SSAODemo & PerformanceDemo
  • Improved compatibility with mobile devices.

Requires three ≥ 0.102.0 < 0.127.0

Changelog

Effects

• SelectiveBloomEffect
  • Fixed a clear color bug. See #280.

Materials

• DepthMaskMaterial
  • The error threshold (epsilon) for the depth modes EqualDepth and NotEqualDepth is now configurable. See #280.
  • Added getEpsilon and setEpsilon methods.

Demos

• Tweaked shadow map settings.
• The shadow map size will now be smaller on devices with smaller screens.

Requires three ≥ 0.102.0 < 0.127.0

Changelog

Fixed an issue that broke bundling with Webpack. See #277.

Requires three ≥ 0.102.0 < 0.127.0

Changelog

Effects

• SSAOEffect
  • Minor optimization. See 42d7b1a.
  • Added reference to original getViewPosition implementation. See #275.

Materials

• Added DepthCopyMaterial.

Passes

• Added DepthSavePass.
• Added DepthPickingPass. See #270. Thanks @unphased!

Demos

• Fixed UI toggling.
• Updated spatial-controls.
• The options menu will now be closed on small screens.
• Improved styles for mobile.
• ShockWaveDemo
  • Added depth picking.

Requires three ≥ 0.102.0 < 0.126.0

Changelog

Miscellaneous

• Fixed an issue that prevented postprocessing.js and postprocessing.min.js from running in a browser environment.

Requires three ≥ 0.102.0 < 0.126.0

Changelog

Core

• OverrideMaterialManager
  • Added support for BackSide and DoubleSide geometry. See #265.

Requires three ≥ 0.102.0 < 0.126.0

Changelog

Loaders

• SMAAImageLoader
  • Switched back to static base64 strings for faster loading times.
  • Moved the image generation worker to SMAAImageGenerator.
• SMAAImageLoader, LUT3dlLoader and LUTCubeLoader
  • The promise returned by load() will no longer reject if an onError callback is provided.

Images

• Added SMAAImageGenerator.

Requires three ≥ 0.102.0 < 0.125.0

Changelog

Effects

• SelectiveBloomEffect
  • Improved performance.
  • Masking is now based on depth; only selected objects will be rendered a second time.
  • Inverting the selection will simply invert the depth test and has no impact on performance.
  • If a scene background is set, it will no longer be rendered a second time.
  • It is no longer necessary to change render layers of lights.

Materials

• DepthMaskMaterial
  • Added support for all depth test modes. See 1b5220ad6cd0372490fbec08187fdb0fe6a736cc.
  • Added getDepthMode and setDepthMode methods.
  • Added keepFar flag that controls whether the background should be preserved.

Requires three ≥ 0.102.0 < 0.125.0

Changelog

Core

• EffectComposer
  • Fixed removePass method. See #254.

Loaders

• LUTCubeLoader
  • Throw error instead of using console.error if input domain is invalid.

Miscellaneous

• Moved public folder to gh-pages branch.
• Updated CI/CD workflows.

Requires three ≥ 0.102.0 < 0.125.0

Changelog

Effects

• LUTEffect
  • Implemented tetrahedral interpolation. See #250.
  • Added support for custom input domains.
  • Added setTetrahedralInterpolationEnabled method.
• ToneMappingEffect
  • Output will now be clamped to [0.0, 1.0] for the modified Reinhard operator.
  • Exposure can now be controlled via WebGLRenderer.toneMappingExposure.

Loaders

• LUTCubeLoader
  • Added support for custom input domains.

Requires three ≥ 0.102.0 < 0.125.0

Changelog

Effects

• LUTEffect
  • Fixed LUT sampling for both 3D and 2D samplers. Thanks @gkjohnson.
  • Improved handling of input/output encodings.

Images & Textures

• LookupTexture3D
  • Set minification filter to LinearFilter to eliminate artifacts.
  • Added missing return in applyLUT().
  • Data conversion methods will now set needsUpdate to true.
  • Added convertToRGBA() utility method.
• TetrahedralUpscaler
  • Fixed calculation of relative UVW coordinates. Thanks @gkjohnson.

Happy New Year! 🎉

Requires three ≥ 0.102.0 < 0.125.0

Changelog

Core

• OverrideMaterialManager
  • Minor optimizations

Passes

• Added AdaptiveLuminancePass
• Improved shader function signature detection in EffectPass

Effects

• Greatly improved ToneMappingEffect
  • Adaptive luminance was broken before as it used an inadequate buffer type to store the luminance values and an incorrect mipmap sampling approach. The effect now requires support for EXT_color_buffer_half_float and EXT_shader_texture_lod to work properly.
  • Added ToneMappingMode with support for Reinhard, modified Reinhard, adaptive Reinhard, optimized Cineon and ACES filmic operators.
• Added LUTEffect
  • Supports 3DL and CUBE files as well as plain image LUTs in PNG or JPG format.
  • Supports 2D strip format and 3D textures.

Images & Textures

• Added LookupTexture3D
• Added TetrahedralUpscaler

Loaders

• Added LUT3dlLoader
• Added LUTCubeLoader

Miscellaneous

• Switched to esbuild
• Fixed deprecation warnings for the latest version of three
• Removed build folder from repository
• Fixed stuttering issues in the demo
• Added epilepsy warning to the Glitch demo

Requires three ≥ 0.102.0 < 0.123.0

Changelog

Core

• EffectComposer
  • Fixed a bug that caused the depth texture to disappear after changing multisampling.
  • Calling setSize() without parameters no longer updates the size of the renderer. See c7e8521.

Passes

• RenderPass
  • The scene.background will now be ignored when an overrideClearColor is defined. See 9a9c58e.
• Added LambdaPass to address use cases which require pre-render and post-render hooks.

Effects

• SMAAEffect
  • Now always requests a depth texture.

Materials

• EdgeDetectionMaterial
  • Implemented predicated thresholding.
• Added PredicationMode.

Requires three ≥ 0.102.0 < 0.122.0

Requires three ≥ 0.102.0 < 0.121.0

Changelog

Core

• EffectComposer
  • Improved depth texture cleanup by making sure that associated render targets are properly updated.

Requires three ≥ 0.102.0 < 0.121.0

Changelog

Core

• EffectComposer
  • Added a temporary fix that immediately adds a requested depth texture to the input buffer. Note that depth-based effects will still fail if an EffectPass is added before a RenderPass. See #225 for details.

Passes

• SavePass
  • Added texture getter.
• RenderPass
  • Removed faulty depth texture logic.

Requires three ≥ 0.102.0 < 0.120.0

Changelog

Miscellaneous

• Fixed the ES5 build.

Requires three ≥ 0.102.0 < 0.120.0

Changelog

Core

• EffectComposer
  • Removing a pass will now reset its renderToScreen flag to false if autoRenderToScreen is enabled.
  • Added removeAllPasses to clear passes without deleting them.
• OverrideMaterialManager
  • renderer.sortObjects will no longer be disabled temporarily.

Materials

• BokehMaterial
  • Reduced the blur kernel uniform count. See #220.

Passes

• RenderPass
  • Fixed overrideMaterial setter. See af836c1.
• DepthDownsamplingPass
  • Log an error message when the context is not WebGL 2.
• EffectPass
  • Set default value of maxTime to Number.POSITIVE_INFINITY.