Qt3DRender::QRenderCapture Class
class Qt3DRender::QRenderCaptureFrame-Graph-Knoten für die Render-Erfassung. Mehr...
| Überschrift: | #include <Qt3DRender/QRenderCapture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | RenderCapture |
| Erbt von: | Qt3DRender::QFrameGraphNode |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Funktionen
| QRenderCapture(Qt3DCore::QNode *parent = nullptr) | |
| Qt3DRender::QRenderCaptureReply * | requestCapture() |
| Qt3DRender::QRenderCaptureReply * | requestCapture(const QRect &rect) |
Ausführliche Beschreibung
QRenderCapture wird verwendet, um das Rendering in jeder Renderphase als Bild zu erfassen. Die Erfassung muss vom Benutzer initiiert werden, und pro Erfassungsanforderung wird ein Bild zurückgegeben. Der Benutzer kann mehrere Render-Erfassungsanforderungen gleichzeitig ausgeben, jedoch wird pro QRenderCapture-Instanz pro Frame nur eine Anforderung bearbeitet.
Dokumentation der Mitgliedsfunktionen
[explicit] QRenderCapture::QRenderCapture(Qt3DCore::QNode *parent = nullptr)
Der Konstruktor erstellt eine Instanz mit dem angegebenen ` parent`.
[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture()
Wird verwendet, um eine Render-Aufnahme anzufordern. Pro Aufruf von `requestCapture` wird nur ein Ergebnis der Render-Aufnahme erzeugt, selbst wenn der Frame-Graph mehrere Blattknoten enthält. Die Funktion gibt ein `QRenderCaptureReply`-Objekt zurück, das das aufgenommene Bild nach Abschluss des Vorgangs empfängt. Der Benutzer ist dafür verantwortlich, das zurückgegebene Objekt durch Aufruf von `deleterLater()` freizugeben.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture(const QRect &rect)
Wird verwendet, um eine Render-Aufnahme von einem angegebenen „ rect “ anzufordern. Pro Aufruf von „requestCapture“ wird nur ein Render-Aufnahmeergebnis erzeugt, selbst wenn der Frame-Graph mehrere Blattknoten enthält. Die Funktion gibt ein „QRenderCaptureReply“-Objekt zurück, das das aufgenommene Bild erhält, sobald der Vorgang abgeschlossen ist. Der Benutzer ist dafür verantwortlich, das zurückgegebene Objekt durch Aufruf von „ deleteLater()“ freizugeben.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
© 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.
