QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgsmaplayerutils.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsmaplayerutils.cpp
3 -------------------
4 begin : May 2021
5 copyright : (C) 2021 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 "qgsmaplayerutils.h"
19
24#include "qgslogger.h"
25#include "qgsmaplayer.h"
26#include "qgsprovidermetadata.h"
27#include "qgsproviderregistry.h"
28#include "qgsrectangle.h"
29
30#include <QRegularExpression>
31#include <QString>
32
33using namespace Qt::StringLiterals;
34
35QgsRectangle QgsMapLayerUtils::combinedExtent( const QList<QgsMapLayer *> &layers, const QgsCoordinateReferenceSystem &crs, const QgsCoordinateTransformContext &transformContext )
36{
37 // We can't use a constructor since QgsRectangle normalizes the rectangle upon construction
38 QgsRectangle fullExtent;
39 fullExtent.setNull();
40
41 // iterate through the map layers and test each layers extent
42 // against the current min and max values
43 QgsDebugMsgLevel( u"Layer count: %1"_s.arg( layers.count() ), 5 );
44 for ( const QgsMapLayer *layer : layers )
45 {
46 QgsDebugMsgLevel( "Updating extent using " + layer->name(), 5 );
47 QgsDebugMsgLevel( "Input extent: " + layer->extent().toString(), 5 );
48
49 if ( layer->extent().isNull() )
50 continue;
51
52 // Layer extents are stored in the coordinate system (CS) of the
53 // layer. The extent must be projected to the canvas CS
54 QgsCoordinateTransform ct( layer->crs(), crs, transformContext );
56 try
57 {
58 const QgsRectangle extent = ct.transformBoundingBox( layer->extent() );
59
60 QgsDebugMsgLevel( "Output extent: " + extent.toString(), 5 );
61 fullExtent.combineExtentWith( extent );
62 }
63 catch ( QgsCsException & )
64 {
65 QgsDebugError( u"Could not reproject layer extent"_s );
66 }
67 }
68
69 if ( fullExtent.width() == 0.0 || fullExtent.height() == 0.0 )
70 {
71 // If all of the features are at the one point, buffer the
72 // rectangle a bit. If they are all at zero, do something a bit
73 // more crude.
74
75 if ( fullExtent.xMinimum() == 0.0 && fullExtent.xMaximum() == 0.0 &&
76 fullExtent.yMinimum() == 0.0 && fullExtent.yMaximum() == 0.0 )
77 {
78 fullExtent.set( -1.0, -1.0, 1.0, 1.0 );
79 }
80 else
81 {
82 const double padFactor = 1e-8;
83 const double widthPad = fullExtent.xMinimum() * padFactor;
84 const double heightPad = fullExtent.yMinimum() * padFactor;
85 const double xmin = fullExtent.xMinimum() - widthPad;
86 const double xmax = fullExtent.xMaximum() + widthPad;
87 const double ymin = fullExtent.yMinimum() - heightPad;
88 const double ymax = fullExtent.yMaximum() + heightPad;
89 fullExtent.set( xmin, ymin, xmax, ymax );
90 }
91 }
92
93 QgsDebugMsgLevel( "Full extent: " + fullExtent.toString(), 5 );
94 return fullExtent;
95}
96
98{
99 if ( !layer )
100 {
101 return nullptr;
102 }
103
104 try
105 {
107 if ( ! providerMetadata )
108 {
109 return nullptr;
110 }
111
112 std::unique_ptr< QgsAbstractDatabaseProviderConnection > conn { static_cast<QgsAbstractDatabaseProviderConnection *>( providerMetadata->createConnection( layer->source(), {} ) ) };
113 return conn.release();
114 }
115 catch ( const QgsProviderConnectionException &ex )
116 {
117 if ( !ex.what().contains( "createConnection"_L1 ) )
118 {
119 QgsDebugError( u"Error retrieving database connection for layer %1: %2"_s.arg( layer->name(), ex.what() ) );
120 }
121 return nullptr;
122 }
123}
124
125bool QgsMapLayerUtils::layerSourceMatchesPath( const QgsMapLayer *layer, const QString &path )
126{
127 if ( !layer || path.isEmpty() )
128 return false;
129
130 const QVariantMap parts = QgsProviderRegistry::instance()->decodeUri( layer->providerType(), layer->source() );
131 return parts.value( u"path"_s ).toString() == path;
132}
133
134bool QgsMapLayerUtils::updateLayerSourcePath( QgsMapLayer *layer, const QString &newPath )
135{
136 if ( !layer || newPath.isEmpty() )
137 return false;
138
139 QVariantMap parts = QgsProviderRegistry::instance()->decodeUri( layer->providerType(), layer->source() );
140 if ( !parts.contains( u"path"_s ) )
141 return false;
142
143 parts.insert( u"path"_s, newPath );
144 const QString newUri = QgsProviderRegistry::instance()->encodeUri( layer->providerType(), parts );
145 layer->setDataSource( newUri, layer->name(), layer->providerType() );
146 return true;
147}
148
149QList<QgsMapLayer *> QgsMapLayerUtils::sortLayersByType( const QList<QgsMapLayer *> &layers, const QList<Qgis::LayerType> &order )
150{
151 QList< QgsMapLayer * > res = layers;
152 std::sort( res.begin(), res.end(), [&order]( const QgsMapLayer * a, const QgsMapLayer * b ) -> bool
153 {
154 for ( Qgis::LayerType type : order )
155 {
156 if ( a->type() == type && b->type() != type )
157 return true;
158 else if ( b->type() == type )
159 return false;
160 }
161 return false;
162 } );
163 return res;
164}
165
166QString QgsMapLayerUtils::launderLayerName( const QString &name )
167{
168 QString laundered = name.toLower();
169 const thread_local QRegularExpression sRxSwapChars( u"\\s"_s );
170 laundered.replace( sRxSwapChars, u"_"_s );
171
172 const thread_local QRegularExpression sRxRemoveChars( u"[^a-zA-Z0-9_]"_s );
173 laundered.replace( sRxRemoveChars, QString() );
174
175 return laundered;
176}
177
179{
180 if ( layer->providerType() == "wms"_L1 )
181 {
182 if ( const QgsProviderMetadata *metadata = layer->providerMetadata() )
183 {
184 QVariantMap details = metadata->decodeUri( layer->source() );
185 QUrl url( details.value( u"url"_s ).toString() );
186 if ( url.host().endsWith( ".openstreetmap.org"_L1 ) || url.host().endsWith( ".osm.org"_L1 ) )
187 {
188 return true;
189 }
190 }
191 }
192 return false;
193}
194
196{
197 switch ( type )
198 {
200 return QObject::tr( "Vector" );
202 return QObject::tr( "Raster" );
204 return QObject::tr( "Mesh" );
206 return QObject::tr( "Point Cloud" );
208 return QObject::tr( "Annotation" );
210 return QObject::tr( "Vector Tile" );
212 return QObject::tr( "Plugin" );
214 return QObject::tr( "Group" );
216 return QObject::tr( "Tiled Scene" );
217 }
218 Q_ASSERT( false );
219 return QString();
220}
LayerType
Types of layers that can be added to a map.
Definition qgis.h:193
@ Group
Composite group layer. Added in QGIS 3.24.
Definition qgis.h:201
@ Plugin
Plugin based layer.
Definition qgis.h:196
@ TiledScene
Tiled scene layer. Added in QGIS 3.34.
Definition qgis.h:202
@ Annotation
Contains freeform, georeferenced annotations. Added in QGIS 3.16.
Definition qgis.h:199
@ Vector
Vector layer.
Definition qgis.h:194
@ VectorTile
Vector tile layer. Added in QGIS 3.14.
Definition qgis.h:198
@ Mesh
Mesh layer. Added in QGIS 3.2.
Definition qgis.h:197
@ Raster
Raster layer.
Definition qgis.h:195
@ PointCloud
Point cloud layer. Added in QGIS 3.18.
Definition qgis.h:200
Provides common functionality for database based connections.
Represents a coordinate reference system (CRS).
Contains information about the context in which a coordinate transform is executed.
Handles coordinate transforms between two coordinate systems.
void setBallparkTransformsAreAppropriate(bool appropriate)
Sets whether approximate "ballpark" results are appropriate for this coordinate transform.
QgsRectangle transformBoundingBox(const QgsRectangle &rectangle, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward, bool handle180Crossover=false) const
Transforms a rectangle from the source CRS to the destination CRS.
Custom exception class for Coordinate Reference System related exceptions.
QString what() const
static bool updateLayerSourcePath(QgsMapLayer *layer, const QString &newPath)
Updates a layer's data source, replacing its data source with a path referring to newPath.
static QgsRectangle combinedExtent(const QList< QgsMapLayer * > &layers, const QgsCoordinateReferenceSystem &crs, const QgsCoordinateTransformContext &transformContext)
Returns the combined extent of a list of layers.
static QgsAbstractDatabaseProviderConnection * databaseConnection(const QgsMapLayer *layer)
Creates and returns the (possibly nullptr) database connection for a layer.
static QString layerTypeToString(Qgis::LayerType type)
Returns the translated name of the type for a given layer type.
static QList< QgsMapLayer * > sortLayersByType(const QList< QgsMapLayer * > &layers, const QList< Qgis::LayerType > &order)
Sorts a list of map layers by their layer type, respecting the order of types specified.
static QString launderLayerName(const QString &name)
Launders a layer's name, converting it into a format which is general suitable for file names or data...
static bool isOpenStreetMapLayer(QgsMapLayer *layer)
Returns true if the layer is served by OpenStreetMap server.
static bool layerSourceMatchesPath(const QgsMapLayer *layer, const QString &path)
Returns true if the source of the specified layer matches the given path.
Base class for all map layer types.
Definition qgsmaplayer.h:83
QString name
Definition qgsmaplayer.h:87
QString source() const
Returns the source for the layer.
QString providerType() const
Returns the provider type (provider key) for this layer.
void setDataSource(const QString &dataSource, const QString &baseName=QString(), const QString &provider=QString(), bool loadDefaultStyleFlag=false)
Updates the data source of the layer.
QgsProviderMetadata * providerMetadata() const
Returns the layer data provider's metadata, it may be nullptr.
Custom exception class for provider connection related exceptions.
Holds data provider key, description, and associated shared library file or function pointer informat...
virtual QgsAbstractProviderConnection * createConnection(const QString &uri, const QVariantMap &configuration)
Creates a new connection from uri and configuration, the newly created connection is not automaticall...
QVariantMap decodeUri(const QString &providerKey, const QString &uri)
Breaks a provider data source URI into its component paths (e.g.
static QgsProviderRegistry * instance(const QString &pluginPath=QString())
Means of accessing canonical single instance.
QString encodeUri(const QString &providerKey, const QVariantMap &parts)
Reassembles a provider data source URI from its component paths (e.g.
QgsProviderMetadata * providerMetadata(const QString &providerKey) const
Returns metadata of the provider or nullptr if not found.
A rectangle specified with double values.
Q_INVOKABLE QString toString(int precision=16) const
Returns a string representation of form xmin,ymin : xmax,ymax Coordinates will be truncated to the sp...
double xMinimum
double yMinimum
double xMaximum
void set(const QgsPointXY &p1, const QgsPointXY &p2, bool normalize=true)
Sets the rectangle from two QgsPoints.
double yMaximum
void combineExtentWith(const QgsRectangle &rect)
Expands the rectangle so that it covers both the original rectangle and the given rectangle.
void setNull()
Mark a rectangle as being null (holding no spatial information).
#define QgsDebugMsgLevel(str, level)
Definition qgslogger.h:63
#define QgsDebugError(str)
Definition qgslogger.h:59