glLineStipple fonction)
La fonction glLineStipple spécifie le modèle de stipple de ligne.
Syntaxe
void WINAPI glLineStipple(
GLint factor,
GLushort pattern
);
Paramètres
-
factorisés
-
Multiplicateur pour chaque bit dans le modèle stipple de la ligne. Si Factor est égal à 3, par exemple, chaque bit du modèle sera utilisé trois fois avant l’utilisation du bit suivant dans le modèle. Le paramètre Factor est ancré à la plage [ 1, 256 ] et prend par défaut la valeur un.
-
pattern
-
Entier 16 bits dont le modèle de bits détermine les fragments d’une ligne qui seront dessinés lorsque la ligne est pixellisée. Le bit zéro est utilisé en premier, et le modèle par défaut est All.
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 .
| Nom | Signification |
|---|---|
|
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 ligne stippling masque certains fragments produits par la pixellisation ; ces fragments ne seront pas dessinés. Le masquage est effectué à l’aide de trois paramètres : le modèle de modèle stipple de ligne de 16 bits, le facteur nombre de répétitions et un compteur stipple entier.
Le compteur s est remis à zéro chaque fois que glBegin est appelé, et avant que chaque segment de ligne d’une séquence glBegin( _ lignes GL)/glEnd soit généré. 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 d’un segment de ligne de largeur i . Les fragments i associés à Count s sont masqués si le bit de motif ( / facteur s) mod 16 est égal à zéro. Dans le cas contraire, ces fragments sont envoyés au trame. Le bit zéro du modèle est le bit le moins significatif.
Les lignes avec un alias sont traitées comme une séquence de rectangles de largeur 1x à des fins de stippling. Rectangle s est pixellisé ou non en fonction de la règle de fragmentation décrite pour les lignes avec alias ; elle compte des rectangles plutôt que des groupes de fragments.
La ligne stippling est activée ou désactivée à l’aide de glEnable et glDisable avec l’argument, _ ligne _ STIPPLE. Quand cette option est activée, le modèle de stipple de ligne est appliqué comme décrit ci-dessus. Quand elle est désactivée, elle est comme si le modèle était tous des. Au départ, la ligne stippling est désactivée.
Les fonctions suivantes récupèrent les informations relatives à glLineStipple:
glGet avec argument _ modèle de _ STIPPLE de ligne de GL _
glGet avec argument GL _ line _ STIPPLE _ REPEAT
glIsEnabled avec argument GL _ ligne _ 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 |
|
| Bibliothèque |
|
| DLL |
|