v6.28.6

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!

v6.28.5

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!

v6.28.4

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.

v6.28.3

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.

v6.28.2

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!

v6.28.1

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.

v6.28.0

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.

v6.27.0

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.

v6.26.4

Requires three ≥ 0.107.0 < 0.141.0

Changelog

Effects

• BloomEffect
  • Fixed luminanceSmoothing constructor parameter.
  • Output will no longer be clamped to [0.0, 1.0].
• GodRaysEffect
  • Added depthMaskMaterial getter.
• SelectiveBloomEffect
  • Fixed a bug that broke depth masking when the selection was empty.
• ToneMappingEffect
  • Added accessors for whitePoint, middleGrey and averageLuminance.

Materials

• DepthMaskMaterial
  • Changed default value of epsilon to 1e-4.

Passes

• EffectPass
  • Changed visibility of effects to protected.
  • Changed visibility of updateMaterial to protected.
  • Reverted deprecation of dithering.

Special Thanks

Thanks @canadaduane for the continued support!

v6.26.3

Requires three ≥ 0.107.0 < 0.140.0