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

メンバ関数ドキュメント

QOpenGLTextureBlitter::QOpenGLTextureBlitter()

新しい QOpenGLTextureBlitter インスタンスを構築します。

[noexcept] QOpenGLTextureBlitter::~QOpenGLTextureBlitter()

インスタンスをデストラクトします。

void QOpenGLTextureBlitter::bind(GLenum target = GL_TEXTURE_2D)

ブリッタが使用するグラフィックス・リソースをバインドします。これは、blit （）を呼び出す前に呼び出す必要があります。OpenGLの状態を変更するコードは、bind()の呼び出しとblit()の呼び出しの間に存在しないようにする必要があります。

target はソーステクスチャのテクスチャターゲットで、 、 、または のいずれかでなければなりません。GL_TEXTURE_2D GL_TEXTURE_RECTANGLE GL_OES_EGL_image_external

release() およびblit()も参照してください 。

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

ソーステクスチャtexture でブリットを実行します。

targetTransform は適用される変換を指定します。これは通常、 () ヘルパー関数によって生成されます。targetTransform

sourceOrigin は、画像データの反転が必要かどうかを指定します。 が FBO パスにアタッチされたテクスチャに対応する場合、 .一方、 が反転されていない画像データに基づいている場合は、 を渡します。これは () を使うよりも効率的です。texture OriginBottomLeft texture OriginTopLeft QImage::mirrored

targetTransform()、Origin 、bind()も参照 。

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

ソーステクスチャtexture でブリットを実行します。

targetTransform は適用される変換を指定します。これは通常、 () ヘルパー関数によって生成されます。targetTransform

sourceTransform はソースに適用される変換を指定します。これにより、ソース テクスチャのサブレクトのみを使用できます。これは通常、 () ヘルパー関数によって生成されます。sourceTransform

sourceTransform()、targetTransform()、Origin 、およびbind()も参照してください 。

bool QOpenGLTextureBlitter::create()

ブリッタが使用するグラフィックリソースを初期化します。

成功した場合はtrue を、失敗した場合はfalse を返します。失敗は、現在のスレッドに現在のOpenGLコンテキストがない場合や、何らかの理由でシェーダーのコンパイルに失敗した場合に発生します。

isCreated() およびdestroy()も参照 。

void QOpenGLTextureBlitter::destroy()

ブリッターが保持しているすべてのグラフィックス・リソースを解放します。この関数は、create() を呼び出したときにスレッドでカレントであった OpenGL コンテキスト、またはそれとリソースを共有する別のコンテキストがカレントであると仮定します。

この関数は、ブリッタが作成された状態でないときには何の効果もありません。

create()も参照 。

bool QOpenGLTextureBlitter::isCreated() const

create() が呼び出されて成功した場合はtrue を返す。そうでない場合はfalse を返す。

create() およびdestroy() も参照 。

void QOpenGLTextureBlitter::release()

Blitter が使用するグラフィックリソースのバインドを解除します。

bind()も参照して ください。

void QOpenGLTextureBlitter::setOpacity(float opacity)

不透明度をopacity に変更します。デフォルトの不透明度は 1.0 です。

void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)

赤と青のカラーチャンネルでスウィズリングを有効にするかどうかをswizzle に設定します。BGRA から RGBA への変換（CPU 側の遅い変換の代わりに GPU 上のシェーダで発生）は、ソーステクスチャが、リトルエンディアンシステム上で BGRA にマップされるQImage::Format_ARGB32 のようなフォーマットを持つQImage からのデータを含んでいる場合に便利です。

デフォルトでは、フレームバッファオブジェクトにアタッチされたテクスチャや、（QImage::Format_RGBA8888 のような）バイトオーダーQImage フォーマットに基づいたテクスチャが必要とするものであるため、赤青スウィズルは無効になっています。

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

blit() への入力として適切な 3x3 行列を計算します。これは、テクスチャの一部だけがブリットに使用される場合に使用されます。

subTexture textureSize はテクスチャデータの完全な幅と高さです。 は、Y 軸に対する画像データの方向を指定します。origin

blit() およびOriginも参照してください 。

bool QOpenGLTextureBlitter::supportsExternalOESTarget() const

bind() がGL_TEXTURE_EXTERNAL_OES をターゲット引数として受け取った場合、true を返す。

bind() およびblit() も参照 。

bool QOpenGLTextureBlitter::supportsRectangleTarget() const

bind() がターゲット引数としてGL_TEXTURE_RECTANGLE を受け付けると、true を返す。

bind() およびblit()も参照 。

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

blit() に適したターゲット変換を計算します。

target viewport はソースの寸法を表し，たいていの場合は (0, 0, 画像の幅, 画像の高さ) に設定されます。

拡大縮小 さ れていない出力の場合、target とviewport のサ イ ズは一致す る 必要があ り ます。

blit()も参照してください 。