mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-22 03:02:20 +00:00
ISS live telemetry, STATION and LIVE sections, Tiangong model, drawn through the renderer's draw port
Builds on the ISS 3D model (PR #1690) and brings it onto main's renderer seam: the station models are items of a `models` draw set, posed by heading, pitch and roll from the station's flight axes (`headingPitchRollOfAxes`), with the camera, canvas and clicks read from the renderer's ports; no satellites file reaches Cesium. The joint drivers write column-major matrices into node poses the model part keeps, for a renderer that can pose nodes; until the draw contract has that member the models draw rigid. - ISS joints take their angles from NASA's ISSLive telemetry, relayed by the server behind ISS_TELEMETRY_ENABLED. - STATION and LIVE sections of Context replace the floating command panel and player; both collapse like the Radio section. - Cockpit rides the ISS from mounts on its model; the LIVE page in the Cockpit briefing. - Tiangong as a second station model, with computed joints. - Installations: a label-box click selects the site.
This commit is contained in:
1 parent
fd3ca679ec
commit
9cc077964f
103 files changed
+12033
-1775
No files matched your search
@@ -1,12 +1,14 @@
|
||||
import {
|
||||
clearOverlaySource,
|
||||
getWorldOverlayDiagnostics,
|
||||
hitTestWorldOverlay,
|
||||
setOverlayEntries,
|
||||
setOverlaySourceVisible,
|
||||
} from '../../overlays/worldOverlay.js';
|
||||
export const overlayHost = Object.freeze({
|
||||
clearSource: clearOverlaySource,
|
||||
getDiagnostics: getWorldOverlayDiagnostics,
|
||||
hitTest: hitTestWorldOverlay,
|
||||
setEntries: setOverlayEntries,
|
||||
setVisible: setOverlaySourceVisible,
|
||||
});
|
||||
@@ -5,6 +5,7 @@ import {
|
||||
findQuery,
|
||||
} from '../render/rendererOf.js';
|
||||
import { dot, sub } from '../geo/vector.js';
|
||||
import { loadYouTubeApi } from './youtubeApi.js';
|
||||
import { t, msg, onLocaleChange } from '../i18n/index.js';
|
||||
|
||||
const YOUTUBE_HOSTS = new Set([
|
||||
@@ -98,60 +99,6 @@ export function bhoteEventText(value) {
|
||||
let _xWidgetsPromise = null;
|
||||
let _facebookSdkPromise = null;
|
||||
let _facebookEmbedSequence = 0;
|
||||
const youtubeApis = new WeakMap();
|
||||
|
||||
function loadYouTubeApi(documentRef, globalRef) {
|
||||
if (typeof globalRef.YT?.Player === 'function')
|
||||
return Promise.resolve(globalRef.YT);
|
||||
if (youtubeApis.has(documentRef)) return youtubeApis.get(documentRef);
|
||||
const pending = new Promise((resolve, reject) => {
|
||||
const previous = globalRef.onYouTubeIframeAPIReady;
|
||||
let timer;
|
||||
let settled = false;
|
||||
const script = documentRef.createElement('script');
|
||||
const finish = (error) => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
globalRef.clearTimeout(timer);
|
||||
if (globalRef.onYouTubeIframeAPIReady === ready)
|
||||
globalRef.onYouTubeIframeAPIReady = previous;
|
||||
if (error) {
|
||||
script.remove();
|
||||
reject(error);
|
||||
} else resolve(globalRef.YT);
|
||||
};
|
||||
const ready = () => {
|
||||
try {
|
||||
previous?.();
|
||||
} finally {
|
||||
finish(
|
||||
typeof globalRef.YT?.Player === 'function'
|
||||
? null
|
||||
: new Error('YouTube API unavailable'),
|
||||
);
|
||||
}
|
||||
};
|
||||
globalRef.onYouTubeIframeAPIReady = ready;
|
||||
script.src = 'https://www.youtube.com/iframe_api';
|
||||
script.async = true;
|
||||
script.addEventListener(
|
||||
'error',
|
||||
() => finish(new Error('YouTube API unavailable')),
|
||||
{ once: true },
|
||||
);
|
||||
timer = globalRef.setTimeout(
|
||||
() => finish(new Error('YouTube API timed out')),
|
||||
5000,
|
||||
);
|
||||
documentRef.head.append(script);
|
||||
}).catch((error) => {
|
||||
youtubeApis.delete(documentRef);
|
||||
throw error;
|
||||
});
|
||||
youtubeApis.set(documentRef, pending);
|
||||
return pending;
|
||||
}
|
||||
|
||||
/** A trimmed clip follows provider time, never time spent loading its iframe. */
|
||||
export function createTrimmedYouTubePlayback({
|
||||
iframe,
|
||||
|
||||
+14
-2
@@ -172,11 +172,23 @@ export const DATA_CREDITS = [
|
||||
'ISS model: ' +
|
||||
'<a href="https://science.nasa.gov/3d-resources/international-space-station-iss-d-igoal/" target="_blank" rel="noopener">NASA 3D Resources</a> (JSC IGOAL)',
|
||||
},
|
||||
{
|
||||
key: 'tiangong-model',
|
||||
html:
|
||||
"Tiangong model: made for God's Eye View; dimensions from " +
|
||||
'<a href="https://doi.org/10.34133/space.0035" target="_blank" rel="noopener">Wang, Zhang & Wang 2023</a> ' +
|
||||
'(CC BY 4.0) and eoPortal',
|
||||
},
|
||||
{
|
||||
key: 'nasa-iss-telemetry',
|
||||
html: 'ISS joint telemetry (where switched on): NASA ISSLive, via Lightstreamer',
|
||||
},
|
||||
{
|
||||
key: 'nasa-iss-live',
|
||||
html:
|
||||
'ISS live video: NASA, via ' +
|
||||
'<a href="https://www.youtube.com/watch?v=ROboUHfPUrU" target="_blank" rel="noopener">YouTube</a>',
|
||||
'ISS live video (LIVE section): NASA, via YouTube ' +
|
||||
'(<a href="https://www.youtube.com/watch?v=ROboUHfPUrU" target="_blank" rel="noopener">exterior cameras</a>, ' +
|
||||
'<a href="https://www.youtube.com/watch?v=M3HKLzjvKPc" target="_blank" rel="noopener">live video and audio</a>)',
|
||||
},
|
||||
{
|
||||
key: 'ucs-satellite-database',
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
import { msg } from '../i18n/marker.js';
|
||||
|
||||
/**
|
||||
* Live streams the app can show for a selected object: a fixed list, each
|
||||
* entry a broadcast on a platform's own player (YouTube today), attached to
|
||||
* the subjects it shows by key. Any layer can name its selected subject's
|
||||
* keys (`getLiveSubjectKeys`), and the LIVE section in Context offers the
|
||||
* streams that match; the satellites layer names the ISS as `station:iss`
|
||||
* whichever of the station's catalog entries is selected.
|
||||
*
|
||||
* These are broadcasts in the platform's embedded player, not camera feeds:
|
||||
* the CCTV layer is for those. A stream's id changes when its broadcaster
|
||||
* restarts it, so each entry is one line to update.
|
||||
*/
|
||||
|
||||
/** Where YouTube's embedded player is served from: the privacy-enhanced host. */
|
||||
export const YOUTUBE_EMBED_HOST = 'https://www.youtube-nocookie.com';
|
||||
|
||||
/** @typedef {{id: string, platform: 'youtube', videoId: string, title: string,
|
||||
* owner: string, ownerUrl: string, subjects: readonly string[],
|
||||
* note: string}} LiveStream */
|
||||
|
||||
/** @type {readonly LiveStream[]} */
|
||||
export const LIVE_STREAMS = Object.freeze([
|
||||
Object.freeze({
|
||||
id: 'iss-exterior',
|
||||
platform: 'youtube',
|
||||
videoId: 'ROboUHfPUrU',
|
||||
title: msg('Exterior cameras'),
|
||||
owner: 'NASA',
|
||||
ownerUrl: 'https://www.youtube.com/@NASA',
|
||||
subjects: Object.freeze(['station:iss']),
|
||||
note: msg('NASA video, via YouTube'),
|
||||
}),
|
||||
Object.freeze({
|
||||
id: 'iss-crew',
|
||||
platform: 'youtube',
|
||||
videoId: 'M3HKLzjvKPc',
|
||||
title: msg('Live video and space-to-ground audio'),
|
||||
owner: 'NASA',
|
||||
ownerUrl: 'https://www.youtube.com/@NASA',
|
||||
subjects: Object.freeze(['station:iss']),
|
||||
note: msg('NASA video, via YouTube'),
|
||||
}),
|
||||
]);
|
||||
|
||||
/**
|
||||
* The streams attached to any of `subjectKeys`, in list order.
|
||||
* @param {Iterable<string>|null|undefined} subjectKeys
|
||||
* @param {readonly LiveStream[]} [streams]
|
||||
* @returns {LiveStream[]}
|
||||
*/
|
||||
export function liveStreamsFor(subjectKeys, streams = LIVE_STREAMS) {
|
||||
const keys = new Set(subjectKeys ?? []);
|
||||
if (!keys.size) return [];
|
||||
return streams.filter((stream) =>
|
||||
stream.subjects.some((subject) => keys.has(subject)),
|
||||
);
|
||||
}
|
||||
|
||||
/** The video's own page, for the "Open on YouTube" link. */
|
||||
export function youtubeWatchUrl(videoId) {
|
||||
return `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* The parameters the live player is created with: starts on creation (the
|
||||
* player is built as soon as a subject with a stream is selected), muted so
|
||||
* the browser lets it, inline on phones, no related videos, and the page's
|
||||
* origin so the player API may be spoken to.
|
||||
* @param {string} origin The page's origin.
|
||||
* @returns {Record<string, string|number>}
|
||||
*/
|
||||
export function youtubeLivePlayerVars(origin) {
|
||||
return {
|
||||
autoplay: 1,
|
||||
mute: 1,
|
||||
playsinline: 1,
|
||||
rel: 0,
|
||||
enablejsapi: 1,
|
||||
...(origin ? { origin } : {}),
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,80 @@
|
||||
// src/data/liveStreams.test.mjs — the fixed list of live streams and how a
|
||||
// selected object's keys pick from it.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import {
|
||||
LIVE_STREAMS,
|
||||
YOUTUBE_EMBED_HOST,
|
||||
liveStreamsFor,
|
||||
youtubeLivePlayerVars,
|
||||
youtubeWatchUrl,
|
||||
} from './liveStreams.js';
|
||||
|
||||
test('every listed stream is a complete YouTube entry with a distinct id', () => {
|
||||
assert.ok(LIVE_STREAMS.length >= 2, 'the ISS has two streams');
|
||||
const ids = new Set(LIVE_STREAMS.map((stream) => stream.id));
|
||||
assert.equal(ids.size, LIVE_STREAMS.length);
|
||||
for (const stream of LIVE_STREAMS) {
|
||||
assert.equal(stream.platform, 'youtube');
|
||||
assert.match(stream.videoId, /^[\w-]{11}$/, `${stream.id} video id`);
|
||||
assert.ok(stream.title.length > 0);
|
||||
assert.ok(stream.owner.length > 0);
|
||||
assert.match(stream.ownerUrl, /^https:\/\/www\.youtube\.com\//);
|
||||
assert.ok(stream.subjects.length > 0, `${stream.id} names a subject`);
|
||||
assert.ok(Object.isFrozen(stream), 'entries cannot be edited at run time');
|
||||
}
|
||||
});
|
||||
|
||||
test('the ISS streams attach to the station key, in list order', () => {
|
||||
const found = liveStreamsFor(['station:iss']);
|
||||
assert.deepEqual(
|
||||
found.map((stream) => stream.id),
|
||||
['iss-exterior', 'iss-crew'],
|
||||
);
|
||||
});
|
||||
|
||||
test('a key no stream names, or no keys at all, finds nothing', () => {
|
||||
assert.deepEqual(liveStreamsFor(['satellites:25544']), []);
|
||||
assert.deepEqual(liveStreamsFor([]), []);
|
||||
assert.deepEqual(liveStreamsFor(null), []);
|
||||
assert.deepEqual(liveStreamsFor(undefined), []);
|
||||
});
|
||||
|
||||
test('a subject known by several keys gets the union, each stream once', () => {
|
||||
const streams = [
|
||||
{ id: 'a', subjects: ['x'] },
|
||||
{ id: 'b', subjects: ['y', 'x'] },
|
||||
{ id: 'c', subjects: ['z'] },
|
||||
];
|
||||
assert.deepEqual(
|
||||
liveStreamsFor(new Set(['x', 'y']), streams).map((s) => s.id),
|
||||
['a', 'b'],
|
||||
);
|
||||
});
|
||||
|
||||
test('the watch link is the video page on YouTube proper', () => {
|
||||
assert.equal(
|
||||
youtubeWatchUrl('ROboUHfPUrU'),
|
||||
'https://www.youtube.com/watch?v=ROboUHfPUrU',
|
||||
);
|
||||
assert.equal(
|
||||
youtubeWatchUrl('a b&c'),
|
||||
'https://www.youtube.com/watch?v=a%20b%26c',
|
||||
);
|
||||
});
|
||||
|
||||
test('the player is created on the privacy-enhanced host, muted, with the API on', () => {
|
||||
assert.equal(YOUTUBE_EMBED_HOST, 'https://www.youtube-nocookie.com');
|
||||
const vars = youtubeLivePlayerVars('http://localhost:5190');
|
||||
assert.equal(vars.autoplay, 1);
|
||||
assert.equal(vars.mute, 1);
|
||||
assert.equal(vars.playsinline, 1);
|
||||
assert.equal(vars.rel, 0);
|
||||
assert.equal(vars.enablejsapi, 1);
|
||||
assert.equal(vars.origin, 'http://localhost:5190');
|
||||
assert.equal(
|
||||
'origin' in youtubeLivePlayerVars(undefined),
|
||||
false,
|
||||
'no origin is passed when the page has none',
|
||||
);
|
||||
});
|
||||
@@ -0,0 +1,68 @@
|
||||
/**
|
||||
* YouTube's IFrame Player API, loaded once per document: the only in-page
|
||||
* way to learn a player's state (playing, ended) and errors (video gone,
|
||||
* embedding refused), which the live-stream player needs to tell an offline
|
||||
* stream from one still loading. The page's script-src allows
|
||||
* `https://www.youtube.com`.
|
||||
*/
|
||||
|
||||
const youtubeApis = new WeakMap();
|
||||
|
||||
/**
|
||||
* Load the API, or return the one already there.
|
||||
* @param {Document} documentRef
|
||||
* @param {object} globalRef The window: `YT`, `onYouTubeIframeAPIReady`,
|
||||
* timers.
|
||||
* @returns {Promise<object>} The `YT` namespace.
|
||||
*/
|
||||
export function loadYouTubeApi(documentRef, globalRef) {
|
||||
if (typeof globalRef.YT?.Player === 'function')
|
||||
return Promise.resolve(globalRef.YT);
|
||||
if (youtubeApis.has(documentRef)) return youtubeApis.get(documentRef);
|
||||
const pending = new Promise((resolve, reject) => {
|
||||
const previous = globalRef.onYouTubeIframeAPIReady;
|
||||
let timer;
|
||||
let settled = false;
|
||||
const script = documentRef.createElement('script');
|
||||
const finish = (error) => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
globalRef.clearTimeout(timer);
|
||||
if (globalRef.onYouTubeIframeAPIReady === ready)
|
||||
globalRef.onYouTubeIframeAPIReady = previous;
|
||||
if (error) {
|
||||
script.remove();
|
||||
reject(error);
|
||||
} else resolve(globalRef.YT);
|
||||
};
|
||||
const ready = () => {
|
||||
try {
|
||||
previous?.();
|
||||
} finally {
|
||||
finish(
|
||||
typeof globalRef.YT?.Player === 'function'
|
||||
? null
|
||||
: new Error('YouTube API unavailable'),
|
||||
);
|
||||
}
|
||||
};
|
||||
globalRef.onYouTubeIframeAPIReady = ready;
|
||||
script.src = 'https://www.youtube.com/iframe_api';
|
||||
script.async = true;
|
||||
script.addEventListener(
|
||||
'error',
|
||||
() => finish(new Error('YouTube API unavailable')),
|
||||
{ once: true },
|
||||
);
|
||||
timer = globalRef.setTimeout(
|
||||
() => finish(new Error('YouTube API timed out')),
|
||||
5000,
|
||||
);
|
||||
documentRef.head.append(script);
|
||||
}).catch((error) => {
|
||||
youtubeApis.delete(documentRef);
|
||||
throw error;
|
||||
});
|
||||
youtubeApis.set(documentRef, pending);
|
||||
return pending;
|
||||
}
|
||||
@@ -0,0 +1,123 @@
|
||||
import { loadYouTubeApi } from './youtubeApi.js';
|
||||
import { YOUTUBE_EMBED_HOST, youtubeLivePlayerVars } from './liveStreams.js';
|
||||
|
||||
/**
|
||||
* One live stream in YouTube's embedded player, with its state read back
|
||||
* through the player API: `loading` until the video plays, `playing`, and
|
||||
* `offline` once the player says the video has ended, cannot be found or
|
||||
* never starts. The player cannot say "this broadcast is off air" in so
|
||||
* many words: a live stream that is off air is reported as a video that
|
||||
* cannot play, or that never reaches playing, so both read as offline here.
|
||||
* Embedding refused by the video's owner is `unavailable`, which no retry
|
||||
* will change.
|
||||
*/
|
||||
|
||||
/** A stream that has not started playing this long after its player was ready is offline. */
|
||||
export const LIVE_START_TIMEOUT_MS = 25_000;
|
||||
|
||||
/** YouTube's player states. */
|
||||
const ENDED = 0;
|
||||
const PLAYING = 1;
|
||||
/** Error codes: embedding not allowed on this page. */
|
||||
const EMBED_REFUSED = new Set([101, 150]);
|
||||
|
||||
/**
|
||||
* @param {{host: HTMLElement, videoId: string, documentRef?: Document,
|
||||
* globalRef?: object, loadApi?: typeof loadYouTubeApi,
|
||||
* onChange: (state: {state: 'loading'|'playing'|'offline'|'unavailable',
|
||||
* reason: string|null}) => void}} options `host` is emptied and given the
|
||||
* player's iframe.
|
||||
* @returns {{destroy: () => void}}
|
||||
*/
|
||||
export function createYouTubeLivePlayer({
|
||||
host,
|
||||
videoId,
|
||||
documentRef = globalThis.document,
|
||||
globalRef = globalThis,
|
||||
loadApi = loadYouTubeApi,
|
||||
onChange,
|
||||
}) {
|
||||
let destroyed = false;
|
||||
let player = null;
|
||||
let timer = null;
|
||||
let current = null;
|
||||
|
||||
const set = (state, reason = null) => {
|
||||
if (destroyed || current === state) return;
|
||||
current = state;
|
||||
onChange({ state, reason });
|
||||
};
|
||||
const clearTimer = () => {
|
||||
if (timer !== null) globalRef.clearTimeout(timer);
|
||||
timer = null;
|
||||
};
|
||||
const armTimer = () => {
|
||||
clearTimer();
|
||||
timer = globalRef.setTimeout(() => {
|
||||
timer = null;
|
||||
if (current === 'loading') set('offline', 'timeout');
|
||||
}, LIVE_START_TIMEOUT_MS);
|
||||
};
|
||||
|
||||
set('loading');
|
||||
host.replaceChildren();
|
||||
const mount = documentRef.createElement('div');
|
||||
host.append(mount);
|
||||
|
||||
loadApi(documentRef, globalRef).then(
|
||||
(YT) => {
|
||||
if (destroyed) return;
|
||||
try {
|
||||
player = new YT.Player(mount, {
|
||||
host: YOUTUBE_EMBED_HOST,
|
||||
videoId,
|
||||
playerVars: youtubeLivePlayerVars(globalRef.location?.origin),
|
||||
events: {
|
||||
onReady: () => {
|
||||
if (!destroyed) armTimer();
|
||||
},
|
||||
onStateChange: (event) => {
|
||||
if (destroyed) return;
|
||||
if (event?.data === PLAYING) {
|
||||
clearTimer();
|
||||
set('playing');
|
||||
} else if (event?.data === ENDED) {
|
||||
clearTimer();
|
||||
set('offline', 'ended');
|
||||
}
|
||||
},
|
||||
onError: (event) => {
|
||||
if (destroyed) return;
|
||||
clearTimer();
|
||||
const code = Number(event?.data);
|
||||
if (EMBED_REFUSED.has(code)) set('unavailable', `error-${code}`);
|
||||
else set('offline', `error-${code}`);
|
||||
},
|
||||
},
|
||||
});
|
||||
// The API may never call onReady for a video it cannot load.
|
||||
armTimer();
|
||||
} catch {
|
||||
set('offline', 'player');
|
||||
}
|
||||
},
|
||||
() => {
|
||||
if (!destroyed) set('unavailable', 'api');
|
||||
},
|
||||
);
|
||||
|
||||
return {
|
||||
destroy() {
|
||||
if (destroyed) return;
|
||||
destroyed = true;
|
||||
clearTimer();
|
||||
try {
|
||||
player?.destroy?.();
|
||||
} catch {
|
||||
// A player half-created has nothing to destroy.
|
||||
}
|
||||
player = null;
|
||||
host.replaceChildren();
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,188 @@
|
||||
// src/data/youtubeLivePlayer.test.mjs — one live stream in YouTube's player,
|
||||
// with the player API faked: its states and errors read back as the LIVE
|
||||
// section's loading / playing / offline / unavailable.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import {
|
||||
LIVE_START_TIMEOUT_MS,
|
||||
createYouTubeLivePlayer,
|
||||
} from './youtubeLivePlayer.js';
|
||||
import { YOUTUBE_EMBED_HOST } from './liveStreams.js';
|
||||
|
||||
/** A stand-in for the panel's host element: counts what is put in it. */
|
||||
function fakeHost() {
|
||||
return {
|
||||
children: [],
|
||||
replaceChildren() {
|
||||
this.children = [];
|
||||
},
|
||||
append(...nodes) {
|
||||
this.children.push(...nodes);
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The player as YouTube's API builds it: records its options and lets the
|
||||
* test fire its events.
|
||||
*/
|
||||
function fakeApi() {
|
||||
const players = [];
|
||||
class Player {
|
||||
constructor(mount, options) {
|
||||
this.mount = mount;
|
||||
this.options = options;
|
||||
this.destroyed = 0;
|
||||
players.push(this);
|
||||
}
|
||||
fire(name, data) {
|
||||
this.options.events[name]?.({ data, target: this });
|
||||
}
|
||||
destroy() {
|
||||
this.destroyed += 1;
|
||||
}
|
||||
}
|
||||
return { YT: { Player }, players };
|
||||
}
|
||||
|
||||
function fixture({ apiFails = false } = {}) {
|
||||
const api = fakeApi();
|
||||
const timers = [];
|
||||
const globalRef = {
|
||||
location: { origin: 'http://localhost:5190' },
|
||||
setTimeout(callback, delay) {
|
||||
const id = timers.length + 1;
|
||||
timers.push({ id, callback, delay, cleared: false });
|
||||
return id;
|
||||
},
|
||||
clearTimeout(id) {
|
||||
const timer = timers.find((entry) => entry.id === id);
|
||||
if (timer) timer.cleared = true;
|
||||
},
|
||||
};
|
||||
const documentRef = { createElement: (tag) => ({ tag }) };
|
||||
const states = [];
|
||||
const host = fakeHost();
|
||||
const player = createYouTubeLivePlayer({
|
||||
host,
|
||||
videoId: 'ROboUHfPUrU',
|
||||
documentRef,
|
||||
globalRef,
|
||||
loadApi: () =>
|
||||
apiFails ? Promise.reject(new Error('blocked')) : Promise.resolve(api.YT),
|
||||
onChange: (state) => states.push(state),
|
||||
});
|
||||
// Let the API promise settle and the player be built.
|
||||
const settle = () => new Promise((resolve) => setImmediate(resolve));
|
||||
const pending = () => timers.filter((timer) => !timer.cleared);
|
||||
return { api, timers, pending, states, host, player, settle };
|
||||
}
|
||||
|
||||
test('the player is built on the privacy host with the live parameters, once the API loads', async () => {
|
||||
const { api, states, host, settle } = fixture();
|
||||
assert.deepEqual(states, [{ state: 'loading', reason: null }]);
|
||||
assert.equal(host.children.length, 1, 'a mount for the iframe is placed');
|
||||
await settle();
|
||||
assert.equal(api.players.length, 1);
|
||||
const { options } = api.players[0];
|
||||
assert.equal(options.host, YOUTUBE_EMBED_HOST);
|
||||
assert.equal(options.videoId, 'ROboUHfPUrU');
|
||||
assert.equal(options.playerVars.enablejsapi, 1);
|
||||
assert.equal(options.playerVars.mute, 1);
|
||||
assert.equal(options.playerVars.origin, 'http://localhost:5190');
|
||||
});
|
||||
|
||||
test('playing clears the start timer; the same state is not reported twice', async () => {
|
||||
const { api, pending, states, settle } = fixture();
|
||||
await settle();
|
||||
const [player] = api.players;
|
||||
player.fire('onReady');
|
||||
assert.equal(pending().length, 1, 'one start timer is running');
|
||||
assert.equal(pending()[0].delay, LIVE_START_TIMEOUT_MS);
|
||||
player.fire('onStateChange', 1);
|
||||
player.fire('onStateChange', 1);
|
||||
assert.equal(pending().length, 0, 'the timer went when playback began');
|
||||
assert.deepEqual(states.at(-1), { state: 'playing', reason: null });
|
||||
assert.equal(states.length, 2);
|
||||
});
|
||||
|
||||
test('a video that ends, or errors for any other reason, reads as offline', async () => {
|
||||
const ended = fixture();
|
||||
await ended.settle();
|
||||
ended.api.players[0].fire('onStateChange', 0);
|
||||
assert.deepEqual(ended.states.at(-1), { state: 'offline', reason: 'ended' });
|
||||
|
||||
const errored = fixture();
|
||||
await errored.settle();
|
||||
errored.api.players[0].fire('onError', 100);
|
||||
assert.deepEqual(errored.states.at(-1), {
|
||||
state: 'offline',
|
||||
reason: 'error-100',
|
||||
});
|
||||
assert.equal(errored.pending().length, 0, 'the start timer is cleared');
|
||||
});
|
||||
|
||||
test('embedding refused by the owner is unavailable, which no retry would change', async () => {
|
||||
for (const code of [101, 150]) {
|
||||
const { api, states, settle } = fixture();
|
||||
await settle();
|
||||
api.players[0].fire('onError', code);
|
||||
assert.deepEqual(states.at(-1), {
|
||||
state: 'unavailable',
|
||||
reason: `error-${code}`,
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
test('a stream that never starts playing is offline when the start timer runs out', async () => {
|
||||
const { api, pending, states, settle } = fixture();
|
||||
await settle();
|
||||
api.players[0].fire('onReady');
|
||||
const [timer] = pending();
|
||||
timer.callback();
|
||||
assert.deepEqual(states.at(-1), { state: 'offline', reason: 'timeout' });
|
||||
// Buffering states before the timer do not count as playing.
|
||||
assert.equal(
|
||||
states.some((entry) => entry.state === 'playing'),
|
||||
false,
|
||||
);
|
||||
});
|
||||
|
||||
test('a timer that fires after playback began changes nothing', async () => {
|
||||
const { api, timers, states, settle } = fixture();
|
||||
await settle();
|
||||
api.players[0].fire('onReady');
|
||||
api.players[0].fire('onStateChange', 1);
|
||||
for (const timer of timers) timer.callback();
|
||||
assert.deepEqual(states.at(-1), { state: 'playing', reason: null });
|
||||
});
|
||||
|
||||
test('an API that does not load leaves the stream unavailable', async () => {
|
||||
const { states, settle } = fixture({ apiFails: true });
|
||||
await settle();
|
||||
assert.deepEqual(states.at(-1), { state: 'unavailable', reason: 'api' });
|
||||
});
|
||||
|
||||
test('destroy empties the host, destroys the player and silences later events', async () => {
|
||||
const { api, host, pending, player, states, settle } = fixture();
|
||||
await settle();
|
||||
const built = api.players[0];
|
||||
built.fire('onReady');
|
||||
player.destroy();
|
||||
player.destroy();
|
||||
assert.equal(built.destroyed, 1);
|
||||
assert.equal(host.children.length, 0);
|
||||
assert.equal(pending().length, 0);
|
||||
const before = states.length;
|
||||
built.fire('onStateChange', 1);
|
||||
built.fire('onError', 150);
|
||||
assert.equal(states.length, before, 'nothing is reported after destroy');
|
||||
});
|
||||
|
||||
test('destroy before the API loads builds no player', async () => {
|
||||
const { api, player, states, settle } = fixture();
|
||||
player.destroy();
|
||||
await settle();
|
||||
assert.equal(api.players.length, 0);
|
||||
assert.deepEqual(states, [{ state: 'loading', reason: null }]);
|
||||
});
|
||||
@@ -144,3 +144,32 @@ export function followOffsetFitting(sphere, at, view = {}) {
|
||||
2 - 1 / Math.max(1, Math.hypot(at.x, at.y, at.z) / WGS84.radii.x);
|
||||
return offsetFromHeadingPitchRange(0, (-Math.PI / 4) * factor, range);
|
||||
}
|
||||
|
||||
/**
|
||||
* The heading, pitch and roll that turn the east-north-up frame at `origin`
|
||||
* onto `axes`: three unit vectors in the Earth-fixed frame that are a
|
||||
* body's own x, y and z axes there (a right-handed set). The inverse of the
|
||||
* renderer's placing of a model by `{heading, pitch, roll}` at a position
|
||||
* (Cesium's `headingPitchRollToFixedFrame`): heading turns about down,
|
||||
* pitch about the turned east axis, roll about the body's own x. Radians.
|
||||
* @param {{x: number, y: number, z: number}} origin
|
||||
* @param {{x: {x: number, y: number, z: number},
|
||||
* y: {x: number, y: number, z: number},
|
||||
* z: {x: number, y: number, z: number}}} axes
|
||||
* @returns {{heading: number, pitch: number, roll: number}}
|
||||
*/
|
||||
export function headingPitchRollOfAxes(origin, axes) {
|
||||
const enu = eastNorthUp(origin);
|
||||
// M = ENUᵀ · [x y z]: the body's axes on the local east, north, up.
|
||||
const m00 = dot(enu.x, axes.x);
|
||||
const m10 = dot(enu.y, axes.x);
|
||||
const m20 = dot(enu.z, axes.x);
|
||||
const m21 = dot(enu.z, axes.y);
|
||||
const m22 = dot(enu.z, axes.z);
|
||||
// M = Rz(-heading) · Ry(-pitch) · Rx(roll).
|
||||
return {
|
||||
heading: -Math.atan2(m10, m00),
|
||||
pitch: Math.asin(Math.max(-1, Math.min(1, m20))),
|
||||
roll: Math.atan2(m21, m22),
|
||||
};
|
||||
}
|
||||
@@ -3981,16 +3981,8 @@
|
||||
"Layer groups": "مجموعات الطبقات",
|
||||
"Jump to {name}": "الانتقال إلى {name}",
|
||||
"No layers match": "لا توجد طبقات مطابقة",
|
||||
"ISS live video": "بث مباشر من محطة الفضاء الدولية",
|
||||
"ISS LIVE · NASA": "محطة الفضاء الدولية مباشر · NASA",
|
||||
"Open on YouTube": "فتح على YouTube",
|
||||
"Close ISS live video": "إغلاق البث المباشر لمحطة الفضاء الدولية",
|
||||
"Live views from the International Space Station (NASA)": "مشاهد مباشرة من محطة الفضاء الدولية (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "يُشغَّل الفيديو من YouTube، الذي يرى عنوان IP الخاص بك.",
|
||||
"ISS command panel": "لوحة التحكم بمحطة الفضاء الدولية",
|
||||
"ISS · COMMAND PANEL": "المحطة الدولية · لوحة التحكم",
|
||||
"Expand command panel": "توسيع لوحة التحكم",
|
||||
"Collapse command panel": "طي لوحة التحكم",
|
||||
"Automatic": "تلقائي",
|
||||
"Manual": "يدوي",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "الألواح والمشعّات تتبع الشمس، والأطباق تتجه نحو أقمار الترحيل، والأذرع تتحرك للتوضيح فقط. محسوبة، وليست قياسات حية.",
|
||||
@@ -4026,5 +4018,73 @@
|
||||
"Resume sway": "استئناف الحركة التلقائية",
|
||||
"Zoom to the ISS": "تقريب إلى المحطة الدولية",
|
||||
"Now: in sunlight": "الآن: في ضوء الشمس",
|
||||
"Now: in the Earth's shadow": "الآن: في ظل الأرض"
|
||||
"Now: in the Earth's shadow": "الآن: في ظل الأرض",
|
||||
"{label} · STATION VIEW": "{label} · منظر المحطة",
|
||||
"STATION VIEW · {name}": "منظر المحطة · {name}",
|
||||
"Previous station view": "منظر المحطة السابق",
|
||||
"Next station view": "منظر المحطة التالي",
|
||||
"OBSERVATION MODULE · ISS": "وحدة رصد · محطة الفضاء الدولية",
|
||||
"European Space Agency (ESA)": "وكالة الفضاء الأوروبية (ESA)",
|
||||
"7 WINDOWS": "7 نوافذ",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "أُطلقت 8 فبراير 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "ترانكويليتي · المنفذ المواجه للأرض",
|
||||
"LABORATORY MODULE · ISS": "وحدة مختبر · محطة الفضاء الدولية",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "وكالة استكشاف الفضاء اليابانية (JAXA)",
|
||||
"2 WINDOWS": "نافذتان",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "أُطلقت 31 مايو 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "هارموني · الجانب الأيسر",
|
||||
"Return to the default view": "العودة إلى العرض الافتراضي",
|
||||
"ON AIR": "على الهواء",
|
||||
"Starting…": "جارٍ البدء…",
|
||||
"Stream is offline": "البث غير متاح حاليًا",
|
||||
"LIVE VIDEO": "فيديو مباشر",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "بث مرتبط بالعنصر",
|
||||
"Live video": "الفيديو المباشر",
|
||||
"Show Live Video": "عرض الفيديو المباشر",
|
||||
"This stream cannot play here": "لا يمكن تشغيل هذا البث هنا",
|
||||
"Expand Live section": "توسيع قسم البث المباشر",
|
||||
"Collapse Live section": "طيّ قسم البث المباشر",
|
||||
"Expand Live": "توسيع البث المباشر",
|
||||
"Collapse Live": "طيّ البث المباشر",
|
||||
"Live streams for the selected object": "البث المباشر للعنصر المحدد",
|
||||
"Stream": "البث",
|
||||
"Previous stream": "البث السابق",
|
||||
"Next stream": "البث التالي",
|
||||
"Try again": "حاول مرة أخرى",
|
||||
"Exterior cameras": "الكاميرات الخارجية",
|
||||
"Live video and space-to-ground audio": "فيديو مباشر وصوت الاتصال بين الفضاء والأرض",
|
||||
"NASA video, via YouTube": "فيديو ناسا، عبر يوتيوب",
|
||||
"Controls for the selected space station": "عناصر التحكم في المحطة الفضائية المحددة",
|
||||
"Expand Station section": "توسيع قسم المحطة",
|
||||
"Collapse Station section": "طيّ قسم المحطة",
|
||||
"Expand Station": "توسيع المحطة",
|
||||
"Collapse Station": "طيّ المحطة",
|
||||
"Manual · telemetry paused": "يدوي · القياسات متوقفة مؤقتًا",
|
||||
"Telemetry · updated {ago} ago": "القياسات · آخر تحديث قبل {ago}",
|
||||
"No signal since {time} · computed values": "لا إشارة منذ {time} · قيم محسوبة",
|
||||
"No signal · computed values": "لا إشارة · قيم محسوبة",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "القياسات غير متاحة · آخر تحديث قبل {ago} · قيم محسوبة",
|
||||
"Telemetry unavailable · computed values": "القياسات غير متاحة · قيم محسوبة",
|
||||
"Telemetry not enabled on this server · computed values": "القياسات غير مفعّلة على هذا الخادم · قيم محسوبة",
|
||||
"No public telemetry · computed values": "لا توجد قياسات عامة · قيم محسوبة",
|
||||
"Zoom to Tiangong": "تقريب إلى تيانغونغ",
|
||||
"Tianhe arm (degrees)": "ذراع تيانهه (درجات)",
|
||||
"Tianhe wings (degrees)": "أجنحة تيانخه (درجات)",
|
||||
"Lab wings (degrees)": "أجنحة المختبرين (درجات)",
|
||||
"Port wing": "الجناح الأيسر",
|
||||
"Starboard wing": "الجناح الأيمن",
|
||||
"Wentian forward · alpha": "ونتيان الأمامي · ألفا",
|
||||
"Wentian forward · beta": "ونتيان الأمامي · بيتا",
|
||||
"Wentian aft · alpha": "ونتيان الخلفي · ألفا",
|
||||
"Wentian aft · beta": "ونتيان الخلفي · بيتا",
|
||||
"Mengtian forward · alpha": "منغتيان الأمامي · ألفا",
|
||||
"Mengtian forward · beta": "منغتيان الأمامي · بيتا",
|
||||
"Mengtian aft · alpha": "منغتيان الخلفي · ألفا",
|
||||
"Mengtian aft · beta": "منغتيان الخلفي · بيتا",
|
||||
"Wentian arm (degrees)": "ذراع ونتيان (درجات)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "الألواح تتبع الشمس، والهوائي يتجه نحو أقمار التتابع، والأذرع تتمايل للتوضيح. محسوب: الصين لا تنشر قياسات حية.",
|
||||
"Telemetry reads while the model is on screen": "تُقرأ القياسات أثناء ظهور النموذج على الشاشة",
|
||||
"Connecting to telemetry…": "جارٍ الاتصال بالقياسات…",
|
||||
"{seconds} s": "{seconds} ث",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "الألواح والمشعّات وأحد الأطباق تتبع القياسات الحية من ناسا. الطبق الآخر ثابت، والأذرع تتحرك للتوضيح فقط."
|
||||
}
|
||||
@@ -3633,16 +3633,8 @@
|
||||
"Layer groups": "Ebenengruppen",
|
||||
"Jump to {name}": "Zu {name} springen",
|
||||
"No layers match": "Keine passenden Ebenen",
|
||||
"ISS live video": "ISS-Livevideo",
|
||||
"ISS LIVE · NASA": "ISS LIVE · NASA",
|
||||
"Open on YouTube": "Auf YouTube öffnen",
|
||||
"Close ISS live video": "ISS-Livevideo schließen",
|
||||
"Live views from the International Space Station (NASA)": "Livebilder von der Internationalen Raumstation (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "Das Video wird von YouTube abgespielt, das Ihre IP-Adresse sieht.",
|
||||
"ISS command panel": "ISS-Steuerpult",
|
||||
"ISS · COMMAND PANEL": "ISS · STEUERPULT",
|
||||
"Expand command panel": "Steuerpult ausklappen",
|
||||
"Collapse command panel": "Steuerpult einklappen",
|
||||
"Automatic": "Automatisch",
|
||||
"Manual": "Manuell",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Solarflügel und Radiatoren folgen der Sonne, die Antennen richten sich auf Relaissatelliten aus und die Arme bewegen sich zur Veranschaulichung. Berechnet, keine Live-Telemetrie.",
|
||||
@@ -3678,5 +3670,73 @@
|
||||
"Resume sway": "Bewegung fortsetzen",
|
||||
"Zoom to the ISS": "Auf die ISS zoomen",
|
||||
"Now: in sunlight": "Jetzt: im Sonnenlicht",
|
||||
"Now: in the Earth's shadow": "Jetzt: im Erdschatten"
|
||||
"Now: in the Earth's shadow": "Jetzt: im Erdschatten",
|
||||
"STATION VIEW · {name}": "STATIONSANSICHT · {name}",
|
||||
"Previous station view": "Vorherige Stationsansicht",
|
||||
"Next station view": "Nächste Stationsansicht",
|
||||
"OBSERVATION MODULE · ISS": "BEOBACHTUNGSMODUL · ISS",
|
||||
"European Space Agency (ESA)": "Europäische Weltraumorganisation (ESA)",
|
||||
"7 WINDOWS": "7 FENSTER",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "GESTARTET 8. FEB. 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · ERDZUGEWANDTER PORT",
|
||||
"LABORATORY MODULE · ISS": "LABORMODUL · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Japanische Raumfahrtagentur (JAXA)",
|
||||
"2 WINDOWS": "2 FENSTER",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "GESTARTET 31. MAI 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · BACKBORDSEITE",
|
||||
"Return to the default view": "Zur Standardansicht zurückkehren",
|
||||
"{label} · STATION VIEW": "{label} · STATIONSANSICHT",
|
||||
"ON AIR": "ON AIR",
|
||||
"Starting…": "Startet…",
|
||||
"Stream is offline": "Der Stream ist offline",
|
||||
"LIVE VIDEO": "LIVE-VIDEO",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "STREAM ZUM OBJEKT",
|
||||
"Live video": "Live-Video",
|
||||
"Show Live Video": "Live-Video anzeigen",
|
||||
"This stream cannot play here": "Dieser Stream kann hier nicht abgespielt werden",
|
||||
"Expand Live section": "Live-Bereich ausklappen",
|
||||
"Collapse Live section": "Live-Bereich einklappen",
|
||||
"Expand Live": "Live ausklappen",
|
||||
"Collapse Live": "Live einklappen",
|
||||
"Live streams for the selected object": "Livestreams zum ausgewählten Objekt",
|
||||
"Stream": "Stream",
|
||||
"Previous stream": "Vorheriger Stream",
|
||||
"Next stream": "Nächster Stream",
|
||||
"Try again": "Erneut versuchen",
|
||||
"Exterior cameras": "Außenkameras",
|
||||
"Live video and space-to-ground audio": "Livevideo und Funkverkehr mit dem Boden",
|
||||
"NASA video, via YouTube": "NASA-Video, über YouTube",
|
||||
"Controls for the selected space station": "Steuerung der ausgewählten Raumstation",
|
||||
"Expand Station section": "Stationsbereich ausklappen",
|
||||
"Collapse Station section": "Stationsbereich einklappen",
|
||||
"Expand Station": "Station ausklappen",
|
||||
"Collapse Station": "Station einklappen",
|
||||
"Manual · telemetry paused": "Manuell · Telemetrie pausiert",
|
||||
"Telemetry · updated {ago} ago": "Telemetrie · aktualisiert vor {ago}",
|
||||
"No signal since {time} · computed values": "Kein Signal seit {time} · berechnete Werte",
|
||||
"No signal · computed values": "Kein Signal · berechnete Werte",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Telemetrie nicht verfügbar · letzte Aktualisierung vor {ago} · berechnete Werte",
|
||||
"Telemetry unavailable · computed values": "Telemetrie nicht verfügbar · berechnete Werte",
|
||||
"Telemetry not enabled on this server · computed values": "Telemetrie auf diesem Server nicht aktiviert · berechnete Werte",
|
||||
"No public telemetry · computed values": "Keine öffentliche Telemetrie · berechnete Werte",
|
||||
"Zoom to Tiangong": "Auf Tiangong zoomen",
|
||||
"Tianhe arm (degrees)": "Tianhe-Arm (Grad)",
|
||||
"Tianhe wings (degrees)": "Tianhe-Flügel (Grad)",
|
||||
"Lab wings (degrees)": "Labor-Flügel (Grad)",
|
||||
"Port wing": "Backbordflügel",
|
||||
"Starboard wing": "Steuerbordflügel",
|
||||
"Wentian forward · alpha": "Wentian vorn · Alpha",
|
||||
"Wentian forward · beta": "Wentian vorn · Beta",
|
||||
"Wentian aft · alpha": "Wentian hinten · Alpha",
|
||||
"Wentian aft · beta": "Wentian hinten · Beta",
|
||||
"Mengtian forward · alpha": "Mengtian vorn · Alpha",
|
||||
"Mengtian forward · beta": "Mengtian vorn · Beta",
|
||||
"Mengtian aft · alpha": "Mengtian hinten · Alpha",
|
||||
"Mengtian aft · beta": "Mengtian hinten · Beta",
|
||||
"Wentian arm (degrees)": "Wentian-Arm (Grad)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Solarflügel folgen der Sonne, die Antenne richtet sich auf Relaissatelliten und die Arme schwenken zur Veranschaulichung. Berechnet: China veröffentlicht keine Live-Telemetrie.",
|
||||
"Telemetry reads while the model is on screen": "Telemetrie wird gelesen, solange das Modell zu sehen ist",
|
||||
"Connecting to telemetry…": "Verbindung zur Telemetrie…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Solarflügel, Radiatoren und eine Antenne folgen der Live-Telemetrie der NASA. Die andere Antenne steht still und die Arme bewegen sich zur Veranschaulichung."
|
||||
}
|
||||
@@ -3720,16 +3720,8 @@
|
||||
"Layer groups": "Grupos de capas",
|
||||
"Jump to {name}": "Ir a {name}",
|
||||
"No layers match": "Ninguna capa coincide",
|
||||
"ISS live video": "Vídeo en directo de la ISS",
|
||||
"ISS LIVE · NASA": "ISS EN DIRECTO · NASA",
|
||||
"Open on YouTube": "Abrir en YouTube",
|
||||
"Close ISS live video": "Cerrar vídeo en directo de la ISS",
|
||||
"Live views from the International Space Station (NASA)": "Imágenes en directo de la Estación Espacial Internacional (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "El vídeo se reproduce desde YouTube, que ve tu dirección IP.",
|
||||
"ISS command panel": "Panel de mando de la ISS",
|
||||
"ISS · COMMAND PANEL": "ISS · PANEL DE MANDO",
|
||||
"Expand command panel": "Expandir panel de mando",
|
||||
"Collapse command panel": "Contraer panel de mando",
|
||||
"Automatic": "Automático",
|
||||
"Manual": "Manual",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Los paneles y radiadores siguen al Sol, las antenas apuntan a los satélites de retransmisión y los brazos se mueven a modo de ilustración. Calculado, no es telemetría en vivo.",
|
||||
@@ -3765,5 +3757,73 @@
|
||||
"Resume sway": "Reanudar movimiento",
|
||||
"Zoom to the ISS": "Acercar a la ISS",
|
||||
"Now: in sunlight": "Ahora: a la luz del Sol",
|
||||
"Now: in the Earth's shadow": "Ahora: a la sombra de la Tierra"
|
||||
"Now: in the Earth's shadow": "Ahora: a la sombra de la Tierra",
|
||||
"{label} · STATION VIEW": "{label} · VISTA DE LA ESTACIÓN",
|
||||
"STATION VIEW · {name}": "VISTA DE LA ESTACIÓN · {name}",
|
||||
"Previous station view": "Vista anterior de la estación",
|
||||
"Next station view": "Siguiente vista de la estación",
|
||||
"OBSERVATION MODULE · ISS": "MÓDULO DE OBSERVACIÓN · ISS",
|
||||
"European Space Agency (ESA)": "Agencia Espacial Europea (ESA)",
|
||||
"7 WINDOWS": "7 VENTANAS",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "LANZADO EL 8 FEB 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · PUERTO ORIENTADO A LA TIERRA",
|
||||
"LABORATORY MODULE · ISS": "MÓDULO LABORATORIO · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Agencia Japonesa de Exploración Aeroespacial (JAXA)",
|
||||
"2 WINDOWS": "2 VENTANAS",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "LANZADO EL 31 MAY 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · LADO DE BABOR",
|
||||
"Return to the default view": "Volver a la vista predeterminada",
|
||||
"ON AIR": "EN EL AIRE",
|
||||
"Starting…": "Iniciando…",
|
||||
"Stream is offline": "La transmisión está fuera de línea",
|
||||
"LIVE VIDEO": "VÍDEO EN VIVO",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "TRANSMISIÓN VINCULADA AL OBJETO",
|
||||
"Live video": "Vídeo en vivo",
|
||||
"Show Live Video": "Mostrar Vídeo en vivo",
|
||||
"This stream cannot play here": "Esta transmisión no se puede reproducir aquí",
|
||||
"Expand Live section": "Expandir la sección En directo",
|
||||
"Collapse Live section": "Contraer la sección En directo",
|
||||
"Expand Live": "Expandir En directo",
|
||||
"Collapse Live": "Contraer En directo",
|
||||
"Live streams for the selected object": "Transmisiones en directo del objeto seleccionado",
|
||||
"Stream": "Transmisión",
|
||||
"Previous stream": "Transmisión anterior",
|
||||
"Next stream": "Siguiente transmisión",
|
||||
"Try again": "Reintentar",
|
||||
"Exterior cameras": "Cámaras exteriores",
|
||||
"Live video and space-to-ground audio": "Vídeo en directo y audio espacio-tierra",
|
||||
"NASA video, via YouTube": "Vídeo de la NASA, vía YouTube",
|
||||
"Controls for the selected space station": "Controles de la estación espacial seleccionada",
|
||||
"Expand Station section": "Expandir la sección Estación",
|
||||
"Collapse Station section": "Contraer la sección Estación",
|
||||
"Expand Station": "Expandir Estación",
|
||||
"Collapse Station": "Contraer Estación",
|
||||
"Manual · telemetry paused": "Manual · telemetría en pausa",
|
||||
"Telemetry · updated {ago} ago": "Telemetría · actualizada hace {ago}",
|
||||
"No signal since {time} · computed values": "Sin señal desde las {time} · valores calculados",
|
||||
"No signal · computed values": "Sin señal · valores calculados",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Telemetría no disponible · última actualización hace {ago} · valores calculados",
|
||||
"Telemetry unavailable · computed values": "Telemetría no disponible · valores calculados",
|
||||
"Telemetry not enabled on this server · computed values": "Telemetría no activada en este servidor · valores calculados",
|
||||
"No public telemetry · computed values": "Sin telemetría pública · valores calculados",
|
||||
"Zoom to Tiangong": "Acercar a Tiangong",
|
||||
"Tianhe arm (degrees)": "Brazo de Tianhe (grados)",
|
||||
"Tianhe wings (degrees)": "Alas de Tianhe (grados)",
|
||||
"Lab wings (degrees)": "Alas de los laboratorios (grados)",
|
||||
"Port wing": "Ala de babor",
|
||||
"Starboard wing": "Ala de estribor",
|
||||
"Wentian forward · alpha": "Wentian delantera · alfa",
|
||||
"Wentian forward · beta": "Wentian delantera · beta",
|
||||
"Wentian aft · alpha": "Wentian trasera · alfa",
|
||||
"Wentian aft · beta": "Wentian trasera · beta",
|
||||
"Mengtian forward · alpha": "Mengtian delantera · alfa",
|
||||
"Mengtian forward · beta": "Mengtian delantera · beta",
|
||||
"Mengtian aft · alpha": "Mengtian trasera · alfa",
|
||||
"Mengtian aft · beta": "Mengtian trasera · beta",
|
||||
"Wentian arm (degrees)": "Brazo de Wentian (grados)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Los paneles siguen al Sol, la antena apunta a los satélites de retransmisión y los brazos se mueven a modo de ilustración. Calculado: China no publica telemetría en directo.",
|
||||
"Telemetry reads while the model is on screen": "La telemetría se lee mientras el modelo está en pantalla",
|
||||
"Connecting to telemetry…": "Conectando con la telemetría…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Los paneles, los radiadores y una antena siguen la telemetría en vivo de la NASA. La otra antena permanece quieta y los brazos se mueven a modo de ilustración."
|
||||
}
|
||||
@@ -3720,16 +3720,8 @@
|
||||
"Layer groups": "Groupes de couches",
|
||||
"Jump to {name}": "Aller à {name}",
|
||||
"No layers match": "Aucune couche ne correspond",
|
||||
"ISS live video": "Vidéo en direct de l’ISS",
|
||||
"ISS LIVE · NASA": "ISS EN DIRECT · NASA",
|
||||
"Open on YouTube": "Ouvrir sur YouTube",
|
||||
"Close ISS live video": "Fermer la vidéo en direct de l’ISS",
|
||||
"Live views from the International Space Station (NASA)": "Images en direct de la Station spatiale internationale (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "La vidéo est lue depuis YouTube, qui voit votre adresse IP.",
|
||||
"ISS command panel": "Panneau de commande de l'ISS",
|
||||
"ISS · COMMAND PANEL": "ISS · PANNEAU DE COMMANDE",
|
||||
"Expand command panel": "Développer le panneau de commande",
|
||||
"Collapse command panel": "Réduire le panneau de commande",
|
||||
"Automatic": "Automatique",
|
||||
"Manual": "Manuel",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Les panneaux et les radiateurs suivent le Soleil, les antennes visent les satellites relais et les bras bougent à titre d'illustration. Calculé, pas de télémétrie en direct.",
|
||||
@@ -3765,5 +3757,73 @@
|
||||
"Resume sway": "Reprendre le mouvement",
|
||||
"Zoom to the ISS": "Zoomer sur l'ISS",
|
||||
"Now: in sunlight": "En ce moment : au soleil",
|
||||
"Now: in the Earth's shadow": "En ce moment : dans l'ombre de la Terre"
|
||||
"Now: in the Earth's shadow": "En ce moment : dans l'ombre de la Terre",
|
||||
"STATION VIEW · {name}": "VUE DE LA STATION · {name}",
|
||||
"Previous station view": "Vue précédente de la station",
|
||||
"Next station view": "Vue suivante de la station",
|
||||
"OBSERVATION MODULE · ISS": "MODULE D'OBSERVATION · ISS",
|
||||
"European Space Agency (ESA)": "Agence spatiale européenne (ESA)",
|
||||
"7 WINDOWS": "7 HUBLOTS",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "LANCÉ LE 8 FÉV. 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · PORT ORIENTÉ VERS LA TERRE",
|
||||
"LABORATORY MODULE · ISS": "MODULE LABORATOIRE · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Agence japonaise d'exploration aérospatiale (JAXA)",
|
||||
"2 WINDOWS": "2 HUBLOTS",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "LANCÉ LE 31 MAI 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · CÔTÉ BÂBORD",
|
||||
"Return to the default view": "Revenir à la vue par défaut",
|
||||
"{label} · STATION VIEW": "{label} · VUE DE LA STATION",
|
||||
"ON AIR": "À L’ANTENNE",
|
||||
"Starting…": "Démarrage…",
|
||||
"Stream is offline": "Le flux est hors ligne",
|
||||
"LIVE VIDEO": "VIDÉO EN DIRECT",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "FLUX ATTACHÉ À L’OBJET",
|
||||
"Live video": "Vidéo en direct",
|
||||
"Show Live Video": "Afficher la vidéo en direct",
|
||||
"This stream cannot play here": "Ce flux ne peut pas être lu ici",
|
||||
"Expand Live section": "Déplier la section Direct",
|
||||
"Collapse Live section": "Replier la section Direct",
|
||||
"Expand Live": "Déplier Direct",
|
||||
"Collapse Live": "Replier Direct",
|
||||
"Live streams for the selected object": "Flux en direct de l’objet sélectionné",
|
||||
"Stream": "Flux",
|
||||
"Previous stream": "Flux précédent",
|
||||
"Next stream": "Flux suivant",
|
||||
"Try again": "Réessayer",
|
||||
"Exterior cameras": "Caméras extérieures",
|
||||
"Live video and space-to-ground audio": "Vidéo en direct et audio espace-sol",
|
||||
"NASA video, via YouTube": "Vidéo de la NASA, via YouTube",
|
||||
"Controls for the selected space station": "Commandes de la station spatiale sélectionnée",
|
||||
"Expand Station section": "Déplier la section Station",
|
||||
"Collapse Station section": "Replier la section Station",
|
||||
"Expand Station": "Déplier Station",
|
||||
"Collapse Station": "Replier Station",
|
||||
"Manual · telemetry paused": "Manuel · télémétrie en pause",
|
||||
"Telemetry · updated {ago} ago": "Télémétrie · mise à jour il y a {ago}",
|
||||
"No signal since {time} · computed values": "Pas de signal depuis {time} · valeurs calculées",
|
||||
"No signal · computed values": "Pas de signal · valeurs calculées",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Télémétrie indisponible · dernière mise à jour il y a {ago} · valeurs calculées",
|
||||
"Telemetry unavailable · computed values": "Télémétrie indisponible · valeurs calculées",
|
||||
"Telemetry not enabled on this server · computed values": "Télémétrie non activée sur ce serveur · valeurs calculées",
|
||||
"No public telemetry · computed values": "Pas de télémétrie publique · valeurs calculées",
|
||||
"Zoom to Tiangong": "Zoomer sur Tiangong",
|
||||
"Tianhe arm (degrees)": "Bras de Tianhe (degrés)",
|
||||
"Tianhe wings (degrees)": "Ailes de Tianhe (degrés)",
|
||||
"Lab wings (degrees)": "Ailes des laboratoires (degrés)",
|
||||
"Port wing": "Aile bâbord",
|
||||
"Starboard wing": "Aile tribord",
|
||||
"Wentian forward · alpha": "Wentian avant · alpha",
|
||||
"Wentian forward · beta": "Wentian avant · bêta",
|
||||
"Wentian aft · alpha": "Wentian arrière · alpha",
|
||||
"Wentian aft · beta": "Wentian arrière · bêta",
|
||||
"Mengtian forward · alpha": "Mengtian avant · alpha",
|
||||
"Mengtian forward · beta": "Mengtian avant · bêta",
|
||||
"Mengtian aft · alpha": "Mengtian arrière · alpha",
|
||||
"Mengtian aft · beta": "Mengtian arrière · bêta",
|
||||
"Wentian arm (degrees)": "Bras de Wentian (degrés)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Les panneaux suivent le Soleil, l'antenne vise les satellites relais et les bras oscillent à titre d'illustration. Calculé : la Chine ne publie pas de télémétrie en direct.",
|
||||
"Telemetry reads while the model is on screen": "La télémétrie est lue tant que le modèle est à l'écran",
|
||||
"Connecting to telemetry…": "Connexion à la télémétrie…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Les panneaux, les radiateurs et une antenne suivent la télémétrie en direct de la NASA. L'autre antenne reste immobile et les bras bougent à titre d'illustration."
|
||||
}
|
||||
@@ -3720,16 +3720,8 @@
|
||||
"Layer groups": "קבוצות שכבות",
|
||||
"Jump to {name}": "מעבר אל {name}",
|
||||
"No layers match": "אין שכבות תואמות",
|
||||
"ISS live video": "שידור חי מתחנת החלל",
|
||||
"ISS LIVE · NASA": "ISS בשידור חי · NASA",
|
||||
"Open on YouTube": "פתיחה ב-YouTube",
|
||||
"Close ISS live video": "סגירת השידור החי מתחנת החלל",
|
||||
"Live views from the International Space Station (NASA)": "צילומים חיים מתחנת החלל הבינלאומית (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "הווידאו זורם מ-YouTube, שרואה את כתובת ה-IP שלך.",
|
||||
"ISS command panel": "לוח הפיקוד של תחנת החלל",
|
||||
"ISS · COMMAND PANEL": "תחנת החלל · לוח פיקוד",
|
||||
"Expand command panel": "הרחבת לוח הפיקוד",
|
||||
"Collapse command panel": "כיווץ לוח הפיקוד",
|
||||
"Automatic": "אוטומטי",
|
||||
"Manual": "ידני",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "הלוחות והרדיאטורים עוקבים אחר השמש, הצלחות מכוונות ללווייני ממסר והזרועות נעות להמחשה בלבד. מחושב, לא טלמטריה חיה.",
|
||||
@@ -3765,5 +3757,73 @@
|
||||
"Resume sway": "חידוש התנועה",
|
||||
"Zoom to the ISS": "התקרבות לתחנת החלל",
|
||||
"Now: in sunlight": "כעת: באור השמש",
|
||||
"Now: in the Earth's shadow": "כעת: בצל כדור הארץ"
|
||||
"Now: in the Earth's shadow": "כעת: בצל כדור הארץ",
|
||||
"{label} · STATION VIEW": "{label} · תצוגת התחנה",
|
||||
"STATION VIEW · {name}": "תצוגת התחנה · {name}",
|
||||
"Previous station view": "תצוגת התחנה הקודמת",
|
||||
"Next station view": "תצוגת התחנה הבאה",
|
||||
"OBSERVATION MODULE · ISS": "מודול תצפית · תחנת החלל",
|
||||
"European Space Agency (ESA)": "סוכנות החלל האירופית (ESA)",
|
||||
"7 WINDOWS": "7 חלונות",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "שוגר ב-8 בפברואר 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "טרנקוויליטי · פתח הפונה לכדור הארץ",
|
||||
"LABORATORY MODULE · ISS": "מודול מעבדה · תחנת החלל",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "סוכנות חקר החלל היפנית (JAXA)",
|
||||
"2 WINDOWS": "2 חלונות",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "שוגר ב-31 במאי 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "הרמוני · צד שמאל",
|
||||
"Return to the default view": "חזרה לתצוגת ברירת המחדל",
|
||||
"ON AIR": "בשידור",
|
||||
"Starting…": "מתחיל…",
|
||||
"Stream is offline": "השידור אינו פעיל",
|
||||
"LIVE VIDEO": "וידאו חי",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "שידור המשויך לפריט",
|
||||
"Live video": "וידאו חי",
|
||||
"Show Live Video": "הצגת וידאו חי",
|
||||
"This stream cannot play here": "לא ניתן להפעיל שידור זה כאן",
|
||||
"Expand Live section": "הרחבת מקטע השידור החי",
|
||||
"Collapse Live section": "כיווץ מקטע השידור החי",
|
||||
"Expand Live": "הרחבת שידור חי",
|
||||
"Collapse Live": "כיווץ שידור חי",
|
||||
"Live streams for the selected object": "שידורים חיים של הפריט שנבחר",
|
||||
"Stream": "שידור",
|
||||
"Previous stream": "השידור הקודם",
|
||||
"Next stream": "השידור הבא",
|
||||
"Try again": "ניסיון חוזר",
|
||||
"Exterior cameras": "מצלמות חיצוניות",
|
||||
"Live video and space-to-ground audio": "וידאו חי ושמע חלל–קרקע",
|
||||
"NASA video, via YouTube": "וידאו של נאס״א, דרך יוטיוב",
|
||||
"Controls for the selected space station": "בקרות לתחנת החלל שנבחרה",
|
||||
"Expand Station section": "הרחבת מקטע התחנה",
|
||||
"Collapse Station section": "כיווץ מקטע התחנה",
|
||||
"Expand Station": "הרחבת התחנה",
|
||||
"Collapse Station": "כיווץ התחנה",
|
||||
"Manual · telemetry paused": "ידני · הטלמטריה מושהית",
|
||||
"Telemetry · updated {ago} ago": "טלמטריה · עודכנה לפני {ago}",
|
||||
"No signal since {time} · computed values": "אין אות מאז {time} · ערכים מחושבים",
|
||||
"No signal · computed values": "אין אות · ערכים מחושבים",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "הטלמטריה אינה זמינה · עדכון אחרון לפני {ago} · ערכים מחושבים",
|
||||
"Telemetry unavailable · computed values": "הטלמטריה אינה זמינה · ערכים מחושבים",
|
||||
"Telemetry not enabled on this server · computed values": "הטלמטריה אינה מופעלת בשרת זה · ערכים מחושבים",
|
||||
"No public telemetry · computed values": "אין טלמטריה ציבורית · ערכים מחושבים",
|
||||
"Zoom to Tiangong": "התקרבות לטיאנגונג",
|
||||
"Tianhe arm (degrees)": "זרוע טיאנהה (מעלות)",
|
||||
"Tianhe wings (degrees)": "כנפי טיאנחה (מעלות)",
|
||||
"Lab wings (degrees)": "כנפי המעבדות (מעלות)",
|
||||
"Port wing": "כנף שמאל",
|
||||
"Starboard wing": "כנף ימין",
|
||||
"Wentian forward · alpha": "ונטיאן קדמי · אלפא",
|
||||
"Wentian forward · beta": "ונטיאן קדמי · בטא",
|
||||
"Wentian aft · alpha": "ונטיאן אחורי · אלפא",
|
||||
"Wentian aft · beta": "ונטיאן אחורי · בטא",
|
||||
"Mengtian forward · alpha": "מנגטיאן קדמי · אלפא",
|
||||
"Mengtian forward · beta": "מנגטיאן קדמי · בטא",
|
||||
"Mengtian aft · alpha": "מנגטיאן אחורי · אלפא",
|
||||
"Mengtian aft · beta": "מנגטיאן אחורי · בטא",
|
||||
"Wentian arm (degrees)": "זרוע ונטיאן (מעלות)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "הלוחות עוקבים אחר השמש, האנטנה מכוונת ללווייני ממסר והזרועות נעות לצורכי הדגמה. מחושב: סין אינה מפרסמת טלמטריה חיה.",
|
||||
"Telemetry reads while the model is on screen": "הטלמטריה נקראת כל עוד הדגם מוצג על המסך",
|
||||
"Connecting to telemetry…": "מתחבר לטלמטריה…",
|
||||
"{seconds} s": "{seconds} שנ׳",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "הלוחות, הרדיאטורים וצלחת אחת עוקבים אחר הטלמטריה החיה של נאס״א. הצלחת השנייה נשארת במקומה והזרועות נעות להמחשה בלבד."
|
||||
}
|
||||
@@ -3720,16 +3720,8 @@
|
||||
"Layer groups": "Gruppi di livelli",
|
||||
"Jump to {name}": "Vai a {name}",
|
||||
"No layers match": "Nessun livello corrisponde",
|
||||
"ISS live video": "Video in diretta dalla ISS",
|
||||
"ISS LIVE · NASA": "ISS IN DIRETTA · NASA",
|
||||
"Open on YouTube": "Apri su YouTube",
|
||||
"Close ISS live video": "Chiudi il video in diretta della ISS",
|
||||
"Live views from the International Space Station (NASA)": "Immagini in diretta dalla Stazione Spaziale Internazionale (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "Il video viene riprodotto da YouTube, che vede il tuo indirizzo IP.",
|
||||
"ISS command panel": "Pannello di comando della ISS",
|
||||
"ISS · COMMAND PANEL": "ISS · PANNELLO DI COMANDO",
|
||||
"Expand command panel": "Espandi pannello di comando",
|
||||
"Collapse command panel": "Comprimi pannello di comando",
|
||||
"Automatic": "Automatico",
|
||||
"Manual": "Manuale",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Pannelli e radiatori seguono il Sole, le antenne puntano ai satelliti di collegamento e i bracci si muovono a scopo illustrativo. Calcolato, non telemetria in diretta.",
|
||||
@@ -3765,5 +3757,73 @@
|
||||
"Resume sway": "Riprendi movimento",
|
||||
"Zoom to the ISS": "Zoom sulla ISS",
|
||||
"Now: in sunlight": "Ora: alla luce del Sole",
|
||||
"Now: in the Earth's shadow": "Ora: nell'ombra della Terra"
|
||||
"Now: in the Earth's shadow": "Ora: nell'ombra della Terra",
|
||||
"STATION VIEW · {name}": "VISTA DELLA STAZIONE · {name}",
|
||||
"Previous station view": "Vista precedente della stazione",
|
||||
"Next station view": "Vista successiva della stazione",
|
||||
"OBSERVATION MODULE · ISS": "MODULO DI OSSERVAZIONE · ISS",
|
||||
"European Space Agency (ESA)": "Agenzia Spaziale Europea (ESA)",
|
||||
"7 WINDOWS": "7 FINESTRINI",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "LANCIATO L’8 FEB 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · PORTELLONE RIVOLTO ALLA TERRA",
|
||||
"LABORATORY MODULE · ISS": "MODULO LABORATORIO · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Agenzia Giapponese per l’Esplorazione Aerospaziale (JAXA)",
|
||||
"2 WINDOWS": "2 FINESTRINI",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "LANCIATO IL 31 MAG 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · LATO DI BABORDO",
|
||||
"Return to the default view": "Torna alla vista predefinita",
|
||||
"{label} · STATION VIEW": "{label} · VISTA DELLA STAZIONE",
|
||||
"ON AIR": "IN ONDA",
|
||||
"Starting…": "Avvio…",
|
||||
"Stream is offline": "La diretta è offline",
|
||||
"LIVE VIDEO": "VIDEO LIVE",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "DIRETTA COLLEGATA ALL’OGGETTO",
|
||||
"Live video": "Video live",
|
||||
"Show Live Video": "Mostra Video live",
|
||||
"This stream cannot play here": "Questa diretta non può essere riprodotta qui",
|
||||
"Expand Live section": "Espandi la sezione Live",
|
||||
"Collapse Live section": "Comprimi la sezione Live",
|
||||
"Expand Live": "Espandi Live",
|
||||
"Collapse Live": "Comprimi Live",
|
||||
"Live streams for the selected object": "Dirette dell’oggetto selezionato",
|
||||
"Stream": "Diretta",
|
||||
"Previous stream": "Diretta precedente",
|
||||
"Next stream": "Diretta successiva",
|
||||
"Try again": "Riprova",
|
||||
"Exterior cameras": "Telecamere esterne",
|
||||
"Live video and space-to-ground audio": "Video in diretta e audio spazio-terra",
|
||||
"NASA video, via YouTube": "Video NASA, tramite YouTube",
|
||||
"Controls for the selected space station": "Controlli della stazione spaziale selezionata",
|
||||
"Expand Station section": "Espandi la sezione Stazione",
|
||||
"Collapse Station section": "Comprimi la sezione Stazione",
|
||||
"Expand Station": "Espandi Stazione",
|
||||
"Collapse Station": "Comprimi Stazione",
|
||||
"Manual · telemetry paused": "Manuale · telemetria in pausa",
|
||||
"Telemetry · updated {ago} ago": "Telemetria · aggiornata {ago} fa",
|
||||
"No signal since {time} · computed values": "Nessun segnale dalle {time} · valori calcolati",
|
||||
"No signal · computed values": "Nessun segnale · valori calcolati",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Telemetria non disponibile · ultimo aggiornamento {ago} fa · valori calcolati",
|
||||
"Telemetry unavailable · computed values": "Telemetria non disponibile · valori calcolati",
|
||||
"Telemetry not enabled on this server · computed values": "Telemetria non attivata su questo server · valori calcolati",
|
||||
"No public telemetry · computed values": "Nessuna telemetria pubblica · valori calcolati",
|
||||
"Zoom to Tiangong": "Zoom su Tiangong",
|
||||
"Tianhe arm (degrees)": "Braccio di Tianhe (gradi)",
|
||||
"Tianhe wings (degrees)": "Ali di Tianhe (gradi)",
|
||||
"Lab wings (degrees)": "Ali dei laboratori (gradi)",
|
||||
"Port wing": "Ala di sinistra",
|
||||
"Starboard wing": "Ala di dritta",
|
||||
"Wentian forward · alpha": "Wentian anteriore · alfa",
|
||||
"Wentian forward · beta": "Wentian anteriore · beta",
|
||||
"Wentian aft · alpha": "Wentian posteriore · alfa",
|
||||
"Wentian aft · beta": "Wentian posteriore · beta",
|
||||
"Mengtian forward · alpha": "Mengtian anteriore · alfa",
|
||||
"Mengtian forward · beta": "Mengtian anteriore · beta",
|
||||
"Mengtian aft · alpha": "Mengtian posteriore · alfa",
|
||||
"Mengtian aft · beta": "Mengtian posteriore · beta",
|
||||
"Wentian arm (degrees)": "Braccio di Wentian (gradi)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "I pannelli seguono il Sole, l'antenna punta ai satelliti di collegamento e i bracci oscillano a scopo illustrativo. Calcolato: la Cina non pubblica telemetria in tempo reale.",
|
||||
"Telemetry reads while the model is on screen": "La telemetria viene letta finché il modello è sullo schermo",
|
||||
"Connecting to telemetry…": "Connessione alla telemetria…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Pannelli, radiatori e un'antenna seguono la telemetria in diretta della NASA. L'altra antenna resta ferma e i bracci si muovono a scopo illustrativo."
|
||||
}
|
||||
@@ -3546,16 +3546,8 @@
|
||||
"Layer groups": "レイヤーのグループ",
|
||||
"Jump to {name}": "{name} へ移動",
|
||||
"No layers match": "一致するレイヤーはありません",
|
||||
"ISS live video": "ISSのライブ映像",
|
||||
"ISS LIVE · NASA": "ISS ライブ · NASA",
|
||||
"Open on YouTube": "YouTubeで開く",
|
||||
"Close ISS live video": "ISSのライブ映像を閉じる",
|
||||
"Live views from the International Space Station (NASA)": "国際宇宙ステーションからのライブ映像(NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "動画は YouTube から再生され、YouTube にはあなたの IP アドレスが見えます。",
|
||||
"ISS command panel": "ISSコマンドパネル",
|
||||
"ISS · COMMAND PANEL": "ISS · コマンドパネル",
|
||||
"Expand command panel": "コマンドパネルを開く",
|
||||
"Collapse command panel": "コマンドパネルを閉じる",
|
||||
"Automatic": "自動",
|
||||
"Manual": "手動",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "太陽電池パネルとラジエーターは太陽を追い、アンテナは中継衛星を向き、アームは説明用にゆっくり動きます。計算による表示で、実際のテレメトリではありません。",
|
||||
@@ -3591,5 +3583,73 @@
|
||||
"Resume sway": "自動の動きに戻す",
|
||||
"Zoom to the ISS": "ISSにズーム",
|
||||
"Now: in sunlight": "現在:日なた",
|
||||
"Now: in the Earth's shadow": "現在:地球の影の中"
|
||||
"Now: in the Earth's shadow": "現在:地球の影の中",
|
||||
"STATION VIEW · {name}": "ステーションビュー · {name}",
|
||||
"Previous station view": "前のステーションビュー",
|
||||
"Next station view": "次のステーションビュー",
|
||||
"OBSERVATION MODULE · ISS": "観測モジュール · ISS",
|
||||
"European Space Agency (ESA)": "欧州宇宙機関(ESA)",
|
||||
"7 WINDOWS": "窓 7 枚",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "2010年2月8日打ち上げ · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "トランクウィリティー · 地球側ポート",
|
||||
"LABORATORY MODULE · ISS": "実験モジュール · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "宇宙航空研究開発機構(JAXA)",
|
||||
"2 WINDOWS": "窓 2 枚",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "2008年5月31日打ち上げ · STS-124",
|
||||
"HARMONY · PORT SIDE": "ハーモニー · 左舷側",
|
||||
"Return to the default view": "既定のビューに戻す",
|
||||
"{label} · STATION VIEW": "{label} · ステーションビュー",
|
||||
"ON AIR": "オンエア",
|
||||
"Starting…": "開始しています…",
|
||||
"Stream is offline": "ストリームはオフラインです",
|
||||
"LIVE VIDEO": "ライブ映像",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "対象に紐づくライブ配信",
|
||||
"Live video": "ライブ映像",
|
||||
"Show Live Video": "ライブ映像を表示",
|
||||
"This stream cannot play here": "このストリームはここでは再生できません",
|
||||
"Expand Live section": "ライブセクションを展開",
|
||||
"Collapse Live section": "ライブセクションを折りたたむ",
|
||||
"Expand Live": "ライブを展開",
|
||||
"Collapse Live": "ライブを折りたたむ",
|
||||
"Live streams for the selected object": "選択中のオブジェクトのライブ配信",
|
||||
"Stream": "ストリーム",
|
||||
"Previous stream": "前のストリーム",
|
||||
"Next stream": "次のストリーム",
|
||||
"Try again": "再試行",
|
||||
"Exterior cameras": "船外カメラ",
|
||||
"Live video and space-to-ground audio": "ライブ映像と地上との交信音声",
|
||||
"NASA video, via YouTube": "NASAの映像、YouTube経由",
|
||||
"Controls for the selected space station": "選択中の宇宙ステーションの操作",
|
||||
"Expand Station section": "ステーションセクションを展開",
|
||||
"Collapse Station section": "ステーションセクションを折りたたむ",
|
||||
"Expand Station": "ステーションを展開",
|
||||
"Collapse Station": "ステーションを折りたたむ",
|
||||
"Manual · telemetry paused": "手動 · テレメトリ一時停止",
|
||||
"Telemetry · updated {ago} ago": "テレメトリ · {ago}前に更新",
|
||||
"No signal since {time} · computed values": "{time}から信号なし · 計算値",
|
||||
"No signal · computed values": "信号なし · 計算値",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "テレメトリ利用不可 · 最終更新は{ago}前 · 計算値",
|
||||
"Telemetry unavailable · computed values": "テレメトリ利用不可 · 計算値",
|
||||
"Telemetry not enabled on this server · computed values": "このサーバーではテレメトリが無効 · 計算値",
|
||||
"No public telemetry · computed values": "公開テレメトリなし · 計算値",
|
||||
"Zoom to Tiangong": "天宮にズーム",
|
||||
"Tianhe arm (degrees)": "天和アーム(度)",
|
||||
"Tianhe wings (degrees)": "天和の翼(度)",
|
||||
"Lab wings (degrees)": "実験モジュールの翼(度)",
|
||||
"Port wing": "左舷の翼",
|
||||
"Starboard wing": "右舷の翼",
|
||||
"Wentian forward · alpha": "問天 前方 · アルファ",
|
||||
"Wentian forward · beta": "問天 前方 · ベータ",
|
||||
"Wentian aft · alpha": "問天 後方 · アルファ",
|
||||
"Wentian aft · beta": "問天 後方 · ベータ",
|
||||
"Mengtian forward · alpha": "夢天 前方 · アルファ",
|
||||
"Mengtian forward · beta": "夢天 前方 · ベータ",
|
||||
"Mengtian aft · alpha": "夢天 後方 · アルファ",
|
||||
"Mengtian aft · beta": "夢天 後方 · ベータ",
|
||||
"Wentian arm (degrees)": "問天アーム(度)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "太陽電池パネルは太陽を追い、アンテナは中継衛星に向き、アームは説明のために揺れます。計算値:中国はライブテレメトリを公開していません。",
|
||||
"Telemetry reads while the model is on screen": "テレメトリはモデルが画面にある間に読み取られます",
|
||||
"Connecting to telemetry…": "テレメトリに接続中…",
|
||||
"{seconds} s": "{seconds} 秒",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "太陽電池パネル、ラジエーター、アンテナの1基はNASAのライブテレメトリに従います。もう1基のアンテナは動かず、アームは説明用にゆっくり動きます。"
|
||||
}
|
||||
@@ -3720,16 +3720,8 @@
|
||||
"Layer groups": "Grupos de camadas",
|
||||
"Jump to {name}": "Ir para {name}",
|
||||
"No layers match": "Nenhuma camada corresponde",
|
||||
"ISS live video": "Vídeo ao vivo da ISS",
|
||||
"ISS LIVE · NASA": "ISS AO VIVO · NASA",
|
||||
"Open on YouTube": "Abrir no YouTube",
|
||||
"Close ISS live video": "Fechar vídeo ao vivo da ISS",
|
||||
"Live views from the International Space Station (NASA)": "Imagens ao vivo da Estação Espacial Internacional (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "O vídeo é reproduzido a partir do YouTube, que vê o seu endereço IP.",
|
||||
"ISS command panel": "Painel de comando da ISS",
|
||||
"ISS · COMMAND PANEL": "ISS · PAINEL DE COMANDO",
|
||||
"Expand command panel": "Expandir painel de comando",
|
||||
"Collapse command panel": "Minimizar painel de comando",
|
||||
"Automatic": "Automático",
|
||||
"Manual": "Manual",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Painéis e radiadores seguem o Sol, as antenas apontam para os satélites de retransmissão e os braços se movem de forma ilustrativa. Calculado, não é telemetria ao vivo.",
|
||||
@@ -3765,5 +3757,73 @@
|
||||
"Resume sway": "Retomar movimento",
|
||||
"Zoom to the ISS": "Aproximar da ISS",
|
||||
"Now: in sunlight": "Agora: na luz do Sol",
|
||||
"Now: in the Earth's shadow": "Agora: na sombra da Terra"
|
||||
"Now: in the Earth's shadow": "Agora: na sombra da Terra",
|
||||
"STATION VIEW · {name}": "VISTA DA ESTAÇÃO · {name}",
|
||||
"Previous station view": "Vista anterior da estação",
|
||||
"Next station view": "Próxima vista da estação",
|
||||
"OBSERVATION MODULE · ISS": "MÓDULO DE OBSERVAÇÃO · ISS",
|
||||
"European Space Agency (ESA)": "Agência Espacial Europeia (ESA)",
|
||||
"7 WINDOWS": "7 JANELAS",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "LANÇADO EM 8 FEV 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · PORTA VOLTADA PARA A TERRA",
|
||||
"LABORATORY MODULE · ISS": "MÓDULO LABORATÓRIO · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Agência de Exploração Aeroespacial do Japão (JAXA)",
|
||||
"2 WINDOWS": "2 JANELAS",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "LANÇADO EM 31 MAI 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · LADO BOMBORDO",
|
||||
"Return to the default view": "Voltar à vista padrão",
|
||||
"{label} · STATION VIEW": "{label} · VISTA DA ESTAÇÃO",
|
||||
"ON AIR": "NO AR",
|
||||
"Starting…": "A iniciar…",
|
||||
"Stream is offline": "A transmissão está offline",
|
||||
"LIVE VIDEO": "VÍDEO AO VIVO",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "TRANSMISSÃO VINCULADA AO OBJETO",
|
||||
"Live video": "Vídeo ao vivo",
|
||||
"Show Live Video": "Mostrar vídeo ao vivo",
|
||||
"This stream cannot play here": "Esta transmissão não pode ser reproduzida aqui",
|
||||
"Expand Live section": "Expandir a secção Ao vivo",
|
||||
"Collapse Live section": "Recolher a secção Ao vivo",
|
||||
"Expand Live": "Expandir Ao vivo",
|
||||
"Collapse Live": "Recolher Ao vivo",
|
||||
"Live streams for the selected object": "Transmissões ao vivo do objeto selecionado",
|
||||
"Stream": "Transmissão",
|
||||
"Previous stream": "Transmissão anterior",
|
||||
"Next stream": "Próxima transmissão",
|
||||
"Try again": "Tentar novamente",
|
||||
"Exterior cameras": "Câmaras exteriores",
|
||||
"Live video and space-to-ground audio": "Vídeo ao vivo e áudio espaço-terra",
|
||||
"NASA video, via YouTube": "Vídeo da NASA, via YouTube",
|
||||
"Controls for the selected space station": "Controlos da estação espacial selecionada",
|
||||
"Expand Station section": "Expandir a secção Estação",
|
||||
"Collapse Station section": "Recolher a secção Estação",
|
||||
"Expand Station": "Expandir Estação",
|
||||
"Collapse Station": "Recolher Estação",
|
||||
"Manual · telemetry paused": "Manual · telemetria em pausa",
|
||||
"Telemetry · updated {ago} ago": "Telemetria · atualizada há {ago}",
|
||||
"No signal since {time} · computed values": "Sem sinal desde as {time} · valores calculados",
|
||||
"No signal · computed values": "Sem sinal · valores calculados",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Telemetria indisponível · última atualização há {ago} · valores calculados",
|
||||
"Telemetry unavailable · computed values": "Telemetria indisponível · valores calculados",
|
||||
"Telemetry not enabled on this server · computed values": "Telemetria não ativada neste servidor · valores calculados",
|
||||
"No public telemetry · computed values": "Sem telemetria pública · valores calculados",
|
||||
"Zoom to Tiangong": "Aproximar de Tiangong",
|
||||
"Tianhe arm (degrees)": "Braço de Tianhe (graus)",
|
||||
"Tianhe wings (degrees)": "Asas de Tianhe (graus)",
|
||||
"Lab wings (degrees)": "Asas dos laboratórios (graus)",
|
||||
"Port wing": "Asa de bombordo",
|
||||
"Starboard wing": "Asa de estibordo",
|
||||
"Wentian forward · alpha": "Wentian dianteira · alfa",
|
||||
"Wentian forward · beta": "Wentian dianteira · beta",
|
||||
"Wentian aft · alpha": "Wentian traseira · alfa",
|
||||
"Wentian aft · beta": "Wentian traseira · beta",
|
||||
"Mengtian forward · alpha": "Mengtian dianteira · alfa",
|
||||
"Mengtian forward · beta": "Mengtian dianteira · beta",
|
||||
"Mengtian aft · alpha": "Mengtian traseira · alfa",
|
||||
"Mengtian aft · beta": "Mengtian traseira · beta",
|
||||
"Wentian arm (degrees)": "Braço de Wentian (graus)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Os painéis seguem o Sol, a antena aponta para os satélites de retransmissão e os braços oscilam a título ilustrativo. Calculado: a China não publica telemetria em direto.",
|
||||
"Telemetry reads while the model is on screen": "A telemetria é lida enquanto o modelo está no ecrã",
|
||||
"Connecting to telemetry…": "A ligar à telemetria…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Painéis, radiadores e uma antena seguem a telemetria ao vivo da NASA. A outra antena fica parada e os braços se movem de forma ilustrativa."
|
||||
}
|
||||
@@ -3807,16 +3807,8 @@
|
||||
"Layer groups": "Группы слоёв",
|
||||
"Jump to {name}": "Перейти к «{name}»",
|
||||
"No layers match": "Нет подходящих слоёв",
|
||||
"ISS live video": "Прямая трансляция с МКС",
|
||||
"ISS LIVE · NASA": "МКС В ЭФИРЕ · NASA",
|
||||
"Open on YouTube": "Открыть на YouTube",
|
||||
"Close ISS live video": "Закрыть трансляцию с МКС",
|
||||
"Live views from the International Space Station (NASA)": "Прямая трансляция с Международной космической станции (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "Видео воспроизводится с YouTube, который видит ваш IP-адрес.",
|
||||
"ISS command panel": "Панель управления МКС",
|
||||
"ISS · COMMAND PANEL": "МКС · ПАНЕЛЬ УПРАВЛЕНИЯ",
|
||||
"Expand command panel": "Развернуть панель управления",
|
||||
"Collapse command panel": "Свернуть панель управления",
|
||||
"Automatic": "Автоматически",
|
||||
"Manual": "Вручную",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Панели и радиаторы следят за Солнцем, антенны наводятся на спутники-ретрансляторы, а манипуляторы движутся для иллюстрации. Расчёт, а не телеметрия в реальном времени.",
|
||||
@@ -3852,5 +3844,73 @@
|
||||
"Resume sway": "Возобновить движение",
|
||||
"Zoom to the ISS": "Приблизить к МКС",
|
||||
"Now: in sunlight": "Сейчас: на свету",
|
||||
"Now: in the Earth's shadow": "Сейчас: в тени Земли"
|
||||
"Now: in the Earth's shadow": "Сейчас: в тени Земли",
|
||||
"STATION VIEW · {name}": "ВИД СО СТАНЦИИ · {name}",
|
||||
"Previous station view": "Предыдущий вид со станции",
|
||||
"Next station view": "Следующий вид со станции",
|
||||
"OBSERVATION MODULE · ISS": "МОДУЛЬ НАБЛЮДЕНИЯ · МКС",
|
||||
"European Space Agency (ESA)": "Европейское космическое агентство (ЕКА)",
|
||||
"7 WINDOWS": "7 ИЛЛЮМИНАТОРОВ",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "ЗАПУЩЕН 8 ФЕВ 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · ПОРТ, ОБРАЩЁННЫЙ К ЗЕМЛЕ",
|
||||
"LABORATORY MODULE · ISS": "ЛАБОРАТОРНЫЙ МОДУЛЬ · МКС",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Японское агентство аэрокосмических исследований (JAXA)",
|
||||
"2 WINDOWS": "2 ИЛЛЮМИНАТОРА",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "ЗАПУЩЕН 31 МАЯ 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · ЛЕВЫЙ БОРТ",
|
||||
"Return to the default view": "Вернуть вид по умолчанию",
|
||||
"{label} · STATION VIEW": "{label} · ВИД СО СТАНЦИИ",
|
||||
"ON AIR": "В ЭФИРЕ",
|
||||
"Starting…": "Запуск…",
|
||||
"Stream is offline": "Трансляция не ведётся",
|
||||
"LIVE VIDEO": "ВИДЕО ОНЛАЙН",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "ТРАНСЛЯЦИЯ ВЫБРАННОГО ОБЪЕКТА",
|
||||
"Live video": "Видео онлайн",
|
||||
"Show Live Video": "Показать видео онлайн",
|
||||
"This stream cannot play here": "Эту трансляцию нельзя воспроизвести здесь",
|
||||
"Expand Live section": "Развернуть раздел «Эфир»",
|
||||
"Collapse Live section": "Свернуть раздел «Эфир»",
|
||||
"Expand Live": "Развернуть «Эфир»",
|
||||
"Collapse Live": "Свернуть «Эфир»",
|
||||
"Live streams for the selected object": "Прямые трансляции выбранного объекта",
|
||||
"Stream": "Трансляция",
|
||||
"Previous stream": "Предыдущая трансляция",
|
||||
"Next stream": "Следующая трансляция",
|
||||
"Try again": "Повторить",
|
||||
"Exterior cameras": "Внешние камеры",
|
||||
"Live video and space-to-ground audio": "Прямое видео и переговоры с Землёй",
|
||||
"NASA video, via YouTube": "Видео NASA, через YouTube",
|
||||
"Controls for the selected space station": "Управление выбранной космической станцией",
|
||||
"Expand Station section": "Развернуть раздел «Станция»",
|
||||
"Collapse Station section": "Свернуть раздел «Станция»",
|
||||
"Expand Station": "Развернуть «Станцию»",
|
||||
"Collapse Station": "Свернуть «Станцию»",
|
||||
"Manual · telemetry paused": "Вручную · телеметрия приостановлена",
|
||||
"Telemetry · updated {ago} ago": "Телеметрия · обновлено {ago} назад",
|
||||
"No signal since {time} · computed values": "Нет сигнала с {time} · расчётные значения",
|
||||
"No signal · computed values": "Нет сигнала · расчётные значения",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Телеметрия недоступна · последнее обновление {ago} назад · расчётные значения",
|
||||
"Telemetry unavailable · computed values": "Телеметрия недоступна · расчётные значения",
|
||||
"Telemetry not enabled on this server · computed values": "Телеметрия не включена на этом сервере · расчётные значения",
|
||||
"No public telemetry · computed values": "Открытой телеметрии нет · расчётные значения",
|
||||
"Zoom to Tiangong": "Приблизить к «Тяньгун»",
|
||||
"Tianhe arm (degrees)": "Манипулятор «Тяньхэ» (градусы)",
|
||||
"Tianhe wings (degrees)": "Крылья «Тяньхэ» (градусы)",
|
||||
"Lab wings (degrees)": "Крылья лабораторий (градусы)",
|
||||
"Port wing": "Левое крыло",
|
||||
"Starboard wing": "Правое крыло",
|
||||
"Wentian forward · alpha": "«Вэньтянь», передняя · альфа",
|
||||
"Wentian forward · beta": "«Вэньтянь», передняя · бета",
|
||||
"Wentian aft · alpha": "«Вэньтянь», задняя · альфа",
|
||||
"Wentian aft · beta": "«Вэньтянь», задняя · бета",
|
||||
"Mengtian forward · alpha": "«Мэнтянь», передняя · альфа",
|
||||
"Mengtian forward · beta": "«Мэнтянь», передняя · бета",
|
||||
"Mengtian aft · alpha": "«Мэнтянь», задняя · альфа",
|
||||
"Mengtian aft · beta": "«Мэнтянь», задняя · бета",
|
||||
"Wentian arm (degrees)": "Манипулятор «Вэньтянь» (градусы)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Панели следят за Солнцем, антенна наводится на спутники-ретрансляторы, а манипуляторы покачиваются для наглядности. Расчёт: Китай не публикует телеметрию в реальном времени.",
|
||||
"Telemetry reads while the model is on screen": "Телеметрия читается, пока модель на экране",
|
||||
"Connecting to telemetry…": "Подключение к телеметрии…",
|
||||
"{seconds} s": "{seconds} с",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Панели, радиаторы и одна антенна следуют телеметрии NASA в реальном времени. Вторая антенна неподвижна, а манипуляторы движутся для иллюстрации."
|
||||
}
|
||||
@@ -3633,16 +3633,8 @@
|
||||
"Layer groups": "Lagergrupper",
|
||||
"Jump to {name}": "Gå till {name}",
|
||||
"No layers match": "Inga lager matchar",
|
||||
"ISS live video": "Livevideo från ISS",
|
||||
"ISS LIVE · NASA": "ISS LIVE · NASA",
|
||||
"Open on YouTube": "Öppna på YouTube",
|
||||
"Close ISS live video": "Stäng livevideon från ISS",
|
||||
"Live views from the International Space Station (NASA)": "Livebilder från Internationella rymdstationen (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "Videon spelas upp från YouTube, som ser din IP-adress.",
|
||||
"ISS command panel": "Kommandopanel för ISS",
|
||||
"ISS · COMMAND PANEL": "ISS · KOMMANDOPANEL",
|
||||
"Expand command panel": "Expandera kommandopanelen",
|
||||
"Collapse command panel": "Fäll ihop kommandopanelen",
|
||||
"Automatic": "Automatiskt",
|
||||
"Manual": "Manuellt",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Paneler och radiatorer följer solen, antennerna riktas mot relästationer i rymden och armarna rör sig som illustration. Beräknat, inte telemetri i realtid.",
|
||||
@@ -3678,5 +3670,73 @@
|
||||
"Resume sway": "Återuppta rörelsen",
|
||||
"Zoom to the ISS": "Zooma in på ISS",
|
||||
"Now: in sunlight": "Nu: i solljus",
|
||||
"Now: in the Earth's shadow": "Nu: i jordens skugga"
|
||||
"Now: in the Earth's shadow": "Nu: i jordens skugga",
|
||||
"{label} · STATION VIEW": "{label} · STATIONSVY",
|
||||
"STATION VIEW · {name}": "STATIONSVY · {name}",
|
||||
"Previous station view": "Föregående stationsvy",
|
||||
"Next station view": "Nästa stationsvy",
|
||||
"OBSERVATION MODULE · ISS": "OBSERVATIONSMODUL · ISS",
|
||||
"European Space Agency (ESA)": "Europeiska rymdorganisationen (ESA)",
|
||||
"7 WINDOWS": "7 FÖNSTER",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "UPPSKJUTEN 8 FEB 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · DOCKNINGSPORT MOT JORDEN",
|
||||
"LABORATORY MODULE · ISS": "LABORATORIEMODUL · ISS",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Japans rymdorganisation (JAXA)",
|
||||
"2 WINDOWS": "2 FÖNSTER",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "UPPSKJUTEN 31 MAJ 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · BABORDSSIDAN",
|
||||
"Return to the default view": "Återgå till standardvyn",
|
||||
"ON AIR": "PÅ LUFTEN",
|
||||
"Starting…": "Startar…",
|
||||
"Stream is offline": "Strömmen är offline",
|
||||
"LIVE VIDEO": "LIVEVIDEO",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "STRÖM KNUTEN TILL OBJEKTET",
|
||||
"Live video": "Livevideo",
|
||||
"Show Live Video": "Visa livevideo",
|
||||
"This stream cannot play here": "Den här strömmen kan inte spelas upp här",
|
||||
"Expand Live section": "Expandera Live-sektionen",
|
||||
"Collapse Live section": "Fäll ihop Live-sektionen",
|
||||
"Expand Live": "Expandera Live",
|
||||
"Collapse Live": "Fäll ihop Live",
|
||||
"Live streams for the selected object": "Liveströmmar för det valda objektet",
|
||||
"Stream": "Ström",
|
||||
"Previous stream": "Föregående ström",
|
||||
"Next stream": "Nästa ström",
|
||||
"Try again": "Försök igen",
|
||||
"Exterior cameras": "Yttre kameror",
|
||||
"Live video and space-to-ground audio": "Livevideo och ljud rymd–mark",
|
||||
"NASA video, via YouTube": "NASA-video, via YouTube",
|
||||
"Controls for the selected space station": "Reglage för den valda rymdstationen",
|
||||
"Expand Station section": "Expandera Station-sektionen",
|
||||
"Collapse Station section": "Fäll ihop Station-sektionen",
|
||||
"Expand Station": "Expandera Station",
|
||||
"Collapse Station": "Fäll ihop Station",
|
||||
"Manual · telemetry paused": "Manuellt · telemetri pausad",
|
||||
"Telemetry · updated {ago} ago": "Telemetri · uppdaterad för {ago} sedan",
|
||||
"No signal since {time} · computed values": "Ingen signal sedan {time} · beräknade värden",
|
||||
"No signal · computed values": "Ingen signal · beräknade värden",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Telemetri otillgänglig · senast uppdaterad för {ago} sedan · beräknade värden",
|
||||
"Telemetry unavailable · computed values": "Telemetri otillgänglig · beräknade värden",
|
||||
"Telemetry not enabled on this server · computed values": "Telemetri inte aktiverad på den här servern · beräknade värden",
|
||||
"No public telemetry · computed values": "Ingen offentlig telemetri · beräknade värden",
|
||||
"Zoom to Tiangong": "Zooma in på Tiangong",
|
||||
"Tianhe arm (degrees)": "Tianhe-armen (grader)",
|
||||
"Tianhe wings (degrees)": "Tianhes vingar (grader)",
|
||||
"Lab wings (degrees)": "Laboratoriernas vingar (grader)",
|
||||
"Port wing": "Babordsvinge",
|
||||
"Starboard wing": "Styrbordsvinge",
|
||||
"Wentian forward · alpha": "Wentian fram · alfa",
|
||||
"Wentian forward · beta": "Wentian fram · beta",
|
||||
"Wentian aft · alpha": "Wentian bak · alfa",
|
||||
"Wentian aft · beta": "Wentian bak · beta",
|
||||
"Mengtian forward · alpha": "Mengtian fram · alfa",
|
||||
"Mengtian forward · beta": "Mengtian fram · beta",
|
||||
"Mengtian aft · alpha": "Mengtian bak · alfa",
|
||||
"Mengtian aft · beta": "Mengtian bak · beta",
|
||||
"Wentian arm (degrees)": "Wentian-armen (grader)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Panelerna följer solen, antennen riktas mot relästationer i rymden och armarna svänger i illustrativt syfte. Beräknat: Kina publicerar ingen live-telemetri.",
|
||||
"Telemetry reads while the model is on screen": "Telemetri läses medan modellen syns på skärmen",
|
||||
"Connecting to telemetry…": "Ansluter till telemetri…",
|
||||
"{seconds} s": "{seconds} s",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Paneler, radiatorer och en antenn följer NASA:s telemetri i realtid. Den andra antennen står stilla och armarna rör sig som illustration."
|
||||
}
|
||||
@@ -3807,16 +3807,8 @@
|
||||
"Layer groups": "Групи шарів",
|
||||
"Jump to {name}": "Перейти до «{name}»",
|
||||
"No layers match": "Немає відповідних шарів",
|
||||
"ISS live video": "Пряма трансляція з МКС",
|
||||
"ISS LIVE · NASA": "МКС НАЖИВО · NASA",
|
||||
"Open on YouTube": "Відкрити на YouTube",
|
||||
"Close ISS live video": "Закрити трансляцію з МКС",
|
||||
"Live views from the International Space Station (NASA)": "Пряма трансляція з Міжнародної космічної станції (NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "Відео відтворюється з YouTube, який бачить вашу IP-адресу.",
|
||||
"ISS command panel": "Панель керування МКС",
|
||||
"ISS · COMMAND PANEL": "МКС · ПАНЕЛЬ КЕРУВАННЯ",
|
||||
"Expand command panel": "Розгорнути панель керування",
|
||||
"Collapse command panel": "Згорнути панель керування",
|
||||
"Automatic": "Автоматично",
|
||||
"Manual": "Вручну",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "Панелі й радіатори стежать за Сонцем, антени наводяться на супутники-ретранслятори, а маніпулятори рухаються для ілюстрації. Розрахунок, а не телеметрія в реальному часі.",
|
||||
@@ -3852,5 +3844,73 @@
|
||||
"Resume sway": "Відновити рух",
|
||||
"Zoom to the ISS": "Наблизити до МКС",
|
||||
"Now: in sunlight": "Зараз: на світлі",
|
||||
"Now: in the Earth's shadow": "Зараз: у тіні Землі"
|
||||
"Now: in the Earth's shadow": "Зараз: у тіні Землі",
|
||||
"STATION VIEW · {name}": "ВИГЛЯД ЗІ СТАНЦІЇ · {name}",
|
||||
"Previous station view": "Попередній вигляд зі станції",
|
||||
"Next station view": "Наступний вигляд зі станції",
|
||||
"OBSERVATION MODULE · ISS": "МОДУЛЬ СПОСТЕРЕЖЕННЯ · МКС",
|
||||
"European Space Agency (ESA)": "Європейське космічне агентство (ЄКА)",
|
||||
"7 WINDOWS": "7 ІЛЮМІНАТОРІВ",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "ЗАПУЩЕНО 8 ЛЮТ 2010 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "TRANQUILITY · ПОРТ, ЗВЕРНЕНИЙ ДО ЗЕМЛІ",
|
||||
"LABORATORY MODULE · ISS": "ЛАБОРАТОРНИЙ МОДУЛЬ · МКС",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "Японське агентство аерокосмічних досліджень (JAXA)",
|
||||
"2 WINDOWS": "2 ІЛЮМІНАТОРИ",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "ЗАПУЩЕНО 31 ТРАВ 2008 · STS-124",
|
||||
"HARMONY · PORT SIDE": "HARMONY · ЛІВИЙ БОРТ",
|
||||
"Return to the default view": "Повернути типовий вигляд",
|
||||
"{label} · STATION VIEW": "{label} · ВИГЛЯД ЗІ СТАНЦІЇ",
|
||||
"ON AIR": "В ЕФІРІ",
|
||||
"Starting…": "Запуск…",
|
||||
"Stream is offline": "Трансляція не ведеться",
|
||||
"LIVE VIDEO": "ВІДЕО ОНЛАЙН",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "ТРАНСЛЯЦІЯ ВИБРАНОГО ОБ’ЄКТА",
|
||||
"Live video": "Відео онлайн",
|
||||
"Show Live Video": "Показати відео онлайн",
|
||||
"This stream cannot play here": "Цю трансляцію не можна відтворити тут",
|
||||
"Expand Live section": "Розгорнути розділ «Ефір»",
|
||||
"Collapse Live section": "Згорнути розділ «Ефір»",
|
||||
"Expand Live": "Розгорнути «Ефір»",
|
||||
"Collapse Live": "Згорнути «Ефір»",
|
||||
"Live streams for the selected object": "Прямі трансляції вибраного об’єкта",
|
||||
"Stream": "Трансляція",
|
||||
"Previous stream": "Попередня трансляція",
|
||||
"Next stream": "Наступна трансляція",
|
||||
"Try again": "Повторити",
|
||||
"Exterior cameras": "Зовнішні камери",
|
||||
"Live video and space-to-ground audio": "Пряме відео та переговори із Землею",
|
||||
"NASA video, via YouTube": "Відео NASA, через YouTube",
|
||||
"Controls for the selected space station": "Керування вибраною космічною станцією",
|
||||
"Expand Station section": "Розгорнути розділ «Станція»",
|
||||
"Collapse Station section": "Згорнути розділ «Станція»",
|
||||
"Expand Station": "Розгорнути «Станцію»",
|
||||
"Collapse Station": "Згорнути «Станцію»",
|
||||
"Manual · telemetry paused": "Вручну · телеметрію призупинено",
|
||||
"Telemetry · updated {ago} ago": "Телеметрія · оновлено {ago} тому",
|
||||
"No signal since {time} · computed values": "Немає сигналу з {time} · розрахункові значення",
|
||||
"No signal · computed values": "Немає сигналу · розрахункові значення",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "Телеметрія недоступна · останнє оновлення {ago} тому · розрахункові значення",
|
||||
"Telemetry unavailable · computed values": "Телеметрія недоступна · розрахункові значення",
|
||||
"Telemetry not enabled on this server · computed values": "Телеметрію не ввімкнено на цьому сервері · розрахункові значення",
|
||||
"No public telemetry · computed values": "Відкритої телеметрії немає · розрахункові значення",
|
||||
"Zoom to Tiangong": "Наблизити до «Тяньгун»",
|
||||
"Tianhe arm (degrees)": "Маніпулятор «Тяньхе» (градуси)",
|
||||
"Tianhe wings (degrees)": "Крила «Тяньхе» (градуси)",
|
||||
"Lab wings (degrees)": "Крила лабораторій (градуси)",
|
||||
"Port wing": "Ліве крило",
|
||||
"Starboard wing": "Праве крило",
|
||||
"Wentian forward · alpha": "«Веньтянь», передня · альфа",
|
||||
"Wentian forward · beta": "«Веньтянь», передня · бета",
|
||||
"Wentian aft · alpha": "«Веньтянь», задня · альфа",
|
||||
"Wentian aft · beta": "«Веньтянь», задня · бета",
|
||||
"Mengtian forward · alpha": "«Ментянь», передня · альфа",
|
||||
"Mengtian forward · beta": "«Ментянь», передня · бета",
|
||||
"Mengtian aft · alpha": "«Ментянь», задня · альфа",
|
||||
"Mengtian aft · beta": "«Ментянь», задня · бета",
|
||||
"Wentian arm (degrees)": "Маніпулятор «Веньтянь» (градуси)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "Панелі стежать за Сонцем, антена наводиться на супутники-ретранслятори, а маніпулятори похитуються для наочності. Розрахунок: Китай не публікує телеметрію в реальному часі.",
|
||||
"Telemetry reads while the model is on screen": "Телеметрія читається, поки модель на екрані",
|
||||
"Connecting to telemetry…": "Підключення до телеметрії…",
|
||||
"{seconds} s": "{seconds} с",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "Панелі, радіатори й одна антена слідують телеметрії NASA в реальному часі. Друга антена нерухома, а маніпулятори рухаються для ілюстрації."
|
||||
}
|
||||
@@ -3546,16 +3546,8 @@
|
||||
"Layer groups": "图层分组",
|
||||
"Jump to {name}": "跳转到{name}",
|
||||
"No layers match": "没有匹配的图层",
|
||||
"ISS live video": "国际空间站直播视频",
|
||||
"ISS LIVE · NASA": "国际空间站直播 · NASA",
|
||||
"Open on YouTube": "在 YouTube 上打开",
|
||||
"Close ISS live video": "关闭国际空间站直播视频",
|
||||
"Live views from the International Space Station (NASA)": "国际空间站实时画面(NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "视频从 YouTube 播放,YouTube 会看到你的 IP 地址。",
|
||||
"ISS command panel": "国际空间站控制面板",
|
||||
"ISS · COMMAND PANEL": "国际空间站 · 控制面板",
|
||||
"Expand command panel": "展开控制面板",
|
||||
"Collapse command panel": "收起控制面板",
|
||||
"Automatic": "自动",
|
||||
"Manual": "手动",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "太阳能板和散热器跟随太阳,天线指向中继卫星,机械臂仅作演示性摆动。均为计算结果,并非实时遥测。",
|
||||
@@ -3591,5 +3583,73 @@
|
||||
"Resume sway": "恢复摆动",
|
||||
"Zoom to the ISS": "拉近到国际空间站",
|
||||
"Now: in sunlight": "当前:处于日照中",
|
||||
"Now: in the Earth's shadow": "当前:处于地球阴影中"
|
||||
"Now: in the Earth's shadow": "当前:处于地球阴影中",
|
||||
"STATION VIEW · {name}": "空间站视图 · {name}",
|
||||
"Previous station view": "上一个空间站视图",
|
||||
"Next station view": "下一个空间站视图",
|
||||
"OBSERVATION MODULE · ISS": "观测舱 · 国际空间站",
|
||||
"European Space Agency (ESA)": "欧洲航天局(ESA)",
|
||||
"7 WINDOWS": "7 扇舷窗",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "2010年2月8日发射 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "宁静号节点舱 · 对地端口",
|
||||
"LABORATORY MODULE · ISS": "实验舱 · 国际空间站",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "日本宇宙航空研究开发机构(JAXA)",
|
||||
"2 WINDOWS": "2 扇舷窗",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "2008年5月31日发射 · STS-124",
|
||||
"HARMONY · PORT SIDE": "和谐号节点舱 · 左舷",
|
||||
"Return to the default view": "恢复默认视图",
|
||||
"{label} · STATION VIEW": "{label} · 空间站视图",
|
||||
"ON AIR": "直播中",
|
||||
"Starting…": "正在启动…",
|
||||
"Stream is offline": "直播已离线",
|
||||
"LIVE VIDEO": "实时视频",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "与所选对象关联的直播",
|
||||
"Live video": "实时视频",
|
||||
"Show Live Video": "显示实时视频",
|
||||
"This stream cannot play here": "此直播无法在此播放",
|
||||
"Expand Live section": "展开直播区",
|
||||
"Collapse Live section": "收起直播区",
|
||||
"Expand Live": "展开直播",
|
||||
"Collapse Live": "收起直播",
|
||||
"Live streams for the selected object": "所选对象的直播",
|
||||
"Stream": "直播",
|
||||
"Previous stream": "上一个直播",
|
||||
"Next stream": "下一个直播",
|
||||
"Try again": "重试",
|
||||
"Exterior cameras": "外部摄像头",
|
||||
"Live video and space-to-ground audio": "实时视频与天地通话音频",
|
||||
"NASA video, via YouTube": "NASA 视频,经由 YouTube",
|
||||
"Controls for the selected space station": "所选空间站的控制",
|
||||
"Expand Station section": "展开空间站区",
|
||||
"Collapse Station section": "收起空间站区",
|
||||
"Expand Station": "展开空间站",
|
||||
"Collapse Station": "收起空间站",
|
||||
"Manual · telemetry paused": "手动 · 遥测已暂停",
|
||||
"Telemetry · updated {ago} ago": "遥测 · {ago}前更新",
|
||||
"No signal since {time} · computed values": "自 {time} 起无信号 · 计算值",
|
||||
"No signal · computed values": "无信号 · 计算值",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "遥测不可用 · 最后更新于{ago}前 · 计算值",
|
||||
"Telemetry unavailable · computed values": "遥测不可用 · 计算值",
|
||||
"Telemetry not enabled on this server · computed values": "此服务器未启用遥测 · 计算值",
|
||||
"No public telemetry · computed values": "无公开遥测 · 计算值",
|
||||
"Zoom to Tiangong": "拉近到天宫",
|
||||
"Tianhe arm (degrees)": "天和机械臂(度)",
|
||||
"Tianhe wings (degrees)": "天和翼板(度)",
|
||||
"Lab wings (degrees)": "实验舱翼板(度)",
|
||||
"Port wing": "左侧翼板",
|
||||
"Starboard wing": "右侧翼板",
|
||||
"Wentian forward · alpha": "问天前侧 · α",
|
||||
"Wentian forward · beta": "问天前侧 · β",
|
||||
"Wentian aft · alpha": "问天后侧 · α",
|
||||
"Wentian aft · beta": "问天后侧 · β",
|
||||
"Mengtian forward · alpha": "梦天前侧 · α",
|
||||
"Mengtian forward · beta": "梦天前侧 · β",
|
||||
"Mengtian aft · alpha": "梦天后侧 · α",
|
||||
"Mengtian aft · beta": "梦天后侧 · β",
|
||||
"Wentian arm (degrees)": "问天机械臂(度)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "太阳能板跟随太阳,天线指向中继卫星,机械臂仅作示意摆动。计算值:中国不公开实时遥测。",
|
||||
"Telemetry reads while the model is on screen": "模型显示在屏幕上时读取遥测",
|
||||
"Connecting to telemetry…": "正在连接遥测…",
|
||||
"{seconds} s": "{seconds} 秒",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "太阳能板、散热器和一副天线依据 NASA 的实时遥测转动。另一副天线保持不动,机械臂仅作演示性摆动。"
|
||||
}
|
||||
@@ -3546,16 +3546,8 @@
|
||||
"Layer groups": "圖層分組",
|
||||
"Jump to {name}": "跳至{name}",
|
||||
"No layers match": "沒有符合的圖層",
|
||||
"ISS live video": "國際太空站直播影片",
|
||||
"ISS LIVE · NASA": "國際太空站直播 · NASA",
|
||||
"Open on YouTube": "在 YouTube 上開啟",
|
||||
"Close ISS live video": "關閉國際太空站直播影片",
|
||||
"Live views from the International Space Station (NASA)": "國際太空站即時畫面(NASA)",
|
||||
"Video plays from YouTube, which sees your IP address.": "影片從 YouTube 播放,YouTube 會看到你的 IP 位址。",
|
||||
"ISS command panel": "國際太空站控制面板",
|
||||
"ISS · COMMAND PANEL": "國際太空站 · 控制面板",
|
||||
"Expand command panel": "展開控制面板",
|
||||
"Collapse command panel": "收合控制面板",
|
||||
"Automatic": "自動",
|
||||
"Manual": "手動",
|
||||
"Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.": "太陽能板與散熱器跟隨太陽,天線指向中繼衛星,機械臂僅作示意性擺動。皆為計算結果,並非即時遙測。",
|
||||
@@ -3591,5 +3583,73 @@
|
||||
"Resume sway": "恢復擺動",
|
||||
"Zoom to the ISS": "拉近到國際太空站",
|
||||
"Now: in sunlight": "目前:處於日照中",
|
||||
"Now: in the Earth's shadow": "目前:處於地球陰影中"
|
||||
"Now: in the Earth's shadow": "目前:處於地球陰影中",
|
||||
"STATION VIEW · {name}": "太空站視圖 · {name}",
|
||||
"Previous station view": "上一個太空站視圖",
|
||||
"Next station view": "下一個太空站視圖",
|
||||
"OBSERVATION MODULE · ISS": "觀測艙 · 國際太空站",
|
||||
"European Space Agency (ESA)": "歐洲太空總署(ESA)",
|
||||
"7 WINDOWS": "7 扇舷窗",
|
||||
"LAUNCHED 8 FEB 2010 · STS-130": "2010年2月8日發射 · STS-130",
|
||||
"TRANQUILITY · EARTH-FACING PORT": "寧靜號節點艙 · 對地埠口",
|
||||
"LABORATORY MODULE · ISS": "實驗艙 · 國際太空站",
|
||||
"Japan Aerospace Exploration Agency (JAXA)": "日本宇宙航空研究開發機構(JAXA)",
|
||||
"2 WINDOWS": "2 扇舷窗",
|
||||
"LAUNCHED 31 MAY 2008 · STS-124": "2008年5月31日發射 · STS-124",
|
||||
"HARMONY · PORT SIDE": "和諧號節點艙 · 左舷",
|
||||
"Return to the default view": "恢復預設視圖",
|
||||
"{label} · STATION VIEW": "{label} · 太空站視圖",
|
||||
"ON AIR": "直播中",
|
||||
"Starting…": "正在啟動…",
|
||||
"Stream is offline": "直播已離線",
|
||||
"LIVE VIDEO": "實時視訊",
|
||||
"STREAM ATTACHED TO THE SUBJECT": "與所選物件關聯的直播",
|
||||
"Live video": "實時視訊",
|
||||
"Show Live Video": "顯示實時視訊",
|
||||
"This stream cannot play here": "此直播無法在此播放",
|
||||
"Expand Live section": "展開直播區",
|
||||
"Collapse Live section": "收起直播區",
|
||||
"Expand Live": "展開直播",
|
||||
"Collapse Live": "收起直播",
|
||||
"Live streams for the selected object": "所選物件的直播",
|
||||
"Stream": "直播",
|
||||
"Previous stream": "上一個直播",
|
||||
"Next stream": "下一個直播",
|
||||
"Try again": "重試",
|
||||
"Exterior cameras": "外部攝影機",
|
||||
"Live video and space-to-ground audio": "即時影像與天地通話音訊",
|
||||
"NASA video, via YouTube": "NASA 影片,經由 YouTube",
|
||||
"Controls for the selected space station": "所選太空站的控制",
|
||||
"Expand Station section": "展開太空站區",
|
||||
"Collapse Station section": "收起太空站區",
|
||||
"Expand Station": "展開太空站",
|
||||
"Collapse Station": "收起太空站",
|
||||
"Manual · telemetry paused": "手動 · 遙測已暫停",
|
||||
"Telemetry · updated {ago} ago": "遙測 · {ago}前更新",
|
||||
"No signal since {time} · computed values": "自 {time} 起無訊號 · 計算值",
|
||||
"No signal · computed values": "無訊號 · 計算值",
|
||||
"Telemetry unavailable · last update {ago} ago · computed values": "遙測不可用 · 最後更新於{ago}前 · 計算值",
|
||||
"Telemetry unavailable · computed values": "遙測不可用 · 計算值",
|
||||
"Telemetry not enabled on this server · computed values": "此伺服器未啟用遙測 · 計算值",
|
||||
"No public telemetry · computed values": "無公開遙測 · 計算值",
|
||||
"Zoom to Tiangong": "拉近到天宮",
|
||||
"Tianhe arm (degrees)": "天和機械臂(度)",
|
||||
"Tianhe wings (degrees)": "天和翼板(度)",
|
||||
"Lab wings (degrees)": "實驗艙翼板(度)",
|
||||
"Port wing": "左側翼板",
|
||||
"Starboard wing": "右側翼板",
|
||||
"Wentian forward · alpha": "問天前側 · α",
|
||||
"Wentian forward · beta": "問天前側 · β",
|
||||
"Wentian aft · alpha": "問天後側 · α",
|
||||
"Wentian aft · beta": "問天後側 · β",
|
||||
"Mengtian forward · alpha": "夢天前側 · α",
|
||||
"Mengtian forward · beta": "夢天前側 · β",
|
||||
"Mengtian aft · alpha": "夢天後側 · α",
|
||||
"Mengtian aft · beta": "夢天後側 · β",
|
||||
"Wentian arm (degrees)": "問天機械臂(度)",
|
||||
"Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.": "太陽能板跟隨太陽,天線指向中繼衛星,機械臂僅作示意擺動。計算值:中國不公開即時遙測。",
|
||||
"Telemetry reads while the model is on screen": "模型顯示在螢幕上時讀取遙測",
|
||||
"Connecting to telemetry…": "正在連線遙測…",
|
||||
"{seconds} s": "{seconds} 秒",
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.": "太陽能板、散熱器與一座天線依 NASA 的即時遙測轉動。另一座天線保持不動,機械臂僅作示意性擺動。"
|
||||
}
|
||||
@@ -253,7 +253,10 @@
|
||||
"{minutes} min",
|
||||
"1 min/s",
|
||||
"Status",
|
||||
"ISS LIVE · NASA"
|
||||
"ON AIR",
|
||||
"Stream",
|
||||
"{seconds} s",
|
||||
"Mode"
|
||||
],
|
||||
"es": [
|
||||
"1 min/s",
|
||||
@@ -419,7 +422,8 @@
|
||||
"Regional",
|
||||
"{datasets} · {tiles} · {packs}",
|
||||
"VIRTUAL",
|
||||
"Manual"
|
||||
"Manual",
|
||||
"{seconds} s"
|
||||
],
|
||||
"fr": [
|
||||
"1 min/s",
|
||||
@@ -643,7 +647,8 @@
|
||||
"Orthophoto",
|
||||
"Oblique",
|
||||
"Type",
|
||||
"{range} NM"
|
||||
"{range} NM",
|
||||
"{seconds} s"
|
||||
],
|
||||
"it": [
|
||||
"1 min/s",
|
||||
@@ -850,7 +855,8 @@
|
||||
"NORAD: {id}",
|
||||
"DATASET",
|
||||
"{count} datasets",
|
||||
"ZOOM"
|
||||
"ZOOM",
|
||||
"{seconds} s"
|
||||
],
|
||||
"ja": [
|
||||
"1090 MHz",
|
||||
@@ -1082,7 +1088,8 @@
|
||||
"NORAD: {id}",
|
||||
"Regional",
|
||||
"VIRTUAL",
|
||||
"Manual"
|
||||
"Manual",
|
||||
"{seconds} s"
|
||||
],
|
||||
"ru": [
|
||||
"1900–1945",
|
||||
@@ -1281,7 +1288,7 @@
|
||||
"NORAD: {id}",
|
||||
"MMSI: {id}",
|
||||
"Status",
|
||||
"ISS LIVE · NASA"
|
||||
"{seconds} s"
|
||||
],
|
||||
"uk": [
|
||||
"1900–1945",
|
||||
|
||||
Vendored
+30
-1
@@ -36,7 +36,13 @@ function localizeInstallationFeedback(feedback) {
|
||||
: tn(count, '{count} mapped site in view', '{count} mapped sites in view');
|
||||
}
|
||||
|
||||
export function createControls({ state: layerState, services, parts, source }) {
|
||||
export function createControls({
|
||||
state: layerState,
|
||||
services,
|
||||
parts,
|
||||
source,
|
||||
overlayHost,
|
||||
}) {
|
||||
const methods = {
|
||||
id: LAYER_ID,
|
||||
|
||||
@@ -197,6 +203,29 @@ export function createControls({ state: layerState, services, parts, source }) {
|
||||
return id ? methods.getById(id) : null;
|
||||
},
|
||||
|
||||
/**
|
||||
* The mapped installation whose label box the shared overlay paints at a
|
||||
* canvas position: what a click lands on from far out, where the dot is
|
||||
* 7 px. The dot, outline and fill themselves are query port hits, read
|
||||
* with {@link findByPick}. Null for anything else.
|
||||
* @param {{x: number, y: number}|null|undefined} position Canvas CSS px.
|
||||
* @returns {object|null} As {@link getById}.
|
||||
*/
|
||||
findAt(position) {
|
||||
if (!Number.isFinite(position?.x) || !Number.isFinite(position?.y))
|
||||
return null;
|
||||
let hit = null;
|
||||
try {
|
||||
hit =
|
||||
overlayHost?.hitTest?.(position.x, position.y, {
|
||||
sourceId: LAYER_ID,
|
||||
}) ?? null;
|
||||
} catch {
|
||||
hit = null;
|
||||
}
|
||||
return hit ? methods.getById(hit.entryId) : null;
|
||||
},
|
||||
|
||||
/**
|
||||
* Select and frame a mapped installation from another contextual UI.
|
||||
* @param {string} id Source-backed installation id.
|
||||
|
||||
@@ -221,14 +221,20 @@ export function createNamedMarkers({ state, services, parts, overlayHost }) {
|
||||
// What `visit` hands out: the marker's id, position and whether
|
||||
// it is on this side of the horizon.
|
||||
point: { id: { installationId: record.id }, position, show: false },
|
||||
entry: createInfrastructureOverlayEntry({
|
||||
id: record.id,
|
||||
source: LAYER_ID,
|
||||
position,
|
||||
title: installationTitle(record.name),
|
||||
priority: record.areaM2 || 0,
|
||||
accent: COLOR_BY_CLASS[record.class] || '#9ca6b0',
|
||||
}),
|
||||
entry: Object.assign(
|
||||
createInfrastructureOverlayEntry({
|
||||
id: record.id,
|
||||
source: LAYER_ID,
|
||||
position,
|
||||
title: installationTitle(record.name),
|
||||
priority: record.areaM2 || 0,
|
||||
accent: COLOR_BY_CLASS[record.class] || '#9ca6b0',
|
||||
}),
|
||||
// The overlay keeps a hit rect for an interactive entry, so a
|
||||
// click on the label box finds the site (controls.findAt), not
|
||||
// only one on the dot.
|
||||
{ interactive: true },
|
||||
),
|
||||
};
|
||||
markers.set(record.id, marker);
|
||||
} else {
|
||||
|
||||
@@ -9,14 +9,23 @@ import { fakeSceneFrame, fakeSceneQuery } from '../../testSupport/fakeCesiumScen
|
||||
import { createLocalInfrastructureOverlayEntry } from '../../data/localGeojsonCore.js';
|
||||
|
||||
function setup(t) {
|
||||
let labels = [], options, publications = 0, visible = false;
|
||||
let labels = [],
|
||||
options,
|
||||
publications = 0,
|
||||
visible = false;
|
||||
const overlayHost = {
|
||||
setEntries(id, entries, policy) {
|
||||
assert.equal(id, 'military-installations');
|
||||
labels = entries; options = policy; publications++;
|
||||
labels = entries;
|
||||
options = policy;
|
||||
publications++;
|
||||
},
|
||||
clearSource() {
|
||||
labels = [];
|
||||
},
|
||||
setVisible(_id, value) {
|
||||
visible = value;
|
||||
},
|
||||
clearSource() { labels = []; },
|
||||
setVisible(_id, value) { visible = value; },
|
||||
};
|
||||
let x = -100;
|
||||
t.mock.method(C.SceneTransforms, 'worldToWindowCoordinates', () => new C.Cartesian2(x, 300));
|
||||
@@ -40,7 +49,9 @@ test('Contacts camera motion reprojects and declutters existing labels without s
|
||||
const h = setup(t);
|
||||
h.markers.sync(h.records);
|
||||
assert.equal(h.markers.stats().pointsOnScreen, 0);
|
||||
h.setX(600); h.camera.changed.raiseEvent(); h.camera.moveEnd.raiseEvent();
|
||||
h.setX(600);
|
||||
h.camera.changed.raiseEvent();
|
||||
h.camera.moveEnd.raiseEvent();
|
||||
assert.equal(h.markers.stats().pointsOnScreen, 2);
|
||||
assert.equal(h.labels.length, 2);
|
||||
assert.equal(h.options.collisionCapacity, 24);
|
||||
@@ -61,7 +72,8 @@ test('Contacts camera motion reprojects and declutters existing labels without s
|
||||
assert.equal(h.labels.length, 0);
|
||||
assert.equal(h.visible, false);
|
||||
h.state.records = h.records;
|
||||
h.setX(600); h.lifecycle.enable();
|
||||
h.setX(600);
|
||||
h.lifecycle.enable();
|
||||
assert.equal(h.labels.length, 2);
|
||||
assert.equal(h.publications(), 5);
|
||||
h.lifecycle.destroy(h.state.viewer);
|
||||
@@ -73,13 +85,25 @@ test('Contacts camera motion reprojects and declutters existing labels without s
|
||||
test('wide named markers retain primitives until close polygons publish with the same identity', async (t) => {
|
||||
const { retainNamedHandoff } = await import('./ingestion.js');
|
||||
const h = setup(t);
|
||||
h.setX(600); h.markers.sync(h.records);
|
||||
h.setX(600);
|
||||
h.markers.sync(h.records);
|
||||
const first = h.labels[0];
|
||||
const box = { west: -1, east: 1, south: -1, north: 1 };
|
||||
h.markers.sync(retainNamedHandoff(h.records, [], box));
|
||||
assert.equal(h.labels[0], first);
|
||||
assert.equal(first.title, 'Site 1');
|
||||
const polygon = { ...h.records[0], namedArea: false, name: 'Military area', pointOnly: false, footprint: [[0, 0], [0.1, 0], [0, 0.1], [0, 0]] };
|
||||
const polygon = {
|
||||
...h.records[0],
|
||||
namedArea: false,
|
||||
name: 'Military area',
|
||||
pointOnly: false,
|
||||
footprint: [
|
||||
[0, 0],
|
||||
[0.1, 0],
|
||||
[0, 0.1],
|
||||
[0, 0],
|
||||
],
|
||||
};
|
||||
const handed = retainNamedHandoff(h.records, [polygon], box);
|
||||
assert.equal(handed.length, 2);
|
||||
assert.equal(handed[0].name, 'Site 1');
|
||||
@@ -88,7 +112,11 @@ test('wide named markers retain primitives until close polygons publish with the
|
||||
assert.equal(h.labels[0], first);
|
||||
assert.equal(first.title, 'Site 1');
|
||||
assert.equal(h.labels.length, 2, 'no duplicate title at handoff');
|
||||
assert.equal(retainNamedHandoff(h.records, [], { west: 1, east: 2, south: 1, north: 2 }).length, 0);
|
||||
assert.equal(
|
||||
retainNamedHandoff(h.records, [], { west: 1, east: 2, south: 1, north: 2 })
|
||||
.length,
|
||||
0,
|
||||
);
|
||||
h.lifecycle.destroy(h.state.viewer);
|
||||
});
|
||||
|
||||
@@ -98,7 +126,9 @@ test('canonical aliases transfer named marker ownership without replacing marker
|
||||
const parent = h.records[1];
|
||||
h.markers.sync([parent]);
|
||||
let originalPoint;
|
||||
h.markers.visit((_id, point) => { originalPoint = point; });
|
||||
h.markers.visit((_id, point) => {
|
||||
originalPoint = point;
|
||||
});
|
||||
const label = h.labels[0];
|
||||
for (const record of [
|
||||
{ ...parent, id: h.records[0].id, aliasIds: [parent.id], pointOnly: false },
|
||||
@@ -120,17 +150,29 @@ test('canonical aliases transfer named marker ownership without replacing marker
|
||||
h.lifecycle.destroy(h.state.viewer);
|
||||
});
|
||||
|
||||
|
||||
test('the bounded host cohort ranks wide points and polygon titles by area', (t) => {
|
||||
const h = setup(t);
|
||||
h.markers.sync(Array.from({ length: 600 }, (_, n) => ({
|
||||
...h.records[0], id: `site:${n}`, name: `Site ${n}`, areaM2: n,
|
||||
pointOnly: n % 2 === 0,
|
||||
})));
|
||||
h.markers.sync(
|
||||
Array.from({ length: 600 }, (_, n) => ({
|
||||
...h.records[0],
|
||||
id: `site:${n}`,
|
||||
name: `Site ${n}`,
|
||||
areaM2: n,
|
||||
pointOnly: n % 2 === 0,
|
||||
})),
|
||||
);
|
||||
assert.equal(h.labels.length, 512);
|
||||
assert.equal(h.labels[0].id, 'site:599');
|
||||
assert.equal(h.labels.at(-1).id, 'site:88');
|
||||
assert.ok(h.labels.every((entry) => !entry.stateless && entry.horizonCull && entry.collisionGroup === 'ambient-card'));
|
||||
assert.ok(
|
||||
h.labels.every(
|
||||
(entry) =>
|
||||
!entry.stateless &&
|
||||
entry.horizonCull &&
|
||||
entry.collisionGroup === 'ambient-card' &&
|
||||
entry.interactive === true,
|
||||
),
|
||||
);
|
||||
const first = h.labels[0];
|
||||
const publications = h.publications();
|
||||
for (let i = 0; i < 100; i++) {
|
||||
@@ -143,7 +185,6 @@ test('the bounded host cohort ranks wide points and polygon titles by area', (t)
|
||||
assert.equal(h.labels.length, 0);
|
||||
});
|
||||
|
||||
|
||||
test('wide and polygon titles use the Data Centers entry contract and persistent shared domain', (t) => {
|
||||
const h = setup(t);
|
||||
h.markers.sync([h.records[0], { ...h.records[1], pointOnly: false }]);
|
||||
@@ -151,13 +192,25 @@ test('wide and polygon titles use the Data Centers entry contract and persistent
|
||||
assert.equal(h.options.solveIntervalMs, undefined);
|
||||
assert.equal(h.options.maxVisible, 24);
|
||||
for (const entry of h.labels) {
|
||||
const reference = createLocalInfrastructureOverlayEntry({ id: entry.id, layerId: 'military-installations', position: entry.position, properties: { name: entry.title }, priority: entry.priority, accent: entry.accent });
|
||||
assert.deepEqual(entry, { ...reference, selected: false });
|
||||
const reference = createLocalInfrastructureOverlayEntry({
|
||||
id: entry.id,
|
||||
layerId: 'military-installations',
|
||||
position: entry.position,
|
||||
properties: { name: entry.title },
|
||||
priority: entry.priority,
|
||||
accent: entry.accent,
|
||||
});
|
||||
// Interactive: the overlay then keeps a hit rect for the label box, so
|
||||
// a click on it finds the site (controls.findAt).
|
||||
assert.deepEqual(entry, {
|
||||
...reference,
|
||||
interactive: true,
|
||||
selected: false,
|
||||
});
|
||||
}
|
||||
h.lifecycle.destroy(h.state.viewer);
|
||||
});
|
||||
|
||||
|
||||
test('selection promotes exactly one entry and deselection restores that same label', (t) => {
|
||||
const h = setup(t);
|
||||
h.markers.sync(h.records);
|
||||
@@ -167,7 +220,7 @@ test('selection promotes exactly one entry and deselection restores that same la
|
||||
assert.equal(h.labels.length, 2);
|
||||
assert.equal(h.labels[0], original);
|
||||
assert.equal(original.variant, 'selected');
|
||||
assert.equal(h.labels.filter(e => e.selected).length, 1);
|
||||
assert.equal(h.labels.filter((e) => e.selected).length, 1);
|
||||
assert.equal(h.options.maxVisible, 23);
|
||||
h.state.selectedId = null;
|
||||
h.markers.sync(h.records);
|
||||
@@ -180,14 +233,24 @@ test('selection promotes exactly one entry and deselection restores that same la
|
||||
|
||||
test('Contacts can select a point outside the normal title cap or an unnamed polygon', (t) => {
|
||||
const h = setup(t);
|
||||
const records = Array.from({ length: 520 }, (_, i) => ({ ...h.records[0], id: `site:${i}`, areaM2: 1000 - i }));
|
||||
records.push({ ...h.records[0], id: 'unnamed', name: 'Military area', namedArea: false, pointOnly: false });
|
||||
const records = Array.from({ length: 520 }, (_, i) => ({
|
||||
...h.records[0],
|
||||
id: `site:${i}`,
|
||||
areaM2: 1000 - i,
|
||||
}));
|
||||
records.push({
|
||||
...h.records[0],
|
||||
id: 'unnamed',
|
||||
name: 'Military area',
|
||||
namedArea: false,
|
||||
pointOnly: false,
|
||||
});
|
||||
for (const id of ['site:519', 'unnamed']) {
|
||||
h.state.selectedId = id;
|
||||
h.markers.sync(records);
|
||||
assert.equal(h.labels[0].id, id);
|
||||
assert.equal(h.labels[0].variant, 'selected');
|
||||
assert.equal(h.labels.filter(e => e.selected).length, 1);
|
||||
assert.equal(h.labels.filter((e) => e.selected).length, 1);
|
||||
assert.equal(h.labels.length, 512);
|
||||
}
|
||||
h.lifecycle.destroy(h.state.viewer);
|
||||
|
||||
@@ -53,13 +53,17 @@ export function createSelection({
|
||||
layerState.clickSubscription = input.onClick((event) => {
|
||||
if (!layerState.enabled) return;
|
||||
// A site's dot, outline or fill, or a named marker: each draw item
|
||||
// names its installation in its `meta`.
|
||||
// names its installation in its `meta`. Else the label box the shared
|
||||
// overlay paints for the site (controls.findAt reads its hit rects),
|
||||
// which is what a click lands on from far out.
|
||||
const hit = event.drawHit;
|
||||
const id =
|
||||
hit?.set === parts.namedMarkers?.setId ||
|
||||
(hit?.set === parts.namedMarkers?.setId ||
|
||||
parts.rendering.ownsSet(hit?.set)
|
||||
? hit.meta?.installationId
|
||||
: null;
|
||||
: null) ??
|
||||
parts.controls?.findAt?.(event.position)?.id ??
|
||||
null;
|
||||
if (id && layerState.recordById.has(id) && id !== layerState.selectedId) {
|
||||
selectRecord(id);
|
||||
} else if (layerState.selectedId) {
|
||||
|
||||
@@ -9,6 +9,7 @@ import {
|
||||
tleEpochMs,
|
||||
} from './classes.js';
|
||||
import { ISS_NORAD } from './policy.js';
|
||||
import { trackedStation } from './stationModels.js';
|
||||
|
||||
/** The layer id a satellite subject carries through Cockpit events and state. */
|
||||
export const SATELLITE_COCKPIT_LAYER_ID = 'satellites';
|
||||
@@ -261,6 +262,29 @@ export function createCockpitSubject({ state: layerState, parts }) {
|
||||
return out;
|
||||
},
|
||||
|
||||
/**
|
||||
* Where the Cockpit camera sits and looks when the subject is the
|
||||
* station: a view from a point on the ISS model (issMounts.js) in place
|
||||
* of the straight-down picture. The station offers several (from Nauka,
|
||||
* from Zarya, from a docked vehicle), whichever of its entries is ridden.
|
||||
* @param {string|null} [key] The view asked for; the first on offer when
|
||||
* it is not given or not on offer.
|
||||
* @returns {{position: object, direction: object, up: object,
|
||||
* right: object, key: string, label: string,
|
||||
* views: Array<{key: string, label: string}>}|null} Earth-fixed
|
||||
* `{x, y, z}` vectors, the view shown and the views on offer; null for
|
||||
* any other satellite, outside the Cockpit, or until the model has
|
||||
* loaded.
|
||||
*/
|
||||
getCockpitMount(key = null) {
|
||||
if (!_cockpitHeld()) return null;
|
||||
// The station the subject belongs to; a station without views on its
|
||||
// model (Tiangong) answers null, and the Cockpit keeps the nadir picture.
|
||||
return (
|
||||
trackedStation(layerState, parts)?.model?._cockpitMount?.(key) ?? null
|
||||
);
|
||||
},
|
||||
|
||||
/**
|
||||
* Mark the satellite whose position the Cockpit camera occupies, or
|
||||
* release it. The hold applies while that satellite is tracked.
|
||||
|
||||
@@ -631,3 +631,70 @@ test('the subject says whether its class may be ridden', () => {
|
||||
])
|
||||
assert.equal(subject(satelliteClass).enterable, true, satelliteClass);
|
||||
});
|
||||
|
||||
test('the station offers its mount only while the Cockpit rides it', async (t) => {
|
||||
const f = await fixture(t);
|
||||
const mount = { label: 'ZARYA' };
|
||||
// The ISS model part works the mount out (issModel.js, stationModel.js);
|
||||
// this layer only decides when the Cockpit may have it, asking the part
|
||||
// whose station the subject is (stationModels.js).
|
||||
const modelPart = (offered) => ({
|
||||
key: 'iss',
|
||||
norad: ISS_NORAD,
|
||||
_updateStationModel() {},
|
||||
_destroyStationModel() {},
|
||||
_standsInFor: () => false,
|
||||
_cockpitMount: () => offered,
|
||||
});
|
||||
f.parts.stationModels = [modelPart(mount)];
|
||||
assert.equal(f.methods.getCockpitMount(), null, 'nothing tracked');
|
||||
f.track(ISS_NORAD);
|
||||
f.nextFrame();
|
||||
assert.equal(f.methods.getCockpitMount(), null, 'tracked, not ridden');
|
||||
f.methods.setCockpitSubject(String(ISS_NORAD));
|
||||
assert.equal(f.methods.getCockpitMount(), mount);
|
||||
// The view asked for is passed on; none asks for the first on offer.
|
||||
const asked = [];
|
||||
f.parts.stationModels = [
|
||||
{
|
||||
...modelPart(mount),
|
||||
_cockpitMount(key) {
|
||||
asked.push(key);
|
||||
return mount;
|
||||
},
|
||||
},
|
||||
];
|
||||
f.methods.getCockpitMount('zarya');
|
||||
f.methods.getCockpitMount();
|
||||
assert.deepEqual(asked, ['zarya', null]);
|
||||
// The model has nothing to offer: not loaded, or not the station.
|
||||
f.parts.stationModels = [modelPart(null)];
|
||||
assert.equal(f.methods.getCockpitMount(), null);
|
||||
delete f.parts.stationModels;
|
||||
assert.equal(f.methods.getCockpitMount(), null);
|
||||
// Another station's part is not asked for the ISS.
|
||||
f.parts.stationModels = [{ ...modelPart(mount), norad: 48274 }];
|
||||
assert.equal(f.methods.getCockpitMount(), null);
|
||||
f.parts.stationModels = [modelPart(mount)];
|
||||
f.methods.setCockpitSubject(null);
|
||||
assert.equal(f.methods.getCockpitMount(), null, 'released');
|
||||
});
|
||||
|
||||
test('a satellite docked to the ISS draws no ring of its own: the ISS’s shows', async (t) => {
|
||||
const f = await fixture(t);
|
||||
f.track(COMPANION);
|
||||
f.nextFrame();
|
||||
assert.equal(f.state._trackedDockedToIss, true);
|
||||
assert.equal(f.ring(COMPANION), undefined, 'no second ring');
|
||||
assert.equal(f.ring(ISS_NORAD).show, true);
|
||||
// The ISS's ring stands for it even with the stations class hidden.
|
||||
f.methods.setParams({ classes: { stations: false } });
|
||||
assert.equal(f.ring(ISS_NORAD).show, true);
|
||||
// Another satellite keeps its own ring; the ISS's goes with its class.
|
||||
f.track(GPS);
|
||||
f.nextFrame();
|
||||
assert.equal(f.state._trackedDockedToIss, false);
|
||||
assert.ok(f.ring(GPS));
|
||||
assert.equal(f.ring(GPS).show, true);
|
||||
assert.equal(f.ring(ISS_NORAD).show, false);
|
||||
});
|
||||
Vendored
+20
-8
@@ -9,6 +9,7 @@ import {
|
||||
mergeClassVisibility,
|
||||
} from './classes.js';
|
||||
import { ISS_NORAD, POINT_STYLES, classPointStyle } from './policy.js';
|
||||
import { modelFor, trackedStation } from './stationModels.js';
|
||||
|
||||
export function createControls({ state: layerState, services, parts, source }) {
|
||||
const { isExplicitLayerStateOrigin } = services.layerState;
|
||||
@@ -64,7 +65,8 @@ export function createControls({ state: layerState, services, parts, source }) {
|
||||
|
||||
/**
|
||||
* Whether the ISS's ring shows: orbits on, the layer drawing, and its
|
||||
* class on or the ISS tracked (a tracked satellite keeps its ring).
|
||||
* class on or the ISS tracked (a tracked satellite keeps its ring), also
|
||||
* as an object docked to it, which draws no ring of its own.
|
||||
*/
|
||||
function _issOrbitVisible() {
|
||||
return (
|
||||
@@ -72,7 +74,9 @@ export function createControls({ state: layerState, services, parts, source }) {
|
||||
layerState._enabled,
|
||||
layerState._params.showOrbits,
|
||||
) &&
|
||||
(_classVisible(ISS_NORAD) || layerState._trackedNorad === ISS_NORAD)
|
||||
(_classVisible(ISS_NORAD) ||
|
||||
layerState._trackedNorad === ISS_NORAD ||
|
||||
Boolean(layerState._trackedDockedToIss))
|
||||
);
|
||||
}
|
||||
|
||||
@@ -253,13 +257,9 @@ export function createControls({ state: layerState, services, parts, source }) {
|
||||
// that card instead. Only members of the tracked cluster are affected —
|
||||
// unrelated nearby satellites are never suppressed.
|
||||
if (!isTracked && layerState._dockedCompanions.has(noradId)) continue;
|
||||
// Up close the ISS is its 3D model: no mark on it, nor on what is
|
||||
// Up close a station is its 3D model: no mark on it, nor on what is
|
||||
// docked to it.
|
||||
if (
|
||||
parts.issModel?._issStandsInFor?.(noradId) ||
|
||||
(noradId === ISS_NORAD && parts.issModel?._issVisualPosition?.())
|
||||
)
|
||||
continue;
|
||||
if (modelFor(parts, noradId)?._visualPosition?.()) continue;
|
||||
// The Cockpit camera rides a held subject; a bracket on it would sit
|
||||
// on the lens.
|
||||
if (isTracked && parts.cockpit?._cockpitHeld()) continue;
|
||||
@@ -446,6 +446,18 @@ export function createControls({ state: layerState, services, parts, source }) {
|
||||
* @param {string|number} noradId NORAD catalog number.
|
||||
* @returns {boolean} True if tracking started.
|
||||
*/
|
||||
/**
|
||||
* The keys the LIVE section matches streams by for the tracked
|
||||
* satellite: a station is `station:<key>` (`station:iss`,
|
||||
* `station:tiangong`) whichever of its entries is tracked (the station,
|
||||
* a module, a docked vehicle).
|
||||
* @returns {string[]}
|
||||
*/
|
||||
getLiveSubjectKeys() {
|
||||
const station = trackedStation(layerState, parts);
|
||||
return station ? [`station:${station.key}`] : [];
|
||||
},
|
||||
|
||||
trackById(noradId, { origin = 'programmatic' } = {}) {
|
||||
const id = Number(noradId);
|
||||
if (
|
||||
|
||||
@@ -7,9 +7,11 @@ import { createRendering } from './rendering.js';
|
||||
import { createTracking } from './tracking.js';
|
||||
import { createTesting } from './testing.js';
|
||||
import { createInteraction } from './interaction.js';
|
||||
import { createIssCommand } from './issCommand.js';
|
||||
import { createIssLive } from './issLive.js';
|
||||
import { issStationDescription } from './issStation.js';
|
||||
import { createStationPanel } from './stationPanel.js';
|
||||
import { createIssModel } from './issModel.js';
|
||||
import { createTiangongModel } from './tiangongModel.js';
|
||||
import { tiangongStationDescription } from './tiangongStation.js';
|
||||
import { createLifecycle } from './lifecycle.js';
|
||||
import { createIngestion } from './ingestion.js';
|
||||
import { createRecords } from './records.js';
|
||||
@@ -32,9 +34,18 @@ export function createSatellitesLayer({
|
||||
parts.orbits = createOrbits(context);
|
||||
parts.records = createRecords(context);
|
||||
parts.rendering = createRendering(context);
|
||||
// The stations drawn as models up close; the other parts ask
|
||||
// stationModels.js which station an entry belongs to.
|
||||
parts.issModel = createIssModel({ ...context, resolveAsset });
|
||||
parts.issLive = createIssLive(context);
|
||||
parts.issCommand = createIssCommand(context);
|
||||
parts.tiangongModel = createTiangongModel({ ...context, resolveAsset });
|
||||
parts.stationModels = [parts.issModel, parts.tiangongModel];
|
||||
parts.stationPanel = createStationPanel({
|
||||
...context,
|
||||
stations: [
|
||||
issStationDescription(context),
|
||||
tiangongStationDescription(context),
|
||||
],
|
||||
});
|
||||
parts.tracking = createTracking(context);
|
||||
parts.testing = createTesting(context);
|
||||
parts.interaction = createInteraction(context);
|
||||
@@ -45,6 +56,7 @@ export function createSatellitesLayer({
|
||||
{},
|
||||
parts.controls.methods,
|
||||
parts.cockpit.methods,
|
||||
parts.stationPanel.methods,
|
||||
parts.lifecycle.methods,
|
||||
parts.ingestion.methods,
|
||||
{
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
import { inputFor } from '../../input/dispatcher.js';
|
||||
import { modelHitNorad } from './stationModels.js';
|
||||
import { onFollowChanged } from '../../data/followed.js';
|
||||
|
||||
export function createInteraction({
|
||||
@@ -63,12 +64,11 @@ export function createInteraction({
|
||||
parts.tracking._trackSatellite(noradId, { origin: 'user' });
|
||||
return;
|
||||
}
|
||||
// A station's 3D model carries its NORAD number as its pick id. A click
|
||||
// A station's 3D model (stationModel.js) names its station. A click
|
||||
// on the tracked station's own model is already tracked; on another
|
||||
// station's model it tracks that one.
|
||||
const modelPickId = picked?.primitive?.id;
|
||||
const modelNorad = Number(modelPickId);
|
||||
if (modelPickId != null && Number.isFinite(modelNorad)) {
|
||||
const modelNorad = modelHitNorad(parts, hit);
|
||||
if (modelNorad !== null) {
|
||||
if (modelNorad === layerState._trackedNorad) return;
|
||||
if (layerState._catalog.has(modelNorad)) {
|
||||
parts.tracking._cancelPendingTrackingRestore();
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import * as Cesium from 'cesium';
|
||||
import { sunPositionFixed } from '../../geo/celestial.js';
|
||||
|
||||
/**
|
||||
* The ISS model's moving parts. NASA's file names its joints; the build keeps
|
||||
@@ -6,11 +6,15 @@ import * as Cesium from 'cesium';
|
||||
* the model's rest frame (glTF axes, meters: X port, Y zenith, Z forward), so
|
||||
* a joint turns by rotating its node about `pivot`.
|
||||
*
|
||||
* The angles are computed from where the Sun is, not read from telemetry: the
|
||||
* two alpha joints turn the outboard truss about the truss axis, each array's
|
||||
* beta joint turns it about its mast, and the two radiator joints keep the
|
||||
* By default the angles are computed from where the Sun is: the two alpha
|
||||
* joints turn the outboard truss about the truss axis, each array's beta
|
||||
* joint turns it about its mast, and the two radiator joints keep the
|
||||
* radiators edge-on to the Sun. In the Earth's shadow the arrays feather:
|
||||
* masts along the flight direction, edge into it.
|
||||
*
|
||||
* Where the server relays NASA's public telemetry (issTelemetry.js), the
|
||||
* arrays, the radiators and one dish take their real angles from it instead,
|
||||
* and fall back to the computed ones whenever it has nothing to say.
|
||||
*/
|
||||
|
||||
/** Alpha joints (SARJ): rotate about the truss, glTF X. */
|
||||
@@ -189,8 +193,8 @@ export function issStepAngle(current, target, maxStep) {
|
||||
* @param {'x'|'z'} axis
|
||||
* @param {number[]} pivot
|
||||
* @param {number} angle Radians.
|
||||
* @param {Cesium.Matrix4} result
|
||||
* @returns {Cesium.Matrix4}
|
||||
* @param {ArrayLike<number>} result Any 16-slot array, column-major.
|
||||
* @returns {ArrayLike<number>} `result`.
|
||||
*/
|
||||
export function issJointMatrix(axis, pivot, angle, result) {
|
||||
const c = Math.cos(angle);
|
||||
@@ -236,8 +240,18 @@ export function issJointMatrix(axis, pivot, angle, result) {
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Write a row-major 4×4 into `result`, column-major (a renderer's matrix
|
||||
* layout; `result` is any 16-slot array).
|
||||
* @param {ArrayLike<number> & {[i: number]: number}} [result] A new one when not given.
|
||||
* @param {number[]} rowMajor
|
||||
*/
|
||||
function set(result, rowMajor) {
|
||||
return Cesium.Matrix4.fromRowMajorArray(rowMajor, result);
|
||||
result ??= new Float64Array(16);
|
||||
for (let row = 0; row < 4; row++)
|
||||
for (let column = 0; column < 4; column++)
|
||||
result[column * 4 + row] = rowMajor[row * 4 + column];
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -364,22 +378,30 @@ const DISH_MIN_UP = 0.15;
|
||||
* highest above the station first.
|
||||
* @param {number[]} positionEcef Meters.
|
||||
* @param {{x:number[], y:number[], z:number[]}} axes Flight axes.
|
||||
* @param {readonly number[]} [longitudes] The relays' slots, degrees east;
|
||||
* NASA's for the ISS, another station passes its own.
|
||||
* @returns {number[][]} Unit vectors [port, zenith, forward].
|
||||
*/
|
||||
export function issRelayDirections(positionEcef, axes) {
|
||||
return ISS_RELAY_LONGITUDES_DEG.map((longitude) => {
|
||||
const lon = (longitude * Math.PI) / 180;
|
||||
const to = [
|
||||
GEOSTATIONARY_RADIUS_M * Math.cos(lon) - positionEcef[0],
|
||||
GEOSTATIONARY_RADIUS_M * Math.sin(lon) - positionEcef[1],
|
||||
-positionEcef[2],
|
||||
];
|
||||
const length = Math.hypot(to[0], to[1], to[2]);
|
||||
return issSunInModelFrame(
|
||||
to.map((c) => c / length),
|
||||
axes,
|
||||
);
|
||||
}).sort((a, b) => b[1] - a[1]);
|
||||
export function issRelayDirections(
|
||||
positionEcef,
|
||||
axes,
|
||||
longitudes = ISS_RELAY_LONGITUDES_DEG,
|
||||
) {
|
||||
return longitudes
|
||||
.map((longitude) => {
|
||||
const lon = (longitude * Math.PI) / 180;
|
||||
const to = [
|
||||
GEOSTATIONARY_RADIUS_M * Math.cos(lon) - positionEcef[0],
|
||||
GEOSTATIONARY_RADIUS_M * Math.sin(lon) - positionEcef[1],
|
||||
-positionEcef[2],
|
||||
];
|
||||
const length = Math.hypot(to[0], to[1], to[2]);
|
||||
return issSunInModelFrame(
|
||||
to.map((c) => c / length),
|
||||
axes,
|
||||
);
|
||||
})
|
||||
.sort((a, b) => b[1] - a[1]);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -416,8 +438,8 @@ export function issStepDirection(current, target, maxStep) {
|
||||
* @param {number[]} pivot
|
||||
* @param {number[]} axis Unit vector.
|
||||
* @param {number} angle Radians.
|
||||
* @param {Cesium.Matrix4} result
|
||||
* @returns {Cesium.Matrix4}
|
||||
* @param {ArrayLike<number>} result Any 16-slot array, column-major.
|
||||
* @returns {ArrayLike<number>} `result`.
|
||||
*/
|
||||
export function issAxisMatrix(pivot, axis, angle, result) {
|
||||
const [x, y, z] = axis;
|
||||
@@ -440,8 +462,8 @@ export function issAxisMatrix(pivot, axis, angle, result) {
|
||||
* A dish node's matrix that turns its rest boresight (+Y) onto `direction`.
|
||||
* @param {number[]} pivot
|
||||
* @param {number[]} direction Unit vector on the model's axes.
|
||||
* @param {Cesium.Matrix4} result
|
||||
* @returns {Cesium.Matrix4}
|
||||
* @param {ArrayLike<number>} result Any 16-slot array, column-major.
|
||||
* @returns {ArrayLike<number>} `result`.
|
||||
*/
|
||||
export function issAimMatrix(pivot, direction, result) {
|
||||
// Y × direction
|
||||
@@ -471,6 +493,12 @@ export function createIssArticulation() {
|
||||
let lastMs = 0;
|
||||
let override = null;
|
||||
let dishOverride = null;
|
||||
/** Gives the joint angles from telemetry, or null: see setTelemetry. */
|
||||
let telemetry = null;
|
||||
/** Command panel state: Manual takes the joints, so telemetry is off. */
|
||||
let telemetryAllowed = true;
|
||||
/** Whether the last update took its angles from telemetry; null before one. */
|
||||
let lastLive = null;
|
||||
/** Whether the last update had the station in sunlight; null before one. */
|
||||
let lastSunlit = null;
|
||||
/** Command panel state: the arm is being posed by hand, so the sway is off. */
|
||||
@@ -493,10 +521,7 @@ export function createIssArticulation() {
|
||||
const SMALL_RADIATOR_ROOT_Y = -1.6;
|
||||
/** Where each dish looks now, on the model's axes. */
|
||||
let dishes = null;
|
||||
const scratchJulian = new Cesium.JulianDate();
|
||||
const scratchSun = new Cesium.Cartesian3();
|
||||
const scratchToFixed = new Cesium.Matrix3();
|
||||
const scratchMatrix = new Cesium.Matrix4();
|
||||
const scratchMatrix = new Float64Array(16);
|
||||
|
||||
function bind(model) {
|
||||
boundModel = model;
|
||||
@@ -513,18 +538,9 @@ export function createIssArticulation() {
|
||||
}
|
||||
|
||||
function sunEcef(date) {
|
||||
const julian = Cesium.JulianDate.fromDate(date, scratchJulian);
|
||||
const inertial =
|
||||
Cesium.Simon1994PlanetaryPositions.computeSunPositionInEarthInertialFrame(
|
||||
julian,
|
||||
scratchSun,
|
||||
);
|
||||
const toFixed =
|
||||
Cesium.Transforms.computeIcrfToFixedMatrix(julian, scratchToFixed) ??
|
||||
Cesium.Transforms.computeTemeToPseudoFixedMatrix(julian, scratchToFixed);
|
||||
Cesium.Matrix3.multiplyByVector(toFixed, inertial, scratchSun);
|
||||
Cesium.Cartesian3.normalize(scratchSun, scratchSun);
|
||||
return [scratchSun.x, scratchSun.y, scratchSun.z];
|
||||
const sun = sunPositionFixed(date.getTime());
|
||||
const length = Math.hypot(sun.x, sun.y, sun.z) || 1;
|
||||
return [sun.x / length, sun.y / length, sun.z / length];
|
||||
}
|
||||
|
||||
function write(node, axis, pivot, angle) {
|
||||
@@ -533,9 +549,10 @@ export function createIssArticulation() {
|
||||
}
|
||||
|
||||
/**
|
||||
* @param {Cesium.Model} model A ready model.
|
||||
* @param {{ready: boolean, getNode: (name: string) => object|undefined}} model
|
||||
* A ready model, or any holder of nodes that take a `matrix`.
|
||||
* @param {Date} date The instant the model is placed at.
|
||||
* @param {Cesium.Cartesian3} position Earth-fixed station position.
|
||||
* @param {{x:number,y:number,z:number}} position Earth-fixed station position.
|
||||
* @param {{x:number[], y:number[], z:number[]}} axes Its flight axes.
|
||||
* @param {number} [nowMs] Wall clock, for the turn rate.
|
||||
*/
|
||||
@@ -552,6 +569,13 @@ export function createIssArticulation() {
|
||||
lastSunlit = sunlit;
|
||||
targets = issJointTargets(issSunInModelFrame(sun, axes), sunlit, targets);
|
||||
}
|
||||
// Telemetry, when it has a pose, replaces the computed targets; a Sun
|
||||
// chosen by hand in the command panel is always computed.
|
||||
const pose = telemetryAllowed && !forced ? (telemetry?.() ?? null) : null;
|
||||
lastLive = Boolean(pose);
|
||||
const alphaTargets = pose?.alpha ?? [targets.alpha, targets.alpha];
|
||||
const betaTargets = pose?.beta ?? targets.beta;
|
||||
const gammaTargets = pose?.gamma ?? [targets.gamma, targets.gamma];
|
||||
// A first frame, or one after a pause, goes straight to the pose.
|
||||
const elapsed = (nowMs - lastMs) / 1000;
|
||||
lastMs = nowMs;
|
||||
@@ -560,16 +584,20 @@ export function createIssArticulation() {
|
||||
? Number.POSITIVE_INFINITY
|
||||
: ISS_JOINT_RATE * elapsed;
|
||||
const next = {
|
||||
alpha: issStepAngle(angles?.alpha ?? 0, targets.alpha, maxStep),
|
||||
beta: targets.beta.map((target, i) =>
|
||||
alpha: alphaTargets.map((target, i) =>
|
||||
issStepAngle(angles?.alpha[i] ?? 0, target, maxStep),
|
||||
),
|
||||
beta: betaTargets.map((target, i) =>
|
||||
issStepAngle(angles?.beta[i] ?? 0, target, maxStep),
|
||||
),
|
||||
gamma: issStepAngle(angles?.gamma ?? 0, targets.gamma, maxStep),
|
||||
gamma: gammaTargets.map((target, i) =>
|
||||
issStepAngle(angles?.gamma[i] ?? 0, target, maxStep),
|
||||
),
|
||||
};
|
||||
if (!angles || next.alpha !== angles.alpha)
|
||||
ISS_ALPHA_JOINTS.forEach((joint, i) =>
|
||||
write(nodes.alpha[i], 'x', joint.pivot, next.alpha),
|
||||
);
|
||||
ISS_ALPHA_JOINTS.forEach((joint, i) => {
|
||||
if (!angles || next.alpha[i] !== angles.alpha[i])
|
||||
write(nodes.alpha[i], 'x', joint.pivot, next.alpha[i]);
|
||||
});
|
||||
// Command panel: squash the arrays along their masts (see setDeploy).
|
||||
const deployStep = Number.isFinite(maxStep) ? elapsed / 8 : 1;
|
||||
const nextDeploy =
|
||||
@@ -597,58 +625,63 @@ export function createIssArticulation() {
|
||||
radiatorDeploy +
|
||||
Math.sign(radiatorTarget - radiatorDeploy) *
|
||||
Math.min(Math.abs(radiatorTarget - radiatorDeploy), deployStep);
|
||||
if (
|
||||
!angles ||
|
||||
next.gamma !== angles.gamma ||
|
||||
nextRadiator !== radiatorDeploy
|
||||
)
|
||||
ISS_RADIATOR_JOINTS.forEach((joint, i) => {
|
||||
const node = nodes.gamma[i];
|
||||
if (!node) return;
|
||||
const m = issJointMatrix('z', joint.pivot, next.gamma, scratchMatrix);
|
||||
m[10] = nextRadiator;
|
||||
m[14] = RADIATOR_ROOT_Z * (1 - nextRadiator);
|
||||
node.matrix = m;
|
||||
});
|
||||
ISS_RADIATOR_JOINTS.forEach((joint, i) => {
|
||||
if (
|
||||
angles &&
|
||||
next.gamma[i] === angles.gamma[i] &&
|
||||
nextRadiator === radiatorDeploy
|
||||
)
|
||||
return;
|
||||
const node = nodes.gamma[i];
|
||||
if (!node) return;
|
||||
const m = issJointMatrix('z', joint.pivot, next.gamma[i], scratchMatrix);
|
||||
m[10] = nextRadiator;
|
||||
m[14] = RADIATOR_ROOT_Z * (1 - nextRadiator);
|
||||
node.matrix = m;
|
||||
});
|
||||
// The four small radiators fold up to the truss, along Y.
|
||||
if (nextRadiator !== radiatorDeploy)
|
||||
for (const name of SMALL_RADIATOR_NODES) {
|
||||
const node = model.getNode(name);
|
||||
if (!node) continue;
|
||||
node.matrix = Cesium.Matrix4.fromRowMajorArray(
|
||||
[
|
||||
1,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
nextRadiator,
|
||||
0,
|
||||
SMALL_RADIATOR_ROOT_Y * (1 - nextRadiator),
|
||||
0,
|
||||
0,
|
||||
1,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
1,
|
||||
],
|
||||
scratchMatrix,
|
||||
);
|
||||
node.matrix = set(scratchMatrix, [
|
||||
1,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
nextRadiator,
|
||||
0,
|
||||
SMALL_RADIATOR_ROOT_Y * (1 - nextRadiator),
|
||||
0,
|
||||
0,
|
||||
1,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
0,
|
||||
1,
|
||||
]);
|
||||
}
|
||||
radiatorDeploy = nextRadiator;
|
||||
angles = next;
|
||||
|
||||
// Dishes: the highest relay satellite for the first, the next for the
|
||||
// second; one below the station's horizon plane keeps its last aim.
|
||||
// Telemetry reports one dish (the station uses one at a time, and does
|
||||
// not say which): the first takes its real aim, wherever that is, and
|
||||
// the second holds still.
|
||||
const liveDish = !dishOverride && pose?.dish ? pose.dish : null;
|
||||
const relays = dishOverride
|
||||
? [dishOverride, dishOverride]
|
||||
: issRelayDirections([position.x, position.y, position.z], axes);
|
||||
: liveDish
|
||||
? [liveDish, null]
|
||||
: issRelayDirections([position.x, position.y, position.z], axes);
|
||||
const nextDishes = ISS_DISH_JOINTS.map((joint, i) => {
|
||||
const current = dishes?.[i] ?? [0, 1, 0];
|
||||
const wanted = relays[i];
|
||||
const target = wanted && wanted[1] >= DISH_MIN_UP ? wanted : current;
|
||||
const target =
|
||||
wanted && (liveDish || wanted[1] >= DISH_MIN_UP) ? wanted : current;
|
||||
const stepped = issStepDirection(current, target, maxStep);
|
||||
const moved =
|
||||
!dishes || stepped.some((c, k) => Math.abs(c - current[k]) > 1e-9);
|
||||
@@ -718,6 +751,26 @@ export function createIssArticulation() {
|
||||
return lastSunlit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the joint angles come from when telemetry has them: a function
|
||||
* giving `{alpha, beta, gamma, dish}` (issTelemetryPose) or null.
|
||||
* @param {(() => {alpha:number[], beta:number[], gamma:number[],
|
||||
* dish:number[]|null}|null)|null} fn
|
||||
*/
|
||||
function setTelemetry(fn) {
|
||||
telemetry = fn;
|
||||
}
|
||||
|
||||
/** Command panel: Manual switches telemetry off, Automatic back on. */
|
||||
function setTelemetryAllowed(allowed) {
|
||||
telemetryAllowed = Boolean(allowed);
|
||||
}
|
||||
|
||||
/** Whether the last update took its angles from telemetry; null before one. */
|
||||
function isLive() {
|
||||
return lastLive;
|
||||
}
|
||||
|
||||
/** Command panel: aim both dishes along a unit vector, or null for the relays. */
|
||||
function setDishOverride(direction) {
|
||||
dishOverride = direction;
|
||||
@@ -757,5 +810,8 @@ export function createIssArticulation() {
|
||||
setDeploy,
|
||||
setRadiatorDeploy,
|
||||
isSunlit,
|
||||
setTelemetry,
|
||||
setTelemetryAllowed,
|
||||
isLive,
|
||||
};
|
||||
}
|
||||
@@ -1,17 +1,23 @@
|
||||
import { onLocaleChange, t } from '../../i18n/index.js';
|
||||
import { ISS_ARM_JOINTS } from './issArticulation.js';
|
||||
import { makePanelDraggable } from './issLive.js';
|
||||
import * as Cesium from 'cesium';
|
||||
import { ISS_NORAD } from './policy.js';
|
||||
import { t } from '../../i18n/index.js';
|
||||
import { ISS_NORAD, issTrackedOnStation } from './policy.js';
|
||||
|
||||
/**
|
||||
* Whether the command panel shows: the ISS selected (tracked), the layer on
|
||||
* and the Cockpit not riding it.
|
||||
* @param {{enabled: boolean, trackedNorad: number|null, cockpitHeld: boolean}} input
|
||||
* Whether the command panel shows: the ISS selected (tracked), or an object
|
||||
* docked to it, the layer on and the Cockpit not riding it.
|
||||
* @param {{enabled: boolean, trackedNorad: number|null, cockpitHeld: boolean,
|
||||
* docked?: boolean}} input `docked`: the tracked satellite is docked to the
|
||||
* ISS (issTrackedOnStation).
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function issCommandShouldShow({ enabled, trackedNorad, cockpitHeld }) {
|
||||
return Boolean(enabled) && trackedNorad === ISS_NORAD && !cockpitHeld;
|
||||
export function issCommandShouldShow({
|
||||
enabled,
|
||||
trackedNorad,
|
||||
cockpitHeld,
|
||||
docked = false,
|
||||
}) {
|
||||
const onStation =
|
||||
trackedNorad === ISS_NORAD || (Boolean(docked) && trackedNorad !== null);
|
||||
return Boolean(enabled) && onStation && !cockpitHeld;
|
||||
}
|
||||
|
||||
const unit = (v) => {
|
||||
@@ -49,6 +55,21 @@ export function issCommandStatusText(sunlit) {
|
||||
return sunlit ? t('Now: in sunlight') : t("Now: in the Earth's shadow");
|
||||
}
|
||||
|
||||
/**
|
||||
* The Automatic mode's note: what moves the joints right now.
|
||||
* @param {boolean} live Whether the joints are on NASA's telemetry.
|
||||
* @returns {string}
|
||||
*/
|
||||
export function issCommandNoteText(live) {
|
||||
return live
|
||||
? t(
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.",
|
||||
)
|
||||
: t(
|
||||
'Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.',
|
||||
);
|
||||
}
|
||||
|
||||
/** Beyond this the camera counts as far, and the zoom button is offered. */
|
||||
export const ISS_COMMAND_FAR_M = 1000;
|
||||
|
||||
@@ -75,6 +96,61 @@ export function issCommandZoomStep(distance) {
|
||||
return left * 0.14;
|
||||
}
|
||||
|
||||
/**
|
||||
* The follow camera's range after one step of the zoom: the step nearer,
|
||||
* never past the target range, and unchanged once there. The camera is moved
|
||||
* by scaling its follow offset from the station (the camera port's
|
||||
* `followOffset`, the eye in the follow's frame) by
|
||||
* `issCommandZoomRange(range) / range`, which can only bring it in; a move
|
||||
* along the view direction is not used, since it ran away when the camera
|
||||
* was not looking at the station.
|
||||
* @param {number} range Meters from the camera to the station.
|
||||
* @returns {number} The range to set; `range` itself when there is no step.
|
||||
*/
|
||||
export function issCommandZoomRange(range) {
|
||||
if (!(range > 0) || !Number.isFinite(range)) return range;
|
||||
const step = issCommandZoomStep(range);
|
||||
return step > 0 ? Math.max(ISS_COMMAND_ZOOM_RANGE_M, range - step) : range;
|
||||
}
|
||||
|
||||
/**
|
||||
* One step of the zoom on the follow offset: the same offset, shortened to
|
||||
* `issCommandZoomRange` of its length, so the eye keeps its bearing on the
|
||||
* station and only comes in.
|
||||
* @param {{x: number, y: number, z: number}|null|undefined} offset The
|
||||
* eye's offset from the station, metres in the follow's frame.
|
||||
* @returns {{x: number, y: number, z: number}|null} The offset to set; null
|
||||
* when there is no step (close enough, or no offset to shorten).
|
||||
*/
|
||||
export function issCommandZoomOffset(offset) {
|
||||
if (!offset) return null;
|
||||
const range = Math.hypot(offset.x, offset.y, offset.z);
|
||||
const next = issCommandZoomRange(range);
|
||||
if (!(next < range)) return null;
|
||||
const k = next / range;
|
||||
return { x: offset.x * k, y: offset.y * k, z: offset.z * k };
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the zoom may run: only while the camera follows the station's
|
||||
* follow target and has framed it, so that its follow offset is the eye's
|
||||
* offset from the station and shortening it brings the camera in. From any
|
||||
* other camera (still flying to the station, following something else, or
|
||||
* a follow not yet framed) there is no such offset to shorten.
|
||||
* @param {{followed?: object|null, followFramed?: boolean}|null|undefined}
|
||||
* camera What the camera port reports (`cameraOf(viewer)`).
|
||||
* @param {object|null|undefined} target The layer's follow target for the
|
||||
* station (`layerState._followTarget`).
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function issCommandCameraOnStation(camera, target) {
|
||||
return (
|
||||
Boolean(target) &&
|
||||
camera?.followed === target &&
|
||||
camera.followFramed === true
|
||||
);
|
||||
}
|
||||
|
||||
/** How long one lap of the "fast orbit" takes, and its share in shadow. */
|
||||
const FAST_ORBIT_MS = 40_000;
|
||||
|
||||
@@ -91,391 +167,3 @@ export function issCommandFastOrbit(elapsedMs) {
|
||||
sunlit: Math.cos(angle) > -0.5,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The ISS command panel: shown collapsed while the ISS is selected. Automatic
|
||||
* (the default) leaves the model to its own rules: arrays and radiators by the
|
||||
* Sun, dishes at the relay satellites, arms swaying. Manual opens the
|
||||
* controls and hands the joints to the viewer; going back to Automatic
|
||||
* returns every joint to its rule.
|
||||
*/
|
||||
export function createIssCommand({ state: layerState, parts }) {
|
||||
let panel = null;
|
||||
let renderTimer = null;
|
||||
let renderUntil = 0;
|
||||
|
||||
const joints = () => parts.issModel?._issArticulation ?? null;
|
||||
|
||||
/** Keep frames coming while a joint is on its way to a new pose. */
|
||||
function _renderFor(ms) {
|
||||
renderUntil = Math.max(renderUntil, Date.now() + ms);
|
||||
if (renderTimer) return;
|
||||
renderTimer = setInterval(() => {
|
||||
layerState._viewer?.scene?.requestRender?.();
|
||||
if (Date.now() > renderUntil) _stopRendering();
|
||||
}, 33);
|
||||
}
|
||||
|
||||
function _stopRendering() {
|
||||
if (renderTimer) clearInterval(renderTimer);
|
||||
renderTimer = null;
|
||||
renderUntil = 0;
|
||||
}
|
||||
|
||||
let zoomTimer = null;
|
||||
let zoomButton = null;
|
||||
/** Stops listening for language changes; set while the panel is open. */
|
||||
let stopLocale = null;
|
||||
let statusLine = null;
|
||||
/** The lit/shadow state the status line last showed. */
|
||||
let shownSunlit;
|
||||
|
||||
/** Say whether the station is in sunlight right now, when that changes. */
|
||||
function _syncStatus() {
|
||||
if (!statusLine) return;
|
||||
const sunlit = joints()?.isSunlit() ?? null;
|
||||
if (sunlit === shownSunlit) return;
|
||||
shownSunlit = sunlit;
|
||||
statusLine.textContent = issCommandStatusText(sunlit);
|
||||
}
|
||||
|
||||
/** Meters from the camera to the station, or null when unknown. */
|
||||
function _stationDistance() {
|
||||
const viewer = layerState._viewer;
|
||||
const target =
|
||||
parts.issModel?._issVisualPosition?.() ??
|
||||
layerState._trackedFrameCartesian ??
|
||||
layerState._points.get(ISS_NORAD)?.position;
|
||||
if (!viewer || !target) return null;
|
||||
return Cesium.Cartesian3.distance(viewer.camera.positionWC, target);
|
||||
}
|
||||
|
||||
function _syncZoomButton() {
|
||||
if (!zoomButton) return;
|
||||
const distance = _stationDistance();
|
||||
const offered = distance !== null && issCommandOffersZoom(distance);
|
||||
if (zoomButton.hidden === offered) zoomButton.hidden = !offered;
|
||||
}
|
||||
|
||||
function _stopZoom() {
|
||||
if (zoomTimer) clearInterval(zoomTimer);
|
||||
zoomTimer = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Bring the follow camera in to the station. The camera already tracks the
|
||||
* ISS, so this only shortens its range, a step per frame.
|
||||
*/
|
||||
function _zoomToStation() {
|
||||
_stopZoom();
|
||||
let steps = 0;
|
||||
zoomTimer = setInterval(() => {
|
||||
const viewer = layerState._viewer;
|
||||
const target =
|
||||
parts.issModel?._issVisualPosition?.() ??
|
||||
layerState._trackedFrameCartesian ??
|
||||
layerState._points.get(ISS_NORAD)?.position;
|
||||
steps += 1;
|
||||
if (
|
||||
!viewer ||
|
||||
!target ||
|
||||
layerState._trackedNorad !== ISS_NORAD ||
|
||||
steps > 400
|
||||
) {
|
||||
_stopZoom();
|
||||
return;
|
||||
}
|
||||
const step = issCommandZoomStep(
|
||||
Cesium.Cartesian3.distance(viewer.camera.positionWC, target),
|
||||
);
|
||||
if (!step) {
|
||||
_stopZoom();
|
||||
return;
|
||||
}
|
||||
viewer.camera.zoomIn(step);
|
||||
viewer.scene.requestRender?.();
|
||||
}, 16);
|
||||
}
|
||||
|
||||
/** Every joint back to its own rule. */
|
||||
function _automatic() {
|
||||
const articulation = joints();
|
||||
if (!articulation) return;
|
||||
articulation.setOverride(null);
|
||||
articulation.setDishOverride(null);
|
||||
articulation.setDeploy(true);
|
||||
articulation.setRadiatorDeploy(true);
|
||||
articulation.resumeArm();
|
||||
_renderFor(20_000);
|
||||
}
|
||||
|
||||
function _build(documentRef) {
|
||||
const el = (tag, className, text) => {
|
||||
const node = documentRef.createElement(tag);
|
||||
if (className) node.className = className;
|
||||
if (text !== undefined) node.textContent = text;
|
||||
return node;
|
||||
};
|
||||
const root = el('section', 'qci-panel iss-command-panel');
|
||||
root.setAttribute('role', 'region');
|
||||
root.setAttribute('aria-label', t('ISS command panel'));
|
||||
|
||||
const header = el('header', 'qci-header');
|
||||
const title = el('strong', 'iss-command-title', t('ISS · COMMAND PANEL'));
|
||||
const toggle = el('button', 'iss-command-toggle');
|
||||
toggle.type = 'button';
|
||||
header.append(title, toggle);
|
||||
|
||||
const body = el('div', 'iss-command-body');
|
||||
body.hidden = true;
|
||||
const setCollapsed = (collapsed) => {
|
||||
body.hidden = collapsed;
|
||||
toggle.textContent = collapsed ? '▸' : '▾';
|
||||
toggle.setAttribute('aria-expanded', String(!collapsed));
|
||||
toggle.setAttribute(
|
||||
'aria-label',
|
||||
collapsed ? t('Expand command panel') : t('Collapse command panel'),
|
||||
);
|
||||
};
|
||||
toggle.addEventListener('click', () => setCollapsed(!body.hidden));
|
||||
setCollapsed(true);
|
||||
|
||||
// Mode
|
||||
const modes = el('div', 'iss-command-modes');
|
||||
modes.setAttribute('role', 'radiogroup');
|
||||
const autoButton = el('button', 'iss-command-mode', t('Automatic'));
|
||||
const manualButton = el('button', 'iss-command-mode', t('Manual'));
|
||||
const status = el('p', 'iss-command-status');
|
||||
statusLine = status;
|
||||
const autoNote = el(
|
||||
'p',
|
||||
'qci-note',
|
||||
t(
|
||||
'Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.',
|
||||
),
|
||||
);
|
||||
const manual = el('div', 'iss-command-manual');
|
||||
manual.hidden = true;
|
||||
const setMode = (isManual) => {
|
||||
for (const [button, on] of [
|
||||
[autoButton, !isManual],
|
||||
[manualButton, isManual],
|
||||
]) {
|
||||
button.type = 'button';
|
||||
button.setAttribute('role', 'radio');
|
||||
button.setAttribute('aria-checked', String(on));
|
||||
button.classList.toggle('is-active', on);
|
||||
}
|
||||
manual.hidden = !isManual;
|
||||
autoNote.hidden = isManual;
|
||||
status.hidden = isManual;
|
||||
};
|
||||
const resetControls = () => {
|
||||
manual
|
||||
.querySelectorAll('input[type="range"]')
|
||||
.forEach((slider) => (slider.value = '0'));
|
||||
// Back to what Automatic does: each row's own default lit.
|
||||
manual
|
||||
.querySelectorAll('.iss-command-button')
|
||||
.forEach((button) =>
|
||||
button.classList.toggle('is-active', button.dataset.default === '1'),
|
||||
);
|
||||
};
|
||||
autoButton.addEventListener('click', () => {
|
||||
setMode(false);
|
||||
resetControls();
|
||||
_automatic();
|
||||
});
|
||||
manualButton.addEventListener('click', () => setMode(true));
|
||||
modes.append(autoButton, manualButton);
|
||||
setMode(false);
|
||||
|
||||
// Manual controls
|
||||
const group = (label, note) => {
|
||||
const box = el('div', 'iss-command-group');
|
||||
box.append(el('div', 'iss-command-label', label));
|
||||
const row = el('div', 'iss-command-row');
|
||||
box.append(row);
|
||||
if (note) box.append(el('p', 'qci-note', note));
|
||||
manual.append(box);
|
||||
return row;
|
||||
};
|
||||
/** A row of buttons where the last one pressed stays lit. */
|
||||
const choices = (row, entries) => {
|
||||
for (const [label, action, isDefault] of entries) {
|
||||
const button = el('button', 'iss-command-button', label);
|
||||
button.type = 'button';
|
||||
// What Automatic is doing starts lit, so the row shows what holds.
|
||||
if (isDefault) {
|
||||
button.dataset.default = '1';
|
||||
button.classList.add('is-active');
|
||||
}
|
||||
button.addEventListener('click', () => {
|
||||
row
|
||||
.querySelectorAll('.is-active')
|
||||
.forEach((other) => other.classList.remove('is-active'));
|
||||
button.classList.add('is-active');
|
||||
const articulation = joints();
|
||||
if (!articulation) return;
|
||||
action(articulation);
|
||||
_renderFor(20_000);
|
||||
});
|
||||
row.append(button);
|
||||
}
|
||||
};
|
||||
|
||||
choices(group(t('Sun position')), [
|
||||
[t('Follow the Sun'), (a) => a.setOverride(null), true],
|
||||
...issCommandSunPoses().map(({ label, sun, sunlit }) => [
|
||||
label,
|
||||
(a) => {
|
||||
const fixed = { sun, sunlit };
|
||||
a.setOverride(() => fixed);
|
||||
},
|
||||
]),
|
||||
[
|
||||
t('Fast orbit (40 s)'),
|
||||
(a) => {
|
||||
const start = Date.now();
|
||||
a.setOverride((nowMs) => issCommandFastOrbit(nowMs - start));
|
||||
_renderFor(10 * 60_000);
|
||||
},
|
||||
],
|
||||
]);
|
||||
choices(
|
||||
group(
|
||||
t('Solar arrays'),
|
||||
t('Demonstration: the real arrays stay extended.'),
|
||||
),
|
||||
[
|
||||
[t('Retract'), (a) => a.setDeploy(false)],
|
||||
[t('Extend'), (a) => a.setDeploy(true), true],
|
||||
],
|
||||
);
|
||||
choices(
|
||||
group(
|
||||
t('Radiators'),
|
||||
t('Demonstration: the real radiators can fold but stay extended.'),
|
||||
),
|
||||
[
|
||||
[t('Retract'), (a) => a.setRadiatorDeploy(false)],
|
||||
[t('Extend'), (a) => a.setRadiatorDeploy(true), true],
|
||||
],
|
||||
);
|
||||
choices(group(t('Dishes')), [
|
||||
[t('Relay satellites'), (a) => a.setDishOverride(null), true],
|
||||
[t('Up'), (a) => a.setDishOverride([0, 1, 0])],
|
||||
[t('Forward'), (a) => a.setDishOverride(unit([0, 0.35, 0.94]))],
|
||||
[t('Sideways'), (a) => a.setDishOverride(unit([0.94, 0.35, 0]))],
|
||||
]);
|
||||
|
||||
const armLabels = [
|
||||
t('Shoulder roll'),
|
||||
t('Shoulder yaw'),
|
||||
t('Shoulder pitch'),
|
||||
t('Elbow'),
|
||||
t('Wrist pitch'),
|
||||
t('Wrist yaw'),
|
||||
t('Wrist roll'),
|
||||
];
|
||||
const arm = group(t('Canadarm2 (degrees)'));
|
||||
arm.classList.add('iss-command-sliders');
|
||||
ISS_ARM_JOINTS.forEach((joint, i) => {
|
||||
const row = el('label', 'iss-command-slider');
|
||||
const slider = el('input');
|
||||
slider.type = 'range';
|
||||
slider.min = '-120';
|
||||
slider.max = '120';
|
||||
slider.value = '0';
|
||||
slider.addEventListener('input', () => {
|
||||
joints()?.setJoint(
|
||||
joint.node,
|
||||
joint.pivot,
|
||||
joint.axis,
|
||||
(Number(slider.value) * Math.PI) / 180,
|
||||
);
|
||||
_renderFor(2000);
|
||||
});
|
||||
row.append(el('span', '', armLabels[i]), slider);
|
||||
arm.append(row);
|
||||
});
|
||||
const resume = el('button', 'iss-command-button', t('Resume sway'));
|
||||
resume.type = 'button';
|
||||
resume.addEventListener('click', () => {
|
||||
arm
|
||||
.querySelectorAll('input[type="range"]')
|
||||
.forEach((slider) => (slider.value = '0'));
|
||||
joints()?.resumeArm();
|
||||
_renderFor(20_000);
|
||||
});
|
||||
arm.append(resume);
|
||||
|
||||
const zoom = el('button', 'iss-command-button iss-command-zoom');
|
||||
zoom.type = 'button';
|
||||
zoom.textContent = t('Zoom to the ISS');
|
||||
zoom.addEventListener('click', _zoomToStation);
|
||||
zoomButton = zoom;
|
||||
body.append(zoom, modes, status, autoNote, manual);
|
||||
root.append(header, body);
|
||||
makePanelDraggable(root, header);
|
||||
return root;
|
||||
}
|
||||
|
||||
/**
|
||||
* Show or hide the panel for the current selection. Cheap when nothing
|
||||
* changed, so the tracking and Cockpit paths can call it freely.
|
||||
* @returns {void}
|
||||
*/
|
||||
function _syncIssCommand() {
|
||||
const show = issCommandShouldShow({
|
||||
enabled: layerState._enabled,
|
||||
trackedNorad: layerState._trackedNorad,
|
||||
cockpitHeld: Boolean(parts.cockpit?._cockpitHeld()),
|
||||
});
|
||||
if (!show) {
|
||||
_removePanel();
|
||||
return;
|
||||
}
|
||||
if (panel) {
|
||||
_syncZoomButton();
|
||||
_syncStatus();
|
||||
return;
|
||||
}
|
||||
const documentRef = globalThis.document;
|
||||
if (!documentRef?.body) return;
|
||||
panel = _build(documentRef);
|
||||
documentRef.body.append(panel);
|
||||
stopLocale = onLocaleChange(_onLocaleChange);
|
||||
_syncZoomButton();
|
||||
_syncStatus();
|
||||
}
|
||||
|
||||
/** Closing the panel hands the joints back, so no manual pose lingers. */
|
||||
function _removePanel() {
|
||||
if (!panel) return;
|
||||
panel.remove();
|
||||
panel = null;
|
||||
zoomButton = null;
|
||||
stopLocale?.();
|
||||
stopLocale = null;
|
||||
statusLine = null;
|
||||
shownSunlit = undefined;
|
||||
_stopZoom();
|
||||
_automatic();
|
||||
_stopRendering();
|
||||
}
|
||||
|
||||
// A language change rebuilds the panel in the new language. It comes back
|
||||
// collapsed and on Automatic, as on a fresh selection.
|
||||
function _onLocaleChange() {
|
||||
if (!panel) return;
|
||||
_removePanel();
|
||||
_syncIssCommand();
|
||||
}
|
||||
|
||||
function _destroyIssCommand() {
|
||||
_removePanel();
|
||||
}
|
||||
|
||||
return { _syncIssCommand, _destroyIssCommand };
|
||||
}
|
||||
@@ -1,6 +1,9 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import test from 'node:test';
|
||||
import {
|
||||
issCommandCameraOnStation,
|
||||
issCommandZoomOffset,
|
||||
issCommandZoomRange,
|
||||
ISS_COMMAND_ZOOM_RANGE_M,
|
||||
issCommandFastOrbit,
|
||||
issCommandShouldShow,
|
||||
@@ -59,3 +62,118 @@ test('the status line says lit or in shadow, and nothing before the model is pla
|
||||
assert.ok(issCommandStatusText(true).length > 0);
|
||||
assert.ok(issCommandStatusText(false).length > 0);
|
||||
});
|
||||
|
||||
test('the note says whether the joints are computed or on live telemetry', async () => {
|
||||
const { issCommandNoteText } = await import('./issCommand.js');
|
||||
assert.match(issCommandNoteText(false), /Computed, not live telemetry/);
|
||||
assert.match(issCommandNoteText(true), /NASA's live telemetry/);
|
||||
assert.doesNotMatch(issCommandNoteText(true), /not live telemetry/);
|
||||
});
|
||||
|
||||
test('an object docked to the ISS is the station too', async () => {
|
||||
const { issTrackedOnStation } = await import('./policy.js');
|
||||
const NAUKA = 49044;
|
||||
// Tracking Nauka, the ISS shares its position; tracking the ISS needs nothing.
|
||||
assert.equal(issTrackedOnStation(ISS_NORAD, new Set()), true);
|
||||
assert.equal(issTrackedOnStation(ISS_NORAD, null), true);
|
||||
assert.equal(issTrackedOnStation(NAUKA, new Set([ISS_NORAD, 68837])), true);
|
||||
// Another satellite, with or without neighbours, is not.
|
||||
assert.equal(issTrackedOnStation(20580, new Set()), false);
|
||||
assert.equal(issTrackedOnStation(20580, new Set([20581])), false);
|
||||
assert.equal(issTrackedOnStation(null, new Set([ISS_NORAD])), false);
|
||||
assert.equal(issTrackedOnStation(undefined, undefined), false);
|
||||
|
||||
// The panels show for a docked object as for the ISS, on the same terms.
|
||||
const command = { enabled: true, trackedNorad: NAUKA, cockpitHeld: false };
|
||||
assert.equal(issCommandShouldShow(command), false);
|
||||
assert.equal(issCommandShouldShow({ ...command, docked: true }), true);
|
||||
assert.equal(
|
||||
issCommandShouldShow({ ...command, docked: true, cockpitHeld: true }),
|
||||
false,
|
||||
);
|
||||
assert.equal(
|
||||
issCommandShouldShow({ ...command, docked: true, trackedNorad: null }),
|
||||
false,
|
||||
);
|
||||
});
|
||||
|
||||
test('the zoom range only ever shortens, settles at the target range and never runs away', () => {
|
||||
let range = 1e9;
|
||||
let steps = 0;
|
||||
while (steps < 400) {
|
||||
const next = issCommandZoomRange(range);
|
||||
assert.ok(next <= range, `step ${steps} moved out: ${range} -> ${next}`);
|
||||
assert.ok(next >= ISS_COMMAND_ZOOM_RANGE_M, 'never past the target');
|
||||
if (next === range) break;
|
||||
range = next;
|
||||
steps += 1;
|
||||
}
|
||||
assert.ok(steps < 400, "settles within the loop's budget");
|
||||
assert.ok(range <= ISS_COMMAND_ZOOM_RANGE_M * 1.02);
|
||||
assert.equal(
|
||||
issCommandZoomRange(ISS_COMMAND_ZOOM_RANGE_M),
|
||||
ISS_COMMAND_ZOOM_RANGE_M,
|
||||
);
|
||||
assert.equal(
|
||||
issCommandZoomRange(100),
|
||||
100,
|
||||
'closer than the range: left alone',
|
||||
);
|
||||
for (const bad of [0, -5, NaN, Infinity])
|
||||
assert.ok(
|
||||
Object.is(issCommandZoomRange(bad), bad),
|
||||
`${bad} passes through`,
|
||||
);
|
||||
});
|
||||
|
||||
test('one zoom step shortens the follow offset on its own bearing, and stops at the range', () => {
|
||||
const next = issCommandZoomOffset({ x: 3000, y: 4000, z: 0 });
|
||||
const range = Math.hypot(next.x, next.y, next.z);
|
||||
assert.ok(Math.abs(range - issCommandZoomRange(5000)) < 1e-9);
|
||||
assert.ok(Math.abs(next.x / next.y - 3 / 4) < 1e-12, 'the bearing is kept');
|
||||
assert.equal(next.z, 0);
|
||||
// Already at the range, or closer: no step.
|
||||
assert.equal(
|
||||
issCommandZoomOffset({ x: ISS_COMMAND_ZOOM_RANGE_M, y: 0, z: 0 }),
|
||||
null,
|
||||
);
|
||||
assert.equal(issCommandZoomOffset({ x: 0, y: 100, z: 0 }), null);
|
||||
// Nothing to shorten: no follow offset yet (the follow has not framed).
|
||||
assert.equal(issCommandZoomOffset(null), null);
|
||||
assert.equal(issCommandZoomOffset(undefined), null);
|
||||
assert.equal(issCommandZoomOffset({ x: 0, y: 0, z: 0 }), null);
|
||||
});
|
||||
|
||||
test("the zoom needs the camera following the station's target, framed", () => {
|
||||
const target = { key: 'satellites:25544' };
|
||||
const on = { followed: target, followFramed: true };
|
||||
assert.equal(issCommandCameraOnStation(on, target), true);
|
||||
assert.equal(
|
||||
issCommandCameraOnStation(
|
||||
{ followed: target, followFramed: false },
|
||||
target,
|
||||
),
|
||||
false,
|
||||
'not before the follow has framed the eye',
|
||||
);
|
||||
assert.equal(
|
||||
issCommandCameraOnStation({ followed: null, followFramed: false }, target),
|
||||
false,
|
||||
);
|
||||
assert.equal(
|
||||
issCommandCameraOnStation(
|
||||
{ followed: { key: 'flights:a' }, followFramed: true },
|
||||
target,
|
||||
),
|
||||
false,
|
||||
'following something else',
|
||||
);
|
||||
assert.equal(issCommandCameraOnStation(null, target), false);
|
||||
assert.equal(issCommandCameraOnStation(undefined, target), false);
|
||||
assert.equal(issCommandCameraOnStation(on, null), false);
|
||||
assert.equal(
|
||||
issCommandCameraOnStation({ followed: null, followFramed: true }, null),
|
||||
false,
|
||||
'nothing followed and no target is not a match',
|
||||
);
|
||||
});
|
||||
@@ -1,213 +0,0 @@
|
||||
import { onLocaleChange, t } from '../../i18n/index.js';
|
||||
import { ISS_LIVE_VIDEO_ID, ISS_NORAD } from './policy.js';
|
||||
|
||||
/**
|
||||
* The player address for a YouTube video: the privacy-enhanced host the
|
||||
* page's frame-src allows, muted so the browser lets it start on its own.
|
||||
* @param {string} videoId
|
||||
* @returns {string}
|
||||
*/
|
||||
export function issLiveEmbedUrl(videoId) {
|
||||
const params = new URLSearchParams({
|
||||
autoplay: '1',
|
||||
mute: '1',
|
||||
playsinline: '1',
|
||||
rel: '0',
|
||||
});
|
||||
return `https://www.youtube-nocookie.com/embed/${encodeURIComponent(videoId)}?${params}`;
|
||||
}
|
||||
|
||||
/** The video's own page, for the "Open on YouTube" link. */
|
||||
export function issLiveWatchUrl(videoId) {
|
||||
return `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the live panel shows: the ISS selected (tracked), the layer on, the
|
||||
* Cockpit not riding it, and the viewer not having closed it for this pick.
|
||||
* @param {{enabled: boolean, trackedNorad: number|null, cockpitHeld: boolean,
|
||||
* dismissed: boolean}} input
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function issLiveShouldShow({
|
||||
enabled,
|
||||
trackedNorad,
|
||||
cockpitHeld,
|
||||
dismissed,
|
||||
}) {
|
||||
return (
|
||||
Boolean(enabled) && trackedNorad === ISS_NORAD && !cockpitHeld && !dismissed
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Drag a floating panel by its header, kept inside the window (as the Québec
|
||||
* player).
|
||||
* @param {HTMLElement} root
|
||||
* @param {HTMLElement} header
|
||||
*/
|
||||
export function makePanelDraggable(root, header) {
|
||||
header.addEventListener('pointerdown', (event) => {
|
||||
if (event.target.closest('button')) return;
|
||||
const rect = root.getBoundingClientRect();
|
||||
const offsetX = event.clientX - rect.left;
|
||||
const offsetY = event.clientY - rect.top;
|
||||
header.setPointerCapture?.(event.pointerId);
|
||||
const view = root.ownerDocument.defaultView;
|
||||
const move = (moveEvent) => {
|
||||
root.style.left = `${Math.max(0, Math.min(view.innerWidth - root.offsetWidth, moveEvent.clientX - offsetX))}px`;
|
||||
root.style.top = `${Math.max(0, Math.min(view.innerHeight - root.offsetHeight, moveEvent.clientY - offsetY))}px`;
|
||||
root.style.right = 'auto';
|
||||
root.style.bottom = 'auto';
|
||||
};
|
||||
const stop = () => {
|
||||
header.removeEventListener('pointermove', move);
|
||||
header.removeEventListener('pointerup', stop);
|
||||
header.removeEventListener('pointercancel', stop);
|
||||
};
|
||||
header.addEventListener('pointermove', move);
|
||||
header.addEventListener('pointerup', stop, { once: true });
|
||||
header.addEventListener('pointercancel', stop, { once: true });
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* NASA's live view from the ISS, in a panel beside the existing tracked card
|
||||
* while the ISS is selected. The player is created on show and removed on
|
||||
* hide, so nothing streams while the panel is closed.
|
||||
*/
|
||||
export function createIssLive({ state: layerState, parts }) {
|
||||
let panel = null;
|
||||
let dismissed = false;
|
||||
let lastTracked = null;
|
||||
/** Rewrites the open panel's text in the current language. */
|
||||
let reword = null;
|
||||
/** Stops listening for language changes; set while the panel is open. */
|
||||
let stopLocale = null;
|
||||
|
||||
/**
|
||||
* The project's floating video window (the Québec CCTV player,
|
||||
* src/ui/quebecCctvOverlay.js): its `qci-` classes, a header that drags it,
|
||||
* × and Escape to close, the source's credit, the privacy note and a link
|
||||
* to the provider's page.
|
||||
*/
|
||||
function _build(documentRef) {
|
||||
const root = documentRef.createElement('section');
|
||||
root.className = 'qci-panel iss-live-panel';
|
||||
root.setAttribute('role', 'region');
|
||||
// Worded again on a language change, without restarting the player.
|
||||
const word = [];
|
||||
const worded = (apply) => {
|
||||
word.push(apply);
|
||||
apply();
|
||||
};
|
||||
worded(() => root.setAttribute('aria-label', t('ISS live video')));
|
||||
|
||||
const header = documentRef.createElement('header');
|
||||
header.className = 'qci-header';
|
||||
const title = documentRef.createElement('strong');
|
||||
title.className = 'iss-live-title';
|
||||
const dotMark = documentRef.createElement('span');
|
||||
dotMark.className = 'iss-live-dot';
|
||||
dotMark.setAttribute('aria-hidden', 'true');
|
||||
const titleText = documentRef.createTextNode('');
|
||||
worded(() => (titleText.data = t('ISS LIVE · NASA')));
|
||||
title.append(dotMark, titleText);
|
||||
const close = documentRef.createElement('button');
|
||||
close.type = 'button';
|
||||
close.textContent = '×';
|
||||
worded(() => close.setAttribute('aria-label', t('Close ISS live video')));
|
||||
close.addEventListener('click', () => {
|
||||
dismissed = true;
|
||||
_syncIssLive();
|
||||
});
|
||||
header.append(title, close);
|
||||
|
||||
const iframe = documentRef.createElement('iframe');
|
||||
iframe.className = 'qci-live';
|
||||
iframe.src = issLiveEmbedUrl(ISS_LIVE_VIDEO_ID);
|
||||
worded(
|
||||
() =>
|
||||
(iframe.title = t(
|
||||
'Live views from the International Space Station (NASA)',
|
||||
)),
|
||||
);
|
||||
iframe.allow = 'autoplay; encrypted-media; picture-in-picture; fullscreen';
|
||||
iframe.allowFullscreen = true;
|
||||
iframe.referrerPolicy = 'strict-origin-when-cross-origin';
|
||||
iframe.loading = 'eager';
|
||||
|
||||
const credit = documentRef.createElement('p');
|
||||
credit.className = 'qci-credit';
|
||||
credit.textContent = 'NASA · YouTube'; // i18n-ignore: provider names
|
||||
const note = documentRef.createElement('p');
|
||||
note.className = 'qci-note';
|
||||
worded(
|
||||
() =>
|
||||
(note.textContent = t(
|
||||
'Video plays from YouTube, which sees your IP address.',
|
||||
)),
|
||||
);
|
||||
const link = documentRef.createElement('a');
|
||||
link.href = issLiveWatchUrl(ISS_LIVE_VIDEO_ID);
|
||||
link.target = '_blank';
|
||||
link.rel = 'noopener noreferrer';
|
||||
worded(() => (link.textContent = t('Open on YouTube')));
|
||||
reword = () => word.forEach((apply) => apply());
|
||||
|
||||
root.append(header, iframe, credit, note, link);
|
||||
root.addEventListener('keydown', (event) => {
|
||||
if (event.key === 'Escape') close.click();
|
||||
});
|
||||
makePanelDraggable(root, header);
|
||||
return root;
|
||||
}
|
||||
|
||||
/**
|
||||
* Show or hide the panel for the current selection. Cheap when nothing
|
||||
* changed, so the tracking and Cockpit paths can call it freely.
|
||||
* @returns {void}
|
||||
*/
|
||||
function _syncIssLive() {
|
||||
const tracked = layerState._trackedNorad;
|
||||
// A new pick of the ISS brings back a panel closed on an earlier one.
|
||||
if (tracked !== lastTracked) {
|
||||
dismissed = false;
|
||||
lastTracked = tracked;
|
||||
}
|
||||
const show = issLiveShouldShow({
|
||||
enabled: layerState._enabled,
|
||||
trackedNorad: tracked,
|
||||
cockpitHeld: Boolean(parts.cockpit?._cockpitHeld()),
|
||||
dismissed,
|
||||
});
|
||||
if (!show) {
|
||||
_removePanel();
|
||||
return;
|
||||
}
|
||||
if (panel) return;
|
||||
const documentRef = globalThis.document;
|
||||
if (!documentRef?.body) return;
|
||||
panel = _build(documentRef);
|
||||
documentRef.body.append(panel);
|
||||
stopLocale = onLocaleChange(() => reword?.());
|
||||
}
|
||||
|
||||
function _removePanel() {
|
||||
if (!panel) return;
|
||||
panel.remove(); // the player goes with it, so the stream stops
|
||||
panel = null;
|
||||
reword = null;
|
||||
stopLocale?.();
|
||||
stopLocale = null;
|
||||
}
|
||||
|
||||
/** Drop the panel and forget the selection (layer destroy). */
|
||||
function _destroyIssLive() {
|
||||
_removePanel();
|
||||
dismissed = false;
|
||||
lastTracked = null;
|
||||
}
|
||||
|
||||
return { _syncIssLive, _destroyIssLive };
|
||||
}
|
||||
+111
-422
@@ -1,6 +1,13 @@
|
||||
import * as Cesium from 'cesium';
|
||||
import { eciToGeodetic, gstime, propagate } from 'satellite.js';
|
||||
import { createIssArticulation } from './issArticulation.js';
|
||||
import {
|
||||
ISS_MOUNTS,
|
||||
ISS_NAUKA_NORAD,
|
||||
ISS_POISK_NORAD,
|
||||
issMountView,
|
||||
issMountViews,
|
||||
issMountWorld,
|
||||
} from './issMounts.js';
|
||||
import { createIssTelemetryFeed } from './issTelemetry.js';
|
||||
import {
|
||||
ISS_COMPANION_COARSE_M,
|
||||
ISS_COMPANION_RADIUS_M,
|
||||
@@ -15,441 +22,123 @@ import {
|
||||
ISS_ORBIT_HIDE_M,
|
||||
ISS_SPAN_M,
|
||||
} from './policy.js';
|
||||
import {
|
||||
createStationModel,
|
||||
stationFlightAxes,
|
||||
stationModelShouldShow,
|
||||
temeToEcefAxes,
|
||||
} from './stationModel.js';
|
||||
|
||||
/** The model's scale for the real 109 m truss. */
|
||||
export const ISS_MODEL_SCALE = ISS_SPAN_M / ISS_MODEL_NATIVE_SPAN;
|
||||
|
||||
// The station-independent rules live in stationModel.js; these names are
|
||||
// kept for the code and tests written against the ISS-only model.
|
||||
export { temeToEcefAxes };
|
||||
export const issFlightAxes = stationFlightAxes;
|
||||
|
||||
/**
|
||||
* Whether the ISS model may be drawn: the dot's own rules (layer on, points
|
||||
* on, the ISS loaded and its class shown or the ISS tracked), and not while
|
||||
* the Cockpit rides the ISS or hides it as a docked companion.
|
||||
* Whether the ISS model may be drawn (stationModelShouldShow with the ISS's
|
||||
* `hasIss` wording).
|
||||
* @param {{enabled: boolean, showPoints: boolean, hasIss: boolean,
|
||||
* classVisible: boolean, tracked: boolean, cockpitHidden: boolean}} input
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function issModelShouldShow({
|
||||
enabled,
|
||||
showPoints,
|
||||
hasIss,
|
||||
classVisible,
|
||||
tracked,
|
||||
cockpitHidden,
|
||||
}) {
|
||||
export function issModelShouldShow({ hasIss, ...rest }) {
|
||||
return stationModelShouldShow({ hasStation: hasIss, ...rest });
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether a catalog entry at the ISS is one of the station's own modules
|
||||
* (Zarya, Nauka, Poisk, or any other the catalog lists as "ISS (…)") rather
|
||||
* than a visiting vehicle. A missing entry counts as a module.
|
||||
* @param {number} noradId
|
||||
* @param {{name?: string}|undefined} entry
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function issIsModule(noradId, entry) {
|
||||
return (
|
||||
Boolean(enabled) &&
|
||||
Boolean(showPoints) &&
|
||||
Boolean(hasIss) &&
|
||||
(Boolean(classVisible) || Boolean(tracked)) &&
|
||||
!cockpitHidden
|
||||
noradId === ISS_NORAD ||
|
||||
noradId === ISS_NAUKA_NORAD ||
|
||||
noradId === ISS_POISK_NORAD ||
|
||||
/^ISS\s*\(/i.test(entry?.name ?? 'ISS (')
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* The station's flight axes in the Earth-fixed frame, from one SGP4 state:
|
||||
* the ISS normally flies "+XVV", its modules along the velocity, the truss
|
||||
* across the orbit plane, the same side always to the Earth. Returned as the
|
||||
* model's local axes: x along-track, y the orbit normal (along the truss), z
|
||||
* zenith (away from the Earth's centre).
|
||||
* @param {{x:number,y:number,z:number}} positionEcef Earth-fixed position.
|
||||
* @param {{x:number,y:number,z:number}} velocityEcefAxes Inertial velocity,
|
||||
* turned onto the Earth-fixed axes (direction only matters).
|
||||
* @returns {{x:number[], y:number[], z:number[]}|null} Unit vectors, or null
|
||||
* for a degenerate state (zero position or velocity along it).
|
||||
* The ISS as the station model factory describes it: NASA's model at the
|
||||
* real 109 m span, its joints on the Sun or NASA's telemetry, the Cockpit's
|
||||
* views from mounts on the model (so the model stays drawn in the Cockpit),
|
||||
* and its orbit ring, which has rules of its own (`_syncIssOrbit`).
|
||||
* @param {{parts: object}} context
|
||||
* @returns {import('./stationModel.js').StationModelSpec}
|
||||
*/
|
||||
export function issFlightAxes(positionEcef, velocityEcefAxes) {
|
||||
const r = [positionEcef.x, positionEcef.y, positionEcef.z];
|
||||
const v = [velocityEcefAxes.x, velocityEcefAxes.y, velocityEcefAxes.z];
|
||||
const z = unit(r);
|
||||
const y = unit(cross(r, v));
|
||||
if (!z || !y) return null;
|
||||
const x = cross(y, z);
|
||||
return { x, y, z };
|
||||
}
|
||||
|
||||
/**
|
||||
* Turn an inertial (TEME) vector onto the Earth-fixed axes at `gmst`: the same
|
||||
* rotation `eciToGeodetic` applies to the position.
|
||||
* @param {{x:number,y:number,z:number}} v
|
||||
* @param {number} gmst Radians.
|
||||
* @returns {{x:number,y:number,z:number}}
|
||||
*/
|
||||
export function temeToEcefAxes(v, gmst) {
|
||||
const c = Math.cos(gmst);
|
||||
const s = Math.sin(gmst);
|
||||
return { x: c * v.x + s * v.y, y: -s * v.x + c * v.y, z: v.z };
|
||||
}
|
||||
|
||||
function cross(a, b) {
|
||||
return [
|
||||
a[1] * b[2] - a[2] * b[1],
|
||||
a[2] * b[0] - a[0] * b[2],
|
||||
a[0] * b[1] - a[1] * b[0],
|
||||
];
|
||||
}
|
||||
|
||||
function unit(a) {
|
||||
const n = Math.hypot(a[0], a[1], a[2]);
|
||||
if (!(n > 0)) return null;
|
||||
return [a[0] / n, a[1] / n, a[2] / n];
|
||||
}
|
||||
|
||||
/**
|
||||
* The ISS as a 3D model when the camera is close. Far out the dot stays: the
|
||||
* model and the dot (ambient and tracked) split the distance range, so exactly
|
||||
* one of them draws. The model loads on first need and only if the ISS is
|
||||
* shown, and positions itself every frame from its own SGP4 sample (the dot
|
||||
* moves once a second, which at model range would show as a jump).
|
||||
*/
|
||||
export function createIssModel({ state: layerState, parts, resolveAsset }) {
|
||||
let model = null;
|
||||
let loading = false;
|
||||
let failed = false;
|
||||
let generation = 0;
|
||||
/** Turns the solar arrays and radiators by where the Sun is. */
|
||||
const articulation = createIssArticulation();
|
||||
const nearCondition = new Cesium.DistanceDisplayCondition(
|
||||
0,
|
||||
ISS_MODEL_MAX_DISTANCE_M,
|
||||
);
|
||||
const farCondition = new Cesium.DistanceDisplayCondition(
|
||||
ISS_MODEL_MAX_DISTANCE_M,
|
||||
Number.MAX_VALUE,
|
||||
);
|
||||
/** @type {Set<number>} Docked objects whose dots the model stands in for. */
|
||||
const handedCompanions = new Set();
|
||||
let lastCompanionScanMs = Number.NEGATIVE_INFINITY;
|
||||
/** Whether the ISS's orbit ring is hidden for the close-up. */
|
||||
let orbitHidden = false;
|
||||
const scratchPosition = new Cesium.Cartesian3();
|
||||
/** The station centre the model last rendered at (for the tracked card). */
|
||||
const visualPosition = new Cesium.Cartesian3();
|
||||
let visualValid = false;
|
||||
const scratchRotation = new Cesium.Matrix3();
|
||||
const scratchColumn = new Cesium.Cartesian3();
|
||||
|
||||
function _shouldShow() {
|
||||
const tracked = layerState._trackedNorad === ISS_NORAD;
|
||||
return issModelShouldShow({
|
||||
enabled: layerState._enabled,
|
||||
showPoints: layerState._params.showPoints,
|
||||
hasIss: layerState._catalog.has(ISS_NORAD),
|
||||
classVisible: parts.controls._classVisible(ISS_NORAD),
|
||||
tracked,
|
||||
cockpitHidden:
|
||||
(tracked && parts.cockpit?._cockpitHeld()) ||
|
||||
layerState._cockpitHiddenPoints?.has(ISS_NORAD),
|
||||
});
|
||||
}
|
||||
|
||||
async function _load() {
|
||||
loading = true;
|
||||
const loadGeneration = generation;
|
||||
try {
|
||||
const loaded = await Cesium.Model.fromGltfAsync({
|
||||
url: resolveAsset(ISS_MODEL_URL),
|
||||
scale: ISS_MODEL_SCALE,
|
||||
minimumPixelSize: ISS_MODEL_MIN_PX,
|
||||
distanceDisplayCondition: nearCondition,
|
||||
// So a click on the model tracks the ISS, as a click on its dot does.
|
||||
id: ISS_NORAD,
|
||||
show: false,
|
||||
});
|
||||
const viewer = layerState._viewer;
|
||||
if (loadGeneration !== generation || !viewer) {
|
||||
loaded.destroy();
|
||||
return;
|
||||
}
|
||||
viewer.scene.primitives.add(loaded);
|
||||
model = loaded;
|
||||
} catch (error) {
|
||||
// The dot keeps drawing at every distance; nothing else depends on this.
|
||||
failed = true;
|
||||
console.warn('[Data:Satellites] ISS model failed to load:', error);
|
||||
} finally {
|
||||
if (loadGeneration === generation) loading = false;
|
||||
}
|
||||
}
|
||||
|
||||
/** An object's inertial position at `date`, km, or null. */
|
||||
function _temeKm(satrec, date) {
|
||||
if (!satrec) return null;
|
||||
try {
|
||||
const position = propagate(satrec, date)?.position;
|
||||
return position && typeof position !== 'boolean' ? position : null;
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/** Leave the near range to the model: the dots draw only beyond it. */
|
||||
function _handOverDots() {
|
||||
const point = layerState._points.get(ISS_NORAD);
|
||||
if (point && point.distanceDisplayCondition !== farCondition)
|
||||
point.distanceDisplayCondition = farCondition;
|
||||
const dot =
|
||||
layerState._trackedNorad === ISS_NORAD
|
||||
? layerState._trackedEntity?.point
|
||||
: null;
|
||||
if (dot && !dot.distanceDisplayCondition)
|
||||
dot.distanceDisplayCondition = farCondition;
|
||||
}
|
||||
|
||||
/**
|
||||
* Objects docked to the ISS (Nauka, a Soyuz, a Dragon…) have dots of their
|
||||
* own at the station's position. Near the model they are part of it, and
|
||||
* their dots, moved only a few times a second, jump across the model at
|
||||
* 7.6 km/s. While the model shows, their dots draw only beyond its range
|
||||
* too. Rescanned once a second: a vehicle that undocks gets its dot back,
|
||||
* and a catalog rebuild's new dots are picked up.
|
||||
* @param {number} nowMs
|
||||
*/
|
||||
function _handOverCompanions(nowMs) {
|
||||
if (nowMs - lastCompanionScanMs < ISS_COMPANION_SCAN_MS) return;
|
||||
lastCompanionScanMs = nowMs;
|
||||
const issPosition = layerState._points.get(ISS_NORAD)?.position;
|
||||
// The dots are placed at different moments (far apart with the clock sped
|
||||
// up), so their spacing only rules out what is nowhere near. Whether an
|
||||
// object is docked is read from both orbits at one instant.
|
||||
const date = new Date(layerState.now());
|
||||
const issTeme = _temeKm(layerState._catalog.get(ISS_NORAD)?.satrec, date);
|
||||
if (!issPosition || !issTeme) return;
|
||||
for (const [noradId, point] of layerState._points) {
|
||||
if (noradId === ISS_NORAD || !point?.position) continue;
|
||||
const entry = layerState._catalog.get(noradId);
|
||||
if (entry?.group === 'dense') continue;
|
||||
let docked = false;
|
||||
if (
|
||||
Cesium.Cartesian3.distance(point.position, issPosition) <=
|
||||
ISS_COMPANION_COARSE_M
|
||||
) {
|
||||
const teme = _temeKm(entry?.satrec, date);
|
||||
docked =
|
||||
Boolean(teme) &&
|
||||
Math.hypot(
|
||||
teme.x - issTeme.x,
|
||||
teme.y - issTeme.y,
|
||||
teme.z - issTeme.z,
|
||||
) *
|
||||
1000 <=
|
||||
ISS_COMPANION_RADIUS_M;
|
||||
}
|
||||
if (docked) {
|
||||
point.distanceDisplayCondition = farCondition; // no-op when equal
|
||||
handedCompanions.add(noradId);
|
||||
} else if (handedCompanions.has(noradId)) {
|
||||
point.distanceDisplayCondition = undefined;
|
||||
handedCompanions.delete(noradId);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** Give docked objects their dots back at every distance. */
|
||||
function _releaseCompanions() {
|
||||
for (const noradId of handedCompanions) {
|
||||
const point = layerState._points.get(noradId);
|
||||
if (point) point.distanceDisplayCondition = undefined;
|
||||
}
|
||||
handedCompanions.clear();
|
||||
lastCompanionScanMs = Number.NEGATIVE_INFINITY;
|
||||
}
|
||||
|
||||
/**
|
||||
* Up close the orbit ring (polyline chords, turned once a second) runs off
|
||||
* the model and jumps across it, so it is hidden there.
|
||||
* @param {boolean} near Camera within ISS_ORBIT_HIDE_M of the station.
|
||||
*/
|
||||
function _syncOrbitCloseUp(near) {
|
||||
const path = layerState._orbitPaths.get(ISS_NORAD);
|
||||
if (near) {
|
||||
if (path) path.primitive.show = false;
|
||||
orbitHidden = true;
|
||||
} else if (orbitHidden) {
|
||||
orbitHidden = false;
|
||||
// Back to the ring's own rules, unless the Cockpit holds it hidden.
|
||||
if (layerState._cockpitHiddenPath !== ISS_NORAD)
|
||||
parts.controls._syncIssOrbit?.();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Per-frame update from the layer's preRender tick.
|
||||
* @returns {void}
|
||||
*/
|
||||
function _updateIssModel() {
|
||||
visualValid = false;
|
||||
const show = _shouldShow();
|
||||
if (!show) {
|
||||
if (model) model.show = false;
|
||||
if (handedCompanions.size) _releaseCompanions();
|
||||
_syncOrbitCloseUp(false);
|
||||
return;
|
||||
}
|
||||
const point = layerState._points.get(ISS_NORAD);
|
||||
const camera = layerState._viewer?.camera;
|
||||
const cameraDistance =
|
||||
point?.position && camera
|
||||
? Cesium.Cartesian3.distance(camera.positionWC, point.position)
|
||||
: Number.POSITIVE_INFINITY;
|
||||
if (!model) {
|
||||
// The file is fetched only once the camera nears the model's range, so
|
||||
// a globe-wide view of the layer never downloads it.
|
||||
if (
|
||||
!loading &&
|
||||
!failed &&
|
||||
resolveAsset &&
|
||||
cameraDistance <= ISS_MODEL_MAX_DISTANCE_M * 1.5
|
||||
)
|
||||
_load();
|
||||
return;
|
||||
}
|
||||
_handOverDots();
|
||||
_handOverCompanions(Date.now());
|
||||
_syncOrbitCloseUp(cameraDistance < ISS_ORBIT_HIDE_M);
|
||||
// Out of range the model would not draw anyway: skip the SGP4 sample.
|
||||
if (cameraDistance > ISS_MODEL_MAX_DISTANCE_M * 1.5) {
|
||||
model.show = false;
|
||||
return;
|
||||
}
|
||||
|
||||
const sat = layerState._catalog.get(ISS_NORAD);
|
||||
const trackedSample =
|
||||
layerState._trackedNorad === ISS_NORAD &&
|
||||
Number.isFinite(layerState._trackedFrameGeo?.atMs)
|
||||
? layerState._trackedFrameGeo
|
||||
: null;
|
||||
const date = new Date(
|
||||
trackedSample ? trackedSample.atMs : layerState.now(),
|
||||
);
|
||||
let posVel;
|
||||
try {
|
||||
posVel = propagate(sat.satrec, date);
|
||||
} catch {
|
||||
posVel = null;
|
||||
}
|
||||
if (
|
||||
!posVel?.position ||
|
||||
typeof posVel.position === 'boolean' ||
|
||||
!posVel.velocity ||
|
||||
typeof posVel.velocity === 'boolean'
|
||||
) {
|
||||
model.show = false;
|
||||
return;
|
||||
}
|
||||
const gmst = gstime(date);
|
||||
if (trackedSample) {
|
||||
// The sample the follow camera and the tracked dot were placed from.
|
||||
Cesium.Cartesian3.clone(
|
||||
layerState._trackedFrameCartesian,
|
||||
scratchPosition,
|
||||
);
|
||||
} else {
|
||||
const geo = eciToGeodetic(posVel.position, gmst);
|
||||
Cesium.Cartesian3.fromRadians(
|
||||
geo.longitude,
|
||||
geo.latitude,
|
||||
geo.height * 1000,
|
||||
undefined,
|
||||
scratchPosition,
|
||||
);
|
||||
}
|
||||
Cesium.Cartesian3.clone(scratchPosition, visualPosition);
|
||||
const axes = issFlightAxes(
|
||||
scratchPosition,
|
||||
temeToEcefAxes(posVel.velocity, gmst),
|
||||
);
|
||||
if (!axes) {
|
||||
model.show = false;
|
||||
return;
|
||||
}
|
||||
ISS_MODEL_LOCAL_AXES.forEach((key, column) => {
|
||||
scratchColumn.x = axes[key][0];
|
||||
scratchColumn.y = axes[key][1];
|
||||
scratchColumn.z = axes[key][2];
|
||||
Cesium.Matrix3.setColumn(
|
||||
scratchRotation,
|
||||
column,
|
||||
scratchColumn,
|
||||
scratchRotation,
|
||||
);
|
||||
});
|
||||
Cesium.Matrix4.fromRotationTranslation(
|
||||
scratchRotation,
|
||||
scratchPosition,
|
||||
model.modelMatrix,
|
||||
);
|
||||
articulation.update(model, date, scratchPosition, axes);
|
||||
model.show = true;
|
||||
visualValid = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the tracked card should anchor: the station centre the model is
|
||||
* rendering at this frame, or null while the model is not drawn (the card
|
||||
* then keeps the dot's position). Up close the dot's cache can be a frame
|
||||
* ahead of the rendered model, ~130 m of orbit, which shook the card.
|
||||
* @returns {Cesium.Cartesian3|null}
|
||||
*/
|
||||
function _issVisualPosition() {
|
||||
if (!visualValid || !model?.show) return null;
|
||||
const camera = layerState._viewer?.camera;
|
||||
if (
|
||||
camera &&
|
||||
Cesium.Cartesian3.distance(camera.positionWC, visualPosition) >
|
||||
ISS_MODEL_MAX_DISTANCE_M
|
||||
)
|
||||
return null;
|
||||
return visualPosition;
|
||||
}
|
||||
|
||||
/**
|
||||
* How far the tracked card must stay from its anchor to clear the model, in
|
||||
* pixels, or null while the dot shows.
|
||||
*/
|
||||
function _issCardClearPx() {
|
||||
const position = _issVisualPosition();
|
||||
const viewer = layerState._viewer;
|
||||
const camera = viewer?.camera;
|
||||
const height = viewer?.scene?.canvas?.clientHeight;
|
||||
const fovy = camera?.frustum?.fovy;
|
||||
if (!position || !height || !fovy) return null;
|
||||
const distance = Cesium.Cartesian3.distance(camera.positionWC, position);
|
||||
if (!(distance > 0)) return null;
|
||||
const pixelsPerMeter = height / (2 * Math.tan(fovy / 2)) / distance;
|
||||
return Math.min(
|
||||
height * 0.45,
|
||||
Math.max(ISS_MODEL_MIN_PX * 0.35, ISS_CARD_CLEAR_M * pixelsPerMeter),
|
||||
);
|
||||
}
|
||||
|
||||
function _destroyIssModel() {
|
||||
generation += 1;
|
||||
loading = false;
|
||||
failed = false;
|
||||
visualValid = false;
|
||||
articulation.reset();
|
||||
_releaseCompanions();
|
||||
_syncOrbitCloseUp(false);
|
||||
if (model) {
|
||||
const scene = layerState._viewer?.scene;
|
||||
if (scene && scene.primitives.contains(model))
|
||||
scene.primitives.remove(model); // remove() destroys
|
||||
else if (!model.isDestroyed()) model.destroy();
|
||||
model = null;
|
||||
}
|
||||
}
|
||||
|
||||
/** Whether the model is standing in for this docked object's dot. */
|
||||
function _issStandsInFor(noradId) {
|
||||
return handedCompanions.has(noradId) && _issVisualPosition() !== null;
|
||||
}
|
||||
|
||||
export function issModelSpec({ parts }) {
|
||||
return {
|
||||
_updateIssModel,
|
||||
_destroyIssModel,
|
||||
_issVisualPosition,
|
||||
_issCardClearPx,
|
||||
_issStandsInFor,
|
||||
/** The joint driver, for the command panel. */
|
||||
_issArticulation: articulation,
|
||||
key: 'iss',
|
||||
label: 'ISS', // i18n-ignore: the station's name, for log lines
|
||||
norad: ISS_NORAD,
|
||||
modelUrl: ISS_MODEL_URL,
|
||||
scale: ISS_MODEL_SCALE,
|
||||
minPx: ISS_MODEL_MIN_PX,
|
||||
maxDistanceM: ISS_MODEL_MAX_DISTANCE_M,
|
||||
orbitHideM: ISS_ORBIT_HIDE_M,
|
||||
cardClearM: ISS_CARD_CLEAR_M,
|
||||
companionRadiusM: ISS_COMPANION_RADIUS_M,
|
||||
companionCoarseM: ISS_COMPANION_COARSE_M,
|
||||
companionScanMs: ISS_COMPANION_SCAN_MS,
|
||||
localAxes: ISS_MODEL_LOCAL_AXES,
|
||||
isModule: issIsModule,
|
||||
createArticulation: createIssArticulation,
|
||||
createTelemetry: createIssTelemetryFeed,
|
||||
/**
|
||||
* One of the views on the model (issMounts.js), in the world.
|
||||
* `noradId` on the result is the catalog entry the view belongs to.
|
||||
*/
|
||||
cockpitMount: ({ key, centre, axes, name, entry, dockedVehicle }) => {
|
||||
const views = issMountViews({
|
||||
naukaName: name(ISS_NAUKA_NORAD),
|
||||
zaryaName: name(ISS_NORAD),
|
||||
poiskName: name(ISS_POISK_NORAD),
|
||||
dockedName: name(dockedVehicle),
|
||||
naukaNorad: entry(ISS_NAUKA_NORAD),
|
||||
zaryaNorad: entry(ISS_NORAD),
|
||||
poiskNorad: entry(ISS_POISK_NORAD),
|
||||
dockedNorad: entry(dockedVehicle),
|
||||
});
|
||||
const view = issMountView(views, key);
|
||||
return {
|
||||
...issMountWorld(ISS_MOUNTS[view.key], centre, axes),
|
||||
key: view.key,
|
||||
label: view.label,
|
||||
noradId: view.noradId,
|
||||
card: view.card,
|
||||
views,
|
||||
};
|
||||
},
|
||||
// The Cockpit rides the station from a mount on the model, so the model
|
||||
// stays while it does.
|
||||
hideInCockpit: false,
|
||||
syncOrbit: () => parts.controls._syncIssOrbit?.(),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The ISS as a 3D model when the camera is close (stationModel.js), with the
|
||||
* part's methods also under their former ISS-only names.
|
||||
* @param {{state: object, parts: object, resolveAsset?: (url: string) => string}} context
|
||||
*/
|
||||
export function createIssModel(context) {
|
||||
const model = createStationModel(issModelSpec(context), context);
|
||||
return {
|
||||
...model,
|
||||
_updateIssModel: model._updateStationModel,
|
||||
_destroyIssModel: model._destroyStationModel,
|
||||
_issVisualPosition: model._visualPosition,
|
||||
_issCardClearPx: model._cardClearPx,
|
||||
_issStandsInFor: model._standsInFor,
|
||||
_issCockpitMount: model._cockpitMount,
|
||||
_issTelemetryStatus: model._telemetryStatus,
|
||||
_issArticulation: model._articulation,
|
||||
};
|
||||
}
|
||||
@@ -151,94 +151,3 @@ test('TEME to Earth-fixed axes keeps the position eciToGeodetic uses', () => {
|
||||
assert.ok(Math.abs(v.x) < 1e-12);
|
||||
assert.ok(Math.abs(v.y + 1) < 1e-12);
|
||||
});
|
||||
|
||||
test('the ISS live panel follows the ISS selection', async () => {
|
||||
const { issLiveShouldShow } = await import('./issLive.js');
|
||||
const base = {
|
||||
enabled: true,
|
||||
trackedNorad: ISS_NORAD,
|
||||
cockpitHeld: false,
|
||||
dismissed: false,
|
||||
};
|
||||
assert.equal(issLiveShouldShow(base), true);
|
||||
assert.equal(issLiveShouldShow({ ...base, trackedNorad: 48274 }), false);
|
||||
assert.equal(issLiveShouldShow({ ...base, trackedNorad: null }), false);
|
||||
assert.equal(issLiveShouldShow({ ...base, enabled: false }), false);
|
||||
assert.equal(issLiveShouldShow({ ...base, cockpitHeld: true }), false);
|
||||
assert.equal(issLiveShouldShow({ ...base, dismissed: true }), false);
|
||||
});
|
||||
|
||||
test("the ISS live player is NASA's stream on the privacy-enhanced host", async () => {
|
||||
const { issLiveEmbedUrl, issLiveWatchUrl } = await import('./issLive.js');
|
||||
const { ISS_LIVE_VIDEO_ID } = await import('./policy.js');
|
||||
const embed = new URL(issLiveEmbedUrl(ISS_LIVE_VIDEO_ID));
|
||||
assert.equal(embed.origin, 'https://www.youtube-nocookie.com');
|
||||
assert.equal(embed.pathname, `/embed/${ISS_LIVE_VIDEO_ID}`);
|
||||
// Muted, or the browser will not start it on its own.
|
||||
assert.equal(embed.searchParams.get('mute'), '1');
|
||||
assert.equal(embed.searchParams.get('autoplay'), '1');
|
||||
assert.equal(
|
||||
issLiveWatchUrl(ISS_LIVE_VIDEO_ID),
|
||||
`https://www.youtube.com/watch?v=${ISS_LIVE_VIDEO_ID}`,
|
||||
);
|
||||
});
|
||||
|
||||
test('live iframe follows selection, dismissal, cockpit and locale', async (t) => {
|
||||
const { installVueDom } = await import('../../testSupport/vueDom.mjs');
|
||||
const { getLocale, setLocale } = await import('../../i18n/index.js');
|
||||
const { createIssLive } = await import('./issLive.js');
|
||||
const originalLocale = getLocale();
|
||||
const uninstall = installVueDom();
|
||||
const state = { _enabled: true, _trackedNorad: null };
|
||||
let cockpitHeld = false;
|
||||
const live = createIssLive({
|
||||
state,
|
||||
parts: { cockpit: { _cockpitHeld: () => cockpitHeld } },
|
||||
});
|
||||
t.after(() => {
|
||||
live._destroyIssLive();
|
||||
setLocale(originalLocale);
|
||||
uninstall();
|
||||
});
|
||||
|
||||
const player = () => document.querySelector('.iss-live-panel iframe');
|
||||
assert.equal(player(), null);
|
||||
state._trackedNorad = ISS_NORAD;
|
||||
live._syncIssLive();
|
||||
const first = player();
|
||||
assert.ok(first);
|
||||
assert.equal(
|
||||
new URL(first.src).origin,
|
||||
'https://www.youtube-nocookie.com',
|
||||
);
|
||||
|
||||
// Per-frame sync and language changes must not restart a live player.
|
||||
live._syncIssLive();
|
||||
assert.equal(player(), first);
|
||||
setLocale(originalLocale === 'fr' ? 'es' : 'fr');
|
||||
assert.equal(player(), first);
|
||||
assert.equal(document.querySelectorAll('.iss-live-panel iframe').length, 1);
|
||||
|
||||
// Dismissal stays in effect for this selection; another selection resets it.
|
||||
document.querySelector('.iss-live-panel .qci-header button').click();
|
||||
assert.equal(player(), null);
|
||||
live._syncIssLive();
|
||||
assert.equal(player(), null);
|
||||
state._trackedNorad = null;
|
||||
live._syncIssLive();
|
||||
state._trackedNorad = ISS_NORAD;
|
||||
live._syncIssLive();
|
||||
assert.ok(player());
|
||||
assert.notEqual(player(), first);
|
||||
|
||||
// The embedded stream is released whenever its owner stops showing it.
|
||||
cockpitHeld = true;
|
||||
live._syncIssLive();
|
||||
assert.equal(player(), null);
|
||||
cockpitHeld = false;
|
||||
live._syncIssLive();
|
||||
assert.ok(player());
|
||||
state._enabled = false;
|
||||
live._syncIssLive();
|
||||
assert.equal(player(), null);
|
||||
});
|
||||
@@ -0,0 +1,257 @@
|
||||
import { msg } from '../../i18n/index.js';
|
||||
|
||||
/**
|
||||
* Where the Cockpit camera sits when it rides the station. The ISS has
|
||||
* several catalog entries that are one body (the ISS itself, listed under
|
||||
* Zarya, its first module; Nauka; whatever vehicle is docked). Riding any of
|
||||
* them looks out from a point on its 3D model, away from the station, in
|
||||
* place of the straight-down picture every other satellite has, and the
|
||||
* Cockpit steps between the views: from Nauka, from Zarya, from Poisk, from
|
||||
* the Cupola, from Kibo, from a docked vehicle. Each looks outward, in a direction of its own, and the
|
||||
* arrows turn the view from there. From this height the Earth's limb is 20°
|
||||
* below level: a view 30° down has it across its upper part.
|
||||
*
|
||||
* The points were chosen by casting rays across the view against the model
|
||||
* at rest: each is over a meter clear of every surface, and at most a tenth
|
||||
* of its frame meets the station, none of it nearer than 12 m.
|
||||
*
|
||||
* Points and directions are on the model's axes in meters (X port, Y zenith,
|
||||
* Z forward), from the model's origin: the frame the file's nodes sit in.
|
||||
*/
|
||||
|
||||
/**
|
||||
* The station's modules that have catalog entries of their own, beside the
|
||||
* ISS's (ISS_NORAD in policy.js, listed as "ISS (ZARYA)"): Nauka and Poisk.
|
||||
*/
|
||||
export const ISS_NAUKA_NORAD = 49044;
|
||||
export const ISS_POISK_NORAD = 36086;
|
||||
|
||||
const mount = (eye, forward, up) =>
|
||||
Object.freeze({
|
||||
eye: Object.freeze(eye),
|
||||
forward: Object.freeze(forward),
|
||||
up: Object.freeze(up),
|
||||
});
|
||||
|
||||
export const ISS_MOUNTS = Object.freeze({
|
||||
/**
|
||||
* Nauka hangs below Zvezda, pointing at the Earth: from the port side of
|
||||
* its lower end, looking out ahead of the station to port and down.
|
||||
*/
|
||||
nauka: mount([3.03, -12, -24.25], [0.75, -0.5, 0.43], [0, 1, 0]),
|
||||
/**
|
||||
* Zarya lies along the station's long axis, docked at both ends, so it
|
||||
* looks out sideways: from its port side, out across the track and down.
|
||||
*/
|
||||
zarya: mount([3.38, 2.96, -22], [0.87, -0.5, 0], [0, 1, 0]),
|
||||
/**
|
||||
* Poisk stands on top of Zvezda, pointing away from the Earth: from the
|
||||
* top of it, looking out behind the station to starboard, the limb across
|
||||
* the middle of the frame.
|
||||
*/
|
||||
poisk: mount([-1.27, 12, -27.27], [-0.66, -0.34, -0.66], [0, 1, 0]),
|
||||
/**
|
||||
* A docked vehicle (a Progress, a Soyuz, a Dragon): the catalog does not
|
||||
* say which port it is on, so it takes the place of one on Zvezda's aft
|
||||
* port, the most used: looking out behind the station and down, the Earth
|
||||
* falling away.
|
||||
*/
|
||||
docked: mount([0, 2.05, -41.5], [0, -0.5, -0.87], [0, 1, 0]),
|
||||
/**
|
||||
* The Cupola, on Tranquility's Earth-facing port: from just below it,
|
||||
* looking aft along the station and down, the Russian segment (Zvezda,
|
||||
* Nauka, the docked vehicles) in the corner and the Earth beyond.
|
||||
*/
|
||||
cupola: mount([8.3, -3.2, -4.9], [0, -0.5, -0.87], [0, 1, 0]),
|
||||
/**
|
||||
* Kibo, on Harmony's port side: its two windows are on its port end, above
|
||||
* the airlock. From just outside them, looking out to port and down over
|
||||
* the Exposed Facility, the Earth beyond it. The port solar arrays turn
|
||||
* through this view as they follow the Sun, as they do past the windows.
|
||||
*/
|
||||
kibo: mount([15.4, 4.2, 11], [0.81, -0.5, -0.3], [0, 1, 0]),
|
||||
});
|
||||
|
||||
/**
|
||||
* The card a view shows in place of its catalog entry's, for a module the
|
||||
* catalog has no entry for. Its texts are marked for translation; the name
|
||||
* is the module's, as catalog names are.
|
||||
*/
|
||||
export const ISS_MOUNT_CARDS = Object.freeze({
|
||||
cupola: Object.freeze({
|
||||
name: 'CUPOLA',
|
||||
classLabel: msg('OBSERVATION MODULE · ISS'),
|
||||
operator: msg('European Space Agency (ESA)'),
|
||||
facts: Object.freeze([
|
||||
msg('7 WINDOWS'),
|
||||
msg('LAUNCHED 8 FEB 2010 · STS-130'),
|
||||
msg('TRANQUILITY · EARTH-FACING PORT'),
|
||||
]),
|
||||
}),
|
||||
kibo: Object.freeze({
|
||||
name: 'KIBO',
|
||||
classLabel: msg('LABORATORY MODULE · ISS'),
|
||||
operator: msg('Japan Aerospace Exploration Agency (JAXA)'),
|
||||
facts: Object.freeze([
|
||||
msg('2 WINDOWS'),
|
||||
msg('LAUNCHED 31 MAY 2008 · STS-124'),
|
||||
msg('HARMONY · PORT SIDE'),
|
||||
]),
|
||||
}),
|
||||
});
|
||||
|
||||
/**
|
||||
* The views in the order the Cockpit steps through them. The first is the
|
||||
* one it opens on, whichever of the station's entries was selected.
|
||||
*/
|
||||
export const ISS_MOUNT_ORDER = Object.freeze([
|
||||
'nauka',
|
||||
'zarya',
|
||||
'poisk',
|
||||
'cupola',
|
||||
'kibo',
|
||||
'docked',
|
||||
]);
|
||||
|
||||
/**
|
||||
* The views the station offers now, in ISS_MOUNT_ORDER. Nauka, Zarya and
|
||||
* Poisk are part of the model, so they are always there; the docked-vehicle
|
||||
* view is offered only while a vehicle is docked, under that vehicle's name.
|
||||
* Each view names the catalog entry it belongs to (the ISS itself for
|
||||
* Zarya), so the Cockpit can ride that entry and its card describe it; null
|
||||
* when the catalog has no entry for it. The Cupola and Kibo have none: they
|
||||
* ride the ISS's and carry cards of their own (ISS_MOUNT_CARDS).
|
||||
* @param {{naukaName?: string|null, zaryaName?: string|null,
|
||||
* poiskName?: string|null, dockedName?: string|null,
|
||||
* naukaNorad?: number|null, zaryaNorad?: number|null,
|
||||
* poiskNorad?: number|null, dockedNorad?: number|null}} [entries]
|
||||
* Catalog names (e.g. "ISS (NAUKA)") and numbers.
|
||||
* @returns {Array<{key: 'nauka'|'zarya'|'poisk'|'cupola'|'kibo'|'docked',
|
||||
* label: string, noradId: number|null, card: object|null}>}
|
||||
*/
|
||||
export function issMountViews({
|
||||
naukaName,
|
||||
zaryaName,
|
||||
poiskName,
|
||||
dockedName,
|
||||
naukaNorad = null,
|
||||
zaryaNorad = null,
|
||||
poiskNorad = null,
|
||||
dockedNorad = null,
|
||||
} = {}) {
|
||||
const labels = {
|
||||
nauka: issMountLabel(naukaName) || 'NAUKA',
|
||||
zarya: issMountLabel(zaryaName) || 'ZARYA',
|
||||
poisk: issMountLabel(poiskName) || 'POISK',
|
||||
cupola: ISS_MOUNT_CARDS.cupola.name,
|
||||
kibo: ISS_MOUNT_CARDS.kibo.name,
|
||||
docked: issMountLabel(dockedName),
|
||||
};
|
||||
const entries = {
|
||||
nauka: naukaNorad,
|
||||
zarya: zaryaNorad,
|
||||
poisk: poiskNorad,
|
||||
cupola: zaryaNorad,
|
||||
kibo: zaryaNorad,
|
||||
docked: dockedNorad,
|
||||
};
|
||||
return ISS_MOUNT_ORDER.filter((key) => labels[key]).map((key) => ({
|
||||
key,
|
||||
label: labels[key],
|
||||
noradId: Number.isFinite(entries[key]) ? entries[key] : null,
|
||||
card: ISS_MOUNT_CARDS[key] ?? null,
|
||||
}));
|
||||
}
|
||||
|
||||
/**
|
||||
* The view to show: the one asked for while it is on offer, else the first.
|
||||
* @param {Array<{key: string, label: string}>} views From issMountViews.
|
||||
* @param {string|null|undefined} key
|
||||
* @returns {{key: string, label: string}}
|
||||
*/
|
||||
export function issMountView(views, key) {
|
||||
return views.find((view) => view.key === key) ?? views[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* The view after the current one, wrapping round; null with fewer than two.
|
||||
* @param {Array<{key: string, label: string}>} views
|
||||
* @param {string|null|undefined} key The current view.
|
||||
* @returns {{key: string, label: string}|null}
|
||||
*/
|
||||
export function issNextMountView(views, key) {
|
||||
if (!Array.isArray(views) || views.length < 2) return null;
|
||||
const index = views.findIndex((view) => view.key === key);
|
||||
return views[(index + 1) % views.length];
|
||||
}
|
||||
|
||||
/**
|
||||
* The view before the current one, wrapping round; null with fewer than two.
|
||||
* An unknown current view steps back to the last.
|
||||
* @param {Array<{key: string, label: string}>} views
|
||||
* @param {string|null|undefined} key The current view.
|
||||
* @returns {{key: string, label: string}|null}
|
||||
*/
|
||||
export function issPreviousMountView(views, key) {
|
||||
if (!Array.isArray(views) || views.length < 2) return null;
|
||||
const index = views.findIndex((view) => view.key === key);
|
||||
return views[(Math.max(index, 0) - 1 + views.length) % views.length];
|
||||
}
|
||||
|
||||
/**
|
||||
* The name the Cockpit shows for the view: the entry's own, without the
|
||||
* "ISS (…)" the catalog wraps the station's modules in.
|
||||
* @param {string|null|undefined} name Catalog name, e.g. "ISS (ZARYA)".
|
||||
* @returns {string}
|
||||
*/
|
||||
export function issMountLabel(name) {
|
||||
const text = String(name ?? '').trim();
|
||||
const inner = /^ISS\s*\((.+)\)$/i.exec(text);
|
||||
return (inner ? inner[1] : text).trim();
|
||||
}
|
||||
|
||||
const add = (a, b, k) => [a[0] + b[0] * k, a[1] + b[1] * k, a[2] + b[2] * k];
|
||||
const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
||||
const unit = (v) => {
|
||||
const length = Math.hypot(v[0], v[1], v[2]);
|
||||
return [v[0] / length, v[1] / length, v[2] / length];
|
||||
};
|
||||
const cross = (a, b) => [
|
||||
a[1] * b[2] - a[2] * b[1],
|
||||
a[2] * b[0] - a[0] * b[2],
|
||||
a[0] * b[1] - a[1] * b[0],
|
||||
];
|
||||
const point = (v) => ({ x: v[0], y: v[1], z: v[2] });
|
||||
|
||||
/**
|
||||
* A mount in the world: the eye point and the view's frame, Earth-fixed.
|
||||
* The model is placed with its forward axis along the flight direction, its
|
||||
* port axis along the orbit normal and its zenith axis away from the Earth
|
||||
* (issFlightAxes), so a model vector [port, zenith, forward] is
|
||||
* port × axes.y + zenith × axes.z + forward × axes.x.
|
||||
* @param {{eye: number[], forward: number[], up: number[]}} mount
|
||||
* @param {{x: number, y: number, z: number}} centre The model's origin.
|
||||
* @param {{x: number[], y: number[], z: number[]}} axes Flight axes.
|
||||
* @returns {{position: object, direction: object, up: object, right: object}}
|
||||
* `{x, y, z}` vectors; direction, up and right are unit and perpendicular,
|
||||
* right = direction × up.
|
||||
*/
|
||||
export function issMountWorld(mount, centre, axes) {
|
||||
const toWorld = ([port, zenith, forward]) =>
|
||||
add(add(add([0, 0, 0], axes.y, port), axes.z, zenith), axes.x, forward);
|
||||
const direction = unit(toWorld(mount.forward));
|
||||
// Up, squared to the direction: the mount's own need not be exact.
|
||||
const rough = toWorld(mount.up);
|
||||
const up = unit(add(rough, direction, -dot(rough, direction)));
|
||||
const offset = toWorld(mount.eye);
|
||||
return {
|
||||
position: {
|
||||
x: centre.x + offset[0],
|
||||
y: centre.y + offset[1],
|
||||
z: centre.z + offset[2],
|
||||
},
|
||||
direction: point(direction),
|
||||
up: point(up),
|
||||
right: point(cross(direction, up)),
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,183 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import test from 'node:test';
|
||||
import {
|
||||
ISS_MOUNTS,
|
||||
ISS_MOUNT_CARDS,
|
||||
ISS_MOUNT_ORDER,
|
||||
ISS_NAUKA_NORAD,
|
||||
ISS_POISK_NORAD,
|
||||
issMountLabel,
|
||||
issMountView,
|
||||
issMountViews,
|
||||
issMountWorld,
|
||||
issNextMountView,
|
||||
issPreviousMountView,
|
||||
} from './issMounts.js';
|
||||
import { ISS_MODEL_NATIVE_SPAN, ISS_NORAD } from './policy.js';
|
||||
|
||||
const dot = (a, b) => a.x * b.x + a.y * b.y + a.z * b.z;
|
||||
const length = (a) => Math.hypot(a.x, a.y, a.z);
|
||||
|
||||
/** Key, label and entry of each view: what the Cockpit steps through. */
|
||||
const summary = (views) =>
|
||||
views.map(({ key, label, noradId }) => ({ key, label, noradId }));
|
||||
|
||||
test('the station offers its views in order, Nauka first', () => {
|
||||
assert.deepEqual(
|
||||
[...ISS_MOUNT_ORDER],
|
||||
['nauka', 'zarya', 'poisk', 'cupola', 'kibo', 'docked'],
|
||||
);
|
||||
for (const key of ISS_MOUNT_ORDER) assert.ok(ISS_MOUNTS[key]);
|
||||
assert.equal(new Set([ISS_NORAD, ISS_NAUKA_NORAD, ISS_POISK_NORAD]).size, 3);
|
||||
// Each view names the entry it belongs to, for the Cockpit to ride. The
|
||||
// Cupola and Kibo have no entries of their own: they ride the ISS's.
|
||||
const views = issMountViews({
|
||||
naukaName: 'ISS (NAUKA)',
|
||||
zaryaName: 'ISS (ZARYA)',
|
||||
poiskName: 'POISK',
|
||||
dockedName: 'PROGRESS-MS 34',
|
||||
naukaNorad: ISS_NAUKA_NORAD,
|
||||
zaryaNorad: ISS_NORAD,
|
||||
poiskNorad: ISS_POISK_NORAD,
|
||||
dockedNorad: 68837,
|
||||
});
|
||||
assert.deepEqual(summary(views), [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: ISS_NAUKA_NORAD },
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: ISS_NORAD },
|
||||
{ key: 'poisk', label: 'POISK', noradId: ISS_POISK_NORAD },
|
||||
{ key: 'cupola', label: 'CUPOLA', noradId: ISS_NORAD },
|
||||
{ key: 'kibo', label: 'KIBO', noradId: ISS_NORAD },
|
||||
{ key: 'docked', label: 'PROGRESS-MS 34', noradId: 68837 },
|
||||
]);
|
||||
// Only the modules without an entry carry cards of their own.
|
||||
assert.deepEqual(
|
||||
views.filter((view) => view.card).map((view) => view.key),
|
||||
['cupola', 'kibo'],
|
||||
);
|
||||
// No vehicle docked: no view from one. The modules are part of the model,
|
||||
// so they are offered even when the catalog has no entry for them; such a
|
||||
// view has no entry to ride.
|
||||
assert.deepEqual(summary(issMountViews({ zaryaName: 'ISS (ZARYA)' })), [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: null },
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: null },
|
||||
{ key: 'poisk', label: 'POISK', noradId: null },
|
||||
{ key: 'cupola', label: 'CUPOLA', noradId: null },
|
||||
{ key: 'kibo', label: 'KIBO', noradId: null },
|
||||
]);
|
||||
assert.deepEqual(
|
||||
issMountViews().map(({ key }) => key),
|
||||
['nauka', 'zarya', 'poisk', 'cupola', 'kibo'],
|
||||
);
|
||||
});
|
||||
|
||||
test('the Cupola’s card names it and gives its facts, marked for translation', () => {
|
||||
const card = ISS_MOUNT_CARDS.cupola;
|
||||
assert.equal(card.name, 'CUPOLA');
|
||||
assert.equal(card.classLabel, 'OBSERVATION MODULE · ISS');
|
||||
assert.equal(card.operator, 'European Space Agency (ESA)');
|
||||
assert.deepEqual(
|
||||
[...card.facts],
|
||||
[
|
||||
'7 WINDOWS',
|
||||
'LAUNCHED 8 FEB 2010 · STS-130',
|
||||
'TRANQUILITY · EARTH-FACING PORT',
|
||||
],
|
||||
);
|
||||
});
|
||||
|
||||
test('Kibo’s card names it and gives its facts, marked for translation', () => {
|
||||
const card = ISS_MOUNT_CARDS.kibo;
|
||||
assert.equal(card.name, 'KIBO');
|
||||
assert.equal(card.classLabel, 'LABORATORY MODULE · ISS');
|
||||
assert.equal(card.operator, 'Japan Aerospace Exploration Agency (JAXA)');
|
||||
assert.deepEqual(
|
||||
[...card.facts],
|
||||
['2 WINDOWS', 'LAUNCHED 31 MAY 2008 · STS-124', 'HARMONY · PORT SIDE'],
|
||||
);
|
||||
});
|
||||
|
||||
test('the view shown is the one asked for, else the first; the next wraps round', () => {
|
||||
const views = issMountViews({ dockedName: 'SOYUZ-MS 28' });
|
||||
assert.equal(issMountView(views, null).key, 'nauka');
|
||||
assert.equal(issMountView(views, undefined).key, 'nauka');
|
||||
assert.equal(issMountView(views, 'zarya').key, 'zarya');
|
||||
assert.equal(issMountView(views, 'docked').label, 'SOYUZ-MS 28');
|
||||
// A view no longer on offer (the vehicle undocked) falls back to the first.
|
||||
assert.equal(issMountView(issMountViews(), 'docked').key, 'nauka');
|
||||
|
||||
assert.equal(issNextMountView(views, 'nauka').key, 'zarya');
|
||||
assert.equal(issNextMountView(views, 'zarya').key, 'poisk');
|
||||
assert.equal(issNextMountView(views, 'poisk').key, 'cupola');
|
||||
assert.equal(issNextMountView(views, 'cupola').key, 'kibo');
|
||||
assert.equal(issNextMountView(views, 'kibo').key, 'docked');
|
||||
assert.equal(issNextMountView(views, 'docked').key, 'nauka');
|
||||
assert.equal(issNextMountView(views, 'unknown').key, 'nauka');
|
||||
assert.equal(issNextMountView(views.slice(0, 1), 'nauka'), null);
|
||||
assert.equal(issNextMountView(null, 'nauka'), null);
|
||||
|
||||
assert.equal(issPreviousMountView(views, 'nauka').key, 'docked');
|
||||
assert.equal(issPreviousMountView(views, 'docked').key, 'kibo');
|
||||
assert.equal(issPreviousMountView(views, 'zarya').key, 'nauka');
|
||||
assert.equal(issPreviousMountView(views, 'unknown').key, 'docked');
|
||||
assert.equal(issPreviousMountView(views.slice(0, 1), 'nauka'), null);
|
||||
assert.equal(issPreviousMountView(null, 'nauka'), null);
|
||||
});
|
||||
|
||||
test('the view is named after the entry, without the catalog’s "ISS (…)"', () => {
|
||||
assert.equal(issMountLabel('ISS (ZARYA)'), 'ZARYA');
|
||||
assert.equal(issMountLabel(' ISS (NAUKA) '), 'NAUKA');
|
||||
assert.equal(issMountLabel('PROGRESS-MS 34'), 'PROGRESS-MS 34');
|
||||
assert.equal(issMountLabel(null), '');
|
||||
});
|
||||
|
||||
test('every mount is on or beside the model, with a usable view frame', () => {
|
||||
for (const [key, { eye, forward, up }] of Object.entries(ISS_MOUNTS)) {
|
||||
// Within the station's own size of its centre: on it or just off its end.
|
||||
assert.ok(Math.hypot(...eye) < ISS_MODEL_NATIVE_SPAN / 2, key);
|
||||
assert.ok(Math.hypot(...forward) > 0.5, key);
|
||||
// Up is not along the view, so the frame can be squared.
|
||||
const cos =
|
||||
(forward[0] * up[0] + forward[1] * up[1] + forward[2] * up[2]) /
|
||||
(Math.hypot(...forward) * Math.hypot(...up));
|
||||
assert.ok(Math.abs(cos) < 0.9, key);
|
||||
}
|
||||
});
|
||||
|
||||
test('a mount goes to the world on the axes the model is placed with', () => {
|
||||
// Flight axes: x along-track, y the orbit normal, z zenith.
|
||||
const axes = { x: [0, 1, 0], y: [0, 0, 1], z: [1, 0, 0] };
|
||||
const centre = { x: 6_800_000, y: 0, z: 0 };
|
||||
// Model axes are [port, zenith, forward]: forward is along-track, zenith
|
||||
// is away from the Earth, port is the orbit normal.
|
||||
const world = issMountWorld(
|
||||
{ eye: [3, 5, -7], forward: [0, 0, 1], up: [0, 1, 0] },
|
||||
centre,
|
||||
axes,
|
||||
);
|
||||
assert.deepEqual(world.position, { x: 6_800_005, y: -7, z: 3 });
|
||||
assert.deepEqual(world.direction, { x: 0, y: 1, z: 0 });
|
||||
assert.deepEqual(world.up, { x: 1, y: 0, z: 0 });
|
||||
// right = direction × up.
|
||||
assert.deepEqual(world.right, { x: 0, y: 0, z: -1 });
|
||||
});
|
||||
|
||||
test('the view frame is unit and square whatever the mount says', () => {
|
||||
const axes = { x: [0, 1, 0], y: [0, 0, 1], z: [1, 0, 0] };
|
||||
const centre = { x: 1, y: 2, z: 3 };
|
||||
for (const mount of [
|
||||
...Object.values(ISS_MOUNTS),
|
||||
// Lengths off, and an up that leans into the view.
|
||||
{ eye: [0, 0, 0], forward: [0, -3, 4], up: [0, 2, 1] },
|
||||
]) {
|
||||
const { direction, up, right } = issMountWorld(mount, centre, axes);
|
||||
for (const v of [direction, up, right])
|
||||
assert.ok(Math.abs(length(v) - 1) < 1e-12);
|
||||
assert.ok(Math.abs(dot(direction, up)) < 1e-12);
|
||||
assert.ok(Math.abs(dot(direction, right)) < 1e-12);
|
||||
assert.ok(Math.abs(dot(up, right)) < 1e-12);
|
||||
}
|
||||
// The eye is the mount's distance from the centre.
|
||||
const { position } = issMountWorld(ISS_MOUNTS.docked, centre, axes);
|
||||
const offset = Math.hypot(position.x - 1, position.y - 2, position.z - 3);
|
||||
assert.ok(Math.abs(offset - Math.hypot(...ISS_MOUNTS.docked.eye)) < 1e-9);
|
||||
});
|
||||
@@ -0,0 +1,222 @@
|
||||
import { msg } from '../../i18n/index.js';
|
||||
import { ISS_ARM_JOINTS } from './issArticulation.js';
|
||||
import { issCommandFastOrbit } from './issCommand.js';
|
||||
import { ISS_NORAD } from './policy.js';
|
||||
import { trackedStation } from './stationModels.js';
|
||||
|
||||
const unit = (v) => {
|
||||
const n = Math.hypot(...v);
|
||||
return v.map((c) => c / n);
|
||||
};
|
||||
|
||||
/**
|
||||
* The Sun positions Manual offers, on the model's axes (port, zenith,
|
||||
* forward), and whether the station is lit there.
|
||||
*/
|
||||
export const ISS_SUN_POSES = Object.freeze([
|
||||
{ id: 'overhead', label: msg('Overhead'), sun: [0, 1, 0], sunlit: true },
|
||||
{ id: 'ahead', label: msg('Ahead'), sun: unit([0, 0.05, 1]), sunlit: true },
|
||||
{
|
||||
id: 'behind',
|
||||
label: msg('Behind'),
|
||||
sun: unit([0, 0.05, -1]),
|
||||
sunlit: true,
|
||||
},
|
||||
{ id: 'below', label: msg('Below'), sun: unit([0, -1, 0.05]), sunlit: true },
|
||||
{
|
||||
id: 'port',
|
||||
label: msg('Port side'),
|
||||
sun: unit([0.8, 0.5, 0.3]),
|
||||
sunlit: true,
|
||||
},
|
||||
{
|
||||
id: 'starboard',
|
||||
label: msg('Starboard side'),
|
||||
sun: unit([-0.8, 0.5, 0.3]),
|
||||
sunlit: true,
|
||||
},
|
||||
{ id: 'night', label: msg('Night (shadow)'), sun: [0, -1, 0], sunlit: false },
|
||||
]);
|
||||
|
||||
/** A seven-joint arm's slider labels, base to tip (Tiangong's arms share them). */
|
||||
export const ISS_ARM_LABELS = Object.freeze([
|
||||
msg('Shoulder roll'),
|
||||
msg('Shoulder yaw'),
|
||||
msg('Shoulder pitch'),
|
||||
msg('Elbow'),
|
||||
msg('Wrist pitch'),
|
||||
msg('Wrist yaw'),
|
||||
msg('Wrist roll'),
|
||||
]);
|
||||
|
||||
/**
|
||||
* The ISS as the STATION section describes it (stationPanel.js): its joint
|
||||
* driver and telemetry from the model part, and the Manual controls the
|
||||
* command panel offered: the Sun's position or a fast orbit, folding the
|
||||
* arrays and radiators as a demonstration, aiming the dishes, posing
|
||||
* Canadarm2 by joint.
|
||||
* @param {{state: object, parts: object}} context
|
||||
* @returns {import('./stationPanel.js').StationDescription}
|
||||
*/
|
||||
export function issStationDescription({ state: layerState, parts }) {
|
||||
return {
|
||||
key: 'iss',
|
||||
title: 'ISS', // i18n-ignore: the station's name
|
||||
// stationModels.js says which station the tracked entry belongs to.
|
||||
selected: () => trackedStation(layerState, parts)?.norad === ISS_NORAD,
|
||||
subjectName: () =>
|
||||
layerState._catalog.get(layerState._trackedNorad)?.name?.trim() ||
|
||||
`ISS · NORAD ${ISS_NORAD}`,
|
||||
articulation: () => parts.issModel?._articulation ?? null,
|
||||
telemetry: () => {
|
||||
// The feed is read only while the model is drawn; away from it there
|
||||
// is no signal to report, and a stale answer would read as lost.
|
||||
if ((parts.issModel?._visualPosition?.() ?? null) === null)
|
||||
return { state: 'idle', poseAgeMs: null, liveUntilMs: null };
|
||||
return parts.issModel?._telemetryStatus?.() ?? null;
|
||||
},
|
||||
// The model's centre, else this frame's tracked sample, else the dot as
|
||||
// the rendering part draws it.
|
||||
position: () =>
|
||||
parts.issModel?._visualPosition?.() ??
|
||||
layerState._trackedFrameCartesian ??
|
||||
parts.rendering?._pointPosition?.(ISS_NORAD) ??
|
||||
null,
|
||||
zoomLabel: msg('Zoom to the ISS'),
|
||||
notes: {
|
||||
live: msg(
|
||||
"Arrays, radiators and one dish follow NASA's live telemetry. The other dish holds still and the arms sway for illustration.",
|
||||
),
|
||||
computed: msg(
|
||||
'Arrays and radiators follow the Sun, the dishes aim at relay satellites and the arms sway for illustration. Computed, not live telemetry.',
|
||||
),
|
||||
},
|
||||
groups: [
|
||||
{
|
||||
id: 'sun',
|
||||
label: msg('Sun position'),
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'follow',
|
||||
label: msg('Follow the Sun'),
|
||||
isDefault: true,
|
||||
apply: (a) => a.setOverride(null),
|
||||
},
|
||||
...ISS_SUN_POSES.map(({ id, label, sun, sunlit }) => ({
|
||||
id,
|
||||
label,
|
||||
apply: (a) => {
|
||||
const fixed = { sun, sunlit };
|
||||
a.setOverride(() => fixed);
|
||||
},
|
||||
})),
|
||||
{
|
||||
id: 'orbit',
|
||||
label: msg('Fast orbit (40 s)'),
|
||||
apply: (a) => {
|
||||
const start = Date.now();
|
||||
a.setOverride((nowMs) => issCommandFastOrbit(nowMs - start));
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'arrays',
|
||||
label: msg('Solar arrays'),
|
||||
note: msg('Demonstration: the real arrays stay extended.'),
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'retract',
|
||||
label: msg('Retract'),
|
||||
apply: (a) => a.setDeploy(false),
|
||||
},
|
||||
{
|
||||
id: 'extend',
|
||||
label: msg('Extend'),
|
||||
isDefault: true,
|
||||
apply: (a) => a.setDeploy(true),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'radiators',
|
||||
label: msg('Radiators'),
|
||||
note: msg(
|
||||
'Demonstration: the real radiators can fold but stay extended.',
|
||||
),
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'retract',
|
||||
label: msg('Retract'),
|
||||
apply: (a) => a.setRadiatorDeploy(false),
|
||||
},
|
||||
{
|
||||
id: 'extend',
|
||||
label: msg('Extend'),
|
||||
isDefault: true,
|
||||
apply: (a) => a.setRadiatorDeploy(true),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'dishes',
|
||||
label: msg('Dishes'),
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'relays',
|
||||
label: msg('Relay satellites'),
|
||||
isDefault: true,
|
||||
apply: (a) => a.setDishOverride(null),
|
||||
},
|
||||
{
|
||||
id: 'up',
|
||||
label: msg('Up'),
|
||||
apply: (a) => a.setDishOverride([0, 1, 0]),
|
||||
},
|
||||
{
|
||||
id: 'forward',
|
||||
label: msg('Forward'),
|
||||
apply: (a) => a.setDishOverride(unit([0, 0.35, 0.94])),
|
||||
},
|
||||
{
|
||||
id: 'sideways',
|
||||
label: msg('Sideways'),
|
||||
apply: (a) => a.setDishOverride(unit([0.94, 0.35, 0])),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'arm',
|
||||
label: msg('Canadarm2 (degrees)'),
|
||||
kind: 'sliders',
|
||||
resume: msg('Resume sway'),
|
||||
sliders: ISS_ARM_JOINTS.map((joint, i) => ({
|
||||
id: joint.node,
|
||||
label: ISS_ARM_LABELS[i],
|
||||
min: -120,
|
||||
max: 120,
|
||||
apply: (a, value) =>
|
||||
a.setJoint(
|
||||
joint.node,
|
||||
joint.pivot,
|
||||
joint.axis,
|
||||
(value * Math.PI) / 180,
|
||||
),
|
||||
})),
|
||||
resumeApply: (a) => a.resumeArm(),
|
||||
},
|
||||
],
|
||||
automatic: (a) => {
|
||||
a.setTelemetryAllowed?.(true);
|
||||
a.setOverride(null);
|
||||
a.setDishOverride(null);
|
||||
a.setDeploy(true);
|
||||
a.setRadiatorDeploy(true);
|
||||
a.resumeArm();
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,298 @@
|
||||
/**
|
||||
* The ISS model's joints from NASA's public telemetry, when the server relays
|
||||
* it (`/api/iss-telemetry`, off unless the operator sets
|
||||
* `ISS_TELEMETRY_ENABLED=1`). Without it, or while the station has no signal,
|
||||
* the joints keep the computed rules in issArticulation.js.
|
||||
*
|
||||
* How each telemetry angle maps onto a model joint was fitted against a
|
||||
* recording of the feed, using the station's own attitude and position from
|
||||
* the same feed:
|
||||
* - the dish's two angles give a direction that stayed within 0.3° of a TDRS
|
||||
* relay satellite across a hand-over between two of them;
|
||||
* - the alpha joints' sign and zero put the arrays' masts square to the Sun;
|
||||
* - each beta joint's sign is the one that turns its cell side toward the Sun
|
||||
* (the other sign faces it about 45° away). The arrays then sat 5° to 9°
|
||||
* off the Sun, which is where the real station held them.
|
||||
* The radiator joints did not move during the recording, so their sign is the
|
||||
* better of the two candidates on a parked joint, not a fit.
|
||||
*/
|
||||
|
||||
/** The route the server relays the feed at. */
|
||||
export const ISS_TELEMETRY_URL = '/api/iss-telemetry';
|
||||
|
||||
const DEG = Math.PI / 180;
|
||||
|
||||
/** Alpha joints (SARJ), in ISS_ALPHA_JOINTS order: port, starboard. */
|
||||
export const ISS_TELEMETRY_ALPHA = Object.freeze([
|
||||
Object.freeze({ item: 'S0000004', sign: 1 }),
|
||||
Object.freeze({ item: 'S0000003', sign: -1 }),
|
||||
]);
|
||||
|
||||
/**
|
||||
* Beta joints (BGA), in ISS_BETA_JOINTS order: 2A, 4A, 2B, 4B, 1A, 3A, 1B,
|
||||
* 3B. The model's angle is `sign × telemetry + 90°`: at 0° or 180° an array
|
||||
* stands square to the truss, which is the model's ±90°.
|
||||
*/
|
||||
export const ISS_TELEMETRY_BETA = Object.freeze([
|
||||
Object.freeze({ item: 'P4000007', sign: 1 }),
|
||||
Object.freeze({ item: 'P4000008', sign: -1 }),
|
||||
Object.freeze({ item: 'P6000008', sign: -1 }),
|
||||
Object.freeze({ item: 'P6000007', sign: 1 }),
|
||||
Object.freeze({ item: 'S4000007', sign: -1 }),
|
||||
Object.freeze({ item: 'S4000008', sign: 1 }),
|
||||
Object.freeze({ item: 'S6000008', sign: 1 }),
|
||||
Object.freeze({ item: 'S6000007', sign: -1 }),
|
||||
]);
|
||||
|
||||
/** Radiator joints (TRRJ), in ISS_RADIATOR_JOINTS order: port, starboard. */
|
||||
export const ISS_TELEMETRY_GAMMA = Object.freeze([
|
||||
Object.freeze({ item: 'S0000002', sign: 1 }),
|
||||
Object.freeze({ item: 'S0000001', sign: 1 }),
|
||||
]);
|
||||
|
||||
/** The Ku-band dish: elevation and cross-elevation. */
|
||||
export const ISS_TELEMETRY_DISH = Object.freeze({
|
||||
elevation: 'Z1000014',
|
||||
crossElevation: 'Z1000015',
|
||||
});
|
||||
|
||||
/**
|
||||
* Where the dish points, on the model's axes (port, zenith, forward), from
|
||||
* its two gimbal angles: zenith at rest, cross-elevation leans it to port,
|
||||
* elevation then tips it aft.
|
||||
* @param {number} elevationDeg
|
||||
* @param {number} crossElevationDeg
|
||||
* @returns {number[]} Unit vector.
|
||||
*/
|
||||
export function issTelemetryDishDirection(elevationDeg, crossElevationDeg) {
|
||||
const el = elevationDeg * DEG;
|
||||
const xel = crossElevationDeg * DEG;
|
||||
return [
|
||||
Math.sin(xel),
|
||||
Math.cos(el) * Math.cos(xel),
|
||||
-Math.sin(el) * Math.cos(xel),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* The joint angles a telemetry snapshot gives, as the model turns them.
|
||||
* @param {Record<string, [number, number|null]>|null|undefined} items The
|
||||
* relay's `items`: each item's value and the time it was true at.
|
||||
* @returns {{alpha: number[], beta: number[], gamma: number[],
|
||||
* dish: number[]|null}|null} Radians, in the joint lists' order; null
|
||||
* unless every array and radiator joint is present. `dish` is null when
|
||||
* its angles are missing.
|
||||
*/
|
||||
export function issTelemetryPose(items) {
|
||||
if (!items) return null;
|
||||
const read = (item) => {
|
||||
const value = items[item]?.[0];
|
||||
return Number.isFinite(value) ? value : null;
|
||||
};
|
||||
const turn = (list, offsetDeg) =>
|
||||
list.map(({ item, sign }) => {
|
||||
const value = read(item);
|
||||
return value === null ? null : (sign * value + offsetDeg) * DEG;
|
||||
});
|
||||
const alpha = turn(ISS_TELEMETRY_ALPHA, 0);
|
||||
const beta = turn(ISS_TELEMETRY_BETA, 90);
|
||||
const gamma = turn(ISS_TELEMETRY_GAMMA, 0);
|
||||
if ([...alpha, ...beta, ...gamma].includes(null)) return null;
|
||||
const el = read(ISS_TELEMETRY_DISH.elevation);
|
||||
const xel = read(ISS_TELEMETRY_DISH.crossElevation);
|
||||
return {
|
||||
alpha,
|
||||
beta,
|
||||
gamma,
|
||||
dish:
|
||||
el === null || xel === null ? null : issTelemetryDishDirection(el, xel),
|
||||
};
|
||||
}
|
||||
|
||||
/** How often the relay is asked while the model is on screen. */
|
||||
export const ISS_TELEMETRY_POLL_MS = 5_000;
|
||||
/** A snapshot older than this is not used: the joints go back to their rules. */
|
||||
export const ISS_TELEMETRY_FRESH_MS = 20_000;
|
||||
|
||||
/**
|
||||
* The newest moment any of the relay's items was true at: when the feed
|
||||
* last had data, as far as this answer tells.
|
||||
* @param {Record<string, [number, number]>|null|undefined} items
|
||||
* @returns {number|null} Epoch ms, or null without a dated item.
|
||||
*/
|
||||
export function issTelemetryLatestEpoch(items) {
|
||||
let latest = null;
|
||||
for (const entry of Object.values(items ?? {})) {
|
||||
const epoch = Array.isArray(entry) ? Number(entry[1]) : NaN;
|
||||
// An item with no time has 0 there, which is no date.
|
||||
if (
|
||||
epoch > 0 &&
|
||||
Number.isFinite(epoch) &&
|
||||
(latest === null || epoch > latest)
|
||||
)
|
||||
latest = epoch;
|
||||
}
|
||||
return latest;
|
||||
}
|
||||
/** The feed stops asking this long after the model was last drawn. */
|
||||
const WANTED_MS = 10_000;
|
||||
const REQUEST_TIMEOUT_MS = 5_000;
|
||||
/** After a failed request the next one waits this long. */
|
||||
const FAILURE_WAIT_MS = 30_000;
|
||||
|
||||
/**
|
||||
* Polls the relay while the model is drawn. `touch()` each frame the model
|
||||
* shows keeps it asking; it stops by itself when the touches stop, and for
|
||||
* good once the server says the relay is not switched on.
|
||||
* @param {{fetchImpl?: typeof fetch, now?: () => number,
|
||||
* setTimer?: (fn: () => void, ms: number) => unknown,
|
||||
* clearTimer?: (id: unknown) => void}} [options]
|
||||
*/
|
||||
export function createIssTelemetryFeed({
|
||||
fetchImpl = (...args) => globalThis.fetch(...args),
|
||||
now = Date.now,
|
||||
setTimer = (fn, ms) => setTimeout(fn, ms),
|
||||
clearTimer = (id) => clearTimeout(id),
|
||||
} = {}) {
|
||||
/** False once the server answered that the relay is off. */
|
||||
let configured = null;
|
||||
let lastTouchAt = null;
|
||||
let timer = null;
|
||||
let requesting = false;
|
||||
/** Bumped by destroy, so a request in flight cannot write after it. */
|
||||
let generation = 0;
|
||||
let pose = null;
|
||||
let poseAt = null;
|
||||
/** What the relay last said and when, for the station panel's status line. */
|
||||
let relayStatus = null;
|
||||
let answeredAt = null;
|
||||
let failures = 0;
|
||||
/** When the relay last reported signal; the "no signal since" time. */
|
||||
let liveUntil = null;
|
||||
|
||||
async function request() {
|
||||
const mine = generation;
|
||||
requesting = true;
|
||||
const controller = new AbortController();
|
||||
const deadline = setTimer(() => controller.abort(), REQUEST_TIMEOUT_MS);
|
||||
let wait = ISS_TELEMETRY_POLL_MS;
|
||||
try {
|
||||
const response = await fetchImpl(ISS_TELEMETRY_URL, {
|
||||
signal: controller.signal,
|
||||
cache: 'no-store',
|
||||
});
|
||||
if (!response.ok) throw new Error('unavailable');
|
||||
const body = await response.json();
|
||||
if (mine !== generation) return;
|
||||
if (body?.configured !== true) {
|
||||
configured = false;
|
||||
pose = null;
|
||||
return;
|
||||
}
|
||||
configured = true;
|
||||
answeredAt = now();
|
||||
failures = 0;
|
||||
relayStatus = typeof body.status === 'string' ? body.status : null;
|
||||
const next = body.status === 'live' ? issTelemetryPose(body.items) : null;
|
||||
pose = next;
|
||||
poseAt = next ? now() : null;
|
||||
if (next) liveUntil = poseAt;
|
||||
// A page that opens during a loss of signal still learns when the
|
||||
// feed last had data: the newest value the relay holds was true then.
|
||||
else if (body.status === 'no-signal' && liveUntil === null)
|
||||
liveUntil = issTelemetryLatestEpoch(body.items);
|
||||
} catch {
|
||||
if (mine !== generation) return;
|
||||
failures += 1;
|
||||
wait = FAILURE_WAIT_MS;
|
||||
} finally {
|
||||
clearTimer(deadline);
|
||||
if (mine === generation) {
|
||||
requesting = false;
|
||||
schedule(wait);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function wanted() {
|
||||
return (
|
||||
configured !== false &&
|
||||
lastTouchAt !== null &&
|
||||
now() - lastTouchAt < WANTED_MS
|
||||
);
|
||||
}
|
||||
|
||||
function schedule(ms) {
|
||||
if (timer !== null || requesting || !wanted()) return;
|
||||
timer = setTimer(() => {
|
||||
timer = null;
|
||||
if (wanted()) request();
|
||||
}, ms);
|
||||
}
|
||||
|
||||
return {
|
||||
/** The model is on screen: keep the feed asking. */
|
||||
touch() {
|
||||
lastTouchAt = now();
|
||||
schedule(0);
|
||||
},
|
||||
/**
|
||||
* The joint angles to use now, or null: no relay, no signal, or the last
|
||||
* answer is too old.
|
||||
* @returns {{alpha: number[], beta: number[], gamma: number[],
|
||||
* dish: number[]|null}|null}
|
||||
*/
|
||||
pose() {
|
||||
if (!pose || poseAt === null) return null;
|
||||
return now() - poseAt < ISS_TELEMETRY_FRESH_MS ? pose : null;
|
||||
},
|
||||
/** Whether the server relays the feed: null until it has answered. */
|
||||
configured() {
|
||||
return configured;
|
||||
},
|
||||
/**
|
||||
* Where the joints' angles stand, for the station panel: `live` with a
|
||||
* fresh pose; `no-signal` while the relay is up but the station is out
|
||||
* of contact; `unavailable` when the relay cannot be reached or is not
|
||||
* connected; `disabled` when this server does not relay the feed;
|
||||
* `pending` before the first answer. `poseAgeMs` is how old the last
|
||||
* pose is, `liveUntilMs` when signal was last had (epoch ms), both null
|
||||
* when there was none.
|
||||
* @returns {{state: 'live'|'no-signal'|'unavailable'|'disabled'|'pending',
|
||||
* poseAgeMs: number|null, liveUntilMs: number|null}}
|
||||
*/
|
||||
status() {
|
||||
const at = now();
|
||||
const poseAgeMs = poseAt === null ? null : at - poseAt;
|
||||
let state;
|
||||
if (configured === false) state = 'disabled';
|
||||
else if (configured === null) state = 'pending';
|
||||
else if (pose && poseAgeMs < ISS_TELEMETRY_FRESH_MS) state = 'live';
|
||||
else if (failures === 0 && relayStatus === 'no-signal')
|
||||
state = 'no-signal';
|
||||
else if (
|
||||
failures === 0 &&
|
||||
(relayStatus === 'connecting' || relayStatus === 'reconnecting') &&
|
||||
answeredAt !== null &&
|
||||
at - answeredAt < ISS_TELEMETRY_FRESH_MS
|
||||
)
|
||||
state = 'pending';
|
||||
else state = 'unavailable';
|
||||
return { state, poseAgeMs, liveUntilMs: liveUntil };
|
||||
},
|
||||
destroy() {
|
||||
generation += 1;
|
||||
if (timer !== null) clearTimer(timer);
|
||||
timer = null;
|
||||
requesting = false;
|
||||
lastTouchAt = null;
|
||||
pose = null;
|
||||
poseAt = null;
|
||||
configured = null;
|
||||
relayStatus = null;
|
||||
answeredAt = null;
|
||||
failures = 0;
|
||||
liveUntil = null;
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,467 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import test, { after, before } from 'node:test';
|
||||
import * as Cesium from 'cesium';
|
||||
import {
|
||||
ISS_ALPHA_JOINTS,
|
||||
ISS_BETA_JOINTS,
|
||||
ISS_DISH_JOINTS,
|
||||
ISS_RADIATOR_JOINTS,
|
||||
createIssArticulation,
|
||||
} from './issArticulation.js';
|
||||
import {
|
||||
issTelemetryLatestEpoch,
|
||||
ISS_TELEMETRY_ALPHA,
|
||||
ISS_TELEMETRY_BETA,
|
||||
ISS_TELEMETRY_FRESH_MS,
|
||||
ISS_TELEMETRY_GAMMA,
|
||||
ISS_TELEMETRY_POLL_MS,
|
||||
ISS_TELEMETRY_URL,
|
||||
createIssTelemetryFeed,
|
||||
issTelemetryDishDirection,
|
||||
issTelemetryPose,
|
||||
} from './issTelemetry.js';
|
||||
|
||||
// The joint driver asks Cesium for the Earth's orientation, which loads data
|
||||
// over the network; without it Cesium's own fallback is used, as in the app
|
||||
// before that data arrives.
|
||||
const realIcrf = Cesium.Transforms.computeIcrfToFixedMatrix;
|
||||
before(() => {
|
||||
Cesium.Transforms.computeIcrfToFixedMatrix = () => undefined;
|
||||
});
|
||||
after(() => {
|
||||
Cesium.Transforms.computeIcrfToFixedMatrix = realIcrf;
|
||||
});
|
||||
|
||||
const DEG = Math.PI / 180;
|
||||
const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
||||
const angleDeg = (a, b) =>
|
||||
Math.acos(Math.min(1, Math.max(-1, dot(a, b)))) / DEG;
|
||||
|
||||
/**
|
||||
* Two moments recorded from the feed on 13 November 2026, eleven minutes
|
||||
* apart. `sun` and `relayDirection` are on the model's axes (port, zenith,
|
||||
* forward), worked out from the station's own position and attitude in the
|
||||
* same feed; the relay is the TDRS satellite the dish was aimed at.
|
||||
*/
|
||||
const RECORDED = [
|
||||
{
|
||||
items: {
|
||||
S0000004: [306.2512, 0],
|
||||
S0000003: [53.7878, 0],
|
||||
P4000007: [161.5045, 0],
|
||||
P4000008: [198.4406, 0],
|
||||
P6000008: [202.9449, 0],
|
||||
P6000007: [161.0541, 0],
|
||||
S4000007: [18.7427, 0],
|
||||
S4000008: [341.3068, 0],
|
||||
S6000008: [341.7682, 0],
|
||||
S6000007: [18.8361, 0],
|
||||
S0000002: [15.1868, 0],
|
||||
S0000001: [24.8383, 0],
|
||||
Z1000014: [-8.4924, 0],
|
||||
Z1000015: [-31.6077, 0],
|
||||
},
|
||||
sun: [0.45411, 0.5286, -0.7172],
|
||||
relayDirection: [-0.5264, 0.84041, 0.12893],
|
||||
},
|
||||
{
|
||||
items: {
|
||||
S0000004: [262.0807, 0],
|
||||
S0000003: [97.9968, 0],
|
||||
P4000007: [161.8451, 0],
|
||||
P4000008: [198.2867, 0],
|
||||
P6000008: [202.8131, 0],
|
||||
P6000007: [161.4166, 0],
|
||||
S4000007: [18.6932, 0],
|
||||
S4000008: [341.7902, 0],
|
||||
S6000008: [341.6089, 0],
|
||||
S6000007: [18.4076, 0],
|
||||
S0000002: [15.1923, 0],
|
||||
S0000001: [24.8383, 0],
|
||||
Z1000014: [39.5837, 0],
|
||||
Z1000015: [-30.1135, 0],
|
||||
},
|
||||
sun: [0.45807, -0.12024, -0.88075],
|
||||
relayDirection: [-0.50436, 0.66714, -0.54822],
|
||||
},
|
||||
];
|
||||
|
||||
/**
|
||||
* An array's cell-side normal on the model's axes: ±X at rest, turned about
|
||||
* the mast (Z) by beta, then about the truss (X) by alpha.
|
||||
*/
|
||||
function cellNormal(face, alpha, beta) {
|
||||
const x = face * Math.cos(beta);
|
||||
const y = face * Math.sin(beta);
|
||||
return [x, Math.cos(alpha) * y, Math.sin(alpha) * y];
|
||||
}
|
||||
|
||||
test('the joint lists line up with the model joints they drive', () => {
|
||||
assert.equal(ISS_TELEMETRY_ALPHA.length, ISS_ALPHA_JOINTS.length);
|
||||
assert.equal(ISS_TELEMETRY_BETA.length, ISS_BETA_JOINTS.length);
|
||||
assert.equal(ISS_TELEMETRY_GAMMA.length, ISS_RADIATOR_JOINTS.length);
|
||||
const items = [
|
||||
...ISS_TELEMETRY_ALPHA,
|
||||
...ISS_TELEMETRY_BETA,
|
||||
...ISS_TELEMETRY_GAMMA,
|
||||
].map(({ item }) => item);
|
||||
assert.equal(new Set(items).size, items.length, 'no item drives two joints');
|
||||
});
|
||||
|
||||
test('recorded telemetry turns every array toward where the Sun was', () => {
|
||||
for (const { items, sun } of RECORDED) {
|
||||
const pose = issTelemetryPose(items);
|
||||
ISS_BETA_JOINTS.forEach(({ node, face }, i) => {
|
||||
const alpha = pose.alpha[node.startsWith('PORT') ? 0 : 1];
|
||||
const off = angleDeg(cellNormal(face, alpha, pose.beta[i]), sun);
|
||||
// The real arrays were held 5° to 9° off the Sun.
|
||||
assert.ok(off < 11, `${node} is ${off.toFixed(1)}° off the Sun`);
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
test('the other sign on any joint turns its arrays away from the Sun', () => {
|
||||
const { items, sun } = RECORDED[0];
|
||||
const pose = issTelemetryPose(items);
|
||||
ISS_BETA_JOINTS.forEach(({ node, face }, i) => {
|
||||
const alpha = pose.alpha[node.startsWith('PORT') ? 0 : 1];
|
||||
// Beta with the opposite sign about its 90° zero.
|
||||
const flipped = Math.PI - pose.beta[i];
|
||||
assert.ok(angleDeg(cellNormal(face, alpha, flipped), sun) > 35, node);
|
||||
// Alpha with the opposite sign.
|
||||
assert.ok(angleDeg(cellNormal(face, -alpha, pose.beta[i]), sun) > 35, node);
|
||||
});
|
||||
});
|
||||
|
||||
test('the recorded dish angles point at the relay satellite', () => {
|
||||
for (const { items, relayDirection } of RECORDED) {
|
||||
const { dish } = issTelemetryPose(items);
|
||||
assert.ok(Math.abs(Math.hypot(...dish) - 1) < 1e-9);
|
||||
assert.ok(angleDeg(dish, relayDirection) < 0.5);
|
||||
}
|
||||
// At rest it looks at the zenith; cross-elevation leans to port,
|
||||
// elevation tips aft.
|
||||
assert.ok(angleDeg(issTelemetryDishDirection(0, 0), [0, 1, 0]) < 1e-6);
|
||||
assert.ok(issTelemetryDishDirection(0, 30)[0] > 0);
|
||||
assert.ok(issTelemetryDishDirection(30, 0)[2] < 0);
|
||||
});
|
||||
|
||||
test('a snapshot missing a joint gives no pose; missing dish angles give no dish', () => {
|
||||
const { items } = RECORDED[0];
|
||||
assert.equal(issTelemetryPose(null), null);
|
||||
assert.equal(issTelemetryPose({}), null);
|
||||
for (const item of ['S0000004', 'P6000007', 'S0000001']) {
|
||||
const partial = { ...items };
|
||||
delete partial[item];
|
||||
assert.equal(issTelemetryPose(partial), null, item);
|
||||
}
|
||||
assert.equal(
|
||||
issTelemetryPose({ ...items, S0000003: ['x', 0] }),
|
||||
null,
|
||||
'a value that is not a number',
|
||||
);
|
||||
const noDish = { ...items };
|
||||
delete noDish.Z1000015;
|
||||
const pose = issTelemetryPose(noDish);
|
||||
assert.equal(pose.dish, null);
|
||||
assert.equal(pose.beta.length, 8);
|
||||
});
|
||||
|
||||
/** A hand-moved clock with the timers set on it. */
|
||||
function fakeTime() {
|
||||
const time = { ms: 1_000_000 };
|
||||
let timers = [];
|
||||
let nextId = 1;
|
||||
return {
|
||||
now: () => time.ms,
|
||||
setTimer(fn, ms) {
|
||||
const id = nextId++;
|
||||
timers.push({ id, at: time.ms + ms, fn });
|
||||
return id;
|
||||
},
|
||||
clearTimer(id) {
|
||||
timers = timers.filter((timer) => timer.id !== id);
|
||||
},
|
||||
/** Move the clock on, running timers as they fall due. */
|
||||
async advance(ms) {
|
||||
const end = time.ms + ms;
|
||||
for (;;) {
|
||||
// Let a finished request schedule its next timer first.
|
||||
await new Promise((resolve) => setImmediate(resolve));
|
||||
const due = timers
|
||||
.filter((timer) => timer.at <= end)
|
||||
.sort((a, b) => a.at - b.at)[0];
|
||||
if (!due) break;
|
||||
timers = timers.filter((timer) => timer !== due);
|
||||
time.ms = Math.max(time.ms, due.at);
|
||||
due.fn();
|
||||
}
|
||||
time.ms = end;
|
||||
await new Promise((resolve) => setImmediate(resolve));
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
/** A fetch that answers from a queue of bodies (or throws for an Error). */
|
||||
function fakeFetch(answers) {
|
||||
const calls = [];
|
||||
const fetchImpl = async (url, init) => {
|
||||
calls.push({ url, init });
|
||||
const answer = answers.length > 1 ? answers.shift() : answers[0];
|
||||
if (answer instanceof Error) throw answer;
|
||||
return { ok: true, json: async () => answer };
|
||||
};
|
||||
return { fetchImpl, calls };
|
||||
}
|
||||
|
||||
const LIVE = { configured: true, status: 'live', items: RECORDED[0].items };
|
||||
|
||||
test('the feed asks only while the model is drawn, every five seconds', async () => {
|
||||
const time = fakeTime();
|
||||
const { fetchImpl, calls } = fakeFetch([LIVE]);
|
||||
const feed = createIssTelemetryFeed({ fetchImpl, ...time });
|
||||
await time.advance(60_000);
|
||||
assert.equal(calls.length, 0, 'nothing is asked before the model shows');
|
||||
|
||||
feed.touch();
|
||||
await time.advance(0);
|
||||
assert.equal(calls.length, 1);
|
||||
assert.equal(calls[0].url, ISS_TELEMETRY_URL);
|
||||
assert.equal(calls[0].init.cache, 'no-store');
|
||||
assert.equal(feed.configured(), true);
|
||||
assert.deepEqual(feed.pose(), issTelemetryPose(RECORDED[0].items));
|
||||
|
||||
// Drawn for another 12 s: two more requests.
|
||||
for (let i = 0; i < 12; i++) {
|
||||
feed.touch();
|
||||
await time.advance(1000);
|
||||
}
|
||||
assert.equal(calls.length, 1 + Math.floor(12_000 / ISS_TELEMETRY_POLL_MS));
|
||||
|
||||
// Not drawn any more: it stops by itself, and the pose goes stale.
|
||||
const drawn = calls.length;
|
||||
await time.advance(60_000);
|
||||
assert.ok(calls.length <= drawn + 2);
|
||||
assert.equal(feed.pose(), null);
|
||||
const settled = calls.length;
|
||||
await time.advance(60_000);
|
||||
assert.equal(calls.length, settled);
|
||||
});
|
||||
|
||||
test('a relay that is switched off is asked once and never again', async () => {
|
||||
const time = fakeTime();
|
||||
const { fetchImpl, calls } = fakeFetch([{ configured: false }]);
|
||||
const feed = createIssTelemetryFeed({ fetchImpl, ...time });
|
||||
for (let i = 0; i < 30; i++) {
|
||||
feed.touch();
|
||||
await time.advance(1000);
|
||||
}
|
||||
assert.equal(calls.length, 1);
|
||||
assert.equal(feed.configured(), false);
|
||||
assert.equal(feed.pose(), null);
|
||||
});
|
||||
|
||||
test('no signal, a failed request or an old answer all give no pose', async () => {
|
||||
const time = fakeTime();
|
||||
const { fetchImpl, calls } = fakeFetch([
|
||||
LIVE,
|
||||
{ configured: true, status: 'no-signal', items: RECORDED[0].items },
|
||||
LIVE,
|
||||
new Error('offline'),
|
||||
]);
|
||||
const feed = createIssTelemetryFeed({ fetchImpl, ...time });
|
||||
const drawFor = async (ms) => {
|
||||
for (let t = 0; t < ms; t += 1000) {
|
||||
feed.touch();
|
||||
await time.advance(1000);
|
||||
}
|
||||
};
|
||||
await drawFor(1000);
|
||||
assert.ok(feed.pose());
|
||||
await drawFor(ISS_TELEMETRY_POLL_MS);
|
||||
assert.equal(feed.pose(), null, 'no signal');
|
||||
await drawFor(ISS_TELEMETRY_POLL_MS);
|
||||
assert.ok(feed.pose(), 'signal back');
|
||||
// Requests now fail: the last pose is used until it is 20 s old, and the
|
||||
// feed asks less often.
|
||||
const failingFrom = calls.length;
|
||||
await drawFor(ISS_TELEMETRY_FRESH_MS - ISS_TELEMETRY_POLL_MS - 1000);
|
||||
assert.ok(feed.pose());
|
||||
await drawFor(ISS_TELEMETRY_POLL_MS + 2000);
|
||||
assert.equal(feed.pose(), null, 'too old');
|
||||
await drawFor(60_000);
|
||||
assert.ok(calls.length - failingFrom <= 4, 'failures are retried slowly');
|
||||
});
|
||||
|
||||
test('destroy stops the feed, even with a request in flight', async () => {
|
||||
const time = fakeTime();
|
||||
let release;
|
||||
const calls = [];
|
||||
const fetchImpl = (url) => {
|
||||
calls.push(url);
|
||||
return new Promise((resolve) => {
|
||||
release = () => resolve({ ok: true, json: async () => LIVE });
|
||||
});
|
||||
};
|
||||
const feed = createIssTelemetryFeed({ fetchImpl, ...time });
|
||||
feed.touch();
|
||||
await time.advance(0);
|
||||
assert.equal(calls.length, 1);
|
||||
feed.destroy();
|
||||
release();
|
||||
await time.advance(60_000);
|
||||
assert.equal(feed.pose(), null);
|
||||
assert.equal(calls.length, 1);
|
||||
});
|
||||
|
||||
/**
|
||||
* A stand-in for the loaded model: named nodes that keep a copy of the
|
||||
* matrix written to them, as a Cesium node does.
|
||||
*/
|
||||
function fakeModel() {
|
||||
const nodes = new Map();
|
||||
return {
|
||||
ready: true,
|
||||
getNode(name) {
|
||||
if (!nodes.has(name)) {
|
||||
let copy = null;
|
||||
nodes.set(name, {
|
||||
name,
|
||||
get matrix() {
|
||||
return copy;
|
||||
},
|
||||
set matrix(value) {
|
||||
copy = Array.from(value);
|
||||
},
|
||||
});
|
||||
}
|
||||
return nodes.get(name);
|
||||
},
|
||||
matrixOf(name) {
|
||||
return nodes.get(name)?.matrix ?? null;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
const AXES = { x: [1, 0, 0], y: [0, 1, 0], z: [0, 0, 1] };
|
||||
const POSITION = { x: 6_800_000, y: 0, z: 0 };
|
||||
|
||||
test('with a telemetry pose the joints take its angles, each side its own', () => {
|
||||
const articulation = createIssArticulation();
|
||||
const model = fakeModel();
|
||||
const pose = issTelemetryPose(RECORDED[0].items);
|
||||
articulation.setTelemetry(() => pose);
|
||||
articulation.update(
|
||||
model,
|
||||
new Date(Date.UTC(2026, 10, 13, 11, 8)),
|
||||
POSITION,
|
||||
AXES,
|
||||
1000,
|
||||
);
|
||||
assert.equal(articulation.isLive(), true);
|
||||
|
||||
// The alpha joints turn about X by the pose's angle: port and starboard differ.
|
||||
ISS_ALPHA_JOINTS.forEach(({ node }, i) => {
|
||||
const m = model.matrixOf(node);
|
||||
assert.ok(Math.abs(m[5] - Math.cos(pose.alpha[i])) < 1e-9, node);
|
||||
assert.ok(Math.abs(m[6] - Math.sin(pose.alpha[i])) < 1e-9, node);
|
||||
});
|
||||
assert.notDeepEqual(
|
||||
model.matrixOf(ISS_ALPHA_JOINTS[0].node),
|
||||
model.matrixOf(ISS_ALPHA_JOINTS[1].node),
|
||||
);
|
||||
ISS_BETA_JOINTS.forEach(({ node }, i) => {
|
||||
const m = model.matrixOf(node);
|
||||
assert.ok(Math.abs(m[0] - Math.cos(pose.beta[i])) < 1e-9, node);
|
||||
assert.ok(Math.abs(m[1] - Math.sin(pose.beta[i])) < 1e-9, node);
|
||||
});
|
||||
ISS_RADIATOR_JOINTS.forEach(({ node }, i) => {
|
||||
const m = model.matrixOf(node);
|
||||
assert.ok(Math.abs(m[0] - Math.cos(pose.gamma[i])) < 1e-9, node);
|
||||
});
|
||||
// The first dish takes the reported aim (its rest boresight, +Y, turned
|
||||
// onto it); the second is left where it was.
|
||||
const dish = model.matrixOf(ISS_DISH_JOINTS[0].node);
|
||||
assert.ok(angleDeg([dish[4], dish[5], dish[6]], pose.dish) < 1e-4);
|
||||
const second = model.matrixOf(ISS_DISH_JOINTS[1].node);
|
||||
assert.ok(angleDeg([second[4], second[5], second[6]], [0, 1, 0]) < 1e-4);
|
||||
});
|
||||
|
||||
test('without a pose, or in Manual, the joints keep their computed rules', () => {
|
||||
const date = new Date(Date.UTC(2026, 10, 13, 11, 8));
|
||||
const computed = fakeModel();
|
||||
createIssArticulation().update(computed, date, POSITION, AXES, 1000);
|
||||
|
||||
// Telemetry with nothing to say.
|
||||
const silent = createIssArticulation();
|
||||
silent.setTelemetry(() => null);
|
||||
const silentModel = fakeModel();
|
||||
silent.update(silentModel, date, POSITION, AXES, 1000);
|
||||
assert.equal(silent.isLive(), false);
|
||||
|
||||
// Telemetry with a pose, but the command panel is on Manual.
|
||||
const manual = createIssArticulation();
|
||||
manual.setTelemetry(() => issTelemetryPose(RECORDED[0].items));
|
||||
manual.setTelemetryAllowed(false);
|
||||
const manualModel = fakeModel();
|
||||
manual.update(manualModel, date, POSITION, AXES, 1000);
|
||||
assert.equal(manual.isLive(), false);
|
||||
|
||||
// A Sun chosen by hand is computed too.
|
||||
const forced = createIssArticulation();
|
||||
forced.setTelemetry(() => issTelemetryPose(RECORDED[0].items));
|
||||
forced.setOverride(() => ({ sun: [0, 1, 0], sunlit: true }));
|
||||
forced.update(fakeModel(), date, POSITION, AXES, 1000);
|
||||
assert.equal(forced.isLive(), false);
|
||||
|
||||
for (const { node } of [
|
||||
...ISS_ALPHA_JOINTS,
|
||||
...ISS_BETA_JOINTS,
|
||||
...ISS_RADIATOR_JOINTS,
|
||||
]) {
|
||||
assert.deepEqual(silentModel.matrixOf(node), computed.matrixOf(node), node);
|
||||
assert.deepEqual(manualModel.matrixOf(node), computed.matrixOf(node), node);
|
||||
}
|
||||
|
||||
// Back to Automatic: the pose is used again, gliding at the joint rate.
|
||||
manual.setTelemetryAllowed(true);
|
||||
manual.update(manualModel, date, POSITION, AXES, 1100);
|
||||
assert.equal(manual.isLive(), true);
|
||||
});
|
||||
|
||||
test('a page that opens during a loss of signal learns when the feed last had data', async () => {
|
||||
const time = fakeTime();
|
||||
// The recording carries no times; date every item the same.
|
||||
const dated = Object.fromEntries(
|
||||
Object.entries(RECORDED[0].items).map(([key, [value]]) => [
|
||||
key,
|
||||
[value, 1_700_000_000_000],
|
||||
]),
|
||||
);
|
||||
const noSignal = {
|
||||
configured: true,
|
||||
status: 'no-signal',
|
||||
items: dated,
|
||||
};
|
||||
const { fetchImpl } = fakeFetch([noSignal, noSignal]);
|
||||
const feed = createIssTelemetryFeed({ fetchImpl, ...time });
|
||||
feed.touch();
|
||||
await time.advance(1000);
|
||||
const status = feed.status();
|
||||
assert.equal(status.state, 'no-signal');
|
||||
assert.equal(status.poseAgeMs, null);
|
||||
const latest = issTelemetryLatestEpoch(dated);
|
||||
assert.ok(Number.isFinite(latest) && latest > 0);
|
||||
assert.equal(status.liveUntilMs, latest);
|
||||
feed.destroy();
|
||||
});
|
||||
|
||||
test('the latest epoch is the newest dated item, and nothing without one', () => {
|
||||
assert.equal(
|
||||
issTelemetryLatestEpoch({ a: [1, 100], b: [2, 300], c: [3, 200] }),
|
||||
300,
|
||||
);
|
||||
assert.equal(issTelemetryLatestEpoch({ a: [1, 'x'], b: 5, c: [2, 0] }), null);
|
||||
assert.equal(issTelemetryLatestEpoch({}), null);
|
||||
assert.equal(issTelemetryLatestEpoch(null), null);
|
||||
});
|
||||
@@ -43,7 +43,8 @@ export function createLifecycle({
|
||||
const frame = frameOf(viewer);
|
||||
parts.catalog._abortActiveUpdates();
|
||||
clearFocusTarget('satellites');
|
||||
parts.issModel?._destroyIssModel();
|
||||
for (const model of parts.stationModels ?? [])
|
||||
model._destroyStationModel();
|
||||
layerState._viewer = viewer;
|
||||
layerState._catalog = new Map();
|
||||
layerState._points = new Map();
|
||||
@@ -135,10 +136,10 @@ export function createLifecycle({
|
||||
releaseContinuousRender('satellites');
|
||||
parts.rendering._setPointsShown(false);
|
||||
parts.rendering._setOrbitPathsShown(false);
|
||||
parts.issModel?._updateIssModel(); // off: hides the model
|
||||
for (const model of parts.stationModels ?? [])
|
||||
model._updateStationModel(); // off: hides the model
|
||||
parts.tracking._clearTracking();
|
||||
parts.issLive?._syncIssLive(); // off: closes the live video
|
||||
parts.issCommand?._syncIssCommand(); // off: closes the command panel
|
||||
parts.stationPanel?._syncStationPanel(); // off: takes the panel down
|
||||
parts.labels._syncIssOverlay();
|
||||
// Remove click handler + keydown listener + preRender propagation while disabled
|
||||
layerState._clickSubscription?.();
|
||||
@@ -176,9 +177,9 @@ export function createLifecycle({
|
||||
}
|
||||
layerState._overlayHost.clearSource(ISS_OVERLAY_SOURCE_ID);
|
||||
layerState._overlayHost.setVisible(ISS_OVERLAY_SOURCE_ID, false);
|
||||
parts.issModel?._destroyIssModel();
|
||||
parts.issLive?._destroyIssLive();
|
||||
parts.issCommand?._destroyIssCommand();
|
||||
for (const model of parts.stationModels ?? [])
|
||||
model._destroyStationModel();
|
||||
parts.stationPanel?._destroyStationPanel();
|
||||
// The dots', tracked dot's and rings' sets are disposed of
|
||||
parts.rendering._detach(viewer);
|
||||
layerState._points.clear();
|
||||
|
||||
@@ -312,6 +312,98 @@ test('the rendering part draws the dots, the tracked dot and the rings through t
|
||||
}
|
||||
});
|
||||
|
||||
test('a dot handed to a station model draws only beyond its range; the tracked dot too', () => {
|
||||
const viewer = {};
|
||||
const { draw, unbind } = bindFakeDraw(viewer);
|
||||
try {
|
||||
const state = {
|
||||
now: Date.now,
|
||||
_points: new Map(),
|
||||
_orbitPaths: new Map(),
|
||||
_catalog: new Map(),
|
||||
_viewer: viewer,
|
||||
_trackedNorad: null,
|
||||
_enabled: true,
|
||||
_params: { showPoints: false, showOrbits: false },
|
||||
};
|
||||
const rendering = createRendering({
|
||||
state,
|
||||
services: {
|
||||
focus: {
|
||||
focusNowMs: (ms) => ms,
|
||||
getFocusTarget: () => null,
|
||||
focusPassIsNeeded: () => false,
|
||||
},
|
||||
},
|
||||
parts: { tracking: { _getTrackedFramePosition: () => null } },
|
||||
});
|
||||
rendering._attach(viewer);
|
||||
const points = draw.find('satellites:').spec.id;
|
||||
const set = draw.set(points);
|
||||
const range = [1.5e6, Number.MAX_VALUE];
|
||||
let frame = 0;
|
||||
const tick = () => rendering._preRenderTick({ frame: ++frame });
|
||||
rendering._addPoint(25544, { x: 1, y: 2, z: 3 }, POINT_STYLES.iss);
|
||||
tick();
|
||||
assert.equal(set.items.get('25544').displayRange, undefined);
|
||||
assert.equal(rendering._pointDisplayRange(25544), null);
|
||||
// The range goes to the set with the frame, as the item's own copy.
|
||||
assert.equal(rendering._setPointDisplayRange(25544, range), true);
|
||||
assert.equal(rendering._setPointDisplayRange(1, range), false, 'no dot');
|
||||
let writes = set.writes;
|
||||
tick();
|
||||
assert.equal(set.writes, writes + 1, 'sent with the frame');
|
||||
assert.deepEqual(set.items.get('25544').displayRange, range);
|
||||
assert.notEqual(set.items.get('25544').displayRange, range);
|
||||
assert.deepEqual(rendering._pointDisplayRange(25544), range);
|
||||
assert.equal(set.items.get('25544').show, true, 'shown, within its range');
|
||||
// The same range again sends nothing (asked every frame).
|
||||
writes = set.writes;
|
||||
rendering._setPointDisplayRange(25544, [1.5e6, Number.MAX_VALUE]);
|
||||
tick();
|
||||
assert.equal(set.writes, writes);
|
||||
// None again: every distance.
|
||||
rendering._setPointDisplayRange(25544, null);
|
||||
tick();
|
||||
assert.equal(set.items.get('25544').displayRange, undefined);
|
||||
assert.equal(rendering._pointDisplayRange(25544), null);
|
||||
// A dot added again (a catalog rebuild) arrives with no range.
|
||||
rendering._setPointDisplayRange(25544, range);
|
||||
rendering._addPoint(25544, { x: 1, y: 2, z: 3 }, POINT_STYLES.iss);
|
||||
tick();
|
||||
assert.equal(set.items.get('25544').displayRange, undefined);
|
||||
|
||||
// The tracked dot: redrawn at once while drawn, fresh for each tracking.
|
||||
const tracked = draw.set(points.replace(':points', ':tracked'));
|
||||
state._trackedNorad = 25544;
|
||||
assert.equal(rendering._trackedDotDisplayRange(), null, 'no tracked dot');
|
||||
rendering._setTrackedDotDisplayRange(range); // nothing to put it on
|
||||
rendering._addTrackedEntity({ position: () => ({ x: 1, y: 2, z: 3 }) });
|
||||
assert.equal(rendering._trackedDotDisplayRange(), null);
|
||||
tick();
|
||||
assert.equal(tracked.items.get('25544').displayRange, undefined);
|
||||
writes = tracked.writes;
|
||||
rendering._setTrackedDotDisplayRange(range);
|
||||
assert.equal(tracked.writes, writes + 1, 'redrawn at once');
|
||||
assert.deepEqual(tracked.items.get('25544').displayRange, range);
|
||||
assert.deepEqual(rendering._trackedDotDisplayRange(), range);
|
||||
rendering._setTrackedDotDisplayRange([1.5e6, Number.MAX_VALUE]);
|
||||
assert.equal(tracked.writes, writes + 1, 'the same range sends nothing');
|
||||
rendering._setTrackedDotDisplayRange(null);
|
||||
assert.equal(tracked.items.get('25544').displayRange, undefined);
|
||||
assert.equal(rendering._trackedDotDisplayRange(), null);
|
||||
rendering._setTrackedDotDisplayRange(range);
|
||||
rendering._removeTrackedEntity();
|
||||
assert.equal(rendering._trackedDotDisplayRange(), null);
|
||||
rendering._addTrackedEntity({ position: () => ({ x: 1, y: 2, z: 3 }) });
|
||||
tick();
|
||||
assert.equal(tracked.items.get('25544').displayRange, undefined);
|
||||
rendering._detach(viewer);
|
||||
} finally {
|
||||
unbind();
|
||||
}
|
||||
});
|
||||
|
||||
test('the orbit frame matrix turns ECEF about Z by minus the GMST elapsed', () => {
|
||||
const rendering = createRendering({
|
||||
state: {},
|
||||
|
||||
@@ -19,6 +19,38 @@ import { SATELLITE_CLASS_DISPLAY, SATELLITE_CLASS_IDS } from './classes.js';
|
||||
|
||||
export const ISS_NORAD = 25544;
|
||||
|
||||
/**
|
||||
* Tiangong's catalog entry: CelesTrak lists the core module as "CSS (TIANHE)"
|
||||
* and the labs as "CSS (WENTIAN)" and "CSS (MENGTIAN)" under entries of their
|
||||
* own, with the docked Shenzhou and Tianzhou ships beside them.
|
||||
*/
|
||||
export const TIANGONG_NORAD = 48274;
|
||||
|
||||
/**
|
||||
* Whether the tracked satellite is a station: the station's own entry, or an
|
||||
* object docked to it (a module, a cargo ship…), which is the same body under
|
||||
* a catalog entry of its own. A click on the station's dot lands on any of
|
||||
* them.
|
||||
* @param {number} stationNorad The station's entry (ISS_NORAD, TIANGONG_NORAD).
|
||||
* @param {number|null|undefined} trackedNorad
|
||||
* @param {{has(noradId: number): boolean}|null|undefined} dockedCompanions
|
||||
* What shares the tracked satellite's position (`_dockedCompanions`).
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function stationTrackedOn(stationNorad, trackedNorad, dockedCompanions) {
|
||||
if (trackedNorad === stationNorad) return true;
|
||||
return (
|
||||
trackedNorad !== null &&
|
||||
trackedNorad !== undefined &&
|
||||
Boolean(dockedCompanions?.has(stationNorad))
|
||||
);
|
||||
}
|
||||
|
||||
/** `stationTrackedOn` for the ISS. */
|
||||
export function issTrackedOnStation(trackedNorad, dockedCompanions) {
|
||||
return stationTrackedOn(ISS_NORAD, trackedNorad, dockedCompanions);
|
||||
}
|
||||
|
||||
/**
|
||||
* The ISS drawn as a 3D model up close (issModel.js): NASA's "International
|
||||
* Space Station (ISS) (D) (IGOAL)" from NASA 3D Resources, the station's
|
||||
@@ -101,12 +133,41 @@ export const ISS_ORBIT_HIDE_M = 50_000;
|
||||
export const ISS_CARD_CLEAR_M = 40;
|
||||
|
||||
/**
|
||||
* NASA's official live stream from the ISS on YouTube ("Live High-Definition
|
||||
* Views from the International Space Station", channel @NASA), shown in a
|
||||
* panel while the ISS is selected (issLive.js). A YouTube live keeps its id
|
||||
* while the broadcast runs; if NASA restarts it under a new id, change it here.
|
||||
* Tiangong drawn as a 3D model up close (tiangongModel.js): the project's own
|
||||
* model of the station's T configuration (Tianhe, Wentian, Mengtian, with a
|
||||
* Shenzhou forward and nadir and a Tianzhou aft), built from primitives with
|
||||
* procedural textures, in meters, same frame as the ISS file (glTF +X port,
|
||||
* +Y zenith, +Z forward), the scene root at the station's bounding-box
|
||||
* centre (public/models/README.md).
|
||||
*/
|
||||
export const ISS_LIVE_VIDEO_ID = 'ROboUHfPUrU';
|
||||
export const TIANGONG_MODEL_URL = '/models/tiangong.glb';
|
||||
|
||||
/**
|
||||
* The tracked card's clearance from Tiangong (ISS_CARD_CLEAR_M for the ISS):
|
||||
* the station reaches ~29 m from its centre along the lab wings.
|
||||
*/
|
||||
export const TIANGONG_CARD_CLEAR_M = 30;
|
||||
|
||||
/**
|
||||
* The stations the layer treats as one body with their docked entries
|
||||
* (stationModels.js): `key` is the STATION description's and the LIVE
|
||||
* section's (`station:<key>`); objects within `companionRadiusM` of the
|
||||
* station, orbit against orbit, are docked to it. Each is also drawn as a 3D
|
||||
* model up close (issModel.js, tiangongModel.js), but these rules hold
|
||||
* whether or not a model part exists.
|
||||
*/
|
||||
export const STATIONS = Object.freeze([
|
||||
Object.freeze({
|
||||
key: 'iss',
|
||||
norad: ISS_NORAD,
|
||||
companionRadiusM: ISS_COMPANION_RADIUS_M,
|
||||
}),
|
||||
Object.freeze({
|
||||
key: 'tiangong',
|
||||
norad: TIANGONG_NORAD,
|
||||
companionRadiusM: ISS_COMPANION_RADIUS_M,
|
||||
}),
|
||||
]);
|
||||
|
||||
export const ISS_OVERLAY_SOURCE_ID = 'satellites-iss';
|
||||
|
||||
|
||||
@@ -55,6 +55,13 @@ const RING_BEHIND_ALPHA = 0.35;
|
||||
/** An RGBA colour with another alpha. */
|
||||
const withAlpha = (color, alpha) => [color[0], color[1], color[2], alpha];
|
||||
|
||||
/** Whether two display ranges are the same: both none, or the same bounds. */
|
||||
const sameRange = (a, b) =>
|
||||
a && b ? a[0] === b[0] && a[1] === b[1] : !a && !b;
|
||||
|
||||
/** A display range as the item's own copy, or undefined for none. */
|
||||
const rangeOf = (range) => (range ? [range[0], range[1]] : undefined);
|
||||
|
||||
/** Layer instances so far: set ids unique to each. */
|
||||
let instances = 0;
|
||||
|
||||
@@ -259,6 +266,46 @@ export function createRendering({
|
||||
if (trackedDot.drawn) sets?.tracked.upsert([trackedDot.item]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Draw one satellite's dot only at eye distances in `range` (`[near, far)`,
|
||||
* metres), or at every distance for null, apart from whether it is shown:
|
||||
* a station's model stands in for its dot, and for the dots of the objects
|
||||
* docked to it, within the model's range (stationModel.js). A dot added
|
||||
* again (a catalog rebuild) arrives with no range.
|
||||
* @param {number} noradId
|
||||
* @param {readonly [number, number]|null} range
|
||||
* @returns {boolean} Whether the satellite has a dot.
|
||||
*/
|
||||
function _setPointDisplayRange(noradId, range) {
|
||||
const point = layerState._points.get(noradId);
|
||||
if (!point) return false;
|
||||
if (sameRange(point.displayRange, range)) return true;
|
||||
point.displayRange = rangeOf(range);
|
||||
_markDirty(noradId);
|
||||
return true;
|
||||
}
|
||||
|
||||
/** The eye distances a dot is drawn at, or null for every distance. */
|
||||
function _pointDisplayRange(noradId) {
|
||||
return layerState._points.get(noradId)?.displayRange ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The tracked satellite's dot likewise; a dot drawn is redrawn at once. A
|
||||
* new tracked dot (tracking another satellite) arrives with no range.
|
||||
* @param {readonly [number, number]|null} range
|
||||
*/
|
||||
function _setTrackedDotDisplayRange(range) {
|
||||
if (!trackedDot || sameRange(trackedDot.item.displayRange, range)) return;
|
||||
trackedDot.item.displayRange = rangeOf(range);
|
||||
if (trackedDot.drawn) sets?.tracked.upsert([trackedDot.item]);
|
||||
}
|
||||
|
||||
/** The eye distances the tracked dot is drawn at, or null for every distance. */
|
||||
function _trackedDotDisplayRange() {
|
||||
return trackedDot?.item.displayRange ?? null;
|
||||
}
|
||||
|
||||
/** Remove every orbit ring. */
|
||||
function _clearOrbitPaths() {
|
||||
const ids = [...layerState._orbitPaths.values()].map(
|
||||
@@ -665,10 +712,10 @@ export function createRendering({
|
||||
function _tickAfterFrame() {
|
||||
const now = focusNowMs(Date.now());
|
||||
|
||||
// The ISS as a 3D model up close. First, before the tracked sample below
|
||||
// is refreshed: the follow camera and the tracked dot were placed this
|
||||
// frame from the sample still cached, and the model must sit on it too.
|
||||
parts.issModel?._updateIssModel();
|
||||
// The stations as 3D models up close. First, before the tracked sample
|
||||
// below is refreshed: the follow camera and the tracked dot were placed
|
||||
// this frame from the sample still cached, and a model must sit on it too.
|
||||
for (const model of parts.stationModels ?? []) model._updateStationModel();
|
||||
|
||||
const interval = layerState._trackedNorad ? 200 : POSITION_UPDATE_MS;
|
||||
// Space Missions keeps this layer enabled for TLE lookup while deliberately
|
||||
@@ -705,8 +752,7 @@ export function createRendering({
|
||||
parts.cockpit?._syncCockpitSubjectVisuals();
|
||||
|
||||
// NASA's live video beside the card while the ISS is selected.
|
||||
parts.issLive?._syncIssLive();
|
||||
parts.issCommand?._syncIssCommand();
|
||||
parts.stationPanel?._syncStationPanel();
|
||||
|
||||
_updatePointFocus(now);
|
||||
|
||||
@@ -869,6 +915,10 @@ export function createRendering({
|
||||
_setPointStyle,
|
||||
_pointShown,
|
||||
_setTrackedDotShown,
|
||||
_setPointDisplayRange,
|
||||
_pointDisplayRange,
|
||||
_setTrackedDotDisplayRange,
|
||||
_trackedDotDisplayRange,
|
||||
_clearOrbitPaths,
|
||||
_addPoint,
|
||||
_movePoint,
|
||||
|
||||
@@ -80,6 +80,13 @@ export function createState({ services }) {
|
||||
// Click-to-track state
|
||||
|
||||
state._trackedNorad = null;
|
||||
/**
|
||||
* The station the tracked satellite is docked to, by both orbits compared
|
||||
* when tracking began (tracking.js): its NORAD number, or null.
|
||||
*/
|
||||
state._trackedDockedToStation = null;
|
||||
/** Whether that station is the ISS, whose ring stands for the entry's. */
|
||||
state._trackedDockedToIss = false;
|
||||
|
||||
state._pendingTrackingRestore = null;
|
||||
|
||||
|
||||
@@ -0,0 +1,741 @@
|
||||
import { eciToGeodetic, gstime, propagate } from 'satellite.js';
|
||||
import { fromRadians } from '../../geo/ellipsoid.js';
|
||||
import { headingPitchRollOfAxes } from '../../geo/frames.js';
|
||||
import { copyInto, distance, vec } from '../../geo/vector.js';
|
||||
import { canvasOf, drawOf, findCamera } from '../../render/rendererOf.js';
|
||||
import { stationTrackedOn } from './policy.js';
|
||||
|
||||
/**
|
||||
* A space station as a 3D model when the camera is close, driven by a
|
||||
* description of the station (`StationModelSpec`): the ISS (issModel.js) and
|
||||
* Tiangong (tiangongModel.js) are two instances of this one factory. Far out
|
||||
* the dot stays: the model and the dot (ambient and tracked) split the
|
||||
* distance range, so exactly one of them draws (the model by the display
|
||||
* range on its draw item, the dots by the display range the rendering part
|
||||
* puts on theirs). The model is one item of a `models` set on the
|
||||
* renderer's draw port, asked for on first need and only if the station is
|
||||
* shown, and posed every frame from its own SGP4 sample (the dot moves once
|
||||
* a second, which at model range would show as a jump).
|
||||
*
|
||||
* The moving parts (the joint driver, `createArticulation`) write node
|
||||
* matrices into this part's node poses (`_nodePoses`), as they would into a
|
||||
* model's nodes; the draw contract has no per-node posing yet, so the model
|
||||
* draws rigid until it has, and the poses are kept for it.
|
||||
*
|
||||
* @typedef {object} StationModelSpec
|
||||
* @property {string} key Short id ('iss', 'tiangong'): the STATION
|
||||
* description's key and the LIVE section's `station:<key>` subject key.
|
||||
* @property {string} label The station's name, for log lines.
|
||||
* @property {number} norad The catalog entry the model stands at.
|
||||
* @property {string} modelUrl Asset path, resolved with `resolveAsset`.
|
||||
* @property {number} scale The file's units to meters.
|
||||
* @property {number} minPx The model is never drawn smaller than this.
|
||||
* @property {number} maxDistanceM Within this camera distance the model
|
||||
* replaces the dot.
|
||||
* @property {number} orbitHideM Within this camera distance the station's
|
||||
* orbit ring is hidden.
|
||||
* @property {number} cardClearM How many meters of the station the tracked
|
||||
* card keeps clear of.
|
||||
* @property {number} companionRadiusM Objects within this of the station,
|
||||
* orbit against orbit, are docked to it.
|
||||
* @property {number} companionCoarseM Only dots within this are checked.
|
||||
* @property {number} companionScanMs How often the docked set is rescanned.
|
||||
* @property {readonly string[]} localAxes Which flight axis each of the
|
||||
* model's local axes points along (see ISS_MODEL_LOCAL_AXES).
|
||||
* @property {(noradId: number, entry: object|undefined) => boolean} isModule
|
||||
* Whether a catalog entry at the station is one of its own modules (the
|
||||
* ISS's Nauka, Tiangong's labs) rather than a visiting vehicle.
|
||||
* @property {() => object} createArticulation The joint driver
|
||||
* (`update(nodes, date, position, axes)`, `reset()`, and what the STATION
|
||||
* section calls). `nodes` has a model's `ready` and `getNode(name)`, each
|
||||
* node taking a `matrix`.
|
||||
* @property {(() => {pose: () => object|null, touch: () => void,
|
||||
* status: () => object, destroy: () => void})|null} createTelemetry A
|
||||
* telemetry feed for the joints, or null for computed angles only.
|
||||
* @property {((input: {key: string|null, centre: {x: number, y: number, z: number},
|
||||
* axes: {x: number[], y: number[], z: number[]},
|
||||
* name: (noradId: number|null) => string|null,
|
||||
* entry: (noradId: number|null) => number|null,
|
||||
* dockedVehicle: number|null}) => object|null)|null} cockpitMount The
|
||||
* Cockpit camera's views on the model, or null when the station has none.
|
||||
* @property {boolean} hideInCockpit Hide the model while the Cockpit rides
|
||||
* the station: true where its camera would sit inside the hull, false
|
||||
* where it rides a mount on the model.
|
||||
* @property {(() => void)|null} syncOrbit Puts the station's ring back to
|
||||
* its own rules on leaving the close-up; null for the layer's orbit toggle
|
||||
* (a ring that exists only while the station is tracked).
|
||||
*/
|
||||
|
||||
/**
|
||||
* Whether a station model may be drawn: the dot's own rules (layer on, points
|
||||
* on, the station loaded and its class shown or the station tracked), and
|
||||
* not while the Cockpit hides it.
|
||||
* @param {{enabled: boolean, showPoints: boolean, hasStation: boolean,
|
||||
* classVisible: boolean, tracked: boolean, cockpitHidden: boolean}} input
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function stationModelShouldShow({
|
||||
enabled,
|
||||
showPoints,
|
||||
hasStation,
|
||||
classVisible,
|
||||
tracked,
|
||||
cockpitHidden,
|
||||
}) {
|
||||
return (
|
||||
Boolean(enabled) &&
|
||||
Boolean(showPoints) &&
|
||||
Boolean(hasStation) &&
|
||||
(Boolean(classVisible) || Boolean(tracked)) &&
|
||||
!cockpitHidden
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* A station's flight axes in the Earth-fixed frame, from one SGP4 state: a
|
||||
* station normally flies "+XVV", its modules along the velocity, the truss or
|
||||
* labs across the orbit plane, the same side always to the Earth. Returned
|
||||
* as the model's local axes: x along-track, y the orbit normal, z zenith
|
||||
* (away from the Earth's centre).
|
||||
* @param {{x:number,y:number,z:number}} positionEcef Earth-fixed position.
|
||||
* @param {{x:number,y:number,z:number}} velocityEcefAxes Inertial velocity,
|
||||
* turned onto the Earth-fixed axes (direction only matters).
|
||||
* @returns {{x:number[], y:number[], z:number[]}|null} Unit vectors, or null
|
||||
* for a degenerate state (zero position or velocity along it).
|
||||
*/
|
||||
export function stationFlightAxes(positionEcef, velocityEcefAxes) {
|
||||
const r = [positionEcef.x, positionEcef.y, positionEcef.z];
|
||||
const v = [velocityEcefAxes.x, velocityEcefAxes.y, velocityEcefAxes.z];
|
||||
const z = unit(r);
|
||||
const y = unit(cross(r, v));
|
||||
if (!z || !y) return null;
|
||||
const x = cross(y, z);
|
||||
return { x, y, z };
|
||||
}
|
||||
|
||||
/**
|
||||
* Turn an inertial (TEME) vector onto the Earth-fixed axes at `gmst`: the same
|
||||
* rotation `eciToGeodetic` applies to the position.
|
||||
* @param {{x:number,y:number,z:number}} v
|
||||
* @param {number} gmst Radians.
|
||||
* @returns {{x:number,y:number,z:number}}
|
||||
*/
|
||||
export function temeToEcefAxes(v, gmst) {
|
||||
const c = Math.cos(gmst);
|
||||
const s = Math.sin(gmst);
|
||||
return { x: c * v.x + s * v.y, y: -s * v.x + c * v.y, z: v.z };
|
||||
}
|
||||
|
||||
/**
|
||||
* The model's orientation for the renderer, `{heading, pitch, roll}` at
|
||||
* `position`, from the station's flight axes and which of them each model
|
||||
* axis points along (`localAxes`).
|
||||
* @param {{x:number,y:number,z:number}} position Earth-fixed.
|
||||
* @param {{x:number[], y:number[], z:number[]}} axes Flight axes.
|
||||
* @param {readonly string[]} localAxes
|
||||
* @returns {{heading: number, pitch: number, roll: number}}
|
||||
*/
|
||||
export function stationModelOrientation(position, axes, localAxes) {
|
||||
const as = (key) => vec(axes[key][0], axes[key][1], axes[key][2]);
|
||||
return headingPitchRollOfAxes(position, {
|
||||
x: as(localAxes[0]),
|
||||
y: as(localAxes[1]),
|
||||
z: as(localAxes[2]),
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Node poses as a joint driver writes them: `getNode(name)` hands a node
|
||||
* whose `matrix` it sets (a column-major 4×4, copied on write, as a model's
|
||||
* node copies), and `poses` keeps every matrix written, by node name.
|
||||
* @returns {{ready: boolean, getNode: (name: string) => {matrix: Float64Array},
|
||||
* poses: Map<string, Float64Array>, clear: () => void}}
|
||||
*/
|
||||
export function createNodePoses() {
|
||||
const poses = new Map();
|
||||
const nodes = new Map();
|
||||
return {
|
||||
ready: true,
|
||||
poses,
|
||||
getNode(name) {
|
||||
let node = nodes.get(name);
|
||||
if (!node) {
|
||||
node = {
|
||||
get matrix() {
|
||||
return poses.get(name);
|
||||
},
|
||||
set matrix(value) {
|
||||
let kept = poses.get(name);
|
||||
if (!kept) {
|
||||
kept = new Float64Array(16);
|
||||
poses.set(name, kept);
|
||||
}
|
||||
for (let i = 0; i < 16; i++) kept[i] = value[i];
|
||||
},
|
||||
};
|
||||
nodes.set(name, node);
|
||||
}
|
||||
return node;
|
||||
},
|
||||
clear() {
|
||||
poses.clear();
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
function cross(a, b) {
|
||||
return [
|
||||
a[1] * b[2] - a[2] * b[1],
|
||||
a[2] * b[0] - a[0] * b[2],
|
||||
a[0] * b[1] - a[1] * b[0],
|
||||
];
|
||||
}
|
||||
|
||||
function unit(a) {
|
||||
const n = Math.hypot(a[0], a[1], a[2]);
|
||||
if (!(n > 0)) return null;
|
||||
return [a[0] / n, a[1] / n, a[2] / n];
|
||||
}
|
||||
|
||||
/**
|
||||
* One station's model part.
|
||||
* @param {StationModelSpec} spec
|
||||
* @param {{state: object, parts: object, resolveAsset?: (url: string) => string}} context
|
||||
*/
|
||||
export function createStationModel(
|
||||
spec,
|
||||
{ state: layerState, parts, resolveAsset },
|
||||
) {
|
||||
const { norad } = spec;
|
||||
/** The `models` draw set the station is an item of, once asked for. */
|
||||
let set = null;
|
||||
let offReady = null;
|
||||
let offFailed = null;
|
||||
/** The station's draw item, sent again each frame it is posed. */
|
||||
const itemId = `station:${spec.key}`;
|
||||
let item = null;
|
||||
/** Whether the renderer has the model loaded and posed. */
|
||||
let ready = false;
|
||||
let loading = false;
|
||||
let failed = false;
|
||||
/** Turns the moving parts by where the Sun (and the relays) are. */
|
||||
const articulation = spec.createArticulation();
|
||||
/** Where the joint driver writes; kept for a renderer that poses nodes. */
|
||||
const nodePoses = createNodePoses();
|
||||
/**
|
||||
* Telemetry for the same joints, where the station has any: asked for only
|
||||
* while the model is drawn, and used in place of the computed angles
|
||||
* whenever it has a pose.
|
||||
*/
|
||||
const telemetry = spec.createTelemetry?.() ?? null;
|
||||
if (telemetry) articulation.setTelemetry?.(() => telemetry.pose());
|
||||
/** The eye distances the model draws at. */
|
||||
const nearRange = Object.freeze([0, spec.maxDistanceM]);
|
||||
/** The eye distances the dots the model stands in for are drawn at. */
|
||||
const farRange = Object.freeze([spec.maxDistanceM, Number.MAX_VALUE]);
|
||||
/** Whether the station's own dot is left to the model within its range. */
|
||||
let dotHanded = false;
|
||||
/** Whether the tracked dot is, the tracked satellite being the station. */
|
||||
let trackedDotHanded = false;
|
||||
/** @type {Set<number>} Docked objects whose dots the model stands in for. */
|
||||
const handedCompanions = new Set();
|
||||
let lastCompanionScanMs = Number.NEGATIVE_INFINITY;
|
||||
/** Whether the station's orbit ring is hidden for the close-up. */
|
||||
let orbitHidden = false;
|
||||
/** The tracked docked object whose ring is hidden for the close-up, or null. */
|
||||
let companionRingHidden = null;
|
||||
const scratchPosition = vec();
|
||||
const scratchMountCentre = vec();
|
||||
/** The station centre the model last rendered at (for the tracked card). */
|
||||
const visualPosition = vec();
|
||||
let visualValid = false;
|
||||
|
||||
function _shouldShow() {
|
||||
const tracked = layerState._trackedNorad === norad;
|
||||
return stationModelShouldShow({
|
||||
enabled: layerState._enabled,
|
||||
showPoints: layerState._params.showPoints,
|
||||
hasStation: layerState._catalog.has(norad),
|
||||
classVisible: parts.controls._classVisible(norad),
|
||||
tracked,
|
||||
// With no mounts on the model the Cockpit camera would sit inside the
|
||||
// hull, so the model goes while the Cockpit rides the station.
|
||||
cockpitHidden:
|
||||
spec.hideInCockpit &&
|
||||
Boolean(parts.cockpit?._cockpitHeld?.()) &&
|
||||
_trackedOnStation(),
|
||||
});
|
||||
}
|
||||
|
||||
/** The eye, from the camera port, or null without one. */
|
||||
function _eye() {
|
||||
return findCamera(layerState._viewer)?.pose?.()?.position ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Ask the renderer for the model: a `models` set of its own with the
|
||||
* station as its one item, hidden until posed. On a renderer that draws
|
||||
* no models the dot keeps drawing at every distance.
|
||||
* @param {{x:number,y:number,z:number}} at Where the station is now.
|
||||
*/
|
||||
function _load(at) {
|
||||
const draw = drawOf(layerState._viewer);
|
||||
if (typeof draw?.models !== 'function') {
|
||||
failed = true;
|
||||
return;
|
||||
}
|
||||
loading = true;
|
||||
set = draw.models({ id: `satellites:${itemId}`, show: true });
|
||||
offReady = set.on('ready', (id) => {
|
||||
if (id !== itemId) return;
|
||||
ready = true;
|
||||
loading = false;
|
||||
});
|
||||
offFailed = set.on('loadFailed', (id, message) => {
|
||||
if (id !== itemId) return;
|
||||
// The dot keeps drawing at every distance; nothing else depends on this.
|
||||
failed = true;
|
||||
loading = false;
|
||||
console.warn(
|
||||
`[Data:Satellites] ${spec.label} model failed to load:`,
|
||||
message,
|
||||
);
|
||||
});
|
||||
item = {
|
||||
id: itemId,
|
||||
pos: { x: at.x, y: at.y, z: at.z },
|
||||
url: resolveAsset(spec.modelUrl),
|
||||
orientation: { heading: 0, pitch: 0, roll: 0 },
|
||||
scale: spec.scale,
|
||||
minPixelSize: spec.minPx,
|
||||
displayRange: nearRange,
|
||||
// So a click on the model tracks the station, as a click on its dot does.
|
||||
meta: { norad },
|
||||
show: false,
|
||||
};
|
||||
set.upsert([item]);
|
||||
}
|
||||
|
||||
/** Send the item as it stands. */
|
||||
function _send() {
|
||||
if (set && item) set.upsert([item]);
|
||||
}
|
||||
|
||||
/** Hide the model (nothing sent when it is hidden already). */
|
||||
function _hide() {
|
||||
if (item && item.show) {
|
||||
item.show = false;
|
||||
_send();
|
||||
}
|
||||
}
|
||||
|
||||
/** An object's inertial position at `date`, km, or null. */
|
||||
function _temeKm(satrec, date) {
|
||||
if (!satrec) return null;
|
||||
try {
|
||||
const position = propagate(satrec, date)?.position;
|
||||
return position && typeof position !== 'boolean' ? position : null;
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the tracked satellite is the station itself: its own entry, or
|
||||
* an object docked to it (a module, a cargo ship…), which has a catalog
|
||||
* entry and a dot of its own but is the same body as the model.
|
||||
*/
|
||||
function _trackedOnStation() {
|
||||
const tracked = layerState._trackedNorad;
|
||||
return (
|
||||
stationTrackedOn(norad, tracked, layerState._dockedCompanions) ||
|
||||
(tracked !== null && handedCompanions.has(tracked))
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Leave the near range to the model: the station's dot, and the tracked
|
||||
* dot while the tracked satellite is the station, draw only beyond it.
|
||||
* Asked every frame (the calls cost nothing when nothing changes): a
|
||||
* catalog rebuild or a change of tracked satellite brings new dots that
|
||||
* arrive with no range, and a tracked satellite that leaves the station
|
||||
* (a vehicle undocking) gets its tracked dot back.
|
||||
*/
|
||||
function _handOverDots() {
|
||||
dotHanded = parts.rendering._setPointDisplayRange(norad, farRange);
|
||||
const trackedHere = _trackedOnStation();
|
||||
if (trackedHere) parts.rendering._setTrackedDotDisplayRange(farRange);
|
||||
else if (trackedDotHanded) parts.rendering._setTrackedDotDisplayRange(null);
|
||||
trackedDotHanded = trackedHere;
|
||||
}
|
||||
|
||||
/** Give the station's dot and the tracked dot back at every distance. */
|
||||
function _releaseDots() {
|
||||
if (dotHanded) parts.rendering._setPointDisplayRange(norad, null);
|
||||
dotHanded = false;
|
||||
if (trackedDotHanded) parts.rendering._setTrackedDotDisplayRange(null);
|
||||
trackedDotHanded = false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Objects docked to the station (a module, a crew or cargo ship) have dots
|
||||
* of their own at the station's position. Near the model they are part of
|
||||
* it, and their dots, moved only a few times a second, jump across the
|
||||
* model at 7.6 km/s. While the model shows, their dots draw only beyond its
|
||||
* range too. Rescanned once a second: a vehicle that undocks gets its dot
|
||||
* back, and a catalog rebuild's new dots are picked up.
|
||||
* @param {number} nowMs
|
||||
*/
|
||||
function _handOverCompanions(nowMs) {
|
||||
if (nowMs - lastCompanionScanMs < spec.companionScanMs) return;
|
||||
lastCompanionScanMs = nowMs;
|
||||
const stationPosition = parts.rendering._pointPosition(norad);
|
||||
// The dots are placed at different moments (far apart with the clock sped
|
||||
// up), so their spacing only rules out what is nowhere near. Whether an
|
||||
// object is docked is read from both orbits at one instant.
|
||||
const date = new Date(layerState.now());
|
||||
const stationTeme = _temeKm(layerState._catalog.get(norad)?.satrec, date);
|
||||
if (!stationPosition || !stationTeme) return;
|
||||
for (const [noradId, point] of layerState._points) {
|
||||
if (noradId === norad || !point?.pos) continue;
|
||||
const entry = layerState._catalog.get(noradId);
|
||||
if (entry?.group === 'dense') continue;
|
||||
let docked = false;
|
||||
if (distance(point.pos, stationPosition) <= spec.companionCoarseM) {
|
||||
const teme = _temeKm(entry?.satrec, date);
|
||||
docked =
|
||||
Boolean(teme) &&
|
||||
Math.hypot(
|
||||
teme.x - stationTeme.x,
|
||||
teme.y - stationTeme.y,
|
||||
teme.z - stationTeme.z,
|
||||
) *
|
||||
1000 <=
|
||||
spec.companionRadiusM;
|
||||
}
|
||||
if (docked) {
|
||||
parts.rendering._setPointDisplayRange(noradId, farRange); // no-op when equal
|
||||
handedCompanions.add(noradId);
|
||||
} else if (handedCompanions.has(noradId)) {
|
||||
parts.rendering._setPointDisplayRange(noradId, null);
|
||||
handedCompanions.delete(noradId);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** Give docked objects their dots back at every distance. */
|
||||
function _releaseCompanions() {
|
||||
for (const noradId of handedCompanions)
|
||||
parts.rendering._setPointDisplayRange(noradId, null);
|
||||
handedCompanions.clear();
|
||||
lastCompanionScanMs = Number.NEGATIVE_INFINITY;
|
||||
}
|
||||
|
||||
/** The station's ring back to its own rules (see `syncOrbit`). */
|
||||
function _restoreOrbit() {
|
||||
if (spec.syncOrbit) {
|
||||
spec.syncOrbit();
|
||||
return;
|
||||
}
|
||||
parts.rendering._setOrbitPathShown(
|
||||
norad,
|
||||
parts.controls.satelliteVisualsVisible(
|
||||
layerState._enabled,
|
||||
layerState._params.showOrbits,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Up close the orbit ring (polyline chords, turned once a second) runs off
|
||||
* the model and jumps across it, so it is hidden there.
|
||||
* @param {boolean} near Camera within `orbitHideM` of the station.
|
||||
*/
|
||||
function _syncOrbitCloseUp(near) {
|
||||
if (near) {
|
||||
// Kept hidden every frame: the ring may be built after this.
|
||||
parts.rendering._setOrbitPathShown(norad, false);
|
||||
orbitHidden = true;
|
||||
} else if (orbitHidden) {
|
||||
orbitHidden = false;
|
||||
// Back to the ring's own rules, unless the Cockpit holds it hidden.
|
||||
if (layerState._cockpitHiddenPath !== norad) _restoreOrbit();
|
||||
}
|
||||
// A tracked docked object draws a ring of its own through the model.
|
||||
const tracked = layerState._trackedNorad;
|
||||
const companion =
|
||||
near && tracked !== norad && _trackedOnStation() ? tracked : null;
|
||||
if (companionRingHidden !== null && companionRingHidden !== companion) {
|
||||
// A tracked satellite's ring shows; untracking has already hidden it.
|
||||
if (
|
||||
tracked === companionRingHidden &&
|
||||
layerState._cockpitHiddenPath !== companionRingHidden
|
||||
)
|
||||
parts.rendering._setOrbitPathShown(companionRingHidden, true);
|
||||
companionRingHidden = null;
|
||||
}
|
||||
if (companion !== null) {
|
||||
parts.rendering._setOrbitPathShown(companion, false);
|
||||
companionRingHidden = companion;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the station is this frame, and how it is turned: its centre and
|
||||
* its flight axes.
|
||||
*
|
||||
* The follow camera and the Cockpit camera sit on the tracked satellite's
|
||||
* per-frame sample. While the tracked satellite is the station (its own
|
||||
* entry, or an object docked to it, which has a sample of its own) the
|
||||
* model sits on that same sample, or it would be drawn a frame of orbital
|
||||
* motion (over 100 m) away from where the camera looks. Otherwise it is
|
||||
* placed from the station's own orbit now.
|
||||
* @param {{x:number,y:number,z:number}} result Receives the centre.
|
||||
* @returns {{date: Date, axes: {x:number[], y:number[], z:number[]}}|null}
|
||||
* Null when the orbit cannot be propagated.
|
||||
*/
|
||||
function _stationFrame(result) {
|
||||
const sat = layerState._catalog.get(norad);
|
||||
if (!sat) return null;
|
||||
const trackedSample =
|
||||
_trackedOnStation() && Number.isFinite(layerState._trackedFrameGeo?.atMs)
|
||||
? layerState._trackedFrameGeo
|
||||
: null;
|
||||
const date = new Date(
|
||||
trackedSample ? trackedSample.atMs : layerState.now(),
|
||||
);
|
||||
let posVel;
|
||||
try {
|
||||
posVel = propagate(sat.satrec, date);
|
||||
} catch {
|
||||
posVel = null;
|
||||
}
|
||||
if (
|
||||
!posVel?.position ||
|
||||
typeof posVel.position === 'boolean' ||
|
||||
!posVel.velocity ||
|
||||
typeof posVel.velocity === 'boolean'
|
||||
)
|
||||
return null;
|
||||
const gmst = gstime(date);
|
||||
if (trackedSample) {
|
||||
// The sample the camera and the tracked dot were placed from.
|
||||
copyInto(layerState._trackedFrameCartesian, result);
|
||||
} else {
|
||||
const geo = eciToGeodetic(posVel.position, gmst);
|
||||
copyInto(
|
||||
fromRadians(geo.longitude, geo.latitude, geo.height * 1000),
|
||||
result,
|
||||
);
|
||||
}
|
||||
const axes = stationFlightAxes(
|
||||
result,
|
||||
temeToEcefAxes(posVel.velocity, gmst),
|
||||
);
|
||||
return axes ? { date, axes } : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The Cockpit camera's place on the station: one of the views on the
|
||||
* model, in the world, worked out from the same sample the model is about
|
||||
* to be placed on, so the camera stays on the model however fast the orbit
|
||||
* moves it. The spec's `cockpitMount` chooses the view; null for a station
|
||||
* without views.
|
||||
* @param {string|null} [key] The view asked for; the first on offer when
|
||||
* it is not given or not on offer.
|
||||
* @returns {object|null} Null unless the tracked satellite is the station
|
||||
* and the model is loaded and may show.
|
||||
*/
|
||||
function _cockpitMount(key = null) {
|
||||
if (!spec.cockpitMount) return null;
|
||||
if (!ready || !_trackedOnStation() || !_shouldShow()) return null;
|
||||
const frame = _stationFrame(scratchMountCentre);
|
||||
if (!frame) return null;
|
||||
return spec.cockpitMount({
|
||||
key,
|
||||
centre: scratchMountCentre,
|
||||
axes: frame.axes,
|
||||
name: (noradId) => layerState._catalog.get(noradId)?.name ?? null,
|
||||
// An entry is offered to ride only when it has a dot to track.
|
||||
entry: (noradId) =>
|
||||
noradId !== null && layerState._points.has(noradId) ? noradId : null,
|
||||
dockedVehicle: _dockedVehicle(),
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* A vehicle docked to the station (a Progress, a Shenzhou, a Dragon): the
|
||||
* tracked one when that is what is tracked, else the lowest catalog number
|
||||
* among those docked. The station's own modules have entries too (Zarya,
|
||||
* Nauka; Tianhe, Wentian): they are the station, not a vehicle. Null when
|
||||
* no vehicle is docked.
|
||||
* @returns {number|null}
|
||||
*/
|
||||
function _dockedVehicle() {
|
||||
const vehicle = (noradId) =>
|
||||
noradId !== norad &&
|
||||
!spec.isModule(noradId, layerState._catalog.get(noradId));
|
||||
const tracked = layerState._trackedNorad;
|
||||
if (tracked !== null && vehicle(tracked)) return tracked;
|
||||
let lowest = null;
|
||||
for (const group of [handedCompanions, layerState._dockedCompanions ?? []])
|
||||
for (const noradId of group)
|
||||
if (vehicle(noradId) && (lowest === null || noradId < lowest))
|
||||
lowest = noradId;
|
||||
return lowest;
|
||||
}
|
||||
|
||||
/**
|
||||
* Per-frame update from the layer's preRender tick.
|
||||
* @returns {void}
|
||||
*/
|
||||
function _updateStationModel() {
|
||||
visualValid = false;
|
||||
const show = _shouldShow();
|
||||
if (!show) {
|
||||
_hide();
|
||||
// The dots draw at every distance while the model may not.
|
||||
_releaseDots();
|
||||
if (handedCompanions.size) _releaseCompanions();
|
||||
_syncOrbitCloseUp(false);
|
||||
return;
|
||||
}
|
||||
const dotPosition = parts.rendering._pointPosition(norad);
|
||||
const eye = _eye();
|
||||
const cameraDistance =
|
||||
dotPosition && eye
|
||||
? distance(eye, dotPosition)
|
||||
: Number.POSITIVE_INFINITY;
|
||||
if (!item) {
|
||||
// The file is fetched only once the camera nears the model's range, so
|
||||
// a globe-wide view of the layer never downloads it.
|
||||
if (
|
||||
!loading &&
|
||||
!failed &&
|
||||
resolveAsset &&
|
||||
dotPosition &&
|
||||
cameraDistance <= spec.maxDistanceM * 1.5
|
||||
)
|
||||
_load(dotPosition);
|
||||
return;
|
||||
}
|
||||
// The docked set first: a tracked docked object is the station too.
|
||||
_handOverCompanions(Date.now());
|
||||
_handOverDots();
|
||||
_syncOrbitCloseUp(cameraDistance < spec.orbitHideM);
|
||||
// Out of range the model would not draw anyway: skip the SGP4 sample.
|
||||
if (cameraDistance > spec.maxDistanceM * 1.5) {
|
||||
_hide();
|
||||
return;
|
||||
}
|
||||
|
||||
const frame = _stationFrame(scratchPosition);
|
||||
if (!frame) {
|
||||
_hide();
|
||||
return;
|
||||
}
|
||||
const { date, axes } = frame;
|
||||
copyInto(scratchPosition, visualPosition);
|
||||
copyInto(scratchPosition, item.pos);
|
||||
item.orientation = stationModelOrientation(
|
||||
scratchPosition,
|
||||
axes,
|
||||
spec.localAxes,
|
||||
);
|
||||
telemetry?.touch();
|
||||
articulation.update(nodePoses, date, scratchPosition, axes);
|
||||
item.show = true;
|
||||
_send();
|
||||
visualValid = ready;
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the tracked card should anchor: the station centre the model is
|
||||
* rendering at this frame, or null while the model is not drawn (the card
|
||||
* then keeps the dot's position). Up close the dot's cache can be a frame
|
||||
* ahead of the rendered model, ~130 m of orbit, which shook the card.
|
||||
* @returns {{x:number,y:number,z:number}|null}
|
||||
*/
|
||||
function _visualPosition() {
|
||||
if (!visualValid || !item?.show) return null;
|
||||
const eye = _eye();
|
||||
if (eye && distance(eye, visualPosition) > spec.maxDistanceM) return null;
|
||||
return visualPosition;
|
||||
}
|
||||
|
||||
/**
|
||||
* How far the tracked card must stay from its anchor to clear the model, in
|
||||
* pixels, or null while the dot shows.
|
||||
*/
|
||||
function _cardClearPx() {
|
||||
const position = _visualPosition();
|
||||
const pose = findCamera(layerState._viewer)?.pose?.() ?? null;
|
||||
const height = canvasOf(layerState._viewer)?.clientHeight;
|
||||
const fovy = pose?.fovy;
|
||||
if (!position || !height || !fovy) return null;
|
||||
const cameraDistance = distance(pose.position, position);
|
||||
if (!(cameraDistance > 0)) return null;
|
||||
const pixelsPerMeter = height / (2 * Math.tan(fovy / 2)) / cameraDistance;
|
||||
return Math.min(
|
||||
height * 0.45,
|
||||
Math.max(spec.minPx * 0.35, spec.cardClearM * pixelsPerMeter),
|
||||
);
|
||||
}
|
||||
|
||||
function _destroyStationModel() {
|
||||
loading = false;
|
||||
failed = false;
|
||||
ready = false;
|
||||
visualValid = false;
|
||||
articulation.reset();
|
||||
nodePoses.clear();
|
||||
telemetry?.destroy();
|
||||
_releaseDots();
|
||||
_releaseCompanions();
|
||||
_syncOrbitCloseUp(false);
|
||||
offReady?.();
|
||||
offFailed?.();
|
||||
offReady = null;
|
||||
offFailed = null;
|
||||
set?.dispose();
|
||||
set = null;
|
||||
item = null;
|
||||
}
|
||||
|
||||
/** Whether the model is standing in for this docked object's dot. */
|
||||
function _standsInFor(noradId) {
|
||||
return handedCompanions.has(noradId) && _visualPosition() !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The station's NORAD number when a draw hit landed on its model, so a
|
||||
* click on the model tracks the station as a click on its dot does; null
|
||||
* for any other hit.
|
||||
* @param {{set?: string, id?: string}|null|undefined} hit The click's
|
||||
* `drawHit`.
|
||||
* @returns {number|null}
|
||||
*/
|
||||
function _hitNorad(hit) {
|
||||
return set && hit?.set === set.id && hit.id === itemId ? norad : null;
|
||||
}
|
||||
|
||||
return {
|
||||
key: spec.key,
|
||||
norad,
|
||||
spec,
|
||||
_updateStationModel,
|
||||
_destroyStationModel,
|
||||
_visualPosition,
|
||||
_cardClearPx,
|
||||
_standsInFor,
|
||||
_hitNorad,
|
||||
_cockpitMount,
|
||||
_trackedOnStation,
|
||||
/** Where the joints' angles come from, or null for a station without telemetry. */
|
||||
_telemetryStatus: () => telemetry?.status() ?? null,
|
||||
/** The joint driver, for the STATION section. */
|
||||
_articulation: articulation,
|
||||
/** The node matrices the joint driver last wrote, by node name. */
|
||||
_nodePoses: nodePoses.poses,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,369 @@
|
||||
// src/layers/satellites/stationModel.test.mjs — a station's model over the
|
||||
// rendering part's draw items: it loads once the camera nears its range,
|
||||
// stands in for the station's dot, the docked companions' dots and the
|
||||
// tracked dot within that range (a display range on the dots, the model's
|
||||
// own display condition the other side of it), hides the ring up close, and
|
||||
// gives everything back when it may not show or is destroyed.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import * as Cesium from 'cesium';
|
||||
import { eciToGeodetic, gstime, propagate, twoline2satrec } from 'satellite.js';
|
||||
import { createOrbits } from './orbits.js';
|
||||
import { createRendering } from './rendering.js';
|
||||
import { createStationModel } from './stationModel.js';
|
||||
import {
|
||||
ISS_MODEL_LOCAL_AXES,
|
||||
POINT_STYLES,
|
||||
TRACKED_ORBIT_COLOR,
|
||||
} from './policy.js';
|
||||
import { bindFakeDraw } from '../../testSupport/fakeDrawPort.mjs';
|
||||
import { fakeCameraPort } from '../../testSupport/fakeCameraPort.mjs';
|
||||
|
||||
const STATION = 25544;
|
||||
const COMPANION = 49044;
|
||||
const STRANGER = 32711;
|
||||
const ISS = twoline2satrec(
|
||||
'1 25544U 98067A 08264.51782528 -.00002182 00000-0 -11606-4 0 2927',
|
||||
'2 25544 51.6416 247.4627 0006703 130.5360 325.0288 15.72125391563537',
|
||||
);
|
||||
const AT_MS = Date.UTC(2008, 8, 20, 12, 30, 0);
|
||||
const MAX_M = 1_000_000;
|
||||
/** The dots the model stands in for draw only beyond the model's range. */
|
||||
const FAR_RANGE = [MAX_M, Number.MAX_VALUE];
|
||||
|
||||
/** A satellite's ECEF position at `atMs`, as a plain `{x, y, z}`. */
|
||||
function ecef(satrec, atMs) {
|
||||
const date = new Date(atMs);
|
||||
const geo = eciToGeodetic(propagate(satrec, date).position, gstime(date));
|
||||
const c = Cesium.Cartesian3.fromRadians(
|
||||
geo.longitude,
|
||||
geo.latitude,
|
||||
geo.height * 1000,
|
||||
);
|
||||
return { x: c.x, y: c.y, z: c.z };
|
||||
}
|
||||
|
||||
const settle = () => new Promise((resolve) => setTimeout(resolve, 0));
|
||||
|
||||
const MODEL_SET = 'satellites:station:test';
|
||||
const MODEL_ITEM = 'station:test';
|
||||
|
||||
/**
|
||||
* A station model over the real rendering part, a fake draw port (the
|
||||
* model is an item of a `models` set on it) and a fake camera port. The
|
||||
* station and a companion share an orbit (docked); a stranger's dot sits
|
||||
* 500 km off.
|
||||
*/
|
||||
function fixture(t) {
|
||||
const stationPos = ecef(ISS, AT_MS);
|
||||
const strangerPos = { ...stationPos, x: stationPos.x + 500_000 };
|
||||
const camera = fakeCameraPort({
|
||||
pose: { position: { ...stationPos }, fovy: Math.PI / 3 },
|
||||
});
|
||||
const viewer = { canvas: { clientHeight: 1000 } };
|
||||
const { draw, unbind } = bindFakeDraw(viewer, { camera: camera.port });
|
||||
const state = {
|
||||
now: () => AT_MS,
|
||||
_enabled: true,
|
||||
_params: { showPoints: true, showOrbits: true },
|
||||
_points: new Map(),
|
||||
_orbitPaths: new Map(),
|
||||
_catalog: new Map([
|
||||
[STATION, { satrec: ISS, group: 'core', name: 'ISS (ZARYA)' }],
|
||||
[COMPANION, { satrec: ISS, group: 'core', name: 'ISS (NAUKA)' }],
|
||||
]),
|
||||
_viewer: viewer,
|
||||
_trackedNorad: null,
|
||||
_trackedFrameGeo: null,
|
||||
_trackedFrameNumber: -1,
|
||||
_dockedCompanions: new Set(),
|
||||
_cockpitHiddenPath: null,
|
||||
_cockpitSubjectNorad: null,
|
||||
_lastPropagation: -Infinity,
|
||||
_lastReckonMs: AT_MS,
|
||||
_lastRingRotation: -Infinity,
|
||||
_lastFocusUpdate: -Infinity,
|
||||
_activeFocusCount: 0,
|
||||
};
|
||||
const parts = {
|
||||
orbits: createOrbits({ state: {}, services: {}, parts: {} }),
|
||||
tracking: { _getTrackedFramePosition: () => null },
|
||||
catalog: { _propagateDenseChunk() {} },
|
||||
controls: {
|
||||
_classVisible: () => true,
|
||||
satelliteVisualsVisible: (enabled, requested) =>
|
||||
Boolean(enabled) && Boolean(requested),
|
||||
},
|
||||
};
|
||||
parts.rendering = createRendering({
|
||||
state,
|
||||
services: {
|
||||
focus: {
|
||||
focusNowMs: (ms) => ms,
|
||||
getFocusTarget: () => null,
|
||||
focusPassIsNeeded: () => false,
|
||||
},
|
||||
},
|
||||
parts,
|
||||
});
|
||||
const updates = [];
|
||||
const spec = {
|
||||
key: 'test',
|
||||
label: 'TEST',
|
||||
norad: STATION,
|
||||
modelUrl: '/models/test.glb',
|
||||
scale: 2,
|
||||
minPx: 64,
|
||||
maxDistanceM: MAX_M,
|
||||
orbitHideM: 50_000,
|
||||
cardClearM: 60,
|
||||
companionRadiusM: 5_000,
|
||||
companionCoarseM: 200_000,
|
||||
companionScanMs: 0,
|
||||
localAxes: ISS_MODEL_LOCAL_AXES,
|
||||
isModule: () => true,
|
||||
createArticulation: () => ({
|
||||
update: (...args) => updates.push(args),
|
||||
reset() {},
|
||||
}),
|
||||
createTelemetry: null,
|
||||
cockpitMount: null,
|
||||
hideInCockpit: true,
|
||||
syncOrbit: null,
|
||||
};
|
||||
const model = createStationModel(spec, {
|
||||
state,
|
||||
parts,
|
||||
resolveAsset: (url) => `/assets${url}`,
|
||||
});
|
||||
parts.stationModels = [model];
|
||||
parts.rendering._attach(viewer);
|
||||
parts.rendering._addPoint(STATION, stationPos, POINT_STYLES.iss);
|
||||
parts.rendering._addPoint(COMPANION, stationPos, POINT_STYLES.iss);
|
||||
parts.rendering._addPoint(STRANGER, strangerPos, POINT_STYLES.iss);
|
||||
const points = [...draw.sets.keys()].find((id) => id.endsWith(':points'));
|
||||
const set = (suffix) => draw.set(points.replace(':points', suffix));
|
||||
let frame = 0;
|
||||
t.after(() => unbind());
|
||||
const f = {
|
||||
state,
|
||||
parts,
|
||||
model,
|
||||
updates,
|
||||
stationPos,
|
||||
strangerPos,
|
||||
/** The model's draw set, while it is live. */
|
||||
modelSet: () => draw.set(MODEL_SET),
|
||||
/** The model's draw item, once asked for. */
|
||||
modelItem: () => draw.set(MODEL_SET)?.items.get(MODEL_ITEM),
|
||||
cameraAt(metres) {
|
||||
camera.setPose({
|
||||
position: { ...stationPos, x: stationPos.x + metres },
|
||||
});
|
||||
},
|
||||
tick() {
|
||||
parts.rendering._preRenderTick({ frame: ++frame });
|
||||
},
|
||||
/** Bring the camera into loading range and let the renderer load it. */
|
||||
async load() {
|
||||
f.cameraAt(MAX_M * 1.4);
|
||||
f.tick();
|
||||
draw.ready(MODEL_SET, MODEL_ITEM);
|
||||
await settle();
|
||||
},
|
||||
/** Track `noradId`, placing the tracked sample on the station. */
|
||||
track(noradId, at) {
|
||||
state._trackedNorad = noradId;
|
||||
state._trackedFrameGeo = { atMs: AT_MS };
|
||||
Object.assign(state._trackedFrameCartesian, at);
|
||||
parts.rendering._removeTrackedEntity();
|
||||
parts.rendering._addTrackedEntity({ position: () => at });
|
||||
},
|
||||
drawn: (id) => set(':points').items.get(String(id)),
|
||||
trackedDot: () => set(':tracked').items.get(String(state._trackedNorad)),
|
||||
ring: (id) => set(':rings').items.get(String(id)),
|
||||
};
|
||||
return f;
|
||||
}
|
||||
|
||||
test('the model loads once the camera nears its range, measured from the dot as drawn', async (t) => {
|
||||
const f = fixture(t);
|
||||
f.cameraAt(MAX_M * 5);
|
||||
f.tick();
|
||||
assert.equal(f.modelSet(), undefined, 'a globe-wide view never asks for it');
|
||||
f.cameraAt(MAX_M * 1.4);
|
||||
f.tick();
|
||||
const item = f.modelItem();
|
||||
assert.ok(item, 'one item of a models set of its own');
|
||||
assert.equal(item.url, '/assets/models/test.glb');
|
||||
assert.deepEqual(
|
||||
item.meta,
|
||||
{ norad: STATION },
|
||||
'a click on the model tracks the station',
|
||||
);
|
||||
assert.equal(item.scale, 2);
|
||||
assert.equal(item.minPixelSize, 64);
|
||||
assert.deepEqual(item.displayRange, [0, MAX_M], 'drawn within its range');
|
||||
assert.equal(item.show, false, 'hidden until posed');
|
||||
const writes = f.modelSet().writes;
|
||||
f.cameraAt(MAX_M * 5);
|
||||
f.tick();
|
||||
assert.equal(f.modelSet().writes, writes, 'out of range nothing is sent');
|
||||
assert.equal(f.model._hitNorad({ set: MODEL_SET, id: MODEL_ITEM }), STATION);
|
||||
assert.equal(f.model._hitNorad({ set: 'other', id: MODEL_ITEM }), null);
|
||||
assert.equal(f.model._hitNorad(null), null);
|
||||
assert.equal(
|
||||
f.model._visualPosition(),
|
||||
null,
|
||||
'the card keeps the dot until the renderer has the model',
|
||||
);
|
||||
});
|
||||
|
||||
test('posed, the model sits on the station with its flight axes as heading, pitch and roll', async (t) => {
|
||||
const f = fixture(t);
|
||||
await f.load();
|
||||
f.cameraAt(20_000);
|
||||
f.tick();
|
||||
const item = f.modelItem();
|
||||
assert.equal(item.show, true);
|
||||
assert.ok(Math.abs(item.pos.x - f.stationPos.x) < 1, 'on the station');
|
||||
// The renderer places a model by heading, pitch and roll at its position
|
||||
// (Cesium's headingPitchRollToFixedFrame): the frame that gives must have
|
||||
// the model's local axes where ISS_MODEL_LOCAL_AXES says, zenith away from
|
||||
// the Earth and along-track horizontal.
|
||||
const { heading, pitch, roll } = item.orientation;
|
||||
const at = new Cesium.Cartesian3(item.pos.x, item.pos.y, item.pos.z);
|
||||
const m = Cesium.Transforms.headingPitchRollToFixedFrame(
|
||||
at,
|
||||
new Cesium.HeadingPitchRoll(heading, pitch, roll),
|
||||
);
|
||||
const column = (c) => [m[c * 4], m[c * 4 + 1], m[c * 4 + 2]];
|
||||
const up = Cesium.Cartesian3.normalize(at, new Cesium.Cartesian3());
|
||||
const along = (v) => v[0] * up.x + v[1] * up.y + v[2] * up.z;
|
||||
const zenith = column(ISS_MODEL_LOCAL_AXES.indexOf('z'));
|
||||
assert.ok(
|
||||
Math.abs(along(zenith) - 1) < 1e-6,
|
||||
'the zenith axis points away from the Earth',
|
||||
);
|
||||
const track = column(ISS_MODEL_LOCAL_AXES.indexOf('x'));
|
||||
assert.ok(Math.abs(along(track)) < 1e-6, 'the along-track axis is level');
|
||||
assert.equal(f.updates.length, 1, 'the joints are driven');
|
||||
assert.equal(f.updates[0][0].ready, true, 'into node poses');
|
||||
});
|
||||
|
||||
test('a station without views on its model hides it while the Cockpit rides the station, its own entry or a docked one', async (t) => {
|
||||
const f = fixture(t);
|
||||
let held = false;
|
||||
f.parts.cockpit = { _cockpitHeld: () => held };
|
||||
await f.load();
|
||||
f.cameraAt(20);
|
||||
// Riding a docked object (the companion shares the orbit).
|
||||
f.track(COMPANION, f.stationPos);
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, true, 'outside the Cockpit it draws');
|
||||
held = true;
|
||||
f.tick();
|
||||
assert.equal(
|
||||
f.modelItem().show,
|
||||
false,
|
||||
'the Cockpit camera would sit inside the hull',
|
||||
);
|
||||
assert.equal(f.model._visualPosition(), null);
|
||||
// Riding the station itself.
|
||||
held = false;
|
||||
f.track(STATION, f.stationPos);
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, true);
|
||||
held = true;
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, false);
|
||||
// A station that mounts the Cockpit camera on its model keeps drawing.
|
||||
f.model.spec.hideInCockpit = false;
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, true);
|
||||
});
|
||||
|
||||
test('within its range the model stands in for the dots and hides the ring; beyond it the dots draw', async (t) => {
|
||||
const f = fixture(t);
|
||||
await f.load();
|
||||
f.parts.rendering._showOrbitPath(STATION, TRACKED_ORBIT_COLOR);
|
||||
f.cameraAt(20_000);
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, true);
|
||||
assert.equal(f.updates.length, 1, 'the joints are driven');
|
||||
assert.deepEqual(f.drawn(STATION).displayRange, FAR_RANGE);
|
||||
assert.deepEqual(
|
||||
f.drawn(COMPANION).displayRange,
|
||||
FAR_RANGE,
|
||||
'docked, by orbit against orbit',
|
||||
);
|
||||
assert.equal(f.drawn(STRANGER).displayRange, undefined, 'not docked');
|
||||
assert.equal(
|
||||
f.drawn(STATION).show,
|
||||
true,
|
||||
'the range alone splits the distances',
|
||||
);
|
||||
assert.equal(f.model._standsInFor(COMPANION), true);
|
||||
assert.equal(f.model._standsInFor(STRANGER), false);
|
||||
assert.equal(
|
||||
f.ring(STATION).show,
|
||||
false,
|
||||
'the ring runs off the model up close',
|
||||
);
|
||||
assert.ok(f.model._visualPosition(), 'the card anchors on the model');
|
||||
assert.ok(f.model._cardClearPx() > 0);
|
||||
// The tracked dot too, while the tracked satellite is the station (here
|
||||
// an object docked to it)…
|
||||
f.track(COMPANION, f.stationPos);
|
||||
f.tick();
|
||||
assert.deepEqual(f.trackedDot().displayRange, FAR_RANGE);
|
||||
// …and not once another satellite is tracked.
|
||||
f.track(STRANGER, f.strangerPos);
|
||||
f.tick();
|
||||
assert.equal(f.trackedDot().displayRange, undefined);
|
||||
// Beyond its range the model is not drawn and the dots are, by their range.
|
||||
f.cameraAt(MAX_M * 2.5);
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, false);
|
||||
assert.equal(f.model._visualPosition(), null);
|
||||
assert.deepEqual(f.drawn(STATION).displayRange, FAR_RANGE);
|
||||
assert.equal(f.ring(STATION).show, true, "back to the layer's orbit toggle");
|
||||
});
|
||||
|
||||
test('the dots and the ring come back when the model may not show, and on destroy', async (t) => {
|
||||
const f = fixture(t);
|
||||
await f.load();
|
||||
f.parts.rendering._showOrbitPath(STATION, TRACKED_ORBIT_COLOR);
|
||||
f.track(COMPANION, f.stationPos);
|
||||
f.cameraAt(20_000);
|
||||
f.tick();
|
||||
assert.deepEqual(f.drawn(STATION).displayRange, FAR_RANGE);
|
||||
assert.deepEqual(f.trackedDot().displayRange, FAR_RANGE);
|
||||
assert.equal(f.ring(STATION).show, false);
|
||||
// Points off: the model may not show, so every dot draws at any distance.
|
||||
f.state._params.showPoints = false;
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, false);
|
||||
assert.equal(f.drawn(STATION).displayRange, undefined);
|
||||
assert.equal(f.drawn(COMPANION).displayRange, undefined);
|
||||
assert.equal(f.trackedDot().displayRange, undefined);
|
||||
assert.equal(f.model._standsInFor(COMPANION), false);
|
||||
assert.equal(f.ring(STATION).show, true);
|
||||
// Points on again: handed over again.
|
||||
f.state._params.showPoints = true;
|
||||
f.tick();
|
||||
assert.equal(f.modelItem().show, true);
|
||||
assert.deepEqual(f.drawn(STATION).displayRange, FAR_RANGE);
|
||||
assert.deepEqual(f.drawn(COMPANION).displayRange, FAR_RANGE);
|
||||
assert.deepEqual(f.trackedDot().displayRange, FAR_RANGE);
|
||||
assert.equal(f.ring(STATION).show, false);
|
||||
// Destroyed: the model leaves the scene and the dots are given back.
|
||||
f.model._destroyStationModel();
|
||||
f.parts.rendering._flushPoints();
|
||||
assert.equal(f.modelSet(), undefined, 'its set is disposed');
|
||||
assert.equal(f.drawn(STATION).displayRange, undefined);
|
||||
assert.equal(f.drawn(COMPANION).displayRange, undefined);
|
||||
assert.equal(f.trackedDot().displayRange, undefined);
|
||||
assert.equal(f.ring(STATION).show, true);
|
||||
assert.equal(f.model._visualPosition(), null);
|
||||
});
|
||||
@@ -0,0 +1,92 @@
|
||||
import { STATIONS, stationTrackedOn } from './policy.js';
|
||||
|
||||
/**
|
||||
* Which station a catalog entry belongs to. The layer knows more than one
|
||||
* station (STATIONS in policy.js: the ISS, Tiangong), each drawn as a model
|
||||
* part (stationModel.js) at its own catalog entry and standing in for the
|
||||
* entries docked to it; the parts that key behaviour to "the station" (card
|
||||
* anchor and clearance, detection marks, the LIVE and STATION sections, the
|
||||
* Cockpit's mounts) ask here instead of naming the ISS. The model parts are
|
||||
* read from `parts.stationModels` each time, so a layer built without them
|
||||
* (tests, a part replaced) still answers.
|
||||
*/
|
||||
|
||||
/**
|
||||
* The model whose station `noradId` is drawn as: the station's own entry,
|
||||
* or a docked object whose dot the model stands in for right now.
|
||||
* @param {Array<{norad: number, _standsInFor?: (noradId: number) => boolean}>} models
|
||||
* @param {number|null|undefined} noradId
|
||||
* @returns {object|null}
|
||||
*/
|
||||
export function stationModelFor(models, noradId) {
|
||||
if (noradId === null || noradId === undefined) return null;
|
||||
for (const model of models)
|
||||
if (model.norad === noradId || model._standsInFor?.(noradId)) return model;
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The station that is selected: the tracked satellite is the station
|
||||
* itself, or an object docked to it, judged by the dots sharing a position
|
||||
* (`dockedCompanions`), by both orbits compared when tracking began
|
||||
* (`trackedDockedToStation`, the station's NORAD or null), or by the
|
||||
* station's model standing in for its dot.
|
||||
* @param {ReadonlyArray<{key: string, norad: number}>} stations
|
||||
* @param {Array<{norad: number, _standsInFor?: (noradId: number) => boolean}>} models
|
||||
* @param {{trackedNorad: number|null, dockedCompanions?: {has(id: number): boolean}|null,
|
||||
* trackedDockedToStation?: number|null}} selection
|
||||
* @returns {{key: string, norad: number, model: object|null}|null} The
|
||||
* station and its model part (null when none is built).
|
||||
*/
|
||||
export function trackedStationOf(
|
||||
stations,
|
||||
models,
|
||||
{ trackedNorad, dockedCompanions, trackedDockedToStation },
|
||||
) {
|
||||
if (trackedNorad === null || trackedNorad === undefined) return null;
|
||||
for (const station of stations) {
|
||||
const model = models.find((m) => m.norad === station.norad) ?? null;
|
||||
if (
|
||||
stationTrackedOn(station.norad, trackedNorad, dockedCompanions) ||
|
||||
trackedDockedToStation === station.norad ||
|
||||
Boolean(model?._standsInFor?.(trackedNorad))
|
||||
)
|
||||
return { ...station, model };
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/** The layer's station model parts, as built (index.js). */
|
||||
export function stationModels(parts) {
|
||||
return parts.stationModels ?? [];
|
||||
}
|
||||
|
||||
/** See stationModelFor, over the layer's model parts. */
|
||||
export function modelFor(parts, noradId) {
|
||||
return stationModelFor(stationModels(parts), noradId);
|
||||
}
|
||||
|
||||
/** See trackedStationOf, over the layer's stations, model parts and state. */
|
||||
export function trackedStation(layerState, parts) {
|
||||
return trackedStationOf(STATIONS, stationModels(parts), {
|
||||
trackedNorad: layerState._trackedNorad,
|
||||
dockedCompanions: layerState._dockedCompanions,
|
||||
trackedDockedToStation: layerState._trackedDockedToStation ?? null,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* The station whose model a click's draw hit landed on, over the layer's
|
||||
* model parts: its NORAD number, or null for any other hit.
|
||||
* @param {object} parts
|
||||
* @param {{set?: string, id?: string}|null|undefined} hit
|
||||
* @returns {number|null}
|
||||
*/
|
||||
export function modelHitNorad(parts, hit) {
|
||||
if (!hit) return null;
|
||||
for (const model of stationModels(parts)) {
|
||||
const norad = model._hitNorad?.(hit) ?? null;
|
||||
if (norad !== null) return norad;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
// src/layers/satellites/stationModels.test.mjs — which station a catalog
|
||||
// entry belongs to, over stand-in model parts.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { ISS_NORAD, STATIONS, TIANGONG_NORAD } from './policy.js';
|
||||
import {
|
||||
modelFor,
|
||||
stationModelFor,
|
||||
trackedStation,
|
||||
trackedStationOf,
|
||||
} from './stationModels.js';
|
||||
|
||||
const NAUKA = 49044;
|
||||
const SHENZHOU = 60000;
|
||||
const GPS = 32711;
|
||||
|
||||
const part = (norad, standsIn = []) => ({
|
||||
norad,
|
||||
_standsInFor: (id) => standsIn.includes(id),
|
||||
});
|
||||
|
||||
test('the layer knows the ISS and Tiangong, each with a LIVE key', () => {
|
||||
assert.deepEqual(
|
||||
STATIONS.map((s) => [s.key, s.norad]),
|
||||
[
|
||||
['iss', ISS_NORAD],
|
||||
['tiangong', TIANGONG_NORAD],
|
||||
],
|
||||
);
|
||||
for (const station of STATIONS) assert.ok(station.companionRadiusM > 0);
|
||||
});
|
||||
|
||||
test('an entry is drawn by the model at its own number, or one standing in for it', () => {
|
||||
const iss = part(ISS_NORAD, [NAUKA]);
|
||||
const tiangong = part(TIANGONG_NORAD, [SHENZHOU]);
|
||||
const models = [iss, tiangong];
|
||||
assert.equal(stationModelFor(models, ISS_NORAD), iss);
|
||||
assert.equal(stationModelFor(models, NAUKA), iss);
|
||||
assert.equal(stationModelFor(models, TIANGONG_NORAD), tiangong);
|
||||
assert.equal(stationModelFor(models, SHENZHOU), tiangong);
|
||||
assert.equal(stationModelFor(models, GPS), null);
|
||||
assert.equal(stationModelFor(models, null), null);
|
||||
assert.equal(stationModelFor([], ISS_NORAD), null);
|
||||
});
|
||||
|
||||
test('the selected station: itself, a docked companion by position, by orbit, or by stand-in', () => {
|
||||
const models = [part(ISS_NORAD), part(TIANGONG_NORAD, [SHENZHOU])];
|
||||
const select = (selection) => trackedStationOf(STATIONS, models, selection);
|
||||
assert.equal(select({ trackedNorad: null }), null);
|
||||
assert.equal(select({ trackedNorad: GPS }), null);
|
||||
assert.equal(select({ trackedNorad: ISS_NORAD })?.key, 'iss');
|
||||
assert.equal(select({ trackedNorad: TIANGONG_NORAD })?.key, 'tiangong');
|
||||
// Nauka's dot shares the ISS's position.
|
||||
assert.equal(
|
||||
select({ trackedNorad: NAUKA, dockedCompanions: new Set([ISS_NORAD]) })
|
||||
?.key,
|
||||
'iss',
|
||||
);
|
||||
// A Tianzhou judged docked by orbit when tracking began.
|
||||
assert.equal(
|
||||
select({ trackedNorad: 60001, trackedDockedToStation: TIANGONG_NORAD })
|
||||
?.key,
|
||||
'tiangong',
|
||||
);
|
||||
// A Shenzhou whose dot the Tiangong model stands in for.
|
||||
assert.equal(select({ trackedNorad: SHENZHOU })?.key, 'tiangong');
|
||||
// The answer carries the station's model part, or null without one.
|
||||
assert.equal(select({ trackedNorad: ISS_NORAD })?.model, models[0]);
|
||||
assert.equal(
|
||||
trackedStationOf(STATIONS, [], { trackedNorad: TIANGONG_NORAD })?.model,
|
||||
null,
|
||||
);
|
||||
});
|
||||
|
||||
test('the layer-state readers take the parts as built, or none', () => {
|
||||
const parts = {};
|
||||
const layerState = {
|
||||
_trackedNorad: SHENZHOU,
|
||||
_dockedCompanions: new Set(),
|
||||
_trackedDockedToStation: TIANGONG_NORAD,
|
||||
};
|
||||
assert.equal(modelFor(parts, ISS_NORAD), null);
|
||||
assert.equal(trackedStation(layerState, parts)?.key, 'tiangong');
|
||||
assert.equal(trackedStation(layerState, parts)?.model, null);
|
||||
parts.stationModels = [part(TIANGONG_NORAD)];
|
||||
assert.equal(
|
||||
trackedStation(layerState, parts)?.model,
|
||||
parts.stationModels[0],
|
||||
);
|
||||
assert.equal(modelFor(parts, TIANGONG_NORAD), parts.stationModels[0]);
|
||||
});
|
||||
@@ -0,0 +1,337 @@
|
||||
import { distance } from '../../geo/index.js';
|
||||
import { findCamera, findFrame } from '../../render/rendererOf.js';
|
||||
import {
|
||||
issCommandCameraOnStation,
|
||||
issCommandOffersZoom,
|
||||
issCommandZoomOffset,
|
||||
} from './issCommand.js';
|
||||
|
||||
/**
|
||||
* The STATION section in Context, for whichever station is selected. A
|
||||
* station is described once (`issStation.js` describes the ISS) and this
|
||||
* presents it: Automatic, where the joints follow their rules and the panel
|
||||
* says where the angles come from (telemetry, or computed when there is
|
||||
* none); Manual, where the person moves them with the controls the
|
||||
* description lists; and a zoom to the station from far away. Another
|
||||
* station plugs in with a description of its own.
|
||||
*
|
||||
* @typedef {object} StationDescription
|
||||
* @property {string} key Short id, e.g. 'iss'.
|
||||
* @property {string} title The station's name, as a badge.
|
||||
* @property {() => boolean} selected Whether this station is the tracked
|
||||
* subject (also as one of its docked entries).
|
||||
* @property {() => string} subjectName The tracked entry's name.
|
||||
* @property {() => object|null} articulation The joint driver.
|
||||
* @property {() => {state: string, poseAgeMs: number|null,
|
||||
* liveUntilMs: number|null}|null} telemetry Where the angles come from.
|
||||
* @property {() => {x: number, y: number, z: number}|null} position The
|
||||
* station's drawn centre (ECEF metres), for the zoom.
|
||||
* @property {string} zoomLabel The zoom button's text (a msg key).
|
||||
* @property {{live?: string, computed: string}} notes Automatic's note on
|
||||
* what moves the joints (msg keys): `live` while the articulation reports
|
||||
* telemetry, `computed` otherwise (and always, for a station without a
|
||||
* feed).
|
||||
* @property {Array<{id: string, label: string, note?: string|null,
|
||||
* kind: 'choices', choices: Array<{id: string, label: string,
|
||||
* isDefault?: boolean, apply: (articulation: object) => void}>}|
|
||||
* {id: string, label: string, kind: 'sliders', resume?: string,
|
||||
* sliders: Array<{id: string, label: string, min: number, max: number,
|
||||
* apply: (articulation: object, value: number) => void}>,
|
||||
* resumeApply?: (articulation: object) => void}>} groups Manual controls.
|
||||
* @property {(articulation: object) => void} automatic Hand every joint
|
||||
* back to its rule.
|
||||
*/
|
||||
|
||||
/** How often the status line's age is refreshed while the panel shows. */
|
||||
export const STATION_PANEL_TICK_MS = 1000;
|
||||
|
||||
/**
|
||||
* @param {{state: object, parts: object, stations: StationDescription[],
|
||||
* now?: () => number}} context
|
||||
*/
|
||||
export function createStationPanel({
|
||||
state: layerState,
|
||||
parts,
|
||||
stations,
|
||||
now = Date.now,
|
||||
}) {
|
||||
const listeners = new Set();
|
||||
let view = null;
|
||||
/** The station shown, its mode, its Manual choices and slider values. */
|
||||
let current = null;
|
||||
let mode = 'automatic';
|
||||
let choices = new Map();
|
||||
let sliders = new Map();
|
||||
let ticker = null;
|
||||
let zoomTimer = null;
|
||||
|
||||
function _stationShown() {
|
||||
if (!layerState._enabled) return null;
|
||||
// The right rail is hidden while the Cockpit rides; nothing to show.
|
||||
if (parts.cockpit?._cockpitHeld()) return null;
|
||||
return stations.find((station) => station.selected()) ?? null;
|
||||
}
|
||||
|
||||
function _resetManual(station) {
|
||||
choices = new Map();
|
||||
sliders = new Map();
|
||||
for (const group of station?.groups ?? []) {
|
||||
if (group.kind === 'choices') {
|
||||
const chosen = group.choices.find((choice) => choice.isDefault);
|
||||
if (chosen) choices.set(group.id, chosen.id);
|
||||
} else for (const slider of group.sliders) sliders.set(slider.id, 0);
|
||||
}
|
||||
}
|
||||
|
||||
function _publish() {
|
||||
const station = current;
|
||||
if (!station) {
|
||||
if (view !== null) {
|
||||
view = null;
|
||||
for (const listener of listeners) listener(null);
|
||||
}
|
||||
return;
|
||||
}
|
||||
const articulation = station.articulation();
|
||||
const position = station.position();
|
||||
const eye = position
|
||||
? (findCamera(layerState._viewer)?.pose?.()?.position ?? null)
|
||||
: null;
|
||||
const range = position && eye ? distance(eye, position) : null;
|
||||
view = {
|
||||
key: station.key,
|
||||
title: station.title,
|
||||
subject: station.subjectName(),
|
||||
mode,
|
||||
telemetry: station.telemetry(),
|
||||
sunlit: mode === 'manual' ? null : (articulation?.isSunlit?.() ?? null),
|
||||
note:
|
||||
(articulation?.isLive?.() ? station.notes?.live : null) ??
|
||||
station.notes?.computed ??
|
||||
'',
|
||||
groups: station.groups.map((group) =>
|
||||
group.kind === 'choices'
|
||||
? {
|
||||
id: group.id,
|
||||
label: group.label,
|
||||
note: group.note ?? null,
|
||||
kind: 'choices',
|
||||
choices: group.choices.map((choice) => ({
|
||||
id: choice.id,
|
||||
label: choice.label,
|
||||
active: choices.get(group.id) === choice.id,
|
||||
})),
|
||||
}
|
||||
: {
|
||||
id: group.id,
|
||||
label: group.label,
|
||||
note: group.note ?? null,
|
||||
kind: 'sliders',
|
||||
resume: group.resume ?? null,
|
||||
sliders: group.sliders.map((slider) => ({
|
||||
id: slider.id,
|
||||
label: slider.label,
|
||||
min: slider.min,
|
||||
max: slider.max,
|
||||
value: sliders.get(slider.id) ?? 0,
|
||||
})),
|
||||
},
|
||||
),
|
||||
zoom: {
|
||||
offered:
|
||||
range !== null && issCommandOffersZoom(range) && _cameraOnStation(),
|
||||
label: station.zoomLabel,
|
||||
},
|
||||
};
|
||||
for (const listener of listeners) listener(view);
|
||||
}
|
||||
|
||||
function _tick() {
|
||||
if (ticker) return;
|
||||
ticker = setInterval(() => {
|
||||
if (!current) {
|
||||
clearInterval(ticker);
|
||||
ticker = null;
|
||||
return;
|
||||
}
|
||||
_publish();
|
||||
_requestRender();
|
||||
}, STATION_PANEL_TICK_MS);
|
||||
ticker.unref?.();
|
||||
}
|
||||
|
||||
/** Ask the renderer for a frame, through the frame port. */
|
||||
function _requestRender() {
|
||||
findFrame(layerState._viewer)?.requestRender('station-panel');
|
||||
}
|
||||
|
||||
/** Keep frames coming while a joint glides to a new pose. */
|
||||
function _renderFor(ms) {
|
||||
if (!findFrame(layerState._viewer)) return;
|
||||
const until = now() + ms;
|
||||
const pump = setInterval(() => {
|
||||
_requestRender();
|
||||
if (now() > until) clearInterval(pump);
|
||||
}, 33);
|
||||
pump.unref?.();
|
||||
}
|
||||
|
||||
function _stopZoom() {
|
||||
if (zoomTimer) clearInterval(zoomTimer);
|
||||
zoomTimer = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the camera follows the layer's follow target, framed (see
|
||||
* issCommand.js): the tracked satellite is the station, or docked to it.
|
||||
*/
|
||||
function _cameraOnStation() {
|
||||
return issCommandCameraOnStation(
|
||||
findCamera(layerState._viewer),
|
||||
layerState._followTarget,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Bring the follow camera in to the station, a step per frame. Only while
|
||||
* the follow camera is on it: from any other camera the steps would lead
|
||||
* away, and a zoom pressed during the flight to the station would do so.
|
||||
*/
|
||||
function _zoom() {
|
||||
_stopZoom();
|
||||
if (!_cameraOnStation()) return false;
|
||||
let steps = 0;
|
||||
zoomTimer = setInterval(() => {
|
||||
const camera = findCamera(layerState._viewer);
|
||||
steps += 1;
|
||||
if (
|
||||
!camera ||
|
||||
!current?.position() ||
|
||||
!current?.selected() ||
|
||||
!_cameraOnStation() ||
|
||||
steps > 400
|
||||
) {
|
||||
_stopZoom();
|
||||
return;
|
||||
}
|
||||
// While the camera follows the station, its follow offset is the eye's
|
||||
// offset from it: shorten that, never move along the view. The port
|
||||
// asks for the frame itself.
|
||||
const next = issCommandZoomOffset(camera.followOffset.get());
|
||||
if (!next) {
|
||||
_stopZoom();
|
||||
return;
|
||||
}
|
||||
camera.followOffset.set(next);
|
||||
}, 16);
|
||||
return true;
|
||||
}
|
||||
|
||||
const actions = {
|
||||
setStationMode(next) {
|
||||
const articulation = current?.articulation();
|
||||
if (!current || !articulation) return false;
|
||||
const wanted = next === 'manual' ? 'manual' : 'automatic';
|
||||
if (wanted === mode) return true;
|
||||
mode = wanted;
|
||||
if (mode === 'manual') articulation.setTelemetryAllowed?.(false);
|
||||
else {
|
||||
_resetManual(current);
|
||||
current.automatic(articulation);
|
||||
}
|
||||
_renderFor(20_000);
|
||||
_publish();
|
||||
return true;
|
||||
},
|
||||
chooseStation(groupId, choiceId) {
|
||||
const articulation = current?.articulation();
|
||||
const group = current?.groups.find((g) => g.id === groupId);
|
||||
const choice = group?.choices?.find((c) => c.id === choiceId);
|
||||
if (!articulation || !choice) return false;
|
||||
choices.set(groupId, choiceId);
|
||||
choice.apply(articulation);
|
||||
_renderFor(20_000);
|
||||
_publish();
|
||||
return true;
|
||||
},
|
||||
slideStation(sliderId, value) {
|
||||
const articulation = current?.articulation();
|
||||
const group = current?.groups.find((g) =>
|
||||
g.sliders?.some((s) => s.id === sliderId),
|
||||
);
|
||||
const slider = group?.sliders.find((s) => s.id === sliderId);
|
||||
const number = Number(value);
|
||||
if (!articulation || !slider || !Number.isFinite(number)) return false;
|
||||
const clamped = Math.min(slider.max, Math.max(slider.min, number));
|
||||
sliders.set(sliderId, clamped);
|
||||
slider.apply(articulation, clamped);
|
||||
_renderFor(2000);
|
||||
_publish();
|
||||
return true;
|
||||
},
|
||||
resumeStationArm(groupId) {
|
||||
const articulation = current?.articulation();
|
||||
const group = current?.groups.find((g) => g.id === groupId);
|
||||
if (!articulation || !group?.resumeApply) return false;
|
||||
for (const slider of group.sliders) sliders.set(slider.id, 0);
|
||||
group.resumeApply(articulation);
|
||||
_renderFor(20_000);
|
||||
_publish();
|
||||
return true;
|
||||
},
|
||||
zoomStation() {
|
||||
if (!current) return false;
|
||||
return _zoom();
|
||||
},
|
||||
};
|
||||
|
||||
/**
|
||||
* Per tick and on tracking changes: show the selected station's panel,
|
||||
* or take it down. Leaving a station hands its joints back to Automatic,
|
||||
* so no manual pose lingers.
|
||||
*/
|
||||
function _syncStationPanel() {
|
||||
const station = _stationShown();
|
||||
if (station !== current) {
|
||||
if (current && mode === 'manual') {
|
||||
const articulation = current.articulation();
|
||||
if (articulation) current.automatic(articulation);
|
||||
}
|
||||
_stopZoom();
|
||||
current = station;
|
||||
mode = 'automatic';
|
||||
_resetManual(station);
|
||||
if (station) _tick();
|
||||
}
|
||||
_publish();
|
||||
}
|
||||
|
||||
function _destroyStationPanel() {
|
||||
_stopZoom();
|
||||
if (ticker) clearInterval(ticker);
|
||||
ticker = null;
|
||||
current = null;
|
||||
mode = 'automatic';
|
||||
_publish();
|
||||
}
|
||||
|
||||
const methods = {
|
||||
/**
|
||||
* Receive the STATION section's view: the current one at once, then
|
||||
* each change; null while no station is selected.
|
||||
* @param {(view: object|null) => void} listener
|
||||
* @returns {() => void} Stops listening.
|
||||
*/
|
||||
subscribeStationPanel(listener) {
|
||||
listeners.add(listener);
|
||||
listener(view);
|
||||
return () => listeners.delete(listener);
|
||||
},
|
||||
/** The actions the section's controls call (the store's owners). */
|
||||
getStationActions() {
|
||||
return actions;
|
||||
},
|
||||
};
|
||||
|
||||
return { _syncStationPanel, _destroyStationPanel, methods };
|
||||
}
|
||||
@@ -0,0 +1,350 @@
|
||||
// src/layers/satellites/stationPanel.test.mjs — the STATION section's
|
||||
// presenter, over a stand-in station description.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { bindFakeDraw } from '../../testSupport/fakeDrawPort.mjs';
|
||||
import { ISS_COMMAND_ZOOM_RANGE_M } from './issCommand.js';
|
||||
import { createStationPanel } from './stationPanel.js';
|
||||
|
||||
/**
|
||||
* A camera port that follows what it is told to and keeps a follow offset,
|
||||
* as the renderer's does once the follow has framed the eye.
|
||||
*/
|
||||
function fakeFollowCamera({ eye, offset }) {
|
||||
const camera = {
|
||||
eye,
|
||||
offset,
|
||||
followed: null,
|
||||
followFramed: false,
|
||||
offsetsSet: [],
|
||||
pose: () => ({ position: { ...camera.eye } }),
|
||||
followOffset: {
|
||||
get: () => (camera.followFramed ? { ...camera.offset } : null),
|
||||
set(next) {
|
||||
camera.offset = { ...next };
|
||||
camera.offsetsSet.push({ ...next });
|
||||
},
|
||||
},
|
||||
};
|
||||
return camera;
|
||||
}
|
||||
|
||||
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
|
||||
|
||||
function fixture() {
|
||||
const calls = [];
|
||||
const articulation = {
|
||||
isSunlit: () => true,
|
||||
isLive: () => false,
|
||||
setTelemetryAllowed: (allowed) => calls.push(['telemetry', allowed]),
|
||||
};
|
||||
let selected = false;
|
||||
let held = false;
|
||||
let position = null;
|
||||
let telemetry = { state: 'live', poseAgeMs: 3000, liveUntilMs: null };
|
||||
const station = {
|
||||
key: 'test',
|
||||
title: 'TEST',
|
||||
selected: () => selected,
|
||||
subjectName: () => 'TEST STATION',
|
||||
articulation: () => articulation,
|
||||
telemetry: () => telemetry,
|
||||
position: () => position,
|
||||
zoomLabel: 'Zoom to the station',
|
||||
notes: {
|
||||
live: 'Joints on live telemetry.',
|
||||
computed: 'Computed, not live telemetry.',
|
||||
},
|
||||
groups: [
|
||||
{
|
||||
id: 'sun',
|
||||
label: 'Sun position',
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'follow',
|
||||
label: 'Follow',
|
||||
isDefault: true,
|
||||
apply: () => calls.push(['sun', 'follow']),
|
||||
},
|
||||
{
|
||||
id: 'ahead',
|
||||
label: 'Ahead',
|
||||
apply: () => calls.push(['sun', 'ahead']),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'arm',
|
||||
label: 'Arm',
|
||||
kind: 'sliders',
|
||||
resume: 'Resume',
|
||||
sliders: [
|
||||
{
|
||||
id: 'shoulder',
|
||||
label: 'Shoulder',
|
||||
min: -120,
|
||||
max: 120,
|
||||
apply: (a, v) => calls.push(['shoulder', v]),
|
||||
},
|
||||
{
|
||||
id: 'elbow',
|
||||
label: 'Elbow',
|
||||
min: -90,
|
||||
max: 90,
|
||||
apply: (a, v) => calls.push(['elbow', v]),
|
||||
},
|
||||
],
|
||||
resumeApply: () => calls.push(['resume']),
|
||||
},
|
||||
],
|
||||
automatic: () => calls.push(['automatic']),
|
||||
};
|
||||
const layerState = { _enabled: true, _viewer: null };
|
||||
const parts = { cockpit: { _cockpitHeld: () => held } };
|
||||
const panel = createStationPanel({
|
||||
state: layerState,
|
||||
parts,
|
||||
stations: [station],
|
||||
});
|
||||
const views = [];
|
||||
panel.methods.subscribeStationPanel((view) => views.push(view));
|
||||
const actions = panel.methods.getStationActions();
|
||||
return {
|
||||
panel,
|
||||
actions,
|
||||
calls,
|
||||
views,
|
||||
view: () => views.at(-1),
|
||||
layerState,
|
||||
select: (on) => (selected = on),
|
||||
hold: (on) => (held = on),
|
||||
setTelemetry: (next) => (telemetry = next),
|
||||
setPosition: (next) => (position = next),
|
||||
};
|
||||
}
|
||||
|
||||
test('the zoom is offered, and runs, only while the follow camera is on the station', async (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
const viewer = {};
|
||||
const camera = fakeFollowCamera({
|
||||
eye: { x: 5000, y: 0, z: 0 },
|
||||
offset: { x: 3000, y: 4000, z: 0 },
|
||||
});
|
||||
const frames = [];
|
||||
const { unbind } = bindFakeDraw(viewer, {
|
||||
camera,
|
||||
frame: { requestRender: (reason) => frames.push(reason) },
|
||||
});
|
||||
t.after(unbind);
|
||||
const target = { key: 'satellites:25544' };
|
||||
f.layerState._viewer = viewer;
|
||||
f.layerState._followTarget = target;
|
||||
f.setPosition({ x: 0, y: 0, z: 0 });
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().zoom.offered, false, 'still flying to the station');
|
||||
assert.equal(f.actions.zoomStation(), false);
|
||||
camera.followed = { key: 'flights:other' };
|
||||
camera.followFramed = true;
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().zoom.offered, false, 'following something else');
|
||||
camera.followed = target;
|
||||
camera.followFramed = false;
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().zoom.offered, false, 'the follow has not framed yet');
|
||||
camera.followFramed = true;
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().zoom.offered, true);
|
||||
assert.equal(f.actions.zoomStation(), true);
|
||||
await sleep(120);
|
||||
const ranges = camera.offsetsSet.map((o) => Math.hypot(o.x, o.y, o.z));
|
||||
assert.ok(ranges.length >= 3, 'the zoom stepped the follow offset');
|
||||
for (let i = 0; i < ranges.length; i++) {
|
||||
const before = i === 0 ? 5000 : ranges[i - 1];
|
||||
assert.ok(
|
||||
ranges[i] < before,
|
||||
`step ${i} came in: ${before} -> ${ranges[i]}`,
|
||||
);
|
||||
assert.ok(ranges[i] >= ISS_COMMAND_ZOOM_RANGE_M, 'never past the range');
|
||||
}
|
||||
// The bearing is kept: the offset only shortens.
|
||||
const last = camera.offsetsSet.at(-1);
|
||||
assert.ok(Math.abs(last.x / last.y - 3 / 4) < 1e-9);
|
||||
assert.equal(last.z, 0);
|
||||
// The follow ending stops the zoom where it is.
|
||||
camera.followed = null;
|
||||
const steps = camera.offsetsSet.length;
|
||||
await sleep(50);
|
||||
assert.equal(camera.offsetsSet.length, steps);
|
||||
camera.followed = target;
|
||||
camera.eye = { x: 300, y: 0, z: 0 };
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().zoom.offered, false, 'close in, the zoom goes');
|
||||
assert.ok(frames.length === 0 || frames.every((r) => r === 'station-panel'));
|
||||
});
|
||||
|
||||
test('a new subscriber gets the current view at once: nothing while no station is selected', () => {
|
||||
const f = fixture();
|
||||
assert.deepEqual(f.views, [null]);
|
||||
f.panel._syncStationPanel();
|
||||
assert.deepEqual(f.views, [null], 'unchanged nothing is not re-published');
|
||||
f.panel._destroyStationPanel();
|
||||
});
|
||||
|
||||
test('selecting the station publishes it in Automatic with its defaults', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
const view = f.view();
|
||||
assert.equal(view.key, 'test');
|
||||
assert.equal(view.title, 'TEST');
|
||||
assert.equal(view.subject, 'TEST STATION');
|
||||
assert.equal(view.mode, 'automatic');
|
||||
assert.deepEqual(view.telemetry, {
|
||||
state: 'live',
|
||||
poseAgeMs: 3000,
|
||||
liveUntilMs: null,
|
||||
});
|
||||
assert.equal(view.sunlit, true);
|
||||
assert.match(view.note, /Computed, not live telemetry/);
|
||||
assert.deepEqual(
|
||||
view.groups[0].choices.map((c) => [c.id, c.active]),
|
||||
[
|
||||
['follow', true],
|
||||
['ahead', false],
|
||||
],
|
||||
);
|
||||
assert.deepEqual(
|
||||
view.groups[1].sliders.map((s) => s.value),
|
||||
[0, 0],
|
||||
);
|
||||
assert.equal(view.groups[1].resume, 'Resume');
|
||||
assert.deepEqual(view.zoom, { offered: false, label: 'Zoom to the station' });
|
||||
assert.deepEqual(f.calls, [], 'Automatic touches nothing on entry');
|
||||
});
|
||||
|
||||
test('Manual pauses telemetry and offers the controls; Automatic hands the joints back', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.actions.setStationMode('manual'), true);
|
||||
assert.equal(f.view().mode, 'manual');
|
||||
assert.equal(f.view().sunlit, null, "the Sun line is Automatic's");
|
||||
assert.deepEqual(f.calls, [['telemetry', false]]);
|
||||
assert.equal(f.actions.setStationMode('manual'), true, 'again is a no-op');
|
||||
assert.equal(f.calls.length, 1);
|
||||
assert.equal(f.actions.chooseStation('sun', 'ahead'), true);
|
||||
assert.equal(f.view().groups[0].choices[1].active, true);
|
||||
assert.equal(f.actions.setStationMode('automatic'), true);
|
||||
assert.equal(f.view().mode, 'automatic');
|
||||
assert.deepEqual(f.calls.at(-1), ['automatic']);
|
||||
assert.equal(f.view().groups[0].choices[0].active, true, 'choices reset');
|
||||
});
|
||||
|
||||
test('choices apply to the articulation; an unknown choice is refused', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.actions.chooseStation('sun', 'ahead'), true);
|
||||
assert.deepEqual(f.calls, [['sun', 'ahead']]);
|
||||
assert.equal(f.actions.chooseStation('sun', 'nowhere'), false);
|
||||
assert.equal(f.actions.chooseStation('arm', 'ahead'), false);
|
||||
});
|
||||
|
||||
test('sliders clamp to their range and refuse non-numbers', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.actions.slideStation('shoulder', '45'), true);
|
||||
assert.equal(f.actions.slideStation('elbow', 500), true);
|
||||
assert.equal(f.actions.slideStation('elbow', 'abc'), false);
|
||||
assert.equal(f.actions.slideStation('wrist', 10), false);
|
||||
assert.deepEqual(f.calls, [
|
||||
['shoulder', 45],
|
||||
['elbow', 90],
|
||||
]);
|
||||
assert.deepEqual(
|
||||
f.view().groups[1].sliders.map((s) => s.value),
|
||||
[45, 90],
|
||||
);
|
||||
assert.equal(f.actions.resumeStationArm('arm'), true);
|
||||
assert.deepEqual(f.calls.at(-1), ['resume']);
|
||||
assert.deepEqual(
|
||||
f.view().groups[1].sliders.map((s) => s.value),
|
||||
[0, 0],
|
||||
);
|
||||
assert.equal(
|
||||
f.actions.resumeStationArm('sun'),
|
||||
false,
|
||||
'choices have no resume',
|
||||
);
|
||||
});
|
||||
|
||||
test('leaving the station in Manual hands its joints back and takes the section down', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
f.actions.setStationMode('manual');
|
||||
f.actions.slideStation('shoulder', 30);
|
||||
f.select(false);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view(), null);
|
||||
assert.deepEqual(f.calls.at(-1), ['automatic']);
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().mode, 'automatic');
|
||||
assert.deepEqual(
|
||||
f.view().groups[1].sliders.map((s) => s.value),
|
||||
[0, 0],
|
||||
);
|
||||
});
|
||||
|
||||
test('the section is away while the Cockpit holds the rail, and while the layer is off', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.hold(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view(), null);
|
||||
f.hold(false);
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().key, 'test');
|
||||
f.layerState._enabled = false;
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view(), null);
|
||||
});
|
||||
|
||||
test('every sync re-reads the telemetry status for the status line', (t) => {
|
||||
const f = fixture();
|
||||
t.after(() => f.panel._destroyStationPanel());
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
f.setTelemetry({
|
||||
state: 'unavailable',
|
||||
poseAgeMs: 61_000,
|
||||
liveUntilMs: null,
|
||||
});
|
||||
f.panel._syncStationPanel();
|
||||
assert.equal(f.view().telemetry.state, 'unavailable');
|
||||
});
|
||||
|
||||
test('actions without a station are refused; destroy publishes nothing', () => {
|
||||
const f = fixture();
|
||||
assert.equal(f.actions.setStationMode('manual'), false);
|
||||
assert.equal(f.actions.chooseStation('sun', 'ahead'), false);
|
||||
assert.equal(f.actions.slideStation('shoulder', 1), false);
|
||||
assert.equal(f.actions.resumeStationArm('arm'), false);
|
||||
assert.equal(f.actions.zoomStation(), false);
|
||||
f.select(true);
|
||||
f.panel._syncStationPanel();
|
||||
assert.ok(f.view());
|
||||
f.panel._destroyStationPanel();
|
||||
assert.equal(f.view(), null);
|
||||
});
|
||||
@@ -0,0 +1,472 @@
|
||||
import { sunPositionFixed } from '../../geo/celestial.js';
|
||||
import {
|
||||
ISS_JOINT_RATE,
|
||||
issAimMatrix,
|
||||
issArmAngles,
|
||||
issAxisMatrix,
|
||||
issInShadow,
|
||||
issRelayDirections,
|
||||
issStepAngle,
|
||||
issStepDirection,
|
||||
issSunInModelFrame,
|
||||
} from './issArticulation.js';
|
||||
import { tiangongJoint } from './tiangongJoints.js';
|
||||
|
||||
/**
|
||||
* Tiangong's moving parts, driven from the joint table (tiangongJoints.js):
|
||||
* every angle is computed, since China publishes no live telemetry for the
|
||||
* station. The rules are the ISS's (issArticulation.js), written for joints
|
||||
* whose axes and rest normals come from the table instead of being fixed:
|
||||
*
|
||||
* - a wing on one joint (Tianhe's two, each visiting vehicle's two) turns
|
||||
* about its boom so its cell side faces the Sun;
|
||||
* - a lab wing (Wentian's and Mengtian's two each) turns first about the
|
||||
* lab's axis (alpha), so the wing's own axis is across the Sun, then about
|
||||
* that axis (beta), so the cells face it, the ISS's SARJ/BGA pair;
|
||||
* - in the Earth's shadow the wings turn flat to the Earth (cell side to
|
||||
* zenith), which puts them edge-on to the flight direction, the ISS's
|
||||
* feathering;
|
||||
* - the high-gain antenna aims at the highest of China's Tianlian relay
|
||||
* satellites over the equator;
|
||||
* - the two arms sway slowly for illustration (their real pose is not public).
|
||||
*
|
||||
* Joints turn at most ISS_JOINT_RATE on screen.
|
||||
*/
|
||||
|
||||
/** Below this the Sun is too close to a joint's axis to steer by it. */
|
||||
const MIN_STEER = 0.05;
|
||||
/** The dish does not look below this much above the station's horizon plane. */
|
||||
const DISH_MIN_UP = 0.15;
|
||||
/** Where the wings turn in shadow: cell side to zenith, on the model's axes. */
|
||||
const ZENITH = Object.freeze([0, 1, 0]);
|
||||
|
||||
const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
||||
const cross = (a, b) => [
|
||||
a[1] * b[2] - a[2] * b[1],
|
||||
a[2] * b[0] - a[0] * b[2],
|
||||
a[0] * b[1] - a[1] * b[0],
|
||||
];
|
||||
|
||||
/** `v` turned by `angle` about the unit vector `axis` (Rodrigues). */
|
||||
function rotate(v, axis, angle) {
|
||||
const c = Math.cos(angle);
|
||||
const s = Math.sin(angle);
|
||||
const k = cross(axis, v);
|
||||
const d = dot(axis, v) * (1 - c);
|
||||
return [0, 1, 2].map((i) => v[i] * c + k[i] * s + axis[i] * d);
|
||||
}
|
||||
|
||||
/** The signed difference wrapped to (-π, π]. */
|
||||
function wrap(delta) {
|
||||
let d = delta % (2 * Math.PI);
|
||||
if (d > Math.PI) d -= 2 * Math.PI;
|
||||
if (d <= -Math.PI) d += 2 * Math.PI;
|
||||
return d;
|
||||
}
|
||||
|
||||
/** Of `angle` and `angle + π`, the one nearer to `previous`. */
|
||||
function nearestHalfTurn(angle, previous) {
|
||||
const flipped = angle + Math.PI;
|
||||
return Math.abs(wrap(angle - previous)) <= Math.abs(wrap(flipped - previous))
|
||||
? angle
|
||||
: flipped;
|
||||
}
|
||||
|
||||
const wing = (node, normal) =>
|
||||
Object.freeze({ ...tiangongJoint(node), normal: Object.freeze(normal) });
|
||||
|
||||
/**
|
||||
* Wings turned by one joint, with the cell side's normal at rest. The
|
||||
* station's and the forward and aft vehicles' wings lie flat (cells up); the
|
||||
* nadir Shenzhou hangs below the node, so its wings' cells face forward.
|
||||
*/
|
||||
export const TIANGONG_ONE_AXIS_WINGS = Object.freeze([
|
||||
wing('TIANHE_ARRAY_PORT_ALPHA', ZENITH),
|
||||
wing('TIANHE_ARRAY_STBD_ALPHA', ZENITH),
|
||||
wing('SHENZHOU_FORWARD_ARRAY_PORT_ALPHA', ZENITH),
|
||||
wing('SHENZHOU_FORWARD_ARRAY_STBD_ALPHA', ZENITH),
|
||||
wing('SHENZHOU_NADIR_ARRAY_PORT_ALPHA', [0, 0, 1]),
|
||||
wing('SHENZHOU_NADIR_ARRAY_STBD_ALPHA', [0, 0, 1]),
|
||||
wing('TIANZHOU_AFT_ARRAY_PORT_ALPHA', ZENITH),
|
||||
wing('TIANZHOU_AFT_ARRAY_STBD_ALPHA', ZENITH),
|
||||
]);
|
||||
|
||||
/** The lab wings: an alpha joint about the lab's axis, a beta joint under it. */
|
||||
export const TIANGONG_TWO_AXIS_WINGS = Object.freeze(
|
||||
[
|
||||
'WENTIAN_ARRAY_FWD',
|
||||
'WENTIAN_ARRAY_AFT',
|
||||
'MENGTIAN_ARRAY_FWD',
|
||||
'MENGTIAN_ARRAY_AFT',
|
||||
].map((stem) =>
|
||||
Object.freeze({
|
||||
alpha: tiangongJoint(`${stem}_ALPHA`),
|
||||
beta: tiangongJoint(`${stem}_BETA`),
|
||||
normal: ZENITH,
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
/**
|
||||
* The arms' joints, base to tip, with the illustrative sway: `centre` and
|
||||
* `sway` radians over `period` seconds, about the folded pose in the file.
|
||||
* The joints that lift the booms sway on one side of rest only, so the arms
|
||||
* rise off the hull and never swing into it.
|
||||
*/
|
||||
const arm = (prefix, sway) =>
|
||||
Object.freeze(
|
||||
['SHR', 'SHY', 'SHP', 'EP', 'WP', 'WY', 'WR'].map((name) => {
|
||||
const [centreDeg = 0, swayDeg = 0, period = 0] = sway[name] ?? [];
|
||||
return Object.freeze({
|
||||
...tiangongJoint(`${prefix}_${name}`),
|
||||
centre: (centreDeg * Math.PI) / 180,
|
||||
sway: (swayDeg * Math.PI) / 180,
|
||||
period,
|
||||
});
|
||||
}),
|
||||
);
|
||||
|
||||
export const TIANGONG_ARMS = Object.freeze({
|
||||
/** The Tianhe arm (CMM), its booms folded along the core module. */
|
||||
cmm: arm('CMM', { SHP: [12, 6, 71], EP: [-14, 8, 53], WP: [0, 5, 41] }),
|
||||
/** The Wentian arm (EMM), folded along the lab. */
|
||||
emm: arm('EMM', { SHP: [-12, 6, 67], EP: [14, 8, 47], WP: [0, 5, 37] }),
|
||||
});
|
||||
|
||||
/** The high-gain antenna's gimbal; rest boresight +Y. */
|
||||
export const TIANGONG_HGA = tiangongJoint('TIANHE_HGA');
|
||||
|
||||
/**
|
||||
* China's Tianlian II relay satellites over the equator, degrees east, the
|
||||
* station's counterparts to NASA's TDRS: II-01 at 79.9°E, II-02 at 171.04°E,
|
||||
* II-03 at 10.5°E (Wikipedia, "Tianlian", and satcat.com's definitive orbit
|
||||
* for 53100 at 10.56°E; II-03's slot is not stated by the launch reports, which
|
||||
* say only that the three form a global network). Nominal slots, not a live
|
||||
* roster: which satellite the station uses at a given moment is not public.
|
||||
*/
|
||||
export const TIANGONG_RELAY_LONGITUDES_DEG = Object.freeze([
|
||||
79.9, 171.04, 10.5,
|
||||
]);
|
||||
|
||||
/**
|
||||
* The angle that turns a wing's cell side onto the Sun about one axis.
|
||||
* @param {number[]} sun Unit vector on the model's axes.
|
||||
* @param {{axis: readonly number[], normal: readonly number[]}} joint The
|
||||
* turn axis and the cell side's normal at rest (perpendicular to it).
|
||||
* @param {number} [previous] Held when the Sun is along the axis.
|
||||
* @returns {number} Radians.
|
||||
*/
|
||||
export function tiangongOneAxisAngle(sun, { axis, normal }, previous = 0) {
|
||||
const across = cross(axis, normal);
|
||||
const u = dot(sun, normal);
|
||||
const v = dot(sun, across);
|
||||
if (Math.hypot(u, v) < MIN_STEER) return previous;
|
||||
return Math.atan2(v, u);
|
||||
}
|
||||
|
||||
/**
|
||||
* The two angles that face a lab wing to the Sun: `alpha` about the lab's
|
||||
* axis puts the wing's own axis across the Sun, `beta` about that axis turns
|
||||
* the cell side onto it.
|
||||
* @param {number[]} sun Unit vector on the model's axes.
|
||||
* @param {{alphaAxis: readonly number[], betaAxis: readonly number[],
|
||||
* normal: readonly number[]}} joint Axes at rest; the normal is
|
||||
* perpendicular to both.
|
||||
* @param {number} [previousAlpha] Alpha has two answers half a turn apart
|
||||
* (beta makes up the difference); the nearer to this is kept, and it is
|
||||
* held when the Sun is along the alpha axis.
|
||||
* @returns {{alpha: number, beta: number}} Radians.
|
||||
*/
|
||||
export function tiangongTwoAxisAngles(
|
||||
sun,
|
||||
{ alphaAxis, betaAxis, normal },
|
||||
previousAlpha = 0,
|
||||
) {
|
||||
const across = cross(alphaAxis, betaAxis);
|
||||
const u = dot(sun, betaAxis);
|
||||
const v = dot(sun, across);
|
||||
const alpha =
|
||||
Math.hypot(u, v) < MIN_STEER
|
||||
? previousAlpha
|
||||
: nearestHalfTurn(Math.atan2(-u, v), previousAlpha);
|
||||
// The Sun as the wing sees it after the alpha turn.
|
||||
const local = rotate(sun, alphaAxis, -alpha);
|
||||
const beta = Math.atan2(
|
||||
dot(local, cross(betaAxis, normal)),
|
||||
dot(local, normal),
|
||||
);
|
||||
return { alpha, beta };
|
||||
}
|
||||
|
||||
/**
|
||||
* Every wing's target angles.
|
||||
* @param {number[]} sun Unit vector toward the Sun on the model's axes.
|
||||
* @param {boolean} sunlit False in the Earth's shadow: the wings turn flat.
|
||||
* @param {{one: number[], alpha: number[]}} [previous] The last targets.
|
||||
* @returns {{one: number[], alpha: number[], beta: number[]}} Radians, per
|
||||
* TIANGONG_ONE_AXIS_WINGS and TIANGONG_TWO_AXIS_WINGS entry.
|
||||
*/
|
||||
export function tiangongWingTargets(sun, sunlit, previous = null) {
|
||||
const toward = sunlit ? sun : ZENITH;
|
||||
const one = TIANGONG_ONE_AXIS_WINGS.map((joint, i) =>
|
||||
tiangongOneAxisAngle(toward, joint, previous?.one[i] ?? 0),
|
||||
);
|
||||
const two = TIANGONG_TWO_AXIS_WINGS.map((pair, i) =>
|
||||
tiangongTwoAxisAngles(
|
||||
toward,
|
||||
{
|
||||
alphaAxis: pair.alpha.axis,
|
||||
betaAxis: pair.beta.axis,
|
||||
normal: pair.normal,
|
||||
},
|
||||
previous?.alpha[i] ?? 0,
|
||||
),
|
||||
);
|
||||
return {
|
||||
one,
|
||||
alpha: two.map((t) => t.alpha),
|
||||
beta: two.map((t) => t.beta),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the Tianlian satellites are from the station, on the model's axes,
|
||||
* the highest above the station first.
|
||||
* @param {number[]} positionEcef Meters.
|
||||
* @param {{x:number[], y:number[], z:number[]}} axes Flight axes.
|
||||
* @returns {number[][]} Unit vectors [port, zenith, forward].
|
||||
*/
|
||||
export function tiangongRelayDirections(positionEcef, axes) {
|
||||
return issRelayDirections(positionEcef, axes, TIANGONG_RELAY_LONGITUDES_DEG);
|
||||
}
|
||||
|
||||
/**
|
||||
* Drives the loaded model's joints. Same contract as the ISS driver
|
||||
* (`update`, `reset`, the STATION section's `setOverride`, `setJoint`,
|
||||
* `resumeArm`, `isSunlit`), minus telemetry: `isLive` is always false.
|
||||
*/
|
||||
export function createTiangongArticulation() {
|
||||
let boundModel = null;
|
||||
let nodes = null;
|
||||
let angles = null;
|
||||
let targets = null;
|
||||
let lastMs = 0;
|
||||
let override = null;
|
||||
let lastSunlit = null;
|
||||
/** Where the dish looks now, on the model's axes. */
|
||||
let dish = null;
|
||||
/** STATION section: arms being posed by hand, so their sway is off. */
|
||||
const armManual = new Set();
|
||||
/**
|
||||
* STATION section: wings set by hand, node name → radians. A wing with an
|
||||
* entry here holds that angle (reached at the joint rate) instead of
|
||||
* following the Sun; the others keep following.
|
||||
*/
|
||||
const wingManual = new Map();
|
||||
const scratchMatrix = new Float64Array(16);
|
||||
|
||||
function bind(model) {
|
||||
boundModel = model;
|
||||
const get = (joint) => model.getNode(joint.node) ?? null;
|
||||
nodes = {
|
||||
one: TIANGONG_ONE_AXIS_WINGS.map(get),
|
||||
alpha: TIANGONG_TWO_AXIS_WINGS.map((pair) => get(pair.alpha)),
|
||||
beta: TIANGONG_TWO_AXIS_WINGS.map((pair) => get(pair.beta)),
|
||||
dish: get(TIANGONG_HGA),
|
||||
arms: Object.fromEntries(
|
||||
Object.entries(TIANGONG_ARMS).map(([key, joints]) => [
|
||||
key,
|
||||
joints.map(get),
|
||||
]),
|
||||
),
|
||||
};
|
||||
angles = null;
|
||||
dish = null;
|
||||
}
|
||||
|
||||
function sunEcef(date) {
|
||||
const sun = sunPositionFixed(date.getTime());
|
||||
const length = Math.hypot(sun.x, sun.y, sun.z) || 1;
|
||||
return [sun.x / length, sun.y / length, sun.z / length];
|
||||
}
|
||||
|
||||
function write(node, joint, angle) {
|
||||
if (!node) return;
|
||||
node.matrix = issAxisMatrix(joint.pivot, joint.axis, angle, scratchMatrix);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param {{ready: boolean, getNode: (name: string) => object|undefined}} model
|
||||
* A ready model, or any holder of nodes that take a `matrix`.
|
||||
* @param {Date} date The instant the model is placed at.
|
||||
* @param {{x:number,y:number,z:number}} position Earth-fixed station position.
|
||||
* @param {{x:number[], y:number[], z:number[]}} axes Its flight axes.
|
||||
* @param {number} [nowMs] Wall clock, for the turn rate.
|
||||
*/
|
||||
function update(model, date, position, axes, nowMs = Date.now()) {
|
||||
if (!model.ready) return;
|
||||
if (model !== boundModel) bind(model);
|
||||
const forced = override?.(nowMs) ?? null;
|
||||
if (forced) {
|
||||
lastSunlit = Boolean(forced.sunlit);
|
||||
targets = tiangongWingTargets(forced.sun, forced.sunlit, targets);
|
||||
} else {
|
||||
const sun = sunEcef(date);
|
||||
const sunlit = !issInShadow([position.x, position.y, position.z], sun);
|
||||
lastSunlit = sunlit;
|
||||
targets = tiangongWingTargets(
|
||||
issSunInModelFrame(sun, axes),
|
||||
sunlit,
|
||||
targets,
|
||||
);
|
||||
}
|
||||
// A first frame, or one after a pause, goes straight to the pose.
|
||||
const elapsed = (nowMs - lastMs) / 1000;
|
||||
lastMs = nowMs;
|
||||
const maxStep =
|
||||
!angles || !(elapsed >= 0) || elapsed > 2
|
||||
? Number.POSITIVE_INFINITY
|
||||
: ISS_JOINT_RATE * elapsed;
|
||||
// A wing set by hand aims for its set angle; the rest for the Sun's.
|
||||
const goalFor = (group, joints) =>
|
||||
targets[group].map((target, i) =>
|
||||
wingManual.has(joints[i].node)
|
||||
? wingManual.get(joints[i].node)
|
||||
: target,
|
||||
);
|
||||
const goals = {
|
||||
one: goalFor('one', TIANGONG_ONE_AXIS_WINGS),
|
||||
alpha: goalFor(
|
||||
'alpha',
|
||||
TIANGONG_TWO_AXIS_WINGS.map((pair) => pair.alpha),
|
||||
),
|
||||
beta: goalFor(
|
||||
'beta',
|
||||
TIANGONG_TWO_AXIS_WINGS.map((pair) => pair.beta),
|
||||
),
|
||||
};
|
||||
const step = (group) =>
|
||||
goals[group].map((target, i) =>
|
||||
issStepAngle(angles?.[group][i] ?? 0, target, maxStep),
|
||||
);
|
||||
const next = { one: step('one'), alpha: step('alpha'), beta: step('beta') };
|
||||
TIANGONG_ONE_AXIS_WINGS.forEach((joint, i) => {
|
||||
if (!angles || next.one[i] !== angles.one[i])
|
||||
write(nodes.one[i], joint, next.one[i]);
|
||||
});
|
||||
TIANGONG_TWO_AXIS_WINGS.forEach((pair, i) => {
|
||||
if (!angles || next.alpha[i] !== angles.alpha[i])
|
||||
write(nodes.alpha[i], pair.alpha, next.alpha[i]);
|
||||
if (!angles || next.beta[i] !== angles.beta[i])
|
||||
write(nodes.beta[i], pair.beta, next.beta[i]);
|
||||
});
|
||||
angles = next;
|
||||
|
||||
// The dish: the highest relay satellite; one below the station's horizon
|
||||
// plane keeps its last aim.
|
||||
const current = dish ?? [0, 1, 0];
|
||||
const wanted = tiangongRelayDirections(
|
||||
[position.x, position.y, position.z],
|
||||
axes,
|
||||
)[0];
|
||||
const target = wanted && wanted[1] >= DISH_MIN_UP ? wanted : current;
|
||||
const stepped = issStepDirection(current, target, maxStep);
|
||||
if (!dish || stepped.some((c, k) => Math.abs(c - current[k]) > 1e-9))
|
||||
if (nodes.dish)
|
||||
nodes.dish.matrix = issAimMatrix(
|
||||
TIANGONG_HGA.pivot,
|
||||
stepped,
|
||||
scratchMatrix,
|
||||
);
|
||||
dish = stepped;
|
||||
|
||||
// Arms: an illustrative sway about the folded pose (see TIANGONG_ARMS).
|
||||
for (const [key, joints] of Object.entries(TIANGONG_ARMS)) {
|
||||
if (armManual.has(key)) continue;
|
||||
const sway = issArmAngles(nowMs / 1000, joints);
|
||||
joints.forEach((joint, i) => {
|
||||
if (!joint.sway && !joint.centre) return;
|
||||
write(nodes.arms[key][i], joint, joint.centre + sway[i]);
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* STATION section: turn any named node about an axis through a pivot. A
|
||||
* node of either arm takes that arm off its sway.
|
||||
* @param {string} name
|
||||
* @param {number[]} pivot
|
||||
* @param {number[]} axis Unit vector.
|
||||
* @param {number} angle Radians.
|
||||
*/
|
||||
function setJoint(name, pivot, axis, angle) {
|
||||
for (const [key, joints] of Object.entries(TIANGONG_ARMS))
|
||||
if (joints.some((joint) => joint.node === name)) armManual.add(key);
|
||||
const node = boundModel?.getNode(name);
|
||||
if (node) node.matrix = issAxisMatrix(pivot, axis, angle, scratchMatrix);
|
||||
}
|
||||
|
||||
function reset() {
|
||||
boundModel = null;
|
||||
nodes = null;
|
||||
angles = null;
|
||||
targets = null;
|
||||
dish = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* STATION section: a function giving the Sun on the model's axes (and
|
||||
* whether the station is lit) in place of the real one, or null for the
|
||||
* real one.
|
||||
* @param {((nowMs:number)=>{sun:number[], sunlit:boolean}|null)|null} fn
|
||||
*/
|
||||
function setOverride(fn) {
|
||||
override = fn;
|
||||
}
|
||||
|
||||
/** Whether the station is in sunlight, as of the last update. */
|
||||
function isSunlit() {
|
||||
return lastSunlit;
|
||||
}
|
||||
|
||||
/**
|
||||
* STATION section: hand an arm back to its sway; both when no arm is named.
|
||||
* @param {'cmm'|'emm'} [key]
|
||||
*/
|
||||
function resumeArm(key) {
|
||||
if (key) armManual.delete(key);
|
||||
else armManual.clear();
|
||||
}
|
||||
|
||||
/**
|
||||
* STATION section: hold one wing joint at an angle, by its node name
|
||||
* (a TIANGONG_ONE_AXIS_WINGS entry, or a lab wing's alpha or beta node).
|
||||
* The joint turns there at the joint rate on the next updates. Null lets
|
||||
* the wing follow the Sun again.
|
||||
* @param {string} name
|
||||
* @param {number|null} angle Radians.
|
||||
*/
|
||||
function setWingAngle(name, angle) {
|
||||
if (angle === null || !Number.isFinite(angle)) wingManual.delete(name);
|
||||
else wingManual.set(name, angle);
|
||||
}
|
||||
|
||||
/** STATION section: every wing back to the Sun. */
|
||||
function resumeWings() {
|
||||
wingManual.clear();
|
||||
}
|
||||
|
||||
return {
|
||||
update,
|
||||
reset,
|
||||
setOverride,
|
||||
setJoint,
|
||||
resumeArm,
|
||||
setWingAngle,
|
||||
resumeWings,
|
||||
isSunlit,
|
||||
/** No telemetry exists for Tiangong: the angles are always computed. */
|
||||
isLive: () => false,
|
||||
setTelemetryAllowed() {},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,238 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import { readFileSync } from 'node:fs';
|
||||
import test from 'node:test';
|
||||
import { ISS_RELAY_LONGITUDES_DEG } from './issArticulation.js';
|
||||
import { TIANGONG_MODEL_URL } from './policy.js';
|
||||
import {
|
||||
TIANGONG_ARMS,
|
||||
TIANGONG_HGA,
|
||||
TIANGONG_ONE_AXIS_WINGS,
|
||||
TIANGONG_RELAY_LONGITUDES_DEG,
|
||||
TIANGONG_TWO_AXIS_WINGS,
|
||||
tiangongOneAxisAngle,
|
||||
tiangongRelayDirections,
|
||||
tiangongTwoAxisAngles,
|
||||
tiangongWingTargets,
|
||||
} from './tiangongArticulation.js';
|
||||
import { TIANGONG_JOINTS, tiangongJoint } from './tiangongJoints.js';
|
||||
|
||||
const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
||||
const cross = (a, b) => [
|
||||
a[1] * b[2] - a[2] * b[1],
|
||||
a[2] * b[0] - a[0] * b[2],
|
||||
a[0] * b[1] - a[1] * b[0],
|
||||
];
|
||||
const unit = (v) => v.map((c) => c / Math.hypot(...v));
|
||||
/** `v` turned by `angle` about `axis` (Rodrigues), the turn the matrix makes. */
|
||||
const rotate = (v, axis, angle) => {
|
||||
const c = Math.cos(angle);
|
||||
const s = Math.sin(angle);
|
||||
const k = cross(axis, v);
|
||||
const d = dot(axis, v) * (1 - c);
|
||||
return [0, 1, 2].map((i) => v[i] * c + k[i] * s + axis[i] * d);
|
||||
};
|
||||
|
||||
const SUNS = [
|
||||
[0, 1, 0],
|
||||
[0, -1, 0],
|
||||
[0, 0, 1],
|
||||
[1, 0, 0],
|
||||
[0.5, 0.5, 0.7],
|
||||
[-0.6, 0.2, -0.77],
|
||||
[0.3, -0.9, 0.3],
|
||||
[0.9, 0.1, -0.4],
|
||||
].map(unit);
|
||||
|
||||
test("the joint table is the model build's: 37 nodes, every kind, frozen", () => {
|
||||
assert.equal(TIANGONG_JOINTS.length, 37);
|
||||
const kinds = new Map();
|
||||
for (const joint of TIANGONG_JOINTS) {
|
||||
kinds.set(joint.kind, (kinds.get(joint.kind) ?? 0) + 1);
|
||||
assert.ok(Object.isFrozen(joint) && Object.isFrozen(joint.pivot));
|
||||
assert.equal(joint.pivot.length, 3);
|
||||
assert.ok(Math.abs(Math.hypot(...joint.axis) - 1) < 1e-9, joint.node);
|
||||
if (joint.kind === 'dock') assert.equal(joint.rangeDeg, null);
|
||||
else assert.equal(joint.rangeDeg.length, 2);
|
||||
}
|
||||
// 2 Tianhe wings, 4 lab wings and 6 vehicle wings turn on alpha joints.
|
||||
assert.deepEqual(Object.fromEntries(kinds), {
|
||||
alpha: 12,
|
||||
beta: 4,
|
||||
antenna: 1,
|
||||
dock: 6,
|
||||
arm: 14,
|
||||
});
|
||||
assert.equal(tiangongJoint('CMM_EP').parent, 'CMM_SHP');
|
||||
assert.throws(() => tiangongJoint('NOT_A_JOINT'));
|
||||
});
|
||||
|
||||
test('a one-axis wing turns its cell side onto the Sun, as far as its axis allows', () => {
|
||||
for (const wing of TIANGONG_ONE_AXIS_WINGS) {
|
||||
assert.ok(Math.abs(dot(wing.axis, wing.normal)) < 1e-9, wing.node);
|
||||
for (const sun of SUNS) {
|
||||
const angle = tiangongOneAxisAngle(sun, wing);
|
||||
const normal = rotate(wing.normal, wing.axis, angle);
|
||||
// The best the wing can do: the Sun's part across its axis.
|
||||
const reachable = Math.hypot(
|
||||
dot(sun, wing.normal),
|
||||
dot(sun, cross(wing.axis, wing.normal)),
|
||||
);
|
||||
if (reachable < 0.05) continue;
|
||||
assert.ok(
|
||||
Math.abs(dot(normal, sun) - reachable) < 1e-6,
|
||||
`${wing.node} ${sun}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
// The Sun along the axis: nothing to steer by, the last angle holds.
|
||||
const tianhe = TIANGONG_ONE_AXIS_WINGS[0];
|
||||
assert.equal(tiangongOneAxisAngle([1, 0, 0], tianhe, 0.7), 0.7);
|
||||
});
|
||||
|
||||
test('a lab wing faces the Sun exactly: alpha across it, beta onto it', () => {
|
||||
for (const pair of TIANGONG_TWO_AXIS_WINGS) {
|
||||
const joint = {
|
||||
alphaAxis: pair.alpha.axis,
|
||||
betaAxis: pair.beta.axis,
|
||||
normal: pair.normal,
|
||||
};
|
||||
for (const sun of SUNS) {
|
||||
if (Math.abs(dot(sun, pair.alpha.axis)) > 0.95) continue;
|
||||
const { alpha, beta } = tiangongTwoAxisAngles(sun, joint);
|
||||
// The beta joint hangs from the alpha joint: beta turns first.
|
||||
const normal = rotate(
|
||||
rotate(pair.normal, pair.beta.axis, beta),
|
||||
pair.alpha.axis,
|
||||
alpha,
|
||||
);
|
||||
assert.ok(dot(normal, sun) > 1 - 1e-6, `${pair.alpha.node} ${sun}`);
|
||||
const wingAxis = rotate(pair.beta.axis, pair.alpha.axis, alpha);
|
||||
assert.ok(
|
||||
Math.abs(dot(wingAxis, sun)) < 1e-6,
|
||||
'wing axis across the Sun',
|
||||
);
|
||||
}
|
||||
// Alpha keeps the half turn nearer its last answer.
|
||||
const first = tiangongTwoAxisAngles(unit([0.2, 1, 0.3]), joint, 0);
|
||||
const flipped = tiangongTwoAxisAngles(
|
||||
unit([0.2, 1, 0.3]),
|
||||
joint,
|
||||
first.alpha + Math.PI,
|
||||
);
|
||||
assert.ok(Math.abs(Math.abs(flipped.alpha - first.alpha) - Math.PI) < 1e-9);
|
||||
// Sun along the lab: alpha holds.
|
||||
assert.equal(tiangongTwoAxisAngles([1, 0, 0], joint, 0.4).alpha, 0.4);
|
||||
}
|
||||
});
|
||||
|
||||
test("in the Earth's shadow every wing turns flat to the Earth, edge into the flight", () => {
|
||||
const targets = tiangongWingTargets(unit([0.3, -0.9, 0.3]), false, {
|
||||
one: TIANGONG_ONE_AXIS_WINGS.map(() => 3),
|
||||
alpha: TIANGONG_TWO_AXIS_WINGS.map(() => 3),
|
||||
});
|
||||
TIANGONG_ONE_AXIS_WINGS.forEach((wing, i) => {
|
||||
const normal = rotate(wing.normal, wing.axis, targets.one[i]);
|
||||
assert.ok(Math.abs(normal[1] - 1) < 1e-9, wing.node);
|
||||
});
|
||||
TIANGONG_TWO_AXIS_WINGS.forEach((pair, i) => {
|
||||
// The nearer half turn to 3 rad is ±π, with beta making up the rest.
|
||||
assert.ok(Math.abs(Math.cos(targets.alpha[i]) + 1) < 1e-9, pair.alpha.node);
|
||||
const normal = rotate(
|
||||
rotate(pair.normal, pair.beta.axis, targets.beta[i]),
|
||||
pair.alpha.axis,
|
||||
targets.alpha[i],
|
||||
);
|
||||
assert.ok(Math.abs(normal[1] - 1) < 1e-9);
|
||||
});
|
||||
// Lit, the targets face the Sun instead.
|
||||
const lit = tiangongWingTargets([0, 0, 1], true);
|
||||
assert.ok(Math.abs(Math.abs(lit.one[0]) - Math.PI / 2) < 1e-9);
|
||||
});
|
||||
|
||||
test('the antenna aims at Tianlian, not TDRS: unit vectors, highest first', () => {
|
||||
assert.deepEqual([...TIANGONG_RELAY_LONGITUDES_DEG], [79.9, 171.04, 10.5]);
|
||||
assert.notDeepEqual(
|
||||
[...TIANGONG_RELAY_LONGITUDES_DEG],
|
||||
[...ISS_RELAY_LONGITUDES_DEG],
|
||||
);
|
||||
// Over 80°E at 400 km: Tianlian II-01 is nearly overhead.
|
||||
const lon = (79.9 * Math.PI) / 180;
|
||||
const r = 6_771_000;
|
||||
const position = [r * Math.cos(lon), r * Math.sin(lon), 0];
|
||||
const axes = {
|
||||
x: [-Math.sin(lon), Math.cos(lon), 0],
|
||||
y: [0, 0, 1],
|
||||
z: unit(position),
|
||||
};
|
||||
const directions = tiangongRelayDirections(position, axes);
|
||||
assert.equal(directions.length, 3);
|
||||
for (const d of directions) assert.ok(Math.abs(Math.hypot(...d) - 1) < 1e-9);
|
||||
assert.ok(directions[0][1] > 0.999, 'II-01 overhead');
|
||||
assert.ok(
|
||||
directions[0][1] >= directions[1][1] &&
|
||||
directions[1][1] >= directions[2][1],
|
||||
);
|
||||
assert.deepEqual(TIANGONG_HGA.axis, [0, 1, 0]);
|
||||
});
|
||||
|
||||
test('the arms sway on one side of rest only, so they lift off the hull', () => {
|
||||
for (const joints of Object.values(TIANGONG_ARMS)) {
|
||||
assert.equal(joints.length, 7);
|
||||
for (const joint of joints) {
|
||||
if (!joint.sway) {
|
||||
assert.equal(joint.centre, 0);
|
||||
continue;
|
||||
}
|
||||
// The sway never crosses rest unless it is centred on it (wrist pitch).
|
||||
assert.ok(
|
||||
joint.centre === 0 || Math.abs(joint.centre) > joint.sway,
|
||||
joint.node,
|
||||
);
|
||||
assert.ok(joint.period > 0);
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
test('the model file has every joint node, under its parent, with an identity rest', () => {
|
||||
const glb = readFileSync(
|
||||
new URL(`../../../public${TIANGONG_MODEL_URL}`, import.meta.url),
|
||||
);
|
||||
const jsonLength = glb.readUInt32LE(12);
|
||||
const gltf = JSON.parse(glb.subarray(20, 20 + jsonLength).toString('utf8'));
|
||||
const byName = new Map(gltf.nodes.map((node, index) => [node.name, index]));
|
||||
const parentOf = new Map();
|
||||
gltf.nodes.forEach((node, index) =>
|
||||
(node.children ?? []).forEach((child) => parentOf.set(child, index)),
|
||||
);
|
||||
for (const joint of TIANGONG_JOINTS) {
|
||||
const index = byName.get(joint.node);
|
||||
assert.ok(index !== undefined, joint.node);
|
||||
const node = gltf.nodes[index];
|
||||
assert.equal(
|
||||
gltf.nodes[parentOf.get(index)].name,
|
||||
joint.parent,
|
||||
joint.node,
|
||||
);
|
||||
if (joint.kind !== 'dock') {
|
||||
assert.equal(node.translation ?? null, null, joint.node);
|
||||
assert.equal(node.rotation ?? null, null, joint.node);
|
||||
assert.equal(node.matrix ?? null, null, joint.node);
|
||||
}
|
||||
}
|
||||
// Each wing's mesh is thin along the cell normal the rules assume.
|
||||
const thin = (meshNode, normal) => {
|
||||
const node = gltf.nodes[byName.get(meshNode)];
|
||||
const accessor =
|
||||
gltf.accessors[gltf.meshes[node.mesh].primitives[0].attributes.POSITION];
|
||||
const size = [0, 1, 2].map((i) => accessor.max[i] - accessor.min[i]);
|
||||
const along = normal.findIndex((c) => c !== 0);
|
||||
assert.ok(
|
||||
size[along] < Math.min(...size.filter((_, i) => i !== along)) / 3,
|
||||
meshNode,
|
||||
);
|
||||
};
|
||||
for (const wing of TIANGONG_ONE_AXIS_WINGS)
|
||||
thin(wing.node.replace(/_ALPHA$/, ''), wing.normal);
|
||||
for (const pair of TIANGONG_TWO_AXIS_WINGS)
|
||||
thin(pair.beta.node.replace(/_BETA$/, ''), pair.normal);
|
||||
});
|
||||
@@ -0,0 +1,280 @@
|
||||
/**
|
||||
* Tiangong's joint and dock-marker nodes, as the model file carries them in
|
||||
* each node's glTF `extras` (the model build's joints.json, copied here; the
|
||||
* app reads this table, never the file's extras). Root frame, meters: glTF +X
|
||||
* port, +Y zenith, +Z forward. Every driven joint is a node with an identity
|
||||
* rest transform whose moving mesh hangs beneath it, so a turn of `angle` about
|
||||
* `axis` through `pivot` is `issAxisMatrix(pivot, axis, angle)`, as for the ISS.
|
||||
* `kind`: alpha (a wing's drive about its boom), beta (a lab wing's turn about
|
||||
* its own axis, under its alpha), arm (the two robotic arms, seven joints
|
||||
* each, base to tip), antenna (the high-gain dish, rest boresight +Y), dock (a
|
||||
* docking port's outer face, not driven: `axis` is a docked vehicle's
|
||||
* direction, `rangeDeg` null). `approximate` marks the model author's
|
||||
* estimates against published dimensions.
|
||||
* @type {ReadonlyArray<Readonly<{node: string, pivot: number[], axis: number[],
|
||||
* kind: 'alpha'|'beta'|'arm'|'antenna'|'dock', rangeDeg: number[]|null,
|
||||
* approximate: boolean, parent: string}>>}
|
||||
*/
|
||||
export const TIANGONG_JOINTS = Object.freeze(
|
||||
[
|
||||
[
|
||||
'TIANHE_ARRAY_PORT_ALPHA',
|
||||
[1.4, 0, -6.7],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'TIANHE_ARRAY_STBD_ALPHA',
|
||||
[-1.4, 0, -6.7],
|
||||
[-1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'TIANHE_HGA',
|
||||
[0, 2.4, -6],
|
||||
[0, 1, 0],
|
||||
'antenna',
|
||||
[-90, 90],
|
||||
true,
|
||||
'tiangong',
|
||||
],
|
||||
['DOCK_FORWARD', [0, 0, 8.3], [0, 0, 1], 'dock', null, false, 'tiangong'],
|
||||
['DOCK_AFT', [0, 0, -8.3], [0, 0, -1], 'dock', null, false, 'tiangong'],
|
||||
['DOCK_NADIR', [0, -2, 6.4], [0, -1, 0], 'dock', null, true, 'tiangong'],
|
||||
['DOCK_ZENITH', [0, 2, 6.4], [0, 1, 0], 'dock', null, true, 'tiangong'],
|
||||
['BERTH_PORT', [2.1, 0, 6.4], [1, 0, 0], 'dock', null, true, 'tiangong'],
|
||||
['BERTH_STBD', [-2.1, 0, 6.4], [-1, 0, 0], 'dock', null, true, 'tiangong'],
|
||||
[
|
||||
'WENTIAN_ARRAY_FWD_ALPHA',
|
||||
[-18.9, 0, 6.9],
|
||||
[-1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'WENTIAN_ARRAY_FWD_BETA',
|
||||
[-18.9, 0, 7.7],
|
||||
[0, 0, 1],
|
||||
'beta',
|
||||
[-180, 180],
|
||||
false,
|
||||
'WENTIAN_ARRAY_FWD_ALPHA',
|
||||
],
|
||||
[
|
||||
'WENTIAN_ARRAY_AFT_ALPHA',
|
||||
[-18.9, 0, 5.9],
|
||||
[-1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'WENTIAN_ARRAY_AFT_BETA',
|
||||
[-18.9, 0, 5.1],
|
||||
[0, 0, -1],
|
||||
'beta',
|
||||
[-180, 180],
|
||||
false,
|
||||
'WENTIAN_ARRAY_AFT_ALPHA',
|
||||
],
|
||||
[
|
||||
'MENGTIAN_ARRAY_FWD_ALPHA',
|
||||
[18.9, 0, 6.9],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'MENGTIAN_ARRAY_FWD_BETA',
|
||||
[18.9, 0, 7.7],
|
||||
[0, 0, 1],
|
||||
'beta',
|
||||
[-180, 180],
|
||||
false,
|
||||
'MENGTIAN_ARRAY_FWD_ALPHA',
|
||||
],
|
||||
[
|
||||
'MENGTIAN_ARRAY_AFT_ALPHA',
|
||||
[18.9, 0, 5.9],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
false,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'MENGTIAN_ARRAY_AFT_BETA',
|
||||
[18.9, 0, 5.1],
|
||||
[0, 0, -1],
|
||||
'beta',
|
||||
[-180, 180],
|
||||
false,
|
||||
'MENGTIAN_ARRAY_AFT_ALPHA',
|
||||
],
|
||||
[
|
||||
'CMM_SHR',
|
||||
[0.5, 1.9, 3.6],
|
||||
[0, 1, 0],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'CMM_SHY',
|
||||
[0.5, 2.3, 3.6],
|
||||
[0, 0, 1],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'CMM_SHR',
|
||||
],
|
||||
[
|
||||
'CMM_SHP',
|
||||
[0.5, 2.7, 3.6],
|
||||
[1, 0, 0],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'CMM_SHY',
|
||||
],
|
||||
[
|
||||
'CMM_EP',
|
||||
[0.5, 2.7, -0.9],
|
||||
[1, 0, 0],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'CMM_SHP',
|
||||
],
|
||||
['CMM_WP', [0.5, 3.3, 3.6], [1, 0, 0], 'arm', [-270, 270], true, 'CMM_EP'],
|
||||
['CMM_WY', [0.5, 3.3, 4.1], [0, 1, 0], 'arm', [-270, 270], true, 'CMM_WP'],
|
||||
['CMM_WR', [0.5, 3.3, 4.6], [0, 0, 1], 'arm', [-270, 270], true, 'CMM_WY'],
|
||||
[
|
||||
'EMM_SHR',
|
||||
[-6, 2.3, 6.4],
|
||||
[0, 1, 0],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'tiangong',
|
||||
],
|
||||
[
|
||||
'EMM_SHY',
|
||||
[-6, 2.55, 6.4],
|
||||
[1, 0, 0],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'EMM_SHR',
|
||||
],
|
||||
[
|
||||
'EMM_SHP',
|
||||
[-6, 2.85, 6.4],
|
||||
[0, 0, 1],
|
||||
'arm',
|
||||
[-270, 270],
|
||||
true,
|
||||
'EMM_SHY',
|
||||
],
|
||||
['EMM_EP', [-8, 2.85, 6.4], [0, 0, 1], 'arm', [-270, 270], true, 'EMM_SHP'],
|
||||
['EMM_WP', [-6, 3.2, 6.4], [0, 0, 1], 'arm', [-270, 270], true, 'EMM_EP'],
|
||||
['EMM_WY', [-5.7, 3.2, 6.4], [0, 1, 0], 'arm', [-270, 270], true, 'EMM_WP'],
|
||||
['EMM_WR', [-5.4, 3.2, 6.4], [1, 0, 0], 'arm', [-270, 270], true, 'EMM_WY'],
|
||||
[
|
||||
'SHENZHOU_FORWARD_ARRAY_PORT_ALPHA',
|
||||
[1.4, 0, 15.1],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'SHENZHOU_FORWARD',
|
||||
],
|
||||
[
|
||||
'SHENZHOU_FORWARD_ARRAY_STBD_ALPHA',
|
||||
[-1.4, 0, 15.1],
|
||||
[-1, -0, -0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'SHENZHOU_FORWARD',
|
||||
],
|
||||
[
|
||||
'SHENZHOU_NADIR_ARRAY_PORT_ALPHA',
|
||||
[1.4, -8.8, 6.4],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'SHENZHOU_NADIR',
|
||||
],
|
||||
[
|
||||
'SHENZHOU_NADIR_ARRAY_STBD_ALPHA',
|
||||
[-1.4, -8.8, 6.4],
|
||||
[-1, -0, -0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'SHENZHOU_NADIR',
|
||||
],
|
||||
[
|
||||
'TIANZHOU_AFT_ARRAY_PORT_ALPHA',
|
||||
[1.4, 0, -16.6],
|
||||
[1, 0, 0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'TIANZHOU_AFT',
|
||||
],
|
||||
[
|
||||
'TIANZHOU_AFT_ARRAY_STBD_ALPHA',
|
||||
[-1.4, 0, -16.6],
|
||||
[-1, -0, -0],
|
||||
'alpha',
|
||||
[-180, 180],
|
||||
true,
|
||||
'TIANZHOU_AFT',
|
||||
],
|
||||
].map(([node, pivot, axis, kind, rangeDeg, approximate, parent]) =>
|
||||
Object.freeze({
|
||||
node,
|
||||
pivot: Object.freeze(pivot),
|
||||
axis: Object.freeze(axis),
|
||||
kind,
|
||||
rangeDeg: rangeDeg && Object.freeze(rangeDeg),
|
||||
approximate,
|
||||
parent,
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
const BY_NODE = new Map(TIANGONG_JOINTS.map((joint) => [joint.node, joint]));
|
||||
|
||||
/**
|
||||
* One joint by node name.
|
||||
* @param {string} node
|
||||
* @returns {(typeof TIANGONG_JOINTS)[number]}
|
||||
*/
|
||||
export function tiangongJoint(node) {
|
||||
const joint = BY_NODE.get(node);
|
||||
if (!joint) throw new Error(`Tiangong has no joint ${node}`);
|
||||
return joint;
|
||||
}
|
||||
|
||||
/** The visiting vehicles' mesh nodes; hiding one hides its arrays with it. */
|
||||
export const TIANGONG_VEHICLE_NODES = Object.freeze([
|
||||
'SHENZHOU_FORWARD',
|
||||
'SHENZHOU_NADIR',
|
||||
'TIANZHOU_AFT',
|
||||
]);
|
||||
@@ -0,0 +1,72 @@
|
||||
import {
|
||||
ISS_COMPANION_COARSE_M,
|
||||
ISS_COMPANION_RADIUS_M,
|
||||
ISS_COMPANION_SCAN_MS,
|
||||
ISS_MODEL_LOCAL_AXES,
|
||||
ISS_MODEL_MAX_DISTANCE_M,
|
||||
ISS_MODEL_MIN_PX,
|
||||
ISS_ORBIT_HIDE_M,
|
||||
TIANGONG_CARD_CLEAR_M,
|
||||
TIANGONG_MODEL_URL,
|
||||
TIANGONG_NORAD,
|
||||
} from './policy.js';
|
||||
import { createStationModel } from './stationModel.js';
|
||||
import { createTiangongArticulation } from './tiangongArticulation.js';
|
||||
|
||||
/**
|
||||
* Whether a catalog entry at Tiangong is one of the station's own modules
|
||||
* (CelesTrak lists them as "CSS (TIANHE)", "CSS (WENTIAN)", "CSS (MENGTIAN)")
|
||||
* rather than a visiting Shenzhou or Tianzhou. A missing entry counts as a
|
||||
* module.
|
||||
* @param {number} noradId
|
||||
* @param {{name?: string}|undefined} entry
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function tiangongIsModule(noradId, entry) {
|
||||
return (
|
||||
noradId === TIANGONG_NORAD || /^CSS\s*\(/i.test(entry?.name ?? 'CSS (')
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Tiangong as the station model factory describes it. The file is in meters
|
||||
* (scale 1) and in the ISS file's frame, so it takes the ISS's local-axes
|
||||
* mapping: the station is assumed to fly like the ISS, Tianhe along the
|
||||
* velocity with the node (forward port) forward, the labs across the orbit,
|
||||
* nadir to the Earth. Its joints are computed only; there is no telemetry,
|
||||
* no Cockpit views on the model (so the model is hidden while the Cockpit
|
||||
* rides the station), and its ring follows the layer's orbit toggle like any
|
||||
* tracked satellite's.
|
||||
* @returns {import('./stationModel.js').StationModelSpec}
|
||||
*/
|
||||
export function tiangongModelSpec() {
|
||||
return {
|
||||
key: 'tiangong',
|
||||
label: 'Tiangong', // i18n-ignore: the station's name, for log lines
|
||||
norad: TIANGONG_NORAD,
|
||||
modelUrl: TIANGONG_MODEL_URL,
|
||||
scale: 1,
|
||||
minPx: ISS_MODEL_MIN_PX,
|
||||
maxDistanceM: ISS_MODEL_MAX_DISTANCE_M,
|
||||
orbitHideM: ISS_ORBIT_HIDE_M,
|
||||
cardClearM: TIANGONG_CARD_CLEAR_M,
|
||||
companionRadiusM: ISS_COMPANION_RADIUS_M,
|
||||
companionCoarseM: ISS_COMPANION_COARSE_M,
|
||||
companionScanMs: ISS_COMPANION_SCAN_MS,
|
||||
localAxes: ISS_MODEL_LOCAL_AXES,
|
||||
isModule: tiangongIsModule,
|
||||
createArticulation: createTiangongArticulation,
|
||||
createTelemetry: null,
|
||||
cockpitMount: null,
|
||||
hideInCockpit: true,
|
||||
syncOrbit: null,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Tiangong as a 3D model when the camera is close (stationModel.js).
|
||||
* @param {{state: object, parts: object, resolveAsset?: (url: string) => string}} context
|
||||
*/
|
||||
export function createTiangongModel(context) {
|
||||
return createStationModel(tiangongModelSpec(), context);
|
||||
}
|
||||
@@ -0,0 +1,124 @@
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { issModelSpec } from './issModel.js';
|
||||
import {
|
||||
ISS_MODEL_LOCAL_AXES,
|
||||
ISS_NORAD,
|
||||
TIANGONG_MODEL_URL,
|
||||
TIANGONG_NORAD,
|
||||
} from './policy.js';
|
||||
import { stationModelShouldShow } from './stationModel.js';
|
||||
import { tiangongIsModule, tiangongModelSpec } from './tiangongModel.js';
|
||||
|
||||
test("Tiangong is CSS (TIANHE) by NORAD number, drawn at the file's meters", () => {
|
||||
const spec = tiangongModelSpec();
|
||||
assert.equal(TIANGONG_NORAD, 48274);
|
||||
assert.equal(spec.norad, TIANGONG_NORAD);
|
||||
assert.equal(spec.key, 'tiangong');
|
||||
assert.equal(spec.scale, 1);
|
||||
assert.equal(spec.modelUrl, TIANGONG_MODEL_URL);
|
||||
// The same frame as the ISS file, so the same flight-axes mapping.
|
||||
assert.equal(spec.localAxes, ISS_MODEL_LOCAL_AXES);
|
||||
// No telemetry, no Cockpit views, so the model goes while the Cockpit rides.
|
||||
assert.equal(spec.createTelemetry, null);
|
||||
assert.equal(spec.cockpitMount, null);
|
||||
assert.equal(spec.hideInCockpit, true);
|
||||
assert.equal(spec.syncOrbit, null);
|
||||
assert.equal(typeof spec.createArticulation().update, 'function');
|
||||
});
|
||||
|
||||
test("the ISS spec keeps the ISS's own rules", () => {
|
||||
const spec = issModelSpec({ parts: {} });
|
||||
assert.equal(spec.norad, ISS_NORAD);
|
||||
assert.equal(spec.key, 'iss');
|
||||
assert.equal(spec.hideInCockpit, false);
|
||||
assert.equal(typeof spec.cockpitMount, 'function');
|
||||
assert.equal(typeof spec.createTelemetry, 'function');
|
||||
assert.equal(typeof spec.syncOrbit, 'function');
|
||||
});
|
||||
|
||||
test("the station's modules are CSS (…) entries; ships are vehicles", () => {
|
||||
assert.equal(
|
||||
tiangongIsModule(TIANGONG_NORAD, { name: 'CSS (TIANHE)' }),
|
||||
true,
|
||||
);
|
||||
assert.equal(tiangongIsModule(53239, { name: 'CSS (WENTIAN)' }), true);
|
||||
assert.equal(tiangongIsModule(54216, { name: 'CSS (MENGTIAN)' }), true);
|
||||
assert.equal(tiangongIsModule(60000, { name: 'SHENZHOU-23 (SZ-23)' }), false);
|
||||
assert.equal(tiangongIsModule(60001, { name: 'TIANZHOU-10' }), false);
|
||||
assert.equal(
|
||||
tiangongIsModule(60002, undefined),
|
||||
true,
|
||||
'unknown: not a vehicle',
|
||||
);
|
||||
});
|
||||
|
||||
test("a station hidden for the Cockpit stays hidden; the dot's rules otherwise", () => {
|
||||
const shown = {
|
||||
enabled: true,
|
||||
showPoints: true,
|
||||
hasStation: true,
|
||||
classVisible: true,
|
||||
tracked: false,
|
||||
cockpitHidden: false,
|
||||
};
|
||||
assert.equal(stationModelShouldShow(shown), true);
|
||||
assert.equal(
|
||||
stationModelShouldShow({ ...shown, cockpitHidden: true }),
|
||||
false,
|
||||
);
|
||||
assert.equal(stationModelShouldShow({ ...shown, hasStation: false }), false);
|
||||
assert.equal(
|
||||
stationModelShouldShow({ ...shown, classVisible: false, tracked: true }),
|
||||
true,
|
||||
);
|
||||
});
|
||||
|
||||
test('the shipped asset is centred on the station, in meters, with its own textures', () => {
|
||||
const glb = readFileSync(
|
||||
new URL(`../../../public${TIANGONG_MODEL_URL}`, import.meta.url),
|
||||
);
|
||||
assert.equal(glb.toString('latin1', 0, 4), 'glTF');
|
||||
const jsonLength = glb.readUInt32LE(12);
|
||||
const gltf = JSON.parse(glb.subarray(20, 20 + jsonLength).toString('utf8'));
|
||||
assert.deepEqual(gltf.scenes[0].nodes.length, 1);
|
||||
const root = gltf.nodes[gltf.scenes[0].nodes[0]];
|
||||
assert.equal(root.name, 'tiangong');
|
||||
// The same compression and texture format as the ISS file.
|
||||
assert.ok(gltf.extensionsUsed.includes('KHR_draco_mesh_compression'));
|
||||
assert.ok(gltf.extensionsUsed.includes('EXT_texture_webp'));
|
||||
assert.ok(gltf.textures.length > 0);
|
||||
assert.equal(gltf.animations ?? undefined, undefined);
|
||||
// Station extents (without the vehicles): 41.9 m across the lab wings,
|
||||
// 57.2 m along the flight direction. The root puts their centre at the
|
||||
// origin, so minimumPixelSize scales about the orbital position.
|
||||
const vehicles = new Set([
|
||||
'SHENZHOU_FORWARD',
|
||||
'SHENZHOU_NADIR',
|
||||
'TIANZHOU_AFT',
|
||||
]);
|
||||
const min = [Infinity, Infinity, Infinity];
|
||||
const max = [-Infinity, -Infinity, -Infinity];
|
||||
const visit = (index) => {
|
||||
const node = gltf.nodes[index];
|
||||
if (vehicles.has(node.name)) return;
|
||||
const offset = node.translation ?? [0, 0, 0];
|
||||
for (const primitive of gltf.meshes[node.mesh]?.primitives ?? []) {
|
||||
const accessor = gltf.accessors[primitive.attributes.POSITION];
|
||||
for (let i = 0; i < 3; i++) {
|
||||
min[i] = Math.min(min[i], accessor.min[i] + offset[i]);
|
||||
max[i] = Math.max(max[i], accessor.max[i] + offset[i]);
|
||||
}
|
||||
}
|
||||
(node.children ?? []).forEach(visit);
|
||||
};
|
||||
root.children.forEach(visit);
|
||||
assert.ok(Math.abs(max[0] - min[0] - 41.9) < 0.1, `X ${max[0] - min[0]}`);
|
||||
assert.ok(Math.abs(max[2] - min[2] - 57.2) < 0.1, `Z ${max[2] - min[2]}`);
|
||||
for (let i = 0; i < 3; i++)
|
||||
assert.ok(
|
||||
Math.abs((min[i] + max[i]) / 2 + root.translation[i]) < 0.05,
|
||||
`centre ${i}`,
|
||||
);
|
||||
});
|
||||
@@ -0,0 +1,141 @@
|
||||
import { msg } from '../../i18n/index.js';
|
||||
import { issCommandFastOrbit } from './issCommand.js';
|
||||
import { ISS_ARM_LABELS, ISS_SUN_POSES } from './issStation.js';
|
||||
import { TIANGONG_NORAD } from './policy.js';
|
||||
import { trackedStation } from './stationModels.js';
|
||||
import {
|
||||
TIANGONG_ARMS,
|
||||
TIANGONG_ONE_AXIS_WINGS,
|
||||
TIANGONG_TWO_AXIS_WINGS,
|
||||
} from './tiangongArticulation.js';
|
||||
|
||||
/** The lab wings' slider labels, per TIANGONG_TWO_AXIS_WINGS entry. */
|
||||
const LAB_WING_LABELS = [
|
||||
[msg('Wentian forward · alpha'), msg('Wentian forward · beta')],
|
||||
[msg('Wentian aft · alpha'), msg('Wentian aft · beta')],
|
||||
[msg('Mengtian forward · alpha'), msg('Mengtian forward · beta')],
|
||||
[msg('Mengtian aft · alpha'), msg('Mengtian aft · beta')],
|
||||
];
|
||||
|
||||
/**
|
||||
* Tiangong as the STATION section describes it (stationPanel.js): its joint
|
||||
* driver from the model part, computed values only (China publishes no
|
||||
* telemetry), and the Manual controls: the Sun's position or a fast orbit,
|
||||
* and the two arms posed by joint.
|
||||
* @param {{state: object, parts: object}} context
|
||||
* @returns {import('./stationPanel.js').StationDescription}
|
||||
*/
|
||||
export function tiangongStationDescription({ state: layerState, parts }) {
|
||||
const model = () => parts.tiangongModel ?? null;
|
||||
const armGroup = (id, label, joints) => ({
|
||||
id,
|
||||
label,
|
||||
kind: 'sliders',
|
||||
resume: msg('Resume sway'),
|
||||
sliders: joints.map((joint, i) => ({
|
||||
id: joint.node,
|
||||
label: ISS_ARM_LABELS[i],
|
||||
min: -120,
|
||||
max: 120,
|
||||
apply: (a, value) =>
|
||||
a.setJoint(
|
||||
joint.node,
|
||||
joint.pivot,
|
||||
joint.axis,
|
||||
(value * Math.PI) / 180,
|
||||
),
|
||||
})),
|
||||
resumeApply: (a) => a.resumeArm(id),
|
||||
});
|
||||
// Every wing has a joint of its own, so each can be set apart from the
|
||||
// others; a wing not touched keeps following the Sun.
|
||||
const wingSlider = (joint, label) => ({
|
||||
id: joint.node,
|
||||
label,
|
||||
min: -180,
|
||||
max: 180,
|
||||
apply: (a, value) => a.setWingAngle(joint.node, (value * Math.PI) / 180),
|
||||
});
|
||||
const wingGroup = (id, label, sliders) => ({
|
||||
id,
|
||||
label,
|
||||
kind: 'sliders',
|
||||
resume: msg('Follow the Sun'),
|
||||
sliders,
|
||||
resumeApply: (a) => a.resumeWings(),
|
||||
});
|
||||
const tianheWings = wingGroup('tianhe-wings', msg('Tianhe wings (degrees)'), [
|
||||
wingSlider(TIANGONG_ONE_AXIS_WINGS[0], msg('Port wing')),
|
||||
wingSlider(TIANGONG_ONE_AXIS_WINGS[1], msg('Starboard wing')),
|
||||
]);
|
||||
const labWings = wingGroup(
|
||||
'lab-wings',
|
||||
msg('Lab wings (degrees)'),
|
||||
TIANGONG_TWO_AXIS_WINGS.flatMap((pair, i) => [
|
||||
wingSlider(pair.alpha, LAB_WING_LABELS[i][0]),
|
||||
wingSlider(pair.beta, LAB_WING_LABELS[i][1]),
|
||||
]),
|
||||
);
|
||||
return {
|
||||
key: 'tiangong',
|
||||
title: 'Tiangong', // i18n-ignore: the station's name
|
||||
selected: () => trackedStation(layerState, parts)?.norad === TIANGONG_NORAD,
|
||||
subjectName: () =>
|
||||
layerState._catalog.get(layerState._trackedNorad)?.name?.trim() ||
|
||||
`Tiangong · NORAD ${TIANGONG_NORAD}`,
|
||||
articulation: () => model()?._articulation ?? null,
|
||||
// No feed exists: the status line says so instead of waiting for one.
|
||||
telemetry: () => ({ state: 'none', poseAgeMs: null, liveUntilMs: null }),
|
||||
position: () =>
|
||||
model()?._visualPosition?.() ??
|
||||
layerState._trackedFrameCartesian ??
|
||||
parts.rendering?._pointPosition?.(TIANGONG_NORAD) ??
|
||||
null,
|
||||
zoomLabel: msg('Zoom to Tiangong'),
|
||||
notes: {
|
||||
computed: msg(
|
||||
'Arrays follow the Sun, the antenna aims at relay satellites and the arms sway for illustration. Computed: China publishes no live telemetry.',
|
||||
),
|
||||
},
|
||||
groups: [
|
||||
{
|
||||
id: 'sun',
|
||||
label: msg('Sun position'),
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{
|
||||
id: 'follow',
|
||||
label: msg('Follow the Sun'),
|
||||
isDefault: true,
|
||||
apply: (a) => a.setOverride(null),
|
||||
},
|
||||
...ISS_SUN_POSES.map(({ id, label, sun, sunlit }) => ({
|
||||
id,
|
||||
label,
|
||||
apply: (a) => {
|
||||
const fixed = { sun, sunlit };
|
||||
a.setOverride(() => fixed);
|
||||
},
|
||||
})),
|
||||
{
|
||||
id: 'orbit',
|
||||
label: msg('Fast orbit (40 s)'),
|
||||
apply: (a) => {
|
||||
const start = Date.now();
|
||||
a.setOverride((nowMs) => issCommandFastOrbit(nowMs - start));
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
tianheWings,
|
||||
labWings,
|
||||
armGroup('cmm', msg('Tianhe arm (degrees)'), TIANGONG_ARMS.cmm),
|
||||
armGroup('emm', msg('Wentian arm (degrees)'), TIANGONG_ARMS.emm),
|
||||
],
|
||||
automatic: (a) => {
|
||||
a.setOverride(null);
|
||||
a.resumeWings();
|
||||
a.resumeArm();
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,179 @@
|
||||
// src/layers/satellites/tiangongStation.test.mjs — Tiangong's STATION
|
||||
// description: every wing can be set apart from the others, and Automatic
|
||||
// hands them all back to the Sun.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import * as Cesium from 'cesium';
|
||||
import {
|
||||
createTiangongArticulation,
|
||||
TIANGONG_ONE_AXIS_WINGS,
|
||||
TIANGONG_TWO_AXIS_WINGS,
|
||||
} from './tiangongArticulation.js';
|
||||
import { issAxisMatrix } from './issArticulation.js';
|
||||
import { tiangongStationDescription } from './tiangongStation.js';
|
||||
import { TIANGONG_NORAD } from './policy.js';
|
||||
|
||||
function recordingArticulation() {
|
||||
const calls = [];
|
||||
return {
|
||||
calls,
|
||||
setOverride: (fn) => calls.push(['override', fn === null ? null : 'fn']),
|
||||
setJoint: (node, pivot, axis, angle) => calls.push(['joint', node, angle]),
|
||||
resumeArm: (key) => calls.push(['resumeArm', key ?? null]),
|
||||
setWingAngle: (node, angle) => calls.push(['wing', node, angle]),
|
||||
resumeWings: () => calls.push(['resumeWings']),
|
||||
};
|
||||
}
|
||||
|
||||
function description() {
|
||||
const layerState = {
|
||||
_trackedNorad: TIANGONG_NORAD,
|
||||
_catalog: new Map([[TIANGONG_NORAD, { name: 'CSS (TIANHE)' }]]),
|
||||
_points: new Map(),
|
||||
_trackedFrameCartesian: null,
|
||||
};
|
||||
const parts = { tiangongModel: { _articulation: null } };
|
||||
return tiangongStationDescription({ state: layerState, parts });
|
||||
}
|
||||
|
||||
test('the description offers one slider per wing joint: two on Tianhe, eight on the labs', () => {
|
||||
const d = description();
|
||||
const tianhe = d.groups.find((g) => g.id === 'tianhe-wings');
|
||||
const labs = d.groups.find((g) => g.id === 'lab-wings');
|
||||
assert.equal(tianhe.kind, 'sliders');
|
||||
assert.deepEqual(
|
||||
tianhe.sliders.map((s) => s.id),
|
||||
TIANGONG_ONE_AXIS_WINGS.slice(0, 2).map((w) => w.node),
|
||||
);
|
||||
assert.equal(labs.sliders.length, 8);
|
||||
assert.deepEqual(
|
||||
labs.sliders.map((s) => s.id),
|
||||
TIANGONG_TWO_AXIS_WINGS.flatMap((p) => [p.alpha.node, p.beta.node]),
|
||||
);
|
||||
const labels = new Set(labs.sliders.map((s) => s.label));
|
||||
assert.equal(labels.size, 8, 'every lab slider has a label of its own');
|
||||
for (const slider of [...tianhe.sliders, ...labs.sliders]) {
|
||||
assert.equal(slider.min, -180);
|
||||
assert.equal(slider.max, 180);
|
||||
}
|
||||
// The arms are still there, after the wings.
|
||||
assert.deepEqual(
|
||||
d.groups.map((g) => g.id),
|
||||
['sun', 'tianhe-wings', 'lab-wings', 'cmm', 'emm'],
|
||||
);
|
||||
});
|
||||
|
||||
test('a wing slider sets that wing alone, in radians; the group resume frees them all', () => {
|
||||
const d = description();
|
||||
const a = recordingArticulation();
|
||||
const labs = d.groups.find((g) => g.id === 'lab-wings');
|
||||
labs.sliders[3].apply(a, 90);
|
||||
assert.deepEqual(a.calls, [['wing', labs.sliders[3].id, Math.PI / 2]]);
|
||||
labs.resumeApply(a);
|
||||
assert.deepEqual(a.calls.at(-1), ['resumeWings']);
|
||||
assert.equal(labs.resume, 'Follow the Sun');
|
||||
});
|
||||
|
||||
test('Automatic hands the Sun, the wings and the arms back', () => {
|
||||
const d = description();
|
||||
const a = recordingArticulation();
|
||||
d.automatic(a);
|
||||
assert.deepEqual(a.calls, [
|
||||
['override', null],
|
||||
['resumeWings'],
|
||||
['resumeArm', null],
|
||||
]);
|
||||
});
|
||||
|
||||
/** A stand-in model whose nodes keep the last matrix written. */
|
||||
function fakeModel() {
|
||||
const nodes = new Map();
|
||||
return {
|
||||
ready: true,
|
||||
nodes,
|
||||
getNode(name) {
|
||||
// Cesium's node clones the matrix it is given; the driver writes a
|
||||
// shared scratch matrix, so the stand-in must clone too.
|
||||
if (!nodes.has(name))
|
||||
nodes.set(name, {
|
||||
_matrix: null,
|
||||
get matrix() {
|
||||
return this._matrix;
|
||||
},
|
||||
set matrix(value) {
|
||||
this._matrix = Cesium.Matrix4.clone(value);
|
||||
},
|
||||
});
|
||||
return nodes.get(name);
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
test('the driver holds a wing set by hand at its angle while the others follow the Sun', () => {
|
||||
const driver = createTiangongArticulation();
|
||||
const model = fakeModel();
|
||||
const date = new Date('2026-11-13T12:00:00Z');
|
||||
const position = new Cesium.Cartesian3(6_780_000, 0, 0);
|
||||
const axes = { x: [0, 1, 0], y: [0, 0, 1], z: [1, 0, 0] };
|
||||
// A fixed Sun: the real one would fetch Cesium's Earth-orientation data.
|
||||
const fixed = { sun: [0, 0.6, 0.8], sunlit: true };
|
||||
driver.setOverride(() => fixed);
|
||||
driver.update(model, date, position, axes, 1000);
|
||||
const port = TIANGONG_ONE_AXIS_WINGS[0];
|
||||
const starboard = TIANGONG_ONE_AXIS_WINGS[1];
|
||||
const portBefore = Cesium.Matrix4.clone(model.getNode(port.node).matrix);
|
||||
const starboardBefore = Cesium.Matrix4.clone(
|
||||
model.getNode(starboard.node).matrix,
|
||||
);
|
||||
driver.setWingAngle(port.node, 1.2);
|
||||
// Long after the last frame: the step is not rate-limited.
|
||||
driver.update(model, date, position, axes, 11_000);
|
||||
const expected = issAxisMatrix(
|
||||
port.pivot,
|
||||
port.axis,
|
||||
1.2,
|
||||
new Cesium.Matrix4(),
|
||||
);
|
||||
assert.ok(
|
||||
Cesium.Matrix4.equalsEpsilon(
|
||||
model.getNode(port.node).matrix,
|
||||
expected,
|
||||
1e-9,
|
||||
),
|
||||
'the port wing is at the set angle',
|
||||
);
|
||||
assert.ok(
|
||||
Cesium.Matrix4.equalsEpsilon(
|
||||
model.getNode(starboard.node).matrix,
|
||||
starboardBefore,
|
||||
1e-9,
|
||||
),
|
||||
'the starboard wing kept its Sun angle (same Sun, same date)',
|
||||
);
|
||||
assert.equal(
|
||||
Cesium.Matrix4.equals(model.getNode(port.node).matrix, portBefore),
|
||||
false,
|
||||
'the set angle differs from the Sun angle',
|
||||
);
|
||||
driver.resumeWings();
|
||||
driver.update(model, date, position, axes, 21_000);
|
||||
assert.ok(
|
||||
Cesium.Matrix4.equalsEpsilon(
|
||||
model.getNode(port.node).matrix,
|
||||
portBefore,
|
||||
1e-9,
|
||||
),
|
||||
'back to the Sun once freed',
|
||||
);
|
||||
// Null frees one wing on its own.
|
||||
driver.setWingAngle(port.node, 0.3);
|
||||
driver.setWingAngle(port.node, null);
|
||||
driver.update(model, date, position, axes, 31_000);
|
||||
assert.ok(
|
||||
Cesium.Matrix4.equalsEpsilon(
|
||||
model.getNode(port.node).matrix,
|
||||
portBefore,
|
||||
1e-9,
|
||||
),
|
||||
);
|
||||
});
|
||||
@@ -1,19 +1,21 @@
|
||||
import { cameraOf } from '../../render/rendererOf.js';
|
||||
import { entityFollowTarget, stopFollowing } from '../../data/followed.js';
|
||||
import { satelliteClassText } from '../../data/satelliteClass.js';
|
||||
import { fromDegreesInto } from '../../geo/ellipsoid.js';
|
||||
import { clone, scale } from '../../geo/vector.js';
|
||||
import { fromDegrees, fromDegreesInto } from '../../geo/ellipsoid.js';
|
||||
import { clone, distance, scale } from '../../geo/vector.js';
|
||||
import { t } from '../../i18n/index.js';
|
||||
import { formatQuantity, unitLabel } from '../../ui/unitLabels.js';
|
||||
import {
|
||||
ISS_NORAD,
|
||||
CONTEXT_REFRESH_INTERVAL_MS,
|
||||
HIGH_ORBIT_ALTITUDE_M,
|
||||
ISS_NORAD,
|
||||
STATIONS,
|
||||
TRACK_VIEW_FROM_HIGH_SCALE,
|
||||
TRACK_VIEW_FROM_LEO,
|
||||
TRACKED_ORBIT_COLOR,
|
||||
} from './policy.js';
|
||||
import { entityRecord, readEntityRecord } from '../../data/entityRecords.js';
|
||||
import { modelFor } from './stationModels.js';
|
||||
|
||||
export function createTracking({ state: layerState, services, parts, source }) {
|
||||
const { clearFocusTarget } = services.focus;
|
||||
@@ -118,6 +120,8 @@ export function createTracking({ state: layerState, services, parts, source }) {
|
||||
layerState._trackedEntity = null;
|
||||
}
|
||||
layerState._trackedNorad = null;
|
||||
layerState._trackedDockedToStation = null;
|
||||
layerState._trackedDockedToIss = false;
|
||||
parts.controls._syncIssOrbit?.();
|
||||
// A held Cockpit subject that stops being tracked gets its marks back.
|
||||
if (layerState._cockpitSubjectNorad !== null)
|
||||
@@ -384,13 +388,11 @@ export function createTracking({ state: layerState, services, parts, source }) {
|
||||
: t('DOCKED · {name}', { name: companions[0] }),
|
||||
);
|
||||
}
|
||||
// While the ISS model shows, the card keeps clear of it: the gap follows
|
||||
// the station's size on screen, in steps so the card is not republished
|
||||
// every frame.
|
||||
// While a station's model shows, the card keeps clear of it: the gap
|
||||
// follows the station's size on screen, in steps so the card is not
|
||||
// republished every frame.
|
||||
const clearPx =
|
||||
layerState._trackedNorad === ISS_NORAD
|
||||
? parts.issModel?._issCardClearPx?.()
|
||||
: null;
|
||||
modelFor(parts, layerState._trackedNorad)?._cardClearPx?.() ?? null;
|
||||
// The overlay's gap is twice the anchor radius, so half the clearance.
|
||||
const anchorRadiusPx = clearPx ? Math.round(clearPx / 8) * 4 : null;
|
||||
const current = readEntityRecord(layerState._trackedEntity)?.labelModel;
|
||||
@@ -411,6 +413,33 @@ export function createTracking({ state: layerState, services, parts, source }) {
|
||||
refreshTrackedReadout(layerState._trackedEntity);
|
||||
}
|
||||
|
||||
/**
|
||||
* The station a satellite is docked to: both orbits, propagated to one
|
||||
* instant, within the station's companion radius (dots are moved at
|
||||
* different moments, so their spacing cannot say). A station is docked to
|
||||
* nothing, and the dense group never is.
|
||||
* @param {number} noradId
|
||||
* @returns {number|null} The station's NORAD number, or null.
|
||||
*/
|
||||
function _dockedToStation(noradId) {
|
||||
if (STATIONS.some((station) => station.norad === noradId)) return null;
|
||||
const sat = layerState._catalog.get(noradId);
|
||||
if (!sat?.satrec || sat.group === 'dense') return null;
|
||||
const date = new Date(layerState.now());
|
||||
const at = (p) => fromDegrees(p.longitude, p.latitude, p.altitude);
|
||||
let own = null;
|
||||
for (const station of STATIONS) {
|
||||
const entry = layerState._catalog.get(station.norad);
|
||||
if (!entry?.satrec) continue;
|
||||
own ??= parts.orbits.propagatePosition(sat.satrec, date);
|
||||
if (!own) return null;
|
||||
const there = parts.orbits.propagatePosition(entry.satrec, date);
|
||||
if (there && distance(at(own), at(there)) <= station.companionRadiusM)
|
||||
return station.norad;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function _trackSatellite(noradId, { origin = 'programmatic' } = {}) {
|
||||
_clearTracking(false, { origin });
|
||||
|
||||
@@ -425,9 +454,18 @@ export function createTracking({ state: layerState, services, parts, source }) {
|
||||
// Hide the dot — the tracked dot draws it, larger and over everything.
|
||||
parts.rendering._hidePoint(noradId);
|
||||
|
||||
// Show orbital path
|
||||
parts.rendering._showOrbitPath(noradId, TRACKED_ORBIT_COLOR);
|
||||
if (noradId === ISS_NORAD) parts.controls._syncIssOrbit?.();
|
||||
// Show orbital path. An object docked to the ISS (Nauka, a Progress…)
|
||||
// flies the station's orbit under elements of its own: its ring would
|
||||
// run beside the ISS's, a second line through the same station. The
|
||||
// ISS's ring stands for it instead. Another station's ring is drawn only
|
||||
// while that station is tracked, so its docked objects keep their own.
|
||||
layerState._trackedDockedToStation = _dockedToStation(noradId);
|
||||
layerState._trackedDockedToIss =
|
||||
layerState._trackedDockedToStation === ISS_NORAD;
|
||||
if (!layerState._trackedDockedToIss)
|
||||
parts.rendering._showOrbitPath(noradId, TRACKED_ORBIT_COLOR);
|
||||
if (noradId === ISS_NORAD || layerState._trackedDockedToIss)
|
||||
parts.controls._syncIssOrbit?.();
|
||||
|
||||
// The tracked position propagates per evaluation through the per-frame
|
||||
// cache (WS-D2) — dot, host readout, and camera share one SGP4 epoch per frame.
|
||||
@@ -462,10 +500,11 @@ export function createTracking({ state: layerState, services, parts, source }) {
|
||||
entityRecord(layerState._trackedEntity).trackedId = `satellites:${noradId}`;
|
||||
entityRecord(layerState._trackedEntity).displayPosition =
|
||||
_trackedDisplayCached;
|
||||
// Up close the ISS is a 3D model: the card welds to where it is drawn.
|
||||
if (noradId === ISS_NORAD)
|
||||
entityRecord(layerState._trackedEntity).visualPosition = () =>
|
||||
parts.issModel?._issVisualPosition?.() ?? null;
|
||||
// Up close a station is a 3D model: the card welds to where it is drawn.
|
||||
// So does the card of an object docked to it, which the model stands in
|
||||
// for.
|
||||
entityRecord(layerState._trackedEntity).visualPosition = () =>
|
||||
modelFor(parts, noradId)?._visualPosition?.() ?? null;
|
||||
_updateTrackedSatelliteLabelModel(initialPos?.altitude ?? null);
|
||||
|
||||
const dotPosition = parts.rendering._pointPosition(noradId);
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import { followedOf } from '../data/followed.js';
|
||||
import { readEntityRecord } from '../data/entityRecords.js';
|
||||
import { nextTick } from 'vue';
|
||||
import { nextTick, watch } from 'vue';
|
||||
import { resolveImageryHost } from '../layers/weather/imageryHost.js';
|
||||
import { ShellFacade } from './shellFacade.js';
|
||||
import { AircraftDisplay } from './aircraftDisplay.js';
|
||||
@@ -25,6 +25,7 @@ import { CctvControls } from './cctv.js';
|
||||
import { StreetLevelControls } from './streetLevelControls.js';
|
||||
import { createWildlifeSightingCard } from './wildlifeSightingCard.js';
|
||||
import { RadioControls } from './radio.js';
|
||||
import { LiveControls } from './liveControls.js';
|
||||
import { LocalSdrControls } from './localSdrControls.js';
|
||||
import { LocationNavigation } from './locationNavigation.js';
|
||||
import { bindCameraOrientationControls } from './cameraOrientationControls.js';
|
||||
@@ -62,6 +63,8 @@ import { applyLocaleChoice } from './localePicker.js';
|
||||
import { PanelNavigation } from './panelNavigation.js';
|
||||
import { applicationPinia, createUiRuntime } from './vueRuntime.js';
|
||||
import { useContextStore } from './stores/context.js';
|
||||
import { useLiveStore } from './stores/live.js';
|
||||
import { useStationStore } from './stores/station.js';
|
||||
import { useMissionReplayStore } from './stores/missionReplay.js';
|
||||
import { useCelestialRingStore } from './stores/celestialRing.js';
|
||||
import { icrfToFixedAxes } from '../sky/icrf.js';
|
||||
@@ -994,6 +997,7 @@ export class StyleManager extends ShellFacade {
|
||||
militaryInstallationsLayer,
|
||||
militaryAwarenessLayer,
|
||||
rocketLaunchesLayer,
|
||||
satellitesLayer,
|
||||
} = this.services;
|
||||
const contextStore = useContextStore(applicationPinia());
|
||||
this._contextControls = new ContextControls({
|
||||
@@ -1050,6 +1054,39 @@ export class StyleManager extends ShellFacade {
|
||||
rocketLaunchesLayer?.subscribeReplayOverlay?.((view) =>
|
||||
missionReplayStore.publish(view),
|
||||
);
|
||||
// The STATION section: the selected space station's moving parts, as
|
||||
// the satellites layer presents them; its controls reach the layer.
|
||||
const stationStore = useStationStore(applicationPinia());
|
||||
this._stationPanelUnsubscribe?.();
|
||||
if (this._stationOwner) stationStore.detach(this._stationOwner);
|
||||
this._stationOwner = null;
|
||||
stationStore.publish(null);
|
||||
if (satellitesLayer?.getStationActions)
|
||||
this._stationOwner = stationStore.connect(
|
||||
satellitesLayer.getStationActions(),
|
||||
);
|
||||
this._stationPanelUnsubscribe = satellitesLayer?.subscribeStationPanel?.(
|
||||
(view) => stationStore.publish(view),
|
||||
);
|
||||
// The LIVE section: streams attached to whatever the tracking layers
|
||||
// select, in the platform's own player, started as soon as one is chosen.
|
||||
this._liveControls?.destroy();
|
||||
const liveStore = useLiveStore(applicationPinia());
|
||||
this._liveControls = new LiveControls({
|
||||
store: liveStore,
|
||||
actions: {
|
||||
getLayer: (layerId) =>
|
||||
this._dataManager?.layers?.get(layerId)?.module ?? null,
|
||||
scheduleLayout: () => this._scheduleRightPanelLayout(),
|
||||
},
|
||||
});
|
||||
// The Cockpit briefing offers its LIVE page while a stream is on offer.
|
||||
this._liveOfferedUnwatch?.();
|
||||
this._liveOfferedUnwatch = watch(
|
||||
() => liveStore.view !== null,
|
||||
(offered) => this.cockpitView?.setBriefLiveOffered?.(offered),
|
||||
{ immediate: true },
|
||||
);
|
||||
}
|
||||
|
||||
/** Wire the independent Radio companion controls. */
|
||||
@@ -1907,6 +1944,14 @@ export class StyleManager extends ShellFacade {
|
||||
this.services?.streetLevelLayer?.attachNavigation?.(null);
|
||||
this._streetLevelControls?.destroy();
|
||||
this._radioControls?.destroy();
|
||||
this._liveControls?.destroy();
|
||||
this._liveOfferedUnwatch?.();
|
||||
this._liveOfferedUnwatch = null;
|
||||
this._stationPanelUnsubscribe?.();
|
||||
this._stationPanelUnsubscribe = null;
|
||||
if (this._stationOwner)
|
||||
useStationStore(applicationPinia()).detach(this._stationOwner);
|
||||
this._stationOwner = null;
|
||||
this._localSdrControls?.destroy();
|
||||
this._awarenessPanelUnsubscribe?.();
|
||||
this._awarenessPanelUnsubscribe = null;
|
||||
|
||||
@@ -46,6 +46,48 @@ export const COCKPIT_BRIEF_PAGES = [
|
||||
},
|
||||
];
|
||||
|
||||
/**
|
||||
* The fourth page, LIVE: the ridden subject's live video, the LIVE section
|
||||
* of Context in the card. Offered only while a stream is on offer (the
|
||||
* `gev-live` store's view is not null); the automatic cycle never turns to it.
|
||||
*/
|
||||
export const COCKPIT_LIVE_BRIEF_PAGE = Object.freeze({
|
||||
id: 'live',
|
||||
kickerKey: msg('LIVE VIDEO'),
|
||||
subtitleKey: msg('STREAM ATTACHED TO THE SUBJECT'),
|
||||
// Attribution stays English; the page itself credits the stream's owner.
|
||||
source: 'YOUTUBE EMBEDDED PLAYER · MUTED',
|
||||
});
|
||||
|
||||
/**
|
||||
* The pages on offer: the three fixed ones, and LIVE after them while the
|
||||
* ridden subject has a stream.
|
||||
* @param {boolean} liveOffered
|
||||
* @returns {readonly object[]}
|
||||
*/
|
||||
export function cockpitBriefPages(liveOffered) {
|
||||
return liveOffered
|
||||
? [...COCKPIT_BRIEF_PAGES, COCKPIT_LIVE_BRIEF_PAGE]
|
||||
: COCKPIT_BRIEF_PAGES;
|
||||
}
|
||||
|
||||
/**
|
||||
* Where the automatic cycle goes from the page at `index`: the next page
|
||||
* that is not LIVE (video is never started by the cycle), wrapping; null
|
||||
* while LIVE is the shown page, where the cycle waits as it does under the
|
||||
* pointer.
|
||||
* @param {readonly object[]} pages
|
||||
* @param {number} index
|
||||
* @returns {number|null}
|
||||
*/
|
||||
export function briefCycleTarget(pages, index) {
|
||||
if (pages[index]?.id === 'live') return null;
|
||||
const count = pages.length;
|
||||
let next = (index + 1) % count;
|
||||
if (pages[next]?.id === 'live') next = (next + 1) % count;
|
||||
return next;
|
||||
}
|
||||
|
||||
// The cycle toggle's tooltip, as literal keys for the extractor.
|
||||
export const CYCLE_HELP_KEYS = Object.freeze({
|
||||
on: msg(
|
||||
|
||||
@@ -9,8 +9,9 @@ import {
|
||||
formatCockpitWindDirection,
|
||||
} from './cockpitPresentation.js';
|
||||
import {
|
||||
COCKPIT_BRIEF_PAGES,
|
||||
CYCLE_HELP_KEYS,
|
||||
briefCycleTarget,
|
||||
cockpitBriefPages,
|
||||
createBriefState,
|
||||
newsWindowFooter,
|
||||
} from './cockpitBriefPages.js';
|
||||
@@ -48,11 +49,17 @@ export function publishBriefView() {
|
||||
});
|
||||
}
|
||||
|
||||
/** The pages on offer now: three, or four with LIVE while a stream is. */
|
||||
function briefPages() {
|
||||
return cockpitBriefPages(this.briefLiveOffered === true);
|
||||
}
|
||||
|
||||
export function showBriefPage(index, { manual = false } = {}) {
|
||||
if (this.destroyed) return;
|
||||
const count = COCKPIT_BRIEF_PAGES.length;
|
||||
const pages = briefPages.call(this);
|
||||
const count = pages.length;
|
||||
this.briefPageIndex = ((Number(index) % count) + count) % count;
|
||||
const page = COCKPIT_BRIEF_PAGES[this.briefPageIndex];
|
||||
const page = pages[this.briefPageIndex];
|
||||
Object.assign(this.brief, {
|
||||
pageIndex: this.briefPageIndex,
|
||||
pageId: page.id,
|
||||
@@ -101,6 +108,20 @@ export function relocalizeBrief() {
|
||||
this.renderRegionalBriefStatus(this.brief.news.state, this.lastSubjectInfo);
|
||||
}
|
||||
|
||||
/**
|
||||
* Offer or withdraw the LIVE page, as the ridden subject's stream comes and
|
||||
* goes. A LIVE page shown as its stream goes falls back to Live Signals;
|
||||
* otherwise the shown page stays and its position counts the pages anew.
|
||||
*/
|
||||
export function setBriefLiveOffered(offered) {
|
||||
if (this.destroyed) return;
|
||||
const next = offered === true;
|
||||
if (next === this.briefLiveOffered) return;
|
||||
this.briefLiveOffered = next;
|
||||
const count = cockpitBriefPages(next).length;
|
||||
this.showBriefPage(this.briefPageIndex < count ? this.briefPageIndex : 0);
|
||||
}
|
||||
|
||||
export function setBriefAutoRotate(enabled) {
|
||||
if (this.destroyed) return;
|
||||
this.briefAutoRotateEnabled = Boolean(enabled);
|
||||
@@ -129,7 +150,13 @@ export function startBriefRotation({ reset = false } = {}) {
|
||||
this.signalStream?.contains(document.activeElement) === true;
|
||||
const isInteracting = hasPointer || hasFocus;
|
||||
if (!isInteracting) {
|
||||
this.showBriefPage(this.briefPageIndex + 1);
|
||||
// The cycle never turns to the LIVE page, and waits while it is shown:
|
||||
// video starts and stops on request only.
|
||||
const target = briefCycleTarget(
|
||||
briefPages.call(this),
|
||||
this.briefPageIndex,
|
||||
);
|
||||
if (target !== null) this.showBriefPage(target);
|
||||
}
|
||||
this.startBriefRotation();
|
||||
}, COCKPIT_BRIEF_ROTATE_MS);
|
||||
|
||||
@@ -8,18 +8,24 @@ import { fileURLToPath } from 'node:url';
|
||||
import { createPinia } from 'pinia';
|
||||
import { createApp, nextTick } from 'vue';
|
||||
import { setLocale } from '../i18n/index.js';
|
||||
import { createBriefState } from './cockpitBriefPages.js';
|
||||
import {
|
||||
briefCycleTarget,
|
||||
cockpitBriefPages,
|
||||
createBriefState,
|
||||
} from './cockpitBriefPages.js';
|
||||
import {
|
||||
maybeRefreshRegionalBrief,
|
||||
publishBriefView,
|
||||
renderRegionalBrief,
|
||||
renderRegionalBriefStatus,
|
||||
setBriefAutoRotate,
|
||||
setBriefLiveOffered,
|
||||
showBriefPage,
|
||||
updateLocalPosition,
|
||||
} from './cockpitBriefing.js';
|
||||
import { setSignalCollapsed } from './cockpitLayout.js';
|
||||
import { useCockpitStore } from './stores/cockpit.js';
|
||||
import { useLiveStore } from './stores/live.js';
|
||||
import CockpitBriefing from './views/panels/CockpitBriefing.vue';
|
||||
|
||||
function fixture(t) {
|
||||
@@ -35,9 +41,11 @@ function fixture(t) {
|
||||
destroyed: false,
|
||||
briefPageIndex: 0,
|
||||
briefAutoRotateEnabled: false,
|
||||
briefLiveOffered: false,
|
||||
brief: createBriefState(),
|
||||
publishBrief: (view) => store.publishBrief(view),
|
||||
publishBriefView,
|
||||
showBriefPage,
|
||||
scheduleContextLayout() {},
|
||||
startBriefRotation() {},
|
||||
stopBriefRotation() {},
|
||||
@@ -49,11 +57,49 @@ function fixture(t) {
|
||||
[...document.querySelectorAll('[data-cockpit-brief-page]')]
|
||||
.filter((page) => !page.hidden)
|
||||
.map((page) => page.dataset.cockpitBriefPage);
|
||||
// The tabs on offer: the LIVE tab is in the markup but hidden without a stream.
|
||||
const current = () =>
|
||||
[...document.querySelectorAll('[data-cockpit-brief-index]')].map((tab) =>
|
||||
tab.getAttribute('aria-current'),
|
||||
[...document.querySelectorAll('[data-cockpit-brief-index]')]
|
||||
.filter((tab) => !tab.hidden)
|
||||
.map((tab) => tab.getAttribute('aria-current'));
|
||||
// A stream on offer for the ridden subject, as LiveControls publishes it;
|
||||
// the briefing then offers its LIVE page.
|
||||
const liveStore = useLiveStore(pinia);
|
||||
const liveActed = [];
|
||||
liveStore.connect({
|
||||
cycleLive: (direction) => liveActed.push(['cycle', direction]),
|
||||
playLive: () => liveActed.push(['play']),
|
||||
stopLive: () => liveActed.push(['stop']),
|
||||
retryLive: () => liveActed.push(['retry']),
|
||||
});
|
||||
const offerLive = async (view) => {
|
||||
liveStore.publish(
|
||||
view && {
|
||||
label: 'ISS (ZARYA)',
|
||||
streams: [
|
||||
{ id: 'iss-exterior', title: 'Exterior cameras', owner: 'NASA' },
|
||||
{ id: 'iss-crew', title: 'Live video and audio', owner: 'NASA' },
|
||||
],
|
||||
index: 0,
|
||||
count: 2,
|
||||
current: {
|
||||
id: 'iss-exterior',
|
||||
title: 'Exterior cameras',
|
||||
owner: 'NASA',
|
||||
ownerUrl: 'https://www.youtube.com/@NASA',
|
||||
note: 'NASA video, via YouTube',
|
||||
watchUrl: 'https://www.youtube.com/watch?v=ROboUHfPUrU',
|
||||
},
|
||||
state: 'idle',
|
||||
reason: null,
|
||||
...view,
|
||||
},
|
||||
);
|
||||
return { $, text, owner, visiblePages, current };
|
||||
setBriefLiveOffered.call(owner, view !== null);
|
||||
await nextTick();
|
||||
await nextTick();
|
||||
};
|
||||
return { $, text, owner, visiblePages, current, offerLive, liveActed };
|
||||
}
|
||||
|
||||
const INFO = { latitude: 30.25, longitude: -97.75 };
|
||||
@@ -111,6 +157,147 @@ test('pages, the cycle toggle and the source follow the controller', async (t) =
|
||||
assert.match(auto.title, /^Stop automatic page cycling/);
|
||||
});
|
||||
|
||||
test('without a stream the briefing keeps its three pages and hides the LIVE tab', async (t) => {
|
||||
const { $, text, owner, visiblePages } = fixture(t);
|
||||
const liveTab = $('[data-cockpit-brief-index="3"]');
|
||||
assert.equal(liveTab.hidden, true);
|
||||
assert.equal(liveTab.textContent, 'LIVE');
|
||||
assert.equal(liveTab.getAttribute('aria-label'), 'Show Live Video');
|
||||
assert.equal(
|
||||
$('[data-cockpit-brief-page="live"]').querySelector('*'),
|
||||
null,
|
||||
'no page body without a stream',
|
||||
);
|
||||
// Next from Local wraps to Live Signals, past the page not on offer.
|
||||
showBriefPage.call(owner, 3);
|
||||
await nextTick();
|
||||
assert.deepEqual(visiblePages(), ['signals']);
|
||||
assert.equal(text('#cockpit-brief-position'), '1 / 3');
|
||||
});
|
||||
|
||||
test('with a stream the LIVE page is the fourth, reached by the arrows and its tab', async (t) => {
|
||||
const { $, text, owner, visiblePages, current, offerLive } = fixture(t);
|
||||
await offerLive({});
|
||||
assert.equal(text('#cockpit-brief-position'), '1 / 4');
|
||||
const liveTab = $('[data-cockpit-brief-index="3"]');
|
||||
assert.equal(liveTab.hidden, false);
|
||||
assert.deepEqual(current(), ['true', 'false', 'false', 'false']);
|
||||
showBriefPage.call(owner, 2);
|
||||
showBriefPage.call(owner, owner.briefPageIndex + 1);
|
||||
await nextTick();
|
||||
assert.deepEqual(visiblePages(), ['live']);
|
||||
assert.deepEqual(current(), ['false', 'false', 'false', 'true']);
|
||||
assert.equal(text('#cockpit-brief-kicker'), 'LIVE VIDEO');
|
||||
assert.equal(
|
||||
text('#cockpit-brief-subtitle'),
|
||||
'STREAM ATTACHED TO THE SUBJECT',
|
||||
);
|
||||
assert.equal(text('#cockpit-brief-position'), '4 / 4');
|
||||
assert.equal(
|
||||
text('#cockpit-brief-source'),
|
||||
'YOUTUBE EMBEDDED PLAYER · MUTED',
|
||||
);
|
||||
assert.equal($('#cockpit-signal-stream').dataset.briefPage, 'live');
|
||||
// The page shows what the LIVE section shows, with the player's own screen.
|
||||
const page = $('[data-cockpit-brief-page="live"]');
|
||||
assert.equal(
|
||||
page.querySelector('.cockpit-live-subject strong').textContent,
|
||||
'ISS (ZARYA)',
|
||||
);
|
||||
assert.equal(text('#cockpit-live-stream-title'), 'Exterior cameras · 1/2');
|
||||
assert.ok($('#cockpit-live-player-host'));
|
||||
assert.ok($('#cockpit-live-previous'));
|
||||
assert.ok($('#cockpit-live-next'));
|
||||
assert.equal(text('#cockpit-live-badge-text'), 'OFF');
|
||||
assert.equal(text('#cockpit-live-status'), 'Starting…');
|
||||
assert.equal(
|
||||
$('#cockpit-live-watch-link').getAttribute('href'),
|
||||
'https://www.youtube.com/watch?v=ROboUHfPUrU',
|
||||
);
|
||||
// Next from LIVE wraps to Live Signals.
|
||||
showBriefPage.call(owner, owner.briefPageIndex + 1);
|
||||
await nextTick();
|
||||
assert.deepEqual(visiblePages(), ['signals']);
|
||||
assert.equal(text('#cockpit-brief-position'), '1 / 4');
|
||||
});
|
||||
|
||||
test('the LIVE page asks for the stream as soon as it is offered, and its controls reach LiveControls', async (t) => {
|
||||
const { $, owner, offerLive, liveActed } = fixture(t);
|
||||
await offerLive({});
|
||||
assert.deepEqual(
|
||||
liveActed,
|
||||
[['play']],
|
||||
'the player starts on selection, whichever page is shown',
|
||||
);
|
||||
showBriefPage.call(owner, 3);
|
||||
await offerLive({ state: 'playing' });
|
||||
const page = $('[data-cockpit-brief-page="live"]');
|
||||
assert.equal($('#cockpit-live-badge-text').textContent, 'ON AIR');
|
||||
assert.equal(
|
||||
page.querySelector('.live-dot').classList.contains('on-air'),
|
||||
true,
|
||||
);
|
||||
assert.equal(
|
||||
page.querySelector('.live-screen').classList.contains('active'),
|
||||
true,
|
||||
);
|
||||
assert.equal($('#cockpit-live-status').textContent, 'Live');
|
||||
$('#cockpit-live-next').click();
|
||||
$('#cockpit-live-previous').click();
|
||||
assert.deepEqual(liveActed, [['play'], ['cycle', 1], ['cycle', -1]]);
|
||||
await offerLive({ state: 'offline', reason: 'timeout' });
|
||||
const card = page.querySelector('.live-card');
|
||||
assert.equal(card.classList.contains('offline'), true);
|
||||
assert.equal(card.querySelector('strong').textContent, 'Stream is offline');
|
||||
$('#cockpit-live-retry').click();
|
||||
assert.deepEqual(liveActed.at(-1), ['retry']);
|
||||
await offerLive({ state: 'unavailable', reason: 'error-150' });
|
||||
assert.equal($('#cockpit-live-retry'), null);
|
||||
assert.equal(
|
||||
$('#cockpit-live-status').textContent,
|
||||
'This stream cannot play here',
|
||||
);
|
||||
});
|
||||
|
||||
test('the stream going while LIVE is shown falls back to Live Signals with three pages', async (t) => {
|
||||
const { $, text, owner, visiblePages, offerLive } = fixture(t);
|
||||
await offerLive({});
|
||||
showBriefPage.call(owner, 3);
|
||||
await nextTick();
|
||||
assert.deepEqual(visiblePages(), ['live']);
|
||||
await offerLive(null);
|
||||
assert.deepEqual(visiblePages(), ['signals']);
|
||||
assert.equal(text('#cockpit-brief-position'), '1 / 3');
|
||||
assert.equal($('[data-cockpit-brief-index="3"]').hidden, true);
|
||||
// Going on another page, the page stays and only the count changes.
|
||||
showBriefPage.call(owner, 1);
|
||||
await offerLive({});
|
||||
assert.deepEqual(visiblePages(), ['news']);
|
||||
assert.equal(text('#cockpit-brief-position'), '2 / 4');
|
||||
// Offering what is already offered changes nothing.
|
||||
const views = [];
|
||||
owner.publishBrief = (view) => views.push(view);
|
||||
setBriefLiveOffered.call(owner, true);
|
||||
assert.equal(views.length, 0);
|
||||
});
|
||||
|
||||
test('the automatic cycle never turns to the LIVE page and waits while it is shown', () => {
|
||||
const three = cockpitBriefPages(false);
|
||||
assert.deepEqual(
|
||||
[0, 1, 2].map((index) => briefCycleTarget(three, index)),
|
||||
[1, 2, 0],
|
||||
);
|
||||
const four = cockpitBriefPages(true);
|
||||
assert.equal(four.length, 4);
|
||||
assert.equal(four[3].id, 'live');
|
||||
assert.deepEqual(
|
||||
[0, 1, 2].map((index) => briefCycleTarget(four, index)),
|
||||
[1, 2, 0],
|
||||
'Local goes back to Live Signals, past LIVE',
|
||||
);
|
||||
assert.equal(briefCycleTarget(four, 3), null, 'shown by hand, LIVE stays');
|
||||
});
|
||||
|
||||
test('regional news and local conditions render what the region returned', async (t) => {
|
||||
const { $, text, owner } = fixture(t);
|
||||
renderRegionalBriefStatus.call(owner, 'loading', INFO);
|
||||
|
||||
@@ -26,10 +26,12 @@ import {
|
||||
import { update } from './cockpitCamera.js';
|
||||
import {
|
||||
beginOrbital,
|
||||
orbitalViewSignal,
|
||||
endOrbital,
|
||||
resetOrbitalLook,
|
||||
jumpToSensorSwath,
|
||||
onOrbitalWheel,
|
||||
stepOrbitalMount,
|
||||
stepOrbitalZoom,
|
||||
turnOrbitalLook,
|
||||
updateOrbital,
|
||||
@@ -77,6 +79,7 @@ import {
|
||||
publishBriefView,
|
||||
showBriefPage,
|
||||
setBriefAutoRotate,
|
||||
setBriefLiveOffered,
|
||||
startBriefRotation,
|
||||
stopBriefRotation,
|
||||
updateLocalPosition,
|
||||
@@ -271,6 +274,8 @@ export class CockpitViewController {
|
||||
this.signalSignatures = new Map();
|
||||
this.briefPageIndex = 0;
|
||||
this.briefAutoRotateEnabled = false;
|
||||
/** Whether the briefing offers its LIVE page (the subject has a stream). */
|
||||
this.briefLiveOffered = false;
|
||||
// Cockpit's views render what these receive.
|
||||
this.publishPresence = publish.presence ?? (() => {});
|
||||
this.publishBrief = publish.brief ?? (() => {});
|
||||
@@ -401,6 +406,10 @@ export class CockpitViewController {
|
||||
else if (target?.closest?.('#cockpit-orbital-zoom-out'))
|
||||
this.stepOrbitalZoom(-1);
|
||||
else if (target?.closest?.('#cockpit-orbital-nadir')) this.orbitalNadir();
|
||||
else if (target?.closest?.('#cockpit-orbital-view-next'))
|
||||
this.nextOrbitalView();
|
||||
else if (target?.closest?.('#cockpit-orbital-view-previous'))
|
||||
this.previousOrbitalView();
|
||||
else if (target?.closest?.('#cockpit-orbital-sensor'))
|
||||
this.jumpToSensorSwath();
|
||||
});
|
||||
@@ -454,6 +463,26 @@ export class CockpitViewController {
|
||||
beginOrbital() {
|
||||
return beginOrbital.call(this);
|
||||
}
|
||||
|
||||
orbitalViewSignal(info) {
|
||||
return orbitalViewSignal.call(this, info);
|
||||
}
|
||||
|
||||
/**
|
||||
* The station view's right arrow: step to the station's next view.
|
||||
* @returns {boolean} True when the view changed.
|
||||
*/
|
||||
nextOrbitalView() {
|
||||
return stepOrbitalMount.call(this, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* The station view's left arrow: step back to the view before.
|
||||
* @returns {boolean} True when the view changed.
|
||||
*/
|
||||
previousOrbitalView() {
|
||||
return stepOrbitalMount.call(this, -1);
|
||||
}
|
||||
endOrbital() {
|
||||
return endOrbital.call(this);
|
||||
}
|
||||
@@ -711,6 +740,9 @@ export class CockpitViewController {
|
||||
setBriefAutoRotate(enabled) {
|
||||
return setBriefAutoRotate.call(this, enabled);
|
||||
}
|
||||
setBriefLiveOffered(offered) {
|
||||
return setBriefLiveOffered.call(this, offered);
|
||||
}
|
||||
startBriefRotation(options) {
|
||||
return startBriefRotation.call(this, options);
|
||||
}
|
||||
|
||||
@@ -115,8 +115,19 @@ function sitePosition(site) {
|
||||
: null;
|
||||
}
|
||||
|
||||
/** The mapped site a canvas position shows, through the layer's picks. */
|
||||
/**
|
||||
* The mapped site a canvas position shows: through the layer's own lookup
|
||||
* where it has one (`findAt`: the dot, the site entity or the label box the
|
||||
* overlay paints, which is what a click lands on from orbit), else through
|
||||
* its pick ids.
|
||||
*/
|
||||
function siteAt(controller, position) {
|
||||
try {
|
||||
const found = sitesLayer(controller)?.findAt?.(position) ?? null;
|
||||
if (found) return found;
|
||||
} catch {
|
||||
// Fall through to the pick ids.
|
||||
}
|
||||
let picked = null;
|
||||
try {
|
||||
picked = findQuery(controller.viewer)?.pick(position.x, position.y) ?? null;
|
||||
@@ -297,15 +308,26 @@ export function routeSceneClick() {
|
||||
* held from its last record). Also rebuilds
|
||||
* the orbital Live Signals rows on their own clock.
|
||||
* @param {object} state The orbital session.
|
||||
* @param {{direction: object, up: object, right: object}} nadir This
|
||||
* frame's nadir frame.
|
||||
* @param {{x: number, y: number, z: number}} position The satellite, ECEF.
|
||||
* @param {{direction: object, up: object, right: object}} nadir The frame
|
||||
* the look turns about this frame: the nadir one, or a station view's.
|
||||
* @param {{x: number, y: number, z: number}} position Where the camera is,
|
||||
* ECEF: the satellite, or the station view's point on it.
|
||||
* @param {number} nowMs
|
||||
* @param {{direction: object, up: object, right: object}|null} [trueNadir]
|
||||
* The nadir frame when `nadir` is a station view's: the rows still word
|
||||
* their angles from straight down.
|
||||
* @returns {boolean} True when it placed `state.lookView` itself.
|
||||
*/
|
||||
export function updateOrbitalFocus(state, nadir, position, nowMs) {
|
||||
export function updateOrbitalFocus(
|
||||
state,
|
||||
nadir,
|
||||
position,
|
||||
nowMs,
|
||||
trueNadir = null,
|
||||
) {
|
||||
state.focusFrame = {
|
||||
nadir,
|
||||
trueNadir,
|
||||
position: { x: position.x, y: position.y, z: position.z },
|
||||
};
|
||||
// After a satellite switch the first frame on the new satellite (the hop
|
||||
@@ -459,13 +481,21 @@ export function orbitalSitesInReach(info) {
|
||||
});
|
||||
state.listedSites = remembered;
|
||||
const focusKey = state.focus?.key ?? null;
|
||||
const positions = new Map(candidates.map((c) => [c.key, c.position]));
|
||||
// Reach is measured about the frame the look turns in; the angle shown
|
||||
// is always from straight down, also from a station view.
|
||||
const shownOffNadir = (key, offNadirDeg) => {
|
||||
if (!frame.trueNadir) return offNadirDeg;
|
||||
const look = focusLook(frame.trueNadir, frame.position, positions.get(key));
|
||||
return Number.isFinite(look?.offNadirDeg) ? look.offNadirDeg : offNadirDeg;
|
||||
};
|
||||
return {
|
||||
entries: pointsInReach(candidates, {
|
||||
nadir: frame.nadir,
|
||||
satellite: frame.position,
|
||||
}).map(({ key, offNadirDeg }) => ({
|
||||
site: byId.get(key),
|
||||
offNadirDeg,
|
||||
offNadirDeg: shownOffNadir(key, offNadirDeg),
|
||||
focused: key === focusKey,
|
||||
})),
|
||||
};
|
||||
|
||||
@@ -39,10 +39,34 @@ const FRAME_MS = 16;
|
||||
|
||||
/** Satellites the layer knows, by NORAD id: the ridden one and its neighbours. */
|
||||
const SATELLITES = Object.freeze({
|
||||
25544: { name: 'ISS (ZARYA)', lat: 30, lon: -97, alt: 420_000, cls: 'stations' },
|
||||
49260: { name: 'LANDSAT 9', lat: 31.5, lon: -95, alt: 705_000, cls: 'imaging' },
|
||||
40697: { name: 'SENTINEL-2A', lat: 26, lon: -99, alt: 786_000, cls: 'imaging' },
|
||||
99001: { name: 'DEB FRAGMENT', lat: 30.2, lon: -97.1, alt: 430_000, cls: 'debris' },
|
||||
25544: {
|
||||
name: 'ISS (ZARYA)',
|
||||
lat: 30,
|
||||
lon: -97,
|
||||
alt: 420_000,
|
||||
cls: 'stations',
|
||||
},
|
||||
49260: {
|
||||
name: 'LANDSAT 9',
|
||||
lat: 31.5,
|
||||
lon: -95,
|
||||
alt: 705_000,
|
||||
cls: 'imaging',
|
||||
},
|
||||
40697: {
|
||||
name: 'SENTINEL-2A',
|
||||
lat: 26,
|
||||
lon: -99,
|
||||
alt: 786_000,
|
||||
cls: 'imaging',
|
||||
},
|
||||
99001: {
|
||||
name: 'DEB FRAGMENT',
|
||||
lat: 30.2,
|
||||
lon: -97.1,
|
||||
alt: 430_000,
|
||||
cls: 'debris',
|
||||
},
|
||||
});
|
||||
|
||||
/** Mapped sites as the installations layer keeps them. */
|
||||
@@ -56,6 +80,8 @@ const SITES = Object.freeze({
|
||||
lon: -96.5,
|
||||
memberNames: ['North Field'],
|
||||
at: { x: 100, y: 100 },
|
||||
// Where the overlay paints its label box: nothing picks there.
|
||||
labelAt: { x: 140, y: 70 },
|
||||
},
|
||||
bravo: {
|
||||
id: 'osm:military:way/202',
|
||||
@@ -100,7 +126,11 @@ function installationsLayer() {
|
||||
withPosition(record) {
|
||||
return {
|
||||
...record,
|
||||
position: Cesium.Cartesian3.fromDegrees(record.longitude, record.latitude, 0),
|
||||
position: Cesium.Cartesian3.fromDegrees(
|
||||
record.longitude,
|
||||
record.latitude,
|
||||
0,
|
||||
),
|
||||
};
|
||||
},
|
||||
// As the layer's own: loaded installations within `rangeM` of
|
||||
@@ -117,7 +147,10 @@ function installationsLayer() {
|
||||
from,
|
||||
Cesium.Cartographic.fromDegrees(record.longitude, record.latitude),
|
||||
);
|
||||
return { ...layer.withPosition(record), distanceM: geodesic.surfaceDistance };
|
||||
return {
|
||||
...layer.withPosition(record),
|
||||
distanceM: geodesic.surfaceDistance,
|
||||
};
|
||||
})
|
||||
.filter((record) => record.distanceM <= rangeM)
|
||||
.sort((a, b) => a.distanceM - b.distanceM)
|
||||
@@ -133,6 +166,17 @@ function installationsLayer() {
|
||||
const id = hit?.meta?.installationId ?? null;
|
||||
return id ? layer.getById(id) : null;
|
||||
},
|
||||
// As the layer's: the label box the overlay paints, where no primitive
|
||||
// picks (the dot is left to the pick ids here).
|
||||
findAt(position) {
|
||||
const site = Object.values(SITES).find(
|
||||
(s) =>
|
||||
s.labelAt &&
|
||||
s.labelAt.x === position?.x &&
|
||||
s.labelAt.y === position?.y,
|
||||
);
|
||||
return site ? layer.getById(site.id) : null;
|
||||
},
|
||||
};
|
||||
return layer;
|
||||
}
|
||||
@@ -190,7 +234,11 @@ function satellitesLayer(viewer) {
|
||||
},
|
||||
// As the layer's: the nearest shown satellites, bounded, with the
|
||||
// asked-for ids and classes left out.
|
||||
getNearestPositions(center, maxCount = 8, { excludeIds = [], excludeClasses = [] } = {}) {
|
||||
getNearestPositions(
|
||||
center,
|
||||
maxCount = 8,
|
||||
{ excludeIds = [], excludeClasses = [] } = {},
|
||||
) {
|
||||
layer.calls.push(['nearest']);
|
||||
const skip = new Set(excludeIds.map(String));
|
||||
return layer
|
||||
@@ -214,7 +262,9 @@ function satellitesLayer(viewer) {
|
||||
if (!positions.has(id)) return false;
|
||||
layer.calls.push(['track', id]);
|
||||
layer.tracked = id;
|
||||
followEntity(viewer, { position: { getValue: () => layer.position(id) } });
|
||||
followEntity(viewer, {
|
||||
position: { getValue: () => layer.position(id) },
|
||||
});
|
||||
return true;
|
||||
},
|
||||
setCockpitSubject(noradId) {
|
||||
@@ -234,7 +284,11 @@ function fixture(t, { reducedMotion = false } = {}) {
|
||||
const host = document.body.appendChild(document.createElement('div'));
|
||||
const pinia = createPinia();
|
||||
const app = createApp(
|
||||
defineComponent(() => () => [h(ContextView), h(IntelHudView), h(CockpitView)]),
|
||||
defineComponent(() => () => [
|
||||
h(ContextView),
|
||||
h(IntelHudView),
|
||||
h(CockpitView),
|
||||
]),
|
||||
).use(pinia);
|
||||
app.mount(host);
|
||||
useHudStore(pinia);
|
||||
@@ -276,7 +330,10 @@ function fixture(t, { reducedMotion = false } = {}) {
|
||||
handler.stockDouble = ({ position }) => {
|
||||
handler.stockDoubleClicks += 1;
|
||||
const picked = picks.get(`${position.x},${position.y}`);
|
||||
followEntity(viewer, picked ? { position: { getValue: () => null } } : null);
|
||||
followEntity(
|
||||
viewer,
|
||||
picked ? { position: { getValue: () => null } } : null,
|
||||
);
|
||||
};
|
||||
// The viewer's stock handler holds them, so the scene's input has them to
|
||||
// hold off.
|
||||
@@ -374,7 +431,11 @@ function fixture(t, { reducedMotion = false } = {}) {
|
||||
globalThis.matchMedia = previousMatchMedia;
|
||||
performance.now = originalNow;
|
||||
Date.now = originalDateNow;
|
||||
document.body.classList.remove('cockpit-mode', 'cockpit-bridge', 'cockpit-orbit');
|
||||
document.body.classList.remove(
|
||||
'cockpit-mode',
|
||||
'cockpit-bridge',
|
||||
'cockpit-orbit',
|
||||
);
|
||||
});
|
||||
|
||||
const frame = () => {
|
||||
@@ -454,7 +515,10 @@ function missDeg(shot, key) {
|
||||
|
||||
/** The camera's angle from nadir, degrees. */
|
||||
function offNadir(shot) {
|
||||
const toCentre = Cesium.Cartesian3.negate(shot.destination, new Cesium.Cartesian3());
|
||||
const toCentre = Cesium.Cartesian3.negate(
|
||||
shot.destination,
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
return angleDeg(shot.direction, toCentre);
|
||||
}
|
||||
|
||||
@@ -465,7 +529,10 @@ function siteOffNadir(shot, key) {
|
||||
shot.destination,
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
const toCentre = Cesium.Cartesian3.negate(shot.destination, new Cesium.Cartesian3());
|
||||
const toCentre = Cesium.Cartesian3.negate(
|
||||
shot.destination,
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
return angleDeg(line, toCentre);
|
||||
}
|
||||
|
||||
@@ -520,7 +587,9 @@ test('in orbit Live Signals lists the sites getNearby finds and the nearest sate
|
||||
assert.ok(shown.length <= 5, 'five rows at most');
|
||||
assert.equal(shown[0].title, 'TRACK ACQUIRED', 'the track row stays first');
|
||||
// Two site rows, nearest to nadir first, then the satellites (debris out).
|
||||
const sitesShown = shown.filter((row) => row.target?.layerId === 'military-installations');
|
||||
const sitesShown = shown.filter(
|
||||
(row) => row.target?.layerId === 'military-installations',
|
||||
);
|
||||
assert.deepEqual(
|
||||
sitesShown.map((row) => row.target.id).sort(),
|
||||
[SITES.alpha.id, SITES.bravo.id].sort(),
|
||||
@@ -529,16 +598,33 @@ test('in orbit Live Signals lists the sites getNearby finds and the nearest sate
|
||||
assert.match(row.detail, /^(BASE|AIRFIELD) · OFF-NADIR \d+\.\d°$/);
|
||||
assert.match(row.className, /nearby actionable/);
|
||||
}
|
||||
const satellitesShown = shown.filter((row) => row.target?.layerId === 'satellites');
|
||||
assert.deepEqual(satellitesShown.map((row) => row.title), ['LANDSAT 9', 'SENTINEL-2A']);
|
||||
assert.match(satellitesShown[0].detail, /^SATELLITE · (AHEAD|[LR] \d{3}°) · [\d,.]+\s+KM$/);
|
||||
const satellitesShown = shown.filter(
|
||||
(row) => row.target?.layerId === 'satellites',
|
||||
);
|
||||
assert.deepEqual(
|
||||
satellitesShown.map((row) => row.title),
|
||||
['LANDSAT 9', 'SENTINEL-2A'],
|
||||
);
|
||||
assert.match(
|
||||
satellitesShown[0].detail,
|
||||
/^SATELLITE · (AHEAD|[LR] \d{3}°) · [\d,.]+\s+KM$/,
|
||||
);
|
||||
// Each row names its own action.
|
||||
assert.equal(siteRow(scene, 'alpha').getAttribute('aria-label'), 'Keep the camera on Camp Alpha');
|
||||
assert.equal(satelliteRow(scene, 49260).getAttribute('aria-label'), 'Ride LANDSAT 9');
|
||||
assert.equal(
|
||||
siteRow(scene, 'alpha').getAttribute('aria-label'),
|
||||
'Keep the camera on Camp Alpha',
|
||||
);
|
||||
assert.equal(
|
||||
satelliteRow(scene, 49260).getAttribute('aria-label'),
|
||||
'Ride LANDSAT 9',
|
||||
);
|
||||
// Rebuilt on the clock, rows keep their keys and times.
|
||||
const before = shown.map((row) => [row.key, row.time]);
|
||||
await refreshRows(scene);
|
||||
assert.deepEqual(rows(scene).map((row) => [row.key, row.time]), before);
|
||||
assert.deepEqual(
|
||||
rows(scene).map((row) => [row.key, row.time]),
|
||||
before,
|
||||
);
|
||||
});
|
||||
|
||||
test('a site row turns the camera onto it, holds it, and reads its off-nadir angle', async (t) => {
|
||||
@@ -550,11 +636,17 @@ test('a site row turns the camera onto it, holds it, and reads its off-nadir ang
|
||||
// The first frames turn part of the way: no jump onto the site.
|
||||
assert.ok(missDeg(scene.frame(), 'alpha') > 5, 'still turning');
|
||||
const largest = run(scene, LAND_FRAMES);
|
||||
assert.ok(largest > 0.1 && largest < MAX_TURN_PER_FRAME_DEG, `turned ${largest}° in a frame`);
|
||||
assert.ok(
|
||||
largest > 0.1 && largest < MAX_TURN_PER_FRAME_DEG,
|
||||
`turned ${largest}° in a frame`,
|
||||
);
|
||||
for (let i = 0; i < 20; i += 1) {
|
||||
scene.satellites.move(0.002, 0.002);
|
||||
const shot = scene.frame();
|
||||
assert.ok(missDeg(shot, 'alpha') < 1e-5, `frame ${i}: ${missDeg(shot, 'alpha')}°`);
|
||||
assert.ok(
|
||||
missDeg(shot, 'alpha') < 1e-5,
|
||||
`frame ${i}: ${missDeg(shot, 'alpha')}°`,
|
||||
);
|
||||
}
|
||||
for (let i = 0; i < 8; i += 1) scene.frame();
|
||||
await settle();
|
||||
@@ -564,14 +656,20 @@ test('a site row turns the camera onto it, holds it, and reads its off-nadir ang
|
||||
`OFF-NADIR ${siteOffNadir(shot, 'alpha').toFixed(1)}°`,
|
||||
);
|
||||
assert.equal($('#cockpit-orbital-focus').textContent, 'FOCUS · Camp Alpha');
|
||||
assert.equal($('#cockpit-orbital-look-readout').getAttribute('aria-live'), 'off');
|
||||
assert.equal(
|
||||
$('#cockpit-orbital-look-readout').getAttribute('aria-live'),
|
||||
'off',
|
||||
);
|
||||
assert.equal(store.orbital.footprintKm, null);
|
||||
assert.match($('.cockpit-orbital-swath').textContent, /^SWATH ≈ [\d.]+ KM$/);
|
||||
// The held site's row reads as the subject does, first among the sites.
|
||||
const held = rows(scene).find((row) => row.target?.id === SITES.alpha.id);
|
||||
assert.match(held.className, /^track actionable$/);
|
||||
assert.match(held.detail, /^FOCUS · BASE · OFF-NADIR/);
|
||||
assert.equal(siteRow(scene, 'alpha').getAttribute('aria-label'), 'Release the camera from Camp Alpha');
|
||||
assert.equal(
|
||||
siteRow(scene, 'alpha').getAttribute('aria-label'),
|
||||
'Release the camera from Camp Alpha',
|
||||
);
|
||||
});
|
||||
|
||||
test('another site row switches the focus; the held site row ends it', async (t) => {
|
||||
@@ -586,7 +684,10 @@ test('another site row switches the focus; the held site row ends it', async (t)
|
||||
assert.ok(largest < MAX_TURN_PER_FRAME_DEG, `turned ${largest}° in a frame`);
|
||||
assert.ok(missDeg(scene.shots.at(-1), 'bravo') < 1e-5);
|
||||
await settle();
|
||||
assert.match(rows(scene).find((row) => row.target?.id === SITES.alpha.id).className, /^nearby/);
|
||||
assert.match(
|
||||
rows(scene).find((row) => row.target?.id === SITES.alpha.id).className,
|
||||
/^nearby/,
|
||||
);
|
||||
siteRow(scene, 'bravo').click();
|
||||
assert.equal(cockpit.orbital.focus, null);
|
||||
const back = run(scene, LAND_FRAMES, { drift: 0 });
|
||||
@@ -603,7 +704,11 @@ test('a click on a site marker focuses it through the layer; a click elsewhere e
|
||||
run(scene, LAND_FRAMES);
|
||||
assert.ok(missDeg(scene.shots.at(-1), 'alpha') < 1e-5);
|
||||
scene.click(SITES.alpha.at);
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.alpha.id, 'kept on a second click');
|
||||
assert.equal(
|
||||
cockpit.orbital.focus.key,
|
||||
SITES.alpha.id,
|
||||
'kept on a second click',
|
||||
);
|
||||
const focused = offNadir(scene.shots.at(-1));
|
||||
scene.click(EMPTY_GROUND);
|
||||
assert.equal(cockpit.orbital.focus, null);
|
||||
@@ -626,13 +731,21 @@ test('a click a tool owns is left alone', async (t) => {
|
||||
const lease = claimPointer('draw');
|
||||
t.after(() => releasePointer(lease));
|
||||
scene.click(SITES.alpha.at);
|
||||
assert.equal(scene.cockpit.orbital.focus ?? null, null, 'no focus while drawing');
|
||||
assert.equal(
|
||||
scene.cockpit.orbital.focus ?? null,
|
||||
null,
|
||||
'no focus while drawing',
|
||||
);
|
||||
releasePointer(lease);
|
||||
scene.click(SITES.alpha.at);
|
||||
const again = claimPointer('draw');
|
||||
t.after(() => releasePointer(again));
|
||||
scene.click(EMPTY_GROUND);
|
||||
assert.equal(scene.cockpit.orbital.focus.key, SITES.alpha.id, 'kept while drawing');
|
||||
assert.equal(
|
||||
scene.cockpit.orbital.focus.key,
|
||||
SITES.alpha.id,
|
||||
'kept while drawing',
|
||||
);
|
||||
});
|
||||
|
||||
test('a double-click on a site focuses it and keeps the orbital view', async (t) => {
|
||||
@@ -647,7 +760,11 @@ test('a double-click on a site focuses it and keeps the orbital view', async (t)
|
||||
scene.doubleClick(SITES.bravo.at);
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.bravo.id);
|
||||
scene.doubleClick(SITES.far.at);
|
||||
assert.equal(handler.stockDoubleClicks, 0, 'beyond reach: not focused, not tracked');
|
||||
assert.equal(
|
||||
handler.stockDoubleClicks,
|
||||
0,
|
||||
'beyond reach: not focused, not tracked',
|
||||
);
|
||||
scene.frame();
|
||||
assert.equal(cockpit.active, true);
|
||||
scene.doubleClick(EMPTY_GROUND);
|
||||
@@ -689,8 +806,15 @@ test('turning the layer off ends the focus and says why; a reload around the sit
|
||||
assert.ok(status, 'a status row says why no site is listed');
|
||||
assert.equal(status.detail, 'ENABLE MAPPED INSTALLATIONS FOR SITE PINGS');
|
||||
assert.equal(status.className, 'warning');
|
||||
assert.ok(!rows(scene).some((row) => row.target?.layerId === 'military-installations'));
|
||||
assert.equal(rows(scene).filter((row) => row.target?.layerId === 'satellites').length, 2);
|
||||
assert.ok(
|
||||
!rows(scene).some(
|
||||
(row) => row.target?.layerId === 'military-installations',
|
||||
),
|
||||
);
|
||||
assert.equal(
|
||||
rows(scene).filter((row) => row.target?.layerId === 'satellites').length,
|
||||
2,
|
||||
);
|
||||
scene.sites.enabled = true;
|
||||
await refreshRows(scene);
|
||||
assert.ok(!rows(scene).some((row) => row.title === 'SITES STANDBY'));
|
||||
@@ -701,7 +825,11 @@ test('turning the layer off ends the focus and says why; a reload around the sit
|
||||
const loaded = scene.sites.records;
|
||||
scene.sites.records = loaded.filter((r) => r.id !== SITES.bravo.id);
|
||||
run(scene, 10);
|
||||
assert.equal(scene.cockpit.orbital.focus.key, SITES.bravo.id, 'kept through a reload');
|
||||
assert.equal(
|
||||
scene.cockpit.orbital.focus.key,
|
||||
SITES.bravo.id,
|
||||
'kept through a reload',
|
||||
);
|
||||
assert.ok(missDeg(scene.shots.at(-1), 'bravo') < 1e-5, 'still centred');
|
||||
scene.sites.records = loaded;
|
||||
// A row the list shows works even if the layer just dropped its site.
|
||||
@@ -714,7 +842,10 @@ test('turning the layer off ends the focus and says why; a reload around the sit
|
||||
test('a satellite row rides it, staying in orbit; RETURN goes back', async (t) => {
|
||||
const scene = await inOrbit(t);
|
||||
const { cockpit, satellites, viewer, modeEvents } = scene;
|
||||
assert.ok(!rows(scene).some((row) => row.title.startsWith('RETURN')), 'no history yet');
|
||||
assert.ok(
|
||||
!rows(scene).some((row) => row.title.startsWith('RETURN')),
|
||||
'no history yet',
|
||||
);
|
||||
siteRow(scene, 'alpha').click();
|
||||
run(scene, 5);
|
||||
const before = Cesium.Cartesian3.clone(scene.shots.at(-1).destination);
|
||||
@@ -724,21 +855,36 @@ test('a satellite row rides it, staying in orbit; RETURN goes back', async (t) =
|
||||
satelliteRow(scene, 49260).click();
|
||||
const newTrack = cockpit.signalItems.filter((item) => item.key === 'track');
|
||||
assert.equal(newTrack.length, 1);
|
||||
assert.ok(newTrack[0].timestamp > firstTrack.timestamp, 'the new ride’s own time');
|
||||
assert.deepEqual(satellites.calls.slice(-2), [['track', 49260], ['subject', 49260]]);
|
||||
assert.ok(
|
||||
newTrack[0].timestamp > firstTrack.timestamp,
|
||||
'the new ride’s own time',
|
||||
);
|
||||
assert.deepEqual(satellites.calls.slice(-2), [
|
||||
['track', 49260],
|
||||
['subject', 49260],
|
||||
]);
|
||||
assert.equal(followedOf(viewer), null, 'the Cockpit keeps the camera');
|
||||
assert.equal(cockpit.subjectId, 49260);
|
||||
assert.equal(cockpit.orbital.focus, null, 'the focus is reset');
|
||||
assert.equal(modeEvents.at(-1)?.active, true);
|
||||
await settle();
|
||||
const shown = rows(scene);
|
||||
assert.deepEqual([shown[0].title, shown[0].detail], ['TRACK ACQUIRED', 'LANDSAT 9 · NADIR VIEW']);
|
||||
assert.deepEqual(
|
||||
[shown[0].title, shown[0].detail],
|
||||
['TRACK ACQUIRED', 'LANDSAT 9 · NADIR VIEW'],
|
||||
);
|
||||
assert.equal(shown.filter((row) => row.title === 'TRACK ACQUIRED').length, 1);
|
||||
const back = shown.find((row) => row.title === 'RETURN · ISS (ZARYA)');
|
||||
assert.ok(back, 'a RETURN row while there is history');
|
||||
assert.equal(back.detail, 'PREVIOUS SATELLITE');
|
||||
assert.equal(satelliteRow(scene, 25544).getAttribute('aria-label'), 'Return to ISS (ZARYA)');
|
||||
assert.ok(!shown.some((row) => row.title === 'ISS (ZARYA)'), 'listed once, as RETURN');
|
||||
assert.equal(
|
||||
satelliteRow(scene, 25544).getAttribute('aria-label'),
|
||||
'Return to ISS (ZARYA)',
|
||||
);
|
||||
assert.ok(
|
||||
!shown.some((row) => row.title === 'ISS (ZARYA)'),
|
||||
'listed once, as RETURN',
|
||||
);
|
||||
|
||||
// The camera hops along the way, never in one jump.
|
||||
const target = satellites.position(49260);
|
||||
@@ -748,11 +894,20 @@ test('a satellite row rides it, staying in orbit; RETURN goes back', async (t) =
|
||||
for (let i = 0; i < Math.ceil(ORBITAL_HOP_MS / FRAME_MS) + 2; i += 1) {
|
||||
const shot = scene.frame();
|
||||
assert.equal(cockpit.active, true, `still in orbit at frame ${i}`);
|
||||
largestStep = Math.max(largestStep, Cesium.Cartesian3.distance(previous, shot.destination));
|
||||
largestStep = Math.max(
|
||||
largestStep,
|
||||
Cesium.Cartesian3.distance(previous, shot.destination),
|
||||
);
|
||||
previous = shot.destination;
|
||||
}
|
||||
assert.ok(largestStep < hopM * 0.1, `largest step ${largestStep} m of ${hopM} m`);
|
||||
assert.ok(Cesium.Cartesian3.distance(previous, target) < 1, 'landed on the satellite');
|
||||
assert.ok(
|
||||
largestStep < hopM * 0.1,
|
||||
`largest step ${largestStep} m of ${hopM} m`,
|
||||
);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.distance(previous, target) < 1,
|
||||
'landed on the satellite',
|
||||
);
|
||||
run(scene, LAND_FRAMES, { drift: 0 });
|
||||
assert.ok(offNadir(scene.shots.at(-1)) < 1e-6, 'looking at nadir');
|
||||
|
||||
@@ -768,10 +923,16 @@ test('a satellite row rides it, staying in orbit; RETURN goes back', async (t) =
|
||||
satelliteRow(scene, 25544).click();
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
await settle();
|
||||
assert.ok(!rows(scene).some((row) => row.title.startsWith('RETURN')), 'back at the start');
|
||||
assert.ok(
|
||||
!rows(scene).some((row) => row.title.startsWith('RETURN')),
|
||||
'back at the start',
|
||||
);
|
||||
scene.frame();
|
||||
assert.equal(cockpit.active, true);
|
||||
assert.ok(!satellites.calls.some(([, id]) => id === 99001), 'debris never offered');
|
||||
assert.ok(
|
||||
!satellites.calls.some(([, id]) => id === 99001),
|
||||
'debris never offered',
|
||||
);
|
||||
});
|
||||
|
||||
test('while the camera hops, no stale rows; on landing, rows measured from the new satellite', async (t) => {
|
||||
@@ -790,15 +951,32 @@ test('while the camera hops, no stale rows; on landing, rows measured from the n
|
||||
scene.refreshCard();
|
||||
await settle();
|
||||
assert.ok(cockpit.orbital.hop, 'still hopping');
|
||||
assert.deepEqual(rows(scene).map((row) => row.title), ['TRACK ACQUIRED', 'RETURN · ISS (ZARYA)']);
|
||||
assert.deepEqual(
|
||||
rows(scene).map((row) => row.title),
|
||||
['TRACK ACQUIRED', 'RETURN · ISS (ZARYA)'],
|
||||
);
|
||||
// Landed: the first frame on the satellite rebuilds them at once.
|
||||
for (let i = 0; i < Math.ceil(ORBITAL_HOP_MS / FRAME_MS) + 2; i += 1) scene.frame();
|
||||
for (let i = 0; i < Math.ceil(ORBITAL_HOP_MS / FRAME_MS) + 2; i += 1)
|
||||
scene.frame();
|
||||
await settle();
|
||||
shown = rows(scene);
|
||||
assert.ok(shown.some((row) => row.target?.layerId === 'military-installations'), 'sites back');
|
||||
const satellitesShown = shown.filter((row) => row.title !== 'TRACK ACQUIRED' && row.target?.layerId === 'satellites');
|
||||
assert.ok(!satellitesShown.some((row) => row.title === 'LANDSAT 9'), 'never the ridden one');
|
||||
assert.equal(satellitesShown.filter((row) => row.target.id === '25544').length, 1, 'ISS only as RETURN');
|
||||
assert.ok(
|
||||
shown.some((row) => row.target?.layerId === 'military-installations'),
|
||||
'sites back',
|
||||
);
|
||||
const satellitesShown = shown.filter(
|
||||
(row) =>
|
||||
row.title !== 'TRACK ACQUIRED' && row.target?.layerId === 'satellites',
|
||||
);
|
||||
assert.ok(
|
||||
!satellitesShown.some((row) => row.title === 'LANDSAT 9'),
|
||||
'never the ridden one',
|
||||
);
|
||||
assert.equal(
|
||||
satellitesShown.filter((row) => row.target.id === '25544').length,
|
||||
1,
|
||||
'ISS only as RETURN',
|
||||
);
|
||||
});
|
||||
|
||||
test('RETURN to a satellite that left the catalogue offers the one before it', async (t) => {
|
||||
@@ -815,7 +993,10 @@ test('RETURN to a satellite that left the catalogue offers the one before it', a
|
||||
satelliteRow(scene, 49260).click();
|
||||
assert.equal(cockpit.subjectId, 40697, 'still on the same satellite');
|
||||
await settle();
|
||||
assert.ok(rows(scene).some((row) => row.title === 'RETURN · ISS (ZARYA)'), 'the one before');
|
||||
assert.ok(
|
||||
rows(scene).some((row) => row.title === 'RETURN · ISS (ZARYA)'),
|
||||
'the one before',
|
||||
);
|
||||
satelliteRow(scene, 25544).click();
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
});
|
||||
@@ -827,7 +1008,11 @@ test('with Installations off no site is offered, by row, list or click', async (
|
||||
sites.enabled = false;
|
||||
await refreshRows(scene);
|
||||
assert.ok(rows(scene).some((row) => row.title === 'SITES STANDBY'));
|
||||
assert.equal(cockpit.orbital.listedSites.size, 0, 'nothing kept to focus from');
|
||||
assert.equal(
|
||||
cockpit.orbital.listedSites.size,
|
||||
0,
|
||||
'nothing kept to focus from',
|
||||
);
|
||||
assert.equal(cockpit.toggleOrbitalFocus(SITES.alpha.id), false);
|
||||
scene.click(SITES.alpha.at);
|
||||
assert.equal(cockpit.orbital.focus ?? null, null);
|
||||
@@ -842,7 +1027,10 @@ test('an arrow during the ease back from a focus turns on the arrows’ clock',
|
||||
scene.frame();
|
||||
assert.equal(cockpit.orbital.focusReleasing, true);
|
||||
const view = { ...cockpit.orbital.lookView };
|
||||
assert.ok(Math.abs(view.pitchDeg) > 1 || Math.abs(view.yawDeg) > 1, 'still turned');
|
||||
assert.ok(
|
||||
Math.abs(view.pitchDeg) > 1 || Math.abs(view.yawDeg) > 1,
|
||||
'still turned',
|
||||
);
|
||||
cockpit.onKeyDown({
|
||||
key: 'ArrowUp',
|
||||
target: document.body,
|
||||
@@ -855,7 +1043,10 @@ test('an arrow during the ease back from a focus turns on the arrows’ clock',
|
||||
Math.abs(cockpit.orbital.lookTarget.yawDeg - view.yawDeg) < 1e-6,
|
||||
'across kept',
|
||||
);
|
||||
assert.ok(cockpit.orbital.lookTarget.pitchDeg > view.pitchDeg, 'tilted on up');
|
||||
assert.ok(
|
||||
cockpit.orbital.lookTarget.pitchDeg > view.pitchDeg,
|
||||
'tilted on up',
|
||||
);
|
||||
});
|
||||
|
||||
test('leaving orbit leaves no orbital rows to act on', async (t) => {
|
||||
@@ -870,7 +1061,10 @@ test('leaving orbit leaves no orbital rows to act on', async (t) => {
|
||||
assert.equal(scene.cockpit.toggleOrbitalFocus(SITES.bravo.id), false);
|
||||
assert.equal(scene.cockpit.onOrbitalClick(SITES.bravo.at), false);
|
||||
assert.equal(scene.cockpit.rideOrbitalSatellite(49260), false);
|
||||
assert.equal(scene.cockpit.handleOrbitalSignalClick('satellites', '49260'), false);
|
||||
assert.equal(
|
||||
scene.cockpit.handleOrbitalSignalClick('satellites', '49260'),
|
||||
false,
|
||||
);
|
||||
});
|
||||
|
||||
test('NADIR and Home end a focus; an arrow takes the view over where it is', async (t) => {
|
||||
@@ -913,7 +1107,12 @@ test('reduced motion cuts onto the site, back, and between satellites', async (t
|
||||
assert.ok(offNadir(scene.frame()) < 1e-6, 'back at once');
|
||||
satelliteRow(scene, 49260).click();
|
||||
const shot = scene.frame();
|
||||
assert.ok(Cesium.Cartesian3.distance(shot.destination, scene.satellites.position(49260)) < 1);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.distance(
|
||||
shot.destination,
|
||||
scene.satellites.position(49260),
|
||||
) < 1,
|
||||
);
|
||||
});
|
||||
|
||||
test('stopping the Cockpit leaves both clicks to the renderer', async (t) => {
|
||||
@@ -944,11 +1143,21 @@ test('the focused site keeps its row after nearer sites push it down', async (t)
|
||||
sources: [],
|
||||
});
|
||||
await refreshRows(scene);
|
||||
const sitesShown = rows(scene).filter((row) => row.target?.layerId === 'military-installations');
|
||||
const sitesShown = rows(scene).filter(
|
||||
(row) => row.target?.layerId === 'military-installations',
|
||||
);
|
||||
assert.equal(sitesShown.length, 2);
|
||||
assert.equal(sitesShown[0].target.id, SITES.alpha.id, 'the focused site is kept, first');
|
||||
assert.equal(
|
||||
sitesShown[0].target.id,
|
||||
SITES.alpha.id,
|
||||
'the focused site is kept, first',
|
||||
);
|
||||
siteRow(scene, 'alpha').click();
|
||||
assert.equal(scene.cockpit.orbital.focus, null, 'its row still ends the focus');
|
||||
assert.equal(
|
||||
scene.cockpit.orbital.focus,
|
||||
null,
|
||||
'its row still ends the focus',
|
||||
);
|
||||
});
|
||||
|
||||
test('a site the layer drops in a reload keeps its row, and its row still focuses it', async (t) => {
|
||||
@@ -959,13 +1168,24 @@ test('a site the layer drops in a reload keeps its row, and its row still focuse
|
||||
// The thinned view reloads without Camp Alpha for a moment.
|
||||
scene.sites.records = loaded.filter((r) => r.id !== SITES.alpha.id);
|
||||
await refreshRows(scene);
|
||||
assert.deepEqual(rows(scene).map((row) => row.key), before, 'the rows hold still');
|
||||
assert.deepEqual(
|
||||
rows(scene).map((row) => row.key),
|
||||
before,
|
||||
'the rows hold still',
|
||||
);
|
||||
siteRow(scene, 'alpha').click();
|
||||
assert.equal(scene.cockpit.orbital.focus?.key, SITES.alpha.id, 'focused from its row');
|
||||
assert.equal(
|
||||
scene.cockpit.orbital.focus?.key,
|
||||
SITES.alpha.id,
|
||||
'focused from its row',
|
||||
);
|
||||
siteRow(scene, 'alpha').click();
|
||||
// Gone for good: after a while it leaves the rows.
|
||||
for (let i = 0; i < 12; i += 1) await refreshRows(scene);
|
||||
assert.ok(!rows(scene).some((row) => row.target?.id === SITES.alpha.id), 'forgotten later');
|
||||
assert.ok(
|
||||
!rows(scene).some((row) => row.target?.id === SITES.alpha.id),
|
||||
'forgotten later',
|
||||
);
|
||||
});
|
||||
|
||||
test('shown rows keep their places while they still qualify', async (t) => {
|
||||
@@ -990,12 +1210,165 @@ test('shown rows keep their places while they still qualify', async (t) => {
|
||||
const sitesAfter = rows(scene)
|
||||
.filter((row) => row.target?.layerId === 'military-installations')
|
||||
.map((row) => row.target.id);
|
||||
assert.deepEqual(sitesAfter, sitesBefore, 'no row moves while its site is in reach');
|
||||
assert.deepEqual(
|
||||
sitesAfter,
|
||||
sitesBefore,
|
||||
'no row moves while its site is in reach',
|
||||
);
|
||||
// Once a shown site leaves the list, the nearer one takes its slot.
|
||||
scene.sites.records = scene.sites.records.filter((r) => r.id !== SITES.bravo.id);
|
||||
scene.sites.records = scene.sites.records.filter(
|
||||
(r) => r.id !== SITES.bravo.id,
|
||||
);
|
||||
for (let i = 0; i < 12; i += 1) await refreshRows(scene);
|
||||
assert.ok(
|
||||
rows(scene).some((row) => row.target?.id === 'osm:military:way/999'),
|
||||
'the nearer site fills the freed slot',
|
||||
);
|
||||
});
|
||||
|
||||
/**
|
||||
* A view from the station: its camera 20 m above the satellite, looking 65°
|
||||
* below level toward the north, as the satellites layer gives it. Camp Alpha,
|
||||
* about 120 km to the north-east of a satellite 420 km up, is some 74°
|
||||
* below level from it: within the view's reach.
|
||||
*/
|
||||
function stationMount(scene) {
|
||||
const position = scene.satellites.position(25544);
|
||||
const enu = Cesium.Transforms.eastNorthUpToFixedFrame(position);
|
||||
const axis = (x, y, z) =>
|
||||
Cesium.Cartesian3.normalize(
|
||||
Cesium.Matrix4.multiplyByPointAsVector(
|
||||
enu,
|
||||
new Cesium.Cartesian3(x, y, z),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
const down = (65 * Math.PI) / 180;
|
||||
const direction = axis(0, Math.cos(down), -Math.sin(down));
|
||||
const up = axis(0, Math.sin(down), Math.cos(down));
|
||||
return {
|
||||
position: Cesium.Cartesian3.add(
|
||||
position,
|
||||
Cesium.Cartesian3.multiplyByScalar(
|
||||
axis(0, 0, 1),
|
||||
20,
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
direction,
|
||||
up,
|
||||
right: Cesium.Cartesian3.cross(direction, up, new Cesium.Cartesian3()),
|
||||
key: 'zarya',
|
||||
label: 'ZARYA',
|
||||
noradId: 25544,
|
||||
card: null,
|
||||
views: [
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: 25544, card: null },
|
||||
{ key: 'cupola', label: 'CUPOLA', noradId: 25544, card: null },
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
test('from a station view, a site row turns the camera onto it from the view’s own point and holds it', async (t) => {
|
||||
const scene = await inOrbit(t);
|
||||
const { cockpit, satellites } = scene;
|
||||
satellites.getCockpitMount = () => stationMount(scene);
|
||||
scene.frame();
|
||||
await refreshRows(scene);
|
||||
const mount = stationMount(scene);
|
||||
// Camp Alpha lies below and to the north-east, within 45° of the view.
|
||||
assert.ok(missDeg(scene.shots.at(-1), 'alpha') > 5, 'not centred yet');
|
||||
siteRow(scene, 'alpha').click();
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.alpha.id);
|
||||
run(scene, LAND_FRAMES, { drift: 0 });
|
||||
for (let i = 0; i < 10; i += 1) {
|
||||
const shot = scene.frame();
|
||||
// From the view's camera point on the station, not the satellite's.
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.distance(
|
||||
shot.destination,
|
||||
stationMount(scene).position,
|
||||
) < 1e-6,
|
||||
);
|
||||
assert.ok(
|
||||
missDeg(shot, 'alpha') < 1e-4,
|
||||
`frame ${i}: ${missDeg(shot, 'alpha')}°`,
|
||||
);
|
||||
}
|
||||
// The same site from straight down would be off the view's direction.
|
||||
assert.ok(angleDeg(mount.direction, scene.shots.at(-1).direction) > 1);
|
||||
// Its row still words the angle from straight down, not from the view.
|
||||
await refreshRows(scene);
|
||||
const held = rows(scene).find((row) => row.target?.id === SITES.alpha.id);
|
||||
const fromNadir = siteOffNadir(scene.shots.at(-1), 'alpha');
|
||||
const shown = Number(/OFF-NADIR ([\d.]+)°/.exec(held.detail)[1]);
|
||||
assert.ok(Math.abs(shown - fromNadir) < 0.2, `${shown}° vs ${fromNadir}°`);
|
||||
|
||||
// Switching views ends the focus: the new view looks its own way.
|
||||
cockpit.nextOrbitalView();
|
||||
assert.ok(!cockpit.orbital.focus);
|
||||
});
|
||||
|
||||
test('from a station view, a site beyond 45° of where the view looks is not focused', async (t) => {
|
||||
const scene = await inOrbit(t);
|
||||
const { cockpit, satellites } = scene;
|
||||
// The view looks south; Camp Alpha is to the north-east, behind it.
|
||||
satellites.getCockpitMount = () => {
|
||||
const mount = stationMount(scene);
|
||||
const flip = (v) => Cesium.Cartesian3.negate(v, new Cesium.Cartesian3());
|
||||
const enu = Cesium.Transforms.eastNorthUpToFixedFrame(
|
||||
scene.satellites.position(25544),
|
||||
);
|
||||
const south = Cesium.Cartesian3.normalize(
|
||||
Cesium.Matrix4.multiplyByPointAsVector(
|
||||
enu,
|
||||
new Cesium.Cartesian3(0, -0.87, -0.5),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
const up = Cesium.Cartesian3.normalize(
|
||||
Cesium.Matrix4.multiplyByPointAsVector(
|
||||
enu,
|
||||
new Cesium.Cartesian3(0, -0.5, 0.87),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
return {
|
||||
...mount,
|
||||
direction: south,
|
||||
up,
|
||||
right: Cesium.Cartesian3.cross(south, up, new Cesium.Cartesian3()),
|
||||
unused: flip,
|
||||
};
|
||||
};
|
||||
scene.frame();
|
||||
await refreshRows(scene);
|
||||
const row = siteRow(scene, 'alpha');
|
||||
if (row) row.click();
|
||||
else cockpit.toggleOrbitalFocus?.(SITES.alpha.id);
|
||||
assert.ok(!cockpit.orbital.focus);
|
||||
});
|
||||
|
||||
test("a click on a site's label box focuses it, as one on its dot does", async (t) => {
|
||||
const scene = await inOrbit(t);
|
||||
const { cockpit, handler, sites } = scene;
|
||||
// No dot is drawn at the label's place: the layer's own lookup is what
|
||||
// finds the site there, through the label box the overlay paints.
|
||||
assert.equal(sites.findByPick(null), null, 'no draw item at the label');
|
||||
assert.equal(sites.findAt(SITES.alpha.labelAt)?.id, SITES.alpha.id);
|
||||
scene.click(SITES.alpha.labelAt);
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.alpha.id);
|
||||
assert.equal(handler.stockClicks, 1, 'Cesium still gets the click');
|
||||
run(scene, LAND_FRAMES);
|
||||
assert.ok(missDeg(scene.shots.at(-1), 'alpha') < 1e-5);
|
||||
// The label of the focused site again keeps it; another site's dot
|
||||
// switches.
|
||||
scene.click(SITES.alpha.labelAt);
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.alpha.id);
|
||||
scene.click(SITES.bravo.at);
|
||||
assert.equal(cockpit.orbital.focus.key, SITES.bravo.id);
|
||||
});
|
||||
@@ -159,7 +159,7 @@ export function switchOrbitalSatellite(noradId) {
|
||||
'track',
|
||||
'track',
|
||||
t('TRACK ACQUIRED'),
|
||||
t('{label} · NADIR VIEW', { label: info.name }),
|
||||
this.orbitalViewSignal(info),
|
||||
);
|
||||
this.updateOrbitalHud(info);
|
||||
this.refreshOrbitalSignals?.();
|
||||
|
||||
+165
-26
@@ -1,5 +1,6 @@
|
||||
/** The orbital (satellite) view of the Cockpit controller: camera, zoom, look and HUD. */
|
||||
import { isFollowing } from '../data/followed.js';
|
||||
import { clone } from '../geo/vector.js';
|
||||
import { cameraOf, canvasOf, findGlobe } from '../render/rendererOf.js';
|
||||
import { formatNumber, msg, t } from '../i18n/index.js';
|
||||
import {
|
||||
@@ -34,6 +35,10 @@ import {
|
||||
import { cockpitUiUpdateDue } from '../cockpitMath.js';
|
||||
import { createPlaceTracker, nearPlaceRadiusKm } from '../data/placeBelow.js';
|
||||
import { isPointerFree } from '../data/inputOwnership.js';
|
||||
import {
|
||||
issNextMountView,
|
||||
issPreviousMountView,
|
||||
} from '../layers/satellites/issMounts.js';
|
||||
import { zoomableSwathKm } from '../layers/satellites/sensors.js';
|
||||
import {
|
||||
easeOrbitalLook,
|
||||
@@ -41,7 +46,10 @@ import {
|
||||
releaseOrbitalFocus,
|
||||
updateOrbitalFocus,
|
||||
} from './cockpitOrbitalFocus.js';
|
||||
import { orbitalEyePosition } from './cockpitOrbitalSatellites.js';
|
||||
import {
|
||||
orbitalEyePosition,
|
||||
switchOrbitalSatellite,
|
||||
} from './cockpitOrbitalSatellites.js';
|
||||
import {
|
||||
COCKPIT_CONTEXT_UPDATE_MS,
|
||||
COCKPIT_HUD_UPDATE_MS,
|
||||
@@ -84,6 +92,15 @@ export function beginOrbital() {
|
||||
// A zoom step in flight: the magnification it started from and when.
|
||||
transition: null,
|
||||
previousUp: null,
|
||||
// The station's view shown (its key and name) and the views on offer;
|
||||
// null and none for any other satellite. The key is kept while the
|
||||
// model is away, so the same view comes back with it.
|
||||
mountKey: null,
|
||||
mount: null,
|
||||
mountViews: [],
|
||||
// A view of a module with no catalog entry (the Cupola) carries the
|
||||
// card shown in place of the entry it rides; null otherwise.
|
||||
mountCard: null,
|
||||
altitudeM: null,
|
||||
verticalFov: null,
|
||||
lastBriefMs: 0,
|
||||
@@ -270,8 +287,49 @@ export function updateOrbital(nowMs) {
|
||||
);
|
||||
if (!position) return;
|
||||
const state = this.orbital;
|
||||
// The station is ridden from a point on its 3D model, looking along it,
|
||||
// in place of the straight-down picture (the satellites layer says where).
|
||||
const mount =
|
||||
this.services.satellitesLayer?.getCockpitMount?.(state.mountKey) ?? null;
|
||||
if (mount?.key) state.mountKey = mount.key;
|
||||
state.mountViews = mount?.views ?? [];
|
||||
state.mountCard = mount?.card ?? null;
|
||||
// Each view belongs to an entry of its own (Nauka, the ISS, Poisk, the
|
||||
// docked vehicle). The Cockpit rides that entry, so the readout, the TLE
|
||||
// and the signals describe the module the view is from, not the one first
|
||||
// selected. The switch lands on the next frame; one that fails is not
|
||||
// retried until the view changes.
|
||||
if (
|
||||
mount?.noradId !== null &&
|
||||
mount?.noradId !== undefined &&
|
||||
String(mount.noradId) !== String(this.subjectId) &&
|
||||
state.mountSwitchFailed !== mount.key
|
||||
) {
|
||||
if (switchOrbitalSatellite.call(this, mount.noradId)) return;
|
||||
state.mountSwitchFailed = mount.key;
|
||||
}
|
||||
// The model can load after entry, and the picture then changes under the
|
||||
// TRACK ACQUIRED line that named it: say which it is now.
|
||||
const riding = mount !== null;
|
||||
const changed = state.riding !== undefined && state.riding !== riding;
|
||||
state.riding = riding;
|
||||
if (changed) {
|
||||
this.signalItems = (this.signalItems ?? []).filter(
|
||||
(item) => item.key !== 'track',
|
||||
);
|
||||
this.signalSignatures?.delete('track');
|
||||
this.pushCockpitSignal(
|
||||
'track',
|
||||
'track',
|
||||
t('TRACK ACQUIRED'),
|
||||
this.orbitalViewSignal(info),
|
||||
);
|
||||
}
|
||||
state.mount = mount ? mount.label || '' : null;
|
||||
// On the satellite, or on the way to it after Previous/Next.
|
||||
const eye = orbitalEyePosition(state, position, nowMs);
|
||||
const eye = mount
|
||||
? clone(mount.position)
|
||||
: orbitalEyePosition(state, position, nowMs);
|
||||
// Track-up: the ground track at the top, so the picture scrolls along it.
|
||||
// A geostationary satellite has no track and stays north-up.
|
||||
const nadir = nadirOrientation(eye, {
|
||||
@@ -291,15 +349,28 @@ export function updateOrbital(nowMs) {
|
||||
this.lastSubjectInfo = info;
|
||||
goToZoom.call(this, maxZoom);
|
||||
}
|
||||
// A ground focus aims the look itself (src/ui/cockpitOrbitalFocus.js).
|
||||
if (!updateOrbitalFocus.call(this, state, nadir, eye, nowMs))
|
||||
// A ground focus aims the look itself (src/ui/cockpitOrbitalFocus.js),
|
||||
// in the frame the arrows turn: from a station view, its own, from its
|
||||
// camera point on the station. The same ±45° reach holds about it.
|
||||
if (
|
||||
!updateOrbitalFocus.call(
|
||||
this,
|
||||
state,
|
||||
mount ?? nadir,
|
||||
eye,
|
||||
nowMs,
|
||||
mount ? nadir : null,
|
||||
)
|
||||
)
|
||||
state.lookView = easeOrbitalLook(
|
||||
state,
|
||||
nowMs - (state.lookLastMs || nowMs),
|
||||
{ immediate: prefersReducedMotion() },
|
||||
);
|
||||
state.lookLastMs = nowMs;
|
||||
const view = offNadirOrientation(nadir, {
|
||||
// The arrows tilt the view about its own frame: the nadir one, or the
|
||||
// mount's.
|
||||
const view = offNadirOrientation(mount ?? nadir, {
|
||||
northDeg: state.lookView.pitchDeg,
|
||||
eastDeg: state.lookView.yawDeg,
|
||||
});
|
||||
@@ -470,9 +541,19 @@ export function publishOrbitalView(info, transition = IDLE_TRANSITION) {
|
||||
northDeg: state.lookView?.pitchDeg ?? 0,
|
||||
eastDeg: state.lookView?.yawDeg ?? 0,
|
||||
});
|
||||
// Riding the station from a mount on its model: the view's name, and no
|
||||
// ground readings, which describe the nadir picture.
|
||||
const mount = state.mount ?? null;
|
||||
// A module with no catalog entry of its own shows its own card: its name,
|
||||
// what it is and a few facts, in place of the entry's identity and TLE.
|
||||
const card = mount !== null ? (state.mountCard ?? null) : null;
|
||||
this.publishOrbital({
|
||||
name: info.name,
|
||||
classLabel: info.classLabel || '',
|
||||
name: card ? card.name : info.name,
|
||||
mount,
|
||||
facts: card ? card.facts.map((fact) => t(fact)) : null,
|
||||
// How many views the station offers: the arrows show with two or more.
|
||||
mountViews: mount === null ? 0 : (state.mountViews?.length ?? 0),
|
||||
classLabel: card ? t(card.classLabel) : info.classLabel || '',
|
||||
altitudeM: info.altitudeM,
|
||||
velocityMps: Number.isFinite(info.velocityMps) ? info.velocityMps : null,
|
||||
latitude: info.latitude,
|
||||
@@ -480,12 +561,12 @@ export function publishOrbitalView(info, transition = IDLE_TRANSITION) {
|
||||
zoom: state.zoom,
|
||||
zoomSteps: ORBITAL_ZOOM_LADDER.filter((step) => step <= maxZoom),
|
||||
maxZoom,
|
||||
footprintKm: offset ? null : footprintKm,
|
||||
footprintKm: offset || mount !== null ? null : footprintKm,
|
||||
// The imaging sensor's swath, drawn to scale; null without one. The
|
||||
// SENSOR step's zoom is null when the swath lies outside 1x..maxZoom.
|
||||
// Looking past the limb there is no ground for it to cover: no sensor.
|
||||
sensor:
|
||||
swathKm === null || !seesEarth
|
||||
swathKm === null || !seesEarth || mount !== null
|
||||
? null
|
||||
: {
|
||||
label: info.sensor?.label ?? null,
|
||||
@@ -503,18 +584,22 @@ export function publishOrbitalView(info, transition = IDLE_TRANSITION) {
|
||||
transition: { ...transition },
|
||||
look: {
|
||||
offset,
|
||||
readout: focus
|
||||
? wordFocusOffNadir(focus)
|
||||
: offset
|
||||
? wordOffNadir(state.lookTarget, { trackUp })
|
||||
: '',
|
||||
// From a mount the tilt is about the mount's frame, not the nadir.
|
||||
readout:
|
||||
mount !== null
|
||||
? ''
|
||||
: focus
|
||||
? wordFocusOffNadir(focus)
|
||||
: offset
|
||||
? wordOffNadir(state.lookTarget, { trackUp })
|
||||
: '',
|
||||
// The mapped point the view is held on, or null.
|
||||
focus: focus ? { key: focus.key, label: focus.label } : null,
|
||||
// Off nadir, the ground width at the view's centre, approximated from
|
||||
// the nadir footprint (`offNadirSwathScale`); 1 and null at nadir.
|
||||
swathScale,
|
||||
swathKm:
|
||||
offset && seesEarth && Number.isFinite(footprintKm)
|
||||
mount === null && offset && seesEarth && Number.isFinite(footprintKm)
|
||||
? footprintKm * swathScale
|
||||
: null,
|
||||
},
|
||||
@@ -523,23 +608,45 @@ export function publishOrbitalView(info, transition = IDLE_TRANSITION) {
|
||||
trackUp,
|
||||
northDeg: trackUp ? (360 - info.groundTrackDeg) % 360 : 0,
|
||||
place: state.place,
|
||||
noradId: info.noradId ?? null,
|
||||
cosparId: info.cosparId ?? null,
|
||||
tle: info.tle ?? null,
|
||||
noradId: card ? null : (info.noradId ?? null),
|
||||
cosparId: card ? null : (info.cosparId ?? null),
|
||||
tle: card ? null : (info.tle ?? null),
|
||||
// Read on the HUD's cadence, so the age stays current without a timer.
|
||||
// The gap between the TLE's epoch and the time the satellite is shown
|
||||
// at (the world clock's), either side: SGP4 drifts both ways.
|
||||
tleAgeMs: Number.isFinite(info.tle?.epochMs)
|
||||
? Math.abs(
|
||||
(Number.isFinite(info.atMs) ? info.atMs : Date.now()) -
|
||||
info.tle.epochMs,
|
||||
)
|
||||
: null,
|
||||
owner: info.owner ?? null,
|
||||
operator: info.operator ?? null,
|
||||
tleAgeMs:
|
||||
!card && Number.isFinite(info.tle?.epochMs)
|
||||
? Math.abs(
|
||||
(Number.isFinite(info.atMs) ? info.atMs : Date.now()) -
|
||||
info.tle.epochMs,
|
||||
)
|
||||
: null,
|
||||
owner: card ? null : (info.owner ?? null),
|
||||
operator: card ? t(card.operator) : (info.operator ?? null),
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* The TRACK ACQUIRED line for a satellite subject: which picture it gets.
|
||||
* The station is ridden from a mount on its 3D model (once that is loaded);
|
||||
* every other satellite looks straight down.
|
||||
* @param {object} info Satellite subject.
|
||||
* @returns {string}
|
||||
*/
|
||||
export function orbitalViewSignal(info) {
|
||||
// A running session knows; on entry, before its first frame, the layer does.
|
||||
const riding =
|
||||
this.orbital?.riding ??
|
||||
Boolean(
|
||||
this.services.satellitesLayer?.getCockpitMount?.(
|
||||
this.orbital?.mountKey ?? null,
|
||||
),
|
||||
);
|
||||
return riding
|
||||
? t('{label} · STATION VIEW', { label: info.name })
|
||||
: t('{label} · NADIR VIEW', { label: info.name });
|
||||
}
|
||||
|
||||
/**
|
||||
* Present the orbital view on entry and after a language switch: the HUD,
|
||||
* the local page and a regional brief for the sub-satellite point.
|
||||
@@ -556,6 +663,38 @@ export function updateOrbitalHud(info, nowMs = performance.now()) {
|
||||
updateOrbitalContext.call(this, info, nowMs, true);
|
||||
}
|
||||
|
||||
/**
|
||||
* The station view's arrows: move to its next view (from Nauka, from Zarya,
|
||||
* from Poisk, from the Cupola, from Kibo, from a docked vehicle) or the one
|
||||
* before, wrapping round, looking the way that view looks.
|
||||
* @param {number} [direction] 1 for the next view, -1 for the one before.
|
||||
* @returns {boolean} True when the view changed.
|
||||
*/
|
||||
export function stepOrbitalMount(direction = 1) {
|
||||
if (!this.active || this.subjectKind !== 'satellite' || !this.orbital)
|
||||
return false;
|
||||
const state = this.orbital;
|
||||
const step = direction < 0 ? issPreviousMountView : issNextMountView;
|
||||
const next =
|
||||
state.mount === null ? null : step(state.mountViews, state.mountKey);
|
||||
if (!next) return false;
|
||||
state.mountKey = next.key;
|
||||
state.mount = next.label || '';
|
||||
state.mountCard = next.card ?? null;
|
||||
state.mountSwitchFailed = null;
|
||||
// A ground focus was aimed from the old view: it ends with it.
|
||||
if (state.focus) {
|
||||
state.focus = null;
|
||||
state.focusReleasing = false;
|
||||
this.refreshOrbitalSignals?.();
|
||||
}
|
||||
// Each view has its own way of looking: the look goes back to it.
|
||||
state.lookTarget = { ...NADIR_LOOK };
|
||||
state.lookView = { ...NADIR_LOOK };
|
||||
presentNow.call(this);
|
||||
return true;
|
||||
}
|
||||
|
||||
/** Re-apply the field of view and publish after a zoom or look change. */
|
||||
function presentNow() {
|
||||
const state = this.orbital;
|
||||
|
||||
@@ -1466,3 +1466,535 @@ test('back to nadir from past the limb, the sensor waits for the view', async (t
|
||||
await settle();
|
||||
assert.ok(store.orbital.sensor, 'back on the Earth');
|
||||
});
|
||||
|
||||
/** A mount on the station: 20 m from the satellite's position, looking along the track. */
|
||||
function stationMount() {
|
||||
const centre = satellitePosition();
|
||||
const enu = Cesium.Transforms.eastNorthUpToFixedFrame(centre);
|
||||
const axis = (x, y, z) =>
|
||||
Cesium.Matrix4.multiplyByPointAsVector(
|
||||
enu,
|
||||
new Cesium.Cartesian3(x, y, z),
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
const direction = axis(0, 1, 0);
|
||||
const up = axis(0, 0, 1);
|
||||
return {
|
||||
position: Cesium.Cartesian3.add(
|
||||
centre,
|
||||
Cesium.Cartesian3.multiplyByScalar(up, 20, new Cesium.Cartesian3()),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
direction,
|
||||
up,
|
||||
right: Cesium.Cartesian3.cross(direction, up, new Cesium.Cartesian3()),
|
||||
label: 'ZARYA',
|
||||
};
|
||||
}
|
||||
|
||||
test('the station is ridden from its mount: the camera sits there and looks along it', async (t) => {
|
||||
const { $, cockpit, satellites, shots, store, clock } = await orbitAt(t);
|
||||
const mount = stationMount();
|
||||
satellites.getCockpitMount = () => mount;
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
const shot = shots.at(-1);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.equalsEpsilon(shot.destination, mount.position, 1e-9),
|
||||
'the camera is at the mount, not at the satellite',
|
||||
);
|
||||
near(
|
||||
angleDeg(shot.direction, mount.direction),
|
||||
0,
|
||||
'looks along the mount',
|
||||
1e-9,
|
||||
);
|
||||
near(angleDeg(shot.up, mount.up), 0, 'the mount is upright', 1e-9);
|
||||
|
||||
// The HUD names the view and drops what describes the nadir picture.
|
||||
assert.equal(store.orbital.mount, 'ZARYA');
|
||||
assert.equal(store.orbital.footprintKm, null);
|
||||
assert.equal(store.orbital.sensor, null);
|
||||
assert.equal(
|
||||
$('.cockpit-orbital-kicker').textContent,
|
||||
'STATION VIEW · ZARYA',
|
||||
);
|
||||
assert.equal($('.cockpit-orbital-reticle'), null);
|
||||
assert.equal($('.cockpit-orbital-north'), null);
|
||||
assert.match($('.cockpit-help').textContent, /ARROWS LOOK/);
|
||||
assert.match($('.cockpit-help').textContent, /HOME RESET/);
|
||||
assert.doesNotMatch($('.cockpit-help').textContent, /NADIR/);
|
||||
|
||||
// The arrows turn the view about the mount's own frame, and Home returns.
|
||||
press(cockpit, 'ArrowRight');
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
const turned = shots.at(-1);
|
||||
near(angleDeg(turned.direction, mount.direction), 5, 'one step is 5°', 1e-6);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.dot(turned.direction, mount.right) > 0,
|
||||
'right turns toward the mount’s right',
|
||||
);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.equalsEpsilon(turned.destination, mount.position, 1e-9),
|
||||
);
|
||||
assert.equal($('#cockpit-orbital-nadir').textContent, 'RESET');
|
||||
assert.equal($('#cockpit-orbital-look-readout').textContent, '');
|
||||
press(cockpit, 'Home');
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
near(angleDeg(shots.at(-1).direction, mount.direction), 0, 'Home', 1e-9);
|
||||
});
|
||||
|
||||
test('without a mount the same satellite keeps the nadir picture, and gets it back', async (t) => {
|
||||
const { $, cockpit, satellites, shots, store, clock } = await orbitAt(t);
|
||||
const position = satellitePosition();
|
||||
const toCentre = Cesium.Cartesian3.negate(
|
||||
Cesium.Cartesian3.normalize(position, new Cesium.Cartesian3()),
|
||||
new Cesium.Cartesian3(),
|
||||
);
|
||||
const signals = [];
|
||||
cockpit.pushCockpitSignal = (key, kind, title, detail) =>
|
||||
signals.push(detail);
|
||||
// The model has not loaded yet: straight down, as for any satellite.
|
||||
satellites.getCockpitMount = () => null;
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
assert.deepEqual(signals, [], 'nothing changed: nothing to say');
|
||||
near(angleDeg(shots.at(-1).direction, toCentre), 0, 'nadir', 1e-9);
|
||||
assert.equal(store.orbital.mount, null);
|
||||
assert.equal(
|
||||
$('.cockpit-orbital-kicker').textContent,
|
||||
'ORBITAL VIEW · NADIR',
|
||||
);
|
||||
assert.ok($('.cockpit-orbital-reticle'));
|
||||
|
||||
// It loads: the view moves to the mount. It goes again: back to nadir.
|
||||
const mount = stationMount();
|
||||
satellites.getCockpitMount = () => mount;
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
assert.equal(store.orbital.mount, 'ZARYA');
|
||||
near(angleDeg(shots.at(-1).direction, mount.direction), 0, 'mount', 1e-9);
|
||||
// The TRACK ACQUIRED line follows the picture, once per change.
|
||||
cockpit.update();
|
||||
assert.deepEqual(signals, ['ISS (ZARYA) · STATION VIEW']);
|
||||
satellites.getCockpitMount = () => null;
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
assert.deepEqual(signals, [
|
||||
'ISS (ZARYA) · STATION VIEW',
|
||||
'ISS (ZARYA) · NADIR VIEW',
|
||||
]);
|
||||
assert.equal(store.orbital.mount, null);
|
||||
near(angleDeg(shots.at(-1).direction, toCentre), 0, 'nadir again', 1e-9);
|
||||
assert.ok(
|
||||
Cesium.Cartesian3.equalsEpsilon(shots.at(-1).destination, position, 1e-6),
|
||||
);
|
||||
});
|
||||
|
||||
/** The station's views as the satellites layer offers them, by key. */
|
||||
function stationViews({ docked = true } = {}) {
|
||||
const views = [
|
||||
{ key: 'nauka', label: 'NAUKA' },
|
||||
{ key: 'zarya', label: 'ZARYA' },
|
||||
...(docked ? [{ key: 'docked', label: 'PROGRESS-MS 34' }] : []),
|
||||
];
|
||||
const base = stationMount();
|
||||
// Each view sits a different distance above the satellite's position.
|
||||
const heights = { nauka: 10, zarya: 20, docked: 30 };
|
||||
const asked = [];
|
||||
return {
|
||||
asked,
|
||||
views,
|
||||
heightOf(shot) {
|
||||
return Math.round(
|
||||
Cesium.Cartesian3.distance(shot.destination, satellitePosition()),
|
||||
);
|
||||
},
|
||||
getCockpitMount(key) {
|
||||
asked.push(key);
|
||||
const view = views.find((entry) => entry.key === key) ?? views[0];
|
||||
return {
|
||||
...base,
|
||||
position: Cesium.Cartesian3.add(
|
||||
satellitePosition(),
|
||||
Cesium.Cartesian3.multiplyByScalar(
|
||||
base.up,
|
||||
heights[view.key],
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
new Cesium.Cartesian3(),
|
||||
),
|
||||
key: view.key,
|
||||
label: view.label,
|
||||
views,
|
||||
};
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
test('the station opens on its first view and the arrows step through the rest', async (t) => {
|
||||
const { $, cockpit, satellites, shots, store, clock } = await orbitAt(t);
|
||||
const station = stationViews();
|
||||
satellites.getCockpitMount = station.getCockpitMount;
|
||||
const frame = async () => {
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
await frame();
|
||||
// Nothing was chosen: the layer is asked for its first view, Nauka's,
|
||||
// though the entry ridden is ISS (ZARYA).
|
||||
assert.equal(station.asked[0], null);
|
||||
assert.equal(store.orbital.mount, 'NAUKA');
|
||||
assert.equal(store.orbital.mountViews, 3);
|
||||
assert.equal(station.heightOf(shots.at(-1)), 10);
|
||||
assert.equal(
|
||||
$('.cockpit-orbital-kicker').textContent,
|
||||
'STATION VIEW · NAUKA',
|
||||
);
|
||||
assert.equal(
|
||||
$('#cockpit-orbital-view-next').getAttribute('aria-label'),
|
||||
'Next station view',
|
||||
);
|
||||
assert.equal(
|
||||
$('#cockpit-orbital-view-previous').getAttribute('aria-label'),
|
||||
'Previous station view',
|
||||
);
|
||||
assert.equal($('#cockpit-orbital-view-name').textContent, 'NAUKA');
|
||||
|
||||
// A look off to one side is dropped by the step: each view looks its own way.
|
||||
press(cockpit, 'ArrowRight');
|
||||
await frame();
|
||||
assert.equal(store.orbital.look.offset, true);
|
||||
|
||||
// The button, as a click anywhere inside it.
|
||||
$('#cockpit-orbital-view-next').dispatchEvent(
|
||||
new Event('click', { bubbles: true }),
|
||||
);
|
||||
await settle();
|
||||
assert.equal(store.orbital.mount, 'ZARYA', 'named at once, before a frame');
|
||||
await frame();
|
||||
assert.equal(station.asked.at(-1), 'zarya');
|
||||
assert.equal(station.heightOf(shots.at(-1)), 20);
|
||||
assert.equal(store.orbital.look.offset, false);
|
||||
near(
|
||||
angleDeg(shots.at(-1).direction, stationMount().direction),
|
||||
0,
|
||||
'reset',
|
||||
1e-9,
|
||||
);
|
||||
assert.equal(
|
||||
$('.cockpit-orbital-kicker').textContent,
|
||||
'STATION VIEW · ZARYA',
|
||||
);
|
||||
|
||||
assert.equal(cockpit.nextOrbitalView(), true);
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'PROGRESS-MS 34');
|
||||
assert.equal(station.heightOf(shots.at(-1)), 30);
|
||||
// Round again to the first.
|
||||
assert.equal(cockpit.nextOrbitalView(), true);
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'NAUKA');
|
||||
assert.equal(station.heightOf(shots.at(-1)), 10);
|
||||
});
|
||||
|
||||
test('the chosen view is kept while the model is away, and one view has no arrows', async (t) => {
|
||||
const { $, cockpit, satellites, store, clock } = await orbitAt(t);
|
||||
const station = stationViews({ docked: false });
|
||||
satellites.getCockpitMount = station.getCockpitMount;
|
||||
// A second per frame: the HUD republishes on its own cadence.
|
||||
const frame = async () => {
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
await frame();
|
||||
assert.equal(store.orbital.mountViews, 2);
|
||||
cockpit.nextOrbitalView();
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'ZARYA');
|
||||
// The model goes: nadir, no control, nothing to step.
|
||||
satellites.getCockpitMount = () => null;
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, null);
|
||||
assert.equal(store.orbital.mountViews, 0);
|
||||
assert.equal($('#cockpit-orbital-view-next'), null);
|
||||
assert.equal($('#cockpit-orbital-view-previous'), null);
|
||||
assert.equal(cockpit.nextOrbitalView(), false);
|
||||
// It comes back: the same view is asked for again.
|
||||
satellites.getCockpitMount = station.getCockpitMount;
|
||||
await frame();
|
||||
assert.equal(station.asked.at(-1), 'zarya');
|
||||
assert.equal(store.orbital.mount, 'ZARYA');
|
||||
|
||||
// A station offering a single view shows no control.
|
||||
station.views.length = 1;
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'NAUKA', 'the view on offer');
|
||||
assert.equal(store.orbital.mountViews, 1);
|
||||
assert.equal($('#cockpit-orbital-view-next'), null);
|
||||
assert.equal($('#cockpit-orbital-view-previous'), null);
|
||||
assert.equal(cockpit.nextOrbitalView(), false);
|
||||
});
|
||||
|
||||
test('the view arrows do nothing outside a station view', async (t) => {
|
||||
const { cockpit, clock } = await orbitAt(t);
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
assert.equal(cockpit.nextOrbitalView(), false);
|
||||
assert.equal(cockpit.previousOrbitalView(), false);
|
||||
cockpit.exit();
|
||||
assert.equal(cockpit.nextOrbitalView(), false);
|
||||
assert.equal(cockpit.previousOrbitalView(), false);
|
||||
});
|
||||
|
||||
test('each station view rides its own entry, so the card describes that module', async (t) => {
|
||||
const { $, cockpit, satellites, store, clock } = await orbitAt(t);
|
||||
// The layer, as it behaves: tracking another entry makes it the subject.
|
||||
const names = {
|
||||
25544: 'ISS (ZARYA)',
|
||||
49044: 'ISS (NAUKA)',
|
||||
36086: 'POISK',
|
||||
68837: 'PROGRESS-MS 34',
|
||||
};
|
||||
let subject = { ...ISS, noradId: 68837, id: '68837', name: names[68837] };
|
||||
const tracked = [];
|
||||
satellites.getCockpitSubject = () => ({ ...subject });
|
||||
satellites.trackById = (noradId) => {
|
||||
tracked.push(Number(noradId));
|
||||
const id = Number(noradId);
|
||||
subject = { ...ISS, noradId: id, id: String(id), name: names[id] };
|
||||
return true;
|
||||
};
|
||||
cockpit.subjectId = 68837;
|
||||
const base = stationMount();
|
||||
const views = [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: 49044 },
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: 25544 },
|
||||
{ key: 'poisk', label: 'POISK', noradId: 36086 },
|
||||
{ key: 'docked', label: 'PROGRESS-MS 34', noradId: 68837 },
|
||||
];
|
||||
satellites.getCockpitMount = (key) => {
|
||||
const view = views.find((entry) => entry.key === key) ?? views[0];
|
||||
return { ...base, ...view, views };
|
||||
};
|
||||
const frame = async () => {
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
// Entered on the Progress; the view opens on Nauka and rides Nauka.
|
||||
await frame();
|
||||
await frame();
|
||||
assert.deepEqual(tracked, [49044]);
|
||||
assert.equal(cockpit.subjectId, 49044);
|
||||
assert.equal(store.orbital.name, 'ISS (NAUKA)');
|
||||
assert.equal($('.cockpit-orbital-name').textContent, 'ISS (NAUKA)');
|
||||
assert.equal(store.orbital.mount, 'NAUKA');
|
||||
|
||||
// Each step rides the next view's entry.
|
||||
for (const [noradId, name] of [
|
||||
[25544, 'ISS (ZARYA)'],
|
||||
[36086, 'POISK'],
|
||||
[68837, 'PROGRESS-MS 34'],
|
||||
[49044, 'ISS (NAUKA)'],
|
||||
]) {
|
||||
assert.equal(cockpit.nextOrbitalView(), true);
|
||||
await frame();
|
||||
await frame();
|
||||
assert.equal(cockpit.subjectId, noradId);
|
||||
assert.equal(store.orbital.name, name);
|
||||
assert.equal($('.cockpit-orbital-name').textContent, name);
|
||||
}
|
||||
assert.deepEqual(tracked, [49044, 25544, 36086, 68837, 49044]);
|
||||
});
|
||||
|
||||
test('a view with no entry, or one that cannot be ridden, keeps the subject', async (t) => {
|
||||
const { cockpit, satellites, store, clock } = await orbitAt(t);
|
||||
const base = stationMount();
|
||||
let views = [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: null },
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: 25544 },
|
||||
];
|
||||
satellites.getCockpitMount = (key) => {
|
||||
const view = views.find((entry) => entry.key === key) ?? views[0];
|
||||
return { ...base, ...view, views };
|
||||
};
|
||||
let asked = 0;
|
||||
satellites.trackById = () => {
|
||||
asked += 1;
|
||||
return false;
|
||||
};
|
||||
const frame = async () => {
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
// No entry for Nauka: the ISS stays the subject, and nothing is tracked.
|
||||
await frame();
|
||||
assert.equal(asked, 0);
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
assert.equal(store.orbital.mount, 'NAUKA');
|
||||
// An entry the layer will not track: asked once, not every frame.
|
||||
views = [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: 49044 },
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: 25544 },
|
||||
];
|
||||
await frame();
|
||||
await frame();
|
||||
await frame();
|
||||
assert.equal(asked, 1);
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
assert.equal(document.body.classList.contains('cockpit-orbit'), true);
|
||||
});
|
||||
|
||||
const CUPOLA_CARD = Object.freeze({
|
||||
name: 'CUPOLA',
|
||||
classLabel: 'OBSERVATION MODULE · ISS',
|
||||
operator: 'European Space Agency (ESA)',
|
||||
facts: ['7 WINDOWS', 'LAUNCHED 8 FEB 2010 · STS-130'],
|
||||
});
|
||||
|
||||
test('a view with a card of its own shows it in place of the entry’s identity', async (t) => {
|
||||
const { $, cockpit, satellites, store, clock } = await orbitAt(t);
|
||||
const base = stationMount();
|
||||
const views = [
|
||||
{ key: 'zarya', label: 'ZARYA', noradId: 25544, card: null },
|
||||
{ key: 'cupola', label: 'CUPOLA', noradId: 25544, card: CUPOLA_CARD },
|
||||
];
|
||||
satellites.getCockpitMount = (key) => {
|
||||
const view = views.find((entry) => entry.key === key) ?? views[0];
|
||||
return { ...base, ...view, views };
|
||||
};
|
||||
const frame = async () => {
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
await frame();
|
||||
assert.equal(store.orbital.name, 'ISS (ZARYA)');
|
||||
assert.equal(store.orbital.noradId, 25544);
|
||||
assert.equal(store.orbital.facts, null);
|
||||
|
||||
cockpit.nextOrbitalView();
|
||||
await frame();
|
||||
// Same entry ridden (nothing to switch), the Cupola's own card shown.
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
assert.equal(store.orbital.mount, 'CUPOLA');
|
||||
assert.equal(store.orbital.name, 'CUPOLA');
|
||||
assert.equal($('.cockpit-orbital-name').textContent, 'CUPOLA');
|
||||
assert.equal(store.orbital.classLabel, 'OBSERVATION MODULE · ISS');
|
||||
assert.equal(store.orbital.operator, 'European Space Agency (ESA)');
|
||||
assert.equal(store.orbital.noradId, null);
|
||||
assert.equal(store.orbital.tle, null);
|
||||
assert.equal(store.orbital.owner, null);
|
||||
assert.equal(
|
||||
$('.cockpit-orbital-ident-text').textContent,
|
||||
'7 WINDOWS · LAUNCHED 8 FEB 2010 · STS-130',
|
||||
);
|
||||
assert.equal($('#cockpit-orbital-tle-toggle'), null);
|
||||
// Altitude, velocity and the sub-satellite point are the station's still.
|
||||
assert.ok($('.cockpit-orbital-altitude').textContent.length > 0);
|
||||
|
||||
// Back round to Zarya: the entry's own card again.
|
||||
cockpit.nextOrbitalView();
|
||||
await frame();
|
||||
assert.equal(store.orbital.name, 'ISS (ZARYA)');
|
||||
assert.equal(store.orbital.noradId, 25544);
|
||||
assert.equal(store.orbital.facts, null);
|
||||
});
|
||||
|
||||
test('leaving a station view selects Nauka; leaving any other keeps the satellite', async (t) => {
|
||||
const { cockpit, satellites, clock } = await orbitAt(t);
|
||||
const names = { 25544: 'ISS (ZARYA)', 49044: 'ISS (NAUKA)' };
|
||||
let subject = { ...ISS };
|
||||
const tracked = [];
|
||||
satellites.getCockpitSubject = () => ({ ...subject });
|
||||
satellites.trackById = (noradId) => {
|
||||
const id = Number(noradId);
|
||||
tracked.push(id);
|
||||
subject = { ...ISS, noradId: id, id: String(id), name: names[id] };
|
||||
return true;
|
||||
};
|
||||
const base = stationMount();
|
||||
const views = [
|
||||
{ key: 'nauka', label: 'NAUKA', noradId: 49044, card: null },
|
||||
{ key: 'cupola', label: 'CUPOLA', noradId: 25544, card: CUPOLA_CARD },
|
||||
];
|
||||
satellites.getCockpitMount = (key) => {
|
||||
const view = views.find((entry) => entry.key === key) ?? views[0];
|
||||
return { ...base, ...view, views };
|
||||
};
|
||||
const frame = async () => {
|
||||
clock.advance(1000);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
await frame();
|
||||
await frame();
|
||||
// On the Cupola, riding the ISS's entry, when the Cockpit is left.
|
||||
cockpit.nextOrbitalView();
|
||||
await frame();
|
||||
await frame();
|
||||
assert.equal(cockpit.subjectId, 25544);
|
||||
satellites.calls.length = 0;
|
||||
tracked.length = 0;
|
||||
assert.equal(cockpit.exit(), true);
|
||||
assert.deepEqual(tracked, [49044], 'Nauka is selected');
|
||||
assert.deepEqual(satellites.calls, [
|
||||
['subject', null],
|
||||
['refocus', 49044],
|
||||
]);
|
||||
});
|
||||
|
||||
test('leaving the plain orbital view refocuses the satellite ridden', async (t) => {
|
||||
const { cockpit, satellites } = await orbitAt(t);
|
||||
const tracked = [];
|
||||
satellites.trackById = (noradId) => {
|
||||
tracked.push(noradId);
|
||||
return true;
|
||||
};
|
||||
satellites.calls.length = 0;
|
||||
assert.equal(cockpit.exit(), true);
|
||||
assert.deepEqual(tracked, []);
|
||||
assert.deepEqual(satellites.calls, [
|
||||
['subject', null],
|
||||
['refocus', 25544],
|
||||
]);
|
||||
});
|
||||
|
||||
test('the left arrow steps back through the views, wrapping round', async (t) => {
|
||||
const { $, cockpit, satellites, shots, store, clock } = await orbitAt(t);
|
||||
const station = stationViews();
|
||||
satellites.getCockpitMount = station.getCockpitMount;
|
||||
const frame = async () => {
|
||||
clock.advance(16);
|
||||
cockpit.update();
|
||||
await settle();
|
||||
};
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'NAUKA');
|
||||
// From the first view back to the last.
|
||||
$('#cockpit-orbital-view-previous').dispatchEvent(
|
||||
new Event('click', { bubbles: true }),
|
||||
);
|
||||
await settle();
|
||||
assert.equal(store.orbital.mount, 'PROGRESS-MS 34');
|
||||
await frame();
|
||||
// The camera is at the docked vehicle's view (30 m up in this stand-in).
|
||||
assert.equal(station.heightOf(shots.at(-1)), 30);
|
||||
assert.equal(cockpit.previousOrbitalView(), true);
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'ZARYA');
|
||||
assert.equal(cockpit.nextOrbitalView(), true);
|
||||
await frame();
|
||||
assert.equal(store.orbital.mount, 'PROGRESS-MS 34');
|
||||
});
|
||||
@@ -675,7 +675,7 @@ export function enter({ kind = null } = {}) {
|
||||
'track',
|
||||
'track',
|
||||
t('TRACK ACQUIRED'),
|
||||
t('{label} · NADIR VIEW', { label: info.name }),
|
||||
this.orbitalViewSignal(info),
|
||||
);
|
||||
} else if (vessel) {
|
||||
this.pushCockpitSignal(
|
||||
@@ -734,6 +734,14 @@ export function exit({ restoreTracking = true } = {}) {
|
||||
const vesselSubject = this.subjectKind === 'vessel' ? this.subjectId : null;
|
||||
const satelliteSubject =
|
||||
this.subjectKind === 'satellite' ? this.subjectId : null;
|
||||
// Leaving a view from the station selects Nauka, whichever view or entry
|
||||
// it ended on: the station's first view, and the one it opens on.
|
||||
const station = this.orbital;
|
||||
const stationHome =
|
||||
satelliteSubject !== null && station && station.mount != null
|
||||
? (station.mountViews?.find((view) => view.key === 'nauka')?.noradId ??
|
||||
null)
|
||||
: null;
|
||||
this.active = false;
|
||||
this.subjectKind = null;
|
||||
this.subjectProvider = null;
|
||||
@@ -805,8 +813,20 @@ export function exit({ restoreTracking = true } = {}) {
|
||||
// Back to the selected vessel's map view, through the layer's own focus.
|
||||
this.services.aisLiveVesselsLayer?.focusSelectedVessel?.();
|
||||
} else if (restoreTracking && satelliteSubject !== null) {
|
||||
// Back to the satellite's follow camera, through the layer's own refocus.
|
||||
this.services.satellitesLayer?.refocusTrackedById?.(satelliteSubject);
|
||||
// Back to the satellite's follow camera, through the layer's own refocus;
|
||||
// from the station, on Nauka.
|
||||
const layer = this.services.satellitesLayer;
|
||||
let subject = satelliteSubject;
|
||||
if (stationHome !== null && String(stationHome) !== String(subject)) {
|
||||
let tracked = false;
|
||||
try {
|
||||
tracked = Boolean(layer?.trackById?.(stationHome, { origin: 'user' }));
|
||||
} catch {
|
||||
tracked = false;
|
||||
}
|
||||
if (tracked) subject = stationHome;
|
||||
}
|
||||
layer?.refocusTrackedById?.(subject);
|
||||
}
|
||||
this.syncEntry();
|
||||
// Back to whichever entry was used: the Contacts button or the readout's.
|
||||
|
||||
@@ -0,0 +1,319 @@
|
||||
import {
|
||||
LIVE_STREAMS,
|
||||
liveStreamsFor,
|
||||
youtubeWatchUrl,
|
||||
} from '../data/liveStreams.js';
|
||||
import { createYouTubeLivePlayer } from '../data/youtubeLivePlayer.js';
|
||||
import { useLiveStore } from './stores/live.js';
|
||||
import { applicationPinia } from './vueRuntime.js';
|
||||
|
||||
/** The element the LIVE section in Context keeps for the player. */
|
||||
export const LIVE_PLAYER_HOST_ID = 'live-player-host';
|
||||
|
||||
/**
|
||||
* The element the Cockpit briefing's LIVE page keeps for the player; the one
|
||||
* used while the Cockpit is on, since the right rail is hidden there.
|
||||
*/
|
||||
export const COCKPIT_LIVE_PLAYER_HOST_ID = 'cockpit-live-player-host';
|
||||
|
||||
/**
|
||||
* A layer's selected subject can be judged again as it settles (a satellite
|
||||
* is docked to the station once both orbits have been compared): the keys
|
||||
* are read again this often while something is selected.
|
||||
*/
|
||||
export const LIVE_SUBJECT_REFRESH_MS = 2000;
|
||||
|
||||
/**
|
||||
* Own the live video: which object is selected (the tracking layers'
|
||||
* `gev:awareness-subject-selected`), which streams the list attaches to it,
|
||||
* and the one player. The views (the LIVE section in Context and the Cockpit
|
||||
* briefing's LIVE page) render what this publishes and ask for the stream to
|
||||
* start (`playLive`) as soon as one is chosen; the player is built into
|
||||
* whichever view is shown, the section's outside the Cockpit and the page's
|
||||
* inside it, and built again in the other when the Cockpit is entered or
|
||||
* left (an embedded player cannot change parents without reloading). It goes
|
||||
* when the selection changes or clears.
|
||||
*/
|
||||
export class LiveControls {
|
||||
/**
|
||||
* @param {{store?: object, actions: {getLayer: (layerId: string) => object|null,
|
||||
* scheduleLayout?: () => void}, documentRef?: Document, globalRef?: object,
|
||||
* createPlayer?: typeof createYouTubeLivePlayer,
|
||||
* streams?: readonly object[], refreshMs?: number}} options
|
||||
*/
|
||||
constructor({
|
||||
store = useLiveStore(applicationPinia()),
|
||||
actions,
|
||||
documentRef = globalThis.document,
|
||||
globalRef = globalThis,
|
||||
createPlayer = createYouTubeLivePlayer,
|
||||
streams = LIVE_STREAMS,
|
||||
refreshMs = LIVE_SUBJECT_REFRESH_MS,
|
||||
}) {
|
||||
this.store = store;
|
||||
this.actions = actions;
|
||||
this.documentRef = documentRef;
|
||||
this.globalRef = globalRef;
|
||||
this.createPlayer = createPlayer;
|
||||
this.streams = streams;
|
||||
this.refreshMs = refreshMs;
|
||||
this.destroyed = false;
|
||||
/** The selected object: its layer, id and label; null for none. */
|
||||
this.subject = null;
|
||||
/** The streams on offer for it, and the chosen one's id. */
|
||||
this.offered = [];
|
||||
this.currentId = null;
|
||||
/** The player, the element and stream it was built for, and its state. */
|
||||
this.player = null;
|
||||
this.playerHost = null;
|
||||
this.playerStreamId = null;
|
||||
this.playback = { state: 'idle', reason: null };
|
||||
/** Whether the Cockpit is on, which decides the host the player goes in. */
|
||||
this.cockpitActive =
|
||||
documentRef?.body?.classList?.contains?.('cockpit-mode') === true;
|
||||
this.timer = null;
|
||||
this.listeners = new AbortController();
|
||||
const { signal } = this.listeners;
|
||||
const target = globalRef.addEventListener ? globalRef : null;
|
||||
target?.addEventListener(
|
||||
'gev:awareness-subject-selected',
|
||||
(event) => this._onSelected(event.detail),
|
||||
{ signal },
|
||||
);
|
||||
target?.addEventListener(
|
||||
'gev:awareness-subject-cleared',
|
||||
(event) => this._onCleared(event.detail),
|
||||
{ signal },
|
||||
);
|
||||
target?.addEventListener(
|
||||
'gev:cockpit-mode-changed',
|
||||
(event) => this._onCockpitMode(event.detail?.active === true),
|
||||
{ signal },
|
||||
);
|
||||
this.owner = store.connect({
|
||||
cycleLive: (direction) => this.cycle(direction),
|
||||
playLive: () => this.play(),
|
||||
stopLive: () => this.stop(),
|
||||
retryLive: () => this.play({ restart: true }),
|
||||
});
|
||||
store.publish(null);
|
||||
}
|
||||
|
||||
_onSelected(detail) {
|
||||
if (this.destroyed || !detail?.layerId || detail.id == null) return;
|
||||
const same =
|
||||
this.subject &&
|
||||
this.subject.layerId === detail.layerId &&
|
||||
String(this.subject.id) === String(detail.id);
|
||||
this.subject = {
|
||||
layerId: detail.layerId,
|
||||
id: detail.id,
|
||||
label: String(detail.label ?? detail.id),
|
||||
};
|
||||
if (!same) this.stop();
|
||||
this._refresh();
|
||||
this._arm();
|
||||
}
|
||||
|
||||
_onCleared(detail) {
|
||||
if (this.destroyed || !this.subject) return;
|
||||
if (detail?.layerId && detail.layerId !== this.subject.layerId) return;
|
||||
this.subject = null;
|
||||
this.stop();
|
||||
this._disarm();
|
||||
this._refresh();
|
||||
}
|
||||
|
||||
/**
|
||||
* The Cockpit went on or off: the view shown changed, so a player that is
|
||||
* loading or playing is built again in the host now shown. With no such
|
||||
* host in the page the player goes, and the view starts it again once its
|
||||
* screen is there.
|
||||
*/
|
||||
_onCockpitMode(active) {
|
||||
if (this.destroyed || active === this.cockpitActive) return;
|
||||
this.cockpitActive = active;
|
||||
if (this.player === null) return;
|
||||
const host = this._host();
|
||||
if (host && host === this.playerHost) return;
|
||||
if (!this.play({ restart: true })) this.stop();
|
||||
}
|
||||
|
||||
/** The element the player belongs in now: the Cockpit page's, or the section's. */
|
||||
_host() {
|
||||
const id = this.cockpitActive
|
||||
? COCKPIT_LIVE_PLAYER_HOST_ID
|
||||
: LIVE_PLAYER_HOST_ID;
|
||||
return this.documentRef?.getElementById?.(id) ?? null;
|
||||
}
|
||||
|
||||
/** Read the selected subject's keys again on a timer, while one is selected. */
|
||||
_arm() {
|
||||
this._disarm();
|
||||
if (!this.subject || !(this.refreshMs > 0)) return;
|
||||
this.timer = this.globalRef.setInterval(
|
||||
() => this._refresh(),
|
||||
this.refreshMs,
|
||||
);
|
||||
this.timer?.unref?.();
|
||||
}
|
||||
|
||||
_disarm() {
|
||||
if (this.timer !== null) this.globalRef.clearInterval(this.timer);
|
||||
this.timer = null;
|
||||
}
|
||||
|
||||
/** The keys the selected subject is known by, from its layer. */
|
||||
_subjectKeys() {
|
||||
if (!this.subject) return [];
|
||||
const { layerId, id } = this.subject;
|
||||
const keys = [`${layerId}:${id}`];
|
||||
let layer = null;
|
||||
try {
|
||||
layer = this.actions.getLayer?.(layerId) ?? null;
|
||||
} catch {
|
||||
layer = null;
|
||||
}
|
||||
try {
|
||||
for (const key of layer?.getLiveSubjectKeys?.() ?? [])
|
||||
if (typeof key === 'string') keys.push(key);
|
||||
} catch {
|
||||
// A layer that cannot say keeps its plain key.
|
||||
}
|
||||
return keys;
|
||||
}
|
||||
|
||||
/** Work out the streams on offer and publish. */
|
||||
_refresh() {
|
||||
if (this.destroyed) return;
|
||||
const offered = liveStreamsFor(this._subjectKeys(), this.streams);
|
||||
const changed =
|
||||
offered.length !== this.offered.length ||
|
||||
offered.some((stream, index) => stream.id !== this.offered[index]?.id);
|
||||
this.offered = offered;
|
||||
if (!offered.some((stream) => stream.id === this.currentId)) {
|
||||
// The chosen stream went with the selection: nothing plays on.
|
||||
if (this.player) this.stop();
|
||||
this.currentId = offered[0]?.id ?? null;
|
||||
}
|
||||
this._publish();
|
||||
if (changed) this.actions.scheduleLayout?.();
|
||||
}
|
||||
|
||||
_publish() {
|
||||
if (this.destroyed) return;
|
||||
if (!this.subject || !this.offered.length) {
|
||||
this.store.publish(null);
|
||||
return;
|
||||
}
|
||||
const index = Math.max(
|
||||
0,
|
||||
this.offered.findIndex((stream) => stream.id === this.currentId),
|
||||
);
|
||||
const current = this.offered[index];
|
||||
this.store.publish({
|
||||
label: this.subject.label,
|
||||
streams: this.offered.map((stream) => ({
|
||||
id: stream.id,
|
||||
title: stream.title,
|
||||
owner: stream.owner,
|
||||
})),
|
||||
index,
|
||||
count: this.offered.length,
|
||||
current: {
|
||||
id: current.id,
|
||||
title: current.title,
|
||||
owner: current.owner,
|
||||
ownerUrl: current.ownerUrl,
|
||||
note: current.note,
|
||||
watchUrl: youtubeWatchUrl(current.videoId),
|
||||
},
|
||||
state: this.playback.state,
|
||||
reason: this.playback.reason,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Step to the next (+1) or previous (-1) stream on offer, wrapping. A
|
||||
* playing stream hands over to the new one.
|
||||
* @returns {boolean} True when the stream changed.
|
||||
*/
|
||||
cycle(direction = 1) {
|
||||
if (this.offered.length < 2) return false;
|
||||
const index = this.offered.findIndex((s) => s.id === this.currentId);
|
||||
const next =
|
||||
(Math.max(index, 0) + (direction < 0 ? -1 : 1) + this.offered.length) %
|
||||
this.offered.length;
|
||||
this.currentId = this.offered[next].id;
|
||||
const wasPlaying = this.player !== null;
|
||||
this.stop();
|
||||
if (wasPlaying) this.play();
|
||||
else this._publish();
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Start the chosen stream in the host now shown: the one call that loads
|
||||
* the player. A player already loading or playing that stream in that host
|
||||
* is left alone, so the views may ask whenever they see nothing playing;
|
||||
* `restart` (Try again) builds a fresh one regardless.
|
||||
* @returns {boolean} True when a player is loading or playing afterwards.
|
||||
*/
|
||||
play({ restart = false } = {}) {
|
||||
if (this.destroyed) return false;
|
||||
const stream = this.offered.find((s) => s.id === this.currentId);
|
||||
const host = this._host();
|
||||
if (!stream || !host) return false;
|
||||
const running =
|
||||
this.playback.state === 'loading' || this.playback.state === 'playing';
|
||||
if (
|
||||
!restart &&
|
||||
this.player &&
|
||||
running &&
|
||||
this.playerHost === host &&
|
||||
this.playerStreamId === stream.id
|
||||
)
|
||||
return true;
|
||||
this.stop();
|
||||
this.playback = { state: 'loading', reason: null };
|
||||
this.playerHost = host;
|
||||
this.playerStreamId = stream.id;
|
||||
this.player = this.createPlayer({
|
||||
host,
|
||||
videoId: stream.videoId,
|
||||
documentRef: this.documentRef,
|
||||
globalRef: this.globalRef,
|
||||
onChange: ({ state, reason }) => {
|
||||
if (this.destroyed) return;
|
||||
this.playback = { state, reason };
|
||||
this._publish();
|
||||
},
|
||||
});
|
||||
this._publish();
|
||||
return true;
|
||||
}
|
||||
|
||||
/** Remove the player; the screen goes dark. */
|
||||
stop() {
|
||||
const had = this.player !== null;
|
||||
this.player?.destroy();
|
||||
this.player = null;
|
||||
this.playerHost = null;
|
||||
this.playerStreamId = null;
|
||||
if (had || this.playback.state !== 'idle') {
|
||||
this.playback = { state: 'idle', reason: null };
|
||||
this._publish();
|
||||
}
|
||||
return had;
|
||||
}
|
||||
|
||||
destroy() {
|
||||
if (this.destroyed) return;
|
||||
this.stop();
|
||||
this.destroyed = true;
|
||||
this._disarm();
|
||||
this.listeners.abort();
|
||||
this.store.detach(this.owner);
|
||||
this.store.publish(null);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,368 @@
|
||||
// src/ui/liveControls.test.mjs — LiveControls owns the live video: the
|
||||
// selected object's streams, the one player, which screen it is built into,
|
||||
// and when it goes.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import {
|
||||
COCKPIT_LIVE_PLAYER_HOST_ID,
|
||||
LIVE_PLAYER_HOST_ID,
|
||||
LiveControls,
|
||||
} from './liveControls.js';
|
||||
import { createOwners } from './stores/owners.js';
|
||||
|
||||
const STREAMS = Object.freeze([
|
||||
{
|
||||
id: 'one',
|
||||
platform: 'youtube',
|
||||
videoId: 'AAAAAAAAAAA',
|
||||
title: 'First',
|
||||
owner: 'Owner',
|
||||
ownerUrl: 'https://www.youtube.com/@owner',
|
||||
subjects: ['station:test'],
|
||||
note: 'note',
|
||||
},
|
||||
{
|
||||
id: 'two',
|
||||
platform: 'youtube',
|
||||
videoId: 'BBBBBBBBBBB',
|
||||
title: 'Second',
|
||||
owner: 'Owner',
|
||||
ownerUrl: 'https://www.youtube.com/@owner',
|
||||
subjects: ['station:test'],
|
||||
note: 'note',
|
||||
},
|
||||
{
|
||||
id: 'other',
|
||||
platform: 'youtube',
|
||||
videoId: 'CCCCCCCCCCC',
|
||||
title: 'Elsewhere',
|
||||
owner: 'Owner',
|
||||
ownerUrl: 'https://www.youtube.com/@owner',
|
||||
subjects: ['station:other'],
|
||||
note: 'note',
|
||||
},
|
||||
]);
|
||||
|
||||
function fixture({
|
||||
withHost = true,
|
||||
withCockpitHost = true,
|
||||
cockpitMode = false,
|
||||
} = {}) {
|
||||
const globalRef = new EventTarget();
|
||||
const intervals = [];
|
||||
globalRef.setInterval = (callback, ms) => {
|
||||
const id = intervals.length + 1;
|
||||
intervals.push({ id, callback, ms, cleared: false });
|
||||
return id;
|
||||
};
|
||||
globalRef.clearInterval = (id) => {
|
||||
const timer = intervals.find((entry) => entry.id === id);
|
||||
if (timer) timer.cleared = true;
|
||||
};
|
||||
const host = { id: LIVE_PLAYER_HOST_ID };
|
||||
const cockpitHost = { id: COCKPIT_LIVE_PLAYER_HOST_ID };
|
||||
const documentRef = {
|
||||
getElementById: (id) => {
|
||||
if (id === LIVE_PLAYER_HOST_ID) return withHost ? host : null;
|
||||
if (id === COCKPIT_LIVE_PLAYER_HOST_ID)
|
||||
return withCockpitHost ? cockpitHost : null;
|
||||
return null;
|
||||
},
|
||||
body: {
|
||||
classList: { contains: (name) => cockpitMode && name === 'cockpit-mode' },
|
||||
},
|
||||
};
|
||||
const published = [];
|
||||
const store = {
|
||||
...createOwners(),
|
||||
publish: (view) => published.push(view),
|
||||
};
|
||||
let keys = [];
|
||||
const layer = { getLiveSubjectKeys: () => keys };
|
||||
const layouts = [];
|
||||
const players = [];
|
||||
const createPlayer = (options) => {
|
||||
const player = {
|
||||
options,
|
||||
destroyed: 0,
|
||||
destroy: () => (player.destroyed += 1),
|
||||
};
|
||||
players.push(player);
|
||||
return player;
|
||||
};
|
||||
const controls = new LiveControls({
|
||||
store,
|
||||
actions: {
|
||||
getLayer: (layerId) => (layerId === 'satellites' ? layer : null),
|
||||
scheduleLayout: () => layouts.push(1),
|
||||
},
|
||||
documentRef,
|
||||
globalRef,
|
||||
createPlayer,
|
||||
streams: STREAMS,
|
||||
refreshMs: 2000,
|
||||
});
|
||||
const dispatch = (type, detail) =>
|
||||
globalRef.dispatchEvent(new CustomEvent(type, { detail }));
|
||||
const select = (detail) =>
|
||||
dispatch('gev:awareness-subject-selected', {
|
||||
layerId: 'satellites',
|
||||
id: 25544,
|
||||
label: 'ISS (ZARYA)',
|
||||
...detail,
|
||||
});
|
||||
const view = () => published.at(-1);
|
||||
const running = () => intervals.filter((timer) => !timer.cleared);
|
||||
return {
|
||||
controls,
|
||||
store,
|
||||
published,
|
||||
view,
|
||||
dispatch,
|
||||
select,
|
||||
setKeys: (next) => (keys = next),
|
||||
players,
|
||||
layouts,
|
||||
intervals,
|
||||
running,
|
||||
host,
|
||||
cockpitHost,
|
||||
};
|
||||
}
|
||||
|
||||
test('nothing selected publishes no section; a selection with streams publishes them', () => {
|
||||
const f = fixture();
|
||||
assert.equal(f.view(), null);
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
const view = f.view();
|
||||
assert.equal(view.label, 'ISS (ZARYA)');
|
||||
assert.equal(view.count, 2);
|
||||
assert.equal(view.index, 0);
|
||||
assert.deepEqual(
|
||||
view.streams.map((stream) => stream.id),
|
||||
['one', 'two'],
|
||||
);
|
||||
assert.equal(view.current.id, 'one');
|
||||
assert.equal(
|
||||
view.current.watchUrl,
|
||||
'https://www.youtube.com/watch?v=AAAAAAAAAAA',
|
||||
);
|
||||
assert.equal(view.state, 'idle');
|
||||
assert.equal(
|
||||
f.layouts.length,
|
||||
1,
|
||||
'the rail is laid out once the section appears',
|
||||
);
|
||||
assert.equal(f.running().length, 1, 'the subject is re-read on a timer');
|
||||
assert.equal(f.running()[0].ms, 2000);
|
||||
});
|
||||
|
||||
test('a selection no stream names keeps the section away; the plain key counts too', () => {
|
||||
const f = fixture();
|
||||
f.select();
|
||||
assert.equal(f.view(), null);
|
||||
assert.equal(f.layouts.length, 0);
|
||||
// A stream attached to a layer's own `<layer>:<id>` key needs no layer help.
|
||||
const g = fixture();
|
||||
g.setKeys([]);
|
||||
g.select({ layerId: 'satellites', id: 'x' });
|
||||
assert.equal(g.view(), null);
|
||||
});
|
||||
|
||||
test('the layer is asked again on the timer: an entry that settles as docked gains the streams', () => {
|
||||
const f = fixture();
|
||||
f.select();
|
||||
assert.equal(f.view(), null);
|
||||
f.setKeys(['station:test']);
|
||||
f.running()[0].callback();
|
||||
assert.equal(f.view()?.count, 2);
|
||||
assert.equal(f.layouts.length, 1);
|
||||
// Unchanged keys do not lay out again.
|
||||
f.running()[0].callback();
|
||||
assert.equal(f.layouts.length, 1);
|
||||
});
|
||||
|
||||
test('playLive builds the player for the chosen stream in the section, once; Try again builds it anew', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
assert.equal(
|
||||
f.players.length,
|
||||
0,
|
||||
'the views ask; selection alone builds nothing',
|
||||
);
|
||||
assert.equal(f.store.act('playLive'), true);
|
||||
assert.equal(f.players.length, 1);
|
||||
assert.equal(f.players[0].options.videoId, 'AAAAAAAAAAA');
|
||||
assert.equal(f.players[0].options.host, f.host);
|
||||
assert.equal(f.view().state, 'loading');
|
||||
// Asked again while loading or playing, the same player stays.
|
||||
assert.equal(f.store.act('playLive'), true);
|
||||
f.players[0].options.onChange({ state: 'playing', reason: null });
|
||||
assert.equal(f.store.act('playLive'), true);
|
||||
assert.equal(f.players.length, 1, 'no second player for the same stream');
|
||||
assert.equal(f.players[0].destroyed, 0);
|
||||
assert.equal(f.view().state, 'playing');
|
||||
f.players[0].options.onChange({ state: 'offline', reason: 'ended' });
|
||||
assert.equal(f.view().state, 'offline');
|
||||
assert.equal(f.view().reason, 'ended');
|
||||
assert.equal(f.store.act('stopLive'), true);
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.view().state, 'idle');
|
||||
// Try again builds a fresh player.
|
||||
assert.equal(f.store.act('retryLive'), true);
|
||||
assert.equal(f.players.length, 2);
|
||||
});
|
||||
|
||||
test('Play without the host element in the page, or without a selection, does nothing', () => {
|
||||
const noHost = fixture({ withHost: false });
|
||||
noHost.setKeys(['station:test']);
|
||||
noHost.select();
|
||||
assert.equal(noHost.store.act('playLive'), false);
|
||||
assert.equal(noHost.players.length, 0);
|
||||
const idle = fixture();
|
||||
assert.equal(idle.store.act('playLive'), false);
|
||||
});
|
||||
|
||||
test('the arrows step through the streams, wrapping, and a playing stream hands over', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
assert.equal(f.store.act('cycleLive', 1), true);
|
||||
assert.equal(f.view().current.id, 'two');
|
||||
assert.equal(f.store.act('cycleLive', 1), true);
|
||||
assert.equal(f.view().current.id, 'one', 'wraps forward');
|
||||
assert.equal(f.store.act('cycleLive', -1), true);
|
||||
assert.equal(f.view().current.id, 'two', 'wraps backward');
|
||||
assert.equal(f.players.length, 0, 'stepping while idle loads nothing');
|
||||
f.store.act('playLive');
|
||||
f.store.act('cycleLive', 1);
|
||||
assert.equal(f.players.length, 2);
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.players[1].options.videoId, 'AAAAAAAAAAA');
|
||||
assert.equal(f.view().state, 'loading');
|
||||
});
|
||||
|
||||
test('with one stream there is nothing to cycle', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:other']);
|
||||
f.select();
|
||||
assert.equal(f.view().count, 1);
|
||||
assert.equal(f.store.act('cycleLive', 1), false);
|
||||
assert.equal(f.view().current.id, 'other');
|
||||
});
|
||||
|
||||
test('a new selection stops the stream; the same entry selected again keeps it', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('playLive');
|
||||
f.select({ origin: 'pick' });
|
||||
assert.equal(f.players[0].destroyed, 0, 'the same subject plays on');
|
||||
f.setKeys(['station:other']);
|
||||
f.select({ id: 99999, label: 'OTHER' });
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.view().label, 'OTHER');
|
||||
assert.equal(f.view().current.id, 'other');
|
||||
assert.equal(f.view().state, 'idle');
|
||||
});
|
||||
|
||||
test('clearing the selection takes the section down; another layer clearing does not', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('playLive');
|
||||
f.dispatch('gev:awareness-subject-cleared', { layerId: 'flights' });
|
||||
assert.equal(f.view().count, 2, 'another layer clearing is not ours');
|
||||
f.dispatch('gev:awareness-subject-cleared', { layerId: 'satellites' });
|
||||
assert.equal(f.view(), null);
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.running().length, 0, 'the timer stops with the selection');
|
||||
});
|
||||
|
||||
test("entering the Cockpit builds the player again in the briefing page's screen, and leaving it in the section's", () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('playLive');
|
||||
f.players[0].options.onChange({ state: 'playing', reason: null });
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: true });
|
||||
assert.equal(f.players[0].destroyed, 1, 'the rail is hidden in the Cockpit');
|
||||
assert.equal(f.players.length, 2);
|
||||
assert.equal(f.players[1].options.host, f.cockpitHost);
|
||||
assert.equal(f.players[1].options.videoId, 'AAAAAAAAAAA');
|
||||
assert.equal(f.view().state, 'loading', 'a fresh player starts again');
|
||||
// The same state again changes nothing.
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: true });
|
||||
assert.equal(f.players.length, 2);
|
||||
// playLive from the hidden section's view finds the Cockpit's screen too.
|
||||
assert.equal(f.store.act('playLive'), true);
|
||||
assert.equal(f.players.length, 2);
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: false });
|
||||
assert.equal(f.players[1].destroyed, 1);
|
||||
assert.equal(f.players.length, 3);
|
||||
assert.equal(f.players[2].options.host, f.host);
|
||||
});
|
||||
|
||||
test('the Cockpit going on or off with nothing playing builds nothing', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: true });
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: false });
|
||||
assert.equal(f.players.length, 0);
|
||||
assert.equal(f.view().state, 'idle');
|
||||
});
|
||||
|
||||
test("entering the Cockpit without the page's screen in the page removes the player", () => {
|
||||
const f = fixture({ withCockpitHost: false });
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('playLive');
|
||||
f.dispatch('gev:cockpit-mode-changed', { active: true });
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.players.length, 1);
|
||||
assert.equal(
|
||||
f.view().state,
|
||||
'idle',
|
||||
'the view starts it once its screen is there',
|
||||
);
|
||||
assert.equal(f.store.act('playLive'), false, 'still no screen');
|
||||
});
|
||||
|
||||
test("constructed with the Cockpit already on, playLive uses the page's screen", () => {
|
||||
const f = fixture({ cockpitMode: true });
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
assert.equal(f.store.act('playLive'), true);
|
||||
assert.equal(f.players[0].options.host, f.cockpitHost);
|
||||
});
|
||||
|
||||
test('the chosen stream going from the list stops it and picks the first that remains', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('cycleLive', 1);
|
||||
f.store.act('playLive');
|
||||
f.setKeys(['station:other']);
|
||||
f.running()[0].callback();
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.view().current.id, 'other');
|
||||
assert.equal(f.view().state, 'idle');
|
||||
});
|
||||
|
||||
test('destroy stops the stream, detaches the actions and publishes nothing', () => {
|
||||
const f = fixture();
|
||||
f.setKeys(['station:test']);
|
||||
f.select();
|
||||
f.store.act('playLive');
|
||||
f.controls.destroy();
|
||||
assert.equal(f.players[0].destroyed, 1);
|
||||
assert.equal(f.view(), null);
|
||||
assert.equal(f.store.act('playLive'), undefined, 'no owner answers');
|
||||
assert.equal(f.running().length, 0);
|
||||
const before = f.published.length;
|
||||
f.select();
|
||||
assert.equal(f.published.length, before, 'events after destroy are ignored');
|
||||
});
|
||||
@@ -0,0 +1,240 @@
|
||||
// src/ui/livePanel.test.mjs — the LIVE panel renders what LiveControls
|
||||
// publishes, over happy-dom; it starts the stream as soon as one is chosen,
|
||||
// collapsed or not, and its controls reach the store's owner.
|
||||
import '../testSupport/registerDom.mjs';
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { createPinia } from 'pinia';
|
||||
import { createApp, nextTick } from 'vue';
|
||||
import { useLiveStore } from './stores/live.js';
|
||||
import { usePanelChromeStore } from './stores/panelChrome.js';
|
||||
import LivePanel from './views/panels/LivePanel.vue';
|
||||
|
||||
const settle = async () => {
|
||||
await nextTick();
|
||||
await nextTick();
|
||||
};
|
||||
|
||||
function fixture(t) {
|
||||
document.body.replaceChildren();
|
||||
const host = document.body.appendChild(document.createElement('div'));
|
||||
const pinia = createPinia();
|
||||
const app = createApp(LivePanel).use(pinia);
|
||||
app.mount(host);
|
||||
t.after(() => app.unmount());
|
||||
const store = useLiveStore(pinia);
|
||||
const acted = [];
|
||||
store.connect({
|
||||
cycleLive: (direction) => acted.push(['cycle', direction]),
|
||||
playLive: () => acted.push(['play']),
|
||||
stopLive: () => acted.push(['stop']),
|
||||
retryLive: () => acted.push(['retry']),
|
||||
});
|
||||
const chrome = usePanelChromeStore(pinia);
|
||||
const token = chrome.connect({ toggle() {}, pin() {} });
|
||||
const setOpen = async (open) => {
|
||||
chrome.publish(token, 'live-panel', { collapsed: !open });
|
||||
await settle();
|
||||
};
|
||||
const $ = (id) => document.getElementById(id);
|
||||
const publish = async (view) => {
|
||||
store.publish(
|
||||
view && {
|
||||
label: 'ISS (ZARYA)',
|
||||
streams: [
|
||||
{ id: 'iss-exterior', title: 'Exterior cameras', owner: 'NASA' },
|
||||
{
|
||||
id: 'iss-crew',
|
||||
title: 'Live video and space-to-ground audio',
|
||||
owner: 'NASA',
|
||||
},
|
||||
],
|
||||
index: 0,
|
||||
count: 2,
|
||||
current: {
|
||||
id: 'iss-exterior',
|
||||
title: 'Exterior cameras',
|
||||
owner: 'NASA',
|
||||
ownerUrl: 'https://www.youtube.com/@NASA',
|
||||
note: 'NASA video, via YouTube',
|
||||
watchUrl: 'https://www.youtube.com/watch?v=ROboUHfPUrU',
|
||||
},
|
||||
state: 'idle',
|
||||
reason: null,
|
||||
...view,
|
||||
},
|
||||
);
|
||||
await settle();
|
||||
};
|
||||
return { $, publish, acted, setOpen };
|
||||
}
|
||||
|
||||
test('without a view the section is hidden and shows OFF', (t) => {
|
||||
const { $, acted } = fixture(t);
|
||||
assert.equal($('live-panel').hidden, true);
|
||||
assert.equal($('live-badge-text').textContent, 'OFF');
|
||||
assert.equal(
|
||||
$('live-player-host'),
|
||||
null,
|
||||
'no screen until a stream is offered',
|
||||
);
|
||||
assert.deepEqual(acted, [], 'nothing to start');
|
||||
});
|
||||
|
||||
test('a view shows the subject and the stream, and starts it at once, with the section collapsed', async (t) => {
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({});
|
||||
const panel = $('live-panel');
|
||||
assert.equal(panel.hidden, false);
|
||||
assert.equal(panel.querySelector('.live-subject').textContent, 'ISS (ZARYA)');
|
||||
assert.equal($('live-stream-title').textContent, 'Exterior cameras · 1/2');
|
||||
assert.ok($('live-previous-btn'));
|
||||
assert.ok($('live-next-btn'));
|
||||
assert.ok($('live-player-host'), 'the screen is in the page for the player');
|
||||
assert.equal(
|
||||
$('live-watch-link').getAttribute('href'),
|
||||
'https://www.youtube.com/watch?v=ROboUHfPUrU',
|
||||
);
|
||||
assert.equal($('live-watch-link').getAttribute('rel'), 'noopener noreferrer');
|
||||
assert.deepEqual(acted, [['play']], 'the stream starts on selection');
|
||||
// Loading and playing change nothing further.
|
||||
await publish({ state: 'loading' });
|
||||
await publish({ state: 'playing' });
|
||||
assert.deepEqual(acted, [['play']]);
|
||||
});
|
||||
|
||||
test('a different stream chosen while idle starts too', async (t) => {
|
||||
const { publish, acted } = fixture(t);
|
||||
await publish({});
|
||||
assert.deepEqual(acted, [['play']]);
|
||||
await publish({
|
||||
current: {
|
||||
id: 'iss-crew',
|
||||
title: 'Live video and space-to-ground audio',
|
||||
owner: 'NASA',
|
||||
ownerUrl: 'https://www.youtube.com/@NASA',
|
||||
note: '',
|
||||
watchUrl: 'https://www.youtube.com/watch?v=M3HKLzjvKPc',
|
||||
},
|
||||
index: 1,
|
||||
});
|
||||
assert.deepEqual(acted, [['play'], ['play']]);
|
||||
});
|
||||
|
||||
test('collapsing or opening the section neither stops nor restarts the stream', async (t) => {
|
||||
const { $, publish, acted, setOpen } = fixture(t);
|
||||
await setOpen(true);
|
||||
await publish({ state: 'playing' });
|
||||
assert.deepEqual(acted, [], 'already playing: nothing to start');
|
||||
await setOpen(false);
|
||||
assert.deepEqual(acted, [], 'the +/- only hides the body');
|
||||
assert.ok($('live-player-host'), 'the player keeps its element');
|
||||
await setOpen(true);
|
||||
assert.deepEqual(acted, []);
|
||||
});
|
||||
|
||||
test('while playing the badge says ON AIR with the blinking dot, and there is no card', async (t) => {
|
||||
const { $, publish } = fixture(t);
|
||||
await publish({ state: 'playing' });
|
||||
const panel = $('live-panel');
|
||||
assert.equal(panel.classList.contains('live-on-air'), true);
|
||||
assert.equal($('live-badge-text').textContent, 'ON AIR');
|
||||
assert.equal(
|
||||
panel.querySelector('.live-dot').classList.contains('on-air'),
|
||||
true,
|
||||
);
|
||||
assert.equal(
|
||||
panel.querySelector('.live-screen').classList.contains('active'),
|
||||
true,
|
||||
);
|
||||
assert.equal(panel.querySelector('.live-card'), null);
|
||||
assert.equal($('live-status').textContent, 'Live');
|
||||
});
|
||||
|
||||
test('starting shows the waiting dot', async (t) => {
|
||||
const { $, publish } = fixture(t);
|
||||
await publish({ state: 'loading' });
|
||||
assert.equal($('live-badge-text').textContent, 'OFF');
|
||||
assert.equal(
|
||||
$('live-panel').querySelector('.live-dot').classList.contains('waiting'),
|
||||
true,
|
||||
);
|
||||
assert.equal($('live-status').textContent, 'Starting…');
|
||||
});
|
||||
|
||||
test('an offline stream shows the fallback card with Try again, and is not restarted by itself', async (t) => {
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({ state: 'offline', reason: 'timeout' });
|
||||
const card = $('live-panel').querySelector('.live-card');
|
||||
assert.equal(card.classList.contains('offline'), true);
|
||||
assert.equal(card.querySelector('strong').textContent, 'Stream is offline');
|
||||
assert.equal($('live-status').textContent, 'Stream is offline');
|
||||
assert.deepEqual(acted, [], 'offline is left to Try again');
|
||||
$('live-retry-btn').click();
|
||||
assert.deepEqual(acted, [['retry']]);
|
||||
});
|
||||
|
||||
test('a stream that cannot be embedded says so, without Try again', async (t) => {
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({ state: 'unavailable', reason: 'error-150' });
|
||||
const card = $('live-panel').querySelector('.live-card');
|
||||
assert.equal(card.classList.contains('unavailable'), true);
|
||||
assert.equal(
|
||||
card.querySelector('strong').textContent,
|
||||
'This stream cannot play here',
|
||||
);
|
||||
assert.equal($('live-retry-btn'), null);
|
||||
assert.equal($('live-status').textContent, 'This stream cannot play here');
|
||||
assert.deepEqual(acted, []);
|
||||
});
|
||||
|
||||
test('the arrows step through the streams', async (t) => {
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({ state: 'playing' });
|
||||
$('live-next-btn').click();
|
||||
$('live-previous-btn').click();
|
||||
assert.deepEqual(acted, [
|
||||
['cycle', 1],
|
||||
['cycle', -1],
|
||||
]);
|
||||
});
|
||||
|
||||
test('with one stream there are no arrows and no counter', async (t) => {
|
||||
const { $, publish } = fixture(t);
|
||||
await publish({
|
||||
count: 1,
|
||||
streams: [{ id: 'iss-exterior', title: 'Exterior cameras', owner: 'NASA' }],
|
||||
});
|
||||
assert.equal($('live-previous-btn'), null);
|
||||
assert.equal($('live-next-btn'), null);
|
||||
assert.equal($('live-stream-title').textContent, 'Exterior cameras');
|
||||
});
|
||||
|
||||
test('publishing null hides the section again', async (t) => {
|
||||
const { $, publish } = fixture(t);
|
||||
await publish({});
|
||||
await publish(null);
|
||||
assert.equal($('live-panel').hidden, true);
|
||||
});
|
||||
|
||||
test('a language change keeps the same screen element and neither stops nor restarts the stream', async (t) => {
|
||||
// The player is built into #live-player-host by LiveControls, outside Vue.
|
||||
// A locale change re-renders the panel's words; the screen must be the
|
||||
// same element afterwards, with nothing asked of the owner, or the stream
|
||||
// would be torn down and rebuilt with every language switch.
|
||||
const { getLocale, setLocale } = await import('../i18n/index.js');
|
||||
const originalLocale = getLocale();
|
||||
t.after(() => setLocale(originalLocale));
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({ state: 'playing' });
|
||||
const screen = $('live-player-host');
|
||||
assert.ok(screen, 'the screen is in the page while a stream is offered');
|
||||
const marker = screen.appendChild(document.createElement('span'));
|
||||
const askedBefore = acted.length;
|
||||
setLocale(originalLocale === 'fr' ? 'es' : 'fr');
|
||||
await settle();
|
||||
assert.equal($('live-player-host'), screen, 'the same screen element');
|
||||
assert.equal(marker.parentNode, screen, 'what LiveControls put in it stays');
|
||||
assert.equal(acted.length, askedBefore, 'no play, stop or retry asked');
|
||||
assert.equal($('live-panel').hidden, false);
|
||||
});
|
||||
@@ -0,0 +1,58 @@
|
||||
import { storeToRefs } from 'pinia';
|
||||
import { computed, nextTick, watch } from 'vue';
|
||||
import { t } from '../i18n/index.js';
|
||||
import { useLiveStore } from './stores/live.js';
|
||||
|
||||
/**
|
||||
* What the LIVE section in Context and the Cockpit briefing's LIVE page
|
||||
* share: the live store's view, its state read as words, and the rule that
|
||||
* starts the stream. Each view calls this from its setup and renders the
|
||||
* result; the controls call LiveControls through `act`.
|
||||
*/
|
||||
export function useLiveScreen() {
|
||||
const store = useLiveStore();
|
||||
const { act } = store;
|
||||
const { view } = storeToRefs(store);
|
||||
const playing = computed(() => view.value?.state === 'playing');
|
||||
const loading = computed(() => view.value?.state === 'loading');
|
||||
const offline = computed(() => view.value?.state === 'offline');
|
||||
const unavailable = computed(() => view.value?.state === 'unavailable');
|
||||
const badgeText = computed(() => (playing.value ? t('ON AIR') : t('OFF')));
|
||||
const statusText = computed(() => {
|
||||
switch (view.value?.state) {
|
||||
case 'playing':
|
||||
return t('Live');
|
||||
case 'offline':
|
||||
return t('Stream is offline');
|
||||
case 'unavailable':
|
||||
return t('This stream cannot play here');
|
||||
default:
|
||||
return t('Starting…');
|
||||
}
|
||||
});
|
||||
|
||||
// Start the stream as soon as one is chosen and nothing plays, once the
|
||||
// screen is in the page (the player is built into it). Which screen is
|
||||
// LiveControls' choice, and asking from both views starts nothing twice.
|
||||
// A stream that went offline or cannot play stays as it is until Try again.
|
||||
watch(
|
||||
[() => view.value?.current?.id ?? null, () => view.value?.state ?? null],
|
||||
async ([streamId, state]) => {
|
||||
if (!streamId || state !== 'idle') return;
|
||||
await nextTick();
|
||||
act('playLive');
|
||||
},
|
||||
{ immediate: true, flush: 'post' },
|
||||
);
|
||||
|
||||
return {
|
||||
view,
|
||||
act,
|
||||
playing,
|
||||
loading,
|
||||
offline,
|
||||
unavailable,
|
||||
badgeText,
|
||||
statusText,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,215 @@
|
||||
// src/ui/stationPanel.test.mjs — the STATION panel renders what the
|
||||
// satellites layer publishes, over happy-dom; its controls reach the owner.
|
||||
import '../testSupport/registerDom.mjs';
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { createPinia } from 'pinia';
|
||||
import { createApp, nextTick } from 'vue';
|
||||
import { useStationStore } from './stores/station.js';
|
||||
import StationPanel from './views/panels/StationPanel.vue';
|
||||
|
||||
function fixture(t) {
|
||||
document.body.replaceChildren();
|
||||
const host = document.body.appendChild(document.createElement('div'));
|
||||
const pinia = createPinia();
|
||||
const app = createApp(StationPanel).use(pinia);
|
||||
app.mount(host);
|
||||
t.after(() => app.unmount());
|
||||
const store = useStationStore(pinia);
|
||||
const acted = [];
|
||||
store.connect({
|
||||
setStationMode: (mode) => acted.push(['mode', mode]),
|
||||
chooseStation: (group, choice) => acted.push(['choose', group, choice]),
|
||||
slideStation: (slider, value) => acted.push(['slide', slider, value]),
|
||||
resumeStationArm: (group) => acted.push(['resume', group]),
|
||||
zoomStation: () => acted.push(['zoom']),
|
||||
});
|
||||
const $ = (id) => document.getElementById(id);
|
||||
const publish = async (view) => {
|
||||
store.publish(
|
||||
view && {
|
||||
key: 'iss',
|
||||
title: 'ISS',
|
||||
subject: 'ISS (ZARYA)',
|
||||
mode: 'automatic',
|
||||
telemetry: { state: 'live', poseAgeMs: 4200, liveUntilMs: null },
|
||||
sunlit: true,
|
||||
note: 'Computed, not live telemetry.',
|
||||
groups: [
|
||||
{
|
||||
id: 'sun',
|
||||
label: 'Sun position',
|
||||
note: null,
|
||||
kind: 'choices',
|
||||
choices: [
|
||||
{ id: 'follow', label: 'Follow the Sun', active: true },
|
||||
{ id: 'ahead', label: 'Ahead', active: false },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'arm',
|
||||
label: 'Canadarm2 (degrees)',
|
||||
note: null,
|
||||
kind: 'sliders',
|
||||
resume: 'Resume sway',
|
||||
sliders: [
|
||||
{
|
||||
id: 'shoulder',
|
||||
label: 'Shoulder roll',
|
||||
min: -120,
|
||||
max: 120,
|
||||
value: 15,
|
||||
},
|
||||
],
|
||||
},
|
||||
],
|
||||
zoom: { offered: false, label: 'Zoom to the ISS' },
|
||||
...view,
|
||||
},
|
||||
);
|
||||
await nextTick();
|
||||
};
|
||||
const telemetryText = () => $('station-telemetry').textContent.trim();
|
||||
return { $, publish, acted, telemetryText };
|
||||
}
|
||||
|
||||
test('without a view the section is hidden', (t) => {
|
||||
const { $ } = fixture(t);
|
||||
assert.equal($('station-panel').hidden, true);
|
||||
assert.equal($('station-badge').textContent, '');
|
||||
});
|
||||
|
||||
test('Automatic shows the subject, the live telemetry age, the Sun line and the note', async (t) => {
|
||||
const { $, publish, telemetryText } = fixture(t);
|
||||
await publish({});
|
||||
const panel = $('station-panel');
|
||||
assert.equal(panel.hidden, false);
|
||||
assert.equal($('station-badge').textContent, 'ISS');
|
||||
assert.equal(
|
||||
panel.querySelector('.station-subject').textContent,
|
||||
'ISS (ZARYA)',
|
||||
);
|
||||
assert.equal($('station-automatic-btn').getAttribute('aria-checked'), 'true');
|
||||
assert.equal(
|
||||
$('station-automatic-btn').classList.contains('is-active'),
|
||||
true,
|
||||
);
|
||||
assert.equal($('station-manual-btn').getAttribute('aria-checked'), 'false');
|
||||
assert.equal(telemetryText(), 'Telemetry · updated 4 s ago');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'live');
|
||||
assert.equal($('station-sun').textContent, 'Now: in sunlight');
|
||||
assert.equal(
|
||||
panel.querySelectorAll('.station-group').length,
|
||||
0,
|
||||
'no controls in Automatic',
|
||||
);
|
||||
assert.equal($('station-zoom-btn'), null);
|
||||
});
|
||||
|
||||
test('the status line words each telemetry state, with ages in seconds or minutes', async (t) => {
|
||||
const { $, publish, telemetryText } = fixture(t);
|
||||
await publish({
|
||||
telemetry: { state: 'live', poseAgeMs: 95_000, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'Telemetry · updated 2 min ago');
|
||||
await publish({
|
||||
telemetry: { state: 'no-signal', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'No signal · computed values');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'waiting');
|
||||
await publish({
|
||||
telemetry: {
|
||||
state: 'no-signal',
|
||||
poseAgeMs: 30_000,
|
||||
liveUntilMs: Date.UTC(2026, 10, 13, 12, 0),
|
||||
},
|
||||
});
|
||||
assert.match(telemetryText(), /^No signal since \S.* · computed values$/);
|
||||
await publish({
|
||||
telemetry: { state: 'unavailable', poseAgeMs: 50_000, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(
|
||||
telemetryText(),
|
||||
'Telemetry unavailable · last update 50 s ago · computed values',
|
||||
);
|
||||
assert.equal($('station-telemetry').dataset.tone, 'off');
|
||||
await publish({
|
||||
telemetry: { state: 'unavailable', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'Telemetry unavailable · computed values');
|
||||
await publish({
|
||||
telemetry: { state: 'disabled', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(
|
||||
telemetryText(),
|
||||
'Telemetry not enabled on this server · computed values',
|
||||
);
|
||||
// A station with no feed at all (Tiangong).
|
||||
await publish({
|
||||
telemetry: { state: 'none', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'No public telemetry · computed values');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'off');
|
||||
await publish({
|
||||
telemetry: { state: 'pending', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'Connecting to telemetry…');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'waiting');
|
||||
await publish({
|
||||
telemetry: { state: 'idle', poseAgeMs: null, liveUntilMs: null },
|
||||
});
|
||||
assert.equal(telemetryText(), 'Telemetry reads while the model is on screen');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'off');
|
||||
await publish({ sunlit: false });
|
||||
assert.equal($('station-sun').textContent, "Now: in the Earth's shadow");
|
||||
});
|
||||
|
||||
test('Manual shows the groups with the active choice, the sliders and the resume button', async (t) => {
|
||||
const { $, publish, telemetryText, acted } = fixture(t);
|
||||
await publish({ mode: 'manual', sunlit: null });
|
||||
const panel = $('station-panel');
|
||||
assert.equal(panel.classList.contains('station-manual'), true);
|
||||
assert.equal($('station-manual-btn').getAttribute('aria-checked'), 'true');
|
||||
assert.equal(telemetryText(), 'Manual · telemetry paused');
|
||||
assert.equal($('station-telemetry').dataset.tone, 'manual');
|
||||
assert.equal($('station-sun'), null);
|
||||
assert.equal(panel.querySelectorAll('.station-group').length, 2);
|
||||
const follow = panel.querySelector('[data-station-choice="sun:follow"]');
|
||||
const ahead = panel.querySelector('[data-station-choice="sun:ahead"]');
|
||||
assert.equal(follow.getAttribute('aria-pressed'), 'true');
|
||||
assert.equal(follow.classList.contains('is-active'), true);
|
||||
assert.equal(ahead.getAttribute('aria-pressed'), 'false');
|
||||
ahead.click();
|
||||
const slider = $('station-slider-shoulder');
|
||||
assert.ok(slider, 'the slider is in the page');
|
||||
assert.equal(
|
||||
panel.querySelector('.station-slider output').textContent,
|
||||
'15°',
|
||||
);
|
||||
panel.querySelector('[data-station-resume="arm"]').click();
|
||||
assert.deepEqual(acted, [
|
||||
['choose', 'sun', 'ahead'],
|
||||
['resume', 'arm'],
|
||||
]);
|
||||
});
|
||||
|
||||
test('the mode buttons and the zoom button call the owner', async (t) => {
|
||||
const { $, publish, acted } = fixture(t);
|
||||
await publish({ zoom: { offered: true, label: 'Zoom to the ISS' } });
|
||||
$('station-manual-btn').click();
|
||||
$('station-automatic-btn').click();
|
||||
assert.equal($('station-zoom-btn').textContent, 'Zoom to the ISS');
|
||||
$('station-zoom-btn').click();
|
||||
assert.deepEqual(acted, [
|
||||
['mode', 'manual'],
|
||||
['mode', 'automatic'],
|
||||
['zoom'],
|
||||
]);
|
||||
});
|
||||
|
||||
test('publishing null hides the section again', async (t) => {
|
||||
const { $, publish } = fixture(t);
|
||||
await publish({});
|
||||
await publish(null);
|
||||
assert.equal($('station-panel').hidden, true);
|
||||
});
|
||||
@@ -0,0 +1,23 @@
|
||||
import { defineStore } from 'pinia';
|
||||
import { markRaw, shallowRef } from 'vue';
|
||||
import { createOwners } from './owners.js';
|
||||
|
||||
/**
|
||||
* The LIVE section in Context as its view renders it: the streams on offer
|
||||
* for the selected object, the one chosen and the player's state.
|
||||
* LiveControls presents it (`gev-live` store) and answers the section's
|
||||
* controls through act(): `cycleLive`, `playLive`, `stopLive`, `retryLive`.
|
||||
*/
|
||||
export const useLiveStore = defineStore('gev-live', () => {
|
||||
/** The presented section; null while nothing selected has a stream. */
|
||||
const view = shallowRef(null);
|
||||
|
||||
/** @param {?object} next A fresh presentation; every publish re-renders. */
|
||||
function publish(next) {
|
||||
view.value = next && markRaw(next);
|
||||
}
|
||||
|
||||
const { connect, detach, act } = createOwners();
|
||||
|
||||
return { view, publish, connect, detach, act };
|
||||
});
|
||||
@@ -0,0 +1,25 @@
|
||||
import { defineStore } from 'pinia';
|
||||
import { markRaw, shallowRef } from 'vue';
|
||||
import { createOwners } from './owners.js';
|
||||
|
||||
/**
|
||||
* The STATION section in Context as its view renders it: the selected
|
||||
* station's controls (Automatic or Manual, the moving parts by hand), where
|
||||
* its joint angles come from right now, and a zoom to it. The satellites
|
||||
* layer's station panel presents it (`gev-station` store) and answers its
|
||||
* controls through act(): `setStationMode`, `chooseStation`, `slideStation`,
|
||||
* `resumeStationArm`, `zoomStation`.
|
||||
*/
|
||||
export const useStationStore = defineStore('gev-station', () => {
|
||||
/** The presented section; null while no station is selected. */
|
||||
const view = shallowRef(null);
|
||||
|
||||
/** @param {?object} next A fresh presentation; every publish re-renders. */
|
||||
function publish(next) {
|
||||
view.value = next && markRaw(next);
|
||||
}
|
||||
|
||||
const { connect, detach, act } = createOwners();
|
||||
|
||||
return { view, publish, connect, detach, act };
|
||||
});
|
||||
@@ -1952,6 +1952,61 @@ html:not([lang='en']) .cockpit-brief-tabs button {
|
||||
color: #fff;
|
||||
outline: none;
|
||||
}
|
||||
/* The LIVE tab is in the markup whether or not a stream is on offer. */
|
||||
.cockpit-brief-tabs button[hidden] {
|
||||
display: none;
|
||||
}
|
||||
|
||||
/* The briefing's LIVE page: the LIVE section's parts (live.css) in the
|
||||
card's measure. */
|
||||
.cockpit-live-subject {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 6px;
|
||||
color: #fff;
|
||||
font-size: 9px;
|
||||
letter-spacing: 0.1em;
|
||||
}
|
||||
.cockpit-live-subject strong {
|
||||
overflow: hidden;
|
||||
font-weight: 500;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
}
|
||||
.cockpit-live-subject .live-badge {
|
||||
flex: none;
|
||||
font-size: 7px;
|
||||
}
|
||||
.cockpit-live-pick {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 5px;
|
||||
margin: 5px 0 6px;
|
||||
}
|
||||
.cockpit-live-pick .live-stream-title {
|
||||
font-size: 8px;
|
||||
}
|
||||
.cockpit-live-pick .live-step .material-symbols-outlined {
|
||||
font-size: 14px;
|
||||
}
|
||||
.cockpit-live-status {
|
||||
margin: 5px 0 0;
|
||||
color: rgba(244, 251, 255, 0.7);
|
||||
font-size: 7px;
|
||||
letter-spacing: 0.1em;
|
||||
text-transform: uppercase;
|
||||
}
|
||||
.cockpit-live-credit {
|
||||
margin: 4px 0 0;
|
||||
color: rgba(182, 226, 241, 0.72);
|
||||
font: 600 7px/1.2 var(--font-mono);
|
||||
letter-spacing: 0.08em;
|
||||
text-transform: uppercase;
|
||||
}
|
||||
.cockpit-live-credit a {
|
||||
color: inherit;
|
||||
}
|
||||
.cockpit-signal-window[data-layout-mode='rail-right-constrained'] {
|
||||
gap: 5px;
|
||||
}
|
||||
|
||||
@@ -482,6 +482,21 @@
|
||||
color: #fff;
|
||||
outline: none;
|
||||
}
|
||||
/* A station view's arrows either side of its name. */
|
||||
.cockpit-orbital-views .cockpit-orbital-look-readout {
|
||||
flex: 1;
|
||||
text-align: center;
|
||||
}
|
||||
.cockpit-orbital-view-step {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 1px 4px;
|
||||
line-height: 1;
|
||||
}
|
||||
.cockpit-orbital-view-step .material-symbols-outlined {
|
||||
font-size: 18px;
|
||||
}
|
||||
|
||||
/* The Cockpit HUD in orbit (#cockpit-hud[data-subject='satellite']): the
|
||||
orbital readout names the satellite, so the topline keeps only the
|
||||
|
||||
@@ -1,150 +0,0 @@
|
||||
/* NASA's ISS live video while the ISS is selected (src/layers/satellites/issLive.js).
|
||||
The project's floating video window: the Québec CCTV player's `qci-` look
|
||||
(quebecCctvOverlay.css), draggable by its header. Only its starting place
|
||||
and the iframe's details are set here: bottom right, above the timeline,
|
||||
300 px wide so it clears the right rail. */
|
||||
.qci-panel.iss-live-panel {
|
||||
top: auto;
|
||||
right: 16px;
|
||||
bottom: 96px;
|
||||
width: min(300px, calc(100vw - 32px));
|
||||
}
|
||||
|
||||
.iss-live-title {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.iss-live-dot {
|
||||
width: 7px;
|
||||
height: 7px;
|
||||
border-radius: 50%;
|
||||
background: #ff4444;
|
||||
box-shadow: 0 0 6px #ff4444;
|
||||
}
|
||||
|
||||
.iss-live-panel .qci-live {
|
||||
border: 0;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
|
||||
/* The ISS command panel (src/layers/satellites/issCommand.js): the same
|
||||
floating window, bottom left, collapsed to its header until opened. */
|
||||
.qci-panel.iss-command-panel {
|
||||
top: auto;
|
||||
right: auto;
|
||||
left: 16px;
|
||||
bottom: 96px;
|
||||
width: min(250px, calc(100vw - 32px));
|
||||
}
|
||||
|
||||
.iss-command-title {
|
||||
min-width: 0;
|
||||
letter-spacing: 0.06em;
|
||||
}
|
||||
|
||||
.iss-command-body {
|
||||
max-height: calc(100vh - 230px);
|
||||
overflow-y: auto;
|
||||
padding: 8px 10px 10px;
|
||||
}
|
||||
|
||||
.iss-command-body[hidden],
|
||||
.iss-command-manual[hidden],
|
||||
.iss-command-panel .qci-note[hidden] {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.iss-command-modes {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: 6px;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
|
||||
.iss-command-mode,
|
||||
.iss-command-button {
|
||||
padding: 5px 7px;
|
||||
border: 1px solid #2a5d78;
|
||||
border-radius: 5px;
|
||||
background: #12283a;
|
||||
color: inherit;
|
||||
font: inherit;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.iss-command-mode.is-active,
|
||||
.iss-command-button.is-active {
|
||||
border-color: #3eabbc;
|
||||
background: #1b4a5c;
|
||||
}
|
||||
|
||||
.iss-command-mode:focus-visible,
|
||||
.iss-command-button:focus-visible,
|
||||
.iss-command-slider input:focus-visible {
|
||||
outline: 2px solid #7fe3f3;
|
||||
outline-offset: 1px;
|
||||
}
|
||||
|
||||
.iss-command-panel .qci-note {
|
||||
margin: 6px 0 0;
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
.iss-command-group {
|
||||
margin-top: 10px;
|
||||
}
|
||||
|
||||
.iss-command-label {
|
||||
margin-bottom: 4px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.iss-command-row {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 4px;
|
||||
}
|
||||
|
||||
.iss-command-sliders {
|
||||
flex-direction: column;
|
||||
flex-wrap: nowrap;
|
||||
}
|
||||
|
||||
.iss-command-slider {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
}
|
||||
|
||||
.iss-command-slider span {
|
||||
flex: 0 0 96px;
|
||||
}
|
||||
|
||||
.iss-command-slider input {
|
||||
flex: 1;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.iss-command-zoom {
|
||||
display: block;
|
||||
width: 100%;
|
||||
margin-bottom: 8px;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.iss-command-zoom[hidden] {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.iss-command-status {
|
||||
margin: 0 0 4px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.iss-command-status[hidden],
|
||||
.iss-command-status:empty {
|
||||
display: none;
|
||||
}
|
||||
@@ -0,0 +1,202 @@
|
||||
/* The LIVE section inside Context: a live stream in the platform's player. */
|
||||
|
||||
#live-panel[hidden] {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
/* A section inside Context, laid out as the Radio section is: its +/-
|
||||
hides and shows the body, and it goes with the Context panel. */
|
||||
#live-panel {
|
||||
position: relative;
|
||||
width: 100%;
|
||||
min-height: 0;
|
||||
margin-top: 10px;
|
||||
padding-top: 10px;
|
||||
border-top: 1px solid rgba(65, 220, 231, 0.16);
|
||||
}
|
||||
.live-panel-inner {
|
||||
position: relative;
|
||||
display: flex;
|
||||
min-height: 0;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
padding: 10px;
|
||||
border: 1px solid rgba(65, 220, 231, 0.18);
|
||||
border-radius: 8px;
|
||||
background: rgba(2, 15, 20, 0.42);
|
||||
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.035);
|
||||
}
|
||||
#live-panel .panel-header {
|
||||
margin-bottom: 0;
|
||||
}
|
||||
#right-context-rail #global-context-panel:not(.collapsed) #live-panel {
|
||||
flex: 0 0 auto;
|
||||
}
|
||||
#live-panel.collapsed .live-panel-inner > :not(.panel-header),
|
||||
#global-context-panel.collapsed #live-panel {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
.live-badge {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
font-size: 10px;
|
||||
letter-spacing: 0.12em;
|
||||
}
|
||||
.live-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
border-radius: 50%;
|
||||
background: rgba(255, 255, 255, 0.28);
|
||||
box-shadow: none;
|
||||
flex: none;
|
||||
}
|
||||
.live-dot.waiting {
|
||||
background: #ffb547;
|
||||
}
|
||||
.live-dot.on-air {
|
||||
background: #ff3b3b;
|
||||
box-shadow: 0 0 6px rgba(255, 59, 59, 0.9);
|
||||
animation: live-blink 1.2s ease-in-out infinite;
|
||||
}
|
||||
@keyframes live-blink {
|
||||
0%,
|
||||
100% {
|
||||
opacity: 1;
|
||||
}
|
||||
50% {
|
||||
opacity: 0.25;
|
||||
}
|
||||
}
|
||||
@media (prefers-reduced-motion: reduce) {
|
||||
.live-dot.on-air {
|
||||
animation: none;
|
||||
}
|
||||
}
|
||||
|
||||
.live-subject {
|
||||
font-size: 11px;
|
||||
letter-spacing: 0.08em;
|
||||
opacity: 0.85;
|
||||
margin: 2px 0 6px;
|
||||
}
|
||||
.live-pick {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
.live-stream-title {
|
||||
flex: 1;
|
||||
text-align: center;
|
||||
font-size: 11px;
|
||||
font-weight: 700;
|
||||
letter-spacing: 0.06em;
|
||||
}
|
||||
.live-stream-title small {
|
||||
font-weight: 400;
|
||||
opacity: 0.7;
|
||||
}
|
||||
.live-step {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 1px 4px;
|
||||
border: 1px solid rgba(255, 255, 255, 0.25);
|
||||
border-radius: 2px;
|
||||
background: rgba(0, 7, 12, 0.6);
|
||||
color: inherit;
|
||||
cursor: pointer;
|
||||
line-height: 1;
|
||||
}
|
||||
.live-step .material-symbols-outlined {
|
||||
font-size: 18px;
|
||||
}
|
||||
.live-step:hover,
|
||||
.live-step:focus-visible {
|
||||
border-color: var(--cockpit-accent, #00dcff);
|
||||
outline: none;
|
||||
}
|
||||
|
||||
/* The screen keeps a 16:9 box whether a player is in it or not. */
|
||||
.live-screen {
|
||||
position: relative;
|
||||
width: 100%;
|
||||
aspect-ratio: 16 / 9;
|
||||
background: #000;
|
||||
border: 1px solid rgba(255, 255, 255, 0.18);
|
||||
border-radius: 2px;
|
||||
overflow: hidden;
|
||||
}
|
||||
.live-player-host,
|
||||
.live-player-host iframe {
|
||||
position: absolute;
|
||||
inset: 0;
|
||||
width: 100%;
|
||||
height: 100%;
|
||||
border: 0;
|
||||
}
|
||||
.live-screen:not(.active) .live-player-host {
|
||||
display: none;
|
||||
}
|
||||
.live-card {
|
||||
position: absolute;
|
||||
inset: 0;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: 8px;
|
||||
padding: 12px;
|
||||
text-align: center;
|
||||
font-size: 11px;
|
||||
letter-spacing: 0.08em;
|
||||
background:
|
||||
radial-gradient(
|
||||
circle at 50% 40%,
|
||||
rgba(0, 220, 255, 0.08),
|
||||
transparent 60%
|
||||
),
|
||||
#050a0f;
|
||||
}
|
||||
.live-card-dot {
|
||||
width: 10px;
|
||||
height: 10px;
|
||||
border-radius: 50%;
|
||||
background: rgba(255, 255, 255, 0.3);
|
||||
}
|
||||
.live-card.offline .live-card-dot {
|
||||
background: #ff3b3b;
|
||||
opacity: 0.6;
|
||||
}
|
||||
.live-card button {
|
||||
padding: 3px 10px;
|
||||
border: 1px solid rgba(255, 255, 255, 0.35);
|
||||
border-radius: 2px;
|
||||
background: rgba(0, 7, 12, 0.7);
|
||||
color: #f4fbff;
|
||||
font: inherit;
|
||||
letter-spacing: 0.12em;
|
||||
cursor: pointer;
|
||||
}
|
||||
.live-card button:hover,
|
||||
.live-card button:focus-visible {
|
||||
border-color: var(--cockpit-accent, #00dcff);
|
||||
outline: none;
|
||||
}
|
||||
|
||||
.live-status {
|
||||
margin: 6px 0 0;
|
||||
font-size: 11px;
|
||||
opacity: 0.85;
|
||||
}
|
||||
.live-credit,
|
||||
.live-privacy {
|
||||
margin: 6px 0 0;
|
||||
font-size: 10px;
|
||||
opacity: 0.75;
|
||||
}
|
||||
.live-credit a {
|
||||
color: inherit;
|
||||
}
|
||||
@@ -0,0 +1,147 @@
|
||||
/* The STATION section inside Context: a space station's moving parts. */
|
||||
|
||||
#station-panel[hidden] {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
/* A section inside Context, laid out as the Radio section is: its +/-
|
||||
hides and shows the body, and it goes with the Context panel. */
|
||||
#station-panel {
|
||||
position: relative;
|
||||
width: 100%;
|
||||
min-height: 0;
|
||||
margin-top: 10px;
|
||||
padding-top: 10px;
|
||||
border-top: 1px solid rgba(65, 220, 231, 0.16);
|
||||
}
|
||||
.station-panel-inner {
|
||||
position: relative;
|
||||
display: flex;
|
||||
min-height: 0;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
padding: 10px;
|
||||
border: 1px solid rgba(65, 220, 231, 0.18);
|
||||
border-radius: 8px;
|
||||
background: rgba(2, 15, 20, 0.42);
|
||||
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.035);
|
||||
}
|
||||
#station-panel .panel-header {
|
||||
margin-bottom: 0;
|
||||
}
|
||||
#right-context-rail #global-context-panel:not(.collapsed) #station-panel {
|
||||
flex: 0 0 auto;
|
||||
}
|
||||
#station-panel.collapsed .station-panel-inner > :not(.panel-header),
|
||||
#global-context-panel.collapsed #station-panel {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
.station-badge {
|
||||
font-size: 10px;
|
||||
letter-spacing: 0.12em;
|
||||
}
|
||||
.station-subject {
|
||||
font-size: 11px;
|
||||
letter-spacing: 0.08em;
|
||||
opacity: 0.85;
|
||||
margin: 2px 0 8px;
|
||||
}
|
||||
.station-modes {
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
.station-mode,
|
||||
.station-button {
|
||||
padding: 3px 10px;
|
||||
border: 1px solid rgba(255, 255, 255, 0.3);
|
||||
border-radius: 2px;
|
||||
background: rgba(0, 7, 12, 0.6);
|
||||
color: #f4fbff;
|
||||
font: inherit;
|
||||
font-size: 10px;
|
||||
letter-spacing: 0.12em;
|
||||
cursor: pointer;
|
||||
}
|
||||
.station-mode {
|
||||
flex: 1;
|
||||
font-weight: 700;
|
||||
}
|
||||
.station-mode.is-active,
|
||||
.station-button.is-active {
|
||||
border-color: var(--cockpit-accent, #00dcff);
|
||||
color: var(--cockpit-accent, #00dcff);
|
||||
}
|
||||
.station-mode:focus-visible,
|
||||
.station-button:focus-visible {
|
||||
outline: 1px solid var(--cockpit-accent, #00dcff);
|
||||
outline-offset: 1px;
|
||||
}
|
||||
|
||||
.station-telemetry {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
margin: 0 0 6px;
|
||||
font-size: 11px;
|
||||
letter-spacing: 0.04em;
|
||||
}
|
||||
.station-telemetry-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
border-radius: 50%;
|
||||
background: rgba(255, 255, 255, 0.3);
|
||||
flex: none;
|
||||
}
|
||||
.station-telemetry[data-tone='live'] .station-telemetry-dot {
|
||||
background: #3bff7a;
|
||||
box-shadow: 0 0 6px rgba(59, 255, 122, 0.8);
|
||||
}
|
||||
.station-telemetry[data-tone='waiting'] .station-telemetry-dot {
|
||||
background: #ffb547;
|
||||
}
|
||||
.station-telemetry[data-tone='manual'] .station-telemetry-dot {
|
||||
background: var(--cockpit-accent, #00dcff);
|
||||
}
|
||||
.station-note {
|
||||
margin: 0 0 6px;
|
||||
font-size: 10px;
|
||||
opacity: 0.75;
|
||||
}
|
||||
|
||||
.station-group {
|
||||
margin: 8px 0 0;
|
||||
padding-top: 8px;
|
||||
border-top: 1px solid rgba(255, 255, 255, 0.12);
|
||||
}
|
||||
.station-label {
|
||||
font-size: 10px;
|
||||
letter-spacing: 0.12em;
|
||||
opacity: 0.85;
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
.station-row {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 4px;
|
||||
}
|
||||
.station-sliders {
|
||||
display: grid;
|
||||
gap: 4px;
|
||||
}
|
||||
.station-slider {
|
||||
display: grid;
|
||||
grid-template-columns: 7em 1fr 3.5em;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
font-size: 10px;
|
||||
}
|
||||
.station-slider output {
|
||||
text-align: right;
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
.station-zoom {
|
||||
margin-top: 8px;
|
||||
width: 100%;
|
||||
}
|
||||
@@ -23,8 +23,14 @@ import CockpitUtilityControls from './panels/CockpitUtilityControls.vue';
|
||||
// does, they show the state they start in. The controller also publishes
|
||||
// which surfaces are shown and the utility strip's measured layout; the
|
||||
// layout pass stays with it, and the controls keep its listeners.
|
||||
const { presence, instruments, route, vision, utilityLayout } =
|
||||
storeToRefs(useCockpitStore());
|
||||
const {
|
||||
presence,
|
||||
instruments,
|
||||
route,
|
||||
vision,
|
||||
utilityLayout,
|
||||
orbital: orbitalView,
|
||||
} = storeToRefs(useCockpitStore());
|
||||
const active = computed(() => Boolean(presence.value?.active));
|
||||
// A vessel subject swaps the aviation readouts for bridge ones.
|
||||
const bridge = computed(() => presence.value?.subjectKind === 'vessel');
|
||||
@@ -34,6 +40,9 @@ const orbital = computed(() => presence.value?.subjectKind === 'satellite');
|
||||
// window view whose readouts, labels and texts the provider words.
|
||||
const generic = computed(() => presence.value?.subjectGeneric === true);
|
||||
const labels = computed(() => presence.value?.subjectLabels ?? null);
|
||||
// The station is ridden from a mount on its 3D model: the arrows look about
|
||||
// it and Home returns to it, where the nadir picture tilts and returns to nadir.
|
||||
const stationView = computed(() => (orbitalView.value?.mount ?? null) !== null);
|
||||
const subject = computed(() =>
|
||||
generic.value
|
||||
? presence.value.subjectKind
|
||||
@@ -314,7 +323,7 @@ const tickStyle = (tick) =>
|
||||
<CockpitRadar />
|
||||
</div>
|
||||
<CockpitUtilityControls />
|
||||
<div class="cockpit-help"><bdi>{{ t('ESC EXIT') }}</bdi><template v-if="looks"> <span>·</span> <bdi>{{ t('ARROWS LOOK') }}</bdi> <span>·</span> <bdi>{{ t('HOME RESET') }}</bdi></template><template v-if="orbital"> <span>·</span> <bdi>{{ t('+/− ZOOM') }}</bdi> <span>·</span> <bdi>{{ t('ARROWS TILT') }}</bdi> <span>·</span> <bdi>{{ t('HOME NADIR') }}</bdi></template></div>
|
||||
<div class="cockpit-help"><bdi>{{ t('ESC EXIT') }}</bdi><template v-if="looks"> <span>·</span> <bdi>{{ t('ARROWS LOOK') }}</bdi> <span>·</span> <bdi>{{ t('HOME RESET') }}</bdi></template><template v-if="orbital"> <span>·</span> <bdi>{{ t('+/− ZOOM') }}</bdi> <span>·</span> <template v-if="stationView"><bdi>{{ t('ARROWS LOOK') }}</bdi> <span>·</span> <bdi>{{ t('HOME RESET') }}</bdi></template><template v-else><bdi>{{ t('ARROWS TILT') }}</bdi> <span>·</span> <bdi>{{ t('HOME NADIR') }}</bdi></template></template></div>
|
||||
</section>
|
||||
|
||||
<nav id="view-switcher" :aria-label="t('View switcher')">
|
||||
|
||||
@@ -12,7 +12,9 @@ import AwarenessPanel from './panels/AwarenessPanel.vue';
|
||||
import BhoteKoshiPanel from './panels/BhoteKoshiPanel.vue';
|
||||
import MissionDetail from './panels/MissionDetail.vue';
|
||||
import MissionRoster from './panels/MissionRoster.vue';
|
||||
import LivePanel from './panels/LivePanel.vue';
|
||||
import RadioPanel from './panels/RadioPanel.vue';
|
||||
import StationPanel from './panels/StationPanel.vue';
|
||||
import UiButton from '../kit/UiButton.vue';
|
||||
import { cockpitEntryFace } from '../cockpitPresentation.js';
|
||||
|
||||
@@ -79,6 +81,8 @@ const sceneRuntime = computed(() => scenePanel.value?.runtime ?? '');
|
||||
<MissionDetail />
|
||||
</div>
|
||||
</section>
|
||||
<StationPanel />
|
||||
<LivePanel />
|
||||
<RadioPanel />
|
||||
</div>
|
||||
</RailPanel>
|
||||
|
||||
@@ -4,6 +4,8 @@ import { computed, useTemplateRef } from 'vue';
|
||||
import { t } from '../../../i18n/index.js';
|
||||
import { createBriefState } from '../../cockpitBriefPages.js';
|
||||
import { useCockpitStore } from '../../stores/cockpit.js';
|
||||
import { useLiveStore } from '../../stores/live.js';
|
||||
import CockpitLivePage from './CockpitLivePage.vue';
|
||||
import CockpitRoute from './CockpitRoute.vue';
|
||||
import CockpitSignalList from './CockpitSignalList.vue';
|
||||
import UiButton from '../../kit/UiButton.vue';
|
||||
@@ -11,8 +13,11 @@ import UiButton from '../../kit/UiButton.vue';
|
||||
// The Cockpit briefing card. The Cockpit controller presents its pages,
|
||||
// cycle toggle, regional news and local conditions; until it does, the card
|
||||
// shows the state it starts in. The controls keep the controller's
|
||||
// listeners. The route card and the signal rows render themselves.
|
||||
// listeners. The route card, the signal rows and the LIVE page render
|
||||
// themselves; the LIVE page and its tab are there only while the subject has
|
||||
// a stream (the live store's view), which the controller is told of.
|
||||
const { presence, brief } = storeToRefs(useCockpitStore());
|
||||
const { view: live } = storeToRefs(useLiveStore());
|
||||
const initial = createBriefState();
|
||||
const b = computed(() => brief.value ?? initial);
|
||||
// The card's collapse, which its toggle and data-collapsed show.
|
||||
@@ -79,6 +84,9 @@ function leaveSignals() {
|
||||
</div>
|
||||
<a class="cockpit-weather-credit" href="https://open-meteo.com/" target="_blank" rel="noopener">{{ t('Weather data by Open-Meteo.com') }}</a>
|
||||
</section>
|
||||
<section data-cockpit-brief-page="live" :aria-label="t('Live video')" :hidden="b.pageId !== 'live'">
|
||||
<CockpitLivePage v-if="live" />
|
||||
</section>
|
||||
</div>
|
||||
<footer class="cockpit-signal-footer">
|
||||
<span id="cockpit-brief-source">{{ b.source }}</span>
|
||||
@@ -86,6 +94,8 @@ function leaveSignals() {
|
||||
<button type="button" data-cockpit-brief-index="0" :aria-label="t('Show Live Signals')" :aria-current="String(b.pageIndex === 0)">{{ t('SIG') }}</button>
|
||||
<button type="button" data-cockpit-brief-index="1" :aria-label="t('Show Regional News')" :aria-current="brief ? String(b.pageIndex === 1) : undefined">{{ t('NEWS') }}</button>
|
||||
<button type="button" data-cockpit-brief-index="2" :aria-label="t('Show Local Info')" :aria-current="brief ? String(b.pageIndex === 2) : undefined">{{ t('LOCAL') }}</button>
|
||||
<!-- Always in the markup (the controller binds the tabs once); hidden without a stream. -->
|
||||
<button type="button" data-cockpit-brief-index="3" :hidden="!live" :aria-label="t('Show Live Video')" :aria-current="brief ? String(b.pageIndex === 3) : undefined">{{ t('LIVE') }}</button>
|
||||
</nav>
|
||||
</footer>
|
||||
</aside>
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
<script setup>
|
||||
import { t } from '../../../i18n/index.js';
|
||||
import { useLiveScreen } from '../../liveScreen.js';
|
||||
|
||||
// The Cockpit briefing's LIVE page: the LIVE section of Context, in the
|
||||
// card's measure, for the ridden subject's streams. The briefing renders it
|
||||
// only while a stream is on offer. LiveControls builds the player into
|
||||
// `#cockpit-live-player-host` while the Cockpit is on (the right rail, and
|
||||
// the section's screen with it, is hidden there), and the page's controls
|
||||
// call LiveControls through the live store, as the section's do.
|
||||
const {
|
||||
view,
|
||||
act,
|
||||
playing,
|
||||
loading,
|
||||
offline,
|
||||
unavailable,
|
||||
badgeText,
|
||||
statusText,
|
||||
} = useLiveScreen();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<template v-if="view">
|
||||
<div class="cockpit-live-subject">
|
||||
<strong>{{ view.label }}</strong>
|
||||
<span class="live-badge"><span class="live-dot" :class="{ 'on-air': playing, waiting: loading }" aria-hidden="true"></span><span id="cockpit-live-badge-text">{{ badgeText }}</span></span>
|
||||
</div>
|
||||
<div class="cockpit-live-pick" role="group" :aria-label="t('Stream')">
|
||||
<button v-if="view.count > 1" id="cockpit-live-previous" type="button" class="live-step" @click="act('cycleLive', -1)" :aria-label="t('Previous stream')" :title="t('Previous stream')"><span class="material-symbols-outlined" aria-hidden="true">chevron_left</span></button>
|
||||
<span id="cockpit-live-stream-title" class="live-stream-title" aria-live="polite">{{ t(view.current.title) }}<small v-if="view.count > 1"> · {{ view.index + 1 }}/{{ view.count }}</small></span>
|
||||
<button v-if="view.count > 1" id="cockpit-live-next" type="button" class="live-step" @click="act('cycleLive', 1)" :aria-label="t('Next stream')" :title="t('Next stream')"><span class="material-symbols-outlined" aria-hidden="true">chevron_right</span></button>
|
||||
</div>
|
||||
<!-- The player's element stays put across re-renders: LiveControls mounts the player in it. -->
|
||||
<div class="live-screen" :class="{ active: playing || loading }">
|
||||
<div id="cockpit-live-player-host" class="live-player-host"></div>
|
||||
<div v-if="offline || unavailable" class="live-card" :class="{ offline, unavailable }">
|
||||
<span class="live-card-dot" aria-hidden="true"></span>
|
||||
<strong>{{ offline ? t('Stream is offline') : t('This stream cannot play here') }}</strong>
|
||||
<button v-if="offline" id="cockpit-live-retry" type="button" @click="act('retryLive')">{{ t('Try again') }}</button>
|
||||
</div>
|
||||
</div>
|
||||
<p id="cockpit-live-status" class="cockpit-live-status" role="status" aria-live="polite">{{ statusText }}</p>
|
||||
<p class="cockpit-live-credit"><a :href="view.current.ownerUrl" target="_blank" rel="noopener noreferrer">{{ view.current.owner }}</a> · <a id="cockpit-live-watch-link" :href="view.current.watchUrl" target="_blank" rel="noopener noreferrer">{{ t('Open on YouTube') }}</a></p>
|
||||
</template>
|
||||
</template>
|
||||
@@ -220,6 +220,8 @@ const shownMark = computed(() =>
|
||||
const identParts = computed(() => {
|
||||
const o = orbital.value;
|
||||
if (!o) return [];
|
||||
// A module with no catalog entry (the Cupola) shows its facts instead.
|
||||
if (Array.isArray(o.facts) && o.facts.length) return [...o.facts];
|
||||
const parts = [];
|
||||
if (o.noradId !== null && o.noradId !== undefined && o.noradId !== '')
|
||||
parts.push(t('NORAD {id}', { id: String(o.noradId) }));
|
||||
@@ -250,6 +252,11 @@ watch(
|
||||
|
||||
// The off-nadir tilt; an untilted view shows no readout or reset.
|
||||
const look = computed(() => orbital.value?.look || { offset: false });
|
||||
// Riding the station from a mount on its 3D model: the view's name, or null
|
||||
// for the straight-down picture every other satellite has.
|
||||
const mount = computed(() => orbital.value?.mount ?? null);
|
||||
// The station offers several views; with two or more, the arrows step through them.
|
||||
const mountViews = computed(() => orbital.value?.mountViews ?? 0);
|
||||
// A ground focus names its target in a polite live region; the angle,
|
||||
// which changes every update, is left out of it.
|
||||
const focusText = computed(() => {
|
||||
@@ -270,7 +277,8 @@ const lensStyle = computed(() => {
|
||||
<section id="cockpit-orbital" class="cockpit-orbital" :class="{ 'cockpit-orbital-focusing': transition.active }" :style="lensStyle" :aria-label="t('Orbital view')" :hidden="!orbital">
|
||||
<template v-if="orbital">
|
||||
<div class="cockpit-orbital-lens" aria-hidden="true"></div>
|
||||
<div class="cockpit-orbital-reticle" :class="{ 'cockpit-orbital-reticle-lock': transition.lockTick }" aria-hidden="true">
|
||||
<!-- The nadir reticle and its north pointer; a view from the station has no ground point at its centre. -->
|
||||
<div v-if="mount === null" class="cockpit-orbital-reticle" :class="{ 'cockpit-orbital-reticle-lock': transition.lockTick }" aria-hidden="true">
|
||||
<span class="cockpit-orbital-bracket cockpit-orbital-bracket-tl"></span>
|
||||
<span class="cockpit-orbital-bracket cockpit-orbital-bracket-tr"></span>
|
||||
<span class="cockpit-orbital-bracket cockpit-orbital-bracket-bl"></span>
|
||||
@@ -287,7 +295,7 @@ const lensStyle = computed(() => {
|
||||
<!-- Under the vision selector: where the ground track is. -->
|
||||
<p v-if="placeText" id="cockpit-orbital-over" class="cockpit-orbital-over"><span>{{ t('CURRENTLY OVER') }}</span> <strong>{{ placeText }}</strong></p>
|
||||
<div class="cockpit-orbital-readout">
|
||||
<p class="cockpit-orbital-kicker">{{ look.offset ? t('ORBITAL VIEW · OFF-NADIR') : t('ORBITAL VIEW · NADIR') }}</p>
|
||||
<p class="cockpit-orbital-kicker">{{ mount !== null ? t('STATION VIEW · {name}', { name: mount }) : look.offset ? t('ORBITAL VIEW · OFF-NADIR') : t('ORBITAL VIEW · NADIR') }}</p>
|
||||
<div class="cockpit-orbital-title">
|
||||
<span v-if="shownMark?.kind === 'flag'" class="cockpit-orbital-flag" role="img" :aria-label="shownMark.label" :title="shownMark.label" :style="shownMark.style"></span>
|
||||
<span v-else-if="shownMark?.kind === 'badge'" class="cockpit-orbital-owner-badge" :title="shownMark.title">{{ shownMark.label }}</span>
|
||||
@@ -315,11 +323,17 @@ const lensStyle = computed(() => {
|
||||
<dd class="cockpit-orbital-subpoint">{{ subPointText }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
<p class="cockpit-orbital-north">{{ trackUp ? t('TRACK UP') : t('NORTH UP') }}</p>
|
||||
<p v-if="mount === null" class="cockpit-orbital-north">{{ trackUp ? t('TRACK UP') : t('NORTH UP') }}</p>
|
||||
<!-- A station view: which one it is, and the step to the next. -->
|
||||
<div v-if="mount !== null && mountViews > 1" class="cockpit-orbital-look cockpit-orbital-views">
|
||||
<button id="cockpit-orbital-view-previous" type="button" class="cockpit-orbital-nadir cockpit-orbital-view-step" :aria-label="t('Previous station view')" :title="t('Previous station view')"><span class="material-symbols-outlined" aria-hidden="true">chevron_left</span></button>
|
||||
<span id="cockpit-orbital-view-name" class="cockpit-orbital-look-readout" aria-live="polite">{{ mount }}</span>
|
||||
<button id="cockpit-orbital-view-next" type="button" class="cockpit-orbital-nadir cockpit-orbital-view-step" :aria-label="t('Next station view')" :title="t('Next station view')"><span class="material-symbols-outlined" aria-hidden="true">chevron_right</span></button>
|
||||
</div>
|
||||
<!-- Shown only while the view is tilted off nadir: where it looks and the way back. -->
|
||||
<div v-if="look.offset" class="cockpit-orbital-look">
|
||||
<span id="cockpit-orbital-look-readout" class="cockpit-orbital-look-readout" :aria-live="look.focus ? 'off' : 'polite'">{{ look.readout }}</span>
|
||||
<button id="cockpit-orbital-nadir" ref="nadirButton" type="button" class="cockpit-orbital-nadir" :aria-label="t('Return the view to nadir')" :title="t('Return to nadir (Home or 0)')" aria-keyshortcuts="Home 0">{{ t('NADIR') }}</button>
|
||||
<button id="cockpit-orbital-nadir" ref="nadirButton" type="button" class="cockpit-orbital-nadir" :aria-label="mount !== null ? t('Return to the default view') : t('Return the view to nadir')" :title="mount !== null ? t('Return to the default view') : t('Return to nadir (Home or 0)')" aria-keyshortcuts="Home 0">{{ mount !== null ? t('RESET') : t('NADIR') }}</button>
|
||||
</div>
|
||||
<p id="cockpit-orbital-focus" class="cockpit-orbital-focus" aria-live="polite">{{ focusText }}</p>
|
||||
</div>
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
<script setup>
|
||||
import { computed } from 'vue';
|
||||
import { t } from '../../../i18n/index.js';
|
||||
import RailPanel from '../../rail/RailPanel.vue';
|
||||
import { vClassToggle } from '../../rail/classToggle.js';
|
||||
import { useLiveScreen } from '../../liveScreen.js';
|
||||
|
||||
// The LIVE section inside Context: the live streams attached to the selected
|
||||
// object (LiveControls publishes them), one at a time in the platform's own
|
||||
// player. It is there only while the selection has a stream, and the stream
|
||||
// starts as soon as one is chosen (useLiveScreen). The section starts
|
||||
// collapsed; its +/- hides and shows the body, and the player plays on,
|
||||
// muted, underneath. Its controls call LiveControls through the store.
|
||||
const PANEL_ID = 'live-panel';
|
||||
const {
|
||||
view,
|
||||
act,
|
||||
playing,
|
||||
loading,
|
||||
offline,
|
||||
unavailable,
|
||||
badgeText,
|
||||
statusText,
|
||||
} = useLiveScreen();
|
||||
const liveWords = computed(() => ({
|
||||
expandLabel: t('Expand Live section'),
|
||||
collapseLabel: t('Collapse Live section'),
|
||||
expandTitle: t('Expand Live'),
|
||||
collapseTitle: t('Collapse Live'),
|
||||
}));
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<RailPanel :id="PANEL_ID" tag="section" start-collapsed :hidden="!view" v-class-toggle="{ 'live-on-air': playing }" :aria-label="t('Live streams for the selected object')" :title="t('LIVE')" :toggle-words="liveWords" :glow="false" scroll>
|
||||
<template #badge><span class="live-badge"><span class="live-dot" :class="{ 'on-air': playing, waiting: loading }" aria-hidden="true"></span><span id="live-badge-text">{{ badgeText }}</span></span></template>
|
||||
<template v-if="view">
|
||||
<div class="live-subject">{{ view.label }}</div>
|
||||
<div class="live-pick" role="group" :aria-label="t('Stream')">
|
||||
<button v-if="view.count > 1" id="live-previous-btn" type="button" class="live-step" @click="act('cycleLive', -1)" :aria-label="t('Previous stream')" :title="t('Previous stream')"><span class="material-symbols-outlined" aria-hidden="true">chevron_left</span></button>
|
||||
<span id="live-stream-title" class="live-stream-title" aria-live="polite">{{ t(view.current.title) }}<small v-if="view.count > 1"> · {{ view.index + 1 }}/{{ view.count }}</small></span>
|
||||
<button v-if="view.count > 1" id="live-next-btn" type="button" class="live-step" @click="act('cycleLive', 1)" :aria-label="t('Next stream')" :title="t('Next stream')"><span class="material-symbols-outlined" aria-hidden="true">chevron_right</span></button>
|
||||
</div>
|
||||
<!-- The player's element stays put across re-renders: LiveControls mounts the player in it. -->
|
||||
<div class="live-screen" :class="{ active: playing || loading }">
|
||||
<div id="live-player-host" class="live-player-host"></div>
|
||||
<div v-if="offline || unavailable" class="live-card" :class="{ offline, unavailable }">
|
||||
<span class="live-card-dot" aria-hidden="true"></span>
|
||||
<strong>{{ offline ? t('Stream is offline') : t('This stream cannot play here') }}</strong>
|
||||
<button v-if="offline" id="live-retry-btn" type="button" @click="act('retryLive')">{{ t('Try again') }}</button>
|
||||
</div>
|
||||
</div>
|
||||
<p id="live-status" class="live-status" role="status" aria-live="polite">{{ statusText }}</p>
|
||||
<p class="live-credit"><a :href="view.current.ownerUrl" target="_blank" rel="noopener noreferrer">{{ view.current.owner }}</a> · <a id="live-watch-link" :href="view.current.watchUrl" target="_blank" rel="noopener noreferrer">{{ t('Open on YouTube') }}</a></p>
|
||||
<p class="live-privacy">{{ t('Video plays from YouTube, which sees your IP address.') }}</p>
|
||||
</template>
|
||||
</RailPanel>
|
||||
</template>
|
||||
@@ -0,0 +1,108 @@
|
||||
<script setup>
|
||||
import { storeToRefs } from 'pinia';
|
||||
import { computed } from 'vue';
|
||||
import { formatNumber, t } from '../../../i18n/index.js';
|
||||
import RailPanel from '../../rail/RailPanel.vue';
|
||||
import { vClassToggle } from '../../rail/classToggle.js';
|
||||
import UiSlider from '../../kit/UiSlider.js';
|
||||
import { useStationStore } from '../../stores/station.js';
|
||||
|
||||
// The STATION section inside Context: the selected space station's moving
|
||||
// parts. Automatic leaves them to their rules (NASA's telemetry where the
|
||||
// server relays it, computed from the Sun otherwise); Manual hands them to
|
||||
// the person. The satellites layer publishes the view; its controls call
|
||||
// the layer through the store. It is there only while a station is selected.
|
||||
const store = useStationStore();
|
||||
const { act } = store;
|
||||
const { view } = storeToRefs(store);
|
||||
const manual = computed(() => view.value?.mode === 'manual');
|
||||
|
||||
/** A duration as the status line words it. */
|
||||
const ago = (ms) => {
|
||||
if (!Number.isFinite(ms)) return '';
|
||||
const seconds = Math.max(0, Math.round(ms / 1000));
|
||||
return seconds < 90
|
||||
? t('{seconds} s', { seconds: formatNumber(seconds) })
|
||||
: t('{minutes} min', { minutes: formatNumber(Math.round(seconds / 60)) });
|
||||
};
|
||||
const clock = (ms) =>
|
||||
Number.isFinite(ms)
|
||||
? new Date(ms).toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit' })
|
||||
: '';
|
||||
const telemetry = computed(() => view.value?.telemetry ?? null);
|
||||
const telemetryText = computed(() => {
|
||||
const status = telemetry.value;
|
||||
if (!status) return '';
|
||||
if (manual.value) return t('Manual · telemetry paused');
|
||||
switch (status.state) {
|
||||
case 'live':
|
||||
return t('Telemetry · updated {ago} ago', { ago: ago(status.poseAgeMs) });
|
||||
case 'no-signal':
|
||||
return Number.isFinite(status.liveUntilMs)
|
||||
? t('No signal since {time} · computed values', { time: clock(status.liveUntilMs) })
|
||||
: t('No signal · computed values');
|
||||
case 'unavailable':
|
||||
return Number.isFinite(status.poseAgeMs)
|
||||
? t('Telemetry unavailable · last update {ago} ago · computed values', { ago: ago(status.poseAgeMs) })
|
||||
: t('Telemetry unavailable · computed values');
|
||||
case 'disabled':
|
||||
return t('Telemetry not enabled on this server · computed values');
|
||||
case 'none':
|
||||
return t('No public telemetry · computed values');
|
||||
case 'idle':
|
||||
return t('Telemetry reads while the model is on screen');
|
||||
default:
|
||||
return t('Connecting to telemetry…');
|
||||
}
|
||||
});
|
||||
const telemetryTone = computed(() => {
|
||||
if (manual.value) return 'manual';
|
||||
const state = telemetry.value?.state;
|
||||
return state === 'live' ? 'live' : state === 'no-signal' ? 'waiting' : state === 'pending' ? 'waiting' : 'off';
|
||||
});
|
||||
const sunText = computed(() => {
|
||||
const sunlit = view.value?.sunlit;
|
||||
if (sunlit === null || sunlit === undefined) return '';
|
||||
return sunlit ? t('Now: in sunlight') : t("Now: in the Earth's shadow");
|
||||
});
|
||||
const stationWords = computed(() => ({
|
||||
expandLabel: t('Expand Station section'),
|
||||
collapseLabel: t('Collapse Station section'),
|
||||
expandTitle: t('Expand Station'),
|
||||
collapseTitle: t('Collapse Station'),
|
||||
}));
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<RailPanel id="station-panel" tag="section" start-collapsed :hidden="!view" v-class-toggle="{ 'station-manual': manual }" :aria-label="t('Controls for the selected space station')" :title="t('STATION')" :toggle-words="stationWords" :glow="false" scroll>
|
||||
<template #badge><span id="station-badge" class="station-badge">{{ view ? view.title : '' }}</span></template>
|
||||
<template v-if="view">
|
||||
<div class="station-subject">{{ view.subject }}</div>
|
||||
<div class="station-modes" role="radiogroup" :aria-label="t('Mode')">
|
||||
<button id="station-automatic-btn" type="button" role="radio" class="station-mode" :aria-checked="String(!manual)" v-class-toggle="{ 'is-active': !manual }" @click="act('setStationMode', 'automatic')">{{ t('Automatic') }}</button>
|
||||
<button id="station-manual-btn" type="button" role="radio" class="station-mode" :aria-checked="String(manual)" v-class-toggle="{ 'is-active': manual }" @click="act('setStationMode', 'manual')">{{ t('Manual') }}</button>
|
||||
</div>
|
||||
<p id="station-telemetry" class="station-telemetry" :data-tone="telemetryTone" role="status" aria-live="polite"><span class="station-telemetry-dot" aria-hidden="true"></span>{{ telemetryText }}</p>
|
||||
<p v-if="!manual && sunText" id="station-sun" class="station-note">{{ sunText }}</p>
|
||||
<p v-if="!manual && view.note" class="station-note">{{ t(view.note) }}</p>
|
||||
<template v-if="manual">
|
||||
<div v-for="group in view.groups" :key="group.id" class="station-group">
|
||||
<div class="station-label">{{ t(group.label) }}</div>
|
||||
<div v-if="group.kind === 'choices'" class="station-row" role="group" :aria-label="t(group.label)">
|
||||
<button v-for="choice in group.choices" :key="choice.id" type="button" class="station-button" :data-station-choice="`${group.id}:${choice.id}`" v-class-toggle="{ 'is-active': choice.active }" :aria-pressed="String(choice.active)" @click="act('chooseStation', group.id, choice.id)">{{ t(choice.label) }}</button>
|
||||
</div>
|
||||
<div v-else class="station-sliders">
|
||||
<label v-for="slider in group.sliders" :key="slider.id" class="station-slider">
|
||||
<span>{{ t(slider.label) }}</span>
|
||||
<UiSlider :id="`station-slider-${slider.id}`" :min="slider.min" :max="slider.max" :model-value="slider.value" :aria-label="t(slider.label)" @update:model-value="act('slideStation', slider.id, $event)" />
|
||||
<output class="gev-slider-value">{{ formatNumber(slider.value) }}°</output>
|
||||
</label>
|
||||
<button v-if="group.resume" type="button" class="station-button" :data-station-resume="group.id" @click="act('resumeStationArm', group.id)">{{ t(group.resume) }}</button>
|
||||
</div>
|
||||
<p v-if="group.note" class="station-note">{{ t(group.note) }}</p>
|
||||
</div>
|
||||
</template>
|
||||
<button v-if="view.zoom.offered" id="station-zoom-btn" type="button" class="station-button station-zoom" @click="act('zoomStation')">{{ t(view.zoom.label) }}</button>
|
||||
</template>
|
||||
</RailPanel>
|
||||
</template>
|
||||
Reference in new issue
Block a user