v.read()

Use v.read() when JavaScript needs GPU results.

const result = await v.read(buffer);

Read Targets

v.read() accepts:

| Target | Result | | --- | --- | | Buffer | Typed array when possible, otherwise ArrayBuffer | | RawBuffer | ArrayBuffer | | Node | Record of declared outputs | | Handle | Result from the concrete buffer behind the handle | | ReadTarget[] | Array of results |

Reading a Buffer

const values = await v.read(buffer);
// Float32Array [...]

Primitive Buffer types return matching typed arrays when Volten can infer one.

Structured buffers return ArrayBuffer; use unpack() to decode them.

Reading a Node

Reading a node returns only declared outputs.

const kernel = new Kernel(`...`, {
    outputs: ['result']
});

const node = v.pass(kernel, { input, result });
v.run(node);

const outputs = await v.read(node);
// { result: Float32Array [...] }

If the kernel has no declared outputs, read a buffer or handle directly.

const data = await v.read(node.data);

Reading Multiple Targets

const [a, b] = await v.read([bufferA, nodeB.output]);

Volten deduplicates concrete buffers internally, so reading the same backing buffer through multiple handles does not copy it more than once.