MirOS Manual: glGetTexParameter(3), glGetTexParameterfv(3), glGetTexParameteriv(3)


GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(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 con-
                                        stant. 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

MirOS BSD #10-current  Printed 03.04.2017                       1

GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(3G)

                                        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 ini-
                                        tial 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

MirOS BSD #10-current  Printed 03.04.2017                       2

GLGETTEXPARAMETER(3G)UNIX Programmer's ManuaGLGETTEXPARAMETER(3G)

                                        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 tex-
                                        ture. 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)

MirOS BSD #10-current  Printed 03.04.2017                       3

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.