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

[[ru:Добавление сплайнов и приборов]] [[en:Adding Splines and Fixtures]] [[zh:添加样条和固定装置]]
在“映射”(Mapping)窗口中放置固定装置(Fixture)有两种工具:“添加固定装置”(Add Fixture)按钮每次点击创建一个固定装置,“添加样条”(Add Spline)按钮则绘制一条线,固定装置会沿着这条线自动排列。下面介绍这两种工具的使用方法、程序会自动替您填写哪些内容(固定装置类型、端口、地址),以及创建后应该立即检查和调整哪些内容。

样条与一组单个固定装置有什么区别、针对具体对象该如何选择,请参见文章[[样条和单个固定装置]]。这两个按钮都位于“映射”窗口的工具栏上,工具栏的完整说明见文章[[Панель инструментов]]。

== 在放置固定装置之前需要设置什么 ==

有几项设置决定了新固定装置的最终效果。请在第一次点击前检查它们——之后再修改会更麻烦。

; 固定装置类型(Fixture Type)
: 位于添加工具右侧的按钮。在新建项目中,按钮上显示的是“RGB”——这是默认固定装置:三个通道(红、绿、蓝),尺寸为一个像素。点击该按钮可打开[[固定装置库]],在其中选择所需的固定装置,然后点击“选择固定装置”(Select Fixture)。只有在“添加固定装置”或“添加样条”工具处于激活状态时,该按钮才可用——当选中其他工具时,它会显示为“选择固定装置”并且无法点击。所选的类型会被记住,并应用于之后创建的所有固定装置和样条,直到您重新更改为止。
; 端口(Port)
: 如果在“固定装置”(Fixtures)窗口中选中了某个设备端口,那么每个新建的固定装置会立即归入该端口——无需再单独进行地址分配。如果没有选中端口,固定装置会在设备之外创建,并保留在项目的固定装置总列表中,之后可将其拖入端口(参见[[固定装置的地址分配]])。
; 自动分配地址(Auto-Patching)
: 工具栏上的开关按钮,默认开启。开启自动分配地址后,每个新固定装置都会获得下一个空闲地址:接在所选端口的最后一个固定装置之后;如果未选择端口,则接在最后一个未分配地址的固定装置之后。依次放置的固定装置会在地址空间中一个接一个地排列。关闭自动分配地址后,所有新固定装置都会以地址1创建(所在世界为所选端口的第一个世界),需要手动设置地址。
; 吸附到网格(Snap to Grid)
: 位于工具栏右侧的按钮,默认开启:固定装置的坐标会四舍五入到场地的整数像素,固定装置会精确落在网格单元内。只有当固定装置需要落在网格单元之间时才关闭它。开启菜单项“查看 → 2D映射 → 显示像素网格”(View → 2D Mapping → Show Pixel Grid)后即可看到网格本身。

== 单个固定装置 ==

# 点击工具栏上的“添加固定装置”。
# 将光标移到场地上。绿色方形准星会显示未来固定装置的位置;开启网格吸附后,准星会按网格单元移动。
# 单击左键——固定装置即被创建。
# 继续点击:该工具保持激活状态,一次可以连续放置上百个固定装置。
# 完成后切换回“选择并移动”(Select and Move)工具——用它来选中和移动固定装置。

此时会发生以下情况:

* 固定装置会出现在场地上以及“固定装置”窗口中——位于所选端口内,或位于项目的固定装置总列表中。系统会按类型加三位数字为其命名:“RGB001”“RGB002”依此类推。
* 开启自动分配地址后,每个后续固定装置的地址会在前一个固定装置的通道数基础上偏移。当固定装置在一个世界中放不下时,编址会自动延续到下一个世界——放置大批固定装置时无需关注世界边界。
* 在同一位置再次点击不会创建第二个固定装置:两个固定装置不会意外叠放在一起。
* 点错了——“Ctrl+Z”可撤销添加操作。已创建的固定装置可以在“固定装置”窗口中用“Delete”键删除:在映射场地本身上,该键不会删除固定装置。

