avcpp

AvCpp

Wrapper für FFmpeg, der die Verwendung in C++-Projekten vereinfacht.

Derzeit abgedeckte nächste Funktionalität:

• Kernhilfs- und Hilfsklassen (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational usw.)
• Containerformate und Kontexte muxen und demuxen
• Codecs und Codec-Kontexte: Kodierung und Dekodierung
• Streams (AVStream -> av::Stream)
• Filter (Audio und Video): Analyse anhand einer Zeichenfolge, manuelles Hinzufügen von Filtern zum Diagramm und andere
• SW-Video- und Audio-Resampler

Die vollständige Dokumentation können Sie hier lesen.

Anforderungen

• 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 ist erforderlich)
• CMake (> 3,19) oder Meson (> 50,0)

Debian, Ubuntu 19.10 und Linux Mint 20.x oder neuer

Sie sollten FFmpeg-Pakete von der Website deb-multimedia.org installieren:

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

Hinweis 1: Ich habe das Erstellen unter Debian nicht getestet.

Hinweis 2: Das Debian Wheezy-Repo enthält nur FFmpeg 1.0.8. Ich habe den Aufbau nur mit 2.x getestet. Es wird daher dringend empfohlen, das Wheezy-Backport-Repo zu verwenden.

Ubuntu 18.04 und Linux Mint 19.x

Wenn Sie Ubuntu Bionic oder Linux Mint 19.x verwenden, sollten Sie ffmpeg-4 PPA hinzufügen:

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

Danach installieren Sie einfach die gleichen Pakete wie oben.

---

Bauen

Es gibt zwei Möglichkeiten zum Kompilieren, entweder mit CMake oder mit Meson. Standardmäßig ist Meson schneller, aber wenn Ihr Projekt CMake verwendet, sind diese Anweisungen möglicherweise besser für die Integration geeignet.

Erstellen mit CMake

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

Wenn Ihre Git-Version so alt ist (siehe SO zur Klarstellung), können Sie einfach --recurse-submodules durch ein Paar git submodule init && git submodule update ersetzen.

Wenn sich FFmpeg an einem nicht standardmäßigen Ort befindet:

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

So zeigen Sie das Installationspräfix an:

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

Installieren:

sudo make install

oder (zur Verpackung)

sudo make DESTDIR= < some_prefix > install

Weitere Details, die einige Sonderfälle abdecken können, finden Sie in der CMake-Dokumentation.

Bauen mit Mesonen

Bevor Sie mit dem Aufbau beginnen können, müssen Sie das Repository wie folgt klonen:

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

IDE-Integration:

Es gibt Erweiterungen für verschiedene IDEs wie VS Code/Codium, Eclipse, Xcode usw. Weitere Informationen finden Sie in den Dokumenten.

Aufbau des Projekts:

Wenn Sie die Abhängigkeiten nicht installiert haben, lädt Meson sie herunter und kompiliert sie. Da ffmpeg so groß ist (~2000 c-Dateien), sollten Sie erwägen, sie mit Ihrem Paketmanager zu installieren. Anschließend können Sie das Projekt mit den folgenden Befehlen erstellen:

mkdir build
cd build
meson ..
meson compile

Projekt konfigurieren:

Standardmäßig werden die Beispielprojekte und der Test kompiliert. Wenn Sie dies nicht möchten, können Sie es mit den folgenden Befehlen deaktivieren:

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

Sie können das Installationspräfix mit meson --prefix <your/own/prefix> festlegen. Um alle verfügbaren Optionen anzuzeigen, geben Sie einfach meson configure und meson configure --help ein, um weitere Informationen zu erhalten.

Installation des Projekts:

Geben Sie einfach meson install ein und das Projekt wird im konfigurierten Präfix (standardmäßig /usr/local) installiert.

Ausführen der Tests:

Um den Test auszuführen, verwenden Sie einfach meson test . Wenn Sie den Test deaktiviert haben, hat dies keine Auswirkung.