NAME

       glBindSampler - 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      │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
       │/             │     │     │     │     │     │     │     │     │     │     │     │     │
       │Feature       │     │     │     │     │     │     │     │     │     │     │     │     │
       │Name          │     │     │     │     │     │     │     │     │     │     │     │     │
       ├──────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │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

[FIXME: source]                             07/22/2015                          GLBINDSAMPLER(3G)