En esta página

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

enum class Flag { PreserveContents, MipMaps }
flags Flags

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)
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.

ConstanteValorDescripción
QCanvasOffscreenCanvas::Flag::PreserveContents0x01Indica 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::MipMaps0x02Indica 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.