配置

MG-Picker支持多个层次的配置：

  1. 在界面上的手动配置。可以通过设计师界面模式下访问“窗口/配置..”菜单来设置，快捷键是Ctrl+K。

  2. 基于文本的服务端配置档。

  3. 环境变量。

不同层次的配置

不同层次的配置的优先级，从高到低：

  1. 基于文本的服务端配置档里，以感叹号开始的配置变量名。

  2. 界面上的手动配置。

  3. 基于文本的服务端配置档里，不以感叹号开始的配置变量名。

  4. 环境变量。

基于界面的手动配置

除了手动在配置对话框里配置，您还可以通过Python/MEL应用程序接口来查询或设置它们。这些API只要插件被加载了，不需要MG-Picker窗口被加载就可以使用。

# Query all config keys and values in string forms:
cmds.MGPicker(q=True, config=True)

# To query one single config:
cmds.MGPicker(q=True, config=("recentPickerFiles", ""))

# To set one single config:
cmds.MGPicker(e=True, config=(configKey, configStringKey))

基于文本的服务端配置

  • 服务端配置文件，默认是安装目录下的MGPicker_ServerConfig/ServerConfig.txt。

  • 配置的格式是 关键词 = 值， 如果要注释一行，则用#开头。

  • 默认情况下，用户手动在界面上的设置会配置服务端配置的值，除非你在关键词前加!， 使用!关键词 = 值，则这个值会强制覆盖界面上的手动配置。

  • 可以用下面的应用程序接口来查询所有支持的配置关键词：

cmds.MGPicker(q=True, config=True)

  • 可以设置环境变量MGPICKER_SERVER_CONFIG_FILE_PATH来指定一个另外的服务端配置文件。默认的就会被忽略。

  • 配置值里支持引用环境变量，可以用这些格式来引用：$变量名, ${变量名}, %变量名% or __变量名__。

  • 在环境变量之外还支持一些预设的变量，你可以通过像引用环境变量一样引用它们：

    • UserAppDir : Maya的默认用户程序文件夹。

    • UserScriptDir: Maya的默认用户脚本文件夹。

目前支持的环境变量

MG-Picker所支持的环境变量如下表：

环境变量

描述

MGPICKER_SERVER_CONFIG_FILE_PATH

用来指定另一个文本配置文件， 如果指定的文件存在且可读，则默认的MGPicker_ServerConfig/ServerConfig.txt会被忽略。

MGPICKER_PROGRAM_FILE_DIR

MG-Picker程序的目录，便于在公司环境下布署和更新程序。

MGPICKER_LOADER_PY_MODULES

包含所有目录用来搜索用户自行编写的loader模块。不同目录路径以;分隔。

MGPICKER_FLOAT_LIC_CONNECTOR_DIR

指定浮动授权连接器可执行文件所在的目录， 以便程序知道在哪里启动浮动授权连接器。

MGPICKER_AUTO_CONNECT_FLOAT_LIC

数值为0 或 1， 用来决定程序Picker程序后是否自动连接浮动授权，如果浮动授权有事先设置过。

注意环境变量 MGPICKER_USER_CONFIG_DIR 已不再支持，用户配置目录被固定为 操作系统我的文档/MGLAND/MG-PickerStudio。