Files
gods-eye-view/src/render/cesium/vectorBase.js
T
Sameh Khamis 143f4df049 Cesium vectorBase: test that removing the layer aborts its paints
Cesium cancels none of an imagery layer's requests itself; the port's
layer cancels its requests in flight as it is removed, which is what the
provider's cancelled check sees. A test now goes through that path.
2026-11-11 20:06:05 -08:00

74 lines
2.3 KiB
JavaScript

/**
* @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<ReturnType<typeof import('../vectorBase/index.js').loadVectorStyle>>} 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(/&copy;/gi, '©')
.replace(/&amp;/gi, '&')
.replace(/\s+/g, ' ')
.trim();
}