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
GL_INVALID_ENUM	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	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glArrayElement

glBegin

glColorPointer

glDrawArrays

glEnableClientState

glEnd

glGet

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopAttrib

glPushAttrib

glTexCoordPointer

glVertexPointer