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 都是不相等的，因此必须对返回值进行相应的处理。但也有例外情况，特别是在使用图集的情况下（多个纹理共享相同的图集纹理），这将由子类实现酌情处理。

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

返回从该纹理采样时是否使用 mipmapping。

另请参阅 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 是一个可选的资源更新批次，纹理操作（如果有）将在此批次上排队。材料可以从 获取一个实例。如果为空，removedFromAtlas() 实现会创建自己的批次并立即提交。但是，如果指定了一个有效的实例，此函数将不会提交更新批次。QSGMaterialShader::RenderState

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

返回此QSGTexture 的QRhiTexture ，如果没有（因为内部尚未创建有效的纹理，或者因为此概念不适用于使用中的场景图后端），则返回 null。

如果没有，则该函数不会创建新的QRhiTexture 。在这种情况下，它应该返回空值。渲染器的期望是，空纹理会导致使用透明的假纹理。

此函数在 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 。

如果纹理没有 mipmap，则设置 mipmap 过滤没有任何作用。

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

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

将垂直换行模式设置为vwrap

另请参阅 verticalWrapMode().

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

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

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

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

另请参阅 setVerticalWrapMode()。