查看“创建自定义固定装置”的源代码

[[ru:Создание пользовательских приборов]] [[en:Creating Custom Fixtures]] [[zh:创建自定义固定装置]]
'''创建自定义固定装置'''是指在软件中为不存在于[[固定装置库]]现成分类中的固定装置，或者实际使用的DMX模式与出厂描述不同的固定装置，编写描述。自定义描述本质上就是把固定装置说明书中的通道表搬进软件：固定装置占用多少个通道、每个通道代表什么，以及固定装置在'''3D视图'''（3D View）窗口中如何发光。

自定义固定装置保存在'''我的固定装置'''（My Fixtures）分类中：只有其中的内容可以修改，出厂分类受写保护。库与软件本身绑定，而不是与工程绑定，因此一旦创建了某个固定装置，它就会在这台电脑上的所有工程中可用。

== 何时需要自定义描述 ==

* 所需型号既不在'''LED固定装置'''（LED Fixtures）分类中，也不在'''制造商'''（Manufacturers）分类中。
* 库中存在该型号，但固定装置本身设置的是另一种DMX模式——通道数量或通道顺序不同。
* 固定装置的颜色通道顺序非标准，使用出厂描述会发出错误的颜色。
* 固定装置的部分通道不应由软件控制。
* 现成描述在通道上是合适的，但固定装置在3D中应以不同方式发光——不同的光束类型或不同的尺寸。

对于普通像素灯带、灯排或灯串，不需要自定义描述：'''LED固定装置'''分类中的标准固定装置就足够了（参见[[固定装置的种类与类型]]）。

== 需要提前了解的内容 ==

描述是根据固定装置说明书编写的，因此开始之前应该了解：

* 固定装置本身设置的是哪种DMX模式——同一型号通常有多种模式；
* 该模式占用多少个通道；
* 每个通道从第一个开始依次代表什么；
* 对于旋转类固定装置——'''Pan'''和'''Tilt'''的旋转角度范围（度）。

如果之后固定装置上的模式发生变化，描述就必须重新制作：软件会完全按照描述中记录的方式读取通道。

== 从零创建固定装置 ==

# 打开'''设置 → 固定装置库'''（Settings → Fixture Library）。
# 选择'''创建 → 固定装置'''（Create → Fixture）。'''我的固定装置'''分类中会出现一个名为'''RGB'''的模板：三个通道——红、绿、蓝——种类为'''像素'''（Pixel）。模板会立即被选中，其描述会在右侧展开，所有字段均可编辑。
# 在右侧面板最上方的字段中设置名称。该名称会显示在库树和固定装置属性中，因此最好让名称能体现出型号和模式，例如''Model 12ch''。
# 在'''3D预览'''（3D Preview）区块中选择'''光束类型'''（Beam Type）和光束尺寸。
# 在下方的'''DMX设置'''（DMX Settings）区块中，设置'''通道数量'''（Channel Count）——数值应与所选DMX模式占用的通道数相同。
# 在通道表中为每个通道设置分配：点击该行，从列表中选择数值。
# 执行'''文件 → 保存库'''（File → Save Library）。库未保存之前，固定装置只存在于打开的窗口中。

现在可以为固定装置分配了：在映射（Mapping）上选中固定装置，点击库窗口右下角的'''选择固定装置'''（Select Fixture）——详见[[固定装置库]]一文。

== 通道 ==

通道表是描述中最主要的部分。'''#'''列中的编号是该通道相对于固定装置地址的偏移量：第一行对应固定装置的地址，第二行对应下一个地址，依此类推。因此行的顺序必须与说明书中通道的顺序完全一致。

分配列表中可以选择的内容：

{| class="wikitable"
! 分配 !! 软件向该通道发送的内容
|-
| '''red'''、'''green'''、'''blue''' || 来自'''映射'''（Mapping）面板上固定装置所在点的红、绿、蓝颜色分量
|-
| '''white min'''、'''white average''' || 白色分量：三个颜色分量中的最小值或平均值
|-
| '''red-min(rgb)'''、'''green-min(rgb)'''、'''blue-min(rgb)''' || 减去白色分量后的颜色分量。用于白色LED代替颜色灰度部分的固定装置，与白色通道一起使用
|-
| '''pan'''、'''tilt'''，以及精细的'''panfine'''、'''tiltfine''' || 旋转固定装置的转动角度
|-
| '''strob'''、'''shuttern'''、'''gobo'''、'''focus'''、'''zoom'''、'''frost'''、'''movementspeed'''、'''reset''' || “智能”固定装置的功能通道。软件本身不会更改它们——数值由'''设置通道数值'''（Set Channel Values）和'''通道动画'''（Channel Animation）效果设置
|-
| '''other'''、'''other 1'''…'''other 10''' || 描述中未说明用途的通道：调光器、宏、色轮选择等
|-
| '''color white 5 bit''' || 个别型号特有的白色通道。普通描述中不使用
|-
| '''Empty''' || 固定装置占用、但软件不会写入任何内容的通道
|}

