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

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

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

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

bool QOpenGLTextureBlitter::isCreated() const

create() がコールされ、成功した場合はtrue を返す。そうでない場合はfalse を返す。

create() およびdestroy()も参照のこと 。

void QOpenGLTextureBlitter::release()

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

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

void QOpenGLTextureBlitter::setOpacity(float opacity)

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

void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)

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

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

[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 はターゲッ ト矩形を ピ ク セル単位で表 し ます。 は元画像の寸法を表 し 、 たいていの場合 (0, 0, 画像の幅, 画像の高さ) に設定 さ れます。viewport

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

blit()も参照 。