fonction glInterleavedArrays
La fonction glInterleavedArrays spécifie et active simultanément plusieurs tableaux entrelacés dans un tableau d’agrégation plus grand.
Syntaxe
void WINAPI glInterleavedArrays(
GLenum format,
GLsizei stride,
const GLvoid *pointer
);
Paramètres
-
format
-
Type de tableau à activer. Le paramètre peut supposer l’une des valeurs symboliques suivantes : GL_V2F, GL_V3F, GL_C4UB_V2F, GL_C4UB_V3F, GL_C3F_V3F, GL_N3F_V3F, GL_C4F_N3F_V3F, GL_T2F_V3F, GL_T4F_V4F, GL_T2F_C4UB_V3F, GL_T2F_C3F_V3F, GL_T2F_N3F_V3F, GL_T2F_C4F_N3F_V3F ou GL_T4F_C4F_N3F_V4F.
-
Foulée
-
Décalage en octets entre chaque élément de tableau d’agrégation.
-
Pointeur
-
Pointeur vers le premier élément d’un tableau d’agrégation.
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 .
Name | Signification |
---|---|
|
format n’était pas une valeur acceptée. |
|
stride était une valeur négative. |
|
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Notes
Avec la fonction glInterleavedArrays , vous pouvez spécifier et activer simultanément plusieurs tableaux de couleurs, normales, textures et vertex entrelacés dont les éléments font partie d’un élément de tableau d’agrégation plus grand. Pour certaines architectures de mémoire, cela est plus efficace que de spécifier les tableaux séparément.
Si le paramètre stride est égal à zéro, les éléments de tableau d’agrégation sont stockés consécutivement ; sinon, les octets stride se produisent entre les éléments de tableau agrégés.
Le paramètre format sert de clé qui décrit comment extraire des tableaux individuels du tableau d’agrégation :
- Si le format contient un T, les coordonnées de texture sont extraites du tableau entrelacé.
- Si C est présent, les valeurs de couleur sont extraites.
- Si N est présent, les coordonnées normales sont extraites.
- Les coordonnées de vertex sont toujours extraites.
- Les chiffres 2, 3 et 4 indiquent le nombre de valeurs extraites.
- F indique que les valeurs sont extraites en tant que valeurs à virgule flottante.
- Si 4UB suit le C, les couleurs peuvent également être extraites sous la forme de 4 octets non signés. Si une couleur est extraite sous la forme de 4 octets non signés, l’élément de tableau de vertex qui suit se trouve à la première adresse alignée à virgule flottante possible.
Si vous appelez glInterleavedArrays lors de la compilation d’une liste d’affichage, elle n’est pas compilée dans la liste, mais est exécutée immédiatement.
Vous ne pouvez pas inclure d’appels à glInterleavedArrays dans glDisableClientState entre les appels à glBegin et l’appel correspondant à glEnd.
Notes
La fonction glInterleavedArrays est disponible uniquement dans OpenGL version 1.1 ou ultérieure.
La fonction glInterleavedArrays est implémentée côté client sans protocole. Étant donné que les paramètres du tableau de vertex sont à l’état côté client, ils ne sont pas enregistrés ou restaurés par glPushAttrib et glPopAttrib. Utilisez glPushClientAttrib et glPopClientAttrib à la place.
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 |
|