glGetProgramiv — Returns a parameter from a program object
void glGetProgramiv(
|
GLuint program, |
GLenum pname, | |
GLint *params) ; |
program
Specifies the program object to be queried.
pname
Specifies the object parameter. Accepted
symbolic names are
GL_ACTIVE_ATOMIC_COUNTER_BUFFERS
,
GL_ACTIVE_ATTRIBUTES
,
GL_ACTIVE_ATTRIBUTE_MAX_LENGTH
,
GL_ACTIVE_UNIFORMS
,
GL_ACTIVE_UNIFORM_BLOCKS
,
GL_ACTIVE_UNIFORM_BLOCK_MAX_NAME_LENGTH
,
GL_ACTIVE_UNIFORM_MAX_LENGTH
,
GL_ATTACHED_SHADERS
,
GL_COMPUTE_WORK_GROUP_SIZE
,
GL_DELETE_STATUS
,
GL_INFO_LOG_LENGTH
,
GL_LINK_STATUS
,
GL_PROGRAM_BINARY_LENGTH
,
GL_PROGRAM_BINARY_RETRIEVABLE_HINT
,
GL_PROGRAM_SEPARABLE
,
GL_TRANSFORM_FEEDBACK_BUFFER_MODE
,
GL_TRANSFORM_FEEDBACK_VARYINGS
,
GL_TRANSFORM_FEEDBACK_VARYING_MAX_LENGTH
and
GL_VALIDATE_STATUS
.
params
Returns the requested object parameter.
glGetProgramiv
returns in params
the value of a parameter for a specific program object. The following parameters are defined:
GL_ACTIVE_ATOMIC_COUNTER_BUFFERS
params
returns the
number of active attribute atomic counter buffers used by
program
.
GL_ACTIVE_ATTRIBUTES
params
returns the
number of active attribute variables for
program
.
GL_ACTIVE_ATTRIBUTE_MAX_LENGTH
params
returns the
length of the longest active attribute name for
program
, including the null
termination character (i.e., the size of the
character buffer required to store the longest
attribute name). If no active attributes exist, 0 is
returned.
GL_ACTIVE_UNIFORM_BLOCKS
params
returns the
number of uniform blocks for program
containing active uniforms.
GL_ACTIVE_UNIFORM_BLOCK_MAX_NAME_LENGTH
params
returns the
length of the longest active uniform block name
for program
, including the
null termination character (i.e., the size of the
character buffer required to store the longest
uniform block name). If no active uniform
blocks exist, 0 is returned.
GL_ACTIVE_UNIFORMS
params
returns the
number of active uniform variables for
program
.
GL_ACTIVE_UNIFORM_MAX_LENGTH
params
returns the
length of the longest active uniform variable name
for program
, including the
null termination character (i.e., the size of the
character buffer required to store the longest
uniform variable name). If no active uniform
variables exist, 0 is returned.
GL_ATTACHED_SHADERS
params
returns the
number of shader objects attached to
program
.
GL_COMPUTE_WORK_GROUP_SIZE
params
returns an
array of three integers containing the local work group size of
the compute program as specified by its input layout qualifier(s).
program
must be the name of a program object
that has been previously linked successfully and contains a binary
for the compute shader stage.
GL_DELETE_STATUS
params
returns
GL_TRUE
if
program
is currently flagged
for deletion, and GL_FALSE
otherwise.
GL_INFO_LOG_LENGTH
params
returns the
number of characters in the information log for
program
including the null
termination character (i.e., the size of the
character buffer required to store the information
log). If program
has no
information log, a value of 0 is
returned.
GL_LINK_STATUS
params
returns
GL_TRUE
if the last link
operation on program
was
successful, and GL_FALSE
otherwise.
GL_PROGRAM_BINARY_LENGTH
params
returns the
length of the program binary that would be returned by
glGetProgramBinary.
GL_PROGRAM_BINARY_RETRIEVABLE_HINT
params
returns the
current value of whether the binary retrieval
hint is enabled for program
.
GL_PROGRAM_SEPARABLE
params
returns
GL_TRUE
if the program has been flagged
for use as a separable program object that can be bound to
individual shader stages with
glUseProgramStages.
GL_TRANSFORM_FEEDBACK_BUFFER_MODE
params
returns a symbolic constant
indicating the buffer mode used when transform feedback is active.
This may be GL_SEPARATE_ATTRIBS
or
GL_INTERLEAVED_ATTRIBS
.
GL_TRANSFORM_FEEDBACK_VARYINGS
params
returns the number of varying
variables to capture in transform feedback mode for the program.
GL_TRANSFORM_FEEDBACK_VARYING_MAX_LENGTH
params
returns the length of the longest
variable name to be used for transform feedback, including the null-terminator.
GL_VALIDATE_STATUS
params
returns
GL_TRUE
or if the last
validation operation on
program
was successful, and
GL_FALSE
otherwise.
If an error is generated, no change is made to the
contents of params
.
GL_INVALID_VALUE
is generated if program
is not a value generated by OpenGL.
GL_INVALID_OPERATION
is generated if program
does not refer to a program object.
GL_INVALID_ENUM
is generated if pname
is not an accepted value.
glGetActiveAttrib
with argument program
glGetActiveUniform
with argument program
glGetAttachedShaders
with argument program
glGetProgramInfoLog
with argument program
OpenGL ES API Version | |||
---|---|---|---|
Function Name | 2.0 | 3.0 | 3.1 |
glGetProgramiv | ✔ | ✔ | ✔ |
glAttachShader, glCreateProgram, glDeleteProgram, glGetProgramiv, glGetShaderiv, glLinkProgram, glValidateProgram
Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2020 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. https://opencontent.org/openpub/.