OpenSuSE Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
GLGETTEXPARAMETER(3G)                                    GLGETTEXPARAMETER(3G)

NAME
       glGetTexParameterfv,  glGetTexParameteriv  -  return  texture parameter
       values

C SPECIFICATION
       void glGetTexParameterfv( GLenum target,
                                 GLenum pname,
                                 GLfloat *params )
       void glGetTexParameteriv( GLenum target,
                                 GLenum pname,
                                 GLint *params )

PARAMETERS
       target  Specifies  the   symbolic   name   of   the   target   texture.
               GL_TEXTURE_1D,GL_TEXTURE_2D, and GL_TEXTURE_3D  are accepted.

       pname   Specifies   the   symbolic   name   of   a  texture  parameter.
               GL_TEXTURE_MAG_FILTER,                   GL_TEXTURE_MIN_FILTER,
               GL_TEXTURE_MIN_LOD,  GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL,
               GL_TEXTURE_MAX_LEVEL,   GL_TEXTURE_WRAP_S,   GL_TEXTURE_WRAP_T,
               GL_TEXTURE_WRAP_R,                     GL_TEXTURE_BORDER_COLOR,
               GL_TEXTURE_PRIORITY, and GL_TEXTURE_RESIDENT are accepted.

       params  Returns the texture parameters.

DESCRIPTION
       glGetTexParameter returns in params the value or values of the  texture
       parameter  specified  as pname.  target defines the target texture, ei-
       ther GL_TEXTURE_1D, GL_TEXTURE_2D, or GL_TEXTURE_3D  to  specify  one-,
       two-,  or  three-dimensional texturing.  pname accepts the same symbols
       as glTexParameter, with the same interpretations:

       GL_TEXTURE_MAG_FILTER              Returns  the  single-valued  texture
                                          magnification   filter,  a  symbolic
                                          constant.  The  initial   value   is
                                          GL_LINEAR.

       GL_TEXTURE_MIN_FILTER              Returns  the  single-valued  texture
                                          minification filter, a symbolic con-
                                          stant.    The   initial   value   is
                                          GL_NEAREST_MIPMAP_LINEAR.

       GL_TEXTURE_MIN_LOD                 Returns  the  single-valued  texture
                                          minimum  level-of-detail value.  The
                                          initial value is -1000.

       GL_TEXTURE_MAX_LOD                 Returns  the  single-valued  texture
                                          maximum  level-of-detail  value. The
                                          initial value is 1000.

       GL_TEXTURE_BASE_LEVEL              Returns the single-valued base  tex-
                                          ture   mipmap  level.   The  initial
                                          value is 0.

       GL_TEXTURE_MAX_LEVEL               Returns  the  single-valued  maximum
                                          texture  mipmap  array  level.   The
                                          initial value is 1000.

       GL_TEXTURE_WRAP_S                  Returns the  single-valued  wrapping
                                          function for texture coordinate s, a
                                          symbolic constant. The initial value
                                          is GL_REPEAT.

       GL_TEXTURE_WRAP_T                  Returns  the  single-valued wrapping
                                          function for texture coordinate t, a
                                          symbolic constant. The initial value
                                          is GL_REPEAT.

       GL_TEXTURE_WRAP_R                  Returns the  single-valued  wrapping
                                          function for texture coordinate r, a
                                          symbolic constant. The initial value
                                          is GL_REPEAT.

       GL_TEXTURE_BORDER_COLOR            Returns  four  integer  or floating-
                                          point numbers that comprise the RGBA
                                          color of the texture border.  Float-
                                          ing-point values are returned in the
                                          range  [0,  1].   Integer values are
                                          returned as a linear mapping of  the
                                          internal  floating-point representa-
                                          tion such that 1.0 maps to the  most
                                          positive  representable  integer and
                                          -1.0 maps to the most negative  rep-
                                          resentable   integer.   The  initial
                                          value is (0, 0, 0, 0).

       GL_TEXTURE_PRIORITY                Returns the  residence  priority  of
                                          the  target  texture  (or  the named
                                          texture bound to  it).  The  initial
                                          value        is        1.        See
                                          glPrioritizeTextures.

       GL_TEXTURE_RESIDENT                Returns the residence status of  the
                                          target  texture.   If  the value re-
                                          turned in  params  is  GL_TRUE,  the
                                          texture  is resident in texture mem-
                                          ory.  See glAreTexturesResident.

NOTES
       GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are available only  if  the
       GL version is 1.1 or greater.

       GL_TEXTURE_3D,          GL_TEXTURE_MIN_LOD,         GL_TEXTURE_MAX_LOD,
       GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R  are
       available only if the GL version is 1.2 or greater.

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

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

       GL_INVALID_OPERATION is generated if glGetTexParameter is executed  be-
       tween  the  execution  of  glBegin  and  the corresponding execution of
       glEnd.

SEE ALSO
       glAreTexturesResident(3G), glPrioritizeTextures(3G), glTexParameter(3G)

                                                         GLGETTEXPARAMETER(3G)

Want to link to this manual page? Use this URL:
<
http://star2.abcm.com/cgi-bin/bsdi-man?query=glGetTexParameter&sektion=3g&manpath=>

home | help