プラグイン モジュールを作成すれば、ネットワーク上の任意の場所またはローカルに保存できるプラグインの配布可能インストールを作成できるようになります。これにより、場所を管理するために Maya インストールやその他のハードにファイルを書き込む必要がなくなります。モジュール ファイルを使用することで、インストールされている数多くのプラグインの場所を別のスクリプト フォルダに変えるなど、モジュールの配布を簡単に変更できるようになります。
Maya では、複数のバージョンのプラグインをインストールしたり、OS、Maya のバージョン、および言語設定に基づいて異なるバージョンをロードしたりすることができます。
注: 拡張子に関係なく、すべてのモジュール ファイルが Maya によって読み取られます。
モジュール ファイルでは、モジュールの場所を指定します。場所は、読み取られる .mod ファイルの場所を基準としたパス、または絶対パスで指定できます。
モジュール フォルダの構造を上書きするには、次の構文を使用します: <folder to override>: <new location for this folder>。
たとえば、モジュールのスクリプト フォルダの新しい場所を指定するには、次の行を追加します。
scripts: ../commonModuleFiles/scripts
この方法は、モジュール間でスクリプト/アイコン/プリセット ファイルを共有する場合に役に立ちます。
重要: スクリプト フォルダのパスを指定する場合は、scripts: の後にスペースを追加する必要があります(例: scripts: c:\myScripts)。
モジュールおよびスクリプト ファイルの場所
.mod ファイルの場所
.mod ファイルには次の行が含まれています。
+ PLATFORM:win64 CustomModule 3.10.5 ..\CustomModule\Modules\win64
scripts: ..\..\CommonFiles\scripts
最初の行では、.mod ファイルの場所(C:\ModulesMOD\CustomModule.mod)を基準にしてモジュールの場所を指定する相対パスが使用されています。次の行では、モジュールの場所(..\CustomModule\Modules\win64)を基準にしてスクリプト フォルダの場所を指定する相対パスが使用されています。
既定では、Maya はモジュール内に含まれるすべてのサブフォルダを無視します。Maya がモジュールのサブフォルダを無視しないようにするには、[r] キーワードを使用してそのフォルダの再帰的動作を要求する必要があります。次のように指定します。
[r] scripts: ..\..\CommonFiles\scripts
.フォルダ(すなわちドットで始まるフォルダ、別名隠しフォルダ)は、\[r\] キーワードが設定されていても無視されます。このフォルダは再帰的にパースされることはなく、検索パスとして Maya に追加されることもありません。
モジュールをロードする条件を指定できます。次の条件の中から選択します。
サポートされている OS 条件は次のとおりです。
システム ロケールについては、次の条件がサポートされています。
Maya のバージョンを指定するには、MAYAVERSION: を使用します。
重要: 条件は、+ とモジュール名の間に指定する必要があります。
+ MAYAVERSION:2016 PLATFORM:win64 LOCALE:ja_JP CustomModule 3.10.5 ..\CustomModule\Modules\win64
この例では、Maya のバージョンが 2016、OS が 64 ビット Windows、システム ロケール設定が日本語の場合にのみ、CustomModule プラグインがロードされます。
カスタム環境変数を設定するには、次の構文を使用します。
MYVAR=MYVALUE
モジュールの場所を基準とした値を使用して環境変数を指定することもできます。その場合は「:=」構文を使用します。
前述の例で、PYTHONPATH を C:\CustomModule\Modules\win64\python に設定する必要がある場合は、次のように設定するだけです。
PYTHONPATH:=python
変数の現在値にアペンドするには、+ または : 演算子を使用します。次に例を示します。
PATH += c:/myModule/bin と設定すると、環境変数 PATH の現在値に ;c:/myModule/bin が追加されます。
PATH +:= bin と設定すると、環境変数 PATH の現在値に ;’module location’/bin が追加されます。
モジュール パスを照会するには、次のように MEL コマンド getModulePath を使用します。
getModulePath –moduleName “MyModule”
この照会によって次の値が返されます。c:\MyModule
次のフォルダ タイプは、リーガル モジュール リソース パスとしてサポートされていません。モジュール システムでは、名前に次の拡張子が付いたフォルダは無視されます。