AGG 顶点源(Vertex Source)

顶点源(Vertex Source)

顶点源是一种可以产生多边形所需要的“带命令的顶点”的对象。比如三角形顶点源，就应该会产生一个带“MoveTo”命令的点，另外二 个带"LineTo"命令的点和最终闭合的“ClosePoly”命令。

头文件

#include <agg_path_storage.h> //path_storage
#include <agg_ellipse.h>  // ellipse
#include <agg_arc.h> // arc
#include <agg_arrowhead.h> // arrowhead
#include <agg_curves.h> // curve3, curve4
#include <agg_gsv_text.h> // gsv_text, gsv_text_outline
#include <agg_rounded_rect.h> // rounded_rect
...

类型

自定义类	所有实现了void rewind(unsigned path_id);和unsigned vertex(double* x, double* y);的类。
ellipse	圆，输入为中心点坐标和XY轴半径，本文所用的例子就 使用了这个顶点源
arc	弧线，输入为中心点坐标和XY轴半径，以及起始和终止角(rad)，顺时针/逆时针方向
curve3	贝塞尔曲线，输入为起点坐标、第一控制点坐标、终点点坐标
curve4	贝塞尔曲线，输入为起点坐标、第一控制点坐标、第二控制点坐标、终点坐标
gsv_text	使用AGG自带字模的文字输出（只支持ASCII码），使用start_point方法指定文字位置，text方法指定 文字，flip指定是否上下倒转，size指定文字大小，适合与conv_stroke或gsv_text_outline配合。
gsv_text_outline<>	可变换文字，输入为gsv_text和变换矩阵(默认为trans_affine，后文会提到)。width方法设置文 字宽度
rounded_rect	圆角方形，输入为左上角右下角坐标和圆角半径
path_storage	路径存储器，可以用join_path方法加入多个顶点源。而且path_storage本身支持move_to, line_to，curve和arc_to等画线功能
arrowhead	箭头，它是作为标记点来用的

其中的arrowhead颇为特殊，它一般作为线段的标记点，具体用法是这样的：

arrowhead ah;
ah.head(d1,d2,d3,d4); //定义箭头
ah.tail(d1,d2,d3,d4); //定义箭尾
VertexSource VS; //其它顶点源
// 使用顶点转换器，并指定Markers类型为vcgen_markers_term
// 顶点转换器可以是conv_dash、conv_stroke或conv_marker_adaptor，见后文《坐标转换管道》
// vcgen_markers_term:以端点作为标记点
conv_stroke<VertexSource, vcgen_markers_term> csVS(VS);
...draw_term
// 用conv_marker指定ah作为线段marker点的标记
conv_marker<vcgen_markers_term, arrowhead> arrow(csVS.markers(), ah);
ras.add_path(csVS);
ras.add_path(arrow); //marker要紧随其后加入
...render

ah.head()和ah.tail()方法中的d1,d2,d3,d4参数的意义见下图

例，画一条简单的箭头直线(基于此处代码)

在on_draw()方法最后加上下列代码：

1. agg::arrowhead ah;
2. ah.head(0,10,5,5);
3. ah.tail(10,10,5,5);
4. // 用path_storage生成一条直线
5. agg::path_storage ps;
6. ps.move_to(160,60);
7. ps.line_to(100,100);
8. // 转换
9. agg::conv_stroke<agg::path_storage, agg::vcgen_markers_term> csps(ps);
10. agg::conv_marker<agg::vcgen_markers_term, agg::arrowhead>
11.       arrow(csps.markers(), ah);
12. // 画线
13. ras.add_path(csps);
14. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(0,0,0));
15. // 画箭头
16. ras.add_path(arrow);
17. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));

得到的图形是:

注意要加头文件:

#include "agg_conv_marker.h"
#include "agg_arrowhead.h"
#include "agg_path_storage.h"
#include "agg_vcgen_markers_term.h"

试验代码，自定义一个顶点源(基于此处代码)

