funzione glDrawArrays
La funzione glDrawArrays specifica più primitive da eseguire per il rendering.
Sintassi
void WINAPI glDrawArrays(
GLenum mode,
GLint first,
GLsizei count
);
Parametri
-
mode
-
Tipo di primitive da eseguire per il rendering. Le costanti seguenti specificano tipi accettabili di primitive: 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.
-
first
-
Indice iniziale nelle matrici abilitate.
-
count
-
Numero di indici da eseguire per il rendering.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
il conteggio era negativo. |
|
la modalità non è stata accettata. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
Con glDrawArrays è possibile specificare più primitive geometriche da eseguire per il rendering. Anziché chiamare funzioni OpenGL separate per passare ogni singolo vertice, normale o colore, è possibile specificare matrici separate di vertici, normali e colori per definire una sequenza di primitive (tutti gli stessi tipi) con una singola chiamata a glDrawArrays.
Quando si chiama glDrawArrays, conteggiare gli elementi sequenziali di ogni matrice abilitata vengono usati per costruire una sequenza di primitive geometriche, a partire dal primo elemento. Il parametro mode specifica il tipo di primitiva da costruire e come usare gli elementi della matrice per costruire le primitive.
Dopo aver restituito glDrawArrays , i valori degli attributi dei vertici modificati da glDrawArrays non sono definiti. Se, ad esempio, GL_COLOR_ARRAY è abilitato, il valore del colore corrente non è definito dopo la restituzione di glDrawArrays . Gli attributi non modificati da glDrawArrays rimangono definiti. Quando GL_VERTEX_ARRAY non è abilitato, non vengono generate primitive geometriche, ma vengono modificati gli attributi corrispondenti alle matrici abilitate.
È possibile includere glDrawArrays negli elenchi di visualizzazione. Quando si includono glDrawArrays in un elenco di visualizzazione, i dati della matrice necessari, determinati dai puntatori di matrice e dagli abilita, vengono generati e immessi nell'elenco di visualizzazione. I valori dei puntatori di matrice e abilita vengono determinati durante la creazione di elenchi di visualizzazione.
È possibile leggere i dati della matrice statica in qualsiasi momento. Se gli elementi della matrice statica vengono modificati e la matrice non viene specificata di nuovo, i risultati delle chiamate successive a glDrawArrays non sono definiti.
Anche se non viene generato alcun errore quando si specifica una matrice più di una volta all'interno di glBegin e coppie glend , i risultati non sono definiti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|