跳转到内容
MA2 助手文档

Effect 效果脚本的基础语法

Effect 参数：

Section titled “Effect 参数：”
  1. @
    Form，样式。@8，表示 Form 8。
  2. V
    Interleave，交错。Vo, Ve, V13, V23, V33, V14, V24, V34, V44。
  3. M
    Mode，模式。M1: Abs，绝对值。M2：Rel，相对值。空：自动。
  4. S
    Speed，速度。S20。除了支持数值之外，还增加了对音乐 BPM 分数和百分数的支持，S1/2，S50%。由 MA2 助手自动计算出具体数值，省去用户手工计算的工作量。
  5. sm
    Speed Master，速度主控。sm1，表示 Speed Master 1。控制 Effect 的 Speed Group。
  6. >, <, ><, <>
    Dir，方向 。>：从左向右。 <：从右向左。 ><：从左向右，反弹。 <>：从右向左，反弹。
  7. L
    Low value，低值。L20, L1/3..68。彩色低值支持中英文和缩写。C@24W50Lr, Lred, L红
  8. H
    High value，高值。H100, H2/3..90。彩色高值支持中英文和缩写。C@24W50Hc, Hcyan, H青
  9. W
    Width。W100,W90..1/3。
  10. P
    Phase。P0, P355..0, P1/5, P40%..-1/5
  11. a
    Attack，过冲。当 Form 为 3, 4, 5 时有效。a10
  12. d
    Decay，衰减。当 Form 为 3, 4, 5 时有效。d10
  13. B
    Blocks，多块。B3，此例中 3 个成员为一块，只关心每个 块 中的成员数量，与 MA2 一致。新增 B*3，3 个块，只关心 块 的数量，块中的成员数量自动计算。
  14. G
    Groups，多组。G3，此例中 3 个成员为一组，只关心成员数量的分组，与 MA2 一致。新增 G*3 语法，* 在 G 和数字之间，表示：只关心分组的数量。示例中为 3 个分组，而不关心每组成员数量，由 MA2 助手自动计算。
  15. U
    Wings，多翼。U2, U-3
  16. $
    SingleShot，单发。$：单次执行。空：默认值，无。

MA3 新增的 Effect 参数：

Section titled “MA3 新增的 Effect 参数：”
  1. t
    Transition，过渡百分比。默认：100.
  2. pa
    Proportional, Accel。开放曲线，加速。默认：无
  3. fa
    Free, Accel。圆，加速。默认：无
  4. pd
    Proportional, Decel。开放曲线，减速。默认：无
  5. fd
    Free, Decel。圆。减速。默认：无
  6. Mtu
    MAtricks, Shuffle。随机。默认：无
  7. Mti
    MAtricks, Shift。移位。默认：无
  8. Mtm
    MAtricks, Mirror。镜像。默认：无
  9. By Bz
    Blocks，多块。By3, Bz3。By*3, Bz*3
  10. Gy Gz
    Groups，多组。Gy3, Gz3。Gy*3, Gz*3
  11. Uy Uz
    Wings，多翼。Uy2, Uz3。Uy*2, Uz*3

Preset 参数：

Section titled “Preset 参数：”
  1. #
    Preset，预置。#2.2，表示 Preset 2.2。

属性简写：

Section titled “属性简写：”

属性可以直接输入全称，如：Gobo，Iris，Prism 等。以下常用属性也可以使用简写：

  1. D
    DIM，强度。
  2. N
    PAN，水平摆动。
  3. T
    TILT，垂直摆动。
  4. C
    Color，彩色。三基色：rgb。
  5. r, g, b
    分别代表 red， green，blue。对应 grandMA2 中 COLORRGB1, COLORRGB2, COLORRGB3 举例：(r@13; g@14; b@15)
  6. w
    white。对应 COLORRGB5。
  7. O
    颜色 CMY。O@4, O 表示 Color 基色： cmy。
  8. c, m, y，可以考虑用全称。
    分别代表 cyan, magenta, yellow。对应 grandMA2 中 COLORCMY1, COLORCMY2, COLORCMY3。举例：(c@13; m@14; y@15)
  9. x, y, z
    用于 arena, fb4, Beyond。(arena@x2 y3 z1), (fb4@x1 y3 z4)

分隔及包裹符号：

Section titled “分隔及包裹符号：”
  1. :
    冒号。分隔 Group 名称与 Cues。
  2. ~
    波折号。多个 Cue 可拼接在一起。中间用 ~ 分隔，表达先后次序。与 grandMA2 Sequence 中 Cue 的 follow 类似。 (D@4W50) ~ A2(D@12P0)
  3. ()
    圆括号，包裹一个 Effect 模板脚本。(D@4 W50 P0)
  4. []
    方括号，包裹临时编组。如：[2],[2..8, 12..15], [-2, 8], [2/5]
  5. {}
    花括号，包裹拼接编组。如：{GROUPNAME+ f3e34 c30}
  6. +
    加号。拼接编组的连接符号。
  7. ,
    逗号。隔开多个拼接编组。例如：{GROUPNAME1, GROUPNAME2}
  8. ''
    单引号。包裹拼接编组名称，用于有空格的编组名称。例如：{'GROUP NAME'}。
  9. _
    下划线。连接符号。用于连接临时编组中的多个单元。
  10. ;
    分号。当同一个 Effect 中有多行时，用分号隔开。例如彩虹效果：(r@13; g@14; b@15)

约束语法：

Section titled “约束语法：”
  1. 2.3.4
    独立结束时间，用小节号表示。一定要写在效果脚本的前面。
  2. ?
    问号，周期次数。其直接影响效果速度，Effect Speed。?2.5，表示：当前片段速度的 2.5 倍。?3/4，表示：当前片段速度的 3/4。?180%，表示：当前片段速度的 180%，相当于 1.8 倍。
  3. tr
    EffectTimer, 效果参数定时器。_, 表示 Effect Timer 的参数分隔符，支持多参数。惊叹号 ! 表示结束。tr1_10 v1/4 H20..100!。
  4. fm
    Fader Master, 幅度主控。fm1，表示 Fader Master 的第一个。控制其关联的执行器幅度。Fader Master 的数量不限，与编程时使用的执行器数量相关。
  5. ^
    MIB, 黑场移动，提前量。在片段的开始时间之前执行。举例：^2 D@7。^10%，表示：提前 10% 的时间开始执行。^1/8，表示：提前片段周期的 1/8 开始执行。
  6. A
    Delay 延迟。A2，从片段开始时间点向后延迟 1 秒开始执行。A-4，在片段结束时间点之前 10 秒结束。A+1，从结束时间点开始执行，向后延时 1 秒结束。增加对片段时长的分数和百分数的支持，助手自动计算出时间。A1/3, A33%，A-1/3，A+33%。既方便设置，又能得出更精准的时间。A-10，A+10，表示结束点。
  7. []
    临时编组。
  8. {}
    拼接编组。