/**************************************************************************** ** ** Copyright (C) 2015 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_QABSTRACTTEXTURE_H #define QT3DRENDER_QABSTRACTTEXTURE_H #include #include #include QT_BEGIN_NAMESPACE namespace Qt3DRender { class QAbstractTexturePrivate; class QTextureWrapMode; class QAbstractTextureImage; class QTextureGenerator; class QTextureDataUpdate; typedef QSharedPointer QTextureGeneratorPtr; class Q_3DRENDERSHARED_EXPORT QAbstractTexture : public Qt3DCore::QNode { Q_OBJECT Q_PROPERTY(Target target READ target CONSTANT) Q_PROPERTY(TextureFormat format READ format WRITE setFormat NOTIFY formatChanged) Q_PROPERTY(bool generateMipMaps READ generateMipMaps WRITE setGenerateMipMaps NOTIFY generateMipMapsChanged) Q_PROPERTY(Qt3DRender::QTextureWrapMode *wrapMode READ wrapMode CONSTANT) Q_PROPERTY(Status status READ status NOTIFY statusChanged) Q_PROPERTY(int width READ width WRITE setWidth NOTIFY widthChanged) Q_PROPERTY(int height READ height WRITE setHeight NOTIFY heightChanged) Q_PROPERTY(int depth READ depth WRITE setDepth NOTIFY depthChanged) Q_PROPERTY(Filter magnificationFilter READ magnificationFilter WRITE setMagnificationFilter NOTIFY magnificationFilterChanged) Q_PROPERTY(Filter minificationFilter READ minificationFilter WRITE setMinificationFilter NOTIFY minificationFilterChanged) Q_PROPERTY(float maximumAnisotropy READ maximumAnisotropy WRITE setMaximumAnisotropy NOTIFY maximumAnisotropyChanged) Q_PROPERTY(ComparisonFunction comparisonFunction READ comparisonFunction WRITE setComparisonFunction NOTIFY comparisonFunctionChanged) Q_PROPERTY(ComparisonMode comparisonMode READ comparisonMode WRITE setComparisonMode NOTIFY comparisonModeChanged) Q_PROPERTY(int layers READ layers WRITE setLayers NOTIFY layersChanged) Q_PROPERTY(int samples READ samples WRITE setSamples NOTIFY samplesChanged) Q_PROPERTY(HandleType handleType READ handleType NOTIFY handleTypeChanged REVISION 13) Q_PROPERTY(QVariant handle READ handle NOTIFY handleChanged REVISION 13) public: enum Status { None = 0, Loading, Ready, Error }; Q_ENUM(Status) // LCOV_EXCL_LINE enum Target { TargetAutomatic = 0, // Target will be determined by the Qt3D engine Target1D = 0x0DE0, // GL_TEXTURE_1D Target1DArray = 0x8C18, // GL_TEXTURE_1D_ARRAY Target2D = 0x0DE1, // GL_TEXTURE_2D Target2DArray = 0x8C1A, // GL_TEXTURE_2D_ARRAY Target3D = 0x806F, // GL_TEXTURE_3D TargetCubeMap = 0x8513, // GL_TEXTURE_CUBE_MAP TargetCubeMapArray = 0x9009, // GL_TEXTURE_CUBE_MAP_ARRAY Target2DMultisample = 0x9100, // GL_TEXTURE_2D_MULTISAMPLE Target2DMultisampleArray = 0x9102, // GL_TEXTURE_2D_MULTISAMPLE_ARRAY TargetRectangle = 0x84F5, // GL_TEXTURE_RECTANGLE TargetBuffer = 0x8C2A // GL_TEXTURE_BUFFER }; Q_ENUM(Target) // LCOV_EXCL_LINE enum TextureFormat { NoFormat = 0, // GL_NONE Automatic = 1, // The Qt3D engine automatically determines the best format // Unsigned normalized formats R8_UNorm = 0x8229, // GL_R8 RG8_UNorm = 0x822B, // GL_RG8 RGB8_UNorm = 0x8051, // GL_RGB8 RGBA8_UNorm = 0x8058, // GL_RGBA8 R16_UNorm = 0x822A, // GL_R16 RG16_UNorm = 0x822C, // GL_RG16 RGB16_UNorm = 0x8054, // GL_RGB16 RGBA16_UNorm = 0x805B, // GL_RGBA16 // Signed normalized formats R8_SNorm = 0x8F94, // GL_R8_SNORM RG8_SNorm = 0x8F95, // GL_RG8_SNORM RGB8_SNorm = 0x8F96, // GL_RGB8_SNORM RGBA8_SNorm = 0x8F97, // GL_RGBA8_SNORM R16_SNorm = 0x8F98, // GL_R16_SNORM RG16_SNorm = 0x8F99, // GL_RG16_SNORM RGB16_SNorm = 0x8F9A, // GL_RGB16_SNORM RGBA16_SNorm = 0x8F9B, // GL_RGBA16_SNORM // Unsigned integer formats R8U = 0x8232, // GL_R8UI RG8U = 0x8238, // GL_RG8UI RGB8U = 0x8D7D, // GL_RGB8UI RGBA8U = 0x8D7C, // GL_RGBA8UI R16U = 0x8234, // GL_R16UI RG16U = 0x823A, // GL_RG16UI RGB16U = 0x8D77, // GL_RGB16UI RGBA16U = 0x8D76, // GL_RGBA16UI R32U = 0x8236, // GL_R32UI RG32U = 0x823C, // GL_RG32UI RGB32U = 0x8D71, // GL_RGB32UI RGBA32U = 0x8D70, // GL_RGBA32UI // Signed integer formats R8I = 0x8231, // GL_R8I RG8I = 0x8237, // GL_RG8I RGB8I = 0x8D8F, // GL_RGB8I RGBA8I = 0x8D8E, // GL_RGBA8I R16I = 0x8233, // GL_R16I RG16I = 0x8239, // GL_RG16I RGB16I = 0x8D89, // GL_RGB16I RGBA16I = 0x8D88, // GL_RGBA16I R32I = 0x8235, // GL_R32I RG32I = 0x823B, // GL_RG32I RGB32I = 0x8D83, // GL_RGB32I RGBA32I = 0x8D82, // GL_RGBA32I // Floating point formats R16F = 0x822D, // GL_R16F RG16F = 0x822F, // GL_RG16F RGB16F = 0x881B, // GL_RGB16F RGBA16F = 0x881A, // GL_RGBA16F R32F = 0x822E, // GL_R32F RG32F = 0x8230, // GL_RG32F RGB32F = 0x8815, // GL_RGB32F RGBA32F = 0x8814, // GL_RGBA32F // Packed formats RGB9E5 = 0x8C3D, // GL_RGB9_E5 RG11B10F = 0x8C3A, // GL_R11F_G11F_B10F RG3B2 = 0x2A10, // GL_R3_G3_B2 R5G6B5 = 0x8D62, // GL_RGB565 RGB5A1 = 0x8057, // GL_RGB5_A1 RGBA4 = 0x8056, // GL_RGBA4 RGB10A2 = 0x8059, // GL_RGB10_A2 RGB10A2U = 0x906F, // GL_RGB10_A2UI // Depth formats D16 = 0x81A5, // GL_DEPTH_COMPONENT16 D24 = 0x81A6, // GL_DEPTH_COMPONENT24 D24S8 = 0x88F0, // GL_DEPTH24_STENCIL8 D32 = 0x81A7, // GL_DEPTH_COMPONENT32 D32F = 0x8CAC, // GL_DEPTH_COMPONENT32F D32FS8X24 = 0x8CAD, // GL_DEPTH32F_STENCIL8 // Compressed formats RGB_DXT1 = 0x83F0, // GL_COMPRESSED_RGB_S3TC_DXT1_EXT RGBA_DXT1 = 0x83F1, // GL_COMPRESSED_RGBA_S3TC_DXT1_EXT RGBA_DXT3 = 0x83F2, // GL_COMPRESSED_RGBA_S3TC_DXT3_EXT RGBA_DXT5 = 0x83F3, // GL_COMPRESSED_RGBA_S3TC_DXT5_EXT R_ATI1N_UNorm = 0x8DBB, // GL_COMPRESSED_RED_RGTC1 R_ATI1N_SNorm = 0x8DBC, // GL_COMPRESSED_SIGNED_RED_RGTC1 RG_ATI2N_UNorm = 0x8DBD, // GL_COMPRESSED_RG_RGTC2 RG_ATI2N_SNorm = 0x8DBE, // GL_COMPRESSED_SIGNED_RG_RGTC2 RGB_BP_UNSIGNED_FLOAT = 0x8E8F, // GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB RGB_BP_SIGNED_FLOAT = 0x8E8E, // GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB RGB_BP_UNorm = 0x8E8C, // GL_COMPRESSED_RGBA_BPTC_UNORM_ARB R11_EAC_UNorm = 0x9270, // GL_COMPRESSED_R11_EAC R11_EAC_SNorm = 0x9271, // GL_COMPRESSED_SIGNED_R11_EAC RG11_EAC_UNorm = 0x9272, // GL_COMPRESSED_RG11_EAC RG11_EAC_SNorm = 0x9273, // GL_COMPRESSED_SIGNED_RG11_EAC RGB8_ETC2 = 0x9274, // GL_COMPRESSED_RGB8_ETC2 SRGB8_ETC2 = 0x9275, // GL_COMPRESSED_SRGB8_ETC2 RGB8_PunchThrough_Alpha1_ETC2 = 0x9276, // GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2 SRGB8_PunchThrough_Alpha1_ETC2 = 0x9277, // GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2 RGBA8_ETC2_EAC = 0x9278, // GL_COMPRESSED_RGBA8_ETC2_EAC SRGB8_Alpha8_ETC2_EAC = 0x9279, // GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC RGB8_ETC1 = 0x8D64, // GL_ETC1_RGB8_OES // sRGB formats SRGB8 = 0x8C41, // GL_SRGB8 SRGB8_Alpha8 = 0x8C43, // GL_SRGB8_ALPHA8 SRGB_DXT1 = 0x8C4C, // GL_COMPRESSED_SRGB_S3TC_DXT1_EXT SRGB_Alpha_DXT1 = 0x8C4D, // GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT SRGB_Alpha_DXT3 = 0x8C4E, // GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT SRGB_Alpha_DXT5 = 0x8C4F, // GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT SRGB_BP_UNorm = 0x8E8D, // GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_ARB // ES 2 formats DepthFormat = 0x1902, // GL_DEPTH_COMPONENT AlphaFormat = 0x1906, // GL_ALPHA RGBFormat = 0x1907, // GL_RGB RGBAFormat = 0x1908, // GL_RGBA LuminanceFormat = 0x1909, // GL_LUMINANCE LuminanceAlphaFormat = 0x190A }; Q_ENUM(TextureFormat) // LCOV_EXCL_LINE enum Filter { Nearest = 0x2600, // GL_NEAREST Linear = 0x2601, // GL_LINEAR NearestMipMapNearest = 0x2700, // GL_NEAREST_MIPMAP_NEAREST NearestMipMapLinear = 0x2702, // GL_NEAREST_MIPMAP_LINEAR LinearMipMapNearest = 0x2701, // GL_LINEAR_MIPMAP_NEAREST LinearMipMapLinear = 0x2703 // GL_LINEAR_MIPMAP_LINEAR }; Q_ENUM(Filter) // LCOV_EXCL_LINE enum CubeMapFace { CubeMapPositiveX = 0x8515, // GL_TEXTURE_CUBE_MAP_POSITIVE_X CubeMapNegativeX = 0x8516, // GL_TEXTURE_CUBE_MAP_NEGATIVE_X CubeMapPositiveY = 0x8517, // GL_TEXTURE_CUBE_MAP_POSITIVE_Y CubeMapNegativeY = 0x8518, // GL_TEXTURE_CUBE_MAP_NEGATIVE_Y CubeMapPositiveZ = 0x8519, // GL_TEXTURE_CUBE_MAP_POSITIVE_Z CubeMapNegativeZ = 0x851A, // GL_TEXTURE_CUBE_MAP_NEGATIVE_Z AllFaces }; Q_ENUM(CubeMapFace) // LCOV_EXCL_LINE enum ComparisonFunction { CompareLessEqual = 0x0203, // GL_LEQUAL CompareGreaterEqual = 0x0206, // GL_GEQUAL CompareLess = 0x0201, // GL_LESS CompareGreater = 0x0204, // GL_GREATER CompareEqual = 0x0202, // GL_EQUAL CommpareNotEqual = 0x0205, // GL_NOTEQUAL CompareAlways = 0x0207, // GL_ALWAYS CompareNever = 0x0200 // GL_NEVER }; Q_ENUM(ComparisonFunction) // LCOV_EXCL_LINE enum ComparisonMode { CompareRefToTexture = 0x884E, // GL_COMPARE_REF_TO_TEXTURE CompareNone = 0x0000 // GL_NONE }; Q_ENUM(ComparisonMode) // LCOV_EXCL_LINE enum HandleType { NoHandle, OpenGLTextureId }; Q_ENUM(HandleType) // LCOV_EXCL_LINE ~QAbstractTexture(); Target target() const; TextureFormat format() const; bool generateMipMaps() const; Status status() const; void addTextureImage(QAbstractTextureImage *textureImage); void removeTextureImage(QAbstractTextureImage *textureImage); QVector textureImages() const; // sampler data - in the future proxy to a Sampler helper void setWrapMode(const QTextureWrapMode &wrapMode); QTextureWrapMode *wrapMode(); void setSize(int width, int height=1, int depth=1); Filter minificationFilter() const; Filter magnificationFilter() const; float maximumAnisotropy() const; ComparisonFunction comparisonFunction() const; ComparisonMode comparisonMode() const; int width() const; int height() const; int depth() const; int layers() const; int samples() const; Q3D_DECL_DEPRECATED QTextureGeneratorPtr dataGenerator() const; HandleType handleType() const; QVariant handle() const; Q_INVOKABLE void updateData(const QTextureDataUpdate &update); public Q_SLOTS: void setFormat(TextureFormat format); void setGenerateMipMaps(bool gen); void setWidth(int width); void setHeight(int height); void setDepth(int depth); void setMinificationFilter(Filter f); void setMagnificationFilter(Filter f); void setMaximumAnisotropy(float anisotropy); void setComparisonFunction(ComparisonFunction function); void setComparisonMode(ComparisonMode mode); void setLayers(int layers); void setSamples(int samples); Q_SIGNALS: void formatChanged(TextureFormat format); void statusChanged(Status status); void generateMipMapsChanged(bool generateMipMaps); void widthChanged(int width); void heightChanged(int height); void depthChanged(int depth); void magnificationFilterChanged(Filter magnificationFilter); void minificationFilterChanged(Filter minificationFilter); void maximumAnisotropyChanged(float maximumAnisotropy); void comparisonFunctionChanged(ComparisonFunction comparisonFunction); void comparisonModeChanged(ComparisonMode comparisonMode); void layersChanged(int layers); void samplesChanged(int samples); Q_REVISION(13) void handleTypeChanged(HandleType handleType); Q_REVISION(13) void handleChanged(QVariant handle); protected: explicit QAbstractTexture(Qt3DCore::QNode *parent = nullptr); explicit QAbstractTexture(Target target, Qt3DCore::QNode *parent = nullptr); explicit QAbstractTexture(QAbstractTexturePrivate &dd, Qt3DCore::QNode *parent = nullptr); void sceneChangeEvent(const Qt3DCore::QSceneChangePtr &change) override; // TO DO Qt6, should be on private class void setStatus(Status status); void setHandle(const QVariant &handle); void setHandleType(HandleType type); private: Q_DECLARE_PRIVATE(QAbstractTexture) Qt3DCore::QNodeCreatedChangeBasePtr createNodeCreationChange() const override; }; } // namespace Qt3DRender QT_END_NAMESPACE Q_DECLARE_METATYPE(Qt3DRender::QAbstractTexture *) // LCOV_EXCL_LINE #endif // QT3DRENDER_QABSTRACTTEXTURE_H