qgsannotationlayerchunkloader_p.h

Go to the documentation of this file.

/***************************************************************************
  qgsannotationlayerchunkloader_p.h
  --------------------------------------
  Date                 : September 2025
  Copyright            : (C) 2025 by Nyall Dawson
  Email                : nyall dot dawson 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 QGSANNOTATIONLAYERCHUNKLOADER_P_H
#define QGSANNOTATIONLAYERCHUNKLOADER_P_H

 
//
//  W A R N I N G
//  -------------
//
// This file is not part of the QGIS API.  It exists purely as an
// implementation detail.  This header file may change from version to
// version without notice, or even be removed.
//
 
#include "qgs3drendercontext.h"
#include "qgsbillboardgeometry.h"
#include "qgschunkedentity.h"
#include "qgschunkloader.h"
#include "qgstextformat.h"
 
#include <QImage>
 
#define SIP_NO_FILE
 
class QgsAnnotationLayer;
class QgsAnnotationItem;
 
namespace Qt3DCore
{
  class QTransform;
}
 
#include <QFutureWatcher>
 

class QgsAnnotationLayerChunkLoaderFactory : public QgsQuadtreeChunkLoaderFactory
{
    Q_OBJECT
 
  public:
    QgsAnnotationLayerChunkLoaderFactory(
      const Qgs3DRenderContext &context,
      QgsAnnotationLayer *layer,
      int leafLevel,
      Qgis::AltitudeClamping clamping,
      double zOffset,
      bool showCallouts,
      const QColor &calloutLineColor,
      double calloutLineWidth,
      const QgsTextFormat &textFormat,
      double zMin,
      double zMax
    );

    QgsChunkLoader *createChunkLoader( QgsChunkNode *node ) const override;
 
    Qgs3DRenderContext mRenderContext;
    QgsAnnotationLayer *mLayer = nullptr;
    int mLeafLevel = 0;
    Qgis::AltitudeClamping mClamping = Qgis::AltitudeClamping::Relative;
    double mZOffset = 0;
    bool mShowCallouts = false;
    QColor mCalloutLineColor;
    double mCalloutLineWidth = 2;
    QgsTextFormat mTextFormat;
};
 

class QgsAnnotationLayerChunkLoader : public QgsChunkLoader
{
    Q_OBJECT
 
  public:
    QgsAnnotationLayerChunkLoader( const QgsAnnotationLayerChunkLoaderFactory *factory, QgsChunkNode *node );
    ~QgsAnnotationLayerChunkLoader() override;
 
    void start() override;
    void cancel() override;
    Qt3DCore::QEntity *createEntity( Qt3DCore::QEntity *parent ) override;
 
  private:
    const QgsAnnotationLayerChunkLoaderFactory *mFactory = nullptr;
    Qgs3DRenderContext mRenderContext;
    bool mCanceled = false;
    QFutureWatcher<void> *mFutureWatcher = nullptr;
    QString mLayerName;
    QgsVector3D mChunkOrigin;
 
    std::vector< std::unique_ptr< QgsAnnotationItem > > mItemsToRender;
 
    QVector< QgsBillboardGeometry::BillboardAtlasData > mBillboardPositions;
    QVector< QgsBillboardGeometry::BillboardAtlasData > mTextBillboardPositions;
    QVector< QgsLineString > mCalloutLines;
    QImage mBillboardAtlas;
    QImage mTextBillboardAtlas;
    double mZMin = std::numeric_limits< double >::max();
    double mZMax = std::numeric_limits< double >::lowest();
};
 

class QgsAnnotationLayerChunkedEntity : public QgsChunkedEntity
{
    Q_OBJECT
  public:
    explicit QgsAnnotationLayerChunkedEntity(
      Qgs3DMapSettings *map,
      QgsAnnotationLayer *layer,
      Qgis::AltitudeClamping clamping,
      double zOffset,
      bool showCallouts,
      const QColor &calloutLineColor,
      double calloutLineWidth,
      const QgsTextFormat &textFormat,
      double zMin,
      double zMax
    );
    ~QgsAnnotationLayerChunkedEntity() override;
 
  private slots:
    void onTerrainElevationOffsetChanged();
 
  private:
    Qt3DCore::QTransform *mTransform = nullptr;
 
    bool applyTerrainOffset() const;
 
    friend class TestQgsChunkedEntity;
};

 
#endif // QGSANNOTATIONLAYERCHUNKLOADER_P_H