glGetProgramInfoLog - повертає інформаційний журнал програмного об'єкта.
C-специфікація
void glGetProgramInfoLog (GLuint program,
GLsizei maxLength,
GLsizei *length,
GLchar *infoLog) ;
Параметри
program вказує програмний об'єкт, інформаційний журнал якого необхідно отримати.
maxLength вказує розмір буферу символів для збереження поверненого інформаційного журналу.
length повертає довжину рядка символів розміщеного у infoLog (виключаючи завершуючий нульовий символ).
infoLog вказує масив символів, який використовується для повернення інформаційного журналу
Опис
Функція glGetProgramInfoLog повертає інформаційний журнал для вказаного програмного об'єкта. Інформаційний журнал для програмного об'єкта модифікується коли програмний об'єкт скомпонований або перевірений. Повернений рядок символів буде містити завершуючий нульовий символ.
Функція glGetProgramInfoLog повертає у infoLog стільки інформації, скільки це можливо, включаючи maxLength символів. Кількість фактично повернених символів, не включаючи завершуючий нульовий символ, вказується у length. Якщо довжина поверненого рядка не вимагається, у аргументі length можна розмістити значення NULL. Необхідний розмір буфера для збереження інформаційного журналу можна отримати за допомогою виклику функції glGetProgram з значенням GL_INFO_LOG_LENGTH.
Інформаційний журнал для програмного об'єкту являється пустим рядком, або рядком символів, який містить інформацію про останню операцію компонування, або про останню операцію перевірки. Він може містити відлагоджуючі, попереджаючі повідомлення або іншу інформацію. Коли програмний об'єкт створено, його інформаційний журнал буде містити символьний рядок довжиною нуль символів.
Нотатки
Функція glGetProgramInfoLog доступна у системі OpenGL версії 2.0 або вище.
Інформаційний журнал програмного об'єкта являється головним механізмом для висвітлення інформації про компонування і перевірку для реалізаторів систем OpenGL. Отже, інформаційний журнал може бути корисним для розробників програмного забезпечення під час процесу розробки, навіть коли дані операції пройшли успішно. Розробники програмного забезпечення не повинні очікувати, що різні реалізації OpenGL будуть генерувати ідентичні повідомлення у інформаційних журналах.
Помилки
GL_INVALID_VALUE генерується якщо параметр program не містить значення згенероване системою OpenGL.
GL_INVALID_OPERATION генерується якщо параметр program не містить ідентифікатор програмного об'єкта.
GL_INVALID_VALUE генерується якщо параметр maxLength містить значення менше за 0.
GL_INVALID_OPERATION генерується якщо glGetProgramInfoLog виконується між відповідними викликами glBegin і glEnd.
Пов'язані параметри
glGetProgram з аргументом GL_INFO_LOG_LENGTH
glIsProgram
Перегляньте також
glCompileShader, glGetShaderInfoLog, glLinkProgram, glValidateProgram
Оригінал
https://www.khronos.org/registry/OpenGL-Refpages/gl2.1/xhtml/glGetProgramInfoLog.xml