Back to Qt.io
Contact Us Blog Download Qt
このページでは

Qt3DRender::QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

FrameGraphノード。レンダリングターゲットのある領域から別の領域へ、ピクセル値の矩形を転送します。詳細...

ヘッダー: #include <qblitframebuffer.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML内: BlitFramebuffer
継承元: Qt3DRender::QFrameGraphNode
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

パブリック型

enum InterpolationMethod { Nearest, Linear }

プロパティ

パブリック関数

QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
virtual ~QBlitFramebuffer()
Qt3DRender::QRenderTarget *destination() const
Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint() const
QRectF destinationRect() const
Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod() const
void setDestination(Qt3DRender::QRenderTarget *destination)
void setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)
void setDestinationRect(const QRectF &outputRect)
void setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)
void setSource(Qt3DRender::QRenderTarget *source)
void setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)
void setSourceRect(const QRectF &inputRect)
Qt3DRender::QRenderTarget *source() const
Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint() const
QRectF sourceRect() const

シグナル

void destinationAttachmentPointChanged()
void destinationChanged()
void destinationRectChanged()
void interpolationMethodChanged()
void sourceAttachmentPointChanged()
void sourceChanged()
void sourceRectChanged()

詳細な説明

このノードは、glBlitFrameBuffer またはそれに相当するものをコマンドストリームに挿入します。これにより、テクスチャやQRenderTarget でラップされたサーフェスのバックバッファ間で矩形をコピーする際、テクスチャ付き四角形を描画するよりも効率的な方法が提供されます。また、指定された補間方法によるスケーリングもサポートしています。

注：実際には、 ブリット処理ではいかなるエンティティに対しても描画コールを発行すべきではないため、QBlitFramebufferノードはQNoDraw と組み合わせて使用されることがよくあります。

メンバ型のドキュメント

enum QBlitFramebuffer::InterpolationMethod

画像が引き伸ばされた場合に適用される補間方法を指定します。

定数値説明
Qt3DRender::QBlitFramebuffer::Nearest0最近傍補間。
Qt3DRender::QBlitFramebuffer::Linear1線形補間。

プロパティのドキュメント

destination : Qt3DRender::QRenderTarget*

出力先となるレンダリングターゲットを指定します。設定されていない場合、出力先は（存在すれば）デフォルトのフレームバッファ（つまり、現在のサーフェスのバックバッファ）であるとみなされます。

注：ソースと宛先は 、同じレンダリングターゲットを参照してはなりません。

アクセス関数：

Qt3DRender::QRenderTarget *destination() const
void setDestination(Qt3DRender::QRenderTarget *destination)

通知シグナル：

void destinationChanged()

destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

対象の接続点を指定します。

アクセス機能：

Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint() const
void setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)

通知信号：

void destinationAttachmentPointChanged()

destinationRect : QRectF

目的の矩形を指定します。座標は通常の Qt 座標系に従うものとみなされます。つまり、Y 軸は上から下へと伸びています。

アクセス関数：

QRectF destinationRect() const
void setDestinationRect(const QRectF &outputRect)

Notifierシグナル:

void destinationRectChanged()

interpolationMethod : InterpolationMethod

このプロパティは、画像が拡大・縮小された際に適用される補間方法を指定します。

画像が拡大・縮小された際に適用される補間方法を指定します。デフォルトは「線形」です。

アクセス関数：

Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod() const
void setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)

通知信号：

void interpolationMethodChanged()

source : Qt3DRender::QRenderTarget*

ソースのレンダリングターゲットを指定します。設定されていない場合、ソースは（存在すれば）デフォルトのフレームバッファ（つまり、現在のサーフェスのバックバッファ）であるとみなされます。

注： ソースとデスティネーションは 、同じレンダリングターゲットを参照してはなりません。

アクセス関数：

Qt3DRender::QRenderTarget *source() const
void setSource(Qt3DRender::QRenderTarget *source)

通知シグナル：

void sourceChanged()

sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

ソースの接続点を指定します。

アクセス関数：

Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint() const
void setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)

通知信号：

void sourceAttachmentPointChanged()

sourceRect : QRectF

