时间轴
时间轴为场景创建相机动画,用关键帧定义位置和运动,在编辑器平滑播放。

控件
包含:
- 播放/暂停。
- 上一/下一帧,Shift 点击跳关键帧。
- Add Key(+),当前时间创建。
- Remove Key(-),删除播放头位置关键帧。
- 滑块,拖播放头预览,显示帧号。
- FPS。
- 总帧数。
- Smoothness,0–1 插值平滑度。
- Loop,默认开启,最后平滑回首帧,关闭则停末帧,见循环。
快捷键
可用键盘:
| 按键 | 动作 |
|---|---|
| Space | 播放/暂停 |
, / . | 上一/下一帧 |
< / > | 上一/下一关键帧 |
| Enter | 添加 |
| Shift + Enter | 删除 |
| Ctrl + T,Mac Cmd + T | 切换面板 |
创建关键帧
步骤:
- 点击时间轴或用计数器移到目标帧。
- 调整相机位置与朝向。
- 点击 + 或 Enter。
黄色菱形保存该时刻位置和旋转。
导入相机位姿
可从 COLMAP 或 INRIA JSON 自动生成关键帧,近似复现采集路径。
COLMAP images.txt
步骤:
- 从重建结果取得 images.txt。
- File > Import 或拖入。
- 自动创建关键帧。
按文件顺序放到连续帧,形成原始采集路径。
文件中的 COLMAP 四元数和平移自动转换为适合时间轴的位置朝向。
INRIA 位姿 JSON
接收相机条目数组,每条必须有 position、rotation,可含 id/img_name 排序,以及 fx、fy、width、height 计算 FOV。
Import 或拖入,按 id 或 img_name 末尾数字排序,每条生成一帧。不要命名 meta.json,该名保留给非打包 SOG。
编辑关键帧
可通过以下方式:
调整时间
沿时间轴拖黄色菱形。
复制
Shift 拖动,克隆跟随指针,释放处创建副本,原帧不动。
更新位置旋转
步骤:
- 播放头移到目标关键帧。
- 调整相机。
- 点击
+覆盖已有值。
或 Ctrl 点击菱形直接用当前视图覆盖,无需先移播放头。
删除关键帧
步骤:
- 播放头移到目标。
- 点击 - 或 Shift + Enter。
添加、移动、复制、删除均可 Ctrl + Z 撤销、Ctrl + Shift + Z 重做,Mac 用 Cmd。
可视化相机
右侧 Overlays 开 Camera Poses,在各帧姿态画线框相机,便于检查路径,开关保存到项目。
时间轴设置
FPS
控制播放速度,可选:
- 1 FPS:每秒一帧。
- 6 FPS:低。
- 12 FPS:中。
- 24 FPS:标准电影。
- 30 FPS:常见视频。
- 60 FPS:平滑高帧率。
长度
总帧数定义持续时间和循环位置。
缩短后超范围关键帧保留,但不参与播放插值。标记变暗带错误色,固定在右边缘外,提示原帧号。
拖回范围或增大 Total Frames 可恢复。缩短会把播放头限制到新末端,关键帧导航跳过越界项。删除前先拖回或临时扩长度。
平滑度
范围 0–1:
- 0:线性直线。
- 1:最大平滑、弯曲电影感。
- 中间值:两者混合。
从机械精确到自然流动,可据此塑造动画。
播放
点击播放或 Space,按平滑度插值。默认 Loop 从末帧持续回首帧。
动画循环
平滑度旁 Loop 控制末关键帧之后:
- 开(默认):闭合路径,剩余帧平滑插回首关键帧。
- 关:开放路径,停留末姿态。
开关保存到项目,Camera Poses 路径相应显示闭合或开放。
循环时避免在首尾时间轴帧都设关键帧,否则回环会突然跳动。
最后关键帧应早于末端,留时间插回开始。
例如 100 帧:
- 推荐:0、10、20、30、40、50、60、70、80、90。
- 从 90 平滑回 0。
- 避免:0、10、20、…、90、100。
- 100 回 0 会跳变。
这种方式形成无缝循环。
发布与场景页播放
动画存在于项目中。访客要播放,需发布时开启 Animation,将路径烘焙并设加载播放。Loop Mode 按时间轴初始化,开为 Repeat,关为 None,决定一次或循环。
场景页的 Viewer 自动播放,repeat 可形成无需操作的电影漫游。
动画在编辑器时间轴制作;Studio 只编排相机、标注、后期、天空盒和碰撞。发布设置中的 animTracks(loopMode、interpolation、关键帧)与 startMode 详见体验设置。
保存动画
只有保存 .ssproj 才保留时间轴,PLY 等数据导出不保存它。
参见项目管理。