glGetTexLevelParameter.3gl

Name

  glGetTexLevelParameterfv, glGetTexLevelParameteriv - return texture

  parameter values for a specific level	of detail

C Specification

  void glGetTexLevelParameterfv( GLenum	target,

				 GLint level,

				 GLenum	pname,

				 GLfloat *params )

  void glGetTexLevelParameteriv( GLenum	target,

				 GLint level,

				 GLenum	pname,

				 GLint *params )

Parameters

  target  Specifies the	symbolic name of the target texture, either

	  GL_TEXTURE_1D	or GL_TEXTURE_2D.



  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_COMPONENTS, and

	  GL_TEXTURE_BORDER are	accepted.



  params  Returns the requested	data.

Description

  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 or GL_TEXTURE_2D, to specify one- or

  two-dimensional texturing.  pname specifies the texture parameter whose

  value	or values will be returned.



  The accepted parameter names are as follows:



  GL_TEXTURE_WIDTH

	    params returns a single value, the width of	the texture image.

	    This value includes	the border of the texture image.



  GL_TEXTURE_HEIGHT

	    params returns a single value, the height of the texture image.

	    This value includes	the border of the texture image.



  GL_TEXTURE_COMPONENTS

	    params returns a single value, the number of components in the

	    texture image.



  GL_TEXTURE_BORDER

	    params returns a single value, the width in	pixels of the border

	    of the texture image.

Notes

  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_VALUE is generated	if level is less than zero or greater than

  log max, where max is	the returned value of GL_MAX_TEXTURE_SIZE.

     2

  GL_INVALID_OPERATION is generated if glGetTexLevelParameter is called

  between a call to glBegin and	the corresponding call to glEnd.

See Also

  glGetTexParameter, glTexImage1D, glTexImage2D, glTexParameter

Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV