svg2mod 项目使用教程

svg2mod 项目使用教程

svg2mod Convert Inkscape SVG drawings to KiCad footprint modules 项目地址: https://gitcode.com/gh_mirrors/sv/svg2mod

1. 项目介绍

svg2mod 是一个用于将 Inkscape 中的 SVG 绘图转换为 KiCad 足迹模块的小程序。它使用 cjlano 的 Python SVG 解析器和绘图模块来解释绘图，并通过直线线段近似曲线。生成的模块文件可以输出为 KiCad 的旧版或 s-expression（即“pretty”）格式。此外，它还能自动生成水平镜像的模块，以便在双层 PCB 的背面使用。

2. 项目快速启动

安装

首先，确保你已经安装了 Python 环境。然后，通过以下命令安装 svg2mod：

git clone https://github.com/mtl/svg2mod.git
cd svg2mod
pip install .

使用示例

假设你有一个名为 example.svg 的 SVG 文件，你可以使用以下命令将其转换为 KiCad 模块文件：

svg2mod.py -i example.svg -o example.mod --name ExampleModule --value ExampleValue

参数说明

• -i FILENAME: 输入的 SVG 文件名。
• -o FILENAME: 输出的模块文件名。
• --name NAME: 模块的基名。
• --value VALUE: 模块的值。
• -f FACTOR: 缩放路径的因子。
• -p PRECISION: 用于近似曲线的平滑度（浮点数）。
• -d DPI: SVG 文件的 DPI（整数）。
• --front-only: 省略背面模块的输出（仅适用于旧版输出格式）。
• --format FORMAT: 输出模块文件格式（legacy|pretty）。
• --units UNITS: 输出单位，如果输出格式为旧版（decimil|mm）。

3. 应用案例和最佳实践

应用案例

假设你正在设计一个定制的 PCB 足迹，你可以使用 Inkscape 绘制 SVG 图形，然后使用 svg2mod 将其转换为 KiCad 模块文件。这样，你可以在 KiCad 中直接使用这些定制的足迹，而不需要手动绘制。

最佳实践

1. 使用 Inkscape 的“Path->Object To Path”和“Path->Stroke To Path”菜单选项：将矩形、圆弧和圆形等元素转换为路径，以确保它们在 KiCad 中正确渲染。
2. 使用图层：确保图层名称符合 KiCad 的命名规则，以便正确映射到 KiCad 的图层。
3. 调整精度：根据需要调整 --precision 参数，以平衡精度和文件大小。

4. 典型生态项目

KiCad

svg2mod 主要用于与 KiCad 集成，KiCad 是一个开源的电子设计自动化（EDA）工具，广泛用于 PCB 设计。通过 svg2mod，用户可以更方便地将 Inkscape 中的设计导入到 KiCad 中。

Inkscape

Inkscape 是一个开源的矢量图形编辑器，广泛用于创建和编辑 SVG 文件。svg2mod 利用 Inkscape 的 SVG 文件格式，将其转换为 KiCad 模块文件。

cjlano/svg

svg2mod 使用了 cjlano 的 Python SVG 解析器和绘图模块，这是一个轻量级的 SVG 解析库，适用于需要处理 SVG 文件的 Python 项目。

通过这些工具的结合，用户可以更高效地进行 PCB 设计和定制。

svg2mod Convert Inkscape SVG drawings to KiCad footprint modules 项目地址: https://gitcode.com/gh_mirrors/sv/svg2mod