postprocessing

Requires three ≥ 0.138.0 < 0.154.0

Changelog

• Changed package type to module. See #485, #490.
• Removed postprocessing/module export.

Requires three ≥ 0.138.0 < 0.154.0

Changelog

• Fixed an issue in the CD workflow.

Requires three ≥ 0.138.0 < 0.154.0

Changelog

Effects

• DepthOfFieldEffect, SelectiveBloomEffect
  • Added support for logarithmic depth. See #493.

Documentation

• Fixed documentation of OutlineEffect. See #487. Thanks @Suprhimp!

Special Thanks

Thanks @canadaduane, @alexpineda, @juliangarnier, @FractalHQ and @donmccurdy for the support! ❤️

Requires three ≥ 0.138.0 < 0.153.0

Changelog

Added backward-compatible support for three's color management changes.

Effects

• DepthOfFieldEffect
  • Fixed a bug that caused bad blending with transparent objects. See #481. Thanks @CodyJasonBennett!

Documentation

• Fixed documentation of EffectMaterial and EffectPass. See #478.

Special Thanks

Thanks @canadaduane, @alexpineda, @juliangarnier, @FractalHQ and @donmccurdy for the support! 🚀

Requires three ≥ 0.138.0 < 0.152.0

Changelog

Types

• Made scene/camera params optional. See #460. Thanks @Beilinson!
• Added null as a valid type for inputBuffer and outputBuffer in Pass.render method.

Core

• Timer
  • Fixed a bug that caused initial leaps in elapsed time. See https://github.com/mrdoob/three.js/pull/17912#issuecomment-1490698221.
• OverrideMaterialManager
  • Added a workaround for copying render target textures. See https://github.com/mrdoob/three.js/pull/25560.

Effects

• GodRaysEffect
  • Added lightSource accessors.
• SSAOEffect
  • Added normalBuffer accessors.

Special Thanks

Thanks @canadaduane, @alexpineda, @juliangarnier and @FractalHQ for the support! 🚀

Requires three ≥ 0.138.0 < 0.151.0

Requires three ≥ 0.138.0 < 0.150.0

Changelog

⚠️ The minimum supported version of three was raised to r138.

Core

• EffectComposer
  • Removed usage of WebGLMultisampleRenderTarget. See #448.
• Timer
  • Fixed a type error. See #449.

Effects

• LUT3DEffect
  • Removed usage of DataTexture3D. See #448.

Special Thanks

Thanks @canadaduane, @alexpineda, @juliangarnier and all private sponsors for the support ❤️

Requires three ≥ 0.125.0 < 0.149.0

Changelog

Core

• Updated the Timer API.

Requires three ≥ 0.125.0 < 0.149.0

Changelog

Effects

• TiltShiftEffect
  • Deprecated bias as it is no longer needed for blending. See f368d08.

Package

• Added types to exports. See #438, thanks @FuriouZz!

Special Thanks

Thanks @canadaduane, @alexpineda, @juliangarnier and everyone who supported @pmndrs in 2022 🚀

Requires three ≥ 0.125.0 < 0.147.0

Changelog

• Fixed a documentation/type issue. See #415.

Requires three ≥ 0.125.0 < 0.146.0

Changelog

EffectComposer

• Added setMainScene and setMainCamera methods to allow changing the main scene/camera for all registered passes. See #410 and #391.
• Changing the renderer with setRenderer no longer affects the styles of the canvas element. See #411.

Materials

• BoxBlurMaterial, CircleOfConfusionMaterial, DepthComparisonMaterial, DepthMaskMaterial, EffectMaterial, SSAOMaterial
  • Renamed adoptCameraSettings to copyCameraSettings.
• BoxBlurMaterial
  • Added scale parameter and normalDepthBuffer support. See 35706c2.
• SSAOMaterial
  • Deprecated intensity setting.

Effects

• Effect
  • Added mainScene and mainCamera setters.
• GodRaysEffect, SelectiveBloomEffect
  • Renamed adoptCameraSettings to copyCameraSettings.
• OutlineEffect
  • Removed timer dependency. See 8160499.
• SSAOEffect
  • Added intensity setting.
  • Deprecated distanceScaling (now always on).
  • Deprecated normalDepthbuffer (will now be created automatically if possible).
  • Deprecated distanceThreshold, distanceFalloff, rangeThreshold and rangeFalloff (use the world-scale parameters instead).
• Added TiltShiftEffect. See #413, thanks @chasedavis!
  • Optimized tilt shift with Kawase blur. See 791d105.

Passes

• Pass
  • Added mainScene and mainCamera setters.
• EffectPass
  • Made varying detection more robust. See 3fa0440.
• DepthDownsamplingPass
  • Changed requirements from WebGL 2 to FloatType textures.
• EffectPass
  • Added timeScale setting. See bd595b1.
• MipmapBlurPass
  • Fixed levels setter. See #408.

Special Thanks

Thanks @canadaduane, @alexpineda and @juliangarnier for the support 🚀

Requires three ≥ 0.125.0 < 0.145.0

Changelog

Raised the minimum recommended version of three to r125.

EffectComposer

• Changed depth texture type back to UnsignedIntType.

Special Thanks

Thanks @canadaduane and @alexpineda for the continued support!

Requires three ≥ 0.107.0 < 0.144.0

Changelog

Core

• EffectComposer
  • Changed depth texture type to UnsignedInt248Type. See #402.

Materials

• Added BoxBlurMaterial.

Passes

• Added BoxBlurPass.
• MipmapBlurPass
  • Fixed a bug in dispose. See #398.

Types

• Updated types to improve compatibility with Angular. See #395.

Special Thanks

Thanks @vlucendo for supporting the project!

Requires three ≥ 0.107.0 < 0.144.0

Changelog

Addressed a breaking change caused by a shader function rename. See e69d6ed.

Effects

• SepiaEffect
  • Made color weights configurable via weightsR, weightsG and weightsB.
• BlendFunction
  • Marked blend functions that support HDR. See 4a77f6d.

Passes

• LuminancePass
  • Fixed unintended clamping of HDR colors by respecting the main frame buffer type.

Special Thanks

Thanks @canadaduane and @alexpineda for supporting the project!

Requires three ≥ 0.107.0 < 0.143.0

Changelog

Effects

• BloomEffect
  • Fixed a bug that caused incorrect darkening near the screen edges: before / after

Materials

• Up/DownsamplingMaterial
  • Optimized texture sampling.

Requires three ≥ 0.107.0 < 0.143.0

Changelog

Effects

• OutlineEffect
  • Fixed a bug that caused outlines to remain visible when the selection was empty. See #383.

Requires three ≥ 0.107.0 < 0.143.0

Changelog

Package

• Updated types. See #380.
• Temporarily changed the build target to es2019. See #378.

Core

• Resolution
  • The effective size will now be calculated on change.

Effects

• Effect & Pass
  • Made dispose less destructive. See #381.
• DepthOfFieldEffect
  • Minor optimizations.
• OutlineEffect
  • Added experimental multisampling setting (requires three >= r138). See da079c6, #379.

Passes

• GaussianBlurPass & KawaseBlurPass
  • Minor optimizations.

Special Thanks

Thanks @canadaduane for the continued support!

Requires three ≥ 0.107.0 < 0.142.0

Changelog

Loaders

• LUTCubeLoader & LUT3dlLoader
  • Fixed parsing of data points. See #375.

Effects

• BlendMode
  • Added blend functions COLOR, HUE, SATURATION, LUMINOSITY, LINEAR_DODGE, LINEAR_BURN, LINEAR_LIGHT, VIVID_LIGHT, HARD_LIGHT, HARD_MIX, INVERT, INVERT_RGB and PIN_LIGHT. See 1a9f0e7.
  • Optimized existing blend functions.
  • Replaced SKIP and SET with DST and SRC.
• ChromaticAberrationEffect & GlitchEffect
  • Removed blendFunction constructor parameter.
• BrightnessContrastEffect
  • Changed default blendFunction to SRC.

Requires three ≥ 0.107.0 < 0.142.0

Changelog

Core

• Resolution
  • Fixed scale not being copied in copy method.

Effects

• BloomEffect & SelectiveBloomEffect
  • Added mipmapBlur constructor parameter to enable Mipmap/Unreal bloom. See #103 and #309.
    Mipmap bloom will replace the current default bloom implementation in the next major release.
  • Added radius and levels constructor parameters.
  • Deprecated constructor parameters kernelSize, resolutionScale, resolutionX, resolutionY.
  • Deprecated resolution property.
• BrightnessContrastEffect
  • Input colors are now converted to sRGB.
• Effect
  • Added experimental inputColorSpace and outputColorSpace settings. See #370.
• PixelationEffect
  • Minor optimizations.
• Added FXAAEffect. See e6437d0.

Materials

• EffectMaterial
  • Deprecated all constructor parameters.
  • Deprecated methods setShaderParts, setDefines, setUniforms and setExtensions.
  • Added method setShaderData.
• DepthMaskMaterial
  • Depth will now be linearized for more accurate results. See 0c5c687.
• Added DownsamplingMaterial and UpsamplingMaterial. See 933fd58.

Passes

• EffectPass
  • Improved shader token collection by removing duplicates and false positives. See fef3493.
  • Removed manual verification of uniforms and varyings.
• GaussianBlurPass
  • Added iterations setting. See 69f1b31.
• ShaderPass
  • Made input uniform detection more robust.
• Added MipmapBlurPass. See 2238e84.

Requires three ≥ 0.107.0 < 0.142.0

Changelog

Reorganized folders, shaders and enums. See 5ce3511.

Core

• Added GaussKernel.

Effects

• Added SET blend function and improved existing blend functions. See 100a981.
• Added LUT1DEffect. See #371. Thanks @donmccurdy.
• BrightnessContrastEffect
  • Removed unnecessary clamp logic.
• ChromaticAberrationEffect
  • Implemented radial modulation. See 966958a.
• BloomEffect, DepthOfFieldEffect, GodRaysEffect, OutlineEffect
  • Reverted deprecation of resolutionScale constructor parameter.
  • Renamed width and height constructor parameters to resolutionX and resolutionY.

Materials

• DepthOfFieldEffect
  • The blur kernel will now be scaled according to resolution.scale for consistent results.
• Added GaussianBlurMaterial.
• CopyMaterial
  • Added support for dithering.
• KawaseBlurMaterial
  • Removed support for dithering.

Passes

• EffectPass
  • Changed visibility of effects back to private.
  • Added protected setEffects() method. See #367.
  • Fixed a potential null error in verifyResources.
• KawaseBlurPass
  • The blur kernel will now be scaled according to resolution.scale for consistent results.
  • The last blur pass will now properly be performed on a downscaled buffer. See 6780dac.
  • Changed default kernelSize to MEDIUM.
• Added GaussianBlurPass.
• DepthDownsamplingPass, DepthPass, KawaseBlurPass, LuminancePass, NormalPass
  • Reverted deprecation of resolutionScale constructor parameter.
  • Renamed width and height constructor parameters to resolutionX and resolutionY.