查看“导出遮罩”的源代码

[[ru:Экспортирование маски]] [[en:Exporting Mask]] [[zh:导出遮罩]]
固定装置遮罩(Fixture Mask)是一张图像,其中项目中所有固定装置(Fixture)和样条(Spline)的位置,会按照它们在'''映射(Mapping)'''窗口中的实际排列方式以白色标出,其余区域保持透明。Light Stream 可以将这样的遮罩保存为 <code>*.png</code> 文件,以便在其他程序中使用。

== 遮罩的用途 ==

遮罩是您的物体在项目像素中的“地图”。它最常用于以下场景:

* 作为在第三方编辑软件(After Effects、Photoshop、Resolume 等)中制作内容时的底图:在遮罩上绘制的视频或图片将精确对应到实际的固定装置上;
* 作为蒙版(Stencil):按遮罩裁剪成品视频后,灯光只会保留在真正安装了固定装置的位置;
* 作为没有 Light Stream 和项目文件的美术人员或承包商使用的布置图;
* 用于检查排列本身——遮罩上可以清楚地看到缺失、多余像素和不整齐的线条。

遮罩的默认尺寸与'''映射(Mapping)'''区域的尺寸相同,因此遮罩上的一个像素对应项目中的一个像素,无需手动将内容与固定装置对齐。

== 如何打开该窗口 ==

# 在主菜单中选择 ''查看(View) – 导出遮罩(Export Mask)''。
# 将打开'''导出固定装置遮罩(Export Fixture Mask)'''窗口。左侧是保存按钮和参数,右侧是待生成文件的预览。
# 更改任意参数后预览会立即更新,因此在保存之前就能看到结果。

遮罩以纯白色绘制在透明背景上。预览中透明部分以灰色“棋盘格”显示:凡是看起来像棋盘格背景的区域,在保存的文件中都是透明的。

== 哪些内容会进入遮罩 ==

* 项目中所有的固定装置和样条,无论其是否被选中,也无论当前打开的是哪个合成(Composition)。遮罩描述的是固定装置的排列,而不是动画,因此效果(Effect)、布局(Layout)、背景图片和网格都不会包含在遮罩中。
* 已关闭可见性的固定装置不会包含在遮罩中。位于已关闭可见性的端口(Port)或转换器(Converter)中的固定装置同样不会包含在内。这是仅导出物体一部分遮罩的便捷方法:在'''固定装置(Fixtures)'''窗口中关闭不需要的固定装置、端口或转换器的可见性,然后导出遮罩。
* 超出'''映射(Mapping)'''区域边界的固定装置不会包含在图像中——图像的大小受项目尺寸限制。
* '''固定装置(Fixtures)'''和'''样条(Splines)'''复选框可用于选择具体绘制的内容:仅单个固定装置、仅样条,或两者都绘制。

== 窗口参数 ==

{| class="wikitable"
! 参数 !! 说明
|-
| '''固定装置(Fixtures)''' || 在遮罩中绘制单个固定装置。默认开启
|-
| '''样条(Splines)''' || 在遮罩中绘制样条。默认开启
|-
| '''固定装置大小(Fixture Size)''' || 单个固定装置白点的大小。以'''映射(Mapping)'''区域的像素为单位设置,默认值为 1。允许使用小数值
|-
| '''样条大小(Spline Size)''' || 样条上固定装置的白线粗细(点的大小),以'''映射(Mapping)'''区域的像素为单位。默认值为 1
|-
| '''纹理宽度(Texture Width)''' || 保存图像的宽度(像素)。默认等于'''映射(Mapping)'''区域的宽度
|-
| '''纹理高度(Texture Height)''' || 保存图像的高度(像素)。默认等于'''映射(Mapping)'''区域的高度
|-
| '''X2 大小(X2 Size)''' || 将纹理的宽度和高度加倍。只要结果不超过每边 8192 像素,该按钮就可以使用
|-
| '''1/2 大小(1/2 Size)''' || 将纹理的宽度和高度减半
|-
| '''重置(Reset)''' || 将所有参数恢复为默认值,并将纹理大小恢复为当前项目的大小
|}

在调整大小的按钮下方,会以 ''1.00x / 1.00x'' 的形式显示当前纹理与项目大小的比例——宽度和高度分别显示。数值 ''2.00x / 2.00x'' 表示导出的遮罩是项目的两倍大小。请确保两个数值一致:如果两者不同,图像将被拉伸变形,按照这样的遮罩绘制的内容将无法与固定装置对齐。

程序会记住所设置的参数,并在下次打开该窗口时提供这些值。

== 使用预览 ==

可以在不改变文件本身的情况下详细查看预览:

* '''鼠标滚轮''' — 放大或缩小图像;
* '''按住鼠标滚轮''' — 移动图像;
* '''鼠标右键''' — 将缩放比例和位置恢复到初始状态。

放大预览有助于确认固定装置的点没有粘连在一起,样条的线条也没有断开。

== 将遮罩保存为单个文件 ==

# 启用所需的'''固定装置(Fixtures)'''和'''样条(Splines)'''复选框。
# 设置点和纹理的大小,在预览中检查结果。
# 点击'''另存为…(Save As…)'''。
# 指定文件夹和文件名,然后点击'''保存(Save)'''。

遮罩以带透明背景的 <code>*.png</code> 格式保存。预览中显示的所有内容都会保存到同一个文件中。

== 为每个固定装置保存单独的文件 ==

'''保存每一个(Save Each)'''按钮不会导出一张总的遮罩,而是为项目中的每个固定装置和每条样条分别导出一张图像。当需要为物体的每个元素单独制作内容时(例如每条线都有自己的动画),就需要用到此功能。

# 启用'''固定装置(Fixtures)'''和'''样条(Splines)'''复选框——只会导出被勾选的类型。如果两个复选框都未勾选,该按钮将不可用。
# 点击'''保存每一个(Save Each)'''。
# 选择用于存放文件的文件夹,然后点击'''确定(OK)'''。

每个文件都会使用'''固定装置(Fixtures)'''窗口中固定装置或样条的名称,并带有 <code>.png</code> 扩展名。如果文件夹中已存在同名文件,新文件名会附加 <code>-d</code>,因此不会覆盖之前保存的遮罩。所有文件的纹理和点的大小相同,均取自窗口中的字段值,因此各个单独的遮罩能与彼此以及与整体遮罩精确对齐。

为了便于区分文件,请事先在'''固定装置(Fixtures)'''窗口中为固定装置和样条指定清晰易懂的名称。

== 选择遮罩大小 ==

* 对于大多数任务,默认大小已经足够——它等于项目大小,不需要进行任何对齐。
* 如果固定装置数量很多,在遮罩上连成一片,可以用'''X2 大小(X2 Size)'''按钮放大纹理。点会随图像一起变大,比例保持不变。
* 如果内容制作的分辨率高于'''映射(Mapping)'''区域,请按内容的分辨率导出遮罩——但须为项目大小的整数倍,以保持宽高比例不变。
* 边长的最大值为 8192 像素。非常大的遮罩计算耗时更长,占用空间也更多。
* '''固定装置大小(Fixture Size)'''和'''样条大小(Spline Size)'''以项目像素为单位设置,并随纹理一起增大。只有在需要让点明显大于实际像素间距时才单独增大它们——例如,为了得到物体的实心轮廓。
* 如果不确定当前的数值,点击'''重置(Reset)'''重新开始调整。

== 参见 ==

* [[添加样条和固定装置]]
* [[Изменение размера и вращение приборов]]
* [[Описание режимов отображения]]
* [[Экспорт композиций]]