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

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

== 遮罩的用途 ==

遮罩是以像素形式呈现的对象“地图”,与项目坐标一一对应。它最常用于以下场景:

* 作为在第三方编辑器(After Effects、Photoshop、Resolume 等)中制作内容时的底图:绘制在遮罩之上的视频或图片将精确落在真实的固定装置上;
* 作为模板(蒙版):将制作好的视频按遮罩裁剪,使灯光只出现在真正安装了固定装置的位置;
* 作为没有 Light Stream 和项目文件的美术人员或承包商使用的布置示意图;
* 用于检查布置本身是否正确——在遮罩上可以清楚看到遗漏、多余的像素以及不齐的线条。

遮罩的默认尺寸与'''Mapping'''窗口的字段尺寸一致,因此遮罩的一个像素对应项目中的一个像素,无需手动对齐内容与固定装置。

== 如何打开窗口 ==

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

遮罩以纯白色绘制。在预览中,它显示为深色背景上的白色点;而在保存的文件中,背景完全透明——遮罩本身没有颜色,只有白色的固定装置像素。

== 遮罩中包含的内容 ==

* 项目中的所有固定装置和样条,无论是否被选中,也无论当前打开的是哪个合成(Composition)。遮罩描述的是固定装置的布置,而不是动画,因此效果(Effect)、布局(Layout)、背景图片和网格都不会包含在内。
* 在'''固定装置(Fixtures)'''窗口中,'''Enabled'''列复选框未勾选的固定装置和样条不会包含在遮罩中。同样,若某个端口(Port)或转换器(Converter)在同一窗口中的可见性复选框未勾选,则挂载在其上的固定装置也不会包含在内。这是一种方便的方法,可以只导出对象一部分的遮罩:关闭不需要的固定装置、端口或转换器后再导出遮罩即可。
* 尚未绑定到端口的固定装置与其他固定装置一样会包含在遮罩中:对遮罩而言,重要的只是固定装置的位置,而不是它的地址。
* 位于'''Mapping'''字段边界之外的固定装置不会包含在图像中——图像范围受项目尺寸限制。
* '''固定装置(Fixtures)'''和'''样条(Splines)'''复选框可用于选择要绘制的内容:只绘制单个固定装置、只绘制样条,或两者都绘制。

== 窗口参数 ==

{| class="wikitable"
! 参数 !! 说明
|-
| '''Fixtures'''(固定装置) || 在遮罩中绘制单个固定装置。默认启用
|-
| '''Splines'''(样条) || 在遮罩中绘制样条。默认启用
|-
| '''Fixture Size'''(固定装置大小) || 单个固定装置白色圆点的大小。以'''Mapping'''字段的像素为单位设置,默认值为 1。允许使用小数值
|-
| '''Spline Size'''(样条大小) || 样条上固定装置的白色线条粗细(点的大小),以'''Mapping'''字段的像素为单位。默认值为 1
|-
| '''Texture Width'''(纹理宽度) || 保存图像的宽度,以像素为单位。默认等于'''Mapping'''字段的宽度
|-
| '''Texture Height'''(纹理高度) || 保存图像的高度,以像素为单位。默认等于'''Mapping'''字段的高度
|-
| '''X2 Size'''(X2 尺寸) || 将纹理的宽度和高度加倍。只要加倍后两边仍小于 8192 像素,该按钮就可用
|-
| '''1/2 Size'''(1/2 尺寸) || 将纹理的宽度和高度减半
|-
| '''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 Size'''按钮增大纹理。点会随图像一起变大,比例保持不变。
* 如果内容制作时使用的分辨率高于'''Mapping'''字段,应按内容的分辨率导出遮罩——但需为项目尺寸的整数倍,以保证宽高比例不变。
* 只要边长仍小于 8192 像素,就可以使用'''X2 Size'''按钮不断放大遮罩。非常大的遮罩计算耗时更长,占用空间也更大。
* '''Fixture Size'''和'''Spline Size'''的数值以项目像素为单位设置,并随纹理一起变化。只有在需要让点明显大于实际像素间距时(例如,为了得到对象的实心轮廓),才需要单独调大这些值。
* 如果不确定当前的数值是否合适,可以点击'''Reset'''重新开始调整。

== 参见 ==

* [[添加样条和固定装置]]
* [[固定装置的缩放与旋转]]
* [[显示模式概述]]
* [[导出合成]]