glGetTexLevelParameteriv man page on OpenBSD

Man page or keyword search:  
man Server   11362 pages
apropos Keyword Search (all sections)
Output format
OpenBSD logo
[printable version]

GLGETTEXLEVELPARAMETER(3G)			    GLGETTEXLEVELPARAMETER(3G)

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 )

       delim $$

PARAMETERS
       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, or
	      GL_PROXY_TEXTURE_3D.

       level  Specifies the level-of-detail number of the desired image.
	      Level 0 is the base image level.	Level $n$ is the $n$th 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
       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, or GL_PROXY_TEXTURE_3D.

       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.

       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.
		 The initial value is 0.

       GL_TEXTURE_HEIGHT
		 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
		 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
		 params returns a single value, the internal  of the texture
		 image.

       GL_TEXTURE_BORDER
		 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
		 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
       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.

       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.

       When the GL_ARB_multitexture extension is supported,
       glGetTexLevelParameter returns the texture level parameters for the
       active texture unit.

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 0.

       GL_INVALID_VALUE may be generated if level is greater than $ log sub 2$
       max, 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
       glActiveTextureARB(3G), glGetTexParameter(3G), glCopyTexImage1D(3G),
       glCopyTexImage2D(3G), glCopyTexSubImage1D(3G), glCopyTexSubImage2D(3G),
       glCopyTexSubImage3D(3G), glTexEnv(3G), glTexGen(3G), glTexImage1D(3G),
       glTexImage2D(3G), glTexImage3D(3G), glTexSubImage1D(3G),
       glTexSubImage2D(3G), glTexSubImage3D(3G), glTexParameter(3G)

								 March 1, 2011
[top]

List of man pages available for OpenBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net