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

[[ru:Сплайны и одиночные приборы]] [[en:Splines and Single Fixtures]] [[zh:样条和单个固定装置]]
Light Stream 项目中的任何固定装置都属于两种类型之一：'''单个固定装置'''，或者'''样条'''——沿着一条线排列的一串固定装置。这个选择决定了固定装置如何编址、如何配接（Patch），以及以后调整布局的难易程度。下面介绍两者的区别、针对具体对象该如何选择，以及如果选错了该如何把一种转换成另一种。

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

== 简要说明区别 ==

; 单个固定装置
: 一个独立的对象：拥有自己的名称、自己的地址、自己的域，以及自己的固定装置类型。在'''固定装置'''（Fixtures）窗口中占据单独一行，在'''映射'''（Mapping）字段上显示为一个点。可以独立于相邻装置进行移动、编址和配接。

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

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

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

对效果而言两者没有区别：无论是样条上的固定装置，还是单个固定装置，都会根据它们在'''映射'''字段上的位置获得颜色。选择固定装置的类型是为了方便项目操作和编址，而不是为了呈现效果。

== 如何在映射字段上区分它们 ==

* 两种类型的固定装置都以绿色圆点表示，被选中的则显示为红色。
* 样条上的固定装置由深灰色线连接。这条线只是为了便于观察——发光的是固定装置，而不是线本身。是否显示连线由菜单项'''视图 → 2D映射 → 显示样条'''（View → 2D Mapping → Show Splines）控制，默认开启。
* 样条的第一个固定装置带有白色边框。这是线的起点：地址从它开始计数，'''反转'''按钮正是把它和最后一个固定装置互换位置。
* 如果固定装置没有标签，可以在同一菜单中开启所需项目：'''显示像素编号'''（Show Pixel Numbers）、'''显示固定装置域'''（Show Fixture Universes）、'''显示固定装置多地址'''（Show Fixture Multi-Addresses）。'''显示像素网格'''（Show Pixel Grid）选项会开启场地网格——用它可以方便地检查固定装置是否排列整齐。

要确切判断，可以查看'''属性'''（Properties）窗口：样条在其中有'''固定装置数量'''、'''平滑'''（Smooth）和'''分布类型'''（Distribution Type）参数，而单个固定装置没有这些参数。

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

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

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

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

* 探照灯、泛光灯、光束灯；
* 物体上按无规律顺序摆放的独立点位；
* 混合摆放的不同类型固定装置；
* 需要非连续地址或不同端口的固定装置。

'''矩阵'''通常由样条搭建而成：先画出一行，为它设置好所需的固定装置数量，其余各行则用'''复制'''（Duplicate）工具生成——该工具会按坐标、地址和域，以恒定的步长生成副本。

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

== 编址 ==

这是两种类型之间最明显的区别，也正因如此，重新调整布局的情况大多由此而起。

=== 样条的编址 ===

属性中设置的是'''地址'''（Address）和'''域'''（Universe）——它们对应线上的第一个固定装置。之后的部分由程序自动计算：

* 相邻固定装置之间的间隔，等于所选固定装置类型的通道数加上'''地址偏移'''（Address Offset）参数的值（默认值为0，即地址紧密相连）；
* 当固定装置超出一个域的容量时，样条的后续部分会自动转到下一个域；在切换为'''SPI'''模式的端口上，固定装置不会因此被拆分——下一个固定装置会从下一个域的第一个地址开始；
* 在'''固定装置'''窗口中，样条旁边会以'''U1-1-300'''的形式显示所占用的范围：域、首地址和末地址。

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

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

地址和域是分别为每个固定装置设置的。为了避免手动操作，摆放固定装置时通常会开启'''自动配接'''（Auto Patching）——这样每个新固定装置会紧接着上一个获得地址。已经摆好的固定装置也可以重新计算地址：在'''固定装置'''窗口中右键点击端口 → '''重新计算固定装置地址'''（Recalculate Fixture Addresses）。

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

关于配接以及固定装置在各端口间分配的详细说明，参见文章[[Патчинг приборов]]。

=== 编址错误 ===

如果固定装置或样条超出了端口所分配的域范围，或者它们的地址相互重叠，'''固定装置'''窗口中的该行会显示为红色——连同该端口一起变红。红色的行表示信号无法到达这些固定装置：请调整地址、样条上的固定装置数量，或者每个端口的域数量。

== 属性 ==

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

{| class="wikitable"
! 参数 !! 单个固定装置 !! 样条 !! 作用
|-
| '''名称'''（Name） || 有 || 有 || '''固定装置'''窗口中的名称。清晰易懂的名称能在配接时节省大量时间。
|-
| '''可见性'''（Visibility） || 有 || 有 || 关闭可见性的固定装置不会显示在场地上，也无法用鼠标选中；与之关联的'''3D视图'''中的对象也会一并隐藏。
|-
| '''地址'''、'''域''' || 有 || 有 || 对样条而言——即线上第一个固定装置的地址和域。
|-
| '''固定装置类型'''（Fixture Type） || 有 || 有 || 显示当前固定装置名称的按钮，点击可打开[[Библиотека приборов|固定装置库]]（Fixture Library）。对样条而言，更改类型会同时应用到线上所有固定装置。
|-
| '''转到3D固定装置'''（Go to 3D Fixture） || 有 || 有 || 在'''3D视图'''窗口中查找并选中关联的对象。
|-
| '''分布类型''' || — || 有 || '''均匀'''（Uniform）——固定装置沿整条线的长度分布，数量由你设定。'''固定像素'''（Fixed Pixels）——在线的每个顶点上放置一个固定装置，固定装置数量等于顶点数量。
|-
| '''固定装置数量''' || — || 有 || 线上有多少个固定装置。仅在均匀分布模式下可用。
|-
| '''地址偏移''' || — || 有 || 线上相邻固定装置之间要跳过多少个通道。
|-
| '''反转''' || — || 有 || 翻转固定装置的顺序：第一个变成最后一个。
|-
| '''平滑''' || — || 有 || 让线的转角变圆：折线变成平滑的曲线。
|-
| '''像素对齐'''（Snap to Pixels） || — || 有 || 让线上的固定装置精确落在像素网格的格子上。
|}

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

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

这个选择并非一成不变。'''映射'''窗口的工具栏上有两个按钮——'''转换为样条'''（Convert to Spline）和'''转换为固定装置'''（Convert to Fixtures）（在早期版本中它们分别叫做'''连接'''（Link）和'''断开'''（Unlink））。两者都需要在'''选择并移动'''（Select and Move）工具处于激活状态时才能使用，并且都可以用'''Ctrl+Z'''撤销。在样条编辑模式下，这两个按钮会被锁定。

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

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

结果如下：

* 生成的线会经过被选中固定装置的位置，每个顶点对应一个固定装置——新样条会被设为'''固定像素'''分布类型；
* 顶点的顺序由'''地址'''决定，而不是由选中顺序决定：线会从地址最小的固定装置连接到地址最大的固定装置；
* 地址、域、固定装置类型和端口取自第一个固定装置——其余固定装置的这些值会被重新分配，以匹配整条线统一的编号；
* 新样条的'''像素对齐'''功能默认关闭，因此固定装置会保持原来的位置不变；
* 原来的单个固定装置会从项目中删除，新生成的样条会立即处于选中状态。

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

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

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

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

线上的每个固定装置都会变成独立个体：位置保持不变，保留原有的地址和域，并归属到样条原来所在的端口；在该端口内，固定装置会按地址从小到大排列。线本身连同它的参数——平滑、反转、固定装置数量和分布类型——都会一并消失。

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

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

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

== 常见问题 ==

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