op_anim_igp_circle_fill()
摘要
在查看器内的指定位置,使用指定的图形属性绘制填充圆形。
语法
op_anim_igp_circle_fill (anvid, props, pat_name, ctr_x, ctr_y, radius)
| 参数 | 类型 | 说明 |
|---|---|---|
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 页。] |
pat_name |
char* |
图案名称 [该字符串指定用作填充图案的图标。] |
ctr_x |
int |
圆形中心点的 x 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量 |
ctr_y |
int |
圆形中心点的 y 坐标,以像素为单位,从查看器窗口的原点(左上角)起测量 |
radius |
int |
圆形的半径 [该值是以像素为单位测量的距离。] |
返回类型
Andid
圆形的绘图 ID
[保留绘图会被分配 ID,以便之后可以被擦除(参见参考部分)。要使绘图被保留,必须传入图形属性标志 OPC_ANIM_RETAIN。非保留绘图会被分配 ID 常量 OPC_ANIM_ID_NIL。]
示例
/* Open a full-size animation viewer. */
vid = op_anim_viewer_open_std ("Source-Dest Connectivity", OPC_ANIM_LOCATION_FULL);
/* Determine the number of nodes in network model. */
node_count = op_topo_object_count (OPC_OBJMTYPE_NODE);
/* Cache the graphical property flags for circles. */
circ_props = OPC_ANIM_RETAIN | OPC_ANIM_COLOR_BLUE;
/* Loop through nodes, drawing source and destination circles for each. */
for (i = 0, ypos = 100; i < node_count; i++, ypos += 40)
{
/* Draw source circle for node. */
op_anim_igp_circle_fill (vid, circ_props, " ", xleft, ypos, 10);
/* Draw destination circle for node. */
op_anim_igp_circle_fill (vid, circ_props, " ", xright, ypos, 10);
}
详情
填充圆形绘图受 color、pixop、retention 和 style 图形属性的影响。圆形的 color 图形属性可以赋值 64 个索引颜色值中的任意一个(格式为 OPC_ANIM_COLOR_RGB<rgb>)或 25 个命名颜色值之一(默认颜色为黑色)。如果 pixop 图形属性被设置为默认值(OPC_ANIM_PIXOP_SRC)以外的值,绘制在非黑色查看器像素之上的圆形部分可能显示为所分配颜色以外的颜色(注意:当圆形绘图之后将被擦除时,应使用 pixop 值 OPC_ANIM_PIXOP_XOR)。设置了 retention 图形属性(OPC_ANIM_RETAIN)的圆形绘图,将在关联的查看器窗口每次重绘时重新绘制;默认情况下,它们会直接消失。
只有当指定了 style 图形属性标志 OPC_ANIM_STYLE_PATTERN 时,pat_name 参数才会被引用。图案填充会重复平铺指定的图标以填满圆形区域。平铺块与图形显示设备的绝对坐标对齐,而不是与圆形对齐,因此移动查看器可能改变圆形与其填充平铺之间的相对对齐。你可以使用图标数据库编辑器(Icon Database Editor)创建图标并将其添加到图标数据库。更多信息见“Icon Database Editor“ 第 615 页。
如果 retention 图形属性未启用,或者由于缺少自定义动画探针、或存在当前未激活的自定义动画探针而导致 KP 执行被禁用,此 KP 将返回由符号常量 OPC_ANIM_ID_NIL 标识的特殊值。
用途
提供了一种在动画中绘制填充圆形的机制。圆形可以作为完全自定义显示的组成部分,也可以作为某种动态事件或状态的指示器添加到模型图中。填充圆形适合描绘替代图中的节点或状态等静态模型对象,或数据包、ICI 等动态模型对象。若要用填充圆形而非其典型模型图标来表示移动节点,可以通过 KP op_ima_obj_pos_get() 获取节点的位置,并可以通过 KP op_anim_ime_gen_pos() 将其转换为查看器坐标。状态历史图或动态 Petri 网等与模型无关的动画也可以利用 Igp 圆形。
错误
- 程序中止:segmentation violation(由于
pat_name参数的字符串格式错误) - 诊断错误: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>).(由于ctr_x、ctr_y或radius参数的值超出 short integer 的范围)
参考
- 使用 op_anim_igp_circle_draw() 绘制圆形轮廓
- 使用 op_anim_mgp_circle_fill() 在宏的上下文中填充圆形
- 使用 op_anim_igp_drawing_erase() 擦除并释放由本 KP 创建的保留圆形
- 使用 op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID,或使用符号常量
OPC_ANIM_ANVID_PBSPEC从处于激活状态的无标签自定义动画探针获取查看器 ID