查看“添加样条和固定装置”的源代码

[[ru:Добавление сплайнов и приборов]] [[en:Adding Splines and Fixtures]] [[zh:添加样条和固定装置]]
在'''映射（Mapping）'''字段上放置固定装置（Fixture）有两种工具：'''添加固定装置（Add Fixture）'''每次点击创建一个固定装置，'''添加样条（Add Spline）'''则绘制一条线，固定装置会沿着这条线自动排列。下面介绍这两种工具的用法、程序会自动为你填写哪些内容（固定装置类型、端口、地址），以及创建后应立即检查哪些内容。

样条与一组独立固定装置的区别，以及针对具体对象该如何选择，见文章 [[Сплайны и одиночные приборы]]。这两个按钮都位于'''映射（Mapping）'''窗口的工具栏（Toolbar）上，完整说明见文章 [[Панель инструментов]]。

== 放置固定装置前需要设置的内容 ==

有几项设置决定了新建固定装置的样子。请在第一次点击前检查它们——事后再改会更费时间。

; 固定装置类型（Fixture Type）
: 位于添加工具右侧的按钮。在新项目中它显示为'''RGB'''——这是默认的固定装置：三个通道（红、绿、蓝），尺寸为一个像素。点击该按钮可打开[[Библиотека приборов|固定装置库（Fixture Library）]]，在其中选择所需的固定装置，然后点击'''选择固定装置（Select Fixture）'''。该按钮只有在'''添加固定装置'''或'''添加样条'''工具处于激活状态时才可用——选中其他工具时，它会显示为'''选择固定装置'''且无法点击。选定的类型会被记住，并应用于此后创建的所有固定装置和样条，直到你再次更改它。
; 端口（Port）
: 如果在'''固定装置（Fixtures）'''窗口中选中了某个设备端口，那么每个新建的固定装置都会立即归入该端口——无需再单独配址（patch）。如果没有选中端口，固定装置会在设备之外创建，并留在项目的固定装置总列表中，之后可以再把它们拖入端口（见 [[Патчинг приборов]]）。
; 自动配址（Auto-Patch）
: 工具栏上的一个复选框，默认开启。开启自动配址后，每个新建的固定装置都会获得下一个空闲地址：排在所选端口最后一个固定装置之后；如果未选中端口，则排在最后一个未配址的固定装置之后。连续放置的固定装置会依次落入地址空间。关闭自动配址后，所有新建固定装置的地址都会是1，需要手动设置地址。
; 网格对齐（Snap to Grid）
: 同样默认开启：固定装置的坐标会四舍五入到整数像素，使固定装置正好落在网格单元格中。只有当固定装置需要落在单元格之间时才应关闭它。开启菜单项'''视图（View） → 2D映射（2D Mapping） → 显示像素网格（Show Pixel Grid）'''后即可看到网格本身。

== 独立固定装置 ==

# 点击工具栏上的'''添加固定装置'''。
# 将光标移到字段上方。绿色十字准星框会显示固定装置将被放置的位置；开启网格对齐时，它会按单元格移动。
# 点击鼠标左键——固定装置创建完成。
# 继续点击：该工具会保持激活状态，因此可以连续放置上百个固定装置。
# 完成后切换回'''选择和移动（Select and Move）'''工具，用它来选中和移动固定装置。

此过程中会发生以下情况：

* 固定装置会出现在字段上以及'''固定装置'''窗口中——归入所选端口，或进入项目的固定装置总列表。它会以类型加三位数编号命名：'''RGB001'''、'''RGB002'''，依此类推。
* 开启自动配址时，每个后续固定装置的地址会按前一个固定装置的通道数递增。当固定装置在某个域（Universe）中放不下时，下一个固定装置会自动从下一个域的第一个地址开始——因此排列大批固定装置时无需盯着域的边界。
* 在同一位置再次点击不会创建第二个固定装置：不会出现两个固定装置意外叠在一起的情况。
* 如果出错——'''Ctrl+Z'''撤销添加，'''Delete'''删除选中的固定装置。

== 样条 ==

样条（Spline）是一条折线，程序会沿着它自动排列固定装置。灯条、灯带、彩灯串、外墙轮廓等都是这样设置的：只需画一条线，线上可以有三个固定装置，也可以有三百个。

# 点击'''添加样条'''。
# 在线条起点处点击鼠标左键。
# 每次点击都会添加一个新的顶点。移动鼠标时，即将生成的线段会跟随光标；顶点用绿色方块标出。
# 要得到严格水平或垂直的线段，请按住'''Shift'''（或'''Ctrl'''）：如果新顶点与上一个顶点的偏差小于5像素，它会自动与上一个顶点对齐。
# 按'''Enter'''——样条创建完成。顶点数必须不少于两个，否则无法完成绘制。

有用的提示：

* '''Esc'''会清除正在绘制的线条，之后可以重新绘制；如果线条尚未开始绘制，'''Esc'''会退出该工具，回到'''选择和移动'''。
* 绘制完成的样条会保持选中状态——可以立即看到它的边框和属性。要绘制下一条，再次点击'''添加样条'''。
* 在'''固定装置'''窗口中，样条会以单独一行显示，名称为'''Spline001'''——它的所有固定装置作为一个整体进行配址、移动和编址。
* 绘制过程可以用'''Ctrl+Z'''撤销。

== 样条上有多少个固定装置 ==

刚绘制完成的样条会获得'''100'''个固定装置，沿其整个长度均匀分布。实际数量可以在'''属性（Properties）'''窗口中设置——选中样条，调整'''固定装置数量（Fixture Count）'''参数。固定装置会立即沿线重新分布，地址也会自动重新计算。

