查看“设置”的源代码

[[ru:Settings]] [[en:Settings]] [[zh:设置]]
'''设置(Settings)'''窗口汇集了程序本身的设置:界面语言、启动行为、内存与性能、声音、网络、'''MIDI'''与'''OSC'''、导出参数以及排期(Schedule)。

这些是工作站的设置,而不是项目的设置。它们保存在电脑上,并对该电脑上打开的所有项目生效——无法随项目文件一起转移到另一台机器上。唯一的例外是'''主布局尺寸(Main Layout Size)'''按钮:它会更改当前项目。

== 如何打开 ==

* 菜单'''设置(Settings)''' → '''属性(Properties)''',或快捷键 ''Ctrl+P''。
* 项目尚未打开时,欢迎窗口'''欢迎使用 Light Stream(Welcome to Light Stream)'''中的'''设置(Settings)'''链接。
* 程序顶部面板中'''Art-Net'''按钮右侧的齿轮按钮——直接打开'''网络(Network)'''选项卡。
* '''导出(Export)'''窗口中,'''导出模式(Export Mode)'''列表旁边的齿轮按钮——直接打开'''导出(Export)'''选项卡。

窗口中没有'''确定'''和'''取消'''按钮:每一处更改都会立即生效并保存,只能手动改回原值来撤销(此处 ''Ctrl+Z'' 不起作用)。关闭窗口用关闭按钮或 ''Esc'' 键。窗口打开期间无法在程序主窗口中操作。

== 选项卡 ==

{| class="wikitable"
! 选项卡 !! 设置内容
|-
| '''常规(General)''' || 界面语言、程序和项目的自动启动、主布局尺寸、映射(Mapping)界面上的鼠标行为
|-
| '''Memory & Performance''' || 视频序列在内存中的缓存以及画面刷新频率
|-
| '''Audio / SMPTE''' || 音频输出与输入设备、接收'''SMPTE'''时间码
|-
| '''网络(Network)''' || 网卡、'''Art-Net'''输出、设备搜索
|-
| '''MIDI''' || 用于控制程序的虚拟'''MIDI'''设备
|-
| '''OSC''' || 通过'''OSC'''接收命令以及反馈
|-
| '''导出(Export)''' || '''GIF'''预览与视频渲染参数
|-
| '''排期(Schedule)''' || 场地的地理位置以及日历中事件的高亮显示
|}

== 常规(General) ==

=== 语言(Language) ===

界面可翻译为三种语言:'''English'''、'''Русский (Russian)'''和'''中國人 (Chinese)'''。选择之后,程序会立即提示需要重启才能切换语言:

* '''是(Yes)''' ——程序将重启并以新语言打开。重启前最好先保存未保存的项目;
* '''否(No)''' ——语言保持不变,以后需要重新选择。

同样的列表在菜单'''设置(Settings)''' → '''语言(Language)'''中也有。

=== Windows ===

'''随 Windows 启动时运行程序(Launch application on Windows startup)''' ——登录系统时程序会自动打开。它与下一组设置一起,是搭建无人值守工作站的主要方式:开机——项目打开——排期开始运行。

=== 程序启动时打开项目(Open project on program startup) ===

# 勾选'''已启用(Enabled)'''复选框。
# 在旁边的字段中指定项目文件——手动输入,或通过'''打开(Open)'''按钮选择。
# 如有需要,勾选下方的两个复选框(仅在勾选'''已启用(Enabled)'''后才可用):
#* '''加载时启动排期(Start schedule on load)''' ——程序会立即按日历开始工作,无需等待操作员;
#* '''加载时启用 Art-Net(Enable Art-Net on load)''' ——无需按顶部面板上的'''Art-Net'''按钮,对灯具的输出会自动启用。

如果项目文件被重命名或移动,程序将以空项目打开——需要重新指定路径。

=== 映射(Mapping) ===

'''主布局尺寸(Main Layout Size)''' ——一个按钮,旁边显示当前尺寸(像素)。点击后会打开一个窗口,用于为'''当前项目'''设置'''映射(Mapping)'''工作区域的宽度和高度。如果新尺寸比原来的小,导致某些布局放不下,程序会询问:“是否将布局裁剪到缩小后的尺寸?”。回答'''是'''会将布局调整到新边界内,'''否'''则保持原样——这样布局的一部分会落在区域之外。

在已完成的项目中缩小区域尺寸是有风险的:落在边界之外的灯具将不再参与动画。最好在工作开始时一次性设定好区域尺寸。

