GL_WORKGROUPID(3G)

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

💅 GL_WORKGROUPID 💅

okay bestie, so this is a page from the 3G manual section and it's literally all about gl_WorkGroupID — the little built-in that tells your compute shader which workgroup it's currently vibing in. let's get into it ✨

🌸 NAME 🌸

gl_WorkGroupID — contains the index of the workgroup currently being operated on by a compute shader 🫶

🎀 DECLARATION 🎀

in uvec3 gl_WorkGroupID ;

(no cap, that's the whole decl — inside your shader, you just write gl_WorkGroupID and the compiler already knows her 💅)

✨ DESCRIPTION ✨

so, in the compute language, gl_WorkGroupID holds the 3-dimensional index of the global work group that the current compute shader invocation is executing within 🦋 like, the bigger bucket your invocation lives in, iykyk.

the possible values range across the parameters you pass into glDispatchCompute, okay? so it goes from (0, 0, 0) all the way up to (gl_NumWorkGroups.x - 1, gl_NumWorkGroups.y - 1, gl_NumWorkGroups.z - 1). that's the whole range, bestie — no sneaky extras 👑

🔥 VERSION SUPPORT 🔥

here's the vibe check on which GLSL versions support her — the original page lays this out in a big table, so let me translate it into something readable 🌈

  • 1.10 — nope, - 💀
  • 1.20 — nope, - 💀
  • 1.30 — nope, - 💀
  • 1.40 — nope, - 💀
  • 1.50 — nope, - 💀
  • 3.30 — nope, - 💀
  • 4.00 — nope, - 💀
  • 4.10 — nope, - 💀
  • 4.20 — nope, - 💀
  • 4.30 — YES, ✔ 🎉
  • 4.40 — YES, ✔ 🎉
  • 4.50 — YES, ✔ 🎉

so the variable name row is gl_WorkGroupID and the OpenGL Shading Language Version columns are the ones above — she shows up starting at 4.30 and stays iconic through 4.50 💖

🧚 SEE ALSO 🧚

  • gl_NumWorkGroups()
  • gl_WorkGroupID()
  • gl_LocalInvocationID()

Copyright © 2011-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 © 2012-2014 Khronos Group

and that's a wrap, bestie 🫶 this absolute icon of a page is sourced from [FIXME: source] and dated 08/09/2021 — go forth and dispatch those workgroups responsibly 💜🎀

📦 where this page comes from