op_anim_viewer_open()
摘要
按指定的名称、位置和大小打开一个查看器。
语法
op_anim_viewer_open (name, x, y, width, height)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
char* |
查看器名称 [查看器名称用作全局动画的“会合点”(即重复使用同一查看器名称的打开操作将返回与首次打开操作相同的查看器 ID);因此多个进程甚至远程模块可以共享同一查看器。查看器名称还显示在查看器的横幅中,作为窗口标题。] |
x |
int |
查看器左上角的 x 坐标 |
y |
int |
查看器左上角的 y 坐标 [x 和 y 坐标值以像素为单位,从工作区原点(左上角)起算。] |
width |
int |
查看器宽度(像素) |
height |
int |
查看器高度(像素) |
返回类型
Anvid
所打开查看器的数值 ID
[该整数 ID 用作“句柄”,在调用其他 op_anim… 内核过程时引用新查看器。]
示例
/* Open a viewer for network. */
net_vid = op_anim_viewer_open ("Network View", 10, 10, 450, 650);
/* Load network model. */
op_anim_ime_nmod_draw (net_vid, OPC_ANIM_MODTYPE_NETWORK, "inet", "top",
OPC_ANIM_MOD_OPTION_NONE, OPC_ANIM_DEFPROPS);
/* Open a viewer for node. */
node_vid = op_anim_viewer_open ("Node View", 475, 10, 450, 650);
/* Load node model. */
op_anim_ime_nmod_draw (node_vid, OPC_ANIM_MODTYPE_NODE, "inet_fddi_gwy", " ",
OPC_ANIM_MOD_OPTION_NONE, OPC_ANIM_DEFPROPS);
详情
显式打开动画查看器是获取查看器以显示动画请求的几种技术之一(其他技术依赖自定义动画探针自动打开其关联的查看器)。调用本内核过程将按函数参数指定的方式打开查看器,并忽略任何已定义的自定义动画探针所指定的查看器属性。
本内核过程的执行受标准屏蔽条件禁用:动画流不活动,或完全没有自定义动画探针。但缺少活动的自定义动画探针并不会禁用其执行,因为无论探针何时变为活动,为动画内核过程保留一个可用的查看器非常重要。
用途
提供一种按指定位置和大小打开查看器窗口的机制。查看器是动画的“绘图表面”,因此每个可视动画中必须至少打开一个查看器。
错误
- 程序中止:段错误(由于
name参数的字符串格式错误) - 诊断错误:内核过程参数(
<arg_name>)的值超出范围(<value>)。(由于x、y、width或height参数的值超出 short 类型的范围)
参考
- 使用内核过程
op_anim_viewer_open_std()以标准位置和大小打开查看器 - 使用内核过程
op_anim_lprobe_anvid()获取由带标签动画探针打开的查看器 ID - 使用
op_anim_igp…内核过程在已打开的查看器中显示图形基元 - 使用
op_anim_ime…内核过程在已打开的查看器中显示或修改模型元素 - 使用内核过程
op_anim_viewer_close()擦除并释放已打开的查看器 - 使用内核过程
op_anim_viewer_redraw()触发查看器重绘