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

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

这一切都在'''导出'''(Export)窗口中完成。如果看不到该窗口,请通过菜单'''窗口'''(Window)→ '''导出'''(Export)将其打开。

== 导出前需要完成的准备 ==

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

* 固定装置(Fixtures)已在'''映射'''(Mapping)窗口中摆放好,并已连接到转换器(Converter)端口——cue 文件中的数据正是取自设备的宇宙(universe),未连接到任何端口的固定装置不会被写入文件,参见[[固定装置的地址分配]];
* 项目中存在 '''Light Stream Player''' 设备——cue 文件是针对具体某台播放器生成的;
* 合成已设置好最终的时长和帧率:导出后再修改意味着要重新渲染,参见[[合成设置]];
* 合成的命名要方便之后在 '''Player''' 中查找——合成名称默认会成为文件名;
* 程序已激活:没有许可证时,'''导出'''(Export)窗口中的'''开始'''(Start)按钮不可用,渲染无法启动。

== “导出”窗口 ==

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

{| class="wikitable"
! 列 !! 含义
|-
| '''输出'''(Output) || 复选框:该合成是否会被导出。列标题中的复选框可一次性勾选或取消所有合成。复选框状态会随项目一起保存
|-
| '''名称'''(Name) || 合成的名称。此处不可编辑——重命名合成需要在'''合成'''(Compositions)窗口中按 '''F2''',或通过'''右键''' → '''重命名'''(Rename)
|-
| '''时长'''(Duration) || 合成时长,格式为 ''小时:分钟:秒:帧''
|-
| '''文件名'''(File Name) || 将生成的 cue 文件的名称。默认是合成名称加扩展名 <code>.cue</code>。此字段可编辑:点击后输入自定义名称。自定义名称仅在项目关闭前有效——下次打开项目时,该列会重新显示合成名称
|-
| '''大小'''(Size),MB || cue 文件的大致大小。根据合成时长和占用的宇宙数量计算,因此会随时长或地址分配的变化而变化。如果项目中有多个 '''Light Stream Player''',大小会用逗号分隔列出——每台播放器一个
|-
| '''进度'''(Progress) || 导出过程中该合成的进度条和已渲染帧的编号
|}

左下方显示预览图像:导出过程中,它会播放当前正在渲染的内容——通过它可以立即看到 GIF 预览中会呈现怎样的动画。首次运行前,该位置显示为灰色矩形。

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

{| class="wikitable"
! 元素 !! 作用
|-
| '''导出模式'''(Export Mode) || '''CUE 文件'''(CUE Files)——将合成渲染为 <code>*.cue</code> 文件,供 '''Player''' 使用。'''视频渲染'''(Video Render)——将合成渲染为视频文件
|-
| 齿轮按钮 || 打开程序设置中的'''导出'''(Export)选项卡:GIF 预览、视频和音频参数
|-
| '''选择视图'''(Select View) || GIF 预览和视频画面的来源:'''映射预览'''(Mapping Preview)——'''映射'''(Mapping)窗口的平面图像;'''透视'''(Perspective)——'''3D 视图'''(3D View)窗口的透视摄像机视角;下方列出的是您在项目中添加的摄像机。正视图(顶视图、前视图等)不会出现在此列表中
|-
| '''路径'''(Path) || 文件保存的文件夹。可手动输入,也可通过'''打开'''(Open)按钮选择。路径会随项目保存
|-
| '''开始'''(Start)/'''取消'''(Cancel) || 启动导出;运行期间会变为取消按钮
|}

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

== 导出为 cue 文件 ==

# 打开'''导出'''(Export)窗口,在'''导出模式'''(Export Mode)列表中选择'''CUE 文件'''(CUE Files)。
# 在'''输出'''(Output)列中勾选需要导出的合成。建议取消勾选草稿合成——它们只会延长渲染时间。
# 如有需要,在'''文件名'''(File Name)列中调整文件名称。
# 在'''选择视图'''(Select View)列表中指定 GIF 预览的拍摄来源:'''映射预览'''(Mapping Preview)或'''3D 视图'''(3D View)中的某个摄像机。预览之后会显示在 '''Player''' 界面中,因此请选择物体清晰可辨的视角。
# 在'''路径'''(Path)字段中设置文件夹,或通过'''打开'''(Open)按钮选择。新建项目中已默认填入项目文件旁的 ''Export'' 子文件夹。
# 点击'''开始'''(Start)。

