MMDScale (Blender 插件 / Add-on)

作者: RedialC
Author: RedialC

---

📖 插件介绍 / Description

MMDScale 是一个 Blender 插件，可以在时间轴（X 轴）上缩放关键帧。主要用于优化VMD相机数据在blender使用高帧率渲染时直接缩放产生的跳帧问题。
MMDScale is a Blender add-on that scales keyframes on the timeline (X axis).

它会保持 原本相邻的关键帧对（后一 = 前一 + 1） 在缩放后依然相邻。
It preserves originally adjacent key pairs (next = prev + 1) after scaling.

• 默认枢轴帧 (Pivot) = 1.0
• Default pivot frame = 1.0
• 默认缩放比例 (Scale) = 2.0
• Default scale factor = 2.0
• 支持对象 / 骨骼动画和形态键动画
• Supports Object/Bone animations and Shape Keys animations

---

📦 安装方法 / Installation

1. 前往 Releases 页面 下载最新的 MMDScale.zip。
   Go to the Releases page and download the latest MMDScale.zip.
2. 打开 Blender → 编辑 → 首选项 → 插件 → 安装。
   Open Blender → Edit → Preferences → Add-ons → Install.
3. 选择下载的 MMDScale.zip 并启用插件。
   Select the downloaded MMDScale.zip and enable the add-on.

---

🕹 使用方法 / Usage

• 打开 Dope Sheet / Graph Editor / 3D View。
  Open Dope Sheet / Graph Editor / 3D View.
• 按 N 打开右侧边栏，找到 MMDScale 标签。
  Press N to open the right sidebar, then go to the MMDScale tab.
• 设置参数：
  Set parameters:
  • Scale（默认 2.0 / default 2.0）
  • Pivot Frame（默认 1.0 / default 1.0）
  • 是否包含形态键 / Include Shape Keys
  • 是否只处理选中物体 / Only Selected Objects
  • 是否在控制台打印日志 / Verbose Log
• 点击 MMDScale: Scale Now 按钮执行。
  Click the MMDScale: Scale Now button to execute.

你也可以在 Dope Sheet / Graph Editor 顶栏 使用快捷按钮快速运行。
You can also use the quick MMDScale button in the Dope Sheet / Graph Editor header.

---

📷 界面预览 / UI Preview

---

🔧 示例 / Example

假设你有两个关键帧在第 10 和 11 帧：
Suppose you have two keys on frame 10 and 11:

以 pivot=1.0，scale=2.0 缩放后 → 它们会变成 19 和 20，依然保持相邻。
After scaling around pivot=1.0 with scale=2.0 → they become 19 and 20, still locked as adjacent.

---

📜 许可证 / License

本项目基于 MIT License 开源。
This project is released under the MIT License.

---

🙌 致谢 / Credits

由 RedialC 开发
Created by RedialC

特别感谢 Blender & MMD 社区。
Special thanks to the Blender & MMD community.