Macro Operator Editor¶

Macro Operator は、複数の操作を 1 回の実行でまとめて順次実行するエディターです。登録した Macro は名前付きのオペレーターとして Blender に組み込まれ、hotkey や他の PME メニュー、Python から呼び出されます。

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

画面と編集の流れ¶

Box Sel with X-Ray の編集画面。 — Blender 5.2 / PME 2.1 の開発環境。「Box Sel with X-Ray」の設定例。

名前と基本操作
Advanced settings
Keymap / Hotkey
順番に実行するスロット

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

名前と基本操作¶

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

Keymap / Hotkey¶

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

Macro は Blender にオペレーターとして登録されるため、hotkey が未設定でも、メニュー経由 / open_menu() / bpy.ops.pme.invoke_macro(...) などから呼び出せます。

Added in version 2.0.5: スクリプトやカスタム UI から PME Macro を呼び出すための bpy.ops.pme.invoke_macro(...) を追加しました。呼び出し側で Macro 内の全スロット引数を渡さなくても、PME 側の Macro 定義をそのまま使えます。

スロット¶

スロットは上から順に実行されます。Stack Key のように「次の押下まで待つ」挙動はありません。

スロットの追加・削除・並び替えが可能です。
個別スロットの有効化/無効化ができます。
スロットタイプは Command / Menu の 2 種です。
Menu スロットでは PME の Sticky Key / Macro Operator / Modal Operator を呼び出せます。Pop-up Dialog / Pie Menu のような対話 UI は Macro の途中から呼び出す対象には適しません。

保存 → 処理 → 復元を、別のスロットに分ける¶

前の Command で覚えた値を、後の Command で使う。 一回の Macro の中では変数を共有できるので、一時的な設定変更と後片付けを分けて書けます。

        flowchart LR
    A["① 保存して変更"] --> B["② 処理"]
    B --> C["③ 元へ戻す"]
    classDef remember fill:#e8f1fb,stroke:#4878aa,color:#172b43;
    classDef restore fill:#e8f5ed,stroke:#45805d,color:#183f28;
    class A,B remember;
    class C restore;

例えば、3D ビューの床グリッドを一時的に隠すなら、次の三つの Command を上から並べます。一回の呼び出しで順に実行され、次の押下は待ちません。

① 復元先と現在値を覚えてから、グリッドを隠す

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

② 一時設定の間に行う処理（ここでは確認用の出力）

print("一時設定の間に行う処理")

③ 覚えておいた状態へ戻す

view.overlay.show_floor = start_floor

Keymap を 3D View にして、3D ビューから起動します。この最小例は途中で入力を待たないため、グリッドが隠れている時間は目では追えない場合があります。print() は Blender の標準出力へ出ます。

view と start_floor は自分で付けた名前です。start_floor は banana でも構いませんが、覚える側と戻す側で同じ名前を使います。

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

共有範囲と復元の条件

共有期間：一回の Macro 内の Python コードは同じ名前空間を使います。新しく Macro を呼び出すと別の名前空間になり、前回の保存値は引き継ぎません。
子 Macro：Menu スロットで組み込んだ子 Macro も共有します。親子で同じ変数名を使うと上書きされるため、組み合わせるコードの名前も確認します。コードから別途 Macro を起動する場合は新しい実行です。
他の種別：組み込んだ Sticky Key / Modal Operator の内部変数は、それぞれの名前空間に属します。Macro の変数が自動で渡るわけではありません。
復元先と名前：この例は、覚えた 3D ビューが最後まで残ることが前提です。PME が提供する C、E、menu、slot などを保存先として上書きしません。
途中停止：後処理スロットは finally ではありません。途中のオペレーターの取消、Command の失敗、stop = True による停止では復元まで進むとは限らず、変更済みの値も自動では戻りません。
必ず対にする同期処理：一つのスクリプト内で try / finally にまとめる方法があります。ただし、そのスクリプトから起動した対話オペレーターの完了を finally が待つわけではありません。

診断メッセージ¶

オペレーターや参照先が見つからないなど、PME が検出した構成上の問題はスロット行の警告アイコンから確認できます。警告がないことは、実行時のモード・選択状態で全オペレーターの条件が成立する保証ではありません。実行時のエラーは、その場のコンテキストも確認してください。

Added in version 2.0.5: 現在の Blender 環境で見つからない operator が Macro に含まれている場合、Blender の native Macro 実行に入る前に PME 側で検出し、Macro 全体を安全に停止するようになりました。古い設定、無効化されたアドオン、名前が変わった operator が原因で Blender ごと落ちることがあった既知の問題への対策です。

Advanced settings（詳細設定）¶

Box Sel with X-Ray の Advanced settings。説明文と利用できる条件を設定します。 — Advanced settings。値はこの例の設定です。

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

Macro の Poll は「この Macro 全体を実行してよいか」の判定として評価されます。

コードと入力欄¶

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

活用例と確認する条件¶

連続操作をまとめる¶

アクティブなメッシュがあり、Object Mode から始める例です。最初のステップで Mesh Edit Mode へ移り、次で全要素を選択します。

スロット 1（Command）:

bpy.ops.object.mode_set(mode='EDIT')

スロット 2（Command）:

bpy.ops.mesh.select_all(action='SELECT')

同じオペレーターを違うパラメータで実行する¶

同じオペレーターでも、それぞれのスロットに異なる引数を設定できます。次は Mesh Edit Mode で面を選択した状態から使う例です。二回目は一回目の結果に対して実行されます。

bpy.ops.mesh.inset(thickness=0.02)

bpy.ops.mesh.inset(thickness=0.05)

Stack Key の各スロットを複数ステップにする¶

Stack Key の Command スロットから Macro を呼び出すと、巡回する各ステップが複数操作を持てる構成になります。

open_menu("My Macro Operator")

または bpy.ops.pme.invoke_macro を使う形：

bpy.ops.pme.invoke_macro(pm_name="My Macro Operator")

対話的な操作を含める¶

Transform のようにユーザーが調整するオペレーターは、開始処理を呼ぶ指定を使います。PME が Blender の Macro ステップとして扱うオペレーターでは、操作の確定後に次へ進む構成にできます。任意の Python コードの途中で非同期処理を始めても、すべての処理を自動で待てるわけではありません。単独のオペレーター呼び出しとしてスロットを分け、確定と取消をそれぞれ試します。

bpy.ops.transform.resize('INVOKE_DEFAULT')

実行する場所と対象を整える¶

最初に必要なエディター、モード、アクティブ・選択対象を決めます。途中でモードを変更するなら、次の操作がそのモードで使える順序にします。エリアを切り替える focus_area() などのヘルパーもありますが、単に別エリアを選べばすべてのオペレーターが実行できるわけではありません。必要な対象が見つからない場合の動作を決め、コンテキストの確認を行います。

Added in version 2.1: Re-Capture で最近の操作を複数選び、実行した順番で Macro として追加できます。取り込んだ後は引数と実行条件を確認してください。

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

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

Macro Operator Editor¶

画面と編集の流れ¶

名前と基本操作¶

Keymap / Hotkey¶

スロット¶

保存 → 処理 → 復元を、別のスロットに分ける¶

診断メッセージ¶

Advanced settings（詳細設定）¶

コードと入力欄¶

活用例と確認する条件¶

連続操作をまとめる¶

同じオペレーターを違うパラメータで実行する¶

Stack Key の各スロットを複数ステップにする¶

別の Macro / Sticky Key / Modal を呼ぶ¶

対話的な操作を含める¶

実行する場所と対象を整える¶

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