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 |
- Liste de tous les membres, y compris les membres hérités
- QOpenGLFramebufferObjectFormat fait partie du module « Rendu 3D ».
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 :
- Number of samples per pixels.
- Depth and/or stencil attachments.
- Texture target.
- Internal texture format.
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.