fglGetTexLevelParameteriv man page on IRIX

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



fglGetTexLevelParameter(3G)    OpenGL Reference	   fglGetTexLevelParameter(3G)

NAME
     fglGetTexLevelParameterfv, fglGetTexLevelParameteriv - return texture
     parameter values for a specific level of detail

FORTRAN SPECIFICATION
     SUBROUTINE fglGetTexLevelParameterfv( INTEGER*4 target,
					   INTEGER*4 level,
					   INTEGER*4 pname,
					   CHARACTER*8 params )
     SUBROUTINE fglGetTexLevelParameteriv( INTEGER*4 target,
					   INTEGER*4 level,
					   INTEGER*4 pname,
					   CHARACTER*8 params )

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, 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
     fglGetTexLevelParameter 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 fglGetTexLevelParameter, 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

fglGetTexLevelParameter(3G)    OpenGL Reference	   fglGetTexLevelParameter(3G)

     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 format 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
	       fglTexImage1D, fglTexImage2D, fglTexImage3D, fglCopyTexImage1D,
	       and fglCopyTexImage2D. 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.

									Page 2

fglGetTexLevelParameter(3G)    OpenGL Reference	   fglGetTexLevelParameter(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
     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 fglGetTexLevelParameter is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.

SEE ALSO
     fglGetTexParameter, fglCopyTexImage1D, fglCopyTexImage2D,
     fglCopyTexSubImage1D, fglCopyTexSubImage2D, fglCopyTexSubImage3D,
     fglTexEnv, fglTexGen, fglTexImage1D, fglTexImage2D, fglTexImage3D,
     fglTexSubImage1D, fglTexSubImage2D, fglTexSubImage3D, fglTexParameter

									Page 3

[top]

List of man pages available for IRIX

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