Requires three ≥ 0.157.0 < 0.182.0

This release contains potential breaking changes for DepthOfFieldEffect and effect blending in general. If you encounter any unexpected issues, please create a bug report.

What's Changed

• Update CI/CD workflows
• Update dependencies
• EffectComposer
  • Remove unused ignoreDepthForMultisampleCopy
• DepthOfFieldEffect & CircleOfConfusionMaterial
  • Fix alpha of far color buffer
  • Implement distance-based CoC, see #426
  • CircleOfConfusionMaterial
    • focusRange and focusDistance are now always in world units
    • Deprecate worldFocusDistance and worldFocusRange
• GodRaysEffect
  • Improve light source masking
  • Reduce flickering
  • Fix alpha blend bug, see #730
• CopyPass
  • CopyMaterial
    • Backport support for depth copying from v7
    • Add channelWeights for masking
• BlendMode
  • Deprecate ALPHA blend function, use NORMAL instead
  • All blend functions now consider alpha
• SSAOMaterial, DepthPass, DepthComparisonMaterial, EffectMaterial, DepthMaskMaterial, CircleOfConfusionMaterial
  • Add support for logarithmic depth and reversed depth
• Pass
  • The default camera is now an OrthographicCamera instead of Camera

Full Changelog: v6.37.8...v6.38.0

Special Thanks

Thanks @juliangarnier and @donmccurdy for the continued support! ❤️

Requires three ≥ 0.179.0 < 0.181.0

Migration Guide

What's Changed

• CDL implementation for tone mapping #723
• Improve shader manipulation for G-Buffer rendering 3170990, 9330b88, 0f4fe92
• Write out roughness from lights_physical_fragment 89c3f6b
• Handle render info auto reset f8b2e03
• Fix clearing without background #708 (comment) a40bb34
• Export gbuffer ouput shader chunks 5d0e62f
• Various manual updates

Full Changelog: v7.0.0-beta.13...v7.0.0-beta.14

Requires three ≥ 0.157.0 < 0.181.0

What's Changed

• Fix load/loadAsync implementations in LUT3dlLoader and LUTCubeLoader
• Improve type declarations, see #728
• Update dependencies

Full Changelog: v6.37.7...v6.37.8

Special Thanks

Thanks @juliangarnier and @donmccurdy for the continued support! 🚀

Requires three ≥ 0.179.0 < 0.180.0

Migration Guide

What's Changed

• Handle external breaking changes f630106
• Prevent unintentional canvas style update d71e8d6
• Add viewMatrix to FullscreenMaterial uniforms f6c8673
• Fix camera macro bug fa04eb9
• Adjust SMAA presets aae0c42
• Fix default G-Buffer output 2597768
• Fix getDistance function 06c067d, b744f09
• BloomEffect, TextureEffect
  • Improve output alpha calculation #719, 84e6574
  • Create LuminanceHighPassMaterial ba92ef5
  • Remove LuminanceMaterial 7e61527
• Pass
  • Remove renderer parameter from Pass.checkRequirements 02f1661
  • Process all fullscreen materials on I/O change 5292a36
  • Improve compilation of fullscreen materials 29885f4
  • Add autoSyncDefaultBuffers 584197b
  • Auto update the resolution of fullscreen materials 16fcf76, dba8102
• GeometryPass
  • Make writing to G-Buffer more robust #708, 6255b45, 49399b2, 282097a, 4b00a10, 8c1ce0f, c265e3d
  • Always use HalfFloatType for emission 495b8ac, c810a07, 14a7c02
  • Change default depth texture type to FloatType 0686901
  • Encode normals and change format to RGFormat 9db09da
  • Accept null for scene and camera in constructor 528ccf1
• EffectPass
  • Make effects setter public a6de40c
• BufferDebugPass
  • Add DISTANCE debug mode fcfa022
• Allow null param in Selection constructor 2623258
• Use IUniform 529d3d1
• Various updates for the manual

Full Changelog: v7.0.0-beta.12...v7.0.0-beta.13

