Function createUniformBuffer

src/renderers/rendererUtils.ts:191–215

(
  device: GPUDevice,
  size: number,
  options?: { readonly label?: string; readonly alignment?: number }
)

 *   `device.limits.minUniformBufferOffsetAlignment` (commonly 256). This helper does not enforce that.
 */
export function createUniformBuffer(
  device: GPUDevice,
  size: number,
  options?: { readonly label?: string; readonly alignment?: number }
): GPUBuffer {
  if (!Number.isFinite(size) || size <= 0) {
    throw new Error(`createUniformBuffer(size): size must be a positive number. Received: ${String(size)}`);
  }

  const alignment = options?.alignment ?? 16;
  const alignedSize = alignTo(size, Math.max(4, alignment));

  const maxSize = device.limits.maxUniformBufferBindingSize;
  if (alignedSize > maxSize) {
    throw new Error(
      `createUniformBuffer(size): requested size ${alignedSize} exceeds device.limits.maxUniformBufferBindingSize (${maxSize}).`
    );
  }

  return device.createBuffer({
    label: options?.label,
    size: alignedSize,
    usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
  });
}

/**
 * Writes CPU data into a uniform buffer (default offset 0).