查看“属性”的源代码

[[ru:Properties]] [[en:Properties]] [[zh:属性]]
'''属性'''(Properties)窗口是一个统一的参数面板:它显示当前选中对象的所有可配置内容。选中一个固定装置(Fixture)——你会看到它的地址(Address)和宇宙(Universe);选中一个转换器(Converter)——它的网络设置;选中一个效果(Effect)——它的参数;打开一个合成(Composition)——它的时长。Light Stream 中并没有为每种对象类型单独设置窗口:所有内容都汇集在同一个地方,窗口内容会随选择而变化。

不要把'''属性'''窗口和程序的设置混淆:菜单项'''设置'''(Settings) → '''属性'''('''Ctrl+P''')会打开 Light Stream 的常规设置,相关内容见文章 [[Settings]]。

== 窗口位置 ==

在默认工作区(Workspace)中,'''属性'''窗口位于屏幕左侧,在'''合成'''和'''固定装置'''窗口下方。窗口之间的边界可以用鼠标拖动:如果参数太多放不下,可以增加窗口高度或滚动列表。

该窗口无法关闭,但可以隐藏后再调出——菜单'''窗口'''(Window) → '''属性'''。和程序中其他窗口一样,'''属性'''窗口可以通过标题栏拖到别处、与相邻窗口合并为标签页,或者独立成浮动窗口。窗口布局会保存在工作区中,参见 [[Workspace]]。

当没有任何选中内容时,窗口是空的——这是正常现象,不代表出错。

== 窗口中显示的内容 ==

{| class="wikitable"
! 选中的对象 !! 在哪里选中 !! 属性窗口显示的内容
|-
| 单个固定装置或样条(Spline) || '''映射'''(Mapping)窗口,或'''固定装置'''窗口中的固定装置列表 || 名称、可见性、地址分配、固定装置类型;样条还会显示固定装置在其上的分布方式
|-
| 转换器 || '''固定装置'''窗口 || 网络设置和宇宙设置
|-
| 转换器端口(Port) || '''固定装置'''窗口 || 端口名称
|-
| Light Stream Player || '''固定装置'''窗口 || 网络地址、登录信息以及设置交换按钮
|-
| 效果 || '''时间线'''(Timeline)或'''映射'''窗口 || 混合模式(Blend Mode)、不透明度以及该效果的全部参数
|-
| 合成 || 在'''合成'''窗口中双击某个合成 || 名称、时长、循环模式、备注和颜色过滤
|-
| 布局(Layout) || '''映射'''或'''时间线'''窗口 || 布局的位置和大小
|-
| 3D 对象(3D Object)、摄像机(Camera)、投影(Projection) || '''3D 视图'''(3D View)或'''3D 对象'''窗口 || 尺寸、位置、旋转以及该对象自身的设置
|}

程序中的选择是联动的:在'''固定装置'''窗口中选中一个固定装置,也会同时在'''映射'''窗口中选中它,反之亦然——两种情况下,'''属性'''窗口显示的都是同一个固定装置。

== 通用规则 ==

* 数值会立即生效,窗口中没有"确定"和"应用"按钮。
* 数值可以通过键盘输入,也可以用字段右侧的箭头调整。
* 属性被分为几个区块——'''常规'''(General)、'''宇宙设置'''(Universe Settings)、'''授权'''(Authorization)、'''颜色过滤'''(Color Filtering)。具体显示哪些区块取决于当前选中的内容。
* 如果同时选中了多个对象,窗口会显示其中一个对象的属性,但修改会立即应用到所有选中的对象。例外是'''名称'''(Name):只有属性正被打开查看的那个对象才会获得新名称。
* 属性的组成还取决于对象自身的设置。例如,使用 sACN 协议的转换器会用"组播(Multicast)"代替"广播(Broadcast)";而分布方式为"固定像素"的样条,其"固定装置数量"字段将不再起作用。

== 固定装置属性 ==

单个固定装置就是映射上的一个像素或一个灯具。它显示的是'''常规'''区块。

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称''' || 固定装置的名称。固定装置会以此名称显示在'''固定装置'''窗口以及端口的固定装置列表中
|-
| '''可见性''' || 固定装置不再显示在'''映射'''和'''3D 视图'''窗口中,其通道值会归零——不会向真实灯具发送任何数据。此时固定装置不会从端口中移除,仍保留其地址
|-
| '''地址''' || 固定装置在宇宙内的起始 DMX 地址
|-
| '''宇宙''' || 固定装置所在宇宙的编号
|-
| '''固定装置类型''' || 显示当前类型名称的按钮。点击会打开[[固定装置库|固定装置库]],可以在其中选择其他类型——例如将 RGB 改为 RGBW
|-
| '''转到 3D 固定装置''' || 跳转到关联的 3D 固定装置的按钮。仅当存在 3D 关联时才可用;如果关联了多个固定装置,程序会提示从列表中选择
|}

通常不需要手动设置地址和宇宙:开启自动地址分配(patching)后,程序会在固定装置被移入端口时自动重新计算。只有在需要按已安装好的设备来设定地址时,才需要手动修改。

== 样条属性 ==

样条(Spline)——承载多个固定装置的一条线——同样显示'''常规'''区块,但参数更多。'''名称'''、'''可见性'''、'''地址'''、'''宇宙'''、'''固定装置类型'''和'''转到 3D 固定装置'''的工作方式与单个固定装置相同:地址和宇宙对应样条上的第一个固定装置,其余固定装置依此顺推计算。此外还有以下参数:

{| class="wikitable"
! 参数 !! 作用
|-
| '''平滑''' || 样条变为平滑曲线而非折线。固定装置会立即按新形状重新排列
|-
| '''吸附像素''' || 样条上的固定装置精确对齐到映射的像素网格。关闭后,固定装置沿线自由分布,不再对齐网格
|-
| '''分布类型''' || '''均匀''' —— 设定数量的固定装置沿样条全长均匀分布。'''固定像素''' —— 固定装置按网格单元放置,数量由样条长度决定
|-
| '''固定装置数量''' || 样条上有多少个固定装置。仅在'''均匀'''分布下起作用;在'''固定像素'''模式下,数量由线段长度计算得出,该字段不起任何作用
|-
| '''地址偏移''' || 样条上相邻固定装置之间额外的通道间隔。为 0 时,固定装置依次相连,通道紧接通道。当设备要求固定装置之间的间距大于其通道数时会用到
|-
| '''反转''' || 翻转地址分配方向:第一个固定装置变为最后一个。用于修正接反了(从"另一端"接入)、动画播放方向相反的线路
|}

除名称外,以上所有参数会同时应用到所有选中的样条。这是修改整组线路的固定装置数量或固定装置类型最快的方法:在映射上用框选选中它们,设置一次数值即可。

== 转换器属性 ==

转换器在'''固定装置'''窗口中选中。它的属性是 Light Stream 向设备发送数据方式的设置;物理设备本身的配置是另外进行的,参见 [[Light Stream Converter 配置]]。

'''常规'''区块:

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称''' || 转换器在项目中的名称。名称必须各不相同:重名会影响向 Player 导出设置
|-
| '''可见性''' || 关闭可见性的转换器不会接收数据——它所有端口都会输出零值。固定装置本身仍保留在原来的位置和地址上
|-
| '''协议''' || '''Art-Net''' 或 '''sACN'''
|-
| '''控制器类型''' || '''DMX''' 或 '''SPI'''。这决定了端口内固定装置地址的计算方式
|-
| '''广播''' || 数据以广播方式发送给网络中的所有设备。使用 '''Art-Net''' 协议时显示
|-
| '''Multicast''' || 组播方式发送。使用 '''sACN''' 协议时显示
|-
| '''IP 地址''' || 数据发送的目标设备地址。仅在关闭广播时设置
|-
| '''端口''' || 发送使用的网络端口。只有特殊情况下才需要修改
|-
| '''使用自定义网络接口''' || 允许该转换器通过指定的网卡发送数据,而不是使用项目的公共网卡
|-
| '''网卡''' || 为该转换器选择网卡。仅在启用自定义网络接口时可用
|}

'''宇宙设置'''区块:

{| class="wikitable"
! 参数 !! 作用
|-
| '''起始宇宙''' || 第一个端口的宇宙编号。其余端口的宇宙按顺序依此计算
|-
| '''端口数量''' || 项目中该转换器的端口数量。不能设置得比实际设备的端口数更多
|-
| '''每端口宇宙数''' || 一个端口占用多少个宇宙。这会影响一个端口能容纳多少固定装置
|-
| '''发送空端口''' || 即使端口内没有任何固定装置,也会发送数据
|}

有两个设置需要谨慎修改:

* '''起始宇宙''' 会将该转换器所有固定装置的宇宙整体偏移相同的量。当需要在整体地址方案中移动整台设备时很方便,但偏移后固定装置会落入不同的宇宙。
* 减小'''端口数量'''会连同其地址分配(patching)一起删除多余端口:被删除端口中的固定装置会返回到通用列表中,变为未分配状态。固定装置本身及其在映射上的位置不会丢失。

== 端口属性 ==

端口在'''属性'''窗口中只能设置'''名称'''。像"正面,左侧"这样清晰易懂的名称,有助于在地址分配和安装施工时不会把端口搞混。

