查看“属性”的源代码

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

不要把'''属性'''窗口和程序设置混淆：菜单项'''设置'''（Settings）→ '''属性'''（'''Ctrl+P'''）会打开 Light Stream 的通用设置，详见 [[设置]] 一文。

== 窗口位置 ==

在默认工作区（Workspace）中，'''属性'''窗口位于屏幕左侧，紧邻'''合成'''（Compositions）、'''固定装置'''（Fixtures）和'''3D物体'''（3D Objects）窗口。窗口之间的边界可以用鼠标拖动：如果参数太多放不下，可以放大窗口或滚动列表。

该窗口无法关闭，但可以隐藏并重新显示——菜单'''窗口'''（Window）→ '''属性'''。和程序中其他窗口一样，'''属性'''窗口可以通过拖动标题栏移动到其他位置、与相邻窗口合并为选项卡，或者独立为浮动窗口。窗口布局会保存在工作区中，参见 [[Workspace]]。

当没有选中任何对象时，窗口为空——这是正常现象，不代表出错。

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

{| class="wikitable"
! 选中内容 !! 在何处选中 !! “属性”窗口显示的内容
|-
| 单个固定装置 || '''映射'''（Mapping）窗口或'''固定装置'''窗口中的固定装置列表 || 名称、可见性、地址分配、固定装置类型、跳转到关联的3D固定装置
|-
| 样条（Spline） || '''映射'''窗口或'''固定装置'''窗口中的固定装置列表 || 与上相同，并额外显示固定装置沿线的分布
|-
| 转换器 || '''固定装置'''窗口 || 网络设置和宇宙设置
|-
| 转换器端口 || '''固定装置'''窗口 || 端口名称
|-
| '''Light Stream Player''' || '''固定装置'''窗口 || 网络地址和端口、登录凭据、设置交换、内部转换器
|-
| 布局（Layout） || '''映射'''窗口或'''时间轴'''（Timeline）窗口 || 混合模式、位置、大小及布局的背景图片
|-
| 效果 || '''时间轴'''窗口 || 混合模式、不透明度及效果的所有参数
|-
| 合成 || 在'''合成'''窗口中双击某个合成 || 名称、时长、循环模式、备注及颜色过滤
|-
| 3D物体、摄像机、投影 || '''3D视图'''（3D View）窗口或'''3D物体'''窗口 || 尺寸、位置、旋转及对象自身的设置
|}

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

== 通用规则 ==

* 数值会立即生效，窗口中没有'''确定'''（OK）和'''取消'''（Cancel）按钮。唯一的例外是布局的'''应用'''（Apply）按钮：它会根据输入的宽度和高度重新计算布局。
* 数值参数可以用键盘输入，也可以用字段右侧的箭头调整。按住'''Shift'''点击箭头时，步进值会增大十倍。
* 属性按分区显示——'''基本'''（General）、'''宇宙设置'''（Universe Settings）、'''授权'''（Authorization）、'''内部转换器'''（Internal Converter）、'''背景'''（Background）、'''颜色过滤'''（Color Filtering）。分区的组合取决于当前选中的内容；点击分区标题可以将其折叠。
* 如果同时选中多个对象，窗口显示的是最后选中对象的属性，但修改会立即应用到所有选中对象。例外是'''名称'''（Name）：只有属性窗口当前打开的那个对象才会获得新名称。
* 属性的组合还取决于对象自身的设置。例如，使用'''sACN'''协议的转换器会显示'''Multicast'''（组播）而不是'''广播'''（Broadcast），而分布方式为'''固定像素'''的样条则会禁用'''固定装置数量'''字段。

== 固定装置属性 ==

