OpenGL API - glShaderSource

https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glShaderSource.xhtml

OpenGL API - 笔记汇总

名称

glShaderSource ---- 给 shader 对象指定源码。

原型

void glShaderSource(GLuint shader,
				 	GLsizei count,
				 	const GLchar **string,
				 	const GLint *length);

参数

shader
指定需要设置源码的 shader 对象。
count
指定源码脚本的数量。
string
指定用于装载的 shader 源码。
length
指定 string 源码数组的长度。

描述

glShaderSource 将shader中的源代码设置为string指定的字符串数组中的源代码。以前存储在着色器对象中的任何源代码都将被完全替换。数组中的字符串数由count指定。如果长度为空，则假定每个字符串以空结尾。如果长度不是空值，则它指向一个数组，该数组包含字符串的每个对应元素的字符串长度。长度数组中的每个元素都可以包含相应字符串的长度（空字符不计算为字符串长度的一部分）或小于0的值，以指示字符串以空结尾。此时不会扫描或分析源代码字符串；它们只是复制到指定的着色器对象中。

注意

当调用 glShaderSource 函数时 OpenGL 复制 shader 源码字符串，所以当函数执行后，应用程序可以将源码的字符串释放掉。

错误

如果 shader 参数不是 OpenGL 生成的，那么生成 GL_INVALID_VALUE 错误。

如果 shader 参数不是一个 shader 对象，那么生成 GL_INVALID_OPERATION 错误。

如果 count 小于0，那么生成 GL_INVALID_VALUE 错误。