qgspointclouddataprovider.h

Go to the documentation of this file.

/***************************************************************************
                         qgspointclouddataprovider.h
                         ---------------------
    begin                : October 2020
    copyright            : (C) 2020 by Peter Petrik
    email                : zilolv at gmail dot 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 QGSPOINTCLOUDDATAPROVIDER_H
#define QGSPOINTCLOUDDATAPROVIDER_H
 
#include "qgis_core.h"
#include "qgsdataprovider.h"
#include "qgspointcloudattribute.h"
#include "qgspointcloudindex.h"
#include "qgspointcloudsubindex.h"
 
class QgsPointCloudRenderer;
class QgsGeometry;
class QgsPointCloudStatistics;

class CORE_EXPORT QgsPointCloudDataProvider: public QgsDataProvider
{
    Q_OBJECT
  public:

    enum Capability SIP_ENUM_BASETYPE( IntFlag )
    {
      NoCapabilities = 0,       
      ReadLayerMetadata = 1 << 0, 
      WriteLayerMetadata = 1 << 1, 
      CreateRenderer = 1 << 2, 
      ContainSubIndexes = 1 << 3, 
      ChangeAttributeValues = 1 << 4, 
    };
 
    Q_DECLARE_FLAGS( Capabilities, Capability )
 
    
    enum PointCloudIndexGenerationState SIP_ENUM_BASETYPE( IntFlag )
    {
      NotIndexed = 0, 
      Indexing = 1 << 0, 
      Indexed = 1 << 1 
    };

    QgsPointCloudDataProvider( const QString &uri,
                               const QgsDataProvider::ProviderOptions &providerOptions,
                               Qgis::DataProviderReadFlags flags = Qgis::DataProviderReadFlags() );
 
    ~QgsPointCloudDataProvider() override;
 
#ifndef SIP_RUN

    QVector<QVariantMap> identify( double maxError, const QgsGeometry &extentGeometry, const QgsDoubleRange &extentZRange = QgsDoubleRange(), int pointsLimit = 1000 );
#else

    SIP_PYLIST identify( float maxErrorInMapCoords, QgsGeometry extentGeometry, const QgsDoubleRange extentZRange = QgsDoubleRange(), int pointsLimit = 1000 );
    % MethodCode
    {
      QVector<QMap<QString, QVariant>> res = sipCpp->identify( a0, *a1, *a2, a3 );
      sipRes = PyList_New( res.size() );
      for ( int i = 0; i < res.size(); ++i )
      {
        PyObject *dict = PyDict_New();
        for ( QString key : res[i].keys() )
        {
          PyObject *keyObj = sipConvertFromNewType( new QString( key ), sipType_QString, Py_None );
          PyObject *valObj = sipConvertFromNewType( new QVariant( res[i][key] ), sipType_QVariant, Py_None );
          PyDict_SetItem( dict, keyObj, valObj );
        }
        PyList_SET_ITEM( sipRes, i, dict );
      }
    }
    % End
#endif

    virtual QgsPointCloudDataProvider::Capabilities capabilities() const;

    virtual QgsPointCloudAttributeCollection attributes() const = 0;

    virtual void loadIndex( ) = 0;

    virtual void generateIndex( ) = 0;
 

    virtual PointCloudIndexGenerationState indexingState( ) = 0;

    virtual QgsPointCloudIndex index() const { return QgsPointCloudIndex( nullptr ); }

    virtual QVector<QgsPointCloudSubIndex> subIndexes() SIP_SKIP { return QVector<QgsPointCloudSubIndex>(); }

    virtual void loadSubIndex( int n ) SIP_SKIP { Q_UNUSED( n ) return; }

    bool hasValidIndex() const;

    virtual qint64 pointCount() const = 0;

    virtual QgsGeometry polygonBounds() const;

    virtual QVariantMap originalMetadata() const;

    virtual QgsPointCloudRenderer *createRenderer( const QVariantMap &configuration = QVariantMap() ) const SIP_FACTORY;

    QgsPointCloudStatistics metadataStatistics();
 
    bool supportsSubsetString() const override;
    QString subsetStringDialect() const override;
    QString subsetStringHelpUrl() const override;
    QString subsetString() const override;
    bool setSubsetString( const QString &subset, bool updateFeatureCount = false ) override;

    static QMap< int, QString > lasClassificationCodes();

    static QMap< int, QString > translatedLasClassificationCodes();

    static QMap< int, QString > dataFormatIds();

    static QMap< int, QString > translatedDataFormatIds();
 
  signals:

    void indexGenerationStateChanged( QgsPointCloudDataProvider::PointCloudIndexGenerationState state );
 
  protected:
    QString mSubsetString;

    QVector<QVariantMap> identify( QgsPointCloudIndex &index, double maxError, const QgsGeometry &extentGeometry, const QgsDoubleRange &extentZRange, int pointsLimit ) SIP_SKIP ;
 
  private:
    QVector<QgsPointCloudNodeId> traverseTree( const QgsPointCloudIndex &pc, QgsPointCloudNode node, double maxError, double nodeError, const QgsGeometry &extentGeometry, const QgsDoubleRange &extentZRange );
 
};
 
#endif // QGSMESHDATAPROVIDER_H