PatchGeometry.h

Go to the documentation of this file.

/****************************************************************************
 *
 * (c) 2009-2024 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/
 
#pragma once
 
#include <QtCore/QList>
#include <QtQuick3D/QQuick3DGeometry>
 
#include <array>
 
#include "TileMath.h"
 
class HeightField;
 
Q_MOC_INCLUDE("HeightField.h")
 
 
class PatchGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_ELEMENT
    Q_PROPERTY(int gridSize READ gridSize WRITE setGridSize NOTIFY gridSizeChanged)
    Q_PROPERTY(qreal span READ span WRITE setSpan NOTIFY spanChanged)
    Q_PROPERTY(QList<float> heights READ heights WRITE setHeights NOTIFY heightsChanged)
    Q_PROPERTY(QList<int> edgeLodDeltas READ edgeLodDeltas WRITE setEdgeLodDeltas NOTIFY edgeLodDeltasChanged)
    Q_PROPERTY(HeightField* heightField READ heightField WRITE setHeightField NOTIFY heightFieldChanged)
 
public:
    explicit PatchGeometry(QQuick3DObject* parent = nullptr);
 
    static constexpr int kMinGridSize = 1;
    static constexpr int kMaxGridSize = 256;
    static constexpr double kSkirtDepthFraction =
        0.05;  
 
    int gridSize() const { return _gridSize; }
 
    void setGridSize(int gridSize);
 
    qreal span() const { return _span; }
 
    void setSpan(qreal span);
 
    QList<float> heights() const { return _heights; }
 
    void setHeights(const QList<float>& heights);
 
    HeightField* heightField() const { return _heightField; }
 
    void setHeightField(HeightField* heightField);
 
    bool sampleFromField(const TileMath::TileKey& key);
 
    void setEdgeLodDeltas(int north, int south, int west, int east);
 
    QList<int> edgeLodDeltas() const
    {
        return {_lodDelta[kNorth], _lodDelta[kSouth], _lodDelta[kWest], _lodDelta[kEast]};
    }
 
    void setEdgeLodDeltas(const QList<int>& deltas);
 
signals:
    void gridSizeChanged();
    void spanChanged();
    void heightsChanged();
    void edgeLodDeltasChanged();
    void heightFieldChanged();
 
protected:
    void componentComplete() override;
 
private:
    enum Edge
    {
        kNorth,
        kSouth,
        kWest,
        kEast,
        kEdgeCount
    };
 
    void _rebuild();
    void _requestRebuild();
    float _heightAt(int row, int col) const;
    float _rawHeightAt(int row, int col) const;
 
    int _gridSize = 16;
    qreal _span = 1000.0;
    QList<float> _heights;
    HeightField* _heightField = nullptr;
    std::array<int, kEdgeCount> _lodDelta{};
};