qgsframegraph.h

Go to the documentation of this file.

/***************************************************************************
  qgsframegraph.h
  --------------------------------------
  Date                 : August 2020
  Copyright            : (C) 2020 by Belgacem Nedjima
  Email                : gb underscore nedjima at esi dot dz
 ***************************************************************************
 *                                                                         *
 *   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 QGSFRAMEGRAPH_H
#define QGSFRAMEGRAPH_H
 
#include <QWindow>
#include <Qt3DRender/QCamera>
#include <Qt3DRender/QRenderSurfaceSelector>
#include <Qt3DRender/QViewport>
#include <Qt3DRender/QCameraSelector>
#include <Qt3DRender/QLayerFilter>
#include <Qt3DRender/QLayer>
#include <Qt3DRender/QRenderTargetSelector>
#include <Qt3DRender/QRenderTarget>
#include <Qt3DRender/QTexture>
#include <Qt3DRender/QClearBuffers>
#include <Qt3DRender/QParameter>
#include <Qt3DRender/QFrustumCulling>
#include <Qt3DRender/QRenderStateSet>
#include <Qt3DRender/QDepthTest>
#include <Qt3DRender/QCullFace>
#include <Qt3DRender/QPolygonOffset>
#include <Qt3DRender/QRenderCapture>
#include <Qt3DRender/QDebugOverlay>
 
#include "qgspointlightsettings.h"
 
class QgsDirectionalLightSettings;
class QgsCameraController;
class QgsRectangle;
class QgsPostprocessingEntity;
class QgsAmbientOcclusionRenderEntity;
class QgsPreviewQuad;
class QgsAmbientOcclusionBlurEntity;
 
#define SIP_NO_FILE
 
class QgsFrameGraph : public Qt3DCore::QEntity
{
    Q_OBJECT
 
  public:
    QgsFrameGraph( QSurface *surface, QSize s, Qt3DRender::QCamera *mainCamera, Qt3DCore::QEntity *root );
 
    Qt3DRender::QFrameGraphNode *frameGraphRoot() { return mRenderSurfaceSelector; }
 
    Qt3DRender::QTexture2D *forwardRenderColorTexture() { return mForwardColorTexture; }
    Qt3DRender::QTexture2D *forwardRenderDepthTexture() { return mForwardDepthTexture; }
    Qt3DRender::QTexture2D *shadowMapTexture() { return mShadowMapTexture; }
 
    Qt3DRender::QTexture2D *blurredAmbientOcclusionFactorMap() { return mAmbientOcclusionBlurTexture; }
 
    Qt3DRender::QLayer *previewLayer() { return mPreviewLayer; }
    Qt3DRender::QLayer *castShadowsLayer() { return mCastShadowsLayer; }
    Qt3DRender::QLayer *forwardRenderLayer() { return mForwardRenderLayer; }
 
    Qt3DRender::QLayer *transparentObjectLayer() { return mTransparentObjectsPassLayer; }
 
    Qt3DRender::QCamera *mainCamera() { return mMainCamera; }
    Qt3DRender::QCamera *lightCamera() { return mLightCamera; }
    QgsPostprocessingEntity *postprocessingEntity() { return mPostprocessingEntity; }
    Qt3DCore::QEntity *rootEntity() { return mRootEntity; }
 
    Qt3DCore::QEntity *rubberBandsRootEntity() { return mRubberBandsRootEntity; }
 
    Qt3DRender::QRenderCapture *renderCapture() { return mRenderCapture; }
 
    Qt3DRender::QRenderCapture *depthRenderCapture() { return mDepthRenderCapture; }
 
 
    bool frustumCullingEnabled() const { return mFrustumCullingEnabled; }
    void setFrustumCullingEnabled( bool enabled );
 
    bool shadowRenderingEnabled() const { return mShadowRenderingEnabled; }
    void setShadowRenderingEnabled( bool enabled );
 
    float shadowBias() const { return mShadowBias; }
    void setShadowBias( float shadowBias );
 
    int shadowMapResolution() const { return mShadowMapResolution; }
    void setShadowMapResolution( int resolution );
 
 
    void setAmbientOcclusionEnabled( bool enabled );
 
    bool ambientOcclusionEnabled() const { return mAmbientOcclusionEnabled; }
 
    void setAmbientOcclusionIntensity( float intensity );
 
    float ambientOcclusionIntensity() const { return mAmbientOcclusionIntensity; }
 
    void setAmbientOcclusionRadius( float radius );
 
    float ambientOcclusionRadius() const { return mAmbientOcclusionRadius; }
 
    void setAmbientOcclusionThreshold( float threshold );
 
    float ambientOcclusionThreshold() const { return mAmbientOcclusionThreshold; }
 
    void setClearColor( const QColor &clearColor );
    QgsPreviewQuad *addTexturePreviewOverlay( Qt3DRender::QTexture2D *texture, const QPointF &centerNDC, const QSizeF &size, QVector<Qt3DRender::QParameter *> additionalShaderParameters = QVector<Qt3DRender::QParameter *>() );
    void setupDirectionalLight( const QgsDirectionalLightSettings &light, float maximumShadowRenderingDistance );
    void setupEyeDomeLighting( bool enabled, double strength, int distance );
    void setupShadowMapDebugging( bool enabled, Qt::Corner corner, double size );
    void setupDepthMapDebugging( bool enabled, Qt::Corner corner, double size );
    void setSize( QSize s );
 
    void setRenderCaptureEnabled( bool enabled );
 
    bool renderCaptureEnabled() const { return mRenderCaptureEnabled; }
 
    void setDebugOverlayEnabled( bool enabled );
 
    QString dumpFrameGraph() const;
 
    QString dumpSceneGraph() const;
 
    void addClipPlanes( int nrClipPlanes );
 
    void removeClipPlanes();
 
  private:
    Qt3DRender::QRenderSurfaceSelector *mRenderSurfaceSelector = nullptr;
    Qt3DRender::QViewport *mMainViewPort = nullptr;
    bool mFrustumCullingEnabled = true;
 
    Qt3DRender::QCamera *mMainCamera = nullptr;
    Qt3DRender::QCamera *mLightCamera = nullptr;
 
    // Forward rendering pass branch nodes:
    Qt3DRender::QCameraSelector *mMainCameraSelector = nullptr;
    Qt3DRender::QLayerFilter *mForwardRenderLayerFilter = nullptr;
    Qt3DRender::QRenderTargetSelector *mForwardRenderTargetSelector = nullptr;
    Qt3DRender::QClearBuffers *mForwardClearBuffers = nullptr;
    Qt3DRender::QFrustumCulling *mFrustumCulling = nullptr;
    // Forward rendering pass texture related objects:
    Qt3DRender::QTexture2D *mForwardColorTexture = nullptr;
    Qt3DRender::QTexture2D *mForwardDepthTexture = nullptr;
    // QDebugOverlay added in the forward pass
    Qt3DRender::QDebugOverlay *mDebugOverlay = nullptr;
 
    // Shadow rendering pass branch nodes:
    Qt3DRender::QCameraSelector *mLightCameraSelectorShadowPass = nullptr;
    Qt3DRender::QLayerFilter *mShadowSceneEntitiesFilter = nullptr;
    Qt3DRender::QRenderTargetSelector *mShadowRenderTargetSelector = nullptr;
    Qt3DRender::QClearBuffers *mShadowClearBuffers = nullptr;
    Qt3DRender::QRenderStateSet *mShadowRenderStateSet = nullptr;
    // Shadow rendering pass texture related objects:
    Qt3DRender::QTexture2D *mShadowMapTexture = nullptr;
 
    // - The depth buffer render pass is made to copy the depth buffer into
    //    an RGB texture that can be captured into a QImage and sent to the CPU for
    //    calculating real 3D points from mouse coordinates (for zoom, rotation, drag..)
    // Depth buffer render pass branch nodes:
    Qt3DRender::QCameraSelector *mDepthRenderCameraSelector = nullptr;
    Qt3DRender::QRenderStateSet *mDepthRenderStateSet = nullptr;
    Qt3DRender::QLayerFilter *mDepthRenderLayerFilter = nullptr;
    Qt3DRender::QRenderTargetSelector *mDepthRenderCaptureTargetSelector = nullptr;
    Qt3DRender::QRenderCapture *mDepthRenderCapture = nullptr;
    // Depth buffer processing pass texture related objects:
    Qt3DRender::QTexture2D *mDepthRenderCaptureDepthTexture = nullptr;
    Qt3DRender::QTexture2D *mDepthRenderCaptureColorTexture = nullptr;
 
    // Post processing pass branch nodes:
    Qt3DRender::QRenderTargetSelector *mRenderCaptureTargetSelector = nullptr;
    Qt3DRender::QRenderCapture *mRenderCapture = nullptr;
    // Post processing pass texture related objects:
    Qt3DRender::QTexture2D *mRenderCaptureColorTexture = nullptr;
    Qt3DRender::QTexture2D *mRenderCaptureDepthTexture = nullptr;
 
    // Ambient occlusion factor generation pass
    Qt3DRender::QCameraSelector *mAmbientOcclusionRenderCameraSelector = nullptr;
    Qt3DRender::QRenderStateSet *mAmbientOcclusionRenderStateSet = nullptr;
    Qt3DRender::QLayerFilter *mAmbientOcclusionRenderLayerFilter = nullptr;
    Qt3DRender::QRenderTargetSelector *mAmbientOcclusionRenderCaptureTargetSelector = nullptr;
    // Ambient occlusion factor generation pass texture related objects:
    Qt3DRender::QTexture2D *mAmbientOcclusionRenderTexture = nullptr;
 
    // Ambient occlusion factor blur pass
    Qt3DRender::QCameraSelector *mAmbientOcclusionBlurCameraSelector = nullptr;
    Qt3DRender::QRenderStateSet *mAmbientOcclusionBlurStateSet = nullptr;
    Qt3DRender::QLayerFilter *mAmbientOcclusionBlurLayerFilter = nullptr;
    Qt3DRender::QRenderTargetSelector *mAmbientOcclusionBlurRenderCaptureTargetSelector = nullptr;
    // Ambient occlusion factor blur pass texture related objects:
    Qt3DRender::QTexture2D *mAmbientOcclusionBlurTexture = nullptr;
 
    // Rubber bands pass
    Qt3DRender::QCameraSelector *mRubberBandsCameraSelector = nullptr;
    Qt3DRender::QLayerFilter *mRubberBandsLayerFilter = nullptr;
    Qt3DRender::QRenderStateSet *mRubberBandsStateSet = nullptr;
    Qt3DRender::QRenderTargetSelector *mRubberBandsRenderTargetSelector = nullptr;
 
    bool mShadowRenderingEnabled = false;
    float mShadowBias = 0.00001f;
    int mShadowMapResolution = 2048;
 
    // Ambient occlusion related settings
    bool mAmbientOcclusionEnabled = false;
    float mAmbientOcclusionIntensity = 0.5f;
    float mAmbientOcclusionRadius = 25.f;
    float mAmbientOcclusionThreshold = 0.5f;
 
    QSize mSize = QSize( 1024, 768 );
 
    bool mEyeDomeLightingEnabled = false;
    double mEyeDomeLightingStrength = 1000.0;
    int mEyeDomeLightingDistance = 1;
 
    QgsPreviewQuad *mDebugShadowMapPreviewQuad = nullptr;
    QgsPreviewQuad *mDebugDepthMapPreviewQuad = nullptr;
 
    QEntity *mDepthRenderQuad = nullptr;
 
    QVector3D mLightDirection = QVector3D( 0.0, -1.0f, 0.0f );
 
    // clip planes render state
    Qt3DRender::QRenderStateSet *mClipRenderStateSet = nullptr;
 
    Qt3DCore::QEntity *mRootEntity = nullptr;
 
    Qt3DRender::QLayer *mPreviewLayer = nullptr;
    Qt3DRender::QLayer *mForwardRenderLayer = nullptr;
    Qt3DRender::QLayer *mCastShadowsLayer = nullptr;
    Qt3DRender::QLayer *mDepthRenderPassLayer = nullptr;
    Qt3DRender::QLayer *mTransparentObjectsPassLayer = nullptr;
    Qt3DRender::QLayer *mRubberBandsLayer = nullptr;
 
    QgsPostprocessingEntity *mPostprocessingEntity = nullptr;
    QgsAmbientOcclusionRenderEntity *mAmbientOcclusionRenderEntity = nullptr;
    QgsAmbientOcclusionBlurEntity *mAmbientOcclusionBlurEntity = nullptr;
 
    Qt3DCore::QEntity *mRubberBandsRootEntity = nullptr;
 
    QVector<QgsPreviewQuad *> mPreviewQuads;
 
    Qt3DRender::QFrameGraphNode *constructShadowRenderPass();
    Qt3DRender::QFrameGraphNode *constructForwardRenderPass();
    Qt3DRender::QFrameGraphNode *constructPostprocessingPass();
    Qt3DRender::QFrameGraphNode *constructDepthRenderPass();
    Qt3DRender::QFrameGraphNode *constructAmbientOcclusionRenderPass();
    Qt3DRender::QFrameGraphNode *constructAmbientOcclusionBlurPass();
    Qt3DRender::QFrameGraphNode *constructRubberBandsPass();
 
    Qt3DRender::QFrameGraphNode *constructSubPostPassForProcessing();
    Qt3DRender::QFrameGraphNode *constructSubPostPassForRenderCapture();
    Qt3DRender::QFrameGraphNode *constructSubPostPassForTexturesPreview();
 
    Qt3DCore::QEntity *constructDepthRenderQuad();
 
    bool mRenderCaptureEnabled = false;
 
    Q_DISABLE_COPY( QgsFrameGraph )
};
 
#endif // QGSFRAMEGRAPH_H