'''灯具地址标签大小(Fixture Address Size)''' ——映射界面上灯具旁显示的地址标签的大小。如果在大显示器上地址不易看清,可以调大;如果在密集的样条(spline)上标签互相重叠,可以调小。标签的显示本身在菜单'''查看(View)''' → '''2D 映射(2D Mapping)'''中的'''显示灯具宇宙(Show Fixture Universes)'''和'''显示灯具多地址(Show Fixture Multi-Addresses)'''选项中开启。

=== 投影(Projection) ===

'''纹理上的点大小(Point Size on Texture)''' ——灯具在投影纹理上以多大的点显示。默认值为 3。点越大,灯具产生的光晕看起来越密集、越明亮,灯具之间的“空洞”也越少。

=== 其他(Other) ===

'''缩放至光标中心(Zoom to Cursor Center)''' ——在'''映射(Mapping)'''窗口中滚动鼠标滚轮时,画面会向光标所在的点缩放。取消勾选后,缩放将相对于窗口中心进行。默认启用。

'''播放时更新关键帧数据(影响性能)(Update Keyframe Data During Playback (affects performance))''' ——播放合成(Composition)时,'''属性(Properties)'''窗口中的效果参数值会随关键帧变化。这在调整动画时很直观,但在关键帧较多的合成上会导致程序卡顿,因此默认不勾选。调整关键帧时可以打开它,正式播放时应关闭。

== Memory & Performance ==

=== 视频序列(Video Sequences) ===

'''启用视频序列缓存(Enable Video Sequence Caching)''' ——序列解码后的帧会保存在内存中,程序不必在每次循环时都从磁盘读取。播放会更流畅,尤其是在慢速磁盘和较长序列的情况下,但会占用更多内存。默认关闭。

'''缓存帧数(Number of Cached Frames)''' ——在内存中保留多少帧,范围为 10 到 100,000,默认 100。请逐步增大并关注内存占用:在较大的序列上,缓存设得过大可能会占满全部可用内存。

=== 渲染(Rendering) ===

'''映射预览帧率(Mapping Preview FPS)''' ——程序重绘画面的频率,涉及'''映射(Mapping)'''区域、'''3D 视图(3D View)'''、合成预览。默认 60,不能低于 10。

这是程序自身的绘制频率,不影响合成的帧率以及导出文件的帧率——那些在合成属性中单独设置。只有在性能较弱的电脑上才需要降低该值,并且要谨慎:数值越低,预览画面和效果编辑过程看起来就越卡顿。

'''排期运行时显示映射和 3D 场景(Display Mapping and 3D Scene While Scheduler Is Running)''' ——排期运行期间,程序会继续在屏幕上绘制映射和 3D 场景。默认不勾选:在无人值守独立运行的场地,渲染画面没有意义,只会占用本该用于灯具输出的资源。当确实有人在屏幕前观看时再启用它。

== Audio / SMPTE ==

'''音频输出(Audio Output)''' ——播放添加到合成时间轴(Timeline)上的声音所使用的设备。如果项目中有音轨但听不到声音,应从这里开始排查。

'''音频输入(Audio Input)''' ——对音乐做出反应的效果(均衡器、节拍)所使用的声音来源。'''已启用(Enabled)'''复选框用于启动采集;只有在采集关闭时才能在列表中选择设备,因此要更换麦克风或线路输入,需先取消勾选。

'''SMPTE 时间码(SMPTE Timecode)''' ——接收外部时间码,程序据此使播放与其他设备同步:

* '''已启用(Enabled)''' ——开始接收;
* '''输入设备(Input Device)''' ——接收时间码信号的音频输入;
* '''每秒帧数(Frames Per Second)''' ——时间码格式:24、25、29.97 或 30。该值必须与信号源的设置一致,否则同步会逐渐偏移。

与音频输入一样,设备和格式只能在取消勾选'''已启用(Enabled)'''时选择。

== 网络(Network) ==

该选项卡负责通过'''Art-Net'''向灯具输出数据。

{| class="wikitable"
! 参数 !! 用途
|-
| '''网卡(Network Adapter)''' || 整个项目发送'''Art-Net'''所使用的电脑网卡。只需选择一次;如果电脑上有多块网卡,请选择转换器(Converter)所在的那一块
|-
| '''启用 Art-Net(Enable Art-Net)''' || 开启输出。与程序顶部面板上的'''Art-Net'''按钮功能相同
|-
| '''ArtSync''' || 发送同步数据包——所有宇宙(Universe)在转换器上同时更新。适用于大型场地中不同区域更新明显不同步的情况
|-
| '''搜索(Search)''' || 在网络中搜索'''Art-Net'''设备,并打开一个窗口,通过'''添加所选(Add Selected)'''按钮将找到的转换器和播放器添加到项目中
|-
| '''每个端口的最大宇宙数(Maximum Universes per Port)''' || 可分配给一个转换器端口的宇宙数量上限。默认 4
|-
| '''不自动启用/关闭 Art-Net(Do Not Enable/Disable Art-Net Automatically)''' || 程序不再自动开启和关闭输出,'''Art-Net'''按钮的状态完全由你控制
|}

