1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
|
/****************************************************************************
**
** Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the Qt3D module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL3$
** 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 http://www.qt.io/terms-conditions. For further
** information use the contact form at http://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.LGPLv3 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.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 later as published by the Free
** Software Foundation and appearing in the file LICENSE.GPL included in
** the packaging of this file. Please review the following information to
** ensure the GNU General Public License version 2.0 requirements will be
** met: http://www.gnu.org/licenses/gpl-2.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef QT3DRENDER_QABSTRACTTEXTUREPROVIDER_H
#define QT3DRENDER_QABSTRACTTEXTUREPROVIDER_H
#include <Qt3DRender/texturedata.h>
#include <Qt3DRender/qt3drender_global.h>
#include <Qt3DCore/qnode.h>
QT_BEGIN_NAMESPACE
namespace Qt3DRender {
class QAbstractTextureProviderPrivate;
class QTextureWrapMode;
class QAbstractTextureImage;
class QT3DRENDERSHARED_EXPORT QAbstractTextureProvider : 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 maximumLayers READ maximumLayers WRITE setMaximumLayers NOTIFY maximumLayersChanged)
Q_PROPERTY(bool unique READ isUnique WRITE setUnique NOTIFY uniqueChanged)
public:
enum Status {
Loading = 0,
Loaded,
Error
};
Q_ENUM(Status)
enum Target {
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)
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 = 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)
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)
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
};
Q_ENUM(CubeMapFace)
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)
enum ComparisonMode {
CompareRefToTexture = 0x884E, // GL_COMPARE_REF_TO_TEXTURE
CompareNone = 0x0000 // GL_NONE
};
Q_ENUM(ComparisonMode)
~QAbstractTextureProvider();
Target target() const;
void setFormat(TextureFormat format);
TextureFormat format() const;
Status status() const;
void addTextureImage(QAbstractTextureImage *textureImage);
void removeTextureImage(QAbstractTextureImage *textureImage);
QList<QAbstractTextureImage *> textureImages() const;
void setGenerateMipMaps(bool gen);
bool generateMipMaps() const;
// sampler data - in the future proxy to a Sampler helper
void setMinificationFilter(Filter f);
void setMagnificationFilter(Filter f);
Filter minificationFilter() const;
Filter magnificationFilter() const;
void setWrapMode(const QTextureWrapMode &wrapMode);
QTextureWrapMode *wrapMode();
void setMaximumAnisotropy(float anisotropy);
float maximumAnisotropy() const;
void setComparisonFunction(ComparisonFunction function);
ComparisonFunction comparisonFunction() const;
void setComparisonMode(ComparisonMode mode);
ComparisonMode comparisonMode() const;
void setSize(int width, int height=1, int depth=1);
void setWidth(int width);
void setHeight(int height);
void setDepth(int depth);
int width() const;
int height() const;
int depth() const;
void setMaximumLayers(int maximumLayers);
int maximumLayers() const;
void setUnique(bool unique);
bool isUnique() const;
Q_SIGNALS:
void formatChanged();
void statusChanged();
void generateMipMapsChanged();
void widthChanged();
void heightChanged();
void depthChanged();
void magnificationFilterChanged();
void minificationFilterChanged();
void maximumAnisotropyChanged();
void comparisonFunctionChanged();
void comparisonModeChanged();
void maximumLayersChanged();
void uniqueChanged();
protected:
explicit QAbstractTextureProvider(Qt3DCore::QNode *parent = 0);
explicit QAbstractTextureProvider(Target target, Qt3DCore::QNode *parent = 0);
QAbstractTextureProvider(QAbstractTextureProviderPrivate &dd, Qt3DCore::QNode *parent = 0);
void copy(const Qt3DCore::QNode *ref) Q_DECL_OVERRIDE;
void setStatus(Status status);
private:
Q_DECLARE_PRIVATE(QAbstractTextureProvider)
QT3D_CLONEABLE(QAbstractTextureProvider)
};
} // namespace Qt3DRender
QT_END_NAMESPACE
#endif // QT3DRENDER_QABSTRACTTEXTUREPROVIDER_H
|
