AGG第二十一课 agg::conv_contour 扩展轮廓线

1前言

轮廓线就是图形的边界，任何封闭的顶点源跳过agg::conv_stroke阶段，将会描绘实心的图形，填充的颜色和边界保持一致。如果不封闭的顶点源一旦跳过agg::conv_stroke就什么也不绘制。agg::conv_stroke就是用来描绘图形边界的。和agg::trans_affine对比可知，agg::conv_contour是扩展图形的轮廓线，通俗一点就是拓展图形的边界，对图形的边界进行放缩（但是和agg::trans_affine仿射变换不同，这是中心位置不变的缩放）。

2 官方例子

执行examples/conv_stroke例程，提供如下的控制：1）线段端点的切换2）线段之间的连接方式3）线段宽度

3代码分析

头文件：#include"agg/include/agg_conv_stroke.h"

1）线段端点的形状

enum line_cap_e { butt_cap,//按钮形状，实际和方形形状并无二致 square_cap,//设置之后，长度比butt_cap长一些 round_cap//半圆形状};设置函数：voidline_cap(line_cap_e lc)

2）线段的宽度

设置函数：voidwidth(double w)

3）介绍stroke的默认参数

当然我们可以不调用line_cap,也可以不调用width，因为stroke有默认的构造器，指定了默认的参数如下： m_width(0.5), m_width_abs(0.5), m_width_eps(0.5/1024.0), m_width_sign(1), m_miter_limit(4.0), m_inner_miter_limit(1.01), m_approx_scale(1.0), m_line_cap(butt_cap), m_line_join(miter_join), m_inner_join(inner_miter)

4）agg::conv_stroke的线段样式

采用的是实线的渲染方式，是否我们可以通过替换她，描述虚线：agg::conv_dash结果发现：什么也没有渲染出来！！agg::conv_dash会单独描述！！

3 例子

ras.reset(); agg::path_storage ps1; ps1.move_to(200,200); ps1.line_to(300,300); agg::line_cap_e cap = agg::round_cap;//设置线段端点的形状 agg::conv_stroke<agg::path_storage> stroke(ps1);//线段的样式 stroke.line_cap(cap); stroke.width(50);//设置线段的宽度 ras.add_path(stroke);agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));

2 agg::conv_contour轮廓变换

1 分析

轮廓线是图形的轮廓边界，扩展轮廓线也就是在图形的中心位置不变的情况下，边界进行了放缩，和affine的仿射缩放不同，后者是中心位置也会产生偏移，针对于圆形非常好理解，可以尝试对一个圆形分别进行agg::conv_contour和agg::trans_affine处理，可以看到明显的效果：agg::conv_contour原地膨胀agg::trans_affine圆心偏移，并且放缩3.3 例子回放 //Vertex Source agg::ellipse ell(100,100,50,50); // Coordinate conversion pipeline typedef agg::conv_contour<agg::ellipse> ell_cc_type; ell_cc_type ccell(ell); typedef agg::conv_stroke<ell_cc_type> ell_cc_cs_type; ell_cc_cs_type csccell(ccell); // Draw renb.clear(agg::rgba8(255,255,255)); for(int i=0; i<3; i++) { ccell.width(i*50);//看清楚，这是对轮廓线的实例进行的操作，而不是stroke实例 ras.add_path(csccell); agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));}分析：当i = 0的时候，并没有进行轮廓的放缩，可以清晰的了解到，进行轮廓放缩的时候，圆形变大了，实际上是圆形的轮廓边界放大的缘故，但是圆心不变！！

3 图形处理流程

网上提供的一般逻辑：矩阵变换agg::conv_transform轮廓边界扩展（实际上是边界缩放）agg::conv_contour转换成多义线（显示轮廓线）agg::conv_stroke再次重申：agg::conv_contour和agg::conv_stroke作为“坐标转换管道Coordinateconversion pipeline”，conv_contour扩展轮廓线，conv_stroke只显示轮廓线（如果没有conv_stroke就会显示实心圆，可以去掉试试）。

4代码分析

conv_contour实际上是由vcgen_contour真正实现的！！几乎所有的实现都是调用了vcgen_contour的generator函数 一个简单的测试例子： agg::ellipse ell(100,100,50,50); agg::trans_affine mtx; mtx.scale(2,1); typedef agg::conv_transform<agg::ellipse> ell_ct_type; ell_ct_type ctell(ell, mtx); /************/ typedef agg::conv_contour<ell_ct_type> ell_cc_type; ell_cc_type ccell(ctell); // 轮廓变换 ccell.width(6);//nothing happen /************/ typedef agg::conv_stroke<ell_cc_type> ell_cc_cs_type; ell_cc_cs_type csccell(ccell); //csccell.width(6); ras.add_path(ccell);agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));

5 auto_detect_orientation函数

正如名称所言：自动检测方向，什么方向，可能很多人不了解，通过AGG邮件了解到几点：扩展轮廓线跟图形的绘制方向有关（也就是move_to,line_to,构成的图形的顺时针，还是逆时针）。如下的两个例子，一个是顺时针绘制矩形，一个是逆时针绘制矩形，然后扩展轮廓线。

例子1逆时针

agg::path_storage ps; ps.move_to(395.5,200.5); ps.line_to(295.5,200.5); ps.line_to(295.5,210.5); ps.line_to(395.5,210.5);ps.close_polygon();agg::conv_contour<agg::path_storage> contour(ps);//contour.auto_detect_orientation(true);contour.width(m_slider1.value());//获取滑动条的值agg::conv_stroke<agg::conv_contour<agg::path_storage> >stroke(contour); ras.add_path(stroke);

例子2 顺时针

agg::path_storage ps; ps.move_to(395.5,200.5); ps.line_to(395.5,210.5); ps.line_to(295.5,210.5);ps.line_to(295.5,200.5); agg::conv_contour<agg::path_storage>contour(ps); contour.width(m_slider1.value()); agg::conv_stroke<agg::conv_contour<agg::path_storage> >stroke(contour);ras.add_path(stroke); 结果分析：第二个例子顺利的进行扩展线的放大或缩小，但是第一个例子刚好相反，两个例子之间的区别就是图形绘制的方向不同而已。所以为了解决这种问题，才引入了contour.auto_detect_orientation函数。把第一个例子的上面函数去掉注释，就可以按照正常的逻辑进行缩放轮廓线。

6 width函数参数意义探究

AGG里面大部分的函数参数都是需要高深的图形计算的知识，探究源码更是需要深厚的功底。所以现在只能够通过函数的调用，然后通过显示的图形，推导出该函数的具体含义。 结论如下：当前是通过规则的圆形来示范发现，当设置width参数为200的时候，半径是增加了100，其中的100都是以像素作为单位。每一个像素代表一个坐标点。如下是详细的代码： void TestContourValue() { agg::rendering_buffer &rbuf = rbuf_window(); agg::pixfmt_bgr24 pixf(rbuf); typedef agg::renderer_base<agg::pixfmt_bgr24> renderer_base_type; renderer_base_type renb(pixf); typedef agg::renderer_scanline_aa_solid<renderer_base_type>renderder_scanline_type; renderder_scanline_type rensl(renb); agg::rasterizer_scanline_aa<> ras; agg::scanline_u8 sl; ras.reset(); agg::path_storage ps; ps.move_to(200,200); ps.line_to(400,200); ps.line_to(400,400); ps.line_to(200,400); ps.close_polygon(); agg::conv_stroke<agg::path_storage> stroke(ps); ras.add_path(stroke); agg::ellipse ell(300,300,100,100); agg::conv_stroke<agg::ellipse> stroke1(ell); ras.add_path(stroke1); ps.remove_all(); ps.move_to(100,100); ps.line_to(500,100); ps.line_to(500,500); ps.line_to(100,500); ps.close_polygon(); agg::conv_stroke<agg::path_storage> stroke2(ps); ras.add_path(stroke2); agg::conv_contour<agg::ellipse> contour(ell); contour.width(200); agg::conv_stroke<agg::conv_contour<agg::ellipse> >stroke3(contour); ras.add_path(stroke3); ps.remove_all(); ps.move_to(0,0); ps.line_to(600,0); ps.line_to(600,600); ps.line_to(0,600); ps.close_polygon(); agg::conv_stroke<agg::path_storage> stroke4(ps); ras.add_path(stroke4); agg::conv_contour<agg::ellipse> contour1(ell); contour1.width(400); agg::conv_stroke<agg::conv_contour<agg::ellipse> >stroke5(contour1); ras.add_path(stroke5); agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(0,255,0)); }

