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

+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.
* `cull` says whether rows past the ellipsoid's horizon are hidden (by
* default always). `translucent` says whether every row is drawn in one
* alpha-blended pass, in row order, the last on top (Cesium's
* `BlendOption.TRANSLUCENT`), in place of an opaque pass and a translucent
* one (by default never). `pickObject` builds a row's pick object around the
* alpha-blended pass, as Cesium's `BlendOption.TRANSLUCENT` billboards
* are, in place of an opaque pass and a translucent one (by default
* 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 }`).
*/
@@ -795,9 +796,8 @@ export class IconSetPrimitive {
}),
),
];
// Every row in one pass, blended in row order: equal depths pass, and
// depth is written in place of sorting, as Cesium's translucent
// billboards do.
// Every row in one blended pass, equal depths passing and depth written
// in place of sorting, as Cesium's translucent billboards are drawn.
this._singleCommand = command(
Cesium.Pass.TRANSLUCENT,
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',
);
});
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');
});