QRhiReadbackDescription Class
Beschreibt einen Readback-Vorgang (das Zurücklesen von Texturinhalten aus möglicherweise ausschließlich auf der GPU befindlichem Speicher). Mehr...
| Header: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Seit: | Qt 6.6 |
Öffentliche Funktionen
| QRhiReadbackDescription() | |
| QRhiReadbackDescription(QRhiTexture *texture) | |
| int | layer() const |
| int | level() const |
(since 6.10) QRect | rect() const |
| void | setLayer(int layer) |
| void | setLevel(int level) |
(since 6.10) void | setRect(const QRect &rectangle) |
| void | setTexture(QRhiTexture *tex) |
| QRhiTexture * | texture() const |
Ausführliche Beschreibung
Die Quelle der Readback-Operation ist entweder ein „ QRhiTexture “ oder der aktuelle Backbuffer des aktuell als Ziel festgelegten „ QRhiSwapChain “. Wenn „ texture()“ nicht festgelegt ist, wird die Swapchain verwendet. Andernfalls wird der angegebene „ QRhiTexture “ als Quelle behandelt.
Hinweis: Texturen , die bei Readbacks verwendet werden, müssen mit ` QRhiTexture::UsedAsTransferSource` erstellt worden sein.
Hinweis: Die bei Readbacks verwendetenSwapchains müssen mit ` QRhiSwapChain::UsedAsTransferSource` erstellt werden.
layer() und ` level()` sind nur anwendbar, wenn die Quelle ein ` QRhiTexture` ist.
Hinweis: Multisample- Texturen können nicht zurückgelesen werden. Das Zurücklesen wird jedoch für Multisample-Swapchain-Puffer unterstützt.
Hinweis: Hierbei handelt es sich um eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Dokumentation der Member-Funktionen
[constexpr noexcept default] QRhiReadbackDescription::QRhiReadbackDescription()
Erstellt eine leere Beschreibung für das Zurücklesen einer Textur.
Hinweis: Die Quelltextur ist standardmäßig auf „null“ gesetzt, was dennoch ein gültiges Readback darstellt: Es gibt an, dass der Backbuffer der aktuellen Swapchain zurückgelesen werden soll. (Mit „aktuell“ ist die Ziel-Swapchain des Frames zum Zeitpunkt des Commits von „ QRhiResourceUpdateBatch “ mit dem darauf befindlichen „ texture readback “ gemeint.)
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
Erstellt eine Beschreibung für das Zurücklesen einer Textur, die angibt, dass Ebene 0 von Layer 0 von texture zurückgelesen werden soll.
Hinweis: „ texture “ kann auch null sein; in diesem Fall entspricht dieser Konstruktor der Variante ohne Argumente.
int QRhiReadbackDescription::layer() const
Gibt die aktuell eingestellte Array-Ebene zurück (Cubemap-Fläche, Array-Index). Der Standardwert ist 0.
Gilt nur, wenn die Quelle des Rücklesens ein „ QRhiTexture “ ist.
Siehe auch ` setLayer()`.
int QRhiReadbackDescription::level() const
Gibt die aktuell eingestellte Mip-Stufe zurück. Der Standardwert ist 0.
Gilt nur, wenn die Quelle des Readbacks ein ` QRhiTexture` ist.
Siehe auch ` setLevel()`.
[since 6.10] QRect QRhiReadbackDescription::rect() const
Gibt das Rechteck zurück, das zurückgelesen werden soll. Standardmäßig wird ein ungültiges Rechteck zurückgegeben.
Ist das Rechteck ungültig, wird die gesamte Textur oder der gesamte Swapchain-Backbuffer zurückgelesen.
Diese Funktion wurde in Qt 6.10 eingeführt.
Siehe auch ` setRect()`.
void QRhiReadbackDescription::setLayer(int layer)
Legt das Array „ layer “ für das Zurücklesen fest.
Siehe auch ` layer()`.
void QRhiReadbackDescription::setLevel(int level)
Legt die Mip- level fest, die zurückgelesen werden soll.
Siehe auch level().
[since 6.10] void QRhiReadbackDescription::setRect(const QRect &rectangle)
Legt die „ rectangle “ für das Zurücklesen fest.
Diese Funktion wurde in Qt 6.10 eingeführt.
Siehe auch ` rect()`.
void QRhiReadbackDescription::setTexture(QRhiTexture *tex)
Legt die Textur „ tex “ als Quelle für den Readback-Vorgang fest.
Die Einstellung „ nullptr “ ist ebenfalls zulässig; in diesem Fall wird der aktuelle Backbuffer der aktuellen Swapchain verwendet. (Allerdings kann der Readback-Befehl dann 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 bei Rücklesevorgängen verwendet werden, müssen mit ` QRhiTexture::UsedAsTransferSource` erstellt worden sein.
Hinweis: Die bei Readbacks verwendetenSwapchains müssen mit ` QRhiSwapChain::UsedAsTransferSource` erstellt werden.
Siehe auch ` texture()`.
QRhiTexture *QRhiReadbackDescription::texture() const
Gibt den zurückgelesenen „ QRhiTexture “ zurück. Kann auf „ nullptr “ gesetzt bleiben, was angibt, dass stattdessen der Backbuffer der aktuellen Swapchain verwendet werden soll.
Siehe auch setTexture().
© 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.
