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 |
- Lista de todos los miembros, incluidos los heredados
- QOpenGLPaintDevice forma parte de «Renderizado en 3D».
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.