GLProgramming.com

home :: about :: development guides :: irc :: forums :: search :: paste :: links :: contribute :: code dump

-> Click here to learn how to get live help <-

Manpage of GLENABLE

GLENABLE

Index
 

NAME

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

 

C SPECIFICATION

void f3glEnablefP( GLenum fIcapfP ) 




 

PARAMETERS





f2capfP

Specifies a symbolic constant indicating a GL capability.


 

C SPECIFICATION


void f3glDisablefP(
GLenum fIcapfP )





 

PARAMETERS





f2capfP

Specifies a symbolic constant indicating a GL capability.


 

DESCRIPTION


%f3glEnablefP and %f3glDisablefP enable and disable various capabilities.
Use %f3glIsEnabledfP or %f3glGetfP to determine the current setting
of any capability. The initial value for each capability with the
exception of %f3GL_DITHERfP is %f3GL_FALSEfP. The initial value for
%f3GL_DITHERfP is %f3GL_TRUEfP. 

Both %f3glEnablefP and %f3glDisablefP take a single argument, f2capfP,
which can assume one of the following values:



%f3GL_ALPHA_TESTfP

If enabled,
do alpha testing. See
%f3glAlphaFuncfP.

%f3GL_AUTO_NORMALfP

If enabled,
generate normal vectors when either
%f3GL_MAP2_VERTEX_3fP or
%f3GL_MAP2_VERTEX_4fP is used to generate vertices. 
See %f3glMap2fP.

%f3GL_BLENDfP

If enabled,
blend the incoming RGBA color values with the values in the color
buffers. See %f3glBlendFuncfP.

%f3GL_CLIP_PLANEfPf2ifP

If enabled,
clip geometry against user-defined clipping plane f2ifP.
See %f3glClipPlanefP.

%f3GL_COLOR_LOGIC_OPfP

If enabled,
apply the currently selected logical operation to the incoming RGBA
color and color buffer values. See %f3glLogicOpfP.

%f3GL_COLOR_MATERIALfP

If enabled,
have one or more material parameters track the current color.
See %f3glColorMaterialfP.

%f3GL_COLOR_TABLEfP

If enabled,
preform a color table lookup on the incoming RGBA color values.
See %f3glColorTablefP.

%f3GL_CONVOLUTION_1DfP

If enabled,
perform a 1D convolution operation on incoming RGBA color values.
See %f3glConvolutionFilter1DfP.

%f3GL_CONVOLUTION_2DfP

If enabled,
perform a 2D convolution operation on incoming RGBA color values.
See %f3glConvolutionFilter2DfP.

%f3GL_CULL_FACEfP

If enabled,
cull polygons based on their winding in window coordinates. 
See %f3glCullFacefP.

%f3GL_DEPTH_TESTfP

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
%f3glDepthFuncfP and 



%f3glDepthRangefP. 

%f3GL_DITHERfP  

If enabled,

dither color components or indices before they are written to the
color buffer.

%f3GL_FOGfP

If enabled,
blend a fog color into the posttexturing color.
See %f3glFogfP.

%f3GL_HISTOGRAMfP

If enabled,
histogram incoming RGBA color values.
See %f3glHistogramfP.

%f3GL_INDEX_LOGIC_OPfP

If enabled,
apply the currently selected logical operation to the incoming index and color
buffer indices. See 



%f3glLogicOpfP.

%f3GL_LIGHTfPf2ifP

If enabled,
include light f2ifP in the evaluation of the lighting
equation. See %f3glLightModelfP and %f3glLightfP.

%f3GL_LIGHTINGfP

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 



%f3glMaterialfP, %f3glLightModelfP, and %f3glLightfP.

%f3GL_LINE_SMOOTHfP

If enabled,
draw lines with correct filtering.
Otherwise,
draw aliased lines.
See %f3glLineWidthfP.

%f3GL_LINE_STIPPLEfP

If enabled,
use the current line stipple pattern when drawing lines. See
%f3glLineStipplefP. 

%f3GL_MAP1_COLOR_4fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate RGBA values.
See %f3glMap1fP.

%f3GL_MAP1_INDEXfP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate color indices.
See %f3glMap1fP.

%f3GL_MAP1_NORMALfP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate normals.
See %f3glMap1fP.

%f3GL_MAP1_TEXTURE_COORD_1fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
f2sfP
texture coordinates.
See %f3glMap1fP.

%f3GL_MAP1_TEXTURE_COORD_2fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
f2sfP and
f2tfP texture coordinates.
See %f3glMap1fP.

%f3GL_MAP1_TEXTURE_COORD_3fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
f2sfP,
f2tfP, and
f2rfP texture coordinates.
See %f3glMap1fP.

