文件路径变量

 
 
 
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 XP

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

  • Windows Vista 和 Windows 7

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

  • Mac OS X

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

  • Linux(64 位)

    ~<用户名>/maya

MAYA_CMD_FILE_OUTPUT

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

注意

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

MAYA_CUSTOM_TEMPLATE_PATH

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

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。有关详细信息,请参阅下文关于这些变量的描述以及 API Guide 中的分发 Maya 插件部分。

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

Windows 的默认值

<用户的目录>/My Documents/maya/2013/modules

<用户的目录>/My Documents/maya/modules

C:/Program Files/Common Files/Autodesk Shared/Modules/maya/2013

C:/Program Files/Common Files/Autodesk Shared/Modules/maya

<maya_directory>/modules/
Mac OS X、Linux 的默认值

$MAYA_APP_DIR/maya/2013/modules

$MAYA_APP_DIR/maya/modules

/usr/autodesk/modules/maya/2013

/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 2013/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 变量的描述和 API Guide 中的“Distributing Multi-File Modules”部分。

Windows 的默认值

<用户的目录>/My Documents/maya/2013/plug-ins

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

<maya_directory>/bin/plug-ins

Mac OS X 的默认值

在主文件夹下的 Library/Preferences/Autodesk/maya/2013

在主文件夹下的 Library/Preferences/Autodesk/maya

/Users/Shared/Autodesk/maya/2013

/Users/Shared/Autodesk/maya

在 Maya 软件包的 /Applications/Maya 2013/Maya.app

Linux 的默认值

$MAYA_APP_DIR/maya/2013/plug-ins

$MAYA_APP_DIR/maya/plug-ins

/usr/autodesk/userconfig/maya/2013/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 变量的描述和 API Guide 中的“Distributing Multi-File Modules”部分。

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 将无法使用该目录,甚至“CD”“ls”也无效。

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 变量的描述以及 API Guide 中的“Distributing Multi-File Modules”部分。

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

PYTHONPATH

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

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

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

Windows 的默认值

<用户的目录>/My Documents/maya/projects/default/mel

<用户的目录>/My Documents/maya/2013/scripts

<用户的目录>/My Documents/maya/scripts

<用户的目录>/My Documents/maya/2013/presets

<用户的目录>/My Documents/maya/2013/prefs/shelves

<用户的目录>/My Documents/maya/2013/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/2013/scripts

$MAYA_APP_DIR/maya/scripts

/usr/autodesk/userconfig/maya/2013/scripts

/usr/autodesk/userconfig/maya/scripts

$MAYA_APP_DIR/maya/2013/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/2013 中

在主文件夹下的 Library/Preferences/Autodesk/maya 下

/Users/Shared/Autodesk/maya/2013

/Users/Shared/Autodesk/maya

在 Maya 软件包的 /Applications/Autodesk/Maya 2013/Maya.app 中

Temp 或 TMPDIR

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

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

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

XBMLANGPATH

此变量指定图标文件的位置,例如用于“工具架”(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”部分。

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

Windows 的默认值

%MAYA_APP_DIR%\maya\2013\prefs\icons

%MAYA_LOCATION%\icons

%MAYA_LOCATION%\icons \paintEffects

%MAYA_LOCATION%\icons \cloth

%MAYA_LOCATION%\icons \fur

Mac OS X 的默认值

在主文件夹下的 Library/Preferences/Autodesk/maya/2013/prefs/icons 中

在主文件夹中的 Library/Preferences/Autodesk/maya/prefs/icons 中

/Users/Shared/Autodesk/maya/2013/icons

/Users/Shared/Autodesk/maya/icons

在 Maya 软件包的 /Applications/Autodesk/Maya 2013/Maya.app 中

Linux 的默认值

$MAYA_APP_DIR/maya/2013/prefs/icons/%B

$MAYA_APP_DIR/maya/prefs/icons/%B

/usr/autodesk/userconfig/maya/2013/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_MR_STARTUP_DIR

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