QRhiTextureCopyDescription Class
Décrit une opération de copie de texture à texture. 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
| 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
Un pixelSize vide () indique que la totalité de la sous-ressource doit être copiée. Une description de copie construite par défaut conduit donc à copier l'intégralité de la sous-ressource au niveau 0 de la couche 0.
Remarque : la texture source doit être créée avec QRhiTexture::UsedAsTransferSource.
Remarque : Les rectangles source et destination définis par pixelSize(), sourceTopLeft() et destinationTopLeft() doivent correspondre aux textures source et destination, respectivement. 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 des couches source et destination. Avec les textures mipmappées, un niveau mip peut être copié à la fois. Les indices des couches source et destination et du niveau mip peuvent être différents, 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 avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.
Documentation des fonctions membres
[constexpr noexcept] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Construit une description de copie de texture vide.
int QRhiTextureCopyDescription::destinationLayer() const
Renvoie la couche du tableau de destination (face du cubemap ou index de la couche du tableau). La valeur par défaut est 0.
Voir aussi setDestinationLayer().
int QRhiTextureCopyDescription::destinationLevel() const
Renvoie le niveau du mip de déstionnement. La valeur par défaut est 0.
Voir aussi setDestinationLevel().
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Renvoie la position haut-gauche de la description en pixels. La valeur par défaut est (0, 0).
Voir également setDestinationTopLeft().
QSize QRhiTextureCopyDescription::pixelSize() const
Renvoie la taille de la région à copier.
Note : Un pixelSize() vide indique que la totalité de la sous-ressource doit être copiée. Une description de copie construite par défaut conduit donc à copier l'intégralité de la sous-ressource 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 aussi destinationLevel().
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
Définit la position en haut à gauche de la destination p.
Voir aussi destinationTopLeft().
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
Définit la taille de la région à copier sur sz.
Voir aussi pixelSize().
void QRhiTextureCopyDescription::setSourceLayer(int layer)
Définit le tableau source layer.
Voir aussi sourceLayer().
void QRhiTextureCopyDescription::setSourceLevel(int level)
Définit le mip source level.
Voir aussi sourceLevel().
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
Fixe la position haut-gauche de la source à p.
Voir aussi sourceTopLeft().
int QRhiTextureCopyDescription::sourceLayer() const
Renvoie la couche du tableau source (face du cubemap ou index de la couche du tableau). La valeur par défaut est 0.
Voir aussi setSourceLayer().
int QRhiTextureCopyDescription::sourceLevel() const
Renvoie le niveau du mip source. La valeur par défaut est 0.
Voir aussi setSourceLevel().
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Renvoie la position de la source en haut à gauche (en pixels). La valeur par défaut est (0, 0).
Voir également 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.
