linkcad.conv

文件格式转换——以编程方式加载和保存图纸。

from linkcad.conv import Conversion, Conversions, FormatRegistry, Format

类

Conversion

单个导入 → 导出操作。适用于直接的一文件转换。

from linkcad.conv import Conversion

conv = Conversion("GDSII", "DXF")
conv.set_import_path("/data/design.gds")
conv.set_export_path("/data/design.dxf")

conv.read_file()
if not conv.succeeded():
    raise RuntimeError("Import failed")

dwg = conv.drawing()
# optionally inspect/modify dwg under WriteLock here

conv.write_file()
if not conv.succeeded():
    raise RuntimeError("Export failed")

方法	说明
`Conversion(import_format, export_format)`	使用格式名称构造（例如 `"GDSII"`、`"DXF"`）
`conv.set_import_path(path)`	设置单个输入文件路径
`conv.set_export_path(path)`	设置输出文件路径
`conv.read_file()`	执行导入步骤
`conv.write_file()`	执行导出步骤
`conv.succeeded()`	如果上一个操作成功，则返回 `True`
`conv.drawing()`	返回由 `read_file()` 生成的 `Drawing`

Conversions

用于运行多个 Conversion 作业的批量容器。每个作业相互独立。

from linkcad.conv import Conversions

batch = Conversions()
conv = batch.append_new("CIF", "CIF")
conv.set_import_paths(["/data/a.cif", "/data/b.cif"])
conv.set_export_path("/data/out.cif")

conv.read_file()
conv.write_file()

方法	说明
`Conversions()`	创建空批量容器
`batch.append_new(import_fmt, export_fmt)`	向批量容器添加新的 `Conversion` 并返回它
`conv.set_import_paths(paths)`	设置输入文件路径列表（用于多文件格式）

FormatRegistry

提供对 LinkCAD 可读取和写入格式列表的访问。

from linkcad.conv import FormatRegistry

registry = FormatRegistry.instance()
for fmt in registry.formats():
    print(fmt.name, fmt.extensions)

方法	说明
`FormatRegistry.instance()`	类方法——获取单例注册表
`registry.formats()`	迭代所有已注册的 `Format` 对象
`registry.find(name)`	按名称查找格式；未找到时返回 `None`

Format

描述 LinkCAD 支持的单个文件格式。

属性	说明
`fmt.name`	格式显示名称（例如 `"GDSII"`）
`fmt.extensions`	文件模式列表（例如 `[".gds", ".gdsii"]`）
`fmt.can_read`	如果该格式支持导入，则为 `True`
`fmt.can_write`	如果该格式支持导出，则为 `True`