导出合成

来自Light Stream (CN)
LumiBot讨论 | 贡献2026年9月2日 (三) 19:16的版本 (Перевод с русской вики (задача №977, LS Dev Hub))
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

导出(Export)是项目工作的最后一步。制作完成的合成(Composition)会被逐帧计算并保存为 *.cue 文件——这些文件之后会被加载到 Light Stream Player 中,这样对象即使在没有电脑运行的情况下也能发光。在同一窗口中,合成也可以不导出为 cue,而是导出为普通视频文件——用于向客户展示或做演示。

这一切都在 导出(Export) 窗口中完成。如果看不到该窗口,请在 窗口(Window) 菜单中启用:窗口(Window)导出(Export)

导出前需要做什么

导出只是记录项目中已经设置好的内容,因此在开始之前应检查:

  • 固定装置(Fixtures)已在 映射(Mapping) 窗口中放置好,并已接入转换器(Converter)的端口——cue 文件中的数据取自设备的域(universe),未接入任何端口的固定装置不会写入文件,参见固定装置的地址分配
  • 项目中已有 Light Stream Player 设备——cue 文件是为特定的播放器生成的;
  • 合成已设定好最终的时长和帧率:导出后再修改意味着要重新计算全部内容,参见合成设置
  • 合成已按照方便在 Player 中查找的方式命名——合成名称默认会成为文件名;
  • 软件已激活。没有许可证时导出仍会运行并生成文件,但文件中的数据将是空的。

“导出(Export)”窗口

窗口上半部分是项目中所有合成的列表——顺序与 合成(Compositions) 窗口中一致。

含义
输出(Output) 复选框:该合成是否会被导出。列标题中的复选框可一次性勾选或取消所有合成。复选框状态会随项目一起保存
名称(Name) 合成名称。此处不可编辑——需在 合成(Compositions) 窗口中按 F2 重命名
时长(Duration) 合成时长,格式为“时:分:秒:帧”
文件名(File Name) 未来 cue 文件的名称。默认与合成名称相同。此字段可编辑:点击后输入自己的名称
大小,MB(Size, MB) cue 文件的大致大小。根据合成时长和占用的域(universe)数量计算,因此时长或地址分配变化时会随之改变。如果项目中有多个 Light Stream Player,大小会以逗号分隔列出——每个播放器一个数值
进度(Progress) 导出过程中该合成已计算帧数的进度条和帧号

左下方显示预览图:导出过程中,其中播放的是当前正在计算的内容——通过它可以立即看到哪个动画会出现在 GIF 预览中。在第一次运行之前,此处显示灰色矩形。

预览图右侧是导出设置和启动按钮。

元素 作用
导出模式(Export Mode) CUE 文件 —— 将合成计算为供 Player 使用的 *.cue 文件。视频渲染(Video render) —— 将合成计算为视频文件
齿轮按钮 打开程序设置中的 导出(Export) 选项卡:GIF 预览参数和视频渲染参数
选择视图(Select view) GIF 预览和视频的画面来源:映射预览(Mapping preview) —— 映射(Mapping) 字段的平面图像;列表中的其他项目 —— 来自 3D 预览(3D View) 窗口中摄像机的视图,包括你在项目中创建的摄像机
路径(Path) 文件保存的文件夹。可以手动输入,也可以用 打开(Open) 按钮选择。路径会随项目一起保存
开始(Start) / 取消(Cancel) 启动导出;运行期间会变为取消按钮

导出期间,按钮下方会出现所有已勾选合成的总进度条,其下方是“已用时间 / 预计总时间”格式的时间。同样的总体进度也会同步显示在 Windows 任务栏的程序图标上,因此无需展开窗口即可跟踪导出进度。

导出为 cue 文件

  1. 打开 导出(Export) 窗口,在 导出模式(Export Mode) 列表中选择 CUE 文件
  2. 输出(Output) 列中勾选需要导出的合成。建议取消勾选草稿合成——它们只会延长计算时间。
  3. 如有需要,在 文件名(File Name) 列中调整文件名。
  4. 选择视图(Select view) 列表中指定 GIF 预览的画面来源:映射预览(Mapping preview)3D 预览(3D View) 中的某个摄像机。预览之后会显示在 Player 界面中,因此应选择能清楚识别对象的视图。
  5. 路径(Path) 字段中设置文件夹,或用 打开(Open) 按钮选择。在新建项目中,项目文件旁的 Export 子文件夹已默认填入该处。
  6. 点击 开始(Start)

