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 中的像素数据。如果希望生成一连串的 mipmaps，可将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 扩展，在不可用的地方模拟 EXT_direct_state_access 扩展。

另请参见 release().

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

将此纹理绑定到纹理单元unit ，以便进行渲染。请注意，您不需要绑定QOpenGLTexture 对象就可以修改它们，因为在可用的情况下会使用 EXT_direct_state_access 扩展，而在不可用的情况下则会模拟 EXT_direct_state_access 扩展。

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

另请参见 release()。

QColor QOpenGLTexture::borderColor() const

返回此纹理的 borderColor。

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

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

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

返回三维纹理的深度。

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

QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

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

另请参见 setDepthStencilMode()。

void QOpenGLTexture::destroy()

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

另请参阅 create()、isCreated() 和textureId()。

int QOpenGLTexture::faces() const

返回此纹理的面数。对于 cubemap 和 cubemap 阵列类型的目标，返回值为 6。

对于非 cubemap 类型的目标，将返回 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 生成此纹理对象的贴图。如果您使用的纹理目标和过滤选项需要 mipmaps，而且您已禁用自动 mipmap 生成功能，则需要调用此函数或重载函数来创建 mipmap 链。

通过将 mipmap 基本级别设置为baseLevel ，然后生成 mipmap 链，就可以生成baseLevel 以上的 mipmap。如果resetBaseLevel 是true ，那么纹理的 baseLevel 将重置为之前的值。

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

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

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

int QOpenGLTexture::height() const

返回二维或三维纹理的高度。

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

一旦存储空间分配完毕，就不能更改纹理格式、尺寸、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

返回使用此纹理进行所有纹理查找时使用的 mipmap 基本级别。默认值为 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 设置为 alpha 值。

这是一个重载函数。

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)

将压缩像素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)

上传此纹理对象的像素data mipLevel 、数组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 指定子图像的尺寸。mipLevel 指定了要更新的子图像的 mip 地图级别。

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 指定子图像的尺寸。mipLevel 和layer 指定了要更新的子图像的 mip 地图级别和层数。

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 。这将限制选择最高分辨率的 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 的纹理目标，该函数会设置请求分配存储空间的 mipmaplevels 数量。此函数应在为纹理分配存储空间之前调用。

如果纹理目标不支持 mipmaps，则此函数不起作用。

另请参阅 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 ，而您的 OpenGL 实现不支持重复非幂次的纹理，那么包模式将自动设置为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 是用于设置颜色红、绿、蓝和阿尔法值的值。

这是一个重载函数。

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

返回一维、二维或三维纹理的宽度。

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

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

返回纹理维度direction 的换行模式。

另请参阅 setWrapMode() 。