glGetSamplerParameter — return sampler parameter values
void glGetSamplerParameterfv( | GLuint sampler, |
GLenum pname, | |
GLfloat * params) ; |
void glGetSamplerParameteriv( | GLuint sampler, |
GLenum pname, | |
GLint * params) ; |
void glGetSamplerParameterIiv( | GLuint sampler, |
GLenum pname, | |
GLint * params) ; |
void glGetSamplerParameterIuiv( | GLuint sampler, |
GLenum pname, | |
GLuint * params) ; |
sampler
Specifies name of the sampler object from which to retrieve parameters.
pname
Specifies the symbolic name of a sampler parameter.
GL_TEXTURE_MAG_FILTER
,
GL_TEXTURE_MIN_FILTER
,
GL_TEXTURE_MIN_LOD
,
GL_TEXTURE_MAX_LOD
,
GL_TEXTURE_LOD_BIAS
,
GL_TEXTURE_WRAP_S
,
GL_TEXTURE_WRAP_T
,
GL_TEXTURE_WRAP_R
,
GL_TEXTURE_BORDER_COLOR
,
GL_TEXTURE_COMPARE_MODE
, and
GL_TEXTURE_COMPARE_FUNC
are accepted.
params
Returns the sampler parameters.
glGetSamplerParameter
returns in params
the value or values of the sampler parameter
specified as pname
.
sampler
defines the target sampler, and must be the name of an existing sampler object, returned from a previous call
to glGenSamplers.
pname
accepts the same symbols as glSamplerParameter,
with the same interpretations:
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
Returns the single-valued texture minimum level-of-detail value. The
initial value is
GL_TEXTURE_MAX_LOD
Returns the single-valued texture maximum level-of-detail value. The initial value is 1000.
GL_TEXTURE_WRAP_S
Returns the single-valued wrapping function for texture coordinate
GL_REPEAT
.
GL_TEXTURE_WRAP_T
Returns the single-valued wrapping function for texture coordinate
GL_REPEAT
.
GL_TEXTURE_WRAP_R
Returns the single-valued wrapping function for texture coordinate
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
GL_TEXTURE_COMPARE_MODE
Returns a single-valued texture comparison mode, a symbolic constant. The
initial value is GL_NONE
. See glSamplerParameter.
GL_TEXTURE_COMPARE_FUNC
Returns a single-valued texture comparison function, a symbolic constant. The
initial value is GL_LEQUAL
. See glSamplerParameter.
If an error is generated,
no change is made to the contents of params
.
glGetSamplerParameter
is available only if the GL version is 3.3 or higher.
GL_INVALID_VALUE
is generated if sampler
is not the name of a sampler object returned from
a previous call to glGenSamplers.
GL_INVALID_ENUM
is generated if pname
is not an accepted value.
Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.