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参数的值无效,后者由于宏已被销毁)
参考
- 使用 KP op_anim_macro_create() 创建空宏
- 使用 KP op_anim_macro_close() 表示宏定义完成
- 使用 KP op_anim_igp_macro_draw() 在查看器中调用宏