PiXYZ Studio での Python スクリプトの作成方法

本チュートリアルは、Unity 2019 LTS と PiXYZ 2020.1.1.8 を使って検証しています。

Python は PiXYZ Studio の中核であり、スクリプトはその能力を活用して時間のかかる作業や繰り返しの作業を行うための効果的な方法です。PiXYZ Studio では、通常のメニューを使って機能を実行すると、Output ペインに Python コマンドへの参照が表示されます (画像 01) 。

PiXYZ Studio の Python バインディングの詳細については、API ドキュメントをご覧ください。また、PiXYZ Studio には、多数の Python スクリプトが同梱されています。それらにアクセスするには、Help ドロップダウンから Open Sample Scripts Directory を選択します (画像 02) 。

Python スクリプトは、エクスプローラーから直接スクリプトペインにドラッグアンドドロップすることで読み込むことができます。Script パネルの表示を切り替えるには、Windows ドロップダウンから Script を選択します (画像 03) 。

Script パネルには、スクリプト用の領域の上にボタンが並んでいます (画像 04) 。

ボタンは左から順に：

1. New File - 別のタブで新しいファイルを作成します。
2. Open A Script - 保存した Python スクリプトを読み込むためのウィンドウを開きます。
3. Save Script - 現在のスクリプトを保存します。
4. Save Script to a File - 現在のスクリプトを新しいファイルに保存します。
5. Execute the Script - スクリプト全体を実行します。
6. Execute Selection -選択された行のみを実行します。
7. Interrupt Pixyz Process - 現在のスクリプトに、スクリプトの実行を停止するための core.interruptionRequested() コマンドが含まれている場合、ボタンがアクティブになります。
8. Show Non-Printable Characters - 印刷不可能な文字の表示/非表示を切り替えます。
9. Open Sample Scripts Directory - Sample Script Directory のインストール先へのウィンドウを開きます。

Windows エクスプローラーから Script パネルにスクリプトをドラッグアンドドロップするか、Load Script ボタンをクリックします (画像 05) 。

New Script ボタン「＋」をクリックすると、スクリプトを作成することができます (画像 06) 。

PiXYZ Studio の Python は、お持ちの機能に加えるべき強力なツールです。サンプルスクリプトや API ドキュメントをぜひご覧ください。