QPaintEngine Class
La clase `QPaintEngine` ofrece una definición abstracta de cómo di QPainter o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o di o dixml-ph-0000@deepl .inte
| Encabezado: | #include <QPaintEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los miembros heredados
- QPaintEngine forma parte de las clases de pintura.
Tipos públicos
| enum | DirtyFlag { DirtyPen, DirtyBrush, DirtyBrushOrigin, DirtyFont, DirtyBackground, …, AllDirty } |
| flags | DirtyFlags |
| enum | PaintEngineFeature { AlphaBlend, Antialiasing, BlendModes, BrushStroke, ConicalGradientFill, …, AllFeatures } |
| flags | PaintEngineFeatures |
| enum | PolygonDrawMode { OddEvenMode, WindingMode, ConvexMode, PolylineMode } |
| enum | Type { X11, Windows, MacPrinter, CoreGraphics, QuickDraw, …, Direct2D } |
Funciones públicas
| QPaintEngine(QPaintEngine::PaintEngineFeatures caps = PaintEngineFeatures()) | |
| virtual | ~QPaintEngine() |
| virtual bool | begin(QPaintDevice *pdev) = 0 |
| virtual void | drawEllipse(const QRectF &rect) |
| virtual void | drawEllipse(const QRect &rect) |
| virtual void | drawImage(const QRectF &rectangle, const QImage &image, const QRectF &sr, Qt::ImageConversionFlags flags = Qt::AutoColor) |
| virtual void | drawLines(const QLineF *lines, int lineCount) |
| virtual void | drawLines(const QLine *lines, int lineCount) |
| virtual void | drawPath(const QPainterPath &path) |
| virtual void | drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr) = 0 |
| virtual void | drawPoints(const QPoint *points, int pointCount) |
| virtual void | drawPoints(const QPointF *points, int pointCount) |
| virtual void | drawPolygon(const QPointF *points, int pointCount, QPaintEngine::PolygonDrawMode mode) |
| virtual void | drawPolygon(const QPoint *points, int pointCount, QPaintEngine::PolygonDrawMode mode) |
| virtual void | drawRects(const QRectF *rects, int rectCount) |
| virtual void | drawRects(const QRect *rects, int rectCount) |
| virtual void | drawTextItem(const QPointF &p, const QTextItem &textItem) |
| virtual void | drawTiledPixmap(const QRectF &rect, const QPixmap &pixmap, const QPointF &p) |
| virtual bool | end() = 0 |
| bool | hasFeature(QPaintEngine::PaintEngineFeatures feature) const |
| bool | isActive() const |
| QPaintDevice * | paintDevice() const |
| QPainter * | painter() const |
| void | setActive(bool state) |
| virtual QPaintEngine::Type | type() const = 0 |
| virtual void | updateState(const QPaintEngineState &state) = 0 |
Descripción detallada
Qt proporciona varias implementaciones predefinidas de QPaintEngine para los diferentes backends de pintura que admitimos. El motor de pintura principal que se proporciona es el motor de pintura ráster, que contiene un rasterizador de software que admite el conjunto completo de funciones en todas las plataformas compatibles. Este es el motor predeterminado para pintar en clases basadas en ` QWidget`, por ejemplo, en Windows, X11 y macOS; es el backend para pintar en ` QImage ` y se utiliza como alternativa para los motores de pintura que no admiten una determinada funcionalidad. Además, proporcionamos implementaciones de QPaintEngine para OpenGL (accesibles a través de QOpenGLWidget) y para impresión (lo que permite utilizar QPainter para dibujar en un objeto QPrinter ).
Si se desea utilizar QPainter para dibujar en un backend diferente, es necesario crear una subclase de QPaintEngine y reimplementar todas sus funciones virtuales. La implementación de QPaintEngine se pone entonces a disposición creando una subclase de QPaintDevice y reimplementando la función virtual QPaintDevice::paintEngine().
QPaintEngine es creado y gestionado por el QPaintDevice que lo ha creado.
Véase también QPainter, QPaintDevice::paintEngine() y Sistema de pintura.
Documentación sobre los tipos de miembros
enum QPaintEngine::DirtyFlag
flags QPaintEngine::DirtyFlags
| Constante | Valor | Descripción |
|---|---|---|
QPaintEngine::DirtyPen | 0x0001 | El lápiz está sucio y hay que actualizarlo. |
QPaintEngine::DirtyBrush | 0x0002 | El pincel está sucio y hay que actualizarlo. |
QPaintEngine::DirtyBrushOrigin | 0x0004 | El origen del pincel está sucio y hay que actualizarlo. |
QPaintEngine::DirtyFont | 0x0008 | La fuente está sucia y hay que actualizarla. |
QPaintEngine::DirtyBackground | 0x0010 | El fondo está sucio y hay que actualizarlo. |
QPaintEngine::DirtyBackgroundMode | 0x0020 | El modo de fondo está desactualizado y hay que actualizarlo. |
QPaintEngine::DirtyTransform | 0x0040 | La transformación está desactualizada y hay que actualizarla. |
QPaintEngine::DirtyClipRegion | 0x0080 | La región de recorte está desactualizada y debe actualizarse. |
QPaintEngine::DirtyClipPath | 0x0100 | La ruta de recorte está desactualizada y debe actualizarse. |
QPaintEngine::DirtyHints | 0x0200 | Las sugerencias de renderizado están desactualizadas y deben actualizarse. |
QPaintEngine::DirtyCompositionMode | 0x0400 | El modo de composición está desactualizado y debe actualizarse. |
QPaintEngine::DirtyClipEnabled | 0x0800 | El estado de si el recorte está activado o no está desactualizado y debe actualizarse. |
QPaintEngine::DirtyOpacity | 0x1000 | La opacidad constante ha cambiado y debe actualizarse como parte del cambio de estado en ` QPaintEngine::updateState()`. |
QPaintEngine::AllDirty | 0xffff | Enumeración de conveniencia utilizada internamente. |
QPainter utiliza estos tipos para activar actualizaciones diferidas de los distintos estados en QPaintEngine mediante QPaintEngine::updateState().
Un motor de pintura debe actualizar todos los estados «dirty».
El tipo DirtyFlags es un typedef para QFlags<DirtyFlag>. Almacena una combinación OR de valores de DirtyFlag.
enum QPaintEngine::PaintEngineFeature
flags QPaintEngine::PaintEngineFeatures
Esta enumeración se utiliza para describir las características o capacidades que tiene el motor de pintura. Si el motor no admite una característica, QPainter hará todo lo posible por emularla mediante otros medios y enviará al motor un objeto ` QImage ` con mezcla alfa que contenga los resultados emulados. Algunas características no se pueden emular: `AlphaBlend` y `PorterDuff`.
| Constante | Valor | Descripción |
|---|---|---|
QPaintEngine::AlphaBlend | 0x00000080 | El motor puede realizar mezclas alfa de primitivas. |
QPaintEngine::Antialiasing | 0x00000400 | El motor puede utilizar el suavizado (antialiasing) para mejorar el aspecto de las primitivas renderizadas. |
QPaintEngine::BlendModes | 0x00008000 | El motor admite modos de fusión. |
QPaintEngine::BrushStroke | 0x00000800 | El motor admite trazos que contengan pinceles como rellenos, no solo colores sólidos (por ejemplo, una línea discontinua con degradado de 2 de ancho). |
QPaintEngine::ConicalGradientFill | 0x00000040 | El motor admite rellenos con degradados cónicos. |
QPaintEngine::ConstantOpacity | 0x00001000 | El motor admite la función proporcionada por QPainter::setOpacity(). |
QPaintEngine::LinearGradientFill | 0x00000010 | El motor admite rellenos con degradados lineales. |
QPaintEngine::MaskedBrush | 0x00002000 | El motor es capaz de renderizar pinceles que tengan una textura con un canal alfa o una máscara. |
QPaintEngine::ObjectBoundingModeGradients | 0x00010000 | El motor ofrece soporte nativo para degradados con el modo de coordenadas QGradient::ObjectBoundingMode. En caso contrario, si se admite QPaintEngine::PatternTransform, los degradados en modo de delimitación de objetos se convierten a degradados con el modo de coordenadas QGradient::LogicalMode y una transformación de pincel para la asignación de coordenadas. |
QPaintEngine::PainterPaths | 0x00000200 | El motor admite trazados. |
QPaintEngine::PaintOutsidePaintEvent | 0x20000000 | El motor es capaz de pintar fuera de los eventos de pintura. |
QPaintEngine::PatternBrush | 0x00000008 | El motor es capaz de renderizar pinceles con los patrones de pincel especificados en Qt::BrushStyle. |
QPaintEngine::PatternTransform | 0x00000002 | El motor admite la transformación de patrones de pincel. |
QPaintEngine::PerspectiveTransform | 0x00004000 | El motor admite la realización de transformaciones en perspectiva sobre primitivas. |
QPaintEngine::PixmapTransform | 0x00000004 | El motor puede transformar mapas de píxeles, incluyendo rotación y sesgamiento. |
QPaintEngine::PorterDuff | 0x00000100 | El motor admite operaciones de Porter-Duff |
QPaintEngine::PrimitiveTransform | 0x00000001 | El motor admite la transformación de primitivas de dibujo. |
QPaintEngine::RadialGradientFill | 0x00000020 | El motor admite rellenos con degradados radiales. |
QPaintEngine::RasterOpModes | 0x00020000 | El motor admite operaciones de ráster bit a bit. |
QPaintEngine::AllFeatures | 0xffffffff | Todas las características anteriores. Este valor de enumeración se suele utilizar como máscara de bits. |
El tipo `PaintEngineFeatures` es una definición de tipo para ` QFlags<PaintEngineFeature>`. Almacena una combinación OR de valores de `PaintEngineFeature`.
enum QPaintEngine::PolygonDrawMode
| Constante | Valor | Descripción |
|---|---|---|
QPaintEngine::OddEvenMode | 0 | El polígono debe dibujarse utilizando la regla de relleno «Impar-Par». |
QPaintEngine::WindingMode | 1 | El polígono debe dibujarse utilizando la regla de relleno «Winding». |
QPaintEngine::ConvexMode | 2 | El polígono es convexo y puede dibujarse utilizando algoritmos especializados cuando estén disponibles. |
QPaintEngine::PolylineMode | 3 | Solo debe dibujarse el contorno del polígono. |
enum QPaintEngine::Type
| Constante | Valor | Descripción |
|---|---|---|
QPaintEngine::X11 | 0 | |
QPaintEngine::Windows | 1 | |
QPaintEngine::MacPrinter | 4 | |
QPaintEngine::CoreGraphics | 3 | Quartz2D (CoreGraphics) de macOS |
QPaintEngine::QuickDraw | 2 | QuickDraw de macOS |
QPaintEngine::QWindowSystem | 5 | Qt para Linux embebido |
QPaintEngine::OpenGL | 6 | |
QPaintEngine::Picture | 7 | QPicture formato |
QPaintEngine::SVG | 8 | Gráficos vectoriales escalables (SVG) en formato XML |
QPaintEngine::Raster | 9 | |
QPaintEngine::Direct3D | 10 | Solo para Windows, motor basado en Direct3D |
QPaintEngine::Pdf | 11 | Formato de documento portátil |
QPaintEngine::OpenVG | 12 | |
QPaintEngine::User | 50 | ID del primer tipo de usuario |
QPaintEngine::MaxUser | 100 | Último ID de tipo de usuario |
QPaintEngine::OpenGL2 | 13 | |
QPaintEngine::PaintBuffer | 14 | |
QPaintEngine::Blitter | 15 | |
QPaintEngine::Direct2D | 16 | Solo para Windows, motor basado en Direct2D |
Documentación de las funciones de miembro
[explicit] QPaintEngine::QPaintEngine(QPaintEngine::PaintEngineFeatures caps = PaintEngineFeatures())
Crea un motor de pintura con el conjunto de características especificado en caps.
[virtual noexcept] QPaintEngine::~QPaintEngine()
Destruye el motor de pintura.
[pure virtual] bool QPaintEngine::begin(QPaintDevice *pdev)
Reimplementa esta función para inicializar tu motor de dibujo cuando vaya a comenzar el proceso de dibujo en el dispositivo de dibujo pdev. Devuelve «true» si la inicialización se ha realizado correctamente; en caso contrario, devuelve «false».
Véase también end() y isActive().
[virtual] void QPaintEngine::drawEllipse(const QRectF &rect)
Reimplementa esta función para dibujar la elipse más grande que quepa dentro del rectángulo rect.
La implementación por defecto llama a drawPolygon().
[virtual] void QPaintEngine::drawEllipse(const QRect &rect)
La implementación predeterminada de esta función llama a la versión de punto flotante de esta función
Se trata de una función sobrecargada.
[virtual] void QPaintEngine::drawImage(const QRectF &rectangle, const QImage &image, const QRectF &sr, Qt::ImageConversionFlags flags = Qt::AutoColor)
Reimplementa esta función para dibujar la parte de image especificada por el rectángulo sr en el rectangle dado, utilizando los indicadores de conversión flags proporcionados, con el fin de convertirla en un mapa de píxeles.
[virtual] void QPaintEngine::drawLines(const QLineF *lines, int lineCount)
La implementación predeterminada divide la lista de líneas de lines en lineCount llamadas independientes a drawPath() o drawPolygon(), dependiendo del conjunto de funciones del motor de pintura.
[virtual] void QPaintEngine::drawLines(const QLine *lines, int lineCount)
La implementación por defecto convierte las primeras líneas de lineCount en lines a QLineF y llama a la versión en coma flotante de esta función.
Se trata de una función sobrecargada.
[virtual] void QPaintEngine::drawPath(const QPainterPath &path)
La implementación predeterminada ignora el ` path ` y no realiza ninguna acción.
[pure virtual] void QPaintEngine::drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr)
Reimplementa esta función para dibujar la parte del pm especificada por el rectángulo sr en el r dado.
[virtual] void QPaintEngine::drawPoints(const QPoint *points, int pointCount)
Dibuja los primeros puntos de tipo ` pointCount ` en el búfer points
La implementación por defecto convierte los primeros QPoints de tipo « pointCount » de « points » en QPointFs y llama a la versión de punto flotante de drawPoints.
[virtual] void QPaintEngine::drawPoints(const QPointF *points, int pointCount)
Dibuja los primeros puntos de tipo « pointCount » en el búfer points
[virtual] void QPaintEngine::drawPolygon(const QPointF *points, int pointCount, QPaintEngine::PolygonDrawMode mode)
Reimplementa esta función virtual para dibujar el polígono definido por los puntos iniciales de pointCount en points, utilizando el modo mode.
Nota: Debe reimplementarseal menos una de las funciones drawPolygon().
[virtual] void QPaintEngine::drawPolygon(const QPoint *points, int pointCount, QPaintEngine::PolygonDrawMode mode)
Reimplementa esta función virtual para dibujar el polígono definido por los primeros puntos de pointCount en points, utilizando el modo mode.
Nota: Debe reimplementarseal menos una de las funciones drawPolygon().
Esta es una función sobrecargada.
[virtual] void QPaintEngine::drawRects(const QRectF *rects, int rectCount)
Dibuja los primeros rectángulos de tipo « rectCount » en el búfer « rects ». La implementación predeterminada de esta función llama a « drawPath()» o a « drawPolygon()», dependiendo del conjunto de características del motor de dibujo.
[virtual] void QPaintEngine::drawRects(const QRect *rects, int rectCount)
La implementación por defecto convierte los primeros rectángulos rectCount del búfer rects en un QRectF y llama a la versión en coma flotante de esta función.
Se trata de una función sobrecargada.
[virtual] void QPaintEngine::drawTextItem(const QPointF &p, const QTextItem &textItem)
Esta función dibuja el elemento de texto « textItem » en la posición « p ». La implementación predeterminada de esta función convierte el texto en un « QPainterPath » y dibuja la ruta resultante.
[virtual] void QPaintEngine::drawTiledPixmap(const QRectF &rect, const QPixmap &pixmap, const QPointF &p)
Reimplementa esta función para dibujar el mapa de píxeles « pixmap » en el mapa de píxeles « rect » indicado, comenzando en el punto « p » especificado. El mapa de píxeles se dibujará repetidamente hasta que se llene el « rect ».
[pure virtual] bool QPaintEngine::end()
Reimplementa esta función para finalizar el dibujo en el dispositivo de dibujo actual. Devuelve «true» si el dibujo se ha completado correctamente; en caso contrario, devuelve «false».
Véase también begin() y isActive().
bool QPaintEngine::hasFeature(QPaintEngine::PaintEngineFeatures feature) const
Devuelve ` true ` si el motor de pintura admite el ` feature` especificado; en caso contrario, devuelve ` false`.
bool QPaintEngine::isActive() const
Devuelve ` true ` si el motor de dibujo está dibujando activamente; en caso contrario, devuelve ` false`.
Véase también setActive().
QPaintDevice *QPaintEngine::paintDevice() const
Devuelve el dispositivo en el que este motor está dibujando, si el dibujo está activo; en caso contrario, devuelve ` nullptr`.
QPainter *QPaintEngine::painter() const
Devuelve el objeto «painter» del motor de pintura.
void QPaintEngine::setActive(bool state)
Establece el estado activo del motor de pintura en « state ».
Véase también isActive().
[pure virtual] QPaintEngine::Type QPaintEngine::type() const
Reimplementa esta función para que devuelva el motor de renderizado Type.
[pure virtual] void QPaintEngine::updateState(const QPaintEngineState &state)
Reimplementa esta función para actualizar el estado de un motor de renderizado.
Una vez implementada, esta función se encarga de comprobar el estado actual del motor de dibujo ( state ) y de actualizar las propiedades que hayan cambiado. Utiliza la función QPaintEngineState::state() para averiguar qué propiedades deben actualizarse y, a continuación, utiliza la función correspondiente get function para recuperar los valores actuales de dichas propiedades.
Véase también QPaintEngineState.
© 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.