スクリプトの管理

PMEの Scripts 一覧では、execute_script() で呼び出すPythonファイルを管理できます。 ファイルを探して編集したり、メニューに貼り付ける呼び出しコードをコピーしたり、 そのファイルを使っているメニューへ戻ったりできます。

たとえば、スロットのCommand欄に次のように書くと、保存したファイルを実行できます。

execute_script("scripts/my_tool.py")

このページでは、その呼び出し先のファイルを作成・編集・保存する手順を説明します。 execute_script() の引数や戻り値は スクリプティング を参照してください。

一覧は次の2か所から開けます。

  • 設定を整理する場合: PMEの Preferences > Settings > Resources > Scripts。

  • コードを編集する場合: BlenderのText Editorでサイドバー(Nキー)を開き、PME タブ > Scripts。

最初に保存先を設定する場合は、保存先とフォルダ構成 のScript Directoriesを参照してください。

ファイルを探す

フォルダーの左の三角を押すと、中のファイルが表示されます。 数が多い場合は検索欄に文字を入れて絞り込めます。ファイルの場所も確認できます。 Blenderの外で追加したファイルが見つからない場合は Refresh を押してください。

Text Editor側では、ファイル名をクリックするとその場で開きます。 Preferences側では、ファイルの行メニューから Edit を選びます。 外部エディターを設定している場合はそちらで、未設定ならBlenderのText Editorで開きます。

Tip

外部エディターは、Blenderの Preferences > File Paths > Text Editor で設定できます。 設定後も Edit in Blender でBlender内の編集を選べます。 Text Editor側から外部エディターへ移る場合は Edit Externally を使います。

新しく作る・メニューで使う

メニューに追加しながら作る場合**は、スロットのCommand欄の補助メニューで **New Script を選びます。 ファイルが作成され、execute_script() の呼び出しコードもスロットに入ります。

先にファイルだけ作る場合**は、Scripts一覧の **New (+)を押します。 作成したファイルがエディターで開くので、ひな型の処理部分を書き換えて保存してください。 保存先は、先頭のScript Directoryの scripts/ フォルダーです。 そのフォルダーがない場合は、登録したディレクトリーの直下に作成されます。既存ファイルは上書きしません。

既存ファイルをメニューで使う場合**は、その行の **Copy Reference で execute_script() の呼び出しコードをコピーし、 スロットのCommand欄へ貼り付けます。Slot Editorの Call External Script から選ぶこともできます。

編集して保存する

Text Editorで変更すると、一覧のファイル名の右側に保存アイコンが出ます。 これを押すか、Text Editorの Save で保存してください。 保存後、次に execute_script() で呼び出すと、新しい内容で動きます。

まだファイルとして保存していないテキストや、登録先の外にあるテキストには、一覧の下に Save into Script Directory が表示されます。押すと保存先を選べます。 保存後はScripts一覧から探せるようになり、Copy Reference も使えます。

注釈

Blenderの外でも同じファイルが変更されている場合は、上書き前に Resolve Conflict が開きます。 外部の内容を読み直す Reload、Blender側の内容を保存する Save、 Blender内のテキストとして保持する Make Internal から選んでください。

保存したのに変更が反映されない場合
  • Blenderの外で追加したファイルを一覧に出すには Refresh を押します。

  • スクリプトがimportする別のPythonモジュールは、ファイルを保存しただけでは読み直されません。 Blenderを再起動するか、コード側で importlib.reload を使って再読み込みします。

  • scripts/autorun/ 内のスクリプトは起動時に実行されます。変更後はPMEを再有効化してください。

使っているメニューへ戻る

ファイルの横にある Used by (リンクのアイコン)を押すと、execute_script() でそのファイルを呼び出しているメニューに移動します。 複数のスロットで使っている場合は、移動先を一覧から選べます。

Used byに表示される範囲

保存済みのCommand・Customスロットに、execute_script("scripts/tool.py") のように ファイル名を直接書いた呼び出しを探します。 コード内でファイル名を組み立てている場合や、autorunで登録した関数を名前で呼ぶ場合は一覧に含まれません。 構文エラーのあるコード、Poll、Context Routerのコードも対象外です。 ここに表示されないことだけでは「使われていない」とは判断できません。

移動先はPMEのEditorタブです。Slot Editorは自動では開きません。 Text Editor側から操作した場合、Preferencesが閉じていれば開きます。

警告が出たら

ファイル名の左にある警告の印を押すと、理由や候補の場所を確認できます。 Slot Editorにも、呼び出し先の問題を知らせる印が表示されます。

状態

確認すること

ファイルが見つからない(Missing)

ファイルの移動・改名や、呼び出しコードのパスを確認してください。 実行時のメッセージにある Show in Scripts から、該当する項目へ移動できます。

同じパスが複数ある

複数のScript Directoryに同じ相対パスのファイルがあります。 どちらを使うか決められないため実行されません。警告に出る場所を確認してください。

ファイルを読めない

表示された理由を確認し、ファイルの場所やアクセス権を見直してください。

一覧の分類と、その他の表示

Preferences側の Outside Script Directories は、登録先の外の絶対パスや同梱のサンプルを 呼び出している項目です。Missing は呼び出し先が見つからない項目です。 この2分類はText Editor側の一覧には表示されません。

Text Editorの一覧の下には、現在開いているテキストの保存状態も表示されます。

  • Not listed yet: 一覧の更新後に保存されたファイルです。Refreshで更新してください。

  • Not in a Script Directory: 登録先の外に保存されています。

  • Internal text, not saved as a file: Blender内にだけ存在し、外部ファイルには保存されていません。

ファイルの場所を開くには Open Folder を使います。 Text EditorのOpen・Save Asでは、ファイルブラウザー左側の Pie Menu Editor から 登録先へすばやく移動できます。

ひな型とフォルダー内の案内

新しいスクリプトには、PMEのスロットとText Editorの両方から実行できるひな型が入っています。 ただし、Text Editorから実行する場合のコンテキストはText Editor自身です。 3D Viewなどを必要とする処理は、実際に使うメニューからも確認してください。

scripts/README_PME.md には、メニューからの呼び出し方や使える変数、サンプルの場所が書かれています。 スクリプトを書き始めるときや、AIに編集を依頼するときの案内として使えます。 PMEが scripts/ のある保存先を設定したり、そこに新しいファイルを作ったりするときに用意され、 既存のREADMEは上書きされません。

参考

保存先とフォルダ構成 — 保存先を追加する・整理する

スクリプティング — 関数・引数・戻り値を調べる

同梱ユーティリティー — 同梱の補助関数を使う