查看“固定装置的地址分配”的源代码

[[ru:Патчинг приборов]] [[en:Patching Fixtures]] [[zh:固定装置的地址分配]]
'''地址分配（Patching）'''是将项目中的固定装置（Fixtures）与设备端口（Port）关联起来的操作。固定装置在完成地址分配之前，只存在于'''映射（Mapping）'''面板上：可以看到它，它也会参与效果，但它的数据不会发送到任何地方——既不会发送到真实设备，也不会写入导出的 <code>*.cue</code> 文件。地址分配回答的问题是"这个固定装置的光究竟是通过哪台设备的哪个物理接口发出的"。

这一切都在'''固定装置'''窗口中完成——把固定装置从下方列表拖到设备端口中。下面介绍这个窗口的结构、如何单个或批量地为固定装置分配地址、'''自动地址分配（Auto-patching）'''的作用，以及如何确认地址分配是否正确。

关于地址、域（Universe）和通道本身，请参见 [[Виды и типы приборов]]。关于你要分配地址的设备的参数，请参见 [[Light Stream Converter 参数]]。

== "固定装置"窗口 ==

窗口分为两个区域，两者之间的分界线可以用鼠标拖动。

; 上方区域——设备
: 一个四层结构的树状列表：'''Light Stream Player''' → Converter → Converter 端口 → 已分配到该端口的固定装置。行左侧的箭头用于展开或折叠该层级。
; 下方区域——未分配地址的固定装置
: 未与任何端口关联的固定装置和样条（Spline）。凡是在'''映射'''面板上、端口之外绘制的新固定装置，都会出现在这里。

地址分配的目标是清空下方列表：留在其中的一切，在现场都不会发光。

固定装置行在两个区域中的显示方式相同：

{| class="wikitable"
! 列 !! 显示内容
|-
| '''复选框（Checkbox）''' || 固定装置的可见性。取消勾选会关闭该固定装置的显示，但不影响其地址。如果列表中同时选中了多个固定装置，复选框会同时对所有选中项生效
|-
| '''图标''' || 表示固定装置在映射中的绘制方式：一个点表示单个固定装置，一条折线表示样条
|-
| '''名称''' || 固定装置的名称。双击名称或按 '''F2''' 可修改
|-
| '''地址（Address）''' || 已占用的首尾地址，例如 '''1-300'''
|-
| '''域（Universe）''' || 固定装置所占用的域：'''U1'''，或者当一个域放不下时为 '''U1-U2'''。此列仅在固定装置已分配地址时才会出现
|}

端口行显示其名称，以及分配给该端口的域编号——例如 '''U1''' 或 '''U1 U2'''。双击名称、按 '''F2'''，或通过'''鼠标右键（right-click）''' → '''重命名（Rename）'''，都可以重命名端口；像"正面幕墙左侧"这样清晰的名称，能在大型项目中节省大量时间。

窗口底部有四个按钮：

* '''添加设备（Add Device）'''（加号）——向项目中添加设备。菜单分为两部分：'''Light Stream'''——'''Player'''、'''Player V2'''，以及现成的 '''Converter 2'''、'''Converter 6'''、'''Converter 8 LITE'''；'''Art-Net Converter'''——拥有 1、2、3、4、5、6、8 或 16 个端口的 Converter。新添加的 Converter 会加入当前选中的 '''Player''' 内部，因此请先选中它所连接的那个 '''Player'''。
* '''搜索（Search）'''——在网络中搜索设备，并可以将已配置好的设备直接添加到项目中。
* '''折叠（Collapse）'''——一键折叠所有 Converter 和端口；再次点击则展开整棵树。当 Converter 和端口很多时非常有用。
* '''自动地址分配（Auto-patching）'''——自动分配地址的模式，详见下文。

== 如何为固定装置分配地址 ==

# 确认项目中已有端口数量足够的设备。如果没有，用'''添加设备'''按钮添加一个。
# 在下方列表中选中要放入同一端口的固定装置。按住 '''Shift''' 可连续选择，按住 '''Ctrl''' 可不连续选择。
# 将选中项拖到目标端口所在的行。这些固定装置会被放到该端口列表的末尾。
# 端口会自动展开，你会立即看到已分配好地址和域的固定装置。

对其余端口重复以上步骤。以下几点可以节省时间：

* 拖动时可以按住任意一个被选中的固定装置——整个选中的组都会一起移动。
* 如果需要把固定装置放到端口中的特定位置，而不是末尾，请把它们拖放到已分配地址的固定装置之间，而不是端口行上。
* 无论样条上有多少固定装置，它都会作为一个整体、一行来移动。不能把同一条样条上的固定装置分配到不同端口——如果需要这样做，请先把样条转换为单个固定装置，参见 [[样条和单个固定装置]]。
* 固定装置也可以在端口之间拖动，包括拖到另一个 Converter 上，也可以拖回下方列表。
* 任何拖动操作都可以用 '''Ctrl+Z''' 撤销，用 '''Ctrl+Shift+Z''' 重做。

