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
GL_INVALID_ENUM	format n’était pas une valeur acceptée.
GL_INVALID_VALUE	stride était une valeur négative.
GL_INVALID_OPERATION	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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnableClientState

glGetPointerv

glIndexPointer

glNormalPointer

glPushAttrib

glPushClientAttrib

glTexCoordPointer

glVertexPointer