151 lines
4.0 KiB
Markdown
151 lines
4.0 KiB
Markdown
# Studio Library
|
||
|
||
Studio Library 是一个免费的动画库工具，用于在 Autodesk Maya 中管理姿势和动画。
|
||
|
||
## 版本
|
||
|
||
Studio Library 2.20.2
|
||
|
||
## 官方信息
|
||
|
||
- **官网**: https://www.studiolibrary.com
|
||
- **GitHub**: https://github.com/krathjen/studiolibrary
|
||
- **作者**: Kurt Rathjen
|
||
|
||
## 功能特性
|
||
|
||
- 保存和加载动画姿势
|
||
- 管理动画片段
|
||
- 镜像姿势和动画
|
||
- 选择集管理
|
||
- 自定义缩略图
|
||
- 支持多个库
|
||
- 拖放操作
|
||
- 搜索和过滤
|
||
|
||
## 使用方法
|
||
|
||
### 方式 1：使用 launcher（推荐）
|
||
|
||
```python
|
||
from animation_tools.studiolibrary import launcher
|
||
launcher.LaunchStudioLibrary()
|
||
```
|
||
|
||
### 方式 2：直接导入
|
||
|
||
```python
|
||
# 需要先添加路径到 sys.path
|
||
import sys
|
||
import os
|
||
studiolibrary_path = r'h:\Workspace\Raw\Tools\Plugins\Maya\2023\scripts\animation_tools\studiolibrary'
|
||
if studiolibrary_path not in sys.path:
|
||
sys.path.insert(0, studiolibrary_path)
|
||
|
||
# 然后导入并启动
|
||
import studiolibrary
|
||
studiolibrary.main()
|
||
```
|
||
|
||
### 方式 3：从 animation_tools 导入
|
||
|
||
```python
|
||
# 如果 animation_tools 已在 PYTHONPATH 中
|
||
from animation_tools import studiolibrary
|
||
studiolibrary.main()
|
||
```
|
||
|
||
### 在 MEL 中启动
|
||
|
||
```mel
|
||
python("from animation_tools.studiolibrary import launcher; launcher.LaunchStudioLibrary()");
|
||
```
|
||
|
||
### 从工具架启动
|
||
|
||
点击动画工具架上的 **StudioLib** 按钮即可启动。
|
||
|
||
## 模块结构
|
||
|
||
此模块包含以下子模块：
|
||
|
||
- **studiolibrary**: 核心库模块
|
||
- **studiolibrarymaya**: Maya 集成模块
|
||
- **mutils**: Maya 工具函数
|
||
- **studioqt**: Qt 界面组件
|
||
- **studiovendor**: 第三方依赖
|
||
|
||
## 注意事项
|
||
|
||
- 首次使用需要设置库路径
|
||
- 支持 Maya 2017 及更高版本
|
||
- 需要 PySide2 或 PySide6（Maya 自带）
|
||
|
||
## 🔧 版本兼容性
|
||
|
||
### 支持的 Maya 版本
|
||
- **Maya 2017-2024** - 使用 PySide2
|
||
- **Maya 2025+** - 使用 PySide6
|
||
- **自动适配** - 运行时自动检测 Maya 环境和 Qt 版本
|
||
|
||
### Maya 2025 特别说明
|
||
- ✅ 已创建外层 `__init__.py` 文件，解决模块导入问题
|
||
- ✅ 自动检测并使用 PySide6
|
||
- ✅ 完全兼容新版本的 Python 3.11
|
||
|
||
### Qt 兼容性
|
||
Studio Library 使用 `Qt.py` 兼容层，支持多种 Qt 绑定：
|
||
- **PySide6** - Maya 2025+ (优先)
|
||
- **PySide2** - Maya 2017-2024 (优先)
|
||
- **PyQt5** - 备用方案
|
||
- **PySide** - Maya 2014-2016 (备用)
|
||
- **PyQt4** - 备用方案
|
||
|
||
### 兼容性特性
|
||
1. **自动 Qt 检测** - 运行时检测可用的 Qt 绑定
|
||
2. **Maya 环境检测** - 自动识别是否在 Maya 中运行
|
||
3. **跨版本支持** - 同一代码在不同 Maya 版本中运行
|
||
4. **Python 2/3 兼容** - 使用 `six` 库实现 Python 2 和 3 的兼容
|
||
|
||
### Qt 绑定优先级
|
||
```
|
||
PySide6 > PySide2 > PyQt5 > PySide > PyQt4
|
||
```
|
||
|
||
可通过环境变量 `QT_PREFERRED_BINDING` 指定优先使用的绑定：
|
||
```python
|
||
import os
|
||
os.environ['QT_PREFERRED_BINDING'] = 'PySide2'
|
||
```
|
||
|
||
## 💡 技术架构
|
||
|
||
### 核心模块
|
||
- **studiolibrary** - 核心库逻辑，与 DCC 无关
|
||
- **studiolibrarymaya** - Maya 特定集成
|
||
- **mutils** - Maya 工具函数（动画、姿势等）
|
||
- **studioqt** - Qt UI 组件
|
||
- **studiovendor** - 第三方依赖（Qt.py, six）
|
||
|
||
### 兼容性层次
|
||
```
|
||
┌─────────────────────────────┐
|
||
│ Studio Library UI │
|
||
└──────────┬──────────────────┘
|
||
│
|
||
┌──────────▼──────────────────┐
|
||
│ Qt.py (兼容层) │
|
||
│ - PySide6/PySide2/PyQt5 │
|
||
└──────────┬──────────────────┘
|
||
│
|
||
┌──────────▼──────────────────┐
|
||
│ Maya API │
|
||
│ - maya.cmds │
|
||
│ - maya.OpenMaya │
|
||
└─────────────────────────────┘
|
||
```
|
||
|
||
## 许可证
|
||
|
||
GNU Lesser General Public License v3.0
|