Requires three ≥ 0.157.0 < 0.180.0

What's Changed

• LuminanceMaterial
  • Preserve alpha and improve masking 574ec0d
• Update dependencies

Full Changelog: v6.37.6...v6.37.7

Special Thanks

Thanks @juliangarnier and @donmccurdy for the continued support! ❤️

Requires three ≥ 0.157.0 < 0.179.0

What's Changed

• BloomEffect, TextureEffect
  • Improve output alpha calculation dc88f87, #719
• BloomEffect
  • Change default of mipmapBlur to true 868079f
  • Change luminance threshold and smoothing defaults 885c0a0

This release changes some default values for BloomEffect constructor parameters.
You may need to tweak the luminance threshold and smoothing values depending on your use case:

const bloomEffect = new BloomEffect(scene, camera, {
  mipmapBlur: false, // default: true
  luminanceThreshold: 0.9, // default: 1.0
  luminanceSmoothing: 0.025, // default: 0.03
  ...
});

Full Changelog: v6.37.5...v6.37.6

Requires three ≥ 0.157.0 < 0.179.0

What's Changed

• Improve blend functions d33675b, #706
• Update dependencies

Full Changelog: v6.37.4...v6.37.5

Special Thanks

Thanks @juliangarnier and @donmccurdy for the continued support! 🚀

Requires three ≥ 0.174.0 < 0.178.0

What's Changed

• Add internalFormat to GBufferTextureConfig 893eb1c
• Add normal-codec-pars.frag 52f9115
• Fix normal clear value d8ede8d
• Simplify clear values and flags cc53845 99db4c2
• Update gbuffer-default-output.frag df82f27
• Update BufferDebugPass 38a6f21 521d6fc f68ed61
• DepthCopyPass
  • Add mode accessor 4e69472
• DepthPickingPass
  • Add support for reverse and log depth 642e4ba
• CopyPass
  • Fix feedback loop in shader-based copy path 3ad7693
  • Make blit optional (disabled by default) 676e2ca
• GeometryPass
  • Add alpha setting (disabled by default)
  • Use R11F_G11F_B10F if applicable 7b2c5d9, 3f1b136, #661
  • Create GBuffer struct based on gBuffer components instead of gData 9db96a6
  • Use NearestFilter for ORM
  • Expand shader manipulation to more object types a018bde #708
• EffectPass
  • Improve GData depth read 8ecca6e
  • Throw if effects are invalid or can't be merged 4e82932
  • Refresh gBuffer components on effect change 1f95d07
  • Optimize internal event dispatching 6747ab9 0bc1331
• Update dependencies
• Various updates for the manual

Full Changelog: v7.0.0-beta.11...v7.0.0-beta.12

Requires three ≥ 0.157.0 < 0.178.0

What's Changed

• Update dependencies and add threejs 177 support by @mohammadbaghaei in #704

Full Changelog: v6.37.3...v6.37.4

Special Thanks

Thanks @juliangarnier and @donmccurdy for the continued support! ❤️

Requires three ≥ 0.174.0 < 0.177.0

What's Changed

• Use common.vert as default vertex shader dad3e25
• Add support for reverse depth 62fc5e9, 24b0c56
• Remove LuminanceFormat usage 7b40c8a
• Set visibility of GeometryPass.textureConfigs to protected f62276b
• Refactor event types 4768a46, ccad88a
• Fix custom-effects docs #698, a8dc436
• Manage GData buffer sources #698, 05b12de
• Fix GData initialization order 1eea864
• Fix luminance pass event listener in BloomEffect e9a89ef
• Move onSceneChildAdded/Removed hooks to Pass 3523401, 51055b9
• Implement NoiseEffect 0be9718, cb4d1f5, #597, #692
• Suppress events when restoring G-Buffer 7340766, a41bd7e
• Move lut param to options object in LUT1D/3DEffect 1fb2e7e
• Remove resolutionScale param from GaussianBlurPass 30a5913
• Harmonize options and documentation 1884bbe

Full Changelog: v7.0.0-beta.10...v7.0.0-beta.11