op_anim_mme_nobj_pos()
摘要
在指定宏内定义一个操作,将指定模型对象的位置加载到一对寄存器中。
语法
op_anim_mme_nobj_pos (anmid, obj_type, obj_name, x_regid, y_regid, vertex)
| 参数 | 类型 | 说明 |
|---|---|---|
anmid |
Anmid |
宏 ID [该值是数值标识符,引用一个已打开的动画宏,由内核过程 op_anim_macro_create() 创建。] |
obj_type |
int |
对象类型代码 [这是数值代码,指定将被查询位置的模型对象类型。支持的对象类型常量列于详情小节。] |
obj_name |
char* |
对象名称 |
x_regid |
int |
位置 x 坐标的绘图寄存器 ID |
y_regid |
int |
位置 y 坐标的绘图寄存器 ID |
vertex |
int |
对象顶点代码 [这是数值代码,标识用于确定对象位置的对象“热点”。支持的顶点类型常量列于详情小节。] |
返回类型
void
无返回值
示例
/* Create a macro which draws a line between two nodes. */
mid = op_anim_macro_create ("node dynconn");
/* Determine the positions of the nodes A & B; the position of A is */
/* stored in (M,N) and the position of B is stored in (O,P). */
op_anim_mme_nobj_pos (mid, OPC_ANIM_OBJTYPE_NODE, OPC_ANIM_REG_A_STR,
OPC_ANIM_REG_M_INT, OPC_ANIM_REG_N_INT, OPC_ANIM_VERTEX_ICON_CTR);
op_anim_mme_nobj_pos (mid, OPC_ANIM_OBJTYPE_NODE, OPC_ANIM_REG_B_STR,
OPC_ANIM_REG_O_INT, OPC_ANIM_REG_P_INT, OPC_ANIM_VERTEX_ICON_CTR);
/* Indicate end of register setup section. */
op_anim_mgp_setup_end (mid);
/* Draw the line between the nodes. */
op_anim_mgp_line_draw (mid, OPC_ANIM_COLOR_GREEN,
OPC_ANIM_REG_M_INT, OPC_ANIM_REG_N_INT, OPC_ANIM_REG_O_INT, OPC_ANIM_REG_P_INT);
/* Execute the macro for source & destination nodes. */
op_anim_igp_macro_draw (vid, OPC_ANIM_RETAIN, mid,
OPC_ANIM_REG_A_STR, src_nd_name,
OPC_ANIM_REG_B_STR, dst_nd_name, OPC_EOL);
详情
obj_type 参数应传入格式为 OPC_ANIM_OBJTYPE_<type> 的符号常量,其中 <type> 的可能取值为:
- 网络模型对象
- SUBNET——子网对象
- NODE——节点对象(固定、移动、卫星)
- SIMPLINK——单工点对点链路对象
- DUPLINK——双工点对点链路对象
- BUSLINK——总线链路对象
- TAPLINK——总线分接对象
- MODULE——模块对象
- STREAM——数据包流对象
- STATWIRE——统计量连线对象
- 进程模型对象
- STATE——状态对象
- TRANSITION——转移对象
vertex 参数指定要加载到寄存器中的对象顶点。传入该参数的值应具有格式 OPC_ANIM_VERTEX_<v>,其中 <v> 为下列之一:
- 图标的角点(ICON_NE、ICON_NW、ICON_SE、ICON_SW)
- 图标边的中点(ICON_N、ICON_S、ICON_E、ICON_W)
- 图标的中心(ICON_CTR)
- 沿路径的三个点之一(PATH_SRC、PATH_DST、PATH_MID)
用途
提供一种获取模型对象位置的机制,供后续宏操作使用。许多宏在现有模型对象附近显示图形元素,以此描绘对象的状态。例如,可以在队列模块图标附近放置一行文本,指示队列中存储的数据包数量。
错误
- 程序中止:段错误(由于
obj_name参数的字符串格式错误) - 可恢复错误:动画宏 ID(
<anmid>)超出范围或无法识别。(前者由于anmid参数值无效,后者由于宏已被销毁) obj_type、vertex、x_regid和y_regid参数超出范围时的标准诊断错误。
参考
- 使用内核过程
op_anim_ime_gen_pos()将模型坐标中的一般位置转换为可用于 Anim 包图形内核过程的坐标值 - 使用内核过程
op_anim_macro_create()创建一个空宏 - 使用内核过程
op_anim_macro_close()表示宏定义完成 - 使用内核过程
op_anim_igp_macro_draw()在查看器内调用宏