Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Pie Menu Editor 2.3 ドキュメント
Pie Menu Editor 2.3 ドキュメント

はじめる

  • インストール
  • 基本的なパイメニューの作成
  • 使用例とアイデア
    • コード例

エディタ

  • エディターの共通要素
  • Hotkey Mode
  • Pie Menu Editor
  • Vector Menu Editor
  • Regular Menu Editor
  • Pop-up Dialog Editor
  • Floating Panel Editor
  • Sticky Key Editor
  • Stack Key Editor
  • Macro Operator Editor
  • Modal Operator Editor
  • Property Editor
  • Property Stack Editor
  • Context Router Editor
  • Side Panel Editor
  • Hiding Unused Panels
  • Interactive Panels と Extend Panel
  • UI Customization
  • キャプチャーメニュー
  • カスタムアイコン
  • Settings

スクリプティング

  • コードの入力と実行
  • API リファレンス
  • スクリプトの管理
  • 同梱ユーティリティー
  • Context Browser

参考資料

  • キーマップの選び方
  • キーマップの重複
  • Poll Method
  • 用語集
  • 保存先とフォルダ構成
  • 起動オプション
  • 開発者オプション
  • ビデオチュートリアル

サポート

  • FAQ
  • 既知の問題
  • サポート
  • Change Log
🇺🇸 🇯🇵
Back to top
View this page

Pop-up Dialog Editor¶

Pop-up Dialog は、ボタン・プロパティ・スライダー・チェックボックスを行と列で組み立てた小さな UI パネルを、その場でポップアップとして表示するエディターです。Pie Menu や Regular Menu と異なり、レイアウトを自分で構成できます。

構成ガイド — 機能・組み合わせ・活用例(AI 向け)

呼び名:Popup Dialog/種別 ID:DIALOG。 行・列に操作と設定をまとめ、ダイアログやポップアップとして表示します。Command / Property / Menu / Hotkey / Custom を使い、行・列を追加して構成します。

  • 割り当て:Property は RNA パスによる設定ウィジェット、Command は操作を実行する Python、Custom は Blender の UILayout を使う描画コードです。

  • Menu の組み合わせ:別のメニューを開くほか、Regular Menu / Popup Dialog を展開できます。Property / Property Stack の参照は設定ウィジェットの配置です。

  • 配置:ホットキーから開く/Pie Menu の中へ展開する/既存の Panel・Header へ差し込む。展開先の幅・位置は、参照するスロット側の設定と区別します。

  • 設計:レイアウトの行・列と、ポップアップの Mode を分けて決めます。画面が開くことと、そのコンテキストでボタンが実行できることは別に確認します。

行と列は レイアウト、差し込みは Extend Target、表示の設定は Advanced settingsへ。

画面と編集の流れ¶

Viewport Display Menu の編集画面。 1名前と基本操作編集対象の名前と有効状態を確認し、プレビューや詳細設定を開きます。 2Extend Target既存のパネルやヘッダーへの差し込み先を指定します。この例は未指定です。 3Advanced settings説明、利用条件、表示モード、幅、プロパティの配置を設定します。 4Keymap / Hotkey呼び出す場所とキーを設定します。 5メニュースロット表示設定を行と列にまとめます。各行と項目の右端から編集操作を選びます。
Blender 5.2 / PME 2.1 の開発環境。「Viewport Display Menu」の設定例。
  1. 名前と基本操作

  2. Extend Target

  3. Advanced settings

  4. Keymap / Hotkey

  5. メニュースロットとレイアウト

名前と利用条件、呼び出し方を設定し、スロットでメニューの内容を組み立てます。

名前と基本操作¶

Viewport Display Menu の 名前と基本操作。編集対象の名前と有効状態を確認し、プレビューや詳細設定を開きます。
名前と基本操作。値はこの例の設定です。

有効状態、プレビュー、選択メニュー、名前、タグ、ドキュメント、詳細設定の操作です。各ボタンは 選択メニューの設定を参照してください。

Keymap / Hotkey¶

Viewport Display Menu の Keymap / Hotkey。呼び出す場所とキーを設定します。
Keymap / Hotkey。値はこの例の設定です。

使う場所を Keymap、起動キーと修飾キーを Hotkey で設定します。Open Mode は開くタイミングです。入力欄は 共通の Hotkey 設定を参照してください。

