QRhi类

成员函数文档

[noexcept] QRhi::~QRhi()

析构函数。销毁后端并释放资源。

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

注册一个回调，当QRhi被销毁或调用runCleanup()时将被调用。

回调将在图形资源仍然可用时运行，因此这为应用程序提供了一次干净地释放属于QRhi的QRhiResource实例的机会。这对于管理存储在cache类型对象中的资源生命周期尤其有用，其中缓存保留QRhiResources或包含QRhiResources的对象。

另请参阅runCleanup()和~QRhi。

void QRhi::addCleanupCallback(const void *key, const QRhi::CleanupCallback &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等等）也是可能的，但这会降低并行性，因此应很少这样做。

离屏帧不允许CPU在GPU仍在处理前一个帧时生成另一个帧。这有一个副作用，即如果已安排读取回，则一旦返回endOffscreenFrame()，则可以保证结果可用。而对于针对交换链的帧来说并非如此：在那里GPU的利用率可能会更高，但是与应用程序一起使用读取回操作需要更多的注意，因为与endOffscreenFrame不同，endFrame不会保证读取回的结果在那时可用。

没有交换链渲染帧并随后读取帧内容的骨架可能看起来像以下内容

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

返回一个矩阵，允许应用程序在没有考虑活动 QRhi 后端的情况下继续使用针对 OpenGL 的顶点数据和你视图投影矩阵（例如，由 QMatrix4x4::perspective() 生成的那些）。

在一个典型的渲染器中，使用 this_matrix * mvp 代替仅仅使用 mvp，可以直接使用向上为Y的顶点数据以及深度范围为 0 - 1 的视口，而无需考虑运行时将使用什么后端（以及所以的图形接口）。这样就可以避免根据 isYUpInNDC() 和 isClipDepthZeroToOne() 的分支（尽管当实现某些高级图形技术时可能需要这样的逻辑）。

有关从 Vulkan 视角讨论这个主题，请参阅这篇页面。

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

返回一个新的 QRhi 实例，其图形 API 使用指定 impl 的后端，以及指定的 flags。

params 必须指向 QRhiInitParams 的一个后端特定子类的实例，例如，QRhiVulkanInitParams、QRhiMetalInitParams、QRhiD3D11InitParams、QRhiD3D12InitParams、QRhiGles2InitParams。参见这些类以获取创建 QRhi 的示例。

设计上，QRhi 不实现任何回退逻辑：如果指定的 API 无法初始化，create() 会失败，后端会在调试输出中打印警告。然而，QRhi 的客户端，例如 Qt Quick，可能会提供额外的逻辑，允许回退到所请求的不同的 API，具体取决于平台。如果只是为了测试在稍后调用 create() 时的初始化是否成功，最好使用 probe() 而不是 create()，因为与 create() 不同，create() 会执行完整的基础设施初始化，如果在创建后立即丢弃该 QRhi 实例，这是一种浪费。

importDevice 允许使用已经存在的图形设备，而无需 QRhi 创建自己的。当非空时，此参数必须指向 QRhiNativeHandles 的一个子类实例：QRhiVulkanNativeHandles、QRhiD3D11NativeHandles、QRhiD3D12NativeHandles、QRhiMetalNativeHandles、QRhiGles2NativeHandles。确切细节和语义取决于后端和底层图形 API。

另请参阅probe。

int QRhi::currentFrameSlot() const

在录制帧时返回当前帧槽的索引。在非活动帧中调用时未定义（也就是当 isRecordingFrame() 为 false 时）。

在像 Vulkan 或 Metal 这样的后端中，当启动新帧并发现 CPU 已经比 GPU 领先 FramesInFlight - 1 个帧时，QRhi 后端的职责是阻塞（因为帧号 current - FramesInFlight 中提交的命令缓冲区尚未完成）。

那些在帧与帧之间容易发生变化的资源（例如，类型为 QRhiBuffer::Dynamic 的原生动态缓冲区的后台对象）存在多个版本，这样每一帧都可以在处理前一个帧的同时提交，从而在自己的副本上工作，因此避免了在准备帧时阻塞管道的需求。（应该不允许访问 GPU 上可能仍在使用的资源的内容，但仅仅等待前一个帧完成会降低 GPU 利用率，最终影响性能和效率。）

从概念上看，这与某些 C++ 容器和其他类型使用的写时复制方案有些相似。这也可能与 OpenGL 或 Direct3D 11 内部针对某些类型对象执行的实现相似。

在实践中，这种双重（或三重）缓冲资源是通过在 QRhiResource 后面有固定数量的本地资源（如，VkBuffer）slot 来在 Vulkan、Metal 以及类似的 QRhi 后端中实现的。然后可以通过帧槽索引进行索引，该索引从 0 开始，到 FramesInFlight-1 结束，然后回绕。

所有这些对 QRhi 的用户都是透明的。然而，可能需要将直接使用图形 API 完成的渲染集成的应用程序也进行类似的图形资源双重或三重缓冲。这可以通过知道最大并发帧数（可通过 resourceLimit() 获取）和当前帧（槽）索引（由该函数返回）来实现。

另请参阅 isRecordingFrame()，beginFrame() 和 endFrame。

QRhiDriverInfo QRhi::driverInfo() const

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

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

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

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

flags 可选地用于以某些方式更改行为。传递 QRhi::SkipPresent 将跳过排队 Present 命令或调用 swapBuffers。

在成功时返回QRhi::FrameOpSuccess，或在失败时返回另一个QRhi::FrameOpResult值。其中一些应被视为软错误，即“稍后再尝试”：当返回QRhi::FrameOpSwapChainOutOfDate时，应通过调用QRhiSwapChain::createOrResize()来调整交换链的大小或更新它。然后应用程序应尝试生成一个新的帧。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。

实际上，这对于OpenGL来说始终为false，因为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中检测到，具体取决于后端和底层原生API。最常见的是endFrame，因为在那里进行显示。在一些后端中，QRhiSwapChain::createOrResize()也可以失败，因为这可能是设备丢失。因此，此函数提供了作为一种通用方式来检查之前的操作是否检测到设备丢失。

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

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

Qt 本身基于 QRhi 构建的框架，如 Qt Quick，在设备丢失发生时可以期待能够处理并采取适当的措施。如果图形资源（如纹理和缓冲区）的数据仍然在 CPU 端可用，这种事件在应用级别可能根本不明显，因为图形资源可以无缝重新初始化。然而，直接与 QRhi 共同工作的应用和库应该准备自己检查和处理设备丢失的情况。

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

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

bool QRhi::isRecordingFrame() const

当存在活动帧时返回真，这意味着存在一个没有对应 endFrame() (或 endOffscreenFrame()) 的 beginFrame() (或 beginOffscreenFrame())

另请参阅：currentFrameSlot()，beginFrame() 和 endFrame()。

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

如果通过 flags 修改的指定 format 的纹理受支持，则返回 true

该查询既支持未压缩也支持压缩格式。

bool QRhi::isYUpInFramebuffer() const

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

实际上，这对于 OpenGL 只有 true

bool QRhi::isYUpInNDC() const

如果底层图形 API 在其归一化设备坐标系统中将 Y 轴指向向上，则返回 true

实际上，这对于 Vulkan 只有 false

bool QRhi::makeThreadLocalNativeContextCurrent()

使用 OpenGL，此函数使当前线程上的 OpenGL 上下文成为当前上下文。对于其他后端，此函数没有效果。

调用此函数通常在 Qt 框架代码中相关，当需要确保由应用程序提供的外部 OpenGL 代码还能够像先前直接使用 OpenGL 那样运行时，只要 QRhi 使用 OpenGL 后端。

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

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

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

返回给定size的米级等级数量。

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、子纹理模式mipmapMode以及地址（包装）模式addressU、addressV和addressW。

另请参阅QRhiResource::destroy。

QRhiShaderResourceBindings *QRhi::newShaderResourceBindings()

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

另请参阅QRhiResource::destroy。

QRhiSwapChain *QRhi::newSwapChain()

返回一个新的交换链。

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

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

返回一个新的1D或2D纹理，其具有指定的format、pixelSize、sampleCount和flags。

1D纹理数组必须在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 = {})