样条的其余参数位于'''常规（General）'''部分：

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称（Name）''' || 样条在'''固定装置'''窗口中的名称。清晰的名称（如“左侧外墙”“檐口1”）能在配址时节省大量时间。
|-
| '''可见性（Visibility）''' || 关闭后，样条不会显示在字段上，也无法用鼠标选中。只能在'''固定装置'''窗口的列表中选中它。
|-
| '''平滑（Smooth）''' || 使拐角变圆：样条从折线变为平滑曲线。适用于拱形和波浪形，对于严格的几何形状则相反——不需要开启。
|-
| '''像素对齐（Snap to Pixels）''' || 将固定装置精确放置在像素网格单元格中。默认开启。如果固定装置需要精确落在线条上而不四舍五入，请关闭它。
|-
| '''地址（Address）'''与'''域（Universe）''' || 样条第一个固定装置的地址和域。其余固定装置以此为基准计算。
|-
| '''分布类型（Distribution Type）''' || '''均匀（Even）'''——固定装置分布在整条线的长度上，数量由你设置。'''固定像素（Fixed Pixels）'''——固定装置放置在线条的每个顶点上，固定装置数量等于顶点数量；此模式下'''固定装置数量'''参数不可编辑。
|-
| '''固定装置数量（Fixture Count）''' || 样条上固定装置的数量（均匀分布时）。
|-
| '''地址偏移（Address Offset）''' || 样条上相邻固定装置之间要跳过的通道数。通常为0：地址紧密相连。当实际固定装置的部分通道未被使用时，需要设置大于零的值。
|-
| '''反转（Reverse）''' || 翻转固定装置的顺序：第一个变为最后一个。如果动画沿线条运行的方向与实际物体上的方向不一致，点击此项。
|-
| '''固定装置类型（Fixture Type）''' || 显示当前固定装置名称的按钮。点击可打开[[Библиотека приборов|固定装置库（Fixture Library）]]——这样就能更改已创建样条的类型。
|}

如果样条上的固定装置在一个域中放不下，剩余部分会像独立固定装置一样自动延续到下一个域。

== 创建后应立即做什么 ==

* '''移动、旋转、缩放。'''使用'''选择和移动'''工具：拖动选框边缘可移动，拖动角点可缩放，拖动侧边手柄可旋转。详情见文章 [[Мышь, выделение и перемещение]]，关于尺寸和角度见文章 [[Изменение размера и вращение приборов]]。
* '''调整线条形状。'''双击样条（或点击'''编辑样条（Edit Spline）'''按钮）可进入顶点编辑模式：可以拖动点、在线条附近点击添加新点，用'''Delete'''删除点。如果选中端点后在空白处点击，样条会继续延伸——之前绘制的线条可以随时继续绘制。
* '''清除多余的顶点。'''在样条上点击鼠标右键 → '''删除多余的点（Remove Redundant Points）'''：该命令会移除与相邻顶点重复或不改变线条方向的顶点。适合在快速手绘之后使用。
* '''配址（Patch）。'''如果固定装置是在未选中端口的情况下创建的，请在'''固定装置'''窗口中将它们拖入设备的端口（见 [[Патчинг приборов]]）。

== 添加固定装置的其他方式 ==

并不是每个固定装置都需要手动绘制。

; 拖动复制
: 按住'''Ctrl'''拖动选中的固定装置——新位置会出现一个设置相同的副本。
; 复制（Duplicate）
: 该工具可以一次性按固定步长生成一整排副本：设置副本数量、X和Y方向的偏移量、地址和域的偏移量。这样一次操作就能得到一排相同的灯条或一个像素矩阵。点击'''应用（Apply）'''按钮即可创建副本。
; 转换为样条／转换为固定装置
: 将多个选中的独立固定装置合并为一条样条，或将样条重新拆分为独立固定装置。当排列已经完成，但换一种方式处理更方便时很有用。
; 从3D导入
: 如果场景是在映射之前搭建的，就不需要重新绘制固定装置：'''魔法2D按钮（Magic 2D Button）'''会根据'''3D视图（3D View）'''窗口中的样条和固定装置，在映射中创建对应的固定装置，并立即将它们关联起来。参见 [[Добавление 3D сплайнов]] 和 [[Связь 2D и 3D]]。
; 导入DXF
: 在制图软件中准备好的排列方案可以整体导入：'''文件（File） → 导入（Import） → Dxf'''。

== 常见问题 ==

* '''点击字段没有创建固定装置。'''当前激活了其他工具。'''选择和编辑效果（Select and Edit Effects）'''工具用于处理效果和布局，而非固定装置；请点击'''添加固定装置'''或'''添加样条'''。
* '''固定装置类型按钮无法点击。'''它只有在添加工具处于激活状态时才可用。要更改已创建固定装置的类型，请通过其属性中的'''固定装置类型'''参数。
* '''所有固定装置的地址都变成了1。'''这是因为'''自动配址'''被关闭了。开启它后继续放置固定装置，并为已创建的固定装置手动设置地址，或使用'''固定装置'''窗口中的地址重新计算功能。
* '''样条上的固定装置太多。'''默认数量为100。选中样条，在'''固定装置数量'''参数中设置所需的数量。
* '''固定装置排列不整齐。'''为新建固定装置开启工具栏上的'''网格对齐'''，为线条上的固定装置开启样条属性中的'''像素对齐'''。绘制时按住'''Shift'''可得到笔直的线段。
* '''Enter无法完成样条绘制。'''只放置了一个顶点。请再点击一次，然后再次按'''Enter'''。
* '''固定装置已创建，但不发光。'''请检查它是否被放置在工作字段边界之外：边界之外的固定装置不会播放动画。此外还应确认合成（composition）中存在能覆盖到该位置的效果（见 [[Добавление эффекта в композицию]]）。