GridArt是一款 桌面图形界面（GUI）应用程序，用于将任意图片转换为手作网格图纸，适用于 拼豆（Perler Bead）、十字绣、钻石画、像素画 等多种手工创作场景。支持将生成的图纸导出为 PDF 文档 或 高清 PNG 图片，方便打印或分享。

【使用说明】

　　第一步 — 导入图片

　　点击顶部工具栏的 "导入图片" 按钮，在弹出的文件对话框中选择图片。

　　支持的图片格式：.png、.jpg、.jpeg、.bmp、.webp、.gif

　　图片加载后自动开始处理。

　　第二步 — 选择图纸格数（网格尺寸）

　　右侧面板的 "图纸格数" 卡片提供了以下预设选项：

　　小：29 格，适合 1 块拼豆板

　　中（默认）：48 格，入门推荐

　　大：58 格，适合 2 块拼豆板

　　特大：80 格，适合精细花纹

　　自定义    用户自定义    可分别输入宽度和高度（10–200 格）

　　选择 "自定义格数" 后会出现宽度和高度输入框，输入后点击 "应用" 按钮即可重新生成图纸。

　　非自定义模式下，系统会按照图片原始比例自动计算另一边的格数。

　　第三步 — 设置颜色数量

　　在 "颜色设置" 卡片中通过滑块调整颜色数：

　　范围： 2 – 64 种颜色

　　默认： 16 种

　　拖动滑块后自动重新进行颜色量化处理（内置 350ms 防抖，避免频繁重算）

　　滑块下方会实时显示 颜色调色板，展示每种颜色的符号标识、色块及对应的珠子数量

　　第四步 — 预览图纸

　　窗口左侧为 可缩放的图纸预览区：

　　每个格子显示为独立的色块

　　缩放至一定程度后（格子 ≥ 8px）自动显示网格线，每 5 格加粗，便于计数

　　缩放控制：

　　缩小 / 放大： 每次缩放 30%

　　自适应： 自动缩放以适应预览区域

　　缩放范围：50% – 2000%

　　"显示网格线" 复选框可手动开关网格线

【导出说明】

　　1、导出 PDF

　　点击 "导出 PDF" 按钮，选择保存路径后生成多页 A4 尺寸的 PDF 文件，包含：

　　封面页 — 包括：

　　标题："GridArt — 手作图纸"

　　原图缩略图

　　网格尺寸、总珠子数、颜色数量、生成日期

　　完整的颜色图例表（色块、符号、色号、中文颜色名、珠子数量、占比）

　　全图预览页 — 将整个图纸缩放至一页 A4 内，附带网格线

　　分页详细图纸 — 将大图纸拆分为多页（每页 36 列 × 54 行），每页包含：

　　页头标注行列范围

　　行号和列号标签

　　每个格子的颜色填充与字母符号

　　网格线（逐格细线 + 每 5 格加粗线）

　　底部附带当页颜色图例

　　2、导出 PNG

　　点击 "导出图片" 按钮，导出高清 PNG 图片：

　　每格渲染为 20×20 像素

　　每个格子内标注字母符号（深色背景白字、浅色背景黑字）

　　包含完整网格线

　　适合打印或在线分享

【颜色量化说明】

　　程序使用 KMeans 聚类算法 将图片颜色简化为指定数量的代表色：

　　颜色按使用频率从高到低排序（最常用的颜色分配符号 A，依次递推）

　　每种颜色自动匹配最接近的 中文颜色名（如"红色"、"天蓝色"等，约 31 种预设名称）

　　支持 64 个符号标识（A–Z、a–z、0–9、+、*）