QRhi Class

成员函数文档

[noexcept] QRhi::~QRhi()

销毁器销毁后台并释放资源。

void QRhi::addCleanupCallback(const QRhi::CleanupCallback &callback)

注册一个callback ，在QRhi 销毁或调用runCleanup() 时调用。

回调将在图形资源仍然可用的情况下运行，因此这就为应用程序提供了一个机会，可以干净利落地释放属于QRhi 的QRhiResource 实例。这对于管理存储在cache 类型对象中的资源的生命周期特别有用，在这种情况下，缓存会保存 QRhiResources 或包含 QRhiResources 的对象。

另请参阅 runCleanup() 和~QRhi()。

void QRhi::addCleanupCallback(const void *key, const QRhi::CleanupCallback &callback)

这是一个重载函数。

它注册callback ，以便在QRhi 被销毁或runCleanup() 被调用时调用。该重载函数接收一个不透明指针key ，用于确保给定的回调只被注册（和调用）一次。

另请参见 removeCleanupCallback()。

QRhi::Implementation QRhi::backend() const

返回QRhi 的后台类型。

const char *QRhi::backendName() const

以字符串形式返回该QRhi 的后端类型。

[static] const char *QRhi::backendName(QRhi::Implementation impl)

返回后台impl 的友好名称，通常是正在使用的 3D API 的名称。

QRhi::FrameOpResult QRhi::beginFrame(QRhiSwapChain *swapChain, QRhi::BeginFrameFlags flags = {})

启动一个新帧，目标是swapChain 的下一个可用缓冲区。

一个帧由资源更新和一个或多个渲染和计算通道组成。

flags 可以表示某些特殊情况。

使用交换链渲染到QWindow 的高级模式：

• 创建交换链。
• 只要曲面尺寸与之前不同，就调用QRhiSwapChain::createOrResize() 。
• 在QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed 上调用QRhiSwapChain::destroy() 。
• 然后在每一帧

  beginFrame(sc);
  updates = nextResourceUpdateBatch();
  updates->...
  QRhiCommandBuffer *cb = sc->currentFrameCommandBuffer();
  cb->beginPass(sc->currentFrameRenderTarget(), colorClear, dsClear, updates);
  ...
  cb->endPass();
  ... // more passes as necessary
  endFrame(sc);

成功时返回QRhi::FrameOpSuccess ，失败时返回另一个QRhi::FrameOpResult 值。其中一些错误应视为 "稍后再试 "类型的软错误：当返回QRhi::FrameOpSwapChainOutOfDate 时，应调用QRhiSwapChain::createOrResize() 来调整或更新交换链的大小。QRhi::FrameOpDeviceLost 意味着图形设备丢失，但也可以通过释放所有资源（包括QRhi 本身）然后重新创建所有资源来恢复。进一步讨论见isDeviceLost()。

另请参阅 endFrame()、beginOffscreenFrame() 和isDeviceLost()。

QRhi::FrameOpResult QRhi::beginOffscreenFrame(QRhiCommandBuffer **cb, QRhi::BeginFrameFlags flags = {})

启动一个新的离屏帧。cb flags 用于表示某些特殊情况，就像beginFrame() 一样。

不使用交换链也可以进行渲染。典型的用例是在完全离屏的应用程序中使用，例如通过渲染和回读生成图像序列，而不显示窗口。

在屏幕应用程序中也可以使用（如beginFrame,endFrame, beginOffscreenFrame,endOffscreenFrame,beginFrame, ......），但这样会降低并行性，因此只能偶尔使用。

当 GPU 仍在处理前一个帧时，屏幕外帧不会让 CPU 产生另一个帧。这样做的副作用是，如果安排了回读，那么一旦endOffscreenFrame() 返回，就能保证结果可用。以交换链为目标的帧则不是这种情况：在这种情况下，GPU 有可能得到更好的利用，但在处理回读操作时，应用程序需要更加小心，因为endFrame() 与endOffscreenFrame() 不同，不能保证回读的结果在此时可用。

在没有交换链的情况下渲染帧，然后回读帧内容的骨架如下所示：

