Function writeUniformBuffer

src/renderers/rendererUtils.ts:226–245

(device: GPUDevice, buffer: GPUBuffer, data: BufferSource)

 * - `queue.writeBuffer()` requires write size (and offsets) to be multiples of 4 bytes.
 */
export function writeUniformBuffer(device: GPUDevice, buffer: GPUBuffer, data: BufferSource): void {
  const src =
    data instanceof ArrayBuffer
      ? { arrayBuffer: data, offset: 0, size: data.byteLength }
      : { arrayBuffer: data.buffer, offset: data.byteOffset, size: data.byteLength };

  if (src.size === 0) return;

  if ((src.offset & 3) !== 0 || (src.size & 3) !== 0) {
    throw new Error(
      `writeUniformBuffer(data): data byteOffset (${src.offset}) and byteLength (${src.size}) must be multiples of 4 for queue.writeBuffer().`
    );
  }

  if (src.size > buffer.size) {
    throw new Error(`writeUniformBuffer(data): data byteLength (${src.size}) exceeds buffer.size (${buffer.size}).`);
  }

  device.queue.writeBuffer(buffer, 0, src.arrayBuffer, src.offset, src.size);
}