En esta página

QOpenGLPaintDevice Class

La clase `QOpenGLPaintDevice` permite dibujar en un contexto de OpenGL mediante ` QPainter`. Más información...

Encabezado: #include <QOpenGLPaintDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl
Heredado de: QPaintDevice

Funciones públicas

QOpenGLPaintDevice()
QOpenGLPaintDevice(const QSize &size)
QOpenGLPaintDevice(int width, int height)
virtual ~QOpenGLPaintDevice()
QOpenGLContext *context() const
qreal dotsPerMeterX() const
qreal dotsPerMeterY() const
virtual void ensureActiveTarget()
bool paintFlipped() const
void setDevicePixelRatio(qreal devicePixelRatio)
void setDotsPerMeterX(qreal dpmx)
void setDotsPerMeterY(qreal dpmy)
void setPaintFlipped(bool flipped)
void setSize(const QSize &size)
QSize size() const

Funciones públicas reimplementadas

virtual QPaintEngine *paintEngine() const override

Funciones protegidas

QOpenGLPaintDevice(const QOpenGLPaintDevice &)
QOpenGLPaintDevice &operator=(const QOpenGLPaintDevice &)

Funciones protegidas reimplementadas

virtual int metric(QPaintDevice::PaintDeviceMetric metric) const override

Descripción detallada

QOpenGLPaintDevice utiliza el contexto QOpenGL actual para renderizar comandos de dibujo de l QPainter. El contexto se captura durante la construcción. Requiere compatibilidad con OpenGL (ES) 2.0 o superior.

Rendimiento

QOpenGLPaintDevice cuenta casi siempre con aceleración por hardware y puede llegar a ser mucho más rápido que la rasterización por software. Sin embargo, es más sensible a los cambios de estado y, por lo tanto, requiere que los comandos de dibujo se ordenen cuidadosamente para lograr un rendimiento óptimo.

Suavizado y calidad

El suavizado en el motor de pintura de OpenGL se realiza mediante multimuestreo. La mayoría del hardware requiere una cantidad de memoria significativamente mayor para realizar el multimuestreo y la calidad resultante no está a la altura de la del motor de pintura por software. El punto fuerte del motor de pintura de OpenGL reside en su rendimiento, no en la calidad de su representación visual.

Cambios de estado

Al dibujar en un `QOpenGLPaintDevice` mediante ` QPainter`, el motor de dibujo modificará el estado del contexto actual de OpenGL para adaptarlo a sus necesidades. Las aplicaciones no deben dar por sentado que el estado de OpenGL se restablecerá a sus condiciones originales, en particular el programa de sombreado actual, la ventana de visualización de OpenGL, las unidades de textura y los modos de dibujo.

Combinación de QPainter y OpenGL

Al combinar « QPainter » y OpenGL, es importante notificar a « QPainter » que el estado de OpenGL puede haberse alterado, para que pueda restaurar su estado interno. Esto se consigue llamando a « QPainter::beginNativePainting()» antes de iniciar el renderizado de OpenGL y a « QPainter::endNativePainting()» una vez finalizado.

Consideraciones de seguridad

Advertencia: Se espera quetodo el contenido renderizado a través de `QOpenGLPaintDevice` sea de confianza. La geometría vectorial, las imágenes y otros datos de dibujo se procesan, pueden modificarse y se transmiten a la implementación subyacente de OpenGL. Se recomienda a los desarrolladores de aplicaciones que consideren cuidadosamente las posibles implicaciones antes de renderizar (transmitir) contenido proporcionado por el usuario.

Véase también el ejemplo de ventana OpenGL.

Documentación de las funciones miembro

QOpenGLPaintDevice::QOpenGLPaintDevice()

Crea un objeto `QOpenGLPaintDevice`.

El QOpenGLPaintDevice solo es válido para el contexto actual.

Véase también QOpenGLContext::currentContext().

[explicit] QOpenGLPaintDevice::QOpenGLPaintDevice(const QSize &size)

Crea un objeto `QOpenGLPaintDevice` con el ` size` indicado.

El QOpenGLPaintDevice solo es válido para el contexto actual.

Véase también QOpenGLContext::currentContext().

QOpenGLPaintDevice::QOpenGLPaintDevice(int width, int height)

Crea un objeto `QOpenGLPaintDevice` con los valores especificados para ` width ` y ` height`.

El QOpenGLPaintDevice solo es válido para el contexto actual.

Véase también QOpenGLContext::currentContext().

[protected delete] QOpenGLPaintDevice::QOpenGLPaintDevice(const QOpenGLPaintDevice &)

Crea una instancia de ` QOpenGLPaintDevice` mediante copia. Esta función se ha eliminado.

[virtual noexcept] QOpenGLPaintDevice::~QOpenGLPaintDevice()

Destruye el « QOpenGLPaintDevice ».

QOpenGLContext *QOpenGLPaintDevice::context() const

Devuelve el contexto de OpenGL asociado al dispositivo de dibujo.

qreal QOpenGLPaintDevice::dotsPerMeterX() const

Devuelve el número de píxeles por metro en sentido horizontal.

Véase también setDotsPerMeterX().

qreal QOpenGLPaintDevice::dotsPerMeterY() const

Devuelve el número de píxeles por metro en la dirección vertical.

Véase también setDotsPerMeterY().

[virtual] void QOpenGLPaintDevice::ensureActiveTarget()

Este método virtual se proporciona como una llamada de retorno para permitir volver a vincular un objeto de búfer de fotogramas o un contexto de destino cuando diferentes instancias de ` QOpenGLPaintDevice ` emiten llamadas de dibujo de forma alterna.

beginNativePainting() también activará este método.

La implementación por defecto no realiza ninguna acción.

[override virtual protected] int QOpenGLPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const

Reimplementa: ` QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const`.

[override virtual] QPaintEngine *QOpenGLPaintDevice::paintEngine() const

Reimplementa: QPaintDevice::paintEngine() const.

bool QOpenGLPaintDevice::paintFlipped() const

Devuelve « true » si la imagen está invertida respecto al eje Y.

Véase también setPaintFlipped().

void QOpenGLPaintDevice::setDevicePixelRatio(qreal devicePixelRatio)

Establece la relación de píxeles del dispositivo para el dispositivo de pintura en ` devicePixelRatio`.

void QOpenGLPaintDevice::setDotsPerMeterX(qreal dpmx)

Establece el número de píxeles por metro en sentido horizontal en dpmx.

Véase también dotsPerMeterX().

void QOpenGLPaintDevice::setDotsPerMeterY(qreal dpmy)

Establece el número de píxeles por metro en sentido vertical en dpmy.

Véase también dotsPerMeterY().

void QOpenGLPaintDevice::setPaintFlipped(bool flipped)

Establece si la imagen debe invertirse alrededor del eje Y o no en flipped.

Véase también paintFlipped().

void QOpenGLPaintDevice::setSize(const QSize &size)

Establece el tamaño en píxeles del dispositivo de pintura en size.

Véase también size().

QSize QOpenGLPaintDevice::size() const

Devuelve el tamaño en píxeles del dispositivo de pintura.

Véase también setSize().

[protected delete] QOpenGLPaintDevice &QOpenGLPaintDevice::operator=(const QOpenGLPaintDevice &)

Asigna mediante copia other a esta instancia de QOpenGLPaintDevice. Esta función se ha eliminado.

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