QRhiReadbackDescription Class
リードバック（GPU専用メモリからテクスチャの内容を読み出す）操作について説明します。詳細...
| ヘッダー | #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 |
パブリック関数
| QRhiReadbackDescription() | |
| QRhiReadbackDescription(QRhiTexture *texture) | |
| int | layer() const |
| int | level() const |
| void | setLayer(int layer) |
| void | setLevel(int level) |
| void | setTexture(QRhiTexture *tex) |
| QRhiTexture * | texture() const |
詳細説明
リードバック操作のソースは、QRhiTexture または現在ターゲットになっているQRhiSwapChain の現在のバックバッファのいずれかです。texture() が設定されていない場合、スワップチェーンが使用される。それ以外の場合は、指定されたQRhiTexture がソースとして扱われます。
注意： リードバックで使用されるテクスチャは、QRhiTexture::UsedAsTransferSource で作成する必要があります。
注意： リードバックで使用されるスワップチェーンはQRhiSwapChain::UsedAsTransferSource で作成する必要があります。
layer() およびlevel() は、ソースがQRhiTexture の場合にのみ適用されます。
注： マルチサンプルテクスチャはリードバックできません。ただし、リードバックはマルチサンプルのスワップチェーンバッファではサポートされています。
注： これは互換性保証に制限のあるRHI APIです。詳細はQRhi を参照してください。
メンバー関数ドキュメント
[constexpr noexcept] QRhiReadbackDescription::QRhiReadbackDescription()
空のテクスチャリードバック記述を構築します。
Note: デフォルトではソーステクスチャはnullに設定されていますが、これはまだ有効なリードバックです。(カレントとは、texture readback でQRhiResourceUpdateBatch をコミットした時点のフレームのターゲット swapchain を意味します)
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
texture のレイヤー 0 のレベル 0 がリードバックされることを指定するテクスチャ リードバック記述を構築する。
注意: texture は null にすることもできます。その場合、このコンストラクタは引数のないバリアントと同じになります。
int QRhiReadbackDescription::layer() const
現在設定されている配列レイヤー（キューブマップ面、配列インデックス）を返します。デフォルトは 0。
リードバックのソースがQRhiTexture の場合のみ有効です。
setLayer()も参照してください 。
int QRhiReadbackDescription::level() const
現在設定されている mip レベルを返す。デフォルトは0。
リードバックのソースがQRhiTexture の場合にのみ適用される。
setLevel()も参照 。
void QRhiReadbackDescription::setLayer(int layer)
読み戻す配列layer を設定する。
layer()も参照のこと 。
void QRhiReadbackDescription::setLevel(int level)
読み返す miplevel を設定する。
level()も参照のこと 。
void QRhiReadbackDescription::setTexture(QRhiTexture *tex)
テクスチャtex をリードバック操作のソースとして設定します。
nullptr この場合、現在のスワップチェーンの現在のバックバッファが使用されます。(ただし、その場合、リードバックはスワップチェーンベースでないフレームでは発行できません)
注： マルチサンプルテクスチャはリードバックできません。ただし、マルチサンプルのスワップチェーンバッファのリードバックはサポートされています。
Note: リードバックで使用されるテクスチャはQRhiTexture::UsedAsTransferSource で作成する必要があります。
注意： リードバックで使用されるスワップチェーンはQRhiSwapChain::UsedAsTransferSource で作成する必要があります。
texture()も参照 。
QRhiTexture *QRhiReadbackDescription::texture() const
読み戻すQRhiTexture を返す。現在のスワップチェーンのバックバッファが代わりに使われることを示すnullptr をセットしたままにすることもできる。
setTexture()も参照 。
© 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.
