This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

GLGETTEXENV(3G)                                                                              GLGETTEXENV(3G)



NAME
       glGetTexEnvfv, glGetTexEnviv - return texture environment parameters


C SPECIFICATION
       void glGetTexEnvfv( GLenum target,
                           GLenum pname,
                           GLfloat *params )
       void glGetTexEnviv( GLenum target,
                           GLenum pname,
                           GLint *params )


PARAMETERS
       target  Specifies a texture environment.  Must be GL_TEXTURE_ENV.

       pname   Specifies  the  symbolic  name  of  a  texture  environment  parameter.   Accepted values are
               GL_TEXTURE_ENV_MODE and GL_TEXTURE_ENV_COLOR.

       params  Returns the requested data.

DESCRIPTION
       glGetTexEnv returns in params selected values of  a  texture  environment  that  was  specified  with
       glTexEnv.   target  specifies  a  texture  environment.   Currently,  only one texture environment is
       defined and supported: GL_TEXTURE_ENV.

       pname names a specific texture environment parameter, as follows:

       GL_TEXTURE_ENV_MODE
                 params returns the single-valued texture environment mode, a symbolic constant. The initial
                 value is GL_MODULATE.

       GL_TEXTURE_ENV_COLOR
                 params  returns  four  integer  or  floating-point  values that are the texture environment
                 color.  Integer values, when requested, are linearly mapped  from  the  internal  floating-point floatingpoint
                 point  representation  such  that  1.0 maps to the most positive representable integer, and
                 -1.0 maps to the most negative representable integer. The initial value is (0, 0, 0, 0).

NOTES
       If an error is generated, no change is made to the contents of params.

       When the GL_ARB_multitexture extension is supported,  glGetTexEnv  returns  the  texture  environment
       parameters for the active texture unit.

ERRORS
       GL_INVALID_ENUM is generated if target or pname is not an accepted value.

       GL_INVALID_OPERATION is generated if glGetTexEnv is executed between the execution of glBegin and the
       corresponding execution of glEnd.

SEE ALSO
       glActiveTextureARB(3G), glTexEnv(3G)




                                                                                             GLGETTEXENV(3G)