Skip to content

WasmGPU.compute.workgroups1D

Summary

WasmGPU.compute.workgroups1D converts a 1D invocation count into dispatch workgroup counts. This helper applies ceiling division so all requested invocations are covered. If invocations is 0, it returns [0, 1, 1] to represent an empty dispatch. Use this for explicit command construction before dispatch or encodeDispatch.

Syntax

WasmGPU.compute.workgroups1D(invocations: number, workgroupSizeX: number): WorkgroupCounts
const workgroups = wgpu.compute.workgroups1D(invocations, workgroupSizeX);

Parameters

Name Type Required Description
invocations number Yes Total 1D logical thread count you want to process.
workgroupSizeX number Yes @workgroup_size X dimension declared in the WGSL kernel.

Returns

WorkgroupCounts - Three-component dispatch counts [x, y, z].

Type Details

type WorkgroupCounts = readonly [number, number, number];

Example

const canvas = document.querySelector("canvas");
const wgpu = await WasmGPU.create(canvas);

const invocations = 100000;
const groupSizeX = 256;
const workgroups = wgpu.compute.workgroups1D(invocations, groupSizeX);

console.log(workgroups);

See Also