单个固定装置是映射上的一个像素或一个灯具。它会显示'''基本'''分区。

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称''' || 固定装置的名称。固定装置在'''固定装置'''窗口和端口的固定装置列表中都以此名称显示
|-
| '''可见性'''（Visibility） || 固定装置将不再显示在'''映射'''和'''3D视图'''窗口中，其通道值也会清零——不会向实际灯具发送任何数据。固定装置不会因此从端口中移除，其地址也会保留
|-
| '''地址'''（Address） || 固定装置在宇宙内的起始DMX地址
|-
| '''宇宙'''（Universe） || 固定装置所在的宇宙编号
|-
| '''固定装置类型'''（Fixture Type） || 显示当前类型名称的按钮。点击会打开[[固定装置库]]，可以在其中选择其他类型——例如将RGB改为RGBW
|-
| '''转到3D固定装置'''（Go to 3D Fixture） || 跳转到关联3D固定装置的按钮：该固定装置会在'''3D视图'''窗口中被选中，'''属性'''窗口随即显示它的参数。如果没有3D关联，该按钮不可用；如果关联了多个固定装置，程序会提示从列表中选择需要的一个
|}

通常不需要手动设置地址和宇宙：在启用自动地址分配的情况下，程序会在固定装置被移入端口后自动重新计算。只有在为已安装好的设备设置地址时，才需要手动修改。

== 样条属性 ==

样条（Spline）——同时承载多个固定装置的一条线——同样显示'''基本'''分区，但参数更多。'''名称'''、'''可见性'''、'''地址'''、'''宇宙'''、'''固定装置类型'''和'''转到3D固定装置'''的作用与单个固定装置相同：地址和宇宙对应样条上的第一个固定装置，其余固定装置以此为基准计算。此外还有以下参数：

{| class="wikitable"
! 参数 !! 作用
|-
| '''平滑'''（Smooth） || 样条变为平滑曲线而不是折线。固定装置会立即按新形状重新排列
|-
| '''吸附到像素'''（Snap to Pixels） || 样条上的固定装置会精确对齐到映射的像素网格。关闭后，固定装置沿线自由分布，不再对齐网格
|-
| '''分布类型'''（Distribution Type） || '''均匀'''（Even）——设定数量的固定装置沿样条全长均匀分布。'''固定像素'''（Fixed Pixels）——每个线条节点上放置一个固定装置，固定装置数量由节点数决定
|-
| '''固定装置数量'''（Fixture Count） || 样条上固定装置的数量。仅在分布方式为'''均匀'''时生效；在'''固定像素'''模式下，该字段显示线条的节点数，输入数值不会产生任何效果
|-
| '''地址偏移'''（Address Offset） || 样条上相邻固定装置之间通道的额外间隔。数值为0时，固定装置依次相连，通道紧接通道。适用于设备要求固定装置间距大于其通道数量的情况
|-
| '''反向'''（Reverse） || 反转地址分配方向：第一个固定装置变为最后一个。用于修正因接反方向而导致动画倒放的线路
|}

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

== 转换器属性 ==

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

'''基本'''分区：

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称''' || 转换器在项目中的名称。名称必须互不相同：重名会影响向'''Player'''导出设置
|-
| '''可见性''' || 禁用的转换器不会接收数据——其所有端口都会输出零值。固定装置仍会保留在原位置和地址上
|-
| '''协议'''（Protocol） || '''ArtNet''' 或 '''sACN'''
|-
| '''控制器类型'''（Controller Type） || '''DMX''' 或 '''SPI'''。这决定了端口中固定装置地址的计算方式
|-
| '''广播'''（Broadcast） || 数据以广播方式发送给网络中的所有设备。使用'''ArtNet'''协议时显示
|-
| '''Multicast'''（组播） || 组播方式发送。使用'''sACN'''协议时显示
|-
| '''IP地址'''（IP Address） || 数据发送到的设备地址。关闭广播时需要设置
|-
| '''端口'''（Port） || 发送使用的网络端口。只有在特殊情况下才需要更改
|-
| '''使用自定义网络接口'''（Use Custom Network Interface） || 允许不通过项目共用的网卡，而通过为该转换器单独选择的网卡发送数据
|-
| '''网卡'''（Network Adapter） || 为该转换器选择网卡。仅在启用自定义网络接口时可用
|}

'''宇宙设置'''分区：

{| class="wikitable"
! 参数 !! 作用
|-
| '''起始宇宙'''（Start Universe） || 第一个端口的宇宙编号。其余端口的宇宙编号依次以此为基准计算
|-
| '''端口数量'''（Port Count） || 项目中该转换器的端口数量。不能设置超过实际设备型号所拥有的端口数
|-
| '''每端口宇宙数'''（Universes per Port） || 一个端口占用的宇宙数量。影响一个端口能容纳的固定装置数量
|-
| '''发送空端口'''（Send Empty Ports） || 即使端口中没有任何固定装置，也会发送数据
|}

以下两项设置需要谨慎修改：

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

== 端口属性 ==

端口（Port）在'''属性'''窗口中只能配置'''名称'''。像“正面，左侧”这样清晰易懂的名称，有助于在地址分配和安装施工时不混淆端口。

其余内容都是从“上层”传递给端口的，需要在其他地方配置：

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

== Light Stream Player 属性 ==

'''Light Stream Player'''是'''固定装置'''窗口中的顶层设备：转换器存在于其内部，而端口又存在于转换器内部。点击该设备即可打开播放器的属性。

{| class="wikitable"
! 分区 !! 参数 !! 作用
|-
| '''基本''' || '''名称''' || 设备在项目中的名称
|-
| '''基本''' || '''IP地址''' || 播放器的网络地址。默认值为192.168.0.205
|-
| '''基本''' || '''启用HTTPS'''（Enable HTTPS） || 程序通过安全协议与播放器通信
|-
| '''基本''' || '''HTTP端口'''、'''HTTPS端口''' || 程序访问播放器所使用的网络端口。无需更改默认值
|-
| '''授权''' || '''用户名'''（Username）、'''密码'''（Password） || 登录播放器所需的凭据。密码旁边有一个按钮，可以隐藏或显示已输入的字符
|-
| '''授权''' || '''导入/导出设置'''（Import / Export Settings） || 该按钮会打开设置交换窗口：项目中的宇宙和设备会发送到播放器，也可以反向获取已配置好的播放器的设置
|-
| '''内部转换器''' || '''使用内部转换器'''（Use Internal Converter） || 启用播放器自身内置的宇宙。该参数关闭时，内置宇宙不参与与其他转换器编号冲突的检查
|}

播放器完整的参数列表及其配置顺序，参见[[Light Stream Player 设置]]一文。

== 布局属性 ==

布局（Layout）通过点击'''映射'''窗口中的边框或'''时间轴'''上的布局行来选中；新创建的布局会自动打开其属性。此时会显示两个分区。

'''基本'''分区：

{| class="wikitable"
! 参数 !! 作用
|-
| '''混合模式'''（Blend Mode） || 布局内容如何叠加在其下方内容之上。详见[[Режимы смешивания]]一文
|-
| '''X位置'''、'''Y位置'''（Position X, Position Y） || 布局在映射画面上的位置，单位为像素
|-
| '''宽度'''、'''高度'''（Width, Height） || 布局的尺寸，单位为像素
|-
| '''应用''' || 根据输入的宽度和高度重新计算布局
|}

主布局（'''Main layout'''）表现特殊：无法移动，改变其宽度和高度会改变整个映射画面的尺寸。关于布局的创建和顺序，参见[[Создание и изменение лейаутов]]。

'''背景'''分区——布局的衬底：便于摆放固定装置的场地平面图或立面照片。

{| class="wikitable"
! 参数 !! 作用
|-
| '''显示图像'''（Show Image） || 开启固定装置下方衬底图像的显示
|-
| '''文件名'''（File Name） || 选择图片文件的按钮。选择后按钮上会显示所选文件的名称
|-
| '''重采样模式'''（Resampling Mode） || 图片的拉伸方式：'''自动'''（Automatic）——带平滑处理，'''最近邻（硬边缘）'''（Nearest Neighbor (hard edges)）——不做平滑处理，像素边界清晰
|-
| '''X偏移'''、'''Y偏移'''（Offset X, Offset Y） || 图片相对布局的位移
|-
| '''X缩放'''、'''Y缩放'''（Scale X, Scale Y） || 图片在水平和垂直方向上的缩放
|-
| '''刷新'''（Refresh） || 重新从磁盘读取文件。在外部编辑器中重新绘制过图片时需要用到
|}

