GLDISPATCHCOMPUTE

Section: [FIXME: manual] (3G)
Updated: 01/26/2021
Page Index
 

NAME

glDispatchCompute - 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. 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

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

 

SEE ALSO

glDispatchComputeIndirect().  

COPYRIGHT

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. m[blue]http://opencontent.org/openpub/m[].  

COPYRIGHT


Copyright © 2013-2014 Khronos Group

 

Index

NAME
C SPECIFICATION
PARAMETERS
DESCRIPTION
ERRORS
ASSOCIATED GETS
VERSION SUPPORT
SEE ALSO
COPYRIGHT
COPYRIGHT