# 结构与装配：两段讲解素材

这两段先把“哪些固定、哪些运动”讲清楚，再说明导向、对中和气隙。红黑配色与已有原理动画一致，可直接插入项目介绍，也可以单独配音发布。

成片均为 **16 秒、1920 × 1080、24 fps、H.264、无声 MP4**。画面中的字形、线条和图形直接绘制到 1080p 画布，没有先生成低分辨率位图再放大。底部已有简短讲解字幕，另外提供 UTF-8 SRT，方便导入剪辑软件后修改时间或配音。

## 05 · 直线这款，哪些固定、哪些跟着动

- [视频](05-linear-structure.mp4)
- [预览图](05-linear-structure-preview.png)
- [SRT 字幕](05-linear-structure.srt)

前面先把底座、PCB、滑块和磁铁的功能关系摆出来，后半段滑块做往返运动。PCB 和三颗霍尔保持固定，磁铁随滑块经过 U1、U2、U4；图中同时标出导向和气隙。

旁白按四段各约四秒准备：

1. 先看直线这款，PCB 固定在底座上。
2. 磁铁跟着滑块移动。
3. 通过导向，尽量保持磁铁姿态和气隙不变。
4. 然后移动一下滑块，看它怎样经过三颗霍尔。

视频适合接在直线样机全景之后，先讲完结构，再切到三路信号和位置读数。对应 [PCB 与机械](../../../wiki/PCB-and-Mechanics.md)、[复刻清单](../../../wiki/Replication-Checklist.md)。

## 06 · 旋转这款，先对中，再固定气隙

- [视频](06-rotary-structure.mp4)
- [预览图](06-rotary-structure-preview.png)
- [SRT 字幕](06-rotary-structure.srt)

左边俯视图表现磁铁与阵列中心对齐，然后磁铁随轴转动；右边侧视图表现固定相对高度和气隙。俯视和侧视是同一功能关系的两个示意视图，不是从实际 STEP 投影而来。

旁白：

1. 旋转这款，先让转轴、磁铁和阵列中心对齐。
2. 再固定磁铁高度，保持气隙。
3. 转轴带着径向充磁磁铁转动，PCB 保持不动。
4. 装好后先看三路信号，再做一圈校准。

视频适合接旋转样机的磁铁、转轴近景，再切到三相示意或实测原码。三点围绕轴线排列并不能单独保证实际三路信号相差 120°；需要检查磁铁方向、器件朝向与实测波形，再做对应校准。

## 与原始模型、图纸的关系

画面明确标有 **“功能结构示意 · 非 STEP 装配分解 · 非尺寸图”**。支架、导向、滑块、轴和底座使用通用图形表示，没有把它们当作仓库模型中已经确认的独立零件，也没有给出未经核实的气隙、配合、公差或机械尺寸。

制作前检查了仓库中的两份 STEP：

- [HALLPOS v1.step](../../../mechanical/models/HALLPOS%20v1.step)
- [ENCODER v2.step](../../../mechanical/models/ENCODER%20v2.step)

这两份文件包含实体或装配信息，但本片未对它们作 CAD 解析、零件识别或真实装配分解。需要打印与核对实际几何时使用原 STEP；不要按动画截屏反推模型尺寸。

磁铁规格沿用项目维护者提供的信息：直线版 **Φ10 × 3 mm、轴向充磁**；旋转版 **Φ6 × 3 mm、径向充磁**。图里的磁极颜色和相对比例仅说明充磁与运动关系，实际安装方向仍按对应图纸和测量确认。动画没有磁场有限元、真实运动台数据、精度或量程验证。

## 重新生成

源文件是 [render_structure.py](render_structure.py)。需要 Python、Pillow、FFmpeg；运行：

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

只生成其中一段可加 `--clip linear` 或 `--clip rotary`。默认字体为 Windows 微软雅黑；其他系统通过 `HALL_FONT`、`HALL_FONT_BOLD` 环境变量指定可显示中文的字体文件。

编码先写临时 MP4，完整解码检查成功后才替换成片，避免读取到正在写入的文件。画面和 SRT 来自同一组时间段；修改旁白时同步调整源文件中的字幕及动画阶段。