funzione glInterleavedArrays
La funzione glInterleavedArrays specifica e abilita contemporaneamente diverse matrici interleaved in una matrice di aggregazione più grande.
Sintassi
void WINAPI glInterleavedArrays(
GLenum format,
GLsizei stride,
const GLvoid *pointer
);
Parametri
-
format
-
Tipo di matrice da abilitare. Il parametro può assumere uno dei valori simbolici seguenti: 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 o GL_T4F_C4F_N3F_V4F.
-
Passo
-
Offset in byte tra ogni elemento della matrice di aggregazione.
-
Puntatore
-
Puntatore al primo elemento di una matrice di aggregazione.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
Nome | Significato |
---|---|
|
format non è un valore accettato. |
|
stride è un valore negativo. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
Con la funzione glInterleavedArrays , è possibile specificare e abilitare contemporaneamente diverse matrici di colori interleaved, normali, trama e vertici i cui elementi fanno parte di un elemento di matrice di aggregazione più grande. Per alcune architetture di memoria, questa operazione è più efficiente rispetto alla specifica delle matrici separatamente.
Se il parametro stride è zero, gli elementi della matrice di aggregazione vengono archiviati consecutivamente; in caso contrario, i byte stride si verificano tra gli elementi della matrice di aggregazione.
Il parametro format funge da chiave che descrive come estrarre singole matrici dalla matrice di aggregazione:
- Se il formato contiene una T, le coordinate della trama vengono estratte dalla matrice interleaved.
- Se C è presente, i valori dei colori vengono estratti.
- Se N è presente, vengono estratte le coordinate normali.
- Le coordinate dei vertici vengono sempre estratte.
- Le cifre 2, 3 e 4 indicano il numero di valori estratti.
- F indica che i valori vengono estratti come valori a virgola mobile.
- Se 4UB segue il C, i colori possono essere estratti anche come 4 byte senza segno. Se un colore viene estratto come 4 byte senza segno, l'elemento della matrice vertice che segue si trova al primo indirizzo allineato a virgola mobile possibile.
Se si chiama glInterleavedArrays durante la compilazione di un elenco di visualizzazione, non viene compilato nell'elenco ma viene eseguito immediatamente.
Non è possibile includere chiamate a glInterleavedArrays in glDisableClientState tra le chiamate a glBegin e la chiamata corrispondente a glEnd.
Nota
La funzione glInterleavedArrays è disponibile solo in OpenGL versione 1.1 o successiva.
La funzione glInterleavedArrays viene implementata sul lato client senza alcun protocollo. Poiché i parametri della matrice dei vertici sono di tipo lato client, non vengono salvati o ripristinati da glPushAttrib e glPopAttrib. Usare invece glPushClientAttrib e glPopClientAttrib .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
Libreria |
|
DLL |
|