文件路径变量

此变量定义个人 Maya 应用程序目录。此目录包含项目和其他重要的项目：

• 首选项目录
• 项目目录
• mayaRenderLog.txt
• mayaLog
• mayaJournal
• 脚本目录
• Maya.env，如果选择创建此项，则也可以位于此目录中

只能从操作系统中设定 MAYA_APP_DIR，不能使用 Maya.env。如果在 Mac OS X 操作系统中设定此变量，则必须从“终端”(Terminal)窗口启动 Maya。否则，Maya 将不使用设定的值。

如果不设定 MAYA_APP_DIR 变量，则默认值为：

• Windows XP

  \Documents and Settings\<用户名>\My Documents\maya

• Windows Vista 和 Windows 7

  \Users\<用户名>\Documents\maya

• Mac OS X

  ~<用户名>/Library/Preferences/Autodesk/maya

• Linux（64 位）

  ~<用户名>/maya

此变量在启动时启用 cmdFileOutput 命令，使脚本辑器中的内容自动输出到指定文件。如果未指定文件名，则会将错误发送到标准错误输出，例如终端窗口。此功能有助于 Maya 在启动后发生崩溃时跟踪错误消息。

该变量用于覆盖自定义“属性编辑器”(Attribute Editor)模板所在的目录。默认为 Maya 安装目录下的 scripts\AETemplates 文件夹。

此变量自 Maya 3.0 以来已被废弃。请参见 XBMLANGPATH，应使用此变量。

定义 Maya 模块文件的搜索路径。模块文件说明作为模块分发的插件的安装位置。Maya 会将此安装位置的子目录附加到以下路径变量中：MAYA_PLUG_IN_PATH、MAYA_PRESET_PATH、MAYA_SCRIPT_PATH、PYTHONPATH 和 XBMLANGPATH。有关详细信息，请参阅下文关于这些变量的描述以及 API Guide 中的分发 Maya 插件部分。

以下表格所列为默认路径，这些路径将始终出现在任意指定路径之后。

此变量用于覆盖存储电影文件的目录。默认值为 $MAYA_LOCATION/movies。

Maya 安装目录的路径。如果未设定此变量，则会使用默认值 /usr/autodesk/mayaVersionNumber (Linux) 或 C:\Program Files\Autodesk\MayaVersionNumber (Windows)。

在 Mac OS X 中，Maya 会安装为 /Applications/Maya 2014/Maya.app。由于 Mac OS X 的架构导致难以访问 Maya 应用程序软件包的内容，我们强烈建议不要在 Mac OS X 中使用 MAYA_LOCATION。相反，请使用以下替代位置：

搜索插件的路径。当以相应路径名称指定插件时，即会在此路径的目录中搜索指定插件的名称。此路径还会确定列在“插件管理器”(Plug-in Manager)中的目录。此外，对于 Maya 启动时发现的每个模块文件，该模块根目录下的 plug-ins 子目录将添加到 MAYA_PLUG_IN_PATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述和 API Guide 中的“Distributing Multi-File Modules”部分。

定义 Maya 预设的位置。路径中的每个条目指向 attrPresets 目录之上的目录。此外，对于 Maya 启动时发现的每个模块文件，模块根目录中的“预设”子目录将添加到 MAYA_PRESET_PATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述和 API Guide 中的“Distributing Multi-File Modules”部分。

指定启动时项目文件夹的位置。

在“首选项”(Preferences)窗口中的“文件/项目 > 项目设置”(File/Projects > Project Settings)下，文件夹位置显示为“始终使用此项目启动”(Always start in this project)。设定变量后，将无法从“首选项”(Preferences)窗口中更改项目文件夹的位置。必须更改或删除变量。

指定项目文件夹的位置。

在“首选项”(Preferences)窗口中，“文件项目 > 项目设置”(File/Projects > Project Settings)下，文件夹位置显示为“默认项目目录”(Default projects directory)。设定变量后，将无法从“首选项”(Preferences)窗口中更改项目文件夹的位置。必须更改或删除变量。

