Scale, fade and show icons by eye distance

Cesium icon sets now draw an item's scaleByDistance, fadeByDistance and
displayRange, as point sets already draw their curves, and drop them again
when a restyle in place leaves them out. An empty display range shows the
icon nowhere; a curve whose far end is not past its near one is left out
rather than refused mid-update. Cesium eases between a curve's ends rather
than interpolating linearly, as it always has for points.

The reference renderer now scales an item's pick size by its distance curve
and leaves out items faded or scaled to nothing, and the draw.icons.distance
conformance check covers all three fields.
This commit is contained in:
Sameh Khamis committed 2026-11-06 22:25:07 -08:00
1 parent 1aa280b43f
commit ee6b9e49aa
5 files changed
+147 -6

No files matched your search

+25 -3
View File
@@ -70,9 +70,15 @@ const classificationOf = (clampTo = 'both') =>
tiles: Cesium.ClassificationType.CESIUM_3D_TILE,
})[clampTo] ?? Cesium.ClassificationType.BOTH;
/** A distance curve as Cesium's, or undefined. */
/**
* A distance curve as Cesium's, or undefined. Cesium's curves hold the same
* end values but ease between them (not linearly, as the contract's do):
* points and icons draw them as Cesium's own entities always have. A curve
* whose far end is not past its near one is left out.
*/
const nearFarOf = (curve) =>
curve
// One that ends where it starts is no curve, which Cesium refuses.
curve && curve.far > curve.near
? new Cesium.NearFarScalar(
curve.near,
curve.nearValue,
@@ -81,6 +87,18 @@ const nearFarOf = (curve) =>
)
: undefined;
/** Whether a `displayRange` shows anything: `[near, far)` is not empty. */
const displayable = (range) => !range || range[1] > range[0];
/**
* A `displayRange` as Cesium's, or undefined for none (or an empty one).
* Cesium still shows an item at exactly its far distance.
*/
const displayConditionOf = (range) =>
range && displayable(range)
? new Cesium.DistanceDisplayCondition(range[0], range[1])
: undefined;
/** Cesium's point blending for a set's `blend`. */
const pointBlendOf = (blend) =>
({
@@ -445,7 +463,11 @@ export function createCesiumDraw({ scene, report }) {
verticalOrigin: ANCHORS[item.anchor ?? 'center'],
disableDepthTestDistance: item.disableDepthTest ?? 0,
heightReference: heightReferenceOf(item.height, record.spec.clampTo),
show: item.show !== false,
// An empty range shows it nowhere.
show: item.show !== false && displayable(item.displayRange),
scaleByDistance: nearFarOf(item.scaleByDistance),
translucencyByDistance: nearFarOf(item.fadeByDistance),
distanceDisplayCondition: displayConditionOf(item.displayRange),
// The defaults, so a restyle in place puts back what an item dropped.
rotation: 0,
alignedAxis: Cesium.Cartesian3.ZERO,