查看“样条和单个固定装置”的源代码

[[ru:Сплайны и одиночные приборы]] [[en:Splines and Single Fixtures]] [[zh:样条和单个固定装置]]
Light Stream 项目中的每一个固定装置(Fixture)都属于以下两种类型之一：'''单个固定装置'''(Single Fixture)，或者'''样条'''(Spline)——沿着一条线排列的一串固定装置。这一选择决定了固定装置如何寻址、如何进行地址分配(Patching)，以及日后修改布局的难易程度。下面将说明它们的区别、针对具体对象该如何选择，以及如果选错了该如何将一种转换为另一种。

两者的绘制方法参见文章[[添加样条和固定装置]]。固定装置有哪些类型、各自有多少通道，参见文章[[Виды и типы приборов]]。

== 区别简述 ==

; 单个固定装置
: 独立对象：拥有自己的名称、自己的地址、自己的宇宙(Universe)、自己的固定装置类型。在'''固定装置'''(Fixtures)窗口中占一行，在'''映射'''(Mapping)平面上显示为一个点。可以独立于相邻装置进行移动、寻址和地址分配。

; 样条
: 一条排列有固定装置的线。样条是一个单独的对象：一个名称、一个起始地址、整条线上所有固定装置统一的一种类型。程序会自行沿线排布固定装置，并自行为它们依次分配地址。在'''固定装置'''窗口中，无论线上有多少固定装置——10个还是500个——样条都只占一行。

主要的实际结果是：样条是整体进行管理的，而单个固定装置则是逐个管理的。

{| class="wikitable"
! !! 单个固定装置 !! 样条
|-
| 在'''固定装置'''窗口中 || 每个固定装置一行 || 整条线一行
|-
| 地址 || 为每个固定装置单独设置 || 为第一个设置，其余自动计算
|-
| 地址分配 || 每个固定装置需单独移到端口 || 整体一次性移到端口
|-
| 固定装置数量 || 通过添加和删除固定装置来改变 || 属性中的'''固定装置数量'''参数
|-
| 排布方式 || 任意：放在哪里就在哪里 || 沿着一条线，其形状通过顶点调整
|-
| 固定装置顺序 || 由其地址决定 || 由线的方向决定，可用'''反转'''(Reverse)按钮翻转
|-
| 在平面上的选择 || 可以选中单个固定装置 || 整条线一起被选中
|-
| 与3D的关联 || 单个固定装置与'''3D 视图'''(3D View)窗口中的对象关联 || 样条与'''3D 视图'''窗口中的对象关联
|}

对效果而言两者没有区别：样条上的固定装置和单个固定装置一样，都是根据它们在'''映射'''平面上的位置获得颜色的。选择固定装置的类型是为了便于项目管理和寻址，而不是为了画面效果。

== 如何在映射平面上区分它们 ==

* 两种类型的固定装置都以绿色圆点显示，被选中的则显示为红色。
* 样条上的固定装置由一条深灰色的线相连。这条线仅用于直观显示——发光的是固定装置，而不是这条线。是否显示这些线由菜单项'''查看(View) → 2D 映射(2D Mapping) → 显示样条(Show Splines)'''控制，默认开启。
* 样条的第一个固定装置带有白色边框。这是线的起点：地址从它开始计数，'''反转'''按钮正是把它和最后一个固定装置互换位置。
* 如果固定装置没有标注，可以在同一菜单中打开需要的选项：'''显示像素编号(Show Pixel Numbers)'''、'''显示固定装置的宇宙(Show Fixture Universes)'''、'''显示固定装置的多地址(Show Fixture Multi-addresses)'''。'''显示像素网格(Show Pixel Grid)'''项会打开平面的网格，便于检查固定装置是否排列整齐。

在'''固定装置'''窗口中，样条和单个固定装置通过名称左侧的图标区分：样条的图标是一条折线，单个固定装置的图标则是装置本身。要确认无误，可以查看'''属性'''(Properties)窗口：样条在其中有'''固定装置数量'''、'''平滑'''(Smooth)和'''分布类型'''(Distribution Type)这些参数，而单个固定装置没有。

== 针对具体对象该如何选择 ==

'''样条'''——当固定装置沿一条线依次排列并依次寻址时：

* LED灯带、灯条、像素灯管；
* 灯串和灯线；
* 立面轮廓、檐口、窗洞、栏杆；
* 任何连接到同一端口的、由相同固定装置组成的长排。

