QRhiReadbackDescription Class
Décrit une opération de relecture (lecture du contenu d'une texture à partir d'une mémoire éventuellement réservée au GPU). Plus d'informations...
| En-tête : | #include <rhi/qrhi.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake : | QT += gui-private |
| Depuis : | Qt 6.6 |
Fonctions publiques
| 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 |
Description détaillée
La source de l'opération de relecture est soit une QRhiTexture, soit le backbuffer actuel de la QRhiSwapChain ciblée. Si texture() n'est pas défini, la chaîne d'échange est utilisée. Dans le cas contraire, l'adresse QRhiTexture spécifiée est considérée comme la source.
Remarque : les textures utilisées dans les readbacks doivent être créées avec QRhiTexture::UsedAsTransferSource.
Note : Les chaînes de permutation utilisées dans les readbacks doivent être créées avec QRhiSwapChain::UsedAsTransferSource.
layer() et level() ne s'appliquent que lorsque la source est QRhiTexture.
Remarque : les textures multi-échantillons ne peuvent pas être relues. Les retours en arrière sont toutefois pris en charge pour les tampons de chaîne d'échange multi-échantillons.
Note : Il s'agit d'une API RHI avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.
Documentation des fonctions membres
[constexpr noexcept] QRhiReadbackDescription::QRhiReadbackDescription()
Construit une description de lecture de texture vide.
Note : La texture source est mise à null par défaut, ce qui est toujours un readback valide : il spécifie que le backbuffer de la chaîne d'échange actuelle doit être relu. (courant signifie la chaîne d'échange cible de la trame au moment de la validation de QRhiResourceUpdateBatch avec texture readback ).
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
Construit une description de lecture de texture qui spécifie que le niveau 0 de la couche 0 de texture doit être lu.
Remarque : texture peut également être nul, auquel cas ce constructeur est identique à la variante sans argument.
int QRhiReadbackDescription::layer() const
Renvoie la couche de tableau actuellement définie (face de cubemap, index de tableau). La valeur par défaut est 0.
Applicable uniquement lorsque la source du readback est un QRhiTexture.
Voir aussi setLayer().
int QRhiReadbackDescription::level() const
Renvoie le niveau de mip actuellement défini. La valeur par défaut est 0.
Applicable uniquement lorsque la source de la lecture est QRhiTexture.
Voir également setLevel().
[since 6.10] QRect QRhiReadbackDescription::rect() const
Renvoie le rectangle à relire. Par défaut, il s'agit d'un rectangle invalide.
S'il n'est pas valide, la texture entière ou le backbuffer de la chaîne d'échange est lu.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi setRect().
void QRhiReadbackDescription::setLayer(int layer)
Définit le tableau layer à relire.
Voir aussi layer().
void QRhiReadbackDescription::setLevel(int level)
Définit le mip level à lire en retour.
Voir aussi level().
[since 6.10] void QRhiReadbackDescription::setRect(const QRect &rectangle)
Définit l'adresse rectangle à lire en retour.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi rect().
void QRhiReadbackDescription::setTexture(QRhiTexture *tex)
Définit la texture tex comme source de l'opération de relecture.
La valeur nullptr est également valable, auquel cas le backbuffer actuel de la chaîne d'échange est utilisé. (mais dans ce cas, la lecture ne peut pas être effectuée dans une trame non basée sur la chaîne d'échange).
Remarque : les textures multi-échantillons ne peuvent pas être relues. Les retours en arrière sont cependant supportés pour les tampons de chaînes d'échange multi-échantillons.
Note : Les textures utilisées dans les readbacks doivent être créées avec QRhiTexture::UsedAsTransferSource.
Remarque : Les chaînes d'échange utilisées dans les relectures doivent être créées à l'aide de QRhiSwapChain::UsedAsTransferSource.
Voir également texture().
QRhiTexture *QRhiReadbackDescription::texture() const
Retourne le QRhiTexture qui est relu. Peut être laissé à nullptr qui indique que le backbuffer de la chaîne d'échange actuelle doit être utilisé à la place.
Voir aussi 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.
