名稱

glGetProgramiv- 從program物件返回一個引數的值

C規範

void glGetProgramiv（GLuint program,GLenum pname,GLint *params）;

引數

program

指定要查詢的program物件。

pname

指定program物件引數。 接受的符號名稱為GL_DELETE_STATUS，GL_LINK_STATUS，GL_VALIDATE_STATUS，GL_INFO_LOG_LENGTH，GL_ATTACHED_SHADERS，GL_ACTIVE_ATTRIBUTES

params

返回請求的物件引數的值。

描述

glGetProgramiv以params形式返回指定的program物件的引數值。 定義了以下引數：

GL_DELETE_STATUS

如果program當前標記為刪除，則params返回GL_TRUE，否則返回GL_FALSE。

GL_LINK_STATUS

如果program的最後一個連結操作成功，則params返回GL_TRUE，否則返回GL_FALSE

GL_VALIDATE_STATUS

params返回GL_TRUE，program的最後一次驗證操作成功了也返回GL_TRUE，否則返回GL_FALSE。

GL_INFO_LOG_LENGTH

params返回program資訊日誌中的字元數，包括空終止字元（即，儲存資訊日誌所需的字元緩衝區的大小）。 如果程式沒有資訊日誌，則返回值0。

GL_ATTACHED_SHADERS

params返回附加到program的著色器物件的數量。

GL_ACTIVE_ATTRIBUTES

params返回program的啟用狀態的屬性變數數。

GL_ACTIVE_ATTRIBUTE_MAX_LENGTH

params返回program的最長啟用狀態的屬性名稱的長度，包括空終止字元（即，儲存最長屬性名稱所需的字元緩衝區的大小）。 如果不存在活動屬性，則返回0。

GL_ACTIVE_UNIFORMS

params返回program的啟用狀態的統一變數的數量。

GL_ACTIVE_UNIFORM_MAX_LENGTH

params返回program的最長啟用狀態的統一變數名稱的長度，包括空終止字元（即，儲存最長統一變數名稱所需的字元緩衝區的大小）。 如果不存在活動的統一變數，則返回0。

注意

如果生成錯誤，則不會更改params的內容。

錯誤

GL_INVALID_ENUM ：pname不是一個可接受的值

GL_INVALID_VALUE ：program不是OpenGL生成的值

GL_INVALID_OPERATION： program沒有關聯program物件

相關Gets

glGetActiveAttrib 引數：program

glGetActiveUniform 引數：program

glGetAttachedShaders 引數：program

glGetProgramInfoLog 引數：program

glIsProgram

另見

glAttachShader, glCreateProgram, glDeleteProgram, glGetShaderiv, glLinkProgram, glValidateProgram

版權

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glGetProgramiv.xml

Copyright © 1991-2006 Silicon Graphics, Inc.本文件的許可是根據SGI Free Software B License.詳見http://oss.sgi.com/projects/FreeB/.