funzione glEdgeFlagPointer
La funzione glEdgeFlagPointer definisce una matrice di flag perimetrali.
Sintassi
void WINAPI glEdgeFlagPointer(
GLsizei stride,
const GLvoid *pointer
);
Parametri
-
Passo
-
Offset di byte tra flag di bordo consecutivi. Quando stride è zero, i flag perimetrali sono strettamente compressi nella matrice.
-
Puntatore
-
Puntatore al primo flag perimetrale nella matrice.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
Il codice di errore seguente può essere recuperato dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
stride o conteggio è negativo. |
Commenti
La funzione glEdgeFlagPointer specifica la posizione e i dati di una matrice di flag perimetrali booleani da usare durante il rendering. Il parametro stride determina l'offset di byte da un flag perimetrale al successivo, che consente 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.
Quando si specifica la costante di GL_EDGE_FLAG_ARRAY con glEnableClientState, viene abilitata una matrice di flag perimetrale. Se abilitato, glDrawArrays o glArrayElement usa la matrice del flag perimetrale. Per impostazione predefinita, la matrice di flag perimetrale è disabilitata.
Usare glDrawArrays per costruire una sequenza di primitive (tutti gli stessi tipi) dai vertici prespecificati e dalle matrici di attributi del vertice. Usare glArrayElement per specificare le primitive indicizzando vertici e attributi del vertice e glDrawElements per costruire una sequenza di primitive indicizzando vertici e attributi del vertice.
Non è possibile includere glEdgeFlagPointer negli elenchi di visualizzazione.
Quando si specifica una matrice di flag perimetrale usando glEdgeFlagPointer, i valori di tutti i parametri della matrice del flag perimetrale 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 del flag perimetrale si trovano in uno stato lato client, glPushAttrib e glPopAttrib non salvano o ripristinano i valori.
Anche se la chiamata a glEdgeFlagPointer all'interno di una coppia glBegin/glend non genera un errore, i risultati non sono definiti.
Le funzioni seguenti recuperano informazioni correlate alla funzione glEdgeFlagPointer :
glGet con argomento GL_EDGE_FLAG_ARRAY_STRIDE
glGet con argomento GL_EDGE_FLAG_ARRAY_COUNT
glGetPointerv con argomento GL_EDGE_FLAG_ARRAY_POINTER
glIsEnabled con argomento GL_EDGE_FLAG_ARRAY
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|