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

Documentation des fonctions membres

QOpenGLTextureBlitter::QOpenGLTextureBlitter()

Crée une nouvelle instance de QOpenGLTextureBlitter.

[noexcept] QOpenGLTextureBlitter::~QOpenGLTextureBlitter()

Détruit l'instance.

void QOpenGLTextureBlitter::bind(GLenum target = GL_TEXTURE_2D)

Lie les ressources graphiques utilisées par le blitter. Cette fonction doit être appelée avant d’appeler ` blit()`. Il convient d’éviter toute modification de l’état OpenGL entre l’appel à `bind()` et celui à ` blit()`, car cela pourrait entraîner des conflits.

target est la cible de texture pour la texture source et doit être soit GL_TEXTURE_2D, soit GL_TEXTURE_RECTANGLE, soit GL_OES_EGL_image_external.

Voir également release() et blit().

void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, QOpenGLTextureBlitter::Origin sourceOrigin)

Effectue le blit à l'aide de la texture source texture.

targetTransform Spécifie la transformation appliquée. Celle-ci est généralement générée par la fonction d'aide targetTransform().

sourceOrigin Spécifie si les données d’image doivent être inversées. Lorsque texture correspond à une texture associée à un FBO, passez OriginBottomLeft. En revanche, lorsque texture repose sur des données d’image non inversées, passez OriginTopLeft. Cette méthode est plus efficace que l’utilisation de QImage::flipped().

Voir également targetTransform(), Origin et bind().

void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, const QMatrix3x3 &sourceTransform)

Effectue le blit avec la texture source texture.

targetTransform Spécifie la transformation appliquée. Celle-ci est généralement générée par la fonction d'aide targetTransform().

sourceTransform Spécifie la transformation appliquée à la source. Cela permet d’utiliser uniquement un sous-rectangle de la texture source. Elle est généralement générée par la fonction d’aide ` sourceTransform()`.

Voir également sourceTransform(), targetTransform(), Origin et bind().

bool QOpenGLTextureBlitter::create()

Initialise les ressources graphiques utilisées par le blitter.

Renvoie « true » en cas de succès, « false » en cas d'échec. Des échecs peuvent se produire lorsqu'il n'y a pas de contexte OpenGL actif sur le thread actuel, ou lorsque la compilation du shader échoue pour une raison quelconque.

Voir également isCreated() et destroy().

void QOpenGLTextureBlitter::destroy()

Libère toutes les ressources graphiques détenues par le blitter. Suppose que le contexte OpenGL, ou tout autre contexte partageant des ressources avec celui-ci, qui était actif sur le thread lors de l'appel de la fonction ` create()` est toujours actif.

Cette fonction n'a aucun effet lorsque le blitter n'est pas à l'état « created ».

Voir également create().

bool QOpenGLTextureBlitter::isCreated() const

Renvoie ` true ` si la fonction ` create()` a été appelée et a abouti. ` false ` dans le cas contraire.

Voir également create() et destroy().

void QOpenGLTextureBlitter::release()

Libère les ressources graphiques utilisées par le blitter.

Voir aussi bind().

void QOpenGLTextureBlitter::setOpacity(float opacity)

Règle l'opacité sur opacity. L'opacité par défaut est 1,0.

void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)

Détermine si le « swizzling » est activé pour les canaux de couleur rouge et bleu vers le format « swizzle ». Une conversion BGRA vers RGBA (effectuée dans le shader sur le GPU, plutôt que par une transformation lente côté CPU) peut s’avérer utile lorsque la texture source contient des données issues d’un « QImage » au format tel que QImage::Format_ARGB32, qui correspond au format BGRA sur les systèmes « little endian ».

Par défaut, le swizzle rouge-bleu est désactivé, car c’est ce dont a besoin une texture associée à un objet framebuffer ou une texture basée sur un format d’ QImage s par ordre d’octets (comme QImage::Format_RGBA8888).

[static] QMatrix3x3 QOpenGLTextureBlitter::sourceTransform(const QRectF &subTexture, const QSize &textureSize, QOpenGLTextureBlitter::Origin origin)

Calcule une matrice 3x3 pouvant servir d'entrée à la fonction ` blit()`. Cette fonction est utilisée lorsqu'une partie seulement de la texture doit être utilisée dans le blit.

subTexture est le rectangle source souhaité en pixels, textureSize correspond à la largeur et à la hauteur totales des données de texture. origin spécifie l'orientation des données d'image par rapport à l'axe Y.

Voir également blit() et Origin.

bool QOpenGLTextureBlitter::supportsExternalOESTarget() const

Renvoie ` true ` lorsque ` bind()` accepte ` GL_TEXTURE_EXTERNAL_OES ` comme argument cible.

Voir également bind() et blit().

bool QOpenGLTextureBlitter::supportsRectangleTarget() const

Renvoie ` true ` lorsque ` bind()` accepte ` GL_TEXTURE_RECTANGLE ` comme argument cible.

Voir également bind() et blit().

[static] QMatrix4x4 QOpenGLTextureBlitter::targetTransform(const QRectF &target, const QRect &viewport)

Calcule une transformation cible adaptée à la fonction ` blit()`.

target est le rectangle cible en pixels. viewport décrit les dimensions de la source et sera, dans la plupart des cas, défini sur (0, 0, largeur de l'image, hauteur de l'image).

Pour une sortie non mise à l'échelle, la taille de ` target ` et celle de ` viewport ` doivent correspondre.

Voir également blit().