NAME

glEnable, glDisable - enable or disable server-side GL capabilities

C SPECIFICATION

void ggllEEnnaabbllee( GLenum _c_a_p )

        

PARAMETERS

_c_a_p
Specifies a symbolic constant indicating a GL capability.

C SPECIFICATION

void ggllDDiissaabbllee( GLenum _c_a_p )

        

PARAMETERS

_c_a_p
Specifies a symbolic constant indicating a GL capability.

DESCRIPTION

ggllEEnnaabbllee and ggllDDiissaabbllee enable and disable various capabilities. Use ggllIIssEEnnaabblleedd or ggllGGeett to determine the current setting of any capability. The initial value for each capability with the exception of GGLL__DDIITTHHEERR is GGLL__FFAALLSSEE. The initial value for GGLL__DDIITTHHEERR is GGLL__TTRRUUEE.

Both ggllEEnnaabbllee and ggllDDiissaabbllee take a single argument, _c_a_p, which can assume one of the following values:

GGLL__AALLPPHHAA__TTEESSTT
If enabled, do alpha testing. See ggllAAllpphhaaFFuunncc.
GGLL__AAUUTTOO__NNOORRMMAALL
If enabled, generate normal vectors when either GGLL__MMAAPP22__VVEERRTTEEXX__33 or GGLL__MMAAPP22__VVEERRTTEEXX__44 is used to generate vertices. See ggllMMaapp22.
GGLL__BBLLEENNDD
If enabled, blend the incoming RGBA color values with the values in the color buffers. See ggllBBlleennddFFuunncc.
GGLL__CCLLIIPP__PPLLAANNEE_i
If enabled, clip geometry against user-defined clipping plane _i. See ggllCClliippPPllaannee.
GGLL__CCOOLLOORR__LLOOGGIICC__OOPP
If enabled, apply the currently selected logical operation to the incoming RGBA color and color buffer values. See ggllLLooggiiccOOpp.
GGLL__CCOOLLOORR__MMAATTEERRIIAALL
If enabled, have one or more material parameters track the current color. See ggllCCoolloorrMMaatteerriiaall.
GGLL__CCOOLLOORR__TTAABBLLEE
If enabled, preform a color table lookup on the incoming RGBA color values. See ggllCCoolloorrTTaabbllee.
GGLL__CCOONNVVOOLLUUTTIIOONN__11DD
If enabled, perform a 1D convolution operation on incoming RGBA color values. See ggllCCoonnvvoolluuttiioonnFFiilltteerr11DD.
GGLL__CCOONNVVOOLLUUTTIIOONN__22DD
If enabled, perform a 2D convolution operation on incoming RGBA color values. See ggllCCoonnvvoolluuttiioonnFFiilltteerr22DD.
GGLL__CCUULLLL__FFAACCEE
If enabled, cull polygons based on their winding in window coordinates. See ggllCCuullllFFaaccee.
GGLL__DDEEPPTTHH__TTEESSTT
If enabled, do depth comparisons and update the depth buffer. Note that even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. See ggllDDeepptthhFFuunncc and
ggllDDeepptthhRRaannggee.
GGLL__DDIITTHHEERR
If enabled, dither color components or indices before they are written to the color buffer.
GGLL__FFOOGG
If enabled, blend a fog color into the posttexturing color. See ggllFFoogg.
GGLL__HHIISSTTOOGGRRAAMM
If enabled, histogram incoming RGBA color values. See ggllHHiissttooggrraamm.
GGLL__IINNDDEEXX__LLOOGGIICC__OOPP
If enabled, apply the currently selected logical operation to the incoming index and color buffer indices. See
ggllLLooggiiccOOpp.
GGLL__LLIIGGHHTT_i
If enabled, include light _i in the evaluation of the lighting equation. See ggllLLiigghhttMMooddeell and ggllLLiigghhtt.
GGLL__LLIIGGHHTTIINNGG
If enabled, use the current lighting parameters to compute the vertex color or index. Otherwise, simply associate the current color or index with each vertex. See
ggllMMaatteerriiaall, ggllLLiigghhttMMooddeell, and ggllLLiigghhtt.
GGLL__LLIINNEE__SSMMOOOOTTHH
If enabled, draw lines with correct filtering. Otherwise, draw aliased lines. See ggllLLiinneeWWiiddtthh.
GGLL__LLIINNEE__SSTTIIPPPPLLEE
If enabled, use the current line stipple pattern when drawing lines. See ggllLLiinneeSSttiippppllee.
GGLL__MMAAPP11__CCOOLLOORR__44
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate RGBA values. See ggllMMaapp11.
GGLL__MMAAPP11__IINNDDEEXX
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate color indices. See ggllMMaapp11.
GGLL__MMAAPP11__NNOORRMMAALL
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate normals. See ggllMMaapp11.
GGLL__MMAAPP11__TTEEXXTTUURREE__CCOOOORRDD__11
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate _s texture coordinates. See ggllMMaapp11.
GGLL__MMAAPP11__TTEEXXTTUURREE__CCOOOORRDD__22
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate _s and _t texture coordinates. See ggllMMaapp11.
GGLL__MMAAPP11__TTEEXXTTUURREE__CCOOOORRDD__33
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate _s, _t, and _r texture coordinates. See ggllMMaapp11.
GGLL__MMAAPP11__TTEEXXTTUURREE__CCOOOORRDD__44
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate _s, _t, _r, and _q texture coordinates. See ggllMMaapp11.
GGLL__MMAAPP11__VVEERRTTEEXX__33
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate _x, _y, and _z vertex coordinates. See ggllMMaapp11.
GGLL__MMAAPP11__VVEERRTTEEXX__44
If enabled, calls to ggllEEvvaallCCoooorrdd11, ggllEEvvaallMMeesshh11, and ggllEEvvaallPPooiinntt11 generate homogeneous _x, _y, _z, and _w vertex coordinates. See ggllMMaapp11.
GGLL__MMAAPP22__CCOOLLOORR__44
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate RGBA values. See ggllMMaapp22.
GGLL__MMAAPP22__IINNDDEEXX
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate color indices. See ggllMMaapp22.
GGLL__MMAAPP22__NNOORRMMAALL
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate normals. See ggllMMaapp22.
GGLL__MMAAPP22__TTEEXXTTUURREE__CCOOOORRDD__11
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate _s texture coordinates. See ggllMMaapp22.
GGLL__MMAAPP22__TTEEXXTTUURREE__CCOOOORRDD__22
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate _s and _t texture coordinates. See ggllMMaapp22.
GGLL__MMAAPP22__TTEEXXTTUURREE__CCOOOORRDD__33
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate _s, _t, and _r texture coordinates. See ggllMMaapp22.
GGLL__MMAAPP22__TTEEXXTTUURREE__CCOOOORRDD__44
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate _s, _t, _r, and _q texture coordinates. See ggllMMaapp22.
GGLL__MMAAPP22__VVEERRTTEEXX__33
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate _x, _y, and _z vertex coordinates. See ggllMMaapp22.
GGLL__MMAAPP22__VVEERRTTEEXX__44
If enabled, calls to ggllEEvvaallCCoooorrdd22, ggllEEvvaallMMeesshh22, and ggllEEvvaallPPooiinntt22 generate homogeneous _x, _y, _z, and _w vertex coordinates. See ggllMMaapp22.
GGLL__MMIINNMMAAXX
If enabled, compute the minimum and maximum values of incoming RGBA color values. See ggllMMiinnmmaaxx.
GGLL__NNOORRMMAALLIIZZEE
If enabled, normal vectors specified with ggllNNoorrmmaall are scaled to unit length after transformation. See ggllNNoorrmmaall.
GGLL__PPOOIINNTT__SSMMOOOOTTHH
If enabled, draw points with proper filtering. Otherwise, draw aliased points. See ggllPPooiinnttSSiizzee.
GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__FFIILLLL
If enabled, and if the polygon is rendered in GGLL__FFIILLLL mode, an offset is added to depth values of a polygon's fragments before the depth comparison is performed. See ggllPPoollyyggoonnOOffffsseett.
GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__LLIINNEE
If enabled, and if the polygon is rendered in GGLL__LLIINNEE mode, an offset is added to depth values of a polygon's fragments before the depth comparison is performed. See ggllPPoollyyggoonnOOffffsseett.
GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__PPOOIINNTT
If enabled, an offset is added to depth values of a polygon's fragments before the depth comparison is performed, if the polygon is rendered in GGLL__PPOOIINNTT mode. See ggllPPoollyyggoonnOOffffsseett.
GGLL__PPOOLLYYGGOONN__SSMMOOOOTTHH
If enabled, draw polygons with proper filtering. Otherwise, draw aliased polygons. For correct anti-aliased polygons, an alpha buffer is needed and the polygons must be sorted front to back.
GGLL__PPOOLLYYGGOONN__SSTTIIPPPPLLEE
If enabled, use the current polygon stipple pattern when rendering polygons. See ggllPPoollyyggoonnSSttiippppllee.
GGLL__PPOOSSTT__CCOOLLOORR__MMAATTRRIIXX__CCOOLLOORR__TTAABBLLEE
If enabled, preform a color table lookup on RGBA color values after color matrix transformation. See ggllCCoolloorrTTaabbllee.
GGLL__PPOOSSTT__CCOONNVVOOLLUUTTIIOONN__CCOOLLOORR__TTAABBLLEE
If enabled, preform a color table lookup on RGBA color values after convolution. See ggllCCoolloorrTTaabbllee.
GGLL__RREESSCCAALLEE__NNOORRMMAALL
If enabled, normal vectors specified with ggllNNoorrmmaall are scaled to unit length after transformation. See ggllNNoorrmmaall.
GGLL__SSEEPPAARRAABBLLEE__22DD
If enabled, perform a two-dimensional convolution operation using a separable convolution filter on incoming RGBA color values. See ggllSSeeppaarraabblleeFFiilltteerr22DD.
GGLL__SSCCIISSSSOORR__TTEESSTT
If enabled, discard fragments that are outside the scissor rectangle. See ggllSScciissssoorr.
GGLL__SSTTEENNCCIILL__TTEESSTT
If enabled, do stencil testing and update the stencil buffer. See ggllSStteenncciillFFuunncc and ggllSStteenncciillOOpp.
GGLL__TTEEXXTTUURREE__11DD
If enabled, one-dimensional texturing is performed (unless two- or three-dimensional texturing is also enabled). See ggllTTeexxIImmaaggee11DD.
GGLL__TTEEXXTTUURREE__22DD
If enabled, two-dimensional texturing is performed (unless three-dimensional texturing is also enabled). See ggllTTeexxIImmaaggee22DD.
GGLL__TTEEXXTTUURREE__33DD
If enabled, three-dimensional texturing is performed. See ggllTTeexxIImmaaggee33DD.
GGLL__TTEEXXTTUURREE__GGEENN__QQ
If enabled, the _q texture coordinate is computed using the texture generation function defined with ggllTTeexxGGeenn. Otherwise, the current _q texture coordinate is used. See ggllTTeexxGGeenn.
GGLL__TTEEXXTTUURREE__GGEENN__RR
If enabled, the _r texture coordinate is computed using the texture generation function defined with ggllTTeexxGGeenn. Otherwise, the current _r texture coordinate is used. See ggllTTeexxGGeenn.
GGLL__TTEEXXTTUURREE__GGEENN__SS
If enabled, the _s texture coordinate is computed using the texture generation function defined with ggllTTeexxGGeenn. Otherwise, the current _s texture coordinate is used. See ggllTTeexxGGeenn.
GGLL__TTEEXXTTUURREE__GGEENN__TT
If enabled, the _t texture coordinate is computed using the texture generation function defined with ggllTTeexxGGeenn. Otherwise, the current _t texture coordinate is used. See ggllTTeexxGGeenn.

