QOpenGLTextureBlitter Class

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();
}

Documentación de las funciones miembro

QOpenGLTextureBlitter::QOpenGLTextureBlitter()

Construye una nueva instancia de QOpenGLTextureBlitter.

[noexcept] QOpenGLTextureBlitter::~QOpenGLTextureBlitter()

Destruye la instancia.

void QOpenGLTextureBlitter::bind(GLenum target = GL_TEXTURE_2D)

Vincula los recursos gráficos utilizados por el blitter. Debe invocarse antes de llamar a blit(). Debe evitarse código que modifique el estado OpenGL entre la llamada a bind() y blit() porque de lo contrario pueden surgir conflictos.

target es la textura objetivo para la textura fuente y debe ser GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE, o GL_OES_EGL_image_external.

Ver 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 es generada por la función de ayuda targetTransform().

sourceOrigin especifica si es necesario voltear los datos de la imagen. Cuando texture corresponde a una textura adjunta a un FBO pasa OriginBottomLeft. Por otro lado, cuando texture se basa en datos de imagen sin voltear, pasa OriginTopLeft. Esto es 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 es generada por la función de ayuda targetTransform().

sourceTransform especifica la transformación aplicada a la fuente. Permite utilizar sólo un subrecto de la textura de origen. Suele generarse mediante la función de ayuda sourceTransform().

Véase también sourceTransform(), targetTransform(), Origin, y bind().

bool QOpenGLTextureBlitter::create()

Inicializa los recursos gráficos utilizados por el blitter.

Devuelve true en caso de éxito, false en caso de fallo. Los fallos pueden ocurrir cuando no hay un contexto OpenGL actual en el thread actual, o cuando la compilación del shader falla por alguna razón.

Véase también isCreated() y destroy().

void QOpenGLTextureBlitter::destroy()

Libera todos los recursos gráficos del blitter. Asume que el contexto OpenGL, u otro contexto que comparta recursos con él, que estaba activo en el subproceso cuando se invocó create() está activo.

La función no tiene efecto cuando el blitter no está en estado creado.

Véase también create().

bool QOpenGLTextureBlitter::isCreated() const

Devuelve true si se llamó a create() y tuvo éxito. false en caso contrario.

Véase también create() y destroy().

void QOpenGLTextureBlitter::release()

Desvincula 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 por defecto es 1.0.

void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)

Establece si el swizzling está habilitado para los canales de color rojo y azul en swizzle. Una conversión de BGRA a RGBA (que ocurre en el shader en la GPU, en lugar de una lenta transformación del lado de la CPU) puede ser útil cuando la textura fuente contiene datos de un QImage con un formato como QImage::Format_ARGB32 que mapea a BGRA en sistemas little endian.

Por defecto el swizzle rojo-azul está desactivado ya que esto es lo que necesita una textura adjunta a un objeto framebuffer o una textura basada en un formato QImage ordenado por bytes (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 blit(). Esto se utiliza cuando sólo una parte de la textura se va a utilizar en el blit.

subTexture es el rectángulo fuente deseado en píxeles, textureSize es la anchura y altura completa de los datos de la textura. origin especifica la orientación de los datos de la imagen cuando se trata del 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éase 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, anchura de la imagen, altura de la imagen).

Para una salida sin escalado, el tamaño de target y viewport debe coincidir.

Véase también blit().