QSurfaceFormat Class

Documentation des fonctions membres

QSurfaceFormat::QSurfaceFormat()

Crée un objet `QSurfaceFormat` initialisé par défaut.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

Crée un objet `QSurfaceFormat` avec le format spécifié options.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

Crée une copie de other.

[noexcept] QSurfaceFormat::~QSurfaceFormat()

Supprime l'QSurfaceFormat.

int QSurfaceFormat::alphaBufferSize() const

Récupère la taille, en bits, du canal alpha du tampon de couleurs.

Voir également setAlphaBufferSize().

int QSurfaceFormat::blueBufferSize() const

Récupère la taille, en bits, du canal bleu du tampon de couleur.

Voir également la fonction ` setBlueBufferSize()`.

const QColorSpace &QSurfaceFormat::colorSpace() const

Renvoie l'espace colorimétrique.

Voir aussi setColorSpace().

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

Renvoie le format de surface par défaut global.

Lorsque la fonction setDefaultFormat() n'est pas appelée, il s'agit d'un objet QSurfaceFormat construit par défaut.

Voir également setDefaultFormat().

int QSurfaceFormat::depthBufferSize() const

Renvoie la taille du tampon de profondeur.

Voir aussi ` setDepthBufferSize()`.

int QSurfaceFormat::greenBufferSize() const

Récupère la taille, en bits, du canal vert du tampon de couleurs.

Voir également la fonction ` 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 principale d'OpenGL.

La version par défaut est 2.0.

Voir aussi setMajorVersion().

int QSurfaceFormat::minorVersion() const

Renvoie la version mineure d'OpenGL.

Voir également setMinorVersion().

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

Renvoie les options de formatage actuellement définies.

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

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

Récupère le profil du contexte OpenGL configuré.

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

Voir également setProfile().

int QSurfaceFormat::redBufferSize() const

Récupère la taille en bits du canal rouge du tampon de couleur.

Voir également la fonction ` setRedBufferSize()`.

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

Récupère le type de rendu.

Permet de choisir entre OpenGL pour ordinateur de bureau, OpenGL ES et OpenVG.

Voir aussi setRenderableType().

int QSurfaceFormat::samples() const

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

Voir également setSamples().

void QSurfaceFormat::setAlphaBufferSize(int size)

Définit l'size e souhaitée en bits du canal alpha du tampon de couleur.

Voir aussi alphaBufferSize().

void QSurfaceFormat::setBlueBufferSize(int size)

Définissez l'size e souhaitée en bits du canal bleu du tampon de couleur.

Voir aussi blueBufferSize().

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

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

Cela permet, par exemple, de demander des fenêtres dont les framebuffers par défaut prennent en charge le profil sRGB sur les plateformes qui le permettent.

Cette fonction a été introduite dans Qt 6.0.

Voir également ` colorSpace()`.

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

Définit l'format par défaut de la surface globale.

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

Il peut toujours être redéfini au cas par cas à l’aide de la fonction setFormat() propre à la classe concernée. Cependant, il est souvent plus pratique de définir le format pour toutes les fenêtres en une seule fois au démarrage 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 toutes les surfaces, même ceux créés en interne par Qt, utiliseront le même format.

Voir également ` defaultFormat()`.

void QSurfaceFormat::setDepthBufferSize(int size)

Définissez la taille minimale du tampon de profondeur sur size.

Voir également depthBufferSize().

void QSurfaceFormat::setGreenBufferSize(int size)

Définissez l'size souhaitée en bits du canal vert du tampon de couleurs.

Voir aussi greenBufferSize().

void QSurfaceFormat::setMajorVersion(int major)

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

Voir aussi majorVersion().

void QSurfaceFormat::setMinorVersion(int minor)

Définit la version OpenGL souhaitée pour l'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, désactive cette option.

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

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

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

Définit les options de format sur « options ».

Pour vérifier qu'une option a bien été respectée, comparez le format réel au format demandé après la création de la surface ou 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 également profile().

void QSurfaceFormat::setRedBufferSize(int size)

Définissez l'size e souhaitée en bits du canal rouge du tampon de couleur.

Voir aussi redBufferSize().

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

Définit l'type souhaitée pour le rendu.

Permet de choisir entre OpenGL pour ordinateur de bureau, OpenGL ES et OpenVG.

Voir également renderableType().

void QSurfaceFormat::setSamples(int numSamples)

Définissez le nombre souhaité d'échantillons par pixel lorsque le multisampling est activé à l'adresse numSamples. Par défaut, le multisampling est désactivé.

Voir également samples().

void QSurfaceFormat::setStencilBufferSize(int size)

Définissez la taille souhaitée du tampon de pochoir à size bits.

Voir également stencilBufferSize().

void QSurfaceFormat::setStereo(bool enable)

Si la valeur « enable » est définie sur « true », la mise en mémoire tampon stéréo est activée ; dans le cas contraire, elle est désactivée.

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 tampons de couleur supplémentaires pour générer les images destinées à l'œil gauche et à l'œil droit.

Voir également stereo().

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

Définit l'behavior de swap de la surface.

Le comportement de swap permet de spécifier si l'on souhaite un buffering simple, double ou triple. La valeur par défaut, ` DefaultSwapBehavior`, correspond au comportement de swap par défaut de la plate-forme.

Voir également swapBehavior().

void QSurfaceFormat::setSwapInterval(int interval)

Définit l'intervalle de permutation souhaité. L'intervalle de permutation spécifie le nombre minimum d'images vidéo affichées avant qu'une permutation de tampon n'ait lieu. Cela permet de synchroniser le dessin GL dans une fenêtre avec le rafraîchissement vertical de l'écran.

Si vous définissez la valeur « interval » sur 0, la synchronisation avec le rafraîchissement vertical est désactivée ; toute valeur supérieure à 0 active la synchronisation verticale. Si vous définissez « interval » sur une valeur plus élevée, par exemple 10, cela entraîne 10 retraces verticaux entre chaque permutation de tampon.

L’intervalle par défaut est 1.

La modification de l’intervalle de permutation peut ne pas être prise en charge par la plate-forme sous-jacente. Dans ce cas, la requête sera ignorée sans message d’erreur.

Voir également swapInterval().

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

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

La version par défaut est 2.0.

Voir aussi version().

int QSurfaceFormat::stencilBufferSize() const

Renvoie la taille du tampon de stencil 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 de swap configuré.

Voir également setSwapBehavior().

int QSurfaceFormat::swapInterval() const

Renvoie l'intervalle de swap.

Voir aussi setSwapInterval().

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

Renvoie « true » si l'option de format option est activée ; sinon, renvoie « false ».

Voir aussi options().

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

Renvoie un std::pair<int, int> représentant la version d'OpenGL.

Utile pour vérifier la version, par exemple : format.version() >= std::pair(3, 2)

Voir également setVersion().

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

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