QRhiTextureCopyDescription Class
Décrit une opération de copie de texture vers texture. En savoir plus...
| 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
| QRhiTextureCopyDescription() | |
| int | destinationLayer() const |
| int | destinationLevel() const |
| QPoint | destinationTopLeft() const |
| QSize | pixelSize() const |
| void | setDestinationLayer(int layer) |
| void | setDestinationLevel(int level) |
| void | setDestinationTopLeft(const QPoint &p) |
| void | setPixelSize(const QSize &sz) |
| void | setSourceLayer(int layer) |
| void | setSourceLevel(int level) |
| void | setSourceTopLeft(const QPoint &p) |
| int | sourceLayer() const |
| int | sourceLevel() const |
| QPoint | sourceTopLeft() const |
Description détaillée
Une description de copie vide ( pixelSize()) indique que la sous-ressource entière doit être copiée. Une description de copie construite par défaut entraîne donc la copie de la sous-ressource entière au niveau 0 de la couche 0.
Remarque : la texture source doit être créée à l’aide de ` QRhiTexture::UsedAsTransferSource`.
Remarque : les rectangles source et destination définis par ` pixelSize()`, ` sourceTopLeft()` et ` destinationTopLeft()` doivent respectivement correspondre aux textures source et destination. Dans le cas contraire, le comportement est indéfini.
Avec les cubemaps, les textures 3D et les tableaux de textures, une face ou une tranche peut être copiée à la fois. La face ou la tranche est spécifiée par les indices de couche source et de destination. Avec les textures mipmappées, un niveau de mip peut être copié à la fois. Les indices de couche et de niveau de mip de source et de destination peuvent différer, mais la taille et la position doivent être soigneusement contrôlées pour éviter les copies hors limites, auquel cas le comportement est indéfini.
Remarque : il s’agit d’une API RHI dont la compatibilité est garantie de manière limitée ; pour plus de détails, consultez QRhi.
Documentation des fonctions membres
[constexpr noexcept default] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Crée une description de copie de texture vide.
int QRhiTextureCopyDescription::destinationLayer() const
Renvoie la couche de tableau de destination (face de cubemap ou index de la couche de tableau). Valeur par défaut : 0.
Voir aussi setDestinationLayer().
int QRhiTextureCopyDescription::destinationLevel() const
Renvoie le niveau MIP de destination. La valeur par défaut est 0.
Voir aussi setDestinationLevel().
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Renvoie la position en haut à gauche de la destination, en pixels. La valeur par défaut est (0, 0).
Voir aussi setDestinationTopLeft().
QSize QRhiTextureCopyDescription::pixelSize() const
Renvoie la taille de la région à copier.
Remarque : une valeur vide de la fonction `pixelSize()` indique que la sous-ressource doit être copiée dans son intégralité. Une description de copie construite par défaut entraîne donc la copie de la sous-ressource entière au niveau 0 de la couche 0.
Voir également setPixelSize().
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
Définit le tableau de destination layer.
Voir également destinationLayer().
void QRhiTextureCopyDescription::setDestinationLevel(int level)
Définit le mip de destination level.
Voir également destinationLevel().
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
Définit la position en haut à gauche de la destination p.
Voir également destinationTopLeft().
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
Définit la taille de la zone à copier vers sz.
Voir également pixelSize().
void QRhiTextureCopyDescription::setSourceLayer(int layer)
Définit le tableau source layer.
Voir également sourceLayer().
void QRhiTextureCopyDescription::setSourceLevel(int level)
Définit l'level de mip de source.
Voir aussi sourceLevel().
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
Définit la position en haut à gauche de la source sur p.
Voir également sourceTopLeft().
int QRhiTextureCopyDescription::sourceLayer() const
Renvoie la couche de tableau source (face de cubemap ou index de couche de tableau). La valeur par défaut est 0.
Voir aussi setSourceLayer().
int QRhiTextureCopyDescription::sourceLevel() const
Renvoie le niveau MIP source. La valeur par défaut est 0.
Voir aussi setSourceLevel().
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Renvoie la position d'origine en haut à gauche (en pixels). La valeur par défaut est (0, 0).
Voir aussi setSourceTopLeft().
© 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.
