WasmGPU.compute.createReadbackRing¶

Summary¶

WasmGPU.compute.createReadbackRing creates a dedicated staged readback helper for async GPU-to-CPU copies. A ring uses multiple staging slots so repeated readbacks can overlap more smoothly. Use this when you need frequent CPU readback of storage-buffer results without repeatedly creating temporary map-read buffers. Each created ring is independent from WasmGPU.compute.readback.

Syntax¶

WasmGPU.compute.createReadbackRing(desc?: ReadbackRingDescriptor): ReadbackRing
const ring = wgpu.compute.createReadbackRing(desc);

Parameters¶

Name	Type	Required	Description
`desc`	`ReadbackRingDescriptor`	No	Optional readback ring configuration including slot count and label prefix.

Returns¶

ReadbackRing - New readback ring instance.

Type Details¶

ReadbackRingDescriptor¶

type ReadbackRingDescriptor = {
    slots?: number;
    labelPrefix?: string;
};

Example¶

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

const ring = wgpu.compute.createReadbackRing({
    slots: 4,
    labelPrefix: "my-readback"
});

console.log(ring);