artcraft 这个项目最初是为了解决一个非常具体的问题给一位做传统手工艺的A同学批量生成图案稿。传统纹样这种东西手工画极其费精力某个花边要在不同尺寸之间切换重新描一遍轮廓就要半天换成程序生成核心逻辑反而不复杂无非是把纹样拆成几何元素再按对称、平铺、随机扰动这几条规则去合成。artcraft 的名字就是 art 与 craft 的组合定位是“艺术创意”和“工艺实现”之间的翻译器。这篇文章会从需求拆解、技术选型、核心代码、踩坑排查一直讲到后续扩展适合想用参数化方式做创意工具、又不想一上来就上重型框架的朋友。1. 项目整体设计与思路拆解1.1 需求背后的矛盾手工感与批量生产传统手工艺图案稿最大的特点是“规矩里有活气”。刺绣用的回纹、缠枝纹木雕用的角花印染用的连续纹样几乎都有严格的几何规律但完全用尺规做出来又会显得死板。手工制稿之所以贵在于同一个纹样在不同尺寸、不同弧度、不同材质上的适配需要经验和反复试错。A同学当时的痛点很明确他接了一个需要大量装饰纹样的活儿同一套基础纹样要在十几种规格上出图手工改稿根本不现实。artcraft 的定位就在这里不替代设计师而是把“图案生成”这一步变成可控的参数化过程。我希望能通过填写几个参数比如画布尺寸、对称类型、平铺行列、随机扰动幅度生成一批可继续编辑的矢量图再由人来挑选微调。这意味着整个项目必须满足三件事可复现、可调整、可输出。可复现对应随机数的种子控制同一套参数必须能得到同一张图不然售后和微调都无从谈起。可调整对应参数配置外置而不是把数值硬编码在代码里。可输出则要求最终生成的格式能对接常见的工艺设备或设计软件SVG 就是最稳妥的中间格式之一。这三个目标看似简单实际做下来每个都会牵出一堆细节后面我会逐个展开。1.2 技术选型思路为什么是 Python 而不是“重型软件”很多人问这类图案用平面设计软件的人工操作或者带脚本支持的软件也能做为什么还要单独写个项目我的回答是批量、交叉、可回溯。设计软件适合单张精修但面对几十种规格的组合人工操作必然出错软件里的脚本功能虽然能自动化但调一次参数要动很多地方且很难做自动化的二次计算。所以 artcraft 选用 Python 作为主语言配合 svgwrite 库直接产出 SVG 文件。Python 的优势不在性能而在生态简洁和表达直接。同样一个坐标变换用脚本写出来可以一眼看懂后续要扩展成 web 工具或者命令行工具都很方便。svgwrite 库本身很轻核心就是把 SVG 的 XML 结构映射成 Python 对象不引入重型渲染引擎学习成本很低。我也把配置文件选成了 YAML。为什么不直接用命令行参数因为图案参数一旦多起来一行命令会变得又臭又长YAML 的好处是可读性好、可以加注释还能像配置文件一样存放多组预设。一个人开发的小项目配置外置往往比 UI 界面更快毕竟一个文本文件就能完成所有调整。1.3 和现成参数化设计工具的对比市面上的参数化图案生成工具并不少一类是在线纹样生成器输入参数直接出图另一类是可视化节点工具比如用节点连线条、噪点、变换。artcraft 没有直接采用现成方案是因为这些工具在“批量生成 格式控制”上总有几处不舒服。方案优点主要问题在线纹样生成器上手快不需要装环境参数维度有限无法离线若干场景下格式导出受限可视化节点工具所见即所得组合理灵活学习曲线陡节点一多就难维护自动化批量生成别扭手动绘图软件精细可控艺术自由度最高批量时人力开销极大版本回溯难artcraft 脚本方案参数全外置可批量复现格式自定义需要写代码前期投入成本较高我选择自研脚本本质上是接受了“前期写代码费时间”这个成本换取后期批量处理时的自由。很多图案生成平台的输出结果是可以的但你不知道它是怎么算出来的中间是否动了比例也没法把算法扩展成自己的工艺参数体系。对一个要长期演进的小项目而言代码在自己手里才是最大的确定性。2. 核心细节解析与实操要点2.1 把传统纹样拆成可计算的元素编程生成纹样最难的不是写代码而是怎样把“看着像某种传统风格”这件事翻译成几何规则。我通常从三个维度拆解纹样。第一是基础形状。以八角星纹为例它本质上是一个正八边形内部交错生成的几何结构如果简化成刺绣网格也可以理解为若干小正方形和菱形在棋盘上按规律摆放。这个过程很像搭积木先定义几个关键点再由这些点生成线段或闭合图形。在代码里基础形状就是一组坐标点可以看成“积木”的位置表。第二是变换规则。传统纹样里最常见的三种变换是平移、旋转和镜像。平移负责让图案“延展开”旋转负责产生花形的放射感镜像负责形成左右或上下对称。把它们组合起来就得到了重复单元的骨架。我用一个 Symmetry 模块来管理这些变换避免在生成逻辑里到处写坐标变换代码。第三是扰动参数。手工纹样的魅力在于线条不会像 CAD 那样绝对光滑会有极细微的偏差。我引入了一个随机扰动值作用在关键点的坐标上范围通常很小在画布尺寸为 600 时扰动幅度设 3 左右。这样生成的图案既保留了几何秩序又不会显得“塑料感”十足。扰动幅度是一个需要反复试的参数不同工艺差异很大我会在常见问题章节再细说。2.2 对称与平铺从基础单元到完整画面对称生成时有一个必须注意的边界问题如果只是简单地把点做镜像或旋转很容易在画布边缘产生越界点。我的处理办法是强制把坐标裁剪到画布范围以内同时保留越界前的位置用于判断图形完整性避免出现“孤零零的半边元素”。平铺逻辑也类似。单元平铺时通常不需要让纹样完全占满整个画布否则边缘会被切断影响生产加工。artcraft 的做法是计算画布尺寸、单元尺寸和间隙之后得到合适的行列数生成完整体后再按需裁切。比如 600 像素的画布单元边长 160间距 20那么 3x3 平铺刚好能铺满并留出边界。这里有一个值得仔细想的参数平铺换行步长。很多人直接按“单元边长 间距”来做步长忽略了旋转对称情况下图形实际占用的空间。比如旋转 90 度后图形的外接尺寸会和原来不同。在 artcraft 里我会预先对每个单元算一遍边界框再决定平铺步长。这一步看起来不起眼但省去了成片图形互相穿插然后返工的麻烦。2.3 颜色分层与工艺适配图案生成不只是画线。手工艺最终交付往往需要分色层同一个纹样在不同工艺里的表达逻辑完全不一样。刺绣工艺更关心线迹路径需要把图案拆分成连续线条或点阵颜色通常代表不同颜色的绣线激光雕刻或木雕更关心轮廓和块面浅色填充可能意味着保留区域深色轮廓则意味着雕刻路径丝网印花又需要明确的色块边界和留白。如果一开始就把颜色写死在单个 SVG 文件里到工艺端拆层会非常痛苦。artcraft 的约定是“一层一文件”每个颜色或者每个线型单独导出一个 SVG文件名里标明用途比如 base_outline.svg、fill_block.svg。这样无论是导入刺绣软件还是雕刻软件都能直接拿对应图层去设置工艺参数。这个约定的成本很低但实际生产时特别能省沟通成本。3. 实操过程与核心环节实现3.1 环境准备与配置文件设计实操部分先给一个可直接抄作业的目录结构artcraft/ ├── config.yaml ├── requirements.txt └── artcraft_generator.pyrequirements.txt 里就两行pyyaml 和 svgwrite。安装命令pip install pyyaml svgwriteconfig.yaml 我习惯这样写canvas: width: 600 height: 600 background: #FDF6EC pattern: module: star8 symmetry: 4 tile_cols: 3 tile_rows: 3 gap: 20 jitter: 3 random: seed: 42需要说明的是module 字段代表读取哪种基础纹样的定义当前我先内置了 star8 和 grid_weave 两种。后面想加新的纹样只需在代码里注册一个新函数即可配置文件不需要改动。seed 字段很重要它决定了随机扰动能否复现每次想调整图案细节又不想改变整体布局时只需要固定 seed修改 jitter 就好。3.2 核心代码实现对称生成、平铺与输出先展示最核心的对称生成部分import random import yaml import svgwrite def apply_symmetry(points, canvas_size): out [] for x, y in points: out.append((x, y)) out.append((x, canvas_size - y)) # 上下镜像 out.append((canvas_size - y, x)) # 旋转90度 out.append((canvas_size - x, canvas_size - y)) # 中心对称 return out这里上下镜像和旋转 90 度都做了得到的点集合就是四向对称族。之所以不直接输出线条是因为不同工艺对图形元素的表达方式差异很大刺绣要的是线迹坐标木雕要的是轮廓闭合路径印花则可能需要填充色块。先输出基础点集后续逻辑可以根据工艺再封装成不同形状。接着是生成基础单元并平铺的代码。以 star8 为例生成八个顶点def build_base_points(modulestar8, size160): if module star8: cx cy size / 2 points [] for i in range(8): angle 2 * 3.1415926 * i / 8 import math px cx (size / 3) * math.cos(angle) py cy (size / 3) * math.sin(angle) points.append((px, py)) return points raise ValueError(funknown module: {module})平铺时步长不能用死数字而是根据基础单元尺寸和 gap 计算def tile_points(base_points, tile_cols, tile_rows, gap): result [] step base_size gap for row in range(tile_rows): for col in range(tile_cols): offset_x col * step offset_y row * step shifted [(x offset_x, y offset_y) for x, y in base_points] result.extend(shifted) return result需要提醒的是svgwrite 里的坐标系统和画布坐标一致左上角为原点y 轴向下所以镜像公式里用的是 canvas_size - y 而不是负 y这一点刚开始很容易写反。写镜像时如果按数学坐标系的习惯直接用 -y输出的图案会和预期完全颠倒。输出 SVG 的部分我会把点画成小方块或者连接成线段取决于工艺要求。一个最小可用的输出函数长这样def write_svg(points, output_path, canvas_size): dwg svgwrite.Drawing(output_path, size(canvas_size, canvas_size)) for x, y in points: dwg.add(dwg.rect(insert(x - 3, y - 3), size(6, 6), fill#E0C437, strokenone)) dwg.save()这个函数虽然简单但已经能生成一张看得过去的点阵纹样底稿。实际使用时我会把画布背景色、主色、辅色也做成配置项避免每次都改代码。运行整个项目的命令也很直接python artcraft_generator.py --config config.yaml运行结束后目录下会多出一个 output.svg 文件可以直接用浏览器打开预览。3.3 从矢量稿到可交付文件转换与校验SVG 出图后还需要处理两个环节转位图和检查线宽。转位图我一般用 Inkscape 的命令行或者直接让浏览器打印成 PDF再按需求导出。一个实用参考如果最终要 300 DPI 的 A4 图片像素尺寸大约是 2480×3508。SVG 是矢量格式导出时注意把单位换算在软件里统一为毫米或像素避免出现缩放比例混乱。简单换算方法是目标像素宽度 物理尺寸毫米数 × DPI / 25.4。检查线宽也很关键。刺绣导入线迹时过细的线在针脚里毫无存在感而过粗又会在工艺软件里变成夸张的色块。我通常会把不同设计层拆分成独立 SVG一层为轮廓线一层为填充块交给工艺端前再三确认每层的颜色、线宽。这个步骤看起来琐碎但跳过它往往会在生产阶段浪费更多时间。3.4 文件命名与版本记录生成的文件一旦变多命名就成了大问题。我最初用 output.svg 这种固定名称结果跑了几次参数之后完全分不清哪个文件对应哪组参数只能再跑一遍对比。后来 artcraft 统一改成带参数前缀的命名规则star8_3x3_seed42_j3.svg gridweave_2x2_seed7_j1.svg文件名的每一段都能对应回 config.yaml 里的内容看到名字就知道这个文件的生成来源。同时每次运行都会自动写一份 manifest.yaml记录这次运行用到的全部参数、运行时间、输出文件列表。这样即使过了一个月我还能准确还原当初某张图是怎么生成出来的。对一个工具类项目来说可回溯性不是加分项而是必需品。4. 常见问题与排查技巧实录4.1 高频问题速查表参数化生成工具的问题往往集中在坐标、编码和配置三块。我整理了一张速查表按出现频率排好现象可能原因处理方式图案整体偏移到画布外未做边界裁剪或平铺步长计算错误输出前统一 clamp 坐标到画布范围SVG 文件浏览器打不开文本编码格式问题或 XML 标签不闭合统一用 UTF-8 写入检查 svgwrite 生成后的 XML 头同一参数两次生成结果不同随机种子未固定设置 random.seed 并保存配置文件里的 seed 值中文图例显示乱码字体未嵌入 SVG避免直接在 SVG 中写入复杂中文或转 PDF 后再加注图形元素之间互相穿插未考虑旋转对称后的边界框变化先算单元边界框再算平铺步长这张表是我自己踩坑最多的地方。尤其是边界裁剪初次实现时我把对称点强制裁剪了结果导致图形边缘出现大量缺失点后来改成“裁剪前先判断是否属于完整图形”才算稳妥。排查的时候不要只盯着 SVG 文件看先打印关键点的坐标范围往往一眼就能发现问题。4.2 随机扰动与可复现性的细节关于随机数的使用我有两条习惯。其一任何随机扰动都要基于同一个 Random 实例才能保证整张图的随机可复现。不要在图里到处 random.random()那样一旦插入一个新步骤全局随机状态就会变化之前的图就很难重新生成出来。我会在最外层创建一个 Random 实例传入需要扰动的点集。其二扰动的幅度建议用画布尺寸的 0.5% 以下作为默认而不是固定像素值。比如 600 的画布默认 jitter 设 3换到 3000 的画布时就应该是 15 左右。这样在不同画布尺寸之间切换时视觉上的“手工感”是一致的。固定像素值会在放大画布后显得扰动力度过弱或过强风格漂移明显。还有颜色模式的问题。如果目标设备是激光雕刻浅色填充往往会被识别成雕刻区域或是原样保留不同软件的行为不一致。我现在的做法是默认黑色轮廓、浅色填充后续用颜色分离脚本把每类颜色单独导出交给对应工艺软件前再手动指定。4.3 边界裁剪与连接性我最头疼的坑整个项目里让我花最多时间的其实是边界裁剪和图形连接性的冲突。最初的实现很粗暴所有点生成完后凡是不在画布范围内的点一律丢掉。结果导致边缘位置的纹样缺口非常明显尤其是连续纹样本该在边缘处继续延伸的线条被齐齐切断工艺端根本不能用。解决办法是区分“生成阶段”和“输出阶段”。生成阶段不做裁剪保留单元级边界框让每个单元在平铺时能够完整计算相邻关系输出阶段才针对最终画布做一次裁剪。这样做的代价是需要多一层坐标处理逻辑但换来的是边缘图案的完整性和自然衔接。实际生产里很多情况下边缘其实会被裁掉或遮挡不需要过度追求满布但作为工具至少要保证用户能看到完整体再决定怎么切。另外一个相关的小技巧平铺时给每个单元多生成一圈“外延单元”输出时通过偏移量对齐主画布。这样即使从中间截取一小块区域做细节图案依然连贯。这个思路有点类似做游戏的地图 chunk 管理只是 scale 小很多。5. 后续扩展方向与个人心得5.1 可以往哪些方向扩展artcraft 目前还是命令行工具下一件我想做的是给它包上一层简单的 Web 界面让不熟悉命令行的使用者也能通过网页调整参数并预览。技术上可以用 Flask 或者 Gradio都不是很复杂核心生成逻辑保持独立即可。这样 artcraft 就更像一个小型在线设计工具而不只是我一个人在命令行里用的脚本。另外纹样库的扩充空间也很大。不同工艺的纹样风格差异明显刺绣喜欢连续细密的线迹木雕偏好块面化的轮廓印染则需要均衡的留白。把这些规则抽象成“工艺配置”而不是硬编码在生成逻辑里后续加新工艺时只改配置就行生成器主体可以保持不变。我计划下一步把每次跑出来的方案做成一个简单的 HTML 预览页直接按缩略图浏览省得一个个打开 SVG。5.2 我个人的几条体会这个项目做到现在我最大的感受是参数化生成工具的最大价值不是替代创意而是把创意从重复劳动中解放出来。真正决定一张图案能不能用的依然是人对比例、疏密、结构和错落之感的判断。代码生成的部分再稳定最后也还是需要人去看一眼、改一笔这是很自然的事情。还有一个体会是关于“留人味”的。传统手工艺的美感在很大程度上来自非绝对均匀所以随机扰动参数被我放到了配置的第一页并且默认值不为 0。工具注定要解决的是“可批量复制”但好工具一定不会把手工独有的呼吸感彻底抹掉。这一点写在代码里也就是一两行随机数的事但在设计整个项目时想清楚后续方向就不会跑偏。