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、+、*）