funzione glIndexPointer
La funzione glIndexPointer definisce una matrice di indici di colore.
Sintassi
void WINAPI glIndexPointer(
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parametri
-
type
-
Tipo di dati di ogni indice di colore nella matrice usando le costanti simboliche seguenti: GL_SHORT, GL_INT, GL_FLOAT, GL_DOUBLE.
-
Passo
-
Offset di byte tra indici di colore consecutivi. Quando stride è zero, gli indici di colore sono strettamente compressi nella matrice.
-
Puntatore
-
Puntatore al primo indice di colore nella matrice.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
tipo non è stato accettato. |
|
stride o conteggio è negativo. |
Commenti
La funzione glIndexPointer specifica la posizione e i dati di una matrice di indici di colore da usare durante il rendering. Il parametro di tipo specifica il tipo di dati di ogni indice di colore e stride determina l'offset di byte da un indice di byte a quello successivo, consentendo la compressione di vertici e attributi in una singola matrice o archiviazione in matrici separate. In alcune implementazioni, l'archiviazione dei vertici e degli attributi in una singola matrice può essere più efficiente rispetto all'uso di matrici separate. Per altre informazioni, vedere glInterleavedArrays.
Quando si specifica la costante di GL_INDEX_ARRAY con glEnableClientState, viene abilitata una matrice di indice a colori. Se abilitato, glDrawArrays e glArrayElement usano la matrice color-index. Per impostazione predefinita, la matrice color-index è disabilitata.
Non è possibile includere glIndexPointer negli elenchi di visualizzazione.
Quando si specifica una matrice color-index usando glIndexPointer, i valori di tutti i parametri della matrice color-index della funzione vengono salvati in uno stato lato client e gli elementi della matrice statica possono essere memorizzati nella cache. Poiché i parametri della matrice color-index sono lo stato lato client, i relativi valori non vengono salvati o ripristinati da glPushAttrib e glPopAttrib.
Anche se non viene generato alcun errore quando si chiama glIndexPointer all'interno di glBegin e glEnd coppie, i risultati non sono definiti.
Le funzioni seguenti recuperano informazioni correlate a glIndexPointer:
glIsEnabled con argomento GL_INDEX_ARRAY
glGet con argomento GL_INDEX_ARRAY_STRIDE
glGet con argomento GL_INDEX_ARRAY_COUNT
glGet con argomento GL_INDEX_ARRAY_TYPE
glGet con argomento GL_INDEX_ARRAY_SIZE
glGetPointerv con argomento GL_INDEX_ARRAY_POINTER
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|