This variable defines your personal Maya application directory. This directory contains your projects and other important items:
You can only set MAYA_APP_DIR from the operating system; you cannot use Maya.env. If you set this variable in the Mac OS X operating system, you must launch Maya from the Terminal window. Otherwise, Maya will not use the set value.
If you do not set the MAYA_APP_DIR variable, the default values are:
This variable enables the cmdFileOutput command during startup so the content in the script editor automatically outputs to a designated file. If no file name is specified, then errors are sent to the standard error output, for example the Terminal window. This feature is useful for tracking down error messages when Maya crashes upon startup.
This variable has become obsolete since Maya 3.0. See XBMLANGPATH as this variable should be used instead.
Defines the search paths for Maya module files. A module file describes the install location of a plugin which has been distributed as a module. Maya will append subdirectories of this install location to the following path variables: MAYA_PLUG_IN_PATH, MAYA_PRESET_PATH, MAYA_SCRIPT_PATH, PYTHONPATH and XBMLANGPATH. See the individual descriptions of these variables below and Distributing Maya Plug-ins in the API Guide for more information.
The following tables list the default paths, which will always follow any path that you specify.
The path for the Maya installation directory. If it is not set, it defaults to /usr/autodesk/mayaVersionNumber (Linux) or C:\Program Files\Autodesk \MayaVersionNumber (Windows).
On Mac OS X, Maya is installed as /Applications/Maya 2014/Maya.app. Since Mac OS X architecture makes it difficult to access the contents of the Maya application package, we strongly discourage the use of MAYA_LOCATION on Mac OS X. Instead, use the following alternate locations:
Search path for plug-ins. When a plug-in is specified by relative path name, the directories in this path are searched for the given plug-in name. This path also determines which directories are listed in the Plug-in Manager. In addition, for each module file found by Maya on startup, the plug-ins subdirectory of the module's root directory will be added to MAYA_PLUG_IN_PATH. See the description of the MAYA_MODULE_PATH variable above and in Distributing Multi-File Modules in the API Guide for more information.
| Default for Windows |
|---|
| <user’s directory>/My Documents/maya/2014/plug-ins <user’s directory>/My Documents/maya/plug-ins <maya_directory>/bin/plug-ins |
Defines the location for Maya presets. Each entry in the path points to the directory above the attrPresets directory. In addition, for each module file found by Maya on startup, the the 'presets' subdirectory of the module's root directory will be added to MAYA_PRESET_PATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the API Guide for more information.
Specifies the location of your project folder on startup.
In the Preferences window, under File/Projects > Project Settings, the folder location is displayed as Always start in this project. After setting the variable, you cannot change the location of the project folder from the Preferences window. You must either change or remove the variable.
Beginning Maya 2013, for the Linux and Mac platforms, there are checks to ensure that the directory pointed to by lastLocalWS is accessible before Maya attempts to use it. The directory must have 555 (r-xr-xr-x) permissions. Otherwise, if the directory only has 444(r--r--r--) permissions, Maya cannot use it; even cd or ls do not work.
In addition to lastLocalWS, there are other workspaces that Maya tries to use on startup, and the same check is being applied to these workspaces also. The order in which Maya tries to use these workspaces are as follows:
Specifies the location of your project folder.
In the Preferences window, under File/Projects > Project Settings, the folder location is displayed as Default projects directory. After setting the variable, you cannot change the location of the project folder from the Preferences window. You must either change or remove the variable.
Specifies the directories that Maya searches to access the shelves. You can store shelves in a location accessible by different groups who then set the MAYA_SHELF_PATH variable for their workstation.
You can specify more than one directory using MAYA_SHELF_PATH, separated by colons; for example, Production/shelf:Shot/shelf:MyDir/shelf specifies three different shelf directories. At startup, Maya searches each directory in the order specified to instantiate shelves. After searching the directories specified in MAYA_SHELF_PATH, Maya continues to add shelves from the default shelf directory. Once a shelf exists, a shelf with the same name in the subsequent searched directories is ignored.
When a new shelf is created, it is always saved in the default shelf directory. To share it, move it to the desired directory (that is, one of the ones specified by MAYA_SHELF_PATH).
To restrict access to a shelf directory, disable the write permission of that directory. A warning appears when a user attempts to write into a restricted shelf directory (while exiting or saving all shelves).
Colon-separated search path for MEL scripts. If an unresolved MEL procedure is called, then this path will be searched for a script that implements it. Also, if a MEL file is sourced without giving the full path, then this path will be searched.
In addition, for each module file found by Maya on startup, the the scripts subdirectory of the module's root directory will be added to MAYA_SCRIPT_PATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the API Guide for more information.
The following table lists the default paths, which will always follow any path that you specify.
Specifies the directories that Maya searches for ToolClip content.
You can specify more than one directory using MAYA_TOOLCLIPS_PATH, separated by colons; for example, <drive:>\<path>;<drive2:>\<path2> specifies two different ToolClip directories. At startup, Maya searches each directory in the order specified. After searching the directories specified in MAYA_TOOLCLIPS_PATH, Maya continues to search the default user.toolclips directory and then the builtin.toolclips directory.
If a key name exists in two ToolClip.xml files within the ToolClip search path, Maya uses the key name that is encountered first.
Location for your Python module files when you import them in a program. Set this variable to the list of directory names for your module directories. Separate this list by colons for UNIX and semicolons for Windows.
In addition, for each module file found by Maya on startup, the the scripts subdirectory of the module's root directory will be added to PYTHONPATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the API Guide for more information.
Use of this variable is not mandatory. Because Python always searches the home directory of the program’s top level file, you only need to set this environment variable if one of your modules needs to import another module that resides in a different directory.
This variable specifies the directory location Maya uses for various temporary files, such as:
On Linux, set TMPDIR only. On Windows, set both TEMP and TMPDIR. If not set, the temporary directory is /tmp (Linux), or C:/temp (Windows), or under your Home folder in Documents/temp.
This variable specifies the location of icon files, such as icons used for Shelf buttons. On Linux, the syntax is slightly different then other paths. For example:
XBMLANGPATH = "./icons/%B:$HOME/dev/icons/%B"
In this example, %B is acts as a placeholder that will be replaced by Maya with the bitmap filename.
In addition, for each module file found by Maya on startup, the icons subdirectory of the module's root directory ('icons/%B on Linus) will be added to XBMLANGPATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the API Guide for more information.
The following table lists the default paths, which will always follow any path that you specify.
| Default for Windows |
|---|
| %MAYA_APP_DIR%\maya\2014\prefs\icons %MAYA_LOCATION%\icons %MAYA_LOCATION%\icons \paintEffects %MAYA_LOCATION%\icons \cloth %MAYA_LOCATION%\icons \fur |
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License
