文件路径变量

MAYA_APP_DIR

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

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

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

如果不设定 MAYA_APP_DIR 变量,则默认值为:

  • Windows Vista、Windows 7 和 Windows 8

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

  • Mac OS X

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

  • Linux(64 位)

    ~<用户名>/Maya

MAYA_CMD_FILE_OUTPUT

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

注:

“脚本编辑器”(Script editor)中的内容将同时在“脚本编辑器”(Script editor)中和指定的输出位置显示。

MAYA_CONTENT_PATH

此变量将获取内容目录的路径,使用这些路径可以填充内容浏览器中的“示例”(Examples)选项卡。通过将插件添加到其模块模板文件中的环境变量或使用 assetBrowser -addContentPath 标志,可以将插件及其自身的内容目录添加到此路径。

MAYA_CUSTOM_TEMPLATE_PATH

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

用于“节点编辑器”(Node Editor )时:可以通过创建自定义属性列表模板自定义为每个节点显示的属性列表。下次创建相同节点时,Maya 会搜索现有模板,如果找到适用模板,则会使用您创建的自定义属性列表显示节点。您可以将此环境变量设置为自定义样板所在的位置,与其他用户共享这些模板。有关详细信息,请参见自定义节点属性列表。此环境变量支持在 Windows 上以 ; 分隔或在 Mac OS X/Linux 上以 : 分隔的多个路径。

MAYA_CUSTOM_TEMPLATE_WRITE_PATH

用于“节点编辑器”(Node Editor)。可以通过创建自定义属性列表模板自定义为每个节点显示的属性列表。默认情况下,模板保存到 $MAYA_APP_DIR/<app_ver>/[本地化语言]/prefs/viewTemplates/,但您可以将此环境变量设置为所需的位置来覆盖默认位置。有关详细信息,请参见自定义节点属性列表

MAYA_FILE_ICON_PATH

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

MAYA_MODULE_PATH

定义 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_directory>/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_MOVIE_DIR

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

MAYA_LOCATION

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

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

MAYA_PLUG_IN_PATH

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

Windows 的默认值

<用户的目录>/Documents/Maya/<版本>/plug-ins

<用户的目录>/Documents/Maya/plug-ins

<maya_directory>/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

/Applications/Maya <版本>/Maya.app 中的 Maya 软件包内

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_PRESET_PATH

定义 Maya 预设的位置。路径中的每个条目指向 attrPresets 目录之上的目录。此外,对于 Maya 启动时发现的每个模块文件,模块根目录中的“预设”子目录将添加到 MAYA_PRESET_PATH。有关详细信息,请参见上述 MAYA_MODULE_PATH 变量的描述以及 Maya 开发人员帮助中的“分发多文件模块”部分。

MAYA_PROJECT

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

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

注:

从 Maya 2013 开始,对于 Linux 和 Mac 平台,在 Maya 尝试使用 lastLocalWS 指向的目录之前将进行检查以确保该目录可以访问。目录必须具有“555(r-x -xr-x)”权限。否则,如果目录仅具有 444(r--r--r--) 权限,则 Maya 不能使用它;即使 cdls 不起作用也是如此。

lastLocalWS 之外,Maya 在启动时还尝试使用其他的工作区,而对这些工作区也将应用相同的检查。Maya 尝试使用这些工作区的顺序如下:

  • -proj 命令行参数获取的值
  • MAYA_PROJECT 环境变量获取的值
  • InitialProject optionVar(即标记为“始终使用此项目启动”(Always start in this project)的首选项)
  • lastLocalWS optionVar (在退出时由 Maya 自动存储,以记住上一活动工作区)
  • 默认项目
MAYA_PROJECTS_DIR

指定项目文件夹的位置。

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

MAYA_SHELF_PATH

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

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

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

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

MAYA_SCRIPT_PATH

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

此外,对于 Maya 启动时发现的每个模块文件,该模块根目录下的 scripts 子目录将添加到 MAYA_SCRIPT_PATH。有关详细信息,请参见上述 MAYA_MODULE_PATH 变量的描述以及 Maya 开发人员帮助中的“分发多文件模块”部分。

注意: 如果选择定义自定义脚本路径和自定义工具架路径(即,设置 MAYA_SHELF_PATH 和 MAYA_SCRIPT_PATH),则 MAYA_SHELF_PATH 必须先(早于 MAYA_SCRIPT_PATH)在 Maya.env 中列出。
MAYA_TOOLCLIPS_PATH

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

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

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

PYTHONPATH

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

此外,对于 Maya 启动时发现的每个模块文件,该模块根目录下的 scripts 子目录将添加到 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_directory>/scripts/startup

<maya_directory>/scripts/others

<maya_directory>/scripts/AETemplates

<maya_directory>/scripts/paintEffects

<maya_directory>/scripts/fluidEffects

<maya_directory>/scripts/hair

<maya_directory>/scripts/cloth

<maya_directory>/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

在 /Applications/Autodesk/Maya <版本>/Maya.app 中的 Maya 软件包内

Temp 或 TMPDIR

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

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

在 Mac OS X 和 Linux 中,仅设置 TMPDIR。在 Windows 中,设定 TEMP 和 TMPDIR。

如果未设置,临时目录为:

  • /tmp (Linux)
  • C:/temp (Windows),或在主文件夹下的 Documents/temp 中。
  • /var/folders/xx/xxx/T,其中,xx 和 xxx 可以是字符的任意组合。(Mac OS X)

    或者,您可以在终端窗口中运行 env 命令,返回所有环境变量集及其对应值的列表。

XBMLANGPATH

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

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

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

此外,对于 Maya 启动时发现的每个模块文件,模块根目录的 icons 子目录(Linux 中为 'icons/%B)将添加到 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

在 /Applications/Autodesk/Maya <版本>/Maya.app 中的 Maya 软件包内

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