docs(render): translucent icon sets blend as Cesium's translucent billboards, order-independently where the scene is; a test for a host that draws its blend itself

This commit is contained in:
Sameh Khamis committed 2026-11-12 12:14:47 -08:00
1 parent 06516819da
commit 01788c1b10
5 files changed
+38 -11

No files matched your search

+1 -1
View File
@@ -466,7 +466,7 @@ export function createRendering({
if (!layerState._viewer || layerState._icons) return; if (!layerState._viewer || layerState._icons) return;
const set = drawOf(layerState._viewer).icons({ const set = drawOf(layerState._viewer).icons({
id: `firms:${++iconSets}:icons`, id: `firms:${++iconSets}:icons`,
// Blended in one pass, in order, as the detections overlap. // Blended as one translucent pass, as its billboards were.
blend: 'translucent', blend: 'translucent',
horizonCull: true, horizonCull: true,
show: layerState._enabled && !(layerState._handoffHeat >= 1), show: layerState._enabled && !(layerState._handoffHeat >= 1),
+1 -2
View File
@@ -380,8 +380,7 @@ export function createShipwrecksLayer({
// sprite layers (`SPRITE_LAYER_ORDER`). // sprite layers (`SPRITE_LAYER_ORDER`).
_markers = drawOf(viewer).icons({ _markers = drawOf(viewer).icons({
id: 'shipwrecks:markers', id: 'shipwrecks:markers',
// Blended in one pass, in order: the wrecks added last (the // Translucent, as its billboards were.
// largest) on top.
blend: 'translucent', blend: 'translucent',
drawOrder: spriteDrawOrder(SHIPWRECKS_LAYER_ID), drawOrder: spriteDrawOrder(SHIPWRECKS_LAYER_ID),
show: false, show: false,
+2 -2
View File
@@ -145,8 +145,8 @@ export function createRendering({
if (!viewer || state.icons) return; if (!viewer || state.icons) return;
const set = drawOf(viewer).icons({ const set = drawOf(viewer).icons({
id: `ais-vessels:${++instances}`, id: `ais-vessels:${++instances}`,
// Blended in one pass, in order, each chevron keeping its outline // Translucent, as its billboards were: overlapping chevrons keep
// over the ones under it. // their outlines rather than the first one's fill.
blend: 'translucent', blend: 'translucent',
horizonCull: true, horizonCull: true,
drawOrder: spriteDrawOrder?.('ais') ?? 0, drawOrder: spriteDrawOrder?.('ais') ?? 0,
+6 -6
View File
@@ -327,9 +327,10 @@ const EARTH_BOUNDS = new Cesium.BoundingSphere(
* a newly loaded image, for a layer that does not render continuously. * a newly loaded image, for a layer that does not render continuously.
* `cull` says whether rows past the ellipsoid's horizon are hidden (by * `cull` says whether rows past the ellipsoid's horizon are hidden (by
* default always). `translucent` says whether every row is drawn in one * default always). `translucent` says whether every row is drawn in one
* alpha-blended pass, in row order, the last on top (Cesium's * alpha-blended pass, as Cesium's `BlendOption.TRANSLUCENT` billboards
* `BlendOption.TRANSLUCENT`), in place of an opaque pass and a translucent * are, in place of an opaque pass and a translucent one (by default
* one (by default never). `pickObject` builds a row's pick object around the * never); under order-independent translucency, overlapping rows blend
* together, as those billboards do. `pickObject` builds a row's pick object around the
* `primitive` drill picks hide it by (by default `{ id, iconSet, meta, * `primitive` drill picks hide it by (by default `{ id, iconSet, meta,
* primitive }`). * primitive }`).
*/ */
@@ -795,9 +796,8 @@ export class IconSetPrimitive {
}), }),
), ),
]; ];
// Every row in one pass, blended in row order: equal depths pass, and // Every row in one blended pass, equal depths passing and depth written
// depth is written in place of sorting, as Cesium's translucent // in place of sorting, as Cesium's translucent billboards are drawn.
// billboards do.
this._singleCommand = command( this._singleCommand = command(
Cesium.Pass.TRANSLUCENT, Cesium.Pass.TRANSLUCENT,
this._programs.single, this._programs.single,
+28
View File
@@ -172,3 +172,31 @@ test('a blended host turns only its own commands, in render passes, each frame',
'wrapped once', 'wrapped once',
); );
}); });
test('a host that draws the blend itself keeps its commands as made, and others turn back', () => {
const [mine] = commands();
let blend = 'additive';
let drawsIt = false;
const host = blendHost(
{
update: (fs) => fs.commandList.push(mine),
drawsBlend: (asked) => drawsIt && asked === 'translucent',
},
() => blend,
);
const frame = () => {
const frameState = { commandList: [], passes: { render: true } };
host.update(frameState);
return frameState.commandList[0];
};
const given = { renderState: mine.renderState, pass: mine.pass };
assert.notEqual(frame().renderState, given.renderState, 'turned to additive');
blend = 'translucent';
drawsIt = true;
const drawn = frame();
assert.equal(drawn.renderState, given.renderState, 'as made');
assert.equal(drawn.pass, given.pass);
blend = undefined;
drawsIt = false;
assert.equal(frame().renderState, given.renderState, 'still as made');
});