编辑特效脚本

目的

• 创建和调试特效脚本。生成一个节目的完整回放数据。

• 脚本播放时可自动生成 grandMA2 中的 Timecode、Sequence、Cue、Executor、 Effect。

• 也可以直接动态回放，不生成 Timecode 等静态数据。

提示

• 下载 FFMPEG，并将文件夹路径保存到 Windows 的环境变量中的用户变量 Path 中。

• 已经有了舞台布局。或者通过导入 Execel 文件，生成舞台布局。

• 可以选择全程不在 grandMA2 中编程。但要了解 Effect 的概念和参数。

• 如果对特效 Effect 比较生疏，请先阅读：基于特效 Effect 的编程

• 如果想快速掌握特效脚本的语法，请下载样例文件，并结合本章内容对照学习。

要点

• 特效脚本支持两种应用场景：自动播放、现场播放。
• 自动播放 基于时间线，由确定的外部时序触发回放。而 现场播放 只基于单个 Effect，没有确定的外部时序，一般由手动触发回放。
• 本章从 脚本语法 到 Delay 和 out Delay 之间的部分为初级特效简介。
• 脚本支持的中级特效： 特效拼接、特效叠加、幅度主控、速度主控、多行特效。
• 脚本支持的高级特效： 声控、参数定时器、摄像机机位变换。
• 重点阅读：速度参数

脚本语法

先从一条简单的特效脚本起步：

GROUP1: (C@4 W50 U2)

脚本构成：

• :
  英文冒号将脚本分为左右两个部分。冒号左侧为编组名称，对应着灯具。冒号右侧特效参数。

• ~
  波折号是多个 Cue 的分隔符。如果有多个 Cue 首尾连接，就会出现多个 ~。

• 这条特效脚本的效果。如果灯具布局是线性开放式的话，比如：一条直线或弧线。将有一半灯具颜色为白色，另一半为黑色，由外侧两端向中心跑动。速度则取决于这段音乐的时长，由 MA2 助手自动计算得出，无需手工输入。

脚本内容与 Effect 参数的对应关系如下：

• GROUP1
  编组名称的中文别名，对应 grandMA2 中以 GROUP1 命名的编组。同时也对应了一组以 GROUP1 开头的特效，其中的每一种属性都有一个单独的特效。它相当于选中了 GROUP1 中的全部灯具，Effect 参数 Qty 的值将与 GROUP1 编组中的灯具数量相同。

• ()
  英文圆括号包裹一个属性的特效内容 C@4 W50 U2。如果存在多个属性，将会出现多个 ()。例如：(C@4 W50 U2) (T@8)

• C@24
C 表示 颜色 Color 属性，@4 表示 grandMA2 中第 4 个 Form。这两个参数必须以固定的先后顺序写在开头。它们后面的参数可以是任意顺序。比如： C@4 Y2 W50

• W50
  表示 宽度 Width 为：50%

• U2
  表示 翼 Wings 为 2。

这条脚本将为 grandMA2 中的一个 Effect 生成 跑灯特效 的全部参数。在脚本中没有表达出来的其他参数均为默认值。比如：颜色高值默认为白色，低值为黑色。详细的语法内容，请参考：特效脚本的基础语法

操作步骤：

1. 在 MA2 助手网站，鼠标悬停在 工具 上，点 时间线 进入页面后。
2. 右侧主窗口输入 媒体名称。英文名在前，中文名在后。
3. 将表格文件所在的目录名称拷贝到输入框中。
4. 将表格文件名拷贝到输入框中。省略扩展名。
5. 输入表格文件的工作表名称。
6. 将音视频文件所在的目录名称拷贝到输入框中。
7. 将音视频文件名拷贝到输入框中。省略扩展名。
8. 输入 speed 信息。start, end, tempo, bpm
9. 输入 bpm, drumbeat
10. 输入 delay
11. 在事件区域，输入参数：start, end, clips。
12. 每输入完成一个事件的参数，就可以点击 播放 ，同步播放这一片段的音乐。
13. 当输入完成所有事件后，点击 【】 播放。可选择播放任意时间点，任意时长的音乐。
14. 点击 【】 播放时，在对话框中选择 生成，即可在 grandMA2 中生成 Timecode。Timecode 的名称为媒体的英文名称，而中文部分无法显示。
15. 切换到 grandMA2 窗口查看结果。

自动生成 Effect 参数

• 写好脚本，点击 播放 按钮时，会自动在 grandMA2 中生成 Effect 并执行回放。同时，也同步播放本时间段的音乐。
• 不再需要在 grandMA2 中输入各种数据和指令。
• 脚本是文本，可阅读，内容详情一目了然。有提示助记的作用。
• 脚本还可拷贝、剪切、粘贴，方便编辑修改。
• 脚本尺寸很小。一首歌曲的完整脚本仅仅是 KB 级别，方便分享。

