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 参数超出范围时的标准诊断错误。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com