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

    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 );
};

 
#endif // QGSGLTFUTILS_H