前言

  • 本章介绍矢量图层线要素单一符号中爆炸线(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);
  1. 构造函数:设置颜色方案为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);
  1. 创建符号并设置到渲染器
    //多个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)的使用