查看“固定装置库”的源代码

[[ru:Библиотека приборов]] [[en:Fixture Library]] [[zh:固定装置库]]
'''固定装置库'''（Fixture Library）是整个程序共用的固定装置描述列表。从这里为项目中的每个元素选择要使用的固定装置类型：它有多少个通道、每个通道代表什么，以及该固定装置在'''3D 查看'''（3D View）窗口中如何发光。库中包含标准像素固定装置、真实厂商型号的现成描述，以及您自己创建的固定装置。

该库并不与项目绑定，而是与程序本身绑定：一旦某个固定装置被加入库中，它就会在这台电脑上的所有项目中可用。关于固定装置的种类和类型有何区别、通道又代表什么，请参见[[Виды и типы приборов]]。

== 如何打开库 ==

该窗口可以通过三种方式打开：

* 菜单'''设置'''（Settings）→ '''固定装置库''' — 随时可用；
* '''映射'''（Mapping）窗口工具栏上显示当前固定装置名称的按钮。该按钮仅在选中'''添加固定装置'''（Add Fixture）或'''添加样条'''（Add Spline）工具时可用，并显示新固定装置将采用的类型（在新项目中为'''RGB'''）；
* 所选固定装置或样条的'''属性'''（Properties）窗口中的'''固定装置类型'''（Fixture Type）参数——按钮上标注的是当前分配给它的固定装置名称。

库窗口不会阻塞程序：可以让它保持打开状态，同时继续在映射上工作。关闭方式是点击关闭按钮或按'''Esc'''键。无法打开第二个这样的窗口——再次调用只会将已打开的窗口带到最前面。哪些分区被展开、哪些被折叠，程序会记住，直到下次打开为止。

== 库的分区 ==

窗口左侧是一个由四个分区组成的树状结构。每个固定装置的名称旁都会显示其图片。

{| class="wikitable"
! 分区 !! 包含内容 !! 是否可修改
|-
| '''LED 固定装置'''（LED Fixtures） || 程序的标准固定装置，按组排列：针对三种发光方式（像素、线性固定装置、射灯）的简单通道组合（'''RGB'''、'''RGBW'''、单色白光） || 否，只能选择和复制
|-
| '''制造商'''（Manufacturers） || 按厂商分组的真实型号现成描述 || 否，只能选择和复制
|-
| '''我的固定装置'''（My Fixtures） || 您自己创建或从其他分区复制到此处的固定装置的简单列表 || 是
|-
| '''项目中使用'''（Used in Project） || 分配给当前项目中固定装置的描述。该分区自动填充 || 否，只能选择和复制
|}

标准固定装置和厂商固定装置受到保护，不能修改：选中它们时，右侧的字段会被锁定。要获得出厂固定装置的自定义版本，请将其复制到'''我的固定装置'''中。

窗口中没有搜索框：需要展开'''制造商'''分区及其内部的分组来查找所需型号。如果其中没有对应型号，可以选用相近的型号，或自行描述固定装置——见下文。

== 所选固定装置显示的内容 ==

在树状结构中选中某个固定装置后，右侧会立即打开它的描述。顶部是固定装置的名称，下方有两个区块。

'''3D 预览'''（3D Preview）——固定装置在三维场景中的外观和发光方式：

{| class="wikitable"
! 参数 !! 含义
|-
| '''光束类型'''（Beam type） || 固定装置种类：'''像素'''（Pixel）、'''线性'''（Linear）或'''射灯'''（Spot）
|-
| '''长度'''（Length）、'''角度°'''（Angle°）、'''深度'''（Depth）、'''高度'''（Height）、'''大小'''（Size） || 光束尺寸。字段的组合取决于所选的光束类型：射灯有角度和高度，线性固定装置有长度、角度和深度
|}

旁边是固定装置的图片和'''更改图片'''（Change Image）链接，通过它可以将自己固定装置的图片替换为任意自选图片。

'''DMX 设置'''（DMX Settings）——固定装置在控制线一侧的表现：

{| class="wikitable"
! 参数 !! 含义
|-
| '''通道数量'''（Number of Channels） || 一个固定装置占用多少个DMX通道
|-
| 通道表 || 通道的序号和用途。行的顺序即通道顺序：第一行对应固定装置的地址，第二行对应下一个地址，依此类推
|-
| '''旋转固定装置'''（Rotating fixture） || 具有旋转机构的固定装置会勾选此项
|-
| '''Pan（水平旋转），最小/最大'''、'''Tilt（垂直倾斜），最小/最大''' || 以度为单位的旋转限制。'''PAN TILT 动画'''（PAN TILT Animation）效果会用到这些限制
|}

将这份描述与真实固定装置的说明书对照非常方便：如果通道数量及其顺序与固定装置本身所设置的DMX模式一致，固定装置就会正常工作。

== 如何从库中分配固定装置 ==

对于您正准备绘制的固定装置：

# 在'''映射'''窗口的工具栏上选择'''添加固定装置'''或'''添加样条'''。
# 点击旁边显示当前固定装置名称的按钮——库将会打开。
# 在树状结构中找到所需的固定装置并选中它。
# 点击窗口右下角的'''选择固定装置'''（Select Fixture）。
# 工具栏上的按钮会显示新的名称。此后绘制的所有固定装置和样条都将是该类型。

对于项目中已存在的固定装置：