== 效果属性 ==

在'''时间轴'''上选中一个效果——'''属性'''窗口会完全用于显示它。顶部是效果的通用标题栏：

* '''效果名称'''（Effect name）——位于左侧，加粗显示。
* '''混合模式'''——下拉列表：效果如何叠加在其下方内容之上。右键点击该列表会恢复为'''正常'''（Normal）模式。详见[[Режимы смешивания]]一文。
* '''齿轮图标'''（gear icon）——打开效果设置窗口：大小、翻转、旋转、缩放和位移，包括时间位移。参见[[Настройки эффектов]]。
* '''不透明度'''（Opacity）——控制效果整体透明度的滑块。

标题栏中没有效果本身的位置、旋转或缩放——这些都需要在齿轮图标打开的效果设置窗口中设置。

下方是效果自身的参数——每个效果各不相同：速度、颜色、元素数量、方向等等。它们以单一列表形式显示，没有嵌套分组，超出窗口高度时可以滚动。右键点击滑块可将参数恢复为默认值。

每个参数右侧有两个按钮：

* '''L'''——将参数绑定到函数或通过OSC、MIDI、DMX进行外部控制。如果已绑定，字母会变为橙色；如果参数已分配函数，按钮上还会出现字母'''F'''。
* '''秒表图标'''（stopwatch icon）——为参数开启关键帧（Keyframe）模式。这是唯一能开启关键帧模式的地方：一旦开启，该参数就会在'''时间轴'''上以效果下方单独一行的形式出现，关键帧就是在那里放置的。没有关键帧的参数不会显示在时间轴上。详见[[Ключевые кадры и параметры эффектов]]一文。

对于不处理平面图像的效果，标题栏会有所不同：3D效果的标题栏中，混合模式被替换为3D区域的选择；而控制固定装置通道和旋转的效果，标题栏中则是固定装置选择按钮和已选数量的计数。

如果效果参数很多而窗口较窄，可以拉宽窗口：所有元素会随窗口大小按比例缩放。

== 合成属性 ==

双击'''合成'''窗口中的某个合成后，它会自动显示在'''属性'''窗口中。此时会显示两个分区：

* '''基本'''——'''名称'''、'''时长'''（Duration，格式为“时:分:秒:帧”的按钮）、'''无限'''（Infinite）、'''循环'''（Loop）和'''备注'''（Comments）。
* '''颜色过滤'''——四个滑块：'''红'''、'''绿'''、'''蓝'''和'''白'''，用于减弱对应的固定装置通道。

以上内容在[[Настройки композиций]]一文中有详细说明。

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

== 出现问题时 ==

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

'''窗口显示的属性不对。''' 窗口显示的是最后一次选择的内容，而这一选择是整个程序共用的：在时间轴上点击某个效果会把固定装置的属性从窗口中挤出去，打开合成也会把效果的属性挤出去。请重新选中所需对象。

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

'''样条上的固定装置数量无法更改。''' 该样条启用了'''固定像素'''分布方式，此时固定装置数量由线条的节点数决定。请将'''分布类型'''切换为'''均匀'''。

'''固定装置在实体对象上不亮，但程序中动画正在播放。''' 请依次检查'''可见性'''链条：固定装置本身、端口（'''固定装置'''窗口中的复选框）以及转换器。其中任何一处可见性被关闭，都会使输出数据清零。

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

== 另请参阅 ==

* [[设置]]
* [[Workspace]]
* [[固定装置的地址分配]]
* [[固定装置的种类和类型]]
* [[样条和单个固定装置]]
* [[Создание и изменение лейаутов]]
* [[Настройки композиций]]
* [[关键帧与效果参数]]
* [[效果设置]]
* [[3D Объекты]]
* [[Терминология]]