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

Parameters

parent – PySide6.Qt3DCore.Qt3DCore.QNode

Constructs a new QBlitFramebuffer with the given parent.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.InterpolationMethod

Specifies the interpolation applied if the image is stretched.

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

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destination()

Return type

PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationAttachmentPoint()

Return type

AttachmentPoint

Specifies the target attachment point.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationAttachmentPointChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationRect()

Return type

PySide6.QtCore.QRectF

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

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.destinationRectChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.interpolationMethod()

Return type

InterpolationMethod

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.interpolationMethodChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setDestination(destination)

Parameters

destination – PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setDestinationAttachmentPoint(destinationAttachmentPoint)

Parameters

destinationAttachmentPoint – AttachmentPoint

Specifies the target attachment point.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setDestinationRect(destinationRect)

Parameters

destinationRect – PySide6.QtCore.QRectF

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

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setInterpolationMethod(interpolationMethod)

Parameters

interpolationMethod – InterpolationMethod

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSource(source)

Parameters

source – PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSourceAttachmentPoint(sourceAttachmentPoint)

Parameters

sourceAttachmentPoint – AttachmentPoint

Specifies the source attachment point.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.setSourceRect(sourceRect)

Parameters

sourceRect – PySide6.QtCore.QRectF

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

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.source()

Return type

PySide6.Qt3DRender.Qt3DRender.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.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceAttachmentPoint()

Return type

AttachmentPoint

Specifies the source attachment point.

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceAttachmentPointChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceChanged()

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceRect()

Return type

PySide6.QtCore.QRectF

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

PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer.sourceRectChanged()