QCanvasPainterFactory Class
QCanvasPainterFactory gestiona las instancias de ` QCanvasPainter ` y el motor de renderizado asociado. Más información...
| Encabezado: | #include <QCanvasPainterFactory> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
Funciones públicas
| QCanvasPainterFactory() | |
| QCanvasPainter * | create(QRhi *rhi) |
| void | destroy() |
| bool | isValid() const |
| QCanvasRhiPaintDriver * | paintDriver() |
| QCanvasPainter * | painter() |
Miembros públicos estáticos
| QCanvasPainterFactory * | sharedInstance(QRhi *rhi) |
Descripción detallada
Las aplicaciones que realizan el renderizado mediante QCanvasPainter no crean por sí mismas instancias de la clase painter, sino que se espera que utilicen un QCanvasPainterFactory.
Nota: Esta clase solo es relevante cuando se trabaja con ` QCanvasPainter ` sin una clase de conveniencia como ` QCanvasPainterWidget ` o ` QCanvasPainterItem`, ya que estas proporcionan una instancia de ` QCanvasPainter ` a la aplicación.
A continuación se muestra un fragmento de código de ejemplo para obtener un ` QCanvasPainter ` para utilizarlo con un ` QRhi` ya existente e inicializado correctamente:
std::unique_ptr<QCanvasPainterFactory> factory(new QCanvasPainterFactory);
QCanvasPainter *painter = factory->create(rhi);
QCanvasRhiPaintDriver *paintDriver = factory->paintDriver();Se recomienda que todo el código de dibujo que opere en el mismo hilo con el mismo ` QRhi ` comparta y reutilice el mismo ` QCanvasPainter`, en lugar de tener un pintor (y, por tanto, una fábrica) dedicado en cada componente. Esto se puede lograr llamando a ` sharedInstance()`, en lugar de construir una nueva `QCanvasPainterFactory`:
QCanvasPainterFactory *factory = QCanvasPainterFactory::sharedInstance(rhi);
QCanvasPainter *painter = factory->painter();
QCanvasRhiPaintDriver *paintDriver = factory->paintDriver();Documentación de las funciones miembro
QCanvasPainterFactory::QCanvasPainterFactory()
Constructor.
Véase también sharedInstance().
QCanvasPainter *QCanvasPainterFactory::create(QRhi *rhi)
Inicializa la infraestructura de representación de QCanvasPainter, si aún no se ha hecho para esta fábrica.
Devuelve el «painter» o «null» si no se ha podido inicializar el renderizador.
La fábrica quedará asociada a rhi y no podrá utilizarse con ningún otro QRhi, a menos que se vuelvan a llamar destroy() y, a continuación, create().
Las llamadas repetidas a esta función no tienen ningún efecto y son inofensivas. Llama primero a ` destroy()` si deseas reinicializar la infraestructura del pintor, posiblemente con un ` rhi` diferente.
Nota: Noes necesario llamar a esta función cuando se ha utilizado sharedInstance() para obtener una instancia de fábrica.
Véase también destroy(), isValid() y painter().
void QCanvasPainterFactory::destroy()
Desmonta la infraestructura de renderizado. Normalmente no es necesario llamar a esta función. Se utiliza, más bien, en situaciones en las que va seguida de una llamada a create().
Véase también create().
bool QCanvasPainterFactory::isValid() const
Devuelve «true» si se ha llamado correctamente a la función create().
QCanvasRhiPaintDriver *QCanvasPainterFactory::paintDriver()
Devuelve el objeto del controlador de pintura o «null» si isValid() es falso.
Nota: El objeto devuelto no es propiedad de quien realiza la llamada.
QCanvasPainter *QCanvasPainterFactory::painter()
Devuelve el «painter» o «null» si isValid() es falso.
Nota: El objeto devuelto no es propiedad de quien realiza la llamada.
[static] QCanvasPainterFactory *QCanvasPainterFactory::sharedInstance(QRhi *rhi)
Devuelve una instancia de ` QCanvasPainterFactory ` asociada al ` rhi` indicado.
Al llamar a esta función con el mismo ` rhi `, siempre se devolverá el mismo ` QCanvasPainterFactory`.
No es necesario llamar a ` create()` en la fábrica devuelta, y se puede consultar ` painter()` de inmediato, ya que el resultado siempre está ya inicializado, lo que significa que ` isValid()` devuelve `true`.
Esta función es segura para subprocesos. Sin embargo, se aplican las reglas de subprocesos de QRhi como de costumbre: se espera que un objeto QRhi y, por extensión, una instancia de QCanvasPainterFactory, QCanvasRhiPaintDriver y QCanvasPainter asociada a ese QRhi se utilicen todos en un único subproceso.
Nota: El objeto QCanvasPainterFactory devuelto no es propiedad del llamante y deja de ser válido cuando se destruye rhi.
Véase también painter().
© 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.