QSurfaceFormat Class

Documentation des fonctions membres

QSurfaceFormat::QSurfaceFormat()

Construit un QSurfaceFormat initialisé par défaut.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

Construit un QSurfaceFormat avec le format donné options.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

Construit une copie de other.

[noexcept] QSurfaceFormat::~QSurfaceFormat()

Détruit le site QSurfaceFormat.

int QSurfaceFormat::alphaBufferSize() const

Obtenir la taille en bits du canal alpha du tampon de couleur.

Voir aussi setAlphaBufferSize().

int QSurfaceFormat::blueBufferSize() const

Obtient la taille en bits du canal bleu du tampon de couleur.

Voir aussi setBlueBufferSize().

const QColorSpace &QSurfaceFormat::colorSpace() const

Renvoie l'espace colorimétrique.

Voir aussi setColorSpace().

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

Renvoie le format de surface global par défaut.

Lorsque setDefaultFormat() n'est pas appelé, il s'agit d'une construction par défaut QSurfaceFormat.

Voir aussi setDefaultFormat().

int QSurfaceFormat::depthBufferSize() const

Renvoie la taille du tampon de profondeur.

Voir aussi setDepthBufferSize().

int QSurfaceFormat::greenBufferSize() const

Obtient la taille en bits du canal vert du tampon de couleur.

Voir aussi setGreenBufferSize().

bool QSurfaceFormat::hasAlpha() const

Renvoie true si la taille du tampon alpha est supérieure à zéro.

Cela signifie que la surface peut être utilisée avec des effets de translucidité par pixel.

int QSurfaceFormat::majorVersion() const

Renvoie la version majeure d'OpenGL.

La version par défaut est 2.0.

Voir aussi setMajorVersion().

int QSurfaceFormat::minorVersion() const

Renvoie la version mineure d'OpenGL.

Voir aussi setMinorVersion().

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

Renvoie les options de format actuellement définies.

Voir aussi setOption(), setOptions() et testOption().

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

Obtenir le profil de contexte OpenGL configuré.

Ce paramètre est ignoré si la version OpenGL demandée est inférieure à 3.2.

Voir aussi setProfile().

int QSurfaceFormat::redBufferSize() const

Obtenir la taille en bits du canal rouge du tampon de couleur.

Voir aussi setRedBufferSize().

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

Obtient le type de rendu.

Choisit entre OpenGL de bureau, OpenGL ES et OpenVG.

Voir aussi setRenderableType().

int QSurfaceFormat::samples() const

Renvoie le nombre d'échantillons par pixel lorsque le multi-échantillonnage est activé, ou -1 lorsque le multi-échantillonnage est désactivé. La valeur de retour par défaut est -1.

Voir également setSamples().

void QSurfaceFormat::setAlphaBufferSize(int size)

Définit la valeur size en bits du canal alpha du tampon de couleur.

Voir aussi alphaBufferSize().

void QSurfaceFormat::setBlueBufferSize(int size)

Définit la valeur souhaitée size en bits du canal bleu du tampon de couleur.

Voir également blueBufferSize().

[since 6.0] void QSurfaceFormat::setColorSpace(const QColorSpace &colorSpace)

Définit l'adresse colorSpace préférée.

Par exemple, cela permet de demander des fenêtres avec des framebuffers par défaut qui sont compatibles avec sRGB sur les plates-formes qui le supportent.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi colorSpace().

[static] void QSurfaceFormat::setDefaultFormat(const QSurfaceFormat &format)

Définit la surface globale par défaut format.

Ce format est utilisé par défaut dans les classes QOpenGLContext, QWindow, QOpenGLWidget et similaires.

Il est toujours possible de le remplacer pour chaque instance en utilisant la fonction setFormat() de la classe en question. Cependant, il est souvent plus pratique de définir le format pour toutes les fenêtres au début de l'application. Cela garantit également un comportement correct dans les cas où des contextes partagés sont nécessaires, car la définition du format via cette fonction garantit que tous les contextes et surfaces, même ceux créés en interne par Qt, utiliseront le même format.

Voir aussi defaultFormat().

void QSurfaceFormat::setDepthBufferSize(int size)

Fixe la taille minimale du tampon de profondeur à size.

Voir aussi depthBufferSize().

void QSurfaceFormat::setGreenBufferSize(int size)

Définit la valeur souhaitée size en bits du canal vert du tampon de couleur.

Voir également greenBufferSize().

void QSurfaceFormat::setMajorVersion(int major)

Définit la version OpenGL souhaitée pour major.

Voir également majorVersion().

void QSurfaceFormat::setMinorVersion(int minor)

Définit la version OpenGL souhaitée pour minor.

