QSGTexture 类

成员函数文档

QSGTexture::QSGTexture()

构造QSGTexture基类。

[覆盖虚函数 noexcept] QSGTexture::~QSGTexture()

销毁QSGTexture。

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

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

另请参阅setAnisotropyLevel。

[虚函数，自6.0开始] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

调用此函数将图像上传操作入队到resourceUpdates，如果有任何挂起的操作。如果没有新数据（例如，因为自上次调用此函数以来没有setImage()），则函数不执行任何操作。

涉及rhi纹理的材料应在其updateSampledImage()实现中调用此函数，通常不需要任何条件，传递从QSGMaterialShader::RenderState中获取的state.rhi()和state.resourceUpdateBatch()。

此函数自Qt 6.0引入。

[纯虚函数] qint64 QSGTexture::comparisonKey() const

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

仅仅比较QSGTexture指针并不总是足够的，因为两个QSGTexture实例可能指向同一个底层的原生纹理对象，也应该被认为是相等的。因此需要这个函数。

此函数的实现预期不会也不会创建任何图形资源（原生纹理对象），如果还没有的话。

一个没有底层原生纹理对象的QSGTexture典型情况下不代表任何其他QSGTexture，所以返回值必须相应地构建。有例外，特别是当使用atlas时（多个纹理在底层共享同一个atlas纹理），这留给了子类的实现酌情处理。

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

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

另请参阅normalizedTextureSubRect。

QSGTexture::Filtering QSGTexture::filtering() const

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

另请参阅setFiltering。

[纯虚函数] bool QSGTexture::hasAlphaChannel() const

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

[纯虚函数] bool QSGTexture::hasMipmaps() const

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

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

返回用于此纹理的水平环绕模式。

另请参阅setHorizontalWrapMode。

[虚函数] bool QSGTexture::isAtlasTexture() const

返回此纹理是否是图集的一部分。

默认实现返回false。

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

返回是否在从此纹理采样时使用mipmap。

另请参阅setMipmapFiltering。

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

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

此函数提供了访问QSGTexture的平台特定功能，如QNativeInterface命名空间中所述。

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

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

[虚函数] QRectF QSGTexture::normalizedTextureSubRect() const

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

默认实现返回位置为(0, 0)，宽度为1和高度为1的矩形。

[虚函数] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

此函数返回当前纹理的副本，该纹理已从其图集中删除。

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

从图集中删除纹理主要用于将其传递给在纹理坐标0-1上操作的着色器，而不是传递到图集中的纹理子矩形。

如果纹理不是纹理图集的一部分，则该函数返回 0。

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

resourceUpdates 是一个可选的资源更新批次，纹理操作（如果有的话）会排队在该批次上。材料可以从 QSGMaterialShader::RenderState 中检索一个实例。当为 null 时，removedFromAtlas() 的实现会创建自己的批次并立即提交它。然而，当指定了有效的实例时，该函数不会提交更新批次。

[虚拟，自 6.0] QRhiTexture *QSGTexture::rhiTexture() const

返回此 QSGTexture 的 QRhiTexture 或 null（因为可能尚未创建有效的纹理，或者该概念不适用于所使用的场景图后端）。

如果当前没有 QRhiTexture，则此函数不会创建新的 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)

将米柏采样模式设置为 filter。

如果纹理没有米柏，则设置米柏过滤没有效果。

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

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

设置垂直包装模式为 vwrap

另请参阅：verticalWrapMode()。

[纯虚拟] QSize QSGTexture::textureSize() const

返回纹理的像素大小。

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

返回用于此纹理的垂直包装模式。

另请参阅：setVerticalWrapMode()。