查看“合成”的源代码

[[ru:Композиции]] [[en:Compositions]] [[zh:合成]]
合成（Composition）是项目已完成的动画：一组按时间分布在布局（Layout）内的效果（Effect），拥有自己的时长和帧率。一个项目中可以有任意数量的合成，导出时每一个都会变成一个单独的 cue 文件，之后由 '''Light Stream Player''' 播放。

同一个项目里的所有合成使用相同的固定装置（Fixture）、设备和布局：固定装置只在 '''Mapping'''（映射）窗口中摆放一次，各个合成只是以不同方式点亮它们。每个合成独有的只是时间轴上的效果和它自己的设置——时长、帧率、循环和颜色过滤。

== "Compositions"（合成）窗口 ==

项目的合成列表位于 '''Compositions'''（合成）窗口中。默认情况下它占据屏幕左侧，与 '''Fixtures'''（固定装置）和 '''3D Objects'''（3D 对象）窗口共用空间——通过顶部的标签页切换。如果窗口被关闭，可以通过菜单 '''Window'''（窗口）→ '''Compositions''' 重新打开。

合成以卡片形式显示。卡片上可以看到：
* 缩略图——合成当前在 '''Mapping''' 画面上绘制的内容；播放期间缩略图是实时的；
* 合成的名称；
* ''小时:分钟:秒:帧''格式的时长；启用了无限（Infinity）的合成会用 ∞ 符号代替时长。

卡片上还可以额外显示两行信息——该合成被多少个播放列表和多少个日历事件使用。它们通过在窗口空白处右键点击，选择 '''Show usage in playlists'''（显示在播放列表中的使用情况）和 '''Show usage in events'''（显示在事件中的使用情况）来启用。默认两行都是关闭的。

正在播放的合成以橙色高亮显示，仅被选中的合成则用浅色底纹标出。可以同时选中多个合成，点击窗口空白处会取消选择。

窗口底部有两个按钮：左侧是 '''Create Composition'''（新建合成），右侧是 '''Delete Composition'''（删除合成）。

== 新建合成 ==

新项目中默认已经有五个空合成——''Composition001''…''Composition005''。第一个合成中添加了 '''Atom 3D''' 效果，以便在 Mapping 上立刻能看到内容。

要添加另一个合成：
# 点击 '''Compositions''' 窗口左下角的 '''Create Composition''' 按钮（方框中的加号）。窗口空白处右键菜单中的 '''Create Composition''' 项作用相同。
# 合成出现在列表末尾，立即被选中并在 '''Timeline'''（时间轴）中打开。
# 给它起一个清晰的名字并添加效果——参见 [[Добавление эффекта в композицию]]。

新合成是空的，时长为 1 分钟。帧率取自列表中最后一个合成，以保证项目中所有合成的计算方式一致；如果项目中还没有任何合成，则使用创建项目窗口中设置的 '''Project Frame Rate'''（项目帧率）值（默认 40）。

如果项目中一个合成都没有了，'''Mapping''' 窗口中央会出现一个 '''Create Composition''' 按钮——作用完全相同。

== 打开与播放 ==

单击只会选中卡片。要打开合成，需要'''双击'''它：它的效果会出现在 '''Timeline''' 上，画面会出现在 '''Mapping''' 画面和 '''3D View'''（3D 预览）窗口中，参数会出现在 '''Properties'''（属性）窗口中。打开的合成会立即开始播放，其卡片会变为橙色。

可以通过以下方式控制播放：
* '''Space''' 键——启动或停止已打开的合成；
* 卡片右键菜单中的 '''Start'''（开始）和 '''Stop'''（停止）项；
* '''Timeline''' 面板上的播放按钮——参见 [[Таймлайн]]。

同一时间只能播放一个合成：切换到另一个合成时，之前的会停止，新的从头开始播放。

== 重命名 ==

合成的名称会成为导出的 cue 文件的名称，并显示在 '''Light Stream Player''' 界面中，因此最好一开始就给合成起有意义的名字。

选中合成并按 '''F2'''，或在右键菜单中选择 '''Rename'''（重命名），输入新名称后按 '''Enter'''。

名称限制：
* 长度——最多 40 个字符；
* 项目中的合成名称不能重复：如果输入已被占用的名称，程序会在其后添加一个三位数编号；
* Windows 文件名中禁止使用的字符（<code>\ / : * ? " < > |</code> 等特殊符号）在输入时不被接受。

