Qgis 开发初级《地图交互》

Qigs 添加数据的方式其实有两种，一种在非编辑模式下，一宗在编辑模式下，编辑模式下的数据操作是可以追溯的，可撤销，可恢复。编辑模式下的数据操作基本都是交互式操作，所以和事件是分不开的。qgis 的有些事件是和图层绑定在一起的，前面说过，qgis有当前图层的概念，qgis的内部事件的操作逻辑也是和当前图层绑定在一起的。所以，如果我们写自己的事件的话，为了避免和qgis的事件有冲突，通常要去掉qigs的事件，我们是二次开发，原则上不动qgis的源码，所以会去除当前图层，具体如何操作，后面会介绍。

1、事件

1.1、Tool 工具

无论是arcgis 还是qgis 都有tool的概念，简单来说，就是一种和地图交互的类。事件也是和这些Tool息息相关的。先看下Qgis里面内置的一些重要的Tools类。接下来，我们主要以 QgsMapToolEdit（地图编辑类）和QgsMapToolIdentify(地图拾取类) 两个主要类介绍事件。

当我们要自定义一个工具的时候，一般这样写，下面是一个继承了QgsMapToolIdentify基类的类。其中覆写了五个事件，依次为键盘按下事件，键盘抬起事件，鼠标按下事件，鼠标抬起事件和鼠标移动事件。

class BTool : public QgsMapToolIdentify
public:BTool(QgsMapCanvas* pMapCanvas);~BTool();protected:void keyPressEvent(QKeyEvent* e) override;void keyReleaseEvent(QKeyEvent* e) override;void canvasPressEvent(QgsMapMouseEvent* e) override;void canvasReleaseEvent(QgsMapMouseEvent* e) override;void canvasMoveEvent(QgsMapMouseEvent* e) override;};

其中在键盘事件中，可通过下面方法判断是按下了哪个键，qgis里面是有按键的枚举值的，我一般是通过这种数字去判断。27 表示按下的是ESC 的键。

e->nativeVirtualKey() == 27

在鼠标事件中，可通过下面方法判断是左键，还是右键，下面的代码表示按下了左键。

e->button() == Qt::MouseButton::LeftButton

1.2、Tool 工具的激活

Tool是工具一般都具有一个很重要的特点，一次只能启用一个工具，比如说，画点和画线，同时启用会带来混乱的。Tools 的工具激活状态和非激活状态都是通过QgsMapCanvas 来实现的。所谓其中就是让事件生效。小面就是让tool的Tool类生效。其中canvas 是QgsMapCanvas 类，tool是QgsMapTool类或者继承了该类的子类。

canvas->setMapTool(tool)

非活动状态，获取当前tool，使其进入非活动状态。

    auto tool = qgsmapcanvas->mapTool();canvas->unsetMapTool(tool);

2、交互绘图

交互绘图一般会继承QgsMapToolEdit 的类，继承里面的相关事件。交互绘图有个很重要的特点就是对象要实时显示，绘图点要跟随鼠标移动。事件怎么触发在第一小节已经介绍了。这里介绍一个很重要的对象QgsRubberBand。qgis的交互临时对象一般都离不开它。使用它可以让你更方便的绘图。用这个对象，一般在鼠标左键里面创建对象，在鼠标左键或者右键里面结束对象，在鼠标移动事件里面动态修改对象。Qgis 是由一个createRubberBand 方法，可以通过它获取对象。交互不在细说了，可以查看资源绑定里面的代码。

比如增加点

mpRubberBand->removeLastPoint();
mpRubberBand->addPoint(e->snapPoint());

比如说转成geometey

 mpRubberBand->asGeometry()

3、交互拾取

