bizhi-1024/embroidery-lab

embroidery-lab —— 刺绣效果生成原型（路线 A：程序化针迹渲染）

参考对象：SHIPS 50 周年页 <https://www.shipsltd.co.jp/pages/sp50thanniversary.aspx> （该站刺绣文字为预渲染 PNG + GSAP 动效，本原型做的是它没做的事：实时生成。）

运行

纯前端单文件，无依赖：浏览器直接打开 index.html 即可（或任意静态服务器）。

管线

文字/图片 → 按针迹角度旋转栅格化 → 二值/k-means 多色掩码
→ 连通域分块（8 邻域 BFS）→ 扫描行提针（≤2px 缝隙桥接，蛇形往复，
   长行按最大针长拆榻榻米段）→ 坐标旋回 → 机器顺序时间线（色块→分块→跳线→线头）
→ 逐针三层渲染（投影 / 缎面渐变线身 / 丝光高光）+ 布纹底 + 浮雕投影

针对旧版本三大问题的对策

测试

核心提针管线有 Node 冒烟测试（DOM 桩 + 合成掩码，13 项断言：连通域、 排序、蛇形、断针分割、首末行覆盖、角度旋转往返、针数上限）。

已知待做（明确延后，非砍掉）

• —逐笔画方向场（横竖笔画各自垂直走线）——目前全局单角度 + 榻榻米兜底
• —多色图片的色彩→绣线色卡映射与描边针（目前用聚类色直出）
• —导出真实绣花机文件（DST/PES）
• —服务端化 / 接入 Ink/Stitch 做工业级针迹规划