QBlitFramebuffer Class
class Qt3DRender::QBlitFramebufferFrameGraph-Knoten zur Übertragung eines Rechtecks von Pixelwerten von einem Bereich eines Rendering-Ziels zu einem anderen. Mehr...
| Kopfzeile: | #include <QBlitFramebuffer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | BlitFramebuffer |
| Vererbt: | Qt3DRender::QFrameGraphNode |
| Status: | Veraltet |
Ö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 eine 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 umhüllt sind, als das Zeichnen von texturierten Quads. Es unterstützt auch die Skalierung mit der angegebenen Interpolationsmethode.
Hinweis: In der Praxis wird der QBlitFramebuffer-Knoten oft in Kombination mit QNoDraw verwendet, da ein Blit keine Zeichnungsaufrufe für irgendwelche Entitäten beinhalten sollte.
Dokumentation der Mitgliedstypen
enum QBlitFramebuffer::InterpolationMethod
Gibt die Interpolation an, die angewendet wird, wenn das Bild gestreckt wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
Qt3DRender::QBlitFramebuffer::Nearest | 0 | Nächste-Nachbarn-Interpolation. |
Qt3DRender::QBlitFramebuffer::Linear | 1 | Lineare Interpolation. |
Eigenschaft Dokumentation
destination : Qt3DRender::QRenderTarget*
Gibt das Rendering-Ziel an. Wenn es nicht festgelegt ist, wird als Ziel der Standard-Framebuffer (d. h. der Backbuffer der aktuellen Oberfläche) angenommen, sofern ein solcher vorhanden ist.
Hinweis: Quelle und Ziel dürfen sich nicht auf das gleiche Rendering-Ziel beziehen.
Zugriffsfunktionen:
| Qt3DRender::QRenderTarget * | destination() const |
| void | setDestination(Qt3DRender::QRenderTarget *destination) |
Notifier-Signal:
| void | destinationChanged() |
destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Gibt den Zielanschlagspunkt an.
Zugriffsfunktionen:
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | destinationAttachmentPoint() const |
| void | setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint) |
Melder-Signal:
| void | destinationAttachmentPointChanged() |
destinationRect : QRectF
Gibt das Zielrechteck an. Es wird angenommen, dass die Koordinaten dem normalen Qt-Koordinatensystem folgen, d.h. Y verläuft von oben nach unten.
Zugriffsfunktionen:
| QRectF | destinationRect() const |
| void | setDestinationRect(const QRectF &outputRect) |
Benachrichtigungssignal:
| void | destinationRectChanged() |
source : Qt3DRender::QRenderTarget*
Gibt das Quell-Rendering-Ziel an. Wenn nichts festgelegt ist, wird als Quelle der Standard-Framebuffer (d. h. der Backbuffer der aktuellen Oberfläche) angenommen, sofern ein solcher vorhanden ist.
Hinweis: Quelle und Ziel dürfen sich nicht auf das gleiche Rendering-Ziel beziehen.
Zugriffsfunktionen:
Notifier-Signal:
| void | sourceChanged() |
sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Gibt den Quellanhangspunkt an.
Zugriffsfunktionen:
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | sourceAttachmentPoint() const |
| void | setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint) |
Melder-Signal:
| void | sourceAttachmentPointChanged() |
sourceRect : QRectF
Gibt das Quellrechteck an. Es wird angenommen, dass die Koordinaten dem normalen Qt-Koordinatensystem folgen, d.h. Y verläuft von oben nach unten.
Zugriffsfunktionen:
| QRectF | sourceRect() const |
| void | setSourceRect(const QRectF &inputRect) |
Benachrichtigungssignal:
| void | sourceRectChanged() |
Member Function Dokumentation
[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
Konstruiert einen neuen QBlitFramebuffer mit dem angegebenen parent.
[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()
Zerstörer.
Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const
Gibt das Ziel-Rendering-Ziel zurück.
Hinweis: Getter-Funktion für die Eigenschaft destination.
Siehe auch setDestination().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const
Gibt den Zielanhängepunkt 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 Rendering-Ziel fest. Der Standardwert ist nullptr, in diesem Fall wird als Ziel der Standard-Framebuffer (d.h. der Backbuffer der aktuellen Oberfläche) angenommen, falls es einen gibt.
Hinweis: Quelle und Ziel dürfen sich nicht auf das gleiche Rendering-Ziel beziehen.
Hinweis: Wie bei anderen Knoten auch, wird destination automatisch der QBlitFramebuffer Instanz zugeordnet, wenn kein Elternteil festgelegt wurde. Die Lebensdauer wird ebenfalls verfolgt, was bedeutet, dass das Ziel zu nullptr zurückkehrt, wenn die aktuell gesetzte destination zerstört wird.
Hinweis: Setter-Funktion für die Eigenschaft destination.
Siehe auch destination().
void QBlitFramebuffer::setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)
Setzt die Eigenschaft destinationAttachmentPoint. Standardmäßig ist dies Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.
Hinweis: Setter-Funktion für die Eigenschaft destinationAttachmentPoint.
Siehe auch destinationAttachmentPoint().
void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)
Setzt das Zielrechteck auf outputRect. Es wird angenommen, dass die Koordinaten dem normalen Qt-Koordinatensystem folgen, d.h. Y 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 interpolationMethod fest, die angewendet wird, wenn das Bild gestreckt wird. Der Standardwert ist Linear.
Hinweis: Setter-Funktion für die Eigenschaft interpolationMethod.
Siehe auch interpolationMethod().
void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)
Legt das Quell-Rendering-Ziel fest. Der Standardwert ist nullptr. In diesem Fall wird angenommen, dass die Quelle der Standard-Framebuffer ist (d.h. der Backbuffer der aktuellen Oberfläche), falls es einen gibt.
Hinweis: Quelle und Ziel dürfen sich nicht auf das gleiche Rendering-Ziel beziehen.
Hinweis: Wie bei anderen Knoten auch, wird source automatisch der QBlitFramebuffer Instanz zugeordnet, wenn kein Elternteil festgelegt wurde. Die Lebensdauer wird ebenfalls verfolgt, was bedeutet, dass die Quelle zu nullptr zurückkehrt, wenn die aktuell gesetzte source zerstört wird.
Hinweis: Setter-Funktion für die Eigenschaft source.
Siehe auch source().
void QBlitFramebuffer::setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)
Setzt die Eigenschaft sourceAttachmentPoint. Standardmäßig ist dies Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.
Hinweis: Setter-Funktion für die Eigenschaft sourceAttachmentPoint.
Siehe auch sourceAttachmentPoint().
void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)
Setzt das Quellrechteck auf inputRect. Es wird angenommen, dass die Koordinaten dem normalen Qt-Koordinatensystem folgen, d.h. Y verläuft von oben nach unten.
Hinweis: Setter-Funktion für die Eigenschaft sourceRect.
Siehe auch sourceRect().
Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const
Gibt das Rendering-Ziel der Quelle zurück.
Hinweis: Getter-Funktion für die Eigenschaft source.
Siehe auch setSource().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const
Gibt den Quellanhängepunkt 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().
© 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.
