funzione glEnd

  • Articolo

Le funzioni glBegin e glEnd delimitano i vertici di una primitiva o di un gruppo di primitive.

Sintassi

void WINAPI glEnd(void);

Parametri

Questa funzione non ha parametri.

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_OPERATION
 Una funzione diversa da glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList o glCallLists è stata chiamata tra glBegin e il glEnd corrispondente. La funzione glEnd è stata chiamata prima della chiamata glBegin corrispondente o glBegin è stata chiamata all'interno di una sequenza glBegin/glEnd.

Commenti

Le funzioni glBegin e glEnd delimitano i vertici che definiscono una primitiva o un gruppo di primitive. La funzione glBegin accetta un singolo argomento che specifica quale di dieci primitive compongono i vertici. Prendendo n come numero intero a partire da uno e N come numero totale di vertici specificati, le interpretazioni sono le seguenti:

  • È possibile usare solo un subset di funzioni OpenGL tra glBegin e glEnd. Le funzioni che è possibile usare sono:

    È anche possibile usare glCallList o glCallLists per eseguire elenchi di visualizzazione che includono solo le funzioni precedenti. Se qualsiasi altra funzione OpenGL viene chiamata tra glBegin e glEnd, il flag di errore viene impostato e la funzione viene ignorata.

  • Indipendentemente dal valore scelto per la modalità in glBegin, non esiste alcun limite al numero di vertici che è possibile definire tra glBegin e glEnd. Le linee, i triangoli, i quadrilateri e i poligoni specificati in modo incompleto non vengono disegnati. Risultati di specifica incompleti quando vengono specificati troppo pochi vertici per specificare anche una singola primitiva o quando viene specificato un multiplo errato di vertici. La primitiva incompleta viene ignorata; vengono disegnate le primitive complete.

  • La specifica minima dei vertici per ogni primitiva è:

    Numero minimo di vertici Tipo di primitiva
    1 point
    2 line
    3 triangolo
    4 Quadrilatero
    3 polygon

  • Le modalità che richiedono un determinato numero di vertici sono GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4) e GL_QUAD_STRIP (2).

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

glCallLists

glColor

glEdgeFlag

glEvalCoord

glEvalPoint

glIndex

glMaterial

glNormal

glTexCoord

glVertex