op_anim_igp_text_draw()
摘要
在查看器内的指定位置,使用指定的图形属性绘制文本字符串。
语法
op_anim_igp_text_draw (anvid, props, x, y, text)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是引用某个查看器的数字标识符。文本将显示在该查看器的窗口中。] |
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 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量 |
text |
char* |
要绘制的文本字符串 |
返回类型
Andid
文本的绘图 ID
[保留绘图会被分配 ID,以便之后可以被擦除(参见参考部分)。要使绘图被保留,必须传入图形属性标志 OPC_ANIM_RETAIN。非保留绘图会被分配 ID 常量 OPC_ANIM_ID_NIL。]
示例
/** Draw the OSI 7-layer protocol stack. **/
/* Setup argument values. */
x = 100, y = 100;
w = 400, h = 50;
rfprops = OPC_ANIM_RETAIN | OPC_ANIM_COLOR_GREEN;
rdprops = OPC_ANIM_RETAIN | OPC_ANIM_COLOR_YELLOW;
tprops = OPC_ANIM_RETAIN | OPC_ANIM_COLOR_YELLOW |
OPC_ANIM_ALIGNH_CENTER | OPC_ANIM_ALIGNV_CENTER;
/* Loop through each layer. */
for (i = 0; i < 7; i++, y += h)
{
op_anim_igp_rect_fill (vid, rfprops, " ", x, y, w, h);
op_anim_igp_rect_draw (vid, rdprops, x, y, w, h);
op_anim_igp_text_draw (vid, tprops, x + (w / 2), y + (h / 2),
Stack_Name [i]);
}
详情
文本绘图受 color、bgcolor(背景颜色)、pixop、retain、font 和 style 图形属性的影响。文本的 color 和 bgcolor 图形属性可以赋值 64 个索引颜色值中的任意一个(格式为 OPC_ANIM_COLOR_RGB<rgb>)或 25 个命名颜色值之一(color 和 bgcolor 的默认值均为黑色)。文本字符串的背景颜色出现在文本周围的包围矩形中,填充各个字符之间的像素;这可用于使文本条带与彩色背景相匹配。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,绘制在非黑色查看器像素之上的文本部分可能显示为所分配颜色以外的颜色(注意:当矩形绘图之后将被擦除时,应使用 pixop 值 OPC_ANIM_PIXOP_XOR)。设置了 retain 图形属性(OPC_ANIM_RETAIN)的文本绘图,将在关联的查看器窗口每次重绘时重新绘制;默认情况下,它们会直接消失。
文本的大小可以通过 font 图形属性设置(可接受的值格式为 OPC_ANIM_FONT_OPEN_<ptsize>,其中 <ptsize> 可以是 10、12、14、18 或 24)。如果使用此方法,必须在你的偏好文件中包含 “open” 字体环境属性(格式为 fn_x_open_<size>pt)来设置窗口系统字体。文本相对于指定点的水平和垂直对齐可以通过 style 图形属性设置。属性格式为:OPC_ANIM_ALIGNH_<h>,其中 <h> 为 LEFT、CENTER 或 RIGHT;以及 OPC_ANIM_ALIGHV_<v>,其中 <v> 为 TOP、CENTER 或 BOTTOM。默认对齐方式为水平左对齐(文本左边缘位于该点)和垂直顶对齐(文本上边缘位于该点)。
用途
提供了一种在动画中绘制一行文本的机制。文本可以作为完全自定义显示的组成部分,也可以作为某种动态事件或状态的指示器添加到模型图中。文本在动画中适合显示动态仿真状态(如队列溢出、路由更新、协议状态)、显示统计量(如队列长度、冲突次数、平均吞吐量或时延),以及为图中对象添加标签。其中某些应用需要通过 KP op_anim_mme_nobj_pos() 将模型对象位置加载到宏寄存器中。
错误
- 程序中止:segmentation violation(由于
text参数的字符串格式错误) - 诊断错误:Animation viewer ID (
<anvid>) is out-of-range.(由于anvid参数的值无效) - 诊断错误:Invalid property component (
<prop_comp>) for graphical primitive.(由于props参数的值不适用或无效) - 诊断错误:Kernel procedure argument (
<arg_name>) has out-of-range value (<value>).(由于x或y参数的值超出 short integer 的范围)
参考
- 使用 KP op_anim_mgp_text_draw() 在宏的上下文中绘制文本
- 使用 KP op_anim_igp_drawing_erase() 擦除并释放由本 KP 创建的保留文本字符串
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID,或使用符号常量
OPC_ANIM_ANVID_PBSPEC从处于激活状态的无标签自定义动画探针获取查看器 ID