GLAPI/glGenSamplers: Difference between revisions
4.0 API. |
m Bot: Adding better formatting. |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 9: | Line 9: | ||
== Function Definition == | == Function Definition == | ||
void '''glGenSamplers'''(GLsizei | void '''glGenSamplers'''(GLsizei {{param|n}}, GLuint *{{param|samplers}}); | ||
; n | ; n | ||
| Line 18: | Line 18: | ||
== Description == | == Description == | ||
'''glGenSamplers''' returns | '''glGenSamplers''' returns {{param|n}} sampler object names in {{param|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 | Sampler object names returned by a call to '''glGenSamplers''' are not returned by subsequent calls, unless they are first deleted with {{apifunc|glDeleteSamplers}}. | ||
The names returned in | The names returned in {{param|samplers}} are marked as used, for the purposes of '''glGenSamplers''' only, but they acquire state and type only when they are first bound. | ||
== Notes == | == Notes == | ||
| Line 30: | Line 30: | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== See Also == | == See Also == | ||
{{apifunc|glBindSampler}}, {{apifunc|glIsSampler}}, {{apifunc|glDeleteSamplers}} | |||
== Copyright == | == Copyright == | ||
| 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:API Reference | [[Category:Core API Reference|GenSamplers]] | ||
[[Category:Core API Ref Texturing|GenSamplers]] | |||
Latest revision as of 17:21, 29 April 2012
| 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/.