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
GL_INVALID_ENUM	tipo non è stato accettato.
GL_INVALID_VALUE	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	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glArrayElement

glColorPointer

glDrawArrays

glEdgeFlagPointer

glGetPointerv

glGetString

glNormalPointer

glPushAttrib

glTexCoordPointer

glVertexPointer