== 复制与排序 ==

右键菜单中的 '''Copy'''（复制）和 '''Paste'''（粘贴）会创建包含全部效果和设置的合成副本。副本会出现在列表末尾并获得唯一的名称。

拖动卡片到新位置可以改变列表中合成的顺序。合成在 '''Export'''（导出）窗口中也按同样的顺序显示，因此按照展示的设计来排列列表会更方便。

拖动合成也可以把它发送到播放列表——播放列表会接收从 '''Compositions''' 窗口拖来的卡片。

== 时长与帧率 ==

合成的时长在 '''Set Duration'''（设置持续时间）窗口中设置。打开方式有两种：右键点击卡片选择 '''Set Duration'''，或点击所选合成 '''Properties''' 窗口中的时长数值。

窗口中有四个时间字段——'''Hours'''（小时）、'''Minutes'''（分钟）、'''Sec'''（秒）、'''Frames'''（帧）——以及一个 '''Frames Per Second'''（每秒帧数）字段。点击 '''OK''' 应用设置。

几点说明：
* 帧率是为每个合成单独设置的，但不建议无故更改：帧率越高，动画越流畅，生成的 cue 文件也越大；
* 如果缩短时长，时间轴上的效果会保持原位——超出新边界的部分只是不会播放，也不会包含在导出中；
* 启用 '''Infinity'''（无限）后时长不再起作用，合成会一直播放直到被停止。

== 合成属性 ==

选中合成后，其参数会显示在 '''Properties''' 窗口中。

{| class="wikitable"
! 参数 !! 作用
|-
| '''Name'''（名称） || 合成的名称；与用 '''F2''' 重命名效果相同
|-
| '''Duration'''（时长） || 当前时长；点击数值会打开 '''Set Duration''' 窗口
|-
| '''Infinity'''（无限） || 合成不受时间限制地播放。启用期间，'''Loop'''（循环）参数不可用
|-
| '''Loop'''（循环） || 播放到结尾后，合成会重新开始
|-
| '''Comments'''（备注） || 合成的自由文本备注，随项目一起保存
|-
| '''Color Filtering'''（颜色过滤）：'''Red'''（红）、'''Green'''（绿）、'''Blue'''（蓝）、'''White'''（白） || 数值从 0 到 1 的滑块，用于限制该合成中对应固定装置通道的输出比例。数值为 1 表示通道完全输出，0 表示通道关闭。适合在不改动效果的情况下整体调暗合成
|}

更多细节——参见 [[Настройки композиций]]。

== 删除 ==

选中一个或多个合成，按 '''Delete'''，或点击窗口右下角的 '''Delete Composition''' 按钮，或使用右键菜单中的 '''Delete'''（删除）项。

程序会要求确认，并显示即将删除的合成名称。如果合成正在被播放列表使用，同一窗口会列出具体是哪些播放列表——合成也会从那里消失。误删除可以用 '''Ctrl+Z''' 撤销。

== 通过外部信号触发合成 ==

合成可以绑定到外部信号，从而无需用鼠标启动。右键点击卡片 → '''Trigger'''（触发器），然后选择来源：'''OSC'''、'''MIDI''' 或 '''DMX'''。之后收到的相应指令就会触发这个合成。

== 合成与导出 ==

项目的所有合成都列在 '''Export''' 窗口中。名称左侧的复选框表示该合成是否会被包含在导出中：取消勾选草稿合成可以避免在其上浪费渲染时间。复选框的状态会随项目一起保存。

每个被勾选的合成会导出为一个以合成命名的独立 cue 文件，如果启用了相应选项，还会附带 GIF 预览。详情参见 [[Экспорт композиций]]、[[Настройки GIF превью]] 和 [[Импорт cue в Player]]。

== 快捷键 ==

{| class="wikitable"
! 操作 !! 按键
|-
| 打开合成 || 双击卡片
|-
| 重命名 || '''F2'''
|-
| 开始 / 停止 || '''Space'''
|-
| 删除 || '''Delete''' 或 '''Backspace'''
|-
| 撤销 / 重做操作 || '''Ctrl+Z''' / '''Ctrl+Shift+Z'''
|}

== 另请参阅 ==

* [[Настройки композиций]]
* [[Таймлайн]]
* [[Добавление эффекта в композицию]]
* [[Создание и изменение лейаутов]]
* [[Экспорт композиций]]
* [[Терминология]]