渲染开始。程序中的播放在此期间会暂停,合成会按从上到下的顺序依次渲染,预览图像中会显示当前帧,'''进度'''(Progress)列中会显示已渲染帧的编号。当所有已勾选合成的'''进度'''(Progress)列进度条都填满,且按钮重新显示为'''开始'''(Start)时,导出即完成(此时按钮下方的总进度条会归零)。

无法预先说明这需要多长时间:时间取决于合成的时长、帧率、固定装置数量以及效果的复杂程度。更方便的做法是参考总进度条上的预估时间——它会在过程中不断更新。

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

=== 文件保存位置 ===

* 如果项目中只有一台 '''Light Stream Player''',cue 文件会直接保存到所选文件夹中。
* 如果有多台播放器,文件夹内会创建以播放器名称命名的子文件夹,每个子文件夹中存放各自的一组 cue 文件。这样很方便:之后只需将对应的子文件夹加载到相应的播放器中。

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

=== GIF 预览 ===

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

预览截取自合成的中间部分,其时长、质量和颜色数量在程序设置的'''导出'''(Export)选项卡中设置——通过'''导出模式'''(Export Mode)列表旁的齿轮按钮,进入'''GIF 设置'''(GIF Settings)分组。这些参数的详细说明见[[GIF预览设置]]一文。

从 3D 摄像机拍摄时会被截入预览的区域边界,可以直接在'''3D 视图'''(3D View)窗口中显示:菜单'''视图'''(View)→ '''3D 视图'''(3D View)→ '''显示 3D GIF 边界'''(Show 3D GIF Bounds)(快捷键 '''F5''')。

== 导出为视频文件 ==

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

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

* 文件名取自合成名称,而非'''文件名'''(File Name)列;
* 扩展名取决于所选编解码器;
* 此模式下不会生成 GIF 预览;
* 如果合成的时间轴上有音轨,会被混合进最终视频中。

视频参数在程序设置的'''导出'''(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'''——配置文件级别越高,质量越好,文件也越大
|-
| '''码率'''(Bitrate),Mbit/s || 仅在选择 '''H.264''' 和 '''H.265''' 时出现:每秒视频的数据量。数值越大,画面越清晰,文件也越大
|-
| '''音频编解码器'''(Audio Codec) || '''MP3''' 或 '''AAC'''——用于压缩合成音频的方式
|-
| '''码率'''(Bitrate),Kbit/s || 音质,范围从 32 到 320 Kbit/s
|}

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

== 出现问题时 ==

* '''“开始”(Start)按钮不可用''' ——程序未激活。请输入许可证密钥:没有许可证时导出无法启动。
* '''出现“无写入权限”提示''' ——程序没有写入所选文件夹的权限。请选择其他文件夹,例如“文档”目录下的文件夹。
* '''文件已生成,但播放器上的固定装置不亮''' ——很可能固定装置未连接到转换器端口,或项目中使用的不是正确的 '''Light Stream Player'''。请检查'''固定装置'''(Fixtures)窗口,然后重新导出合成。
* '''播放器预览中显示黑色方块''' ——GIF 是从未对准物体的 3D 摄像机拍摄的,或'''3D 视图'''(3D View)中没有可显示的内容。请选择'''映射预览'''(Mapping Preview)或其他摄像机。
* '''导出的合成比预期短''' ——导出的时长正是合成所设置的时长;超出时间轴边界的效果不会包含在文件中。
* '''导出耗时很长''' ——请降低合成的帧率,或取消勾选当前不需要的合成。

== 另请参阅 ==

* [[合成]]
* [[合成设置]]
* [[GIF预览设置]]
* [[将Cue文件导入Player]]
* [[固定装置的地址分配]]
* [[术语]]