op_anim_mgp_bg_fill()
摘要
向指定宏添加一个图元,用背景颜色或图案填充查看器的窗口。
语法
op_anim_mgp_bg_fill (anmid, props, pat_name)
| 参数 | 类型 | 说明 |
|---|---|---|
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* |
图案名称 [该字符串指定用作填充操作图案的图标(只有当指定了属性标志 OPC_ANIM_STYLE_PATTERN 时才会引用此参数。填充图标必须由 op_vuanim 加载。用户自定义图标可以添加到用户的图标数据库 user_icon_db 中,位于 $HOME/op_admin。)] |
返回类型
void
无返回值
示例
/** Construct a macro which draws viewer title frame; **/
/** the title is expected in register S. **/
mid = op_anim_macro_create ("vtframe");
/* Fill the background with low-key color. */
op_anim_mgp_bg_fill (mid, OPC_ANIM_COLOR_TAN, " ");
/* Draw a double-rectangle inside window. */
op_anim_mgp_rect_draw (mid, OPC_ANIM_COLOR_BLACK, 10, 10, 600, 500);
op_anim_mgp_rect_draw (mid, OPC_ANIM_COLOR_BLACK, 12, 12, 596, 496);
/* Draw title near top of rectangle. */
op_anim_mgp_text_draw (mid, OPC_ANIM_ALIGNH_CENTER | OPC_ANIM_ALIGNV_TOP |
OPC_ANIM_FONT_OPEN_18 | OPC_ANIM_COLOR_BLACK, 300, 20, OPC_ANIM_REG_S_STR);
op_anim_macro_close (mid);
详情
此 KP 的 props 和 pat_name 参数可以接受宏寄存器 ID 符号常量,如“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页下列出的常量。如果为这些参数传入寄存器 ID,则实际值在宏被调用时从指定寄存器中取得。
背景填充受 color、pixop 和 style 图形属性的影响。注意,背景填充的颜色由 color 图形属性设置,而不是 bgcolor 图形属性(bgcolor 仅用于文本绘图的背景颜色)。默认颜色为黑色。如果 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参数的字面值不适用或无效)
参考
- 使用 KP op_anim_mgp_rect_fill() 填充宏内的矩形查看器区域
- 使用 KP op_anim_igp_bg_fill() 以立即模式填充查看器窗口背景
- 使用 KP op_anim_macro_create() 创建空宏
- 使用 KP op_anim_macro_close() 表示宏定义完成
- 使用 KP op_anim_igp_macro_draw() 在查看器中调用宏