op_anim_viewer_open_std()
摘要
按指定名称在指定的标准位置打开一个查看器。
语法
op_anim_viewer_open_std (name, location)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
char* |
查看器名称 [查看器名称用作全局动画的“会合点”(即重复使用同一查看器名称的打开操作将返回与首次打开操作相同的查看器 ID);因此多个进程甚至远程模块可以共享同一查看器。查看器名称还显示在查看器的横幅中,作为窗口标题。] |
location |
int |
查看器位置 [这是数值代码,指定单个标准查看器位置(含关联的位置与大小)。标准位置符号常量列于详情小节 |
返回类型
Anvid
所打开查看器的数值 ID
[该整数 ID 用作“句柄”,在调用其他 op_anim… 内核过程时引用新查看器。]
示例
/* Open a viewer for network. */
net_vid = op_anim_viewer_open_std ("Network View", OPC_ANIM_LOCATION_W_HALF);
/* 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_std ("Node View", OPC_ANIM_LOCATION_E_HALF);
/* 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);
详情
显式打开动画查看器是获取查看器以显示动画请求的几种技术之一(其他技术依赖自定义动画探针自动打开其关联的查看器)。调用本内核过程将按函数参数指定的方式打开查看器,并忽略任何已定义的自定义动画探针所指定的查看器属性。
本内核过程的执行受标准屏蔽条件禁用:动画流不活动,或完全没有自定义动画探针。但缺少活动的自定义动画探针并不会禁用其执行,因为无论探针何时变为活动,为动画内核过程保留一个可用的查看器非常重要。
location 参数指示新窗口的位置和大小,应传入格式为 OPC_ANIM_LOCATION_<loc> 的符号常量,其中 <loc> 的可能取值为:
- FULL——整个工作区
- N_HALF——工作区北半部
- S_HALF——工作区南半部
- E_HALF——工作区东半部
- W_HALF——工作区西半部
- NW_QTR——工作区西北四分之一
- NE_QTR——工作区东北四分之一
- SW_QTR——工作区西南四分之一
- SE_QTR——工作区东南四分之一
用途
提供一种打开标准大小窗口以显示动画的机制。查看器是动画的“绘图表面”,因此每个可视动画中必须至少打开一个查看器。当复合动画需要同时显示多个查看器时,标准查看器窗口位置非常有用:标准位置能将 op_vuanim 工作区整齐地“拼贴”排布,避免查看器相互重叠。
错误
- 程序中止:段错误(由于
name参数的字符串格式错误)
参考
- 使用内核过程
op_anim_viewer_open()以自定义位置和大小参数打开查看器 - 使用内核过程
op_anim_lprobe_anvid()获取由带标签动画探针打开的查看器 ID - 使用
op_anim_igp…内核过程在已打开的查看器中显示图形基元 - 使用
op_anim_ime…内核过程在已打开的查看器中显示或修改模型元素 - 使用内核过程
op_anim_viewer_close()擦除并释放已打开的查看器 - 使用内核过程
op_anim_viewer_redraw()触发查看器重绘