指定 Maya 为了访问工具架而对其进行搜索的目录。可以将工具架存储在不同组可访问的位置，然后这些组将设定各自工作站的 MAYA_SHELF_PATH 变量。

可以使用 MAYA_SHELF_PATH 指定多个目录并用冒号分隔；例如，Production/shelf:Shot/shelf:MyDir/shelf 指定三个不同的工具架目录。Maya 会在启动时按指定顺序搜索每个目录以实例化工具架。在搜索 MAYA_SHELF_PATH 中指定的目录后，Maya 将继续从默认工具架目录添加工具架。一个工具架一旦存在，后续搜索目录中具有相同名称的工具架将被忽略。

新建工具架将始终存储在默认工具架目录中。若要共享工具架，请将其移动到所需目录（即 MAYA_SHELF_PATH 指定的目录之一）。

若要限制对工具架目录的访问权限，请禁用该目录的写入权限。如果用户在退出或保存所有工具架时尝试写入受限工具架目录，系统即会显示警告。

以逗号分隔的 MEL 脚本搜索路径。如果调用未解析的 MEL 程序，则将在此路径中搜索实施该程序的脚本。此外，如果在不提供完整路径的情况下寻找 MEL 文件的来源，则也将搜索该路径。

另外，对于 Maya 启动时发现的每个模块文件，模块根目录中的 scripts 子目录将添加到 MAYA_SCRIPT_PATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述以及 API Guide 中的“Distributing Multi-File Modules”部分。

下表所列为默认路径，这些路径将始终出现在任意指定路径之后。

指定 Maya 将搜索工具动画演示内容的目录。

可以使用 MAYA_TOOLCLIPS_PATH 并用冒号分隔来指定多个目录；例如，<drive:>\<path>;<drive2:>\<path2> 指定了两个不同的工具动画演示目录。启动时，Maya 会按指定顺序搜索每个目录。搜索完 MAYA_TOOLCLIPS_PATH 中所指定的目录之后，Maya 会继续依次搜索默认的 user.toolclips 目录和 builtin.toolclips 目录。

如果某一关键帧名称存在于工具动画演示搜索路径内的两个 ToolClip.xml 文件中，Maya 会使用首先出现的关键帧名称。

在某个程序中导入 Python 模块文件时的位置。将此变量放入模块目录的目录名称列表。在 UNIX 中用逗号分隔此列表，在 Windows 中用分号分隔此列表。

此外，对于 Maya 启动时发现的每个模块文件，模块根目录中的 scripts 子目录将添加到 PYTHONPATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述以及 API Guide 中的“Distributing Multi-File Modules”部分。

不强制使用此变量。由于 Python 始终搜索程序顶层文件的主项目，仅当一个模块需要导入位于其他目录的其他模块时需要设定此环境变量。

此变量指定 Maya 用于各种临时文件的目录位置，例如：

• 渲染期间的临时渲染缓存文件
• Maya 崩溃时的崩溃文件

在 Linux 中，仅设定 TMPDIR。在 Windows 中，设定 TEMP 和 TMPDIR。如果未设定，临时目录为 /tmp (Linux) 或 C:/temp (Windows)，或在主文件夹下 Documents/temp 的中。

此变量指定图标文件的位置，例如用于“工具架”(Shelf)按钮的图标。在 Linux 中，语法与其他路径稍有不同。例如：

XBMLANGPATH = "./icons/%B:$HOME/dev/icons/%B"

在本示例中，%B 用作 Maya 将用位图文件名替换的占位符。

此外，对于 Maya 启动时发现的每个模块文件，其根目录的 icons 子目录（Linus 中为 "ico s/%B）将添加到 XBMLANGPATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述以及 API Guide 中的“Distributing Multi-File Modules”部分。

下表所列为默认路径，这些路径将始终出现在任意指定路径之后。

此变量可用于指定 maya.rayrc 文件的位置。