7 扩展轮廓的限制

agg::conv_contour无法应用于自交的图形测试代码： void DrawIntersectContour() { agg::rendering_buffer &rbuf = rbuf_window(); agg::pixfmt_bgr24 pixf(rbuf); typedef agg::renderer_base<agg::pixfmt_bgr24> renderer_base_type; renderer_base_type renb(pixf); typedef agg::renderer_scanline_aa_solid<renderer_base_type>renderder_scanline_type; renderder_scanline_type rensl(renb); agg::rasterizer_scanline_aa<> ras; agg::scanline_u8 sl; ras.reset(); agg::path_storage ps; ps.move_to(200,400); ps.line_to(500,500); ps.line_to(200,500); ps.line_to(500,400); ps.line_to(200,400); agg::conv_contour<agg::path_storage> contour(ps); agg::conv_stroke<agg::conv_contour<agg::path_storage> >stroke(contour); ras.add_path(stroke);// agg::conv_stroke<agg::path_storage> stroke1(ps);// ras.add_path(stroke1); agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(0,255,0)); }结果分析：尝试绘制一个三角形漏斗，但是通过扩展轮廓线模块，发现没有进行封闭，可通过取消注释，查看具体的情况。实际上AGG提供的例子就是通过渲染a,实际上该字母本身就是自交的，导致了轮廓的放缩非常的奇怪！！如下是作者的描述：You can use conv_contour in your vectorpipeline. Seeexamples/conv_contour.cpp for details. Theonly problem is it won'twork forself-intersecting contours, because thedirection of the polygons isessential, but we can't talk about thepolygon direction if itintersectsitself.