Release 2026-04-05

atmosphere@0.18.0

Changed

• WebGPU entry point (@takram/three-atmosphere/webgpu) requires three >= 0.182.0.

• BREAKING: Nodes and objects no longer take atmosphereContext as a constructor parameter. Use renderer.contextNode instead.

  Before:

  import {
    aerialPerspective,
    AtmosphereContextNode,
    AtmosphereLight
  } from '@takram/three-atmosphere/webgpu'
  
  const atmosphereContext = new AtmosphereContextNode()
  
  const node = aerialPerspective(atmosphereContext, colorNode, depthNode)
  const light = new AtmosphereLight(atmosphereContext)

  After:

  import {
    aerialPerspective,
    AtmosphereContext,
    AtmosphereLight
  } from '@takram/three-atmosphere/webgpu'
  import { context } from 'three/tsl'
  
  // AtmosphereContextNode is replaced by AtmosphereContext:
  const atmosphereContext = new AtmosphereContext()
  
  // Instead of passing the atmosphere context in the parameter of classes and
  // functions, create `getAtmosphere: () => AtmosphereContext` in the
  // renderer's global context:
  renderer.contextNode = context({
    ...renderer.contextNode.value, // Merge with the existing context values
    getAtmosphere: () => atmosphereContext
  })
  
  // The atmosphere context parameter must then be omitted:
  const node = aerialPerspective(colorNode, depthNode)
  const light = new AtmosphereLight()

• Deprecated AtmosphereContextNode and renamed it to AtmosphereContext.

• Changed default values for depthTest and depthWrite in SkyMaterial and StarsMaterial.

• Deprecated SKY_RENDER_ORDER, which is no longer used.

• BREAKING: Replaced MoonNode.normalNode with MoonNode.displacementNode.

Fixed

• Fixed StarsMaterial not fully appearing over post-processing sky, #28.

clouds@0.7.4

This release contains internal dependency updates only.

core@0.8.0

Added

• Added ScreenSpaceShadowNode.

Changed

• WebGPU entry point (@takram/three-geospatial/webgpu) requires three >= 0.182.0.
• BREAKING: Removed RTTTextureNode and convertToTexture. Use RTTNode and convertToTexture in three/tsl instead.
• BREAKING: Changed the UV of EllipsoidGeometry to make (0, 0.5) coincide with the prime meridian without rotation. You might need to change the rotation of the mesh.
• Deprecated the higher-order function signature of temporalAntialias.
• TemporalAntialiasNode: Improved subpixel correction.

Fixed

• TemporalAntialiasNode: Fixed ghosting when resizing canvas.

effects@0.6.2

This release contains internal dependency updates only.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/core@0.7.1...core@0.8.0

Release 2026-03-23

General

Fixed

• Fixed depth test when logarithmic depth is used with postprocessing >= 6.38.0, #100.

atmosphere@0.17.1

clouds@0.7.3

core@0.7.1

• Fixed convolution filters not being compiled with three@0.183.0.

effects@0.6.1

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/core@0.7.0...core@0.7.1

Release 2026-03-10

clouds@0.7.1

Fixed

• Fixed clouds not appearing when logarithmic depth is used, #102.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/clouds@0.7.0...clouds@0.7.1

Release 2026-03-09

General

Changed

• Updated the peer dependency for postprocessing to >= 6.38.0.
• Updated dependencies.

Fixed

• Fixed logarithmic depth when used with postprocessing >= 6.38.0.

atmosphere@0.17.0

Changed

• PrecomputedTexturesLoader: Removed deprecated setTypeFromRenderer().
• Removed deprecated sunIrradiance and skyIrradiance options.
• Removed deprecated IrradianceMask.
• AerialPerspectiveEffect: Removed deprecated irradianceScale option.
• StarsMaterial: Removed deprecated radianceScale option.
• Removed deprecated useAtmosphereTextureProps hook.

clouds@0.7.0

Changed

• CloudsEffect: Removed deprecated skyIrradianceScale, groundIrradianceScale and accurateSunSkyIrradiance options.

core@0.7.0

Changed

• Migrated types to @types/three@0.182.0.

effects@0.6.0

Fixed

• Fixed type errors in decorators when used with postprocessing >= 6.38.0.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/atmosphere@0.16.0...atmosphere@0.17.0

Release 2025-12-24

atmosphere@0.16.0

Changed

• Migrated types to @types/three@0.181.0
• AerialPerspectiveEffect, AerialPerspectiveNode: Improved post-process lighting when normal buffer is disabled, 97.
• Updated dependencies.

clouds@0.6.0

Changed

• Migrated types to @types/three@0.181.0.
• Updated dependencies.

core@0.6.0

Changed

• Migrated types to @types/three@0.181.0.
• Updated dependencies.

effects@0.5.0

Changed

• Migrated types to @types/three@0.181.0.
• Updated dependencies.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/atmosphere@0.15.1...atmosphere@0.16.0

effects@0.4.2

Changed

• Removed module augmentation from type definitions.
• Updated dependencies.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/effects@0.4.1...effects@0.4.2

core@0.5.0

Added

• Added initial support for WebGPU / TSL. See WEBGPU.md for details.
• Added getMoonFixedToECIRotationMatrix.
• Ellipsoid: Added flattening, eccentricity.

Changed

• Removed module augmentation from type definitions.
• Updated dependencies.

Fixed

• Addressed usage of requestIdleCallback in SSR environment.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/core@0.4.0...core@0.5.0

clouds@0.5.1

Changed

• Removed module augmentation from type definitions.
• Updated dependencies.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/clouds@0.5.0...clouds@0.5.1

atmosphere@0.15.0

Added

• Added initial support for WebGPU / TSL. See WEBGPU.md for details.

Changed

• Removed module augmentation from type definitions.
• Updated dependencies.

Fixed

• Fixed USE_LOGARITHMIC_DEPTH_BUFFER was not respected.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/atmosphere@0.14.0...atmosphere@0.15.0

effects@0.4.1

Changed

• Updated dependencies.

Full Changelog: https://github.com/takram-design-engineering/three-geospatial/compare/effects@0.4.0...effects@0.4.1