QRhiReadbackResult rbResult;
QRhiCommandBuffer *cb;
rhi->beginOffscreenFrame(&cb);
cb->beginPass(rt, colorClear, dsClear);
// ...
u = nextResourceUpdateBatch();
u->readBackTexture(rb, &rbResult);
cb->endPass(u);
rhi->endOffscreenFrame();
// image data available in rbResult

另请参见 endOffscreenFrame() 和beginFrame()。

QMatrix4x4 QRhi::clipSpaceCorrMatrix() const

返回一个矩阵，允许应用程序继续使用以 OpenGL 为目标的顶点数据和透视投影矩阵（例如，由QMatrix4x4::perspective()) 生成的矩阵），而无需考虑活动的QRhi 后端。

在典型的渲染器中，一旦使用了this_matrix * mvp 而不仅仅是mvp ，就可以使用 Y 向上的顶点数据和深度范围为 0 - 1 的视口，而无需考虑运行时将使用哪个后端（以及图形 API）。这样就可以避免基于isYUpInNDC() 和isClipDepthZeroToOne() 的分支（尽管在实施某些高级图形技术时可能仍然需要这种逻辑）。

有关从 Vulkan 角度讨论该主题的内容，请参见本页。

[static] QRhi *QRhi::create(QRhi::Implementation impl, QRhiInitParams *params, QRhi::Flags flags = {}, QRhiNativeHandles *importDevice = nullptr)

Returns a newQRhi instance with a backend for the graphics API specified byimpl with the specifiedflags 。如果函数失败，则返回nullptr 。

params 必须指向 后端特定子类之一的实例，如 , , , , 。有关创建 的示例，请参阅这些类。QRhiInitParams QRhiVulkanInitParams QRhiMetalInitParams QRhiD3D11InitParams QRhiD3D12InitParams QRhiGles2InitParams QRhi

QRhi 如果指定的 API 无法初始化，create() 就会失败，后端会在调试输出中打印警告。 的客户端（例如 ）可能会根据平台提供额外的逻辑，允许回退到与请求不同的 API。如果只是为了在以后调用 create() 时测试初始化是否成功，最好使用 () 而不是 create()，因为对于某些后端，探测可以以更轻量级的方式实现，而 create()则会执行基础设施的完全初始化，如果 实例被立即丢弃，则会造成浪费。QRhi Qt Quick probe QRhi

importDevice 允许使用已有的图形设备，而无需 创建自己的图形设备。该参数不为空时，必须指向 的子类之一的实例：, , , , 。具体细节和语义取决于后台和底层图形 API。QRhi QRhiNativeHandles QRhiVulkanNativeHandles QRhiD3D11NativeHandles QRhiD3D12NativeHandles QRhiMetalNativeHandles QRhiGles2NativeHandles

另请参阅 probe() 。

int QRhi::currentFrameSlot() const

返回录制帧时的当前帧槽索引。在活动帧之外调用时（即isRecordingFrame() 为false 时）未指定。

对于 Vulkan 或 Metal 等后端，每当开始新的帧并发现 CPU 已领先 GPUFramesInFlight - 1 帧（因为在current -FramesInFlight 帧中提交的命令缓冲尚未完成）时，QRhi 后端就有责任阻塞。

