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 © 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/.