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 zulässigen Werte finden Sie im folgenden 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 glEnd aufgerufen.

Bemerkungen

Die Funktionen glEnable und glDisable ermöglichen und deaktivieren verschiedene OpenGL-Grafikfunktionen. Verwenden Sie glIsEnabled oder glGet , um die aktuelle Einstellung einer beliebigen Funktion zu bestimmen.

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

Wert Bedeutung
GL_ALPHA_TEST Wenn aktiviert, führen Sie Alphatests durch. Siehe glAlphaFunc.
GL_AUTO_NORMAL Wenn diese Option aktiviert ist, werden normale Vektoren analytisch berechnet, wenn entweder GL_MAP2_VERTEX_3 oder GL_MAP2_VERTEX_4 Scheitelpunkte generiert hat. Siehe glMap2.
GL_BLEND Wenn diese Option aktiviert ist, blenden Sie die eingehenden RGBA-Farbwerte mit den Werten in den Farbpuffern ein. Siehe glBlendFunc.
GL_CLIP_PLANEi Wenn diese Option aktiviert ist, schneidet die Geometrie auf der benutzerdefinierten Clippingebene i ab. Siehe glClipPlane.
GL_COLOR_LOGIC_OP Wenn aktiviert, wenden Sie den aktuellen logischen Vorgang auf die eingehenden RGBA-Farb- und Farbpufferwerte an. Siehe glLogicOp.
GL_COLOR_MATERIAL Wenn diese Option aktiviert ist, lassen Sie mindestens einen Materialparameter die aktuelle Farbe nachverfolgen. Siehe glColorMaterial.
GL_CULL_FACE Wenn diese Option aktiviert ist, können Sie Polygone basierend auf ihrer Wicklung in Fensterkoordinaten cullen. Siehe glCullFace.
GL_DEPTH_TEST Wenn diese Option aktiviert ist, führen Sie Tiefenvergleiche durch, und aktualisieren Sie den Tiefenpuffer. Siehe glDepthFunc und glDepthRange.
GL_DITHER Wenn diese Option aktiviert ist, ditherfarbene Komponenten oder Indizes, bevor sie in den Farbpuffer geschrieben werden.
GL_FOG Wenn aktiviert, blenden Sie eine Nebelfarbe in die Farbe nach der Texturierung ein. Siehe glFog.
GL_INDEX_LOGIC_OP Wenn aktiviert, wenden Sie den aktuellen logischen Vorgang auf die eingehenden Index- und Farbpufferindizes an. Siehe glLogicOp.
GL_LIGHTi Wenn aktiviert, schließen Sie licht i in die Auswertung der Beleuchtungsgleichung ein. Siehe glLightModel und glLight.
GL_LIGHTING Wenn aktiviert, verwenden Sie die aktuellen Beleuchtungsparameter, um die Vertexfarbe oder den Index zu berechnen. Wenn deaktiviert, ordnen Sie jedem Scheitelpunkt die aktuelle Farbe oder den aktuellen Index zu. Siehe glMaterial, glLightModel und glLight.
GL_LINE_SMOOTH Wenn aktiviert, zeichnen Sie Linien mit korrekter Filterung. Wenn deaktiviert, zeichnen Sie Aliaslinien. 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, glEvalMesh1 und 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, glEvalMesh1 und glEvalPoint1 Normals. Siehe auch glMap1.
GL_MAP1_TEXTURE_COORD_1 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1die Texturkoordinaten. Siehe auch glMap1.
GL_MAP1_TEXTURE_COORD_2 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und 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, glEvalMesh1 und 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 glEvalPoint1x-, y- und z-Vertexkoordinaten. Siehe auch glMap1.
GL_MAP1_VERTEX_4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord1, glEvalMesh1 und glEvalPoint1 homogene Vertexkoordinaten x, y, z und w. Siehe auch glMap1.
GL_MAP2_COLOR_4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und 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 aktiviert, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 Normals. Siehe auch glMap2.
GL_MAP2_TEXTURE_COORD_1 Wenn aktiviert, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2die Texturkoordinaten. Siehe auch glMap2.
GL_MAP2_TEXTURE_COORD_2 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und 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, glEvalMesh2 und 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 glEvalPoint2x-, y- und z-Vertexkoordinaten. Siehe auch glMap2.
GL_MAP2_VERTEX_4 Wenn diese Option aktiviert ist, generieren Aufrufe von glEvalCoord2, glEvalMesh2 und glEvalPoint2 homogene Vertexkoordinaten x, y, z und w . Siehe auch glMap2.
GL_NORMALIZE Wenn aktiviert, werden normale Vektoren, die mit glNormal angegeben sind, nach der Transformation auf die Länge der Einheit skaliert. Siehe glNormal.
GL_POINT_SMOOTH Wenn aktiviert, zeichnen Sie Punkte mit der richtigen Filterung. Wenn diese Option deaktiviert ist, zeichnen Sie Aliaspunkte. Siehe glPointSize.
GL_POLYGON_OFFSET_FILL Wenn diese Option aktiviert ist und das Polygon im modus GL_FILL gerendert wird, wird den Tiefenwerten der Fragmente eines Polygons vor dem Tiefenvergleich ein Offset hinzugefügt. Siehe glPolygonOffset.
GL_POLYGON_OFFSET_LINE Wenn aktiviert und das Polygon im GL_LINE Modus gerendert wird, wird vor dem Tiefenvergleich ein Offset zu den Tiefenwerten der Fragmente eines Polygons hinzugefügt. 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 aktiviert, zeichnen Sie Polygone mit der richtigen Filterung. Wenn diese Option deaktiviert ist, zeichnen Sie Polygone mit Aliasnamen. 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 aktiviert, verwerfen Sie Fragmente, die sich außerhalb des Scherenrechtecks befinden. Siehe glScissor.
GL_STENCIL_TEST Wenn diese Option aktiviert ist, führen Sie Schablonentests durch, und aktualisieren Sie den Schablonenpuffer. Siehe glStencilFunc und glStencilOp.
GL_TEXTURE_1D Wenn diese Option aktiviert ist, wird eine eindimensionale Texturierung ausgeführt (es sei denn, die zweidimensionale Texturierung ist ebenfalls aktiviert). Siehe glTexImage1D.
GL_TEXTURE_2D Wenn diese Option aktiviert ist, wird eine zweidimensionale Texturierung ausgeführt. Siehe glTexImage2D.
GL_TEXTURE_GEN_Q Wenn diese Option aktiviert ist, wird die q-Texturkoordinate mithilfe der mit glTexGen definierten Texturgenerierungsfunktion berechnet. Andernfalls wird die aktuelle q-Texturkoordinate verwendet.
GL_TEXTURE_GEN_R Wenn aktiviert, wird die r-Texturkoordinate mithilfe der mit glTexGen definierten Texturgenerierungsfunktion berechnet. Wenn deaktiviert, wird die aktuelle r-Texturkoordinate verwendet.
GL_TEXTURE_GEN_S Wenn diese Option aktiviert ist, wird die Texturkoordinate s mithilfe der mit glTexGen definierten Texturgenerierungsfunktion berechnet. Wenn diese Option deaktiviert ist, wird die aktuelle Texturkoordinate verwendet .
GL_TEXTURE_GEN_T Wenn diese Option aktiviert ist, wird die t-Texturkoordinate mithilfe der mit glTexGen definierten Texturgenerierungsfunktion berechnet. Wenn sie deaktiviert ist, wird die aktuelle t-Texturkoordinate verwendet.

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