Skip to content

PythonQt.Qt.QOpenGLTexture

QOpenGLTexture

PythonQtInstanceWrapper object

Native bases: PythonQtInstanceWrapper

Supplemental documentation: Qt 5 reference:

Detailed Description

QOpenGLTexture makes it easy to work with OpenGL textures and the myriad features and targets that they offer depending upon the capabilities of your OpenGL implementation.

The typical usage pattern for QOpenGLTexture is

  • Instantiate the object specifying the texture target type
  • Set properties that affect the storage requirements e.g. storage format, dimensions
  • Allocate the server-side storage
  • Optionally upload pixel data
  • Optionally set any additional properties e.g. filtering and border options
  • Render with texture or render to texture

In the common case of simply using a QImage as the source of texture pixel data most of the above steps are performed automatically.

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).mirrored());
texture->setMinificationFilter(QOpenGLTexture::LinearMipMapLinear);
texture->setMagnificationFilter(QOpenGLTexture::Linear);
...
// Render with texture
texture->bind();
glDrawArrays(...);

Note that the QImage is mirrored vertically to account for the fact that OpenGL and QImage use opposite directions for the y axis. Another option would be to transform your texture coordinates.

Source: https://doc.qt.io/archives/qt-5.15/qopengltexture.html

Complete member index

Every captured member retains its own identity. Identical captured declaration text is linked once; this does not establish native inheritance or interchangeable objects.

Member Kind Signature Summary
Alpha attribute Any (shared captured text)
AlphaFormat attribute Any (shared captured text)
AlphaValue attribute Any (shared captured text)
AnisotropicFiltering attribute Any (shared captured text)
BGR attribute Any (shared captured text)
BGRA attribute Any (shared captured text)
BGRA_Integer attribute Any (shared captured text)
BGR_Integer attribute Any (shared captured text)
BindingTarget attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
BindingTarget1D attribute Any (shared captured text)
BindingTarget1DArray attribute Any (shared captured text)
BindingTarget2D attribute Any (shared captured text)
BindingTarget2DArray attribute Any (shared captured text)
BindingTarget2DMultisample attribute Any (shared captured text)
BindingTarget2DMultisampleArray attribute Any (shared captured text)
BindingTarget3D attribute Any (shared captured text)
BindingTargetBuffer attribute Any (shared captured text)
BindingTargetCubeMap attribute Any (shared captured text)
BindingTargetCubeMapArray attribute Any (shared captured text)
BindingTargetRectangle attribute Any (shared captured text)
BlueValue attribute Any (shared captured text)
ClampToBorder attribute Any (shared captured text)
ClampToEdge attribute Any (shared captured text)
CommpareNotEqual attribute Any (shared captured text)
CompareAlways attribute Any (shared captured text)
CompareEqual attribute Any (shared captured text)
CompareGreater attribute Any (shared captured text)
CompareGreaterEqual attribute Any (shared captured text)
CompareLess attribute Any (shared captured text)
CompareLessEqual attribute Any (shared captured text)
CompareNever attribute Any (shared captured text)
CompareNone attribute Any (shared captured text)
CompareRefToTexture attribute Any (shared captured text)
ComparisonFunction attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
ComparisonMode attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
CoordinateDirection attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
CubeMapFace attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
CubeMapNegativeX attribute Any (shared captured text)
CubeMapNegativeY attribute Any (shared captured text)
CubeMapNegativeZ attribute Any (shared captured text)
CubeMapPositiveX attribute Any (shared captured text)
CubeMapPositiveY attribute Any (shared captured text)
CubeMapPositiveZ attribute Any (shared captured text)
D16 attribute Any (shared captured text)
D24 attribute Any (shared captured text)
D24S8 attribute Any (shared captured text)
D32 attribute Any (shared captured text)
D32F attribute Any (shared captured text)
D32FS8X24 attribute Any (shared captured text)
Depth attribute Any (shared captured text)
DepthFormat attribute Any (shared captured text)
DepthMode attribute Any (shared captured text)
DepthStencil attribute Any (shared captured text)
DepthStencilMode attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
DirectionR attribute Any (shared captured text)
DirectionS attribute Any (shared captured text)
DirectionT attribute Any (shared captured text)
DontGenerateMipMaps attribute Any (shared captured text)
DontResetTextureUnit attribute Any (shared captured text)
Feature attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
Features attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
Filter attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
Float16 attribute Any (shared captured text)
Float16OES attribute Any (shared captured text)
Float32 attribute Any (shared captured text)
Float32_D32_UInt32_S8_X24 attribute Any (shared captured text)
FormatClass_128Bit attribute Any (shared captured text)
FormatClass_16Bit attribute Any (shared captured text)
FormatClass_24Bit attribute Any (shared captured text)
FormatClass_32Bit attribute Any (shared captured text)
FormatClass_48Bit attribute Any (shared captured text)
FormatClass_64Bit attribute Any (shared captured text)
FormatClass_8Bit attribute Any (shared captured text)
FormatClass_96Bit attribute Any (shared captured text)
FormatClass_BPTC_Float attribute Any (shared captured text)
FormatClass_BPTC_Unorm attribute Any (shared captured text)
FormatClass_RGTC1_R attribute Any (shared captured text)
FormatClass_RGTC2_RG attribute Any (shared captured text)
FormatClass_S3TC_DXT1_RGB attribute Any (shared captured text)
FormatClass_S3TC_DXT1_RGBA attribute Any (shared captured text)
FormatClass_S3TC_DXT3_RGBA attribute Any (shared captured text)
FormatClass_S3TC_DXT5_RGBA attribute Any (shared captured text)
FormatClass_Unique attribute Any (shared captured text)
GenerateMipMaps attribute Any (shared captured text)
GreenValue attribute Any (shared captured text)
ImmutableMultisampleStorage attribute Any (shared captured text)
ImmutableStorage attribute Any (shared captured text)
Int16 attribute Any (shared captured text)
Int32 attribute Any (shared captured text)
Int8 attribute Any (shared captured text)
Linear attribute Any (shared captured text)
LinearMipMapLinear attribute Any (shared captured text)
LinearMipMapNearest attribute Any (shared captured text)
Luminance attribute Any (shared captured text)
LuminanceAlpha attribute Any (shared captured text)
LuminanceAlphaFormat attribute Any (shared captured text)
LuminanceFormat attribute Any (shared captured text)
MaxFeatureFlag attribute Any (shared captured text)
MipMapGeneration attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
MirroredRepeat attribute Any (shared captured text)
NPOTTextureRepeat attribute Any (shared captured text)
NPOTTextures attribute Any (shared captured text)
Nearest attribute Any (shared captured text)
NearestMipMapLinear attribute Any (shared captured text)
NearestMipMapNearest attribute Any (shared captured text)
NoFormat attribute Any (shared captured text)
NoFormatClass attribute Any (shared captured text)
NoPixelType attribute Any (shared captured text)
NoSourceFormat attribute Any (shared captured text)
OneValue attribute Any (shared captured text)
PixelFormat attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
PixelType attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
R11_EAC_SNorm attribute Any (shared captured text)
R11_EAC_UNorm attribute Any (shared captured text)
R16F attribute Any (shared captured text)
R16I attribute Any (shared captured text)
R16U attribute Any (shared captured text)
R16_SNorm attribute Any (shared captured text)
R16_UNorm attribute Any (shared captured text)
R32F attribute Any (shared captured text)
R32I attribute Any (shared captured text)
R32U attribute Any (shared captured text)
R5G6B5 attribute Any (shared captured text)
R8I attribute Any (shared captured text)
R8U attribute Any (shared captured text)
R8_SNorm attribute Any (shared captured text)
R8_UNorm attribute Any (shared captured text)
RG attribute Any (shared captured text)
RG11B10F attribute Any (shared captured text)
RG11_EAC_SNorm attribute Any (shared captured text)
RG11_EAC_UNorm attribute Any (shared captured text)
RG16F attribute Any (shared captured text)
RG16I attribute Any (shared captured text)
RG16U attribute Any (shared captured text)
RG16_SNorm attribute Any (shared captured text)
RG16_UNorm attribute Any (shared captured text)
RG32F attribute Any (shared captured text)
RG32I attribute Any (shared captured text)
RG32U attribute Any (shared captured text)
RG3B2 attribute Any (shared captured text)
RG8I attribute Any (shared captured text)
RG8U attribute Any (shared captured text)
RG8_SNorm attribute Any (shared captured text)
RG8_UNorm attribute Any (shared captured text)
RGB attribute Any (shared captured text)
RGB10A2 attribute Any (shared captured text)
RGB16F attribute Any (shared captured text)
RGB16I attribute Any (shared captured text)
RGB16U attribute Any (shared captured text)
RGB16_SNorm attribute Any (shared captured text)
RGB16_UNorm attribute Any (shared captured text)
RGB32F attribute Any (shared captured text)
RGB32I attribute Any (shared captured text)
RGB32U attribute Any (shared captured text)
RGB5A1 attribute Any (shared captured text)
RGB8I attribute Any (shared captured text)
RGB8U attribute Any (shared captured text)
RGB8_ETC1 attribute Any (shared captured text)
RGB8_ETC2 attribute Any (shared captured text)
RGB8_PunchThrough_Alpha1_ETC2 attribute Any (shared captured text)
RGB8_SNorm attribute Any (shared captured text)
RGB8_UNorm attribute Any (shared captured text)
RGB9E5 attribute Any (shared captured text)
RGBA attribute Any (shared captured text)
RGBA16F attribute Any (shared captured text)
RGBA16I attribute Any (shared captured text)
RGBA16U attribute Any (shared captured text)
RGBA16_SNorm attribute Any (shared captured text)
RGBA16_UNorm attribute Any (shared captured text)
RGBA32F attribute Any (shared captured text)
RGBA32I attribute Any (shared captured text)
RGBA32U attribute Any (shared captured text)
RGBA4 attribute Any (shared captured text)
RGBA8I attribute Any (shared captured text)
RGBA8U attribute Any (shared captured text)
RGBA8_ETC2_EAC attribute Any (shared captured text)
RGBA8_SNorm attribute Any (shared captured text)
RGBA8_UNorm attribute Any (shared captured text)
RGBAFormat attribute Any (shared captured text)
RGBA_DXT1 attribute Any (shared captured text)
RGBA_DXT3 attribute Any (shared captured text)
RGBA_DXT5 attribute Any (shared captured text)
RGBA_Integer attribute Any (shared captured text)
RGBFormat attribute Any (shared captured text)
RGB_BP_SIGNED_FLOAT attribute Any (shared captured text)
RGB_BP_UNSIGNED_FLOAT attribute Any (shared captured text)
RGB_BP_UNorm attribute Any (shared captured text)
RGB_DXT1 attribute Any (shared captured text)
RGB_Integer attribute Any (shared captured text)
RG_ATI2N_SNorm attribute Any (shared captured text)
RG_ATI2N_UNorm attribute Any (shared captured text)
RG_Integer attribute Any (shared captured text)
R_ATI1N_SNorm attribute Any (shared captured text)
R_ATI1N_UNorm attribute Any (shared captured text)
Red attribute Any (shared captured text)
RedValue attribute Any (shared captured text)
Red_Integer attribute Any (shared captured text)
Repeat attribute Any (shared captured text)
ResetTextureUnit attribute Any (shared captured text)
S8 attribute Any (shared captured text)
SRGB8 attribute Any (shared captured text)
SRGB8_Alpha8 attribute Any (shared captured text)
SRGB8_Alpha8_ETC2_EAC attribute Any (shared captured text)
SRGB8_ETC2 attribute Any (shared captured text)
SRGB8_PunchThrough_Alpha1_ETC2 attribute Any (shared captured text)
SRGB_Alpha_DXT1 attribute Any (shared captured text)
SRGB_Alpha_DXT3 attribute Any (shared captured text)
SRGB_Alpha_DXT5 attribute Any (shared captured text)
SRGB_BP_UNorm attribute Any (shared captured text)
SRGB_DXT1 attribute Any (shared captured text)
Stencil attribute Any (shared captured text)
StencilMode attribute Any (shared captured text)
StencilTexturing attribute Any (shared captured text)
Swizzle attribute Any (shared captured text)
SwizzleAlpha attribute Any (shared captured text)
SwizzleBlue attribute Any (shared captured text)
SwizzleComponent attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
SwizzleGreen attribute Any (shared captured text)
SwizzleRed attribute Any (shared captured text)
SwizzleValue attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
Target attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
Target1D attribute Any (shared captured text)
Target1DArray attribute Any (shared captured text)
Target2D attribute Any (shared captured text)
Target2DArray attribute Any (shared captured text)
Target2DMultisample attribute Any (shared captured text)
Target2DMultisampleArray attribute Any (shared captured text)
Target3D attribute Any (shared captured text)
TargetBuffer attribute Any (shared captured text)
TargetCubeMap attribute Any (shared captured text)
TargetCubeMapArray attribute Any (shared captured text)
TargetRectangle attribute Any (shared captured text)
Texture1D attribute Any (shared captured text)
Texture3D attribute Any (shared captured text)
TextureArrays attribute Any (shared captured text)
TextureBuffer attribute Any (shared captured text)
TextureComparisonOperators attribute Any (shared captured text)
TextureCubeMapArrays attribute Any (shared captured text)
TextureFormat attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
TextureFormatClass attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
TextureMipMapLevel attribute Any (shared captured text)
TextureMultisample attribute Any (shared captured text)
TextureRectangle attribute Any (shared captured text)
TextureUnitReset attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
UInt16 attribute Any (shared captured text)
UInt16_R5G6B5 attribute Any (shared captured text)
UInt16_R5G6B5_Rev attribute Any (shared captured text)
UInt16_RGB5A1 attribute Any (shared captured text)
UInt16_RGB5A1_Rev attribute Any (shared captured text)
UInt16_RGBA4 attribute Any (shared captured text)
UInt16_RGBA4_Rev attribute Any (shared captured text)
UInt32 attribute Any (shared captured text)
UInt32_D24S8 attribute Any (shared captured text)
UInt32_RG11B10F attribute Any (shared captured text)
UInt32_RGB10A2 attribute Any (shared captured text)
UInt32_RGB10A2_Rev attribute Any (shared captured text)
UInt32_RGB9_E5 attribute Any (shared captured text)
UInt32_RGBA8 attribute Any (shared captured text)
UInt32_RGBA8_Rev attribute Any (shared captured text)
UInt8 attribute Any (shared captured text)
UInt8_RG3B2 attribute Any (shared captured text)
UInt8_RG3B2_Rev attribute Any (shared captured text)
WrapMode attribute type Convert a number or string to an integer, or return 0 if no arguments are given. (shared captured text)
ZeroValue attribute Any (shared captured text)
__init__ function (self, *args: Any, **kwargs: Any) -> None Native constructor; consult class documentation for supported overloads. (shared captured text)
allocateStorage function (self, pixelFormat: Any, pixelType: Any) -> None X.allocateStorage(pixelFormat, pixelType) (shared captured text)
bind function (self, unit: Any, reset: Any) -> None X.bind(unit, reset) (shared captured text)
borderColor function (self, border: Any) -> Any X.borderColor(border) -> PythonQt.QtGui.QColor (shared captured text)
boundTextureId function (self, unit: Any, target: Any) -> int X.boundTextureId(unit, target) -> int (shared captured text)
className function (self, *args: Any, **kwargs: Any) -> Any Return the classname of the object (shared captured text)
comparisonFunction function (self) -> Any Returns the texture comparison operator set on this texture. (shared captured text)
comparisonMode function (self) -> Any Returns the texture comparison mode set on this texture. (shared captured text)
create function (self) -> bool X.create() -> bool (shared captured text)
createTextureView function (self, target: Any, viewFormat: Any, minimumMipmapLevel: int, maximumMipmapLevel: int, minimumLayer: int, max… X.createTextureView(target, viewFormat, minimumMipmapLevel, maximumMipmapLevel, minimumLayer, maximumLayer) -> PythonQt.QtGui.QOpenGLTexture (shared captured text)
delete function (self, *args: Any, **kwargs: Any) -> Any Deletes the C++ object (at your own risk, my friend!) (shared captured text)
depth function (self) -> int X.depth() -> int (shared captured text)
depthStencilMode function (self) -> Any Returns the depth stencil mode for textures using a combined depth/stencil format. (shared captured text)
destroy function (self) -> None Destroys the underlying OpenGL texture object. (shared captured text)
faces function (self) -> int X.faces() -> int (shared captured text)
format function (self) -> Any Returns the format of this texture object. (shared captured text)
generateMipMaps function (self, baseLevel: Any, resetBaseLevel: Any) -> None X.generateMipMaps(baseLevel, resetBaseLevel) (shared captured text)
hasFeature function (self, feature: Any) -> bool X.hasFeature(feature) -> bool (shared captured text)
height function (self) -> int X.height() -> int (shared captured text)
help function (self, *args: Any, **kwargs: Any) -> Any Shows the help of available methods for this class (shared captured text)
inherits function (self, *args: Any, **kwargs: Any) -> Any Returns if the class inherits or is of given type name (shared captured text)
isAutoMipMapGenerationEnabled function (self) -> bool X.isAutoMipMapGenerationEnabled() -> bool (shared captured text)
isBound function (self, unit: Any) -> bool X.isBound(unit) -> bool (shared captured text)
isCreated function (self) -> bool X.isCreated() -> bool (shared captured text)
isFixedSamplePositions function (self) -> bool X.isFixedSamplePositions() -> bool (shared captured text)
isStorageAllocated function (self) -> bool X.isStorageAllocated() -> bool (shared captured text)
isTextureView function (self) -> bool X.isTextureView() -> bool (shared captured text)
layers function (self) -> int X.layers() -> int (shared captured text)
levelOfDetailRange function (self) -> Any Returns the minimum and maximum level of detail parameters. (shared captured text)
levelofDetailBias function (self) -> float X.levelofDetailBias() -> float (shared captured text)
magnificationFilter function (self) -> Any Returns the magnification filter. (shared captured text)
maximumAnisotropy function (self) -> float X.maximumAnisotropy() -> float (shared captured text)
maximumLevelOfDetail function (self) -> float X.maximumLevelOfDetail() -> float (shared captured text)
maximumMipLevels function (self) -> int X.maximumMipLevels() -> int (shared captured text)
minMagFilters function (self) -> Any Returns the current minification and magnification filters. (shared captured text)
minificationFilter function (self) -> Any Returns the minification filter. (shared captured text)
minimumLevelOfDetail function (self) -> float X.minimumLevelOfDetail() -> float (shared captured text)
mipBaseLevel function (self) -> int X.mipBaseLevel() -> int (shared captured text)
mipLevelRange function (self) -> Any Returns the range of mipmap levels that can be used for texture lookups with this texture. (shared captured text)
mipLevels function (self) -> int X.mipLevels() -> int (shared captured text)
mipMaxLevel function (self) -> int X.mipMaxLevel() -> int (shared captured text)
release function (self, unit: Any, reset: Any) -> None X.release(unit, reset) (shared captured text)
samples function (self) -> int X.samples() -> int (shared captured text)
setAutoMipMapGenerationEnabled function (self, enabled: bool) -> None If enabled is true, enables automatic mipmap generation for this texture object to occur whenever the level 0 mipmap data is set via… (shared captured text)
setBorderColor function (self, r: Any, g: Any, b: Any, a: Any) -> None X.setBorderColor(r, g, b, a) (shared captured text)
setComparisonFunction function (self, function: Any) -> None Sets the texture comparison function on this texture to function. (shared captured text)
setComparisonMode function (self, mode: Any) -> None Sets the texture comparison mode on this texture to mode. (shared captured text)
setData function (self, image: Any, genMipMaps: Any) -> None X.setData(image, genMipMaps) (shared captured text)
setDepthStencilMode function (self, mode: Any) -> None If using a texture that has a combined depth/stencil format this function sets which component of the texture is accessed to mode. (shared captured text)
setFixedSamplePositions function (self, fixed: bool) -> None Sets whether the sample positions and number of samples used with a multisample capable texture target to fixed. (shared captured text)
setFormat function (self, format: Any) -> None Sets the format of this texture object to format. (shared captured text)
setLayers function (self, layers: int) -> None Sets the number of array layers to allocate storage for. (shared captured text)
setLevelOfDetailRange function (self, min: float, max: float) -> None X.setLevelOfDetailRange(min, max) (shared captured text)
setLevelofDetailBias function (self, bias: float) -> None Sets the level of detail bias to bias. (shared captured text)
setMagnificationFilter function (self, filter: Any) -> None Sets the magnification filter to filter. (shared captured text)
setMaximumAnisotropy function (self, anisotropy: float) -> None If your OpenGL implementation supports the GL_EXT_texture_filter_anisotropic extension this function sets the maximum anisotropy level to anisotropy. (shared captured text)
setMaximumLevelOfDetail function (self, value: float) -> None Sets the maximum level of detail to value. (shared captured text)
setMinMagFilters function (self, minificationFilter: Any, magnificationFilter: Any) -> None X.setMinMagFilters(minificationFilter, magnificationFilter) (shared captured text)
setMinificationFilter function (self, filter: Any) -> None Sets the filter used for minification to filter. (shared captured text)
setMinimumLevelOfDetail function (self, value: float) -> None Sets the minimum level of detail to value. (shared captured text)
setMipBaseLevel function (self, baseLevel: int) -> None Sets the base mipmap level used for all texture lookups with this texture to baseLevel. (shared captured text)
setMipLevelRange function (self, baseLevel: int, maxLevel: int) -> None X.setMipLevelRange(baseLevel, maxLevel) (shared captured text)
setMipLevels function (self, levels: int) -> None For texture targets that support mipmaps, this function sets the requested number of mipmap levels to allocate storage for. (shared captured text)
setMipMaxLevel function (self, maxLevel: int) -> None Sets the maximum mipmap level used for all texture lookups with this texture to maxLevel. (shared captured text)
setSamples function (self, samples: int) -> None Sets the number of samples to allocate storage for when rendering to a multisample capable texture target. (shared captured text)
setSize function (self, width: int, height: int, depth: int) -> None X.setSize(width, height, depth) (shared captured text)
setSwizzleMask function (self, r: Any, g: Any, b: Any, a: Any) -> None X.setSwizzleMask(r, g, b, a) (shared captured text)
setWrapMode function (self, direction: Any, mode: Any) -> None X.setWrapMode(direction, mode) (shared captured text)
swizzleMask function (self, component: Any) -> Any Returns the swizzle mask for texture component. (shared captured text)
target function (self) -> Any Returns the binding target of this texture. (shared captured text)
textureId function (self) -> int X.textureId() -> int (shared captured text)
width function (self) -> int X.width() -> int (shared captured text)
wrapMode function (self, direction: Any) -> Any Returns the wrap mode for the texture dimension direction. (shared captured text)