LithoSphere

A free tile-based 3D globe renderer built with Three.js

LithoSphere is a completely free and open-sourced tile-based 3D globe renderer. First built within the Geographical Information System (GIS) application MMGIS, LithoSphere has been pulled out and refactored into a standalone, mapping focused, JavaScript library. At its core sits the brilliant Three.js library with all its extensible familiarity.

LIVE DEMO

Quick Start

npm install lithosphere

Head over to the Documentation pages for more or checkout /example.html.

Features

• Fully configurable layer types:
  • Vector
  • Clamped
  • Overlay (upcoming)
  • Tile
  • Tile3d
  • Model
  • Curtain
• Adjustable planetary radii
• Scripts for tiling Digital Elevation Maps (DEM) and custom projections
• Various tile formats:
  • TMS
  • WMTS
  • WMS
• Full Proj4 support to render tile sets of any projection
• A suite of pluginable UI controls:
  • Compass
  • Layers
  • Walk
  • Observe
  • Home
  • Exaggerate
  • Crop (upcoming?)
  • Controls
  • Coordinates
  • Link
• The ability to use custom parsers for your own tiled data formats
• And more!

LithoSphere CHANGELOG

Official Releases

v1.5.4

Oct 18, 2022

Fixed

• Support the elevOffset styling even if an elevation is already set in geometry.coordinates

v1.5.3

Oct 5, 2022

Added

• Model Layers can now accept an array of model paths

v1.5.2

Sept 15, 2022

Added

• The Coordinate Control now has an onChange handler

v1.5.1

May 24, 2022

Fixed

• Proper annotation borders and centered anchors

v1.5.0

May 23, 2022

Added

• Support for clamped and vector layer annotations
• Support for clamped and vector layer visibility cutoffs

Fixed

• Near-Far plane issues with large planetary radii.

v1.4.2

May 5, 2022

Added

• New orderLayers function

v1.4.1

May 2, 2022

Added

• New initialCamera constructor option

v1.4.0

Mar 29, 2022

Added

• Navigation control
• Easting and northing boundingBoxEN option for tile layers

v1.3.0

Feb 23, 2022

Added

• Curtain layer type
• Full local data example

Fixed

• Removed extraneous addition of "ratio of surface areas" to reszoomlevel

v1.2.0

Jan 27, 2022

Added

• Apply filters and blend modes to tile layers with setLayerFilterEffect()

v1.1.0

Dec 13, 2021

Added

• Model layer type (.dae, .gltf, .obj)
• Bearings (directional arrows) for clamped vector points
• Keyboard navigation controls (wasd = pan, qe = rotate, rf = dolly, tg: zoom)

v1.0.3

Sep 01, 2021

Added

• {constructor}.demFallback

Fixed

• {vector/clamped layer}.letPropertiesStyleOverride

v1.0.2

Aug 19, 2021

Changed

• PNG.js and zlib.js are now modules instead of globals

v1.0.1

Jul 22, 2021

Added

• Support for WMS tiles of any projection
• A .tif tile parser

v1.0.0

Jun 15, 2021

LithoSphere's first release!