# 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 中启动

```python
import animation_tools.mgpicker
animation_tools.mgpicker.start()
```

### 在 MEL 中启动

```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. **兜底策略** - 如果当前版本比所有可用插件都旧，使用最旧的可用插件

### 使用示例

```python
# 自动检测版本并启动（动画师模式）
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