Extend Target¶

Extend Target に TOPBAR_HT_upper_bar を指定した例。差し込み位置、右リージョンへの切り替え、表示順を設定できます。

TOPBAR_HT_upper_bar を差し込み先に指定した例。¶

トップバー直下にあり、Blender の既存パネル / ヘッダーにこの Pop-up Dialog を差し込むための行です。

Added in version 2.0.0: Extend Panel / Extend Header を再設計し、同じ Target に複数の Pop-up Dialog / Regular Menu を重ねられるようになりました。

Extend Target:

差し込み先の Blender クラス ID。検索付きで、Interactive Panels の Copy Panel ID で取得した文字列をそのまま貼り付けできます。未指定の場合は通常の hotkey 呼び出し型として動作します。

Side:

差し込み位置。Prepend は先頭、Append は末尾に追加します。画像では左右の三角ボタンで選びます。

R:

Target が TOPBAR_HT_ の場合に限り表示され、TOPBAR ヘッダーの右リージョンに差し込むかを切り替えます。

Order:

同じ Target に複数のメニューが差し込まれている場合の表示順。値が小さいほど先に描画されます。

差し込み手順の詳細は Interactive Panels と Extend Panel を参照してください。

Advanced settings¶

Viewport Display Menu の Advanced settings。説明、利用条件、表示モード、幅、プロパティの配置を設定します。
Advanced settings。値はこの例の設定です。

Description と Poll は、説明文と利用条件の設定です。Python による動的な説明も使えます。共通の 詳細設定を参照してください。

Added in version 2.1: Property Split でラベルと入力欄を整列できます。メニュー全体の設定に加え、項目ごとの切り替えも使えます。

Property Split はプロパティ名と値を分けて表示し、Property Decorators はアニメーションに関する装飾表示を設定します。

表示モード¶

ポップアップダイアログのモード設定

ポップアップの見た目と閉じ方を 3 つのモードから選びます。

モード比較¶

モード

Pie

Dialog

Popup

マウスをポップアップ外に移動すると閉じる

❌

❌

✅

ポップアップ内のウィジェットを操作すると閉じる

✅

❌

❌

OK ボタン

❌

✅

❌

移動可能

❌

✅

✅

幅をカスタマイズ可能

❌

✅

✅

レイアウト¶

Blender の行と列のレイアウトシステムをそのまま使い、Pop-up Dialog の UI を組み立てます。

スロットはボタンやプロパティなどのウィジェットになります。行を列に分け、必要に応じてサブ列・サブ行を追加します。スロットの追加・削除・並び替えは、ポップアップの見た目に反映されます。

レイアウトのデモンストレーション

エディタ上では、行に対して列を設定し、必要に応じてサブ列とサブ行を追加していきます。

サブ列を追加するには、いずれかのボタンで LMB を押してメニューを開き、Column セパレータを選択します。サブ列にさらにサブ行を追加するには、メニューにある Begin Subrow と End Subrow を使います。

Custom スロットで Python のレイアウト API を直接書けば、デフォルトのボタンの代わりに任意のウィジェットを描画できます。

行・列を組み合わせた配置の参考に、原作者 roaoao の動画を紹介します。旧版の UI ですが、複雑なレイアウトを組み立てる流れを確認できます。

Popup Dialog with Complex Layout

Popup Dialog with Complex Layout — YouTube で開く

レイアウトを親ポップアップに展開する¶

レイアウト展開設定

別の Pie Menu や Pop-up Dialog のスロットからこの Pop-up Dialog を呼んだとき、独立ポップアップとして開くか、呼び出し元のメニューにレイアウトを展開するかを選べます。呼び出し元側で Menu タブの Expand Popup Dialog を有効にすると、展開動作になります。

固定列¶

固定列のデモンストレーション

Fixed Columns を有効にすると、列幅を揃えます。ピクセル数を指定する設定ではありません。

配置¶

配置のデモンストレーション

行に列がない(行を分割していない)場合、その行内のボタンの水平方向の配置を左寄せ / 中央 / 右寄せから選べます。


パネルの組み込みとリンク操作¶

Added in version 2.0.5: 折りたたみパネルと、エディターのリンクボタンの表示設定が追加されました。パネルの組み込みには Blender 4.2 以降が必要です。

