fonction glTexCoordPointer

La fonction glTexCoordPointer définit un tableau de coordonnées de texture.

Syntaxe

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

Paramètres

size

Nombre de coordonnées par élément de tableau. La valeur de la taille doit être 1, 2, 3 ou 4.

type

Type de données de chaque texture dans le tableau à l’aide des constantes symboliques suivantes : GL_SHORT, GL_INT, GL_FLOAT et GL_DOUBLE.

Foulée

Décalage d’octet entre les éléments de tableau consécutifs. Lorsque la foulée est égale à zéro, les éléments du tableau sont étroitement emballés dans le tableau.

Pointeur

Pointeur vers la première coordonnée du premier élément du 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
GL_INVALID_ENUM	type n’était pas une valeur acceptée.
GL_INVALID_VALUE	taille n’était pas 1, 2, 3 ou 4.
GL_INVALID_VALUE	stride était négatif.

Notes

La fonction glTexCoordPointer spécifie l’emplacement et les données d’un tableau de coordonnées de texture à utiliser lors du rendu. Le paramètre size spécifie le nombre de coordonnées utilisées pour chaque élément du tableau. Le paramètre type spécifie le type de données de chaque coordonnée de texture. Le paramètre stride détermine le décalage d’octet d’un élément de tableau à l’autre, ce qui permet l’empaquetage des sommets et des attributs dans un tableau unique ou un stockage dans des tableaux distincts. Dans certaines implémentations, le stockage des sommets et des attributs dans un tableau unique peut être plus efficace que d’utiliser des tableaux distincts. Pour plus d’informations, consultez glInterleavedArrays. Lorsqu’un tableau de coordonnées de texture est spécifié, la taille, le type, la foulée et le pointeur sont enregistrés côté client.

Un tableau de coordonnées de texture est activé lorsque vous spécifiez la constante GL_TEXTURE_COORD_ARRAY avec glEnableClientState. Lorsque cette option est activée, glDrawArrays, glDrawElements et glArrayElement utilisent le tableau de coordonnées de texture. Par défaut, le tableau de coordonnées de texture est désactivé.

Vous ne pouvez pas inclure glTexCoordPointer dans les listes d’affichage.

Lorsque vous spécifiez un tableau de coordonnées de texture à l’aide de glTexCoordPointer, les valeurs de tous les paramètres du tableau de coordonnées de texture de la fonction sont enregistrées dans un état côté client et les éléments de tableau statiques peuvent être mis en cache. Étant donné que les paramètres du tableau de coordonnées de texture 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 lorsque vous appelez glTexCoordPointer dans des paires glBegin et glEnd , les résultats ne sont pas définis.

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

glIsEnabled avec argument GL_TEXTURE_COORD_ARRAY

glGet avec argument GL_TEXTURE_COORD_ARRAY_SIZE

glGet avec argument GL_TEXTURE_COORD_ARRAY_STRIDE

glGet avec argument GL_TEXTURE_COORD_ARRAY_COUNT

glGet avec argument GL_TEXTURE_COORD_ARRAY_TYPE

glGetPointerv avec argument GL_TEXTURE_COORD_ARRAY_POINTER

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

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer