Qt3DRender::QComputeCommand Class
class Qt3DRender::QComputeCommandQComponent 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
- runType : RunType
- workGroupX : int
- workGroupY : int
- workGroupZ : int
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
| void | runTypeChanged() |
| void | workGroupXChanged() |
| void | workGroupYChanged() |
| void | workGroupZChanged() |
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); }); [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); }); © 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.