Difference between pages "GlGetTexLevelParameter" and "GlGetTexParameter"

From QB64 Wiki
(Difference between pages)
Jump to navigation Jump to search
imported>Galleon
(Created page with ''''_glGetTexLevelParameter:''' return texture parameter values for a specific level of detail {{PageSyntax}} SUB _glGetTexLevelParameterfv (BYVAL target AS _UNSIGNED LONG, B…')
 
imported>Galleon
(Created page with ''''_glGetTexParameter:''' return texture parameter values {{PageSyntax}} SUB _glGetTexParameterfv (BYVAL target AS _UNSIGNED LONG, BYVAL pname AS _UNSIGNED LONG, params AS S…')
 
Line 1: Line 1:
'''_glGetTexLevelParameter:''' return texture parameter values for a specific level of detail
+
'''_glGetTexParameter:''' return texture parameter values
  
  
 
{{PageSyntax}}
 
{{PageSyntax}}
  
   SUB _glGetTexLevelParameterfv (BYVAL target AS _UNSIGNED LONG, BYVAL level AS LONG, BYVAL pname AS _UNSIGNED LONG, params AS SINGLE)
+
   SUB _glGetTexParameterfv (BYVAL target AS _UNSIGNED LONG, BYVAL pname AS _UNSIGNED LONG, params AS SINGLE)
   void '''_glGetTexLevelParameterfv'''(GLenum {{Parameter|target}}, GLint {{Parameter|level}}, GLenum {{Parameter|pname}}, GLfloat * {{Parameter|params}});
+
   void '''_glGetTexParameterfv'''(GLenum {{Parameter|target}}, GLenum {{Parameter|pname}}, GLfloat * {{Parameter|params}});
  
   SUB _glGetTexLevelParameteriv (BYVAL target AS _UNSIGNED LONG, BYVAL level AS LONG, BYVAL pname AS _UNSIGNED LONG, params AS LONG)
+
   SUB _glGetTexParameteriv (BYVAL target AS _UNSIGNED LONG, BYVAL pname AS _UNSIGNED LONG, params AS LONG)
   void '''_glGetTexLevelParameteriv'''(GLenum {{Parameter|target}}, GLint {{Parameter|level}}, GLenum {{Parameter|pname}}, GLint * {{Parameter|params}});
+
   void '''_glGetTexParameteriv'''(GLenum {{Parameter|target}}, GLenum {{Parameter|pname}}, GLint * {{Parameter|params}});
  
 +
  void '''_glGetTexParameterIiv'''(GLenum {{Parameter|target}}, GLenum {{Parameter|pname}}, GLint * {{Parameter|params}});
 +
  void '''_glGetTexParameterIuiv'''(GLenum {{Parameter|target}}, GLenum {{Parameter|pname}}, GLuint * {{Parameter|params}});
  
 
; target
 
; target
: Specifies the symbolic name of the target texture, one of {{KW|_GL_TEXTURE_1D}}, {{KW|_GL_TEXTURE_2D}}, {{KW|_GL_TEXTURE_3D}}, {{KW|_GL_TEXTURE_1D_ARRAY}}, {{KW|_GL_TEXTURE_2D_ARRAY}}, {{KW|_GL_TEXTURE_RECTANGLE}}, {{KW|_GL_TEXTURE_2D_MULTISAMPLE}}, {{KW|_GL_TEXTURE_2D_MULTISAMPLE_ARRAY}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_X}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_X}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_Y}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_Y}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_Z}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}}, {{KW|_GL_PROXY_TEXTURE_1D}}, {{KW|_GL_PROXY_TEXTURE_2D}}, {{KW|_GL_PROXY_TEXTURE_3D}}, {{KW|_GL_PROXY_TEXTURE_1D_ARRAY}}, {{KW|_GL_PROXY_TEXTURE_2D_ARRAY}}, {{KW|_GL_PROXY_TEXTURE_RECTANGLE}}, {{KW|_GL_PROXY_TEXTURE_2D_MULTISAMPLE}}, {{KW|_GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY}}, {{KW|_GL_PROXY_TEXTURE_CUBE_MAP}}, or {{KW|_GL_TEXTURE_BUFFER}}.
+
: Specifies the symbolic name of the target texture. {{KW|_GL_TEXTURE_1D}}, {{KW|_GL_TEXTURE_2D}}, {{KW|_GL_TEXTURE_1D_ARRAY}}, {{KW|_GL_TEXTURE_2D_ARRAY}}, {{KW|_GL_TEXTURE_3D}}, {{KW|_GL_TEXTURE_RECTANGLE}}, {{KW|_GL_TEXTURE_CUBE_MAP}}, and {{KW|_GL_TEXTURE_CUBE_MAP_ARRAY}} are accepted.
; 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
 
; pname
: Specifies the symbolic name of a texture parameter. {{KW|_GL_TEXTURE_WIDTH}}, {{KW|_GL_TEXTURE_HEIGHT}}, {{KW|_GL_TEXTURE_DEPTH}}, {{KW|_GL_TEXTURE_INTERNAL_FORMAT}}, {{KW|_GL_TEXTURE_BORDER}}, {{KW|_GL_TEXTURE_RED_SIZE}}, {{KW|_GL_TEXTURE_GREEN_SIZE}}, {{KW|_GL_TEXTURE_BLUE_SIZE}}, {{KW|_GL_TEXTURE_ALPHA_SIZE}}, {{KW|_GL_TEXTURE_DEPTH_SIZE}}, {{KW|_GL_TEXTURE_COMPRESSED}}, {{KW|_GL_TEXTURE_COMPRESSED_IMAGE_SIZE}}, and {{KW|_GL_TEXTURE_BUFFER_OFFSET}} are accepted.
+
: Specifies the symbolic name of a texture parameter. {{KW|_GL_DEPTH_STENCIL_TEXTURE_MODE}}, {{KW|_GL_TEXTURE_BASE_LEVEL}}, {{KW|_GL_TEXTURE_BORDER_COLOR}}, {{KW|_GL_TEXTURE_COMPARE_MODE}}, {{KW|_GL_TEXTURE_COMPARE_FUNC}}, {{KW|_GL_TEXTURE_IMMUTABLE_FORMAT}}, {{KW|_GL_TEXTURE_IMMUTABLE_LEVELS}}, {{KW|_GL_TEXTURE_LOD_BIAS}}, {{KW|_GL_TEXTURE_MAG_FILTER}}, {{KW|_GL_TEXTURE_MAX_LEVEL}}, {{KW|_GL_TEXTURE_MAX_LOD}}, {{KW|_GL_TEXTURE_MIN_FILTER}}, {{KW|_GL_TEXTURE_MIN_LOD}}, {{KW|_GL_TEXTURE_SWIZZLE_R}}, {{KW|_GL_TEXTURE_SWIZZLE_G}}, {{KW|_GL_TEXTURE_SWIZZLE_B}}, {{KW|_GL_TEXTURE_SWIZZLE_A}}, {{KW|_GL_TEXTURE_SWIZZLE_RGBA}}, {{KW|_GL_TEXTURE_VIEW_MIN_LAYER}}, {{KW|_GL_TEXTURE_VIEW_MIN_LEVEL}}, {{KW|_GL_TEXTURE_VIEW_NUM_LAYERS}}, {{KW|_GL_TEXTURE_VIEW_NUM_LEVELS}}, {{KW|_GL_TEXTURE_WRAP_S}}, {{KW|_GL_TEXTURE_WRAP_T}}, and {{KW|_GL_TEXTURE_WRAP_R}} are accepted.
 
; params
 
; params
: Returns the requested data.
+
: Returns the texture parameters.
  
  
 
{{PageDescription}}
 
