QComputeCommand#

QComponent to issue work for the compute shader on GPU. More

Inheritance diagram of PySide6.Qt3DRender.Qt3DRender.QComputeCommand

Synopsis#

Properties#

Functions#

Slots#

Signals#

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#

A QComputeCommand is used to issue work for the compute shader. The compute shader is specified in the QMaterial component of the same entity the QComputeCommand is added to. The workGroupX , workGroupY and workGroupZ properties specify the work group sizes for the compute shader invocation. QDispatchCompute node needs to be present in the FrameGraph to actually issue the commands.

Note

If the rendering policy is set to OnDemand and there are no changes to the scene, the ComputeCommand will not be invoked repeatedly. The Always render policy must be set for the ComputeCommand to be repeatedly invoked if there are no other changes to the scene that triggers rendering a new frame.

class PySide6.Qt3DRender.Qt3DRender.QComputeCommand([parent=None])#
Parameters:

parentPySide6.Qt3DCore.Qt3DCore.QNode

The constructor creates a new QComputeCommand instance with the specified parent.

Note

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

property PᅟySide6.Qt3DRender.Qt3DRender.QComputeCommand.runType: RunType#

Specifies whether the compute command should be performed every frame or manually triggered.

If set to Continuous, Compute command is executed everyframe. This is the default.

If set to Manual CompouteCommand is executed for a given number of frames and then the component disables itself.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupX: int#

Specifies X workgroup size.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupY: int#

Specifies Y workgroup size.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupZ: int#

Specifies Z workgroup size.

Access functions:
PySide6.Qt3DRender.Qt3DRender.QComputeCommand.RunType#
PySide6.Qt3DRender.Qt3DRender.QComputeCommand.runType()#
Return type:

RunType

See also

setRunType()

Getter of property runType .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.runTypeChanged()#

Notification signal of property runType .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.setRunType(runType)#
Parameters:

runTypeRunType

See also

runType()

Setter of property runType .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.setWorkGroupX(workGroupX)#
Parameters:

workGroupX – int

Sets the workgroup for the first dimension to workGroupX.

See also

workGroupX()

Setter of property workGroupX .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.setWorkGroupY(workGroupY)#
Parameters:

workGroupY – int

Sets the workgroup for the second dimension to workGroupY.

See also

workGroupY()

Setter of property workGroupY .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.setWorkGroupZ(workGroupZ)#
Parameters:

workGroupZ – int

Sets the workgroup for the third dimension to workGroupZ.

See also

workGroupZ()

Setter of property workGroupZ .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.trigger([frameCount=1])#
Parameters:

frameCount – int

When the run type is set to Manual, calling trigger will make the compute command be executed for the next frameCount frames. Upon completion of the execution, the enabled property will be set to false.

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

  • workGroupY – int

  • workGroupZ – int

  • frameCount – int

When the run type is set to Manual, calling trigger will make the compute command be executed for the next frameCount frames. Upon completion of the execution, the enabled property will be set to false. The size of the workgroup previously set will be overridden with workGroupX, workGroupY, workGroupZ.

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupX()#
Return type:

int

See also

setWorkGroupX()

Getter of property workGroupX .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupXChanged()#

Notification signal of property workGroupX .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupY()#
Return type:

int

See also

setWorkGroupY()

Getter of property workGroupY .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupYChanged()#

Notification signal of property workGroupY .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupZ()#
Return type:

int

See also

setWorkGroupZ()

Getter of property workGroupZ .

PySide6.Qt3DRender.Qt3DRender.QComputeCommand.workGroupZChanged()#

Notification signal of property workGroupZ .