op_anim_viewer_scroll()
摘要
滚动查看器窗口,使指定的图形坐标与查看器原点对齐。
语法
op_anim_viewer_scroll (anvid, x, y)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是数值标识符,引用要滚动的查看器。] |
x |
int |
查看器原点的 x 坐标 |
y |
int |
查看器原点的 y 坐标 [ x 和 y 坐标值以像素为单位,从模型图形原点(左上角)起算。] |
返回类型
void
无返回值
示例
/** Message transmission delay line (TDL) chart. **/
/* Calculate the vertical coordinates of TDL. */
simtime = op_sim_time ();
y_src = (simtime / MAX_SIM_TIME) * MAX_Y_LEV;
y_dst = ((simtime + xmit_time) / MAX_SIM_TIME) * MAX_Y_LEV;
/* Draw TDL. */
op_anim_igp_line_draw (vid, lprops, X_SRC, y_src, X_DST, y_dst);
/* Label line at source with simulation time. */
sprintf (tstring, "%g", simtime);
op_anim_igp_text_draw (vid, tprops, X_SRC - TEXT_WIDTH, y_src, tstring);
/* If simulation time passes beyond chart extent, scroll the chart, */
/* leaving some overlap to maintain context. */
if (((int) (simtime / SCROLL_DURATION)) > scrollnum)
op_anim_viewer_scroll (vid, 0, (++scrollnum * SCROLL_DURATION) -
(SCROLL_DURATION * 0.10));
详情
创建查看器时,其滚动条会被初始化:水平滚动条位于其范围的最左端,垂直滚动条位于其范围的顶端。这种定位使图形的原点 (0,0) 与查看器的原点(窗口的左上角)对齐。手动调整查看器的滚动条会改变与查看器原点对齐的图形坐标。本内核过程具有类似的效果:它在查看器内重新定位图形,使指定的坐标与查看器原点对齐。
用途
提供一种改变大于查看器窗口的动画图形视图的机制。对于随仿真生成数据不断增大的自定义图形,查看器滚动非常有用。在这种情况下,可以通过动态滚动查看器到活动区域,使图形中最新添加的内容保持在视野内(示例小节演示了这一技术)。
错误
- 诊断错误:动画查看器 ID(
<anvid>)超出范围。(由于anvid参数的值无效) - 诊断错误:内核过程参数(
<arg_name>)的值超出范围(<value>)。(由于x和y参数的值超出 short 类型的范围)
参考
- 使用内核过程
op_anim_viewer_open()或op_anim_viewer_open_std()创建动画查看器并获取其 ID,或使用内核过程op_anim_lprobe_anvid()获取由带标签自定义动画探针打开的查看器 ID - 使用内核过程
op_anim_viewer_redraw()强制重绘查看器窗口