glVertexPointer fonction)

La fonction glVertexPointer définit un tableau de données de vertex.

Syntaxe

void WINAPI glVertexPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Paramètres

size

Nombre de coordonnées par vertex. La valeur de Size doit être 2, 3 ou 4.

type

Type de données de chaque coordonnée dans le tableau à l’aide des constantes symboliques suivantes : GL _ short, GL _ int, GL _ float et GL _ double.

progrès

Décalage d’octet entre les vertex consécutifs. Lorsque la valeur de Stride est égale à zéro, les vertex sont étroitement empaquetés dans le tableau.

pointeur

Pointeur vers la première coordonnée du premier vertex dans le tableau.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
_valeur non valide du GL _
la taille n’est pas 2, 3 ou 4.
_enum GL non valide _
le type n’est pas une valeur acceptée.
_valeur non valide du GL _
Stride ou Count était négatif.

Remarques

La fonction glVertexPointer spécifie l’emplacement et les données d’un tableau de coordonnées de vertex à utiliser lors du rendu. Le paramètre Size spécifie le nombre de coordonnées par vertex. Le paramètre de type spécifie le type de données de chaque coordonnée de vertex. Le paramètre Stride détermine le décalage d’octets d’un vertex à l’autre, ce qui permet d’empaqueter des vertex et des attributs dans un tableau unique ou un stockage dans des tableaux séparés. Dans certaines implémentations, le stockage des vertex et des attributs dans un tableau unique peut être plus efficace que l’utilisation de tableaux distincts (consultez glInterleavedArrays).

Un tableau de vertex est activé quand vous spécifiez _ la _ constante de tableau de vertex GL avec glEnableClientState. Quand cette option est activée, glDrawArrays, glDrawElementset glArrayElement utilisent le tableau de vertex. Par défaut, le tableau de vertex est désactivé.

Vous ne pouvez pas inclure des glVertexPointer dans des listes d’affichage.

Lorsque vous spécifiez un tableau de vertex à l’aide de glVertexPointer, les valeurs de tous les paramètres de tableau de vertex de la fonction sont enregistrées dans un État côté client et les éléments de tableau statique peuvent être mis en cache. Étant donné que les paramètres du tableau de vertex sont l’État côté client, leurs valeurs ne sont pas enregistrées ou restaurées par glPushAttrib et glPopAttrib.

Bien qu’aucune erreur ne soit générée si vous appelez glVertexPointer dans des paires glBegin et glEnd , les résultats ne sont pas définis.

Les fonctions suivantes récupèrent les informations relatives à glVertexPointer:

glGet avec argument GL _ vertex de _ tableau _ taille

glGet avec argument GL _ vertex de _ tableau _ Stride

glGet avec argument _ nombre de _ tableaux de vertex GL _

glGet avec argument _ type de _ tableau de vertex GL _

glGetPointerv avec un _ pointeur de _ tableau de vertex d’argument GL _

glIsEnabled avec argument GL _ vertex _ Array

Configuration requise

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

glArrayElement

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glTexCoordPointer