前言

• 本章介绍矢量图层线要素单一符号中爆炸线（Lineburst）的使用
• 说明：文章中的示例代码均来自开源项目qgis_cpp_api_apps

爆炸线（Lineburst）

沿着一条线垂直绘制渐变图案。
在地理信息系统（GIS）和相关领域中，这种类型的线条符号可能用于表示某种渐变的线性特征，例如地形高度变化、光照强度变化或人口密度变化等。通过在线条上绘制渐变图案，可以更直观地展示这些特征的变化趋势和分布情况。

• 以river.shp图层为例，在QGis中添加river图层，默认使用的符号是简单线，如下图所示
  

QGis设置线符号为爆炸线（Lineburst）

• Symbol layer type设置为Lineburst，可设置的属性见下图
  
• 符号颜色有两种选择：两种颜色(Two color)和渐变色(Color ramp)
• 属性设置为Tow color效果如下
  
• 设置为Color ramp效果如下
  

二次开发代码实现爆炸线（Lineburst）

• 类QgsLineburstSymbolLayer是Lineburst，详情见文档，类图如下
  
• 符号颜色有两种，函数setGradientColorType设置颜色方案，参数代码如下

enum class GradientColorSource 
{
  SimpleTwoColor, //!< Simple two color gradient
  ColorRamp, //!< Gradient color ramp
};

• 构造函数中默认是SimpleTwoColor，代码如下

QgsLineburstSymbolLayer::QgsLineburstSymbolLayer( const QColor &color, const QColor &color2 )
  : QgsAbstractBrushedLineSymbolLayer()
  , mColor2( color2 )
{
  setColor( color );
}

• 代码实现设置图层符号有两种方法：构造函数和静态函数create
• 方法一

1. 从图层获取渲染器

    //从图层获取渲染器
    QgsFeatureRenderer * layerRenderer= layer->renderer();
    QgsSingleSymbolRenderer *singleSymbolRenderer = QgsSingleSymbolRenderer::convertFromRenderer(layerRenderer);

2. 构造函数：设置颜色方案为SimpleTwoColor或者ColorRamp

//    auto lineBurstSymbolLayer = new QgsLineburstSymbolLayer(QColor(35,35,35),Qt::white);
//    lineBurstSymbolLayer->setGradientColorType(Qgis::GradientColorSource::SimpleTwoColor);
//    lineBurstSymbolLayer->setWidth(2.0);
    auto lineBurstSymbolLayer = new QgsLineburstSymbolLayer();
    lineBurstSymbolLayer->setGradientColorType(Qgis::GradientColorSource::ColorRamp);
    QgsGradientColorRamp *ramp = new QgsGradientColorRamp(QColor( 0, 255, 0 ), QColor( 0, 20, 0 ));
    lineBurstSymbolLayer->setColorRamp(ramp);
    lineBurstSymbolLayer->setWidth(2.0);

3. 创建符号并设置到渲染器

    //多个Symbol Layer构成一个Symbol
    QgsSymbolLayerList layerList;
    layerList << rasterSymbolLayer;
    //构造QgsLineSymbol并设置renderer
    auto lineSymbol = new QgsLineSymbol(layerList);
    singleSymbolRenderer->setSymbol(lineSymbol);
    layer->setRenderer(singleSymbolRenderer);

• 方法二
  方法一中步骤1，3不变，步骤2中使用create()成员函数，颜色方案同样有两种选择

    QVariantMap mp;
//    mp["color_type"] = QStringLiteral("0");
//    mp["color"] = QStringLiteral("35,35,35");
//    mp["gradient_color2"] = QStringLiteral("250,250,250");

    mp["color_type"] = QStringLiteral("1");
    mp["color1"] = QStringLiteral("0, 255, 0");
    mp["color2"] = QStringLiteral("0, 20, 0");
    mp["line_width"] = QStringLiteral("2.0");
    auto lineBurstSymbolLayer = QgsLineburstSymbolLayer::create(mp);

• 完整测试代码如下

void MainWindow::lineBurstSlot()
{
    //添加一个线图层
    QgsVectorLayer* layer = addTestShape(QStringLiteral("maps/shapefile/rivers.shp"));
    //从图层获取渲染器
    QgsFeatureRenderer * layerRenderer= layer->renderer();
    QgsSingleSymbolRenderer *singleSymbolRenderer = QgsSingleSymbolRenderer::convertFromRenderer(layerRenderer);
#if 0
//    auto lineBurstSymbolLayer = new QgsLineburstSymbolLayer(QColor(35,35,35),Qt::white);
//    lineBurstSymbolLayer->setGradientColorType(Qgis::GradientColorSource::SimpleTwoColor);
//    lineBurstSymbolLayer->setWidth(2.0);
    auto lineBurstSymbolLayer = new QgsLineburstSymbolLayer();
    lineBurstSymbolLayer->setGradientColorType(Qgis::GradientColorSource::ColorRamp);
    QgsGradientColorRamp *ramp = new QgsGradientColorRamp(QColor( 0, 255, 0 ), QColor( 0, 20, 0 ));
    lineBurstSymbolLayer->setColorRamp(ramp);
    lineBurstSymbolLayer->setWidth(2.0);

#else
    QVariantMap mp;
//    mp["color_type"] = QStringLiteral("0");
//    mp["color"] = QStringLiteral("35,35,35");
//    mp["gradient_color2"] = QStringLiteral("250,250,250");

    mp["color_type"] = QStringLiteral("1");
    mp["color1"] = QStringLiteral("0, 255, 0");
    mp["color2"] = QStringLiteral("0, 20, 0");
    mp["line_width"] = QStringLiteral("2.0");
    auto lineBurstSymbolLayer = QgsLineburstSymbolLayer::create(mp);
#endif
    //多个Symbol Layer构成一个Symbol
    QgsSymbolLayerList layerList;
    layerList << lineBurstSymbolLayer;
    //构造QgsLineSymbol并设置renderer
    auto lineSymbol = new QgsLineSymbol(layerList);
    singleSymbolRenderer->setSymbol(lineSymbol);
    layer->setRenderer(singleSymbolRenderer);

}

• 效果如下图
  
  

总结

• 介绍了矢量图层线要素单一符号中爆炸线（Lineburst）的使用