返回一个新的1D、2D或3D纹理，其具有指定的format、width、height、depth、sampleCount和flags。

此重载适用于3D纹理，因为它允许指定depth。3D纹理必须在flags中设置QRhiTexture::ThreeDimensional，但使用此重载时可以省略，因为当depth大于0时，标志会隐式设置。对于1D、2D和立方纹理，depth应设置为0。

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

这是一个重载函数。

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

返回一个新的1D或2D纹理数组，其具有指定的format、arraySize、pixelSize、sampleCount和flags。

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

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

另请参阅 newTexture()。

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

返回一个新的纹理渲染目标，其中包含在desc中给出的颜色和深度/模板附加，以及指定的flags。

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

返回一个二进制数据块，其中包含从 QRhi 生命周期内成功创建的 QRhiGraphicsPipeline 和 QRhiComputePipeline 收集的数据。

通过保存这份数据，然后在同一应用的后续运行中重新加载缓存数据，可以潜在减少管道和着色器创建的时间。缓存及其序列化版本的具体内容未指定，始终与使用的后端相关，并且在某些情况下还依赖于图形 API 的特定实现。

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

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

当返回的数据非空时，它始终与 Qt 版本和 QRhi 后端相关。此外，在某些情况下，还依赖于特定的图形设备和使用的确切驱动程序版本。QRhi 负责添加适当的头文件，并确保数据可以安全地传递到 setPipelineCacheData()，因此尝试从其他版本的驱动程序上运行的实例加载数据将被安全且优雅地处理。

