glEdgeFlagPointer-Funktion

Die glEdgeFlagPointer-Funktion definiert ein Array von Edgeflags.

Syntax

void WINAPI glEdgeFlagPointer(
         GLsizei stride,
   const GLvoid  *pointer
);

Parameter

Schritt

Der Byteoffset zwischen aufeinander folgenden Edgeflags. Wenn stride 0 (null) ist, werden die Edgeflags eng in das Array gepackt.

Zeiger

Ein Zeiger auf das erste Edgeflag im Array.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

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

Name Bedeutung
GL _ INVALID _ ENUM
stride oder count war negativ.

Hinweise

Die glEdgeFlagPointer-Funktion gibt den Speicherort und die Daten eines Arrays von booleschen Edgeflags an, die beim Rendering verwendet werden. Der stride-Parameter bestimmt den Byteoffset von einem Edgeflag zum nächsten, wodurch das Packen von Scheitelzeichen und Attributen in einem einzelnen Array oder Speicher in separaten Arrays ermöglicht wird. In einigen Implementierungen kann das Speichern der Scheitelungen und Attribute in einem einzelnen Array effizienter sein als die Verwendung separater Arrays.

Ein Edgeflagarray wird aktiviert, wenn Sie die GL _ EDGE FLAG ARRAY-Konstante mit _ _ glEnableClientState angeben. Bei Aktivierung verwendet glDrawArrays oder glArrayElement das Edgeflagarray. Standardmäßig ist das Edgeflagarray deaktiviert.

Verwenden Sie glDrawArrays, um eine Sequenz von Primitiven (alle desselben Typs) aus vorab angegebenen Vertex- und Vertexattributarrays zu erstellen. Verwenden Sie glArrayElement, um Primitive anzugeben, indem Sie Scheitelpunkte und Scheitelpunktattribute indizieren, und glDrawElements, um eine Sequenz von Primitiven zu erstellen, indem Scheitelpunkte und Scheitelpunktattribute indiziert werden.

GlEdgeFlagPointer kann nicht in Anzeigelisten enthalten sein.

Wenn Sie ein Edgeflagarray mit glEdgeFlagPointer angeben, werden die Werte aller Edgeflag-Arrayparameter der Funktion in einem clientseitigen Zustand gespeichert, und statische Arrayelemente können zwischengespeichert werden. Da sich die Arrayparameter des Edgeflags in einem clientseitigen Zustand befinden, speichern und wiederherstellen glPushAttrib und glPopAttrib ihre Werte nicht.

Obwohl der Aufruf von glEdgeFlagPointer in einem glBegin-gekoppeltenPaar keinen Fehler generiert, sind die Ergebnisse / nicht definiert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit der glEdgeFlagPointer-Funktion ab:

glGet mit argument GL _ EDGE FLAG ARRAY _ _ _ STRIDE

glGet mit argument GL _ EDGE FLAG ARRAY _ _ _ COUNT

glGetPointerv mit Argument GL _ EDGE FLAG ARRAY _ _ _ POINTER

glIsEnabled mit Argument GL _ EDGE FLAG _ _ ARRAY

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

glArrayElement

glBegin

glColorPointer

glDrawArrays

glEnableClientState

glEnd

glGet

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopAttrib

glPushAttrib

glTexCoordPointer

glVertexPointer