Settings

Settings は、Pie Menu Editor 全体の挙動を調整する設定画面です。Edit > Preferences > Add-ons から Pie Menu Editor を開き、画面上部の Editor / Settings タブの Settings 側で表示されます。

左側のタブで 10 枚に分かれています。上の 5 タブが全体に効く設定、中央の 4 タブが各エディター固有のデフォルト、最下段が開発者向けです。


General

PME 全体の使い勝手に関わる設定をまとめたタブです。エディター画面の見た目、メニューリストの幅・行数、自動バックアップやタグの自動付与、上級者向けトグルがここに集まります。各エディター固有のデフォルトは、後続のエディター別タブで設定します。

インターフェース

N-Panel Preferences

3D View の N-Panel に PME の設定を表示するかを切り替えます。有効にすると、3D View の N-Panel 内に PME タブが追加され、Preferences ウィンドウを開かなくても主要な設定にアクセスできます。

Expand Slot Tools

スロットエディタを開いたときに、コピー・削除・移動などのスロットツール群を最初から展開して並べるかを切り替えます。

Slot Tools 展開時

Operator Editor

Command タブで Operator Properties Editor(Blender の F6 / Adjust Last Operation と同等の入力 UI)を使うかを切り替えます。Off にすると、Blender の汎用フィールド入力にフォールバックします。

Multi-line Command Editor

Command と Custom のコードを複数行で編集します。Context Router の Target も対象です。Blender 5.2 以上で利用でき、既定ではオフです。それより前の Blender では設定が薄く表示されます。値は切り替えられますが、オンでも従来の1行欄を使います。

JSON のインポートで改行入りの Command または Custom が追加・置換されると、この設定が自動でオンになり、INFO メッセージで通知します。Blender 5.2 未満でも設定はオンになりますが、欄は1行のままです。

Shift+Enter で改行し、Enter で欄の編集を終えてから OK でスロットを保存します。Preferences ウィンドウでは、ポインターを欄外へ移して Enter でも保存できます。ポインターが欄上に残っていると、Enter は欄の再編集になります。右下の角をドラッグすると欄の高さを変えられ、収まらない本文は欄内でスクロールします。 PME の popup editor は、この設定が有効でも1行欄を使います。複数行の編集には Preferences を開いてください。

Recent Menu Targets

Widget Context Menu で、PME メニューへ要素を追加する際に、最近呼んだメニューを追加先候補として表示するかを切り替えます。デフォルトで有効です。

Persist Tree State

メニュー一覧のツリー表示で、展開/折りたたみの状態を Blender 終了後も保存するかを切り替えます。

Show Tree Group Counts

ツリー表示のグループ行(タグごとの見出しなど)に、含まれるメニュー数を表示するかを切り替えます。

List Width

エディター画面左側のメニューリストの幅(%)を指定します。範囲は 1〜80、デフォルトは 40。

List Rows

メニューリストに表示する行数を指定します。範囲は 5〜50、デフォルトは 10。

Search Keywords

メニューの Search / Select 機能で、メニュー名以外に検索対象に含めるトークンを選びます。以下から複数選択できます。

  • Hotkey — メニューに割り当てた hotkey 文字列(例: Ctrl+Shift+A)

  • Extend Target — Extend Panel / Extend Menu の差し込み先クラス ID(例: VIEW3D_MT_object)

  • UID — PME 内部の uid 文字列

デフォルトは Hotkey のみ。

自動化

Auto Backup

メニューを編集して保存するたびに、自動でバックアップを取るかを切り替えます。Menu Backups / Logs の Menu Backups にタイムスタンプ付きで蓄積されます。バックアップを 1 ファイルに上書きしたい場合は Overwrite Backup File を使います。

Auto-Tag New Menus

Tree Mode で Group by Tag を使っている場合、新規メニューに選択行のグループのタグを付けます。同じメニューが複数グループに表示されていても、選択した側のタグひとつだけを引き継ぎます。Untagged グループを選択している場合は、タグを付けません。

それ以外の表示では、タグフィルターが有効でタグをひとつだけ指定している場合(例: Modeling だけ表示中)に、そのタグを自動で割り当てます。

パフォーマンス

Cache Scripts

Custom / Command スロットから読み込む外部 Python スクリプトをキャッシュするかを切り替えます。同じスクリプトを繰り返し評価するメニューで起動コストを下げます。

Expert

Show Error Trace

スロットの Python 式(Description / Poll / Custom / Command)で例外が出たときに、トレース情報を表示するかを切り替えます。

Sidebar Tab Memory (Retired)

