funzione glArrayElement

La funzione glArrayElement specifica gli elementi della matrice utilizzati per eseguire il rendering di un vertice.

Sintassi

void WINAPI glArrayElement(
   GLint index
);

Parametri

index

Indice nelle matrici abilitate.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

Usare la funzione glArrayElement all'interno di coppie glBegin e glEnd per specificare i dati dei vertici e degli attributi per le primitive point, line e polygon. La funzione glArrayElement specifica i dati per un singolo vertice usando i dati dei vertici e degli attributi che si trovano in corrispondenza dell'indice delle matrici di vertici abilitate.

È possibile usare glArrayElement per costruire primitive tramite l'indicizzazione dei dati dei vertici, invece di eseguire lo streaming tramite matrici di dati in ordine primo-a-ultimo. Poiché glArrayElement specifica solo un singolo vertice, è possibile specificare in modo esplicito gli attributi per le singole primitive. Ad esempio, è possibile impostare una singola normale per ogni singolo triangolo.

Quando si includono chiamate a glArrayElement negli elenchi di visualizzazione, i dati della matrice necessari, determinati dai puntatori di matrice e dai valori di abilitazione, vengono immessi anche nell'elenco di visualizzazione. Il puntatore di matrice e i valori di abilitazione vengono determinati quando vengono creati elenchi di visualizzazione, non quando vengono eseguiti elenchi di visualizzazione.

È possibile leggere e memorizzare nella cache i dati delle matrici statiche in qualsiasi momento con glArrayElement. Quando si modificano gli elementi di una matrice statica senza specificare di nuovo la matrice, i risultati delle chiamate successive a glArrayElement non sono definiti.

Quando si chiama glArrayElement senza prima chiamare glEnableClientState(GL_VERTEX_ARRAY), non viene eseguito alcun disegno, ma gli attributi corrispondenti alle matrici abilitate vengono modificati. Anche se non viene generato alcun errore quando si specifica una matrice all'interno di coppie glBegin e glEnd , i risultati non sono definiti.

Nota

La funzione glArrayElement è disponibile solo in OpenGL versione 1.1 o successiva.

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

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer