Skip to content

Releases: pmndrs/postprocessing

v6.24.0

07 Feb 01:50
@vanruesc vanruesc
v6.24.0
fbc246e
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v6.24.0

Requires three ≥ 0.102.0 < 0.138.0

Changelog

Attention: The changes made in this release are currently being revised. It's recommended to not switch to the newly added methods just yet as there's a chance that they will partly be replaced with accessor properties. See #349.

This release adds accessor methods to consolidate the configuration API. It should no longer be necessary to access undocumented uniforms of materials or effects directly. The demo has not yet been updated to use the new methods because it will be replaced by the manual.

Package

  • Changed ESM bundle name from postprocessing.esm.js to postprocessing.mjs.

Core

  • EffectComposer
    • Internal frame buffers are now always RGBA. See #338.
    • Deprecated replaceRenderer method.
    • Added setRenderer method. See 009edf8 and #337.
  • Selection
    • Deprecated exclusive.
    • Added methods isExclusive, setExclusive.
  • Resizer
    • Renamed to Resolution.
    • Deprecated resizable, base, target, scale.
    • Added methods copy, getWidth, getHeight, getScale, setScale, getBaseWidth, setBaseWidth, getBaseHeight, setBaseHeight, setBaseSize, getPreferredWidth, setPreferredWidth, getPreferredHeight, setPreferredHeight, setPreferredSize.
    • Resolution now dispatches "change" events when the base size or preferred size is changed.

Effects

  • BlendMode
    • Changed visibility of opacity to private.
    • Added methods getOpacity, setOpacity.
  • Effect
    • Changed visibility of name to private.
    • Changed visibility of defines, uniforms, extensions and blendMode to protected.
    • Added methods getName, getDefines, getUniforms, getExtensions, getBlendMode, setRenderer.
  • BloomEffect
    • Deprecated intensity, luminancePass, luminanceMaterial, blurPass, texture, resolution.
    • Added methods getBlurPass, getIntensity, setIntensity, getLuminancePass, getLuminanceMaterial, getBlurPass, getTexture, getResolution.
  • BrightnessContrastEffect
    • Added methods getBrightness, setBrightness, getContrast, setContrast.
  • ChromaticAberrationEffect
    • Deprecated offset.
    • Added methods getOffset, setOffset.
    • Simplified the shader by always handling alpha.
  • DepthEffect
    • Deprecated inverted.
    • Added methods isInverted setInverted.
  • DepthOfFieldEffect
    • Deprecated bokehScale, blurPass, target, circleOfConfusionMaterial, resolution.
    • Added methods getBokehScale, setBokehScale, getBlurPass, getTarget, setTarget, getCircleOfConfusionMaterial and getResolution.
  • DotScreenEffect
    • Added getAngle method .
  • GodRaysEffect
    • Deprecated blur, samples.
    • Added methods getSamples, setSamples.
  • OutlineEffect
    • Deprecated blur, xRay,
    • Added methods isXRayEnabled, setXRayEnabled
  • GlitchEffect
    • Deprecated delay, duration, strength, mode, ratio, chromaticAberrationOffset, active.
    • Added methods getMinDelay, setMinDelay, getMaxDelay, setMaxDelay, getMinDuration, setMinDuration, getMaxDuration, setMaxDuration, getMinStrength, setMinStrength, getMaxStrength, setMaxStrength, getMode, setMode, isActive, getGlitchRatio, setGlitchRatio, getChromaticAberrationOffset, setChromaticAberrationOffset.
    • The generated perturbation map will now be disposed automatically.
    • Renamed uniform seed to seeds.
  • GodRaysEffect
    • Deprecated blurPass, texture, resolution, godRaysMaterial.
    • Added methods getBlurPass, getGodRaysMaterial, getResolution, getTexture.
  • HueSaturationEffect
    • Added methods getSaturation, setSaturation, getHue.
  • NoiseEffect
    • Deprecated premultiply.
    • Added methods isPremultiplied, setPremultiplied.
  • OutlineEffect
    • Deprecated blurPass, selection, pulseSpeed, resolution.
    • Added methods getBlurPass, getSelection, getPulseSpeed, setPulseSpeed, getResolution.
  • SelectiveBloomEffect
    • Deprecated selection, depthMaskMaterial, inverted, ignoreBackground.
    • Added methods getSelection, getDepthMaskMaterial, isInverted, setInverted, isBackgroundDisabled, setBackgroundDisabled.
  • SepiaEffect
    • Added methods getIntensity, setIntensity.
  • ShockWaveEffect
    • Deprecated epicenter, speed.
    • Added methods getPosition, setPosition, getSpeed, setSpeed.
  • SMAAEffect
    • Deprecated edgeDetectionMaterial, weightsMaterial.
    • Added methods getEdgeDetectionMaterial, getWeightsMaterial, getEdgesTexture, getWeightsTexture.
  • SSAOEffect
    • Deprecated resolution, distanceScaling, samples, rings, color, depthAwareUpsampling, setDistanceCutoff, setProximityCutoff.
    • Added methods getResolution, isDepthAwareUpsamplingEnabled, setDepthAwareUpsamplingEnabled, getColor, setColor.
  • TextureEffect
    • Deprecated texture, uvTransform.
    • Added methods getTexture setTexture.
    • UV transformations on the texture will now always be respected.
  • ToneMappingEffect
    • Removed HalfFloat requirement. See 80089eb.
    • Deprecated resolution, mode, adaptationRate.
    • Added methods getResolution, setResolution, getMode, setMode.
  • VignetteEffect
    • Deprecated eskil.
    • Added VignetteTechnique enum.
    • Added methods getTechnique, setTechnique, getOffset, setOffset, getDarkness, setDarkness.