为了对顶点源有更深入的了解，我们要自己实现一个顶点源，这个顶点源只是很简单的一个三角形。

前面说过，只要实现了 void rewind(unsigned path_id); 和 unsigned vertex(double* x, double* y); 方法就可以作为顶点源。

rewind方 法指示顶点源回到第一个顶点；vertex方 法取出当前顶点然后把当前顶点下移，返回值是当前顶点所带的命令。所谓的命令是一个enum path_commands_e类 型，定义如下：

1. enum path_commands_e
2. {
3.      path_cmd_stop      = 0,        //----path_cmd_stop   
4.      path_cmd_move_to   = 1,        //----path_cmd_move_to
5.      path_cmd_line_to   = 2,        //----path_cmd_line_to
6.      path_cmd_curve3    = 3,        //----path_cmd_curve3
7.      path_cmd_curve4    = 4,        //----path_cmd_curve4
8.      path_cmd_curveN    = 5,        //----path_cmd_curveN
9.      path_cmd_catrom    = 6,        //----path_cmd_catrom
10.      path_cmd_ubspline = 7,        //----path_cmd_ubspline
11.      path_cmd_end_poly = 0x0F,     //----path_cmd_end_poly
12.      path_cmd_mask      = 0x0F      //----path_cmd_mask   
13. };

path_commands_e还 能和path_flags_e组 合：

1. enum path_flags_e
2. {
3.      path_flags_none   = 0,         //----path_flags_none
4.      path_flags_ccw    = 0x10,      //----path_flags_ccw
5.      path_flags_cw     = 0x20,      //----path_flags_cw  
6.      path_flags_close = 0x40,      //----path_flags_close
7.      path_flags_mask   = 0xF0       //----path_flags_mask
8. };
   

vertex()返回的命令中含有path_cmd_stop时 表示结束。

1. // 等边三角形
2. class triangle{
3. public:
4.      triangle(double cx, double cy, double r)//中心点，r为中心点到边的长度
5.      {
6.         // 直接准备好三个点
7.          m_step = 0;
8.          m_pt[0].x = cx; m_pt[0].y = cy-r;
9.          m_pt[1].x = cx+r*0.866; m_pt[1].y = cy+r*0.5;
10.          m_pt[2].x = cx-r*0.866; m_pt[2].y = cy+r*0.5;
11.         //AGG把方向作为区分多边形内部和外部的依据，可以试试m_pt[1]和m_pt[2]对调
12.      }
13.     void rewind(unsigned)
14.      {
15.          m_step = 0;
16.      }
17.      unsigned vertex(double* x, double* y)
18.      {
19.         switch(m_step++)
20.          {
21.         case 0:
22.             //第一步，move_to
23.              *x = m_pt[0].x;
24.              *y = m_pt[0].y;
25.             return agg::path_cmd_move_to;
26.         case 1:
27.         case 2:
28.             //第二、三步，line_to
29.              *x = m_pt[m_step-1].x;
30.              *y = m_pt[m_step-1].y;
31.             return agg::path_cmd_line_to;
32.         case 3:
33.             // 第四步，闭合多边形
34.             return agg::path_cmd_end_poly|agg::path_flags_close;
35.         default:
36.             // 第五步，结束
37.             return agg::path_cmd_stop;
38.          }
39.      }
40. private:
41.      agg::point_d m_pt[3];
42.      unsigned m_step;
43. };

在on_draw()方法里把

    agg::ellipse ell(100,100,50 ,50); 改成 triangle ell(100,100,50);
    typedef agg::conv_contour< agg::ellipse> ell_cc_type;改成typedef agg::conv_contour< triangle> ell_cc_type;

得到的图形是:

除了文字输出功能（gsv_text只能输出ASCII文字），上面这些顶点源提供的图形丰富程度已经超过了系统API。文字输出功能 将以单独的篇幅讲述

作者：毛毛 来源：www.cppprog.com