Auf dieser Seite

QSSGFrameData Class

Speicherklasse, die die für einen Frame erfassten Daten enthält. Mehr...

Header: #include <qssgrenderextensions.h>
Since: Qt 6.7

Öffentliche Funktionen

QSSGCameraId activeCamera() const
QSSGNodeIdList getLayerNodes(QSSGCameraId cameraId, QSSGFrameData::TypeMask typeMask = NodeMask) const
QSSGNodeIdList getLayerNodes(quint32 layerMask, QSSGFrameData::TypeMask typeMask = NodeMask) const
QSSGRhiGraphicsPipelineState getPipelineState() const
QSSGFrameData::Result getRenderResult(QSSGFrameData::RenderResult id) const
QSSGFrameData::Result getRenderResult(QSSGResourceId userPassId, QSSGFrameData::AttachmentSelector attachment) const
void scheduleRenderResults(QSSGFrameData::RenderResults results) const

Ausführliche Beschreibung

Dokumentation zu den Member-Funktionen

QSSGCameraId QSSGFrameData::activeCamera() const

Gibt die aktive Kamera für die Szene zurück oder „null“, falls keine gefunden werden konnte.

QSSGNodeIdList QSSGFrameData::getLayerNodes(QSSGCameraId cameraId, QSSGFrameData::TypeMask typeMask = NodeMask) const

Gibt eine Liste der Layer-Knoten für die angegebene „ cameraId “ zurück, die mit der „ typeMask “ übereinstimmen. Verfügt die Kamera über keine Layer-Maske, wird eine leere Liste zurückgegeben.

QSSGNodeIdList QSSGFrameData::getLayerNodes(quint32 layerMask, QSSGFrameData::TypeMask typeMask = NodeMask) const

Gibt eine Liste von Layer-Knoten zurück, die den Kriterien layerMask und typeMask entsprechen.

QSSGRhiGraphicsPipelineState QSSGFrameData::getPipelineState() const

Gibt den Basis-Pipeline-Status für diesen Frame zurück

QSSGFrameData::Result QSSGFrameData::getRenderResult(QSSGFrameData::RenderResult id) const

Gibt die renderbare Textur zurück, die von „ id “ erzeugt wurde. „ nullptr “, wenn kein passendes „ id “ gefunden wurde.

Hinweis: Selbst wenn die Funktion ein von null verschiedenes Ergebnis zurückgibt, ist die zurückgegebene `QSSGRhiRenderableTexture` möglicherweise noch nicht bereit, solange der Rendering-Durchlauf für die Textur nicht ausgeführt wurde.

Hinweis: Der zurückgegebene Wert ist nur innerhalb des aktuellen Frames gültig. Bei jedem neuen Frame wird das Renderable zurückgesetzt und sollte daher erneut abgefragt werden.

QSSGFrameData::Result QSSGFrameData::getRenderResult(QSSGResourceId userPassId, QSSGFrameData::AttachmentSelector attachment) const

Gibt das renderbare Texturergebnis eines benutzerdefinierten Render-Passes mit dem angegebenen „ userPassId “ zurück. Wenn kein passender Benutzer-Pass gefunden werden konnte oder wenn der Benutzer-Pass keine renderbaren Texturen erzeugt hat, wird ein ungültiges Ergebnis zurückgegeben.

Hinweis: Selbst wenn die Funktion ein Ergebnis ungleich null zurückgibt, ist die zurückgegebene `QSSGRhiRenderableTexture` möglicherweise noch nicht bereit, solange der Render-Durchlauf für die Textur nicht ausgeführt wurde.

Hinweis: Der zurückgegebene Wert ist nur innerhalb des aktuellen Frames gültig. Bei jedem neuen Frame wird die renderbare Textur zurückgesetzt und sollte daher erneut abgefragt werden.

void QSSGFrameData::scheduleRenderResults(QSSGFrameData::RenderResults results) const

Lege fest, dass das angegebene ` results ` für diesen Frame zur Verfügung steht.

Diese Funktion sollte nur während der Vorbereitungsphase in ` QSSGRenderExtension::prepareData()` aufgerufen werden.

Hinweis: Die angeforderten Ergebnisse sind möglicherweise nicht verfügbar, wenn die zugrunde liegende Ebene diese nicht unterstützt oder wenn die Ebene keine Daten enthält, die zur Erzeugung der angeforderten Ergebnisse erforderlich wären; in diesem Fall gibt ` getRenderResult()` ein leeres Ergebnis zurück.

Siehe auch ` getRenderResult()`.

© 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.