OpenGL API - glGetProgramInfoLog

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

OpenGL API - 笔记汇总

名称

glGetProgramInfoLog ---- 绑定带名称的缓存对象。

原型

void glGetProgramInfoLog(GLuint program,
					 	GLsizei maxLength,
					 	GLsizei *length,
					 	GLchar *infoLog);

参数

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

描述

glGetProgramInfoLog 返回指定程序对象的日志信息。当一个程序对象链接或验证时，该程序对象日志信息将会被修改。返回的字符串带有空结尾符。

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

一个程序对象的日志信息可能是一个空字符串，或是宝行了上次链接的日志信息字符串，或是上次验证操作的日志信息字符串。它可能包含了诊断信息，警告信息，和其他的信息。当创建一个程序对象时，它的日志信息的字符串将会是 0 的长度。

注意

程序对象的日志信息是 OpenGL 实现表达关于廉洁与验证信息的主要机制。因此，这些日志信息对应开发者在开发过程是很有帮助的，即使这些操作都是成功的时候。

错误

如果 program 参数不是 OpenGL 生成的，则生成 GL_INVALID_VALUE 错误。

如果 program 参数不是程序对象，则生成 GL_INVALID_OPERATION 错误。

如果 maxLength 参数小于0，则生成 GL_INVALID_VALUE 错误。