如果灯具不亮,应按以下顺序排查:是否选择了正确的'''网卡''',是否启用了'''Art-Net''',转换器的 IP 地址是否与该网卡所在子网一致,以及灯具是否已分配到相应端口(Patched)。

== MIDI ==

该选项卡适用于使用'''MIDI'''控台或控制器来操作程序的用户。

# 点击'''添加(Add)''' ——列表中会出现一个虚拟设备。
# 直接在表格中为它设置'''名称(Name)''' ——之后可在命令中通过该名称识别此设备。
# 在列表中选中该行:下方会展开'''MIDI 虚拟设备(MIDI Virtual Device)'''设置组。
# 勾选'''已启用(Enabled)'''复选框,并在'''MIDI IN'''列表中选择实际的硬件设备。如果控制器是在程序启动后才连接的,点击'''刷新(Refresh)''' ——列表会重新读取。

表格中针对每个设备显示'''状态(Status)'''、'''名称(Name)'''、'''MIDI 输入设备(MIDI Input Device)'''和'''MIDI 输出设备(MIDI Output Device)'''。多余的设备可通过'''删除(Delete)'''按钮移除。

== OSC ==

'''OSC 设置(OSC Settings)'''组负责接收来自平板、控台或其他程序通过'''OSC'''协议发送的命令。

* '''已启用(Enabled)''' ——启动接收。端口和地址只能在取消勾选时更改;
* '''输入端口(Input Port)''' ——程序监听命令的端口,默认 8011;
* '''反馈端口(Feedback Port)'''与'''反馈 IP 地址(Feedback IP Address)''' ——程序发送回复的目标,用于让控台上被按下的按钮点亮;端口默认 9000;
* '''自动(Auto)''' ——反馈地址取自命令发送方的地址。当有多个控台,或平板的地址由路由器分配时,这种方式很方便。

== 导出(Export) ==

这里汇集了程序输出文件时使用的参数。设置对所有项目通用,并作用于下一次导出——已经导出的文件不会改变。

* '''GIF 设置(GIF Settings)''' ——颜色数量、质量以及预览的时长,该预览会被写入每个 cue 文件,并在'''Light Stream Player'''中显示。参数详见文章[[GIF预览设置]]。
* '''视频导出设置(Video Export Settings)'''与'''音频导出设置(Audio Export Settings)''' ——'''视频渲染(Video Render)'''模式下的画面尺寸、合成名称字幕、编解码器与码率。详见文章[[导出合成]]。

== 排期(Schedule) ==

=== 位置(Location) ===

'''位置(Location)'''组用于设置场地的地理位置。它只有一个用途:让程序自行计算日出和日落时间,并据此触发日历事件。坐标未设置之前,这些事件会按照别处的位置计算,触发时间也就不对。

{| class="wikitable"
! 字段 !! 输入内容
|-
| '''名称(Name)''' || 场地名称——仅作为你自己的标注
|-
| '''地址(Address)''' || 场地地址,同样仅供参考
|-
| '''纬度(Latitude)''' || 纬度,单位为度,范围 −90 至 90,使用小数(例如 55.7558)
|-
| '''经度(Longitude)''' || 经度,单位为度,范围 −180 至 180(例如 37.6173)
|}

坐标最简单的获取方式是从任意地图上查找。整数与小数部分之间用点号分隔;超出允许范围的值不会被接受,该字段会以红色高亮显示。

修改后点击'''应用(Apply)''':程序会重新计算日出日落时间并更新日历。不点击的话,日历中仍会保留之前的时间。

=== 显示设置(Display Settings) ===

'''周日历事件高亮(Week Calendar Event Highlighting)''' ——周日历如何高亮显示鼠标悬停的事件:

* '''高亮所有相同事件(Highlight all identical events)''' ——该事件在一周中所有天的所有重复都会被高亮。便于检查排期在各天是否重复一致;
* '''高亮跨越到次日的事件(Highlight event carrying over to the next day)''' ——只高亮该事件本身以及它在午夜之后的延续部分。这是默认选项,对夜间场景更直观。

== 另请参阅 ==

* [[GIF预览设置]]
* [[导出合成]]
* [[合成设置]]
* [[固定装置的地址分配]]
* [[鼠标、选择与移动]]
* [[工作区]]
* [[术语]]