v3.2.0

This release adds five new effects (LensDistortion, Kuwahara, Linocut, Halftone, Sharpness), a way to exclude objects from a selection, and a cheaper default for MSAA. It also fixes a round of props that were typed but never reached the effect, or worked but were missing from the types.

Added

• LensDistortion: new effect, wraps postprocessing's LensDistortionEffect.
• Kuwahara: new painterly filter effect.
• Linocut: new linocut print effect, ported from TresJS post-processing.
• Halftone: new RGB halftone effect, ported from three.js' HalftoneShader.
• Sharpness: new sharpening effect. Based on the proposal in #253 by @imtns
• Select: new exclude prop to keep a subtree out of an enabled ancestor's selection.
• DepthOfField, Autofocus, GodRays, LUT, Outline, SelectiveBloom, SSAO: new opacity prop.
• FXAA: its live props are now typed, they always worked at runtime.
• SMAA: blendFunction is now typed.
• Types: GodRaysProps, LensFlareProps and SSAOProps are now exported.

Changed

• EffectComposer: default multisampling lowered from 8 to 4. Pass multisampling={8} to get the old default back. Based on the proposal in #346 by @kstgrd
• Texture: props now require exactly one of textureSrc or texture. Passing both, or neither, is now a type error.
• SSAO: color now accepts any color representation, not just a Color.

Fixed

• Texture: a pre-loaded texture no longer requires textureSrc or triggers a load.
• SelectiveBloom: blendFunction was ignored and always ADD, it now applies.
• Select: disabling a Select no longer drops objects another Select still selects.

Docs

• Example scenes linked from the effect and pass pages.
• Pages for the new effects and Select exclude.
• Bloom, Grid: props tables fixed to match the actual props.

What's Changed

• docs: Add examples for effects and passes by @kvvasuu in #382
• fix(Texture): skip loading when a texture is passed by @kvvasuu in #383
• feat: add LensDistortion effect by @kvvasuu in #384
• feat: add Kuwahara effect by @kvvasuu in #385
• feat: add Linocut effect by @kvvasuu in #386
• feat: add Halftone effect by @kvvasuu in #387
• feat: add Sharpness effect by @kvvasuu in #389
• perf(EffectComposer): lower default multisampling to 4 by @kvvasuu in #390
• feat(Select): add exclude prop by @kvvasuu in #391
• Chore/prop types audit by @kvvasuu in #392

Full Changelog: v3.1.3...v3.2.0