AGG AGG的字符输出

2010-07-11 22:07

AGG的字符输出

字符输出，对于AGG来说，这个功能可以处于显示流程的 不同位置。比如字体引擎可直接处于“Scanline Rasterizer”层向渲染器提供已处理完毕的扫描线，也可以处于“Vertex Source顶点源”层提供字体的顶点数据。

下面，我们开始学习AGG不同的字符输出方式。如没有特殊说明，所以示例代码都基于此处代码

方式一、使用gsv_text对象

gsv_text属于顶点源层的对象，它的用法也很简单，直接看下例：

引用头文件：#include <agg_gsv_text.h>

在on_draw()方法的最后加入下面的代码

1. // gsv_text类
2. agg::gsv_text txt;
3. agg::conv_stroke<agg::gsv_text> cstxt(txt);
4. // 设置大小及是否反转
5. txt.flip(true);
6. txt.size(18);
7. // 设置位置和文字
8. txt.start_point(20,100);
9. txt.text("cpp");
10. // 以红色输出上面的文字
11. ras.add_path(cstxt);
12. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(1,0,0));
13. // 设置新的位置和文字
14. txt.start_point(20+txt.text_width(),100);
15. txt.text("prog.com");
16. // 以蓝色输出上面的文字
17. ras.add_path(cstxt);
18. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(0,0,1));

显示效果

注：gsv_text的flip ()方法指出是否上下反转输出，这里设置了flip是因为在Windows下agg::platform_support的rbuf_window()其 实是一个DIB缓存，它的方向是从下到上的。

gsv_text必须用conv_stroke转 换才能正确输出文字，否则会被当作多边形处理。为了使用方便，AGG提供了gsv_text_outline包 装，它实现了conv_stroke和坐标转换，代码很短：

1. template<class Transformer = trans_affine> class gsv_text_outline
2. {
3. public:
4.      gsv_text_outline(gsv_text& text, const Transformer& trans) :
5.        m_polyline(text),
6.        m_trans(m_polyline, trans){}
8.     void width(double w){
9.          m_polyline.width(w);
10.      }
12.     void transformer(const Transformer* trans){
13.          m_trans->transformer(trans);
14.      }
16.     void rewind(unsigned path_id) {
17.          m_trans.rewind(path_id);
18.          m_polyline.line_join(round_join);
19.          m_polyline.line_cap(round_cap);
20.      }
22.      unsigned vertex(double* x, double* y) {
23.         return m_trans.vertex(x, y);
24.      }
26. private:
27.      conv_stroke<gsv_text> m_polyline;
28.      conv_transform<conv_stroke<gsv_text>, Transformer> m_trans;
29. };

我们使用gsv_text_outline重写上面的代码：

1. #include <agg_gsv_text.h>
2. #include <agg_trans_single_path.h>
3. ...
4. /////////////////////////////////////////////////
5. // gsv_text及gsv_text_outline
6. agg::gsv_text txt;
7. agg::trans_single_path tran_path; //使用trans_single_path作为变换器
8. agg::gsv_text_outline<agg::trans_single_path> txtol(txt,tran_path);
9. // 设置变换器
10. tran_path.add_path(ell);
11. /////////////////////////////////////////////////
12. // 设置大小及是否反转
13. txt.flip(true);
14. txt.size(24);
15. // 设置位置和文字
16. txt.start_point(0,0);
17. txt.text("cpp");
18. // 以红色输出上面的文字
19. ras.add_path(txtol);
20. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(1,0,0));
22. // 设置新的位置和文字
23. txt.start_point(0+txt.text_width(),0);
24. txt.text("prog.com");
25. // 以蓝色输出上面的文字
26. ras.add_path(txtol);
27. agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(0,0,1));

显示效果

gsv_text的使用很简单，不过要了解的一点是：它只能输出ASCII可显示字符，对于汉字是无能为力的（你可以试试输出"C++编程"）。如果要输出汉字，我 们得继续寻找其它字符输出方式。