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 |
|---|---|
|
le type n’est pas une valeur acceptée. |
|
la taille n’est pas 1, 2, 3 ou 4. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|