QOpenGLTexture 类

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

成员函数文档

[显式] QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

创建一个QOpenGLTexture对象，该对象可以稍后绑定到target。

这不会创建底层的OpenGL纹理对象。因此，使用此构造函数的构造不需要有效的当前OpenGL上下文。

[显式] QOpenGLTexture::QOpenGLTexture(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

创建一个QOpenGLTexture对象，该对象可以稍后绑定到2D纹理目标并包含image中包含的像素数据。如果希望生成一系列的mipmaps，则将genMipMaps设置为true（这是默认值）。

这会创建底层的OpenGL纹理对象。因此，需要使用有效的当前OpenGL上下文来构造此构造函数。

void QOpenGLTexture::allocateStorage()

为这个纹理对象分配服务器端存储，考虑格式、尺寸、mipmap级别、数组层和立方体贴图面。

一旦分配了存储后，就不再可能更改这些属性。

如果受支持，QOpenGLTexture会使用不可变纹理存储。

一旦为纹理分配了存储，就可以通过

另请参阅isStorageAllocated()和setData()。

void QOpenGLTexture::allocateStorage(QOpenGLTexture::PixelFormat pixelFormat, QOpenGLTexture::PixelType pixelType)

为这个纹理对象分配服务器端存储，考虑格式、尺寸、mipmap级别、数组层和立方体贴图面。

一旦分配了存储后，就不再可能更改这些属性。

如果支持 QOpenGLTexture，则将使用不可变纹理存储。但是，如果不可变纹理存储不可用，则将使用指定的 pixelFormat 和 pixelType 来分配可变存储；请注意，在某些 OpenGL 实现中（特别是，OpenGL ES 2）它们必须与传递给后续 setData() 调用的格式和类型完美匹配。

一旦为纹理分配了存储，就可以通过

另请参阅isStorageAllocated()和setData()。

void QOpenGLTexture::bind()

将此纹理绑定到当前活动的纹理单元以进行渲染。请注意，您不需要绑定 QOpenGLTexture 对象来修改它们，因为实现会在存在的情况下使用 EXT_direct_state_access 扩展，并在不存在的地方模拟它。

另请参阅 release。

void QOpenGLTexture::bind(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

将此纹理绑定到纹理单元 unit 以进行渲染。请注意，您不需要绑定 QOpenGLTexture 对象来修改它们，因为实现会在存在的情况下使用 EXT_direct_state_access 扩展，并在不存在的地方模拟它。

如果参数 reset 为 true，则此函数将恢复活动单元为入口时活动的纹理单元。

另请参阅 release。

QColor QOpenGLTexture::borderColor() const

返回此纹理的边框颜色。

另请参阅 setBorderColor。

void QOpenGLTexture::borderColor(float *border) const

将纹理边框颜色写入由 border 指向的数组的第一个四个元素中。

另请参阅 setBorderColor。

void QOpenGLTexture::borderColor(int *border) const

将纹理边框颜色写入由 border 指向的数组的第一个四个元素中。

这是一个重载函数。

void QOpenGLTexture::borderColor(unsigned int *border) const

将纹理边框颜色写入由 border 指向的数组的第一个四个元素中。

这是一个重载函数。

[静态] GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

返回绑定到当前活动纹理单元 target 的纹理的 textureId。

[静态] GLuint QOpenGLTexture::boundTextureId(uint unit, QOpenGLTexture::BindingTarget target)

返回绑定到纹理单元 unit 的 target 的纹理的 textureId。

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

返回设置在此纹理上的纹理比较操作符。默认情况下，纹理具有 CompareLessEqual 比较函数。

另请参阅 setComparisonFunction。

QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

返回在此纹理上设置的纹理比较模式。默认情况下，纹理具有CompareNone比较模式（即禁用比较）。

另请参阅setComparisonMode。

bool QOpenGLTexture::create()

创建底层OpenGL纹理对象。这需要当前的OpenGL有效上下文。如果纹理对象已经存在，此函数将不执行任何操作。

一旦纹理对象创建成功，您可以从textureId()函数获取对象名称。这可能是有用的，如果您希望对此纹理进行一些原始的OpenGL调用。

通常不需要直接调用此函数，因为所有设置纹理对象属性的功能都会在您的情况下隐式调用create()。

如果创建成功，则返回true，否则返回false。

另请参阅destroy ()，isCreated ()和textureId （）。

QOpenGLTexture *QOpenGLTexture::createTextureView(QOpenGLTexture::Target target，QOpenGLTexture::TextureFormat viewFormat，int minimumMipmapLevel，int maximumMipmapLevel，int minimumLayer，int maximumLayer) const

尝试在此纹理上创建一个纹理视图。纹理视图在某种程度上类似于SQL中的视图，因为它呈现了原始数据的有限或重新解释的视图。纹理视图不会在服务器端分配更多存储，而是依赖于源纹理的存储缓冲区。

纹理视图仅在使用不可变存储时可用。有关纹理视图的更多信息，请参阅http://www.opengl.org/wiki/Texture_Storage#Texture_views。

参数target指定用于视图的目标。可以使用某些目标，具体取决于原始目标的类型。例如，可以将Target1DArray纹理的视图指定为Target1DArray或Target1D，但对于后者，由最小层和最大层指定的数组层数必须正好为1。

对viewFormat也适用类似的约束。有关详细信息，请参阅上面的链接和规范。

参数minimumMipmapLevel，maximumMipmapLevel，minimumLayer和maximumLayer用于限制纹理视图可访问的纹理部分。

如果创建纹理视图失败，则此函数将返回0。如果函数成功，则返回对新QOpenGLTexture对象的指针，该对象从其isTextureView ()函数返回true。

另请参阅isTextureView ()。

int QOpenGLTexture::depth() const

返回3D纹理的深度。

另请参阅width ()，height ()和setSize ()。

QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

返回使用组合深度/模板格式的纹理的深度/模板模式。

另请参阅 setDepthStencilMode().

void QOpenGLTexture::destroy()

销毁底层的OpenGL纹理对象。这需要一个当前的、有效的OpenGL上下文。

另请参阅 create()，isCreated() 和 textureId().

int QOpenGLTexture::faces() const

返回此纹理的面的数量。对于立方体贴图和立方体贴图数组目标，这将为6。

对于非立方体贴图类型的目标，这将返回1。

QOpenGLTexture::TextureFormat QOpenGLTexture::format() const

返回此纹理对象的格式。

另请参阅 setFormat().

void QOpenGLTexture::generateMipMaps()

从mipmap级别0为纹理对象生成mipmap。如果您使用的是需要mipmap的纹理目标和建议，且已禁用自动mipmap生成，则需要调用此函数或重载该函数以创建mipmap链。

另请参阅 setAutoMipMapGenerationEnabled()，setMipLevels() 和 mipLevels().

void QOpenGLTexture::generateMipMaps(int baseLevel, bool resetBaseLevel = true)

从mipmap级别baseLevel为纹理对象生成mipmap。如果您使用的是需要mipmap的纹理目标和建议，且已禁用自动mipmap生成，则需要调用此函数或重载该函数以创建mipmap链。

通过将mipmap基础级别设置为baseLevel并生成mipmap链来达到以上baseLevel的mipmap生成。如果resetBaseLevel为true，则纹理的基础级别将重置为其之前的值。

另请参阅 setAutoMipMapGenerationEnabled()，setMipLevels() 和 mipLevels().

[静态] bool QOpenGLTexture::hasFeature(QOpenGLTexture::Feature feature)

如果您的OpenGL实现和版本支持纹理功能feature，则返回true。

int QOpenGLTexture::height() const

返回2D或3D纹理的高度。

另请参阅 width()，depth() 和 setSize().

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

返回是否启用了此纹理对象的自动mipmap生成。

另请参阅 setAutoMipMapGenerationEnabled() 和 generateMipMaps().

bool QOpenGLTexture::isBound() const

如果此纹理被绑定到当前活动纹理单元的相关目标，则返回true。

另请参阅 bind() 和 release().

bool QOpenGLTexture::isBound(uint unit)

如果此纹理已绑定到纹理单元 unit 的相应目标，则返回 true。

另请参阅 bind() 和 release().

bool QOpenGLTexture::isCreated() const

如果底层OpenGL纹理对象已被创建，则返回 true。

另请参阅 create()，destroy() 和 textureId。

bool QOpenGLTexture::isFixedSamplePositions() const

返回此纹理是否使用固定模式的多样本样本。如果尚未为此纹理分配存储空间，则此函数返回请求的固定样本位置设置。

对于不支持多采样的纹理目标，将返回 true。

另请参阅 setFixedSamplePositions() 和 isStorageAllocated。

bool QOpenGLTexture::isStorageAllocated() const

如果为该纹理分配了服务器端存储，则返回 true。

一旦分配了存储，就无法更改纹理格式、维度、多级渐远纹理级别和数组层。

另请参阅 allocateStorage，setSize，setMipLevels，setLayers 和 setFormat。

bool QOpenGLTexture::isTextureView() const

如果此纹理对象实际上是对其他纹理对象的视图，则返回 true。

另请参阅 createTextureView。

int QOpenGLTexture::layers() const

返回此纹理的数组层数。如果尚未为此纹理分配存储空间，则此函数返回请求的数组层数。

不支持数组层的纹理目标将返回 1。

另请参阅 setLayers 和 isStorageAllocated。

QPair<float, float> QOpenGLTexture::levelOfDetailRange() const

返回最小和最大细节级别参数。

另请参阅 setLevelOfDetailRange，minimumLevelOfDetail 和 maximumLevelOfDetail。

float QOpenGLTexture::levelofDetailBias() const

返回细节级别偏差参数。

另请参阅 setLevelofDetailBias。

QOpenGLTexture::Filter QOpenGLTexture::magnificationFilter() const

返回放大滤波器。

另请参阅setMagnificationFilter。

float QOpenGLTexture::maximumAnisotropy() const

返回在执行纹理查找时要考虑的最大各向异性级别。这需要GL_EXT_texture_filter_anisotropic扩展。

另请参阅setMaximumAnisotropy。

float QOpenGLTexture::maximumLevelOfDetail() const

返回最大细节级别参数。

另请参阅setMaximumLevelOfDetail、minimumLevelOfDetail 和 levelOfDetailRange。

int QOpenGLTexture::maximumMipLevels() const

返回给定当前尺寸情况下，此纹理可以具有的最大米普级别数量。

另请参阅setMipLevels、mipLevels 和 setSize。

QPair<QOpenGLTexture::Filter, QOpenGLTexture::Filter> QOpenGLTexture::minMagFilters() const

返回当前的最小化和放大过滤器。

另请参阅setMinMagFilters。

QOpenGLTexture::Filter QOpenGLTexture::minificationFilter() const

返回最小化过滤器。

另请参阅setMinificationFilter。

float QOpenGLTexture::minimumLevelOfDetail() const

返回最小细节级别参数。

另请参阅setMinimumLevelOfDetail、maximumLevelOfDetail 和 levelOfDetailRange。

int QOpenGLTexture::mipBaseLevel() const

返回用于所有使用此纹理的纹理查找的米普基本级别。默认值为0。

另请参阅setMipBaseLevel、mipMaxLevel 和 mipLevelRange。

QPair<int, int> QOpenGLTexture::mipLevelRange() const

返回可用于使用此纹理进行纹理查找的米プ级别范围。

另请参阅setMipLevelRange、mipBaseLevel 和 mipMaxLevel。

int QOpenGLTexture::mipLevels() const

返回此纹理的米普级别数。如果在存储未分配给此纹理之前，它返回请求的米普级别数。

另请参阅setMipLevels、maximumMipLevels 和 isStorageAllocated。

int QOpenGLTexture::mipMaxLevel() const

返回所有使用此纹理进行纹理查找的米普最大级别。

另请参阅setMipMaxLevel、mipBaseLevel 和 mipLevelRange。

void QOpenGLTexture::release()

从当前活动的纹理单元取消绑定这个纹理。

另请参阅 bind()。

void QOpenGLTexture::release(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

从纹理单元 unit 取消绑定这个纹理。

如果参数 reset 为 true，则此函数将恢复活动单元为入口时活动的纹理单元。

int QOpenGLTexture::samples() const

返回此纹理的多样本样本点数。如果尚未为该纹理分配存储空间，则此函数返回请求的样本数。

对于不支持多样本的纹理目标，此值将为 0。

另请参阅 setSamples() 和 isStorageAllocated()。

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

如果 enabled 为 true，则启用自动生成 mipmap，以便在通过 setData() 设置级别 0 mipmap 数据时触发。

默认情况下，自动 mipmap 生成已启用。

另请参阅 isAutoMipMapGenerationEnabled() 和 generateMipMaps()。

void QOpenGLTexture::setBorderColor(const QColor &color)

将纹理的边界颜色设置为 color。

另请参阅 borderColor()。

void QOpenGLTexture::setBorderColor(float r, float g, float b, float a)

将红色设置为 r，绿色设置为 g，蓝色设置为 b，并将 alpha 值设置为 a。

这是一个重载函数。

void QOpenGLTexture::setBorderColor(int r, int g, int b, int a)

将红色设置为 r，绿色设置为 g，蓝色设置为 b，并将 alpha 值设置为 a。

这是一个重载函数。

void QOpenGLTexture::setBorderColor(uint r, uint g, uint b, uint a)

将红色设置为 r，绿色设置为 g，蓝色设置为 b，并将 alpha 值设置为 a。

这是一个重载函数。

void QOpenGLTexture::setComparisonFunction(QOpenGLTexture::ComparisonFunction function)

将此纹理的纹理比较函数设置为 function。纹理比较函数在深度纹理采样时由阴影采样器使用。

另请参阅 comparisonFunction()。

void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

将此纹理的比较模式设置为mode。纹理比较模式在阴影采样器采样深度纹理时使用。

另请参阅comparisonMode。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

将压缩的像素数据上传到mipLevel、数组和cubeFace。可以使用options控制像素传输。参数dataSize应指定由data指向的数据的大小。

如果不使用压缩格式()，则应使用setData()而不是此函数。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

参数layerCount是指在此调用中上传/填充的纹理数组中层的数量。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setCompressedData(int mipLevel, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setCompressedData(int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

上传该纹理对象

mipLevel

、数组

layer

和

cubeFace

的像素数据。在上传像素数据之前，必须已分配存储空间。一些

setData()

的重载会在设置适当的维度、米级数和数组层后为您分配存储空间，如果它们有足够的信息这样做的话。这将在函数文档中注明。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

如果使用压缩的

format()

，则应使用

setCompressedData()

而不是此函数。

另请参阅 setCompressedData()。

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

参数layerCount是指在此调用中上传/填充的纹理数组中层的数量。

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setData(int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setData(QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

此重载用于更新纹理的一部分。参数xOffset、yOffset、zOffset指定纹理中的纹理元素偏移量。参数width、height和depth指定子图像的维度。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

void QOpenGLTexture::setData(int xCos, int yCos, int zCos, int width, int height, int depth, int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

此重载用于更新纹理的一部分。参数 xCos、yCos、zCos 指定纹理中的texel偏移量。参数 width、height 和 depth 指定子图像的尺寸。我们想要更新的子图像的mip级别通过 mipLevel 指定。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

void QOpenGLTexture::setData(int xCos, int yCos, int zCos, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

此重载用于更新纹理的一部分。参数 xCos、yCos、zCos 指定纹理中的texel偏移量。参数 width、height 和 depth 指定子图像的尺寸。我们想要更新的子图像的mip级别以及层通过 mipLevel 和 layer 指定。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

void QOpenGLTexture::setData(int xCos, int yCos, int zCos, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

此重载用于更新纹理的一部分。参数 xCos、yCos、zCos 指定纹理中的texel偏移量。参数 width、height 和 depth 指定子图像的尺寸。我们想要更新的子图像的mip级别、层和立方体贴图的面对通过 mipLevel、layer 和 face 指定。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, int layerCount, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

这是一个重载函数。

此重载用于更新纹理的一部分。参数 xOffset、yOffset、zOffset 指定纹理中的像素偏移量。参数 width、height 和 depth 指定子图像的尺寸。通过 mipLevel、layer、face 和 layerCount 指定要更新的子图像的 Mip 级别、起始层、立方体贴图面和层数。

由

data

指针指向的像素数据结构由

sourceFormat

和

sourceType

指定。像素数据上传可以选择由

options

控制。

void QOpenGLTexture::setData(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

setData() 的此重载会为您分配存储空间。像素数据包含在 image 中。默认情况下会生成 Mip 级别。将 genMipMaps 设置为 DontGenerateMipMaps 以关闭 Mip 级别生成。

这是一个重载函数。

void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::DepthStencilMode mode)

如果您使用的是具有深度/模板格式的纹理，此函数将设置 mode 通过该模式访问纹理的哪个组件。

当参数设置为 DepthMode 时，从着色器访问它将作为单个浮点数访问深度组件，与通常一样。但当参数设置为 StencilMode 时，着色器将访问模板组件。

另请参阅depthStencilMode。

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

设置是否使用带有多采样能力的目标纹理使用 fixed 样本位置和样本数。如果设置为 true，则样本位置和使用的样本数将适用于图像中的所有像素，并且不依赖于图像大小或内部格式。此函数应在为纹理分配存储之前调用。

对于不支持多采样的目标，此函数无效果。

默认值为 true。

另请参阅isFixedSamplePositions() 和 isStorageAllocated。

void QOpenGLTexture::setFormat(QOpenGLTexture::TextureFormat format)

将此纹理对象的格式设置为 format。在分配纹理存储之前必须调用此函数。

请注意，可能并非所有格式都受支持。支持的确切格式取决于您的OpenGL实现和版本。

另请参阅格式() 和 分配存储。

void QOpenGLTexture::setLayers(int layers)

设置分配存储的数组层数。在此函数调用存储分配给纹理之前，应调用此函数。

对于不支持数组层的目标，此函数无任何效果。

另请参阅layers() 和 isStorageAllocated。

void QOpenGLTexture::setLevelOfDetailRange(float min, float max)

将最小细节级别设置为 min 和最大细节级别设置为 max。

另请参阅levelOfDetailRange，setMinimumLevelOfDetail 和 setMaximumLevelOfDetail。

void QOpenGLTexture::setLevelofDetailBias(float bias)

将细节级别偏差设置为 bias。细节级别偏差影响米普贴图级别改变的位置。增加细节级别偏差可以使整体图像更加模糊或平滑。减少值可以使整体图像更加清晰。

另请参阅levelofDetailBias。

void QOpenGLTexture::setMagnificationFilter(QOpenGLTexture::Filter filter)

将放大滤镜设置为 filter。

另请参阅magnificationFilter，setMinificationFilter 和 setMinMagFilters。

void QOpenGLTexture::setMaximumAnisotropy(float anisotropy)

如果您的OpenGL实现支持GL_EXT_texture_filter_anisotropic扩展，则此函数将最大各向异性级别设置为 anisotropy。

另请参阅maximumAnisotropy。

void QOpenGLTexture::setMaximumLevelOfDetail(float value)

将最大细节级别设置为 value。这限制了最低分辨率米普贴图（最高米普贴图级别）的选择。默认值是1000。

另请参阅maximumLevelOfDetail，setMinimumLevelOfDetail 和 setLevelOfDetailRange。

void QOpenGLTexture::setMinMagFilters(QOpenGLTexture::Filter minificationFilter, QOpenGLTexture::Filter magnificationFilter)

将缩小滤镜设置为 minificationFilter 和放大滤镜设置为 magnificationFilter。

另请参阅 minMagFilters()，setMinificationFilter()和setMagnificationFilter()。

void QOpenGLTexture::setMinificationFilter(QOpenGLTexture::Filter filter)

将缩放过滤器设置為filter。

另请参阅 minificationFilter，setMagnificationFilter和setMinMagFilters。

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

将最小细节级别设置为value。这限制了最高分辨率的mipmap（最低mipmap级别）的选择。默认值是-1000。

另请参阅 minimumLevelOfDetail，setMaximumLevelOfDetail和setLevelOfDetailRange。

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

将用于所有具有此纹理的纹理查找的基mipmap级别设置為baseLevel。

另请参阅 mipBaseLevel，setMipMaxLevel和setMipLevelRange。

void QOpenGLTexture::setMipLevelRange(int baseLevel, int maxLevel)

将可用于此纹理的纹理查找的mipmap级别范围设置为从baseLevel到maxLevel。

另请参阅 setMipBaseLevel，setMipMaxLevel和mipLevelRange。

void QOpenGLTexture::setMipLevels(int levels)

对于支持mipmap的纹理目标，此函数将分配存储的请求的mipmap levels数。在为纹理分配存储之前应调用此函数。

如果纹理目标不支持mipmap，则此函数没有效果。

另请参阅 mipLevels，maximumMipLevels和isStorageAllocated。

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

将用于所有具有此纹理的纹理查找的最大mipmap级别设置为maxLevel。

另请参阅 mipMaxLevel，setMipBaseLevel和setMipLevelRange。

void QOpenGLTexture::setSamples(int samples)

将在多样本纹理目标上进行渲染时分配存储的样本数设置为samples。应在为纹理分配存储之前调用此函数。

对于不支持多采样的目标，此函数无效果。

另请参阅 samples和isStorageAllocated。

void QOpenGLTexture::setSize(int width, int height = 1, int depth = 1)

将此纹理对象的尺寸设置为宽度、高度和深度。每个维度的默认值是1。允许的最大纹理大小取决于您的OpenGL实现。如果系统资源不足，为小于最大大小的纹理分配存储仍然可能失败。

如果提供非2的幂的宽度、高度或深度，并且您的OpenGL实现不支持重复的非2的幂纹理，则自动将包装模式设置为ClampToEdge。

另请参阅width()，height()和depth()。

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleComponent component, QOpenGLTexture::SwizzleValue value)

GLSL着色器能够重新排序由纹理函数返回的vec4组件。还希望能够从CPU端代码控制这种排序。自OpenGL 3.3以来，这由混合遮罩（swizzle masks）使得成为可能。

每个纹理组件可以映射到SwizzleValue选项之一。

此函数将component映射到输出value。

另请参阅swizzleMask。

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleValue r, QOpenGLTexture::SwizzleValue g, QOpenGLTexture::SwizzleValue b, QOpenGLTexture::SwizzleValue a)

参数r、g、b和a用于设置颜色红色、绿色、蓝色和alpha值。

这是一个重载函数。

void QOpenGLTexture::setWrapMode(QOpenGLTexture::WrapMode mode)

将所有纹理维度的包装（或重复）模式设置为mode。

另请参阅wrapMode。

void QOpenGLTexture::setWrapMode(QOpenGLTexture::CoordinateDirection direction, QOpenGLTexture::WrapMode mode)

包含纹理维度direction。

这是一个重载函数。

QOpenGLTexture::SwizzleValue QOpenGLTexture::swizzleMask(QOpenGLTexture::SwizzleComponent component) const

返回纹理component的混合遮罩。

另请参阅setSwizzleMask。

QOpenGLTexture::Target QOpenGLTexture::target() const

返回此纹理的绑定目标。

GLuint QOpenGLTexture::textureId() const

返回底层OpenGL纹理对象的名字，如果尚未创建则返回0。

另请参阅 create()，destroy() 和 isCreated()。

int QOpenGLTexture::width() const

返回 1D、2D 或 3D 纹理的宽度。

另请参阅 height()，depth() 和 setSize()。

QOpenGLTexture::WrapMode QOpenGLTexture::wrapMode(QOpenGLTexture::CoordinateDirection direction) const

返回纹理维度 direction 的包装模式。

另请参阅 setWrapMode()。