Install
openclaw skills install perler-patternPerler Pattern
Convert any image into a perler/hama/fuse bead pattern. 把任意图片转换成精美的拼豆图纸。Use when the user wants to generate a bead pattern from a photo, image, or URL. Outpu...
Perler Bead Pattern Generator · 拼豆图纸生成器
把任意图片自动去背景，生成精美拼豆图纸。 内置 GrabCut 离线去背景，无需任何外部 API，零费用。
Palette reference → references/palettes.md
Style guide → references/styles.md
Trigger / 触发时机
- "Turn this photo into a perler bead pattern"
- "帮我把这张图片做成拼豆图纸"
- "Make a hama bead pattern from my pet photo"
- "把我家宠物的照片转成拼豆图纸"
- "Generate a 40×40 Artkal bead pattern"
- "用欧小色板生成拼豆图纸，深色背景"
Step 0: Dependency Check / 环境检查
# Check and install required packages
python3 -c "import cv2" 2>/dev/null || pip3 install opencv-python-headless --quiet
python3 -c "from PIL import Image" 2>/dev/null || pip3 install Pillow --quiet
python3 -c "import numpy" 2>/dev/null || pip3 install numpy --quiet
echo "✅ Ready"
Step 1: Extract Parameters / 提取参数
Image / 图片来源:
Local path 本地路径 or URL 网络链接
Grid size / 网格尺寸 (default 40×40):
"small" → 29×29 (one board / 一块板)
"medium" → 40×40 (default / 默认)
"large" → 48×48
"xlarge" → 64×64
Palette / 色板 (default: hama):
hama / artkal / perler / universal
Background color / 背景色 (default: dark_navy):
dark_navy → (15, 15, 40) 深海军蓝，最常见
black → (5, 5, 5) 纯黑
white → (255,255,255) 白色（适合浅色主体）
custom → 用户指定 RGB
Max colors / 颜色数 (default: 25):
"simple" → 15
"standard" → 25
"detailed" → 32
Step 2: Run / 执行脚本
Replace all __PARAM__ placeholders before running.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""Perler Bead Pattern Generator v1.2 — Auto background removal via GrabCut"""
import os, sys, json, math
import cv2
import numpy as np
from pathlib import Path
from PIL import Image, ImageEnhance, ImageFilter, ImageDraw
# ── Parameters (filled by OpenClaw) ──────────────────────
IMAGE_PATH = "__IMAGE_PATH__"
GRID_W = 40
GRID_H = 40
MAX_COLORS = 25
PALETTE_NAME = "hama" # hama / artkal / perler / universal
BG_COLOR = (15, 15, 40) # deep navy blue
OUTPUT_DIR = "__OUTPUT_DIR__"
# ── Guard ────────────────────────────────────────────────
if "__IMAGE_PATH__" in IMAGE_PATH or not IMAGE_PATH:
print("❌ IMAGE_PATH not set."); sys.exit(1)
os.makedirs(OUTPUT_DIR, exist_ok=True)
# ── Palettes ─────────────────────────────────────────────
PALETTES = {
"hama": {
"H01":("White/白", (255,255,255)), "H02":("Cream/奶油", (255,253,208)),
"H03":("Lt Yellow/淡黄", (255,239, 96)), "H04":("Yellow/黄", (255,216, 0)),
"H05":("Orange/橙", (255,140, 0)), "H06":("Red-Orange/橙红",(230, 75, 0)),
"H07":("Red/红", (210, 20, 20)), "H08":("Dark Red/暗红", (155, 0, 0)),
"H09":("Lt Pink/浅粉", (255,190,210)), "H10":("Pink/粉", (255,130,170)),
"H11":("Rose/玫红", (220, 45,120)), "H12":("Purple/紫", (128, 28,156)),
"H13":("Violet/紫罗兰", ( 88, 18,196)), "H14":("Lavender/薰衣草",(200,168,255)),
"H15":("Lt Blue/天蓝", (130,198,255)), "H16":("Blue/蓝", ( 0, 96,200)),
"H17":("Dark Blue/深蓝", ( 0, 28,138)), "H18":("Turquoise/青", ( 0,178,178)),
"H19":("Dark Green/深绿", ( 0, 88, 0)), "H20":("Green/绿", ( 28,158, 28)),
"H21":("Lime/黄绿", (146,218, 0)), "H22":("Mint/薄荷", (168,255,210)),
"H23":("Dark Brown/深棕", ( 78, 38, 0)), "H24":("Brown/棕", (138, 68, 18)),
"H25":("Tan/浅棕", (198,152, 88)), "H26":("Skin/肤色", (255,208,168)),
"H27":("Peach/桃", (255,178,140)), "H28":("Coral/珊瑚", (255,108,100)),
"H29":("Lt Grey/浅灰", (210,210,210)), "H30":("Grey/灰", (148,148,148)),
"H31":("Dark Grey/深灰", ( 78, 78, 78)), "H32":("Black/黑", ( 10, 10, 10)),
"H33":("Gold/金", (218,178, 0)), "H34":("Silver/银", (188,188,188)),
"H35":("Neon Yellow/荧光黄",(226,255,0)),"H36":("Neon Pink/荧光粉",(255,18,144)),
"H37":("Neon Green/荧光绿",( 0,252, 78)),"H38":("Neon Orange/荧光橙",(255,100,0)),
},
"artkal": {
"C01":("White/白",(255,255,255)),"C02":("Cream/奶油",(255,248,208)),
"C03":("Lt Yellow/淡黄",(255,232,88)),"C04":("Yellow/黄",(255,212,0)),
"C05":("Orange/橙",(255,138,0)),"C06":("Red-Orange/橙红",(228,68,0)),
"C07":("Red/红",(208,14,14)),"C08":("Dark Red/深红",(138,0,0)),
"C09":("Lt Pink/浅粉",(255,172,192)),"C10":("Rose/玫红",(222,38,118)),
"C11":("Purple/紫",(118,24,152)),"C12":("Dark Purple/深紫",(78,0,118)),
"C13":("Sky Blue/天蓝",(128,192,255)),"C14":("Blue/蓝",(0,88,192)),
"C15":("Navy/深蓝",(0,18,128)),"C16":("Cyan/青",(0,172,172)),
"C17":("Green/绿",(24,152,24)),"C18":("Dark Green/深绿",(0,78,0)),
"C19":("Yellow-Green/黄绿",(138,212,0)),"C20":("Brown/棕",(132,62,14)),
"C21":("Dark Brown/深棕",(72,32,0)),"C22":("Tan/浅棕",(192,148,82)),
"C23":("Skin/肤色",(248,202,162)),"C24":("Coral/珊瑚",(248,122,102)),
"C25":("Lt Grey/浅灰",(208,208,208)),"C26":("Grey/灰",(142,142,142)),
"C27":("Dark Grey/深灰",(72,72,72)),"C28":("Black/黑",(4,4,4)),
"C29":("Gold/金",(212,172,0)),"C30":("Lavender/薰衣草",(202,172,248)),
},
"perler": {
"P01":("White/白",(255,255,255)),"P02":("Cream/奶油",(255,246,218)),
"P03":("Yellow/黄",(255,222,0)),"P04":("Orange/橙",(255,118,0)),
"P05":("Red/红",(212,0,14)),"P06":("Lt Pink/浅粉",(255,168,188)),
"P07":("Pink/粉",(255,108,158)),"P08":("Rose/玫红",(218,42,118)),
"P09":("Purple/紫",(122,28,152)),"P10":("Lt Blue/天蓝",(122,188,255)),
"P11":("Blue/蓝",(0,82,188)),"P12":("Dark Blue/深蓝",(0,22,128)),
"P13":("Teal/青",(0,162,162)),"P14":("Green/绿",(18,148,18)),
"P15":("Dark Green/深绿",(0,72,0)),"P16":("Kiwi/黄绿",(142,208,0)),
"P17":("Brown/棕",(128,58,8)),"P18":("Peach/桃",(255,198,158)),
"P19":("Lt Grey/浅灰",(208,208,208)),"P20":("Grey/灰",(138,138,138)),
"P21":("Black/黑",(0,0,0)),"P22":("Gold/金",(208,168,0)),
"P23":("Silver/银",(182,182,182)),"P24":("Clear/透明",(238,238,238)),
},
"universal": {
"U01":("White/白",(255,255,255)),"U02":("Ivory/米白",(255,248,210)),
"U03":("Lt Yellow/浅黄",(255,238,82)),"U04":("Yellow/黄",(255,212,0)),
"U05":("Amber/琥珀",(222,178,0)),"U06":("Lt Orange/浅橙",(255,168,58)),
"U07":("Orange/橙",(255,110,0)),"U08":("Dk Orange/深橙",(218,68,0)),
"U09":("Salmon/鲑鱼",(255,120,100)),"U10":("Red/红",(210,0,0)),
"U11":("Dark Red/深红",(138,0,0)),"U12":("Lt Pink/浅粉",(255,198,212)),
"U13":("Pink/粉",(255,148,178)),"U14":("Hot Pink/玫红",(218,38,118)),
"U15":("Magenta/品红",(198,0,148)),"U16":("Lavender/薰衣草",(208,178,255)),
"U17":("Purple/紫",(128,28,158)),"U18":("Dk Purple/深紫",(78,0,118)),
"U19":("Baby Blue/婴儿蓝",(178,222,255)),"U20":("Sky Blue/天蓝",(98,178,255)),
"U21":("Blue/蓝",(0,88,198)),"U22":("Dark Blue/深蓝",(0,22,138)),
"U23":("Cyan/青",(0,178,178)),"U24":("Dark Cyan/深青",(0,118,118)),
"U25":("Lt Green/浅绿",(148,228,148)),"U26":("Green/绿",(28,158,28)),
"U27":("Dark Green/深绿",(0,88,0)),"U28":("Yellow Green/黄绿",(152,222,0)),
"U29":("Lt Brown/浅棕",(208,168,108)),"U30":("Brown/棕",(148,78,22)),
"U31":("Dark Brown/深棕",(88,42,0)),"U32":("Skin/肤色",(255,208,168)),
"U33":("Peach/桃",(255,178,138)),"U34":("Lt Grey/浅灰",(208,208,208)),
"U35":("Grey/灰",(148,148,148)),"U36":("Dark Grey/深灰",(78,78,78)),
"U37":("Black/黑",(4,4,4)),"U38":("Gold/金",(218,178,0)),
"U39":("Silver/银",(190,190,190)),"U40":("Neon Yellow/荧光黄",(228,255,0)),
"U41":("Neon Pink/荧光粉",(255,18,144)),"U42":("Neon Green/荧光绿",(0,252,78)),
}
}
# ── Color math: Lab color space ───────────────────────────
def rgb_to_lab(rgb):
r,g,b = [c/255.0 for c in rgb]
def lin(c): return c/12.92 if c<=0.04045 else ((c+0.055)/1.055)**2.4
r,g,b = lin(r),lin(g),lin(b)
X=r*0.4124564+g*0.3575761+b*0.1804375
Y=r*0.2126729+g*0.7151522+b*0.0721750
Z=r*0.0193339+g*0.1191920+b*0.9503041
X/=0.95047; Z/=1.08883
def f(t): return t**(1/3) if t>0.008856 else 7.787*t+16/116
fx,fy,fz=f(X),f(Y),f(Z)
return 116*fy-16, 500*(fx-fy), 200*(fy-fz)
def lab_dist(a,b): return sum((x-y)**2 for x,y in zip(a,b))**0.5
def build_lab_pal(palette):
return {code:(info[0],info[1],rgb_to_lab(info[1])) for code,info in palette.items()}
def nearest_color(rgb, lab_pal):
lab=rgb_to_lab(rgb)
best,dist=None,float('inf')
for code,(_,pal_rgb,pal_lab) in lab_pal.items():
d=lab_dist(lab,pal_lab)
if d<dist: dist,best=d,code
_,pal_rgb,_=lab_pal[best]
return best,pal_rgb
# ── Load image ────────────────────────────────────────────
def load_image(path):
if path.startswith(("http://","https://")):
import urllib.request,tempfile
ext=".jpg" if "jpg" in path.lower() else ".png"
tmp=tempfile.mktemp(suffix=ext)
urllib.request.urlretrieve(path,tmp)
path=tmp
return cv2.cvtColor(cv2.imread(path), cv2.COLOR_BGR2RGB)
# ── Auto background removal (GrabCut, fully offline) ─────
def remove_background(img_rgb, bg_color=(15,15,40)):
h,w=img_rgb.shape[:2]
# Init rect: 10% margins, avoids edge artifacts
mx,my=int(w*0.10),int(h*0.08)
rect=(mx,my,w-2*mx,h-2*my)
mask=np.zeros((h,w),np.uint8)
bgd=np.zeros((1,65),np.float64)
fgd=np.zeros((1,65),np.float64)
cv2.grabCut(img_rgb,mask,rect,bgd,fgd,7,cv2.GC_INIT_WITH_RECT)
fg=np.where((mask==cv2.GC_FGD)|(mask==cv2.GC_PR_FGD),255,0).astype(np.uint8)
# Smooth edges
fg=cv2.GaussianBlur(fg,(3,3),0)
_,fg=cv2.threshold(fg,128,255,cv2.THRESH_BINARY)
# Fill holes, remove specks
fg=cv2.morphologyEx(fg,cv2.MORPH_CLOSE,np.ones((9,9),np.uint8))
fg=cv2.morphologyEx(fg,cv2.MORPH_OPEN, np.ones((3,3),np.uint8))
result=img_rgb.copy()
result[fg==0]=bg_color
return result
# ── Resize center-crop ────────────────────────────────────
def resize_crop(img_rgb,w,h):
ih,iw=img_rgb.shape[:2]
scale=max(w/iw,h/ih)
nw,nh=math.ceil(iw*scale),math.ceil(ih*scale)
img_pil=Image.fromarray(img_rgb).resize((nw,nh),Image.LANCZOS)
left=(nw-w)//2; top=(nh-h)//2
return np.array(img_pil.crop((left,top,left+w,top+h)))
# ── Lab-based brightness equalization ────────────────────
def lab_equalize(arr):
def r2l(a):
rgb=a.astype(np.float32)/255.0
m=rgb>0.04045
rgb=np.where(m,((rgb+0.055)/1.055)**2.4,rgb/12.92)
M=np.array([[0.4124564,0.3575761,0.1804375],[0.2126729,0.7151522,0.0721750],[0.0193339,0.1191920,0.9503041]])
xyz=rgb@M.T/[0.95047,1,1.08883]
m2=xyz>0.008856
xyz=np.where(m2,xyz**(1/3),7.787*xyz+16/116)
return np.stack([116*xyz[:,:,1]-16,500*(xyz[:,:,0]-xyz[:,:,1]),200*(xyz[:,:,1]-xyz[:,:,2])],2)
def l2r(lab):
L,a,b=lab[:,:,0],lab[:,:,1],lab[:,:,2]
fy=(L+16)/116;fx=a/500+fy;fz=fy-b/200
xyz=np.stack([fx,fy,fz],2)
m=xyz>0.2068966
xyz=np.where(m,xyz**3,(xyz-16/116)/7.787)*[0.95047,1,1.08883]
Mi=np.array([[3.2404542,-1.5371385,-0.4985314],[-0.9692660,1.8760108,0.0415560],[0.0556434,-0.2040259,1.0572252]])
rgb=np.clip(xyz@Mi.T,0,1)
m2=rgb>0.0031308
return np.clip(np.where(m2,1.055*rgb**(1/2.4)-0.055,12.92*rgb)*255,0,255).astype(np.uint8)
lab=r2l(arr)
L=lab[:,:,0]
p2,p98=np.percentile(L,2),np.percentile(L,98)
if p98-p2>5:
lab[:,:,0]=np.clip((L-p2)/(p98-p2)*100,0,100)
return l2r(lab)
# ── Map pixels to palette ─────────────────────────────────
def map_to_palette(arr,lab_pal,max_colors):
h,w=arr.shape[:2]
cache={}
grid=[[None]*w for _ in range(h)]
usage={}
for y in range(h):
for x in range(w):
rgb=tuple(arr[y,x])
if rgb not in cache:
code,pal_rgb=nearest_color(rgb,lab_pal)
name=lab_pal[code][0]
cache[rgb]=(code,name,pal_rgb)
code,name,pal_rgb=cache[rgb]
grid[y][x]=code
if code not in usage:
usage[code]={"name":name,"rgb":pal_rgb,"count":0}
usage[code]["count"]+=1
# Enforce max_colors: merge least-used into nearest
while len(usage)>max_colors:
least=min(usage,key=lambda c:usage[c]["count"])
ll=rgb_to_lab(usage[least]["rgb"])
best_alt,bd=None,float('inf')
for c in usage:
if c==least: continue
d=lab_dist(ll,rgb_to_lab(usage[c]["rgb"]))
if d<bd: bd,best_alt=d,c
for y in range(h):
for x in range(w):
if grid[y][x]==least: grid[y][x]=best_alt
usage[best_alt]["count"]+=usage[least]["count"]
del usage[least]
grid_rgb=np.zeros((h,w,3),dtype=np.uint8)
for y in range(h):
for x in range(w):
grid_rgb[y,x]=usage[grid[y][x]]["rgb"]
return grid,grid_rgb,usage
# ── SVG output ────────────────────────────────────────────
def gen_svg(grid,usage,cell=16):
rows,cols=len(grid),len(grid[0])
W,H=cols*cell,rows*cell
fs=max(5,cell//3)
L=['<?xml version="1.0" encoding="UTF-8"?>',
f'<svg xmlns="http://www.w3.org/2000/svg" width="{W}" height="{H}" viewBox="0 0 {W} {H}">',
f'<style>text{{font-family:Arial;font-size:{fs}px;}}</style>']
for y,row in enumerate(grid):
for x,code in enumerate(row):
r,g,b=usage[code]["rgb"]
fill=f"#{r:02x}{g:02x}{b:02x}"
lum=0.299*r+0.587*g+0.114*b
tc="#fff" if lum<128 else "#000"
px,py=x*cell,y*cell
L.append(f'<rect x="{px}" y="{py}" width="{cell}" height="{cell}" fill="{fill}" stroke="#ccc" stroke-width="0.4"/>')
if cell>=10:
num=''.join(c for c in code if c.isdigit())
L.append(f'<text x="{px+cell//2}" y="{py+cell//2}" fill="{tc}" text-anchor="middle" dominant-baseline="central">{num}</text>')
for i in range(0,cols+1,10): L.append(f'<line x1="{i*cell}" y1="0" x2="{i*cell}" y2="{H}" stroke="#888" stroke-width="0.8"/>')
for i in range(0,rows+1,10): L.append(f'<line x1="0" y1="{i*cell}" x2="{W}" y2="{i*cell}" stroke="#888" stroke-width="0.8"/>')
L.append(f'<rect x="0" y="0" width="{W}" height="{H}" fill="none" stroke="#222" stroke-width="1.5"/>')
L.append('</svg>')
return '\n'.join(L)
# ── 3D Bead preview PNG ───────────────────────────────────
def gen_bead_preview(arr_q,bg_color,cell=20):
rows,cols=arr_q.shape[:2]
canvas=Image.new("RGB",(cols*cell,rows*cell),bg_color)
draw=ImageDraw.Draw(canvas)
for y in range(rows):
for x in range(cols):
r,g,b=int(arr_q[y,x,0]),int(arr_q[y,x,1]),int(arr_q[y,x,2])
cx,cy=x*cell+cell//2,y*cell+cell//2
pad=1
# Main bead body
draw.ellipse([cx-cell//2+pad,cy-cell//2+pad,cx+cell//2-pad,cy+cell//2-pad],fill=(r,g,b))
# Bottom-right shadow (same hue, darker)
dark=(max(0,r-55),max(0,g-55),max(0,b-55))
draw.arc([cx-cell//2+pad+1,cy-cell//2+pad+1,cx+cell//2-pad-1,cy+cell//2-pad-1],
start=30,end=210,fill=dark,width=2)
# Top-left highlight (lighter)
hs=cell//5
hi=(min(255,r+90),min(255,g+90),min(255,b+90))
draw.ellipse([cx-hs,cy-hs,cx,cy],fill=hi)
return canvas
# ── Interactive HTML viewer ───────────────────────────────
def gen_html(grid,usage,palette_name,bg_color):
rows,cols=len(grid),len(grid[0])
total=sum(v["count"] for v in usage.values())
bg_hex="#{:02x}{:02x}{:02x}".format(*bg_color)
cells_js=json.dumps([[grid[y][x] for x in range(cols)] for y in range(rows)])
colors_js=json.dumps([
{"code":c,"name":v["name"],"hex":"#{:02x}{:02x}{:02x}".format(*v["rgb"]),"count":v["count"]}
for c,v in sorted(usage.items(),key=lambda x:-x[1]["count"])
])
return f"""<!DOCTYPE html>
<html lang="en"><head>
<meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>Perler Pattern · 拼豆图纸 {cols}×{rows}</title>
<style>
*{{box-sizing:border-box;margin:0;padding:0}}
body{{font-family:'PingFang SC','Segoe UI',Arial,sans-serif;background:#f0f0f0}}
header{{background:linear-gradient(135deg,#6c63ff,#3ec6e0);color:#fff;padding:18px 24px}}
header h1{{font-size:20px;margin-bottom:3px}}
header p{{font-size:12px;opacity:.85}}
.wrap{{max-width:1280px;margin:0 auto;padding:16px}}
.bar{{background:#fff;border-radius:10px;padding:12px 16px;margin-bottom:12px;
box-shadow:0 2px 8px rgba(0,0,0,.07);display:flex;gap:14px;align-items:center;flex-wrap:wrap}}
.bar label{{font-size:13px;color:#555;display:flex;align-items:center;gap:6px}}
input[type=range]{{width:100px}}
.btn{{padding:7px 14px;border-radius:7px;border:none;cursor:pointer;font-size:13px;font-weight:600}}
.btn-p{{background:#6c63ff;color:#fff}}.btn-s{{background:#e8e8e8;color:#333}}
.btn:hover{{opacity:.85}}
.layout{{display:grid;grid-template-columns:1fr 290px;gap:12px}}
@media(max-width:780px){{.layout{{grid-template-columns:1fr}}}}
.cbox{{background:#fff;border-radius:10px;padding:14px;box-shadow:0 2px 8px rgba(0,0,0,.07);overflow:auto}}
canvas{{cursor:crosshair;display:block}}
.side{{display:flex;flex-direction:column;gap:12px}}
.card{{background:#fff;border-radius:10px;padding:14px;box-shadow:0 2px 8px rgba(0,0,0,.07)}}
.card h3{{font-size:13px;font-weight:700;color:#333;margin-bottom:10px}}
.stats{{display:grid;grid-template-columns:1fr 1fr;gap:8px}}
.stat{{background:#f7f7f7;border-radius:8px;padding:10px;text-align:center}}
.stat-n{{font-size:18px;font-weight:700;color:#6c63ff}}
.stat-l{{font-size:10px;color:#888;margin-top:2px}}
.clist{{max-height:420px;overflow-y:auto}}
.ci{{display:flex;align-items:center;gap:8px;padding:5px 4px;border-bottom:1px solid #f0f0f0;cursor:pointer;border-radius:5px}}
.ci:hover{{background:#f5f5ff}}.ci.active{{background:#eeeeff;outline:2px solid #6c63ff}}
.sw{{width:22px;height:22px;border-radius:4px;border:1px solid #ddd;flex-shrink:0}}
.cc{{font-size:10px;font-weight:700;color:#6c63ff;width:38px}}
.cn{{font-size:11px;color:#555;flex:1;line-height:1.3}}
.cnt{{font-size:10px;color:#999;white-space:nowrap}}
.tip{{position:fixed;background:rgba(30,30,30,.88);color:#fff;padding:6px 10px;border-radius:6px;
font-size:11px;pointer-events:none;display:none;z-index:999;line-height:1.5}}
@media print{{header,.bar,.side{{display:none!important}}
.wrap{{padding:0;max-width:100%}}.cbox{{box-shadow:none;padding:0;border-radius:0}}}}
</style></head><body>
<header>
<h1>🧩 Perler Bead Pattern · 拼豆图纸</h1>
<p>{cols}×{rows} · {palette_name.upper()} · {len(usage)} colors · {total:,} beads</p>
</header>
<div class="wrap">
<div class="bar">
<label>Cell 格子 <input type="range" id="sz" min="6" max="32" value="14"><span id="szv">14px</span></label>
<label><input type="checkbox" id="nums" checked> Numbers 编号</label>
<label><input type="checkbox" id="grid" checked> Grid 网格</label>
<button class="btn btn-p" onclick="dlSVG()">⬇ SVG</button>
<button class="btn btn-p" onclick="dlPNG()">⬇ PNG</button>
<button class="btn btn-s" onclick="window.print()">🖨 Print</button>
<button class="btn btn-s" onclick="hl=null;draw()">✖ Clear</button>
</div>
<div class="layout">
<div class="cbox"><canvas id="c"></canvas></div>
<div class="side">
<div class="card">
<h3>📊 Stats · 统计</h3>
<div class="stats">
<div class="stat"><div class="stat-n">{cols}×{rows}</div><div class="stat-l">Grid 网格</div></div>
<div class="stat"><div class="stat-n">{total:,}</div><div class="stat-l">Beads 豆数</div></div>
<div class="stat"><div class="stat-n">{len(usage)}</div><div class="stat-l">Colors 颜色</div></div>
<div class="stat"><div class="stat-n" style="font-size:13px">{palette_name.upper()}</div><div class="stat-l">Palette 色板</div></div>
</div>
</div>
<div class="card">
<h3>🎨 Bead List · 用豆清单</h3>
<div class="clist" id="cl"></div>
</div>
</div></div></div>
<div class="tip" id="tip"></div>
<script>
const CELLS={cells_js},COLORS={colors_js};
const ROWS={rows},COLS={cols},BG="{bg_hex}";
const canvas=document.getElementById('c'),ctx=canvas.getContext('2d');
const tip=document.getElementById('tip');
let cell=14,showN=true,showG=true,hl=null;
function draw(){{
canvas.width=COLS*cell;canvas.height=ROWS*cell;
ctx.fillStyle=BG;ctx.fillRect(0,0,canvas.width,canvas.height);
for(let y=0;y<ROWS;y++)for(let x=0;x<COLS;x++){{
const code=CELLS[y][x],ci=COLORS.find(c=>c.code===code);
ctx.fillStyle=(hl&&code!==hl)?'rgba(128,128,128,0.3)':ci.hex;
ctx.fillRect(x*cell,y*cell,cell,cell);
if(showG){{ctx.strokeStyle='rgba(0,0,0,0.15)';ctx.lineWidth=.4;ctx.strokeRect(x*cell,y*cell,cell,cell);}}
if(showN&&cell>=10){{
const lum=parseInt(ci.hex.slice(1,3),16)*.299+parseInt(ci.hex.slice(3,5),16)*.587+parseInt(ci.hex.slice(5,7),16)*.114;
ctx.fillStyle=lum<128?'#fff':'#000';
ctx.font=`${{Math.max(5,Math.floor(cell/3))}}px Arial`;
ctx.textAlign='center';ctx.textBaseline='middle';
ctx.fillText(code.replace(/\\D/g,''),x*cell+cell/2,y*cell+cell/2);
}}
}}
ctx.strokeStyle='#888';ctx.lineWidth=.9;
for(let i=0;i<=COLS;i+=10){{ctx.beginPath();ctx.moveTo(i*cell,0);ctx.lineTo(i*cell,ROWS*cell);ctx.stroke();}}
for(let i=0;i<=ROWS;i+=10){{ctx.beginPath();ctx.moveTo(0,i*cell);ctx.lineTo(COLS*cell,i*cell);ctx.stroke();}}
ctx.strokeStyle='#333';ctx.lineWidth=1.8;ctx.strokeRect(0,0,COLS*cell,ROWS*cell);
}}
function buildList(){{
document.getElementById('cl').innerHTML=COLORS.map(c=>`
<div class="ci" id="ci_${{c.code}}" onclick="toggleHL('${{c.code}}')">
<div class="sw" style="background:${{c.hex}}"></div>
<div class="cc">${{c.code}}</div><div class="cn">${{c.name}}</div>
<div class="cnt">${{c.count.toLocaleString()}}</div>
</div>`).join('');
}}
function toggleHL(code){{
hl=(hl===code)?null:code;
document.querySelectorAll('.ci').forEach(e=>e.classList.remove('active'));
if(hl)document.getElementById('ci_'+code)?.classList.add('active');
draw();
}}
canvas.addEventListener('mousemove',e=>{{
const r=canvas.getBoundingClientRect(),x=Math.floor((e.clientX-r.left)/cell),y=Math.floor((e.clientY-r.top)/cell);
if(x>=0&&x<COLS&&y>=0&&y<ROWS){{
const code=CELLS[y][x],ci=COLORS.find(c=>c.code===code);
tip.style.display='block';tip.style.left=(e.clientX+14)+'px';tip.style.top=(e.clientY-10)+'px';
tip.innerHTML=`<b>${{code}}</b> ${{ci.name}}<br>(${{x+1}},${{y+1}}) · ${{ci.count}} beads`;
}}
}});
canvas.addEventListener('mouseleave',()=>tip.style.display='none');
document.getElementById('sz').addEventListener('input',e=>{{cell=+e.target.value;document.getElementById('szv').textContent=cell+'px';draw();}});
document.getElementById('nums').addEventListener('change',e=>{{showN=e.target.checked;draw();}});
document.getElementById('grid').addEventListener('change',e=>{{showG=e.target.checked;draw();}});
function dlSVG(){{
const fs=Math.max(5,Math.floor(cell/3));
let s=`<svg xmlns="http://www.w3.org/2000/svg" width="${{COLS*cell}}" height="${{ROWS*cell}}" viewBox="0 0 ${{COLS*cell}} ${{ROWS*cell}}">`;
s+=`<style>text{{font-family:Arial;font-size:${{fs}}px;}}</style>`;
s+=`<rect width="${{COLS*cell}}" height="${{ROWS*cell}}" fill="{bg_hex}"/>`;
for(let y=0;y<ROWS;y++)for(let x=0;x<COLS;x++){{
const code=CELLS[y][x],ci=COLORS.find(c=>c.code===code);
const lum=parseInt(ci.hex.slice(1,3),16)*.299+parseInt(ci.hex.slice(3,5),16)*.587+parseInt(ci.hex.slice(5,7),16)*.114;
const tc=lum<128?'#fff':'#000',px=x*cell,py=y*cell;
s+=`<rect x="${{px}}" y="${{py}}" width="${{cell}}" height="${{cell}}" fill="${{ci.hex}}" stroke="rgba(0,0,0,0.15)" stroke-width="0.4"/>`;
if(cell>=10){{const num=code.replace(/\\D/g,'');s+=`<text x="${{px+cell/2}}" y="${{py+cell/2}}" fill="${{tc}}" text-anchor="middle" dominant-baseline="central">${{num}}</text>`;}}
}}
for(let i=0;i<=COLS;i+=10)s+=`<line x1="${{i*cell}}" y1="0" x2="${{i*cell}}" y2="${{ROWS*cell}}" stroke="#888" stroke-width="0.8"/>`;
for(let i=0;i<=ROWS;i+=10)s+=`<line x1="0" y1="${{i*cell}}" x2="${{COLS*cell}}" y2="${{i*cell}}" stroke="#888" stroke-width="0.8"/>`;
s+=`<rect x="0" y="0" width="${{COLS*cell}}" height="${{ROWS*cell}}" fill="none" stroke="#333" stroke-width="1.8"/>`;
s+='</svg>';
const a=document.createElement('a');a.href='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(s);a.download='perler.svg';a.click();
}}
function dlPNG(){{const a=document.createElement('a');a.href=canvas.toDataURL('image/png');a.download='perler.png';a.click();}}
draw();buildList();
</script></body></html>"""
# ── Bead list text ────────────────────────────────────────
def gen_bead_list(usage,palette_name,gw,gh):
total=sum(v["count"] for v in usage.values())
lines=[f"Perler Bead List · 用豆清单",f"Palette: {palette_name.upper()} Grid: {gw}×{gh} Colors: {len(usage)}",
"="*62,f"{'Code':<8}{'Name':<28}{'Count':>6} {'Hex'}","-"*62]
for code,v in sorted(usage.items(),key=lambda x:-x[1]["count"]):
r,g,b=v["rgb"]
lines.append(f"{code:<8}{v['name']:<28}{v['count']:>4} pcs #{r:02x}{g:02x}{b:02x}")
lines+=["="*62,f"{'Total / 合计':<36}{total:>4} pcs"]
return '\n'.join(lines)
# ── MAIN ──────────────────────────────────────────────────
print("🧩 Perler Pattern Generator v1.2 starting...")
if not Path(IMAGE_PATH).exists() and not IMAGE_PATH.startswith("http"):
print(f"❌ Not found: {IMAGE_PATH}"); sys.exit(1)
print("📷 Loading image...")
img_rgb = load_image(IMAGE_PATH)
print(f" Size: {img_rgb.shape[1]}×{img_rgb.shape[0]}")
print("✂️ Removing background (GrabCut, fully offline)...")
img_nobg = remove_background(img_rgb, BG_COLOR)
print(" Done")
print(f"📐 Resizing to {GRID_W}×{GRID_H}...")
img_small = resize_crop(img_nobg, GRID_W, GRID_H)
print("🌈 Equalizing brightness (Lab color space)...")
img_eq = lab_equalize(img_small)
print("🔪 Sharpening edges...")
img_pil = Image.fromarray(img_eq)
img_pil = img_pil.filter(ImageFilter.UnsharpMask(radius=1.2, percent=120, threshold=2))
img_pil = ImageEnhance.Contrast(img_pil).enhance(1.25)
img_arr = np.array(img_pil)
print(f"🎨 Quantizing → {PALETTE_NAME} palette ({MAX_COLORS} colors)...")
img_q = img_pil.quantize(colors=MAX_COLORS, method=Image.Quantize.MEDIANCUT, dither=0).convert("RGB")
palette = PALETTES.get(PALETTE_NAME, PALETTES["hama"])
lab_pal = build_lab_pal(palette)
grid, grid_rgb, usage = map_to_palette(np.array(img_q), lab_pal, MAX_COLORS)
print(f" Actual colors used: {len(usage)}")
print("💾 Generating output files...")
svg = gen_svg(grid, usage, cell=16)
p = os.path.join(OUTPUT_DIR, "pattern.svg")
open(p,"w",encoding="utf-8").write(svg); print(f" ✅ SVG: {p}")
html = gen_html(grid, usage, PALETTE_NAME, BG_COLOR)
p = os.path.join(OUTPUT_DIR, "pattern.html")
open(p,"w",encoding="utf-8").write(html); print(f" ✅ HTML: {p}")
bead_canvas = gen_bead_preview(grid_rgb, BG_COLOR, cell=20)
p = os.path.join(OUTPUT_DIR, "preview_beads.png")
bead_canvas.save(p); print(f" ✅ Bead preview: {p}")
flat = Image.fromarray(grid_rgb).resize((GRID_W*16, GRID_H*16), Image.NEAREST)
p = os.path.join(OUTPUT_DIR, "preview_flat.png")
flat.save(p); print(f" ✅ Flat preview: {p}")
blist = gen_bead_list(usage, PALETTE_NAME, GRID_W, GRID_H)
p = os.path.join(OUTPUT_DIR, "bead_list.txt")
open(p,"w",encoding="utf-8").write(blist); print(f" ✅ Bead list: {p}")
total=sum(v["count"] for v in usage.values())
print(f"""
╔════════════════════════════════════════╗
║ 🧩 Pattern Ready! · 拼豆图纸生成完成 ║
╠════════════════════════════════════════╣
║ Grid : {GRID_W}×{GRID_H} Colors: {len(usage)} Beads: {total:,}
║ Palette: {PALETTE_NAME.upper()}
╠════════════════════════════════════════╣
║ pattern.html ← 浏览器查看/打印
║ pattern.svg ← 可打印矢量图纸
║ preview_beads.png ← 3D豆子效果预览
║ preview_flat.png ← 平铺效果预览
║ bead_list.txt ← 购买清单
╚════════════════════════════════════════╝
Output: {OUTPUT_DIR}
""")
print(blist)
Step 3: Conversation / 多轮对话
"background messy / 背景去除不干净" → ask user to pre-crop or use phone app to remove bg first
"more colors / 颜色太少" → increase MAX_COLORS (+5), re-run
"fewer colors / 颜色太多" → decrease MAX_COLORS (-5), re-run
"change to black bg / 换黑色背景" → BG_COLOR=(5,5,5), re-run
"white background / 白色背景" → BG_COLOR=(255,255,255), re-run
"switch palette / 换色板" → change PALETTE_NAME, re-run
"how many beads / 需要多少豆" → show bead_list.txt
Tips / 使用建议
Best images 最佳图片类型:
- ✅ Pets / animals on simple background · 简单背景的宠物
- ✅ Cartoon / anime characters · 卡通角色
- ✅ Logos, icons · Logo图标
- ✅ Pre-removed background (PNG with transparency) · 已去背景的PNG
If GrabCut result is poor / 如果去背景效果不好:
- Use phone app first: iOS "Remove Background" / Android "Background Eraser"
- 先用手机App去背景，效果会更好
- Or crop image to focus on subject only · 先裁剪让主体占满画面
Color count guide / 颜色数建议:
- 15: Simple, easy to assemble · 简单，容易拼
- 25: Standard, good detail · 标准，细节好（默认）
- 32: Detailed, complex · 精细，适合大尺寸