MAXScript から Python を実行

MAXScript から Python を実行

MAXScript 内部から、Python のコマンドとステートメント(単一のコマンド/式または一連のステートメント)、または Python スクリプト(.py スクリプトなど)を実行できます。次のように python.Execute コマンドと python.ExecuteFile コマンドをそれぞれ使用します。

python.Execute "print 'hello'"

python.ExecuteFile "demoBentCylinder.py"

たとえば次のように ExecuteFile コマンドを使用して完全パスを指定すると、3ds Max は、指定パスから Python ファイルを探します。

python.ExecuteFile @"C:\Program Files\Autodesk\3ds Max 2015\scripts\Python\demoBentCylinder.py"

そうでない場合は、3ds Max は次のディレクトリ以下から Python スクリプトを探します。

• ユーザ スクリプト ディレクトリ
• ユーザ スタートアップ ディレクトリ
• スクリプト ディレクトリ
• スタートアップ スクリプト
• Path 環境変数によって指定される Windows パス。これらのディレクトリを一覧表示するには、コマンド プロンプトに echo %PATH% と入力します。

たとえば、3ds Max は、userscripts\python、userscripts\startup\python、scripts\python、scripts\startup\python のディレクトリ以下の Windows パスを検索します。

スクリプト結果は、[MAXScript リスナー](MAXScript Listener)ウィンドウに出力されます。

Python インタフェース メソッド

MAXScript で

showinterface python

を実行すると、MAXScript リスナーに、使用可能なメソッドのリストが表示されます。以下、これらのメソッドと引数について説明します。

• Init(): まだロードされていない場合に Python がロードされます。
• Execute() および ExecuteFile(): まだロードされていない場合に Python がロードされます。Python を使用することがわかっていて、最初に使用するときに発生するロード関連の遅延を回避したい場合に Init() を使用します。3ds Max を実際に使用しているときではなく、起動時にロードする場合に、スタートアップ スクリプトで python.Init() を呼び出します。
• throwOnError キーワード引数: メソッド実行中にエラーが発生した場合に、MAXScript がランタイム例外をスローするかどうかを制御します。trueに設定した場合は、#success の結果コードが必ず戻ります。それ以外の場合は、ラン タイム例外がスローされます。例外処理用に try/catch 内で呼び出しを行うかどうかは、スクリプトの開発者に委ねられます。

• GetLastError(): Init() メソッド、Execute() メソッド、または ExecuteFile() メソッドの実行中に発生した最後のエラーに関連するエラーメッセージを文字列として返します。

• 結果コード (enums): Python を MAXScript から実行すると、結果コードは次の定数になる可能性があります。
  • #success
  • #pathError
  • #initError
  • #scriptFileError
  • #executeError