En esta página

Qt3DRender::QComputeCommand Class

class Qt3DRender::QComputeCommand

QComponent para enviar trabajo al shader de cálculo en la GPU. Más información...

Encabezado: #include <qcomputecommand.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: ComputeCommand
Heredado de: Qt3DCore::QComponent
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QComputeCommand(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QComputeCommand::RunType runType() const
int workGroupX() const
int workGroupY() const
int workGroupZ() const

Ranuras públicas

void setRunType(Qt3DRender::QComputeCommand::RunType runType)
void setWorkGroupX(int workGroupX)
void setWorkGroupY(int workGroupY)
void setWorkGroupZ(int workGroupZ)
void trigger(int frameCount = 1)
void trigger(int workGroupX, int workGroupY, int workGroupZ, int frameCount = 1)

Señales

Descripción detallada

Un ` Qt3DRender::QComputeCommand ` se utiliza para enviar trabajo al shader de cálculo. El shader de cálculo se especifica en el componente ` QMaterial ` de la misma entidad a la que se añade el `QComputeCommand`. Las propiedades ` workGroupX`, ` workGroupY ` y ` workGroupZ ` especifican los tamaños de los grupos de trabajo para la invocación del shader de cálculo. El nodo ` Qt3DRender::QDispatchCompute ` debe estar presente en el `FrameGraph` para que los comandos se ejecuten realmente.

Nota: Si la política de renderizado está configurada en « Qt3DRender::QRenderSettings::OnDemand » y no hay cambios en la escena, el ComputeCommand no se invocará repetidamente. Debe configurarse la política de renderizado « Qt3DRender::QRenderSettings::Always » para que el ComputeCommand se invoque repetidamente si no hay otros cambios en la escena que desencadenen el renderizado de un nuevo fotograma.

Documentación de propiedades

runType : RunType

Especifica si el comando de cálculo debe ejecutarse en cada fotograma o activarse manualmente.

Si se establece en «Continuo», el comando «Compute» se ejecuta en cada fotograma. Esta es la configuración predeterminada.

Si se establece en «Manual», el comando «Compute» se ejecuta durante un número determinado de fotogramas y, a continuación, el componente se desactiva automáticamente.

Funciones de acceso:

Qt3DRender::QComputeCommand::RunType runType() const
void setRunType(Qt3DRender::QComputeCommand::RunType runType)

Señal de notificación:

void runTypeChanged()

workGroupX : int

Especifica el tamaño del grupo de trabajo X.

Funciones de acceso:

int workGroupX() const
void setWorkGroupX(int workGroupX)

Señal de notificación:

void workGroupXChanged()

workGroupY : int

Especifica el tamaño del grupo de trabajo Y.

Funciones de acceso:

int workGroupY() const
void setWorkGroupY(int workGroupY)

Señal del notificador:

void workGroupYChanged()

workGroupZ : int

Especifica el tamaño del grupo de trabajo Z.

Funciones de acceso:

int workGroupZ() const
void setWorkGroupZ(int workGroupZ)

Señal de notificador:

void workGroupZChanged()

Documentación de la función miembro

[explicit] QComputeCommand::QComputeCommand(Qt3DCore::QNode *parent = nullptr)

El constructor crea una nueva instancia de ` Qt3DRender::QComputeCommand ` con el ` parent` especificado.

[slot] void QComputeCommand::setWorkGroupX(int workGroupX)

Establece el grupo de trabajo de la primera dimensión en « workGroupX ».

Nota: Funciónde asignación para la propiedad workGroupX.

Véase también ` workGroupX()`.

[slot] void QComputeCommand::setWorkGroupY(int workGroupY)

Establece el grupo de trabajo de la segunda dimensión en « workGroupY ».

Nota: Funciónde asignación para la propiedad workGroupY.

Véase también ` workGroupY()`.

[slot] void QComputeCommand::setWorkGroupZ(int workGroupZ)

Establece el grupo de trabajo de la tercera dimensión en « workGroupZ ».

Nota: Funciónde asignación para la propiedad workGroupZ.

Véase también workGroupZ().

[slot] void QComputeCommand::trigger(int frameCount = 1)

Cuando el tipo de ejecución está configurado en «Manual», al activar el disparador se ejecutará el comando de cálculo durante los siguientes frameCount fotogramas. Una vez finalizada la ejecución, la propiedad «enabled» se establecerá en «false».

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        computeCommand, qOverload(&QComputeCommand::trigger));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        computeCommand, [receiver = computeCommand](int frameCount) { receiver->trigger(frameCount); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

[slot] void QComputeCommand::trigger(int workGroupX, int workGroupY, int workGroupZ, int frameCount = 1)

Cuando el tipo de ejecución se establece en «Manual», al activar el disparador se ejecutará el comando de cálculo durante las siguientes frameCount tramas. Una vez finalizada la ejecución, la propiedad «enabled» se establecerá en «false». El tamaño del grupo de trabajo establecido previamente se sustituirá por workGroupX, workGroupY y workGroupZ.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        computeCommand, qOverload(&QComputeCommand::trigger));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        computeCommand, [receiver = computeCommand](int workGroupX, int workGroupY, int workGroupZ, int frameCount) { receiver->trigger(workGroupX, workGroupY, workGroupZ, frameCount); });
Para ver más ejemplos y métodos, consulta «Conexión a ranuras sobrecargadas».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.