ソースの矩形を指定します。座標は通常の Qt 座標系に従うものとみなされます。つまり、Y 軸は上から下へと伸びています。

アクセス関数：

QRectF sourceRect() const
void setSourceRect(const QRectF &inputRect)

Notifier シグナル:

void sourceRectChanged()

メンバ関数のドキュメント

[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)

指定されたparent を使用して、新しいQBlitFramebufferを作成します。

[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()

デストラクタ。

Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const

宛先のレンダリングターゲットを返します。

注: プロパティ destinationのゲッター 関数です。

関連項目： setDestination()。

Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const

宛先のアタッチメントポイントを返します。

注： プロパティ destinationAttachmentPointのゲッター関数です 。

関連項目： setDestinationAttachmentPoint()。

QRectF QBlitFramebuffer::destinationRect() const

宛先矩形を返します。

注： プロパティ destinationRectのゲッター 関数です。

関連項目： setDestinationRect()。

Qt3DRender::QBlitFramebuffer::InterpolationMethod QBlitFramebuffer::interpolationMethod() const

補間メソッドを返します。

注： プロパティ `interpolationMethod`のゲッター関数です 。

関連項目： setInterpolationMethod()。

void QBlitFramebuffer::setDestination(Qt3DRender::QRenderTarget *destination)

宛先のレンダリングターゲットを設定します。デフォルト値は nullptr であり、この場合、宛先は、存在すればデフォルトのフレームバッファ（すなわち、現在のサーフェスのバックバッファ）であるとみなされます。

注：ソースと宛先は 、同じレンダリングターゲットを参照してはなりません。

注： 他のノードと同様に 、親が設定されていない場合、destination は自動的にQBlitFramebuffer インスタンスの子として登録されます。また、ライフタイムも追跡されるため、現在設定されているdestination が破棄された場合、宛先はnullptrに戻ります。

注： プロパティdestination のセッター 関数。

関連項目： destination()。

void QBlitFramebuffer::setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)

destinationAttachmentPoint を設定します。デフォルトはQt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 です。

注： プロパティ `destinationAttachmentPoint`のセッター 関数です。

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

void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)

宛先矩形を `outputRect` に設定します。座標は通常の Qt 座標系に従うものとみなされます。つまり、Y 軸は上から下へと伸びています。

注： プロパティ `destinationRect`のセッター 関数です。

関連項目： destinationRect()。

void QBlitFramebuffer::setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)

画像が引き伸ばされた場合に適用されるinterpolationMethod を設定します。デフォルトはLinearです。

注： プロパティ `interpolationMethod`のセッター 関数です。

関連項目 ：interpolationMethod()

void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)

ソースのレンダリングターゲットを設定します。デフォルト値は nullptr です。この場合、ソースは、存在すればデフォルトのフレームバッファ（すなわち、現在のサーフェスのバックバッファ）であるとみなされます。

注：ソースと宛先は 、同じレンダリングターゲットを参照してはなりません。

注： 他のノードと同様に 、親が設定されていない場合、source は自動的にQBlitFramebuffer インスタンスの子として登録されます。また、ライフタイムも追跡されるため、現在設定されているsource が破棄された場合、ソースはnullptrに戻ります。

注： プロパティ `source`のセッター 関数です。

関連項目：source()も参照してください 。

void QBlitFramebuffer::setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)

sourceAttachmentPoint を設定します。デフォルトはQt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 です。

注： プロパティ `sourceAttachmentPoint`のセッター 関数です。

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

void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)

ソース矩形を `inputRect` に設定します。座標は通常の Qt 座標系に従うものとみなされます。つまり、Y 軸は上から下へと伸びています。

注： プロパティ `sourceRect`のセッター 関数です。

関連項目 ：sourceRect()

Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const

ソースのレンダリングターゲットを返します。

注： プロパティ `source`のゲッター 関数です。

関連項目： setSource()。

Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const

ソースの添付ポイントを返します。

注： プロパティ `sourceAttachmentPoint`のゲッター 関数です。

関連項目： setSourceAttachmentPoint()。

QRectF QBlitFramebuffer::sourceRect() const

ソース矩形を返します。

注： プロパティ sourceRectのゲッター 関数です。

関連項目： setSourceRect()。

© 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.