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

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

库不属于某个项目,而是属于程序本身:一旦某个固定装置被加入库中,本机上的所有项目都可以使用它。关于固定装置种类之间的区别以及通道含义,参见[[Fixture Kinds and Types]]。

== 如何打开库 ==

窗口可以用三种方式打开:

* '''Settings → Fixture Library'''(设置 → 固定装置库)菜单——随时可用;
* '''Mapping'''(映射)窗口工具栏上显示当前固定装置名称的按钮。当选中'''Add Fixture'''(添加固定装置)或'''Create Spline'''(创建样条)工具时该按钮可用,它显示新建固定装置将使用的类型(新项目中默认为'''RGB''');
* 所选固定装置或样条的'''Properties'''(属性)窗口中的'''Fixture Type'''(固定装置类型)参数——按钮上标注的是当前分配给它的固定装置名称。

库窗口不会阻塞程序:您可以让它保持打开状态,继续在映射上工作。可通过关闭按钮或'''Esc'''键关闭它。无法打开第二个此类窗口——再次调用只会将已打开的窗口置于前台。哪些分区是展开的、哪些是折叠的,程序会记住,直到下次打开为止。

== 库的分区 ==

窗口左侧是一个包含四个分区的树状列表。每个固定装置的名称旁都会显示其图片。

{| class="wikitable"
! 分区 !! 包含内容 !! 是否可编辑
|-
| '''LED Fixtures'''(LED 固定装置) || 程序的标准固定装置,按'''LED Pixels'''(LED 像素)、'''LED Wallwasher'''(LED 洗墙灯)和'''LED Spotlight'''(LED 射灯)分组——三种发光方式使用相同的通道组合('''RGB'''、'''RGBW'''、单色白) || 否,仅可选择和复制
|-
| '''Manufacturers'''(厂商) || 按厂商分组的真实型号现成描述:线性洗墙灯、射灯、像素灯条、旋转固定装置 || 否,仅可选择和复制
|-
| '''My Fixtures'''(我的固定装置) || 您自己创建或从其他分区复制过来的固定装置的简单列表 || 是
|-
| '''Used in Project'''(项目中使用) || 分配给当前项目中固定装置的描述。该分区自动填充 || 否,仅可选择和复制
|}

标准固定装置和厂商固定装置受保护、不可修改:选中它们时,右侧字段将被锁定。要获得工厂固定装置的自有版本,请将其复制到'''My Fixtures'''(我的固定装置)。

== 所选固定装置显示哪些信息 ==

在树中选中固定装置后,右侧会打开其描述。顶部是固定装置名称,下方有两个区块。

'''3D Preview'''(3D 预览)——固定装置在三维场景中的外观和发光效果:

{| class="wikitable"
! 参数 !! 含义
|-
| '''Fixture Beam Type'''(光束类型) || 固定装置的种类:像素、线性或射灯
|-
| '''Length'''(长度)、'''Angle°'''(角度)、'''Depth'''(深度)、'''Height'''(高度)、'''Size'''(尺寸) || 光束的尺寸。字段组合取决于所选的光束类型——射灯是角度和高度,线性固定装置是长度、角度和深度
|}

旁边是固定装置的图片和'''Change Image'''(更改图片)链接,通过它可以为您自己的固定装置更换任意图片。

'''DMX Settings'''(DMX 设置)——固定装置在控制线路一侧的表现:

{| class="wikitable"
! 参数 !! 含义
|-
| '''Channel Count'''(通道数量) || 一台固定装置占用多少个 DMX 通道
|-
| 通道表 || 通道的序号和用途。行的顺序即通道顺序:第一行对应固定装置的地址,第二行对应下一个地址,依此类推
|-
| '''Moving Fixture'''(旋转固定装置) || 带有 pan/tilt 旋转机构的固定装置会勾选此项
|-
| '''Pan, min / max'''、'''Tilt, min / max'''(Pan/Tilt 最小/最大值) || 以度为单位的旋转范围限制。'''PAN TILT Animation'''(PAN TILT 动画)效果会用到这些值
|}

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

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

对于您即将绘制的固定装置:

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

对于项目中已有的固定装置:

# 在'''Mapping'''(映射)界面或'''Fixtures'''(固定装置)窗口中选中所需的固定装置或样条。
# 打开库:通过'''Settings → Fixture Library'''(设置 → 固定装置库)菜单,或'''Properties'''(属性)窗口中的'''Fixture Type'''(固定装置类型)按钮。
# 在树中选中新的固定装置,点击'''Select Fixture'''(选择固定装置)。

新类型会立即应用到所有选中的固定装置。如果新类型的通道数量增多或减少,端口中的地址需要重新计算:启用'''Auto-Patching'''(自动配接)时会自动完成,否则需要手动调整地址——参见[[Патчинг приборов]]。

只有在有对象可供应用选择时,'''Select Fixture'''(选择固定装置)按钮才可用:即激活了添加固定装置的工具,或映射上选中了当前类型不同的固定装置。

== 将固定装置复制到“我的固定装置” ==

出厂固定装置无法修改,但可以制作副本并编辑副本。选中固定装置并调用'''Copy to Personal'''(复制到个人库)——可通过窗口底部的按钮、'''Edit'''(编辑)菜单中的选项,或在固定装置上右键点击。副本会出现在'''My Fixtures'''(我的固定装置)分区中,名称后附加''Copy''字样,并立即被选中——接下来只需重命名并调整通道。

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

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

'''Create'''(创建)菜单会在'''My Fixtures'''(我的固定装置)中添加一个新模板:

* '''Fixture'''(固定装置)——包含三个通道的描述:红、绿、蓝;
* '''Moving Head'''(摇头灯)——包含 pan/tilt 旋转通道('''pan'''、'''pan fine'''、'''tilt'''、'''tilt fine''')的描述,并已勾选'''Moving Fixture'''(旋转固定装置),'''Pan'''范围为 0–540°,'''Tilt'''范围为 0–180°。

新固定装置会立即被选中,可在右侧进行配置。详情参见[[Создание пользовательских приборов]]。

只能从'''My Fixtures'''(我的固定装置)分区删除固定装置:选中固定装置后按'''Delete'''或'''Backspace'''键,或通过右键菜单或'''Edit'''(编辑)菜单选择'''Delete'''(删除)。程序会要求确认删除。

从库中删除固定装置不会破坏已经使用它的项目:固定装置的描述同时也保存在项目文件内部,因此这些固定装置会继续正常工作,其描述仍会显示在'''Used in Project'''(项目中使用)分区中。

== 保存库 ==

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

程序会在两种情况下提醒您保存:

* 关闭有未保存更改的窗口时,会出现提示'''Save library?'''(是否保存库?)——'''Yes'''(是)保存更改,'''No'''(否)将库恢复到打开窗口时的状态,'''Cancel'''(取消)使窗口保持打开;
* 在有未保存更改的情况下点击'''Select Fixture'''(选择固定装置)时,会出现提示'''The library must be saved before selecting a fixture, save it?'''(选择固定装置前必须保存库,是否保存?)——'''Yes'''(是)保存库并应用所选固定装置,'''Cancel'''(取消)返回窗口且不做更改。

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

== 库与项目 ==

正在使用的固定装置描述不仅保存在程序库中,也保存在项目文件本身之中。固定装置一经分配,其描述就会加入'''Used in Project'''(项目中使用)分区,并随项目一起保存。因此,即使在另一台电脑上打开项目,即便该电脑的库中没有这个固定装置,项目也能正常工作。

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

== 常见问题 ==

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