blendermarketCN插件概述
钢琴演奏动画工具 1.50 版可把 MIDI 文件中的音符转换为琴键按压、琴槌动作及三踏板动画，并支持左右手配色、自发光及自定义对象命名。 原说明要求 Blender 4.2.0 及以上，以及处理 MIDI 所需的 mido 库。
安装与依赖
下载插件 ZIP，在“编辑 → 偏好设置 → 插件”中安装并启用。若提示缺少 mido，可在 Blender 的 Python 控制台按原说明执行：
import pip
pip.main(['install', 'mido'])也可把安装好的 mido 模块复制到 Blender 的 scripts/modules，然后重启。实际安装命令须匹配 Blender 自带的 Python 环境。
面板与参数
在三维视口按 N 打开侧边栏，进入钢琴标签。
- 琴键设置： 白键前缀、黑键前缀、名称分隔符以及黑白键默认颜色。
- 琴槌设置： 琴槌对象前缀和运动距离。
- 踏板设置： 延音、选择延音、柔音踏板对象名及旋转角度。
- 可调整琴键颜色、发光及其他动画参数，并预览结果。
工作流程
1. 准备名称符合规则的钢琴模型。 2. 点击“测试组件”，确认名称映射、部件和层级正确。 3. 点击“创建钢琴动画”，选择 MIDI 文件并等待生成。 4. 预览动作，调整琴键、琴槌、踏板与发光效果；需要时重新生成。
模型要求与默认名称
原说明要求 52 个白键、36 个黑键、88 个琴槌和 3 个踏板，默认名称示例为：
meshId57_name.1 ... meshId57_name.52
meshId56_name.1 ... meshId56_name.36
pCube1 ... pCube88
piano_pedal_metal01
piano_pedal_metal02
piano_pedal_metal03常见问题
组件测试失败时检查名称、部件是否齐全及对象层级。动画效果不合适时调整琴键和琴槌的运动、踏板旋转，以及配色参数。大文件生成较慢，建议先用较短 MIDI 验证。
作者与许可证
原备份作者为 475519905，联系标记为 qq475519905，文档内部版本标记为 1.0，分类为动画，许可证为 GPL-3.0。