Nexus/2023/scripts/animation_tools/mgpicker/README.md

MG-Picker Studio Module

MG-Picker Studio 动画选择器工具的简化模块版本。

目录结构

mgpicker/
├── __init__.py                 # 模块入口，提供 start() 函数
├── MGPicker_Program/           # 核心程序文件
│   ├── Plug-ins/              # Maya 插件文件 (.mll)
│   ├── UI/                    # 用户界面 MEL 脚本
│   ├── Python/                # Python 支持文件
│   ├── AutoSourced/           # 自动加载的脚本
│   ├── CodeSnippets/          # 代码片段
│   ├── CommandButtonPresets/  # 命令按钮预设
│   ├── Templates/             # Picker 模板
│   └── ...
├── MGPicker_Help/             # 帮助文档
├── Sample_Pickers/            # 示例 Picker 文件
└── MGPicker_UserConfig/       # 用户配置目录

使用方法

在 Python 中启动

import animation_tools.mgpicker
animation_tools.mgpicker.start()

在 MEL 中启动

python("import animation_tools.mgpicker; animation_tools.mgpicker.start()");

插件说明

• 插件文件位于 MGPicker_Program/Plug-ins/ 目录
• 支持 Maya 2017-2026 版本
• 插件会在启动时自动检测 Maya 版本并加载对应的插件

🔧 版本兼容性

支持的 Maya 版本

• Maya 2017 - MGPicker_2017x64.mll
• Maya 2018 - MGPicker_2018x64.mll
• Maya 2019 - MGPicker_2019x64.mll
• Maya 2020 - MGPicker_2020x64.mll
• Maya 2022 - MGPicker_2022x64.mll
• Maya 2023 - MGPicker_2023x64.mll
• Maya 2024 - MGPicker_2024x64.mll
• Maya 2025 - MGPicker_2025x64.mll
• Maya 2026 - MGPicker_2026x64.mll

自动版本匹配

启动器会自动检测当前 Maya 版本并加载对应的插件：

1. 完全匹配 - 优先使用与 Maya 版本完全匹配的插件
2. 向下兼容 - 如果没有完全匹配，使用小于等于当前版本的最高版本插件
3. 兜底策略 - 如果当前版本比所有可用插件都旧，使用最旧的可用插件

使用示例

# 自动检测版本并启动（动画师模式）
import animation_tools.mgpicker
animation_tools.mgpicker.start()

# 启动设计师模式
animation_tools.mgpicker.start(mode=0)

# 仅加载插件
animation_tools.mgpicker.load_plugin()

💡 功能特性

• 动画选择器 - 快速选择和操作角色控制器
• 自定义界面 - 创建自定义的 Picker 界面
• 命令按钮 - 绑定 MEL/Python 命令到按钮
• 姿势管理 - 保存和加载角色姿势
• 镜像功能 - 镜像选择和姿势
• 多版本支持 - 自动适配不同 Maya 版本

原始信息

• 作者: Miguel (Wenfeng Gao)
• 网站: http://mgland.com
• 邮箱: mgtoolspro@gmail.com