Light | Dark

# docs.GL

OpenGL 4
OpenGL 3
OpenGL ES 3

# glBindSampler

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

## Errors

`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`

## API Version Support

| OpenGL ES API Version
--- | ---
Function Name | 2.0 | 3.0 | 3.1
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. https://opencontent.org/openpub/.

Think you can improve this page? Edit this page on GitHub.