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.(由于无法加载转换所需的网络模型)
参考
- 使用 KP op_anim_ime_nmod_draw() 在动画查看器内加载并显示模型;在对该查看器调用 op_anim_ime_gen_pos() 之前必须先这样做
- 使用 KP op_anim_mme_nobj_pos() 在宏的上下文中确定模型对象的查看器坐标
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID