Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

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, either 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
                                          constant. 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 texture 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.   Floating-point  values  are
                                          returned  in  the  range [0, 1].  Integer values are returned as a
                                          linear mapping of the internal floating-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).

       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
                                          returned in params is GL_TRUE, the texture is resident in  texture
                                          memory.  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 between the execution  of  glBegin
       and the corresponding execution of glEnd.

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




                                                                                       GLGETTEXPARAMETER(3G)