qgsgltf3dutils.h

Go to the documentation of this file.

/***************************************************************************
  qgsgltfutils.h
  --------------------------------------
  Date                 : July 2023
  Copyright            : (C) 2023 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 QGSGLTF3DUTILS_H
#define QGSGLTF3DUTILS_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 <memory>
#include <vector>
 
#include "qgis_3d.h"
#include "qgs3dutils.h"
#include "qgsgltfutils.h"
#include "qgsmaterial.h"
#include "qgsmatrix4x4.h"
 
#include <QQuaternion>
#include <QVector3D>
 
#define SIP_NO_FILE
 
#define TINYGLTF_NO_STB_IMAGE       // we use QImage-based reading of images
#define TINYGLTF_NO_STB_IMAGE_WRITE // we don't need writing of images
#include "tiny_gltf.h"
 
class QgsCoordinateTransform;
class Qgs3DRenderContext;
class QgsMaterialContext;
 
namespace Qt3DCore
{
  class QEntity;
  class QGeometry;
  class QNode;
  class QBuffer;
} //namespace Qt3DCore

class _3D_EXPORT QgsGltf3DUtils
{
  public:
    struct EntityTransform
    {
        QgsVector3D chunkOriginTargetCrs;
        QgsMatrix4x4 tileTransform;
        const QgsCoordinateTransform *ecefToTargetCrs = nullptr;

        Qgis::Axis gltfUpAxis = Qgis::Axis::Y;
 
        double zValueScale = 1;
        double zValueOffset = 0;
    };

    static Qt3DCore::QEntity *gltfToEntity( const QByteArray &data, const EntityTransform &transform, const QString &baseUri, const Qgs3DRenderContext &context, QStringList *errors = nullptr );

    static Qt3DCore::QEntity *parsedGltfToEntity( tinygltf::Model &model, const QgsGltf3DUtils::EntityTransform &transform, QString baseUri, const Qgs3DRenderContext &context, QStringList *errors );

    struct InstanceChunkTransform
    {
        QVector3D translation; 
        QQuaternion rotation;  
        QVector3D scale;       
    };

    static QMatrix3x3 ecefToTargetCrsRotationCorrection( const QgsVector3D &ecefPos, const QgsVector3D &mapPos, const QgsCoordinateTransform &ecefToTargetCrs );

    static QVector<InstanceChunkTransform> tileSpaceToChunkLocal( const QgsGltfUtils::InstancedPrimitive &primitive, const EntityTransform &transform );

    static void createInstanceBuffer( Qt3DCore::QGeometry *geometry, const QVector<InstanceChunkTransform> &instances );

    static QVector<Qt3DCore::QEntity *> createInstancedEntities(
      tinygltf::Model &model, const QVector<QgsGltfUtils::InstancedPrimitive> &primitives, const EntityTransform &transform, const QString &baseUri, const QgsMaterialContext &context, QStringList *errors
    );

    static std::vector<QgsMeshNodeData> buildGltfGeometries( const QString &filePath, const QgsMaterialContext &context, QStringList *errors = nullptr, Qt3DCore::QNode *bufferParent = nullptr );
};

 
#endif // QGSGLTF3DUTILS_H