Pie Menu Editor¶
Pie Menu は、Blender のパイメニューに操作を配置するエディターです。 8 方向の項目と、追加の上・下 2 スロットを編集できます。 ショートカットから開くほか、別のメニューの Menu スロットからも呼び出せます。
このページの設定名と制約は PME 2.1 を対象にしています。 旧版の画像・動画では、現在の UI と配置が異なる場合があります。
構成ガイド — 機能・組み合わせ・活用例（AI 向け）
呼び名：Pie Menu（パイメニュー）／種別 ID：PMENU。
ユーザーへの説明には呼び名を使い、データや実装との照合には種別 ID を使います。
役割は、Blender 標準のパイメニューを使い、8 方向と上下の追加スロットに割り当てた内容を表示することです。
スロットは 10 個固定。空のスロットも位置を保持します。
スロットに割り当てるもの
タブ名 |
割り当てと用途 |
種別 ID |
|---|---|---|
Command |
操作を実行する。単一のオペレーターや、複数処理を行う Python コード |
|
Property |
RNA プロパティへのパスを指定し、値を表示・変更するウィジェットを配置する |
|
Menu |
PME で作成した別のカスタマイズを参照する。参照先により呼び出し・描画の意味が変わる |
|
Hotkey |
実行時のコンテキストに応じたキー割り当てを探し、そのオペレーターを実行する。キー入力との違いに注意 |
|
Custom |
Blender の UI レイアウト（ |
|
未割り当ては空スロット（EMPTY）。コードを提案する場合は、先に
コードの書き方と入力制限で入力先ごとの制約を確認します。
Menu で組み合わせる意味 — 代表的な使い分け
Pie Menu → Pie Menu：ネストしたパイを開く。操作をカテゴリに分け、キーを保持したまま次の階層へ進める構成には、親の Confirm on Release と正の Confirm Threshold を使う。ネストの設定例 を参照。
Pie Menu → Regular Menu / Popup Dialog：別のメニューとして開くか、Expand Regular Menu / Expand Popup Dialog で中身を Pie 内に配置する。Popup Dialog の展開では、配置先のスロットで幅と位置も調整できる。展開の使い分けと条件を参照。
Pie Menu → Property / Property Stack：参照先が提供するプロパティのウィジェットを配置する。子メニューを開く操作として扱わない。
これは代表例であり、参照先の全一覧ではありません。Menu タブでの参照と、Command からのスクリプト呼び出しは別の経路です。
活用例と、設計時に決めること
通常のホットキーから開く：利用するエディター・Keymap とキーを決める。Click Drag の設定値は
TWEAK。Keymap / Hotkey へ。Context Router の分岐として使う：モードや対象に応じて表示する Pie Menu を切り替える。分岐条件と、どれにも一致しない場合の動作を決める。コンテキストによる切り替え へ。
親の Pie Menu から詳細な操作へ進む：親にカテゴリ、子に個別操作を割り当てる。クリックで開くか、キーを保持して距離で進むかを決める。ネストの設定例 へ。
各操作が使えるエディター・モード・対象の有無は、メニューを組み合わせるだけでは保証されません。 利用条件は Poll、スロットの配置と編集は メニュースロット を参照してください。
画面と編集の流れ¶
1名前と基本操作メニュー名はカスタマイズ全体を識別する名前です。この行で有効状態を設定し、プレビューや詳細設定を開きます。
2Advanced settingsメニューの説明と利用できる条件、パイの表示半径、項目を選択・確定する方法を設定します。
3Keymap / HotkeyKeymap は呼び出す場所、Hotkey はキーと修飾キーを指定します。Open Mode は押す・保持するなど、メニューを開く操作を決めます。
4メニュースロット8方向と追加の上・下、計10個の固定スロットに操作・プロパティ・別メニューなどを配置します。空のスロットは表示されません。
詳細設定と呼び出し方を設定し、10 個のスロットに操作やプロパティを割り当てます。
Expand Slot Tools は、各スロットの編集・コピー・移動などの操作を右端に並べる表示設定です。 操作の意味は 共通の Expand Slot Tools を参照してください。 名前・タグ・検索・追加など、画面全体の使い方は エディターの共通要素 にまとめています。 ここからは Pie Menu 固有の配置と動作を説明します。
名前と基本操作¶
左から 有効／無効 → プレビュー → 選択メニュー → 名前 → タグ → ドキュメント → Advanced settings。
メニュー名はカスタマイズ全体に付ける名前です。画像では Transform Preset Pie がこれに当たります。 この行では、編集対象を識別する名前と有効状態を設定し、プレビューや詳細設定を開けます。 下の各スロットの表示名とは別です。各ボタンの詳細は 選択メニューの設定 を参照してください。
Advanced settings（詳細設定）¶
Advanced settings では、メニューの説明と利用できる条件、パイの表示半径、項目の選択・確定方法を設定します。 選択メニューの歯車ボタンから開きます。
Description：このメニューの説明文。Python で動的な説明を返すこともできます。書き方は 共通の Description を参照してください。
Poll：現在のコンテキストでメニューを利用できるかを判定する条件。詳しくは 共通の Description / Poll を参照してください。
Pie Menu 固有の距離と確定方法は、次の設定で調整します。
設定 |
意味 |
範囲・既定値 |
|---|---|---|
Radius |
メニューの表示半径。選択を判定する距離とは別 |
|
Confirm on Release |
起動キーを離して項目を確定する操作を有効にする |
既定は ON |
Threshold |
中心から、方向による選択が始まるまでの距離 |
|
Confirm Threshold |
Threshold の外側に加える、距離による確定のための距離 |
|
距離の入力欄の単位はピクセルです。Blender の UI スケールも実際の判定に影響します。 Threshold と Confirm Threshold は、Confirm on Release が ON のときに表示されます。 OFF にすると、これらのメニュー個別の距離設定は使用されません。
Radius を Blender の現在値と異なる値にした場合、PME は表示半径を適用するために パイメニューのアニメーションを一時的に無効化します。
選択距離と表示半径を区別する¶
次の図は、起動キーを保持して 8 方向の通常の項目を選ぶ操作での距離の関係です。 Radius は項目を表示するための寸法なので、この確定距離の計算には足しません。
flowchart LR
A["中心"] -->|"Threshold"| B["選択開始の境界"]
B -->|"Confirm Threshold"| C["距離で確定する境界"]
Confirm Threshold が正値の場合に、この距離による確定を使えます。
たとえば Threshold を 20、Confirm Threshold を 40 とすると、
距離による確定の境界は、UI スケール適用前で中心から 60 です。
Confirm Threshold を Threshold より大きくする必要はありません。
境界を越えた瞬間に必ず実行されるのではなく、Blender がマウスの短い停止を検出して確定します。
Confirm on Release も、起動キーを短くタップすれば必ず閉じるという保証ではありません。 短いタップでは、Blender がクリックで選ぶ操作へ切り替える場合があります。
Keymap / Hotkey¶
上から Keymap（使う場所）→ Hotkey（起動キー）→ 修飾キー。左の三角から Open Mode（開くタイミング） を設定します。
呼び出す場所を Keymap、キー操作を Hotkey として設定します。 入力欄の操作は 共通の Hotkey 設定 を参照してください。
通常の Open Mode は Press / Hold / Double Click / Click Drag / Key Chords です。 Click Drag はドラッグで開くモードです。 Experimental の項目は通常の選択肢と区別してください。
Open Mode は「いつ開くか」の設定です。開いた後の選択・確定を調整する Confirm on Release や Threshold とは別の設定です。
メニュースロット¶
上の8行がパイの8方向、間隔を空けた下の2行が追加の上・下スロットに対応します。 画像は Expand Slot Tools が ON で、右端に操作ボタンを展開した状態です。
スロットは、パイメニューに配置する操作やプロパティなどの項目です。 Pie Menu は 10 個のスロットで構成されます。
8 方向（上下左右 + 斜め 4 方向）と、垂直方向の追加スロット 2 個（最上部・最下部）。
スロットの位置と数は固定です。項目の中身は Move Slot で別の位置と交換できます。
スロットの方向は、メニューを起動した画面上の位置を基準にした絶対方向です。
空のままのスロットはパイメニュー上に描画されません。
スロットには次のタイプを設定できます。入力欄の操作やコードの共通説明は スロットエディタ にまとめています。
タイプ |
Pie Menu に配置するもの |
|---|---|
Command |
選ぶと操作を実行する項目 |
Property |
RNA プロパティへのパスを指定して、値を表示・変更するウィジェット |
Menu |
PME で作成した別のメニューへのリンク |
Hotkey |
実行時のコンテキストに応じたキー割り当てのオペレーターを呼ぶ項目 |
Custom |
Blender の |
Custom でパイのレイアウト直下に複数の要素を追加すると、後続の項目が使う方向がずれます。 一つのスロット内の UI をまとめる書き方は、スロットタイプ の Custom を参照してください。 スロットの編集・アイコン・ラベル・追加ツールは 共通のスロット一覧 で説明しています。
A. スロットを編集¶
一番左の方向の矢印を押すと、スロットエディタ が開きます。 Command / Property / Menu などのタブを選び、スロットの中身を設定します。 この画像では矢印の向きがパイ上の位置を表しています。
B. アイコン¶
矢印の右隣は、スロットに表示するアイコンの設定です。 左端のスロット編集ボタンとは別の操作です。
C. 表示名¶
Local などの文字列は、メニューに表示するスロットのラベルです。 カスタマイズ全体の名前や、Menu タブで指定したリンク先とは区別します。
D. リンク先のカスタマイズへ移動¶
鎖のボタンは、スロットエディタの Menu タブでリンクした別のカスタマイズの編集画面へ移動します。 リンク先の中身を確認・編集するための入口です。リンクする対象の設定は Menu タブで行います。 リンク先への移動ボタンなので、すべてのスロットに表示されるわけではありません。
E. カスタマイズオプション（Expand Slot Tools）¶
右端はスロットごとの操作です。この画像は Settings > General > Expand Slot Tools が ON のため、 通常はメニューにまとまっている操作を、個別のアイコンとして展開しています。
左から Edit Slot / Copy / Move Slot / Enabled・Disabled / Clear。 コピー済みのスロットがある場合は Paste も表示されます。 編集内容の設定そのものを展開する機能ではなく、操作ボタンの表示を切り替える設定です。 詳しくは 共通の Expand Slot Tools を参照してください。
項目を作って確認する¶
10 個のうち、配置したい方向のスロット編集ボタンを押します。
Command / Property / Menu / Hotkey / Custom から用途に合うタイプを選びます。
内容・表示名・アイコンを設定して OK で確定します。
実際に使うエディターからメニューを開き、方向と動作を確認します。
既存のプリセットから項目を作る場合は スロットのプリセット を参照してください。 コードを書く場合は コードの書き方と入力制限 で設定先と長さを確認できます。 プレビューを開けることだけでは、呼び出し元のモードや選択状態で操作が成立する証拠にはなりません。
応用的な使い方¶
コンテキストに応じて切り替える¶
Added in version 2.1: Context Router による条件分岐。
モードや対象オブジェクトに応じてメニューを出し分ける用途には、Context Router を使えます。条件の範囲と、どの条件にも一致しない場合の動作を決めてから、 各分岐の呼び出し先を設定します。
コードで条件を判断する場合も、Object Mode 以外をすべて Mesh Edit Mode と扱ったり、 アクティブオブジェクトが必ずあると仮定したりしないでください。
スクリプトから別のメニューを呼び出す¶
Command スロットから名前を指定して呼ぶ場合は、次のように書けます。
この例には My Sub Menu というメニューが必要です。
open_menu("My Sub Menu")
Open on Mouse Over は対応するメニューをホバーで開く設定です。 Pie の方向選択による子 Pie の呼び出しとは区別して使います。
Hotkey スロットと実際のキー入力の違い¶
Hotkey スロットは、実行時のエディターやモードに対応するキーマップから、指定したキーと修飾キーに一致する 有効な Press の割り当てを探し、実行可能なオペレーターを呼び出します。 同じキーでも、実行時のコンテキストやユーザーのキー設定によって結果が変わります。
キーの押下・保持・解放をそのまま再現する機能ではありません。 Hold や Double Click、モーダル中のキー操作を同じように再生できるとは考えないでください。 また、PME のメニュー呼び出し用キーはこの検索から除外されます。 別の PME メニューを開く目的なら Menu タブを使います。
Pie 内のトグル・スライダー・プロパティ¶
既存の Blender プロパティを表示する場合は、まず Property スロットを使います。
複数の UI 要素を組み合わせる場合は Custom スロットでレイアウトを記述できます。
次は 3D Viewport 内でグリッドの表示を切り替える例です。
C.space_data が 3D Viewport のものであることを確認してください。
L.prop(C.space_data.overlay, "show_floor")
プロポーショナル編集のようにエディターやモードによって参照先が異なる設定は、 ひとつのプロパティパスで全場面を扱えるとは限りません。 表示する場所と操作対象を分けて調べ、必要に応じて Context Router で切り替えます。
参考動画（原作者のチャンネル）¶
roaoao の動画一覧より。旧版の UI・手順を扱う参考動画です。