GLPROGRAMBINARY(3G) [FIXME: manual] GLPROGRAMBINARY(3G)NAME
glProgramBinary - load a program object with a program binary
C SPECIFICATION
void glProgramBinary(GLuint program, GLenum binaryFormat, const void *binary, GLsizei length);
PARAMETERS
program
Specifies the name of a program object into which to load a program binary.
binaryFormat
Specifies the format of the binary data in binary.
binary
Specifies the address an array containing the binary to be loaded into program.
length
Specifies the number of bytes contained in binary.
DESCRIPTION
glProgramBinary loads a program object with a program binary previously returned from glGetProgramBinary(). binaryFormat and binary must
be those returned by a previous call to glGetProgramBinary(), and length must be the length returned by glGetProgramBinary(), or by
glGetProgram() when called with pname set to GL_PROGRAM_BINARY_LENGTH. If these conditions are not met, loading the program binary will
fail and program's GL_LINK_STATUS will be set to GL_FALSE.
A program object's program binary is replaced by calls to glLinkProgram() or glProgramBinary. When linking success or failure is concerned,
glProgramBinary can be considered to perform an implicit linking operation. glLinkProgram() and glProgramBinary both set the program
object's GL_LINK_STATUS to GL_TRUE or GL_FALSE.
A successful call to glProgramBinary will reset all uniform variables to their initial values. The initial value is either the value of the
variable's initializer as specified in the original shader source, or zero if no initializer was present. Additionally, all vertex shader
input and fragment shader output assignments that were in effect when the program was linked before saving are restored with
glProgramBinary is called.
ERRORS
GL_INVALID_OPERATION is generated if program is not the name of an existing program object.
GL_INVALID_ENUM is generated if binaryFormat is not a value recognized by the implementation.
NOTES
A program binary may fail to load if the implementation determines that there has been a change in hardware or software configuration from
when the program binary was produced such as having been compiled with an incompatible or outdated version of the compiler.
ASSOCIATED GETS
glGetProgram() with argument GL_PROGRAM_BINARY_LENGTH
glGet() with argument GL_NUM_PROGRAM_BINARY_FORMATS
glGet() with argument GL_PROGRAM_BINARY_FORMATS
SEE ALSO
glGetProgram(), glGetProgramBinary()
COPYRIGHT
Copyright (C) 2010 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. http://opencontent.org/openpub/.
[FIXME: source] 05/30/2012 GLPROGRAMBINARY(3G)
Check Out this Related Man Page
GLGETPROGRAM(3G) [FIXME: manual] GLGETPROGRAM(3G)NAME
glGetProgramiv - Returns a parameter from a program object
C SPECIFICATION
void glGetProgramiv(GLuint program, GLenum pname, GLint *params);
PARAMETERS
program
Specifies the program object to be queried.
pname
Specifies the object parameter. Accepted symbolic names are GL_DELETE_STATUS, GL_LINK_STATUS, GL_VALIDATE_STATUS, GL_INFO_LOG_LENGTH,
GL_ATTACHED_SHADERS, 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_PROGRAM_BINARY_LENGTH, GL_TRANSFORM_FEEDBACK_BUFFER_MODE,
GL_TRANSFORM_FEEDBACK_VARYINGS, GL_TRANSFORM_FEEDBACK_VARYING_MAX_LENGTH, GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE, and
GL_GEOMETRY_OUTPUT_TYPE.
params
Returns the requested object parameter.
DESCRIPTION
glGetProgram returns in params the value of a parameter for a specific program object. The following parameters are defined:
GL_DELETE_STATUS
params returns GL_TRUE if program is currently flagged for deletion, and GL_FALSE otherwise.
GL_LINK_STATUS
params returns GL_TRUE if the last link operation on program was successful, and GL_FALSE otherwise.
GL_VALIDATE_STATUS
params returns GL_TRUE or if the last validation operation on program was successful, 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_ATTACHED_SHADERS
params returns the number of shader objects attached to program.
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_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_PROGRAM_BINARY_LENGTH
params returns the length of the program binary, in bytes that will be returned by a call to glGetProgramBinary(). When a progam's
GL_LINK_STATUS is GL_FALSE, its program binary length is zero.
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_GEOMETRY_VERTICES_OUT
params returns the maximum number of vertices that the geometry shader in program will output.
GL_GEOMETRY_INPUT_TYPE
params returns a symbolic constant indicating the primitive type accepted as input to the geometry shader contained in program.
GL_GEOMETRY_OUTPUT_TYPE
params returns a symbolic constant indicating the primitive type that will be output by the geometry shader contained in program.
NOTES
GL_ACTIVE_UNIFORM_BLOCKS and GL_ACTIVE_UNIFORM_BLOCK_MAX_NAME_LENGTH are available only if the GL version 3.1 or greater.
GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE and GL_GEOMETRY_OUTPUT_TYPE are accepted only if the GL version is 3.2 or greater.
If an error is generated, no change is made to the contents of params.
ERRORS
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_OPERATION is generated if pname is GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE, or GL_GEOMETRY_OUTPUT_TYPE, and program
does not contain a geometry shader.
GL_INVALID_ENUM is generated if pname is not an accepted value.
ASSOCIATED GETS
glGetActiveAttrib() with argument program
glGetActiveUniform() with argument program
glGetAttachedShaders() with argument program
glGetProgramInfoLog() with argument program
glIsProgram()
SEE ALSO
glAttachShader(), glCreateProgram(), glDeleteProgram(), glGetShader(), glLinkProgram(), glValidateProgram()
COPYRIGHT
Copyright (C) 2003-2005 3Dlabs Inc. Ltd. Copyright (C) 2010-2011 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. http://opencontent.org/openpub/.
[FIXME: source] 05/30/2012 GLGETPROGRAM(3G)