GLAPI/glDeleteSamplers: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Renaming category: 'GL 4 API Texturing' to 'Core API Ref Texturing'.
m Bot: Adding better formatting.
Line 9: Line 9:
== Function Definition ==
== Function Definition ==


   void '''glDeleteSamplers'''(GLsizei ''n'', const GLuint * ''ids'');
   void '''glDeleteSamplers'''(GLsizei {{param|n}}, const GLuint * {{param|ids}});


; n
; n
Line 18: Line 18:
== Description ==
== Description ==


'''glDeleteSamplers''' deletes ''n'' sampler objects named by the elements of the array ''ids''. After a sampler object is deleted, its name is again unused. If a sampler object that is currently bound to a sampler unit is deleted, it is as though [[GLAPI/glBindSampler|glBindSampler]] is called with unit set to the unit the sampler is bound to and sampler zero. Unused names in samplers are silently ignored, as is the reserved name zero.
'''glDeleteSamplers''' deletes {{param|n}} sampler objects named by the elements of the array {{param|ids}}. After a sampler object is deleted, its name is again unused. If a sampler object that is currently bound to a sampler unit is deleted, it is as though {{apifunc|glBindSampler}} is called with unit set to the unit the sampler is bound to and sampler zero. Unused names in samplers are silently ignored, as is the reserved name zero.


== Notes ==
== Notes ==
Line 26: Line 26:
== Errors ==
== Errors ==


{{code|GL_INVALID_VALUE}} is generated if ''n'' is negative.
{{code|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.


== Associated Gets ==
== Associated Gets ==


[[GLAPI/glIsSampler|glIsSampler]]
{{apifunc|glIsSampler}}


== See Also ==
== See Also ==


[[GLAPI/glGenSamplers|glGenSamplers]], [[GLAPI/glBindSampler|glBindSampler]], [[GLAPI/glDeleteSamplers|glDeleteSamplers]], [[GLAPI/glIsSampler|glIsSampler]]
{{apifunc|glGenSamplers}}, {{apifunc|glBindSampler}}, {{apifunc|glDeleteSamplers}}, {{apifunc|glIsSampler}}


== Copyright ==
== Copyright ==

Revision as of 01:15, 29 April 2012

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

glDeleteSamplers: delete named sampler objects

Function Definition

 void glDeleteSamplers(GLsizei n​, const GLuint * ids​);
n
Specifies the number of sampler objects to be deleted.
ids
Specifies an array of sampler objects to be deleted.

Description

glDeleteSamplers deletes n​ sampler objects named by the elements of the array ids​. After a sampler object is deleted, its name is again unused. If a sampler object that is currently bound to a sampler unit is deleted, it is as though glBindSampler is called with unit set to the unit the sampler is bound to and sampler zero. Unused names in samplers are silently ignored, as is the reserved name zero.

Notes

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

Errors

GL_INVALID_VALUE is generated if n​ is negative.

Associated Gets

glIsSampler

See Also

glGenSamplers, glBindSampler, glDeleteSamplers, glIsSampler

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