GLAPI/glDeleteProgram: Difference between revisions
m Bot: Adjusting API page category. |
m Bot: Adding better formatting. |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glDeleteProgram'''(GLuint | void '''glDeleteProgram'''(GLuint {{param|program}}); | ||
; program | ; program | ||
| Line 15: | Line 15: | ||
== Description == | == Description == | ||
'''glDeleteProgram''' frees the memory and invalidates the name associated with the program object specified by | '''glDeleteProgram''' frees the memory and invalidates the name associated with the program object specified by {{param|program.}} This command effectively undoes the effects of a call to {{apifunc|glCreateProgram}}. | ||
If a program object is in use as part of current rendering state, it will be flagged for deletion, but it will not be deleted until it is no longer part of current state for any rendering context. If a program object to be deleted has shader objects attached to it, those shader objects will be automatically detached but not deleted unless they have already been flagged for deletion by a previous call to | If a program object is in use as part of current rendering state, it will be flagged for deletion, but it will not be deleted until it is no longer part of current state for any rendering context. If a program object to be deleted has shader objects attached to it, those shader objects will be automatically detached but not deleted unless they have already been flagged for deletion by a previous call to {{apifunc|glDeleteShader}}. A value of 0 for {{param|program}} will be silently ignored. | ||
To determine whether a program object has been flagged for deletion, call | To determine whether a program object has been flagged for deletion, call {{apifunc|glGetProgram}} with arguments {{param|program}} and {{enum|GL_DELETE_STATUS}}. | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|program}} is not a value generated by OpenGL. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glGet}} with argument {{enum|GL_CURRENT_PROGRAM}} | |||
{{apifunc|glGetProgram}} with arguments {{param|program}} and {{enum|GL_DELETE_STATUS}} | |||
{{apifunc|glIsProgram}} | |||
== See Also == | == See Also == | ||
{{apifunc|glCreateProgram}}, {{apifunc|glCreateShaderProgram}}, {{apifunc|glIsProgram}}, {{apifunc|glLinkProgram}}, {{apifunc|glUseProgram}} | |||
== Copyright == | == Copyright == | ||
| Line 41: | Line 41: | ||
Copyright © 2003-2005 3Dlabs Inc. Ltd. 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 © 2003-2005 3Dlabs Inc. Ltd. 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|DeleteProgram]] | ||
[[Category: | [[Category:Core API Ref Shader Program Creation|DeleteProgram]] | ||
Latest revision as of 19:33, 27 September 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 2.0 | |
glDeleteProgram: Deletes a program object
Function Definition
void glDeleteProgram(GLuint program);
- program
- Specifies the program object to be deleted.
Description
glDeleteProgram frees the memory and invalidates the name associated with the program object specified by program. This command effectively undoes the effects of a call to glCreateProgram.
If a program object is in use as part of current rendering state, it will be flagged for deletion, but it will not be deleted until it is no longer part of current state for any rendering context. If a program object to be deleted has shader objects attached to it, those shader objects will be automatically detached but not deleted unless they have already been flagged for deletion by a previous call to glDeleteShader. A value of 0 for program will be silently ignored.
To determine whether a program object has been flagged for deletion, call glGetProgram with arguments program and GL_DELETE_STATUS.
Errors
GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.
Associated Gets
glGet with argument GL_CURRENT_PROGRAM
glGetProgram with arguments program and GL_DELETE_STATUS
See Also
glCreateProgram, glCreateShaderProgram, glIsProgram, glLinkProgram, glUseProgram
Copyright
Copyright © 2003-2005 3Dlabs Inc. Ltd. 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/.