起動オプション¶
Added in version 2.0.3.
PME には、Blender の起動時に読み込まれる設定ファイル boot_config.json があります。
通常の Preferences とは別に管理され、アドオンの登録処理よりも前に 読み込まれます。
注釈
ここで変更した設定は 次回の Blender 起動から 有効になります。
設定の場所¶
Preferences > Settings > Developer タブから設定できます。
Tip
Open Boot Config Folder ボタンで、boot_config.json があるフォルダを直接開けます。
OS |
PME 2.1 Extensionの |
|---|---|
Windows |
|
macOS |
|
Linux |
|
ExtensionとLegacy add-onは別の設定ファイルを使います。Legacy add-onのファイルは
同じpie_menu_editorフォルダー直下のboot_config.jsonです。通常はパスを手入力せず、
Open Boot Config Folderを使ってください。
このファイルはアドオンの更新では上書きされません。 ユーザーリソース とも独立した保存先です。
import pme を有効にする¶
外部スクリプトやアドオンから Public API を import pme で利用するには、明示的な有効化が必要です。
手順¶
Preferences > Settings > Developer を開く
Enable import pme Alias を ON にする
Blender を再起動する
# 有効化後、外部スクリプトから利用可能
import pme
pme.invoke_pm("My Pie Menu")
なぜ明示的に有効化が必要なのか¶
Blender Extensionの実装package名は、インストール元に応じて
bl_ext.<repository>.pie_menu_editorのように変わります。import pmeは、その物理名を
外部スクリプトへ固定せずに使うため、PMEがBlender processへ登録する短いエイリアスです。
このエイリアスはprocess全体で共有されるtop-level名なので、必要なユーザーだけが有効にする オプトイン方式です。この設定はエイリアスの有効化だけを制御します。Public API自体は 引き続きExperimentalです。
注釈
エイリアスを有効にすると、Extensions画面に次の警告が表示されることがあります。
Policy violation with top level module: pmePolicy violation with top level module: pme.constants
これは、Extensionのbl_ext... namespace外にtop-level名でmoduleが登録された場合に
Blenderが表示する警告です。PMEのオプトインエイリアスでは想定内の表示であり、PMEの
有効化失敗やimport pmeの故障を意味しません。エイリアスを利用できていれば追加対応は
不要です。エイリアスを使わない場合は、この設定をOFFにしてBlenderを再起動してください。
参考
Public API リファレンス — import pme で利用できる関数の一覧
初期化ログを有効にする¶
PME の起動時に問題が発生した場合、初期化ログを有効にすると原因の特定に役立ちます。
Settings から有効にする（推奨）¶
Preferences > Settings > Developer を開く
Enable Init Log を ON にする
Blender を再起動する
Window > Toggle System Console（Windows）またはターミナルからの起動（macOS/Linux）でコンソール出力を確認する
boot_config.json を直接編集して有効にする¶
起動トラブルで Preferences から設定できない場合や、外部ファイルから次回起動用の設定を切り替えたい場合は、boot_config.json を直接編集できます。
{
"version": 1,
"enable_public_api_alias": false,
"init_log_enabled": true,
"persistence_backend": "prefs",
"dev": {
"use_loader_manifest": true,
"auto_generate_candidate": false
}
}
既存の boot_config.json がある場合は、init_log_enabled を true に変更してください。
変更は次回の Blender 起動から有効になります。
コマンドラインで 1 回だけ有効にする¶
設定を変更せず、1 回だけ初期化ログを出力したい場合:
# macOS / Linux
blender --python-expr "import sys; sys.argv.append('--pme-log-init')" --
# Windows
blender.exe --python-expr "import sys; sys.argv.append('--pme-log-init')" --
Tip
コマンドライン引数 --pme-log-init は Settings の設定より優先されます。
boot_config.json を変更せずに一時的にログを取りたいときに便利です。
ログの確認方法¶
初期化ログは以下の場所で確認できます:
Blender のシステムコンソール — 起動直後のログがリアルタイムで表示されます
Preferences のログビューア — Preferences > Settings > Log タブで、ring buffer に保存されたログを確認できます
設定のリセット¶
起動オプションをすべて初期状態に戻すには、boot_config.json を削除してください。
次回の Blender 起動時にデフォルト値で自動的に再生成されます。
警告
boot_config.json が壊れている場合も、PME はデフォルト値で起動を続行します。
PME が起動できなくなることはありません。