QRhiRenderTarget Class

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

Header: #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
Since: Qt 6.6
Inherits: QRhiResource
Inherited By:

QRhiSwapChainRenderTarget and 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()も参照してください

©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。