qgscesiumutils.h

Go to the documentation of this file.

/***************************************************************************
                         qgscesiumutils.h
                         --------------------
    begin                : July 2023
    copyright            : (C) 2023 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 QGSCESIUMUTILS_H
#define QGSCESIUMUTILS_H
 
#include <nlohmann/json_fwd.hpp>
#include <optional>
 
#include "qgis.h"
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgsbox3d.h"
#include "qgsvector3d.h"
 
#include <QQuaternion>
#include <QVector>
#include <QVector3D>
 
#ifndef SIP_RUN
using namespace nlohmann;
#endif
 
class QgsCoordinateTransformContext;
class QgsSphere;
class QgsOrientedBox3D;
class QgsMatrix4x4;
class QgsTiledSceneBoundingVolume;
 
#ifndef SIP_RUN
namespace tinygltf
{
  class Model;
}
#include "qgsgltfutils.h"
#endif

class CORE_EXPORT QgsCesiumUtils
{
  public:
#ifndef SIP_RUN

    static QgsBox3D parseRegion( const json &region );
#endif

    static QgsBox3D parseRegion( const QVariantList &region );
 
#ifndef SIP_RUN

    static QgsOrientedBox3D parseBox( const json &box );
#endif

    static QgsOrientedBox3D parseBox( const QVariantList &box );
 
#ifndef SIP_RUN

    static QgsSphere parseSphere( const json &sphere );
#endif

    static QgsSphere parseSphere( const QVariantList &sphere );

    static QgsSphere transformSphere( const QgsSphere &sphere, const QgsMatrix4x4 &transform );

    struct B3DMContents
    {
        QByteArray gltf;

        QgsVector3D rtcCenter;
    };

    static B3DMContents extractGltfFromB3dm( const QByteArray &tileContent );
 
#ifndef SIP_RUN
    struct TileI3dmData
    {
        int instanceCount = 0;
        QVector<QVector3D> translations;
        QVector<QQuaternion> rotations;
        QVector<QVector3D> scales;
        bool eastNorthUp = false;
    };
#endif

    struct TileContents
    {
        QByteArray gltf;

        QgsVector3D rtcCenter;
 
#ifndef SIP_RUN
        std::optional<TileI3dmData> instancing;
#endif
    };

    Q_DECL_DEPRECATED static TileContents extractGltfFromTileContent( const QByteArray &tileContent ) SIP_DEPRECATED;

    static QVector<QgsCesiumUtils::TileContents> extractTileContent( const QByteArray &tileContent, const QString &baseUri = QString() );

    static QgsTiledSceneBoundingVolume boundingVolumeFromRegion( const QgsBox3D &region, const QgsCoordinateTransformContext &transformContext );

    static QString appendQueryFromBaseUrl( const QString &contentUri, const QUrl &baseUrl );
 
#ifndef SIP_RUN

    static QVector<QgsGltfUtils::InstancedPrimitive> resolveInstancing(
      const tinygltf::Model &model, const std::optional<TileI3dmData> &tileInstancing, Qgis::Axis gltfUpAxis, const QgsMatrix4x4 &tileTransform, const QgsVector3D &rtcCenter
    );
 
#endif // SIP_RUN
};
 
#endif // QGSCESIUMUTILS_H