{{PageDescription}}
  
'''_glGetTexLevelParameter''' returns in {{Parameter|params}} texture parameter values for a specific level-of-detail value, specified as {{Parameter|level}}. {{Parameter|target}} defines the target texture, either {{KW|_GL_TEXTURE_1D}}, {{KW|_GL_TEXTURE_2D}}, {{KW|_GL_TEXTURE_3D}}, {{KW|_GL_PROXY_TEXTURE_1D}}, {{KW|_GL_PROXY_TEXTURE_2D}}, {{KW|_GL_PROXY_TEXTURE_3D}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_X}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_X}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_Y}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_Y}}, {{KW|_GL_TEXTURE_CUBE_MAP_POSITIVE_Z}}, {{KW|_GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}}, or {{KW|_GL_PROXY_TEXTURE_CUBE_MAP}}.
+
'''_glGetTexParameter''' returns in {{Parameter|params}} the value or values of the texture parameter specified as {{Parameter|pname}}. {{Parameter|target}} defines the target texture. {{KW|_GL_TEXTURE_1D}}, {{KW|_GL_TEXTURE_2D}}, {{KW|_GL_TEXTURE_3D}}, {{KW|_GL_TEXTURE_1D_ARRAY}}, {{KW|_GL_TEXTURE_2D_ARRAY}}, {{KW|_GL_TEXTURE_RECTANGLE}}, {{KW|_GL_TEXTURE_CUBE_MAP}}, {{KW|_GL_TEXTURE_CUBE_MAP_ARRAY}} specify one-, two-, or three-dimensional, one-dimensional array, two-dimensional array, rectangle, cube-mapped or cube-mapped array texturing, respectively. {{Parameter|pname}} accepts the same symbols as {{KW|_glTexParameter}}, with the same interpretations:
  
{{KW|_GL_MAX_TEXTURE_SIZE}}, and {{KW|_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.
+
; {{KW|_GL_DEPTH_STENCIL_TEXTURE_MODE}}
 +
: Returns the single-value depth stencil texture mode, a symbolic constant. The initial value is {{KW|_GL_DEPTH_COMPONENT}}.
 +
; {{KW|_GL_TEXTURE_MAG_FILTER}}
 +
: Returns the single-valued texture magnification filter, a symbolic constant. The initial value is {{KW|_GL_LINEAR}}.
 +
; {{KW|_GL_TEXTURE_MIN_FILTER}}
 +
: Returns the single-valued texture minification filter, a symbolic constant. The initial value is {{KW|_GL_NEAREST_MIPMAP_LINEAR}}.
 +
; {{KW|_GL_TEXTURE_MIN_LOD}}
 +
; {{KW|_GL_TEXTURE_MAX_LOD}}
 +
: Returns the single-valued texture maximum level-of-detail value. The initial value is 1000.
 +
; {{KW|_GL_TEXTURE_BASE_LEVEL}}
 +
: Returns the single-valued base texture mipmap level. The initial value is 0.
 +
; {{KW|_GL_TEXTURE_MAX_LEVEL}}
 +
: Returns the single-valued maximum texture mipmap array level. The initial value is 1000.
 +
; {{KW|_GL_TEXTURE_SWIZZLE_R}}
 +
: Returns the red component swizzle. The initial value is {{KW|_GL_RED}}.
 +
; {{KW|_GL_TEXTURE_SWIZZLE_G}}
 +
: Returns the green component swizzle. The initial value is {{KW|_GL_GREEN}}.
 +
; {{KW|_GL_TEXTURE_SWIZZLE_B}}
 +
: Returns the blue component swizzle. The initial value is {{KW|_GL_BLUE}}.
 +
; {{KW|_GL_TEXTURE_SWIZZLE_A}}
 +
: Returns the alpha component swizzle. The initial value is {{KW|_GL_ALPHA}}.
 +
; {{KW|_GL_TEXTURE_SWIZZLE_RGBA}}
 +
: Returns the component swizzle for all channels in a single query.
 +
; {{KW|_GL_TEXTURE_WRAP_S}}
 +
: Returns the single-valued wrapping function for texture coordinate ''s'', a symbolic constant. The initial value is {{KW|_GL_REPEAT}}.
 +
; {{KW|_GL_TEXTURE_WRAP_T}}
 +
: Returns the single-valued wrapping function for texture coordinate ''t'', a symbolic constant. The initial value is {{KW|_GL_REPEAT}}.
 +
; {{KW|_GL_TEXTURE_WRAP_R}}
 +
: Returns the single-valued wrapping function for texture coordinate ''r'', a symbolic constant. The initial value is {{KW|_GL_REPEAT}}.
 +
; {{KW|_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 positive representable integer and -1.0 maps to the most negative representable integer. The initial value is (0, 0, 0, 0).
 +
; {{KW|_GL_TEXTURE_COMPARE_MODE}}
 +
: Returns a single-valued texture comparison mode, a symbolic constant. The initial value is {{KW|_GL_NONE}}. See {{KW|_glTexParameter}}.
 +
; {{KW|_GL_TEXTURE_COMPARE_FUNC}}
 +
: Returns a single-valued texture comparison function, a symbolic constant. The initial value is {{KW|_GL_LEQUAL}}. See {{KW|_glTexParameter}}.
 +
; {{KW|_GL_TEXTURE_VIEW_MIN_LEVEL}}
 +
: Returns a single-valued base level of a texture view relative to its parent. The initial value is 0. See {{KW|_glTextureView}}.
 +
; {{KW|_GL_TEXTURE_VIEW_NUM_LEVELS}}
 +
: Returns a single-valued number of levels of detail of a texture view. See {{KW|_glTextureView}}.
 +
; {{KW|_GL_TEXTURE_VIEW_MIN_LAYER}}
 +
: Returns a single-valued first level of a texture array view relative to its parent. See {{KW|_glTextureView}}.
 +
; {{KW|_GL_TEXTURE_VIEW_NUM_LAYERS}}
 +
: Returns a single-valued number of layers in a texture array view. See {{KW|_glTextureView}}.
 +
; {{KW|_GL_TEXTURE_IMMUTABLE_LEVELS}}
 +
: Returns a single-valued number of immutable texture levels in a texture view. See {{KW|_glTextureView}}.
 +
In addition to the parameters that may be set with {{KW|_glTexParameter}}, '''_glGetTexParameter''' accepts the following read-only parameters:
  
{{Parameter|pname}} specifies the texture parameter whose value or values will be returned.
+
; {{KW|_GL_TEXTURE_IMMUTABLE_FORMAT}}
 
+
: Returns non-zero if the texture has an immutable format. Textures become immutable if their storage is specified with {{KW|_glTexStorage1D}}, {{KW|_glTexStorage2D}} or {{KW|_glTexStorage3D}}. The initial value is {{KW|_GL_FALSE}}.
The accepted parameter names are as follows:
 
 
 
; {{KW|_GL_TEXTURE_WIDTH}}
 
:  
 
{{Parameter|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.
 
; {{KW|_GL_TEXTURE_HEIGHT}}
 
:
 
{{Parameter|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.
 
; {{KW|_GL_TEXTURE_DEPTH}}
 
:
 
{{Parameter|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.
 
; {{KW|_GL_TEXTURE_INTERNAL_FORMAT}}
 
:
 
{{Parameter|params}} returns a single value, the internal format of the texture image.
 
; {{KW|_GL_TEXTURE_RED_TYPE}},
 
: ; {{KW|_GL_TEXTURE_GREEN_TYPE}},
 
: ; {{KW|_GL_TEXTURE_BLUE_TYPE}},
 
: ; {{KW|_GL_TEXTURE_ALPHA_TYPE}},
 
: ; {{KW|_GL_TEXTURE_DEPTH_TYPE}}
 
:
 
The data type used to store the component. The types {{KW|_GL_NONE}}, {{KW|_GL_SIGNED_NORMALIZED}}, {{KW|_GL_UNSIGNED_NORMALIZED}}, {{KW|_GL_FLOAT}}, {{KW|_GL_INT}}, and {{KW|_GL_UNSIGNED_INT}} may be returned to indicate signed normalized fixed-point, unsigned normalized fixed-point, floating-point, integer unnormalized, and unsigned integer unnormalized components, respectively.
 
; {{KW|_GL_TEXTURE_RED_SIZE}},
 
: ; {{KW|_GL_TEXTURE_GREEN_SIZE}},
 
: ; {{KW|_GL_TEXTURE_BLUE_SIZE}},
 
: ; {{KW|_GL_TEXTURE_ALPHA_SIZE}},
 
: ; {{KW|_GL_TEXTURE_DEPTH_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 {{KW|_glTexImage1D}}, {{KW|_glTexImage2D}}, {{KW|_glTexImage3D}}, {{KW|_glCopyTexImage1D}}, and {{KW|_glCopyTexImage2D}}. The initial value is 0.
 
; {{KW|_GL_TEXTURE_COMPRESSED}}
 
:
 
{{Parameter|params}} returns a single boolean value indicating if the texture image is stored in a compressed internal format. The initiali value is {{KW|_GL_FALSE}}.
 
; {{KW|_GL_TEXTURE_COMPRESSED_IMAGE_SIZE}}
 
:
 
{{Parameter|params}} returns a single integer value, the number of unsigned bytes of the compressed texture image that would be returned from {{KW|_glGetCompressedTexImage}}.
 
; {{KW|_GL_TEXTURE_BUFFER_OFFSET}}
 
:
 
{{Parameter|params}} returns a single integer value, the offset into the data store of the buffer bound to a buffer texture. {{KW|_glTexBufferRange}}.
 
; {{KW|_GL_TEXTURE_BUFFER_SIZE}}
 
:
 
{{Parameter|params}} returns a single integer value, the size of the range of a data store of the buffer bound to a buffer texture. {{KW|_glTexBufferRange}}.
 
  
 
{{PageNotes}}
 
{{PageNotes}}
Line 74: Line 79:
 
If an error is generated, no change is made to the contents of {{Parameter|params}}.
 
If an error is generated, no change is made to the contents of {{Parameter|params}}.
  
'''_glGetTexLevelParameter''' returns the texture level parameters for the active texture unit.
+
{{KW|_GL_DEPTH_STENCIL_TEXTURE_MODE}}, {{KW|_GL_TEXTURE_VIEW_MIN_LEVEL}}, {{KW|_GL_TEXTURE_VIEW_NUM_LEVELS}}, {{KW|_GL_TEXTURE_VIEW_MIN_LAYER}}, {{KW|_GL_TEXTURE_VIEW_NUM_LAYERS}} and {{KW|_GL_TEXTURE_IMMUTABLE_LEVELS}} are available only if the GL version is 4.3 or greater.
 
 
{{KW|_GL_TEXTURE_BUFFER_OFFSET}} and {{KW|_GL_TEXTURE_BUFFER_SIZE}} are available only if the GL version is 4.3 or greater.
 
  
  
Line 82: Line 85:
  
 
{{KW|_GL_INVALID_ENUM}} is generated if {{Parameter|target}} or {{Parameter|pname}} is not an accepted value.
 
{{KW|_GL_INVALID_ENUM}} is generated if {{Parameter|target}} or {{Parameter|pname}} is not an accepted value.
 
{{KW|_GL_INVALID_VALUE}} is generated if {{Parameter|level}} is less than 0.
 
 
{{KW|_GL_INVALID_VALUE}} may be generated if {{Parameter|level}} is greater than log<sub>2</sub>(''max''), where ''max'' is the returned value of {{KW|_GL_MAX_TEXTURE_SIZE}}.
 
 
{{KW|_GL_INVALID_VALUE}} is generated if {{Parameter|target}} is {{KW|_GL_TEXTURE_BUFFER}} and {{Parameter|level}} is not zero.
 
 
{{KW|_GL_INVALID_OPERATION}} is generated if {{KW|_GL_TEXTURE_COMPRESSED_IMAGE_SIZE}} is queried on texture images with an uncompressed internal format or on proxy targets.
 
  
  
Line 95: Line 90:
  
 
{{KW|_GL}}
 
{{KW|_GL}}
{{KW|_glActiveTexture}}, {{KW|_glBindTexture}}, {{KW|_glGetTexParameter}}
+
{{KW|_glActiveTexture}}, {{KW|_glBindTexture}}, {{KW|_glGetTexLevelParameter}}, {{KW|_glTexParameter}}
  
  

Revision as of 10:18, 8 January 2013

_glGetTexParameter: return texture parameter values


Syntax

 SUB _glGetTexParameterfv (BYVAL target AS _UNSIGNED LONG, BYVAL pname AS _UNSIGNED LONG, params AS SINGLE)
 void _glGetTexParameterfv(GLenum target, GLenum pname, GLfloat * params);
 SUB _glGetTexParameteriv (BYVAL target AS _UNSIGNED LONG, BYVAL pname AS _UNSIGNED LONG, params AS LONG)
 void _glGetTexParameteriv(GLenum target, GLenum pname, GLint * params);
 void _glGetTexParameterIiv(GLenum target, GLenum pname, GLint * params);
 void _glGetTexParameterIuiv(GLenum target, GLenum pname, GLuint * params);
target
Specifies the symbolic name of the target texture. _GL_TEXTURE_1D, _GL_TEXTURE_2D, _GL_TEXTURE_1D_ARRAY, _GL_TEXTURE_2D_ARRAY, _GL_TEXTURE_3D, _GL_TEXTURE_RECTANGLE, _GL_TEXTURE_CUBE_MAP, and _GL_TEXTURE_CUBE_MAP_ARRAY are accepted.
pname
Specifies the symbolic name of a texture parameter. _GL_DEPTH_STENCIL_TEXTURE_MODE, _GL_TEXTURE_BASE_LEVEL, _GL_TEXTURE_BORDER_COLOR, _GL_TEXTURE_COMPARE_MODE, _GL_TEXTURE_COMPARE_FUNC, _GL_TEXTURE_IMMUTABLE_FORMAT, _GL_TEXTURE_IMMUTABLE_LEVELS, _GL_TEXTURE_LOD_BIAS, _GL_TEXTURE_MAG_FILTER, _GL_TEXTURE_MAX_LEVEL, _GL_TEXTURE_MAX_LOD, _GL_TEXTURE_MIN_FILTER, _GL_TEXTURE_MIN_LOD, _GL_TEXTURE_SWIZZLE_R, _GL_TEXTURE_SWIZZLE_G, _GL_TEXTURE_SWIZZLE_B, _GL_TEXTURE_SWIZZLE_A, _GL_TEXTURE_SWIZZLE_RGBA, _GL_TEXTURE_VIEW_MIN_LAYER, _GL_TEXTURE_VIEW_MIN_LEVEL, _GL_TEXTURE_VIEW_NUM_LAYERS, _GL_TEXTURE_VIEW_NUM_LEVELS, _GL_TEXTURE_WRAP_S, _GL_TEXTURE_WRAP_T, and _GL_TEXTURE_WRAP_R 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. _GL_TEXTURE_1D, _GL_TEXTURE_2D, _GL_TEXTURE_3D, _GL_TEXTURE_1D_ARRAY, _GL_TEXTURE_2D_ARRAY, _GL_TEXTURE_RECTANGLE, _GL_TEXTURE_CUBE_MAP, _GL_TEXTURE_CUBE_MAP_ARRAY specify one-, two-, or three-dimensional, one-dimensional array, two-dimensional array, rectangle, cube-mapped or cube-mapped array texturing, respectively. pname accepts the same symbols as _glTexParameter, with the same interpretations:

_GL_DEPTH_STENCIL_TEXTURE_MODE
Returns the single-value depth stencil texture mode, a symbolic constant. The initial value is _GL_DEPTH_COMPONENT.
_GL_TEXTURE_MAG_FILTER
Returns the single-valued texture magnification filter, a symbolic constant. The initial value is _GL_LINEAR.
_GL_TEXTURE_MIN_FILTER
Returns the single-valued texture minification filter, a symbolic constant. The initial value is _GL_NEAREST_MIPMAP_LINEAR.
_GL_TEXTURE_MIN_LOD
_GL_TEXTURE_MAX_LOD
Returns the single-valued texture maximum level-of-detail value. The initial 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_SWIZZLE_R
Returns the red component swizzle. The initial value is _GL_RED.
_GL_TEXTURE_SWIZZLE_G
Returns the green component swizzle. The initial value is _GL_GREEN.
_GL_TEXTURE_SWIZZLE_B
Returns the blue component swizzle. The initial value is _GL_BLUE.
_GL_TEXTURE_SWIZZLE_A
Returns the alpha component swizzle. The initial value is _GL_ALPHA.
_GL_TEXTURE_SWIZZLE_RGBA
Returns the component swizzle for all channels in a single query.
_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 positive representable integer and -1.0 maps to the most negative representable integer. The initial value is (0, 0, 0, 0).
_GL_TEXTURE_COMPARE_MODE
Returns a single-valued texture comparison mode, a symbolic constant. The initial value is _GL_NONE. See _glTexParameter.
_GL_TEXTURE_COMPARE_FUNC
Returns a single-valued texture comparison function, a symbolic constant. The initial value is _GL_LEQUAL. See _glTexParameter.
_GL_TEXTURE_VIEW_MIN_LEVEL
Returns a single-valued base level of a texture view relative to its parent. The initial value is 0. See _glTextureView.
_GL_TEXTURE_VIEW_NUM_LEVELS
Returns a single-valued number of levels of detail of a texture view. See _glTextureView.
_GL_TEXTURE_VIEW_MIN_LAYER
Returns a single-valued first level of a texture array view relative to its parent. See _glTextureView.
_GL_TEXTURE_VIEW_NUM_LAYERS
Returns a single-valued number of layers in a texture array view. See _glTextureView.
_GL_TEXTURE_IMMUTABLE_LEVELS
Returns a single-valued number of immutable texture levels in a texture view. See _glTextureView.

In addition to the parameters that may be set with _glTexParameter, _glGetTexParameter accepts the following read-only parameters:

_GL_TEXTURE_IMMUTABLE_FORMAT
Returns non-zero if the texture has an immutable format. Textures become immutable if their storage is specified with _glTexStorage1D, _glTexStorage2D or _glTexStorage3D. The initial value is _GL_FALSE.

Notes:

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

_GL_DEPTH_STENCIL_TEXTURE_MODE, _GL_TEXTURE_VIEW_MIN_LEVEL, _GL_TEXTURE_VIEW_NUM_LEVELS, _GL_TEXTURE_VIEW_MIN_LAYER, _GL_TEXTURE_VIEW_NUM_LAYERS and _GL_TEXTURE_IMMUTABLE_LEVELS are available only if the GL version is 4.3 or greater.


Errors

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


See also

_GL _glActiveTexture, _glBindTexture, _glGetTexLevelParameter, _glTexParameter


Copyright: 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License.
For details, see http://oss.sgi.com/projects/FreeB/.



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page

Copyright 1991-2006 Silicon Graphics, Inc. Copyright 2010-2012 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.