GLDISPATCHCOMPUTE(3G)

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

💖 NAME 💖

okay bestie, welcome to the GLDISPATCHCOMPUTE(3G) page — and yes, the header is literally over here saying [FIXME: manual], iconic behavior honestly. The function itself is glDispatchCompute, and it does exactly one main-character thing: launch one or more compute work groups. ✨

✨ C SPECIFICATION ✨

void glDispatchCompute(GLuint num_groups_x, GLuint num_groups_y,
                       GLuint num_groups_z);

🎀 PARAMETERS 🎀

  • num_groups_x — the number of work groups to be launched in the X dimension. 💅
  • num_groups_y — the number of work groups to be launched in the Y dimension. 💅
  • num_groups_z — the number of work groups to be launched in the Z dimension. 💅

🌸 DESCRIPTION 🌸

glDispatchCompute launches one or more compute work groups. Each work group is processed by the active program object for the compute shader stage. While the individual shader invocations within a work group are executed as a unit, work groups are executed completely independently and in unspecified order — no cap, they’re out here living their own lives. 🦋

num_groups_x, num_groups_y and num_groups_z specify the number of local work groups that will be dispatched in the X, Y and Z dimensions, respectively. 💖

💀 ERRORS 💀

  • GL_INVALID_OPERATION is generated if there is no active program for the compute shader stage. 😭
  • GL_INVALID_VALUE is generated if any of num_groups_x, num_groups_y, or num_groups_z is greater than or equal to the maximum work-group count for the corresponding dimension. 💀

👑 ASSOCIATED GETS 👑

glGet() with argument GL_MAX_COMPUTE_WORK_GROUP_COUNT. 👑

🌈 VERSION SUPPORT 🌈

The table’s function / feature name is literally glDispatchCompute, and the version columns are OpenGL Version. Here’s the full vibe check, bestie — no details skipped:

  • 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: ✔

so it’s giving “4.3 and up only,” periodt. 🔥

🦋 SEE ALSO 🦋

  • glDispatchComputeIndirect(). 🫶

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

okay bye bestie 🫶 this little page came from [FIXME: source], dated 08/09/2021, and it’s literally the GLDISPATCHCOMPUTE(3G) manual page — footer vibe check complete, periodt. 💜

📦 where this page comes from