其余内容都是从"上层"传递到端口的,需要在别处设置:

* 端口的宇宙编号由转换器的'''起始宇宙'''和'''每端口宇宙数'''参数计算得出;
* 端口的可见性通过'''固定装置'''窗口中端口旁的复选框切换——隐藏的端口会输出零值;
* 固定装置的组成通过把固定装置拖入端口来设置,参见 [[固定装置的地址分配]]。

== Light Stream Player 属性 ==

项目中始终存在 '''Light Stream Player''',在'''固定装置'''窗口中点击它即可打开其属性。

{| class="wikitable"
! 区块 !! 参数 !! 作用
|-
| '''常规''' || '''名称''' || 该设备在项目中的名称
|-
| '''常规''' || '''IP 地址''' || 播放器的网络地址。默认值为 192.168.0.205
|-
| '''授权''' || '''用户名''' 和 '''密码''' || 登录播放器所需的信息。密码旁有一个按钮,可以显示或隐藏已输入的字符
|-
| '''授权''' || '''导入 / 导出设置''' || 该按钮会打开设置交换窗口:项目中的宇宙和设备会被发送到播放器,也可以反向取回已配置好的播放器的设置
|-
| '''内部转换器''' || '''使用内部转换器''' || 启用播放器自身内置的宇宙。此参数关闭时,内置宇宙不占用许可证容量,也不会与其他转换器检查编号冲突
|}

播放器完整的参数列表及配置步骤见文章 [[Light Stream Player 设置]]。

== 效果属性 ==

在'''时间线'''或映射上选中一个效果——'''属性'''窗口会完全用于显示它。窗口顶部是效果的通用信息栏:

* '''效果名称''' —— 位于左侧,加粗显示。
* '''混合模式''' —— 一个下拉列表:决定该效果如何叠加在其下方的内容之上。右键点击该列表会将模式重置为'''普通'''(Normal)。详情见文章 [[混合模式]]。
* '''齿轮图标''' —— 打开效果设置窗口:大小、镜像、旋转、缩放和偏移,包括时间偏移。参见 [[Настройки эффектов]]。
* '''不透明度''' —— 控制效果整体透明度的滑块。

下方是该效果自身的参数——每个效果各不相同:速度、颜色、元素数量、方向等等。参数旁边有一个秒表图标(启用关键帧)和一个 '''L''' 按钮(通过 OSC、MIDI、DMX 实现的函数和外部控制)。具体用法见文章 [[关键帧与效果参数]]。

如果效果的参数很多而窗口又比较窄,可以拉宽窗口:所有元素都会按窗口大小成比例缩放。

== 合成属性 ==

在'''合成'''窗口中双击某个合成后,它会自动显示在'''属性'''窗口中。此时会显示两个区块:

* '''常规''' —— '''名称'''、'''时长'''(以"时:分:秒:帧"格式显示数值的按钮)、'''无限'''、'''循环'''和'''备注'''。
* '''颜色过滤''' —— 四个滑块:'''红'''、'''绿'''、'''蓝'''和'''白''',用于减弱对应的固定装置通道。

以上内容在文章 [[合成设置]] 中有详细说明。

如果'''属性'''窗口当前显示的是效果或固定装置的参数,只需在'''合成'''窗口中再次双击该合成,即可切换回合成设置。

== 常见问题 ==

'''窗口是空的。''' 没有选中任何内容,或者点击了空白处导致选择被取消。再次点击所需的对象即可。

'''窗口中显示的属性不对。''' 窗口显示的是最近一次的选择,而选择在整个程序中是共享的:点击时间线上的效果会把固定装置的属性从窗口中挤出去,打开合成会挤掉效果的属性。请重新选中所需的对象。

'''修改应用到了错误的固定装置上。''' 如果同时选中了多个固定装置,所有选中的固定装置都会获得该数值。点击空白处取消多余的选择,只保留所需的那一个固定装置。

'''固定装置在实体上不亮,但程序里的动画在正常播放。''' 依次检查'''可见性''':固定装置本身、端口(在'''固定装置'''窗口中的复选框)以及转换器。其中任何一处关闭,都会导致输出数据归零。

'''参数显示不全。''' 拖动'''属性'''窗口与相邻窗口之间的边界,或将'''属性'''窗口拆分为独立的浮动窗口——这样可以为效果参数留出更多空间。

== 另请参阅 ==

* [[Settings]]
* [[Workspace]]
* [[固定装置的地址分配]]
* [[固定装置的种类和类型]]
* [[样条和单个固定装置]]
* [[合成设置]]
* [[关键帧与效果参数]]
* [[Настройки эффектов]]
* [[3D对象]]
* [[Терминология]]