En esta página

Qt Canvas Painter

El módulo Qt Canvas Painter proporciona clases para el dibujo 2D imperativo con aceleración por hardware. Esta API de dibujo está disponible tanto para Qt Quick como para Qt Widgets, y también se puede utilizar directamente con QRhi. El diseño de la API sigue en general el contexto 2D de HTML canvas, con algunas reducciones y algunas adiciones.

En comparación con QPainter, Qt Canvas Painter es más compacto y cuenta con menos abstracciones, con el objetivo de ofrecer un rendimiento óptimo en QRhi. Qt Canvas Painter está diseñado para el renderizado por GPU y no dispone de un backend de CPU como sí lo hace QPainter.

Uso del módulo

API de C++

Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

API de QML

Los tipos QML del módulo están disponibles mediante la importación ` QtCanvas2D `. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtCanvas2D

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Los shaders utilizados con QCanvasCustomBrush se añaden al proyecto mediante la función de CMake ` qt_add_custom_brush_shaders `.

Referencia de clases

Ejemplos

Todos los ejemplos

Licencias y atribuciones

La biblioteca en tiempo de ejecución de Qt Canvas Painter está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General de GNU, versión 3.

Consulta «Licencias de Qt » para obtener más detalles.

Por otra parte, Qt Canvas Painter en la versión 6.12.0 puede contener módulos de terceros bajo las siguientes licencias permisivas:

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