linkcad.env

用于脚本和插件的选项与日志工具。

from linkcad.env import (
    get_option_boolean, set_option_boolean,
    get_option_int,     set_option_int,
    get_option_real,    set_option_real,
    get_option_string,  set_option_string,
    EventLog, Severity,
)

选项

LinkCAD 将持久化的格式和工具选项存储在字符串键下（例如 "GdsiiInFlattenAll"）。以下函数允许脚本在不打开 Options 对话框的情况下读取和覆盖这些值。

函数

函数	说明
`get_option_boolean(name, default)`	读取布尔选项；未设置时返回 `default`
`set_option_boolean(name, value)`	写入布尔选项
`get_option_int(name, default)`	读取整数选项
`set_option_int(name, value)`	写入整数选项
`get_option_real(name, default)`	读取浮点数选项
`set_option_real(name, value)`	写入浮点数选项
`get_option_string(name, default)`	读取字符串选项
`set_option_string(name, value)`	写入字符串选项

from linkcad.env import get_option_boolean, set_option_boolean

# Check whether GDSII import flattens hierarchy
flatten = get_option_boolean("GdsiiInFlattenAll", False)
print(f"GDSII flatten: {flatten}")

# Temporarily override
set_option_boolean("GdsiiInFlattenAll", True)

日志

EventLog

应用程序事件日志。写入这里的消息会显示在 LinkCAD 日志面板中。

from linkcad.env import EventLog, Severity

log = EventLog.instance()
log.log(Severity.Info, "Processing complete")
log.log(Severity.Warning, "Layer 'TEMP' will be deleted")
log.log(Severity.Error, "Could not open file")

方法	说明
`EventLog.instance()`	类方法——获取单例日志实例
`log.log(severity, message)`	以给定严重级别写入消息

Severity

日志消息严重级别。

值	说明
`Severity.Info`	信息性消息
`Severity.Warning`	非致命警告
`Severity.Error`	可恢复错误