class QBlitFramebuffer#

用于从一个渲染目标的某个区域传输像素值矩形到另一个区域的帧图节点。更多

Inheritance diagram of PySide6.Qt3DRender.Qt3DRender.QBlitFramebuffer

摘要#

属性#

方法#

信号#

注意

此文档可能包含从C++自动翻译到Python的片段。我们始终欢迎对片段翻译的贡献。如果您在翻译中发现问题,也可以通过在https://bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述#

此节点将 glBlitFrameBuffer 或等效功能插入到命令流中。与绘制纹理四边形相比,这提供了在纹理或被 QRenderTarget 包装的表面后缓冲区之间复制矩形的高效方法。它还支持使用指定的插值方法进行缩放。

注意

在实际应用中,通常会结合使用 QBlitFramebuffer 节点和 QNoDraw,因为复制(blit)不应涉及为任何实体发出绘制调用。

InterpolationMethod#

指定在图像被拉伸时应用的插值。

常量

描述

Qt3DRender.QBlitFramebuffer.Nearest

最邻近插值。

Qt3DRender.QBlitFramebuffer.Linear

线性插值。

注意

当使用 from __feature__ import true_property 时可以直接使用属性,否则可以通过访问函数使用。

属性 destination: QRenderTarget#

指定目标渲染目标。如果未设置,则假定目标为默认帧缓冲区(即当前表面的后缓冲区),如果有的话。

注意

源和目标不得引用同一渲染目标。

访问函数
属性 destinationAttachmentPoint: Qt3DRender.QRenderTargetOutput.AttachmentPoint#

指定目标附加点。

访问函数
属性 destinationRect: QRectF#

指定目标矩形。坐标假定遵循正常的Qt坐标系统,即Y从上到下。

访问函数
属性 interpolationMethod: Qt3DRender.QBlitFramebuffer.InterpolationMethod#
访问函数
属性 source: QRenderTarget#

指定源渲染目标。如果未设置,则假设源为默认帧缓冲区(即当前表面的后缓冲区),如果有的话。

注意

源和目标不得引用同一渲染目标。

访问函数
属性 sourceAttachmentPoint: Qt3DRender.QRenderTargetOutput.AttachmentPoint#

指定源附加点。

访问函数
属性 sourceRect: QRectF#

指定源矩形。坐标假定遵循正常的Qt坐标系统,即Y从上到下。

访问函数
__init__([parent=None])#
参数:

parentQNode

使用给定的 parent 创建一个新的 QBlitFramebuffer 对象。

destination()#
返回类型::

QRenderTarget

返回目标渲染目标。

另请参阅

setDestination()

属性 destinationᅟ 的获取器。

destinationAttachmentPoint()#
返回类型::

附件点

返回目标附件点。

另请参阅

setDestinationAttachmentPoint()

属性 destinationAttachmentPointᅟ 的获取器。

destinationAttachmentPointChanged()#

属性 destinationAttachmentPointᅟ 的属性通知信号。

destinationChanged()#

属性 destinationᅟ 的属性通知信号。

destinationRect()#
返回类型::

QRectF

返回目标矩形。

另请参阅

setDestinationRect()

属性 destinationRectᅟ 的获取器。

destinationRectChanged()#

属性 destinationRectᅟ 的属性通知信号。

interpolationMethod()#
返回类型::

插值方法

返回插值方法。

另请参阅

setInterpolationMethod()

属性 interpolationMethodᅟ 的获取器。

interpolationMethodChanged()#

属性 interpolationMethod 的通知信号。

setDestination(destination)#
参数:

destination - QRenderTarget

设置目标渲染目标。默认值是 nullptr,在这种情况下,假设目标为默认帧缓冲区(即当前表面的后缓冲区),如果有的话。

注意

源和目标不得引用同一渲染目标。

注意

与其他节点一样,当没有设置父节点时,destination 会自动成为 QBlitFramebuffer 实例的父节点。其生命周期也会被跟踪,这意味着如果当前设置的 destination 被销毁,则目标将回滚到 nullptr。

另请参阅

destination()

属性 destination 的设置器。

setDestinationAttachmentPoint(destinationAttachmentPoint)#
参数:

destinationAttachmentPoint - AttachmentPoint

设置 destinationAttachmentPoint。默认为 Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0。

另请参阅

destinationAttachmentPoint()

属性 destinationAttachmentPoint 的设置器。

setDestinationRect(destinationRect)#
参数:

destinationRect - QRectF

将目标矩形设置为 outputRect。坐标假设遵循正常的 Qt 坐标系统,即 Y 从上到下。

另请参阅

destinationRect()

属性 destinationRect 的设置器。

setInterpolationMethod(interpolationMethod)#
参数:

interpolationMethod - InterpolationMethod

设置如果图像被拉伸时应用的反走样方法。默认为线性。

另请参阅

interpolationMethod()

属性 interpolationMethod 的设置器。

setSource(source)#
参数:

sourceQRenderTarget

设置源渲染目标。默认值为 nullptr,此时假定源是默认帧缓冲区(即当前表面的后缓冲区),如果存在的话。

注意

源和目标不得引用同一渲染目标。

注意

与其他节点一样,当未设置父节点时,source 会自动设置为 QBlitFramebuffer 的实例的父节点。其生命周期也会被跟踪,这意味着如果当前设置的 source 被销毁,则源将重置为 nullptr。

另请参阅

source()

属性 source 的设置器。

setSourceAttachmentPoint(sourceAttachmentPoint)#
参数:

sourceAttachmentPointAttachmentPoint

设置 sourceAttachmentPoint。默认为 Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0。

另请参阅

sourceAttachmentPoint()

属性 sourceAttachmentPoint 的设置器。

setSourceRect(sourceRect)#
参数:

sourceRectQRectF

设置源矩形为 inputRect。坐标被假定为遵守正常的 Qt 坐标系统,即 Y 轴从上到下。

另请参阅

sourceRect()

属性 sourceRect 的设置器。

source()#
返回类型::

QRenderTarget

返回源渲染目标。

另请参阅

setSource()

属性 source 的获取器。

sourceAttachmentPoint()#
返回类型::

附件点

返回源附加点。

另请参阅

setSourceAttachmentPoint()

属性 sourceAttachmentPoint 的获取器。

sourceAttachmentPointChanged()#

属性 sourceAttachmentPoint 的通知信号。

sourceChanged()#

属性 source属性 的通知信号。

sourceRect()#
返回类型::

QRectF

返回源矩形。

另请参阅

setSourceRect()

属性 sourceRect属性 的获取器。

sourceRectChanged()sourceRect属性 的通知信号。