Read the eye's follow frame through the camera port and take share-follow off the Cesium list

The camera port gains an optional followFrame() (capability followFrame):
the frame the eye is placed in now, as a column-major 4x4 matrix to ECEF.
Once a follow has framed the camera it is the follow's own frame
(east-north-up, or the orbit frame an autodetect follow chose), under
lookAt the target's east-north-up frame, otherwise the identity. setView
places a world pose and keeps that frame. The Cesium port reads it from
camera.transform, only when the capability is on; the stub from its own
eye frame. A conformance check covers the world, lookAt and enu-follow
frames, the offset in it, and setView keeping it.

src/ui/shareFollow.js now reads the pose, the frame and the follow offset
through the camera and frame ports: a shared offset is re-expressed in the
follow's own frame as before, satellites included, and the eye is placed
with setView at exact heading, pitch and roll, so a near-vertical view
keeps its roll. placeFollowEye returns false on a camera that cannot say
its frame. offsetFromHeadingPitchRange moves to src/geo/frames.js, shared
with the stub.
This commit is contained in:
Sameh Khamis committed 2026-11-07 21:49:25 -08:00
1 parent b0ed9d7e90
commit 90e73f2ef2
19 files changed
+596 -143

No files matched your search

+24 -1
View File
@@ -1,19 +1,25 @@
/**
* @module geo/frames
* @description Rigid frames (unit axes and an origin, local to ECEF), the
* east-north-up frame at a point, and rotation about an axis.
* east-north-up frame at a point, rotation about an axis, and the offset a
* heading, pitch and range puts an eye at.
*/
import { geodeticSurfaceNormal } from './ellipsoid.js';
import {
EPSILON14,
PI_OVER_TWO,
add,
clamp,
clone,
cross,
dot,
equalsEpsilon,
negate,
normalize,
scale,
sub,
vec,
zeroToTwoPi,
} from './vector.js';
/**
@@ -90,3 +96,20 @@ export function rotate(v, axis, angle) {
v.z * c + k.z * s + axis.z * d * (1 - c),
);
}
/**
* The offset from a target a heading, pitch and range put the eye at, in
* the target's east-north-up frame: heading clockwise from north, pitch
* negative looking down (clamped to straight up or down), as `lookAt` takes
* them.
*/
export function offsetFromHeadingPitchRange(heading, pitch, range) {
const p = clamp(pitch, -PI_OVER_TWO, PI_OVER_TWO);
const h = zeroToTwoPi(heading) - PI_OVER_TWO;
const offset = rotate(
rotate(vec(1, 0, 0), vec(0, 1, 0), -p),
vec(0, 0, 1),
-h,
);
return scale(negate(offset), range);
}