QRhiRenderTarget Class
画面上（スワップチェーン）または画面外（テクスチャ）のレンダリングターゲットを表します。詳細...
| ヘッダー： | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| 以下のように: | Qt 6.6 |
| 継承元: | QRhiResource |
| 継承元: |
パブリック関数
| virtual float | devicePixelRatio() const = 0 |
| virtual QSize | pixelSize() const = 0 |
| QRhiRenderPassDescriptor * | renderPassDescriptor() const |
| virtual int | sampleCount() const = 0 |
| void | setRenderPassDescriptor(QRhiRenderPassDescriptor *desc) |
詳細な説明
アプリケーションはこのクラスのインスタンスを直接作成しません。代わりに、APIのクライアントがnewTextureRenderTarget() を通じてインスタンス化できるのは、サブクラスであるQRhiTextureRenderTarget です。もう1つのサブクラスはQRhiSwapChainRenderTarget であり、これはcurrentFrameRenderTarget() を呼び出した際にQRhiSwapChain が返す型です。
注：これは 互換性の保証が限定されている RHI API です。詳細については、QRhi を参照してください。
QRhiSwapChainRenderTarget およびQRhiTextureRenderTargetも参照してください 。
メンバ関数のドキュメント
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
デバイスピクセル比を返します。QRhiTextureRenderTarget の場合、この値は常に 1 です。QRhiSwapChain から取得したターゲットについては、この値は対象のQWindow のdevice 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()も参照してください 。
© 2026 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.