最容易出错的几条规则：

* '''一个分配对应一个通道。''' 如果描述中有两个通道标记相同（例如两个'''red'''），只有最后一个会收到数据。因此，所有你打算控制的通道都必须使用不同的分配——'''other 1'''…'''other 10'''正是为此而设的。
* '''多余的通道不能跳过。''' 如果固定装置在其模式下占用12个通道，而只需要用到前三个，仍然要把通道数量设为12，其余标记为'''Empty'''——它可以连续标记给任意多行，软件不会向这些通道写入任何内容。否则端口上的下一个固定装置就会占用错误的地址。
* '''增加通道数量会复制最后一个通道。''' 新增的行会重复最后一行的分配，需要重新设置——否则就会出现前面所说的重复通道问题。
* '''减少通道数量会从末尾移除行'''，但其数值会被记住：如果立即把数量改回原值，分配会恢复成之前的样子。

颜色和白色通道的数值由软件逐帧自行计算。其余通道在被效果设置之前保持为零。关于通道的具体含义，以及地址和宇宙（universe）是如何由通道组成的，详见[[固定装置的种类与类型]]。

== 3D预览设置 ==

'''3D预览'''区块只负责固定装置在'''3D视图'''窗口中的外观和发光方式，不影响DMX数据，但决定了预览与真实物体的相似程度。

{| class="wikitable"
! 灯具光束类型 !! 发光方式 !! 尺寸字段 !! 默认值
|-
| '''像素'''（Pixel） || 自身像一个点一样发光；没有光束 || 没有光束尺寸——点本身的大小在3D场景中的固定装置上设置 || —
|-
| '''线性'''（Linear） || 沿灯具主体以宽光束照亮表面 || '''长度'''、'''角度°'''、'''深度''' || 100、30、600
|-
| '''聚光灯'''（Spotlight） || 产生一个定向光锥 || '''角度°'''、'''高度''' || 30、500
|}

切换光束类型时字段集合会立即改变，多余的字段会被隐藏。'''角度°'''是光束的张角，'''深度'''和'''高度'''是光束能照射多远，'''长度'''是灯具主体发光部分的长度。

这些尺寸是新建固定装置的模板值。对于已经放置在3D场景中的固定装置，其光束在其属性中单独设置（参见[[固定装置的种类与类型]]）。

== 固定装置图片 ==

在'''3D预览'''字段旁边会显示固定装置的图片——同一张图片也会作为小图标显示在库树中名称的左侧。自定义固定装置的图片可以替换：点击'''更改图片'''（Change Image）链接，选择'''JPG'''、'''BMP'''、'''GIF'''或'''PNG'''文件。

图片不会内嵌到库中——软件只记住文件路径。选择对话框会直接打开软件存放固定装置图片的文件夹：如果把图片放在那里并且不删除它，重启后图片仍会保留在原位。如果之后移动或删除了该文件，图片会不再显示——这不会影响固定装置的工作。

== 旋转类固定装置 ==

对于带有旋转机构的固定装置，有一个单独的模板：'''创建 → 旋转头'''（Create → Moving Head）。它会以'''Move head'''为名称创建，带有四个旋转通道——'''pan'''、'''panfine'''、'''tilt'''、'''tiltfine'''——并且'''旋转固定装置'''（Moving Fixture）复选框已经勾选，'''Pan'''范围为0–540°，'''Tilt'''范围为0–180°。该模板会添加到'''我的固定装置'''分类的末尾：找到它并选中即可配置。

接下来描述的编写方式与普通固定装置相同：把通道数量调整到该模式的通道数，按说明书排列各通道。如果固定装置没有精细旋转通道，'''panfine'''和'''tiltfine'''行需要重新分配或删除。

'''旋转固定装置'''复选框也可以在普通固定装置上勾选——这样会打开'''Pan 最小值''' / '''最大值'''和'''Tilt 最小值''' / '''最大值'''字段。请在其中填入说明书中固定装置的完整旋转角度范围（度）：'''PAN TILT动画'''（PAN TILT Animation）效果会依据这些值把设定的角度换算成通道数值。如果范围填写错误，固定装置转动的方向就会与效果所显示的不一致。