帧与帧之间可能会发生变化的资源（例如，支持QRhiBuffer 的本地缓冲区对象，其类型为QRhiBuffer::Dynamic ）会有多个版本，这样，当前一帧仍在处理时提交的每一帧都可以使用自己的副本，从而避免了在准备帧时停滞流水线的需要。(GPU 中可能仍在使用的资源内容不应被触及，但总是等待前一帧完成会降低 GPU 的利用率，并最终降低性能和效率）。

从概念上讲，这有点类似于某些 C++ 容器和其他类型所使用的写时复制（copy-on-write）方案。它也可能类似于 OpenGL 或 Direct 3D 11 实现对某些类型对象的内部执行。

在实践中，Vulkan、Metal 和类似的QRhi 后端通过在QRhiResource 后面设置固定数量的本地资源（如 VkBuffer）slots 来实现这种双重（或三重）缓冲资源。然后，可以通过帧槽索引 0、1...、FramesInFlight-1 进行索引，然后再缠绕一圈。

所有这些对QRhi 的用户来说都是透明的。不过，直接使用图形 API 进行渲染的应用程序可能希望对自己的图形资源执行类似的双重或三重缓冲。如果知道最大飞行帧数（可通过resourceLimit() 获取）和当前帧（槽）索引（由该函数返回）的值，就可以轻松实现这一目的。

另请参见 isRecordingFrame()、beginFrame() 和endFrame()。

QRhiDriverInfo QRhi::driverInfo() const

返回已成功初始化的QRhi 实例所使用图形设备的元数据。

QRhi::FrameOpResult QRhi::endFrame(QRhiSwapChain *swapChain, QRhi::EndFrameFlags flags = {})

结束、提交并显示在swapChain 上的最后一个beginFrame() 中启动的帧。

双重（或三重）缓冲由QRhiSwapChain 和QRhi 内部管理。

flags 在某些情况下，可以选择使用"...... "来改变行为。传递 会跳过 Present 命令队列或调用 swapBuffers。QRhi::SkipPresent

成功时返回QRhi::FrameOpSuccess ，失败时返回另一个QRhi::FrameOpResult 值。其中一些错误应视为 "稍后再试 "类型的软错误：当返回QRhi::FrameOpSwapChainOutOfDate 时，应通过调用QRhiSwapChain::createOrResize() 来调整或更新 swapchain。QRhi::FrameOpDeviceLost 意味着图形设备丢失，但也可以通过释放所有资源（包括QRhi 本身）然后重新创建所有资源来恢复。进一步讨论请参见isDeviceLost() 。

另请参阅 beginFrame() 和isDeviceLost()。

QRhi::FrameOpResult QRhi::endOffscreenFrame(QRhi::EndFrameFlags flags = {})

结束、提交并等待屏幕外帧。

flags 目前未使用。

另请参阅 beginOffscreenFrame().

QRhi::FrameOpResult QRhi::finish()

等待图形队列（如适用）中的任何工作完成，然后执行所有延迟操作，如完成回读和资源释放。可在帧内外调用，但不能在通行证内调用。在帧内它意味着提交命令缓冲区上的任何工作。

bool QRhi::isClipDepthZeroToOne() const

如果底层图形 API 在剪辑空间中使用深度范围 [0，1]，则返回true 。

实际上，false 只适用于 OpenGL，因为 OpenGL 使用的投影后深度范围是 [-1, 1]。(不要与由 glDepthRange() 控制的 NDC 到窗口映射混淆，后者使用的范围是 [0，1]，除非被QRhiViewport 改写）在某些 OpenGL 版本中，glClipControl() 可用来改变这一范围，但QRhi 的 OpenGL 后端并不使用该函数，因为 OpenGL ES 或低于 4.5 的 OpenGL 版本中没有该函数。

bool QRhi::isDeviceLost() const

如果图形设备丢失，则返回 true。

设备丢失通常在beginFrame(),endFrame() 或QRhiSwapChain::createOrResize() 中检测到，具体取决于后端和底层本地应用程序接口。最常见的是endFrame() ，因为这就是出现的位置。对于某些后端，QRhiSwapChain::createOrResize() 也可能因设备丢失而失败。因此，我们提供了这个函数，作为检查之前的操作是否检测到设备丢失的通用方法。

当设备丢失时，不应通过QRhi 执行进一步操作。相反，应释放所有QRhi 资源，然后销毁QRhi 。然后可以尝试创建新的QRhi 。如果成功，则必须重新初始化所有图形资源。如果不成功，请稍后再重复尝试。

虽然简单的应用程序可能不会在意设备丢失，但在常用的桌面平台上，设备丢失的原因有很多，包括物理断开图形适配器、禁用设备或驱动程序、卸载或升级图形驱动程序，或者由于错误导致图形设备重置。其中有些情况也可能在完全正常的情况下发生，例如，将图形驱动程序升级到较新版本是一项常见任务，可能在 Qt 应用程序运行时随时发生。用户很可能希望应用程序能在这种情况下正常运行，即使应用程序正在积极使用 OpenGL 或 Direct3D 等 API。

建立在QRhi 之上的 Qt 自身框架，如Qt Quick ，可望在发生设备丢失时进行处理并采取适当措施。如果图形资源（如纹理和缓冲区）的数据在 CPU 端仍然可用，应用程序可能根本不会注意到此类事件，因为图形资源可以无缝地重新初始化。不过，直接使用QRhi 的应用程序和程序库应做好准备，自行检查和处理设备丢失情况。

bool QRhi::isFeatureSupported(QRhi::Feature feature) const

如果支持指定的feature ，则返回true

bool QRhi::isRecordingFrame() const

当有一个活动帧时返回 true，这意味着有一个beginFrame() （或beginOffscreenFrame() ），但还没有相应的endFrame() （或endOffscreenFrame() ）。

另请参阅 currentFrameSlot()、beginFrame() 和endFrame()。

bool QRhi::isTextureFormatSupported(QRhiTexture::Format format, QRhiTexture::Flags flags = {}) const

如果支持经flags 修改的指定纹理format ，则返回true 。

非压缩格式和压缩格式都支持该查询。

bool QRhi::isYUpInFramebuffer() const

如果底层图形 API 在帧缓冲区和图像中将 Y 轴指向上方，则返回true 。

实际上，true 只适用于 OpenGL。

bool QRhi::isYUpInNDC() const

如果底层图形 API 的 Y 轴在其规范化设备坐标系中指向上方，则返回true 。

实际上，false 只适用于 Vulkan。

bool QRhi::makeThreadLocalNativeContextCurrent()

在使用 OpenGL 时，该函数将使 OpenGL 上下文成为当前线程上的当前上下文。该函数对其他后端没有影响。

调用此函数通常与 Qt Framework 代码相关，因为只要QRhi 使用 OpenGL 后端，就必须确保应用程序提供的外部 OpenGL 代码仍能像以前直接使用 OpenGL 时一样运行。

操作失败时返回 false，与QOpenGLContext::makeCurrent() 类似。当操作失败时，可以调用isDeviceLost() 来确定是否出现了上下文丢失的情况。这种检查等同于通过QOpenGLContext::isValid() 进行的检查。

另请参阅 QOpenGLContext::makeCurrent() 和QOpenGLContext::isValid()。

[static] int QRhi::mipLevelsForSize(const QSize &size)

返回给定size 的 mip 级别数。

const QRhiNativeHandles *QRhi::nativeHandles()

返回指向后端特定本地对象集合的指针，该集合包含后端使用的设备、上下文和类似概念。

可根据情况转换为QRhiVulkanNativeHandles,QRhiD3D11NativeHandles,QRhiD3D12NativeHandles,QRhiGles2NativeHandles 或QRhiMetalNativeHandles 。

QRhiBuffer *QRhi::newBuffer(QRhiBuffer::Type type, QRhiBuffer::UsageFlags usage, quint32 size)

用指定的type 、usage 和size 返回一个新的缓冲区。

另请参见 QRhiResource::destroy()。

QRhiComputePipeline *QRhi::newComputePipeline()

返回一个新的计算管道资源。

另请参阅 QRhiResource::destroy()。

QRhiGraphicsPipeline *QRhi::newGraphicsPipeline()

返回一个新的图形管道资源。

另请参见 QRhiResource::destroy()。

QRhiRenderBuffer *QRhi::newRenderBuffer(QRhiRenderBuffer::Type type, const QSize &pixelSize, int sampleCount = 1, QRhiRenderBuffer::Flags flags = {}, QRhiTexture::Format backingFormatHint = QRhiTexture::UnknownFormat)

使用指定的type 、pixelSize 、sampleCount 和flags 返回一个新的呈现缓冲区。

当backingFormatHint 被设置为QRhiTexture::UnknownFormat 以外的纹理格式时，后端可能会使用它来决定使用哪种格式来存储渲染缓冲区。

另请参见 QRhiResource::destroy().

QRhiSampler *QRhi::newSampler(QRhiSampler::Filter magFilter, QRhiSampler::Filter minFilter, QRhiSampler::Filter mipmapMode, QRhiSampler::AddressMode addressU, QRhiSampler::AddressMode addressV, QRhiSampler::AddressMode addressW = QRhiSampler::Repeat)

返回一个新的采样器，该采样器具有指定的放大过滤器magFilter 、缩小过滤器minFilter 、mipmapping 模式mipmapMode 以及寻址（换行）模式addressU addressV 和addressW 。

另请参阅 QRhiResource::destroy()。

QRhiShaderResourceBindings *QRhi::newShaderResourceBindings()

返回新的着色器资源绑定集合资源。

另请参见 QRhiResource::destroy().

[since 6.9] QRhiShadingRateMap *QRhi::newShadingRateMap()

返回一个新的着色率贴图对象。

此函数在 Qt 6.9 中引入。

QRhiSwapChain *QRhi::newSwapChain()

返回新的 swapchain。

另请参阅 QRhiResource::destroy() 和QRhiSwapChain::createOrResize()。

QRhiTexture *QRhi::newTexture(QRhiTexture::Format format, const QSize &pixelSize, int sampleCount = 1, QRhiTexture::Flags flags = {})

使用指定的format,pixelSize,sampleCount 和flags 返回新的一维或二维纹理。

一维纹理数组必须在flags 中设置QRhiTexture::OneDimensional 。如果pixelSize 高度为 0，此函数将隐式设置此标志。

另请参阅 QRhiResource::destroy().

QRhiTexture *QRhi::newTexture(QRhiTexture::Format format, int width, int height, int depth, int sampleCount = 1, QRhiTexture::Flags flags = {})

使用指定的format,width,height,depth,sampleCount 和flags 返回新的一维、二维或三维纹理。

此重载适用于三维纹理，因为它允许指定depth 。三维纹理必须在flags 中设置QRhiTexture::ThreeDimensional ，但使用此重载时可以省略，因为只要depth 大于 0，就会隐式设置该标志。对于一维、二维和立方体纹理，depth 应设置为 0。

一维纹理必须在flags 中设置QRhiTexture::OneDimensional 。如果height 和depth 均为 0，则此重载将隐式设置此标志。

这是一个重载函数。

QRhiTexture *QRhi::newTextureArray(QRhiTexture::Format format, int arraySize, const QSize &pixelSize, int sampleCount = 1, QRhiTexture::Flags flags = {})

使用指定的format,arraySize,pixelSize,sampleCount 和flags 返回新的一维或二维纹理数组。

此函数在flags 中隐含设置QRhiTexture::TextureArray 。

一维纹理数组必须在flags 中设置QRhiTexture::OneDimensional 。如果pixelSize 高度为 0，此函数将隐式设置此标志。

另请参阅 newTexture().

QRhiTextureRenderTarget *QRhi::newTextureRenderTarget(const QRhiTextureRenderTargetDescription &desc, QRhiTextureRenderTarget::Flags flags = {})

Returns a new texture render target with color and depth/stencil attachments given indesc, and with the specifiedflags 。

另请参见 QRhiResource::destroy().

QRhiResourceUpdateBatch *QRhi::nextResourceUpdateBatch()

返回一个可用的空批次，可记录复制类型的操作。

由于不与正在记录的帧绑定，例如以下序列是有效的：

rhi->beginFrame(swapchain);
QRhiResourceUpdateBatch *u = rhi->nextResourceUpdateBatch();
u->uploadStaticBuffer(buf, data);
// ... do not commit the batch
rhi->endFrame();
// u stays valid (assuming buf stays valid as well)
rhi->beginFrame(swapchain);
swapchain->currentFrameCommandBuffer()->resourceUpdate(u);
// ... draw with buf
rhi->endFrame();

QByteArray QRhi::pipelineCacheData()

返回二进制数据 Blob，其中包含从QRhiGraphicsPipeline 和QRhiComputePipeline 收集到的数据，这些数据是在QRhi 的生命周期内成功创建的。

通过保存缓存数据，然后在同一应用程序的后续运行中重新加载缓存数据，有可能缩短流水线和着色器的创建时间。缓存及其序列化版本具体包括哪些内容没有明确规定，总是与所使用的后端有关，在某些情况下还取决于图形 API 的特定实现。

当PipelineCacheDataLoadSave 被报告为不支持时，返回的QByteArray 将是空的。

当调用create() 时没有指定EnablePipelineCacheDataSave 标志，即使支持PipelineCacheDataLoadSave 功能，返回的QByteArray 也可能是空的。

当返回的数据为非空时，它总是特定于 Qt XML 版本和QRhi 后端。此外，在某些情况下，图形设备和所使用的确切驱动程序版本之间存在很强的依赖性。QRhi 会添加适当的头和保障措施，确保数据始终能安全地传递到setPipelineCacheData() ，因此，尝试从另一版本的驱动程序上运行的数据中加载数据时，将得到安全、优雅的处理。

有关此功能的更多详情，请参阅EnablePipelineCacheDataSave 。

另请参见 setPipelineCacheData()、create() 和isFeatureSupported()。

[static] bool QRhi::probe(QRhi::Implementation impl, QRhiInitParams *params)

如果create() 在调用给定的impl 和params 时有望成功，则返回 true。

对于某些后端，这相当于调用create() ，检查其返回值，然后销毁生成的QRhi 。

对于其他后端，尤其是 Metal，可能会有特定的探测实现，从而以更轻量级的方式进行测试，而不会在失败时用警告污染调试输出。

另请参见 create().

void QRhi::releaseCachedResources()

尝试释放后端缓存中的资源。这可能包括 CPU 和 GPU 资源。只有能自动重新创建的内存和资源才在范围内。举例来说，如果后端的QRhiGraphicsPipeline 实现维护着色器编译结果的缓存，调用该函数就会清空缓存，从而释放内存和图形资源。

在资源受限的环境中，调用此函数是有意义的，因为在这种环境中，需要确保在牺牲性能的前提下尽量减少资源使用。

void QRhi::removeCleanupCallback(const void *key)

注销key 中的回调函数。如果key 中没有注册清理回调函数，则该函数不会执行任何操作。未注册密钥的回调无法删除。

另请参阅 addCleanupCallback() 。

int QRhi::resourceLimit(QRhi::ResourceLimit limit) const

返回指定资源limit 的值。

这些值预计将在初始化时由后台查询，这意味着调用该函数是一项轻量级操作。

void QRhi::runCleanup()

调用所有已注册的清理函数。然后清除清理回调列表。通常情况下，销毁QRhi 会自动完成这项工作，但有时触发清理功能以释放所有缓存的非必要资源也很有用。

另请参阅 addCleanupCallback().

void QRhi::setPipelineCacheData(const QByteArray &data)

在适用情况下，将data 载入管道缓存。

当PipelineCacheDataLoadSave 被报告为不支持时，调用该函数是安全的，但没有任何作用。

pipelineCacheData() 返回的 blob 总是特定于 Qt 版本、QRhi 后端，在某些情况下，也特定于图形设备和给定版本的图形驱动程序。QRhi 负责添加适当的头和保障措施，确保数据始终能安全地传递给该函数。如果出现不匹配的情况，例如由于驱动程序升级到了更新的版本，或者数据是从不同的QRhi 后端生成的，则会打印警告，并安全地忽略data 。

对于 Vulkan，这直接映射到 VkPipelineCache。调用该函数可创建一个新的 Vulkan 管道缓存对象，其初始数据来自data 。随后创建的所有QRhiGraphicsPipeline 和QRhiComputePipeline 对象都将使用该管道缓存对象，从而有可能加快管道创建速度。

其他应用程序接口没有真正的管道缓存，但它们可能会提供一个来自着色器编译（D3D）或程序二进制文件（OpenGL）的字节码缓存。在运行时从源代码执行大量着色器编译的应用程序中，如果 "流水线缓存 "是从使用此功能的早期运行中预置的，那么在后续运行中就能显著提高性能。

有关此功能的更多详情，请参阅EnablePipelineCacheDataSave 。

另请参阅 pipelineCacheData() 和isFeatureSupported()。

[since 6.9] void QRhi::setQueueSubmitParams(QRhiNativeHandles *params)

对于适用的后端和图形 API，该函数允许为下一次向图形命令队列提交命令提供额外参数。

特别是在使用 Vulkan 时，该函数允许传入一个 Vulkan semaphore 对象列表，供vkQueueSubmit() 发送信号和等待。params 必须是QRhiVulkanQueueSubmitParams 。这在某些高级用例中非常重要，例如在执行原生 Vulkan 调用时，需要等待应用程序自定义 Vulkan 渲染或计算代码管理的 VkSemaphores 并向其发送信号。此外，这还允许在下一个vkQueuePresentKHR() 中指定额外的 semaphores 等待。

在许多其他后端中，该函数的实现是无操作的。

此函数在 Qt 6.9 中引入。

[static] QSize QRhi::sizeForMipLevel(int mipLevel, const QSize &baseLevelSize)

返回给定mipLevel 的纹理图像尺寸，该尺寸根据baseLevelSize 中给定的第 0 级尺寸计算得出。

QRhiStats QRhi::statistics() const

收集并返回有关图形资源定时和分配的统计数据。

有关内存分配的数据仅适用于某些后端，在这些后端中，此类操作由 Qt 控制。如果图形应用程序接口对资源内存分配没有下级控制，则永远不支持这种操作，结果中的所有相关字段都为 0。

特别是对于 Vulkan，这些值始终有效，并从底层内存分配器库中查询。这样就能了解活动缓冲区和纹理的内存需求。

Direct 3D 12 也是如此。除了内存分配器库的统计数据外，这里的结果还包括一个totalUsageBytes 字段，该字段报告的总大小包括 DXGI 报告的不受内存分配器库控制的其他资源（交换链缓冲区、描述符堆等）。

这些值对应的是所使用的所有内存类型的总和。(在独立 GPU 的情况下，即视频 + 系统）。

大多数后端都能提供其他数据，如创建图形和计算流水线（通常涉及着色器编译或缓存查找，以及潜在的昂贵处理）所花费的总时间（以毫秒为单位）。

QList<int> QRhi::supportedSampleCounts() const

返回支持的样本计数列表。

一个典型的例子是（1、2、4、8）。

对于某些后端，该支持值列表是预先确定的，而对于其他一些后端，（物理）设备属性会在运行时显示支持的值。

另请参见 QRhiRenderBuffer::setSampleCount()、QRhiTexture::setSampleCount()、QRhiGraphicsPipeline::setSampleCount() 和QRhiSwapChain::setSampleCount()。

[since 6.9] QList<QSize> QRhi::supportedShadingRates(int sampleCount) const

返回指定sampleCount 支持的可变阴影率列表。

始终支持 1x1。

此函数在 Qt 6.9 中引入。

QThread *QRhi::thread() const

返回QRhi 所在的线程initialized 。

int QRhi::ubufAligned(int v) const

返回v 与ubufAlignment() 给出的统一缓冲区对齐方式对齐的值（通常是偏移量）。

int QRhi::ubufAlignment() const

返回以字节为单位的最小统一缓冲区偏移对齐方式。通常为 256。

尝试绑定偏移量与此值不一致的统一缓冲区会导致失败，具体取决于后端和底层图形 API。

另请参阅 ubufAligned().

[static] QRhiSwapChainProxyData QRhi::updateSwapChainProxyData(QRhi::Implementation impl, QWindow *window)

生成并返回一个QRhiSwapChainProxyData 结构，其中包含由impl 指定的后端和图形 API 特有的不透明数据。window 是交换链针对的QWindow 。

返回的结构体可传递给QRhiSwapChain::setProxyData() 。这在线程渲染系统中是合理的：与所有QRhi 操作不同，该静态函数预计将在主（gui）线程上调用，然后转给处理QRhi 和QRhiSwapChain 的线程，并传递给 swapchain。这样就可以在主线程上安全调用本地平台查询，例如从 NSView 查询 CAMetalLayer，然后将数据传递给渲染线程上的QRhiSwapChain 。在 Metal 示例中，在专用渲染线程上进行 view.layer 访问会导致 Xcode 线程检查器发出警告。而使用数据代理机制则可以避免这种情况。

当不涉及线程时，不需要生成和传递QRhiSwapChainProxyData ：后端保证能够自行查询所需的任何内容，如果所有内容都在主（gui）线程上，那就足够了。