Loaders

  • SMAAImageGenerator
    • Deprecated disableCache.
    • Added setCacheEnabled method.

more-kylo-ren

Materials

  • AdaptiveLuminanceMaterial
    • Added methods setLuminanceBuffer0, setLuminanceBuffer1, setMipLevel1x1, setDeltaTime, getAdaptationRate, setAdaptationRate, getMinLuminance, setMinLuminance.
  • BokehMaterial
    • Deprecated setTexelSize.
    • Added methods setInputBuffer, setCoCBuffer, getScale, setScale, setSize.
  • CircleOfConfusionMaterial, DepthDownsamplingMaterial, EdgeDetectionMaterial, EffectMaterial, SSAOMaterial
    • Deprecated depthPacking.
    • Added setDepthBuffer method.
  • CircleOfConfusionMaterial
    • Added methods getFocusDistance, setFocusDistance, getFocalLength, setFocalLength.
  • CopyMaterial
    • Added methods setInputBuffer, getOpacity, setOpacity.
  • ConvolutionMaterial
    • Renamed to KawaseBlurMaterial.
    • Added methods setInputBuffer, getScale, setScale, setKernel.
  • DepthComparisonMaterial, DepthCopyMaterial
    • Added setDepthBuffer method.
  • DepthCopyMaterial
    • Added methods getTexelPosition, setTexelPosition.
  • DepthDownsamplingMaterial
    • Added setNormalBuffer method.
  • DepthMaskMaterial
    • Deprecated keepFar.
    • Added methods getDepthTestStrategy, setDepthTestStrategy, setDepthBuffer0 and setDepthBuffer1.
    • Created DepthTestStrategy enum.
    • Removed uniforms bias0 and bias1.
  • EdgeDetectionMaterial
    • Added methods getEdgeDetectionMode, setEdgeDetectionMode, getLocalContrastAdaptationFactor, getEdgeDetectionThreshold, getPredicationMode, getPredicationThreshold, getPredicationScale, getPredicationStrength.
  • EffectMaterial
    • Section enum is now a static class member.
    • Added methods setInputBuffer, setExtensions, isOutputEncodingEnabled, setOutputEncodingEnabled and setDeltaTime.
  • GodRaysMaterial
    • Deprecated samples
    • Added methods getSamples, setSamples, getDensity, setDensity, getDecay, setDecay, getWeight, setWeight, getExposure, setExposure, getMaxIntensity, setMaxIntensity, setInputBuffer, getLightPosition and setLightPosition.
  • LuminanceMaterial, MaskMaterial, OutlineMaterial, SMAAWeightsMaterial.
    • Added setInputBuffer method.
  • LuminanceMaterial
    • Deprecated colorOutput, threshold, smoothing, useThreshold and useRange.
    • Added methods isColorOutputEnabled, setColorOutputEnabled, getThreshold, setThreshold. getSmoothingFactor, setSmoothingFactor, getLuminanceRange, setLuminanceRange.
  • MaskMaterial
    • Deprecated colorChannel, maskFunction, maskTexture, inverted, strength.
    • Added methods getColorChannel, setColorChannel, getMaskFunction, setMaskFunction, setMaskTexture, isInverted, setInverted, getStrength, setStrength.
  • SMAAWeightsMaterial
    • Deprecated diagonalDetection, cornerRounding.
    • Added methods isDiagonalDetectionEnabled, setDiagonalDetectionEnabled, isCornerRoundingEnabled, setCornerRoundingEnabled, setLookupTextures.
  • SSAOMaterial
    • Deprecated setTexelSize.
    • Added methods setSize, setNormalBuffer, setDepthBuffer, setNormalDepthBuffer, setNoiseTexture, getSamples, setSamples, getRings, setRings, getIntensity, setIntensity, getFade, setFade, getBias, setBias, getMinRadiusScale, setMinRadiusScale, getRadius, setRadius, isDistanceScalingEnabled, setDistanceScalingEnabled, setDistanceCutoff, setProximityCutoff.

