GLAPI/glGenSamplers: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Renaming category: 'API Reference 4' to 'Core API Reference'.
m Renaming category: 'GL 4 API Texturing' to 'Core API Ref Texturing'.
Line 40: Line 40:
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/ http://opencontent.org/openpub/].
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/ http://opencontent.org/openpub/].


[[Category:GL 4 API Texturing|GenSamplers]]
[[Category:Core API Reference|GenSamplers]]
[[Category:Core API Reference|GenSamplers]]
[[Category:Core API Ref Texturing|GenSamplers]]

Revision as of 07:58, 26 February 2012

glGenSamplers
Core in version 4.6
Core since version 3.3
Core ARB extension ARB_sampler_objects

glGenSamplers: generate sampler object names

Function Definition

 void glGenSamplers(GLsizei n, GLuint *samplers);
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 bound.

Notes

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

Errors

GL_INVALID_VALUE is generated if n is negative.

See Also

glBindSampler, glIsSampler, glDeleteSamplers

Copyright

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