glLineStipple, fonction

La fonction glLineStipple spécifie le modèle de stipple de ligne.

Syntaxe

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Paramètres

Facteur

Multiplicateur pour chaque bit dans le modèle d’info-bulles de ligne. Si factor a la valeur 3, par exemple, chaque bit du modèle est utilisé trois fois avant l’utilisation du bit suivant dans le modèle. Le paramètre factor est limité à la plage [1, 256] et est défini par défaut sur 1.

pattern

Entier 16 bits dont le modèle de bits détermine les fragments d’une ligne qui seront dessinés lorsque la ligne sera rastérisée. Le bit zéro est utilisé en premier, et le modèle par défaut est tous les bits.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Le code d’erreur suivant peut être récupéré par la fonction glGetError .

Name	Signification
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glLineStipple spécifie le modèle de stipple de ligne. La trame masque certains fragments produits par la rastérisation; ces fragments ne seront pas dessinés. Le masquage est obtenu à l’aide de trois paramètres : le modèle de modèle d’info-bulles de ligne 16 bits, le facteur de nombre de répétitions et un compteur d’info-bulles entiers.

Les compteurs sont réinitialisés à zéro chaque fois que glBegin est appelé et avant la génération de chaque segment de ligne d’une séquence glBegin(GL_LINES)/glEnd . Il est incrémenté après la génération de chaque fragment d’un segment de ligne avec alias de largeur d’unité, ou après la génération de chaque fragment i d’un segment de ligne de largeur i . Les fragments i associés au nombre s sont masqués si le bit de modèle (facteurs / ) mod 16 est égal à zéro. Sinon, ces fragments sont envoyés au framebuffer. Le bit zéro du modèle est le bit le moins significatif.

Les lignes anticrénelées sont traitées comme une séquence de rectangles delargeur 1x à des fins de stippling. Le rectangle s est rastérisé ou non basé sur la règle de fragment décrite pour les lignes avec alias ; il compte les rectangles plutôt que les groupes de fragments.

Le stippling de ligne est activé ou désactivé à l’aide de glEnable et glDisable avec GL_LINE_STIPPLE d’arguments. Lorsqu’il est activé, le modèle d’info-bulle de ligne est appliqué comme décrit ci-dessus. Quand elle est désactivée, c’est comme si le modèle était tous des modèles. Initialement, le stippling de ligne est désactivé.

Les fonctions suivantes récupèrent des informations relatives à glLineStipple :

glGet avec argument GL_LINE_STIPPLE_PATTERN

glGet avec argument GL_LINE_STIPPLE_REPEAT

glIsEnabled avec argument GL_LINE_STIPPLE

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnd

glLineWidth

glPolygonStipple