op_anim_mgp_rect_fill()
摘要
向指定宏添加一个图元,绘制一个填充矩形。
语法
op_anim_mgp_rect_fill (anmid, props, pat_name, x, y, width, height)
| 参数 | 类型 | 说明 |
|---|---|---|
anmid |
Anmid |
宏 ID [该值是引用某个已打开动画宏的数字标识符,由 KP op_anim_macro_create() 创建。] |
props |
int |
图形属性标志 [该值是动画图形属性标志 OPC_ANIM_COLOR_*、OPC_ANIM_PIXOP_*、OPC_ANIM_BGCOLOR_*、OPC_ANIM_STYLE_*、OPC_ANIM_ALIGNH_*、OPC_ANIM_ALIGNV_*、OPC_ANIM_FONT_* 和 OPC_ANIM_RETAIN 按位 OR 组合。更多信息见“Animation“ 第 3 页。] |
pat_name |
char* |
图案名称 |
x |
int |
矩形左上角的 x 坐标 |
y |
int |
矩形左上角的 y 坐标 [ x 和 y 坐标以像素为单位,从查看器窗口的原点(左上角)起测量。] |
width |
int |
矩形的宽度(以像素为单位) |
height |
int |
矩形的高度(以像素为单位) |
返回类型
void
无返回值
示例
/** Construct a macro which depicts a blown-up state. **/
mid = op_anim_macro_create ("mega-state");
/* Fill the state’s circle centered at (X,Y). */
op_anim_mgp_circle_fill (mid, OPC_ANIM_COLOR_RED, " ",
OPC_ANIM_REG_X_INT, OPC_ANIM_REG_Y_INT, 200);
/* Draw the state’s inner ridge centered at (X,Y). */
op_anim_mgp_circle_draw (mid, OPC_ANIM_COLOR_BLACK,
OPC_ANIM_REG_X_INT, OPC_ANIM_REG_Y_INT, 200);
/* Fill the state’s label box at (M,N) (centered at (X,Y)). */
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_W_INT, (180 / 2));
op_anim_mgp_arop (mid, OPC_ANIM_REG_X_INT, OPC_ANIM_AROP_SUBTRACT,
OPC_ANIM_REG_W_INT, OPC_ANIM_REG_M_INT);
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_H_INT, (40 / 2));
op_anim_mgp_arop (mid, OPC_ANIM_REG_Y_INT, OPC_ANIM_AROP_SUBTRACT,
OPC_ANIM_REG_H_INT, OPC_ANIM_REG_N_INT);
op_anim_mgp_rect_fill (mid, OPC_ANIM_COLOR_BLACK, OPC_ANIM_REG_M_INT,
OPC_ANIM_REG_N_INT, 180, 40);
/* ... */
详情
此 KP 的 props、pat_name、x、y、width 和 height 参数可以接受宏寄存器 ID 符号常量,如“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页下列出的常量。如果为这些参数传入寄存器 ID,则实际值在宏被调用时从指定寄存器中取得。
填充矩形绘图受 color、pixop 和 style 图形属性的影响。矩形的 color 图形属性可以赋值 64 个索引颜色值中的任意一个(格式为 OPC_ANIM_COLOR_RGB<rgb>)或 25 个命名颜色值之一(默认颜色为黑色)。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,绘制在非黑色查看器像素之上的矩形部分可能显示为所赋值以外的颜色(注意:如果指定宏将以 retain 属性被调用以便之后擦除,则应使用 pixop 值 OPC_ANIM_PIXOP_XOR)。
只有当指定了 style 图形属性标志 OPC_ANIM_STYLE_PATTERN 时,pat_name 参数才会被引用。图案填充会重复平铺指定的图标以填充矩形区域。平铺块与图形显示设备的绝对坐标对齐,而不是与矩形对齐,因此移动查看器可能改变矩形与其填充平铺之间的相对对齐。你可以使用图标数据库编辑器(Icon Database Editor)创建图标并将其添加到图标数据库。更多信息见“Icon Database Editor“ 第 615 页。
用途
提供了一种在宏的上下文中绘制填充矩形的机制。矩形可以作为完全自定义显示的组成部分,也可以作为某种动态事件或状态的指示器添加到模型图中。填充矩形适合为动画图中的区域着色、替代性地表示节点、模块、状态等模型对象,或绘制协议层、数据包字段等抽象概念。
错误
- 程序中止:segmentation violation(当
props参数指定了图案填充时,由于pat_name参数的字符串格式错误) - 可恢复错误:Animation macro ID (
<anmid>) is [out-of-range] [unrecognized].(前者由于anmid参数的值无效,后者由于宏已被销毁) - 诊断错误:Invalid property component (
<prop_comp>) for graphical primitive.(由于props参数的字面值不适用或无效) - 诊断错误:Kernel procedure argument (
<arg>) has out-of-range value (<val>).(由于x、y、width或height参数的字面值超出 short 的范围)
参考
- 使用 KP op_anim_mgp_rect_draw() 在宏内绘制矩形轮廓
- 使用 KP op_anim_igp_rect_fill() 以立即模式填充矩形
- 使用 KP op_anim_macro_create() 创建空宏
- 使用 KP op_anim_macro_close() 表示宏定义完成
- 使用 KP op_anim_igp_macro_draw() 在查看器中调用宏