取消勾选该复选框会从描述中移除旋转范围。如果重新勾选，字段中会恢复取消前的数值；而对于之前从未是旋转固定装置的固定装置，则会是0–540°和0–180°。

== 基于出厂固定装置创建 ==

当所需描述与现成描述几乎相同时，复制比从零编写更快。在任意分类中选中固定装置，点击'''复制到个人库'''（Copy to Personal）——副本会出现在'''我的固定装置'''分类中，名称后加上''Copy''，并立即被选中，随后即可编辑。

这种方式很适合为同一型号的相邻DMX模式制作描述：复制、重命名、调整通道数量和分配。

副本是独立的固定装置，而不是指向原件的引用：对副本的修改不会影响工程中分配了原始描述的固定装置。要让副本在工程中生效，需要用'''选择固定装置'''按钮重新为固定装置分配。

== 保存与应用 ==

在库窗口中所做的一切最初只存在于窗口本身。'''文件 → 保存库'''会固化这些更改。软件也会自行提醒保存：关闭带有未保存修改的窗口时会询问'''保存库？'''（Save Library?）——回答'''否'''会把库恢复到打开窗口时的状态。点击'''选择固定装置'''时，软件同样会在选择前提示保存库。

保存时，新描述会应用到工程中所有已经分配了该固定装置的对象。这在实际中意味着：

* 如果通道数量发生了变化，固定装置会占用不同数量的地址，而端口上相邻固定装置的地址保持不变——从而产生重叠或断档。可以通过在端口上右击、选择'''重新计算固定装置地址'''（Recalculate Fixture Addresses）来重新计算地址，也可以手动设置——参见[[固定装置的地址分配]]；
* 如果通道分配发生了变化，实际物体上呈现的效果也会随之改变——颜色会重新排列；
* 3D场景中固定装置的光束参数会重新从描述中读取。如果你曾在'''3D视图'''窗口中为个别固定装置单独设置过光束，这些设置会恢复为库中固定装置所记录的内容。

只能从'''我的固定装置'''分类中删除自定义固定装置：选中它，按'''Delete'''或'''Backspace'''键，或通过右键菜单选择'''删除'''。软件会要求确认删除。已经分配了该固定装置的工程不会受删除影响：其描述也保存在工程文件内部。

== 如何检验描述 ==

# 把新固定装置分配给映射上的一个固定装置，并将其接入设备端口。在'''固定装置'''（Fixtures）窗口的'''Address'''列中查看下一个固定装置的地址：差值应等于通道数量。
# 在合成中放置一个简单的纯色填充效果并开启'''Art-Net'''。如果固定装置发出的不是红色而是绿色或蓝色，说明颜色通道顺序搞反了。
# 功能通道通过'''设置通道数值'''效果检验：它会按名称显示所选固定装置的各个通道，每个通道通过'''On'''按钮开启，数值通过滑块设置——可以立即看到真实固定装置的反应。
# 旋转通过'''PAN TILT动画'''效果检验：设置极限角度，并与固定装置实际转动的位置进行比较。

== 常见问题 ==

* '''右侧字段是灰色的，无法修改。''' 选中的是受保护分类中的固定装置。只有'''我的固定装置'''中的内容可以编辑：用'''复制到个人库'''按钮把固定装置复制过去。
* '''重启软件后固定装置消失了。''' 库没有被保存。只有'''文件 → 保存库'''，或在关闭窗口时的提示中选择'''是'''，才会固化更改。
* '''其中一个通道没有反应。''' 很可能表中另一行使用了相同的分配。两个分配相同的通道中，只有最后一个会生效。
* '''固定装置本身发光正常，但相邻的却不正常。''' 描述中的通道数量与实际DMX模式不符，导致端口上后续所有固定装置的地址都发生了偏移。请对照说明书核对通道数量，并重新计算地址——在端口上右击，选择'''重新计算固定装置地址'''。
* '''修改了描述，但工程中没有任何变化。''' 更改会在保存库时应用。如果保存后仍然没有变化，说明工程中的固定装置分配的是另一个描述，例如原件而不是副本；请用'''选择固定装置'''按钮分配所需的固定装置。
* '''如何制作同一型号的多个模式。''' 为每个模式单独制作一份描述：复制现成的描述，调整通道数量和分配。建议在名称中加入模式编号，避免选择时混淆。
* '''固定装置需要在另一台电脑上使用。''' 库不会随工程一起转移，但正在使用的固定装置的描述保存在工程文件中：在另一台电脑上打开该工程，在'''项目中使用的'''（Used in Project）分类中找到该固定装置，点击'''复制到个人库'''——它就会进入这台电脑的'''我的固定装置'''中。