Sur cette page

QOpenGLFramebufferObjectFormat Class

La classe `QOpenGLFramebufferObjectFormat` définit le format d'un objet framebuffer OpenGL. En savoir plus...

En-tête : #include <QOpenGLFramebufferObjectFormat>
CMake : find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake : QT += opengl

Fonctions publiques

QOpenGLFramebufferObjectFormat()
QOpenGLFramebufferObjectFormat(const QOpenGLFramebufferObjectFormat &other)
~QOpenGLFramebufferObjectFormat()
QOpenGLFramebufferObject::Attachment attachment() const
GLenum internalTextureFormat() const
bool mipmap() const
int samples() const
void setAttachment(QOpenGLFramebufferObject::Attachment attachment)
void setInternalTextureFormat(GLenum internalTextureFormat)
void setMipmap(bool enabled)
void setSamples(int samples)
void setTextureTarget(GLenum target)
GLenum textureTarget() const
bool operator!=(const QOpenGLFramebufferObjectFormat &other) const
QOpenGLFramebufferObjectFormat &operator=(const QOpenGLFramebufferObjectFormat &other)
bool operator==(const QOpenGLFramebufferObjectFormat &other) const

Description détaillée

Un objet framebuffer présente plusieurs caractéristiques :

Notez que les pièces jointes souhaitées ou le nombre d'échantillons par pixel peuvent ne pas être pris en charge par le pilote matériel. Appelez la fonction QOpenGLFramebufferObject::format() après avoir créé un objet QOpenGLFramebufferObject afin de déterminer le format exact utilisé pour créer cet objet.

Voir également QOpenGLFramebufferObject.

Documentation des fonctions membres

QOpenGLFramebufferObjectFormat::QOpenGLFramebufferObjectFormat()

Crée un objet `QOpenGLFramebufferObjectFormat` permettant de spécifier le format d'un objet framebuffer OpenGL.

Par défaut, le format spécifie un objet framebuffer non multisample sans annexes de profondeur/stencil, avec une cible de texture GL_TEXTURE_2D et un format interne GL_RGBA8. Sur les systèmes OpenGL/ES, le format interne par défaut est GL_RGBA.

Voir également samples(), attachment() et internalTextureFormat().

QOpenGLFramebufferObjectFormat::QOpenGLFramebufferObjectFormat(const QOpenGLFramebufferObjectFormat &other)

Crée une copie de other.

[noexcept] QOpenGLFramebufferObjectFormat::~QOpenGLFramebufferObjectFormat()

Supprime l'QOpenGLFramebufferObjectFormat.

QOpenGLFramebufferObject::Attachment QOpenGLFramebufferObjectFormat::attachment() const

Renvoie la configuration des tampons de profondeur et de stencil associés à un objet framebuffer. La valeur par défaut est QOpenGLFramebufferObject::NoAttachment.

Voir également setAttachment().

GLenum QOpenGLFramebufferObjectFormat::internalTextureFormat() const

Renvoie le format interne de la texture d’un objet framebuffer ou du tampon de couleurs d’un objet framebuffer multisample. La valeur par défaut est « GL_RGBA8 » sur les systèmes OpenGL de bureau, et « GL_RGBA » sur les systèmes OpenGL/ES.

Voir également setInternalTextureFormat().

bool QOpenGLFramebufferObjectFormat::mipmap() const

Renvoie « true » si le mipmapping est activé.

Voir aussi setMipmap().

int QOpenGLFramebufferObjectFormat::samples() const

Renvoie le nombre d’échantillons par pixel si l’objet framebuffer est un objet framebuffer multi-échantillon. Sinon, renvoie 0. La valeur par défaut est 0.

Voir également setSamples().

void QOpenGLFramebufferObjectFormat::setAttachment(QOpenGLFramebufferObject::Attachment attachment)

Définit la configuration de rattachement d'un objet framebuffer sur « attachment ».

Voir également attachment().

void QOpenGLFramebufferObjectFormat::setInternalTextureFormat(GLenum internalTextureFormat)

Définit le format interne de la texture d’un objet framebuffer ou du tampon de couleurs d’un objet framebuffer multi-échantillon sur « internalTextureFormat ».

Voir également internalTextureFormat().

void QOpenGLFramebufferObjectFormat::setMipmap(bool enabled)

Active le mipmapping si la valeur de « enabled » est « true » ; sinon, il le désactive.

Le mipmapping est désactivé par défaut.

Si le mipmapping est activé, de la mémoire supplémentaire sera allouée pour les niveaux de mipmap. Les niveaux de mipmap peuvent être mis à jour en liant la texture et en appelant glGenerateMipmap(). Le mipmapping ne peut pas être activé pour les objets framebuffer à échantillonnage multiple.

Voir également mipmap() et QOpenGLFramebufferObject::texture().

void QOpenGLFramebufferObjectFormat::setSamples(int samples)

Définit le nombre d'échantillons par pixel pour un objet framebuffer multisample à la valeur samples. La valeur par défaut de 0 correspond à un objet framebuffer standard, non multisample.

Si le nombre d'échantillons par pixel souhaité n'est pas pris en charge par le matériel, le nombre maximal d'échantillons par pixel sera utilisé. Notez que les objets framebuffer multisample ne peuvent pas être liés en tant que textures. De plus, l'extension GL_EXT_framebuffer_multisample est requise pour créer un framebuffer comportant plus d'un échantillon par pixel.

Voir également samples().

void QOpenGLFramebufferObjectFormat::setTextureTarget(GLenum target)

Définit la cible de texture de la texture associée à un objet framebuffer sur target. Ignoré pour les objets framebuffer multi-échantillonnés.

Voir également textureTarget() et samples().

GLenum QOpenGLFramebufferObjectFormat::textureTarget() const

Renvoie la cible de texture de la texture associée à un objet framebuffer. Ignoré pour les objets framebuffer multi-échantillonnés. La valeur par défaut est GL_TEXTURE_2D.

Voir également setTextureTarget() et samples().

bool QOpenGLFramebufferObjectFormat::operator!=(const QOpenGLFramebufferObjectFormat &other) const

Renvoie « false » si toutes les options de ce format d’objet framebuffer sont identiques à celles de « other » ; sinon, renvoie « true ».

QOpenGLFramebufferObjectFormat &QOpenGLFramebufferObjectFormat::operator=(const QOpenGLFramebufferObjectFormat &other)

Attribue la propriété « other » à cet objet.

bool QOpenGLFramebufferObjectFormat::operator==(const QOpenGLFramebufferObjectFormat &other) const

Renvoie « true » si toutes les options de ce format d'objet framebuffer sont identiques à celles de « other » ; sinon, renvoie « false ».

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