glDisable-Funktion

Die Funktionen glEnable und glDisable aktivieren oder deaktivieren OpenGL-Funktionen.

Syntax

void WINAPI glDisable(
   GLenum cap
);

Parameter

Cap

Eine symbolische Konstante, die eine OpenGL-Funktion angibt.

Eine Erläuterung der Werteobergrenze finden Sie im abschnitt "Hinweise".

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ INVALID _ ENUM
cap war keiner der im vorherigen Abschnitt "Hinweise" aufgeführten Werte.
GL _ INVALID _ OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen.

Bemerkungen

Die Funktionen glEnable und glDisable aktivieren und deaktivieren verschiedene OpenGL-Grafikfunktionen. Verwenden Sie glIsEnabled oder glGet, um die aktuelle Einstellung jeder Funktion zu bestimmen.

Sowohl glEnable als auch glDisable übernehmen ein einzelnes Argument, cap, das einen der folgenden Werte annehmen kann:

Wert Bedeutung
GL _ ALPHA _ TEST Wenn diese Option aktiviert ist, sollten Sie Alphatests durchführen. Siehe glAlphaFunc.
GL _ AUTO _ NORMAL Wenn diese Option aktiviert ist, berechnen Sie Normalvektoren der Oberfläche analytisch, wenn entweder GL _ MAP2 _ VERTEX _ 3 oder GL _ MAP2 _ VERTEX _ 4 Scheitelpunkte generiert hat. Siehe glMap2.
GL _ BLEND Wenn diese Option aktiviert ist, mischen Sie die eingehenden RGBA-Farbwerte mit den Werten in den Farbpuffern. Siehe glBlendFunc.
GL _ CLIP _ PLANE i Wenn diese Option aktiviert ist, wird die Geometrie anhand der benutzerdefinierten Clippingebene i abgeschnitten. Weitere Informationen finden Sie unter glClipPlane.
GL _ COLOR _ LOGIC _ OP Wenn diese Option aktiviert ist, wenden Sie den aktuellen logischen Vorgang auf die eingehenden RGBA-Farb- und Farbpufferwerte an. Siehe glLogicOp.
GL _ COLOR _ MATERIAL Wenn diese Option aktiviert ist, können Sie die aktuelle Farbe mit einem oder mehreren Materialparametern nachverfolgen. Siehe glColorMaterial.
GL _ CULL _ FACE Wenn diese Option aktiviert ist, können Polygone basierend auf deren Ziehung in Fensterkoordinaten mit Cullen versetzt werden. Siehe glCullFace.
_ _ GL-TIEFENTEST Wenn diese Option aktiviert ist, können Sie Tiefenvergleiche durchführen und den Tiefenpuffer aktualisieren. Siehe glDepthFunc und glDepthRange.
GL _ DITHER Wenn diese Option aktiviert ist, können Sie Farbkomponenten oder Indizes ditherieren, bevor sie in den Farbpuffer geschrieben werden.
GL _ VERSCHENKTE Wenn diese Option aktiviert ist, mischen Sie eine Farbfarbe in die Farbe nach der Texturierung. Weitere Informationen finden Sie unter glFog.
GL _ INDEX _ LOGIC _ OP Wenn diese Option aktiviert ist, wenden Sie den aktuellen logischen Vorgang auf den eingehenden Index und die Farbpufferindizes an. Siehe glLogicOp.
GL _ LIGHT i Wenn diese Option aktiviert ist, schließen Sie light i in die Auswertung der Beleuchtungsgleichung ein. Siehe glLightModel und glLight.
GL _ LIGHTING Wenn diese Option aktiviert ist, verwenden Sie die aktuellen Beleuchtungsparameter, um die Scheitelpunktfarbe oder den Index zu berechnen. Wenn diese Option deaktiviert ist, ordnen Sie jedem Scheitelpunkt die aktuelle Farbe oder den aktuellen Index zu. Weitere Informationen finden Sie unter glMaterial, glLightModel und glLight.
GL _ LINE _ SMOOTH Wenn diese Option aktiviert ist, zeichnen Sie Linien mit korrekter Filterung. Wenn diese Option deaktiviert ist, zeichnen Sie Linien mit Alias. Siehe glLineWidth.
GL _ LINE _ STIPPLE Wenn diese Option aktiviert ist, verwenden Sie beim Zeichnen von Linien das aktuelle Linienstipplemuster. Siehe glLineStipple.
GL _ LOGIC _ OP Wenn diese Option aktiviert ist, wenden Sie den aktuell ausgewählten logischen Vorgang auf die eingehenden Indizes und Farbpufferindizes an. Siehe glLogicOp.
GL _ MAP1 _ COLOR _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1und glEvalPoint1 RGBA-Werte. Siehe auch glMap1.
GL _ MAP1 _ INDEX Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1 Farbindizes. Siehe auch glMap1.
GL _ MAP1 _ NORMAL Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1und glEvalPoint1 Normaldaten. Siehe auch glMap1.
GL _ MAP1 _ TEXTURE _ COORD _ 1 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1 Texturkoordinaten. Siehe auch glMap1.
GL _ MAP1 _ TEXTURE _ COORD _ 2 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1und glEvalPoint1 die Texturkoordinaten s und t. Siehe auch glMap1.
GL _ MAP1 _ TEXTURE _ COORD _ 3 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1 die Texturkoordinaten s , t und r. Siehe auch glMap1.
GL _ MAP1 _ TEXTURE _ COORD _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1und glEvalPoint1 die Texturkoordinaten s, t, r und q. Siehe auch glMap1.
GL _ MAP1 _ VERTEX _ 3 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1 x-, y- und z-Scheitelpunktkoordinaten. Siehe auch glMap1.
GL _ MAP1 _ VERTEX _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1und glEvalPoint1 homogene x-, y-, z- und w-Scheitelpunktkoordinaten. Siehe auch glMap1.
GL _ MAP2 _ COLOR _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2und glEvalPoint2 RGBA-Werte. Siehe auch glMap2.
GL _ MAP2 _ INDEX Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 Farbindizes. Siehe auch glMap2.
GL _ MAP2 _ NORMAL Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2und glEvalPoint2 Normaldaten. Siehe auch glMap2.
GL _ MAP2 _ TEXTURE _ COORD _ 1 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 Texturkoordinaten. Siehe auch glMap2.
GL _ MAP2 _ TEXTURE _ COORD _ 2 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2und glEvalPoint2 die Texturkoordinaten s und t. Siehe auch glMap2.
GL _ MAP2 _ TEXTURE _ COORD _ 3 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 die Texturkoordinaten s , t und r. Siehe auch glMap2.
GL _ MAP2 _ TEXTURE _ COORD _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2und glEvalPoint2 die Texturkoordinaten s, t, r und q. Siehe auch glMap2.
GL _ MAP2 _ VERTEX _ 3 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 x-, y- und z-Scheitelpunktkoordinaten. Siehe auch glMap2.
GL _ MAP2 _ VERTEX _ 4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2und glEvalPoint2 homogene x-, y-, z- und w-Scheitelpunktkoordinaten. Siehe auch glMap2.
GL _ NORMALIZE Wenn diese Option aktiviert ist, werden normal mit glNormal angegebene Vektoren nach der Transformation auf die Einheitslänge skaliert. Siehe glNormal.
GL _ POINT _ SMOOTH Wenn diese Option aktiviert ist, zeichnen Sie Punkte mit ordnungsgemäßer Filterung. Wenn diese Option deaktiviert ist, zeichnen Sie Punkte mit Alias. Siehe glPointSize.
GL _ POLYGON _ OFFSET _ FILL Wenn diese Option aktiviert ist und das Polygon im GL FILL-Modus gerendert _ wird, wird den Tiefenwerten der Fragmente eines Polygons ein Offset hinzugefügt, bevor der Tiefenvergleich durchgeführt wird. Siehe glPolygonOffset.
GL _ POLYGON _ OFFSET _ LINE Wenn diese Option aktiviert ist und das Polygon im GL LINE-Modus gerendert _ wird, wird den Tiefenwerten der Fragmente eines Polygons ein Offset hinzugefügt, bevor der Tiefenvergleich durchgeführt wird. Siehe glPolygonOffset.
GL _ POLYGON _ OFFSET _ POINT Wenn diese Option aktiviert ist, wird den Tiefenwerten der Fragmente eines Polygons vor dem Tiefenvergleich ein Offset hinzugefügt, wenn das Polygon im GL POINT-Modus gerendert _ wird. Siehe glPolygonOffset.
GL _ POLYGON _ SMOOTH Wenn diese Option aktiviert ist, zeichnen Sie Polygone mit ordnungsgemäßer Filterung. Wenn diese Option deaktiviert ist, zeichnen Sie Polygone mit Alias. Siehe glPolygonMode.
GL _ POLYGON _ STIPPLE Wenn diese Option aktiviert ist, verwenden Sie beim Rendern von Polygonen das aktuelle Polygonstipplemuster. Siehe glPolygonStipple.
GL _ _ SCISSOR-TEST Wenn diese Option aktiviert ist, verwerfen Sie Fragmente, die sich außerhalb des Scissor-Rechtecks befinden. Siehe glScissor.
GL _ _ STENCIL-TEST Wenn diese Option aktiviert ist, können Sie Schablonentests durchführen und den Schablonenpuffer aktualisieren. Siehe glStencilFunc und glStencilOp.
GL _ TEXTURE _ 1D Wenn diese Option aktiviert ist, wird die eindimensionale Texturierung ausgeführt (es sei denn, die zweidimensionale Texturierung ist ebenfalls aktiviert). Siehe glTexImage1D.
GL _ TEXTURE _ 2D Wenn diese Option aktiviert ist, wird die zweidimensionale Texturierung ausgeführt. Siehe glTexImage2D.
GL _ TEXTURE _ GEN _ Q Wenn diese Option aktiviert ist, wird die Texturkoordinate q mithilfe der Texturgenerierungsfunktion berechnet, die mit glTexGendefiniert ist. Andernfalls wird die aktuelle q-Texturkoordinate verwendet.
GL _ TEXTURE _ GEN _ R Wenn diese Option aktiviert ist, wird die r-Texturkoordinate mithilfe der Texturgenerierungsfunktion berechnet, die mit glTexGendefiniert ist. Wenn diese Option deaktiviert ist, wird die aktuelle r-Texturkoordinate verwendet.
GL _ TEXTURE _ GEN _ S Wenn diese Option aktiviert ist, wird die Texturkoordinate mithilfe der Texturgenerierungsfunktion berechnet, die mit glTexGen definiert ist. Wenn diese Option deaktiviert ist, wird die Texturkoordinate der aktuellen verwendet.
GL _ TEXTURE _ GEN _ T Wenn diese Option aktiviert ist, wird die Texturkoordinate t mithilfe der texturgenerierungsfunktion berechnet, die mit glTexGendefiniert ist. Wenn diese Option deaktiviert ist, wird die aktuelle t Texturkoordinate verwendet.

Requirements (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

glAlphaFunc

glArrayElement

glBegin

glBlendFunc

glClipPlane

glColorMaterial

glColorPointer

glCullFace

glDepthFunc

glDepthRange

glDrawArrays

glEdgeFlagPointer

glEnable

glEnd

glEvalCoord1

glEvalMesh1

glEvalPoint1

glFog

glGet

glIndexPointer

glIsEnabled

glLight

glLightModel

glLineWidth

glLineStipple

glLogicOp

glMap1

glMap2

glMaterial

glNormal

glNormalPointer

glPointSize

glPolygonMode

glPolygonStipple

glScissor

glStencilFunc

glStencilOp

glTexCoordPointer

glTexGen

glTexImage1D

glTexImage2D