qgsgltfutils.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 QGSGLTFUTILS_H
#define QGSGLTFUTILS_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 <optional>
 
#include "qgis.h"
#include "qgis_core.h"
#include "qgscoordinatetransform.h"
 
#include <QMatrix4x4>
#include <QVector>
 
#define SIP_NO_FILE
 
class QMatrix4x4;
class QImage;
 
class QgsMatrix4x4;
class QgsTiledSceneTile;
class QgsVector3D;
 
namespace tinygltf
{
  struct Image;
  class Model;
  class Node;
  class TinyGLTF;
} //namespace tinygltf
 

class CORE_EXPORT QgsGltfUtils
{
  public:
    static bool accessorToMapCoordinates(
      const tinygltf::Model &model,
      int accessorIndex,
      const QgsMatrix4x4 &tileTransform,
      const QgsCoordinateTransform *ecefToTargetCrs,
      const QgsVector3D &tileTranslationEcef,
      const QMatrix4x4 *nodeTransform,
      Qgis::Axis gltfUpAxis,
      QVector<double> &vx,
      QVector<double> &vy,
      QVector<double> &vz
    );

    enum class ResourceType
    {
      Embedded, 
      Linked,   
    };

    static ResourceType imageResourceType( const tinygltf::Model &model, int index );

    static QImage extractEmbeddedImage( const tinygltf::Model &model, int index );

    static QString linkedImagePath( const tinygltf::Model &model, int index );

    static std::unique_ptr<QMatrix4x4> parseNodeTransform( const tinygltf::Node &node );

    static QgsVector3D extractTileTranslation( tinygltf::Model &model, Qgis::Axis upAxis = Qgis::Axis::Y );

    static bool loadImageDataWithQImage(
      tinygltf::Image *image, const int image_idx, std::string *err, std::string *warn, int req_width, int req_height, const unsigned char *bytes, int size, void *user_data
    );

    static bool extractTextureCoordinates( const tinygltf::Model &model, int accessorIndex, QVector<float> &x, QVector<float> &y );

    static bool loadGltfModel( const QByteArray &data, tinygltf::Model &model, QString *errors, QString *warnings, const QString &baseDir = QString() );

    static std::size_t sourceSceneForModel( const tinygltf::Model &model, bool &ok );

    struct CORE_EXPORT I3SNodeContext
    {
        void initFromTile( const QgsTiledSceneTile &tile, const QgsCoordinateReferenceSystem &layerCrs, const QgsCoordinateReferenceSystem &sceneCrs, const QgsCoordinateTransformContext &transformContext );

        QVariantMap materialInfo;

        bool isGlobalMode = false;

        QgsCoordinateTransform datasetToSceneTransform;

        QgsVector3D nodeCenterEcef;
    };

    static bool loadDracoModel( const QByteArray &data, const I3SNodeContext &context, tinygltf::Model &model, QString *errors = nullptr );

    static int loadMaterialFromMetadata( const QVariantMap &materialInfo, tinygltf::Model &model );

    static bool writeGltfModel( const tinygltf::Model &model, const QString &outputFilename );

    struct InstancedPrimitive
    {
        int meshIndex = -1;      
        int primitiveIndex = -1; 
        int materialIndex = -1;  

        QVector<QMatrix4x4> instanceTransforms;
    };
};

 
#endif // QGSGLTFUTILS_H