glGenSamplers

From OpenGL Reference
Jump to navigation Jump to search

Generate sampler object names.

C Specification[edit]

void glGenSamplers( GLsizei n, GLuint * samplers );


Parameters[edit]

n - Specifies the number of sampler object names to generate.
samplers - Specifies an array in which the generated sampler object names are stored.


Description[edit]

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


Notes[edit]

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


Errors[edit]

 GL_INVALID_VALUE is generated if n is negative.


Version Support[edit]

 glGenSamplers  3.2+

See Also[edit]

 glBindSampler , glIsSampler , glDeleteSamplers 


Copyright[edit]

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