拾取是任何gis平台的一个重要功能。qgis的点击拾取功能是通过QgsMapToolIdentify(地图拾取类)这个类实现的。这个类有些非常重要的方法，qgis的拾取是通过这些方法实现的。一般传入屏幕坐标和geometry对象。

    QList<QgsMapToolIdentify::IdentifyResult> identify( int x, int y, const QList<QgsMapLayer *> &layerList = QList<QgsMapLayer *>(), IdentifyMode mode = DefaultQgsSetting, const QgsIdentifyContext &identifyContext = QgsIdentifyContext() );/*** Performs the identification.* To avoid being forced to specify IdentifyMode with a list of layers* this has been made private and two publics methods are offered* \param x x coordinates of mouseEvent* \param y y coordinates of mouseEvent* \param mode Identification mode. Can use QGIS default settings or a defined mode.* \param layerType Only performs identification in a certain type of layers (raster, vector, mesh). Default value is AllLayers.* \param identifyContext Identify context object.* \returns a list of IdentifyResult*/QList<QgsMapToolIdentify::IdentifyResult> identify( int x, int y, IdentifyMode mode, LayerType layerType = AllLayers, const QgsIdentifyContext &identifyContext = QgsIdentifyContext() );//! Performs identification based on a geometry (in map coordinates)QList<QgsMapToolIdentify::IdentifyResult> identify( const QgsGeometry &geometry, IdentifyMode mode, LayerType layerType, const QgsIdentifyContext &identifyContext = QgsIdentifyContext() );//! Performs identification based on a geometry (in map coordinates)QList<QgsMapToolIdentify::IdentifyResult> identify( const QgsGeometry &geometry, IdentifyMode mode, const QList<QgsMapLayer *> &layerList, LayerType layerType, const QgsIdentifyContext &identifyContext = QgsIdentifyContext() );

拿到IdentifyResult 对象后，它有两个很重要的属性，一个表示识别的要素，一个表示识别的图层。

QgsFeature feature = var.mFeature;
QgsMapLayer layer=var.mLayer;

还有一些其他的参数，像 IdentifyMode 控制识别的模式，是只识别激活图层，还是选择图层等等。

   enum IdentifyMode{DefaultQgsSetting = -1,ActiveLayer,TopDownStopAtFirst,TopDownAll,LayerSelection};

还有一个图层类型，用于指示识别的图层种类，qgis不仅仅能识别矢量图层，其他类型的图层也是可以识别的。

    enum Type{VectorLayer = 1,RasterLayer = 2,MeshLayer = 4, //!< \since QGIS 3.6VectorTileLayer = 8,  //!< \since QGIS 3.14PointCloudLayer = 16, //!< \since QGIS 3.18AllLayers = VectorLayer | RasterLayer | MeshLayer | VectorTileLayer | PointCloudLayer};

4、捕捉要素

要素操作还有一个重要的关于用户体验的操作，就是捕捉。首先我们看一下qgis的捕捉设置。可以看到qgis的捕捉功能是通过cavas获取QgsSnappingUtils来实现的。用setIndividualLayerSettings，可以把特定的需要捕捉的图层添加捕捉设置中。

QgsSnappingUtils* msnapper= QgsMapToolEdit::canvas()->snappingUtils();
QgsSnappingConfig  config = msnapper->config();config.setEnabled(true);config.setMode(Qgis::SnappingMode::AdvancedConfiguration);config.clearIndividualLayerSettings();QgsSnappingConfig::IndividualLayerSettings ids;ids.setEnabled(true);ids.setType(QgsSnappingConfig::SnappingType::Vertex);ids.setUnits(Qgis::MapToolUnit::Pixels /*QgsTolerance::UnitType::Pixels*/);ids.setTolerance(CCommConfig::getConfig("tolerance").toDouble());config.setIndividualLayerSettings(layer, ids);msnapper->setConfig(config);

捕捉模式有很多种，是个枚举类型。

  enum class SnappingMode SIP_MONKEYPATCH_SCOPEENUM_UNNEST( QgsSnappingConfig, SnappingMode ) : int{ActiveLayer = 1, //!< On the active layerAllLayers = 2, //!< On all vector layersAdvancedConfiguration = 3, //!< On a per layer configuration basis};

开始捕捉是通过QgsSnapIndicator 这个类实现的。一般来说，后面两行代码放在鼠标移动事件中。

	QgsSnapIndicator* msnapIndicator = new QgsSnapIndicator(QgsMapToolEdit::canvas());  auto sp = msnapper->snapToMap(e->pos());msnapIndicator->setMatch(sp);