天晴动作工具组（NDToolsBox / 天晴盒子）的 3ds Max 动画曲线过滤 开源工具。

面向 Curve Editor 中的浮点 / 缩放曲线，提供高斯平滑、Butterworth 滤波与道格拉斯–普克减帧等处理。由 MAXScript 前端 UI + C#（Autodesk.Max .NET SDK）后端组成，相对早期 Python 版本可覆盖更广的 Max 版本线。

不支持 Biped 曲线。

内容概览

文件 / 模块	说明
anim_filter/ClassLibrary3/	主库工程，输出 anim_filter_Library.dll（Butterworth、高斯平滑、Douglas–Peucker、关键读写等）
anim_filter/anim_filter.sln	主解决方案
ClassLibrary4/	同期开发 / 试验工程（曲线采样、多档高斯、Butterworth、减帧、动画塌陷等）
ClassLibrary5/	精简试验工程（高斯平滑、Track View 窗口透明度等）

运行时 UI（如 动画滤波.mse）与安装包资源通常随天晴盒子 / 工具包分发，本仓库以 C# 核心库源码 为主。

主要功能

• 高斯平滑：按邻帧权重平滑选中或整条曲线关键
• Butterworth 滤波：低通滤波，抑制高频抖动
• 道格拉斯–普克减帧（Ramer–Douglas–Peucker）：按阈值简化曲线关键
• 读取 / 写回 Curve Editor 中选中曲线的关键值（浮点、缩放等）
• Track View 窗口透明度等辅助能力（部分工程内）

支持的 3ds Max 版本

• 约 2012 及以上（通过 Autodesk.Max.dll .NET 接口）
• 工程当前目标框架：.NET Framework 4.5.2
• 工程内引用示例路径指向 3ds Max 2015 的 Autodesk.Max.dll；编译时请改为本机对应 Max 版本的 SDK / 安装目录

具体能力以当前 DLL 与 NDToolsBox / 脚本前端配置为准。

编译说明

1. 使用 Visual Studio（建议 2015+）打开 anim_filter/anim_filter.sln（或对应的 ClassLibrary4 / ClassLibrary5 解决方案）
2. 将项目中 Autodesk.Max 的引用路径指向本机 3ds Max 安装目录下的 Autodesk.Max.dll
3. 编译生成 anim_filter_Library.dll（或对应程序集名称）
4. 将 DLL 放到前端脚本所期望的加载路径后，在 Max 中启动 UI 使用

安装路径

通过天晴盒子 / NDToolsBox 安装器部署时，可参考同类工具资源目录：

C:\ProgramData\Autodesk\ApplicationPlugins\NDToolsBox\

离线 / 手动安装时，也可将工具文件夹放到 3ds Max 的 scripts 目录，再将前端 .mse 拖入 Max 启动。

也可从官网入口下载安装：

• 下载安装 (opens new window)

使用文档：

• 动画曲线过滤（C#） (opens new window)
• 动画曲线过滤（Python / Max 2021） (opens new window)
• NetSDK(C#) 动画曲线插件课程 (opens new window)

相关

• 早期 Python 版思路移植自 animFilters for Maya (opens new window)
• 动画重定向工具：Joe_Anim_Picker 动画重定向工具
• 3ds Max 插件客户端：NDToolsBox 插件客户端

Git 仓库

• GitHub：https://github.com/4698to/ND_Anim_Filter (opens new window)
• Gitee：https://gitee.com/to4698_admin/ND_Anim_Filter (opens new window)

开源组织

本项目由以下组织开源：

• 网龙网络公司
• 福建天晴数码有限公司

开源协议

本项目采用 Apache License 2.0 (opens new window) 开源协议。

你可以自由使用、修改和分发本软件，包括用于商业用途，但须遵守该协议的要求，例如保留版权与许可声明，并在修改时注明变更。软件按「原样」提供，不附带任何明示或暗示的担保。