/** * @module render/cesium/vectorBase * @description `vectorBase` on Cesium: an imagery provider over the vector * base painter (`src/render/vectorBase/`), each Web Mercator tile painted * from the style at 256 px. */ import * as Cesium from 'cesium'; import { paintVectorTile } from '../vectorBase/index.js'; /** The tile size vector base tiles are painted at, pixels. */ export const VECTOR_TILE_PX = 256; /** The deepest level painted; deeper, Cesium draws this level's tiles. */ export const VECTOR_MAX_LEVEL = 20; /** * A Cesium imagery provider painting a loaded style's tiles. * @param {Awaited>} style */ export function vectorBaseProvider(style) { const tilingScheme = new Cesium.WebMercatorTilingScheme(); return { tilingScheme, tileWidth: VECTOR_TILE_PX, tileHeight: VECTOR_TILE_PX, minimumLevel: 0, maximumLevel: VECTOR_MAX_LEVEL, rectangle: tilingScheme.rectangle, credit: undefined, errorEvent: new Cesium.Event(), // Where the style paints no opaque background the base below (or the // globe's own colour) shows through, never black. hasAlphaChannel: true, tileDiscardPolicy: undefined, proxy: undefined, getTileCredits: () => undefined, pickFeatures: () => undefined, // A tile whose request was cancelled is not painted once its source // tiles arrive. Cesium cancels none of an imagery layer's requests // itself; the port's layer does as it is removed (`imagery.js`). requestImage: (x, y, level, request) => paintVectorTile(style, level, x, y, { size: VECTOR_TILE_PX, signal: cancelledBy(request), }), }; } /** * An `AbortSignal`-like view of a Cesium request: aborted once the request * is cancelled. Undefined without a request. */ export function cancelledBy(request) { if (!request) return undefined; return { get aborted() { return request.cancelled === true; }, get reason() { return new DOMException('The tile request was cancelled', 'AbortError'); }, }; } /** A TileJSON attribution (markup) as plain text. */ export function attributionText(html) { return String(html) .replace(/<[^>]*>/g, ' ') .replace(/©/gi, '©') .replace(/&/gi, '&') .replace(/\s+/g, ' ') .trim(); }