Passes

  • Pass
    • Added setRenderer method.
  • AdaptiveLuminancePass
    • Deprecated adaptationRate, texture, mipLevel1x1.
    • Added getTexture method.
  • BlurPass
    • Renamed to KawaseBlurPass.
    • Deprecate resolution.
    • Added getResolution method.
  • ClearPass
    • Deprecated color, depth, stencil, overrideColor, overrideAlpha.
    • Added methods setClearFlags, getOverrideClearColor, setOverrideClearColor, getOverrideClearAlpha, setOverrideClearAlpha.
  • DepthSavePass
    • Renamed to DepthCopyPass.
    • Maximum depth will now be preserved. See #340.
    • Deprecated texture, depthPacking.
    • Added methods getTexture, setDepthBuffer, getDepthPacking.
  • DepthPass, DepthDownsam...
Read more
Assets 2
Loading

v6.23.5

14 Jan 02:11
@vanruesc vanruesc
v6.23.5
530792c
Compare
Choose a tag to compare
v6.23.5

Requires three ≥ 0.102.0 < 0.137.0

Changelog

Core

Assets 2
Loading

v6.23.4

09 Jan 19:32
@vanruesc vanruesc
v6.23.4
4a560de
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v6.23.4

Requires three ≥ 0.102.0 < 0.137.0

Changelog

Core

  • EffectComposer
    • Fixed an issue that prevented the alpha constructor parameter from working. See ae1b140.
    • Frame buffers will now be properly invalidated when the multisampling value is changed. See b61e1c3.
    • The render info will now be updated manually to make sure the information doesn't get reset between consecutive render calls. See 1d73bd1.

Effects

  • TextureEffect
    • Handle re-enabled usage of SRGB8_ALPHA8 in three r136.
  • SSAOEffect & GlitchEffect
    • Changed format of noise textures to RGBFormat to avoid issues with LuminanceFormat.

Materials

  • Changed materials to specify name instead of type.

Textures

  • LookupTexture3D & NoiseTexture
    • Explicitly set needsUpdate to true.

Miscellaneous

  • Created manual. The manual is a work in progress that will eventually replace the demos with simpler examples and accompanying explanations.
Assets 2
Loading

v6.23.3

06 Dec 15:06
@vanruesc vanruesc
v6.23.3
97510a4
Compare
Choose a tag to compare
v6.23.3

Requires three ≥ 0.102.0 < 0.136.0

Changelog

Effects

  • TextureEffect
    • Handle disabled usage of SRGB8_ALPHA8 in three r135.
Assets 2
Loading

v6.23.2

28 Oct 21:35
@vanruesc vanruesc
v6.23.2
a3c9745
Compare
Choose a tag to compare
v6.23.2

Requires three ≥ 0.102.0 < 0.135.0

Assets 2
Loading

v6.23.1

03 Oct 18:39
@vanruesc vanruesc
v6.23.1
c7449ed
Compare
Choose a tag to compare
v6.23.1

Requires three ≥ 0.102.0 < 0.134.0

Changelog

Effects

  • TextureEffect
    • Shader-based inline texture decoding will now be disabled for SRGB8_ALPHA8 textures in three ≥ 133.
  • OutlineEffect
    • Added inline decoding support for sRGB pattern textures.
Assets 2
Loading

v6.23.0

24 Sep 15:01
@vanruesc vanruesc
v6.23.0
07b3bfc
Compare
Choose a tag to compare
v6.23.0

Requires three ≥ 0.102.0 < 0.133.0

Changelog

Core

  • EffectComposer
    • The deltaTime parameter of the render method is now optional.
  • Selection
    • Added getLayer and setLayer methods.
    • Deprecated layer accessor.

Effects

  • OutlineEffect & SelectiveBloomEffect
    • Changed default selection layers to avoid collision.

Passes

  • Pass
    • Added isEnabled and setEnabled methods.
    • Deprecated direct access to enabled flag.
  • RenderPass
    • Added setBackgroundDisabled method.
    • Added setShadowMapDisabled method.
    • Added getSelection and setSelection methods.
  • DepthPass & NormalPass
    • The scene background will now be ignored.
    • Automatic shadow map updates will now be avoided.
Assets 2
Loading

v6.22.5

30 Aug 22:07
@vanruesc vanruesc
v6.22.5
ec8fd91
Compare
Choose a tag to compare
v6.22.5

Requires three ≥ 0.102.0 < 0.133.0

Changelog

NPM Package

  • Renamed postprocessing.mjs back to postprocessing.esm.js due to issues with create-react-app. See #312.
Assets 2
Loading

v6.22.4

30 Aug 14:52
@vanruesc vanruesc
v6.22.4
ad83ffc
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v6.22.4

Requires three ≥ 0.102.0 < 0.133.0

Changelog

NPM Package

  • Renamed postprocessing.esm.js to postprocessing.mjs to support native importing in node.

Demos

  • Added smooth camera movement.

Miscellaneous

  • Fixed code formatting issues.
Assets 2
Loading

v6.22.3

30 Jul 22:42
@vanruesc vanruesc
v6.22.3
e8c7911
Compare
Choose a tag to compare
v6.22.3

Requires three ≥ 0.102.0 < 0.132.0

Changelog

Miscellaneous

  • Added engines field to package.json with node set to >= 0.13.2.
Assets 2
Loading