Index

MLT 学习资源索引

采集日期 2026-10-21。目标：学习 MLT framework（Kdenlive / Shotcut 底层多媒体引擎）。 本目录 /workspace/mlt/ 汇总了官方文档镜像（中英）+ 按优先级抓取的 GitHub 权威源。

目录结构

/workspace/mlt/
├── mirror/                wget 镜像的官方 docs 站原始 HTML（www.mltframework.org/docs，34 页）
├── docs_en/               官方 /docs 正文提取（英文 Markdown，33 篇）
├── docs_zh/               官方 /docs 中文翻译（33 篇，代码/命令/属性名保留原文）
├── github_资源探查.md      GitHub 官方/社区资源评估清单
├── tools/extract_docs.py  HTML→Markdown 提取脚本
└── resources/             按优先级抓取的 GitHub 源（下列）

resources/ 五源（按学习优先级）

优先级目录内容语言参考价值
1mlt_web/官方文档真源。developers/（Framework.md、MltXml.md、mlt++.md 等）；plugins/（2169 个服务手册，含 ConsumerAvformat 278KB）→ 核心 255 篇已中译到 plugins_zh/；root（FAQ/Features/Documentation）EN+ZH高
2mlt_repo/demo/~30 个可运行 melt 脚本 + README（jcut/lcut/voiceover/ticker/watermark…），学 melt/XML 组装最快路径EN高
3kdenlive_devdocs/dev-docs/（EN）+ dev-docs_zh/（中译）：mlt-intro、fileformat、architecture、build、coding、packaging、contributingEN+ZH高
4shotcut_filtersets/filter-sets/5 个真实 MLT XML 滤镜片段（Glow/Soft Focus/Obscure/Titler）XML高
5mlt_repo/docs/melt.1、Doxygenmelt CLI 权威 man；API 签名在线查 mltframework.org/doxygen（7.42.0）EN高
6mlt_repo/src/tests/18 个测试套件，验证 producer/playlist/tractor/animation/xml 语义C高
7mlt-python/gpapp 纯 Python 读写 Kdenlive 兼容 MLT XML，含 MLT_XML.md + examplesEN+Py中高

mlt_repo 附赠：src/examples/play.cpp（28 行最小播放器）、src/mlt++/（C++ 封装 ~40 类）、src/swig/python/（play.py、switcher.py、python_bindings.dox，模块名 mlt7）、NEWS（125KB 逐版 API 变更）。

建议阅读顺序（学习路径）

  1. 概念打底：kdenlive_devdocs/dev-docs_zh/mlt-intro.md → docs_zh/framework.md（框架设计路线图）
  2. XML 格式：kdenlive_devdocs/dev-docs_zh/fileformat.md → docs_zh/mltxml.md → mlt_web/developers/MltXml.md（权威源）
  3. 动手 melt：mlt_repo/demo/README + 逐个 mlt_* 脚本 → docs_zh/melt.md → mlt_repo/docs/melt.1
  4. 写代码：docs_zh/mlt++.md → mlt_repo/src/examples/play.cpp → mlt_repo/src/mlt++/ 头文件
  5. Python：mlt-python/MLT_XML.md（不碰 C API 走 XML 捷径）→ mlt_repo/src/swig/python/play.py（mlt7 模块）
  6. 查证语义/签名：mlt_repo/src/tests/ 对拍 → Doxygen 在线查签名 → mlt_web/plugins/ 查具体服务的属性
  7. 真实工程参考：shotcut_filtersets/filter-sets/ 看滤镜 XML 怎么写

已知注意事项

  • Framework.md / MltXml.md：mlt_web 权威源与 docs_zh 已有中译内容结构一致，无需重译；如需比对以 mlt_web/developers/*.md 为准。
  • docs_zh/mvcp.md 与 libmvcp.md：原文整篇包在代码围栏内，翻译选择了"译散文、留协议行"，如需严格不译可回退。
  • docs_zh/unittests.md：内容过时（仍写 qmake/2013 输出，现仓库已改 CMake），参考 mlt_repo/src/tests/CMakeLists.txt 为准。
  • mlt_web/plugins/：核心 255 篇已中译到 plugins_zh/（5 分类索引 + ConsumerAvformat/ProducerAvformat/PluginsFilters + 全部 MLT 原生 producers/consumers/filters/transitions/links）。排除未译：FilterLadspa-*、FilterOpenfx-net-*、avfilter.*、frei0r-*、movit-* 等自动生成参数 dump（约 1900 篇，工具书性质、性价比低）—— 按需再补。
    • 注：巨型文件按小节切块分译后拼合，个别块对 type:/description: 等字段标签中英文不统一（属性名一律保留英文，仅标签风格差异），属外观问题、无内容缺失。
  • mlt_web 站点资产（图片等，占 29M 大头）按你要求全部保留（图片是看效果的关键，未精简）。
GitHub目录