'''固定装置'''窗口和'''映射'''面板中的选中状态是共通的：在列表中选中一个固定装置，就能看到它在现场对应的位置，反之亦然。这是弄清楚自己正在为哪个固定装置分配地址的最简单方法。

== 端口内固定装置的顺序 ==

端口内各行的顺序，就是地址分配的顺序。列表中第一个固定装置获得端口的第一个地址，下一个获得紧随其后的地址，依此类推。因此，端口内的固定装置顺序，应该和它们在现场的实际接线顺序一致：离设备最近的排在最前面。

顺序可以通过在端口内拖动固定装置来调整。开启'''自动地址分配'''后，地址会立即重新计算。

== 自动地址分配 ==

'''自动地址分配'''是程序自动分配地址的模式。这个按钮出现在两个位置：'''固定装置'''窗口底部，以及'''映射'''窗口的工具栏上。该设置是全局的，同时作用于所有端口。

{| class="wikitable"
! 情况 !! 自动地址分配开启 !! 自动地址分配关闭
|-
| 向端口中添加了固定装置 || 整个端口的地址会从其第一个域的地址 1 开始依次重新计算 || 固定装置保留自己的地址；程序只为它们分配域编号
|-
| 更改了端口内固定装置的顺序 || 地址会按新顺序重新计算 || 地址保持不变
|-
| 在映射上绘制了新固定装置 || 获得下一个可用地址 || 获得地址 1——之后的地址需要你自己设置
|-
| 复制了固定装置 || 副本在同一端口内获得下一个可用地址 || 副本保留原件的地址
|}

经验法则：当固定装置按顺序接线、地址应当连续排列时——这适用于绝大多数像素类项目——请开启'''自动地址分配'''。当地址是由已经安装好的设备决定、必须保持原样时，请将其关闭。

关闭'''自动地址分配'''并不意味着"没有帮助"：地址随时都可以一次性重新分配。在端口上点击'''鼠标右键'''，选择'''重新计算固定装置地址（Recalculate Fixture Addresses）'''——端口内的固定装置会按当前行顺序依次获得地址，而该模式本身仍然保持关闭。

地址在域边界处具体如何排列，取决于 Converter 的'''控制器类型（Controller Type）'''：在 '''DMX''' 模式下，通道以连续流的方式排列；在 '''SPI''' 模式下，一个固定装置会整体移动到下一个域。详见 [[Light Stream Converter 参数]]。

== 如何在摆放固定装置的同时完成地址分配 ==

固定装置不一定要先画好再分配地址。在'''固定装置'''窗口中选中一个端口——之后你在'''映射'''面板上绘制的所有固定装置，都会直接进入该端口，并且（在开启'''自动地址分配'''的情况下）已经带有地址。此时端口列表会自动滚动到最后添加的固定装置，已折叠的 '''Player''' 和 Converter 也会自动展开。

副本的行为方式相同：在映射上按住 '''Ctrl''' 复制、通过菜单复制，或从剪贴板粘贴的固定装置，都会留在与原件相同的端口中，并且在开启'''自动地址分配'''时获得后续的可用地址。这正是快速搭建矩阵和相同排列行的方法：先为一行分配好地址，之后只需不断复制。

要让新画的固定装置重新进入下方列表，只需取消端口的选中状态——在'''固定装置'''窗口的空白处点击一下即可。

== 如何将固定装置从端口中移除 ==

选中端口内的固定装置，点击'''鼠标右键'''，选择'''取消地址分配（Unpatch）'''——这些固定装置会返回'''固定装置'''窗口的下方列表，并继续留在映射上原来的位置。

要清空整个端口，在端口上点击'''鼠标右键'''，选择'''全部取消地址分配（Unpatch All）'''。在 Converter 上点击'''鼠标右键'''也能找到同样的选项——它会一次性取消该 Converter 所有端口的地址分配。

'''Delete 键不会取消固定装置的地址分配，而是会把它从项目中直接删除'''——同时删除它在映射上的位置以及与 3D 的关联。如果只是想把固定装置从端口中取出，请使用'''取消地址分配'''。

如果减少 Converter 的'''端口数量（Number of Ports）'''，固定装置也会自动返回下方列表：被移除端口中的固定装置不会消失，只会变为未分配地址的状态。

== 如何检查地址分配是否正确 ==

=== 红色高亮 ===

程序会自动标出地址分配的错误：固定装置所在的行，连同端口和 Converter 的名称，都会变成红色。原因有三种：

* '''固定装置的地址互相重叠'''——两个固定装置占用了相同的通道；
* '''固定装置超出了端口的域范围'''——它的最后一个地址超过了分配给该端口的范围；
* '''端口的域被另一个端口占用'''——同一个 '''Player''' 下的两个端口被分配了相同的域编号；这种情况下，端口行中的域编号本身会显示为红色。

第一种情况，请调整地址或开启'''自动地址分配'''；第二种情况，请增加 Converter 的'''每端口域数量（Universes per Port）'''，或将部分固定装置移动到相邻端口；第三种情况，请通过修改其中一个 Converter 的'''起始域（Start Universe）'''，让各 Converter 使用不同的域。

=== 端口占用指示图 ===

