glTexCoordPointer fonction)

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 Size doit être 1, 2, 3 ou 4.

type

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

progrès

Offset d’octet entre les éléments de tableau consécutifs. Quand Stride est égal à zéro, les éléments de tableau sont étroitement empaquetés dans le tableau.

pointeur

Pointeur vers la première coordonnée du premier élément 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
_enum GL non valide _
le type n’est pas une valeur acceptée.
_valeur non valide du GL _
la taille n’est pas 1, 2, 3 ou 4.
_valeur non valide du GL _
Stride était négatif.

Remarques

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 de type spécifie le type de données de chaque coordonnée de texture. Le paramètre Stride détermine le décalage d’octets d’un élément de tableau à 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 séparés. Pour plus d’informations, consultez glInterleavedArrays. Lorsqu’un tableau de coordonnées de texture est spécifié, la taille, le type, la Stride et le pointeur sont enregistrés à l’État côté client.

Un tableau de coordonnées de texture est activé quand vous spécifiez la constante de _ _ _ tableau de coordonnées de la texture GL avec glEnableClientState. Quand cette option est activée, glDrawArrays, glDrawElementset 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 des glTexCoordPointer dans des 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 de tableau de coordonnées de texture 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 de tableau de coordonnées de texture sont des États 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 les informations relatives à glTexCoordPointer:

glIsEnabled avec argument GL _ texture _ Coord _ tableau

glGet avec argument taille de la texture du GL _ _ _ _ taille du tableau

glGet avec argument GL _ texture _ Coord _ tableau _ Stride

glGet avec argument _ _ _ _ nombre de coordonnées de la texture du GL

glGet avec argument de la _ texture GL _ _ _ type de tableau de coordonnées

glGetPointerv avec argument de la texture du GL _ pointeur de _ _ tableau _ de repère

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

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer