QCanvasPainterItemRenderer Class
El QCanvasPainterItemRenderer se encarga de todo el proceso de dibujo de un elemento « QCanvasPainterItem ». Más información...
| Encabezado: | #include <QCanvasPainterItemRenderer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
| Heredado de: | QQuickRhiItemRenderer |
Funciones públicas
| QCanvasPainterItemRenderer() | |
| virtual | ~QCanvasPainterItemRenderer() override |
| QColor | fillColor() const |
| bool | hasSharedPainter() const |
| qreal | height() const |
| QCanvasPainter * | painter() const |
| void | setSharedPainter(bool enable) |
| qreal | width() const |
Funciones protegidas
| void | beginCanvasPainting(QCanvasOffscreenCanvas &canvas) |
| void | endCanvasPainting() |
| void | grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback) |
| virtual void | initializeResources(QCanvasPainter *painter) |
| virtual void | paint(QCanvasPainter *painter) |
| virtual void | prePaint(QCanvasPainter *painter) |
| virtual void | synchronizeData(QCanvasPainterItem *item) |
Funciones protegidas reimplementadas
| virtual void | initialize(QRhiCommandBuffer *cb) override |
| virtual void | render(QRhiCommandBuffer *cb) override |
| virtual void | synchronize(QQuickRhiItem *item) override |
Descripción detallada
Implementa el método ` paint()` para realizar la representación.
Para exponer los datos del elemento al renderizador de forma segura para los subprocesos, implementa synchronizeData().
El objeto renderizador reside y opera en el hilo de renderizado del grafo de escena deQt Quick , si existe, ya que ese es el hilo en el que se invocan createItemRenderer() y todas las funciones de esta clase.
Si el QCanvasPainterItem se traslada a un window diferente, se asociará a un nuevo QRhi. Por lo tanto, el objeto renderizador se destruye automáticamente y se crea uno nuevo al invocar de nuevo createItemRenderer(). Esto permite una gestión sencilla de los objetos QCanvasImage y QCanvasOffscreenCanvas, ya que pueden ser variables de miembro en el renderizador, configuradas bien en initializeResources() o en paint(), sin tener que restablecerlas cuando se pierden los recursos gráficos debido al cambio de ventana y de QRhi, ya que todo ello ocurre de forma implícita mediante la destrucción de todo el objeto renderizador.
El siguiente fragmento de código muestra la estructura típica de una subclase de `QCanvasPainterItemRenderer`. Consulte QCanvasPainterItem para ver un ejemplo de la clase ` MyItem `.
class MyRenderer : public QCanvasPainterItemRenderer
{
public:
void synchronizeData(QCanvasPainterItem *item) override
{
// copy a custom property value from item in a thread-safe manner
m_value = static_cast<MyItem *>(item)->value();
}
void initializeResources(QCanvasPainter *p) override
{
// load assets
if (m_image.isNull())
m_image = p->addImage(QImage("image.png"), QCanvasPainter::ImageFlag::Repeat);
}
void prePaint(QCanvasPainter *p) override
{
// this is where offscreen canvases are drawn into
if (m_canvas.isNull()) {
m_canvas = p->createCanvas(QSize(640, 480));
beginCanvasPainting(m_canvas);
// ... draw into the offscreen canvas
endCanvasPainting();
m_canvasImage = p->addImage(m_canvas);
}
}
void paint(QCanvasPainter *p) override
{
QPointF center(width() / 2, height() / 2);
// ... draw using m_value, m_image, and m_canvasImage
}
QCanvasImage m_image;
QCanvasOffscreenCanvas m_canvas;
QCanvasImage m_canvasImage;
float m_value;
};Véase también QCanvasPainterItem.
Documentación de las funciones de miembro
QCanvasPainterItemRenderer::QCanvasPainterItemRenderer()
Crea un objeto `QCanvasPainterItemRenderer`.
[override virtual noexcept] QCanvasPainterItemRenderer::~QCanvasPainterItemRenderer()
Destruye el « QCanvasPainterItemRenderer ».
[protected] void QCanvasPainterItemRenderer::beginCanvasPainting(QCanvasOffscreenCanvas &canvas)
Comienza a grabar los comandos de dibujo de « QCanvasPainter » dirigidos a « canvas ».
Nota: Esta función solo debe llamarse desde ` prePaint()` ().
La función `beginCanvasPainting()` debe ir siempre seguida de la correspondiente ` endCanvasPainting()` antes de salir de ` prePaint()`.
[protected] void QCanvasPainterItemRenderer::endCanvasPainting()
Indica el final del dibujo en el lienzo especificado en beginCanvasPainting().
Nota: Esta función solo debe llamarse desde prePaint().
beginCanvasPainting() debe ir siempre seguida de la correspondiente endCanvasPainting() antes de salir de prePaint().
QColor QCanvasPainterItemRenderer::fillColor() const
Devuelve el color de relleno actual del elemento. Este se puede establecer mediante el elemento padre ` QCanvasPainterItem`.
[protected] template <typename Functor> void QCanvasPainterItemRenderer::grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback)
Emite una solicitud de lectura de textura para ` canvas`, asociándola a ` context`.
callback Se invoca en el hilo de renderizado, ya sea antes de que la función devuelva un valor o más tarde, dependiendo de la implementación subyacente de ` QRhi ` y de la API 3D. La lectura del contenido de la textura puede implicar una copia de la GPU a la CPU, dependiendo de la arquitectura de la GPU. Acepta un único argumento de tipo ` const QImage & ` y puede ser cualquier functor, incluidos los de solo movimiento.
Si context se destruye antes de que finalice la lectura, la captura se cancela y no se invoca callback. Esto hace que sea seguro que la llamada de retorno haga referencia a objetos que puedan no sobrevivir a la lectura pendiente.
Por ejemplo, lo siguiente guardaría el contenido de un lienzo fuera de pantalla en un archivo PNG:
grabCanvas(offscreenCanvas, item, [](const QImage &image) {
image.save("result.png");
});bool QCanvasPainterItemRenderer::hasSharedPainter() const
Devuelve ` true ` si este renderizador de elementos utiliza un pintor compartido.
Véase también setSharedPainter.
qreal QCanvasPainterItemRenderer::height() const
Devuelve la altura del área pintada, en unidades lógicas, sin el « scale factor (device pixel ratio) ». Normalmente, este valor coincide con el « height » del elemento «painter», a menos que se haya establecido « QQuickRhiItem::fixedColorBufferHeight ».
[override virtual protected] void QCanvasPainterItemRenderer::initialize(QRhiCommandBuffer *cb)
Reimplementa: QQuickRhiItemRenderer::initialize(QRhiCommandBuffer *cb).
[virtual protected] void QCanvasPainterItemRenderer::initializeResources(QCanvasPainter *painter)
Reimplementa este método para inicializar los recursos utilizando painter. Se llamará una vez antes de la primera llamada a synchronizeData().
Nota: Esta función no se invoca cuando cambia el tamaño de ` QCanvasPainterItem `.
Véanse también QCanvasPainter::addImage y QCanvasPainter::createCanvas.
[virtual protected] void QCanvasPainterItemRenderer::paint(QCanvasPainter *painter)
Reimplementa este método para dibujar utilizando ` painter`.
Este método se invocará después de que el elemento se haya rellenado con fillColor().
paint() se invoca desde el hilo del renderizador. Para acceder a los datos del elemento de forma segura, cópialos en synchronizeData().
Véase también synchronizeData().
QCanvasPainter *QCanvasPainterItemRenderer::painter() const
Devuelve el «painter» asociado a este elemento «painter».
[virtual protected] void QCanvasPainterItemRenderer::prePaint(QCanvasPainter *painter)
Esta función se invoca al inicio del renderizado mediante ` painter`, antes de ` paint()`.
No hay ningún destino de renderizado activo cuando se invoca esta función. Llama a beginCanvasPainting() para inicializar el dibujo en un lienzo fuera de pantalla.
Véanse también beginCanvasPainting() y endCanvasPainting().
[override virtual protected] void QCanvasPainterItemRenderer::render(QRhiCommandBuffer *cb)
Reimplementa: ` QQuickRhiItemRenderer::render` (`QRhiCommandBuffer *cb)`.
void QCanvasPainterItemRenderer::setSharedPainter(bool enable)
Desactiva el uso compartido del pintor si « enable » es « false ».
La función «Painter Sharing» está activada por defecto.
Cuando el «painter sharing» está activado, todos los elementos «painter» dentro de la misma « QQuickWindow » utilizarán el mismo « QCanvasPainter ».
Si se desea desactivar el uso compartido del pintor, esta función debe llamarse con suficiente antelación, por ejemplo, desde el constructor de la clase derivada. Cambiarlo posteriormente, cuando el elemento ya se haya inicializado para el dibujo, no tendrá ningún efecto.
Si dos elementos utilizan pintores dedicados y no compartidos, los recursos gráficos del otro, como los que respaldan a ` QCanvasImage ` o `QOffscreenCanvas`, no serán visibles para ellos. En cambio, si los elementos se encuentran en la misma ventana y el uso compartido está activado, pueden utilizar imágenes o lienzos creados por el otro elemento, ya que ambos utilizan el mismo ` QCanvasPainter`.
Nota: Incluso cuando enable es true, los «pintores» no se comparten entre elementos que pertenecen a diferentes instancias de QQuickWindow y, por extensión, a diferentes grafos de escena.
Véase también hasSharedPainter.
[override virtual protected] void QCanvasPainterItemRenderer::synchronize(QQuickRhiItem *item)
Reimplementa: QQuickRhiItemRenderer::synchronize(QQuickRhiItem *item).
[virtual protected] void QCanvasPainterItemRenderer::synchronizeData(QCanvasPainterItem *item)
Reimplementa este método para sincronizar los datos entre las instancias de « item » y «item painter». Se llamará antes de « paint()» cada vez que sea necesario volver a dibujar el elemento.
Este método es el único lugar en el que el «painter» y el «item» pueden leer y escribir de forma segura las variables del otro.
Normalmente, deberías realizar un `static_cast` de ` item ` a tu tipo de elemento real y, a continuación, intercambiar los datos.
qreal QCanvasPainterItemRenderer::width() const
Devuelve la anchura del área pintada, en unidades lógicas, sin el « scale factor (device pixel ratio) ». Normalmente coincide con la propiedad « width » del elemento «painter», a menos que se haya establecido « QQuickRhiItem::fixedColorBufferWidth ».
© 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.