La version par défaut est 2.0.

Voir aussi minorVersion().

void QSurfaceFormat::setOption(QSurfaceFormat::FormatOption option, bool on = true)

Définit l'option de format option si on est vrai ; sinon, efface l'option.

Pour vérifier qu'une option a été respectée, comparez le format réel au format demandé après la création de la surface/du contexte.

Voir également setOptions(), options() et testOption().

void QSurfaceFormat::setOptions(QSurfaceFormat::FormatOptions options)

Définit les options de format à options.

Pour vérifier qu'une option a été respectée, comparez le format réel au format demandé après la création de la surface/du contexte.

Voir également options() et testOption().

void QSurfaceFormat::setProfile(QSurfaceFormat::OpenGLContextProfile profile)

Définit le contexte OpenGL souhaité profile.

Ce paramètre est ignoré si la version OpenGL demandée est inférieure à 3.2.

Voir aussi profile().

void QSurfaceFormat::setRedBufferSize(int size)

Définit la valeur souhaitée size en bits du canal rouge du tampon de couleur.

Voir également redBufferSize().

void QSurfaceFormat::setRenderableType(QSurfaceFormat::RenderableType type)

Définit le rendu souhaité type.

Choisit entre OpenGL de bureau, OpenGL ES et OpenVG.

Voir aussi renderableType().

void QSurfaceFormat::setSamples(int numSamples)

Définissez le nombre préféré d'échantillons par pixel lorsque le multi-échantillonnage est activé à numSamples. Par défaut, le multi-échantillonnage est désactivé.

Voir également samples().

void QSurfaceFormat::setStencilBufferSize(int size)

Définit la taille préférée de la mémoire tampon du pochoir à size bits.

Voir également stencilBufferSize().

void QSurfaceFormat::setStereo(bool enable)

Si enable est vrai, il active la mise en mémoire tampon stéréo ; sinon, il la désactive.

La mise en mémoire tampon stéréo est désactivée par défaut.

La mise en mémoire tampon stéréo fournit des mémoires tampons de couleur supplémentaires pour générer des images de l'œil gauche et de l'œil droit.

Voir aussi stereo().

void QSurfaceFormat::setSwapBehavior(QSurfaceFormat::SwapBehavior behavior)

Définir la permutation behavior de la surface.

Le comportement de permutation spécifie si la mise en mémoire tampon simple, double ou triple est souhaitée. La valeur par défaut, DefaultSwapBehavior, correspond au comportement d'échange par défaut de la plate-forme.

Voir également swapBehavior().

void QSurfaceFormat::setSwapInterval(int interval)

Définit l'intervalle de permutation préféré. L'intervalle de permutation spécifie le nombre minimum d'images vidéo affichées avant qu'une permutation de tampon ne se produise. Ceci peut être utilisé pour synchroniser le dessin GL dans une fenêtre avec le rafraîchissement vertical de l'écran.

Une valeur de 0 sur interval désactive la synchronisation du rafraîchissement vertical, tandis qu'une valeur supérieure à 0 active la synchronisation verticale. En fixant interval à une valeur plus élevée, par exemple 10, on obtient 10 retraits verticaux entre chaque changement de tampon.

L'intervalle par défaut est de 1.

Il se peut que la plateforme sous-jacente ne prenne pas en charge la modification de l'intervalle d'échange. Dans ce cas, la demande sera ignorée silencieusement.

Voir également swapInterval().

void QSurfaceFormat::setVersion(int major, int minor)

Définit les versions OpenGL souhaitées pour major et minor.

La version par défaut est 2.0.

Voir aussi version().

int QSurfaceFormat::stencilBufferSize() const

Renvoie la taille du tampon du pochoir en bits.

Voir aussi setStencilBufferSize().

bool QSurfaceFormat::stereo() const

Renvoie true si la mise en mémoire tampon stéréo est activée ; sinon, renvoie false. La mise en mémoire tampon stéréo est désactivée par défaut.

Voir aussi setStereo().

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

Renvoie le comportement configuré de l'échange.

Voir aussi setSwapBehavior().

int QSurfaceFormat::swapInterval() const

Renvoie l'intervalle d'échange.

Voir aussi setSwapInterval().

bool QSurfaceFormat::testOption(QSurfaceFormat::FormatOption option) const

Retourne vrai si l'option de format option est activée, sinon retourne faux.

Voir aussi options().

std::pair<int, int> QSurfaceFormat::version() const

Retourne une std::paire<int, int> représentant la version OpenGL.

Utile pour les vérifications de version, par exemple format.version() >= std::pair(3, 2)

Voir aussi setVersion().

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

Attribue other à cet objet.