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