Qt3DRender.QBlitFramebuffer

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

New in version 5.10.

Synopsis

Functions

• def destination ()

• def destinationAttachmentPoint ()

• def destinationRect ()

• def interpolationMethod ()

• def setDestination (destination)

• def setDestinationAttachmentPoint (destinationAttachmentPoint)

• def setDestinationRect (destinationRect)

• def setInterpolationMethod (interpolationMethod)

• def setSource (source)

• def setSourceAttachmentPoint (sourceAttachmentPoint)

• def setSourceRect (sourceRect)

• def source ()

• def sourceAttachmentPoint ()

• def sourceRect ()

Signals

• def destinationAttachmentPointChanged ()

• def destinationChanged ()

• def destinationRectChanged ()

• def interpolationMethodChanged ()

• def sourceAttachmentPointChanged ()

• def sourceChanged ()

• def sourceRectChanged ()

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 PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer([parent=None])

param parent

QNode

Constructs a new QBlitFramebuffer with the given parent .

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.InterpolationMethod

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destination()

Return type

QRenderTarget

Returns the destination render target.

See also

setDestination()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationAttachmentPoint()

Return type

AttachmentPoint

Returns the destination attachment point.

See also

setDestinationAttachmentPoint()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationAttachmentPointChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationRect()

Return type

QRectF

Returns the destination rectangle.

See also

setDestinationRect()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationRectChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.interpolationMethod()

Return type

InterpolationMethod

Returns the interpolation method.

See also

setInterpolationMethod()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.interpolationMethodChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.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.

See also

destination()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setDestinationAttachmentPoint(destinationAttachmentPoint)

Parameters

destinationAttachmentPoint – AttachmentPoint

Sets the destinationAttachmentPoint . Defaults to Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

See also

destinationAttachmentPoint()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setDestinationRect(destinationRect)

Parameters

destinationRect – QRectF

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

See also

destinationRect()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setInterpolationMethod(interpolationMethod)

Parameters

interpolationMethod – InterpolationMethod

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

See also

interpolationMethod()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSource(source)

Parameters

source – QRenderTarget

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.

Note

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

Note

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

See also

source()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSourceAttachmentPoint(sourceAttachmentPoint)

Parameters

sourceAttachmentPoint – AttachmentPoint

Sets the sourceAttachmentPoint . Defaults to Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

See also

sourceAttachmentPoint()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSourceRect(sourceRect)

Parameters

sourceRect – QRectF

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

See also

sourceRect()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.source()

Return type

QRenderTarget

Returns the source render target.

See also

setSource()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceAttachmentPoint()

Return type

AttachmentPoint

Returns the source attachment point.

See also

setSourceAttachmentPoint()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceAttachmentPointChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceChanged()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceRect()

Return type

QRectF

Returns the source rectangle.

See also

setSourceRect()

PySide2.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceRectChanged()