Stack Key Editor¶

Stack Key は、一つのホットキーで複数の処理を使い分けるエディターです。押すたびに次へ進む使い方と、前回の処理を再使用しながら連打で候補を変える使い方を選べます。1スロットだけにして、短いコードにホットキーを割り当てることもできます。

このページは PME 2.1 の設定を対象にしています。

画面と編集の流れ¶

Tool Stack の編集画面。 — Blender 5.2 / PME 2.1 の開発環境。「Tool Stack」の設定例。

名前と基本操作
Advanced settings
Keymap / Hotkey
巡回するスロット

一覧で編集対象を選び、名前と有効状態を確認して、呼び出し方とスロットを設定します。共通の一覧・検索・タグはエディターの共通要素、各部は名前、キー設定、スロット、詳細設定を参照してください。

名前と基本操作¶

名前と有効状態で編集対象を確認します。タグ・名前変更・参照元などの操作は選択メニューの設定を参照してください。この種別にはメニューのプレビューボタンはありません。

Keymap / Hotkey¶

呼び出す場所とキーを設定します。入力欄の操作は共通の Hotkey 設定を参照してください。

スロット¶

通常の巡回では、有効なスロットを上から順に使います。Every Press では押下ごとに進み、Quick Repeat では短時間の続け押しで進みます。最後まで進むと先頭に戻ります。

スロットの追加・削除・並び替えが可能です。
個別スロットの有効化/無効化ができます。
各スロットには表示名が付き、ビューポート上部のヒントテキストにこの名前が表示されます。

Added in version 2.0.5: スロットごとにアイコンを設定できるようになりました。スロットを呼び出したときの通知にも、スロット名とアイコンが表示されます。

一回目で覚え、次の押下で戻す¶

一回押すと床グリッドを隠し、もう一回押すと元へ戻す。 同じ Stack Key を続けて使う間は、前のスロットで覚えた値を次のスロットから読めます。キーを離すだけでは、次のスロットには進みません。

        flowchart LR
    A["一回目<br/>覚えて隠す"] --> B["次の押下を待つ"]
    B --> C["二回目<br/>元の状態へ戻す"]
    classDef remember fill:#e8f1fb,stroke:#4878aa,color:#172b43;
    classDef restore fill:#e8f5ed,stroke:#45805d,color:#183f28;
    class A,B remember;
    class C restore;

① 最初の Command — 元の状態を覚えてから隠す

view = C.space_data; start_floor = view.overlay.show_floor; view.overlay.show_floor = False

② 次の Command — 覚えていれば、その状態へ戻す

if "start_floor" in globals(): view.overlay.show_floor = start_floor

Keymap は 3D View、Remember Slot / Undo Previous Command は OFF にします。二つのスロットを有効にし、透視投影の 3D ビューで、別の操作を挟まず同じ Stack Key を二回呼び出します。

view と start_floor は自分で付けた名前です。start_floor は banana でも構いませんが、覚える側と戻す側で同じ名前を使います。二番目の if は「開始値を覚えている場合だけ戻す」という確認です。途中から二番目だけを実行しても、元の値を知らなければ復元できません。

次の独立した呼び出しや別のメニューへ値を渡す場合は、一時的な共有メモ U（User Data）を使えます。

共有範囲と復元の条件

共有期間：同じ巡回を続ける Command は同じ Python 名前空間を使います。新しい巡回では初期化されます。Remember Slot が OFF の場合、別の Stack Key や Blender オペレーターの実行などが巡回のリセット判定に影響します。
個別の呼び出し：スロット番号を明示した呼び出しと、一スロットだけの Stack Key は、毎回新しい名前空間を使います。
Quick Repeat：時間内に次へ進む場合は共有が続きます。時間外に現在のスロットを再実行する場合は、新しい名前空間になります。
Remember Slot：記憶するのはスロット位置です。変数をメニューごとに分離して保持する設定ではありません。別の Stack Key を挟んだ後も保存値が残ることを前提にしません。
復元先と名前：この例で覚えた 3D ビューが残っていることが前提です。PME が提供する C、E、menu、slot などを保存先として上書きしません。
復元：二番目を実行しないまま別の操作へ移ると、元へ戻りません。エラーや巡回のリセットを補う自動復元もありません。押下・解放で戻すなら Sticky Key、確定・取消で分けるなら Modal Operator の終了スロットを使います。

