avcpp

AvCpp

C++ プロジェクトからの使用を簡素化する FFmpeg のラッパー。

現在カバーされている次の機能:

• コア ヘルパーおよびユーティリティ クラス (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
  • libswresample >= 0.xx
  • libpostproc >= 52.xx
• GCC >= 5.0 (C++11 が必要)
• CMake (> 3.19) または Meson (> 50.0)

Debian、Ubuntu 19.10、および Linux Mint 20.x 以降

FFmpeg パッケージは deb-multimedia.org サイトからインストールする必要があります。

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 または meson を使用してコンパイルするには 2 つの方法があります。デフォルトでは meson の方が高速ですが、プロジェクトで 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 の統合:

VS Code/Codium、Eclipse、Xcode などのさまざまな IDE の拡張機能があります。詳細については、ドキュメントを参照してください。

プロジェクトを構築する:

依存関係がインストールされていない場合は、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使用するだけです。テストを無効にしている場合は何も行われません。