これは、個人的な Maya アプリケーション ディレクトリを定義するための変数です。このディレクトリには、プロジェクトの他、次のような重要な項目が含まれます。
MAYA_APP_DIR はオペレーティング システムからのみ設定できます。Maya.env は使用できません。Mac OS X オペレーティング システムでこの変数を設定した場合、ターミナル(Terminal)ウィンドウから Maya を起動する必要があります。このようにしない場合、Maya は設定値を使用しません。
MAYA_APP_DIR 変数を設定しない場合、既定値は次のようになります。
¥Users¥<ユーザ名>¥Documents¥Maya
~<ユーザ名>/Library/Preferences/Autodesk/Maya
~<ユーザ名>/Maya
この変数はスタートアップ時に cmdFileOutput コマンドを有効にして、スクリプト エディタ(Script Editor)の内容を自動的に指定したファイルに出力します。ファイル名を指定しない場合は、エラーは標準エラー出力(たとえばターミナル ウィンドウ)に送られます。この機能は、Maya がスタートアップ時にクラッシュした際、エラー メッセージをトラッキングするのに便利です。
スクリプト エディタ(Script Editor)の内容は、スクリプト エディタ(Script Editor)と指定した出力位置の双方に表示されます。
この変数は、コンテンツ ブラウザのサンプル(Examples)タブに追加するために使用できるコンテンツ フォルダへのパスを取得します。モジュール テンプレート ファイルの環境変数に追加するか、assetBrowser -addContentPath フラグを使用することで、独自のコンテンツ フォルダを使用してこのパスにプラグインを追加することができます。
アトリビュート エディタを使用した場合: この変数は、カスタムのアトリビュート エディタのテンプレートがあるディレクトリをオーバーライドするために使用されます。既定は Maya のインストール フォルダの scripts¥AETemplates フォルダです。
ノード エディタを使用した場合: カスタム アトリビュートのリストのテンプレートを作成することによって、各ノードに表示されるアトリビュートのリストをカスタマイズすることができます。次に同じノードを作成するときに、Maya では既存のテンプレートを検索します。1 つが検出された場合、ノードは作成されたカスタム アトリビュートのリストで表示されます。カスタム テンプレートが見つかったネットワークの場所にこの環境変数を設定することで、ネットワーク上で他のユーザとこれらのテンプレートを共有することができます。詳細については、「ノード アトリビュートのリストをカスタマイズする」を参照してください。この環境変数は、Windows 上および Mac OS X/Linux 上で分けられる複数のパスをサポートしています。
ノード エディタで使用する場合。カスタム アトリビュートのリストのテンプレートを作成することによって、各ノードに表示されるアトリビュートのリストをカスタマイズすることができます。既定では、テンプレートが $MAYA_APP_DIR/<app_ver>/[localized]/prefs/viewTemplates/ に保存されますが、この環境変数を必要な場所に設定することで、既定の場所をオーバーライドすることができます。詳細については、「ノード アトリビュートのリストをカスタマイズする」を参照してください。
この変数は、Maya 3.0 以降は使用されていません。代わりに変数 XBMLANGPATH を使用してください。
Maya モジュール ファイルへの検索パスを定義します。モジュール ファイルには、モジュールとして配布されているプラグインのインストール場所が記述されています。Maya ではこのインストール場所のサブディレクトリを、パス変数である MAYA_PLUG_IN_PATH、MAYA_PRESET_PATH、MAYA_SCRIPT_PATH、PYTHONPATH、および XBMLANGPATH に付加します。詳細については、後述する変数の個別の説明と、「Maya プラグインの配布」(Maya 開発者ヘルプ)を参照してください。
次の表は、既定のパスをまとめたものです。これらのパスは、必ず、ユーザが指定したパスの後に来ます。
Windows の既定 |
---|
<ユーザ フォルダ>/My Documents/Maya/<バージョン>/modules <ユーザ フォルダ>/My Documents/Maya/modules C:/Program Files/Common Files/Autodesk Shared/Modules/Maya/<バージョン> C:/Program Files/Common Files/Autodesk Shared/Modules/Maya <Maya ディレクトリ>/modules/ |
Mac OS X と Linux の既定 |
---|
$MAYA_APP_DIR/Maya/<バージョン>/modules $MAYA_APP_DIR/Maya/modules /usr/autodesk/modules/Maya/<バージョン> /usr/autodesk/modules/Maya |
作成するファイル パスにスペースを使用すると、ファイル パスが Maya では表示されないため、フォルダ内に格納されているアイコン イメージ ファイルにアクセスできない場合があります。この問題は、ファイル パスにスペースを使用しないことで回避できます。
この変数は、ムービー ファイルが保管されているディレクトリの設定をオーバーライドするために使用されます。既定は $MAYA_LOCATION/movies です。
Maya のインストール フォルダへのパスです。この変数を設定しない場合、既定で /usr/autodesk/Maya<バージョン番号> (Linux)または C:¥Program Files¥Autodesk ¥Maya<バージョン番号> (Windows)が使用されます。
Mac OS X では、Maya は /Applications/Maya <バージョン>/Maya.app としてインストールされます。Mac OS X アーキテクチャでは Maya アプリケーション パッケージのコンテンツにアクセスすることが難しくなっているため、Mac OS X では MAYA_LOCATION を使用しないことを強く推奨します。代わりに、次の場所を使用してください。
プラグインの検索パス。プラグインが相対パス名で指定されている場合、このパス内のディレクトリから指定されたプラグイン名が検索されます。また、プラグイン マネージャ(Plug-in Manager)にリストされるディレクトリは、このパスにより定義されます。さらに、Maya の起動時に検出される各モジュール ファイルについては、モジュールのルート フォルダの plug-ins サブフォルダが、MAYA_PLUG_IN_PATH に付加されます。詳細については、前述の MAYA_MODULE_PATH 変数の説明と「複数ファイル モジュールの配布」(Maya 開発者ヘルプ)を参照してください。
Windows の既定 |
---|
<ユーザ フォルダ>/Documents/Maya/<バージョン>/plug-ins <ユーザ フォルダ>/Documents/Maya/plug-ins <Maya ディレクトリ>/bin/plug-ins |
Mac OS X の既定 |
---|
ホーム フォルダ下: Library/Preferences/Autodesk/Maya/<バージョン>/plug-ins ホーム フォルダ下: Library/Preferences/Autodesk/Maya/plug-ins /Users/Shared/Autodesk/Maya/<バージョン>/plug-ins /Users/Shared/Autodesk/Maya/plug-ins Maya パッケージ内: /Applications/Maya <バージョン>/Maya.app |
Linux の既定 |
---|
$MAYA_APP_DIR/Maya/<バージョン>/plug-ins $MAYA_APP_DIR/Maya/plug-ins /usr/autodesk/userconfig/Maya/<バージョン>/plug-ins /usr/autodesk/userconfig/Maya/plug-ins $MAYA_LOCATION/bin/plug-ins |
MAYA_PLUG_IN_PATH 環境変数に複数のパスを追加する場合、パスを Mac OS X ではコロン(:)、Windows と Linux ではセミコロン(;)で区切る必要があります。
Maya プリセットのロケーションを定義します。パスのエントリはそれぞれ、attrPresets ディレクトリの上にあるディレクトリを示します。さらに、Maya の起動時に検出される各モジュール ファイルについては、モジュールのルート フォルダの「presets」サブフォルダが、MAYA_PRESET_PATH に付加されます。詳細については、前述の MAYA_MODULE_PATH 変数の説明と「複数ファイル モジュールの配布」(Maya 開発者ヘルプ)を参照してください。
スタートアップ時に、プロジェクト フォルダの場所を指定します。
プリファレンス(Preferences)ウィンドウのファイル/プロジェクト > プロジェクトの設定(File/Projects > Project Settings)カテゴリにある常時このプロジェクトで開始(Always start in this project)フィールドに、このフォルダ場所が表示されます。変数の設定後、プロジェクト フォルダの場所をプリファレンス(Preferences)ウィンドウから変えることはできません。変数を変更するか、除去する必要があります。
Maya 2013 以降、Linux と Mac の各プラットフォームに関して、lastLocalWS によって示されるフォルダにアクセス可能であることを、Maya で使用する前に確認するチェック機能が装備されています。このディレクトリには 555 (r-xr-xr-x)パーミッションが付与されている必要があります。そうでない場合、このフォルダに 444 (r--r--r--)権限しか付与されていなければ、Maya で使用することはできません。cd や ls も機能しません。
lastLocalWS 以外にも、Maya のスタートアップ時に使用しようとする他のワークスペースがあり、これらのワークスペースにも同じチェックが適用されます。これらのワークスペースが Maya で使用される順序は以下のとおりです。
プロジェクト フォルダの場所を指定します。
プリファレンス(Preferences)ウィンドウのファイル/プロジェクト > プロジェクトの設定(File/Projects > Project Settings)カテゴリにある既定のプロジェクト ディレクトリ(Default projects directory)フィールドに、このフォルダ位置が表示されます。変数の設定後、プロジェクト フォルダの場所をプリファレンス(Preferences)ウィンドウから帰ることはできません。変数を変更するか、除去する必要があります。
シェルフにアクセスするために Maya が検索するフォルダに指定します。異なる製作グループがアクセスできるロケーションにシェルフを保存します。その後、各作成グループが、それぞれのワークステーションの MAYA_SHELF_PATH 変数を設定します。
MAYA_SHELF_PATH を使用して複数のディレクトリを指定する場合は、ディレクトリの間をコロンで区切って入力します。たとえば、Production/shelf:Shot/shelf:MyDir/shelf では、3 種類のシェルフ ディレクトリが指定されています。起動時、Maya はシェルフをインスタンス化するために、指定された順序で各フォルダを検索します。MAYA_SHELF_PATH で指定されたフォルダを検索した後、Maya は続けて既定のシェルフ フォルダからシェルフを追加します。あるシェルフの存在が確認されたら、その後検索したディレクトリに同じ名前のシェルフがあっても、これは無視されます。
新たに作成されたシェルフは、必ず既定のシェルフ ディレクトリに保存されます。これを共有するには、このシェルフを MAYA_SHELF_PATH に指定されているディレクトリの 1 つに移動します。
シェルフ ディレクトリへのアクセスを制限するには、このディレクトリへの書き込みを禁止します。ユーザが(すべてのシェルフを終了、または保存するときに)制限つきのシェルフ ディレクトリにアクセスしようとすると、警告が表示されます。
MEL スクリプトの検索パスを、コロンで区切って指定します。未解決の MEL プロシージャが呼び出された場合、このプロシージャを実装するスクリプトが、このパスから検索されます。また、フル パスを指定せずに MEL ファイルをソースにした場合もこのパスが検索されます。
さらに、Maya の起動時に検出される各モジュール ファイルについては、モジュールのルート フォルダの script サブフォルダが、MAYA_SCRIPT_PATH に付加されます。詳細については、前述の MAYA_MODULE_PATH 変数の説明と「複数ファイル モジュールの配布」(Maya 開発者ヘルプ)を参照してください。
ツールクリップの内容を Maya が検索するフォルダに指定します。
MAYA_TOOLCLIPS_PATH を使用して複数のディレクトリを指定する場合は、ディレクトリの間をコロンで区切って入力します。たとえば、<drive:>¥<path>;<drive2:>¥<path2> では、2 種類のツールクリップ フォルダが指定されています。起動時、Maya は指定された順序で各フォルダを検索します。MAYA_TOOLCLIPS_PATH で指定されたフォルダを検索した後、Maya は続けて既定の user.toolclips フォルダ、builtin.toolclips フォルダの順に検索します。
キー名がツールクリップの検索パス内にある 2 つの ToolClip.xml ファイルに存在する場合、Maya は最初に遭遇したキー名を使用します。
Python モジュール ファイルをプログラムに読み込む場合のロケーション。モジュール ディレクトリのディレクトリ名のリストに、この変数を設定します。リストは、UNIX の場合はコロンで、Windows の場合はセミコロンで区切ります。
さらに、Maya の起動時に検出される各モジュール ファイルについては、モジュールのルート フォルダの script サブフォルダが、PYTHONPATH に付加されます。詳細については、前述の MAYA_MODULE_PATH 変数の説明と「複数ファイル モジュールの配布」(Maya 開発者ヘルプ)を参照してください。
この変数の使用は、必須ではありません。Python は常にプログラムの最上位ファイルのホーム ディレクトリを検索するため、任意のモジュールが別のディレクトリにあるモジュールを読み込む場合のみに、この環境変数を設定する必要があります。
Windows の既定 |
---|
<ユーザ フォルダ>/My Documents/Maya/projects/default/mel <ユーザ フォルダ>/My Documents/Maya/<バージョン>/scripts <ユーザ フォルダ>/My Documents/Maya/scripts <ユーザ フォルダ>/My Documents/Maya/<バージョン>/presets <ユーザ フォルダ>/My Documents/Maya/<バージョン>/prefs/shelves <ユーザ フォルダ>/My Documents/Maya/<バージョン>/prefs/markingMenus <Maya>/scripts/startup <Maya>/scripts/others <Maya>/scripts/AETemplates <Maya>/scripts/paintEffects <Maya>/scripts/fluidEffects <Maya>/scripts/hair <Maya>/scripts/cloth <Maya>/scripts/fur |
Linux の既定 |
---|
$MAYA_APP_DIR/Maya/<バージョン>/scripts $MAYA_APP_DIR/Maya/scripts /usr/autodesk/userconfig/Maya/<バージョン>/scripts /usr/autodesk/userconfig/Maya/scripts $MAYA_APP_DIR/Maya/<バージョン>/prefs/shelves $MAYA_LOCATION/scripts/startup $MAYA_LOCATION/scripts/others $MAYA_LOCATION/scripts/AETemplates $MAYA_LOCATION/scripts/paintEffects $MAYA_LOCATION/scripts/cloth $MAYA_LOCATION/scripts/fur |
Mac OS X の既定 |
---|
ホーム フォルダ下: Library/Preferences/Autodesk/Maya/<バージョン> ホーム フォルダ下: Library/Preferences/Autodesk/Maya /Users/Shared/Autodesk/Maya/<バージョン> /Users/Shared/Autodesk/Maya Maya パッケージ内: /Applications/Autodesk/Maya <バージョン>/Maya.app |
この変数には、Maya で、次のようなテンポラリ ファイルの保管に使用されるフォルダ ロケーションを指定します。
Mac OS X と Linux では、TMPDIR のみを設定します。Windows では、TEMP と TMPDIR の両方を設定します。
設定していない場合、一時ディレクトリは次のようになります。
または、ターミナル ウィンドウで env コマンドを実行すると、すべての環境変数セットとそれに対応する値のリストが返されます。
この変数には、シェルフ(Shelf)ボタンで使用されるアイコンなどのアイコン ファイルのロケーションを指定します。Linux では、構文は他のパスと多少異なります。例:
XBMLANGPATH = "./icons/%B:$HOME/dev/icons/%B"
この例では、%B はプレースホルダで、Maya により、ビットマップ ファイル名と置き換えられます。
さらに、Maya の起動時に検出される各モジュール ファイルについては、モジュールのルート フォルダ(Linux 上では icons/%B)の icons サブフォルダが、XBMLANGPATH に付加されます。詳細については、前述の MAYA_MODULE_PATH 変数の説明と「複数ファイル モジュールの配布」(Maya 開発者ヘルプ)を参照してください。
次の表は、既定のパスをまとめたものです。これらのパスは、必ず、ユーザが指定したパスの後に来ます。
Windows の既定 |
---|
%MAYA_APP_DIR%¥Maya¥<バージョン>¥prefs¥icons %MAYA_LOCATION%¥icons %MAYA_LOCATION%¥icons¥paintEffects %MAYA_LOCATION%¥icons¥cloth %MAYA_LOCATION%¥icons ¥fur |
Mac OS X の既定 |
---|
ホーム フォルダ下: Library/Preferences/Autodesk/Maya/<バージョン>/prefs/icons ホーム フォルダ下: Library/Preferences/Autodesk/maya/prefs/icons /Users/Shared/Autodesk/Maya/<バージョン>/icons /Users/Shared/Autodesk/Maya/icons Maya パッケージ内: /Applications/Autodesk/Maya <バージョン>/Maya.app |
Linux の既定 |
---|
$MAYA_APP_DIR/maya/<バージョン>/prefs/icons/%B $MAYA_APP_DIR/maya/prefs/icons/%B /usr/autodesk/userconfig/maya/<バージョン>/icons/%B /usr/autodesk/userconfig/maya/icons/%B $MAYA_LOCATION/icons/%B $MAYA_LOCATION/icons/paintEffects/%B $MAYA_LOCATION/icons/cloth/%B $MAYA_LOCATION/icons/fur/%B |
この変数で maya.rayrc ファイルの位置を指定することができます。