QBlitFramebuffer Class

( Qt3DRender::QBlitFramebuffer )

FrameGraph node to transfer a rectangle of pixel values from one region of a render target to another. 更多...

头: #include <QBlitFramebuffer>
qmake: QT += 3drender
Since: Qt 5.10
实例化: 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 ()

静态公共成员

const QMetaObject staticMetaObject

额外继承成员

详细描述

FrameGraph node to transfer a rectangle of pixel values from one region of a render target to another.

This node inserts a glBlitFrameBuffer or an equivalent into the command stream. This provides a more efficient method for copying rectangles between textures or surface backbuffers wrapped by QRenderTarget than drawing textured quads. It also supports scaling with the specified interpolation method.

注意: In practice the QBlitFramebuffer node will often be used in combination with QNoDraw since a blit should not involve issuing draw calls for any entities.

成员类型文档编制

enum QBlitFramebuffer:: InterpolationMethod

特性文档编制

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

访问函数:

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

通知程序信号:

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

访问函数:

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

通知程序信号:

void sourceRectChanged ()

成员函数文档编制

QBlitFramebuffer:: QBlitFramebuffer ( Qt3DCore::QNode * parent = nullptr)

构造新的 QBlitFramebuffer 采用给定 parent .

[virtual] QBlitFramebuffer:: ~QBlitFramebuffer ()

析构函数。

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

Returns the destination render target.

注意: Getter 函数对于特性 destination .

另请参阅 setDestination ().

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

Returns the destination attachment point.

注意: Getter 函数对于特性 destinationAttachmentPoint .

另请参阅 setDestinationAttachmentPoint ().

QRectF QBlitFramebuffer:: destinationRect () const

Returns the destination rectangle.

注意: Getter 函数对于特性 destinationRect .

另请参阅 setDestinationRect ().

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

Returns the interpolation method.

注意: Getter 函数对于特性 interpolationMethod .

另请参阅 setInterpolationMethod ().

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

Sets the destination render target. The default value is nullptr, in which case the destination is assumed to be be the default framebuffer (i.e. the backbuffer of the current surface), if there is one.

注意: the source and destination must not refer to the same render target.

注意: As with other nodes, destination gets automatically parented to the QBlitFramebuffer instance when no parent has been set. The lifetime is also tracked, meaning the destination reverts to nullptr in case the currently set destination 被销毁。

注意: Setter 函数对于特性 destination .

另请参阅 destination ().

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

设置 destinationAttachmentPoint . Defaults to Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

注意: Setter 函数对于特性 destinationAttachmentPoint .

另请参阅 destinationAttachmentPoint ().

void QBlitFramebuffer:: setDestinationRect (const QRectF & outputRect )

Sets the destination rectangle to outputRect . The coordinates are assumed to follow the normal Qt coordinate system, meaning Y runs from top to bottom.

注意: Setter 函数对于特性 destinationRect .

另请参阅 destinationRect ().

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

设置 interpolationMethod that is applied if the image is stretched. Defaults to Linear.

注意: Setter 函数对于特性 interpolationMethod .

另请参阅 interpolationMethod ().

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

Sets the source render target. The default value is nullptr, in which case the source is assumed to be be the default framebuffer (i.e. the backbuffer of the current surface), if there is one.

注意: the source and destination must not refer to the same render target.

注意: As with other nodes, source gets automatically parented to the QBlitFramebuffer instance when no parent has been set. The lifetime is also tracked, meaning the source reverts to nullptr in case the currently set source 被销毁。

注意: Setter 函数对于特性 source .

另请参阅 source ().

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

设置 sourceAttachmentPoint . Defaults to Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

注意: Setter 函数对于特性 sourceAttachmentPoint .

另请参阅 sourceAttachmentPoint ().

void QBlitFramebuffer:: setSourceRect (const QRectF & inputRect )

Sets the source rectangle to inputRect . The coordinates are assumed to follow the normal Qt coordinate system, meaning Y runs from top to bottom.

注意: Setter 函数对于特性 sourceRect .

另请参阅 sourceRect ().

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

Returns the source render target.

注意: Getter 函数对于特性 source .

另请参阅 setSource ().

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

Returns the source attachment point.

注意: Getter 函数对于特性 sourceAttachmentPoint .

另请参阅 setSourceAttachmentPoint ().

QRectF QBlitFramebuffer:: sourceRect () const

Returns the source rectangle.

注意: Getter 函数对于特性 sourceRect .

另请参阅 setSourceRect ().