Revision control
++ // Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB).
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
++
++ #ifndef QT3DRENDER_QABSTRACTTEXTURE_H
++ #define QT3DRENDER_QABSTRACTTEXTURE_H
++
++ #include <Qt3DRender/qtextureimagedata.h>
++ #include <Qt3DRender/qtexturewrapmode.h>
++ #include <Qt3DRender/qt3drender_global.h>
++ #include <Qt3DCore/qnode.h>
++ #include <QtCore/QVariant>
++
++ QT_BEGIN_NAMESPACE
++
++ namespace Qt3DRender {
++
++ class QAbstractTexturePrivate;
++ class QAbstractTextureImage;
++ class QTextureDataUpdate;
++
++ 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(int mipLevels READ mipLevels WRITE setMipLevels NOTIFY mipLevelsChanged)
++ 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(2, 13))
++ Q_PROPERTY(QVariant handle READ handle NOTIFY handleChanged REVISION(2, 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,
++ RHITextureId
++ };
++ 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);
++ QList<QAbstractTextureImage *> 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;
++ int mipLevels() 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);
++ void setMipLevels(int mipLevels);
++
++ 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);
++ void mipLevelsChanged(int mipLevels);
++
++ protected:
++ explicit QAbstractTexture(Qt3DCore::QNode *parent = nullptr);
++ explicit QAbstractTexture(Target target, Qt3DCore::QNode *parent = nullptr);
++ explicit QAbstractTexture(QAbstractTexturePrivate &dd, Qt3DCore::QNode *parent = nullptr);
++
++ // 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)
++ };
++
++ } // namespace Qt3DRender
++
++ QT_END_NAMESPACE
++
++ Q_DECLARE_METATYPE(Qt3DRender::QAbstractTexture *) // LCOV_EXCL_LINE
++
++ #endif // QT3DRENDER_QABSTRACTTEXTURE_H