QRhiReadbackDescription Class
リードバック（GPU専用メモリからテクスチャの内容を読み出す）操作について説明します。詳細...
| 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 |
パブリック関数
| 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()
空のテクスチャリードバック記述を構築します。
注意： ソーステクスチャはデフォルトでnullに設定されますが、これはまだ有効なリードバックです：これは、現在のスワップチェーンのバックバッファがリードバックされることを指定します。(カレントとは、texture readback でQRhiResourceUpdateBatch をコミットした時点のフレームのターゲット swapchain を意味します)
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
texture のレイヤー 0 のレベル 0 がリードバックされることを指定するテクスチャ・リードバック記述を構築します。
注意： texture は null にすることもできます。その場合、このコンストラクタは引数なしのバリアントと同じです。
int QRhiReadbackDescription::layer() const
現在設定されている配列レイヤー (cubemap 面、配列インデックス) を返します。デフォルトは 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()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
