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))