Skip to content

Add PMTiles plugin with MVT support #1469

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AlaricBaraou wants to merge 1 commit into
base: master
Choose a base branch
from
+747 −3
Open

Add PMTiles plugin with MVT support #1469

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions example/three/pmtiles.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
<title>PMTiles Globe Example</title>
<link rel="icon" type="image/x-icon" href="../favicon.ico" />
<style>
html, body {
margin: 0;
padding: 0;
width: 100%;
height: 100%;
overflow: hidden;
}
</style>
</head>
<body>
<script type="module" src="pmtiles.js"></script>
</body>
</html>
176 changes: 176 additions & 0 deletions example/three/pmtiles.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,176 @@
import {
Scene,
WebGLRenderer,
PerspectiveCamera,
AmbientLight,
DirectionalLight,
} from 'three';
import {
TilesRenderer,
GlobeControls,
} from '3d-tiles-renderer';
import {
UpdateOnChangePlugin,
PMTilesPlugin,
} from '3d-tiles-renderer/plugins';
import { GUI } from 'three/examples/jsm/libs/lil-gui.module.min.js';

let scene, renderer, camera, controls, tiles, gui;

// Layer configuration for Protomaps v4 basemap
const LAYERS = {
water: { enabled: true, color: '#4a90d9' },
earth: { enabled: true, color: '#f2efe9' },
landuse: { enabled: false, color: '#e8e4d8' },
landcover: { enabled: false, color: '#d4e8c2' },
natural: { enabled: false, color: '#c8d9af' },
roads: { enabled: false, color: '#ffffff' },
buildings: { enabled: false, color: '#d9d0c9' },
transit: { enabled: false, color: '#888888' },
boundaries: { enabled: true, color: '#ff6b6b' },
places: { enabled: true, color: '#333333' },
pois: { enabled: false, color: '#7d4e24' },
};

// Application state
const state = {
layers: {},
colors: {},
};

// Initialize state from layer config
for ( const key in LAYERS ) {

state.layers[ key ] = LAYERS[ key ].enabled;
state.colors[ key ] = LAYERS[ key ].color;

}

state.colors.default = '#cccccc';

init();
setupGUI();
createTiles();

function init() {

renderer = new WebGLRenderer( { antialias: true } );
renderer.setAnimationLoop( render );
renderer.setPixelRatio( window.devicePixelRatio );
renderer.setSize( window.innerWidth, window.innerHeight );
renderer.setClearColor( 0x111111 );
document.body.appendChild( renderer.domElement );

scene = new Scene();
camera = new PerspectiveCamera( 60, window.innerWidth / window.innerHeight, 100, 1e8 );

const dirLight = new DirectionalLight( 0xffffff );
dirLight.position.set( 1, 1, 1 );
scene.add( dirLight );
scene.add( new AmbientLight( 0x444444 ) );

controls = new GlobeControls( scene, camera, renderer.domElement );
controls.enableDamping = true;
controls.camera.position.set( 0, 0, 1.5 * 1e7 );

window.addEventListener( 'resize', onWindowResize, false );

}

function createFilter() {

return function ( feature, layerName ) {

if ( layerName in state.layers ) {

return state.layers[ layerName ] === true;

}

// Unknown layers: hide by default
return false;

};

}

function createTiles() {

if ( tiles ) {

scene.remove( tiles.group );
tiles.dispose();

}

tiles = new TilesRenderer();
tiles.registerPlugin( new UpdateOnChangePlugin() );
tiles.registerPlugin( new PMTilesPlugin( {
url: 'https://demo-bucket.protomaps.com/v4.pmtiles',
center: true,
shape: 'ellipsoid',
levels: 15,
tileDimension: 512,
styles: state.colors,
filter: createFilter()
} ) );

tiles.group.rotation.x = - Math.PI / 2;
tiles.setCamera( camera );
scene.add( tiles.group );

if ( controls ) controls.setEllipsoid( tiles.ellipsoid, tiles.group );

}

function setupGUI() {

gui = new GUI();

// Layers folder
const layersFolder = gui.addFolder( 'Layers' );
for ( const key in LAYERS ) {

layersFolder.add( state.layers, key )
.name( key.charAt( 0 ).toUpperCase() + key.slice( 1 ) )
.onChange( createTiles );
Copy link
Contributor

@gkjohnson gkjohnson Feb 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The GeoJSONImageSource includes a "redraw" function to rerender every texture in place in case something changes, allowing for styling updates, animations, etc. I'm thinking we should allow the same thing here rather than rebuilding the full set of tiles.


}

// Colors folder
const colorsFolder = gui.addFolder( 'Colors' );
for ( const key in LAYERS ) {

colorsFolder.addColor( state.colors, key )
.name( key.charAt( 0 ).toUpperCase() + key.slice( 1 ) )
.onChange( createTiles );

}

colorsFolder.close();

}

function onWindowResize() {

camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
renderer.setSize( window.innerWidth, window.innerHeight );

}

function render() {

controls.update();
if ( tiles ) {

camera.updateMatrixWorld();
tiles.setCamera( camera );
tiles.setResolutionFromRenderer( camera, renderer );
tiles.update();

}

renderer.render( scene, camera );

}
Loading
Loading