29using namespace Qt::StringLiterals;
33int tile2tms(
const int y,
const int zoom )
35 double n = std::pow( 2, zoom );
36 return (
int ) std::floor( n - y - 1 );
39int lon2tileX(
const double lon,
const int z )
41 return (
int ) ( std::floor( ( lon + 180.0 ) / 360.0 * ( 1 << z ) ) );
44int lat2tileY(
const double lat,
const int z )
46 double latRad = lat * M_PI / 180.0;
47 return (
int ) ( std::floor( ( 1.0 - std::asinh( std::tan( latRad ) ) / M_PI ) / 2.0 * ( 1 << z ) ) );
50double tileX2lon(
const int x,
const int z )
52 return x / ( double ) ( 1 << z ) * 360.0 - 180;
55double tileY2lat(
const int y,
const int z )
57 double n = M_PI - 2.0 * M_PI * y / ( double ) ( 1 << z );
58 return 180.0 / M_PI * std::atan( 0.5 * ( std::exp( n ) - std::exp( -n ) ) );
61QList<MetaTile> getMetatiles(
const QgsRectangle extent,
const int zoom,
long long &tileCount,
const int tileSize )
63 int minX = lon2tileX( extent.
xMinimum(), zoom );
64 int minY = lat2tileY( extent.
yMaximum(), zoom );
65 int maxX = lon2tileX( extent.
xMaximum(), zoom );
66 int maxY = lat2tileY( extent.
yMinimum(), zoom );
67 tileCount =
static_cast<long long>( maxX - minX + 1 ) *
static_cast<long long>( maxY - minY + 1 );
70 QMap<QString, MetaTile> tiles;
71 for (
int x = minX; x <= maxX; x++ )
74 for (
int y = minY; y <= maxY; y++ )
76 QString key = u
"%1:%2"_s.arg( (
int ) ( i / tileSize ) ).arg( (
int ) ( j / tileSize ) );
77 MetaTile tile = tiles.value( key, MetaTile() );
78 tile.addTile( i % tileSize, j % tileSize, Tile( x, y, zoom ) );
79 tiles.insert( key, tile );
84 return tiles.values();
89QString QgsXyzTilesBaseAlgorithm::group()
const
91 return QObject::tr(
"Raster tools" );
94QString QgsXyzTilesBaseAlgorithm::groupId()
const
96 return u
"rastertools"_s;
104void QgsXyzTilesBaseAlgorithm::createCommonParameters()
110 addParameter(
new QgsProcessingParameterColor( u
"BACKGROUND_COLOR"_s, QObject::tr(
"Background color" ), QColor( Qt::transparent ),
true,
true ) );
112 addParameter(
new QgsProcessingParameterEnum( u
"TILE_FORMAT"_s, QObject::tr(
"Tile format" ), QStringList() << u
"PNG"_s << u
"JPG"_s,
false, 0 ) );
119 Q_UNUSED( feedback );
124 QSet<QString> visibleLayers;
127 if ( layer->isVisible() )
129 visibleLayers << layer->layer()->id();
136 if ( visibleLayers.contains( layer->id() ) )
139 clonedLayer->moveToThread(
nullptr );
140 mLayers << clonedLayer;
144 QgsRectangle extent = parameterAsExtent( parameters, u
"EXTENT"_s, context );
149 mExtent = ct.transformBoundingBox( extent );
153 feedback->
reportError( QObject::tr(
"Could not transform the extent into the project CRS" ),
true );
157 mMinZoom = parameterAsInt( parameters, u
"ZOOM_MIN"_s, context );
158 mMaxZoom = parameterAsInt( parameters, u
"ZOOM_MAX"_s, context );
159 mDpi = parameterAsInt( parameters, u
"DPI"_s, context );
160 mBackgroundColor = parameterAsColor( parameters, u
"BACKGROUND_COLOR"_s, context );
161 mAntialias = parameterAsBool( parameters, u
"ANTIALIAS"_s, context );
162 mTileFormat = parameterAsEnum( parameters, u
"TILE_FORMAT"_s, context ) ? u
"JPG"_s : u
"PNG"_s;
163 mJpgQuality = mTileFormat ==
"JPG"_L1 ? parameterAsInt( parameters, u
"QUALITY"_s, context ) : -1;
164 mMetaTileSize = parameterAsInt( parameters, u
"METATILESIZE"_s, context );
168 mFeedback = feedback;
176 mWgs84Extent = mSrc2Wgs.transformBoundingBox( mExtent );
180 feedback->
reportError( QObject::tr(
"Could not transform the extent into WGS84" ),
true );
184 if ( parameters.contains( u
"TILE_WIDTH"_s ) )
186 mTileWidth = parameterAsInt( parameters, u
"TILE_WIDTH"_s, context );
189 if ( parameters.contains( u
"TILE_HEIGHT"_s ) )
191 mTileHeight = parameterAsInt( parameters, u
"TILE_HEIGHT"_s, context );
194 if ( mTileFormat !=
"PNG"_L1 && mBackgroundColor.alpha() != 255 )
196 feedback->
pushWarning( QObject::tr(
"Background color setting ignored, the JPG format only supports fully opaque colors" ) );
208 for (
QgsMapLayer *layer : std::as_const( mLayers ) )
214 QObject::tr(
"Layer %1 will be skipped as the algorithm leads to bulk downloading behavior which is prohibited by the %2OpenStreetMap Foundation tile usage policy%3" )
215 .arg( layer->name(), u
"<a href=\"https://operations.osmfoundation.org/policies/tiles/\">"_s, u
"</a>"_s ),
216 QObject::tr(
"Layer %1 will be skipped as the algorithm leads to bulk downloading behavior which is prohibited by the %2OpenStreetMap Foundation tile usage policy%3" )
217 .arg( layer->name(), QString(), QString() )
219 mLayers.removeAll( layer );
226void QgsXyzTilesBaseAlgorithm::startJobs()
228 while ( mRendererJobs.size() < mThreadsNumber && !mMetaTiles.empty() )
230 MetaTile metaTile = mMetaTiles.takeFirst();
235 settings.
setExtent( mWgs2Mercator.transformBoundingBox( metaTile.extent() ) );
250 if ( mTileFormat ==
"PNG"_L1 || mBackgroundColor.alpha() == 255 )
254 QSize size( mTileWidth * metaTile.rows, mTileHeight * metaTile.cols );
266 mRendererJobs.insert( job, metaTile );
274QString QgsXyzTilesDirectoryAlgorithm::name()
const
276 return u
"tilesxyzdirectory"_s;
279QString QgsXyzTilesDirectoryAlgorithm::displayName()
const
281 return QObject::tr(
"Generate XYZ tiles (Directory)" );
284QStringList QgsXyzTilesDirectoryAlgorithm::tags()
const
286 return QObject::tr(
"tiles,xyz,tms,directory" ).split(
',' );
289QString QgsXyzTilesDirectoryAlgorithm::shortHelpString()
const
291 return QObject::tr(
"Generates XYZ tiles of map canvas content and saves them as individual images in a directory." );
294QgsXyzTilesDirectoryAlgorithm *QgsXyzTilesDirectoryAlgorithm::createInstance()
const
296 return new QgsXyzTilesDirectoryAlgorithm();
299void QgsXyzTilesDirectoryAlgorithm::initAlgorithm(
const QVariantMap & )
301 createCommonParameters();
306 auto titleParam = std::make_unique<QgsProcessingParameterString>( u
"HTML_TITLE"_s, QObject::tr(
"Leaflet HTML output title" ), QVariant(),
false,
true );
308 addParameter( titleParam.release() );
309 auto attributionParam = std::make_unique<QgsProcessingParameterString>( u
"HTML_ATTRIBUTION"_s, QObject::tr(
"Leaflet HTML output attribution" ), QVariant(),
false,
true );
311 addParameter( attributionParam.release() );
312 auto osmParam = std::make_unique<QgsProcessingParameterBoolean>( u
"HTML_OSM"_s, QObject::tr(
"Include OpenStreetMap basemap in Leaflet HTML output" ),
false );
314 addParameter( osmParam.release() );
322 const bool tms = parameterAsBoolean( parameters, u
"TMS_CONVENTION"_s, context );
323 const QString title = parameterAsString( parameters, u
"HTML_TITLE"_s, context );
324 const QString attribution = parameterAsString( parameters, u
"HTML_ATTRIBUTION"_s, context );
325 const bool useOsm = parameterAsBoolean( parameters, u
"HTML_OSM"_s, context );
326 QString outputDir = parameterAsString( parameters, u
"OUTPUT_DIRECTORY"_s, context );
327 const QString outputHtml = parameterAsString( parameters, u
"OUTPUT_HTML"_s, context );
329 mOutputDir = outputDir;
332 long long totalTiles = 0;
334 for (
int z = mMinZoom; z <= mMaxZoom; z++ )
339 long long tileCount = 0;
340 mMetaTiles += getMetatiles( mWgs84Extent, z, tileCount, mMetaTileSize );
341 feedback->
pushInfo( QObject::tr(
"%1 metatiles (%2 tiles) will be created for zoom level %3" ).arg( mMetaTiles.size() - mTotalMetaTiles ).arg( tileCount ).arg( z ) );
342 mTotalMetaTiles = mMetaTiles.size();
343 totalTiles += tileCount;
345 feedback->
pushInfo( QObject::tr(
"A total of %1 metatiles (%2 tiles) will be created" ).arg( mTotalMetaTiles ).arg( totalTiles ) );
347 checkLayersUsagePolicy( feedback );
349 for (
QgsMapLayer *layer : std::as_const( mLayers ) )
351 layer->moveToThread( QThread::currentThread() );
360 qDeleteAll( mLayers );
364 results.insert( u
"OUTPUT_DIRECTORY"_s, outputDir );
366 if ( !outputHtml.isEmpty() )
368 QString osm = QStringLiteral(
369 "var osm_layer = L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png',"
370 "{minZoom: %1, maxZoom: %2, attribution: '© <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a> contributors'}).addTo(map);"
375 QString addOsm = useOsm ? osm : QString();
376 QString tmsConvention = tms ? u
"true"_s : u
"false"_s;
377 QString attr = attribution.isEmpty() ? u
"Created by QGIS"_s : attribution;
378 QString tileSource = u
"'file:///%1/{z}/{x}/{y}.%2'"_s.arg( outputDir.replace(
"\\",
"/" ).toHtmlEscaped() ).arg( mTileFormat.toLower() );
380 QString html = QStringLiteral(
381 "<!DOCTYPE html><html><head><title>%1</title><meta charset=\"utf-8\"/>"
382 "<meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">"
383 "<link rel=\"stylesheet\" href=\"https://unpkg.com/[email protected]/dist/leaflet.css\""
384 "integrity=\"sha384-sHL9NAb7lN7rfvG5lfHpm643Xkcjzp4jFvuavGOndn6pjVqS6ny56CAt3nsEVT4H\""
387 "integrity=\"sha384-cxOPjt7s7Iz04uaHJceBmS+qpjv2JkIHNVcuOrM+YHwZOmJGBXI00mdUXEq65HTH\""
388 "crossorigin=\"\"></script>"
389 "<style type=\"text/css\">body {margin: 0;padding: 0;} html, body, #map{width: 100%;height: 100%;}</style></head>"
390 "<body><div id=\"map\"></div><script>"
391 "var map = L.map('map', {attributionControl: false}).setView([%2, %3], %4);"
392 "L.control.attribution({prefix: false}).addTo(map);"
394 "var tilesource_layer = L.tileLayer(%6, {minZoom: %7, maxZoom: %8, tms: %9, attribution: '%10'}).addTo(map);"
395 "</script></body></html>"
397 .arg( title.isEmpty() ? u
"Leaflet preview"_s : title )
398 .arg( mWgs84Extent.center().y() )
399 .arg( mWgs84Extent.center().x() )
400 .arg( ( mMaxZoom + mMinZoom ) / 2 )
405 .arg( tmsConvention )
408 QFile htmlFile( outputHtml );
409 if ( !htmlFile.open( QIODevice::WriteOnly | QIODevice::Truncate ) )
413 QTextStream fout( &htmlFile );
416 results.insert( u
"OUTPUT_HTML"_s, outputHtml );
424 MetaTile metaTile = mRendererJobs.value( job );
427 QMap<QPair<int, int>, Tile>::const_iterator it = metaTile.tiles.constBegin();
428 while ( it != metaTile.tiles.constEnd() )
430 QPair<int, int> tm = it.key();
431 Tile tile = it.value();
432 QImage tileImage = img.copy( mTileWidth * tm.first, mTileHeight * tm.second, mTileWidth, mTileHeight );
433 QDir tileDir( u
"%1/%2/%3"_s.arg( mOutputDir ).arg( tile.z ).arg( tile.x ) );
434 tileDir.mkpath( tileDir.absolutePath() );
438 y = tile2tms( y, tile.z );
440 tileImage.save( u
"%1/%2.%3"_s.arg( tileDir.absolutePath() ).arg( y ).arg( mTileFormat.toLower() ), mTileFormat.toStdString().c_str(), mJpgQuality );
444 mRendererJobs.remove( job );
447 mFeedback->setProgress( 100.0 * ( mProcessedMetaTiles++ ) / mTotalMetaTiles );
449 if ( mFeedback->isCanceled() )
451 while ( mRendererJobs.size() > 0 )
455 mRendererJobs.remove( j );
458 mRendererJobs.clear();
466 if ( mMetaTiles.size() > 0 )
470 else if ( mMetaTiles.size() == 0 && mRendererJobs.size() == 0 )
481QString QgsXyzTilesMbtilesAlgorithm::name()
const
483 return u
"tilesxyzmbtiles"_s;
486QString QgsXyzTilesMbtilesAlgorithm::displayName()
const
488 return QObject::tr(
"Generate XYZ tiles (MBTiles)" );
491QStringList QgsXyzTilesMbtilesAlgorithm::tags()
const
493 return QObject::tr(
"tiles,xyz,tms,mbtiles" ).split(
',' );
496QString QgsXyzTilesMbtilesAlgorithm::shortHelpString()
const
498 return QObject::tr(
"Generates XYZ tiles of map canvas content and saves them as an MBTiles file." );
501QgsXyzTilesMbtilesAlgorithm *QgsXyzTilesMbtilesAlgorithm::createInstance()
const
503 return new QgsXyzTilesMbtilesAlgorithm();
506void QgsXyzTilesMbtilesAlgorithm::initAlgorithm(
const QVariantMap & )
508 createCommonParameters();
514 const QString outputFile = parameterAsString( parameters, u
"OUTPUT_FILE"_s, context );
516 mMbtilesWriter = std::make_unique<QgsMbTiles>( outputFile );
517 if ( !mMbtilesWriter->create() )
521 mMbtilesWriter->setMetadataValue(
"format", mTileFormat.toLower() );
522 mMbtilesWriter->setMetadataValue(
"name", QFileInfo( outputFile ).baseName() );
523 mMbtilesWriter->setMetadataValue(
"description", QFileInfo( outputFile ).baseName() );
524 mMbtilesWriter->setMetadataValue(
"version", u
"1.1"_s );
525 mMbtilesWriter->setMetadataValue(
"type", u
"overlay"_s );
526 mMbtilesWriter->setMetadataValue(
"minzoom", QString::number( mMinZoom ) );
527 mMbtilesWriter->setMetadataValue(
"maxzoom", QString::number( mMaxZoom ) );
528 QString boundsStr = QString(
"%1,%2,%3,%4" ).arg( mWgs84Extent.xMinimum() ).arg( mWgs84Extent.yMinimum() ).arg( mWgs84Extent.xMaximum() ).arg( mWgs84Extent.yMaximum() );
529 mMbtilesWriter->setMetadataValue(
"bounds", boundsStr );
531 long long totalTiles = 0;
533 for (
int z = mMinZoom; z <= mMaxZoom; z++ )
538 long long tileCount = 0;
539 mMetaTiles += getMetatiles( mWgs84Extent, z, tileCount, mMetaTileSize );
540 feedback->
pushInfo( QObject::tr(
"%1 metatiles (%2 tiles) will be created for zoom level %3" ).arg( mMetaTiles.size() - mTotalMetaTiles ).arg( tileCount ).arg( z ) );
541 mTotalMetaTiles = mMetaTiles.size();
542 totalTiles += tileCount;
544 feedback->
pushInfo( QObject::tr(
"A total of %1 metatiles (%2 tiles) will be created" ).arg( mTotalMetaTiles ).arg( totalTiles ) );
546 checkLayersUsagePolicy( feedback );
548 for (
QgsMapLayer *layer : std::as_const( mLayers ) )
550 layer->moveToThread( QThread::currentThread() );
559 qDeleteAll( mLayers );
563 results.insert( u
"OUTPUT_FILE"_s, outputFile );
569 MetaTile metaTile = mRendererJobs.value( job );
572 QMap<QPair<int, int>, Tile>::const_iterator it = metaTile.tiles.constBegin();
573 while ( it != metaTile.tiles.constEnd() )
575 QPair<int, int> tm = it.key();
576 Tile tile = it.value();
577 QImage tileImage = img.copy( mTileWidth * tm.first, mTileHeight * tm.second, mTileWidth, mTileHeight );
579 QBuffer buffer( &ba );
580 buffer.open( QIODevice::WriteOnly );
581 tileImage.save( &buffer, mTileFormat.toStdString().c_str(), mJpgQuality );
582 mMbtilesWriter->setTileData( tile.z, tile.x, tile2tms( tile.y, tile.z ), ba );
586 mRendererJobs.remove( job );
589 mFeedback->setProgress( 100.0 * ( mProcessedMetaTiles++ ) / mTotalMetaTiles );
591 if ( mFeedback->isCanceled() )
593 while ( mRendererJobs.size() > 0 )
597 mRendererJobs.remove( j );
600 mRendererJobs.clear();
608 if ( mMetaTiles.size() > 0 )
612 else if ( mMetaTiles.size() == 0 && mRendererJobs.size() == 0 )
@ UsePartialCandidates
Whether to use also label candidates that are partially outside of the map view.
QFlags< ProcessingAlgorithmFlag > ProcessingAlgorithmFlags
Flags indicating how and when an algorithm operates and should be exposed to users.
@ Export
Renderer used for printing or exporting to a file.
@ RequiresProject
The algorithm requires that a valid QgsProject is available from the processing context in order to e...
@ Advanced
Parameter is an advanced parameter which should be hidden from users by default.
@ Antialiasing
Enable anti-aliasing for map rendering.
Represents a coordinate reference system (CRS).
Custom exception class for Coordinate Reference System related exceptions.
static QgsExpressionContextScope * mapSettingsScope(const QgsMapSettings &mapSettings)
Creates a new scope which contains variables and functions relating to a QgsMapSettings object.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
void appendScope(QgsExpressionContextScope *scope)
Appends a scope to the end of the context.
bool isCanceled() const
Tells whether the operation has been canceled already.
Stores global configuration for labeling engine.
void setFlag(Qgis::LabelingFlag f, bool enabled=true)
Sets whether a particual flag is enabled.
QList< QgsLayerTreeLayer * > findLayers() const
Find all layer nodes.
Layer tree node points to a map layer.
QList< QgsMapLayer * > layerOrder() const
The order in which layers will be rendered on the canvas.
static bool isOpenStreetMapLayer(QgsMapLayer *layer)
Returns true if the layer is served by OpenStreetMap server.
Base class for all map layer types.
virtual QgsMapLayer * clone() const =0
Returns a new instance equivalent to this one except for the id which is still unique.
void finished()
emitted when asynchronous rendering is finished (or canceled).
void start()
Start the rendering job and immediately return.
Job implementation that renders everything sequentially in one thread.
QImage renderedImage() override
Gets a preview/resulting image.
void cancel() override
Stop the rendering job - does not return until the job has terminated.
Contains configuration for rendering maps.
const QgsLabelingEngineSettings & labelingEngineSettings() const
Returns the global configuration of the labeling engine.
void setLayers(const QList< QgsMapLayer * > &layers)
Sets the list of layers to render in the map.
bool setEllipsoid(const QString &ellipsoid)
Sets the ellipsoid by its acronym.
void setScaleMethod(Qgis::ScaleCalculationMethod method)
Sets the method to use for scale calculations for the map.
void setOutputDpi(double dpi)
Sets the dpi (dots per inch) used for conversion between real world units (e.g.
void setOutputImageFormat(QImage::Format format)
sets format of internal QImage
void setRendererUsage(Qgis::RendererUsage rendererUsage)
Sets the rendering usage.
void setExtent(const QgsRectangle &rect, bool magnified=true)
Sets the coordinates of the rectangle which should be rendered.
void setExpressionContext(const QgsExpressionContext &context)
Sets the expression context.
void setLabelingEngineSettings(const QgsLabelingEngineSettings &settings)
Sets the global configuration of the labeling engine.
void setTransformContext(const QgsCoordinateTransformContext &context)
Sets the coordinate transform context, which stores various information regarding which datum transfo...
void setOutputSize(QSize size)
Sets the size of the resulting map image, in pixels.
void setBackgroundColor(const QColor &color)
Sets the background color of the map.
void setFlag(Qgis::MapSettingsFlag flag, bool on=true)
Enable or disable a particular flag (other flags are not affected).
void setDestinationCrs(const QgsCoordinateReferenceSystem &crs)
Sets the destination crs (coordinate reference system) for the map render.
const QgsExpressionContext & expressionContext() const
Gets the expression context.
virtual Qgis::ProcessingAlgorithmFlags flags() const
Returns the flags indicating how and when the algorithm operates and should be exposed to users.
Contains information about the context in which a processing algorithm is executed.
QgsCoordinateTransformContext transformContext() const
Returns the coordinate transform context.
QgsProject * project() const
Returns the project in which the algorithm is being executed.
QString ellipsoid() const
Returns the ellipsoid to use for distance and area calculations.
int maximumThreads() const
Returns the (optional) number of threads to use when running algorithms.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
virtual void pushInfo(const QString &info)
Pushes a general informational message from the algorithm.
virtual void pushWarning(const QString &warning)
Pushes a warning informational message from the algorithm.
virtual void pushFormattedMessage(const QString &html, const QString &text)
Pushes a pre-formatted message from the algorithm.
virtual void reportError(const QString &error, bool fatalError=false)
Reports that the algorithm encountered an error while executing.
A boolean parameter for processing algorithms.
A color parameter for processing algorithms.
An enum based parameter for processing algorithms, allowing for selection from predefined values.
A rectangular map extent parameter for processing algorithms.
A generic file based destination parameter, for specifying the destination path for a file (non-map l...
A folder destination parameter, for specifying the destination path for a folder created by the algor...
A numeric parameter for processing algorithms.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
QgsLayerTree * layerTreeRoot() const
Returns pointer to the root (invisible) node of the project's layer tree.
QgsCoordinateReferenceSystem crs
Qgis::ScaleCalculationMethod scaleMethod
A rectangle specified with double values.
#define MAXIMUM_OPENSTREETMAP_TILES_FETCH