PME 2.1ではこの旧設定を表示・使用しません。Toggle Side AreaはSidebarのタブ名を別に読み書きして復元しません。Blenderでタブ情報を直接読み取る経路が強制終了につながる場合があるためです。Preserve Side Area State が対応するエディターの状態そのものを保持できた場合は、その一部として表示中のパネルが戻ることがありますが、すべてのSidebarタブを対象にした記憶機能ではありません。Sidebarの表示状態と、開いたエリアの幅または高さは、現在のBlenderセッション中は引き続き記憶されます。既存の設定はそのまま読み込めます。

Show Command Tab Undo

Command タブに Undo Previous Command チェックボックスを表示するかを切り替えます。詳細は Macro Operator Editor と Stack Key Editor を参照してください。

Preserve Side Area State

Toggle Side Area で閉じたり切り替えたりしたエディターの作業状態を、開き直したときに復元します。初期状態は OFF です。 Outliner の検索・フィルター、Properties のコンテキスト、Node Editor のノードツリーなどが対象です。 File Browser / Asset Browser は対象外で、記憶した状態は Blender の再起動後には引き継ぎません。

警告

実験的な機能のため、Blender が不安定になったり、バージョンによって復元できなかったりする場合があります。


Resources

Resources 設定:スクリプト、カスタムアイコン、バックアップ、ログの保存先

スクリプトとカスタムアイコンを読み込む場所、およびメニューバックアップとログの保存先を設定します。 Script Directories にスクリプト、Custom Icon Directories にカスタムアイコンの場所を登録します。最下段の枠には Menu Backups と Logs があります。

バージョン 2.2.0 で変更: 複数のリソースフォルダーに対応し、メニューバックアップとログの保存先を独立した設定にしました。 これらの場所は起動設定ファイルに保存されます。

Script Directories

各行に、スクリプトを読み込むフォルダーを登録します。+ からフォルダーを選ぶと、そのフォルダー名が Name に入ります。中に icons/ があれば、それも Custom Icon Directories に追加します。

  • Name — 一覧とファイル選択画面の Quick Locations に表示する名前。実際のフォルダー名は変わりません。

  • Path — 登録先のパス。欄を直接編集でき、絶対パスと 実行中の Blender の実行ファイル(Windows では blender.exe) があるフォルダーを基準とする相対パスを使えます。

すべての登録先を利用します。scripts/tool.py のようなスクリプト参照は登録先からの相対パスです。フォルダー内の構成と既定の場所は、保存先とフォルダ構成を参照してください。

異なるファイルが同じスクリプトパスやアイコン名を持つ場合は、タブの上部にそのパスを一覧表示します。名前が一意になるまで、それらのスクリプトとアイコンは使われません。ただし scripts/autorun/・scripts/register/・scripts/unregister/ のスクリプトは例外で、同名でもすべて実行されるため一覧に表示しません。 スクリプトの衝突は、登録先の追加・変更・削除のときに確認し、起動時には確認しません。Blender の再起動後や、Blender の外でファイルを追加・改名・移動した後は、Script Directories の + の左にある更新ボタンを押してください。

行末メニュー

各行の右端から、その登録先のスクリプトの件数を確認し、次の操作を行えます。

  • Open Folder — 登録先を OS のファイルブラウザーで開きます。

  • Choose Folder… — ファイルブラウザーで登録先を選び直します。

  • Create Subfolders — 不足している scripts/・exports/ を作成します。既存ファイルは保持します。

  • Remove Resource Folder — 確認後に登録を削除します。フォルダー内のファイルは残りますが、そのスクリプトを使うスロットからは見つからなくなります。アイコン用フォルダーの登録は残ります。最後の1件は削除できません。

Custom Icon Directories

各行に、PNG ファイルをカスタムアイコンとして使うフォルダーを登録します。直下のファイルだけを読み込み、下位フォルダーは読み込みません。 + から追加するか、Path を直接編集します。パスの規則(絶対パス・相対パス)はリソースフォルダーと同じです。 Blender の外で PNG ファイルを追加・変更した後は、Custom Icon Directories の + の左にある更新ボタンで読み直します。

行末メニューからアイコンの件数を確認し、Open Folder・Choose Folder…・Remove Icon Folder を行えます。 一覧は0件にでき、その場合は同梱アイコンだけを使います。削除してもフォルダー内のファイルは残ります。

Menu Backups / Logs

Menu Backups はメニュー設定のバックアップ先、Logs は診断ログの保存先です。 パス欄を直接編集するか、右端のフォルダーボタンから選び直します。 リソースフォルダーと同じ場所の配下にも、別の場所にも指定できます。リソース一覧を変更しても、これらの出力先は変わりません。