特效脚本基于时间线编程

• 在创建特效脚本的同时也生成了时间线。
• 本章时间线的用法与 生成时间线 之中的完全相同，不再赘述。
• 当编写并调试好全部脚本后，可点击 范围 播放，在对话框中勾选 生成静态数据，则自动在 grandMA2 中生成 Timecode 、Sequence、 Cue 的静态数据。
• 当然，如果你采用动态回放，就无需生成静态数据。只保存脚本就可以了。

自定义 Form

• grandMA2 自带的 Form 有 23 个。能支持基本的需求。
• 如果遇到比较复杂的特效需求，则需要自定义 Form 来满足。当然，最省事的办法还是直接用现成的。下载并导入 MA2 助手提供的 Form。
• 可在此基础上，在 grandMA2 中添加或编辑自定义的 Form。
• 如果重开一个新项目，则需要将自定义的 Form 导入。

简单灵活的灯具选择

• 通过 内部重组 和 拼接编组 语法解决灯具选择问题。
• 内部重组。将一个编组中的灯具做出调整，动态生成一个临时的编组。比如：调整顺序，截取一部分，或者做出类似 MAtricks 那样的操作。详情请参考：
• 拼接编组。将多个组拼接成一个大的临时编组。详情请参考：
• 混合编组。临时编组与拼接编组混合使用。
• 以上动态生成的临时编组不会被保存在 grandMA2 中。也无需保存。

速度参数

• 同步音乐的旋律和鼓点节奏是节目编程的最基本需求。这必须依赖速度参数。
• 旋律的速度参数。
• 鼓点节奏的速度参数。

多行特效

• 多行特效，是指将多个属性特效合并到一个 Effect 之中，每个属性对应其中一行。
• 合并的注意事项：
  • 被合并属性必须属于同一类。比如：rgb 虽为三个属性，但都属于 Color 这一大类。不能将 rgb 与 Position 类的属性 tilt 或 pan 合并。
  • 被合并属性的外部时序必须相同。起止点、淡入淡出时长都完全相同。但内部时序速度可以不同。
• 完整用法举例。详情请参考：

灯光颜色的经典的彩虹特效。

龙行天下: (r@13; g@14; b@15)

淡入和淡出 Fade in & Fade out

1. Cue 中 Fade in 和 Fade out 在很多场景下非常有用。是不可或缺的重要功能。
2. MA 对于 Fade in 和 Fade out 有严格的限定，只针对 Dimmer 属性。
3. MA 还有一个条件，要使 Fade in，Fade out 生效，必须执行器的状态由关到开，或由开到关。
4. 如果非 Dimmer 属性，能够实现淡入淡出效果吗？ 可以的。但只能用控制 Fader 的方式，而不能用真正的 Fade in, 1ade out 功能。
5. 综合考虑以上情况，MA2 助手给出了一个折衷的方案：用幅度主控实现淡入淡出效果。
6. 幅度主控实现淡入淡出效果不但兼顾了全部属性，也大幅简化了编程复杂度。

初始延迟和结束延迟 Delay & Out Delay

1. Cue 中 Fade in 和 Fade out 在很多场景下非常有用。是不可或缺的重要功能。
2. MA 对于 Fade in 和 Fade out 有严格的限定，只针对 Dimmer 属性。
3. MA 还有一个条件，要使 Fade in，Fade out 生效，必须执行器的状态由关到开，或由开到关。
4. 如果非 Dimmer 属性，能够实现淡入淡出效果吗？ 可以的。但只能用控制 Fader 的方式，而不能用真正的 Fade in, Fade out 功能。
5. 综合考虑以上情况，MA2 助手给出了一个折衷的方案：用幅度主控实现淡入淡出效果。
6. 幅度主控实现淡入淡出效果不但兼顾了全部属性，也大幅简化了编程复杂度。

特效拼接

• 原理：相当于多个 Cue 拼接起来，顺序执行。每个 Cue 都有各自的执行时长。
• 脚本表达方式：

(D@10P0H80W10) ~A10% (D@9P0H80W80) ~A-10%(D@11P0H80W10)

• 对应在 MA 中实现：三个 Cue，触发方式为: Follow。对应三个不同的特效。
• 现实效果：第一个 Cue 执行 10% 的片段时长，第二个 Cue 接着执行了 80%，第三个 Cue 继续执行了剩余的 10%。

特效叠加

• 原理：在同一组设备，同一个属性上叠加多个特效，同时执行。
• 脚本表达方式：

GROUPNAME: (D@11W50)
GROUPNAME__1: (D@4W50P0S1/4)
GROUPNAME__2: (D@17P0S1/4<)

