glBegin-Funktion
Die GlBegin- und die glBegin-Funktion begrenzen die Scheitelpunkte eines Primitiven oder einer Gruppe von ähnlichen Primitiven.
Syntax
void WINAPI glBegin(
GLenum mode
);
Parameter
-
mode
-
Die primitiven oder primitiven Typen, die aus Scheitelpunkten erstellt werden, die zwischen glBegin und dem nachfolgenden geziertendargestellt werden. Die folgenden symbolischen Konstanten und ihre Bedeutung werden akzeptiert:
Wert Bedeutung - GL _ POINTS
Behandelt jeden Scheitelpunkt als einen einzelnen Punkt. Vertex n definiert Punkt n. N Punkte werden gezeichnet. - GL _ LINES
Behandelt jedes Scheitelpunktpaar als unabhängiges Liniensegment. Die Scheitelpunkte 2n bis 1 und 2n definieren Zeile n. Es werden N/2 Linien gezeichnet. - GL _ LINE _ STRIP
Zeichnet eine verbundene Gruppe von Liniensegmenten vom ersten bis zum letzten Scheitelpunkt. Die Scheitelpunkte n und n+1 definieren Zeile n. N – 1 Linien werden gezeichnet. - GL _ LINE _ LOOP
Zeichnet eine verbundene Gruppe von Liniensegmenten vom ersten Scheitelpunkt bis zum letzten und dann zurück zum ersten. Die Scheitelpunkte n und n + 1 definieren Zeile n. Die letzte Zeile wird jedoch durch die Scheitelpunkte N und 1 definiert. N Linien werden gezeichnet. - GL _ TRIANGLES
Behandelt jedes Triplet von Scheitelpunkten als unabhängiges Dreieck. Die Scheitelpunkte 3n - 2, 3n - 1 und 3n definieren das Dreieck n. N/3 Dreiecke werden gezeichnet. - GL _ TRIANGLE _ STRIP
Zeichnet eine verbundene Gruppe von Dreiecken. Für jeden Scheitelpunkt, der nach den ersten beiden Scheitelpunkten angezeigt wird, wird ein Dreieck definiert. Definieren Sie für ungerade n die Scheitelpunkte n, n + 1 und n + 2 das Dreieck n. Für sogar n definieren die Scheitelpunkte n + 1, n und n + 2 das Dreieck n. N – 2 Dreiecke werden gezeichnet. - GL _ TRIANGLE _ FAN
Zeichnet eine verbundene Gruppe von Dreiecken. Für jeden Scheitelpunkt, der nach den ersten beiden Scheitelpunkten angezeigt wird, wird ein Dreieck definiert. Die Scheitelpunkte 1, n + 1, n + 2 definieren das Dreieck n. N – 2 Dreiecke werden gezeichnet. - GL _ QUADS
Behandelt jede Gruppe von vier Scheitelpunkten als unabhängiges Quadernatral. Die Scheitelpunkte 4n - 3, 4n - 2, 4n - 1 und 4n definieren quadquaquarale n. N/4 Quaderale werden gezeichnet. - GL _ QUAD _ STRIP
Zeichnet eine verbundene Gruppe von Quadernatralen. Für jedes Vertices-Paar, das nach dem ersten Paar angezeigt wird, wird ein Quaderatral definiert. Die Scheitelpunkte 2n – 1, 2n, 2n + 2 und 2n + 1 definieren quadquarale n. N/2 - 1 Quadquaraterale werden gezeichnet. Beachten Sie, dass sich die Reihenfolge, in der Scheitelpunkte zum Erstellen eines Quaderatrals aus Stripdaten verwendet werden, von der Reihenfolge unterscheidet, die mit unabhängigen Daten verwendet wird. - _GL-POLYGON
Zeichnet ein einzelnes konvexes Polygon. Die Scheitelpunkte 1 bis N definieren dieses Polygon.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
mode wurde auf einen nicht akzeptierten Wert festgelegt. |
|
Eine andere Funktion als glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallListoder glCallLists wurde zwischen glBegin und dem entsprechenden geleertenaufgerufen. Die Funktion wurde aufgerufen, bevor die entsprechende glBegin aufgerufen wurde, oder glBegin wurde innerhalb einer glBegin-Sequenz / aufgerufen. |
Hinweise
Die GlBegin- und die glBegind-Funktion begrenzen die Scheitelpunkte, die einen Primitiven oder eine Gruppe von ähnlichen Primitiven definieren. Die glBegin-Funktion akzeptiert ein einzelnes Argument, das angibt, welche von zehn Primitiven die Scheitelpunkte bilden. Wenn n als ganzzahlige Anzahl beginnend bei 1 und N als Gesamtzahl der angegebenen Scheitelpunkte verwendet wird, sind die Interpretationen wie folgt:
Sie können nur eine Teilmenge der OpenGL-Funktionen zwischen glBegin und dem -Ausschnittverwenden. Sie können folgende Funktionen verwenden:
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 soll aufgerufen werden,wird das Fehlerflag festgelegt, und die Funktion wird ignoriert.
Unabhängig vom Wert, der für den Modus in glBegin ausgewählt wurde, gibt es keine Beschränkung für die Anzahl der Scheitelpunkte, die Sie zwischen glBegin und dem gepunktetendefinieren können. Unvollständig angegebene Linien, Dreiecke, Quadquaraterale und Polygone werden nicht gezeichnet. Unvollständige Spezifikationsergebnisse, wenn entweder zu wenige Scheitelpunkte bereitgestellt werden, um sogar einen einzelnen Primitiven anzugeben, oder wenn ein falsches Vielfaches von Scheitelpunkten angegeben wird. Der unvollständige Primitive wird ignoriert. die vollständigen Primitive werden gezeichnet.
Die Mindestspezifikation von Scheitelpunkten für jedes Primitive ist:
Mindestanzahl von Scheitelpunkten Typ des Primitiven 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 |
|
| Bibliothek |
|
| DLL |
|