8.11 矢量图层线要素单一符号使用五(标记线)

前言

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

标记线（Marker line）

在线条特征上绘制重复的标记符号。

在地理信息系统（GIS）和相关领域中，这种类型的线条符号可能用于表示沿着线条特征分布的一系列相同或相似的点状特征。

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

QGis设置线符号为标记线（Marker line）

• Symbol layer type设置为标记线（Marker line），可设置的属性如下图
  
• 可以设置其子符号为Marker符号，如下图
  
• 属性设置完成之后，效果如下图
  

二次开发代码实现标记线（Marker line）

• 类QgsMarkerLineSymbolLayer是标记线（Marker line），详情见文档，类图如下
  
• 和QgsHashedLineSymbolLayer有相同的父类，QgsMarkerLineSymbolLayer的子符号是Marker类型符号，而QgsHashedLineSymbolLayer是Line类型符号
• 构造函数中默认创建了simple marker类型的符号，如下代码

QgsMarkerLineSymbolLayer::QgsMarkerLineSymbolLayer( bool rotateMarker, double interval )
  : QgsTemplatedLineSymbolLayerBase( rotateMarker, interval )
{
  setSubSymbol( new QgsMarkerSymbol() );
}

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

1. 从图层获取渲染器

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

2. 构造函数，需要修改属性调用其setxxx函数即可，如setRotateSymbols (bool rotate)函数

auto markerSymbolLayer = new QgsMarkerLineSymbolLayer(true,3);

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

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

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

    QVariantMap mp;
    mp["rotate"] = QStringLiteral("1");
    mp["interval"] = QStringLiteral("3");
    auto markerSymbolLayer = QgsMarkerLineSymbolLayer::create(mp);

• 完整测试代码如下

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

}

• 效果如下图
  
  

总结

• 介绍了矢量图层线要素单一符号中标记线（Marker line）的使用