glEnd-Funktion

Die Funktionen glBegin und glEnd begrenzen die Scheitelpunkte eines Grundtyps oder einer Gruppe von ähnlichen Grundtypen.

Syntax

void WINAPI glEnd(void);

Parameter

Diese Funktion besitzt keine Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_OPERATION	Eine andere Funktion als glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList oder glCallLists wurde zwischen glBegin und dem entsprechenden glEnd aufgerufen. Die Funktion glEnd wurde aufgerufen, bevor die entsprechende glBegin aufgerufen wurde, oder glBegin wurde innerhalb einer glBegin/glEnd-Sequenz aufgerufen.

Bemerkungen

Die Funktionen glBegin und glEnd begrenzen die Scheitelpunkte, die einen Grundtyp oder eine Gruppe von ähnlichen Grundtypen definieren. Die glBegin-Funktion akzeptiert ein einzelnes Argument, das angibt, welche der zehn Grundtypen die Scheitelpunkte bilden. Wenn n als ganzzahlige Anzahl ab 1 und N als Gesamtanzahl der angegebenen Scheitelpunkte verwendet wird, werden folgende Interpretationen ausgeführt:

• Sie können nur eine Teilmenge der OpenGL-Funktionen zwischen glBegin und glEnd verwenden. Sie können folgende Funktionen verwenden:

  • glVertex
  • glColor
  • glIndex
  • glNormal
  • glTexCoord
  • glEvalCoord
  • glEvalPoint
  • glMaterial
  • glEdgeFlag

  Sie können auch glCallList oder glCallLists verwenden, um Anzeigelisten auszuführen, die nur die vorherigen Funktionen enthalten. Wenn eine andere OpenGL-Funktion zwischen glBegin und glEnd aufgerufen wird, wird das Fehlerflag festgelegt, und die Funktion wird ignoriert.

• Unabhängig vom für den Modus in glBegin ausgewählten Wert gibt es keine Begrenzung der Anzahl von Scheitelpunkten, die Sie zwischen glBegin und glEnd definieren können. Unvollständig angegebene Linien, Dreiecke, Vierecks und Polygone werden nicht gezeichnet. Unvollständige Spezifikation ergibt, wenn entweder zu wenige Scheitelpunkte bereitgestellt werden, um auch nur einen einzelnen Grundtyp anzugeben, oder wenn ein falsches Vielfaches von Scheitelpunkten angegeben wird. Der unvollständige Grundtyp wird ignoriert. die vollständigen Grundtypen werden gezeichnet.

• Die Mindestspezifikation der Scheitelpunkte für jeden Grundtyp ist:

  Mindestanzahl von Scheitelpunkten	Typ des Grundtyps
  1	point
  2	line
  3	Dreieck
  4	Viereck
  3	polygon

• Modi, die ein bestimmtes Vielfaches von Scheitelpunkten erfordern, sind GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4) und GL_QUAD_STRIP (2).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glCallLists

glColor

glEdgeFlag

glEvalCoord

glEvalPoint

glIndex

glMaterial

glNormal

glTexCoord

glVertex