glBindSampler.3G - Man Page
bind a named sampler to a texturing target
C Specification
void glBindSampler(GLuint unit, GLuint sampler);
Parameters
- unit
Specifies the index of the texture unit to which the sampler is bound.
- sampler
Specifies the name of a sampler.
Description
glBindSampler binds sampler to the texture unit at index unit. sampler must be zero or the name of a sampler object previously returned from a call to glGenSamplers(). unit must be less than the value of GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS.
When a sampler object is bound to a texture unit, its state supersedes that of the texture object bound to that texture unit. If the sampler name zero is bound to a texture unit, the currently bound texture's sampler state becomes active. A single sampler object may be bound to multiple texture units simultaneously.
Notes
glBindSampler is available only if the GL version is 3.3 or higher.
Errors
GL_INVALID_VALUE is generated if unit is greater than or equal to the value of GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS.
GL_INVALID_OPERATION is generated if sampler is not zero or a name previously returned from a call to glGenSamplers(), or if such a name has been deleted by a call to glDeleteSamplers().
Associated Gets
glGet() with argument GL_SAMPLER_BINDING
Version Support
OpenGL Version | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 |
glBindSampler | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
See Also
glGenSamplers(), glDeleteSamplers(), glGet(), glSamplerParameter(), glGetSamplerParameter(), glGenTextures(), glBindTexture(), glDeleteTextures()
Copyright
Copyright © 2010-2014 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/.
Copyright
Copyright © 2010-2014 Khronos Group
Referenced By
glBindSamplers.3G(3), glCreateSamplers.3G(3), glDeleteSamplers.3G(3), glGenSamplers.3G(3), glIsSampler.3G(3), glSamplerParameter.3G(3).