CGNICO/Nexus

Fork 0

Files

jeffreytsai1004 719058ff01 Update

2025-11-24 22:26:56 +08:00

4.0 KiB

Raw Blame History

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

4.0 KiB Raw Blame History Unescape Escape