パスの変更は起動設定ファイルへ保存され、Save Preferences は不要です。 場所を変更しても既存ファイルは移動しません。

関連: 保存先とフォルダ構成、カスタムアイコン


Hotkeys

PME 自体のホットキーと、共通的なキー入力タイミングをまとめたタブです。PME を初めて開くときの起動 hotkey、Widget Context Menu の hotkey、HOLD / CHORD / TWEAK の判定時間や距離をここで設定します。Keymap Doctor から、現在有効な Blender キーマップとの競合も確認できます。

PME Hotkey

キャプチャーメニュー(Quick Capture)を開くホットキーです。初期設定は Ctrl+Shift+P。Blender の Screen Editing キーマップに登録されます。

Widget Context Menu

Interactive Panels 経由でキャプチャした UI 要素(ボタン / プロパティ / パネル)に対するコンテキストメニューを呼び出すホットキーです。マウス下のウィジェットに対して、PME メニューへの追加・コピーなどの操作を出します。

詳細は Interactive Panels と Extend Panel を参照してください。

Hotkey Modes

Drag Thresholds

Blenderの Preferences → Input → Mouse と同じ共通設定です。PMEの Tweak とBlenderネイティブのドラッグ操作に作用します。

  • Mouse Drag Threshold: マウスボタンを押したままドラッグするときの閾値。

  • Tablet Drag Threshold: マウスボタンを押したままペンでドラッグするときの閾値。

  • Drag Threshold: キーボードなど、マウスボタン以外を押したままドラッグするときの閾値。ペンやタブレットのボタンをキーボードキーへ割り当てた場合もこれを使います。

これらの距離にはBlenderのUIスケールが反映されます。押下位置から横か縦の移動量が、補正後の閾値を超えたときにTweakが始まります。

バージョン 2.1.1 で変更: Tweakが入力別の閾値とBlenderのUIスケールを使うようになりました。従来はすべてのTweakで、スケール補正のない Drag Threshold を使い、設定欄では Tweak Mode Threshold と表示していました。既存の割当にも新しい計算が適用されるため、反応する距離が変わる場合があります。保存済みの設定値は書き換えません。

Hold Mode Timeout

HOLD モードの判定時間(ミリ秒)です。キーを押してからこの時間を超えると HOLD 扱いになります。範囲は 50〜1000、デフォルトは 200。

Chord Mode Timeout

CHORD モードの判定時間(ミリ秒)です。最初のキーを押してからこの時間以内に次のキーを入力すると、CHORD として連続入力が成立します。範囲は 50〜1000、デフォルトは 300。

Show Next Key Chord

CHORD 入力中に、次に押せるキーをヒントとして画面に表示するかを切り替えます。

Native Click / Click Drag

Hotkey Modeのメニューに、Blender標準のClick / Click Dragを表示するかを切り替えます。標準では非表示です。すでにClick / Click Dragを選択したメニューでは、この設定をOFFにしても選択肢を表示します。

同じキーのPressが入力を処理すると、Clickが成立しない場合があります。詳しくはClickを設定しても開かないときを参照してください。

関連: Hotkey 設定

Keymap Doctor

Scan Keymaps は、各 PME Hotkey を現在有効な Blender の user keymap と比較し、同じキーマップ内の競合を表示します。あわせて、空の PME キーマップ項目、active layer に焼き付いた可能性がある PME 項目、判定を完了できなかった Hotkey も確認できます。

異なる Hotkey Mode、異なる CHORD、mouse modifier など、PME の dispatcher が意図どおり振り分ける組み合わせは競合件数に含めず、情報として区別します。同じ Hotkey Mode や同じ CHORD の重複、余分な ghost 項目は競合として残ります。

スキャン、概要のコピー、レポートの出力はキーマップを変更しません。Clean Up Empty Items が削除するのは、空だと確認できた PME 項目だけです。競合項目は自動的に変更・削除されません。


Overlay

メニュー実行中に画面上に重ねて表示するオーバーレイ(Stack Key の現在スロット名、Modal Operator の操作ガイド、各種ヒントメッセージ)の見た目を調整するタブです。文字サイズ、色、位置、フェード時間をまとめて設定します。

Font Size

オーバーレイ全体のフォントサイズ(ピクセル)です。範囲は 10〜50、デフォルトは 24。Stack Key や Modal Operator のラベルに使用されます。

Text Color

オーバーレイの主テキスト色です。RGBA で指定。Stack Key のスロット名や Modal Operator の現在モードに使われます。

Secondary

サブテキストの色です。RGBA で指定。Stack Key の補助テキスト、Modal の値表示などに使われます。

