En esta página

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

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

ConstanteValorDescripción
QPaintEngine::DirtyPen0x0001El lápiz está sucio y hay que actualizarlo.
QPaintEngine::DirtyBrush0x0002El pincel está sucio y hay que actualizarlo.
QPaintEngine::DirtyBrushOrigin0x0004El origen del pincel está sucio y hay que actualizarlo.
QPaintEngine::DirtyFont0x0008La fuente está sucia y hay que actualizarla.
QPaintEngine::DirtyBackground0x0010El fondo está sucio y hay que actualizarlo.
QPaintEngine::DirtyBackgroundMode0x0020El modo de fondo está desactualizado y hay que actualizarlo.
QPaintEngine::DirtyTransform0x0040La transformación está desactualizada y hay que actualizarla.
QPaintEngine::DirtyClipRegion0x0080La región de recorte está desactualizada y debe actualizarse.
QPaintEngine::DirtyClipPath0x0100La ruta de recorte está desactualizada y debe actualizarse.
QPaintEngine::DirtyHints0x0200Las sugerencias de renderizado están desactualizadas y deben actualizarse.
QPaintEngine::DirtyCompositionMode0x0400El modo de composición está desactualizado y debe actualizarse.
QPaintEngine::DirtyClipEnabled0x0800El estado de si el recorte está activado o no está desactualizado y debe actualizarse.
QPaintEngine::DirtyOpacity0x1000La opacidad constante ha cambiado y debe actualizarse como parte del cambio de estado en ` QPaintEngine::updateState()`.
QPaintEngine::AllDirty0xffffEnumeració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`.

ConstanteValorDescripción
QPaintEngine::AlphaBlend0x00000080El motor puede realizar mezclas alfa de primitivas.
QPaintEngine::Antialiasing0x00000400El motor puede utilizar el suavizado (antialiasing) para mejorar el aspecto de las primitivas renderizadas.
QPaintEngine::BlendModes0x00008000El motor admite modos de fusión.
QPaintEngine::BrushStroke0x00000800El 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::ConicalGradientFill0x00000040El motor admite rellenos con degradados cónicos.
QPaintEngine::ConstantOpacity0x00001000El motor admite la función proporcionada por QPainter::setOpacity().
QPaintEngine::LinearGradientFill0x00000010El motor admite rellenos con degradados lineales.
QPaintEngine::MaskedBrush0x00002000El motor es capaz de renderizar pinceles que tengan una textura con un canal alfa o una máscara.
QPaintEngine::ObjectBoundingModeGradients0x00010000El 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::PainterPaths0x00000200El motor admite trazados.
QPaintEngine::PaintOutsidePaintEvent0x20000000El motor es capaz de pintar fuera de los eventos de pintura.
QPaintEngine::PatternBrush0x00000008El motor es capaz de renderizar pinceles con los patrones de pincel especificados en Qt::BrushStyle.
QPaintEngine::PatternTransform0x00000002El motor admite la transformación de patrones de pincel.
QPaintEngine::PerspectiveTransform0x00004000El motor admite la realización de transformaciones en perspectiva sobre primitivas.
QPaintEngine::PixmapTransform0x00000004El motor puede transformar mapas de píxeles, incluyendo rotación y sesgamiento.
QPaintEngine::PorterDuff0x00000100El motor admite operaciones de Porter-Duff
QPaintEngine::PrimitiveTransform0x00000001El motor admite la transformación de primitivas de dibujo.
QPaintEngine::RadialGradientFill0x00000020El motor admite rellenos con degradados radiales.
QPaintEngine::RasterOpModes0x00020000El motor admite operaciones de ráster bit a bit.
QPaintEngine::AllFeatures0xffffffffTodas 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

ConstanteValorDescripción
QPaintEngine::OddEvenMode0El polígono debe dibujarse utilizando la regla de relleno «Impar-Par».
QPaintEngine::WindingMode1El polígono debe dibujarse utilizando la regla de relleno «Winding».
QPaintEngine::ConvexMode2El polígono es convexo y puede dibujarse utilizando algoritmos especializados cuando estén disponibles.
QPaintEngine::PolylineMode3Solo debe dibujarse el contorno del polígono.

enum QPaintEngine::Type

ConstanteValorDescripción
QPaintEngine::X110 
QPaintEngine::Windows1 
QPaintEngine::MacPrinter4 
QPaintEngine::CoreGraphics3Quartz2D (CoreGraphics) de macOS
QPaintEngine::QuickDraw2QuickDraw de macOS
QPaintEngine::QWindowSystem5Qt para Linux embebido
QPaintEngine::OpenGL6 
QPaintEngine::Picture7QPicture formato
QPaintEngine::SVG8Gráficos vectoriales escalables (SVG) en formato XML
QPaintEngine::Raster9 
QPaintEngine::Direct3D10Solo para Windows, motor basado en Direct3D
QPaintEngine::Pdf11Formato de documento portátil
QPaintEngine::OpenVG12 
QPaintEngine::User50ID del primer tipo de usuario
QPaintEngine::MaxUser100Último ID de tipo de usuario
QPaintEngine::OpenGL213 
QPaintEngine::PaintBuffer14 
QPaintEngine::Blitter15 
QPaintEngine::Direct2D16Solo 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.