Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

glprogrambinary(3g) [debian 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)

Check Out this Related Man Page

GLSHADERBINARY(3G)						   OpenGL Manual						GLSHADERBINARY(3G)

NAME

       glShaderBinary - load pre-compiled shader binaries

C SPECIFICATION

       void glShaderBinary(GLsizei count, const GLuint *shaders, GLenum binaryFormat, const void *binary, GLsizei length);

PARAMETERS

       count
	   Specifies the number of shader object handles contained in shaders.

       shaders
	   Specifies the address of an array of shader handles into which to load pre-compiled shader binaries.

       binaryFormat
	   Specifies the format of the shader binaries contained in binary.

       binary
	   Specifies the address of an array of bytes containing pre-compiled binary shader code.

       length
	   Specifies the length of the array whose address is given in binary.

DESCRIPTION

       glShaderBinary loads pre-compiled shader binary code into the count shader objects whose handles are given in shaders.  binary points to
       length bytes of binary shader code stored in client memory.  binaryFormat specifies the format of the pre-compiled code.

       The binary image contained in binary will be decoded according to the extension specification defining the specified binaryFormat token.
       OpenGL does not define any specific binary formats, but it does provide a mechanism to obtain token vaues for such formats provided by such
       extensions.

       Depending on the types of the shader objects in shaders, glShaderBinary will individually load binary vertex or fragment shaders, or load
       an executable binary that contains an optimized pair of vertex and fragment shaders stored in the same binary.

ERRORS

       GL_INVALID_OPERATION is generated if more than one of the handles in shaders refers to the same shader object.

       GL_INVALID_ENUM is generated if binaryFormat is not an accepted value.

       GL_INVALID_VALUE is generated if the data pointed to by binary does not match the format specified by binaryFormat.

ASSOCIATED GETS

       glGet() with parameter GL_NUM_SHADER_BINARY_FORMATS.

       glGet() with parameter GL_SHADER_BINARY_FORMATS.

SEE ALSO

       glGetProgram(), glGetProgramBinary(), 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/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014							GLSHADERBINARY(3G)
Man Page