qgstextureatlasgenerator.h

Go to the documentation of this file.

/***************************************************************************
  qgstextureatlasgenerator.h
  --------------------------------------
  Date                 : September 2025
  Copyright            : (C) 2025 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 QGSTEXTUREATLASGENERATOR_H
#define QGSTEXTUREATLASGENERATOR_H
 
#include <vector>
 
#include "qgis_3d.h"
 
#include <QImage>
#include <QRect>

class QgsTextureRect;
 

class _3D_EXPORT QgsTextureAtlas
{
  public:
    QgsTextureAtlas();
    ~QgsTextureAtlas();
 
    QgsTextureAtlas( const QgsTextureAtlas &other );
    QgsTextureAtlas &operator=( const QgsTextureAtlas &other );

    bool isValid() const { return mAtlasSize.isValid(); }

    QSize atlasSize() const { return mAtlasSize; }
 
#ifndef SIP_RUN
    QRect rect( int index ) const;
#else

    QRect rect( int index ) const;
    //%MethodCode
    const int count = sipCpp->count();
    if ( a0 < 0 || a0 >= count )
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
    else
    {
      return sipConvertFromNewType( new QRect( sipCpp->rect( a0 ) ), sipType_QRect, Py_None );
    }
    //%End
#endif

    QImage renderAtlasTexture() const;

    QImage renderDebugTexture() const;

    int count() const;
 
#ifdef SIP_RUN
    // clang-format off
    int __len__() const;
    % Docstring
    Returns the number of textures in the atlas.
    % End
    //%MethodCode
    sipRes = sipCpp->count();
    //% End
// clang-format on
#endif
 
  private:
    std::vector< QgsTextureRect > mRects;
    QSize mAtlasSize;
 
    friend class QgsTextureAtlasGenerator;
};

class _3D_EXPORT QgsTextureAtlasGenerator
{
  public:
    static QgsTextureAtlas createFromRects( const QVector< QRect > &rectangles, int maxSide = 1000 );

    static QgsTextureAtlas createFromImages( const QVector< QImage > &images, int maxSide = 1000 );
 
  private:
    static QgsTextureAtlas generateAtlas( std::vector< QgsTextureRect > rects, int maxSide );
};
 
#endif // QGSTEXTUREATLASGENERATOR_H