图层映射

图层映射控制图层如何在输入和输出格式之间转换。它可用于重命名图层、更改颜色、设置可见性、定义 3D 属性，以及过滤要导出的图层。

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 格式

每一行映射一个输入图层。列以逗号分隔，不包含表头行：

input_layer,output_layer,comment,color,visibility,elevation,material,extrude,stack,thickness

列参考

列	类型	说明
`input_layer`	string	导入文件中的图层名称或编号
`output_layer`	string	导出文件中的图层名称或编号
`comment`	string	应用于导出图层的注释
`color`	color	显示颜色 — 十六进制 RGBA（`#rrggbbaa`）或颜色名称（`Blue`、`Red` 等）
`visibility`	bool	是否导出图层（`true`/`false`、`1`/`0`、`on`/`off`）
`elevation`	real	3D 导出的底部 Z 值，以皮米为单位
`material`	integer	3D 导出的材料标识符
`extrude`	bool	图层是否在 3D 中挤出
`stack`	bool	将此图层堆叠在下方图层之上（与 elevation 互斥）
`thickness`	real	3D 导出的图层厚度，以皮米为单位

示例

1,,,Blue,true,,,false,true,10000000000
2,,,Yellow,true,,,false,true,5000000000
3,,,Magenta,true,,,false,true,5000000000
4,,,Cyan,true,,,false,true,5000000000
5,,,"#ffc000",true,,,false,true,5000000000
6,,,"#ff00cc",true,,,false,true,10000000000

这会将 GDSII 图层 1–6 映射为自定义颜色、全部可见，并按指定厚度堆叠。

JSON 与 CSV

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

使用图层映射

在 GUI 中

在导出选项中，勾选 应用图层映射
单击浏览并选择你的 .csv 文件
继续导出——映射会自动应用

从命令行

linkcad.exe -i design.gds -o output.dxf `
  --layer-map LayerMap.csv --apply-layer-map

旧版 CLI 语法

linkcad -LcApplyLayerMap=true -LcLayerMap="LayerMap.csv"

提示

省略不需要的列——尾随逗号是可以的：1,Metal1,,Blue,true
将 visibility 设置为 false，可在导出期间抑制某个图层而不删除它
对于 3D 导出，elevation 和 thickness 始终以皮米（10⁻¹² 米）为单位
对应放在上一图层之上而不是绝对高程位置的图层，请使用 stack=true