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 vers une autre. En savoir plus...
| En-tête : | #include <qblitframebuffer.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | BlitFramebuffer |
| Hérite de : | Qt3DRender::QFrameGraphNode |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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 son équivalent dans le flux de commandes. Cela offre une méthode plus efficace pour copier des rectangles entre des textures ou des tampons de surface gérés par « QRenderTarget » que de dessiner des quadrilatères texturés. Il prend également en charge la mise à l'échelle avec la méthode d'interpolation spécifiée.
Remarque : en pratique, le nœud QBlitFramebuffer sera souvent utilisé en combinaison avec QNoDraw, car un blit ne doit pas impliquer l'émission d'appels de dessin pour aucune entité.
Documentation sur les types de membres
enum QBlitFramebuffer::InterpolationMethod
Spécifie l'interpolation appliquée en cas d'étirement de l'image.
| Constante | Valeur | Description |
|---|---|---|
Qt3DRender::QBlitFramebuffer::Nearest | 0 | Interpolation par le plus proche voisin. |
Qt3DRender::QBlitFramebuffer::Linear | 1 | Interpolation linéaire. |
Documentation sur les propriétés
destination : Qt3DRender::QRenderTarget*
Spécifie la cible de rendu de destination. Si ce paramètre n'est pas défini, la destination est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface actuelle), s'il en existe 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 de notification :
| void | destinationChanged() |
destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Spécifie le point de fixation 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 standard de Qt, c'est-à-dire que l'axe Y s'étend 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é définit la méthode d'interpolation appliquée lorsque l'image est étirée.
Spécifie l'interpolation appliquée lorsque l'image est étirée. La valeur par défaut est Linéaire.
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 cible de rendu source. Si ce paramètre n'est pas défini, la source est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface actuelle), s'il existe.
Remarque : la source et la destination ne doivent pas faire référence à la même cible de rendu.
Fonctions d'accès :
Signal de notification :
| void | sourceChanged() |
sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint
Spécifie le point d'attache 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 standard de Qt, c'est-à-dire que l'axe Y s'étend de haut en bas.
Fonctions d'accès :
| QRectF | sourceRect() const |
| void | setSourceRect(const QRectF &inputRect) |
Signal de notification :
| void | sourceRectChanged() |
Documentation des fonctions membres
[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
Crée un nouvel objet `QBlitFramebuffer` avec l'parent` spécifié.
[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()
Destructeur.
Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const
Renvoie la cible de rendu de destination.
Remarque : fonctiongetter pour la propriété destination.
Voir aussi setDestination().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const
Renvoie le point d'attache de destination.
Remarque : fonctiongetter pour la propriété destinationAttachmentPoint.
Voir aussi setDestinationAttachmentPoint().
QRectF QBlitFramebuffer::destinationRect() const
Renvoie le rectangle de destination.
Remarque : fonctiongetter pour la propriété destinationRect.
Voir aussi setDestinationRect().
Qt3DRender::QBlitFramebuffer::InterpolationMethod QBlitFramebuffer::interpolationMethod() const
Renvoie la méthode d'interpolation.
Remarque : fonctiongetter pour la propriété interpolationMethod.
Voir aussi setInterpolationMethod().
void QBlitFramebuffer::setDestination(Qt3DRender::QRenderTarget *destination)
Définit la cible de rendu de destination. La valeur par défaut est `nullptr` ; dans ce cas, la destination est supposée être le framebuffer par défaut (c'est-à-dire le backbuffer de la surface actuelle), 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 lorsqu’aucun parent n’a été défini. Sa durée de vie est également suivie, ce qui signifie que la destination revient à nullptr si l’ destination actuellement définie est détruite.
Remarque : fonctionde définition pour la propriété destination.
Voir également 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 : fonctionde définition de la propriété destinationAttachmentPoint.
Voir aussi destinationAttachmentPoint().
void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)
Définit le rectangle de destination sur outputRect. Les coordonnées sont supposées suivre le système de coordonnées standard de Qt, c'est-à-dire que l'axe Y va du haut vers le bas.
Remarque : fonctionde définition de la propriété destinationRect.
Voir aussi destinationRect().
void QBlitFramebuffer::setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)
Définit l'interpolationMethod appliquée lorsque l'image est étirée. La valeur par défaut est « Linear ».
Remarque : fonctionde définition de la propriété ` interpolationMethod`.
Voir aussi ` interpolationMethod()`.
void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)
Définit la cible de rendu source. La valeur par défaut est `nullptr` ; dans ce cas, la source est considérée comme étant le framebuffer par défaut (c'est-à-dire le backbuffer de la surface actuelle), 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, source est automatiquement rattaché à l’instance QBlitFramebuffer lorsqu’aucun parent n’a été défini. Sa durée de vie est également suivie, ce qui signifie que la source revient à nullptr si l’ source, actuellement définie, est détruite.
Remarque : fonctionde 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 : fonctionde définition de la propriété sourceAttachmentPoint.
Voir aussi sourceAttachmentPoint().
void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)
Définit le rectangle source sur inputRect. Les coordonnées sont supposées suivre le système de coordonnées standard de Qt, c'est-à-dire que l'axe Y s'étend de haut en bas.
Remarque : fonctionde définition de la propriété sourceRect.
Voir aussi sourceRect().
Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const
Renvoie la cible de rendu source.
Remarque : fonctionde lecture pour la propriété source.
Voir aussi setSource().
Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const
Renvoie le point d'attache source.
Remarque : fonctiongetter pour la propriété sourceAttachmentPoint.
Voir aussi setSourceAttachmentPoint().
QRectF QBlitFramebuffer::sourceRect() const
Renvoie le rectangle source.
Remarque : fonctiongetter pour la propriété sourceRect.
Voir aussi 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.
