图层映射

图层映射定义在转换期间如何重命名、重新编号、合并或过滤图层。当在具有不同图层约定的格式之间转换时（例如从 GDSII 数字图层转换到 DXF 命名图层），它们尤其有用。

LinkCAD 支持两种图层映射文件格式：JSON（推荐）和 CSV。

JSON 格式

JSON 图层映射使用经过 schema 验证且元数据更丰富的格式。这是新项目推荐的格式。

{
  "$schema": "https://schema.linkcad.com/layer-map-v1-schema.json",
  "version": 1,
  "units": "um",
  "layer_map": [
    {
      "input_layer": "METAL1",
      "output_layer": "M1",
      "order": 1,
      "comment": "Metal 1 layer",
      "color": "#FF0000",
      "visibility": true,
      "elevation": 1000,
      "thickness": 500,
      "material": 3,
      "extrude": true
    },
    {
      "input_layer": "VIA1",
      "output_layer": "V1",
      "order": 2,
      "color": "Blue",
      "stack": true,
      "thickness": 200
    }
  ]
}

根字段

字段	必需	描述
`$schema`		用于编辑器验证的 Schema URL
`version`		Schema 版本（必须为 `1`）
`units`		`elevation` 和 `thickness` 值的单位 — `nm`, `pm`, `um`, `mil`, `point`, `mm`, `cm`, `in`, `m`, `ft`
`layer_map`	yes	图层映射条目的数组

条目字段

字段	必需	类型	描述
`input_layer`	yes	string	源图层标识符
`output_layer`		string	目标图层标识符
`order`		integer	显示顺序（仅 JSON — CSV 中不可用）
`comment`		string	描述或备注
`color`		string	图层颜色 — 十六进制（`#FF0000`）或 X11 名称（`Red`）
`visibility`		boolean	图层是否可见
`elevation`		number	Z 坐标，按 `units` 缩放（当 `stack` 为 `true` 时不允许）
`thickness`		number	图层厚度，按 `units` 缩放
`material`		integer	材料索引
`extrude`		boolean	是否在 3D 导出中拉伸此图层
`stack`		boolean	自动堆叠图层（与 `elevation` 互斥）

CSV 格式

CSV 图层映射是使用逗号或分号分隔符的纯文本文件。每一行定义一个图层映射。

列

#	列	描述
1	`input_layer`	源图层标识符（必需）
2	`output_layer`	目标图层标识符
3	`comment`	描述或备注
4	`color`	图层颜色 — 十六进制或 X11 名称
5	`visibility`	`true` 或 `false`
6	`elevation`	数据库单位（皮米）中的 Z 坐标
7	`material`	材料索引
8	`extrude`	`true` 或 `false`
9	`stack`	`true` 或 `false`
10	`thickness`	数据库单位中的图层厚度

示例

METAL1,M1,Metal 1 layer,#FF0000,true,1000,3,true,false,500
VIA1,V1,,Blue,true,,,,false,200
POLY,P1,,#FFFF00,,,,,,

字段可以加引号。逗号和分号分隔符均可接受。

JSON 与 CSV

功能	JSON	CSV
`order` 字段	yes	no
elevation/thickness 的单位缩放	yes	no（始终为皮米）
Schema 验证	yes	no
结构化元数据	yes	no

合并图层

将多个源图层映射到同一个目标即可合并它们：

1,METAL
2,METAL
3,METAL

过滤图层

只有映射中列出的图层会包含在输出中。未列出的图层会被丢弃。

使用图层映射

GUI

从 Layer Map 面板加载图层映射
通过编辑表格分配映射
在转换期间应用

命令行

linkcad.exe -i chip.gds -o chip.dxf `
  --layer-map mapping.csv --apply-layer-map --quit

Python

import linkcad.plugin as lp

# Layer maps can be applied programmatically in tool plugins

提示

图层映射可以从 GUI 创建并保存为 CSV 以便复用
在项目之间使用一致的图层命名约定
映射文件编码应为 UTF-8
有关图层管理的更多信息，请参见图层