QSSGRenderHelpers Class
Clase que contiene funciones auxiliares para configurar y renderizar elementos renderizables de QtQuick3D. Más...
| Header: | #include <qssgrenderhelpers.h> |
| 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 sobre los tipos de los miembros
enum class QSSGRenderHelpers::CreateFlag
flags QSSGRenderHelpers::CreateFlags
| Constante | Valor | Descripción |
|---|---|---|
QSSGRenderHelpers::CreateFlag::None | 0 | El valor por defecto. Los elementos renderizables se crean únicamente para los nodos especificados. |
QSSGRenderHelpers::CreateFlag::Recurse | 0x1 | Se crean elementos renderizables para cada nodo y sus hijos. |
QSSGRenderHelpers::CreateFlag::Steal | 0x2 | Los elementos renderizables se obtienen del motor y no serán renderizados por ` QtQuick3D`. Nota: Llamar a ` QSSGRenderHelpers::createRenderables()` sin la bandera `{QSSGRenderHelpers::CreateFlag::Steal}{Steal}` activada implica que los nodos se duplican y ` QtQuick3D ` renderizará su copia de los nodos como de costumbre. |
El tipo CreateFlags es un typedef para QFlags<CreateFlag>. Almacena una combinación OR de valores de CreateFlag.
Documentación de las funciones de miembro
[static] QSSGPrepResultId QSSGRenderHelpers::commit(const QSSGFrameData &frameData, QSSGPrepContextId prepId, QSSGRenderablesId renderablesId, float lodThreshold = 1.0f)
Una vez realizados los cambios necesarios en los elementos renderizables, los datos pueden marcarse como listos para el renderizador.
Devuelve un identificador del 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 identificadores de nodos y crea elementos renderizables que el renderizador puede procesar posteriormente. Si no hay nodos, o si no hay nodos renderizables en la lista, el identificador devuelto no será válido.
Por defecto, la función no realiza una búsqueda recursiva ni incluye en la lista los hijos del ` nodes `. Para habilitar la recursión, basta con pasar el indicador ` Recurse ` en el argumento ` flags `.
Devuelve un identificador a los elementos 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 recopilar y almacenar información sobre los datos de renderizado asociados a esta extensión de renderizado.
Si se van a renderizar los mismos nodos más de una vez, pero con propiedades diferentes —por ejemplo, un material o una cámara distintos—, se necesitará un nuevo contexto. Para crear varios contextos para una misma extensión, se puede utilizar el argumento ` slot `. El contexto predeterminado se crea en la ranura 0.
Devuelve un identificador del 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 las llamadas de dibujo necesarios para los elementos renderizables antes de llamar a ` renderRenderables`.
Devuelve un identificador del resultado de la preparación.
frameData, renderPassDescriptor, ps, prepId, filter
Véase también ` renderRenderables()`.
[static] void QSSGRenderHelpers::renderRenderables(const QSSGFrameData &frameData, QSSGPrepResultId prepId)
Renderiza los elementos 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.