op_anim_mgp_setup_end()

摘要

向指定宏添加一个图元。该图元标示宏 setup 段的结束。

语法

op_anim_mgp_setup_end (anmid)
参数 类型 说明
anmid Anmid 宏 ID
[该值是引用某个已打开动画宏的数字标识符,由 KP op_anim_macro_create() 创建。]

返回类型

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);

详情

宏的 setup 段通常确定模型对象的位置,并对这些位置施加偏移以计算相关图形元素的位置。宏第一次调用时计算出位置之后,除非参与计算的信息发生变化(如对象位置),否则无需重新执行宏的 setup 段。查看器重绘时无需重新执行宏的 setup 段。宏的 graphics 段只负责在预先计算好的位置上实际绘制图形元素。

用途

提供了一种将宏操作划分为 setup 段和 graphics 段的机制。这是可选的,但它可以提升动画图的重绘性能,因为查看器重绘操作不会重新执行 retain 宏绘图的 setup 段。查看器重绘时只重新执行宏的 graphics 段。

错误

  • 可恢复错误:Animation macro ID (<anmid>) is [out-of-range] [unrecognized].(前者由于 anmid 参数的值无效,后者由于宏已被销毁)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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