OpenGL API - glGetShaderInfoLog

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

OpenGL API - 笔记汇总

名称

glGetShaderInfoLog ---- 返回 shader 对象的日志信息。

原型

void glGetShaderInfoLog(GLuint shader,
					 	GLsizei maxLength,
					 	GLsizei *length,
					 	GLchar *infoLog);

参数

shader
指定需要查询日志信息的 shader 对象。
maxLength
指定储存日志信息的字符缓存大小。
length
返回 infoLog（不包括空结尾符）的字符串长度。
infoLog
指定用于返回日志信息的字符数组。

描述

glGetShaderInfoLog 返回指定 shader 对象的日志信息。一个shader 对象的日志信息会在 shader 编译是修改。返回的字符串将以空字符结尾。

glGetShaderInfoLog 返回 infoLog 的maxLength最大长度的字符的能填入的日志信息。返回的是实际的字符需要的数量，不包含空结尾符，而是指定 length 的长度。如果不需要返回字符串的长度，那么 length 传入 NULL。获取需要日志信息缓存的大小，可通过 只用 GL_INFO_LOG_LENGTH 来调用 glGetShader 。

一个 shader 对象的日志信息可能包含诊断信息，警告信息，和其他关于编译操作的信息。当一个 shader 对象被创建时，它的日志信息将会被设置为一个 0 长度的字符串。

注意

一个 shader 对象的日志信息是 OpenGL 实现的编译相关过程的主要机制。因此，日志信息对于应用程序开发者在开发过程是很有帮助的，即使编译是成功的。

错误

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

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

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