linkcad.controller

高级转换工作流控制器。当你需要完整的转换向导状态机（验证、导入、变换、导出），而不是直接驱动 linkcad.conv 时，请使用此模块。

from linkcad.controller import ConversionController, ConversionState

类

ConversionController

编排 LinkCAD 转换向导使用的多步骤转换工作流。

from linkcad.controller import ConversionController

ctrl = ConversionController()
ctrl.set_import_format("GDSII")
ctrl.set_export_format("DXF")
ctrl.set_import_path("/data/design.gds")
ctrl.set_export_path("/data/design.dxf")

ctrl.run()
if ctrl.state == ConversionState.Done:
    print("Conversion succeeded")
else:
    print(f"Failed at state: {ctrl.state}")

方法 / 属性	说明
ConversionController()	创建新的控制器实例
ctrl.set_import_format(name)	按名称设置导入格式（例如 "GDSII"）
ctrl.set_export_format(name)	按名称设置导出格式
ctrl.set_import_path(path)	设置输入文件路径
ctrl.set_export_path(path)	设置输出文件路径
ctrl.run()	执行完整的转换流水线
ctrl.state	当前 ConversionState
ctrl.drawing()	返回已加载的 Drawing（导入步骤完成后可用）

ConversionState

表示转换向导当前状态的枚举。

值	说明
ConversionState.Idle	尚未开始
ConversionState.Importing	正在执行导入步骤
ConversionState.Transforming	正在应用图层映射和变换
ConversionState.Exporting	正在执行导出步骤
ConversionState.Done	已成功完成
ConversionState.Failed	发生错误