# 项目介绍视频：原理动画素材

新增的原理、结构与代码讲解，可以到 [动画播放页](../../wiki/Animation-Library.md) 看六段短片和合集。新片均为原生 1920 × 1080、24 fps、无声，带画面字幕，附 SRT/VTT；下面两段早期运动示意仍保留。

## 新增六段讲解

- [03 信号链](theory/03-signal-chain.mp4)，18 秒：霍尔电压、ADC、DMA、解算和 RS485。
- [04 基线和零点](theory/04-calibration-zero.mp4)，18 秒：电气偏置和坐标原点分开处理。
- [05 直线结构](structure/05-linear-structure.mp4)，16 秒：固定 PCB、移动滑块、导向与气隙。
- [06 旋转结构](structure/06-rotary-structure.mp4)，16 秒：阵列对中、径向磁铁和转轴。
- [07 主循环](code/07-main-loop.mp4)，18 秒：真实代码摘录、模式选择和两种解算。
- [08 RS485 查询](code/08-rs485-query.mp4)，18 秒：接收缓冲、校验、方向切换与应答。

[六段合集 MP4](explainer-collection.mp4)，104 秒，无声，内含字幕轨；[合集 SRT](explainer-collection.srt) 可直接导入剪辑软件。新片源码、素材依据及重生成方法分别见 [原理](theory/README.md)、[结构](structure/README.md)、[代码](code/README.md)。程序依据仓库 2026-10-27 的快照；结构片是功能示意，不是 STEP 装配分解。

先分别运行这三个目录里的渲染脚本，再运行 `python media/animation/assemble_lessons.py`，可以检查规格、更新 VTT、重新拼接合集并输出章节时间。该步骤会覆盖同名成品；原始镜头不在这个目录中。

## 原有两段运动示意

这两段动画可直接导入剪映、达芬奇或其他剪辑软件，作为实物镜头之间的原理说明。文件为横屏 1920 × 1080、24 fps、H.264 MP4，每段 9 秒，无声音；可按旁白裁切。PNG 是对应动画约第 2 秒的预览图。

| 素材 | 内容 | 建议旁白 |
| --- | --- | --- |
| [01-linear-motion.mp4](01-linear-motion.mp4) | 磁铁沿三颗霍尔滑动，右侧展示三路示意响应 | “它的原理就是利用磁场的变化，单片机采集三颗霍尔的电压，经过校准和计算，就可以估算出磁铁的位置。” |
| [02-rotary-encoder.mp4](02-rotary-encoder.mp4) | 三颗霍尔绕轴排列，径向磁铁旋转，右侧展示理想相位 | “然后是旋转这款，我们把三颗霍尔换成围绕转轴的布局，配合径向充磁的磁铁，再换成角度的计算和校准方法，就可以测量转动角度。” |

两段使用相同的红黑视觉，适合先展示直线样机，再说明与旋转版的联系。视频右下角标明“原理示意 / 非实测波形”：直线曲线是便于讲解的理想形状，旋转相位是理想模型，实际响应取决于磁铁、安装方向、气隙及校准。图中的磁极配色和方位只用于说明充磁方向，具体装配方向应以实物测量确认。动画不表示准确尺寸、磁力线、量程、精度或已经完成实物验证。

实际准备材料：直线版使用 Φ10 × 3 mm 轴向充磁磁铁；旋转版使用 Φ6 × 3 mm 径向充磁磁铁。动画采用示意比例，没有按尺寸绘制。

## 重新生成

`render_animations.py` 是动画的可编辑源文件，使用 Python、Pillow 和 FFmpeg；脚本默认使用 Windows 的微软雅黑字体。安装依赖后在本目录运行：

```powershell
python -m pip install Pillow
python render_animations.py
```

脚本生成并覆盖同目录的两段 MP4 和预览 PNG；需要其他字体时修改脚本开头的 `FONT`、`BOLD` 路径。输出由 1280 × 720 画布放大至 1920 × 1080，横屏画面；如需竖屏版本，建议基于画面重新排版，避免直接裁掉曲线或说明。