%f3GL_MAP1_TEXTURE_COORD_4fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
f2sfP,
f2tfP,
f2rfP, and
f2qfP texture coordinates.
See %f3glMap1fP.

%f3GL_MAP1_VERTEX_3fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
f2xfP, f2yfP, and f2zfP vertex coordinates.
See %f3glMap1fP.

%f3GL_MAP1_VERTEX_4fP

If enabled,
calls to
%f3glEvalCoord1fP,
%f3glEvalMesh1fP, and
%f3glEvalPoint1fP generate
homogeneous
f2xfP,
f2yfP,
f2zfP, and
f2wfP vertex coordinates.
See %f3glMap1fP.

%f3GL_MAP2_COLOR_4fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate RGBA values.
See %f3glMap2fP.

%f3GL_MAP2_INDEXfP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate color indices.
See %f3glMap2fP.

%f3GL_MAP2_NORMALfP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate normals.
See %f3glMap2fP.

%f3GL_MAP2_TEXTURE_COORD_1fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
f2sfP
texture coordinates.
See %f3glMap2fP.

%f3GL_MAP2_TEXTURE_COORD_2fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
f2sfP and
f2tfP texture coordinates.
See %f3glMap2fP.

%f3GL_MAP2_TEXTURE_COORD_3fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
f2sfP,
f2tfP, and
f2rfP texture coordinates.
See %f3glMap2fP.

%f3GL_MAP2_TEXTURE_COORD_4fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
f2sfP,
f2tfP,
f2rfP, and
f2qfP texture coordinates.
See %f3glMap2fP.

%f3GL_MAP2_VERTEX_3fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
f2xfP, f2yfP, and f2zfP vertex coordinates.
See %f3glMap2fP.

%f3GL_MAP2_VERTEX_4fP

If enabled,
calls to
%f3glEvalCoord2fP,
%f3glEvalMesh2fP, and
%f3glEvalPoint2fP generate
homogeneous
f2xfP,
f2yfP,
f2zfP, and
f2wfP vertex coordinates.
See %f3glMap2fP.

%f3GL_MINMAXfP

If enabled,
compute the minimum and maximum values of incoming RGBA color values.
See %f3glMinmaxfP.

%f3GL_NORMALIZEfP

If enabled,
normal vectors specified with %f3glNormalfP are scaled to unit length
after transformation. See %f3glNormalfP.

%f3GL_POINT_SMOOTHfP

If enabled,
draw points with proper filtering.
Otherwise,
draw aliased points.
See %f3glPointSizefP.

%f3GL_POLYGON_OFFSET_FILLfP

If enabled, and if the polygon is rendered in
%f3GL_FILLfP mode, an offset is added to depth values of a polygon's
fragments before the depth comparison is performed. 
See %f3glPolygonOffsetfP. 

%f3GL_POLYGON_OFFSET_LINEfP

If enabled, and if the polygon is rendered in
%f3GL_LINEfP mode, an offset is added to depth values of a polygon's
fragments before the depth comparison is performed. See %f3glPolygonOffsetfP. 

%f3GL_POLYGON_OFFSET_POINTfP

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 
%f3GL_POINTfP mode. See %f3glPolygonOffsetfP. 

%f3GL_POLYGON_SMOOTHfP

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. 

%f3GL_POLYGON_STIPPLEfP

If enabled,
use the current polygon stipple pattern when rendering
polygons. See %f3glPolygonStipplefP.

%f3GL_POST_COLOR_MATRIX_COLOR_TABLEfP

If enabled,
preform a color table lookup on RGBA color values after color matrix 
transformation.
See %f3glColorTablefP.

%f3GL_POST_CONVOLUTION_COLOR_TABLEfP

If enabled,
preform a color table lookup on RGBA color values after convolution.
See %f3glColorTablefP.

%f3GL_RESCALE_NORMALfP

If enabled, normal vectors specified with %f3glNormalfP are scaled to
unit length after transformation. See %f3glNormalfP.

%f3GL_SEPARABLE_2DfP

If enabled, perform a two-dimensional convolution operation using a separable
convolution filter on incoming RGBA color values.
See %f3glSeparableFilter2DfP.

%f3GL_SCISSOR_TESTfP

If enabled,
discard fragments that are outside the scissor rectangle. 
See %f3glScissorfP.

%f3GL_STENCIL_TESTfP

If enabled,
do stencil testing and update the stencil buffer. 
See %f3glStencilFuncfP and %f3glStencilOpfP.

%f3GL_TEXTURE_1DfP

If enabled, one-dimensional texturing is performed
(unless two- or three-dimensional texturing is also enabled).
See %f3glTexImage1DfP.

%f3GL_TEXTURE_2DfP

