funzione glDrawElements
La funzione glDrawElements esegue il rendering delle primitive dai dati della matrice.
Sintassi
void WINAPI glDrawElements(
GLenum mode,
GLsizei count,
GLenum type,
const GLvoid *indices
);
Parametri
-
mode
-
Tipo di primitive di cui eseguire il rendering. Può presupporre uno dei valori simbolici seguenti: GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS e GL_POLYGON.
-
count
-
Numero di elementi di cui eseguire il rendering.
-
type
-
Tipo dei valori negli indici. Deve essere uno dei GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT o GL_UNSIGNED_INT.
-
Indici
-
Puntatore alla posizione in cui sono archiviati gli indici.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
mode non è un valore accettato. |
|
count è un valore negativo. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glDrawElements consente di specificare più primitive geometriche con poche chiamate di funzione. Anziché chiamare una funzione OpenGL per passare ogni singolo vertice, normale o colore, è possibile specificare in anticipo matrici separate di vertici, normali e colori e usarle per definire una sequenza di primitive (tutti dello stesso tipo) con una singola chiamata a glDrawElements.
Quando si chiama la funzione glDrawElements , usa gli elementi sequenziali degli indici per costruire una sequenza di primitive geometriche. Il parametro mode specifica il tipo di primitive costruite e il modo in cui gli elementi della matrice vengono usati per costruire queste primitive. Se GL_VERTEX_ARRAY non è abilitato, non vengono generate primitive geometriche.
Gli attributi vertice modificati da glDrawElements hanno un valore non specificato dopo la restituzione di glDrawElements . Ad esempio, se GL_COLOR_ARRAY è abilitato, il valore del colore corrente non è definito dopo l'esecuzione di glDrawElements . Gli attributi che non vengono modificati rimangono invariati.
È possibile includere la funzione glDrawElements negli elenchi di visualizzazione. Quando glDrawElements è incluso in un elenco di visualizzazione, vengono immessi anche i dati della matrice necessari (determinati dai puntatori di matrice e abilita) nell'elenco di visualizzazione. Poiché i puntatori di matrice e abilita sono variabili di stato lato client, i relativi valori influiscono sugli elenchi di visualizzazione quando vengono creati gli elenchi, non quando vengono eseguiti gli elenchi.
Nota
La funzione glDrawElements è 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 |
|
| Libreria |
|
| DLL |
|