QRhiTextureCopyDescription Class
Beschreibt einen Kopiervorgang von Textur zu Textur. 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
| 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()` gibt an, dass die gesamte Unterressource kopiert werden soll. Eine standardmäßig konstruierte Kopierbeschreibung führt daher zum Kopieren der gesamten Unterressource auf Ebene 0 der Schicht 0.
Hinweis: Die Quelltextur muss mit ` QRhiTexture::UsedAsTransferSource` erstellt worden sein.
Hinweis: Die durch ` pixelSize()`, ` sourceTopLeft()` und ` destinationTopLeft()` definierten Quell- und Zielrechtecke müssen jeweils zu den Quell- und Zieltexturen passen. Andernfalls ist das Verhalten undefiniert.
Bei Cubemaps, 3D-Texturen und Textur-Arrays kann jeweils eine Fläche oder eine Scheibe kopiert werden. Die Fläche oder Scheibe wird durch die Quell- und Ziel-Layer-Indizes angegeben. Bei Mipmap-Texturen kann jeweils eine Mip-Stufe kopiert werden. Die Indizes für die Quell- und Ziel-Ebene sowie die Mip-Stufe können voneinander abweichen, jedoch müssen Größe und Position sorgfältig kontrolliert werden, um Kopiervorgänge außerhalb des zulässigen Bereichs zu vermeiden; in diesem Fall ist das Verhalten undefiniert.
Hinweis: Dies ist eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Dokumentation der Member-Funktionen
[constexpr noexcept default] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Erstellt eine leere Texturkopierbeschreibung.
int QRhiTextureCopyDescription::destinationLayer() const
Gibt die Ziel-Array-Ebene zurück (Cubemap-Fläche oder Array-Ebenen-Index). Standardwert ist 0.
Siehe auch „ setDestinationLayer()“.
int QRhiTextureCopyDescription::destinationLevel() const
Gibt die Mip-Stufe des Ziels zurück. Der Standardwert ist 0.
Siehe auch „ setDestinationLevel()“.
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Gibt die Position des Zielpunkts oben links in Pixeln zurück. Der Standardwert ist (0, 0).
Siehe auch „ setDestinationTopLeft()“.
QSize QRhiTextureCopyDescription::pixelSize() const
Gibt die Größe des zu kopierenden Bereichs zurück.
Hinweis: Ein leererWert von `pixelSize()` bedeutet, dass die gesamte Subressource kopiert werden soll. Eine standardmäßig erstellte Kopierbeschreibung führt daher dazu, dass die gesamte Subressource auf Ebene 0 von Ebene 0 kopiert wird.
Siehe auch ` setPixelSize()`.
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
Legt das Ziel-Array fest: layer.
Siehe auch destinationLayer().
void QRhiTextureCopyDescription::setDestinationLevel(int level)
Legt die Ziel-Mip- level fest.
Siehe auch ` destinationLevel()`.
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
Legt die Position der Zielkoordinate oben links fest: p.
Siehe auch destinationTopLeft().
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
Legt die Größe des Bereichs fest, der nach sz kopiert werden soll.
Siehe auch pixelSize().
void QRhiTextureCopyDescription::setSourceLayer(int layer)
Legt das Quellarray „ layer “ fest.
Siehe auch sourceLayer().
void QRhiTextureCopyDescription::setSourceLevel(int level)
Legt den Quell-Mip- level fest.
Siehe auch ` sourceLevel()`.
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
Setzt die Position der Quelle oben links auf „ p “.
Siehe auch sourceTopLeft().
int QRhiTextureCopyDescription::sourceLayer() const
Gibt die Quell-Array-Ebene zurück (Cubemap-Fläche oder Array-Ebenen-Index). Der Standardwert ist 0.
Siehe auch „ setSourceLayer()“.
int QRhiTextureCopyDescription::sourceLevel() const
Gibt die Mip-Stufe der Quelle zurück. Der Standardwert ist 0.
Siehe auch „ setSourceLevel()“.
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Gibt die Position der Quelle oben links (in Pixeln) zurück. Der Standardwert ist (0, 0).
Siehe auch ` 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.
