8.11 矢量图层线要素单一符号使用二(箭头)

前言

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

箭头（Arrow）

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

QGis设置线符号为箭头(Arrow)

• Symbol layer type选择箭头（Arrow），可以设置箭头的属性，如下图所示
• 箭头（Arrow）图层可以设置子符号为填充类型符号，填充类型符号进一步设置其符号图层的属性，如下图
• 设置完成后效果如下图

二次开发代码实现

• 类QgsArrowSymbolLayer代表箭头图层（Arrow layer），详情见文档，类图如下
• 类QgsArrowSymbolLayer还可以设置子符号setSubSymbol (QgsSymbol *symbol)，调用该函数可以设置填充类型符号
• QgsArrowSymbolLayer构造函数中默认创建了填充类型的符号，代码如下

QgsArrowSymbolLayer::QgsArrowSymbolLayer()
{
  /* default values */
  setOffset( 0.0 );
  setOffsetUnit( QgsUnitTypes::RenderMillimeters );

  mSymbol.reset( static_cast<QgsFillSymbol *>( QgsFillSymbol::createSimple( QVariantMap() ) ) );
}

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

1. 从图层获取渲染器

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

2. 构造函数：这里使用的默认属性，需要修改属性调用其setxxx函数即可，如setHeadType (HeadType type)

auto arrowSymbolLayer  = new QgsArrowSymbolLayer();

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

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

• 方法二 方法一中步骤1，3不变，步骤2中使用create()成员函数

    QVariantMap mp;
    mp["head_type"] = "0";
    mp["arrow_type"] = "0";
    auto arrowSymbolLayer  = QgsArrowSymbolLayer::create(mp);

• 完整测试代码如下

void MainWindow::lineArrowSlot()
{
    //添加一个线图层
    QgsVectorLayer* layer = addTestShape(QStringLiteral("maps/shapefile/rivers.shp"));
    //从图层获取渲染器
    QgsFeatureRenderer * layerRenderer= layer->renderer();
    QgsSingleSymbolRenderer *singleSymbolRenderer = QgsSingleSymbolRenderer::convertFromRenderer(layerRenderer);
#if 0
    auto arrowSymbolLayer  = new QgsArrowSymbolLayer();
#else
    QVariantMap mp;
    mp["head_type"] = "0";
    mp["arrow_type"] = "0";
    auto arrowSymbolLayer  = QgsArrowSymbolLayer::create(mp);
#endif
    //多个Symbol Layer构成一个Symbol
    QgsSymbolLayerList layerList;
    layerList << arrowSymbolLayer;
    //构造QgsLineSymbol并设置renderer
    auto lineSymbol = new QgsLineSymbol(layerList);
    singleSymbolRenderer->setSymbol(lineSymbol);
    layer->setRenderer(singleSymbolRenderer);
}

• 效果如下图

总结

• 介绍了矢量图层单一符号箭头的使用