QRhiRenderTarget 类

表示一个屏幕(交换链)或离屏(纹理)渲染目标。 更多信息...

头文件 #include <QRhiRenderTarget>
CMakefind_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmakeQT += gui
自从Qt 6.6
继承自 QRhiResource
由以下类继承

QRhiSwapChainRenderTargetQRhiTextureRenderTarget

公共函数

虚函数devicePixelRatio() const = 0
virtual QSizepixelSize() const = 0
QRhiRenderPassDescriptor *renderPassDescriptor() const
virtual intsampleCount() const = 0
voidsetRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

详细描述

应用程序不会直接创建该类的实例。相反,它是由 API 的客户端通过 newTextureRenderTarget() 可实例化的子类 QRhiTextureRenderTarget。另一个子类是 QRhiSwapChainRenderTarget,它是当调用 currentFrameRenderTarget() 时 QRhiSwapChain 返回的类型。

注意:这是一个具有有限兼容性保证的 RHI API,有关详细信息,请参阅 QRhi

另请参阅:QRhiSwapChainRenderTargetQRhiTextureRenderTarget

Memeber Function 文档

[纯虚函数] float QRhiRenderTarget::devicePixelRatio() const

返回设备像素比例。对于 QRhiTextureRenderTarget,此值为 1。对于从 QRhiSwapChain 获取的目标,此值反映目标 QWindow设备像素比例

[纯虚函数] QSize QRhiRenderTarget::pixelSize() const

返回像素大小。

只有在调用 create() 成功后才是有效的。在此之前,结果是默认构造的 QSize

使用QRhiTextureRenderTarget时,返回的大小是创建()时关联附件的大小,实际上为第一个颜色附件的大小,如果没有颜色附件则为深度/模板缓冲区的大小。如果后续调整关联的纹理或渲染缓冲区的大小并重新构建,则pixelSize()会隐式调用create()以重建底层数据结构。这种隐式检查与QRhiCommandBuffer::beginPass()所做的是相似的,并确保返回的大小始终是最新的。

QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const

返回关联的QRhiRenderPassDescriptor

另请参阅setRenderPassDescriptor

[纯虚函数] int QRhiRenderTarget::sampleCount() const

返回采样数,如果没有多采样抗锯齿与该渲染目标相关,则返回1。

void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

设置QRhiRenderPassDescriptor desc 以用于该渲染目标。

另请参阅renderPassDescriptor

© 2024 The Qt Company Ltd. 此处包含的文档贡献者是各自所有者的版权。在此提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt及其相应标志是芬兰及/或世界其他地区的The Qt Company Ltd.的商标。所有其他商标均为其各自所有者的财产。