QRhiTextureCopyDescription Class
Describe una operación de copia de textura a textura. Más información...
| Encabezado: | #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 debe copiar todo el subrecurso. Por lo tanto, una descripción de copia construida por defecto da lugar a la copia de todo el subrecurso 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 cubemaps, texturas 3D y matrices de texturas, se puede copiar una cara o un corte cada vez. La cara o el corte se especifican mediante los índices de capa de origen y destino. Con texturas con mipmaps, se puede copiar un nivel de mip cada vez. Los índices de capa y de nivel mip de origen y destino pueden diferir, pero el tamaño y la posición deben controlarse cuidadosamente para evitar copias fuera de límites; en tal caso, el comportamiento es indefinido.
Nota: Se trata de una API RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.
Documentación de las funciones miembro
[constexpr noexcept default] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
Crea una descripción de copia de textura vacía.
int QRhiTextureCopyDescription::destinationLayer() const
Devuelve la capa de matriz de destino (cara del cubemap o índice de la capa de matriz). El valor por defecto es 0.
Véase también setDestinationLayer().
int QRhiTextureCopyDescription::destinationLevel() const
Devuelve el nivel MIP de destino. El valor por defecto es 0.
Véase también setDestinationLevel().
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
Devuelve la posición de la esquina superior izquierda de destino en píxeles. El valor por defecto es (0, 0).
Véase también setDestinationTopLeft().
QSize QRhiTextureCopyDescription::pixelSize() const
Devuelve el tamaño de la región que se va a copiar.
Nota: Un valor nulode pixelSize() indica que se debe copiar todo el subrecurso. Por lo tanto, una descripción de copia creada de forma predeterminada da lugar a la copia de todo el subrecurso 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 que se va 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 matriz de origen (cara del cubemap o índice de la capa de matriz). El valor por defecto es 0.
Véase también setSourceLayer().
int QRhiTextureCopyDescription::sourceLevel() const
Devuelve el nivel MIP de origen. El valor predeterminado es 0.
Véase también setSourceLevel().
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
Devuelve la posición de origen en la esquina superior izquierda (en píxeles). El valor 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.