PySide6.Qt3DRender.Qt3DRender.QComputeCommand

class QComputeCommand

QComponent 用于在 GPU 上为计算着色器发布工作。更多

PySide6.Qt3DRender.Qt3DRender.QComputeCommand 的继承图

概要

属性

方法

插槽

信号

注意

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

详细描述

一个QComputeCommand用于为计算着色器发布工作。计算着色器在添加了QComputeCommand的同一实体的QMaterial组件中指定。workGroupXworkGroupYworkGroupZ属性指定了计算着色器调用的工作组大小。需要在FrameGraph中存在QDispatchCompute节点以实际发布命令。

注意

如果渲染策略设置为OnDemand并且场景没有变化,ComputeCommand将不会被重复调用。必须将渲染策略设置为Always,以便在没有其他触发渲染新帧的场景变化时,ComputeCommand能够被重复调用。

class RunType

注意

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

property runTypeᅟ: Qt3DRender.QComputeCommand.RunType

指定计算命令是每帧执行还是手动触发。

如果设置为连续,Compute命令将在每一帧执行。这是默认设置。

如果设置为手动计算,Command 将在给定的帧数内执行,然后组件将自行禁用。

Access functions:
property workGroupXᅟ: int

指定X工作组的大小。

Access functions:
property workGroupYᅟ: int

指定Y工作组的大小。

Access functions:
property workGroupZᅟ: int

指定Z工作组的大小。

Access functions:
__init__([parent=None])
Parameters:

parentQNode

构造函数使用指定的parent创建一个新的QComputeCommand实例。

runType()
Return type:

RunType

另请参阅

setRunType()

属性 runTypeᅟ 的获取器。

runTypeChanged()

属性 runTypeᅟ 的通知信号。

setRunType(runType)
Parameters:

runTypeRunType

另请参阅

runType()

属性 runTypeᅟ 的设置器。

setWorkGroupX(workGroupX)
Parameters:

workGroupX – int

将第一个维度的工作组设置为 workGroupX

另请参阅

workGroupX()

属性 workGroupXᅟ 的设置器。

setWorkGroupY(workGroupY)
Parameters:

workGroupY – int

将第二个维度的工作组设置为 workGroupY

另请参阅

workGroupY()

属性 workGroupYᅟ 的设置器。

setWorkGroupZ(workGroupZ)
Parameters:

workGroupZ – int

将第三维度的工作组设置为 workGroupZ

另请参阅

workGroupZ()

属性 workGroupZᅟ 的设置器。

trigger([frameCount=1])
Parameters:

frameCount – int

当运行类型设置为手动时,调用触发器将使计算命令在接下来的frameCount帧中执行。执行完成后,enabled属性将被设置为false。

trigger(workGroupX, workGroupY, workGroupZ[, frameCount=1])
Parameters:
  • workGroupX – int

  • workGroupY – int

  • workGroupZ – int

  • frameCount – int

当运行类型设置为手动时,调用触发器将使计算命令在接下来的frameCount帧中执行。执行完成后,启用属性将被设置为false。之前设置的工作组大小将被workGroupXworkGroupYworkGroupZ覆盖。

workGroupX()
Return type:

整数

另请参阅

setWorkGroupX()

属性 workGroupXᅟ 的获取器。

workGroupXChanged()

属性 workGroupXᅟ 的通知信号。

workGroupY()
Return type:

整数

另请参阅

setWorkGroupY()

属性 workGroupYᅟ 的获取器。

workGroupYChanged()

属性 workGroupYᅟ 的通知信号。

workGroupZ()
Return type:

整数

另请参阅

setWorkGroupZ()

属性 workGroupZᅟ 的获取器。

workGroupZChanged()

属性 workGroupZᅟ 的通知信号。