星途 Orbitale｜三维空间轨道浏览与动画制作

API

外部调用Orbitale v1.3.2

通过当前浏览器页面的 window.ztliOrbits 控制视角、时间与逐帧导出。可先在图中调整构图，再读取相机状态。

const api = window.ztliOrbits;
await api.ready();
await api.configure({ view3d: true,
exportOverlays: { orientation: false, timestamp: false, branding: false }, display: {
  spacecraftNames: false, bodyNames: false,
  cycleTracks: true, intervalTracks: false
}});
// Fine movement in viewBox pixels
await api.drag({ dx: 0.2, dy: -0.1 });
// Smooth zoom over 2.5 seconds
await api.zoomTo(api.getState().camera.zoom / 2,
  { duration: 2500, easing: 'smooth' });
// PNG of the current view
const png = await api.captureFrame();

镜头路径与逐帧导出

先选择所需目标和有星历覆盖的时段。下面的镜头缓慢拉远，先慢后快地推进观测时间，最后停留。相机路径和时间进度可分别设置。每帧渲染完成后再编码，不受实时播放速度影响。

const api = window.ztliOrbits;
await api.ready();
const state = await api.configure({ view3d: true });
const start = Date.parse(state.at);
const end = start + 20 * 60 * 1000;
const near = state.camera;
const far = { ...near, zoom: near.zoom / 8 };
const run = await api.prepareTimeline({
  start, end, fps: 30, frames: 600, width: 1920, height: 1080,
  mode: 'fixed', interpolation: 'smooth',
  keyframes: [
    { progress: 0, camera: near },
    { progress: 0.8, camera: far },
    { progress: 1, camera: far }
  ],
  timeKeyframes: [
    { progress: 0, at: start },
    { progress: 0.2, at: start + 20 * 1000 },
    { progress: 0.8, at: end },
    { progress: 1, at: end }
  ]
});
// Optional live preview: await api.playTimeline();
// Stop preview before exporting: await api.pauseTimeline();
await api.startExport({ chunkFrames: 300 });
// api.getExportStatus(), pauseExport(), resumeExport()
const result = await api.waitExport();
// result.files contains downloadable local MP4 URLs
await api.finish();

API v1.3 · 最多 3 个探测器，1–60 FPS。cameraLookAt({ eye, target, up }) 可直接设置观察点、目标与向上方向，坐标采用当前参考系，单位 AU。支持固定画幅、纯画面和 MP4 分段导出；兼容浏览器可通过 WebMCP 调用。本接口仅用于当前页面，不是远程服务器接口。

使用说明与数据来源

时间均为 UTC。应用时间范围后可拖动进度条浏览；跳转到指定时刻会暂停播放。动画可涵盖最多 5 年，以可用星历为准。

3D 模式下拖动以旋转，滚轮或双指缩放；平移按钮可切换为移动画布。缩放中心默认为鼠标位置。

绕日一圈（星历可用时）。单圈轨道随目标时刻更新；所选时段轨迹可单独开关。夹角结果为所选参考中心下的三维夹角，或黄道面上的经度差。切换目标、时间或参考方式会保留查询，也可手动记录，当前标签页内最多保留 5 条。

NASA/JPL Horizons 提供主要星历；部分近地任务采用轨道根数传播或地心近似，以所选目标的数据说明为准。

影像来源

NASA/SVS · Deep Star Maps 2020
Yale · Bright Star Catalogue
NASA · Blue Marble Next Generation
NASA/SVS · CGI Moon Kit · Ernie Wright
NASA GIBS · NOAA-20 / VIIRS

地表采用 2004 年观测合成，近景按需载入更细的贴图；独立静态云层和大气光晕用于外观展示，并非当前天气。可切换每日观测图，分辨率较低。月球采用 LRO 月面影像与实际半径，自转、月相与昼夜随时间变化。太阳光晕为轻微光学效果。夸父一号与羲和号模型按外观简化并放大，朝日姿态为示意。

使用说明