计算随即开始。程序中的播放会在此期间停止,合成从上到下依次计算,预览图中显示当前帧,进度(Progress) 列显示已计算的帧号。当预览停止移动、进度条已填满、按钮重新变回 开始(Start) 时,导出即完成。

所需时间无法提前预知:具体时长取决于合成的时长、帧率、固定装置数量以及效果的复杂程度。参考总进度条下方的预计时间会更方便——它会随着工作进行而不断更新。

可以用 取消(Cancel) 按钮中断导出:进度会被重置,未计算完的合成需要重新导出。

文件保存位置

  • 如果项目中只有一个 Light Stream Player,cue 文件会直接保存到所选文件夹中。
  • 如果有多个播放器,会在该文件夹中创建以各播放器命名的子文件夹,每个子文件夹中放入该播放器对应的一组 cue 文件。这样一来,之后只需将对应的子文件夹加载到相应播放器即可。

文件不会累积:再次导出时,同名文件的合成会覆盖旧文件。

GIF 预览

每个 cue 文件在写入数据的同时,还会写入一段短小的 GIF 动画。Light Stream Player 在动画列表中显示的正是这段动画,因此无需另外制作和加载预览。

预览取自合成的中间部分,其时长、质量和颜色数量在程序设置的 导出(Export) 选项卡中设置——通过 导出模式(Export Mode) 列表旁的齿轮按钮打开。这些参数在Настройки GIF превью一文中有详细说明。

从 3D 摄像机拍摄时将被截入预览的区域边界,可以直接在 3D 预览(3D View) 窗口中显示:菜单 视图(View)3D 预览(3D View)显示 3D GIF 边界(Show 3D GIF bounds)

导出为视频文件

视频渲染(Video render) 模式记录的不是供固定装置使用的数据,而是画面——与 GIF 预览相同的图像,但分辨率为完整分辨率,并覆盖合成的全部时长。这种文件用于演示和审批,不能加载到 Player 中。

流程与导出 cue 相同:勾选合成、选择视图、设置文件夹、点击 开始(Start)。区别在于:

  • 文件名取自合成名称,而非 文件名(File Name) 列;
  • 扩展名取决于所选编码器;
  • 如果合成的时间线上有音轨,会被混入生成的视频中。

视频参数在程序设置的 导出(Export) 选项卡中设置,分为 视频导出设置(Video Export Settings)音频导出设置(Audio Export Settings) 两组。

参数 取值
宽度(Width)高度(Height) 视频分辨率(像素)
显示合成名称(Show composition name) 将合成名称直接印在画面中——当视频较多时很方便
字体大小(Font size) 该文字的大小
标题位置(Title position) 文字所在的画面角落:左上(Top Left)右上(Top Right)左下(Bottom Left)右下(Bottom Right)
视频编码(Video codec) H.264H.265 (HEVC) —— *.mp4 文件,可在任何设备打开;Apple ProRes —— *.mov 文件,用于剪辑;Lossless AVI —— *.avi 文件,无画质损失但体积很大;PNG Sequence —— 不是视频文件,而是包含单独帧的文件夹
配置文件(Profile) 仅适用于 Apple ProRes:从 ProRes 422 ProxyProRes 4444 XQ —— 配置越高,画质越好,文件也越大
比特率,Mbit/s(Bitrate) 仅适用于 H.264H.265:每秒视频的数据量。数值越大,画面越清晰,文件也越大
音频编码(Audio codec) MP3AAC —— 用于压缩合成声音的编码方式
比特率,Kbit/s(Bitrate) 音质,范围为 32 到 320 Kbit/s

PNG Sequence 的帧会保存在导出文件夹内的一个单独文件夹中:该文件夹名称为合成名称加上 VideoSequence 后缀,内含编号文件 000000.png000001.png 等。此模式下不会保存声音。

如果出现问题

  • 出现“无写入权限”消息 —— 程序没有权限写入所选文件夹。请选择另一个文件夹,例如 文档(Documents) 中的文件夹。
  • 文件已生成,但播放器上的固定装置不发光 —— 很可能是固定装置未接入转换器端口,或项目中的 Light Stream Player 不正确。请检查 固定装置(Fixtures) 窗口,然后重新导出合成。
  • 播放器预览中出现黑色方块 —— GIF 是从一个未对准对象的 3D 摄像机拍摄的,或者 3D 预览(3D View) 中没有可显示的内容。请选择 映射预览(Mapping preview) 或其他摄像机。
  • 导出的合成比预期短 —— 导出的时长严格等于合成设定的时长;时间线上超出该边界的效果不会包含在文件中。
  • 导出耗时很长 —— 降低合成的帧率,或取消勾选当前不需要的合成。

另请参阅