内容发布更新时间 : 2024/12/23 11:54:39星期一 下面是文章的全部内容请认真阅读。
本文介绍了AGG输出字符的几种方法：自带的gsv_text对象、WinAPI字体引擎、FreeType字体引擎以及字体缓存管理器。并简单介绍了 FreeType在VC和C++Builder里的编译方法。 AGG的字符输出
字符输出，对于AGG来说，这个功能可以处于显示流程的 不同位置。比如字体引擎可直接处于“Scanline Rasterizer”层向渲染器提供已处理完毕的扫描线，也可以处于“Vertex Source顶点源”层提供字体的顶点数据。
下面，我们开始学习AGG不同的字符输出方式。如没有特殊说明，所以示例代码都基于此处代码
方式一、使用gsv_text对象
gsv_text属于顶点源层的对象，它的用法也很简单，直接看下例： 引用头文件：#include
? agg::gsv_text txt;
? agg::conv_stroke
? // 设置位置和文字 ? txt.start_point(20,100); ? txt.text(\
?? // 以红色输出上面的文字
?? ras.add_path(cstxt);
?? agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(1,0,0)); ?? // 设置新的位置和文字
?? txt.start_point(20+txt.text_width(),100); ?? txt.text(\
?? // 以蓝色输出上面的文字 ?? ras.add_path(cstxt);
?? 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和坐标转换，代码很短：
?? template
?? gsv_text_outline(gsv_text& text, const Transformer& trans) : ?? m_polyline(text),
?? m_trans(m_polyline, trans){} ?? ?? ?? ?? ?? ?? ?? ?? ??
void width(double w){ m_polyline.width(w); }
m_trans->transformer(trans); }
void rewind(unsigned path_id) {
?? void transformer(const Transformer* trans){
?? m_trans.rewind(path_id); ?? ?? ?? ??
m_polyline.line_join(round_join); m_polyline.line_cap(round_cap); }
?? unsigned vertex(double* x, double* y) { ?? return m_trans.vertex(x, y); ?? } ?? ?? private:
?? conv_stroke
?? conv_transform
我们使用gsv_text_outline重写上面的代码： ?? #include
?? #include
?? ///////////////////////////////////////////////// ?? // gsv_text及gsv_text_outline
?? agg::gsv_text txt;
?? agg::trans_single_path tran_path; //使用trans_single_path作为变换器 ?? agg::gsv_text_outline
?? tran_path.add_path(ell);
?? ///////////////////////////////////////////////// ?? // 设置大小及是否反转 ?? txt.flip(true); ?? txt.size(24);
?? // 设置位置和文字 ?? txt.start_point(0,0); ?? txt.text(\
?? // 以红色输出上面的文字
?? ras.add_path(txtol);
?? agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(1,0,0)); ??
?? // 设置新的位置和文字
?? txt.start_point(0+txt.text_width(),0); ?? txt.text(\
?? // 以蓝色输出上面的文字
?? ras.add_path(txtol);
?? agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba(0,0,1)); 显示效果
gsv_text的使用很简单，不过要了解的一点是：它只能输出ASCII可显示字符，对于汉字是无能为力的（你可以试试输出\C++编程\）。如果要输出汉字，我 们得继续寻找其它字符输出方式。
方式二、使用字体引擎(Font Engine)
AGG的字体引擎利用WinAPI:GetGlyphOutline或FreeType库得到字体数据（字模），它可以处于 “Scanline Rasterizer”层或“顶点源”层。要使用字体引擎，要把相应的字体引擎源码(agg_font_win32_tt.cpp或 agg_font_freetype.cpp)加入项目一起编译。 头文件
? #include
注意，它们都有自己的文件夹，不是在agg的include文件夹里。 类型
agg::font_engine_win32_tt_int16 agg::font_engine_win32_tt_int32 agg::font_engine_freetype_int16 agg::font_engine_freetype_int32
显然，前两个利用WinAPI实现，后两个利用FreeType库实现。类型后面的_int16或_int32后缀用于指定坐标单位， 一般int16已经可以满足要求。 成员类型定义： typedef path_adaptor_type typedef gray8_adaptor_type 把字体数据包装成顶点源的类 把字体数据包装成Scanline Rasterizer的类 typedef mono_adaptor_type 成员属性： double: height double: width bool: italic bool: flip_y bool: hinting unsigned: resolution 成员方法:
把字体数据包装成Scanline Rasterizer的类，但无AA效果 字体高度，单位为Point(和Word里的单位一样) 字体宽度，单位为Point*2.4。0表示规则大小(height/2.4) 斜体 上下翻转 字体修正 字体解析度，单位为dpi void transform(const trans_affine& affine); bool create_font(const char* typeface_, glyph_rendering ren_type); bool load_font(const char* font_name, unsigned face_index, glyph_rendering ren_type, const char* font_mem = 0, const long font_mem_size = 0); bool prepare_glyph(unsigned glyph_code) unsigned data_size() const void write_glyph_to(int8u* data) const 按矩阵变换 font_engine_win32_tt_*专有方法 建立字体，typeface_为字体名，ren_type稍后再说 font_engine_freetype_*专有方法 建立字体，font_name是字体文件名或字体名 得到字体数据(字模)所需方法 字体引擎的create_font()方法和load_font()方法需要一个glyph_rendering类型的ren_type参数，它决定了字 体数据的形式。三个成员类型定义：path_adaptor_type、gray8_adaptor_type和mono_adaptor_type所包 装的字体数据是 不一样的，只有与ren_type参数对应才能生成正确的AGG显示节点。
glyph_rendering是一个枚举类型，定义是：
? enum agg::glyph_rendering{
? glyph_ren_native_mono, //对应mono_adaptor_type ? glyph_ren_native_gray8, //对应gray8_adaptor_type ? glyph_ren_outline, //对应path_adaptor_type ? glyph_ren_agg_mono, //对应mono_adaptor_type ? glyph_ren_agg_gray8 //对应gray8_adaptor_type