QRhiReadbackDescription Class
Beschreibt eine Readback-Operation (Zurücklesen von Texturinhalten aus einem möglicherweise GPU-only-Speicher). Mehr...
| Kopfzeile: | #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 |
Öffentliche Funktionen
| 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 |
Detaillierte Beschreibung
Die Quelle der Readback-Operation ist entweder ein QRhiTexture oder der aktuelle Backbuffer des aktuell anvisierten QRhiSwapChain. Wenn texture() nicht gesetzt ist, wird die Swapchain verwendet. Andernfalls wird die angegebene QRhiTexture als Quelle behandelt.
Hinweis: Texturen, die in Readbacks verwendet werden, müssen mit QRhiTexture::UsedAsTransferSource erstellt werden.
Hinweis: Swapchains, die in Readbacks verwendet werden, müssen mit QRhiSwapChain::UsedAsTransferSource erstellt werden.
layer() und level() sind nur anwendbar, wenn die Quelle eine QRhiTexture ist.
Hinweis: Multisample-Texturen können nicht zurückgelesen werden. Rücklesungen werden jedoch für Multisample-Swapchain-Puffer unterstützt.
Hinweis: Dies ist eine RHI-API mit begrenzten Kompatibilitätsgarantien, siehe QRhi für Details.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept] QRhiReadbackDescription::QRhiReadbackDescription()
Konstruiert eine leere Textur-Rücklesebeschreibung.
Hinweis: Die Quelltextur ist standardmäßig auf null gesetzt, was immer noch ein gültiges Readback ist: Es gibt an, dass der Backbuffer der aktuellen Swapchain zurückgelesen werden soll. (aktuell bedeutet die Ziel-Swapchain des Frames zum Zeitpunkt der Übergabe der QRhiResourceUpdateBatch mit der texture readback )
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
Konstruiert eine Textur-Rücklesebeschreibung, die angibt, dass Ebene 0 der Schicht 0 von texture zurückgelesen werden soll.
Hinweis: texture kann auch null sein. In diesem Fall ist dieser Konstruktor identisch mit der argumentlosen Variante.
int QRhiReadbackDescription::layer() const
Gibt die aktuell eingestellte Array-Ebene (Cubemap-Fläche, Array-Index) zurück. Der Standardwert ist 0.
Nur anwendbar, wenn die Quelle des Readbacks eine QRhiTexture ist.
Siehe auch setLayer().
int QRhiReadbackDescription::level() const
Gibt den aktuell eingestellten Mip-Level zurück. Der Standardwert ist 0.
Nur anwendbar, wenn die Quelle des Readbacks eine QRhiTexture ist.
Siehe auch setLevel().
void QRhiReadbackDescription::setLayer(int layer)
Setzt das Array layer zum Zurücklesen.
Siehe auch layer().
void QRhiReadbackDescription::setLevel(int level)
Legt die mip level fest, die zurückgelesen werden soll.
Siehe auch level().
void QRhiReadbackDescription::setTexture(QRhiTexture *tex)
Legt die Textur tex als Quelle für die Rückleseoperation fest.
Die Einstellung nullptr ist ebenfalls gültig, in diesem Fall wird der aktuelle Backbuffer der aktuellen Swapchain verwendet. (aber dann kann das Zurücklesen nicht in einem nicht-swapchain-basierten Frame ausgegeben werden)
Hinweis: Multisample-Texturen können nicht zurückgelesen werden. Readbacks werden jedoch für Multisample-Swapchain-Puffer unterstützt.
Hinweis: Texturen, die in Readbacks verwendet werden, müssen mit QRhiTexture::UsedAsTransferSource erstellt werden.
Hinweis: Swapchains, die in Readbacks verwendet werden, müssen mit QRhiSwapChain::UsedAsTransferSource erstellt werden.
Siehe auch texture().
QRhiTexture *QRhiReadbackDescription::texture() const
Gibt die QRhiTexture zurück, die zurückgelesen wird. Kann auf nullptr gesetzt werden, was anzeigt, dass stattdessen der Backbuffer der aktuellen Swapchain verwendet werden soll.
Siehe auch 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.