NOTES

GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__FFIILLLL, GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__LLIINNEE, GGLL__PPOOLLYYGGOONN__OOFFFFSSEETT__PPOOIINNTT, GGLL__CCOOLLOORR__LLOOGGIICC__OOPP, and GGLL__IINNDDEEXX__LLOOGGIICC__OOPP are available only if the GL version is 1.1 or greater.

GGLL__RREESSCCAALLEE__NNOORRMMAALL, and GGLL__TTEEXXTTUURREE__33DD are available only if the GL version is 1.2 or greater.

GGLL__CCOOLLOORR__TTAABBLLEE, GGLL__CCOONNVVOOLLUUTTIIOONN__11DD, GGLL__CCOONNVVOOLLUUTTIIOONN__22DD, GGLL__HHIISSTTOOGGRRAAMM, GGLL__MMIINNMMAAXX, GGLL__PPOOSSTT__CCOOLLOORR__MMAATTRRIIXX__CCOOLLOORR__TTAABBLLEE, GGLL__PPOOSSTT__CCOONNVVOOLLUUTTIIOONN__CCOOLLOORR__TTAABBLLEE, and GGLL__SSEEPPAARRAABBLLEE__22DD are available only if GGLL__AARRBB__iimmaaggiinngg is returned from ggllGGeett with an argument of GGLL__EEXXTTEENNSSIIOONNSS.

