92 lines
2.7 KiB
Markdown
92 lines
2.7 KiB
Markdown
# 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
|