mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
Draw quads and meshes through the Cesium draw port
The Cesium draw port now makes quads sets (a posed, textured plane with its outline, drawn as a plane entity with a transparent image material draws it) and meshes sets (triangles in the east-north-up frame at an origin, flat and two-sided or lit and closed). Quads change in place as they move, resize, fade or take a new canvas; a video quad keeps frames coming while it plays and gets a new material when its size or source kind changes. Mesh vertices are placed in the Earth-fixed frame, so Cesium can project them for its 2D views. The capabilities list both kinds.
This commit is contained in:
1 parent
fa762f808e
commit
393f1686f2
7 files changed
+871
-7
No files matched your search
@@ -0,0 +1,182 @@
|
||||
/**
|
||||
* @module render/cesium/drawMeshes
|
||||
* @description The Cesium draw port's `meshes` sets: each item one
|
||||
* primitive of its triangles, in the east-north-up frame at its `origin`,
|
||||
* in its colour. `flat` draws it unlit with both faces (a translucent
|
||||
* volume seen from inside or behind); otherwise it is lit by its own
|
||||
* normals and its back faces are culled. Its vertices are placed in the
|
||||
* Earth-fixed frame when it is built (a primitive whose own vertices sit at
|
||||
* its frame's origin cannot be projected for the 2D views Cesium prepares),
|
||||
* so any change but `show` builds it anew, at once, and it draws in the
|
||||
* frame it replaces the old one. `positions` and `indices` are compared by
|
||||
* identity: give new arrays to change a shape.
|
||||
*/
|
||||
import * as Cesium from 'cesium';
|
||||
|
||||
/** A colour as a key: a CSS string as it is, an RGBA array joined. */
|
||||
const colorKey = (color) =>
|
||||
typeof color === 'string' ? color : Array.from(color).join(',');
|
||||
|
||||
/**
|
||||
* The meshes part of a Cesium draw port.
|
||||
* @param {{toColor: Function, pickId: Function, replaceHost: Function,
|
||||
* requestRender: () => void}} options From the draw port.
|
||||
*/
|
||||
export function createMeshSets({
|
||||
toColor,
|
||||
pickId,
|
||||
replaceHost,
|
||||
requestRender,
|
||||
}) {
|
||||
/** The set's host, made once: its meshes are changed where they are. */
|
||||
function hostOf(record) {
|
||||
if (record.host && !record.host.isDestroyed?.()) return record.host;
|
||||
const host = new Cesium.PrimitiveCollection();
|
||||
record.meshes = new Map();
|
||||
replaceHost(record, host);
|
||||
return host;
|
||||
}
|
||||
|
||||
function notePickIds(record) {
|
||||
record.pickIds = [];
|
||||
for (const entry of record.meshes.values())
|
||||
record.pickIds.push(entry.pickId);
|
||||
}
|
||||
|
||||
const pickableOf = (record, item) =>
|
||||
record.spec.pickable !== false && item.pickable !== false;
|
||||
|
||||
const scratchFrame = new Cesium.Matrix4();
|
||||
const scratchPoint = new Cesium.Cartesian3();
|
||||
|
||||
/** The item's east-north-up positions, in the Earth-fixed frame. */
|
||||
function fixedPositions(item) {
|
||||
const { origin, positions } = item;
|
||||
const frame = Cesium.Transforms.eastNorthUpToFixedFrame(
|
||||
new Cesium.Cartesian3(origin.x, origin.y, origin.z),
|
||||
Cesium.Ellipsoid.WGS84,
|
||||
scratchFrame,
|
||||
);
|
||||
const out = new Float64Array(positions.length);
|
||||
for (let i = 0; i + 2 < positions.length; i += 3) {
|
||||
scratchPoint.x = positions[i];
|
||||
scratchPoint.y = positions[i + 1];
|
||||
scratchPoint.z = positions[i + 2];
|
||||
Cesium.Matrix4.multiplyByPoint(frame, scratchPoint, scratchPoint);
|
||||
out[i] = scratchPoint.x;
|
||||
out[i + 1] = scratchPoint.y;
|
||||
out[i + 2] = scratchPoint.z;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
/** What an entry's primitive is built from: equal keys need no rebuild. */
|
||||
const shapeKey = (record, item) => ({
|
||||
origin: `${item.origin.x},${item.origin.y},${item.origin.z}`,
|
||||
positions: item.positions,
|
||||
indices: item.indices,
|
||||
color: colorKey(item.color),
|
||||
flat: item.flat === true,
|
||||
pickable: pickableOf(record, item),
|
||||
});
|
||||
|
||||
const sameShape = (a, b) =>
|
||||
a.origin === b.origin &&
|
||||
a.positions === b.positions &&
|
||||
a.indices === b.indices &&
|
||||
a.color === b.color &&
|
||||
a.flat === b.flat &&
|
||||
a.pickable === b.pickable;
|
||||
|
||||
function primitiveOf(record, item, entry) {
|
||||
const values = fixedPositions(item);
|
||||
const geometry = new Cesium.Geometry({
|
||||
attributes: {
|
||||
position: new Cesium.GeometryAttribute({
|
||||
componentDatatype: Cesium.ComponentDatatype.DOUBLE,
|
||||
componentsPerAttribute: 3,
|
||||
values,
|
||||
}),
|
||||
},
|
||||
indices: item.indices,
|
||||
primitiveType: Cesium.PrimitiveType.TRIANGLES,
|
||||
boundingSphere: Cesium.BoundingSphere.fromVertices(Array.from(values)),
|
||||
});
|
||||
const flat = item.flat === true;
|
||||
if (!flat) Cesium.GeometryPipeline.computeNormal(geometry);
|
||||
const color = toColor(item.color);
|
||||
return new Cesium.Primitive({
|
||||
geometryInstances: new Cesium.GeometryInstance({
|
||||
geometry,
|
||||
attributes: {
|
||||
color: Cesium.ColorGeometryInstanceAttribute.fromColor(color),
|
||||
},
|
||||
id: entry.pickId,
|
||||
}),
|
||||
appearance: new Cesium.PerInstanceColorAppearance({
|
||||
flat,
|
||||
translucent: color.alpha < 1,
|
||||
// Flat: both faces. Lit: a closed shape, its back faces culled.
|
||||
closed: !flat,
|
||||
...(flat ? { renderState: { cull: { enabled: false } } } : {}),
|
||||
}),
|
||||
allowPicking: pickableOf(record, item),
|
||||
asynchronous: false,
|
||||
show: item.show !== false,
|
||||
});
|
||||
}
|
||||
|
||||
function put(record, item) {
|
||||
const host = record.host;
|
||||
let entry = record.meshes.get(item.id);
|
||||
if (!entry) {
|
||||
entry = {
|
||||
item,
|
||||
pickId: pickId(record, item),
|
||||
key: null,
|
||||
primitive: null,
|
||||
};
|
||||
record.meshes.set(item.id, entry);
|
||||
}
|
||||
entry.item = item;
|
||||
entry.pickId.meta = item.meta;
|
||||
const key = shapeKey(record, item);
|
||||
if (entry.primitive && entry.key && sameShape(entry.key, key)) {
|
||||
entry.primitive.show = item.show !== false;
|
||||
return;
|
||||
}
|
||||
const next = host.add(primitiveOf(record, item, entry));
|
||||
if (entry.primitive) host.remove(entry.primitive);
|
||||
entry.primitive = next;
|
||||
entry.key = key;
|
||||
}
|
||||
|
||||
function drop(record, id) {
|
||||
const entry = record.meshes.get(id);
|
||||
if (!entry) return;
|
||||
record.meshes.delete(id);
|
||||
const host = record.host;
|
||||
if (entry.primitive && host && !host.isDestroyed())
|
||||
host.remove(entry.primitive);
|
||||
}
|
||||
|
||||
/** Add or change items, by id; true once handled (always, for meshes). */
|
||||
function upsert(record, list) {
|
||||
hostOf(record);
|
||||
for (const item of list) put(record, item);
|
||||
notePickIds(record);
|
||||
requestRender();
|
||||
return true;
|
||||
}
|
||||
|
||||
/** The set's items as they are now: meshes gone dropped, the rest kept. */
|
||||
function build(record) {
|
||||
hostOf(record);
|
||||
for (const id of [...record.meshes.keys()])
|
||||
if (!record.items.has(id)) drop(record, id);
|
||||
for (const item of record.items.values()) put(record, item);
|
||||
notePickIds(record);
|
||||
}
|
||||
|
||||
return { build, upsert };
|
||||
}
|
||||
Reference in new issue
Block a user