GLGETATTACHEDSHADERS(3G)

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

💅 GLGETATTACHEDSHADERS ✨

Okay bestie, so this is the tea on glGetAttachedShaders from the OpenGL fam — it's a <cyan>3G</cyan> manual page situation, and honestly it's giving "let me peek at your shader attachments" realness. No cap.

🌸 C SPECIFICATION 🌸

void glGetAttachedShaders(GLuint program, GLsizei maxCount,
                          GLsizei *count, GLuint *shaders);

Like, literally that's the whole signature. Slay.

🎀 PARAMETERS 🎀

  • program — this is the program object you're lowkey interrogating. The main character, if you will.
  • maxCount — the size of the array where you're storing the returned object names. It's giving "how much room did you make in your closet" energy.
  • count — returns the number of names actually returned in shaders. Like the receipts of how many shaders showed up. 💅
  • shaders — the array where the names of attached shader objects get returned. This is where the attached besties live.

🦋 DESCRIPTION 🦋

So glGetAttachedShaders returns the names of the shader objects attached to program. The names of shader objects attached to program get returned in shaders. The actual number of shader names written into shaders is returned in count. If no shader objects are attached to program, count is set to 0 — like an empty group chat, tragic but valid.

The maximum number of shader names that may be returned in shaders is specified by maxCount. Don't overflow it, bestie, that's not the vibe.

If the number of names actually returned is not required — say, for instance, if it has just been obtained by calling glGetProgram() — a value of NULL may be passed for count. Iconic flexibility, honestly. If no shader objects are attached to program, a value of 0 will be returned in count. The actual number of attached shaders can be obtained by calling glGetProgram() with the value GL_ATTACHED_SHADERS. Periodt.

💀 ERRORS 💀

Like, things can go wrong and here's the rundown:

  • GL_INVALID_VALUE is generated if program is not a value generated by OpenGL. Not me calling OpenGL with a fake ID 😭.
  • GL_INVALID_OPERATION is generated if program is not a program object. It's giving "you brought a shader to a program-only function" energy.
  • GL_INVALID_VALUE is generated if maxCount is less than 0. Negative maxCount is not it, bestie, just don't.

🔥 ASSOCIATED GETS 🔥

  • glGetProgram() with argument GL_ATTACHED_SHADERS
  • glIsProgram()

Like the linked accounts on your finsta, iykyk.

🌈 VERSION SUPPORT 🌈

Okay so here's the mood board — glGetAttachedShaders is supported in every single one of these OpenGL versions, no skips, no absences, full attendance:

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

The function name is glGetAttachedShaders, and the feature name is also glGetAttachedShaders. Consistent queen. 👑

👀 SEE ALSO 👀

  • glAttachShader()
  • glDetachShader()

The attach/detach duo — the on-again-off-again relationship of shader objects.

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

Okay bestie, that's the whole manual page — every detail preserved, every flag accounted for, all the vibes intact. No technical claims were invented, and nothing got skipped. We ate and left no crumbs. 💅✨

[FIXME: source] — 08/09/2021 — GLGETATTACHEDSHADERS(3G) — signing off, love you bestie, stay chromatically caffeinated 🎀🦋🌸

📦 where this page comes from