端口名称左侧有一张小图——它是该端口所有域的示意图，已占用的通道以橙色标出。通过它可以立即看出端口的占用情况，以及是否存在空缺的通道。点击这张图，可以在单独的窗口中以更大尺寸查看，并带有域的标注；按 '''Esc''' 键可以关闭该窗口。

=== 映射面板上的地址 ===

地址会直接标注在映射面板上固定装置的旁边。具体显示域编号、像素编号，还是连续的多重地址，可以在'''查看（View）→ 2D 映射（2D Mapping）'''菜单中设置。这是检查现场地址走向是否符合预期的最快方法。

=== 在真实现场高亮固定装置 ===

当你需要弄清楚现场哪个固定装置对应列表中的哪一行时，可以使用'''时间轴（Timeline）'''面板右侧的'''高亮固定装置和 DMX 数据（Highlight Fixtures and DMX Data）'''按钮。被选中的固定装置会在动画之上开始发光——无论是在程序中，还是在真实设备上。

它右侧带箭头的小按钮会打开高亮模式列表：

* '''常亮白色（Solid White）'''——持续均匀发光；
* '''闪烁白色（Blinking White）'''——闪烁，在现场最容易辨认；
* '''RGBW 颜色（RGBW Colors）'''——依次切换颜色，同时也有助于检查色彩通道的顺序。

同一位置的'''间隔（Interval）'''选项用于设置切换速度——从 0.5 秒到 5 秒。如果时间轴上没有这个按钮，可以在播放面板上点击'''鼠标右键''' → '''显示固定装置高亮按钮（Show Fixture Highlight Button）'''来启用它。

点击'''固定装置'''窗口中的 Converter 图标，有助于确认程序正在访问的确实是目标设备：真实设备会闪烁指示灯作为响应。

== 大型项目的工作流程 ==

# 在开始分配地址之前（而不是之后），为 Converter 设置好'''起始域'''、'''端口数量'''和'''每端口域数量'''：更改这些参数会使已经完成分配的端口地址发生偏移。
# 检查'''控制器类型'''——'''DMX''' 还是 '''SPI'''。它决定了地址在域边界处的排列方式，因此应在分配地址之前就确定好：对于已经摆放好的单个固定装置，更改类型后地址不会自动重新计算，端口需要手动重新计算。
# 根据现场的区域，为端口起一个含义清晰的名称。
# 开启'''自动地址分配'''，按接线顺序逐条为固定装置分配地址，并确保端口内的行顺序与接线顺序一致。
# 每完成一个端口，查看一下占用指示图：如果已经排满，后续的固定装置将无法再放入。
# 当下方列表清空后，依次检查所有端口，确认没有任何红色高亮。
# 如果 '''Player''' 名称旁边出现了带感叹号的橙色图标，说明设备的设置已经更改，但还没有发送到 '''Player''' 本身。点击该图标，系统会提示打开 '''Player''' 的属性并发送这些设置。

== 常见问题 ==

* '''映射上有固定装置，效果也在播放，但就是不发光。''' 这些固定装置很可能还留在'''固定装置'''窗口的下方列表中——它们还没有被分配地址。同时也请检查固定装置、端口和 Converter 的可见性复选框。
* '''固定装置所在的行变成了红色。''' 说明地址与相邻的重叠，或者超出了端口的域范围。请开启'''自动地址分配'''，或在端口上点击'''鼠标右键'''选择'''重新计算固定装置地址'''。
* '''如何在不删除固定装置的情况下把它从端口中取出？''' '''鼠标右键''' → '''取消地址分配'''。'''Delete''' 键会把固定装置从项目中彻底删除。
* '''端口中的第一个固定装置总是获得地址 1，但我需要其他地址。''' 这是'''自动地址分配'''的工作方式：它总是从端口第一个域的第一个地址开始。请将其关闭，然后在'''属性（Properties）'''面板中手动为该固定装置设置地址。
* '''我只给一个固定装置设置了地址，结果好几个都变了。''' '''地址'''字段中输入的值，会应用到当前所有被选中的固定装置。请取消多余的选中，然后重试。
* '''需要把一条样条分配到两个端口。''' 样条只能作为整体分配地址。请先将其转换为单个固定装置（参见 [[样条和单个固定装置]]），再分别分配到各个端口。
* '''固定装置放不进端口了。''' 增加 Converter 的'''每端口域数量'''，或把部分固定装置移动到相邻端口。请注意，项目中可用的域数量受许可证限制。
* '''更改固定装置类型后地址错乱了。''' 新类型的通道数量不同。请重新计算端口地址，或开启'''自动地址分配'''。
* '''固定装置从端口中消失了。''' 请检查是否减少了 Converter 的'''端口数量'''——被移除端口中的固定装置会返回下方列表。
* '''端口无法展开。''' 说明其中没有任何固定装置：空端口没有内容可以展开。

== 参见 ==

* [[Виды и типы приборов]]
* [[样条和单个固定装置]]
* [[添加样条和固定装置]]
* [[Light Stream Converter 参数]]
* [[Настройка Light Stream Converter]]
* [[Light Stream Player 设置]]
* [[术语]]