class QBlitFramebuffer#

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

Synopsis#

Properties#

destinationᅟ
destinationAttachmentPointᅟ
destinationRectᅟ
interpolationMethodᅟ
sourceᅟ
sourceAttachmentPointᅟ
sourceRectᅟ

Methods#

def __init__()
def destination()
def destinationAttachmentPoint()
def destinationRect()
def interpolationMethod()
def setDestination()
def setDestinationAttachmentPoint()
def setDestinationRect()
def setInterpolationMethod()
def setSource()
def setSourceAttachmentPoint()
def setSourceRect()
def source()
def sourceAttachmentPoint()
def sourceRect()

Signals#

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

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

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.

Note

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.

class InterpolationMethod#

Specifies the interpolation applied if the image is stretched.

Constant

Description

Qt3DRender.QBlitFramebuffer.Nearest

Nearest-neighbor interpolation.

Qt3DRender.QBlitFramebuffer.Linear

Linear interpolation.

Constant	Description
Qt3DRender.QBlitFramebuffer.Nearest	Nearest-neighbor interpolation.
Qt3DRender.QBlitFramebuffer.Linear	Linear interpolation.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property destinationᅟ: QRenderTarget#

Specifies the destination render target. When not set, the destination is assumed to be the default framebuffer (i.e. the backbuffer of the current surface), if there is one.

Note

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

Access functions:

destination()
setDestination()
Signal destinationChanged()

property destinationAttachmentPointᅟ: Qt3DRender.QRenderTargetOutput.AttachmentPoint#

Specifies the target attachment point.

Access functions:

destinationAttachmentPoint()
setDestinationAttachmentPoint()
Signal destinationAttachmentPointChanged()

property destinationRectᅟ: QRectF#

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

Access functions:

destinationRect()
setDestinationRect()
Signal destinationRectChanged()

property interpolationMethodᅟ: Qt3DRender.QBlitFramebuffer.InterpolationMethod#

Access functions:

interpolationMethod()
setInterpolationMethod()
Signal interpolationMethodChanged()

property sourceᅟ: QRenderTarget#

Specifies the source render target. When not set, the source is assumed to be the default framebuffer (i.e. the backbuffer of the current surface), if there is one.

Note

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

Access functions:

source()
setSource()
Signal sourceChanged()

property sourceAttachmentPointᅟ: Qt3DRender.QRenderTargetOutput.AttachmentPoint#

Specifies the source attachment point.

Access functions:

sourceAttachmentPoint()
setSourceAttachmentPoint()
Signal sourceAttachmentPointChanged()

property sourceRectᅟ: QRectF#

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

Access functions:

sourceRect()
setSourceRect()
Signal sourceRectChanged()

__init__([parent=None])#

Parameters:: parent – QNode

Constructs a new QBlitFramebuffer with the given parent.

destination()#

Return type:: QRenderTarget

Returns the destination render target.

See also

setDestination()

Getter of property destinationᅟ .

destinationAttachmentPoint()#

Return type:: AttachmentPoint

Returns the destination attachment point.

See also

setDestinationAttachmentPoint()

Getter of property destinationAttachmentPointᅟ .

destinationAttachmentPointChanged()#

Notification signal of property destinationAttachmentPointᅟ .

destinationChanged()#

Notification signal of property destinationᅟ .

destinationRect()#

Return type:: QRectF

Returns the destination rectangle.

See also

setDestinationRect()

Getter of property destinationRectᅟ .

destinationRectChanged()#

Notification signal of property destinationRectᅟ .

interpolationMethod()#

Return type:: InterpolationMethod

Returns the interpolation method.

See also

setInterpolationMethod()

Getter of property interpolationMethodᅟ .

interpolationMethodChanged()#

Notification signal of property interpolationMethodᅟ .

setDestination(destination)#

Parameters:: destination – QRenderTarget

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.

Note

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

Note

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 is destroyed.