Background

オーバーレイの背景色です。RGBA で指定。Use Background が有効なときだけ描画に使われます。

Use Background

テキストの背景パネルを描画するかを切り替えます。

Use Shadow

テキストにドロップシャドウを乗せるかを切り替えます。デフォルトで有効です。

Alignment

オーバーレイの画面内アラインメント(上 / 中央 / 下 など)を指定します。

Offset X

画面端からの横方向オフセット(ピクセル)です。

Offset Y

画面端からの縦方向オフセット(ピクセル)です。

Duration

オーバーレイの表示時間(秒)です。範囲は 1〜10、デフォルトは 2。


GPU Layout

PME 2.0.0 で導入した独自描画レイヤ(Floating Panel や FPANEL 系の UI)の挙動を調整するタブです。tooltip の最大幅、INVOKE オペレーターの優先戦略、デバッグ用トグルなどがここに集まります。

Tooltip Max Width

GPULayout の tooltip テキストの最大幅(unscaled ピクセル)です。範囲は 160〜1200、デフォルトは 420。

Invoke Priority

オペレーターが INVOKE モードで呼ばれ、明示的な invoke_strategy 指定がないときの既定戦略を選びます。

  • Suspend — INVOKE_SUSPEND(パネルを生かしたまま)を優先。

  • Afterfunc — INVOKE_AFTERFUNC(閉じる → invoke → 再オープン)を優先。

Force INVOKE_AFTERFUNC Operators

INVOKE_AFTERFUNC を必ず使う対象のオペレーター ID 列です。bpy.ops.foo.bar のような ID を、カンマ・スペース・改行のいずれかで区切って並べます。

Force INVOKE_SUSPEND Operators

INVOKE_SUSPEND を必ず使う対象のオペレーター ID 列です。指定形式は上と同じ。

Debug Toggle Keys

Floating Panel 上で、開発用のキー入力(D = HitTest debug、V = Visible/Culling debug、M = Metrics debug)を受け付けるかを切り替えます。

Sync FPANEL to DIALOG

Floating Panel と並べて、レイアウト比較用の DIALOG コピーを開くかを切り替えます。GPULayout の見た目検証用です。

Show Unsupported FPANEL UI

Floating Panel 内で、まだ Blender の UILayout 経由で描画している(GPULayout 未対応の)開発用 UI を表示するかを切り替えます。デバッグ目的の項目です。

Layout Panel Header Spacing

UILayout.panel() のヘッダーレイアウトを使ったとき、ヘッダーとボディの間に上スペースを足すかを切り替えます。Show Unsupported FPANEL UI を有効にすると現れます。

Force Separator Line

AUTO セパレータを「線として描画」するか、「スペース確保のみ」にするかを切り替えます。


Pie Menu

Pie Menu の見た目と既定動作をまとめたタブです。Pie タイトルの有無、マウス位置の復元、Pie 内の追加スロット間隔がここで決まります。半径やしきい値などは Blender 標準のキー操作設定と共通で、同じ値をこのタブから一緒に変更できます。

Show Title

Pie Menu の上部にメニュー名を見出しとして描画するかを切り替えます。デフォルトで有効。

Restore Mouse Position

Pie Menu の hotkey を離した後に、マウス位置を起動時の位置に戻すかを切り替えます。Off にすると、選択したスロットの方向にマウスが残ります。

Extra Pie Slot Gap Size

Pie の 8 方向以外(上 / 下 の追加スロット 2 個)の間隔を指定します。

Animation Timeout (Blender)

Pie Menu が開くときのアニメーション時間です。Blender 標準のキー操作設定と共有しています。

Initial Timeout (Blender)

Pie Menu を開いてから入力受付までの遅延時間です。Blender 標準のキー操作設定と共有しています。

Menu Radius (Blender)

Pie Menu の半径です。Blender 標準のキー操作設定と共有しています。Pie Menu Editor 側で個別に Radius を指定すると、そのメニューに限りこの値が上書きされます。

Menu Threshold (Blender)

スロット選択のしきい値(フリック判定距離)です。Blender 標準のキー操作設定と共有しています。

Menu Confirm (Blender)

フリック確定のしきい値です。Blender 標準のキー操作設定と共有しています。

関連: Pie Menu Editor


Regular Menu

Regular Menu(ドロップダウンメニュー)の開き方の既定値をまとめたタブです。マウスホバーでサブメニューを開くか、その遅延時間をここで設定します。

Open on Mouse Over (Blender)

メニュー項目にマウスを乗せただけでサブメニューを開くかを切り替えます。Blender 標準のキー操作設定と共有しています。

