QOpenGLTextureBlitter Class
La clase `QOpenGLTextureBlitter` ofrece una forma sencilla de dibujar cuadriláteros con textura mediante OpenGL. Más información...
| Encabezado: | #include <QOpenGLTextureBlitter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpenGL) target_link_libraries(mytarget PRIVATE Qt6::OpenGL) |
| qmake: | QT += opengl |
- Lista de todos los miembros, incluidos los heredados
- QOpenGLTextureBlitter forma parte de «Renderización en 3D».
Tipos públicos
| enum | Origin { OriginBottomLeft, OriginTopLeft } |
Funciones públicas
| QOpenGLTextureBlitter() | |
| ~QOpenGLTextureBlitter() | |
| void | bind(GLenum target = GL_TEXTURE_2D) |
| void | blit(GLuint texture, const QMatrix4x4 &targetTransform, QOpenGLTextureBlitter::Origin sourceOrigin) |
| void | blit(GLuint texture, const QMatrix4x4 &targetTransform, const QMatrix3x3 &sourceTransform) |
| bool | create() |
| void | destroy() |
| bool | isCreated() const |
| void | release() |
| void | setOpacity(float opacity) |
| void | setRedBlueSwizzle(bool swizzle) |
| bool | supportsExternalOESTarget() const |
| bool | supportsRectangleTarget() const |
Miembros públicos estáticos
| QMatrix3x3 | sourceTransform(const QRectF &subTexture, const QSize &textureSize, QOpenGLTextureBlitter::Origin origin) |
| QMatrix4x4 | targetTransform(const QRectF &target, const QRect &viewport) |
Descripción detallada
Dibujar cuadriláteros con textura, con el fin de mostrar el contenido de una textura en pantalla, es una operación habitual al desarrollar interfaces de usuario en 2D. QOpenGLTextureBlitter proporciona una clase de conveniencia para evitar la repetición de datos de vértices, fuentes de shaders, la gestión de búferes y programas, y los cálculos matriciales.
Por ejemplo, una subclase de ` QOpenGLWidget ` puede hacer lo siguiente para dibujar el contenido renderizado en un framebuffer en la posición de píxel ` (x, y)`:
void OpenGLWidget::initializeGL()
{
m_blitter.create();
m_fbo = new QOpenGLFramebufferObject(size);
}
void OpenGLWidget::paintGL()
{
m_fbo->bind();
// update offscreen content
m_fbo->release();
m_blitter.bind();
const QRect targetRect(QPoint(x, y), m_fbo->size());
const QMatrix4x4 target = QOpenGLTextureBlitter::targetTransform(targetRect, QRect(QPoint(0, 0), m_fbo->size()));
m_blitter.blit(m_fbo->texture(), target, QOpenGLTextureBlitter::OriginBottomLeft);
m_blitter.release();
}El blitter implementa shaders GLSL tanto para GLSL 1.00 (apto para OpenGL (ES) 2.x y perfiles de compatibilidad de versiones más recientes de OpenGL) como para la versión 150 (apto para contextos de perfil básico con OpenGL 3.2 y versiones posteriores).
Documentación de los tipos de miembros
enum QOpenGLTextureBlitter::Origin
| Constante | Valor | Descripción |
|---|---|---|
QOpenGLTextureBlitter::OriginBottomLeft | 0 | Indica que los datos de la textura siguen la convención de OpenGL para los sistemas de coordenadas, lo que significa que el eje Y va de abajo hacia arriba. |
QOpenGLTextureBlitter::OriginTopLeft | 1 | Indica que, en los datos de la textura, el eje Y va de arriba hacia abajo, lo cual es habitual en los datos de imagen normales, sin invertir. |
Véase también ` blit()`.
Documentación de funciones miembro
QOpenGLTextureBlitter::QOpenGLTextureBlitter()
Crea una nueva instancia de QOpenGLTextureBlitter.
Nota: en el constructorno se inicializan recursos gráficos. Esto permite incluir sin problemas miembros simples de QOpenGLTextureBlitter en clases, ya que la inicialización real, que depende del contexto de OpenGL, solo tiene lugar en create().
[noexcept] QOpenGLTextureBlitter::~QOpenGLTextureBlitter()
Destruye la instancia.
Nota: Cuando el contexto de OpenGL —o un contexto que comparta recursos con él— que estaba activo al llamar a ` create()` ya no lo esté, los recursos gráficos no se liberarán. Por lo tanto, se recomienda llamar a ` destroy()` manualmente en lugar de confiar en que el destructor realice la limpieza de los recursos de OpenGL.
void QOpenGLTextureBlitter::bind(GLenum target = GL_TEXTURE_2D)
Vincula los recursos gráficos utilizados por el blitter. Esta función debe llamarse antes de llamar a ` blit()`. Debe evitarse modificar el estado de OpenGL entre la llamada a `bind()` y ` blit()`, ya que, de lo contrario, podrían surgir conflictos.
target es el destino de la textura de origen y debe ser GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE o GL_OES_EGL_image_external.
Véanse también release() y blit().
void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, QOpenGLTextureBlitter::Origin sourceOrigin)
Realiza el blit con la textura de origen texture.
targetTransform Especifica la transformación aplicada. Normalmente la genera la función auxiliar targetTransform().
sourceOrigin Especifica si es necesario invertir los datos de la imagen. Cuando texture corresponde a una textura asociada a un FBO, pasa OriginBottomLeft. Por otro lado, cuando texture se basa en datos de imagen sin invertir, pasa OriginTopLeft. Esto resulta más eficiente que utilizar QImage::flipped().
Véase también targetTransform(), Origin y bind().
void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, const QMatrix3x3 &sourceTransform)
Realiza el blit con la textura de origen texture.
targetTransform Especifica la transformación aplicada. Normalmente la genera la función auxiliar ` targetTransform()`.
sourceTransform Especifica la transformación aplicada a la fuente. Esto permite utilizar únicamente un subrectángulo de la textura de origen. Normalmente, esto lo genera la función auxiliar ` sourceTransform()`.
Véase también sourceTransform(), targetTransform(), Origin y bind().
bool QOpenGLTextureBlitter::create()
Inicializa los recursos gráficos que utiliza el blitter.
Devuelve ` true ` si se realiza correctamente, y ` false ` si se produce un error. Pueden producirse errores cuando no hay ningún contexto OpenGL activo en el hilo actual, o cuando la compilación del shader falla por algún motivo.
Véanse también isCreated() y destroy().
void QOpenGLTextureBlitter::destroy()
Libera todos los recursos gráficos retenidos por el blitter. Se da por supuesto que el contexto de OpenGL —o cualquier otro contexto que comparta recursos con él— que estuviera activo en el hilo en el momento de invocar ` create()` sigue estando activo.
La función no tiene ningún efecto cuando el blitter no se encuentra en estado «created».
Véase también ` create()`.
bool QOpenGLTextureBlitter::isCreated() const
Devuelve ` true ` si se ha llamado a ` create()` y ha tenido éxito. En caso contrario, devuelve ` false `.
Véase también create() y destroy().
void QOpenGLTextureBlitter::release()
Desasigna los recursos gráficos utilizados por el blitter.
Véase también bind().
void QOpenGLTextureBlitter::setOpacity(float opacity)
Cambia la opacidad a opacity. La opacidad predeterminada es 1,0.
Nota: el blitter no modifica el estado de fusión. Es responsabilidad de quien llama a blit() asegurarse de que estén activas las configuraciones de fusión correctas.
void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)
Establece si se habilita el «swizzling» para los canales de color rojo y azul a « swizzle ». Una conversión de BGRA a RGBA (que se produce en el shader de la GPU, en lugar de una transformación lenta por parte de la CPU) puede resultar útil cuando la textura de origen contiene datos de un « QImage » con un formato como QImage::Format_ARGB32, que se asigna a BGRA en sistemas «little endian».
Por defecto, el intercambio rojo-azul está desactivado, ya que es lo que necesita una textura adjunta a un objeto de búfer de fotogramas o una textura basada en un formato de orden de bytes QImage (como QImage::Format_RGBA8888).
[static] QMatrix3x3 QOpenGLTextureBlitter::sourceTransform(const QRectF &subTexture, const QSize &textureSize, QOpenGLTextureBlitter::Origin origin)
Calcula una matriz de 3x3 adecuada como entrada para la función ` blit()`. Se utiliza cuando solo se va a emplear una parte de la textura en la operación de blit.
subTexture es el rectángulo de origen deseado en píxeles; textureSize es el ancho y la altura totales de los datos de la textura. origin especifica la orientación de los datos de la imagen respecto al eje Y.
Véase también blit() y Origin.
bool QOpenGLTextureBlitter::supportsExternalOESTarget() const
Devuelve ` true ` cuando ` bind()` acepta ` GL_TEXTURE_EXTERNAL_OES ` como argumento de destino.
Véase también bind() y blit().
bool QOpenGLTextureBlitter::supportsRectangleTarget() const
Devuelve « true » cuando « bind()» acepta « GL_TEXTURE_RECTANGLE » como argumento de destino.
Véanse también bind() y blit().
[static] QMatrix4x4 QOpenGLTextureBlitter::targetTransform(const QRectF &target, const QRect &viewport)
Calcula una transformación de destino adecuada para blit().
target es el rectángulo de destino en píxeles. viewport describe las dimensiones de origen y, en la mayoría de los casos, se establecerá en (0, 0, ancho de la imagen, alto de la imagen).
Para obtener una salida sin escalar, el tamaño de target y viewport debe coincidir.
Véase también blit().
© 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.