动画脚本参考

动画脚本语言提供了一种描述动画流(animation flow)的简单语法。一个动画脚本由单个列表构成,其中把该动画流的各个请求编码为语句形式。语句以分号结尾,可以用空格或制表符填充、跨文件行拆分、与同一行上的其他语句合并,或被空行包围。不过在脚本中,惯例是把每条语句放在自己的一行上,并对齐到该行的最左字符。

每条语句的格式都相同,包含以下信息:

  • 发出该请求时的仿真时间
  • 发出该请求时正在执行的仿真事件的执行 ID
  • 请求名称关键字
  • 请求参数列表,参数之间以空格或制表符分隔

下面显示了一条典型的请求语句。注意语句本身并没有为时间、事件和请求参数这些字段加上显式标签;因此通常需要借助该语句及其对应请求的格式,才能解读一条语句中的数据内容。

图 32:动画脚本语句示例

动画脚本语句示例

动画脚本语言所支持的每个请求,都在本节后面由各自的条目单独说明。一个请求条目给出该请求的语法格式,包括请求名称和参数列表,但不包括请求语句中的仿真时间、事件 ID 或结束符字段。条目还会对每个请求参数作出说明。示例条目出现在下一页。

请求条目中不提供动画脚本请求的功能与用途的详细信息。这些细节参见第 2 章 “Animation Package”(第 1 页)。对于那些没有精确对应内核过程(Kernel Procedure)的动画脚本请求,条目中会给出功能信息。

图 33:动画请求条目示例

动画请求条目示例

一般而言,每一种动画脚本请求类型都有一个对应的 Anim 包内核过程(在请求条目中标注为内核过程对应项,KP analog)。但存在一些并非精确对应的情形,例如:

  • 只为仿真进程或过程提供本地服务、而不发出任何请求的 Anim 内核过程(这种情形包括 op_anim_ime_gen_pos()、op_anim_lprobe_anvid() 和 op_anim_macro_close())。
  • 通过发出多个独立请求来实现一个图形操作的 Anim 内核过程(这种情形包括 op_anim_ime_nmod_draw(),它发出 ime_nmod_load 和 ime_mod_draw 请求来加载并绘制一个模型)。
  • 参数个数可变、先发出一个初始请求、随后发出一系列参数设置请求和一个终止请求的 Anim 内核过程(这种情形包括 op_anim_igp_macro_draw()、op_anim_igp_macro_redraw() 和 op_anim_ime_nobj_update(),它们分别发出初始请求 igp_macro_draw、igp_macro_redraw 和 ime_nobj_update;初始请求之后是一系列设置整数、双精度或字符串参数的 arg_int、arg_dbl 或 arg_str 请求,最后是 arg_eol 列表终止请求)。
  • 根据传给其参数的数据类型不同而发出不同请求的 Anim 内核过程(这种情形包括 op_anim_mgp_reg_set(),它发出 mgp_reg_set_int、mgp_reg_set_dbl 和 mgp_reg_set_str 请求)。

动画脚本请求的参数全部是以 ASCII 编码的字面值常量(也就是说脚本语言没有变量或宏能力)。参数数据类型按不同的信息类别定义,如下表所述。注意这些数据类型在许多情况下与用于声明 Anim 包内核过程参数的相应 C 数据类型类似;不过脚本语言支持专门的数据类型及相关的赋值语法,以使参数的指定更为方便。

表 19:动画请求参数数据类型

数据类型 示例取值 说明 内部 C
存储类
integer 5 通用整数值 int or short
double 6.73 通用浮点值 double
string word
"several words"
通用文本值;若字符串用双引号括起,则可包含空格 char []
Anvid 44 查看器 ID(整数) int
Anmid 32 宏 ID(整数) int
Andid 12 绘制 ID(整数) int
keyword xor_reset 单词取值,取自一组枚举词 char or short
keyword list { retain_on,
setup_on }
用花括号括起、逗号分隔的关键字列表 char or short

许多预定义的枚举值(例如请求选项)都定义了关键字。这些关键字很简洁,因为它们依赖于脚本的动画专用特性,与仿真进程和过程中使用的冗长得多的 Anim 包符号常量形成对比。大多数枚举关键字取值列在请求条目的参数说明部分。

常用请求参数 <props>(图形属性)有许多枚举取值,这些关键字仅列在下一页。<props> 参数声明为关键字列表,接受一个用花括号括起的图形属性关键字列表。图形属性关键字被划分为若干属性类。一般而言,来自不同类的图形属性彼此独立、可以组合使用,但来自同一类的图形属性若组合使用会产生不可预期的结果。

表 20:<props> 参数接受的关键字

