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`	回復可能なエラー