メニュースロット。Display As のパネル行と、通常の Menu スロット・パネル本文のリンクボタン。
APanel Row別のダイアログを、開閉できるパネルとして組み込みます。 Bリンク先を編集通常の Menu スロットの参照先へ移動します。Editor Link Buttons で表示を切り替えます。 Cパネルの中身を編集参照先ダイアログへ移動します。このリンクボタンは常時表示されます。
A:Panel Row、B:通常スロットのリンク、C:パネル本文のリンク。

A. Panel Row — 別の Pop-up Dialog を、開閉できるパネルとして組み込みます。「Display As」がパネルの中身として参照するダイアログです。本文から 参照先や初期状態、右端のパネルアイコンから 行全体の操作を設定します。

B・C. リンク先を編集 — 鎖のボタンから、参照先メニューの編集画面へ移動します。

  • B:通常の Menu スロットでは、Editor Link Buttons でボタンの表示を切り替えます。OFF でも スロットの操作メニューの Go to Linked Menu から移動できます。

  • C:Panel Row の本文のボタンは常時表示されます。本文の操作メニューの Go to Panel Content からも移動できます。参照先が無効な場合は移動できません。

スロットと行の編集¶

スロットの内容¶

項目を実行したときに評価する Python コードを設定します。 オペレーターを呼び出す場合は、実行するエディター・モード・選択状態に対応した処理を使います。

# 3D Viewport の Object Mode で立方体を追加する
bpy.ops.mesh.primitive_cube_add()

コマンドの記述方法

Command の保存と Blender 標準 UI 経由の実行には、PME 独自の文字数上限はありません。 GPU メニュー(Floating Panel / Vector Menu)の Command で運ぶ文字列(本文または文字列引数)は、それぞれ 4,096 文字までです。超過すると実行されず、operator_property_string_too_long 診断が出ます。 短い単純文は ; で区切れますが、インデントを持つブロックを機械的に 1 行へ変換しないでください。 入力操作と外部スクリプトへの分割は コードの入力と実行 を参照してください。

グローバル変数

利用可能なグローバル変数の例:

  • C: PME がスクリプトに提供するコンテキスト

  • O: bpy.ops(Blenderのオペレーター)

  • E: event(イベント情報)

Scripting Reference でグローバル変数の説明を確認できます。

オブジェクトのプロパティへのパスを指定し、ウィジェットとして表示します。 例:bpy.context.object.locationでオブジェクトの位置を表示・編集できます。

tool_props() で参照するツール設定は、対象のエディター・モード・ツールで利用できる間だけ表示します。 それ以外のときは非表示になります。表示条件や代替表示を指定する場合はCustomタブを使います。 関数の引数はAPIリファレンスを参照してください。

高度なプロパティ操作

インデックス指定やより複雑なプロパティ操作が必要な場合は、Property Editorを利用してください。

ボタンがクリックされた時にPME内で作成した他のメニューアイテムを呼び出します。 例:

  • Popup DialogをExpand Popup Dialogで表示

  • Regular MenuをOpen on Mouse Overで表示

  • Macro Operatorを実行

ボタンがクリックされた時に、指定されたBlenderのホットキーに割り当てられているオペレーターを検索して実行します。 例:GでGrab(移動)、RでRotate(回転)など、Blenderの標準ホットキーを利用できます。

UI を描画するときに評価する Python コードを設定します。 L はレイアウトオブジェクトで、Blender のレイアウト API を使って UI を構築できます。 再描画でも実行されるため、オブジェクトの追加・削除などの処理を直接書かず、 その処理を実行するボタンを配置します。

# ボックス内にラベルを表示
L.box().label(text="メッシュを追加")
# 複数のボタンを縦に配置
col = L.column(); col.operator("mesh.primitive_cube_add", text="立方体"); col.operator("mesh.primitive_uv_sphere_add", text="球")

上は独立した二つの例です。Pie Menu の 1 スロットに複数の UI 要素を置く場合は、 二つ目の例のように、一つの column や box の中にまとめてください。 パイのレイアウト直下へ複数の要素を追加すると、後続スロットの方向がずれる原因になります。 Vector Menu では、L.menu_pie() に描いた本文の項目をメニューの周りに並べられます。一つのスロットの項目を Pie Menu のように並べる を参照してください。

