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

v6.26.2

Requires three ≥ 0.107.0 < 0.139.0

Changelog

Effects

• SMAAEffect
  • Fixed load event. See 5aa2d5a.

v6.26.1

Requires three ≥ 0.107.0 < 0.139.0

Changelog

Package

Added auto-generated types. Warning: expect errors. Thanks @superguigui.

Effects

• SMAAEffect
  • The effect will now emit a load event when the internal textures have been loaded.
  • Fixed: preloaded images will now be picked up again, if provided.

v6.26.0

Requires three ≥ 0.107.0 < 0.139.0

Postprocessing has recently joined the Poimandres organization 🎉 The motivation behind this is to get more eyes on postprocessing and to ensure that the library continues to evolve as part of something bigger. Apart from that, nothing really changes though! — vanruesc

Changelog

Effects

• BlendMode
  • Added blendFunction accessor.
  • Deprecated getBlendFunction and setBlendFunction.
• ColorAverageEffect & SepiaEffect
  • Minor optimizations.
• DepthOfFieldEffect
  • Renamed circleOfConfusionMaterial to cocMaterial. See 110a381.
  • Fixed calculateFocusDistance. See 2e1b6a8, 2fafb76 and 3739f62.
  • Added constructor parameters worldFocusDistance and worldFocusRange. See 660dd2c.
  • Renamed constructor parameter focalLength to focusRange.
• ScanlineEffect
  • Added support for scrolling scanlines.
  • Added scrollSpeed accessor.
• SMAAEffect
  • It's no longer necessary to preload the search and area lookup textures. See 164a927.
  • The constructor now accepts the named parameters preset, edgeDetectionMode and predicationMode. The old signature is still supported.
• SSAOEffect
  • Fixed a bug that prevented the effect from receiving a depth texture. See 5272f55.
  • Added constructor parameters worldDistanceThreshold, worldDistanceFalloff, worldProximityThreshold and worldProximityFalloff. See 397e287.
  • Added luminanceInfluence accessor.
  • Changed default of minRadiusScale constructor parameter to 0.1.
  • Made depthAwareUpsampling setting more robust. See e5f10f2.

Loaders

• Deprecated SMAAImageLoader.

Materials

• CircleOfConfusionMaterial
  • Renamed focalLength to focusRange. See c9c43f1.
  • Added worldFocusDistance and worldFocusRange accessors. See 3868614.
• SSAOMaterial
  • Added worldDistanceThreshold, worldDistanceFalloff, worldProximityThreshold and worldProximityFalloff accessors. See 6777946.

Special Thanks

Thanks @canadaduane for the financial support!

v6.25.0

Requires three ≥ 0.107.0 < 0.139.0

Attention: Inheritance of legacy classes such as DataTexture3D is broken in three r138 (mrdoob/three.js#23612) and will be fixed in r139 (mrdoob/three.js#23621). It's recommended to skip r138 if you use LUTEffect.

Changelog

Following #349, the getter and setter methods that were introduced in 6.24.0 have been replaced by accessor properties. Methods of the form getFoo and setFoo are now properties of the form foo with some exceptions listed below. For details see 387d5b0, f98d002, 276ee71, de14746, 07617b6, 87f1083, 55f5d39, d5c91e2.

Core

• EffectComposer
  • It's no longer necessary to use HalfFloatType buffers for sRGB workflows. See 0bf4407.
  • Handled removal of WebGLMultisampleRenderTarget.
  • Timer auto reset behaviour will now be restored on reset.
• Selection
  • Added toggle method.

Effects

• Effect
  • Fixed unintentional disposal of renderer. See #353.
  • Deprecated renderer and setRenderer.
• ChromaticAberrationEffect
  • The offset now respects the aspect ratio.
• GlitchEffect
  • Deprecated generatePerturbationMap.
  • Replaced getGlitchColumns and setGlitchColumns with columns accessor.
  • Replaced getGlitchRatio and setGlitchRatio with ratio accessor.
• NoiseEffect
  • Replaced isPremultiplied and setPremultiplied with premultiply accessor.
• OutlineEffect
  • Added patternScale constructor parameter.
  • Added accessors patternScale, edgeStrength, visibleEdgeColor and hiddenEdgeColor.
• ShockWaveEffect
  • Added accessors amplitude, waveSize and maxRadius.

Materials

• AdaptiveLuminanceMaterial
  • Removed LinearMipMapLinearFilter import and raised minimum version of three to r107.
• DepthComparisonMaterial
  • Changed default depth packing strategy to RGBADepthPacking. See #351.

Passes

• Pass
  • Fixed unintentional disposal of renderer. See #353.
  • Deprecated renderer and setRenderer.
• CopyPass
  • Replaced resize with autoResize.
• EffectMaterial
  • Added encodeOutput and time accessors.
• LuminanceMaterial
  • Replaced getSmoothingFactor and setSmoothingFactor with smoothing accessor.
• SMAAMaterial
  • Replaced setLookupTextures with searchTexture and areaTexture accessors.
  • Replaced setCornerRoundingEnabled with cornerDetection accessor.
• SSAOMaterial
  • Replaced setDistanceCutoff with distanceThreshold and distanceFalloff accessors.
  • Replaced setProximityCutoff with proximityThreshold and proximityFalloff accessors.

Textures

• LookupTexture3D
  • Renamed to LookupTexture.

Miscellaneous

• Updated the manual.