GLSHADERSOURCE(3G)

💅 GLSHADERSOURCE 💅

okay so welcome to the 3G manual page for glShaderSource, bestie. This is the one where OpenGL takes your shader source and just... copies it into the shader object. No parsing, no scanning, no little compiler goblin at this stage. ✨ iconic behavior ✨

🌸 NAME 🌸

glShaderSource — Replaces the source code in a shader object.

✨ C SPECIFICATION ✨

void glShaderSource(GLuint shader, GLsizei count, const GLchar **string,
                    const GLint *length);

🎀 PARAMETERS 🎀

• shader — the handle of the shader object whose source code is gonna be replaced. This is the main character here.
• count — how many elements are in the string and length arrays. Like, the group-chat member count.
• string — an array of pointers to strings that hold the source code you're loading into the shader.
• length — an array of string lengths.

🦋 DESCRIPTION 🦋

glShaderSource sets the source code in shader to the source code in the array of strings specified by string. Any source code that was already stored in the shader object is completely replaced — old source? gone, bestie. The number of strings in the array is specified by count.

If length is NULL, each string is assumed to be null terminated. If length is a value other than NULL, it points to an array containing a string length for each of the corresponding elements of string. Each element in the length array may contain the length of the corresponding string (the null character is not counted as part of the string length) or a value less than 0 to indicate that the string is null terminated. The source code strings are not scanned or parsed at this time; they are simply copied into the specified shader object. Periodt. 💅

🧚 NOTES 🧚

OpenGL copies the shader source code strings when glShaderSource is called, so an application may free its copy of the source code strings immediately after the function returns. That's the good stuff — no dangling source-string anxiety. 🫶

💀 ERRORS 💀

• GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.
• GL_INVALID_OPERATION is generated if shader is not a shader object.
• GL_INVALID_VALUE is generated if count is less than 0.

🔍 ASSOCIATED GETS 🔍

• glGetShader() with arguments shader and GL_SHADER_SOURCE_LENGTH
• glGetShaderSource() with argument shader
• glIsShader()

👑 VERSION SUPPORT 👑

The OpenGL Version columns are: 2.0, 2.1, 3.0, 3.1, 3.2, 3.3, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5.

For the Function / Feature Name row: glShaderSource has a ✔ in every single one of those versions. All of them. Every. Single. One. 👑✨

🌈 SEE ALSO 🌈

• glCompileShader()
• glCreateShader()
• glDeleteShader()

🎀 COPYRIGHT 🎀

Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2014 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/.

🎀 COPYRIGHT 🎀

Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2014 Khronos Group

---

okay bye bestie! This page is from the 3G manual, and its source/version is [FIXME: source], dated 08/09/2021. Go replace some shader source and slay. 💖✨