op_anim_igp_icon_draw()

摘要

在指定位置绘制图标。

语法

op_anim_igp_icon_draw (anvid, props, ic_name, x, y)
参数 类型 说明
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 页。]
ic_name char* 图标名称
[该值是某个图标的名称,该图标必须位于 op_vuanim 程序加载的三个图标数据库之一中:sys_icon_db、op_vuanim_icon_db 或 user_icon_db]。
x int 图标左上角的 x 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量
y int 图标左上角的 y 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量

返回类型

Andid

图标的绘图 ID

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

示例

/** Mobile node position update interrupt: animate node’s new position. **/

/* Force calculation of new node position. */
op_ima_obj_pos_get (node_objid, &lat, &lon, &alt, &x, &y, &z);

/* Obtain new position of node in subnet coordinates. */
op_ima_obj_attr_get (node_objid, "x position", &sn_x);
op_ima_obj_attr_get (node_objid, "y position", &sn_y);

/* Convert node position from model coordinates to animation viewer coordinates. */
op_anim_ime_gen_pos (vid, sn_x, sn_y, &v_x, &v_y);

/* Erase node’s icon at previous position. */
op_anim_igp_drawing_erase (vid, node_did, OPC_ANIM_ERASE_MODE_XOR);

/* Redraw node’s icon at new position. */
node_did = op_anim_igp_icon_draw (vid, OPC_ANIM_RETAIN | OPC_ANIM_PIXOP_XOR, 
	"field_svc", v_x, v_y);

详情

图标绘图受 pixop 和 retain 图形属性的影响。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,绘制在非黑色查看器像素之上的图标部分可能显示为与颜色调色板编辑器中所指定颜色不同的颜色(更多信息见“Icon Database Editor“ 第 615 页)。

**注意:**当图标绘图之后将被擦除时,应使用 pixop 值 OPC_ANIM_PIXOP_XOR。

设置了 retain 图形属性(OPC_ANIM_RETAIN)的图标绘图,将在关联的查看器窗口每次重绘时重新绘制;默认情况下,它们会直接消失。

你可以使用图标数据库编辑器(Icon Database Editor)创建图标并将其添加到图标数据库。更多信息见“Icon Database Editor“ 第 615 页。边长最大 100 像素的图标都可以设计。但是,图标越大,绘制所需的时间越长(频繁更新的大图标在低性能工作站上可能导致动画不连贯)。

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

除了参考部分列出的查看器 ID 来源之外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示真正的查看器 ID 应从处于激活状态的无标签自定义动画探针获取。

用途

提供了一种在动画中绘制图标的机制。图标可以作为完全自定义显示的组成部分,也可以作为某种动态事件或状态的指示器添加到模型图中。注意,更改模型图中某个对象的图标是通过 op_anim_ime_nobj_update() 完成的。图标绘图适合描绘替代图中的节点或模块等静态模型对象,或描绘特定模型对象乃至整个仿真系统的状况与状态。本函数的示例演示了如何将移动节点描绘为移动的图标,而不是在模型图中更新节点的位置属性。

错误

  • 程序中止:segmentation violation(由于 ic_name 参数的字符串格式错误)
  • 诊断错误:Animation viewer ID (<anvid>) is out-of-range.(由于 anvid 参数的值无效)
  • 诊断错误:Invalid property component (<prop_comp>) for graphical primitive.(由于 props 参数的值不适用或无效)
  • 诊断错误:Kernel procedure argument (<arg_name>) has out-of-range value (<value>).(由于 x 或 y 参数的值超出 short integer 的范围)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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