Advanced settings（詳細設定）¶

Tool Stack の Advanced settings。前回の候補を記憶するか、どのタイミングで次へ進むかを設定します。 — Advanced settings。値はこの例の設定です。

歯車から開きます。Description と Poll は共通の詳細設定を参照してください。

Remember Slot:

直前に実行したスロット位置を記憶します。無効の場合は、別の Stack Key や Blender オペレーターの実行などで連続操作が途切れると先頭から再開します。クリックなどの入力すべてを「別の操作」として判定するわけではありません。

バージョン 2.0.5 で変更: 従来の Remember State を Remember Slot に整理しました。

Advance On:

Remember Slot 有効時に、次のスロットへ進むタイミングを選びます。

Every Press — 押すたびに次のスロットへ進みます。
Quick Repeat — 短時間に続けて押したときだけ次へ進み、間隔が空いた押下では現在のスロットを再実行します。

Added in version 2.0.5: Advance On を追加しました。既存の Stack Key 設定は Every Press 相当の動作を保ちます。

Repeat Timeout:

Advance On が Quick Repeat のときに使う、「連続押し」と認める時間のしきい値（ミリ秒）。最小値は 1 ms、既定値は 600 ms。

Undo Previous Command:

連続して候補を切り替える際、前の結果を取り消して次のスロットを実行するための設定です。最初の呼び出しやスロットを明示した呼び出しなどでは同じように Undo しません。複数の変更を一つにまとめる機能ではないため、実際の操作と Undo 履歴で結果を確認してください。

ビューポート上部のヒントテキスト¶

通常の巡回では、現在のスロット名とアイコンを通知で確認できます。有効なスロットが一つだけの構成や、スロットを明示して呼ぶ経路では、巡回用の通知は表示されません。

コードと入力欄¶

この種別で使える入力は冒頭の構成ガイドを参照してください。入力欄の操作は共通のスロットエディタ、コードは書き方と入力制限、コード例にまとめています。

活用例と確認する条件¶

2 つのワークスペースを巡回する¶

Layout と Scripting というワークスペースが存在する環境の例です。名前を変更している場合は実際の名前に合わせます。

スロット 1:

C.window.workspace = D.workspaces['Layout']

スロット 2:

C.window.workspace = D.workspaces['Scripting']

1 スロットだけの「hotkey 付き Python コード」¶

任意の Python コードや open_menu() 呼び出しを 1 つのスロットに書き、Stack Key の hotkey に割り当てます。

open_menu("My Pie Menu")

ブラシ切り替えにも応用できますが、ブラシアセットの扱いは Blender の版とペイントモードで異なります。旧版の D.brushes 代入例を使う前に、現在のブラシ切り替え API と対象を確認してください。

修飾キーに応じてスロットを呼び分ける¶

スロットに名前を付けると、外部からスロット名を指定して呼び出せます。event_mods(E) は現在のイベントから "" / "Ctrl" / "Shift" / "Ctrl Shift" のような文字列を返すヘルパーで、スロット名と一致させることで修飾キー別に処理を切り替えられます。

open_menu("My Stack Key", event_mods(E))

この例は入力イベント E が渡される呼び出しで使います。イベントがない評価にそのまま移さず、対応するスロット名が実在することも確認してください。

コンテキストに応じてスロットを切り替える¶

open_menu("My Stack Key", "Command 1") if C.mode == 'OBJECT' else open_menu("My Stack Key", "Command 2")

直前の操作を Undo してから別パラメータで再実行¶

次は Mesh の Edit Mode で、領域選択に使うループを選択済みの場合の例です。選択状態と Undo を含めて確認してください。

Undo Previous Command を有効にすると、直前の結果を巻き戻してから次のスロットを試せます。

スロット 1:

bpy.ops.mesh.loop_to_region(select_bigger=False)

スロット 2:

bpy.ops.mesh.loop_to_region(select_bigger=True)

参考動画（原作者のチャンネル）¶

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