QSGTexture Class

成员函数文档

QSGTexture::QSGTexture()

构建 QSGTexture 基类。

[override virtual noexcept] QSGTexture::~QSGTexture()

销毁QSGTexture 。

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

返回用于过滤此纹理的各向异性级别。

另请参阅 setAnisotropyLevel()。

[virtual, since 6.0] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

调用此函数可将图像上传操作加入resourceUpdates 的队列，以防存在任何待处理的操作。当没有新数据时（例如，自上次调用此函数以来未调用setImage()），该函数不执行任何操作。

涉及rhi 纹理的材质应在其updateSampledImage() 实现中调用此函数，通常无需任何条件，并从QSGMaterialShader::RenderState 传入state.rhi() 和state.resourceUpdateBatch() 。

该函数于 Qt 6.0 中引入。

[pure virtual] qint64 QSGTexture::comparisonKey() const

返回一个适用于纹理比较的键。通常用于QSGMaterial::compare()的实现中。

仅比较QSGTexture 指针并不总是足够的，因为两个引用同一底层本机纹理对象的QSGTexture 实例也应被视为相等。因此需要此函数。

该函数的实现不应、也不应在不存在任何图形资源（本机纹理对象）的情况下创建任何图形资源。

一个底层没有本机纹理对象的QSGTexture 通常不与其他任何QSGTexture 相等，因此必须相应地处理返回值。但也有例外情况，特别是当使用纹理图集（atlasing）时（此时多个纹理在底层共享同一个图集纹理），具体处理方式应由子类实现酌情决定。

QRectF QSGTexture::convertToNormalizedSourceRect(const QRectF &rect) const

返回已转换为归一化坐标的rect 。

另请参阅 normalizedTextureSubRect()。

QSGTexture::Filtering QSGTexture::filtering() const

返回此纹理所使用的采样模式。

另请参阅 setFiltering()。

[pure virtual] bool QSGTexture::hasAlphaChannel() const

如果纹理数据包含Alpha通道，则返回true。

[pure virtual] bool QSGTexture::hasMipmaps() const

如果纹理数据包含Mipmap级别，则返回 true。

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

返回此纹理将使用的水平换行模式。

另请参阅 setHorizontalWrapMode()。

[virtual] bool QSGTexture::isAtlasTexture() const

返回此纹理是否属于纹理图集。

默认实现返回 false。

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

返回从该纹理采样时是否应使用MIP映射。

另请参阅 setMipmapFiltering()。

template <typename QNativeInterface> QNativeInterface *QSGTexture::nativeInterface() const

返回该纹理的指定类型的本机接口。

该函数可访问QSGTexture 中平台特有的功能，这些功能在QNativeInterface 命名空间中已声明：

这允许访问底层本机纹理对象，例如 OpenGL 中的GLuint 纹理 ID，或 Vulkan 中的VkImage 句柄。

如果请求的接口不可用，则返回一个nullptr 。

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

返回该纹理在textureSize()中表示的矩形，以归一化坐标表示。

默认实现返回一个位于 (0, 0) 位置、宽高均为 1 的矩形。

[virtual] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

该函数返回当前纹理的副本，并将该副本从其纹理图集中移除。

当前纹理保持不变，因此无需更新纹理坐标。

从纹理图集中移除纹理，主要是在将其传递给着色器时非常有用，该着色器处理的是纹理坐标 0-1，而不是纹理图集内的纹理子矩形。

如果纹理不属于纹理图集，则此函数返回 0。

建议该函数的实现对于多次调用返回相同的实例，以限制内存使用。

resourceUpdates 是一个可选的资源更新批处理，纹理操作（如有）将排队到该批处理中。材质可以从QSGMaterialShader::RenderState 获取一个实例。当为空时，removedFromAtlas() 的实现会创建自己的批处理并立即提交。但是，当指定了一个有效的实例时，该函数将不会提交更新批处理。

[virtual, since 6.0] QRhiTexture *QSGTexture::rhiTexture() const

返回此QSGTexture 对应的QRhiTexture ，若不存在则返回null（可能是因为内部尚未创建有效的纹理，也可能是因为该概念不适用于当前使用的场景图后端）。

如果不存在QRhiTexture ，该函数不应创建新的 。在这种情况下，它应返回 null。渲染器的预期行为是：当纹理为 null 时，应改用透明的虚拟纹理。

该函数在 Qt 6.0 中引入。

void QSGTexture::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

将各向异性过滤级别设置为level 。默认值为QSGTexture::AnisotropyNone ，这意味着未启用各向异性过滤。

另请参阅 anisotropyLevel()。

void QSGTexture::setFiltering(QSGTexture::Filtering filter)

将采样模式设置为filter 。

另请参阅 filtering()。

void QSGTexture::setHorizontalWrapMode(QSGTexture::WrapMode hwrap)

将水平换行模式设置为hwrap

另请参阅 horizontalWrapMode()。

void QSGTexture::setMipmapFiltering(QSGTexture::Filtering filter)

将Mipmap采样模式设置为filter 。

如果纹理没有米普图，则设置米普图过滤不会产生任何效果。

另请参阅 mipmapFiltering() 和hasMipmaps()。

void QSGTexture::setVerticalWrapMode(QSGTexture::WrapMode vwrap)

将垂直换行模式设置为vwrap

另请参阅 verticalWrapMode()。

[pure virtual] QSize QSGTexture::textureSize() const

返回纹理的大小（以像素为单位）。

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

返回此纹理将使用的垂直折行模式。

另请参阅 setVerticalWrapMode()。