QRhiRenderTarget Class

オンスクリーン(スワップチェーン)またはオフスクリーン(テクスチャ)のレンダーターゲットを表します。詳細...

ヘッダー #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
以来:Qt 6.6
を継承する: QRhiResource
継承元

QRhiSwapChainRenderTarget そしてQRhiTextureRenderTarget

パブリック関数

virtual float devicePixelRatio() const = 0
virtual QSize pixelSize() const = 0
QRhiRenderPassDescriptor *renderPassDescriptor() const
virtual int sampleCount() const = 0
void setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

詳細説明

アプリケーションはこのクラスのインスタンスを直接生成しない。むしろ、newTextureRenderTarget ()を介してAPIのクライアントがインスタンス化できるのは、QRhiTextureRenderTarget のサブクラスである。もう 1 つのサブクラスはQRhiSwapChainRenderTarget で、これはQRhiSwapChaincurrentFrameRenderTarget() を呼び出したときに返す型です。

注: これは互換性保証に制限のあるRHI APIです。詳細はQRhi を参照してください。

QRhiSwapChainRenderTarget およびQRhiTextureRenderTargetも参照のこと

メンバ関数ドキュメント

[pure virtual] float QRhiRenderTarget::devicePixelRatio() const

デバイスのピクセル比率を返します。QRhiTextureRenderTarget の場合、これは常に1である。QRhiSwapChain から取得されたターゲットの場合、値はターゲットQWindowdevice pixel ratio を反映する。

[pure virtual] QSize QRhiRenderTarget::pixelSize() const

サイズをピクセル単位で返します。

create()が正常に呼び出された後にのみ有効。それまでは、デフォルトのQSize が返されます。

QRhiTextureRenderTarget の場合、返されるサイズは create() 時点の関連アタッチメントのサイズであり、実際には最初のカラーアタッチメントのサイズ、またはカラーアタッチメントがない場合は深度/ステンシルバッファのサイズとなります。関連するテクスチャまたはレンダーバッファのサイズが変更され、その後再構築される場合、pixelSize() は、基礎となるデータ構造を再構築するために create() への暗黙の呼び出しを実行します。この暗黙のチェックは、QRhiCommandBuffer::beginPass() が行うことと似ており、返されるサイズが常に最新であることを保証します。

QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const

関連するQRhiRenderPassDescriptor を返す。

setRenderPassDescriptor()も参照

[pure virtual] int QRhiRenderTarget::sampleCount() const

マルチサンプルアンチエイリアシングがこのレンダーターゲットに関連しない場合は、サンプルカウントまたは1を返します。

void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

このレンダーターゲットで使用するQRhiRenderPassDescriptor desc を設定します。

renderPassDescriptor()も参照してください

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.