スクリプトの管理¶
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は上書きされません。