If enabled, two-dimensional texturing is performed
(unless three-dimensional texturing is also enabled). See %f3glTexImage2DfP.

%f3GL_TEXTURE_3DfP

If enabled, three-dimensional texturing is performed. See %f3glTexImage3DfP.

%f3GL_TEXTURE_GEN_QfP

If enabled,
the f2qfP texture coordinate is computed using
the texture generation function defined with %f3glTexGenfP.
Otherwise, the current f2qfP texture coordinate is used.
See %f3glTexGenfP.

%f3GL_TEXTURE_GEN_RfP

If enabled,
the f2rfP texture coordinate is computed using
the texture generation function defined with %f3glTexGenfP.
Otherwise, the current f2rfP texture coordinate is used.
See %f3glTexGenfP.

%f3GL_TEXTURE_GEN_SfP

If enabled,
the f2sfP texture coordinate is computed using
the texture generation function defined with %f3glTexGenfP.
Otherwise, the current f2sfP texture coordinate is used. 
See %f3glTexGenfP.

%f3GL_TEXTURE_GEN_TfP

If enabled,
the f2tfP texture coordinate is computed using
the texture generation function defined with %f3glTexGenfP.
Otherwise, the current f2tfP texture coordinate is used.
See %f3glTexGenfP.


 

NOTES


%f3GL_POLYGON_OFFSET_FILLfP, %f3GL_POLYGON_OFFSET_LINEfP,
%f3GL_POLYGON_OFFSET_POINTfP,
%f3GL_COLOR_LOGIC_OPfP, and %f3GL_INDEX_LOGIC_OPfP are available
only if the GL version is 1.1 or greater. 

%f3GL_RESCALE_NORMALfP, and %f3GL_TEXTURE_3DfP are available only if the
GL version is 1.2 or greater.

%f3GL_COLOR_TABLEfP, %f3GL_CONVOLUTION_1DfP, %f3GL_CONVOLUTION_2DfP,
%f3GL_HISTOGRAMfP, %f3GL_MINMAXfP,
%f3GL_POST_COLOR_MATRIX_COLOR_TABLEfP,
%f3GL_POST_CONVOLUTION_COLOR_TABLEfP, and
%f3GL_SEPARABLE_2DfP are available only if %f3GL_ARB_imagingfP is returned
from %f3glGetfP with an argument of %f3GL_EXTENSIONSfP.

If %f3GL_ARB_multitexturefP is supported, %f3GL_TEXTURE_1DfP,
%f3GL_TEXTURE_2DfP, %f3GL_TEXTURE_3DfP, %f3GL_TEXTURE_GEN_SfP,
%f3GL_TEXTURE_GEN_TfP, %f3GL_TEXTURE_GEN_RfP, and %f3GL_TEXTURE_GEN_QfP
enable or disable the respective state for the active texture unit
specified with %f3glActiveTextureARBfP.
 

ERRORS


%f3GL_INVALID_ENUMfP is generated if f2capfP is not one of the values
listed previously.

%f3GL_INVALID_OPERATIONfP is generated if %f3glEnablefP or %f3glDisablefP
is executed between the execution of %f3glBeginfP
and the corresponding execution of %f3glEndfP.
 

SEE ALSO


%f3glActiveTextureARB(3G)fP,
%f3glAlphaFunc(3G)fP,
%f3glBlendFunc(3G)fP,
%f3glClipPlane(3G)fP,
%f3glColorMaterial(3G)fP,
%f3glCullFace(3G)fP,
%f3glDepthFunc(3G)fP,
%f3glDepthRange(3G)fP,
%f3glEnableClientState(3G)fP,
%f3glFog(3G)fP,
%f3glGet(3G)fP,
%f3glIsEnabled(3G)fP,
%f3glLight(3G)fP,
%f3glLightModel(3G)fP,
%f3glLineWidth(3G)fP,
%f3glLineStipple(3G)fP,
%f3glLogicOp(3G)fP,
%f3glMap1(3G)fP,
%f3glMap2(3G)fP,
%f3glMaterial(3G)fP,
%f3glNormal(3G)fP,
%f3glPointSize(3G)fP,
%f3glPolygonMode(3G)fP,
%f3glPolygonOffset(3G)fP,
%f3glPolygonStipple(3G)fP,
%f3glScissor(3G)fP,
%f3glStencilFunc(3G)fP,
%f3glStencilOp(3G)fP,
%f3glTexGen(3G)fP,
%f3glTexImage1D(3G)fP,
%f3glTexImage2D(3G)fP,
%f3glTexImage3D(3G)fP







 
Index




NAME


C SPECIFICATION


PARAMETERS


C SPECIFICATION


PARAMETERS


DESCRIPTION


NOTES


ERRORS


SEE ALSO