qgsterraingenerator.h

Go to the documentation of this file.

/***************************************************************************
  qgsterraingenerator.h
  --------------------------------------
  Date                 : July 2017
  Copyright            : (C) 2017 by Martin Dobias
  Email                : wonder dot sk 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 QGSTERRAINGENERATOR_H
#define QGSTERRAINGENERATOR_H
 
#include "qgis_3d.h"
#include "qgschunkloader.h"
#include "qgsmaterial3dhandler.h"
#include "qgsphongmaterialsettings.h"
#include "qgstilingscheme.h"
 
#include <QTexture>
 
#define SIP_NO_FILE
 
class Qgs3DMapSettings;
class Qgs3DRenderContext;
class QgsAABB;
class QgsCoordinateTransformContext;
class QgsRectangle;
class QgsTerrainEntity;
class QgsTerrainTextureGenerator;
class QgsTerrainTileEntity;
 
class QDomElement;
class QDomDocument;
class QgsProject;
 

class _3D_EXPORT QgsTerrainGenerator : public QgsQuadtreeChunkLoader
{
    Q_OBJECT
  public:
    enum Type
    {
      Flat,          
      Dem,           
      Online,        
      Mesh,          
      QuantizedMesh, 
    };

    enum class Capability : int
    {
      NoCapabilities = 1 << 0,         
      SupportsTileResolution = 1 << 1, 
    };
 
    Q_ENUM( Capability )
    Q_DECLARE_FLAGS( Capabilities, Capability )
    Q_FLAG( Capabilities )

    QgsTerrainGenerator();
    ~QgsTerrainGenerator() override;

    virtual QgsTerrainGenerator::Capabilities capabilities() const;

    virtual void setTerrain( QgsTerrainEntity *t ) { mTerrain = t; }

    virtual QgsTerrainGenerator *clone() const = 0 SIP_FACTORY;

    virtual Type type() const = 0;

    virtual void setExtent( const QgsRectangle &extent ) { Q_UNUSED( extent ) }

    virtual QgsRectangle rootChunkExtent() const = 0;

    virtual QgsBox3D rootChunkBox3D( const Qgs3DMapSettings &map ) const;

    virtual float rootChunkError( const Qgs3DMapSettings &map ) const;

    virtual void rootChunkHeightRange( float &hMin, float &hMax ) const;

    virtual float heightAt( double x, double y, const Qgs3DRenderContext &context ) const = 0;

    static QString typeToString( Type type );

    const QgsTilingScheme &tilingScheme() const { return mTerrainTilingScheme; }

    virtual void setCrs( const QgsCoordinateReferenceSystem &crs, const QgsCoordinateTransformContext &context );

    virtual QgsCoordinateReferenceSystem crs() const { return mTerrainTilingScheme.crs(); }

    bool isValid() const;
 
    QFuture<QgsChunkLoaderResult> updateChunk( QgsChunkNode *node ) override;
 
  signals:

    void terrainChanged();
 
  protected:
    struct TerrainTextureResources
    {
        QImage image;
        QgsRectangle extentTerrainCrs;
        QgsRectangle extentMapCrs;
        QString tileDebugText;
    };

    QFuture<TerrainTextureResources> loadTextureResources( QgsChunkNode *node );
    Qt3DRender::QTexture2D *applyTexture( QgsTerrainTileEntity *entity, const QgsMaterialContext &context, const TerrainTextureResources &resources ) const;
    void applyMaterial(
      const TerrainTextureResources &resources, QgsTerrainTileEntity *entity, bool isShadingEnabled, const QgsPhongMaterialSettings &shadingMaterial, bool useTexture, const Qgs3DRenderContext &context
    );
 
    QgsTilingScheme mTerrainTilingScheme; 
    QgsTerrainEntity *mTerrain = nullptr;
    QgsRectangle mExtent;
 
    bool mIsValid = true;
};
 
 
#endif // QGSTERRAINGENERATOR_H