QGIS API Documentation  3.24.2-Tisler (13c1a02865)
qgsalgorithmboundary.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsalgorithmboundary.cpp
3  ------------------------
4  begin : April 2017
5  copyright : (C) 2017 by Nyall Dawson
6  email : nyall dot dawson at gmail dot com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #include "qgsalgorithmboundary.h"
19 #include "qgsvectorlayer.h"
20 
22 
23 QString QgsBoundaryAlgorithm::name() const
24 {
25  return QStringLiteral( "boundary" );
26 }
27 
28 QString QgsBoundaryAlgorithm::displayName() const
29 {
30  return QObject::tr( "Boundary" );
31 }
32 
33 QStringList QgsBoundaryAlgorithm::tags() const
34 {
35  return QObject::tr( "boundary,ring,border,exterior" ).split( ',' );
36 }
37 
38 QString QgsBoundaryAlgorithm::group() const
39 {
40  return QObject::tr( "Vector geometry" );
41 }
42 
43 QString QgsBoundaryAlgorithm::groupId() const
44 {
45  return QStringLiteral( "vectorgeometry" );
46 }
47 
48 QString QgsBoundaryAlgorithm::outputName() const
49 {
50  return QObject::tr( "Boundary" );
51 }
52 
53 QString QgsBoundaryAlgorithm::shortHelpString() const
54 {
55  return QObject::tr( "Returns the closure of the combinatorial boundary of the input geometries (ie the "
56  "topological boundary of the geometry). For instance, a polygon geometry will have a "
57  "boundary consisting of the linestrings for each ring in the polygon. Only valid for "
58  "polygon or line layers." );
59 }
60 
61 QList<int> QgsBoundaryAlgorithm::inputLayerTypes() const
62 {
64 }
65 
66 bool QgsBoundaryAlgorithm::supportInPlaceEdit( const QgsMapLayer * ) const
67 {
68  return false;
69 }
70 
71 QgsBoundaryAlgorithm *QgsBoundaryAlgorithm::createInstance() const
72 {
73  return new QgsBoundaryAlgorithm();
74 }
75 
76 QgsProcessingFeatureSource::Flag QgsBoundaryAlgorithm::sourceFlags() const
77 {
79 }
80 
81 QgsWkbTypes::Type QgsBoundaryAlgorithm::outputWkbType( QgsWkbTypes::Type inputWkbType ) const
82 {
84  switch ( QgsWkbTypes::geometryType( inputWkbType ) )
85  {
87  outputWkb = QgsWkbTypes::MultiPoint;
88  break;
89 
91  outputWkb = QgsWkbTypes::MultiLineString;
92  break;
93 
97  outputWkb = QgsWkbTypes::NoGeometry;
98  break;
99  }
100 
101  if ( QgsWkbTypes::hasZ( inputWkbType ) )
102  outputWkb = QgsWkbTypes::addZ( outputWkb );
103  if ( QgsWkbTypes::hasM( inputWkbType ) )
104  outputWkb = QgsWkbTypes::addM( outputWkb );
105 
106  return outputWkb;
107 }
108 
109 QgsFeatureList QgsBoundaryAlgorithm::processFeature( const QgsFeature &feature, QgsProcessingContext &, QgsProcessingFeedback *feedback )
110 {
111  QgsFeature outFeature = feature;
112 
113  if ( feature.hasGeometry() )
114  {
115  const QgsGeometry inputGeometry = feature.geometry();
116  const QgsGeometry outputGeometry = QgsGeometry( inputGeometry.constGet()->boundary() );
117  if ( outputGeometry.isNull() )
118  {
119  feedback->reportError( QObject::tr( "No boundary for feature %1 (possibly a closed linestring?)'" ).arg( feature.id() ) );
120  outFeature.clearGeometry();
121  }
122  else
123  {
124  outFeature.setGeometry( outputGeometry );
125  }
126  }
127  return QgsFeatureList() << outFeature;
128 }
129 
virtual QgsAbstractGeometry * boundary() const =0
Returns the closure of the combinatorial boundary of the geometry (ie the topological boundary of the...
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition: qgsfeature.h:56
QgsGeometry geometry
Definition: qgsfeature.h:67
void clearGeometry()
Removes any geometry associated with the feature.
Definition: qgsfeature.cpp:177
bool hasGeometry() const
Returns true if the feature has an associated geometry.
Definition: qgsfeature.cpp:223
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
Definition: qgsfeature.cpp:163
Q_GADGET QgsFeatureId id
Definition: qgsfeature.h:64
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:125
const QgsAbstractGeometry * constGet() const SIP_HOLDGIL
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
Q_GADGET bool isNull
Definition: qgsgeometry.h:127
Base class for all map layer types.
Definition: qgsmaplayer.h:73
Contains information about the context in which a processing algorithm is executed.
Flag
Flags controlling how QgsProcessingFeatureSource fetches features.
@ FlagSkipGeometryValidityChecks
Invalid geometry checks should always be skipped. This flag can be useful for algorithms which always...
Base class for providing feedback from a processing algorithm.
virtual void reportError(const QString &error, bool fatalError=false)
Reports that the algorithm encountered an error while executing.
@ TypeVectorLine
Vector line layers.
Definition: qgsprocessing.h:50
@ TypeVectorPolygon
Vector polygon layers.
Definition: qgsprocessing.h:51
static GeometryType geometryType(Type type) SIP_HOLDGIL
Returns the geometry type for a WKB type, e.g., both MultiPolygon and CurvePolygon would have a Polyg...
Definition: qgswkbtypes.h:968
static bool hasM(Type type) SIP_HOLDGIL
Tests whether a WKB type contains m values.
Definition: qgswkbtypes.h:1130
Type
The WKB type describes the number of dimensions a geometry has.
Definition: qgswkbtypes.h:70
static Type addZ(Type type) SIP_HOLDGIL
Adds the z dimension to a WKB type and returns the new type.
Definition: qgswkbtypes.h:1176
static bool hasZ(Type type) SIP_HOLDGIL
Tests whether a WKB type contains the z-dimension.
Definition: qgswkbtypes.h:1080
static Type addM(Type type) SIP_HOLDGIL
Adds the m dimension to a WKB type and returns the new type.
Definition: qgswkbtypes.h:1201
QList< QgsFeature > QgsFeatureList
Definition: qgsfeature.h:882