有关此功能的更多详细信息，请参阅 EnablePipelineCacheDataSave。

另请参阅：setPipelineCacheData、create 和 isFeatureSupported。

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

如果使用指定的 impl 和 params 调用 create() 预期将会成功，则返回 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对象，从而可能加速管线创建。

在其他 API 中，实际上没有真正的管线缓存，但它们可能提供从着色器编译（D3D）或程序二进制（OpenGL）的字节码的缓存。在运行时执行大量从源进行着色器编译的应用程序中，如果使用此函数从早期运行中预种“管线缓存”，则可以在后续运行中提供显著的提升。

有关此功能的更多详细信息，请参阅 EnablePipelineCacheDataSave。

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

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

返回给定mipLevel的纹理图像大小，它基于在baseLevelSize中给出的级别 0 大小计算。

QRhiStats QRhi::statistics() const

收集并返回有关图形资源计时和分配的统计信息。

只有一些后端提供内存分配的数据，在这些后端中，此类操作处于 Qt 的控制之下。在没有对资源内存分配的较低级控制的图形 API 中，这永远不会得到支持，并且结果中的所有相关字段都是 0。

特别是在 Vulkan 中，值始终有效，并且是从底层内存分配器库检索的。这提供了对活动缓冲区和纹理内存需求的理解。

对于 Direct 3D 12 也是如此。除了内存分配器库的统计信息之外，这里的参数还包括 DXGI 报告的totalUsageBytes字段，该字段报告了包括不在内存分配器库控制之下（交换链缓冲区，描述符堆等）的额外资源在内的总大小。

值对应于所有类型的内存使用，合并计算。（即，在独立 GPU 的情况下，视频+系统）

大多数后端都可以提供有关图形和计算管线创建所花费时间（通常涉及着色器编译或缓存查找，以及可能昂贵的处理）的附加数据。

QList<int> QRhi::supportedSampleCounts() const

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

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

对于某些后端，此支持值列表是预先固定的，而对于其他一些后端，则（物理）设备属性指示运行时支持的内容。

另请参阅QRhiRenderBuffer::setSampleCount、QRhiTexture::setSampleCount、QRhiGraphicsPipeline::setSampleCount和QRhiSwapChain::setSampleCount。

QThread *QRhi::thread() const

返回初始化QRhi的线程。

int QRhi::ubufAligned(int v) const

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

int QRhi::ubufAlignment() const

返回最小统一缓冲区偏移量对齐的字节数。这通常是256。

尝试绑定不与此值对齐的偏移量的统一缓冲区会将导致根据后端和底层图形API出现失败。

另请参阅ubufAligned。

[静态] QRhiSwapChainProxyData QRhi::updateSwapChainProxyData(QRhi::Implementation impl, QWindow *窗口)

生成并返回一个包含与指定的后端和图形API（impl）相关的不透明数据的QRhiSwapChainProxyData结构，窗口是交换链目标的QWindow。

返回的struct可以传递给QRhiSwapChain::setProxyData。这在多线程渲染系统中很有意义：这个静态函数预期在主（GUI）线程上被调用，与所有QRhi操作相反，然后传递给与QRhi和QRhiSwapChain合作的线程，并传递给swapchain。这允许在主线程上调用只能安全调用的本地平台查询，例如从NSView中查询CAMetalLayer，然后将数据传递给渲染线程上的QRhiSwapChain。在Metal示例中，在专门的渲染线程上执行view.layer访问会在Xcode Thread Checker上引发警告。使用数据代理机制可以避免这种情况。

当不涉及线程时，不需要生成和传递QRhiSwapChainProxyData：后端保证能够自行查询所需的一切，并且如果一切都在主（GUI）线程上，那就足够了。