图像 → SVG(构造的、可编辑的、适合打印的)
将栅格参考图像转换为设计师手绘风格的SVG: 直线的地方真正直线,真正的圆形和圆弧,真实的对称, 一致的重复元素,正确的透视,一致居中布局,可编辑文本,合理的 图层——并在视觉上忠实于原始图像。
此技能背后的核心教训:自动描摹栅格图像会以矢量形式保留 栅格图像的缺陷(边缘锯齿、不对称的穹顶、凹痕、 微孔、略微不同的“相同”窗户)。用户会立即注意到。 描摹适用于首次测量或真正有机形状, 但人造结构应从测量的基本图形中重建。
工作流程
分阶段进行,并在标记为 ✋ 的检查点获得用户的确认。 使用用户的语言进行沟通;保持报告简短并链接到文件。
1. 需求收集 ✋
仅询问那些会改变结果的问题(跳过用户已提供的信息):
- 忠实再现 vs. 忠实且清理(默认:忠实,优化不规则)。
- 背景:无/透明(常见于白色打印)、纯色或纹理。
- 文本:可编辑
<text>(需安装字体) vs. 轮廓化路径。 - 预期用途和尺寸(打印尺寸 → 页面
width/height毫米;保持 源宽高比,例如 2:3 → 30×45 厘米)。
2. 获取最佳参考
使用可用的最高质量副本(磁盘上的PNG优于聊天附件中的JPEG
——询问用户是否有原始文件)。将其复制到
项目目录中(reference/original.png),绝不修改用户的原始文件。
如果只有聊天附件,它可能可以从工作区的会话存储中恢复;
在深入应用数据库前先询问。
3. 分析并提出方案 ✋
在绘制任何内容之前,查看放大的裁剪区域并向用户描述:
- 整体构图和网格(边距、交替、对齐);
- 每个图形:它是什么、它的组成部分、哪些部分是对称的、重复的 元素(窗户、柱子、舱室)、透视(后退立面);
- 字体候选;颜色;
- 等价类和网格:具有相同功能且必须相同的对象
(背景形状、文本角色、强调条、分隔线、成对规则、
重复块)、共同边距、居中项目和垂直节奏。
参考图像在此处往往不一致(半径为 154/128/144,三种标题
大小);建议统一,仅询问可能存在差异的地方。
参见
references/layout.md。 然后提议对象结构(图层/组、命名)。将每个 插图分组为一个类似文件夹的组(例如“建筑剪影”),包含其 作为独立命名子元素的组件。等待确认。
4. 测量
测量,而非目测。使用 scripts/measure.py(网格裁剪、顶部轮廓、
开口、线/圆拟合、颜色采样),并参见
references/measuring.md 了解技术。按组件记录数字:
轮廓坐标、对称轴、窗口框、圆心/半径。
5. 构造几何
使用 scripts/svgkit.py(带自动环绕的多边形、拱形窗、透视拱门、穹顶、
椭圆、尖刺、镜像、以及一个用于收集实体/开口/挖空的 Part)从基本图形构建每个对象。
阅读 references/construction.md —— 其中包含关键规则:
直边、围绕测量轴镜像实现对称、通过消失线实现透视、
将属于一起的部分合并、填充微孔、去除凹痕、避免接缝。
将构建过程编写为脚本(例如 build_svg.py + architecture.py),以便每次
更改都是重新运行,而非手动编辑XML。
5b. 布局系统
将所有内容放置在一个定义为常量的网格上(边距关于页面中心对称,
每类背景形状一个半径,每个文本角色一种样式,
每个重复块一个垂直节奏,相等/镜像的规则)。
使用 inkscape --query-all 按实际墨迹对齐文本,然后将整个
艺术品在页面上居中并将平移嵌入坐标。阅读
references/layout.md。
6. 排版与颜色
使用 scripts/font_match.py 定量匹配字体;保持文本可编辑,
使用一个字号 + 由同一角色的每个文本共享的字间距,
从参考墨迹宽度校准。从平坦内部区域采样
颜色(中位数,而非单个像素)。详见
references/typography-and-colour.md。
7. 逐部分验证
每次构建后:
- 使用 Inkscape 渲染(
scripts/compare.py完成此操作)并逐节 与参考图像进行并排比较,加上红/蓝差异叠加。 - 使用
scripts/symmetry.py检查对称图形(关于轴镜像; 残差应约为 0.1% —— 其余为抗锯齿或故意 不对称细节,如时钟指针)。 - 在打印分辨率(300 dpi 裁剪)下检查接缝、细线、间隙、 残留凹痕。
- 使用
scripts/consistency.py审计布局一致性(相等半径、 每种角色的文本样式、条、规则宽度、边距、垂直节奏、 节间距、颜色对关系、居中)。每个发现要么被修复,要么被确认为有意为之。 - 使用
scripts/validate.py验证文件(无栅格图像/滤镜、 唯一id、可解析的url(#…)、文本对象存在、页面尺寸)。 在报告之前自行查看图像。重叠分数是诊断工具, 而非目标 —— 高质量的重建自然会与模糊、不规则的源图像有所不同。
8. 交付与迭代
简要报告:构建了什么、与参考图像的故意偏差
(例如,使某部分对称、统一窗户数量)、字体依赖、指向
SVG的链接、预览PNG以及比较图像。预期有针对性的反馈
轮次(“这个穹顶不对称”、“让窗户遵循透视”、“匹配这个吊车头”)——
在高缩放下重新测量特定区域,重建,并显示与参考图像相邻的
前后裁剪对比。当请求不明确时
(例如,使用哪种透视模型),将选项渲染为快速示意图,
让用户选择而非猜测。将备选方案
(字体、颜色、间距)显示为对比表:原始 | 当前 | 选项。
内容更改(新坐标、名称)保持样式冻结,并是经过验证的事实
——参见 references/typography-and-colour.md。
环境说明
- Python 依赖(在临时目录中使用一次性 venv,例如
uv venv):pillow numpy scipy opencv-python-headless fonttools lxml。 - Inkscape CLI 可靠渲染:
inkscape in.svg --export-type=png --export-filename=out.png --export-width=4096 --export-background=white --export-background-opacity=1。图像查看器可能缓存—— 为后续预览使用新文件名。 - Potrace 内置于 Inkscape(
libpotrace);scripts/contour.py包装了 Potrace 用于有机形状或首次测量描摹。
文件
references/construction.md—— 建筑/结构几何规则、透视、对称、SVG填充/孔洞/接缝。构建前阅读。references/measuring.md—— 如何从栅格图像提取可靠数字。references/layout.md—— 等价类、网格/边距、垂直节奏、墨迹对齐、共享字间距、艺术品居中。references/typography-and-colour.md—— 字体匹配、可编辑文本、颜色。references/svg-structure.md—— Inkscape的图层/组、背景挖空、打印设置、交付清单。scripts/svgkit.py—— 几何基本图形和Part(从你的构建脚本中导入)。scripts/measure.py—— CLI:grid、profile、holes、color、fit-circle、fit-line。scripts/font_match.py—— 对文本裁剪区域对已安装/候选字体进行排序。scripts/compare.py—— 渲染 + 并排比较 + 每区域叠加。scripts/symmetry.py—— 每个图形的镜像对称残差。scripts/consistency.py—— 布局审计:相等对象、对齐、边距、节奏、居中。scripts/validate.py—— 最终SVG的结构检查。scripts/contour.py—— 基于potrace的有机形状优化轮廓。