avcpp

平均Cpp

FFmpeg 的包装器，简化了 C++ 项目的使用。

目前涵盖下一个功能：

• 核心帮助器和实用程序类（AVFrame -> av::AudioSample 和 av::VideoFrame、AVRational -> av::Rational 等）
• 容器格式和上下文复用和解复用
• 编解码器和编解码器上下文：编码和解码
• 流（AVStream -> av::Stream）
• 过滤器（音频和视频）：从字符串解析，手动将过滤器添加到图表等
• SW 视频和音频重采样器

您可以在此处阅读完整文档。

要求

• FFmpeg >= 2.0
  • libavformat >= 54.xx
  • libavcodec >= 54.xx
  • libavfilter >= 3.xx
  • libavutil >= 51.xx
  • libswscale >= 2.xx
  • libsresample >= 0.xx
  • libpostproc >= 52.xx
• GCC >= 5.0（需要 C++11）
• CMake (> 3.19) 或介子 (> 50.0)

Debian、Ubuntu 19.10 和 Linux Mint 20.x 或更高版本

您应该从 deb-multimedia.org 站点安装 FFmpeg 软件包：

sudo apt-get install libavformat-dev 
                     libavcodec-dev 
                     libavutil-dev 
                     libavfilter-dev 
                     libswscale-dev 
                     libswresample-dev 
                     libpostproc-dev 
                     libavdevice-dev

注 1：我没有在 Debian 上测试构建。

注 2：Debian Wheezy 存储库仅包含 FFmpeg 1.0.8。我仅使用 2.x 测试了构建。因此强烈建议使用 Wheezy 向后移植存储库。

Ubuntu 18.04 和 Linux Mint 19.x

如果您使用的是 Ubuntu bionic 或 Linux Mint 19.x，您应该添加 ffmpeg-4 PPA：

sudo add-apt-repository ppa:jonathonf/ffmpeg-4 -y
sudo apt update && sudo apt upgrade

之后只需安装与上面相同的软件包即可。

---

建造

有两种方法可以使用 CMake 或介子进行编译。默认情况下，介子速度更快，但如果您的项目使用 CMake，这些指令可能更适合集成。

使用 CMake 构建

git clone --recurse-submodules https://github.com/h4tr3d/avcpp.git avcpp-git
cd avcpp-git
mkdir build
cd build
cmake ..
make -j8

如果你的 Git 版本太旧（请参阅 SO 进行澄清），你可以将--recurse-submodules替换为一对git submodule init && git submodule update 。

如果 FFmpeg 位于非标准位置：

cmake -DPC_FFMPEG_LIBRARY_DIRS= < some_path > -DPC_FFMPEG_INCLUDE_DIRS= < some_path > ..

指向安装前缀：

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

安装：

sudo make install

或（用于包装）

sudo make DESTDIR= < some_prefix > install

请参阅 CMake 文档以获取涵盖某些特殊情况的更多详细信息。

用介子构建

在开始构建之前，您必须像这样克隆存储库：

git clone https://github.com/h4tr3d/avcpp.git avcpp-git
cd avcpp-git

IDE 集成：

有各种 IDE 的扩展，例如 VS Code/Codium、Eclipse、Xcode 等。有关更多信息，请参阅文档。

构建项目：

如果您没有安装依赖项，meson 将下载并编译它们。由于 ffmpeg 太大（约 2000 个 c 文件），因此您应该考虑使用包管理器来安装它们。然后您可以使用以下命令构建项目：

mkdir build
cd build
meson ..
meson compile

配置项目：

默认情况下，会编译示例项目和测试。如果您不想这样做，可以使用以下命令禁用它：

meson configure -Dbuild_tests=false
meson configure -Dbuild_samples=false

您可以使用meson --prefix <your/own/prefix>设置安装前缀。要查看所有可用选项，只需键入meson configure和meson configure --help即可获取更多信息。

安装项目：

只需输入meson install ，项目就会安装在配置的前缀中（默认为 /usr/local）。

运行测试：

要运行测试，只需使用meson test 。如果您禁用了测试，这将不会执行任何操作。