glgetprogrambinary(3g) [debian man page]
GLGETPROGRAMBINARY(3G) [FIXME: manual] GLGETPROGRAMBINARY(3G) NAME
glGetProgramBinary - return a binary representation of a program object's compiled and linked executable source C SPECIFICATION
void glGetProgramBinary(GLuint program, GLsizei bufsize, GLsizei *length, GLenum *binaryFormat, void *binary); PARAMETERS
program Specifies the name of a program object whose binary representation to retrieve. bufSize Specifies the size of the buffer whose address is given by binary. length Specifies the address of a variable to receive the number of bytes written into binary. binaryFormat Specifies the address of a variable to receive a token indicating the format of the binary data returned by the GL. binary Specifies the address an array into which the GL will return program's binary representation. DESCRIPTION
glGetProgramBinary returns a binary representation of the compiled and linked executable for program into the array of bytes whose address is specified in binary. The maximum number of bytes that may be written into binary is specified by bufSize. If the program binary is greater in size than bufSize bytes, then an error is generated, otherwise the actual number of bytes written into binary is returned in the variable whose address is given by length. If length is NULL, then no length is returned. The format of the program binary written into binary is returned in the variable whose address is given by binaryFormat, and may be implementation dependent. The binary produced by the GL may subsequently be returned to the GL by calling glProgramBinary(), with binaryFormat and length set to the values returned by glGetProgramBinary, and passing the returned binary data in the binary parameter. ERRORS
GL_INVALID_OPERATION is generated if bufSize is less than the size of GL_PROGRAM_BINARY_LENGTH for program. GL_INVALID_OPERATION is generated if GL_LINK_STATUS for the program object is false. ASSOCIATED GETS
glGetProgram() with argument GL_PROGRAM_BINARY_LENGTH SEE ALSO
glGetProgram(), glProgramBinary() 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 GLGETPROGRAMBINARY(3G)
Check Out this Related Man Page
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)