QAbstractTexture¶
- PyQt5.Qt3DRender.QAbstractTexture
Inherits from QNode.
Inherited by QSharedGLTexture, QTexture1D, QTexture1DArray, QTexture2D, QTexture2DArray, QTexture2DMultisample, QTexture2DMultisampleArray, QTexture3D, QTextureBuffer, QTextureCubeMap, QTextureCubeMapArray, QTextureLoader, QTextureRectangle.
Description¶
A base class to be used to provide textures.
The QAbstractTexture class shouldn’t be used directly but rather through one of its subclasses. Each subclass implements a given texture target (2D, 2DArray, 3D, CubeMap …) Each subclass provides a set of functors for each layer, cube map face and mipmap level. In turn the backend uses those functor to properly fill a corresponding OpenGL texture with data.
Enums¶
- ComparisonFunction
TODO
Member
Value
Description
CommpareNotEqual TODO
TODO
CompareAlways TODO
TODO
CompareEqual TODO
TODO
CompareGreater TODO
TODO
CompareGreaterEqual TODO
TODO
CompareLess TODO
TODO
CompareLessEqual TODO
TODO
CompareNever TODO
TODO
- ComparisonMode
TODO
Member
Value
Description
CompareNone TODO
TODO
CompareRefToTexture TODO
TODO
- CubeMapFace
This enum identifies the faces of a cube map texture
Note: should only be used when a behavior needs to be applied to all the faces of a cubemap. This is the case for example when using a cube map as a texture attachment. Using in the attachment specfication would result in all faces being bound to the attachment point. On the other hand, if a specific face is specified, the attachment would only be using the specified face.
Member
Value
Description
AllFaces 0x851b
Specify all the faces of a cube map
CubeMapNegativeX 0x8516
Specify the negative X face of a cube map
CubeMapNegativeY 0x8518
Specify the negative Y face of a cube map
CubeMapNegativeZ 0x851A
Specify the negative Z face of a cube map
CubeMapPositiveX 0x8515
Specify the positive X face of a cube map
CubeMapPositiveY 0x8517
Specify the positive Y face of a cube map
CubeMapPositiveZ 0x8519
Specify the positive Z face of a cube map
- Filter
Holds the filter type of the texture provider.
Member
Value
Description
Linear 0x2601
GL_LINEAR
LinearMipMapLinear 0x2703
GL_LINEAR_MIPMAP_LINEAR
LinearMipMapNearest 0x2701
GL_LINEAR_MIPMAP_NEAREST
Nearest 0x2600
GL_NEAREST
NearestMipMapLinear 0x2702
GL_NEAREST_MIPMAP_LINEAR
NearestMipMapNearest 0x2700
GL_NEAREST_MIPMAP_NEAREST
- HandleType
TODO
Member
Value
Description
NoHandle TODO
TODO
OpenGLTextureId TODO
TODO
- Status
Contains the status of the texture provider.
Member
Value
Description
Error TODO
TODO
Loading TODO
TODO
None TODO
TODO
Ready TODO
TODO
- Target
Member
Value
Description
Target1D 0x0DE0
GL_TEXTURE_1D
Target1DArray 0x8C18
GL_TEXTURE_1D_ARRAY
Target2D 0x0DE1
GL_TEXTURE_2D
Target2DArray 0x8C1A
GL_TEXTURE_2D_ARRAY
Target2DMultisample 0x9100
GL_TEXTURE_2D_MULTISAMPLE
Target2DMultisampleArray 0x9102
GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Target3D 0x806F
GL_TEXTURE_3D
TargetAutomatic 0
Target will be determined by the Qt3D engine
TargetBuffer 0x8C2A
GL_TEXTURE_BUFFER
TargetCubeMap 0x8513
GL_TEXTURE_CUBE_MAP
TargetCubeMapArray 0x9009
GL_TEXTURE_CUBE_MAP_ARRAY
TargetRectangle 0x84F5
GL_TEXTURE_RECTANGLE
- TextureFormat
This list describes all possible texture formats
Member
Value
Description
AlphaFormat 0x1906
GL_ALPHA
Automatic 1
automatically_determines_format
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
DepthFormat 0x1902
GL_DEPTH_COMPONENT
LuminanceAlphaFormat 0x190A
0x190A
LuminanceFormat 0x1909
GL_LUMINANCE
NoFormat 0
GL_NONE
R11_EAC_SNorm 0x9271
GL_COMPRESSED_SIGNED_R11_EAC
R11_EAC_UNorm 0x9270
GL_COMPRESSED_R11_EAC
R16_SNorm 0x8F98
GL_R16_SNORM
R16_UNorm 0x822A
GL_R16
R16F 0x822D
GL_R16F
R16I 0x8233
GL_R16I
R16U 0x8234
GL_R16UI
R32F 0x822E
GL_R32F
R32I 0x8235
GL_R32I
R32U 0x8236
GL_R32UI
R5G6B5 0x8D62
GL_RGB565
R8_SNorm 0x8F94
GL_R8_SNORM
R8_UNorm 0x8229
GL_R8
R8I 0x8231
GL_R8I
R8U 0x8232
GL_R8UI
R_ATI1N_SNorm 0x8DBC
GL_COMPRESSED_SIGNED_RED_RGTC1
R_ATI1N_UNorm 0x8DBB
GL_COMPRESSED_RED_RGTC1
RG11_EAC_SNorm 0x9273
GL_COMPRESSED_SIGNED_RG11_EAC
RG11_EAC_UNorm 0x9272
GL_COMPRESSED_RG11_EAC
RG11B10F 0x8C3A
GL_R11F_G11F_B10F
RG16_SNorm 0x8F99
GL_RG16_SNORM
RG16_UNorm 0x822C
GL_RG16
RG16F 0x822F
GL_RG16F
RG16I 0x8239
GL_RG16I
RG16U 0x823A
GL_RG16UI
RG32F 0x8230
GL_RG32F
RG32I 0x823B
GL_RG32I
RG32U 0x823C
GL_RG32UI
RG3B2 0x2A10
GL_R3_G3_B2
RG8_SNorm 0x8F95
GL_RG8_SNORM
RG8_UNorm 0x822B
GL_RG8
RG8I 0x8237
GL_RG8I
RG8U 0x8238
GL_RG8UI
RG_ATI2N_SNorm 0x8DBE
GL_COMPRESSED_SIGNED_RG_RGTC2
RG_ATI2N_UNorm 0x8DBD
GL_COMPRESSED_RG_RGTC2
RGB10A2 0x906F
GL_RGB10_A2UI
RGB10A2U TODO
TODO
RGB16_SNorm 0x8F9A
GL_RGB16_SNORM
RGB16_UNorm 0x8054
GL_RGB16
RGB16F 0x881B
GL_RGB16F
RGB16I 0x8D89
GL_RGB16I
RGB16U 0x8D77
GL_RGB16UI
RGB32F 0x8815
GL_RGB32F
RGB32I 0x8D83
GL_RGB32I
RGB32U 0x8D71
GL_RGB32UI
RGB5A1 0x8057
GL_RGB5_A1
RGB8_ETC1 0x8D64
GL_ETC1_RGB8_OES
RGB8_ETC2 0x9274
GL_COMPRESSED_RGB8_ETC2
RGB8_PunchThrough_Alpha1_ETC2 0x9276
GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
RGB8_SNorm 0x8F96
GL_RGB8_SNORM
RGB8_UNorm 0x8051
GL_RGB8
RGB8I 0x8D8F
GL_RGB8I
RGB8U 0x8D7D
GL_RGB8UI
RGB9E5 0x8C3D
GL_RGB9_E5
RGB_BP_SIGNED_FLOAT 0x8E8E
GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB
RGB_BP_UNorm 0x8E8C
GL_COMPRESSED_RGBA_BPTC_UNORM_ARB
RGB_BP_UNSIGNED_FLOAT 0x8E8F
GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB
RGB_DXT1 0x83F0
GL_COMPRESSED_RGB_S3TC_DXT1_EXT
RGBA16_SNorm 0x8F9B
GL_RGBA16_SNORM
RGBA16_UNorm 0x805B
GL_RGBA16
RGBA16F 0x881A
GL_RGBA16F
RGBA16I 0x8D88
GL_RGBA16I
RGBA16U 0x8D76
GL_RGBA16UI
RGBA32F 0x8814
GL_RGBA32F
RGBA32I 0x8D82
GL_RGBA32I
RGBA32U 0x8D70
GL_RGBA32UI
RGBA4 0x8056
GL_RGBA4
RGBA8_ETC2_EAC 0x9278
GL_COMPRESSED_RGBA8_ETC2_EAC
RGBA8_SNorm 0x8F97
GL_RGBA8_SNORM
RGBA8_UNorm 0x8058
GL_RGBA8
RGBA8I 0x8D8E
GL_RGBA8I
RGBA8U 0x8D7C
GL_RGBA8UI
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
RGBAFormat 0x1908
GL_RGBA
RGBFormat 0x1907
GL_RGB
SRGB8 0x8C41
GL_SRGB8
SRGB8_Alpha8 0x8C43
GL_SRGB8_ALPHA8
SRGB8_Alpha8_ETC2_EAC 0x9279
GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
SRGB8_ETC2 0x9275
GL_COMPRESSED_SRGB8_ETC2
SRGB8_PunchThrough_Alpha1_ETC2 0x9277
GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
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
SRGB_DXT1 0x8C4C
GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
Methods¶
- __init__(parent: QNode = None)
The constructor creates a new QAbstractTexture::QAbstractTexture instance with the specified parent.
- __init__(Target, parent: QNode = None)
The constructor creates a new QAbstractTexture::QAbstractTexture instance with the specified target and parent.
- addTextureImage(QAbstractTextureImage)
Adds a new Qt3DCore::QAbstractTextureImage textureImage to the texture provider.
Note: QAbstractTextureImage should never be shared between multiple QAbstractTexture instances.
- comparisonFunction() → ComparisonFunction
Returns the current comparison function.
See also
- comparisonMode() → ComparisonMode
Returns the current comparison mode.
See also
- dataGenerator() → QTextureGenerator
Returns the current data generator.
- depth() → int
Returns the depth of the texture
See also
- format() → TextureFormat
Returns the texture provider’s format.
See also
- generateMipMaps() → bool
See also
- handle() → Any
TODO
- handleType() → HandleType
TODO
- height() → int
Returns the height of the texture
See also
- layers() → int
Returns the maximum number of layers for the texture provider.
Note: this has a meaning only for texture providers that have 3D or array target formats.
See also
- magnificationFilter() → Filter
See also
- maximumAnisotropy() → float
Returns the current maximum anisotropy
See also
- minificationFilter() → Filter
See also
- removeTextureImage(QAbstractTextureImage)
Removes a Qt3DCore::QAbstractTextureImage textureImage from the texture provider.
- samples() → int
Returns the number of samples per texel for the texture provider.
Note: this has a meaning only for texture providers that have multisample formats.
See also
- sceneChangeEvent(QSceneChange)
TODO
- setComparisonFunction(ComparisonFunction)
Set the comparison function to function.
See also
- setComparisonMode(ComparisonMode)
Set the comparison mode to mode.
See also
- setDepth(int)
Set the depth of the texture to depth.
See also
- setFormat(TextureFormat)
Set the texture format to format.
See also
- setGenerateMipMaps(bool)
Boolean parameter gen sets a flag indicating whether the texture provider should generate mipmaps or not.
See also
- setHeight(int)
Set the height to height.
See also
- setLayers(int)
Set the maximum layer count to layers.
See also
- setMagnificationFilter(Filter)
Set the magnification filter to f.
See also
- setMaximumAnisotropy(float)
Sets the maximum anisotropy to anisotropy.
See also
- setMinificationFilter(Filter)
Set the minification filter to the specified value f.
See also
- setSamples(int)
Set the number of samples per texel to samples.
See also
- setSize(int, height: int = 1, depth: int = 1)
Sets the size of the texture provider to width w, height h and depth d.
- setWidth(int)
Set the width of the texture provider to width.
See also
- setWrapMode(QTextureWrapMode)
Set the wrapmode to the value specified in wrapMode.
See also
- status() → Status
Returns the current status of the texture provider.
See also
- target() → Target
Returns the target format of the texture provider.
- textureImages() → List[QAbstractTextureImage]
Returns a list of pointers to QAbstractTextureImage objects contained in the texture provider.
- updateData(QTextureDataUpdate)
TODO
- width() → int
Returns the width of the texture
See also
- wrapMode() → QTextureWrapMode
See also
Signals¶
- comparisonFunctionChanged(ComparisonFunction)
TODO
- comparisonModeChanged(ComparisonMode)
TODO
- depthChanged(int)
TODO
- formatChanged(TextureFormat)
TODO
- generateMipMapsChanged(bool)
TODO
- handleChanged(Any)
TODO
- handleTypeChanged(HandleType)
TODO
- heightChanged(int)
TODO
- layersChanged(int)
TODO
- magnificationFilterChanged(Filter)
TODO
- maximumAnisotropyChanged(float)
TODO
- minificationFilterChanged(Filter)
TODO
- samplesChanged(int)
TODO
- statusChanged(Status)
TODO
- widthChanged(int)
TODO
