QRhiTextureCopyDescription Class
Describe una operación de copia de textura a textura. Más...
| Cabecera: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Desde: | Qt 6.6 |
Funciones Públicas
| 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 |
Descripción detallada
Un pixelSize() vacío indica que se va a copiar todo el sub-recurso. Por lo tanto, una descripción de copia construida por defecto lleva a copiar todo el sub-recurso en el nivel 0 de la capa 0.
Nota: La textura de origen debe crearse con QRhiTexture::UsedAsTransferSource.
Nota : Los rectángulos de origen y destino definidos por pixelSize(), sourceTopLeft(), y destinationTopLeft() deben ajustarse a las texturas de origen y destino, respectivamente. De lo contrario, el comportamiento es indefinido.
Con los mapas de cubos, las texturas 3D y las matrices de texturas se puede copiar una cara o un corte a la vez. La cara o sección se especifica mediante los índices de las capas de origen y destino. Con las texturas mipmapped se puede copiar un nivel mip cada vez. La capa de origen y destino y los índices de nivel mip pueden diferir, pero el tamaño y la posición deben controlarse cuidadosamente para evitar copias fuera de los límites, en cuyo caso el comportamiento es indefinido.
Nota: Se trata de una API RHI con garantías de compatibilidad limitadas; consulte QRhi para obtener más información.
Documentación de las funciones miembro
[constexpr noexcept] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Construye una descripción de copia de textura vacía.
int QRhiTextureCopyDescription::destinationLayer() const
Devuelve la capa de la matriz de destino (cara del cubemap o índice de la capa de la matriz). Por defecto es 0.
Véase también setDestinationLayer().
int QRhiTextureCopyDescription::destinationLevel() const
Devuelve el nivel de destionación mip. Por defecto es 0.
Véase también setDestinationLevel().
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Devuelve la posición superior izquierda de la descripción en píxeles. Por defecto es (0, 0).
Véase también setDestinationTopLeft().
QSize QRhiTextureCopyDescription::pixelSize() const
Devuelve el tamaño de la región a copiar.
Nota: Un pixelSize() vacío indica que se va a copiar todo el subrecurso. Por lo tanto, una descripción de copia construida por defecto lleva a copiar todo el sub-recurso en el nivel 0 de la capa 0.
Véase también setPixelSize().
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
Establece la matriz de destino layer.
Véase también destinationLayer().
void QRhiTextureCopyDescription::setDestinationLevel(int level)
Establece el mip de destino level.
Véase también destinationLevel().
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
Establece la posición superior izquierda de destino p.
Véase también destinationTopLeft().
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
Establece el tamaño de la región a copiar en sz.
Véase también pixelSize().
void QRhiTextureCopyDescription::setSourceLayer(int layer)
Establece la matriz de origen layer.
Véase también sourceLayer().
void QRhiTextureCopyDescription::setSourceLevel(int level)
Establece el mip de origen level.
Véase también sourceLevel().
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
Establece la posición superior izquierda de la fuente en p.
Véase también sourceTopLeft().
int QRhiTextureCopyDescription::sourceLayer() const
Devuelve la capa de la matriz de origen (cara del cubemap o índice de la capa de la matriz). Por defecto es 0.
Véase también setSourceLayer().
int QRhiTextureCopyDescription::sourceLevel() const
Devuelve el nivel de mip de origen. El valor predeterminado es 0.
Véase también setSourceLevel().
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Devuelve la posición superior izquierda de la fuente (en píxeles). Por defecto es (0, 0).
Véase también 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.
