glGetTexLevelParameter(3G)     OpenGL Reference	    glGetTexLevelParameter(3G)

NAME    [Toc]    [Back]

     glGetTexLevelParameterfv, glGetTexLevelParameteriv	- return texture
     parameter values for a specific level of detail

C SPECIFICATION    [Toc]    [Back]

     void glGetTexLevelParameterfv( GLenum target,
				    GLint level,
				    GLenum pname,
				    GLfloat *params )
     void glGetTexLevelParameteriv( GLenum target,
				    GLint level,
				    GLenum pname,
				    GLint *params )

PARAMETERS    [Toc]    [Back]

     target  Specifies the symbolic name of the	target texture,	either
	     GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_PROXY_TEXTURE_1D,
	     GL_PROXY_TEXTURE_2D, GL_PROXY_TEXTURE_3D, or
	     GL_DETAIL_TEXTURE_2D_SGIS.

     level   Specifies the level-of-detail number of the desired image.	 Level
	     0 is the base image level.	 Level n is the	nth mipmap reduction
	     image.

     pname   Specifies the symbolic name of a texture parameter.
	     GL_TEXTURE_WIDTH, GL_TEXTURE_HEIGHT, GL_TEXTURE_DEPTH,
	     GL_TEXTURE_INTERNAL_FORMAT, GL_TEXTURE_BORDER,
	     GL_TEXTURE_RED_SIZE, GL_TEXTURE_GREEN_SIZE, GL_TEXTURE_BLUE_SIZE,
	     GL_TEXTURE_ALPHA_SIZE, GL_TEXTURE_LUMINANCE_SIZE, and
	     GL_TEXTURE_INTENSITY_SIZE are accepted.

     params  Returns the requested data.

DESCRIPTION    [Toc]    [Back]

     glGetTexLevelParameter returns in params texture parameter	values for a
     specific level-of-detail value, specified as level.  target defines the
     target texture, either GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D,
     GL_PROXY_TEXTURE_1D, GL_PROXY_TEXTURE_2D, GL_PROXY_TEXTURE_3D, or
     GL_DETAIL_TEXTURE_2D_SGIS.

     GL_MAX_TEXTURE_SIZE, and GL_MAX_3D_TEXTURE_SIZE are not really
     descriptive enough.  It has to report the largest square texture image
     that can be accommodated with mipmaps and borders,	but a long skinny
     texture, or a texture without mipmaps and borders,	may easily fit in
     texture memory. The proxy targets allow the user to more accurately query
     whether the GL can	accommodate a texture of a given configuration.	 If
     the texture cannot	be accommodated, the texture state variables, which
     may be queried with glGetTexLevelParameter, are set to 0.	If the texture
     can be accommodated, the texture state values will	be set as they would
     be	set for	a non-proxy target.



									Page 1






glGetTexLevelParameter(3G)     OpenGL Reference	    glGetTexLevelParameter(3G)



     pname specifies the texture parameter whose value or values will be
     returned.

     The accepted parameter names are as follows:

     GL_TEXTURE_WIDTH    [Toc]    [Back]
	       params returns a	single value, the width	of the texture image.
	       This value includes the border of the texture image. The
	       initial value is	0.

     GL_TEXTURE_HEIGHT    [Toc]    [Back]
	       params returns a	single value, the height of the	texture	image.
	       This value includes the border of the texture image. The
	       initial value is	0.

     GL_TEXTURE_DEPTH    [Toc]    [Back]
	       params returns a	single value, the depth	of the texture image.
	       This value includes the border of the texture image. The
	       initial value is	0.

     GL_TEXTURE_INTERNAL_FORMAT    [Toc]    [Back]
	       params returns a	single value, the internal format of the
	       texture image.

     GL_TEXTURE_BORDER    [Toc]    [Back]
	       params returns a	single value, the width	in pixels of the
	       border of the texture image. The	initial	value is 0.

     GL_TEXTURE_RED_SIZE,

     GL_TEXTURE_GREEN_SIZE,

     GL_TEXTURE_BLUE_SIZE,

     GL_TEXTURE_ALPHA_SIZE,

     GL_TEXTURE_LUMINANCE_SIZE,

     GL_TEXTURE_INTENSITY_SIZE    [Toc]    [Back]
	       The internal storage resolution of an individual	component.
	       The resolution chosen by	the GL will be a close match for the
	       resolution requested by the user	with the component argument of
	       glTexImage1D, glTexImage2D, glTexImage3D, glCopyTexImage1D, and
	       glCopyTexImage2D. The initial value is 0.

NOTES    [Toc]    [Back]

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

     GL_TEXTURE_INTERNAL_FORMAT	is available only if the GL version is 1.1 or
     greater. In version 1.0, use GL_TEXTURE_COMPONENTS	instead.





									Page 2






glGetTexLevelParameter(3G)     OpenGL Reference	    glGetTexLevelParameter(3G)



     GL_PROXY_TEXTURE_1D and GL_PROXY_TEXTURE_2D are available only if the GL
     version is	1.1 or greater.

     GL_TEXTURE_3D, GL_PROXY_TEXTURE_3D, and GL_TEXTURE_DEPTH are available
     only if the GL version is 1.2 or greater.

ERRORS    [Toc]    [Back]

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

     GL_INVALID_VALUE is generated if level is less than 0.

     GL_INVALID_VALUE may be generated if level	is greater than	log  max,
								   2
     where max is the returned value of	GL_MAX_TEXTURE_SIZE.

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

SEE ALSO    [Toc]    [Back]

     glGetTexParameter,	glCopyTexImage1D, glCopyTexImage2D,
     glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D, glTexEnv,
     glTexGen, glTexImage1D, glTexImage2D, glTexImage3D, glTexSubImage1D,
     glTexSubImage2D, glTexSubImage3D, glTexParameter


									PPPPaaaaggggeeee 3333