查看“导出合成”的源代码

[[ru:Экспорт композиций]] [[en:Exporting Compositions]] [[zh:导出合成]]
导出（Export）是项目工作的最后一步。制作完成的合成（Composition）会被逐帧计算并保存为 <code>*.cue</code> 文件——这些文件之后会被加载到 '''Light Stream Player''' 中，这样对象即使在没有电脑运行的情况下也能发光。在同一窗口中，合成也可以不导出为 cue，而是导出为普通视频文件——用于向客户展示或做演示。

这一切都在 '''导出（Export）''' 窗口中完成。如果看不到该窗口，请在 '''窗口（Window）''' 菜单中启用：'''窗口（Window）''' → '''导出（Export）'''。

== 导出前需要做什么 ==

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

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

== “导出（Export）”窗口 ==

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

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

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

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

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

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

== 导出为 cue 文件 ==

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

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

'''PNG Sequence''' 的帧会保存在导出文件夹内的一个单独文件夹中：该文件夹名称为合成名称加上 ''VideoSequence'' 后缀，内含编号文件 <code>000000.png</code>、<code>000001.png</code> 等。此模式下不会保存声音。

== 如果出现问题 ==

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

== 另请参阅 ==

* [[合成]]
* [[合成设置]]
* [[Настройки GIF превью]]
* [[Импорт cue в Player]]
* [[固定装置的地址分配]]
* [[Терминология]]