Custom の本文には、PME 独自の文字数上限はありません。 GPU メニュー(Floating Panel / Vector Menu)の通常 Command と Context Router の Command Target で運ぶ文字列(本文または文字列引数)は、それぞれ 4,096 文字までで、超過は実行されず operator_property_string_too_long 診断になります。 コードの入力と実行 で、 入力操作、複数行、外部スクリプトの扱いを確認できます。

スロットを追加する(プリセット)¶

PME Slot Examples

一番右のハンバーガーメニュー()を押すと、あらかじめ用意されたいくつかのスロット機能を追加することができます。


スロットのボタンから開くメニューは、内容・アイコン・位置を編集します。行の右端から開くメニューは、行全体の大きさ・余白・追加・移動を扱います。選んだスロットの種類や行の構成に応じて、項目が変わります。

スロットの操作(PDI)¶

通常スロットの操作メニュー。Edit Slot、Change Icon、Visible、スロットの追加・コピー・移動、Separator、Alignment が並びます。

通常スロット「Button 1」の例。¶

項目

操作・表示条件

Edit Slot

スロットの内容を編集する。

Change Icon

アイコンを変更する。

Hide Text

表示名を隠し、アイコンだけにする。アイコンがあるスロット、または Property スロットで表示。

Visible

スロットの表示状態を切り替える。

Go to Linked Menu

参照先メニューを編集対象として開く。リンク先のある Menu スロットで表示。参照切れなどでは無効になる。

← Add Slot / → Add Slot

選択スロットの左 / 右に追加する。

Split Row

このスロットの手前で行を分割する。列分割・位置揃えのない通常行の、先頭以外で表示。

Copy Slot / Paste Slot

スロットをコピー / コピーした内容を貼り付ける。Paste Slot はスロットをコピー済みの場合に表示。

Move Slot

スロットの移動先を選ぶ。Panel Row のヘッダーでは表示されない。

Enabled / Disabled

スロットの有効・無効を切り替える。表示名は現在の状態によって変わる。

Remove Slot / Remove Row

スロットを削除する。行内に一つしかない場合は行の削除になり、他の行がある場合に表示される。

右側のグループは、スロットの手前の区切りや配置を設定します。

グループ

項目と意味

Separator

None:区切りなし。Spacer:手前に余白を入れる(行頭以外)。Column:ここから新しい列にする(Panel Row のヘッダーや位置揃えのある行などでは表示されない)。

Column

Begin Subrow / End Subrow:列の中で横に並べるサブ行の開始 / 終了位置を指定・解除する。列のある通常行で、現在の構造に応じて表示。

Alignment

Left / Center / Right:この位置を基準に左・中央・右の配置を作る。列分割のない行で表示。Clear:行の位置揃えを解除する(設定済みの場合)。

行の操作(PDR)¶

通常行の操作メニュー。Size、Spacer、Fixed Buttons、行とパネルの追加、Join Row、コピー・移動・削除が並びます。

通常行の操作メニュー。¶

項目

操作・表示条件

Size

行の高さと適用範囲を選ぶ。下のサイズ設定を参照。

Spacer

行の上側の余白と適用範囲を選ぶ。先頭行には表示されない。

Fixed Buttons

ボタンの幅を揃える。列なしの行、または列内のサブ行に作用する。

Fixed Columns

列幅を揃える。列分割がある行で表示。ピクセル数を入力して固定する設定ではない。

Add Row Above / Below

現在の行の上 / 下に通常行を追加する。

Add Panel Above / Below

現在の行の上 / 下に Panel Row を追加する。Blender のパネルレイアウト機能が使える環境で表示。

Join Row

次の通常行を現在の行へ結合する。次の行がない場合や Panel Row の場合は表示されない。結合する行の列・位置揃えの区切りも取り除かれる。

Copy Row / Paste Row

行をコピー / コピーした行を現在の行の手前に挿入する。Paste Row は行をコピー済みの場合に表示。

Move Row

行全体の移動先を選ぶ。

Remove Row

行全体を削除する。他の行がある場合に表示。

Size — 高さと適用範囲¶

Size サブメニュー。Row、Aligned Rows、All Rows のそれぞれに Normal、Large、Larger が並びます。

