Branch data Line data Source code
1 : : /***************************************************************************
2 : : qgsrasterdataprovider.h - DataProvider Interface for raster layers
3 : : --------------------------------------
4 : : Date : Mar 11, 2005
5 : : Copyright : (C) 2005 by Brendan Morley
6 : : email : morb at ozemail dot com dot au
7 : :
8 : : async legend fetcher : Sandro Santilli < strk at keybit dot net >
9 : :
10 : : ***************************************************************************/
11 : :
12 : : /***************************************************************************
13 : : * *
14 : : * This program is free software; you can redistribute it and/or modify *
15 : : * it under the terms of the GNU General Public License as published by *
16 : : * the Free Software Foundation; either version 2 of the License, or *
17 : : * (at your option) any later version. *
18 : : * *
19 : : ***************************************************************************/
20 : :
21 : : /* Thank you to Marco Hugentobler for the original vector DataProvider */
22 : :
23 : : #ifndef QGSRASTERDATAPROVIDER_H
24 : : #define QGSRASTERDATAPROVIDER_H
25 : :
26 : : #include "qgis_core.h"
27 : : #include "qgis_sip.h"
28 : : #include <cmath>
29 : :
30 : : #include <QDateTime>
31 : : #include <QVariant>
32 : : #include <QImage>
33 : :
34 : : #include "qgscolorrampshader.h"
35 : : #include "qgsdataprovider.h"
36 : : #include "qgsraster.h"
37 : : #include "qgsfields.h"
38 : : #include "qgsrasterinterface.h"
39 : : #include "qgsrasterpyramid.h"
40 : : #include "qgsrasterrange.h"
41 : : #include "qgsrectangle.h"
42 : : #include "qgsrasteriterator.h"
43 : : #include "qgsrasterdataprovidertemporalcapabilities.h"
44 : :
45 : : class QImage;
46 : : class QByteArray;
47 : :
48 : : class QgsPointXY;
49 : : class QgsRasterIdentifyResult;
50 : : class QgsMapSettings;
51 : :
52 : : /**
53 : : * \brief Handles asynchronous download of images
54 : : * \ingroup core
55 : : * \since QGIS 2.8
56 : : */
57 : : class CORE_EXPORT QgsImageFetcher : public QObject
58 : : {
59 : : Q_OBJECT
60 : : public:
61 : : //! Constructor
62 : : QgsImageFetcher( QObject *parent = nullptr ) : QObject( parent ) {}
63 : :
64 : : /**
65 : : * Starts the image download
66 : : * \note Make sure to connect to "finish" and "error" before starting
67 : : */
68 : : virtual void start() = 0;
69 : :
70 : : signals:
71 : :
72 : : /**
73 : : * Emitted when the download completes
74 : : * \param legend The downloaded legend image
75 : : */
76 : : void finish( const QImage &legend );
77 : : //! Emitted to report progress
78 : : void progress( qint64 received, qint64 total );
79 : : //! Emitted when an error occurs
80 : : void error( const QString &msg );
81 : : };
82 : :
83 : :
84 : : /**
85 : : * \ingroup core
86 : : * \brief Base class for raster data providers.
87 : : */
88 : 0 : class CORE_EXPORT QgsRasterDataProvider : public QgsDataProvider, public QgsRasterInterface
89 : : {
90 : 0 : Q_OBJECT
91 : :
92 : : public:
93 : :
94 : : /**
95 : : * Enumeration with capabilities that raster providers might implement.
96 : : * \since QGIS 3.0
97 : : */
98 : : enum ProviderCapability
99 : : {
100 : : NoProviderCapabilities = 0, //!< Provider has no capabilities
101 : : ReadLayerMetadata = 1 << 1, //!< Provider can read layer metadata from data store. Since QGIS 3.0. See QgsDataProvider::layerMetadata()
102 : : WriteLayerMetadata = 1 << 2, //!< Provider can write layer metadata to the data store. Since QGIS 3.0. See QgsDataProvider::writeLayerMetadata()
103 : : ProviderHintBenefitsFromResampling = 1 << 3, //!< Provider benefits from resampling and should apply user default resampling settings (since QGIS 3.10)
104 : : ProviderHintCanPerformProviderResampling = 1 << 4, //!< Provider can perform resampling (to be opposed to post rendering resampling) (since QGIS 3.16)
105 : : ReloadData = 1 << 5 //!< Is able to force reload data / clear local caches. Since QGIS 3.18, see QgsDataProvider::reloadProviderData()
106 : : };
107 : :
108 : : //! Provider capabilities
109 : : Q_DECLARE_FLAGS( ProviderCapabilities, ProviderCapability )
110 : :
111 : : QgsRasterDataProvider();
112 : :
113 : : /**
114 : : * Constructor for QgsRasterDataProvider.
115 : : *
116 : : * The \a uri argument gives a provider-specific uri indicating the underlying data
117 : : * source and it's parameters.
118 : : *
119 : : * The \a options argument specifies generic provider options and since QGIS 3.16 creation flags are specified within the \a flags value.
120 : : */
121 : : QgsRasterDataProvider( const QString &uri,
122 : : const QgsDataProvider::ProviderOptions &providerOptions = QgsDataProvider::ProviderOptions(),
123 : : QgsDataProvider::ReadFlags flags = QgsDataProvider::ReadFlags() );
124 : :
125 : : QgsRasterDataProvider *clone() const override = 0;
126 : :
127 : : /**
128 : : * Returns flags containing the supported capabilities of the data provider.
129 : : * \since QGIS 3.0
130 : : */
131 : : virtual QgsRasterDataProvider::ProviderCapabilities providerCapabilities() const;
132 : :
133 : : /* It makes no sense to set input on provider */
134 : : bool setInput( QgsRasterInterface *input ) override { Q_UNUSED( input ) return false; }
135 : :
136 : : QgsRectangle extent() const override = 0;
137 : :
138 : : //! Returns data type for the band specified by number
139 : : Qgis::DataType dataType( int bandNo ) const override = 0;
140 : :
141 : : /**
142 : : * Returns the fields of the raster layer for data providers that expose them,
143 : : * the default implementation returns an empty list.
144 : : * \since QGIS 3.14
145 : : */
146 : : virtual QgsFields fields() const { return QgsFields(); };
147 : :
148 : : /**
149 : : * Returns source data type for the band specified by number,
150 : : * source data type may be shorter than dataType
151 : : */
152 : : Qgis::DataType sourceDataType( int bandNo ) const override = 0;
153 : :
154 : : //! Returns data type for the band specified by number
155 : : virtual int colorInterpretation( int bandNo ) const;
156 : :
157 : 0 : QString colorName( int colorInterpretation ) const
158 : : {
159 : : // Modified copy from GDAL
160 : 0 : switch ( colorInterpretation )
161 : : {
162 : : case QgsRaster::UndefinedColorInterpretation:
163 : 0 : return QStringLiteral( "Undefined" );
164 : :
165 : : case QgsRaster::GrayIndex:
166 : 0 : return QStringLiteral( "Gray" );
167 : :
168 : : case QgsRaster::PaletteIndex:
169 : 0 : return QStringLiteral( "Palette" );
170 : :
171 : : case QgsRaster::RedBand:
172 : 0 : return QStringLiteral( "Red" );
173 : :
174 : : case QgsRaster::GreenBand:
175 : 0 : return QStringLiteral( "Green" );
176 : :
177 : : case QgsRaster::BlueBand:
178 : 0 : return QStringLiteral( "Blue" );
179 : :
180 : : case QgsRaster::AlphaBand:
181 : 0 : return QStringLiteral( "Alpha" );
182 : :
183 : : case QgsRaster::HueBand:
184 : 0 : return QStringLiteral( "Hue" );
185 : :
186 : : case QgsRaster::SaturationBand:
187 : 0 : return QStringLiteral( "Saturation" );
188 : :
189 : : case QgsRaster::LightnessBand:
190 : 0 : return QStringLiteral( "Lightness" );
191 : :
192 : : case QgsRaster::CyanBand:
193 : 0 : return QStringLiteral( "Cyan" );
194 : :
195 : : case QgsRaster::MagentaBand:
196 : 0 : return QStringLiteral( "Magenta" );
197 : :
198 : : case QgsRaster::YellowBand:
199 : 0 : return QStringLiteral( "Yellow" );
200 : :
201 : : case QgsRaster::BlackBand:
202 : 0 : return QStringLiteral( "Black" );
203 : :
204 : : case QgsRaster::YCbCr_YBand:
205 : 0 : return QStringLiteral( "YCbCr_Y" );
206 : :
207 : : case QgsRaster::YCbCr_CbBand:
208 : 0 : return QStringLiteral( "YCbCr_Cb" );
209 : :
210 : : case QgsRaster::YCbCr_CrBand:
211 : 0 : return QStringLiteral( "YCbCr_Cr" );
212 : :
213 : : default:
214 : 0 : return QStringLiteral( "Unknown" );
215 : : }
216 : 0 : }
217 : : //! Reload data (data could change)
218 : : virtual bool reload() { return true; }
219 : :
220 : : QString colorInterpretationName( int bandNo ) const override;
221 : :
222 : : /**
223 : : * Read band scale for raster value
224 : : * \since QGIS 2.3
225 : : */
226 : : virtual double bandScale( int bandNo ) const { Q_UNUSED( bandNo ) return 1.0; }
227 : :
228 : : /**
229 : : * Read band offset for raster value
230 : : * \since QGIS 2.3
231 : : */
232 : : virtual double bandOffset( int bandNo ) const { Q_UNUSED( bandNo ) return 0.0; }
233 : :
234 : : // TODO: remove or make protected all readBlock working with void*
235 : :
236 : : //! Read block of data using given extent and size.
237 : : QgsRasterBlock *block( int bandNo, const QgsRectangle &boundingBox, int width, int height, QgsRasterBlockFeedback *feedback = nullptr ) override SIP_FACTORY;
238 : :
239 : : //! Returns TRUE if source band has no data value
240 : 0 : virtual bool sourceHasNoDataValue( int bandNo ) const { return mSrcHasNoDataValue.value( bandNo - 1 ); }
241 : :
242 : : //! Returns the source nodata value usage
243 : 0 : virtual bool useSourceNoDataValue( int bandNo ) const { return mUseSrcNoDataValue.value( bandNo - 1 ); }
244 : :
245 : : //! Sets the source nodata value usage
246 : : virtual void setUseSourceNoDataValue( int bandNo, bool use );
247 : :
248 : : //! Value representing no data value.
249 : 0 : virtual double sourceNoDataValue( int bandNo ) const { return mSrcNoDataValue.value( bandNo - 1 ); }
250 : :
251 : : virtual void setUserNoDataValue( int bandNo, const QgsRasterRangeList &noData );
252 : :
253 : : //! Returns a list of user no data value ranges.
254 : 0 : virtual QgsRasterRangeList userNoDataValues( int bandNo ) const { return mUserNoDataValue.value( bandNo - 1 ); }
255 : :
256 : : virtual QList<QgsColorRampShader::ColorRampItem> colorTable( int bandNo ) const
257 : : { Q_UNUSED( bandNo ) return QList<QgsColorRampShader::ColorRampItem>(); }
258 : :
259 : : /**
260 : : * \brief Returns the sublayers of this layer - useful for providers that manage
261 : : * their own layers, such as WMS
262 : : */
263 : : QStringList subLayers() const override
264 : : {
265 : : return QStringList();
266 : : }
267 : :
268 : : QgsRasterDataProviderTemporalCapabilities *temporalCapabilities() override;
269 : : const QgsRasterDataProviderTemporalCapabilities *temporalCapabilities() const override SIP_SKIP;
270 : :
271 : : //! \brief Returns whether the provider supplies a legend graphic
272 : : virtual bool supportsLegendGraphic() const { return false; }
273 : :
274 : : /**
275 : : * Returns the legend rendered as pixmap
276 : : *
277 : : * This is useful for layers which need to get legend layers remotely as WMS.
278 : : *
279 : : * \param scale Optional parameter that is the Scale of the layer
280 : : * \param forceRefresh Optional bool parameter to force refresh getLegendGraphic call
281 : : * \param visibleExtent Visible extent for providers supporting contextual legends, in layer CRS
282 : : * \note Parameter visibleExtent added in QGIS 2.8
283 : : * \note Not available in Python bindings
284 : : */
285 : : virtual QImage getLegendGraphic( double scale = 0, bool forceRefresh = false, const QgsRectangle *visibleExtent = nullptr ) SIP_SKIP
286 : : {
287 : : Q_UNUSED( scale )
288 : : Q_UNUSED( forceRefresh )
289 : : Q_UNUSED( visibleExtent )
290 : : return QImage();
291 : : }
292 : :
293 : : /**
294 : : * Returns a new image downloader for the raster legend.
295 : : *
296 : : * \param mapSettings map settings for legend providers supporting
297 : : * contextual legends.
298 : : *
299 : : * \returns a download handler or NULLPTR if the provider does not support
300 : : * legend at all. Ownership of the returned object is transferred
301 : : * to caller.
302 : : *
303 : : *
304 : : * \since QGIS 2.8
305 : : */
306 : : virtual QgsImageFetcher *getLegendGraphicFetcher( const QgsMapSettings *mapSettings ) SIP_FACTORY
307 : : {
308 : : Q_UNUSED( mapSettings )
309 : : return nullptr;
310 : : }
311 : :
312 : : //! \brief Create pyramid overviews
313 : : virtual QString buildPyramids( const QList<QgsRasterPyramid> &pyramidList,
314 : : const QString &resamplingMethod = "NEAREST",
315 : : QgsRaster::RasterPyramidsFormat format = QgsRaster::PyramidsGTiff,
316 : : const QStringList &configOptions = QStringList(),
317 : : QgsRasterBlockFeedback *feedback = nullptr )
318 : : {
319 : : Q_UNUSED( pyramidList )
320 : : Q_UNUSED( resamplingMethod )
321 : : Q_UNUSED( format )
322 : : Q_UNUSED( configOptions )
323 : : Q_UNUSED( feedback )
324 : : return QStringLiteral( "FAILED_NOT_SUPPORTED" );
325 : : }
326 : :
327 : : /**
328 : : * Returns the raster layers pyramid list.
329 : : * \param overviewList used to construct the pyramid list (optional), when empty the list is defined by the provider.
330 : : * A pyramid list defines the
331 : : * POTENTIAL pyramids that can be in a raster. To know which of the pyramid layers
332 : : * ACTUALLY exists you need to look at the existsFlag member in each struct stored in the
333 : : * list.
334 : : */
335 : : virtual QList<QgsRasterPyramid> buildPyramidList( QList<int> overviewList = QList<int>() ) // clazy:exclude=function-args-by-ref
336 : : { Q_UNUSED( overviewList ) return QList<QgsRasterPyramid>(); }
337 : :
338 : : //! \brief Returns TRUE if raster has at least one populated histogram.
339 : : bool hasPyramids();
340 : :
341 : : /**
342 : : * Returns metadata in a format suitable for feeding directly
343 : : * into a subset of the GUI raster properties "Metadata" tab.
344 : : */
345 : : virtual QString htmlMetadata() = 0;
346 : :
347 : : /**
348 : : * Identify raster value(s) found on the point position. The context
349 : : * parameters extent, width and height are important to identify
350 : : * on the same zoom level as a displayed map and to do effective
351 : : * caching (WCS). If context params are not specified the highest
352 : : * resolution is used. capabilities() may be used to test if format
353 : : * is supported by provider. Values are set to 'no data' or empty string
354 : : * if point is outside data source extent.
355 : : *
356 : : * \param point coordinates in data source CRS
357 : : * \param format result format
358 : : * \param boundingBox context bounding box
359 : : * \param width context width
360 : : * \param height context height
361 : : * \param dpi context dpi
362 : : * \return QgsRaster::IdentifyFormatValue: map of values for each band, keys are band numbers
363 : : * (from 1).
364 : : * QgsRaster::IdentifyFormatFeature: map of QgsRasterFeatureList for each sublayer
365 : : * QgsRaster::IdentifyFormatHtml: map of HTML strings for each sublayer (WMS).
366 : : * Empty if failed or there are no results.
367 : : * \note The arbitraryness of the returned document is enforced by WMS standards
368 : : * up to at least v1.3.0
369 : : * \see sample(), which is much more efficient for simple "value at point" queries.
370 : : */
371 : : virtual QgsRasterIdentifyResult identify( const QgsPointXY &point, QgsRaster::IdentifyFormat format, const QgsRectangle &boundingBox = QgsRectangle(), int width = 0, int height = 0, int dpi = 96 );
372 : :
373 : : /**
374 : : * Samples a raster value from the specified \a band found at the \a point position. The context
375 : : * parameters \a boundingBox, \a width and \a height are important to identify
376 : : * on the same zoom level as a displayed map and to do effective
377 : : * caching (WCS). If context params are not specified the highest
378 : : * resolution is used.
379 : : *
380 : : * If \a ok is specified and the point is outside data source extent, or an invalid
381 : : * band number was specified, then \a ok will be set to FALSE. In this case the function will return
382 : : * a NaN value.
383 : : *
384 : : * \see identify(), which is much more flexible but considerably less efficient.
385 : : * \since QGIS 3.4
386 : : */
387 : : virtual double sample( const QgsPointXY &point, int band,
388 : : bool *ok SIP_OUT = nullptr,
389 : : const QgsRectangle &boundingBox = QgsRectangle(), int width = 0, int height = 0, int dpi = 96 );
390 : :
391 : : /**
392 : : * \brief Returns the caption error text for the last error in this provider
393 : : *
394 : : * If an operation returns 0 (e.g. draw()), this function
395 : : * returns the text of the error associated with the failure.
396 : : * Interactive users of this provider can then, for example,
397 : : * call a QMessageBox to display the contents.
398 : : */
399 : : virtual QString lastErrorTitle() = 0;
400 : :
401 : : /**
402 : : * \brief Returns the verbose error text for the last error in this provider
403 : : *
404 : : * If an operation returns 0 (e.g. draw()), this function
405 : : * returns the text of the error associated with the failure.
406 : : * Interactive users of this provider can then, for example,
407 : : * call a QMessageBox to display the contents.
408 : : *
409 : : */
410 : : virtual QString lastError() = 0;
411 : :
412 : : //! Returns the format of the error text for the last error in this provider
413 : : virtual QString lastErrorFormat();
414 : :
415 : : //! Returns the dpi of the output device.
416 : : int dpi() const { return mDpi; }
417 : :
418 : : //! Sets the output device resolution.
419 : 0 : void setDpi( int dpi ) { mDpi = dpi; }
420 : :
421 : : //! Time stamp of data source in the moment when data/metadata were loaded by provider
422 : : QDateTime timestamp() const override { return mTimestamp; }
423 : :
424 : : //! Current time stamp of data source
425 : : QDateTime dataTimestamp() const override { return QDateTime(); }
426 : :
427 : : /**
428 : : * Checks whether the provider is in editing mode, i.e. raster write operations will be accepted.
429 : : * By default providers are not editable. Use setEditable() method to enable/disable editing.
430 : : * \see setEditable(), writeBlock()
431 : : * \since QGIS 3.0
432 : : */
433 : : virtual bool isEditable() const { return false; }
434 : :
435 : : /**
436 : : * Turns on/off editing mode of the provider. When in editing mode, it is possible
437 : : * to overwrite data of the provider using writeBlock() calls.
438 : : * \returns TRUE if the switch to/from editing mode was successful
439 : : * \note Only some providers support editing mode and even those may fail to turn
440 : : * the underlying data source into editing mode, so it is necessary to check the return
441 : : * value whether the operation was successful.
442 : : * \see isEditable(), writeBlock()
443 : : * \since QGIS 3.0
444 : : */
445 : : virtual bool setEditable( bool enabled ) { Q_UNUSED( enabled ) return false; }
446 : :
447 : : // TODO: add data type (may be different from band type)
448 : :
449 : : //! Writes into the provider datasource
450 : : virtual bool write( void *data, int band, int width, int height, int xOffset, int yOffset )
451 : : {
452 : : Q_UNUSED( data )
453 : : Q_UNUSED( band )
454 : : Q_UNUSED( width )
455 : : Q_UNUSED( height )
456 : : Q_UNUSED( xOffset )
457 : : Q_UNUSED( yOffset )
458 : : return false;
459 : : }
460 : :
461 : : /**
462 : : * Writes pixel data from a raster block into the provider data source.
463 : : *
464 : : * This will override previously stored pixel values. It is assumed that cells in the passed
465 : : * raster block are aligned with the cells of the data source. If raster block does not cover
466 : : * the whole area of the data source, only a subset of pixels covered by the raster block
467 : : * will be overwritten. By default, writing of raster data starts from the first cell
468 : : * of the raster - it is possible to set offset in pixels by specifying non-zero
469 : : * xOffset and yOffset values.
470 : : *
471 : : * Writing is supported only by some data providers. Provider has to be in editing mode
472 : : * in order to allow write operations.
473 : : * \see isEditable(), setEditable()
474 : : * \returns TRUE on success
475 : : * \since QGIS 3.0
476 : : */
477 : : bool writeBlock( QgsRasterBlock *block, int band, int xOffset = 0, int yOffset = 0 );
478 : :
479 : : //! Creates a new dataset with mDataSourceURI
480 : : static QgsRasterDataProvider *create( const QString &providerKey,
481 : : const QString &uri,
482 : : const QString &format, int nBands,
483 : : Qgis::DataType type,
484 : : int width, int height, double *geoTransform,
485 : : const QgsCoordinateReferenceSystem &crs,
486 : : const QStringList &createOptions = QStringList() );
487 : :
488 : : /**
489 : : * Set no data value on created dataset
490 : : * \param bandNo band number
491 : : * \param noDataValue no data value
492 : : */
493 : : virtual bool setNoDataValue( int bandNo, double noDataValue ) { Q_UNUSED( bandNo ) Q_UNUSED( noDataValue ); return false; }
494 : :
495 : : //! Remove dataset
496 : : virtual bool remove() { return false; }
497 : :
498 : : /**
499 : : * Returns a list of pyramid resampling method name and label pairs
500 : : * for given provider
501 : : */
502 : : static QList<QPair<QString, QString> > pyramidResamplingMethods( const QString &providerKey );
503 : :
504 : : /**
505 : : * Validates creation options for a specific dataset and destination format.
506 : : * \note used by GDAL provider only
507 : : * \note see also validateCreationOptionsFormat() in gdal provider for validating options based on format only
508 : : */
509 : : virtual QString validateCreationOptions( const QStringList &createOptions, const QString &format )
510 : : { Q_UNUSED( createOptions ) Q_UNUSED( format ); return QString(); }
511 : :
512 : : /**
513 : : * Validates pyramid creation options for a specific dataset and destination format
514 : : * \note used by GDAL provider only
515 : : */
516 : : virtual QString validatePyramidsConfigOptions( QgsRaster::RasterPyramidsFormat pyramidsFormat,
517 : : const QStringList &configOptions, const QString &fileFormat )
518 : : { Q_UNUSED( pyramidsFormat ) Q_UNUSED( configOptions ); Q_UNUSED( fileFormat ); return QString(); }
519 : :
520 : : static QString identifyFormatName( QgsRaster::IdentifyFormat format );
521 : : static QgsRaster::IdentifyFormat identifyFormatFromName( const QString &formatName );
522 : : static QString identifyFormatLabel( QgsRaster::IdentifyFormat format );
523 : : static Capability identifyFormatToCapability( QgsRaster::IdentifyFormat format );
524 : :
525 : : /**
526 : : * Step width for raster iterations.
527 : : * \see stepHeight()
528 : : * \since QGIS 3.0
529 : : */
530 : : virtual int stepWidth() const { return QgsRasterIterator::DEFAULT_MAXIMUM_TILE_WIDTH; }
531 : :
532 : : /**
533 : : * Step height for raster iterations.
534 : : * \see stepWidth()
535 : : * \since QGIS 3.0
536 : : */
537 : : virtual int stepHeight() const { return QgsRasterIterator::DEFAULT_MAXIMUM_TILE_HEIGHT; }
538 : :
539 : : /**
540 : : * Returns a list of native resolutions if available, i.e. map units per pixel at which the raster source
541 : : * was originally created.
542 : : *
543 : : * Resolutions are calculated in the provider's crs().
544 : : *
545 : : * \since QGIS 3.8.0
546 : : */
547 : : virtual QList< double > nativeResolutions() const;
548 : :
549 : : /**
550 : : * Returns TRUE if the extents reported by the data provider are not reliable
551 : : * and it's possible that there is renderable content outside of these extents.
552 : : *
553 : : * \since QGIS 3.10.0
554 : : */
555 : : virtual bool ignoreExtents() const;
556 : :
557 : : /**
558 : : * Types of transformation in transformCoordinates() function.
559 : : * \since QGIS 3.14
560 : : */
561 : : enum TransformType
562 : : {
563 : : TransformImageToLayer, //!< Transforms image coordinates to layer (georeferenced) coordinates
564 : : TransformLayerToImage, //!< Transforms layer (georeferenced) coordinates to image coordinates
565 : : };
566 : :
567 : : /**
568 : : * Transforms coordinates between source image coordinate space [0..width]x[0..height] and
569 : : * layer coordinate space (georeferenced coordinates). Often this transformation is a simple
570 : : * 2D affine transformation (offset and scaling), but rasters with different georeferencing
571 : : * methods like GCPs (ground control points) or RPCs (rational polynomial coefficients) may
572 : : * require a more complex transform.
573 : : *
574 : : * If the transform fails (input coordinates are outside of the valid range or data provider
575 : : * does not support this functionality), an empty point is returned.
576 : : *
577 : : * \since QGIS 3.14
578 : : */
579 : : virtual QgsPoint transformCoordinates( const QgsPoint &point, TransformType type );
580 : :
581 : :
582 : : /**
583 : : * Enable or disable provider-level resampling.
584 : : *
585 : : * \return TRUE if success
586 : : * \since QGIS 3.16
587 : : */
588 : : virtual bool enableProviderResampling( bool enable ) { Q_UNUSED( enable ); return false; }
589 : :
590 : : /**
591 : : * Returns whether provider-level resampling is enabled.
592 : : *
593 : : * \note Resampling is effective only if zoomedInResamplingMethod() and/or
594 : : * zoomedOutResamplingMethod() return non-nearest resampling.
595 : : *
596 : : * \see zoomedInResamplingMethod()
597 : : * \see zoomedOutResamplingMethod()
598 : : * \see maxOversampling()
599 : : *
600 : : * \since QGIS 3.16
601 : : */
602 : : bool isProviderResamplingEnabled() const { return mProviderResamplingEnabled; }
603 : :
604 : : /**
605 : : * Resampling method for provider-level resampling.
606 : : * \since QGIS 3.16
607 : : */
608 : : enum class ResamplingMethod
609 : : {
610 : : Nearest, //!< Nearest-neighbour resampling
611 : : Bilinear, //!< Bilinear (2x2 kernel) resampling
612 : : Cubic,//!< Cubic Convolution Approximation (4x4 kernel) resampling
613 : : CubicSpline, //!< Cubic B-Spline Approximation (4x4 kernel)
614 : : Lanczos, //!< Lanczos windowed sinc interpolation (6x6 kernel)
615 : : Average, //!< Average resampling
616 : : Mode, //!< Mode (selects the value which appears most often of all the sampled points)
617 : : Gauss //!< Gauss blurring
618 : : };
619 : :
620 : : /**
621 : : * Set resampling method to apply for zoomed-in operations.
622 : : *
623 : : * \return TRUE if success
624 : : * \since QGIS 3.16
625 : : */
626 : : virtual bool setZoomedInResamplingMethod( ResamplingMethod method ) { Q_UNUSED( method ); return false; }
627 : :
628 : : /**
629 : : * Returns resampling method for zoomed-in operations.
630 : : * \since QGIS 3.16
631 : : */
632 : : ResamplingMethod zoomedInResamplingMethod() const { return mZoomedInResamplingMethod; }
633 : :
634 : : /**
635 : : * Set resampling method to apply for zoomed-out operations.
636 : : *
637 : : * \return TRUE if success
638 : : * \since QGIS 3.16
639 : : */
640 : : virtual bool setZoomedOutResamplingMethod( ResamplingMethod method ) { Q_UNUSED( method ); return false; }
641 : :
642 : : /**
643 : : * Returns resampling method for zoomed-out operations.
644 : : * \since QGIS 3.16
645 : : */
646 : : ResamplingMethod zoomedOutResamplingMethod() const { return mZoomedOutResamplingMethod; }
647 : :
648 : : /**
649 : : * Sets maximum oversampling factor for zoomed-out operations.
650 : : *
651 : : * \return TRUE if success
652 : : * \since QGIS 3.16
653 : : */
654 : : virtual bool setMaxOversampling( double factor ) { Q_UNUSED( factor ); return false; }
655 : :
656 : : /**
657 : : * Returns maximum oversampling factor for zoomed-out operations.
658 : : * \since QGIS 3.16
659 : : */
660 : : double maxOversampling() const { return mMaxOversampling; }
661 : :
662 : : void readXml( const QDomElement &filterElem ) override;
663 : :
664 : : void writeXml( QDomDocument &doc, QDomElement &parentElem ) const override;
665 : :
666 : : signals:
667 : :
668 : : /**
669 : : * Emit a message to be displayed on status bar, usually used by network providers (WMS,WCS)
670 : : * \since QGIS 2.14
671 : : */
672 : : void statusChanged( const QString & ) const;
673 : :
674 : : protected:
675 : :
676 : : /**
677 : : * Reads a block of raster data into \a data.
678 : : * \returns TRUE if the block was successfully read, or FALSE if an error occurred and the block could not be read.
679 : : * \note not available in Python bindings
680 : : */
681 : : virtual bool readBlock( int bandNo, int xBlock, int yBlock, void *data ) SIP_SKIP
682 : : { Q_UNUSED( bandNo ) Q_UNUSED( xBlock ); Q_UNUSED( yBlock ); Q_UNUSED( data ); return false; }
683 : :
684 : : /**
685 : : * Reads a block of raster data into \a data, using the given extent and size.
686 : : * \returns TRUE if the block was successfully read, or FALSE if an error occurred and the block could not be read.
687 : : * \note not available in Python bindings
688 : : */
689 : : virtual bool readBlock( int bandNo, QgsRectangle const &viewExtent, int width, int height, void *data, QgsRasterBlockFeedback *feedback = nullptr ) SIP_SKIP
690 : : { Q_UNUSED( bandNo ) Q_UNUSED( viewExtent ); Q_UNUSED( width ); Q_UNUSED( height ); Q_UNUSED( data ); Q_UNUSED( feedback ); return false; }
691 : :
692 : : //! Returns TRUE if user no data contains value
693 : : bool userNoDataValuesContains( int bandNo, double value ) const;
694 : :
695 : : //! Copy member variables from other raster data provider. Useful for implementation of clone() method in subclasses
696 : : void copyBaseSettings( const QgsRasterDataProvider &other );
697 : :
698 : : /**
699 : : * Dots per inch. Extended WMS (e.g. QGIS mapserver) support DPI dependent output and therefore
700 : : are suited for printing. A value of -1 means it has not been set
701 : : */
702 : : int mDpi = -1;
703 : :
704 : : /**
705 : : * Source no data value is available and is set to be used or internal no data
706 : : * is available. Used internally only
707 : : */
708 : : //bool hasNoDataValue ( int bandNo );
709 : :
710 : : //! \brief Cell value representing original source no data. e.g. -9999, indexed from 0
711 : : QList<double> mSrcNoDataValue;
712 : :
713 : : //! \brief Source no data value exists.
714 : : QList<bool> mSrcHasNoDataValue;
715 : :
716 : : /**
717 : : * \brief Use source nodata value. User can disable usage of source nodata
718 : : * value as nodata. It may happen that a value is wrongly given by GDAL
719 : : * as nodata (e.g. 0) and it has to be treated as regular value.
720 : : */
721 : : QList<bool> mUseSrcNoDataValue;
722 : :
723 : : /**
724 : : * \brief List of lists of user defined additional no data values
725 : : * for each band, indexed from 0
726 : : */
727 : : QList< QgsRasterRangeList > mUserNoDataValue;
728 : :
729 : : mutable QgsRectangle mExtent;
730 : :
731 : : //! Whether provider resampling is enabled.
732 : : bool mProviderResamplingEnabled = false;
733 : :
734 : : //! Resampling method for zoomed in pixel extraction
735 : : ResamplingMethod mZoomedInResamplingMethod = ResamplingMethod::Nearest;
736 : :
737 : : //! Resampling method for zoomed out pixel extraction
738 : : ResamplingMethod mZoomedOutResamplingMethod = ResamplingMethod::Nearest;
739 : :
740 : : //! Maximum boundary for oversampling (to avoid too much data traffic). Default: 2.0
741 : : double mMaxOversampling = 2.0;
742 : :
743 : : private:
744 : :
745 : : /**
746 : : * Data provider temporal properties
747 : : */
748 : : std::unique_ptr< QgsRasterDataProviderTemporalCapabilities > mTemporalCapabilities;
749 : :
750 : : };
751 : :
752 : 0 : Q_DECLARE_OPERATORS_FOR_FLAGS( QgsRasterDataProvider::ProviderCapabilities )
753 : :
754 : : // clazy:excludeall=qstring-allocations
755 : :
756 : : #endif
|