'''单个固定装置'''——当每个固定装置都是独立存在时：

* 探照灯、泛光灯、光束灯；
* 分布在物体上、没有统一规律的独立点位；
* 混合摆放的不同类型固定装置；
* 需要非连续地址或不同端口的固定装置。

'''矩阵'''通常由样条组成：先画出一行，设置好所需的固定装置数量，其余各行通过'''复制'''(Duplicate)工具获得——该工具会按固定的X、Y偏移量和固定的地址偏移量生成指定数量的副本。

总体原则是：同一条线上相同固定装置的排列越长，使用样条就越划算。五百个单独放置的固定装置意味着'''固定装置'''窗口中有五百行、五百个需要手动跟踪的地址；而同样的一排用样条实现，只有一行、一个地址和一个数量参数。

== 寻址 ==

这是两种类型之间最明显的区别，也正是因为它，布局最常需要被重新调整。

=== 样条的寻址 ===

属性中设置'''地址'''(Address)和'''宇宙'''(Universe)——它们对应线上第一个固定装置。接下来程序会自行计算：

* 固定装置之间的间隔等于所选固定装置类型的通道数加上'''地址偏移'''(Address Offset)参数的值（默认值为0，也就是说地址是紧挨着排列的）；
* 当固定装置在一个宇宙中放不下时，样条的后续部分会自动转入下一个宇宙；对于切换到'''SPI'''模式的端口，固定装置不会被拆分——下一个固定装置会从下一个宇宙的第一个地址开始；
* 在'''固定装置'''窗口中，样条旁边会以'''U1-1-300'''的形式显示所占用的范围：端口的起始宇宙、第一个地址和最后一个地址。

任何改动——固定装置数量、固定装置类型、地址偏移、反转——都会立即重新计算整条线的地址。样条内部的固定装置不能手动设置地址：这是为方便所付出的代价。

=== 单个固定装置的寻址 ===

地址和宇宙需要为每个固定装置单独设置。为了避免手动操作，放置固定装置时通常会开启'''自动地址分配'''(Auto-patching)——这样每个新放置的固定装置都会紧接在上一个之后获得地址。已经放置好的固定装置也可以重新计算地址：在'''固定装置'''窗口中右键点击端口 → '''重新计算固定装置地址'''(Recalculate Fixture Addresses)。

请注意：在'''属性'''窗口的'''地址'''字段中输入的值，会应用到此刻在'''固定装置'''窗口中被选中的所有固定装置上。如果只需要修改某一个固定装置的地址，请先取消其余装置的选中状态。

关于地址分配以及固定装置在端口间分布的详细说明，参见文章[[固定装置的地址分配]]。

=== 寻址错误 ===

如果固定装置或样条超出了分配给端口的宇宙范围，或者它们的地址相互重叠，'''固定装置'''窗口中对应的行会显示为红色——同时该端口本身也会一起变红。红色的行意味着信号无法到达这些固定装置：请修正地址、样条上的固定装置数量，或每个端口的宇宙数量。

== 属性 ==

部分参数两种类型都有，部分参数只有样条才有。

{| class="wikitable"
! 参数 !! 单个固定装置 !! 样条 !! 作用
|-
| '''名称'''(Name) || 有 || 有 || '''固定装置'''窗口中显示的名称。清晰易懂的名称能在地址分配时大大节省时间。
|-
| '''可见性'''(Visibility) || 有 || 有 || 关闭后的固定装置不会显示在平面上，也无法用鼠标选中；与之关联的'''3D 视图'''中的对象也会一并隐藏。
|-
| '''地址'''、'''宇宙''' || 有 || 有 || 对样条而言，指的是线上第一个固定装置的地址和宇宙。
|-
| '''固定装置类型'''(Fixture Type) || 有 || 有 || 显示当前固定装置名称的按钮，点击后打开[[固定装置库]]。对样条而言，更改类型会同时改变整条线上所有固定装置的类型。
|-
| '''转到3D固定装置'''(Go to 3D Fixture) || 有 || 有 || 查找并选中'''3D 视图'''窗口中与之关联的对象。如果关联对象不止一个，程序会提示从列表中选择所需的对象。
|-
| '''分布类型'''(Distribution Type) || — || 有 || '''均匀'''(Uniform)——固定装置沿整条线的长度分布，数量由你设置。'''固定像素'''(Fixed Pixels)——每个顶点上放置一个固定装置，固定装置数量等于顶点数量。
|-
| '''固定装置数量'''(Fixture Count) || — || 有 || 线上固定装置的数量。仅在均匀分布时可以更改；固定像素模式下该字段显示顶点数量，输入的值不会生效。
|-
| '''地址偏移'''(Address Offset) || — || 有 || 线上相邻固定装置之间要跳过的通道数。
|-
| '''反转'''(Reverse) || — || 有 || 翻转固定装置的顺序：第一个变成最后一个。
|-
| '''平滑'''(Smooth) || — || 有 || 使线的转角变圆滑：由折线变为平滑曲线。
|-
| '''吸附到像素'''(Snap to Pixels) || — || 有 || 将线上的固定装置精确放置到像素网格的格子中。
|}

