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 。如果您停用了測試，這將不會執行任何操作。