2010-2014
Khronos Group
glGenSamplers
3G

# glGenSamplers

generate sampler object names

## C Specification

                    void glGenSamplers
                    GLsizei n
                    GLuint *samplers

## Parameters

`n`

  Specifies the number of sampler object names to generate.

`samplers`

  Specifies an array in which the generated sampler object names are stored.

## Description

`glGenSamplers` returns `n` sampler object names in `samplers`. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to `glGenSamplers`.

Sampler object names returned by a call to `glGenSamplers` are not returned by subsequent calls, unless they are first deleted with glDeleteSamplers.

The names returned in `samplers` are marked as used, for the purposes of `glGenSamplers` only, but they acquire state and type only when they are first used as a parameter to glBindSampler, glSamplerParameter*, glGetSamplerParameter* or glIsSampler.

## Errors

`GL_INVALID_VALUE` is generated if `n` is negative.

## Associated Gets

glIsSampler, glGetSamplerParameter

## API Version Support

glGenSamplers

## See Also

glBindSampler, glDeleteSamplers, glIsSampler, glGetSamplerParameter, glSamplerParameter

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