# 在'''映射'''区域或'''固定装置'''（Fixtures）窗口中选中所需的固定装置或样条。
# 打开库：菜单'''设置'''→'''固定装置库'''，或'''属性'''窗口中的'''固定装置类型'''按钮。
# 在树状结构中选中新的固定装置，然后点击'''选择固定装置'''。

新类型会立即应用到所有选中的固定装置。如果新类型的通道数量发生了变化，端口上的地址就需要重新计算：启用'''自动分配地址'''（Auto Patching）时会自动完成，否则需要手动调整地址——见[[固定装置的地址分配]]。

'''选择固定装置'''按钮只有在存在可应用对象时才能点击：即已激活添加固定装置的工具，或在映射上选中了当前类型不同的固定装置。

== 将固定装置复制到'''我的固定装置'''中 ==

出厂固定装置无法修改，但可以对其进行复制，然后编辑副本。选中固定装置后调用'''复制到个人库'''（Copy to Personal）——可通过窗口底部的按钮、'''编辑'''（Edit）菜单中的相应项，或在固定装置上单击右键实现（'''项目中使用'''分区没有右键菜单，请使用按钮或菜单）。副本会出现在'''我的固定装置'''分区中，名称后附加''Copy''，并立即被选中——接下来只需重命名并调整通道即可。

从'''项目中使用'''分区复制固定装置的方式相同。当项目来自另一台电脑时这很有用：如果项目中使用了您库中没有的固定装置，复制操作会为您保存这份描述，之后就可以在其他项目中分配使用它。

== 创建和删除固定装置 ==

'''创建'''（Create）菜单会在'''我的固定装置'''中添加一个新的模板：

* '''固定装置'''（Fixture）——具有三个通道（红、绿、蓝）的描述，名为''RGB''；
* '''摇头灯'''（Moving Head）——具有旋转通道（'''pan'''、'''pan fine'''、'''tilt'''、'''tilt fine'''）的描述，名为''Move head''，已勾选'''旋转固定装置'''复选框，'''Pan'''限制为0–540°，'''Tilt'''限制为0–180°。

模板会出现在'''我的固定装置'''分区的末尾——选中它，右侧就会打开供配置的字段。详情见[[Создание пользовательских приборов]]。

删除固定装置只能在'''我的固定装置'''分区中进行：选中固定装置后按'''Delete'''或'''Backspace'''键，或通过右键菜单或'''编辑'''菜单选择'''删除'''。程序会要求确认删除。

从库中删除固定装置不会破坏已经分配了它的项目：固定装置的描述同时也保存在项目文件内部，因此固定装置会继续正常工作，其描述也会保留在'''项目中使用'''分区中可见。

== 保存库 ==

您在窗口中所做的一切——创建、复制、删除、编辑通道——最初都只存在于打开的窗口中。要使更改永久生效，请执行'''文件'''（File）→ '''保存库'''（Save Library）。

程序会在两种情况下主动提醒您保存：

* 在有未保存更改的情况下关闭窗口时，会出现'''保存库？'''的提示——'''是'''会保存更改，'''否'''会将库恢复到窗口打开时的状态，'''取消'''会使窗口保持打开；
* 在有未保存更改的情况下点击'''选择固定装置'''时，会出现'''选择固定装置前需要先保存库，是否保存？'''的提示——'''是'''会保存库并应用所选固定装置，'''取消'''会返回窗口且不做任何更改。

保存库与保存项目无关：这是两个独立的操作，一个不能替代另一个。保存时，对固定装置描述的更改会应用到项目中所有分配了该固定装置的对象：例如，如果修改了通道数量，项目中的固定装置将占用新的地址数量。

== 库与项目 ==

已使用的固定装置的描述不仅保存在程序的库中，也保存在项目文件本身之中。固定装置一经分配，其描述就会被添加到'''项目中使用'''分区，并随项目一起保存。因此，即使在另一台电脑的库中没有该固定装置，项目在那台电脑上打开时依然能正常工作。

'''项目中使用'''分区会自动保持最新状态：当某个固定装置不再被使用时——例如您更改了所有使用该固定装置的类型——其描述会从项目中移除。

== 常见问题 ==

* '''“选择固定装置”按钮点不了。''' 没有选中添加固定装置的工具，映射上也没有选中任何固定装置，或者所有选中的固定装置已经是该类型。
* '''右侧字段呈灰色，无法修改任何内容。''' 选中的是'''LED 固定装置'''、'''制造商'''或'''项目中使用'''分区中的固定装置——它们受保护，无法修改。请将固定装置复制到'''我的固定装置'''中再编辑副本。
* '''重启程序后，我的固定装置消失了。''' 更改没有被保存。只有'''文件'''→'''保存库'''（或在关闭窗口时的提示中回答'''是'''）才能使库中的修改永久生效。
* '''库中没有所需的型号。''' 以相近的固定装置为基础，将其复制到'''我的固定装置'''中，并根据说明书调整通道——见[[Создание пользовательских приборов]]。对于普通的像素灯带或灯条，不需要单独的描述：'''LED 固定装置'''分区中的标准固定装置即可满足需求。
* '''“制造商”分区中的某个型号有几行名称相似的条目。''' 这些是同一型号的不同DMX模式。请选择固定装置本身所设置的那一个，否则通道会对应错乱。
* '''固定装置占用的地址数量与预期不符。''' 请查看所选固定装置的'''通道数量'''：一个固定装置将占用相应数量的DMX地址。