查看“合成”的源代码

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

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

== “合成”窗口 ==

项目的合成列表位于“'''合成（Compositions）'''”窗口中。默认情况下它占据屏幕左侧，并与“'''固定装置（Fixtures）'''”和“'''3D对象（3D Objects）'''”窗口共享空间——通过顶部的选项卡切换。如果该窗口被关闭，可以通过“'''窗口（Window）'''”菜单 → “'''合成（Compositions）'''”找回。

合成以卡片形式显示。卡片上可以看到：
* 缩略图——合成的一帧画面；正在播放的合成，缩略图是实时的，与“'''映射（Mapping）'''”画面同步，其余的显示中间的一帧；
* 合成名称；
* 以“''时:分:秒:帧''”格式表示的持续时间；开启了无限（Infinity）的合成，持续时间处会显示∞符号。

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

正在播放的合成以橙色高亮显示，仅被选中的合成则以浅色底纹显示。按住“'''Ctrl'''”或“'''Shift'''”可以同时选中多个合成；单击窗口空白处会取消选择。

右键单击卡片会打开一个菜单，其中包含“'''开始（Start）'''”“'''停止（Stop）'''”“'''复制（Copy）'''”“'''粘贴（Paste）'''”“'''重命名（Rename）'''”“'''删除（Delete）'''”“'''触发器（Trigger）'''”和“'''设置持续时间（Set Duration）'''”——下文会逐一介绍。右键单击窗口空白处会弹出另一个菜单：“'''创建合成（Create Composition）'''”“'''粘贴（Paste）'''”以及两个卡片显示设置。

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

== 创建合成 ==

新项目一开始就有五个空合成——''Composition001''…''Composition005''。第一个合成中已添加了“'''Atom 3D'''”效果，以便映射画面上立刻能看到内容。

要添加新的合成：
# 单击“'''合成（Compositions）'''”窗口左下角的“'''创建合成（Create Composition）'''”按钮（框内的加号）。窗口空白处右键菜单中的“'''创建合成（Create Composition）'''”项效果相同。
# 新合成出现在列表末尾，立即成为当前合成，在“'''时间轴（Timeline）'''”中打开并开始播放。
# 为它取一个易懂的名称，并添加效果——参见[[在合成中添加效果]]。

新建的合成是空的，持续时间为1分钟。帧率取自列表中最后一个合成，以保证项目中所有合成的计算方式一致；如果项目里还没有任何合成，则使用项目创建窗口中设置的“'''项目每秒帧数（Frames per second for project）'''”值（默认40）。

如果项目中已没有任何合成，“'''映射（Mapping）'''”窗口中央会出现一个“'''创建合成（Create Composition）'''”按钮——作用完全相同。

== 打开与播放 ==

单击只会选中卡片——这已足够用来复制、删除或拖动该合成。要打开合成，需要“'''双击'''”它：其效果会出现在“'''时间轴（Timeline）'''”上，画面出现在“'''映射（Mapping）'''”区域和“'''3D视图（3D View）'''”窗口中，设置则出现在“'''属性（Properties）'''”窗口中。被打开的合成会立即从头开始播放，其卡片变为橙色。

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

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

== 重命名 ==

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

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

名称限制：
* 长度——少于40个字符，更长的名称不会被接受；
* 项目内的合成名称不能重复：如果输入的名称已被占用，程序会在其后加上一个三位数字；
* 保留字符<code>/ \ : ; * ? " < > | # @ ! $ % & ( ) + , { } [ ] ^</code>以及单引号会被程序自动从名称中去除——它们在文件名中是不允许的。

== 复制与排序 ==

右键菜单中的“'''复制（Copy）'''”和“'''粘贴（Paste）'''”会创建该合成及其全部效果和设置的副本。副本会出现在列表末尾，获得唯一的名称并立即打开。复制的合成也可以通过窗口空白处的右键菜单粘贴。

拖动卡片到新位置即可改变列表中合成的顺序。“'''导出（Export）'''”窗口中合成的显示顺序与此相同，因此按照演出设想来排列列表会更方便。

拖动合成还可以把它发送到播放列表——播放列表会接受从“'''合成（Compositions）'''”窗口拖来的卡片。

== 持续时间与帧率 ==

合成的持续时间在“'''设置持续时间（Set Duration）'''”窗口中设定。打开方式有两种：右键单击卡片选择“'''设置持续时间（Set Duration）'''”，或者在已打开合成的“'''属性（Properties）'''”窗口中单击持续时间数值。

该窗口有四个时间字段——“'''时（Hours）'''”“'''分（Minutes）'''”“'''秒（Sec）'''”“'''帧（Frames）'''”——以及一个“'''每秒帧数（Frames per second）'''”字段。按“'''OK'''”或“'''Enter'''”应用；“'''Esc'''”不做任何修改直接关闭窗口。

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

== 合成属性 ==

合成的设置显示在“'''属性（Properties）'''”窗口的“'''基本（Main）'''”和“'''颜色过滤（Color Filtering）'''”部分中。双击卡片后它们会立即出现在那里。如果“'''属性（Properties）'''”中显示的是效果、固定装置或布局的参数，可以通过“'''时间轴（Timeline）'''”面板上合成名称右侧的“'''合成设置（Composition Settings）'''”按钮，将合成设置调回该处。

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称（Name）''' || 合成的名称；与按“'''F2'''”重命名效果相同
|-
| '''持续时间（Duration）''' || 当前的持续时间；单击数值会打开“'''设置持续时间（Set Duration）'''”窗口
|-
| '''无限（Infinity）''' || 合成不受时间限制地播放。开启期间“'''循环（Loop）'''”参数不可用，持续时间显示为00:00:00:00
|-
| '''循环（Loop）''' || 播放到结尾后合成会重新开始。默认开启
|-
| '''备注（Comments）''' || 合成的自由备注文字，随项目一起保存
|-
| '''颜色过滤（Color Filtering）'''：'''红（Red）'''、'''绿（Green）'''、'''蓝（Blue）'''、'''白（White）''' || 0到1、步长0.01的滑块，用于限制该合成中对应固定装置通道的贡献。值为1表示通道完全输出，0表示通道关闭。该过滤作用于输出到固定装置和导出的信号，不改变屏幕上的画面
|}

详见[[Настройки композиций]]。

== 删除 ==

选中一个（或多个）合成，按“'''Delete'''”或“'''Backspace'''”、窗口右下角的“'''删除合成（Delete Composition）'''”按钮，或右键菜单中的“'''删除（Delete）'''”项。

程序会要求确认，并显示将被删除的合成名称。如果该合成在播放列表中被使用，同一窗口会列出具体是哪些播放列表——该合成也会从这些播放列表中消失。误删除可以用“'''Ctrl+Z'''”撤销：合成本身会回到列表中的原位置，它在播放列表中的条目也会恢复。

== 通过外部信号启动合成 ==

可以将合成绑定到外部信号，从而不用鼠标也能启动它。右键单击卡片 → “'''触发器（Trigger）'''”，然后选择信号源：“'''OSC'''”“'''MIDI'''”或“'''DMX'''”。此后，收到的命令就会启动这个合成。

== 合成与导出 ==

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

每个被勾选的合成都会导出为一个以该合成命名的独立cue文件，如果启用了GIF预览，还会附带GIF预览。详情参见[[导出合成]]、[[GIF预览设置]]和[[将Cue文件导入Player]]。

== 快捷键 ==

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

== 另请参阅 ==

* [[Настройки композиций]]
* [[时间轴]]
* [[在合成中添加效果]]
* [[Создание и изменение лейаутов]]
* [[导出合成]]
* [[Терминология]]