AGG第十四课 agg::conv_dash 渲染虚线

1文件引用和参数描述

文件定义：include/agg_conv_dash.h

类定义：

  template<class VertexSource, class Markers=null_markers>

      conv_dash(VertexSource& vs) :

          conv_adaptor_vcgen<VertexSource, vcgen_dash, Markers>(vs)

注意：需要传递顶点源作为构造参数。

      void add_dash(double dash_len, double gap_len)

第一个参数是实线的长度，第二个参数是两条实线之间的距离，通过构建若干条相距gap_len的实线，达到虚线的效果

2 使用经验

刚开始的时候，认为agg::conv_stroke和agg::conv_dash是互相冲突的，认为前者是渲染实线，后者是渲染虚线，实际上，前者是渲染任何图形的轮廓线，虚线也是轮廓线的一种，只不过是进行了拆分吧了！！

3例子

代码如下：

              agg::path_storage ps1;

              ps1.move_to(200,200);

              ps1.line_to(1300,1300);

             agg::conv_dash<agg::path_storage>dash(ps1);

              //第一个参数是实线的长度，第二个参数是两条实线之间的距离，通过构建若干条

              //相距25的实线，达到虚线的效果

              dash.add_dash(5,25);//通不同的调整可以查看到效果，如果是5,5

              //可能完全没有任何的效果！！

             agg::conv_stroke<agg::conv_dash<agg::path_storage>>stroke(dash);

              //添加到渲染器中                     

              ras.add_path(stroke);

              //将线条渲染到内存图片当中，准备显示

              agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));

              ras.reset();

4虚线的宽度

如果当前的dash_len的长度比较短，可以取消抗锯齿，加快渲染的速度，可以对比查看效果尝试使用stroke.width函数设置宽度无效，dash没有提供设置线宽的函数

5取消虚线的抗锯齿

ras.gamma(agg::gamma_threshold(0.5));

例子如下：

  ras.reset();

  agg::path_storage ps;

  ps.move_to(30,40);

  ps.line_to(1300,1400);

  agg::conv_dash<agg::path_storage> dash(ps);

  dash.add_dash(10,30);

  agg::conv_stroke<agg::conv_dash<agg::path_storage>>stroke(dash);

  ras.add_path(stroke);

  //stroke.width(5);//测试线宽

  ras.gamma(agg::gamma_threshold(0.5));//测试抗锯齿

  agg::render_scanlines_aa_solid(ras,sl,renb,agg::rgba8(255,0,0));