QCanvasOffscreenCanvas Class
QCanvasOffscreenCanvas representa un lienzo fuera de pantalla al que puede dirigirse QCanvasPainter. Más información...
| Encabezado: | #include <QCanvasOffscreenCanvas> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
Tipos públicos
Funciones públicas
| QCanvasOffscreenCanvas(const QCanvasOffscreenCanvas &canvas) | |
| QCanvasOffscreenCanvas(QCanvasOffscreenCanvas &&other) | |
| ~QCanvasOffscreenCanvas() | |
| QColor | fillColor() const |
| QCanvasOffscreenCanvas::Flags | flags() const |
| int | height() const |
| bool | isNull() const |
| void | setFillColor(QColor color) |
| QSize | size() const |
| QRhiTexture * | texture() const |
| int | width() const |
| QCanvasOffscreenCanvas & | operator=(const QCanvasOffscreenCanvas &canvas) |
Elementos no miembros relacionados
| bool | operator!=(const QCanvasOffscreenCanvas &lhs, const QCanvasOffscreenCanvas &rhs) |
| bool | operator==(const QCanvasOffscreenCanvas &lhs, const QCanvasOffscreenCanvas &rhs) |
Descripción detallada
Un lienzo fuera de pantalla es, en esencia, un búfer de color (un ` QRhiTexture`), y posiblemente otros recursos gráficos asociados. Una vez que el contenido se ha renderizado en el búfer de color del lienzo, este se puede pasar como ` registered ` al pintor para recuperar un ` QCanvasImage `, que luego se puede utilizar en llamadas a ` drawImage()` o como un ` image pattern`.
Para crear un lienzo fuera de pantalla, llama a QCanvasPainter::createCanvas(). Para dirigir los comandos de dibujo a un lienzo fuera de pantalla, llama a la sobrecarga adecuada de QCanvasRhiPaintDriver::beginPaint() cuando trabajes con la API de bajo nivel, o a QCanvasPainterWidget::beginCanvasPainting() o QCanvasPainterItemRenderer::beginCanvasPainting() cuando utilices el widget de conveniencia o las clases de elementos Qt Quick.
Al igual que QCanvasImage y QCanvasBrush, QCanvasOffscreenCanvas se comparte explícitamente. Véanse «Compartición implícita de datos » y « QSharedDataPointer » para más detalles.
Nota: Al igual que en QCanvasImage, un QCanvasOffscreenCanvas puede considerarse un objeto que simplemente contiene identificadores. Incluso cuando se produce una separación, los recursos reales —por ejemplo, la textura subyacente y los datos de imagen que contiene— nunca se copian ni se duplican realmente. El propietario real de cualquier recurso gráfico (por ejemplo, un ` QRhiTexture`) es el ` QCanvasPainter ` que proporcionó el `QCanvasOffscreenCanvas` mediante ` createCanvas()`.
Un lienzo siempre pertenece al ` QCanvasPainter ` que lo creó. La destrucción manual de los lienzos se realiza llamando a ` destroyCanvas()`. Sin embargo, en la mayoría de los casos esto no será necesario, ya que el «pintor» destruirá automáticamente cualquier lienzo durante su propia destrucción.
Documentación sobre los tipos de miembros
enum class QCanvasOffscreenCanvas::Flag
flags QCanvasOffscreenCanvas::Flags
Especifica los indicadores del lienzo.
| Constante | Valor | Descripción |
|---|---|---|
QCanvasOffscreenCanvas::Flag::PreserveContents | 0x01 | Indica que se conserva el contenido del lienzo al pintar sobre él. Esto puede afectar negativamente al rendimiento, dependiendo de la arquitectura de la GPU. Consulte QRhiTextureRenderTarget::PreserveColorContents para obtener más detalles. No se admite la configuración de este indicador cuando el número de muestras es superior a 1. |
QCanvasOffscreenCanvas::Flag::MipMaps | 0x02 | Indica que la textura de fondo del lienzo debe tener habilitado el mipmapping. No se admite la configuración de este indicador cuando el número de muestras es superior a 1. Ten en cuenta que la secuencia de mipmaps se genera al llamar a addImage() con el indicador GenerateMipmaps activado. Esto implica que se debe llamar a `addImage()` cada vez que cambie el contenido del lienzo, para que se vuelva a generar la cadena de mipmaps. La generación frecuente de mipmaps puede afectar negativamente al rendimiento. |
El tipo Flags es un typedef de QFlags<Flag>. Almacena una combinación OR de valores de Flag.
Documentación de las funciones miembro
QCanvasOffscreenCanvas::QCanvasOffscreenCanvas(const QCanvasOffscreenCanvas &canvas)
Constructor de copia.
[constexpr noexcept default] QCanvasOffscreenCanvas::QCanvasOffscreenCanvas(QCanvasOffscreenCanvas &&other)
Crea una instancia de « QCanvasOffscreenCanvas » mediante la construcción por movimiento.
[noexcept] QCanvasOffscreenCanvas::~QCanvasOffscreenCanvas()
Destructor.
QColor QCanvasOffscreenCanvas::fillColor() const
Devuelve el color de relleno actual.
Véase también setFillColor().
QCanvasOffscreenCanvas::Flags QCanvasOffscreenCanvas::flags() const
Devuelve los indicadores con los que se creó el lienzo.
Los indicadores son inmutables y no se pueden modificar una vez creado el lienzo.
int QCanvasOffscreenCanvas::height() const
Devuelve la altura de este lienzo en píxeles.
Véase también width() y size().
bool QCanvasOffscreenCanvas::isNull() const
Devuelve «true» si este lienzo contiene datos válidos.
Normalmente, esto siempre será verdadero.
Véase también texture().
void QCanvasOffscreenCanvas::setFillColor(QColor color)
Establece el color de relleno (transparente) en color.
Por defecto, se establece en el valor pasado a createCanvas().
Véase también fillColor().
QSize QCanvasOffscreenCanvas::size() const
Devuelve el tamaño (anchura y altura) de este lienzo en píxeles.
Véase también width() y height().
QRhiTexture *QCanvasOffscreenCanvas::texture() const
Devuelve la textura que sirve de fondo a este lienzo fuera de pantalla.
Véase también isNull().
int QCanvasOffscreenCanvas::width() const
Devuelve el ancho de este lienzo en píxeles.
Véase también height() y size().
QCanvasOffscreenCanvas &QCanvasOffscreenCanvas::operator=(const QCanvasOffscreenCanvas &canvas)
Asigna una copia superficial del recurso « canvas » indicado a este lienzo y devuelve una referencia a dicho lienzo. Para obtener más información sobre las copias superficiales, consulta la documentación sobre el intercambio implícito de datos.
Nota: Los recursos subyacentes, es decir, los recursos gráficos como el QRhiTexture, nunca se copian ni se duplican.
Elementos no miembros relacionados
[noexcept] bool operator!=(const QCanvasOffscreenCanvas &lhs, const QCanvasOffscreenCanvas &rhs)
Devuelve ` true ` si el identificador del lienzo ` lhs ` es distinto de ` rhs`; en caso contrario, devuelve ` false `.
Véase también operator==().
[noexcept] bool operator==(const QCanvasOffscreenCanvas &lhs, const QCanvasOffscreenCanvas &rhs)
Devuelve ` true ` si el identificador del lienzo ` lhs ` es igual a ` rhs`; en caso contrario, devuelve ` false `.
Nota: La igualdad significa que los colores de relleno de los dos objetos canvas son los mismos y que hacen referencia a los mismos recursos gráficos. No se compara el contenido (datos de píxeles).
Véase también operator!=().
© 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.