glProgramBinary man page on Oracle
[printable version]
GLPROGRAMBINARY(3G) OpenGL 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 © 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/.
AUTHORS
opengl.org
opengl.org 04/29/2014 GLPROGRAMBINARY(3G)
[top]
List of man pages available for Oracle
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|