使用与功能说明
项目简介
GridArt — 手作图纸工坊 V1.0 是一款 桌面图形界面（GUI）应用程序，用于将任意图片转换为手作网格图纸，适用于 拼豆（Perler Bead）、十字绣、钻石画、像素画 等多种手工创作场景。支持将生成的图纸导出为 PDF 文档 或 高清 PNG 图片，方便打印或分享。
启动方式
Windows 可执行文件：
直接双击 dist/GridArt.exe 即可运行。
本程序没有命令行参数，所有操作通过图形界面完成。
依赖项
| 依赖包 |
用途 |
| PyQt5 ≥ 5.15 |
图形界面框架 |
| Pillow ≥ 9.0 |
图片加载与处理 |
| numpy ≥ 1.21 |
像素数组运算 |
| scikit-learn ≥ 1.0 |
KMeans 颜色聚类（颜色量化） |
| reportlab ≥ 3.6 |
PDF 生成 |
使用流程
第一步 — 导入图片
点击顶部工具栏的 "导入图片" 按钮，在弹出的文件对话框中选择图片。
支持的图片格式：.png、.jpg、.jpeg、.bmp、.webp、.gif
图片加载后自动开始处理。
第二步 — 选择图纸格数（网格尺寸）
右侧面板的 "图纸格数" 卡片提供了以下预设选项：
| 预设 |
格数（最长边） |
适用场景 |
| 小 |
29 格 |
适合 1 块拼豆板 |
| 中（默认） |
48 格 |
入门推荐 |
| 大 |
58 格 |
适合 2 块拼豆板 |
| 特大 |
80 格 |
精细花纹 |
| 自定义 |
用户自定义 |
可分别输入宽度和高度（10–200 格） |
选择 "自定义格数" 后会出现宽度和高度输入框，输入后点击 "应用" 按钮即可重新生成图纸。
非自定义模式下，系统会按照图片原始比例自动计算另一边的格数。
第三步 — 设置颜色数量
在 "颜色设置" 卡片中通过滑块调整颜色数：
- 范围： 2 – 64 种颜色
- 默认： 16 种
- 拖动滑块后自动重新进行颜色量化处理（内置 350ms 防抖，避免频繁重算）
- 滑块下方会实时显示 颜色调色板，展示每种颜色的符号标识、色块及对应的珠子数量
第四步 — 预览图纸
窗口左侧为 可缩放的图纸预览区：
- 每个格子显示为独立的色块
- 缩放至一定程度后（格子 ≥ 8px）自动显示网格线，每 5 格加粗，便于计数
- 缩放控制：
- 缩小 / 放大： 每次缩放 30%
- 自适应： 自动缩放以适应预览区域
- 缩放范围：50% – 2000%
- "显示网格线" 复选框可手动开关网格线
统计信息
右侧面板的 "统计信息" 卡片显示以下数据：
| 项目 |
说明 |
| 总珠子数 |
网格总格数（宽 × 高） |
| 颜色种类 |
量化后的不同颜色数量 |
| 图纸尺寸 |
宽 × 高（格数） |
导出功能
导出 PDF
点击 "导出 PDF" 按钮，选择保存路径后生成多页 A4 尺寸的 PDF 文件，包含：
-
封面页 — 包括：
- 标题："GridArt — 手作图纸"
- 原图缩略图
- 网格尺寸、总珠子数、颜色数量、生成日期
- 完整的颜色图例表（色块、符号、色号、中文颜色名、珠子数量、占比）
-
全图预览页 — 将整个图纸缩放至一页 A4 内，附带网格线
-
分页详细图纸 — 将大图纸拆分为多页（每页 36 列 × 54 行），每页包含：
- 页头标注行列范围
- 行号和列号标签
- 每个格子的颜色填充与字母符号
- 网格线（逐格细线 + 每 5 格加粗线）
- 底部附带当页颜色图例
导出 PNG
点击 "导出图片" 按钮，导出高清 PNG 图片：
- 每格渲染为 20×20 像素
- 每个格子内标注字母符号（深色背景白字、浅色背景黑字）
- 包含完整网格线
- 适合打印或在线分享
颜色量化说明
程序使用 KMeans 聚类算法 将图片颜色简化为指定数量的代表色：
- 颜色按使用频率从高到低排序（最常用的颜色分配符号
A，依次递推）
- 每种颜色自动匹配最接近的 中文颜色名（如"红色"、"天蓝色"等，约 31 种预设名称）
- 支持 64 个符号标识（A–Z、a–z、0–9、+、*）
软件地址：
百度网盘：https://pan.baidu.com/s/1V5ICDGnSXIKaq6PMiyqXMQ 
提取码:8888
夸克网盘：https://pan.quark.cn/s/0c5d3033affa | 
发表于 2026-4-10 18:34
分享到朋友圈
实现了制作拼豆自由
