op_anim_ime_gen_pos()

摘要

将模型图中的任意位置的坐标转换为指定动画查看器中的等效坐标。

语法

op_anim_ime_gen_pos (anvid, modx, mody, vx_ptr, vy_ptr)
参数 类型 说明
anvid Anvid 查看器 ID
[该值是引用某个查看器的数字标识符。文本将显示在该查看器的窗口中。]
modx double 一般模型位置的 x 坐标
mody double 一般模型位置的 y 坐标
[modx 和 mody 坐标值以与指定查看器关联的模型的单位来测量。]
vx_ptr int* 指向整数的指针,将被赋值为对应查看器位置的 x 坐标
vy_ptr int* 指向整数的指针,将被赋值为对应查看器位置的 y 坐标
[vx_ptr 和 vy_ptr 坐标值以像素为单位,从查看器窗口的原点(左上角)起测量。]

返回类型

void

无返回值

示例

/** Draw triangulation lines from listening posts to mobile target. **/

/* Determine position of mobile target. */
op_ima_obj_pos_get (tgt_objid, &tgt_lat, &tgt_lon, &tgt_alt,
	&tgt_x, &tgt_y, &tgt_z);

/* Convert target position from model to viewer coordinates. */
op_anim_ime_gen_pos (vid, tgt_lon, tgt_lat, &tgt_vx, &tgt_vy);

/* Erase existing triangulation lines. */
op_anim_igp_drawing_erase (vid, tl1_id, OPC_ANIM_ERASE_MODE_XOR);
op_anim_igp_drawing_erase (vid, tl2_id, OPC_ANIM_ERASE_MODE_XOR);
op_anim_igp_drawing_erase (vid, tl3_id, OPC_ANIM_ERASE_MODE_XOR);

/* Draw new triangulation lines. */
line_props = OPC_ANIM_RETAIN | OPC_ANIM_PIXOP_XOR | OPC_ANIM_COLOR_YELLOW;
tl1_id = op_anim_igp_line_draw (vid, line_props, lp1_vx, lp1_vy, tgt_vx, tgt_vy);
tl2_id = op_anim_igp_line_draw (vid, line_props, lp2_vx, lp2_vy, tgt_vx, tgt_vy);
tl3_id = op_anim_igp_line_draw (vid, line_props, lp3_vx, lp3_vy, tgt_vx, tgt_vy);

详情

在使用此 KP 之前,必须先通过 KP op_anim_ime_nmod_draw() 对指定的动画查看器发出加载并显示模型请求。为了正确转换模型位置,位置坐标参数(modx 和 mody)应当位于与查看器关联的模型图的坐标系内。如果查看器中正在显示网络模型,指定的模型位置必须落在当前显示的视图(子网)范围内。如果指定的模型位置超出范围,将返回与指定位置所在象限对应的最大可显示查看器坐标(例如,超出范围的正模型坐标将被转换为查看器可用区域的右下角坐标)。

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

用途

提供了一种获取模型图中各位置的动画查看器坐标的机制。当在显示模型图的查看器中使用 op_anim_igp… 系列 KP 绘制图形图元时,这非常有用。也可以在调用宏时把获取到的查看器坐标作为参数传入。在节点图和进程图中,一般位置通常用处不大,因为大多数应用会在模型元素附近绘制图形图元。但在许多网络图中,一般位置具有“现实世界”的意义,可用于放置表示模型图中通常不描绘的动态对象或关系的图形图元。

错误

  • 程序中止:segmentation violation(由于 vx_ptr 和 vy_ptr 参数的整数指针无效)
  • 可恢复错误:Unable to perform translation of general model position into viewer coordinates.(由于无法加载转换所需的网络模型)

参考

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