From e94b7ffb018a890760f6b6814129eac64b134a5d Mon Sep 17 00:00:00 2001 From: Sameh Khamis Date: Sat, 7 Nov 2026 04:24:38 -0800 Subject: [PATCH] Say that height batches miss terrain without depth textures Without depth textures the Cesium renderer still answers terrain heights now, from the loaded tiles, but a batch misses them as it does the surface. The gateway docs and the application guide say so. --- docs/APPLICATION.md | 2 +- src/queries/heights.js | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/APPLICATION.md b/docs/APPLICATION.md index ec92aaf56..7fb047c26 100644 --- a/docs/APPLICATION.md +++ b/docs/APPLICATION.md @@ -168,7 +168,7 @@ the surface. `exclude` lists draw set ids to see through, of those drawn with miss is `null`, and every caller treats it as one; `batch` and `clampBatch` reject when the query itself fails. Without depth-texture support the Cesium renderer answers no `surface` or `tiles` height; `now` still answers -`terrain` from the loaded tiles. +`terrain` from the loaded tiles, while `batch` misses terrain too. ## Cesium internals diff --git a/src/queries/heights.js b/src/queries/heights.js index 692fdbc11..4649566d6 100644 --- a/src/queries/heights.js +++ b/src/queries/heights.js @@ -5,7 +5,8 @@ * asked of the renderer's query port (`src/render/contract/query.d.ts`). * * `now()` answers from what is already loaded and may return `null`: tiles - * not streamed yet, no depth support, no renderer, a point off screen. Every + * not streamed yet, no depth support (below), no renderer, a point off + * screen. Every * caller treats that as a miss, holding its last value or placing first and * patching when `batch()` resolves. `batch()` and `clampBatch()` answer null * per point they miss, and reject when the query itself fails (a tile @@ -15,7 +16,7 @@ * What the renderer cannot answer is a miss: without depth textures (its * `sampleHeight` capability) the Cesium renderer answers no `'surface'` or * `'tiles'` height; `now()` still answers `'terrain'` from the globe's - * loaded tiles. + * loaded tiles, while `batch()` misses there too. * * `against` picks the surface: `'surface'` is what is drawn (tiles, the * globe, and draw sets drawn as ground), `'terrain'` the terrain alone,