QRenderCapture Class

class Qt3DRender::QRenderCapture

Framegraf-Knoten für die Rendering-Erfassung. Mehr...

Kopfzeile: #include <Qt3DRender/QRenderCapture>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: RenderCapture
Vererbt: Qt3DRender::QFrameGraphNode
Status: Veraltet

Öffentliche Funktionen

QRenderCapture(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QRenderCaptureReply *requestCapture()
Qt3DRender::QRenderCaptureReply *requestCapture(const QRect &rect)

Detaillierte Beschreibung

QRenderCapture wird verwendet, um das Rendering in einem beliebigen Rendering-Stadium in ein Bild aufzunehmen. Das Capturing muss vom Benutzer initiiert werden und pro Capture-Anfrage wird ein Bild zurückgegeben. Der Benutzer kann mehrere Render-Capture-Anforderungen gleichzeitig stellen, aber es wird nur eine Anforderung pro QRenderCapture-Instanz und pro Frame bedient.

Dokumentation der Mitgliedsfunktionen

[explicit] QRenderCapture::QRenderCapture(Qt3DCore::QNode *parent = nullptr)

Der Konstruktor erzeugt eine Instanz mit dem angegebenen parent.

[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture()

Wird verwendet, um Render-Capture anzufordern. Pro requestCapture-Aufruf wird nur ein Render-Capture-Ergebnis erzeugt, auch wenn der Frame-Graph mehrere Blattknoten hat. Die Funktion gibt ein QRenderCaptureReply Objekt zurück, das das erfasste Bild erhält, wenn sie fertig ist. Der Benutzer ist für die Freigabe des zurückgegebenen Objekts durch den Aufruf von deleterLater() verantwortlich.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture(const QRect &rect)

Wird verwendet, um ein Render-Capture von einem angegebenen rect anzufordern. Pro requestCapture-Aufruf wird nur ein Render-Capture-Ergebnis erzeugt, auch wenn der Frame-Graph mehrere Blattknoten hat. Die Funktion gibt ein QRenderCaptureReply Objekt zurück, das das aufgenommene Bild erhält, wenn sie fertig ist. Der Benutzer ist dafür verantwortlich, das zurückgegebene Objekt durch den Aufruf von deleteLater() wieder freizugeben.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

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