== 样条 ==

样条(Spline)是一条折线,程序会沿着它自动排列固定装置。灯条、灯带、彩灯串、建筑立面轮廓通常都是这样设置的:只需画一条线,线上的固定装置数量可以是三个,也可以是三百个。

# 点击“添加样条”。
# 在线条起点处单击左键。
# 之后每次点击都会添加一个新顶点。移动鼠标时,即将形成的线段会随光标延伸;顶点用绿色小方块标记。
# 要得到严格水平或垂直的线段,请按住“Shift”(或“Ctrl”):如果新顶点与前一个顶点的偏差小于5像素,它会自动与前一个顶点对齐。
# 按“Enter”——样条即被创建。顶点数量不得少于两个,否则无法完成绘制。

有用的提示:

* 按下“Enter”之后该工具仍保持激活:在场地上再次点击即可开始绘制新的线条,无需重新点击按钮。
* “Esc”会清除正在绘制的线条,之后可以重新绘制;如果放置的顶点少于两个,“Esc”会退出该工具,返回“选择并移动”。
* 绘制完成的样条会保持选中状态——可以立即看到它的边框和属性。
* 在“固定装置”窗口中,样条会以“Spline001”这样的名称显示为一行——它的所有固定装置作为一个整体进行地址分配、移动和编址。
* 绘制过程可以用“Ctrl+Z”撤销。

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

刚刚绘制完成的样条会获得“100”个固定装置,均匀分布在其整个长度上。实际数量在“属性”(Properties)窗口中设置——选中样条并调整“固定装置数量”参数。固定装置会立即沿线条重新分布,地址也会自动重新计算。

