glDispatchCompute — launch one or more compute work groups
void glDispatchCompute( | GLuint num_groups_x, |
| GLuint num_groups_y, | |
GLuint num_groups_z); |
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.
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. 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.
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.
glGet with argument GL_MAX_COMPUTE_WORK_GROUP_COUNT
| OpenGL Version | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 |
glDispatchCompute | - | - | - | - | - | - | - | - | - | ✔ | ✔ | ✔ |
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. https://opencontent.org/openpub/.