閱讀英文

共用方式為


glDisable 函式

glEnableglDisable函式會啟用或停用 OpenGL 功能。

語法

void WINAPI glDisable(
   GLenum cap
);

參數

表示 OpenGL 功能的符號常數。

如需值 上限 的討論,請參閱下列一節。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱 意義
GL_INVALID_ENUM
cap 不是上述一節中所列的其中一個值。
GL_INVALID_OPERATION
函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glEnableglDisable函式會啟用和停用各種 OpenGL 圖形功能。 使用 glIsEnabledglGet 來判斷任何功能的目前設定。

glEnableglDisable都採用單一引數cap,它可以假設下列其中一個值:

意義
GL_ALPHA_TEST 如果啟用,請執行 Alpha 測試。 請參閱 glAlphaFunc
GL_AUTO_NORMAL 如果啟用,當GL_MAP2_VERTEX_3或GL_MAP2_VERTEX_4產生頂點時,會以分析方式計算表面法向量。 請參閱 glMap2
GL_BLEND 如果啟用,請將傳入 RGBA 色彩值與色彩緩衝區中的值混合。 請參閱 glBlendFunc
GL_CLIP_PLANEi 如果啟用,則會針對使用者定義的裁剪平面 i裁剪幾何。 請參閱 glClipPlane
GL_COLOR_LOGIC_OP 如果啟用,請將目前的邏輯作業套用至傳入 RGBA 色彩和色彩緩衝區值。 請參閱 glLogicOp
GL_COLOR_MATERIAL 如果啟用,請讓一或多個材質參數追蹤目前的色彩。 請參閱 glColorMaterial
GL_CULL_FACE 如果啟用,則會根據其在視窗座標中的線圈來計算多邊形。 請參閱 glCullFace
GL_DEPTH_TEST 如果啟用,請執行深度比較並更新深度緩衝區。 請參閱 glDepthFuncglDepthRange
GL_DITHER 如果啟用,則會在色彩元件或索引寫入色彩緩衝區之前,先加以刪除。
GL_FOG 如果啟用,請將水氣色彩混合至貼文色彩。 請參閱 glFog
GL_INDEX_LOGIC_OP 如果啟用,請將目前的邏輯作業套用至傳入索引和色彩緩衝區索引。 請參閱 glLogicOp
GL_LIGHTi 如果啟用,請在光源方程式的評估中包含光線 i 。 請參閱 glLightModelglLight
GL_LIGHTING 如果啟用,請使用目前的光源參數來計算頂點色彩或索引。 如果停用,請將目前的色彩或索引與每個頂點產生關聯。 請參閱 glMaterialglLightModelglLight
GL_LINE_SMOOTH 如果啟用,請使用正確的篩選繪製線條。 如果停用,請繪製別名線條。 請參閱 glLineWidth
GL_LINE_STIPPLE 如果啟用,請在繪製線條時使用目前的線條存根圖樣。 請參閱 glLineStipple
GL_LOGIC_OP 如果啟用,請將目前選取的邏輯作業套用至傳入和色彩緩衝區索引。 請參閱 glLogicOp
GL_MAP1_COLOR_4 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生 RGBA 值。 另請參閱 glMap1
GL_MAP1_INDEX 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生色彩索引。 另請參閱 glMap1
GL_MAP1_NORMAL 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生正常狀況。 另請參閱 glMap1
GL_MAP1_TEXTURE_COORD_1 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1會產生紋理 座標。 另請參閱 glMap1
GL_MAP1_TEXTURE_COORD_2 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生 st 紋理座標。 另請參閱 glMap1
GL_MAP1_TEXTURE_COORD_3 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生 str 紋理座標。 另請參閱 glMap1
GL_MAP1_TEXTURE_COORD_4 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生 strq 紋理座標。 另請參閱 glMap1
GL_MAP1_VERTEX_3 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生 xyz 頂點座標。 另請參閱 glMap1
GL_MAP1_VERTEX_4 如果啟用,則呼叫 glEvalCoord1glEvalMesh1glEvalPoint1 會產生同質 xyzw 頂點座標。 另請參閱 glMap1
GL_MAP2_COLOR_4 如果已啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生 RGBA 值。 另請參閱 glMap2
GL_MAP2_INDEX 如果啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生色彩索引。 另請參閱 glMap2
GL_MAP2_NORMAL 如果已啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生常態。 另請參閱 glMap2
GL_MAP2_TEXTURE_COORD_1 如果啟用,則呼叫glEvalCoord2glEvalMesh2 和 glEvalPoint2會產生紋理座標。 另請參閱 glMap2
GL_MAP2_TEXTURE_COORD_2 如果已啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生 st 紋理座標。 另請參閱 glMap2
GL_MAP2_TEXTURE_COORD_3 如果啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生 str 紋理座標。 另請參閱 glMap2
GL_MAP2_TEXTURE_COORD_4 如果已啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生 strq 紋理座標。 另請參閱 glMap2
GL_MAP2_VERTEX_3 如果已啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生 xyz 頂點座標。 另請參閱 glMap2
GL_MAP2_VERTEX_4 如果啟用,則呼叫 glEvalCoord2glEvalMesh2glEvalPoint2 會產生同質 xyzw 頂點座標。 另請參閱 glMap2
GL_NORMALIZE 如果啟用,使用 glNormal 指定的一般向量會在轉換之後調整為單位長度。 請參閱 glNormal
GL_POINT_SMOOTH 如果啟用,請繪製具有適當篩選的點。 如果停用,請繪製別名點。 請參閱 glPointSize
GL_POLYGON_OFFSET_FILL 如果已啟用,而且多邊形是以GL_FILL模式轉譯,則會在執行深度比較之前,將位移新增至多邊形片段的深度值。 請參閱 glPolygonOffset
GL_POLYGON_OFFSET_LINE 如果已啟用,且多邊形是以GL_LINE模式呈現,則會在執行深度比較之前,將位移新增至多邊形片段的深度值。 請參閱 glPolygonOffset
GL_POLYGON_OFFSET_POINT 如果啟用,則會在執行深度比較之前,將位移新增至多邊形片段的深度值,如果多邊形是以GL_POINT模式轉譯。 請參閱 glPolygonOffset
GL_POLYGON_SMOOTH 如果已啟用,請繪製具有適當篩選的多邊形。 如果停用,請繪製別名多邊形。 請參閱 glPolygonMode
GL_POLYGON_STIPPLE 如果啟用,請在轉譯多邊形時使用目前的多邊形 Stipple 模式。 請參閱 glPolygonStipple
GL_SCISSOR_TEST 如果啟用,請捨棄位於剪刀矩形外部的片段。 請參閱 glScissor
GL_STENCIL_TEST 如果啟用,請執行樣板測試並更新樣板緩衝區。 請參閱 glStencilFuncglStencilOp
GL_TEXTURE_1D 如果啟用,則會 (執行一維紋理,除非同時啟用二維紋理) 。 請參閱 glTexImage1D
GL_TEXTURE_2D 如果啟用,則會執行二維紋理。 請參閱 glTexImage2D
GL_TEXTURE_GEN_Q 如果已啟用,則會使用以glTexGen定義的紋理產生函式來計算q紋理座標。 否則,會使用目前的 q 紋理座標。
GL_TEXTURE_GEN_R 如果已啟用,則會使用以glTexGen定義的紋理產生函式來計算r紋理座標。 如果停用,則會使用目前的 r 紋理座標。
GL_TEXTURE_GEN_S 如果啟用,則會使用以glTexGen定義的紋理產生函數來計算紋理座標。 如果停用,則會 使用目前的紋理 座標。
GL_TEXTURE_GEN_T 如果已啟用,則會使用以glTexGen定義的紋理產生函數來計算t紋理座標。 如果停用,則會使用目前的 t 紋理座標。

規格需求

需求
最低支援的用戶端
Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

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