Difference between revisions of "GLAPI/glCreateShaderProgram"

From OpenGL.org
Jump to: navigation, search
m (Bot: Adding better formatting.)
m (Bot: Adding better formatting.)
Line 57: Line 57:
 
== See Also ==
 
== See Also ==
  
{{apifunc|glCreateShader}}, {{apifunc|glCreateProgram}}, {{apifunc|glCompileShader}}, {{apifunc|glLinkProgram}}
+
{{apifunc|glCreateShader}}, {{apifunc|glCreateProgram}}, {{apifunc|glCompileShader}}, {{apifunc|glShaderSource}}, {{apifunc|glLinkProgram}}
  
 
== Copyright ==
 
== Copyright ==

Revision as of 15:32, 27 September 2012

glCreateShaderProgramv
Core in version 4.5
Core since version 4.1
Core ARB extension ARB_separate_shader_objects

glCreateShaderProgramv: create a stand-alone program from an array of null-terminated source code strings

Function Definition

 GLuint glCreateShaderProgramv(GLenum type​, GLsizei count​, const char **strings​);
type
Specifies the type of shader to create.
count
Specifies the number of source code strings in the array strings​.
strings
Specifies the address of an array of pointers to source code strings from which to create the program object.

Description

glCreateShaderProgram creates a program object containing compiled and linked shaders for a single stage specified by type​. strings​ refers to an array of count​ strings from which to create the shader executables.

glCreateShaderProgram is equivalent (assuming no errors are generated) to:


    const GLuint shader = glCreateShader(type);
    if (shader) {
        glShaderSource(shader, count, strings, NULL);
        glCompileShader(shader);
        const GLuint program = glCreateProgram();
        if (program) {
            GLint compiled = GL_FALSE;
            glGetShaderiv(shader, GL_COMPILE_STATUS, &compiled);
            glProgramParameteri(program, GL_PROGRAM_SEPARABLE, GL_TRUE);
            if (compiled) {
                glAttachShader(program, shader);
                glLinkProgram(program);
                glDetachShader(program, shader);
            }
            /* append-shader-info-log-to-program-info-log */
        }
        glDeleteShader(shader);
        return program;
    } else {
        return 0;
    }
The program object created by glCreateShaderProgram has its GL_PROGRAM_SEPARABLE status set to GL_TRUE.

Errors

GL_INVALID_OPERATION is generated if pipeline​ is not a name previously returned from a call to glGenProgramPipelines or if such a name has been deleted by a call to glDeleteProgramPipelines.

GL_INVALID_OPERATION is generated if program​ refers to a program object that has not been successfully linked.

See Also

glCreateShader, glCreateProgram, glCompileShader, glShaderSource, glLinkProgram

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