QRhiRenderTarget 类
表示一个屏幕(交换链)或离屏(纹理)渲染目标。 更多信息...
头文件 | #include <QRhiRenderTarget> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake | QT += gui |
自从 | Qt 6.6 |
继承自 | QRhiResource |
由以下类继承 |
公共函数
虚函数 | devicePixelRatio() const = 0 |
virtual QSize | pixelSize() const = 0 |
QRhiRenderPassDescriptor * | renderPassDescriptor() const |
virtual int | sampleCount() const = 0 |
void | setRenderPassDescriptor(QRhiRenderPassDescriptor *desc) |
详细描述
应用程序不会直接创建该类的实例。相反,它是由 API 的客户端通过 newTextureRenderTarget() 可实例化的子类 QRhiTextureRenderTarget。另一个子类是 QRhiSwapChainRenderTarget,它是当调用 currentFrameRenderTarget() 时 QRhiSwapChain 返回的类型。
注意:这是一个具有有限兼容性保证的 RHI API,有关详细信息,请参阅 QRhi。
另请参阅:QRhiSwapChainRenderTarget 和 QRhiTextureRenderTarget。
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。
[纯虚函数]
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.的商标。所有其他商标均为其各自所有者的财产。