QOpenGLTexture Class

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

成员函数文档

[explicit] QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

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

这不会创建底层的 OpenGL 纹理对象。因此，使用此构造函数进行初始化时，无需有效的当前 OpenGL 上下文。

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

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

这确实会创建底层的 OpenGL 纹理对象。因此，使用此构造函数进行初始化需要一个有效的当前 OpenGL 上下文。

void QOpenGLTexture::allocateStorage()

为该纹理对象分配服务器端存储空间，同时考虑其格式、尺寸、Mipmap 级别、数组层和立方体贴图面。

一旦存储空间被分配，就无法再更改这些属性。

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

为纹理分配存储空间后，即可通过setData() 的其中一个重载函数上传像素数据。

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

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

为该纹理对象分配服务器端存储空间，同时考虑其格式、尺寸、Mipmap 级别、数组层和立方体贴图面。

一旦存储空间被分配，就无法再更改这些属性。

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

一旦为纹理分配了存储空间，即可通过其中一个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 所指向的数组的前四个元素中。

[static] GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

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

[static] 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 ，但对于后者，通过minimumLayer 和maximumLayer 指定的数组层数必须恰好为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)

根据米普贴图级别baseLevel 为该纹理对象生成米普贴图。如果您使用的纹理目标和过滤选项需要米普贴图，但已禁用自动生成米普贴图功能，则需要调用此函数或其重载来创建米普贴图链。

要生成高于baseLevel 的微图，需将微图基级设置为baseLevel ，然后生成微图链。如果resetBaseLevel 的值为true ，则纹理的baseLevel将被重置为其之前的值。

另请参阅 setAutoMipMapGenerationEnabled()、setMipLevels() 和mipLevels()。

[static] bool QOpenGLTexture::hasFeature(QOpenGLTexture::Feature feature)

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

int QOpenGLTexture::height() const

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

另请参阅 width()、depth() 和setSize()。

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

返回此纹理对象是否启用了自动MIP映射生成。

另请参阅 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 。

一旦存储空间被分配，纹理格式、尺寸、Mipmap 级别和数组层均无法更改。

另请参阅 allocateStorage()、setSize()、setMipLevels()、setLayers() 以及setFormat()。

bool QOpenGLTexture::isTextureView() const

如果该纹理对象实际上是另一个纹理对象的视图，则返回true 。

另请参阅 createTextureView()。

int QOpenGLTexture::layers() const

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

对于不支持数组层的纹理目标，该函数将返回 1。

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

std::pair<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

根据当前尺寸，返回该纹理可拥有的最大Mipmap级别数。

另请参阅 setMipLevels()、mipLevels()，以及setSize()。

std::pair<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

返回此纹理所有纹理查找所使用的MIP映射基级。默认值为 0。

另请参阅 setMipBaseLevel()、mipMaxLevel() 以及mipLevelRange()。

std::pair<int, int> QOpenGLTexture::mipLevelRange() const

返回可用于对该纹理进行纹理查找的Mipmap级别范围。

另请参阅 setMipLevelRange()、mipBaseLevel() 和mipMaxLevel()。

int QOpenGLTexture::mipLevels() const

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

另请参阅 setMipLevels()、maximumMipLevels() 和isStorageAllocated()。

int QOpenGLTexture::mipMaxLevel() const

返回此纹理所有纹理查找所使用的Mipmap最大级别。

另请参阅 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`，则当通过 `setData()` 设置第 0 级 Mipmap 数据时，将启用该纹理对象的自动 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 ，并将a 设为透明度值。

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

将红色设置为r ，绿色设置为g ，蓝色设置为b ，透明度设置为a 。

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

将红色设置为r ，绿色设置为g ，蓝色设置为b ，透明度设置为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)

将压缩的像素数据data 上传至mipLevel 、数组layer 以及cubeFace 。像素传输可通过options 进行可选控制。dataSize 参数应指定data 所指向的数据的大小。

如果不使用压缩的format()，则应使用setData() 代替此函数。

void QOpenGLTexture::setCompressedData(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 mipLevel, int layer, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

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::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

上传该纹理对象mipLevel 的像素数据data 、数组layer 以及cubeFace 。在上传像素数据之前，必须已分配好存储空间。某些 setData() 的重载方法会在具备足够信息的情况下，自动设置适当的尺寸、Mipmap 级别和数组层，并为您分配存储空间。相关说明将在函数文档中注明。

由data 指向的像素数据结构由sourceFormat 和sourceType 指定。像素数据的上传可选地通过options 进行控制。

如果使用压缩的format()，则应使用setCompressedData() 代替此函数。

另请参阅 setCompressedData()。

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

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

void QOpenGLTexture::setData(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(int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

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

参数layerCount 表示由该调用上传/填充的纹理数组中的图层数量。

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 xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

此重载用于更新纹理的一部分。参数xOffset 、yOffset 、zOffset 指定纹理内的纹素偏移量。参数width 、height 和depth 指定子图像的尺寸。要更新的子图像的 MIP 贴图级别通过mipLevel 指定。

由data 所指向的像素数据结构由sourceFormat 和sourceType 指定。像素数据的上传可通过options 进行可选控制。

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

此重载用于更新纹理的一部分。参数xOffset 、yOffset 、zOffset 指定纹理内的纹素偏移量。参数width 、height 和depth 指定子图像的尺寸。要更新的子图像的 MIP 贴图级别和图层分别通过mipLevel 和layer 指定。

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, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

此重载用于更新纹理的一部分。参数xOffset 、yOffset 、zOffset 指定纹理内的纹素偏移量。参数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 指定子图像的尺寸。要更新的子图像的 MIP 贴图级别、起始层、立方贴图面以及层数分别由mipLevel 、layer 、face 和layerCount 指定。

由data 指向的像素数据结构由sourceFormat 和sourceType 指定。像素数据的上传可通过options 进行可选控制。

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 实现和版本。

另请参阅 format() 和allocateStorage()。

void QOpenGLTexture::setLayers(int layers)

设置要为数组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 。这会限制最低分辨率Mipmap（最高Mipmap级别）的选择。默认值为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 。这会限制最高分辨率米普图（最低米普图级别）的选择。默认值为-1000。

另请参阅 minimumLevelOfDetail()、setMaximumLevelOfDetail() 和setLevelOfDetailRange()。

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

将此纹理的所有纹理查找所使用的基米普图级别设置为baseLevel 。

另请参阅 mipBaseLevel()、setMipMaxLevel() 和setMipLevelRange()。

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

将可用于此纹理的纹理查找的微贴图级别范围设置为baseLevel 至maxLevel 。

另请参阅 setMipBaseLevel()、setMipMaxLevel() 和mipLevelRange()。

void QOpenGLTexture::setMipLevels(int levels)

对于支持米普图的纹理目标，此函数用于设置需要为其分配存储空间的米普图levels 的数量。应在为纹理分配存储空间之前调用此函数。

如果纹理目标不支持米普图，则此函数无效。

另请参阅 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)

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

如果提供的width 、height 或depth 不是 2 的幂，且您的 OpenGL 实现不支持重复非 2 的幂纹理，则循环模式将自动设置为ClampToEdge 。

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

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

GLSL 着色器能够重新排列纹理函数返回的 vec4 的分量顺序。此外，能够从 CPU 端代码控制这种重新排列也是非常理想的。自 OpenGL 3.3 起，通过 swizzle 掩码可以实现这一点。

纹理的每个分量都可以映射到SwizzleValue 选项之一。

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

另请参阅 swizzleMask()。

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

参数r 、g 、b 和a 分别用于设置红色、绿色、蓝色以及透明度值。

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

将所有纹理尺寸的环绕（或重复）模式设置为mode 。

另请参阅 wrapMode()。

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

将纹理维度direction 的环绕（或重复）模式设置为mode 。

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()。