/**************************************************************************** ** ** Copyright (C) 2016 Klaralvdalens Datakonsult AB (KDAB). ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt3D module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QT3DRENDER_RENDER_TEXTURE_H #define QT3DRENDER_RENDER_TEXTURE_H // // W A R N I N G // ------------- // // This file is not part of the Qt API. It exists for the convenience // of other Qt classes. This header file may change from version to // version without notice, or even be removed. // // We mean it. // #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE class QOpenGLTexture; namespace Qt3DRender { class QAbstractTexture; namespace Render { class TextureManager; class TextureImageManager; /** * General, constant properties of a texture */ struct TextureProperties { int width = 1; int height = 1; int depth = 1; int layers = 1; int mipLevels = 1; int samples = 1; QAbstractTexture::Target target = QAbstractTexture::Target2D; QAbstractTexture::TextureFormat format = QAbstractTexture::RGBA8_UNorm; bool generateMipMaps = false; bool operator==(const TextureProperties &o) const { return (width == o.width) && (height == o.height) && (depth == o.depth) && (layers == o.layers) && (mipLevels == o.mipLevels) && (target == o.target) && (format == o.format) && (generateMipMaps == o.generateMipMaps) && (samples == o.samples); } inline bool operator!=(const TextureProperties &o) const { return !(*this == o); } }; /** * Texture parameters that are independent of texture data and that may * change without the re-uploading the texture */ struct TextureParameters { QAbstractTexture::Filter magnificationFilter = QAbstractTexture::Nearest; QAbstractTexture::Filter minificationFilter = QAbstractTexture::Nearest; QTextureWrapMode::WrapMode wrapModeX = QTextureWrapMode::ClampToEdge; QTextureWrapMode::WrapMode wrapModeY = QTextureWrapMode::ClampToEdge; QTextureWrapMode::WrapMode wrapModeZ = QTextureWrapMode::ClampToEdge; float maximumAnisotropy = 1.0f; QAbstractTexture::ComparisonFunction comparisonFunction = QAbstractTexture::CompareLessEqual; QAbstractTexture::ComparisonMode comparisonMode = QAbstractTexture::CompareNone; bool operator==(const TextureParameters &o) const { return (magnificationFilter == o.magnificationFilter) && (minificationFilter == o.minificationFilter) && (wrapModeX == o.wrapModeX) && (wrapModeY == o.wrapModeY) && (wrapModeZ == o.wrapModeZ) && (maximumAnisotropy == o.maximumAnisotropy) && (comparisonFunction == o.comparisonFunction) && (comparisonMode == o.comparisonMode); } inline bool operator!=(const TextureParameters &o) const { return !(*this == o); } }; /** * Backend object for QAbstractTexture. Just holds texture properties and parameters. * Will query the TextureImplManager for an instance of TextureImpl that matches it's * properties. */ class Q_AUTOTEST_EXPORT Texture : public BackendNode { public: Texture(); ~Texture(); enum DirtyFlag { NotDirty = 0, DirtyProperties = 0x1, DirtyParameters = 0x2, DirtyImageGenerators = 0x4, DirtyDataGenerator = 0x8 }; Q_DECLARE_FLAGS(DirtyFlags, DirtyFlag) void setTextureImageManager(TextureImageManager *manager); void addDirtyFlag(DirtyFlags flags); inline DirtyFlags dirtyFlags() const { return m_dirty; } void unsetDirty(); void addTextureImage(Qt3DCore::QNodeId id); void removeTextureImage(Qt3DCore::QNodeId id); void cleanup(); void sceneChangeEvent(const Qt3DCore::QSceneChangePtr &e) Q_DECL_OVERRIDE; inline const TextureProperties& properties() const { return m_properties; } inline const TextureParameters& parameters() const { return m_parameters; } inline const QVector& textureImages() const { return m_textureImages; } inline const QTextureGeneratorPtr& dataGenerator() const { return m_dataFunctor; } bool isValid() const; private: void initializeFromPeer(const Qt3DCore::QNodeCreatedChangeBasePtr &change) Q_DECL_FINAL; DirtyFlags m_dirty; TextureProperties m_properties; TextureParameters m_parameters; QTextureGeneratorPtr m_dataFunctor; QVector m_textureImages; TextureImageManager *m_textureImageManager; }; class TextureFunctor : public Qt3DCore::QBackendNodeMapper { public: explicit TextureFunctor(AbstractRenderer *renderer, TextureManager *textureNodeManager, TextureImageManager *textureImageManager); Qt3DCore::QBackendNode *create(const Qt3DCore::QNodeCreatedChangeBasePtr &change) const Q_DECL_FINAL; Qt3DCore::QBackendNode *get(Qt3DCore::QNodeId id) const Q_DECL_FINAL; void destroy(Qt3DCore::QNodeId id) const Q_DECL_FINAL; private: AbstractRenderer *m_renderer; TextureManager *m_textureNodeManager; TextureImageManager *m_textureImageManager; }; #ifndef QT_NO_DEBUG_STREAM inline QDebug operator<<(QDebug dbg, const Texture &texture) { QDebugStateSaver saver(dbg); dbg << "QNodeId =" << texture.peerId() << "imageCount =" << texture.textureImages().size() << endl; return dbg; } #endif } // namespace Render } // namespace Qt3DRender QT_END_NAMESPACE Q_DECLARE_METATYPE(Qt3DRender::Render::Texture*) // LCOV_EXCL_LINE #endif // QT3DRENDER_RENDER_TEXTURE_H