En esta página

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)

Descripción detallada

Documentación sobre los tipos de los miembros

enum class QSSGRenderHelpers::CreateFlag
flags QSSGRenderHelpers::CreateFlags

ConstanteValorDescripción
QSSGRenderHelpers::CreateFlag::None0El valor por defecto. Los elementos renderizables se crean únicamente para los nodos especificados.
QSSGRenderHelpers::CreateFlag::Recurse0x1Se crean elementos renderizables para cada nodo y sus hijos.
QSSGRenderHelpers::CreateFlag::Steal0x2Los 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.