If GGLL__AARRBB__mmuullttiitteexxttuurree is supported, GGLL__TTEEXXTTUURREE__11DD, GGLL__TTEEXXTTUURREE__22DD, GGLL__TTEEXXTTUURREE__33DD, GGLL__TTEEXXTTUURREE__GGEENN__SS, GGLL__TTEEXXTTUURREE__GGEENN__TT, GGLL__TTEEXXTTUURREE__GGEENN__RR, and GGLL__TTEEXXTTUURREE__GGEENN__QQ enable or disable the respective state for the active texture unit specified with ggllAAccttiivveeTTeexxttuurreeAARRBB.

ERRORS

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _c_a_p is not one of the values listed previously.

GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllEEnnaabbllee or ggllDDiissaabbllee is executed between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd.

SEE ALSO

ggllAAccttiivveeTTeexxttuurreeAARRBB((33GG)), ggllAAllpphhaaFFuunncc((33GG)), ggllBBlleennddFFuunncc((33GG)), ggllCClliippPPllaannee((33GG)), ggllCCoolloorrMMaatteerriiaall((33GG)), ggllCCuullllFFaaccee((33GG)), ggllDDeepptthhFFuunncc((33GG)), ggllDDeepptthhRRaannggee((33GG)), ggllEEnnaabblleeCClliieennttSSttaattee((33GG)), ggllFFoogg((33GG)), ggllGGeett((33GG)), ggllIIssEEnnaabblleedd((33GG)), ggllLLiigghhtt((33GG)), ggllLLiigghhttMMooddeell((33GG)), ggllLLiinneeWWiiddtthh((33GG)), ggllLLiinneeSSttiippppllee((33GG)), ggllLLooggiiccOOpp((33GG)), ggllMMaapp11((33GG)), ggllMMaapp22((33GG)), ggllMMaatteerriiaall((33GG)), ggllNNoorrmmaall((33GG)), ggllPPooiinnttSSiizzee((33GG)), ggllPPoollyyggoonnMMooddee((33GG)), ggllPPoollyyggoonnOOffffsseett((33GG)), ggllPPoollyyggoonnSSttiippppllee((33GG)), ggllSScciissssoorr((33GG)), ggllSStteenncciillFFuunncc((33GG)), ggllSStteenncciillOOpp((33GG)), ggllTTeexxGGeenn((33GG)), ggllTTeexxIImmaaggee11DD((33GG)), ggllTTeexxIImmaaggee22DD((33GG)), ggllTTeexxIImmaaggee33DD((33GG))