Top Level

トップレベルメニューが開くまでの遅延時間です。Open on Mouse Over が有効なときだけ意味を持ちます。

Sub Level

サブメニューが開くまでの遅延時間です。Open on Mouse Over が有効なときだけ意味を持ちます。

関連: Regular Menu Editor


Popup Dialog

Pop-up Dialog の既定値をまとめたタブです。Spacer の扱い、ジャンプボタンの表示、新規ダイアログの初期モード、Toolbar モードの最大サイズがここで決まります。

Use ‘Spacer’ Separator by Default

空スロット(中身が空のスロット)を、デフォルトで Spacer(柔軟な余白)として扱うかを切り替えます。Off の場合は固定幅のセパレータになります。

Default Mode

新規 Pop-up Dialog の既定モードを Pie Mode / Popup Mode から選びます。

Max Width (Toolbars)

縦型 Toolbar モードの最大幅(ピクセル)です。デフォルトは 60。

Max Height (Toolbars)

横型 Toolbar モードの最大高さ(ピクセル)です。デフォルトは 60。

関連: Popup Dialog Editor


Modal Operator

Modal Operator のマウス動作と、各プロパティ型ごとの「動かしたときの単位」をまとめたタブです。マウスをどの方向にどれだけ動かすと値がどれだけ変わるか、ここで全エディター共通の既定が決まります。個別の Modal Operator 側で上書きしたい場合は、その Modal の詳細設定で同じ値を設定できます。

Mouse Movement Direction

マウスをどの方向に動かしたときに値を変えるかを選びます(縦 / 横 / 距離 など)。Modal Operator 全体に影響します。

Mouse Threshold (Int)

INT プロパティで、値を 1 変えるのに必要なマウス移動量(ピクセル)です。小さくすると敏感に、大きくすると粗くなります。

Mouse Threshold (Float)

FLOAT プロパティの同上です。プロパティの step 値に対する 1 単位分のマウス移動量を指定します。

Mouse Threshold (Bool)

BOOL プロパティのトグルしきい値です。左にあるトグルで「BOOL に対してもしきい値を使うか」を切り替え、その状態でフィールドが有効になります。

Mouse Threshold (Enum)

ENUM プロパティの項目切替しきい値です。左にあるトグルで「ENUM に対してもしきい値を使うか」を切り替え、その状態でフィールドが有効になります。

関連: Modal Operator Editor


Developer

開発・診断向けの設定です。普段の編集では使いません。Boot Config(起動オプション)、Logger(ログ)、Backup / Export 用の開発フラグがここに集まります。

Boot Config

Open Boot Config Folder

Boot Config が保存されているフォルダを OS のファイルブラウザで開きます。

Enable import pme Alias

sys.modules['pme'] を登録するかを切り替えます。外部スクリプトやアドオンから import pme で PME の公開 API にアクセスしたいときに有効化します。次回起動から反映されます。

Enable Init Log

アドオン起動時の init 診断ログを記録するかを切り替えます。次回起動から反映されます。

Use Bundled Loader Manifest

同梱の loader manifest を使った高速起動を有効にするかを切り替えます。manifest が見つからない / 壊れている場合は、動的検出に自動でフォールバックします。次回起動から反映されます。デフォルトで有効。

Auto-Save Candidate on Startup

起動成功後に、動的検出で得たモジュール順を candidate manifest として loader_manifest.json の隣に自動保存するかを切り替えます。loader manifest の整備フローで使います。

Logger

Open Log Folder

ログの出力フォルダを OS のファイルブラウザで開きます。

Use Colors

コンソール出力に色を付けるかを切り替えます。デフォルトで有効。

File Output (JSONL)

セッションごとに JSONL ログファイルを書き出すかを切り替えます。

Keep Last

メモリ上のリングバッファに残す最近ログの件数です。範囲は 0〜5000、デフォルトは 200。

Logger Categories

カテゴリ別にログの有効/無効と Log Level を設定します。出荷時の既定では、内部・開発系カテゴリは Off、ユーザー向けの user_exec だけが On で警告/エラーを拾います。

Apply Level / Apply to All

選んだ Log Level をすべてのカテゴリに一括適用します。プルダウンでレベルを選び、Apply to All ボタンで反映します。

Backup

Overwrite Backup File

Auto Backup で作るバックアップを、タイムスタンプ別ではなく単一ファイルに上書きする形で保存するかを切り替えます。

Export

Sort Exported Menus by Name

メニューを Export するときに、メニュー名でソートして書き出すかを切り替えます。Off の場合は PME 内部の順序を保ったまま書き出します。


参考