op_anim_mgp_rect_draw()

摘要

向指定宏添加一个图元,绘制一个矩形。

语法

op_anim_mgp_rect_draw (anmid, props, x, y, width, height)
参数 类型 说明
anmid Anmid 宏 ID
[该值是引用某个已打开动画宏的数字标识符,由 KP op_anim_macro_create() 创建。]
props int 图形属性标志
[该值是动画图形属性标志 OPC_ANIM_COLOR_*、OPC_ANIM_PIXOP_*、OPC_ANIM_BGCOLOR_*、OPC_ANIM_STYLE_*、OPC_ANIM_ALIGNH_*、OPC_ANIM_ALIGNV_*、OPC_ANIM_FONT_* 和 OPC_ANIM_RETAIN 按位 OR 组合。更多信息见“Animation“ 第 3 页。]
x int 矩形左上角的 x 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量
y int 矩形左上角的 y 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量
width int 矩形的宽度(以像素为单位)
height int 矩形的高度(以像素为单位)

返回类型

void

无返回值

示例

/** Construct a macro which depicts a field within a packet. **/
mid = op_anim_macro_create ("pk field");

/* Draw a rectangle fixed at (X,Y) which has width(W) = no. bits(B) x 8 */
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_C_INT, 8);
op_anim_mgp_arop (mid, OPC_ANIM_REG_B_INT, OPC_ANIM_AROP_MULTIPLY,
	OPC_ANIM_REG_C_INT, OPC_ANIM_REG_W_INT);
op_anim_mgp_rect_draw (mid, OPC_ANIM_COLOR_RED, OPC_ANIM_REG_X_INT,
	OPC_ANIM_REG_Y_INT, OPC_ANIM_REG_W_INT, 15);

/* Draw the field name at (L,Y) where L = X + (W / 2) */
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_C_INT, 2);
op_anim_mgp_arop (mid, OPC_ANIM_REG_W_INT, OPC_ANIM_AROP_DIVIDE, OPC_ANIM_REG_C_INT,
	OPC_ANIM_REG_H_INT);
op_anim_mgp_arop (mid, OPC_ANIM_REG_X_INT, OPC_ANIM_AROP_ADD, OPC_ANIM_REG_H_INT,
	OPC_ANIM_REG_L_INT);
op_anim_mgp_text_draw (mid, OPC_ANIM_ALIGNH_CENTER | OPC_ANIM_ALIGNV_BOTTOM |
	OPC_ANIM_FONT_OPEN_10 | OPC_ANIM_COLOR_RED,
	OPC_ANIM_REG_L_INT, OPC_ANIM_REG_Y_INT, OPC_ANIM_REG_S_STR);

op_anim_macro_close (mid);

详情

此 KP 的 props、x、y、width 和 height 参数可以接受宏寄存器 ID 符号常量,如“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页下列出的常量。如果为这些参数传入寄存器 ID,则实际值在宏被调用时从指定寄存器中取得。

矩形绘图受 color、pixop 和 style 图形属性的影响。线段的 color 图形属性可以赋值 64 个索引颜色值中的任意一个(格式为 OPC_ANIM_COLOR_RGB<rgb>)或 25 个命名颜色值之一(默认颜色为黑色)。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,绘制在非黑色查看器像素之上的矩形部分可能显示为所赋值以外的颜色(注意:如果指定宏将以 retain 属性被调用以便之后擦除,则应使用 pixop 值 OPC_ANIM_PIXOP_XOR)。矩形的 style 图形属性可以取三个值之一:实线矩形由符号常量 OPC_ANIM_STYLE_SOLID 指定(默认值),虚线矩形由 OPC_ANIM_STYLE_DASHES 指定,点线矩形由 OPC_ANIM_STYLE_DOTS 指定。

用途

提供了一种在宏的上下文中绘制矩形的机制。矩形可以作为完全自定义显示的组成部分,也可以作为某种动态事件或状态的指示器添加到模型图中。未填充的矩形适合划分动画图中的区域、替代性地表示节点、模块、状态等模型对象,或绘制协议层、数据包字段等抽象概念。

错误

  • 可恢复错误:Animation macro ID (<anmid>) is [out-of-range] [unrecognized].(前者由于 anmid 参数的值无效,后者由于宏已被销毁)
  • 诊断错误:Invalid property component (<prop_comp>) for graphical primitive.(由于 props 参数的字面值不适用或无效)
  • 诊断错误:Kernel procedure argument (<arg>) has out-of-range value (<val>).(由于 x、y、width 或 height 参数的字面值超出 short 的范围)

参考

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