# ffcodec **Repository Path**: klua/ffcodec ## Basic Information - **Project Name**: ffcodec - **Description**: FFmpeg 编解码封装库 - **Primary Language**: Unknown - **License**: LGPL-3.0 - **Default Branch**: trunk - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-21 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ffcodec FFmpeg 编解码封装库 (仅 codec; 不含 demux / mux / 网络). * License: **LGPL-3.0** (see [LICENSE](LICENSE)) * Layout (对齐 **g2de**): `src/` 根仅**导出头**; 实现在子模块; `src_3rdparty/` 第三方 * 裁剪 (对齐 **klb/clip.mk** 口令): `clip.mk` → 自有目录/宏 + FFmpeg **configure** 映射 * 产物: **单一** `lib/libffcodec.a` / `lib/libffcodec.so` (FFmpeg **静态完整并入**; 无 `libav*.so`) * 上游: `src_3rdparty/ffmpeg-9.0.2/` (上游发行包 `ffmpeg-9.0.2.tar.xz`) ## 目录 ``` ffcodec/ src/ # 根仅导出: ffcodec.h + ffcodec_export.h core/ dec/ enc/ # 非导出实现 src_klua/ # klua 插件 libkffcodec (require("kffcodec")) src_3rdparty/ # FFmpeg (configure 裁剪; 静态并入 libffcodec) clip.mk / install.mk lib/ # libffcodec.* + libkffcodec.* tmp/ # ffmpeg-build (中间; 非对外产物) Makefile ``` 安装布局 (对齐 **g2de**): | 安装路径 | 产物 | |----------|------| | `$(PREFIX)/lib/libffcodec.so` | 引擎库 (已含 FFmpeg 静态对象) | | `$(PREFIX)/lib/klua/plugins/libkffcodec.so` | klua plugins (同 `libkg2de.so`) | | `$(PREFIX)/include/ffcodec/` | 导出头 | ## 现状 **桩 API** + **FFmpeg 静态并入**: `open` 仍返回 `NULL` / `FFCODEC_EOPNOTSUPP`; `make` 会先编 FFmpeg **仅 .a** (`--disable-shared`), 再 MRI / whole-archive 并入 `libffcodec`. ## 编译 ```bash make # ffmpeg(static) → libffcodec + libkffcodec make kffcodec # 仅插件 (须已有 libffcodec.so) make MY_CLIP="codec-min" make MY_CLIP="codec-min use-vaapi" make info make ffmpeg # 仅刷新 tmp/ffmpeg-build 静态库 make install # → /usr/local (需权限) make local # → ./install make clean ``` | `MY_CLIP` | 自有 | FFmpeg configure (摘要) | |-----------|------|-------------------------| | (空) | core+dec+enc | 软解 h264/hevc/aac + 软编 aac; 无硬件; **无 shared** | | `codec-min` / `min-core` / `no-all` | core+dec+enc (恒编入); `no-hw` | 同上软解; 无 FFmpeg encoder; 无硬件 | | `use-vaapi` | 隐含 min 后加回 hw | `--enable-vaapi` + h264/hevc hwaccel | | `use-d3d11va` / `use-dxva2` / `use-cuda` | 同上 | 对应 Win/NVIDIA 开关 | | `no-enc` | 不影响自有模块 (API 恒可用) | 关闭 FFmpeg encoder | **禁止**把 `src_3rdparty/ffmpeg-9.0.2` 当 zlib 扫进 `MY_DIRS`. **禁止**产出 / 安装 FFmpeg `libav*.so` / `libsw*.so`. **禁止**安装 FFmpeg 头: 对外仅 `src/ffcodec.h` / `ffcodec_export.h` 与 LUA 接口 (kffcodec). ## 边界 | 做 | 不做 | |----|------| | H.264 / H.265 / AAC 编解码门面 | 容器 (MP4/FLV) | | clip 口令 + configure 裁剪 | 手删 libavcodec 当主裁剪 | | 静态并入单一 libffcodec | 运行时依赖 libavcodec.so | | 与 klb `libavutil` 子集隔离 | 覆盖 `klb/src_c/libavutil` |