QRhiTextureCopyDescription Class
Beschreibt eine Textur-zu-Textur-Kopieroperation. 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
| 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 |
Detaillierte Beschreibung
Ein leeres pixelSize() zeigt an, dass die gesamte Subresource kopiert werden soll. Eine standardmäßig konstruierte Kopierbeschreibung führt daher zum Kopieren der gesamten Subresource auf Ebene 0 der Schicht 0.
Hinweis: Die Quelltextur muss mit QRhiTexture::UsedAsTransferSource erstellt werden.
Hinweis : Die mit pixelSize(), sourceTopLeft() und destinationTopLeft() definierten Quell- und Zielrechtecke müssen in die Quell- bzw. Zieltextur passen. Andernfalls ist das Verhalten undefiniert.
Bei Cubemaps, 3D-Texturen und Texturarrays kann jeweils eine Fläche oder ein Slice kopiert werden. Die Fläche bzw. das Slice wird durch die Indizes der Quell- und Zielebene angegeben. Bei Mipmapped-Texturen kann jeweils eine Mip-Ebene kopiert werden. Die Indizes der Quell- und Zielebene und der Mip-Ebene können unterschiedlich sein, aber die Größe und Position müssen sorgfältig kontrolliert werden, um Kopien außerhalb der Grenzen zu vermeiden.
Hinweis: Dies ist eine RHI-API mit eingeschränkten Kompatibilitätsgarantien, siehe QRhi für Details.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Konstruiert eine leere Texturkopie-Beschreibung.
int QRhiTextureCopyDescription::destinationLayer() const
Gibt die Ziel-Array-Ebene zurück (Cubemap-Fläche oder Array-Ebenenindex). Standardwert ist 0.
Siehe auch setDestinationLayer().
int QRhiTextureCopyDescription::destinationLevel() const
Liefert den Zerstörungsgrad der Mip-Ebene. Der Standardwert ist 0.
Siehe auch setDestinationLevel().
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Gibt die obere linke Position des Bildes in Pixeln zurück. Der Standardwert ist (0, 0).
Siehe auch setDestinationTopLeft().
QSize QRhiTextureCopyDescription::pixelSize() const
Gibt die Größe der zu kopierenden Region zurück.
Hinweis: Ein leeres pixelSize() bedeutet, dass die gesamte Subresource kopiert werden soll. Eine standardmäßig konstruierte Kopierbeschreibung führt daher zum Kopieren der gesamten Subresource auf Ebene 0 der Ebene 0.
Siehe auch setPixelSize().
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
Legt das Zielfeld layer fest.
Siehe auch destinationLayer().
void QRhiTextureCopyDescription::setDestinationLevel(int level)
Legt das Ziel mip level fest.
Siehe auch destinationLevel().
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
Legt die obere linke Position des Ziels p fest.
Siehe auch destinationTopLeft().
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
Legt die Größe des zu kopierenden Bereichs auf sz fest.
Siehe auch pixelSize().
void QRhiTextureCopyDescription::setSourceLayer(int layer)
Legt das Quell-Array layer fest.
Siehe auch sourceLayer().
void QRhiTextureCopyDescription::setSourceLevel(int level)
Setzt die Quelle mip level.
Siehe auch sourceLevel().
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
Setzt die obere linke Position der Quelle auf p.
Siehe auch sourceTopLeft().
int QRhiTextureCopyDescription::sourceLayer() const
Gibt die Quell-Array-Ebene zurück (Cubemap-Fläche oder Array-Ebenenindex). Der Standardwert ist 0.
Siehe auch setSourceLayer().
int QRhiTextureCopyDescription::sourceLevel() const
Gibt den Quell-Mip-Level zurück. Der Standardwert ist 0.
Siehe auch setSourceLevel().
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Liefert die Position der Quelle oben links (in Pixel). Der Standardwert ist (0, 0).
Siehe auch setSourceTopLeft().
© 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.
