Qt3DRender::QBlitFramebuffer Class
class Qt3DRender::QBlitFramebufferFrameGraph-Knoten zum Übertragen eines Rechtecks mit Pixelwerten von einem Bereich eines Renderziels in einen anderen. Mehr...
| Header: | #include <qblitframebuffer.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | BlitFramebuffer |
| Erbt von: | Qt3DRender::QFrameGraphNode |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | InterpolationMethod { Nearest, Linear } |
Eigenschaften
|
|
Öffentliche Funktionen
| QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QBlitFramebuffer() |
| Qt3DRender::QRenderTarget * | destination() const |
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | destinationAttachmentPoint() const |
| QRectF | destinationRect() const |
| Qt3DRender::QBlitFramebuffer::InterpolationMethod | interpolationMethod() const |
| void | setDestination(Qt3DRender::QRenderTarget *destination) |
| void | setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint) |
| void | setDestinationRect(const QRectF &outputRect) |
| void | setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod) |
| void | setSource(Qt3DRender::QRenderTarget *source) |
| void | setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint) |
| void | setSourceRect(const QRectF &inputRect) |
| Qt3DRender::QRenderTarget * | source() const |
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | sourceAttachmentPoint() const |
| QRectF | sourceRect() const |
Signale
| void | destinationAttachmentPointChanged() |
| void | destinationChanged() |
| void | destinationRectChanged() |
| void | interpolationMethodChanged() |
| void | sourceAttachmentPointChanged() |
| void | sourceChanged() |
| void | sourceRectChanged() |
Detaillierte Beschreibung
Dieser Knoten fügt einen „ glBlitFrameBuffer “ oder ein Äquivalent in den Befehlsstrom ein. Dies bietet eine effizientere Methode zum Kopieren von Rechtecken zwischen Texturen oder Oberflächen-Backbuffern, die von „ QRenderTarget “ umschlossen sind, als das Zeichnen texturierter Quadrate. Außerdem unterstützt er die Skalierung mit der angegebenen Interpolationsmethode.
Hinweis: In der Praxis wird der Knoten „QBlitFramebuffer“ häufig in Kombination mit „ QNoDraw “ verwendet, da ein Blit keine Draw-Aufrufe für Entitäten erfordern sollte.
Dokumentation zu den Mitgliedstypen
enum QBlitFramebuffer::InterpolationMethod
Legt die Interpolationsmethode fest, die angewendet wird, wenn das Bild gestreckt wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
Qt3DRender::QBlitFramebuffer::Nearest | 0 | Interpolation nach dem Prinzip des nächsten Nachbarn. |
Qt3DRender::QBlitFramebuffer::Linear | 1 | Lineare Interpolation. |
Dokumentation zur Eigenschaft
destination : Qt3DRender::QRenderTarget*
Legt das Ziel-Renderziel fest. Wenn kein Ziel angegeben wird, wird davon ausgegangen, dass es sich um den Standard-Framebuffer handelt (d. h. den Backbuffer der aktuellen Oberfläche), sofern ein solcher vorhanden ist.
Hinweis: Quelle und Ziel dürfen sich nicht auf dasselbe Renderziel beziehen.
Zugriffsfunktionen:
| Qt3DRender::QRenderTarget * | destination() const |
| void | setDestination(Qt3DRender::QRenderTarget *destination) |
Notifier-Signal:
| void | destinationChanged() |
destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Legt den Zielbefestigungspunkt fest.
Zugriffsfunktionen:
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | destinationAttachmentPoint() const |
| void | setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint) |
Benachrichtigungssignal:
| void | destinationAttachmentPointChanged() |
destinationRect : QRectF
Legt das Zielrechteck fest. Es wird davon ausgegangen, dass die Koordinaten dem üblichen Qt-Koordinatensystem entsprechen, d. h., die Y-Achse verläuft von oben nach unten.
Zugriffsfunktionen:
| QRectF | destinationRect() const |
| void | setDestinationRect(const QRectF &outputRect) |
Notifier-Signal:
| void | destinationRectChanged() |
interpolationMethod : InterpolationMethod
Diese Eigenschaft legt fest, welche Interpolationsmethode angewendet wird, wenn das Bild gestreckt wird.
Legt die Interpolationsmethode fest, die angewendet wird, wenn das Bild gestreckt wird. Standardmäßig ist „Linear“ eingestellt.
Zugriffsfunktionen:
| Qt3DRender::QBlitFramebuffer::InterpolationMethod | interpolationMethod() const |
| void | setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod) |
Benachrichtigungssignal:
| void | interpolationMethodChanged() |
source : Qt3DRender::QRenderTarget*
Legt das Quell-Renderziel fest. Ist dieser Parameter nicht festgelegt, wird davon ausgegangen, dass die Quelle der Standard-Framebuffer ist (d. h. der Backbuffer der aktuellen Oberfläche), sofern ein solcher vorhanden ist.
Hinweis: Quelle und Ziel dürfen sich nicht auf dasselbe Renderziel beziehen.
Zugriffsfunktionen:
Notifier-Signal:
| void | sourceChanged() |
sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Legt den Quellbefestigungspunkt fest.
Zugriffsfunktionen:
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | sourceAttachmentPoint() const |
| void | setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint) |
Benachrichtigungssignal:
| void | sourceAttachmentPointChanged() |
sourceRect : QRectF
Legt das Quellrechteck fest. Es wird davon ausgegangen, dass die Koordinaten dem üblichen Qt-Koordinatensystem entsprechen, d. h., die Y-Achse verläuft von oben nach unten.
Zugriffsfunktionen:
| QRectF | sourceRect() const |
| void | setSourceRect(const QRectF &inputRect) |
Notifier-Signal:
| void | sourceRectChanged() |
Dokumentation der Mitgliedsfunktionen
[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
Erstellt einen neuen `QBlitFramebuffer` mit dem angegebenen ` parent`.
[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()
Destruktor.
Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const
Gibt das Ziel-Render-Target zurück.
Hinweis: Getter -Funktion für die Eigenschaft „destination“.
Siehe auch ` setDestination()`.
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const
Gibt den Zielbefestigungspunkt zurück.
Hinweis: Getter -Funktion für die Eigenschaft „destinationAttachmentPoint“.
Siehe auch „ setDestinationAttachmentPoint()“.
QRectF QBlitFramebuffer::destinationRect() const
Gibt das Zielrechteck zurück.
Hinweis: Getter -Funktion für die Eigenschaft „destinationRect“.
Siehe auch „ setDestinationRect()“.
Qt3DRender::QBlitFramebuffer::InterpolationMethod QBlitFramebuffer::interpolationMethod() const
Gibt die Interpolationsmethode zurück.
Hinweis: Getter -Funktion für die Eigenschaft „interpolationMethod“.
Siehe auch „ setInterpolationMethod()“.
void QBlitFramebuffer::setDestination(Qt3DRender::QRenderTarget *destination)
Legt das Ziel-Renderziel fest. Der Standardwert ist `nullptr`; in diesem Fall wird davon ausgegangen, dass das Ziel der Standard-Framebuffer ist (d. h. der Backbuffer der aktuellen Oberfläche), sofern ein solcher vorhanden ist.
Hinweis: Quelle und Ziel dürfen sich nicht auf dasselbe Renderziel beziehen.
Hinweis: Wie bei anderen Knoten wird „ destination “ automatisch der Instanz „ QBlitFramebuffer “ untergeordnet, wenn kein übergeordneter Knoten festgelegt wurde. Die Lebensdauer wird ebenfalls nachverfolgt, d. h., das Ziel wird auf `nullptr` zurückgesetzt, falls die aktuell festgelegte Instanz „ destination “ zerstört wird.
Hinweis: Setter -Funktion für die Eigenschaft „ destination “.
Siehe auch ` destination()`.
void QBlitFramebuffer::setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)
Legt die Eigenschaft „ destinationAttachmentPoint “ fest. Der Standardwert ist „ Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 “.
Hinweis: Setter -Funktion für die Eigenschaft ` destinationAttachmentPoint`.
Siehe auch destinationAttachmentPoint().
void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)
Legt das Zielrechteck auf „ outputRect “ fest. Es wird davon ausgegangen, dass die Koordinaten dem üblichen Qt-Koordinatensystem entsprechen, d. h., die Y-Achse verläuft von oben nach unten.
Hinweis: Setter -Funktion für die Eigenschaft ` destinationRect`.
Siehe auch ` destinationRect()`.
void QBlitFramebuffer::setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)
Legt die Skalierungsfunktion „ interpolationMethod “ fest, die beim Dehnen des Bildes angewendet wird. Die Standardeinstellung ist „Linear“.
Hinweis: Setter -Funktion für die Eigenschaft „ interpolationMethod “.
Siehe auch „ interpolationMethod()“.
void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)
Legt das Quell-Renderziel fest. Der Standardwert ist `nullptr`; in diesem Fall wird davon ausgegangen, dass die Quelle der Standard-Framebuffer ist (d. h. der Backbuffer der aktuellen Oberfläche), sofern vorhanden.
Hinweis: Quelle und Ziel dürfen sich nicht auf dasselbe Renderziel beziehen.
Hinweis: Wie bei anderen Knoten wird „ source “ automatisch der Instanz „ QBlitFramebuffer “ untergeordnet, wenn kein übergeordneter Knoten festgelegt wurde. Die Lebensdauer wird ebenfalls verfolgt, was bedeutet, dass die Quelle auf `nullptr` zurückgesetzt wird, falls die aktuell festgelegte Instanz „ source “ zerstört wird.
Hinweis: Setter -Funktion für die Eigenschaft „ source “.
Siehe auch ` source()`.
void QBlitFramebuffer::setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)
Legt die Eigenschaft „ sourceAttachmentPoint “ fest. Der Standardwert ist „ Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 “.
Hinweis: Setter -Funktion für die Eigenschaft ` sourceAttachmentPoint`.
Siehe auch sourceAttachmentPoint().
void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)
Legt das Quellrechteck auf „ inputRect “ fest. Es wird davon ausgegangen, dass die Koordinaten dem normalen Qt-Koordinatensystem entsprechen, d. h., die Y-Achse verläuft von oben nach unten.
Hinweis: Setter -Funktion für die Eigenschaft ` sourceRect`.
Siehe auch ` sourceRect()`.
Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const
Gibt das Quell-Renderziel zurück.
Hinweis: Getter -Funktion für die Eigenschaft „source“.
Siehe auch „ setSource()“.
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const
Gibt den Quellbefestigungspunkt zurück.
Hinweis: Getter -Funktion für die Eigenschaft „sourceAttachmentPoint“.
Siehe auch „ setSourceAttachmentPoint()“.
QRectF QBlitFramebuffer::sourceRect() const
Gibt das Quellrechteck zurück.
Hinweis: Getter -Funktion für die Eigenschaft „sourceRect“.
Siehe auch „ setSourceRect()“.
© 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.
