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（推荐）
from animation_tools.studiolibrary import launcher
launcher.LaunchStudioLibrary()
方式 2：直接导入
# 需要先添加路径到 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 导入
# 如果 animation_tools 已在 PYTHONPATH 中
from animation_tools import studiolibrary
studiolibrary.main()
在 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 - 备用方案
兼容性特性
- 自动 Qt 检测 - 运行时检测可用的 Qt 绑定
- Maya 环境检测 - 自动识别是否在 Maya 中运行
- 跨版本支持 - 同一代码在不同 Maya 版本中运行
- Python 2/3 兼容 - 使用
six库实现 Python 2 和 3 的兼容
Qt 绑定优先级
PySide6 > PySide2 > PyQt5 > PySide > PyQt4
可通过环境变量 QT_PREFERRED_BINDING 指定优先使用的绑定：
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