QSSGRenderHelpers Class
Clase que contiene funciones de ayuda para configurar y renderizar QtQuick3D renderables. Más...
| Header: | #include <QSSGRenderHelpers> |
| Since: | Qt 6.7 |
Tipos públicos
| enum class | CreateFlag { None, Recurse, Steal } |
| flags | CreateFlags |
Miembros públicos estáticos
| QSSGPrepResultId | commit(const QSSGFrameData &frameData, QSSGPrepContextId prepId, QSSGRenderablesId renderablesId, float lodThreshold = 1.0f) |
| QSSGRenderablesId | createRenderables(const QSSGFrameData &frameData, QSSGPrepContextId prepId, const QSSGNodeIdList &nodes, QSSGRenderHelpers::CreateFlags flags = CreateFlag::None) |
| QSSGPrepContextId | prepareForRender(const QSSGFrameData &frameData, const QSSGRenderExtension &ext, QSSGCameraId cameraId, quint32 slot = 0) |
| void | prepareRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId, QRhiRenderPassDescriptor *renderPassDescriptor, QSSGRhiGraphicsPipelineState &ps, QSSGRenderablesFilters filter = QSSGRenderablesFilter::All) |
| void | renderRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId) |
Documentación de tipos de miembros
enum class QSSGRenderHelpers::CreateFlag
flags QSSGRenderHelpers::CreateFlags
| Constante | Valor | Descripción |
|---|---|---|
QSSGRenderHelpers::CreateFlag::None | 0 | Valor por defecto. Los renderizables se crean sólo para los nodos especificados. |
QSSGRenderHelpers::CreateFlag::Recurse | 0x1 | Los renderizables se crean para cada nodo y sus hijos. |
QSSGRenderHelpers::CreateFlag::Steal | 0x2 | Los renderizables se toman del motor y no serán renderizados por QtQuick3D. |
Nota: Llamar a QSSGRenderHelpers::createRenderables() sin la bandera {QSSGRenderHelpers::CreateFlag::Steal}{Steal} establecida significa que los nodos están duplicados y QtQuick3D renderizará su copia de los nodos de forma normal.
El tipo CreateFlags es un typedef para QFlags<CreateFlag>. Almacena una combinación OR de valores CreateFlag.
Documentación de las funciones miembro
[static] QSSGPrepResultId QSSGRenderHelpers::commit(const QSSGFrameData &frameData, QSSGPrepContextId prepId, QSSGRenderablesId renderablesId, float lodThreshold = 1.0f)
Una vez realizados los cambios necesarios en los renderizables, los datos pueden marcarse como listos para el renderizador.
Devuelve un id al resultado de la preparación.
frameData, prepId, renderablesId, lodThreshold
Véase también prepareRenderables() y renderRenderables().
[static] QSSGRenderablesId QSSGRenderHelpers::createRenderables(const QSSGFrameData &frameData, QSSGPrepContextId prepId, const QSSGNodeIdList &nodes, QSSGRenderHelpers::CreateFlags flags = CreateFlag::None)
Toma una lista de ids de nodos y crea renderizables que pueden ser procesados posteriormente por el renderizador. Si no hay nodos, o no hay nodos renderizables en la lista, el id devuelto será inválido.
Por defecto la función no recurre hacia abajo e incluye los hijos de nodes en la lista. Se puede habilitar la recursión pasando la bandera Recurse en el argumento flags.
Devuelve un id a los renderizables creados.
frameData, prepId
Véase también CreateFlags y prepareForRender().
[static] QSSGPrepContextId QSSGRenderHelpers::prepareForRender(const QSSGFrameData &frameData, const QSSGRenderExtension &ext, QSSGCameraId cameraId, quint32 slot = 0)
prepareForRender() crea un contexto para recoger y almacenar información sobre los datos de render asociados a esta extensión de render.
Si los mismos nodos van a ser renderizados más de una vez pero con diferentes propiedades, por ejemplo un material o cámara diferente, entonces se necesitará un nuevo contexto. Para crear varios contextos para una extensión se puede utilizar el argumento slot. El contexto por defecto se crea en la ranura 0.
Devuelve un id al contexto de preparación.
frameData ext, cameraId
Véase también commit().
[static] void QSSGRenderHelpers::prepareRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId, QRhiRenderPassDescriptor *renderPassDescriptor, QSSGRhiGraphicsPipelineState &ps, QSSGRenderablesFilters filter = QSSGRenderablesFilter::All)
Prepara los datos de llamada a dibujo necesarios para los renderizables antes de llamar a renderRenderables.
Devuelve un id al resultado de la preparación.
frameData, renderPassDescriptor, ps, prepId, filter
Ver también renderRenderables().
[static] void QSSGRenderHelpers::renderRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId)
Renderiza los renderizables.
frameData, prepId
Véase también prepareRenderables().
© 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.
