op_anim_igp_bg_fill()

摘要

用背景颜色或图案填充指定查看器的窗口。

语法

op_anim_igp_bg_fill (anvid, props, pat_name)
参数 类型 说明
anvid Anvid 查看器 ID
[该值是引用某个查看器的数字标识符。背景填充将在该查看器的窗口中执行。]
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* 图案名称
[该字符串指定用作填充操作图案的图标。]

返回类型

Andid

已填充背景的绘图 ID

[保留绘图会被分配 ID,以便之后可以被擦除(参见参考部分)。要使绘图被保留,必须传入图形属性标志 OPC_ANIM_RETAIN。非保留绘图会被分配 ID 常量 OPC_ANIM_ID_NIL。]

示例

/* Open a full-size animation viewer. */
vid = op_anim_viewer_open_std ("Example Viewer", OPC_ANIM_LOCATION_FULL);

/* Fill in the window with a background color. */
op_anim_igp_bg_fill (vid, OPC_ANIM_RETAIN | OPC_ANIM_COLOR_STEEL, " ");

/** Divide the viewer into rectangular regions. **/

/* Draw left box. */
xmin = 10, ymin = 10;
wid = hgt = 400;
op_anim_igp_rect_draw (vid, OPC_ANIM_RETAIN | OPC_ANIM_COLOR_RED,
	xmin, ymin, wid, hgt);

/* Draw right box. */
xmin = xmin + wid + 10;
op_anim_igp_rect_draw (vid, OPC_ANIM_RETAIN | OPC_ANIM_COLOR_RED,
	xmin, ymin, wid, hgt);

详情

背景填充受 color、pixop、retention 和 style 图形属性的影响。注意,背景填充的颜色由 color 图形属性设置,而不是 bgcolor 图形属性(bgcolor 仅用于文本绘图的背景颜色)。默认颜色为黑色。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,背景填充可能会与查看器中显示的任何图形合并,而不是将其替换(注意:当背景填充之后将被擦除时,应使用 pixop 值 OPC_ANIM_PIXOP_XOR)。设置了 retention 图形属性(OPC_ANIM_RETAIN)的背景填充,将在关联的查看器窗口每次重绘时重新绘制。

只有当指定了 style 图形属性标志 OPC_ANIM_STYLE_PATTERN 时,pat_name 参数才会被引用。图案填充会重复平铺指定的图标以填满整个查看器窗口。平铺块与图形显示设备的绝对坐标对齐,而不是与查看器对齐,因此移动查看器可能改变其图案背景与查看器中显示的其他图形之间的相对对齐。你可以使用图标数据库编辑器(Icon Database Editor)创建图标并将其添加到图标数据库。更多信息见“Icon Database Editor“ 第 615 页。

如果 retention 图形属性未启用,或者由于缺少自定义动画探针、或存在当前未激活的自定义动画探针而导致 KP 执行被禁用,此 KP 将返回由符号常量 OPC_ANIM_ID_NIL 标识的特殊值。

用途

提供了一种机制,可将特定颜色设置为查看器窗口的背景(新创建查看器的默认背景颜色为黑色)。这对于特殊信息显示很有用,颜色背景可以增强呈现效果。填充整个查看器窗口也是让查看器恢复到已知状态、以便继续执行后续动画请求的简便方法。

错误

  • 程序中止:segmentation violation(由于 pat_name 参数的字符串格式错误)
  • 诊断错误:Animation viewer ID (<anvid>) is out-of-range.(由于 anvid 参数的值无效)
  • 诊断错误:Invalid property component (<prop_comp>) for graphical primitive.(由于 props 参数的值不适用或无效)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com