Normal / Large / Larger は、それぞれ標準の 1 / 1.25 / 1.5 倍の高さです。Row は現在の行、Aligned Rows は余白なしで連続する行のまとまり、All Rows は全行に適用します。

Spacer — 行間の余白¶

Spacer サブメニュー。Row と All Rows に None、Normal、Large、Larger が並びます。

None / Normal / Large / Larger で、余白なしから段階的に広い余白を選びます。Row は現在の行の上側、All Rows は全行の行間に適用します。列を持つ隣接行では、Row の None が選べない場合があります。

パネル本体の操作(PDI)¶

パネル本体の操作メニュー。Edit Panel Target、Go to Panel Content、Default Closed、Header Layout、パネル行のコピー・移動・削除が並びます。

項目

操作・表示条件

Edit Panel Target

パネルの中身として使う参照先ダイアログを指定・変更する。

Go to Panel Content

参照先ダイアログを編集対象として開く。参照先が有効な場合に利用できる。

Default Closed

パネルを初期状態で閉じて表示する。

Header Layout

パネルのヘッダーにスロットを配置する。有効にすると、必要に応じて最初のヘッダースロットが追加される。

Copy Panel Row / Paste Row

パネル行全体をコピー / コピー済みの行を手前へ挿入する。Paste Row は行をコピー済みの場合に表示。

Move Panel Row

パネル行全体の移動先を選ぶ。

Remove Panel Row

パネル行全体を削除する。他の行がある場合に表示。

Header Layout を OFF にしても、既存のヘッダースロットは削除されず、使われない状態で保持されます。そのスロットのメニューでは Enable Header Layout で再び使用し、Delete Inactive Header で不要なヘッダースロットを削除できます。

パネル行の操作(PDR)¶

Panel Row の行メニュー。Header Layout、Spacer、通常行とパネル行の追加、コピー・移動・削除が並びます。

Panel Row は行の種類を示す見出しです。このメニューは、パネル全体の配置を扱います。

項目

操作・表示条件

Header Layout

ヘッダー用スロットを使用するか切り替える。

Spacer

このパネル行の上側の余白を設定する。先頭行以外で表示。

Add Row Above / Below

上 / 下に通常行を追加する。

Add Panel Above / Below

上 / 下に別のパネル行を追加する。

Copy Panel Row / Paste Row

パネル行をコピー / コピー済みの行を手前に挿入する。Paste Row は行をコピー済みの場合に表示。

Move Panel Row / Remove Panel Row

パネル行全体を移動 / 削除する。削除は他の行がある場合に表示。

通常行の Size / Fixed Buttons / Fixed Columns / Join Row は、パネル行には表示されません。

スクリプトから編集メニューを開く場合

スロットの操作は bpy.ops.pme.pdi_menu('INVOKE_DEFAULT', idx=...)、行の操作は bpy.ops.pme.pdr_menu('INVOKE_DEFAULT', row_idx=...) です。どちらも PME で現在選択しているメニューを対象にします。

idx はスロットを保持するコレクションの位置、row_idx は同じコレクション内の行開始位置です。見た目の「何行目」という番号とは異なります。編集用のコンテキストで呼び出し、別のメニューに切り替えた後の古い位置を使わないでください。


インライン編集ホットキー¶

プレビュー画面や、エディタ起動中に開かれた Pop-up Dialog 上で直接ボタンや行を編集するためのホットキーです。

ボタン操作¶

ボタン操作のホットキー¶

機能

LMB

Ctrl

Shift

Alt

OS

メニューを開く

LMB

ボタンを編集

LMB

Shift

右にボタンを追加

LMB

Ctrl

左にボタンを追加

LMB

Ctrl

Shift

ボタンを削除

LMB

Ctrl

Alt

アイコンを変更

LMB

Alt

アイコンをクリア

LMB

Alt

OS

テキストを非表示

LMB

Shift

Alt

スペーサーを切り替え

LMB

OS

ボタンをコピー

LMB

Ctrl

OS

ボタンを貼り付け

LMB

Ctrl

Shift

OS

行の管理¶

行の管理操作¶

機能

LMB

Ctrl

Shift

OS

メニューを開く

LMB

下に行を追加

LMB

Ctrl

上に行を追加

LMB

Ctrl

Shift

