Back to Qt.io
Contact Us Blog Download Qt

QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

レンダーターゲットのある領域から別の領域にピクセル値の矩形を転送するためのFrameGraphノードです。詳細...

ヘッダー #include <QBlitFramebuffer>
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 座標系に従うと仮定されます。

アクセス関数

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

通知シグナル：

void destinationRectChanged()

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 座標系に従うと仮定されます。

アクセス関数

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

通知シグナル：

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 座標系に従うと仮定されます。

注: プロパティ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

ソース・レンダー・ターゲットを返す。

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

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

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

ソース添付点を返します。

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

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

QRectF QBlitFramebuffer::sourceRect() const

ソース矩形を返す。

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

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

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