• 对应在 MA 中实现：三个执行器，对应关联三个特效。执行器的 Off On Overwritten 为 Off。

幅度主控

• 应用场景：动态改变特效的速度参数，俗称：特效调速。
• 原理：将一个幅度主控与一个特效动态关联。当幅度主控的值变化时，特效的幅度将随之改变。
• 幅度主控只有一个属性值，也是用特效控制其变化的。
• 简写名称：fm，后面加索引号组成一个幅度主控名称 fm1。
• 总数量为 30 个。
• 一个幅度主控只能作用于一个属性，不能共享。
• 完整语法举例如下。详情参考：

fm1 控制灯光颜色淡入。

GROUPNAME: fm1 (C@4 H红 L蓝 W50 P0 S1/4) (D@12 W50)
FaderMaster: ([1] D@10 P0 L20 W10)

速度主控

• 应用场景：动态改变特效的速度参数，俗称：特效调速。
• 原理：将一个速度主控与一个特效动态关联。当速度主控的值变化时，特效的速度将随之改变。
• 速度主控只有一个属性值，也是用特效控制其变化的。
• 简写名称：sm，后面加索引号组成一个速度主控名称 sm1。
• 总数量为 15 个。
• 一个速度主控可以作用于多个特效参数。
• 完整语法举例如下。详情参考：

sm1 控制灯光红色、绿色、蓝色的变化速度先由慢到快，再由快到慢。

GROUPNAME: (r@13 sm1; g@14 sm1; b@15 sm1)
SpeedMaster: ([1] D@12 P0 L20 W10)

声控

• 声控可以让灯具的属性值随着输入的音乐的多个频率值的高低变化而实时变化。
• 声控脚本可根据设备分段的数量自动匹配频率。用户只需确定分段数量和起始频率段索引即可。
• 优点：大幅简化了声控功能原本在 grandMA2 中繁杂的编程操作。语法简练，易学易用。
• 先决条件

  • 电脑声卡设置为混音。

  • 具体步骤：设置 -> 声音 -> 声音控制面板 -> 录制 -> 立体声混音，鼠标右键弹出菜单，点击 “设置为默认设备”。

  • 关闭 grandMA2 onPC，然后重新打开。

  • 在 grandMA2 中设置 Sound Input 模块中的 Sound Gain，Fade 参数。

• 完整语法举例。详情请参考：

属性 dimmer 随输入音乐的节奏而实时变化。

龙行天下: (D@20 k7*5)

参数定时器

• 参数定时器，可定时修改 Effect 中的一个或多个参数的值。
• 一个参数定时器只能控制一个属性的特效参数，不能共享。
• 相邻事件的特效脚本不能使用相同的参数定时器。比如：一个事件使用了 tr1 tr2，与它前后相邻的事件就必须使用其他的索引号的参数定时器， tr3 tr4。相隔一个事件后就又可以了。系统预置了 12 个参数定时器，足够编程使用。
• 优点：大幅简化编程步骤。如果不采用参数定时器，就需要编写多个不同参数的特效才能实现相同效果，不但繁琐复杂，而且很难维护。
• 先决条件：在 基础工具包 -> 设置 界面，将参数定时器插件导入到 grandMA2 中。
• 语法举例 1：tr1 #20 v1/2 W60..100!。
  tr1 控制特效的宽度参数，以 1/2 BPM 的速度递增 20%。范围：60 ~ 100%，初始值：60%。
• 语法举例 2：tr2 #-20 n1/2 P0..360!。
  tr2 控制特效的相位参数，以 1/2 BPM 的速度递减 20°。范围：0 ~ 360°，初始值：360°。
• 完整用法举例。详情请参考：

tr1 控制颜色属性的相位参数。
tr2 控制 dimmer 属性的相位参数。

龙行天下: tr1 #10 v1/2 P0..40! (C@4 Hr Lb W50 P0 S1/4) tr2 #-20 v1/2 P0..360! (D@12 W50)

摄像机机位变换

1. 应用场景：演示、录制视频。现场回放是不需要变换摄像机机位的。
2. MA2 助手将参数简化为 3 个。用写注释的方式来写机位变换脚本。
3. 语法 1。~F100(near1W80far2)。解释：near1 向 far2 机位切换。宽度：W80。
4. 语法 2。31.4~(far2)。解释：far2 机位保持到 31.4 小节。
5. 全部机位数据存于 JSON 文件中，或数据库中。
6. 机位数据中必须包括以下属性：STAGE_X, STAGE_Y, STAGE_Z, MP_ROT_X, MP_ROT_Y, MP_ROT_Z, ZOOM.
7. 根据观察距离分类：最近、近、中、远。
8. 根据观察位置分类：前、右前、左前。后、右后、左后。
9. 根据观察角度分类：平视、仰视、俯视。