行サイズを切り替え

LMB

Shift

行スペーサーを切り替え

LMB

OS


応用的な使い方¶

N パネル代替としての一時パネル¶

普段は閉じておきたい設定群を Pop-up Dialog にまとめ、hotkey で呼び出すと、N パネルに常駐させずに同等の操作面を確保できます。Property スロットや Custom スロットに Blender 標準のウィジェットをそのまま並べられます。

Pie Menu の 1 スロットから詳細パネルを開く¶

Pie Menu の Menu スロットからこの Pop-up Dialog を指定すると、Pie に収まらない詳細設定をその場で開けます。Expand Popup Dialog を有効にしておくと、独立ポップアップではなく Pie のスロット領域内にレイアウトを展開します。

draw_menu() で別レイアウトに描き込む¶

open_menu() が Pop-up Dialog を独立ポップアップとして開くのに対し、draw_menu() は 現在の layout にその中身を描画するヘルパーです。Panel Group や別の Pop-up Dialog から、既存の Pop-up Dialog レイアウトを再利用できます。

draw_menu("Popup Dialog Name")
draw_menu("Popup Dialog Name", frame=True, dx=10, dy=10)

Blender の既存パネルを Custom スロットで描く¶

Custom スロットの Python レイアウトから panel() ヘルパーで Blender ネイティブのパネルを直接埋め込めます。template_* 系のウィジェットも同様に使えます。

panel("VIEW3D_PT_view3d_properties", frame=True, header=True)

template_list() を使う場合は、一覧のコレクションに加え、選択中の項目番号を保持する Int プロパティが必要です。対象に存在する RNA プロパティか、自分で定義したプロパティを指定します。

Extend Panel / Extend Header による差し込み¶

Extend Target を設定すると、Blender の既存パネルやヘッダーにこの Pop-up Dialog の中身がそのまま差し込まれます。詳細は Interactive Panels と Extend Panel を参照してください。

popup_area で Blender エディタ領域を開く¶

popup_area は Pop-up Dialog Editor とは別機能で、Blender のエディタ領域そのもの(Properties、Outliner、Asset Browser など)を一時的なポップアップウィンドウとして開きます。レイアウトを自分で組まずに、既存のエディタ画面をそのまま使いたい場合の経路です。

bpy.ops.pme.popup_area(area='PROPERTIES', width=600, height=800)
bpy.ops.pme.popup_area(area='ASSETS', width=1000, center=False, height=800)

関連ページ

  • エディターの共通要素

  • Interactive Panels と Extend Panel

  • Custom Icons

  • Poll Method の基礎

  • キーマップの選び方

参考動画(原作者のチャンネル)¶

roaoao の動画一覧より。旧版の UI・手順を扱う参考動画です。

Popup Dialog Editor

Popup Dialog Editor — YouTube で開く

Popup Dialog with Panels

Popup Dialog with Panels — YouTube で開く

Popup Dialog with Custom Layout

Popup Dialog with Custom Layout — YouTube で開く

Next
Floating Panel Editor
Previous
Regular Menu Editor
Copyright © 2025, Pluglug and contributors
Made with Sphinx and @pradyunsg's Furo
On this page
  • Pop-up Dialog Editor
    • 画面と編集の流れ
    • 名前と基本操作
    • Keymap / Hotkey
    • Extend Target
    • Advanced settings
      • 表示モード
    • レイアウト
      • レイアウトを親ポップアップに展開する
      • 固定列
      • 配置
      • パネルの組み込みとリンク操作
    • スロットと行の編集
      • スロットの内容
        • スロットを追加する(プリセット)
      • スロットの操作(PDI)
      • 行の操作(PDR)
        • Size — 高さと適用範囲
        • Spacer — 行間の余白
      • パネル本体の操作(PDI)
      • パネル行の操作(PDR)
      • インライン編集ホットキー
        • ボタン操作
        • 行の管理
    • 応用的な使い方
      • N パネル代替としての一時パネル
      • Pie Menu の 1 スロットから詳細パネルを開く
      • draw_menu() で別レイアウトに描き込む
      • Blender の既存パネルを Custom スロットで描く
      • Extend Panel / Extend Header による差し込み
      • popup_area で Blender エディタ領域を開く
    • 参考動画(原作者のチャンネル)