GLCOMPILESHADER(3G)

📦
version 1.1 · 7 versions
, in centos-stream 9

💅 GLCOMPILESHADER 💅

okay so bestie, welcome to the GLCOMPILESHADER(3G) page — yes that 3G means it's an OpenGL manual page, and yes it's giving "I live in the graphics section of the library" ✨. Buckle up, we're compiling shaders fr fr.

🎀 NAME 🎀

glCompileShader — literally compiles a shader object. that's it, that's the whole vibe. 🫶

🌸 C SPECIFICATION 🌸

void glCompileShader(GLuint shader);

look at her. iconic. one parameter, no drama. 👑

🦋 PARAMETERS 🦋

  • shader — specifies the shader object to be compiled. that's the one, the main character we're about to send off to the compiler 💅

✨ DESCRIPTION ✨

okay so here's the tea: glCompileShader compiles the source code strings that have been stored in the shader object specified by shader. like, the strings you already dropped in there? those. they get compiled. slay. 🔥

the compilation status gets stored as part of the shader object's state, ngl that's kind of important. that value will be set to GL_TRUE if the shader was compiled without errors and is ready for use, and GL_FALSE otherwise 😭 (rip). you can query it by calling glGetShader() with arguments shader and GL_COMPILE_STATUS. that's the vibe check, iykyk.

compilation of a shader can fail for a number of reasons as specified by the OpenGL Shading Language Specification — so like, not our fault bestie, the spec said so. and whether or not the compilation was successful, information about the compilation can be obtained from the shader object's information log by calling glGetShaderInfoLog(). yes even when it ate. even when it flopped. the log is always there for you 💜

🌈 ERRORS 🌈

  • GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL. so if you made that number up?? rude. caught. 💀
  • GL_INVALID_OPERATION is generated if shader is not a shader object. wrong type bestie, wrong type 🙈

⭐ ASSOCIATED GETS ⭐

the little besties you can call along with this one:

  • glGetShaderInfoLog() with argument shader
  • glGetShader() with arguments shader and GL_COMPILE_STATUS
  • glIsShader()

👑 VERSION SUPPORT 👑

the function/feature name in question is glCompileShader, and she is supported in every single one of these OpenGL versions — all checks, no misses, we love a consistent queen:

  • OpenGL 2.0 — ✔
  • OpenGL 2.1 — ✔
  • OpenGL 3.0 — ✔
  • OpenGL 3.1 — ✔
  • OpenGL 3.2 — ✔
  • OpenGL 3.3 — ✔
  • OpenGL 4.0 — ✔
  • OpenGL 4.1 — ✔
  • OpenGL 4.2 — ✔
  • OpenGL 4.3 — ✔
  • OpenGL 4.4 — ✔
  • OpenGL 4.5 — ✔

twelve for twelve. periodt. 🎉

🍓 SEE ALSO 🍓

  • glCreateShader()
  • glLinkProgram()
  • glShaderSource()

(go read those next bestie, they're the prequel and the sequel 🧚)

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

and that's the whole page!! 🎀 source is [FIXME: source] and the date on this baddie is 08/09/2021 — go forth and compile responsibly, bestie, mwah 💋✨

📦 where this page comes from