属性类 关键字
水平对齐 alignh_center alignh_left alignh_right
垂直对齐 alignv_bottom alignv_center alignv_top
颜色名称 / RGB
(关键字前缀 <p> 可以是 color(前景色)或 bgcolor(背景色))
<p>_rgb000
<p>_rgb010
<p>_rgb020
<p>_rgb030
<p>_rgb100
<p>_rgb110
<p>_rgb120
<p>_rgb130
<p>_rgb200
<p>_rgb210
<p>_rgb220
<p>_rgb230
<p>_rgb300
<p>_rgb310
<p>_rgb320
<p>_rgb330
<p>_rgb001
<p>_rgb011
<p>_rgb021
<p>_rgb031
<p>_rgb101
<p>_rgb111
<p>_rgb121
<p>_rgb131
<p>_rgb201
<p>_rgb211
<p>_rgb221
<p>_rgb231
<p>_rgb301
<p>_rgb311
<p>_rgb321
<p>_rgb331
<p>_rgb002
<p>_rgb012
<p>_rgb022
<p>_rgb032
<p>_rgb102
<p>_rgb112
<p>_rgb122
<p>_rgb132
<p>_rgb202
<p>_rgb212
<p>_rgb222
<p>_rgb232
<p>_rgb302
<p>_rgb312
<p>_rgb322
<p>_rgb332
<p>_rgb003
<p>_rgb013
<p>_rgb023
<p>_rgb033
<p>_rgb103
<p>_rgb113
<p>_rgb123
<p>_rgb133
<p>_rgb203
<p>_rgb213
<p>_rgb223
<p>_rgb233
<p>_rgb303
<p>_rgb313
<p>_rgb323
<p>_rgb333
颜色名称 / 标准
(关键字前缀 <p> 可以是 color(前景色)或 bgcolor(背景色))
<p>_beige
<p>_brown
<p>_green
<p>_orange
<p>_plum
<p>_sienna
<p>_white
<p>_black
<p>_corn
<p>_magenta
<p>_orchid
<p>_purple
<p>_steel
<p>_yellow
<p>_blue
<p>_cyan
<p>_maroon
<p>_peach
<p>_red
<p>_tan
<p>_brick
<p>_fuchsia
<p>_olive
<p>_pink
<p>_tan
<p>_violet
文本字体 font_open_10
font_open_18
font_open_12
font_open_24
font_open_14
像素操作 pixop_and
pixop_ndst
pixop_nsrc
pixop_osrc
pixop_dst
pixop_nodst
pixop_odst
pixop_osrc
pixop_eqv
pixop_nor
pixop_one
pixop_xor
pixop_nand
pixop_nosrc
pixop_or
pixop_zero
宏设置标志 setup_off setup_on
绘制样式 style_dashes style_dots style_pattern style_solid
绘制保留标志 retain_off retain_on

下面给出一个 <props> 取值示例;它把由 igp_text_draw 请求绘制的文本的图形属性设置为 18 磅、绿色,且以顶边为基准对齐:

图 34:文本图形属性取值示例

文本图形属性取值示例

另一个常用请求参数也声明为关键字列表:mgp 和 mme 宏类请求的 <arg_vals> 参数。这种参数要求一个固定长度的关键字列表,表示该请求其他各参数的取值来源。取值来源可以是:(a) 指定的宏绘制寄存器(由形如 “reg_<C>” 的关键字标识,其中 <C> 是单个字符);(b) 在请求语句中稍后给出的字面值(由关键字 “constant” 标识)。因此 <arg_vals> 参数为 mgp 和 mme 请求配置了某种特定格式,它指定了在 <arg_vals> 之后预期出现的额外参数个数。<arg_vals> 列表的长度由该请求支持的参数个数决定;这个数目出现在 <arg_vals> 的请求条目声明中。下面给出 <arg_vals> 的一个取值示例。

图 35:宏请求中取值来源指定示例

宏请求中取值来源指定示例

通过 <arg_vals> 指定属性来源的机制,给那些只有在另一个参数包含某个特定取值时才会出现的可选参数带来了一个复杂问题。这种情况仅限于 mgp_bg_fill、mgp_circle_fill 和 mgp_rect_fill 请求的可选 <pat_name> 参数,通常只有当 <props> 参数包含 style_pattern 属性关键字时才应包含该参数。以下特殊注意事项影响这些请求:

  • <arg_vals> 列表中的条目数量始终相同(也就是说,该列表中的某个关键字同样适用于 <pat_name> 参数,无论 <pat_name> 是否从请求语句中获得取值)
  • 如果 <props> 参数由请求语句中的字面值指定、且它包含 style_pattern 属性关键字、并且 <arg_vals> 参数指定 <pat_name> 参数要求一个字面值,那么 <pat_name> 应出现在请求语句中
  • 如果 <props> 参数由对宏绘制寄存器的引用指定、并且 <arg_vals> 参数指定 <pat_name> 参数要求一个字面值,那么 <pat_name> 应出现在请求语句中
  • 除上述情形外,<pat_name> 不应出现在请求语句中