Qt3DRender::QBlitFramebuffer Class
class Qt3DRender::QBlitFramebufferNœud FrameGraph permettant de transférer un rectangle de valeurs de pixels d'une région d'une cible de rendu à une autre. Plus d'informations...
| En-tête : | #include <QBlitFramebuffer> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | BlitFramebuffer |
| Hérite : | Qt3DRender::QFrameGraphNode |
| Statut : | Déclassé |
Types publics
| enum | InterpolationMethod { Nearest, Linear } |
Propriétés
|
|
Fonctions publiques
| 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 |
Signaux
| void | destinationAttachmentPointChanged() |
| void | destinationChanged() |
| void | destinationRectChanged() |
| void | interpolationMethodChanged() |
| void | sourceAttachmentPointChanged() |
| void | sourceChanged() |
| void | sourceRectChanged() |
Description détaillée
Ce nœud insère un glBlitFrameBuffer ou un équivalent dans le flux de commandes. Il s'agit d'une méthode plus efficace pour copier des rectangles entre des textures ou des backbuffers de surface enveloppés par QRenderTarget que de dessiner des quads texturés. Cette méthode permet également la mise à l'échelle avec la méthode d'interpolation spécifiée.
Remarque : dans la pratique, le nœud QBlitFramebuffer sera souvent utilisé en combinaison avec QNoDraw, étant donné qu'un blit ne devrait pas impliquer l'émission d'appels de dessin pour des entités.
Documentation sur les types de membres
enum QBlitFramebuffer::InterpolationMethod
Spécifie l'interpolation appliquée si l'image est étirée.
| Constante | Valeur | Description de l'interpolation |
|---|---|---|
Qt3DRender::QBlitFramebuffer::Nearest | 0 | Interpolation du plus proche voisin. |
Qt3DRender::QBlitFramebuffer::Linear | 1 | Interpolation linéaire. |
Propriété Documentation
destination : Qt3DRender::QRenderTarget*
Spécifie la cible de rendu de destination. Si elle n'est pas définie, la destination est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface courante), s'il y en a un.
Remarque : la source et la destination ne doivent pas faire référence à la même cible de rendu.
Fonctions d'accès :
| Qt3DRender::QRenderTarget * | destination() const |
| void | setDestination(Qt3DRender::QRenderTarget *destination) |
Signal Notificateur :
| void | destinationChanged() |
destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Spécifie le point d'attache cible.
Fonctions d'accès :
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | destinationAttachmentPoint() const |
| void | setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint) |
Signal de notification :
| void | destinationAttachmentPointChanged() |
destinationRect : QRectF
Spécifie le rectangle de destination. Les coordonnées sont supposées suivre le système de coordonnées Qt normal, ce qui signifie que Y va de haut en bas.
Fonctions d'accès :
| QRectF | destinationRect() const |
| void | setDestinationRect(const QRectF &outputRect) |
Signal de notification :
| void | destinationRectChanged() |
interpolationMethod : InterpolationMethod
Cette propriété contient la méthode d'interpolation appliquée si l'image est étirée.
Spécifie l'interpolation appliquée si l'image est étirée. La valeur par défaut est Linear.
Fonctions d'accès :
| Qt3DRender::QBlitFramebuffer::InterpolationMethod | interpolationMethod() const |
| void | setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod) |
Signal de notification :
| void | interpolationMethodChanged() |
source : Qt3DRender::QRenderTarget*
Spécifie la source de la cible de rendu. Si elle n'est pas définie, la source est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface courante), s'il y en a un.
Remarque : la source et la destination ne doivent pas faire référence à la même cible de rendu.
Fonctions d'accès :
Signal Notificateur :
| void | sourceChanged() |
sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Spécifie le point d'attachement de la source.
Fonctions d'accès :
| Qt3DRender::QRenderTargetOutput::AttachmentPoint | sourceAttachmentPoint() const |
| void | setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint) |
Signal de notification :
| void | sourceAttachmentPointChanged() |
sourceRect : QRectF
Spécifie le rectangle source. Les coordonnées sont supposées suivre le système de coordonnées Qt normal, ce qui signifie que Y va de haut en bas.
Fonctions d'accès :
| QRectF | sourceRect() const |
| void | setSourceRect(const QRectF &inputRect) |
Signal Notificateur :
| void | sourceRectChanged() |
Fonction membre Documentation
[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
Construit un nouveau QBlitFramebuffer avec l'adresse parent.
[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()
Destructeur.
Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const
Renvoie la cible de rendu de destination.
Note : Fonction Getter pour la propriété destination.
Voir aussi setDestination().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const
Renvoie le point d'attache de la destination.
Remarque : fonction Getter pour la propriété destinationAttachmentPoint.
Voir également setDestinationAttachmentPoint().
QRectF QBlitFramebuffer::destinationRect() const
Renvoie le rectangle de destination.
Remarque : fonction Getter pour la propriété destinationRect.
Voir également setDestinationRect().
Qt3DRender::QBlitFramebuffer::InterpolationMethod QBlitFramebuffer::interpolationMethod() const
Renvoie la méthode d'interpolation.
Remarque : fonction Getter pour la propriété interpolationMethod.
Voir également setInterpolationMethod().
void QBlitFramebuffer::setDestination(Qt3DRender::QRenderTarget *destination)
Définit la cible de rendu de destination. La valeur par défaut est nullptr, auquel cas la destination est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface courante), s'il existe.
Remarque : la source et la destination ne doivent pas faire référence à la même cible de rendu.
Remarque : comme pour les autres nœuds, destination est automatiquement rattaché à l'instance QBlitFramebuffer si aucun parent n'a été défini. La durée de vie est également suivie, ce qui signifie que la destination redevient nullptr si l'instance destination actuellement définie est détruite.
Note : Fonction de définition pour la propriété destination.
Voir aussi destination().
void QBlitFramebuffer::setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)
Définit la propriété destinationAttachmentPoint. La valeur par défaut est Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.
Remarque : fonction de définition de la propriété destinationAttachmentPoint.
Voir également destinationAttachmentPoint().
void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)
Définit le rectangle de destination à outputRect. Les coordonnées sont supposées suivre le système de coordonnées Qt normal, ce qui signifie que Y va de haut en bas.
Note : Fonction de définition de la propriété destinationRect.
Voir aussi destinationRect().
void QBlitFramebuffer::setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)
Définit l'adresse interpolationMethod qui est appliquée si l'image est étirée. La valeur par défaut est Linear.
Remarque : fonction de définition de la propriété interpolationMethod.
Voir également interpolationMethod().
void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)
Définit la cible de rendu de la source. La valeur par défaut est nullptr, auquel cas la source est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface courante), s'il y en a un.
Remarque : la source et la destination ne doivent pas faire référence à la même cible de rendu.
Remarque : comme pour les autres nœuds, source est automatiquement rattaché à l'instance QBlitFramebuffer si aucun parent n'a été défini. La durée de vie est également suivie, ce qui signifie que la source redevient nullptr si l'instance source actuellement définie est détruite.
Note : Fonction de définition pour la propriété source.
Voir également source().
void QBlitFramebuffer::setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)
Définit la propriété sourceAttachmentPoint. La valeur par défaut est Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.
Remarque : fonction de définition de la propriété sourceAttachmentPoint.
Voir également sourceAttachmentPoint().
void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)
Définit le rectangle source à inputRect. Les coordonnées sont supposées suivre le système de coordonnées Qt normal, ce qui signifie que Y va de haut en bas.
Note : Fonction de définition de la propriété sourceRect.
Voir aussi sourceRect().
Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const
Renvoie la cible de rendu de la source.
Note : Fonction Getter pour la propriété source.
Voir aussi setSource().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const
Renvoie le point d'attache de la source.
Remarque : fonction Getter pour la propriété sourceAttachmentPoint.
Voir également setSourceAttachmentPoint().
QRectF QBlitFramebuffer::sourceRect() const
Renvoie le rectangle source.
Remarque : fonction Getter pour la propriété sourceRect.
Voir également 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.
