# MPP V1.4.2 完整四语整理与校对记录

## 来源及版本

- 中文源：docs/cn/Common/MPP/Rockchip_Developer_Guide_MPP_CN.pdf，53 页，V1.4.2。
- 英文源：docs/en/Common/MPP/Rockchip_Developer_Guide_MPP_EN.pdf，57 页，V1.4.2。
- 源绝对路径、SHA-256 和页数见仓库 [来源清单](../common-batch-086-090/SOURCE-INVENTORY.json)；工作区 work/common-batch-086-090/inventory.json 另保留提取证据。原 PDF 未修改。
- 中文正文基于中文原稿；英文基于英文原稿，俄文与德文完整译自英文。相同版本号不意味着文字与平台范围完全一致；不按英文静默改写中文。
- 已删除封面日期/密级、免责声明、商标和版权声明段、厂商联系信息、读者对象、文档修订表与重复静态目录。保留技术版本、技术适用信息、代码注释与示例中的作者/提交标识。

## 章节完整性

| 原稿章节 | 完整保留范围 |
| --- | --- |
| 1 MPP 介绍 | 功能、架构各层、软件及硬件平台、支持功能、使用建议 |
| 2 接口设计 | MppBuffer、MppPacket、MppFrame、MppTask、MppCtx、MppApi，结构/流程图和字段表 |
| 3 MPI 接口 | 解码输入输出与控制、三种内存分配模式、编码输入输出与控制、全部 MppEncCfg 参数表、编码关键点 |
| 4 MPP demo | 解码与编码示例、帮助参数、完整 30 帧日志、格式/颜色列表、码率/帧率/量化参数、工具与环境控制 |
| 5 编译与使用 | 源码下载、Android ARM/AArch64 与 Unix/Linux 构建、NDK 范围和脚本路径 |
| 6 FAQ | AArch64 符号问题、原始 ioctl 日志及解释、运行异常分析，保留最后一条回答 |

两种源稿均为 61 个技术标题、22 个提取表块。俄德覆盖全部英文非代码正文与表格，没有以英文段落回退冒充翻译；纯 API、类型、编码格式名称按源保留。保留网站现有目录及四语切换，不在正文另造入口。

## 原图与代码

- 中文原图 44 张；英文原图 43 张，共 87 个独立技术图文件。中文使用 cn- 前缀图，英文/俄文/德文使用 en- 前缀图，后者三个语言的 URL 一致。
- 图像包含系统与数据流示意、结构关系、内存布局，以及代码/命令行帮助/日志截图。保留原图，不使用整页图代替正文。
- 49 个截图的代码/日志另提供可复制转录：中文 25 个、英文 24 个；英俄德共同保留英文截图代码，未翻译代码标识或改参数。
- 原生代码块中文 9 个、英文 17 个；另加截图转录后中文 34 个、英文/俄文/德文 41 个。中文与英文分块方式不完全相同，不强制跨源逐字符相等。
- 英文 p47/p48/p50/p53 与中文 p44/p45/p47/p49 帮助/日志经主代理逐对图像检查，内容一致；完整 30 帧解码/编码日志及码流/颜色列表由独立转录文件保存，未截成摘要。
- 数值、地址、帧数、速度、内存值、API 名称和源码注释按源保留；图旁明确这些是转录及原稿示例，不保证可直接运行。
- 22 张表恢复为可编辑 Markdown 表格，俄德保留表形及技术标识；尖括号占位符转义以避免被 HTML 吞掉，竖线转义避免破坏表格列。图像说明本地化。

## 提取与排版修复

- 修复正文康熙部首/提取异体、视觉换行；中文开头 AV1 与“视频编码”误粘连已分段。
- 逐单元加入来源页标记。注释与表格、代码之间保留空行，防止 Markdown 表格不渲染。
- 独立编号段落转义点号以保留原编号，避免跨图/表/代码后重置为 1。
- <string-value> 等占位符按可显示文本保留，不作为 HTML 标签；代码中的尖括号保持原样。
- p32/33 中文 MppEncCfg 函数声明跨页连续保留；不删末页 FAQ，也不将正文中的灰框说明直接当成省略项。

## 原稿差异与待核事项

1. 中文功能列表没有英文列出的 AVS2/AVS/AVS+，两稿各自保留，不能据此推定所有硬件都有这些能力。
2. 架构内核层与软件平台段落列出的版本范围并非完全相同（部分段落包含 6.1，另一些止于 5.10）。保持原上下文，实际内核/驱动组合必须按目标 BSP 查证。
3. 英文 p32 外部内存模式原句说内存块“enough”时解码器可能卡住，疑似遗漏否定；俄德明确保留并指出矛盾，不悄悄改成已核实技术结论。
4. 英文 p42 对 rkvenc“仅 H.264、仅 RV1109/RV1126”的陈述与现代平台能力不应混为一谈；作为原稿历史描述保留，不能作为当前全平台兼容表。
5. 旧 MPP_ENC_GET_EXTRA_INFO 与新 MPP_ENC_GET_HDR_SYNC 的内存释放/线程安全差异完整保留；源文段落粘连仅断开为两条说明，不统一其调用语义。
6. MPP_DEC_GET_STREAM_COUT、MPP_DEC_GET_VPUMEM_USED_COUT 等名称按源保留，不按英文拼写习惯擅自修 API。
7. 示例路径 ocrean.h264 / ocrean.yuv、错误日志 unknow、示例返回判断和伪代码均按来源保留，不能据拼写猜测修源码。
8. Android NDK 原稿给出 android-ndk-r16b 与 android-ndk-r25c，描述为 Android 14 以下/以上，边界 Android 14 没有清晰定义；不自动补适配结论。
9. 英文 make –j16 原符号为长横线，正文保留并提醒执行前核对，不把原始印刷命令当作已测试脚本。
10. 英文末页 Stack Overflow URL 有换行断裂；已依据中文 unit469 的完整同地址恢复英俄德链接中的 arm64-platforms，不猜测新链接。
11. 源稿旧/新枚举中存在 NV24/NV42 与 NV16/NV61、YUV400SP 与 YUV400 差异，分别保留，不强制统一常量。
12. 英文 p18 / 中文 p16 的 MppFrameFormat 图末尾确有“? end MppFrameFormat ?”异常符号；转录保留原图所示，不把它声称为可编译代码。
13. 英文 table275 的参数位置存在错位疑点，表格按原稿行列保留，复制前应查实际头文件和 SDK，不凭译者推断重排。
14. MPP_ENC_GET_OSD_PLT_CFG 的说明疑似误用 header 描述，HEADER_MODE 描述又涉及 SEI；按源保留这些互相不一致的名称/说明，待 SDK 核验。

## 适配及验证边界

MPP 的源平台列表不等同于所有 ArmSoM 板卡通用支持；需核实具体 SoC 编解码硬件、内核驱动、vcodec_service/DTS、MPP 版本、格式及内存配置。没有执行源文命令，也没有硬件适配或性能验证。日志中 fps、延迟、内存和码率是原厂示例，不是 ArmSoM 实测。

本次合并检查包括翻译映射覆盖、技术标识、表格结构、图片文件/URL、英俄德代码一致性和末章存在性。视觉图检查与截图转录由批次协作完成；本记录不虚称最终组装者重新逐页查看了全部 110 页。

全站构建、HTTP、真实浏览器四语页面、TOC 高亮、窄屏滚动、搜索、canonical/hreflang、sitemap 和 robots 由主代理统一检查。本记录不提前宣称这些检查通过，也不声称已收录。未 commit、push、发布、提交 Search Console 或修改 DNS。