样条的其余参数位于“常规”(General)部分:

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称''' || 样条在“固定装置”窗口中的名称。清晰易懂的名称(如“左立面”“檐口1”)能在地址分配时大大节省时间。
|-
| '''可见性''' || 关闭后样条不会显示在场地上,也无法用鼠标选中,只能在“固定装置”窗口的列表中选择它。
|-
| '''平滑''' || 让转角变圆:折线会变成平滑的曲线。适用于拱形和波浪形状;对于严格的几何形状则相反,是多余的。
|-
| '''像素吸附''' || 让固定装置精确落在像素网格的单元内。默认开启。如果需要固定装置精确落在线条上、不进行四舍五入,请关闭此项。
|-
| '''地址'''和'''世界(Universe)''' || 样条第一个固定装置的地址和所在世界。其余固定装置以此为基准计算。
|-
| '''分布类型''' || “均匀”(Uniform)——固定装置分布在整条线的长度上,数量由您设定。“固定像素”(Fixed Pixels)——每个顶点放置一个固定装置,固定装置数量等于顶点数量;此模式下“固定装置数量”参数不起作用。
|-
| '''固定装置数量''' || 样条上有多少个固定装置(均匀分布时使用)。
|-
| '''地址偏移''' || 样条上相邻固定装置之间跳过多少个通道。通常为0:地址紧密相连。当实际固定装置有部分通道未使用时,需要设置大于零的值。
|-
| '''反转''' || 反转固定装置的顺序:第一个变为最后一个。如果动画沿线条运行的方向与实际物体上的方向相反,请点击此项。
|-
| '''固定装置类型''' || 显示当前固定装置名称的按钮。点击可打开[[固定装置库]]——这样就能更改已创建样条的类型。
|-
| '''跳转到3D固定装置''' || 跳转到“3D视图”(3D View)窗口中关联的对象。只有存在这种关联时该按钮才可用(参见[[2D 与 3D 的关联]])。
|}

如果样条上的固定装置在一个世界中放不下,多出的部分会像单个固定装置一样自动转移到下一个世界。

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

* '''移动、旋转、缩放。''' 使用“选择并移动”工具:拖动选框可移动,拖动角点可缩放,拖动侧边手柄可旋转。详情见文章[[Мышь, выделение и перемещение]],关于尺寸和角度的内容见文章[[Изменение размера и вращение приборов]]。
* '''调整线条形状。''' 双击样条(或点击“编辑样条”(Edit Spline)按钮)会进入顶点编辑模式:用鼠标移动顶点,在线条附近点击可添加顶点,按“Delete”键可删除顶点——最后两个顶点无法删除。如果选中端点并在线条之外点击,样条会继续延伸:之前绘制的线条可以随时接着画下去。按“Enter”或“Esc”退出该模式。
* '''删除多余的顶点。''' 在顶点编辑模式下右键点击 → “删除多余的点”(Remove Redundant Points):该命令会删除不改变线条方向的顶点。在快速凭手感绘制之后很有用。
* '''分配地址。''' 如果固定装置是在未选择端口的情况下创建的,请在“固定装置”窗口中将其拖入设备的端口(参见[[固定装置的地址分配]])。

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

并非每次都需要手动逐个绘制固定装置。

; 拖拽复制
: 按住“Ctrl”拖动选中的固定装置——新位置会出现一份设置相同的副本。“Ctrl+D”同样可以复制所选内容。
; 复制(Duplicate)
: 该工具可以一次性按固定步长生成一整排副本。选中固定装置或样条并点击“复制”——按钮下方会打开一个参数窗口:“数量”(Count)、“地址偏移”(Address Offset)、“X偏移”(X Offset)、“Y偏移”(Y Offset),以及复选框“蛇形模式”(Snake Mode)和“拆分世界”(Split Universes)。“应用”(Apply)按钮用于创建副本,“取消”(Cancel)按钮用于关闭窗口。这样就能一次性得到一排相同的灯条或一整块像素矩阵。
; 转换为样条 / 转换为固定装置
: 将若干选中的单个固定装置合并为一个样条,或将样条重新拆分为单个固定装置。当布局已经完成、但用另一种方式处理更方便时,这个功能很有用。
; 从3D场景转移
: 如果场景是在映射之前搭建的,就不需要重新绘制固定装置:“3D视图”窗口工具栏上的“魔法2D按钮”(Magic 2D Button)会根据场景中的样条和固定装置在映射上创建固定装置,并立即将它们相互关联起来。已经转移到映射上的固定装置不会被重复转移。参见[[添加3D样条]]和[[2D 与 3D 的关联]]。
; 导入DXF
: 在制图软件中准备好的布局可以整体导入:“文件 → 导入 → Dxf”(File → Import → Dxf)。

== 常见问题 ==

* '''点击场地不会创建固定装置。''' 当前激活的是其他工具。例如,“创建布局”(Create Layout)会在场地上绘制布局矩形,而不是固定装置;请点击“添加固定装置”或“添加样条”。
* '''固定装置类型选择按钮无法点击。''' 该按钮只有在添加工具激活时才可用。要更改已创建固定装置的类型,可通过其属性中的“固定装置类型”参数进行。
* '''所有固定装置的地址都变成了1。''' “自动分配地址”已关闭。开启它后继续放置固定装置,并在“属性”窗口中为已创建的固定装置手动设置地址。
* '''样条上的固定装置太多。''' 默认数量为100。选中样条,在“固定装置数量”参数中设置所需数量。
* '''固定装置排列不整齐。''' 在工具栏上开启“吸附到网格”以对齐新建固定装置,并在样条属性中开启“像素吸附”以对齐线条上的固定装置。绘制时按住“Shift”可得到笔直的线段。
* '''按“Enter”无法完成样条绘制。''' 只放置了一个顶点。请再点击一次,然后重新按“Enter”。
* '''“复制”按钮无法点击。''' 没有选中任何内容:该工具只能复制选中的固定装置或样条。
* '''固定装置已创建,但不亮。''' 请检查它是否落在带有效果的布局范围内:位于带效果布局之外的固定装置会保持熄灭状态(参见[[创建和修改布局]]和[[在合成中添加效果]])。