Legacy Documentation: Version 2018.1 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

ComputeShader.Dispatch

Switch to Manual
public void Dispatch(int kernelIndex, int threadGroupsX, int threadGroupsY, int threadGroupsZ);

Parameters

kernelIndexWhich kernel to execute. A single compute shader asset can have multiple kernel entry points.
threadGroupsXNumber of work groups in the X dimension.
threadGroupsYNumber of work groups in the Y dimension.
threadGroupsZNumber of work groups in the Z dimension.

Description

Execute a compute shader.

This functions "runs" the compute shader, launching the indicated number of compute shader thread groups in the X, Y and Z dimensions. Within each work group, a number of shader invocations ("threads") are made. The work group size is specified in the compute shader itself (using "numthreads" HLSL attribute), and the total amount of compute shader invocations is thus group count multiplied by the thread group size. Work group size can be queried using GetKernelThreadGroupSizes function.

See Also: FindKernel, GetKernelThreadGroupSizes, DispatchIndirect, Compute Shaders.

Did you find this page useful? Please give it a rating: