WasmGPU.python.free¶

Summary¶

WasmGPU.python.free returns the allocation for a kind: "heap" handle to the Wasm heap. Repeated calls with the same handle are safe and do not release the allocation twice. After the first call, view, bytes, copyInto, and receiveNdarray reject that freed handle; previously returned direct views must no longer be used. Calling free on frame or arena handles throws because those lifetimes are reset-driven.

Syntax¶

WasmGPU.python.free(handle: WasmNdarrayHandle): void
wgpu.python.free(handle);

Parameters¶

Name	Type	Required	Description
`handle`	`WasmNdarrayHandle`	Yes	Handle to free; must have `kind === "heap"`.

Returns¶

void - No value is returned.

Example¶

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

const handle = wgpu.python.sendNdarray(new Uint8Array([1, 2, 3]), { dtype: "u8", shape: [3], allocator: "heap" });
wgpu.python.free(handle);