Difference between revisions of "GLAPI/glBindSampler"

From OpenGL.org
Jump to: navigation, search
m (Bot: Adding better formatting.)
m (Bot: Adding better formatting.)
Line 38: Line 38:
== See Also ==
== See Also ==
{{apifunc|glGenSamplers}}, {{apifunc|glDeleteSamplers}}, {{apifunc|glGet}}, {{apifunc|glSamplerParameter}}, {{apifunc|glGetSamplerParameter}}, {{apifunc|glGenTextures}}, {{apifunc|glBindTexture}}, {{apifunc|glDeleteTextures}}
{{apifunc|glGenSamplers}}, {{apifunc|glDeleteSamplers}}, {{apifunc|glSamplerParameter}}, {{apifunc|glGetSamplerParameter}}, {{apifunc|glActiveTexture}}, {{apifunc|glBindTexture}}
== Copyright ==
== Copyright ==

Revision as of 15:30, 27 September 2012

Core in version 4.5
Core since version 3.3
Core ARB extension ARB_sampler_objects

glBindSampler: bind a named sampler to a texturing target

Function Definition

 void glBindSampler(GLuint unit​, GLuint sampler​);
Specifies the index of the texture unit to which the sampler is bound.
Specifies the name of a sampler.


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.


glBindSampler is available only if the GL version is 3.3 or higher.


GL_INVALID_VALUE is generated if unit​ is greater than or equal to the value of GL_MAX_COMBIED_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

See Also

glGenSamplers, glDeleteSamplers, glSamplerParameter, glGetSamplerParameter, glActiveTexture, glBindTexture


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