样条的属性会同时应用到所有被选中的样条上。当需要为十条相同的灯条设置同样的参数时，这一点很方便：全部选中后只需输入一次数值。

== 两种类型之间的相互转换 ==

这个选择并非最终决定。'''映射'''(Mapping)窗口的工具栏上有两个按钮——'''转换为样条'''(Convert to Spline)和'''转换为固定装置'''(Convert to Fixtures)（在更早的版本中，它们叫做'''链接'''(Link)和'''取消链接'''(Unlink)）。通常使用'''选择与移动'''(Selection and Movement)工具进行选择；在样条编辑模式下，这两个按钮都不可用。任何转换都可以用'''Ctrl+Z'''撤销。

=== 从单个固定装置转换为样条 ===

# 使用'''选择与移动'''工具，选中两个或更多单个固定装置。
# 点击'''转换为样条'''。

结果如下：

* 线会经过所选固定装置的位置，每个顶点对应一个固定装置——新样条的分布类型会被设为'''固定像素'''；
* 顶点的顺序由'''地址'''决定，而不是选择的先后顺序：线是从地址最小的固定装置构建到地址最大的固定装置；
* 地址、宇宙、固定装置类型和端口取自第一个固定装置——其余固定装置的这些参数会被重新分配，以符合整条线统一的编号；
* 新样条默认关闭吸附到像素，因此固定装置会精确保留在原来的位置；
* 原来的单个固定装置会从项目中删除，新样条会立即处于被选中状态。

转换前最好先检查地址：如果地址的排列顺序与固定装置在实际物体上的排列顺序不一致，得到的线就会显得杂乱无章。更简单的做法是先按顺序完成固定装置的地址分配，然后再把它们合并为样条。

如果只选中了一个固定装置、所选内容中包含样条，或者处于样条编辑模式，该按钮将不可用。

=== 从样条转换为单个固定装置 ===

# 选中一个或多个样条。
# 点击'''转换为固定装置'''。

线上的每个固定装置都会变为独立对象：保留原位置，保留自己的地址和宇宙，并归入样条原先所在的端口；在端口内，固定装置按地址升序排列，名称则由固定装置类型加序号组成。线本身连同其参数——平滑、反转、固定装置数量和分布类型——一起消失。

以下情况需要用到这种转换：

* 需要把线上部分固定装置转移到另一个端口或另一台转换器；
* 固定装置需要非连续的地址；
* 需要删除或移动个别固定装置，而不是整条线。

转换后请检查与'''3D 视图'''窗口的关联：该关联原本是为样条建立的，新生成的单个固定装置需要重新指定关联。相关内容参见文章[[2D 与 3D 的关联]]。

== 常见问题 ==

* '''样条上的固定装置数量无法更改。''' 当前选择的分布类型是'''固定像素'''——此模式下固定装置数量等于线的顶点数量。请切换为'''均匀'''，或在样条编辑模式下添加顶点。
* '''如何选中样条内部的某一个固定装置？''' 无法做到：样条只能整体被选中、寻址和移动。如果需要访问单个固定装置，请先将样条转换为固定装置。
* '''动画沿线运动的方向不对。''' 对样条，点击'''反转'''；对单个固定装置，请检查地址的顺序。
* '''「转换为样条」按钮无法点击。''' 需要至少选中两个单个固定装置，并退出样条编辑模式。
* '''「固定装置」窗口中某个固定装置或样条的行变成了红色。''' 地址超出了端口的宇宙范围，或与相邻装置的地址发生了重叠。
* '''样条上的固定装置没有对齐网格。''' 在其属性中开启'''吸附到像素'''。
* '''固定装置太多，列表中什么都找不到。''' 把同类型的排列合并为样条：这样'''固定装置'''窗口中原本的几百行就会变成每条线一行，地址也会自动计算。