qgsgdalutils.h

Go to the documentation of this file.

/***************************************************************************
                             qgsgdalutils.h
                             --------------
    begin                : September 2018
    copyright            : (C) 2018 Even Rouault
    email                : even.rouault at spatialys.com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSGDALUTILS_H
#define QGSGDALUTILS_H
 
 
#include <gdal.h>
 
#include "qgis_core.h"
#include "qgsfeedback.h"
#include "qgsogrutils.h"
 
class QgsRasterBlock;
 
#ifndef SIP_RUN
class CORE_EXPORT QgsGdalOption
{
  public:
    enum class Type
    {
      Invalid, 
      Select,  
      Boolean, 
      Text,    
      Int,     
      Double,  
    };

    QString name;

    Type type = Type::Invalid;

    QString description;

    QStringList options;

    QVariant defaultValue;

    QVariant minimum;

    QVariant maximum;

    QString scope;

    static QgsGdalOption fromXmlNode( const CPLXMLNode *node );

    static QList< QgsGdalOption > optionsFromXml( const CPLXMLNode *node );
};
#endif

class CORE_EXPORT QgsGdalUtils
{
  public:
    SIP_SKIP static bool supportsRasterCreate( GDALDriverH driver );

    SIP_SKIP static gdal::dataset_unique_ptr createSingleBandMemoryDataset( GDALDataType dataType, const QgsRectangle &extent, int width, int height, const QgsCoordinateReferenceSystem &crs );

    SIP_SKIP static gdal::dataset_unique_ptr createMultiBandMemoryDataset( GDALDataType dataType, int bands, const QgsRectangle &extent, int width, int height, const QgsCoordinateReferenceSystem &crs );

    SIP_SKIP static gdal::dataset_unique_ptr createSingleBandTiffDataset(
      const QString &filename, GDALDataType dataType, const QgsRectangle &extent, int width, int height, const QgsCoordinateReferenceSystem &crs
    );

    SIP_SKIP static bool resampleSingleBandRaster( GDALDatasetH hSrcDS, GDALDatasetH hDstDS, GDALResampleAlg resampleAlg, const char *pszCoordinateOperation );

    SIP_SKIP static bool resampleSingleBandRaster(
      GDALDatasetH hSrcDS, GDALDatasetH hDstDS, GDALResampleAlg resampleAlg, const QgsCoordinateReferenceSystem &sourceCrs, const QgsCoordinateReferenceSystem &destinationCrs
    );

    SIP_SKIP static QImage resampleImage( const QImage &image, QSize outputSize, GDALRIOResampleAlg resampleAlg );

    SIP_SKIP static QString helpCreationOptionsFormat( const QString &format );

    SIP_SKIP static QString validateCreationOptionsFormat( const QStringList &creationOptions, const QString &format );

    SIP_SKIP static char **papszFromStringList( const QStringList &list );

    SIP_SKIP static gdal::dataset_unique_ptr imageToMemoryDataset( const QImage &image );

    SIP_SKIP static gdal::dataset_unique_ptr blockToSingleBandMemoryDataset( int pixelWidth, int pixelHeight, const QgsRectangle &extent, void *block, GDALDataType dataType );

    SIP_SKIP static gdal::dataset_unique_ptr blockToSingleBandMemoryDataset( const QgsRectangle &extent, QgsRasterBlock *block );

    SIP_SKIP static gdal::dataset_unique_ptr blockToSingleBandMemoryDataset( double rotation, const QgsPointXY &origin, double gridXSize, double gridYSize, QgsRasterBlock *block );

    SIP_SKIP static GDALDatasetH rpcAwareAutoCreateWarpedVrt(
      GDALDatasetH hSrcDS, const char *pszSrcWKT, const char *pszDstWKT, GDALResampleAlg eResampleAlg, double dfMaxError, const GDALWarpOptions *psOptionsIn
    );

    SIP_SKIP static void *rpcAwareCreateTransformer( GDALDatasetH hSrcDS, GDALDatasetH hDstDS = nullptr, char **papszOptions = nullptr );

    SIP_SKIP static GDALDataType gdalDataTypeFromQgisDataType( Qgis::DataType dataType );

    SIP_SKIP static GDALResampleAlg gdalResamplingAlgorithm( Qgis::RasterResamplingMethod method );
 
#ifndef QT_NO_NETWORKPROXY
    SIP_SKIP static void setupProxy();
#endif

    SIP_SKIP static bool pathIsCheapToOpen( const QString &path, int smallFileSizeLimit = 50000 );

    SIP_SKIP static QStringList multiLayerFileExtensions();

    SIP_SKIP static QString vsiPrefixForPath( const QString &path );

    SIP_SKIP static QStringList vsiArchivePrefixes();
 
#ifndef SIP_RUN
    struct VsiNetworkFileSystemDetails
    {
        QString identifier;

        QString name;
    };
#endif

    SIP_SKIP static QList< VsiNetworkFileSystemDetails > vsiNetworkFileSystems();

    SIP_SKIP static bool isVsiArchivePrefix( const QString &prefix );

    SIP_SKIP static QStringList vsiArchiveFileExtensions();

    SIP_SKIP static bool isVsiArchiveFileExtension( const QString &extension );

    SIP_SKIP static Qgis::VsiHandlerType vsiHandlerType( const QString &prefix );

    SIP_SKIP static bool applyVsiCredentialOptions( const QString &prefix, const QString &path, const QVariantMap &options );

    SIP_SKIP static bool vrtMatchesLayerType( const QString &vrtPath, Qgis::LayerType type );

    SIP_SKIP static QString gdalDocumentationUrlForDriver( GDALDriverH hDriver );

    static bool supportsTiffLercCompression();

    static bool supportsMrfLercCompression();
 
  private:
    friend class TestQgsGdalUtils;
};
 
#ifndef SIP_RUN
class CORE_EXPORT QgsGdalProgressAdapter
{
  public:
    explicit QgsGdalProgressAdapter( QgsFeedback *feedback, double startPercentage = 0.0, double endPercentage = 100.0 );

    static int CPL_STDCALL progressCallback( double dfComplete, const char *pszMessage, void *pProgressArg );
 
  private:
    QgsFeedback *mFeedback = nullptr;
    double mStartPercentage;
    double mEndPercentage;
};
#endif
#endif // QGSGDALUTILS_H