avcpp

AvCpp

Envoltorio para FFmpeg que simplifica su uso desde proyectos de C++.

Actualmente se cubre la siguiente funcionalidad:

• Clases principales de ayuda y utilidad (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational, etc.)
• Formatos y contextos de contenedores muxing y demuxing
• Códecs y contextos de códecs: codificación y decodificación
• Secuencias (AVStream -> av::Stream)
• Filtros (audio y vídeo): análisis a partir de cadenas, adición manual de filtros al gráfico y otros
• Remuestreadores de vídeo y audio SW

Puedes leer la documentación completa aquí.

Requisitos

• FFmpeg >= 2.0
  • formato libav >= 54.xx
  • libavcodec >= 54.xx
  • filtro libav >= 3.xx
  • libavutil >= 51.xx
  • escalalibsw>= 2.xx
  • libswresample >= 0.xx
  • libpostproc >= 52.xx
• GCC >= 5.0 (se requiere C++11)
• CMake (> 3.19) o Mesón (> 50.0)

Debian, Ubuntu 19.10 y Linux Mint 20.x o posterior

Debe instalar los paquetes FFmpeg desde el sitio deb-multimedia.org:

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

Nota 1: No probé la compilación en Debian.

Nota 2: El repositorio de Debian Wheezy contiene solo FFmpeg 1.0.8. Probé la construcción solo con 2.x. Por lo tanto, se recomienda encarecidamente utilizar el repositorio de puertos traseros de Wheezy.

Ubuntu 18.04 y Linux Mint 19.x

Si está en Ubuntu bionic o Linux Mint 19.x, debe agregar ffmpeg-4 PPA:

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

Después de eso, simplemente instale los mismos paquetes que el anterior.

---

Construir

Hay dos formas de compilar con CMake o con mesón. De forma predeterminada, meson es más rápido, pero si su proyecto usa CMake, esas instrucciones podrían ser mejores para la integración.

Construyendo con CMake

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

Si su versión de Git es tan antigua (consulte el SO para obtener una aclaración), puede simplemente reemplazar --recurse-submodules con un par de git submodule init && git submodule update .

Si FFmpeg está ubicado en un lugar no estándar:

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

Para señalar el prefijo de instalación:

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

Instalar:

sudo make install

o (para embalaje)

sudo make DESTDIR= < some_prefix > install

Consulte la documentación de CMake para obtener más detalles que pueden cubrir algunos casos especiales.

Construyendo con mesón

Antes de que puedas comenzar con la construcción, debes clonar el repositorio de esta manera:

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

Integración IDE:

Hay extensiones para varios IDE como VS Code/Codium, Eclipse, Xcode, etc. Consulte los documentos para obtener más información.

Construyendo el proyecto:

Si no tiene las dependencias instaladas, meson las descargará y compilará. Debido a que ffmpeg es tan grande (~2000 archivos c), debería considerar usar su administrador de paquetes para instalarlos. Luego puede construir el proyecto con los siguientes comandos:

mkdir build
cd build
meson ..
meson compile

Configurando el proyecto:

De forma predeterminada, se compilan los proyectos de muestra y la prueba. Si no desea esto, puede desactivarlo con los siguientes comandos:

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

Puede configurar el prefijo de instalación usando meson --prefix <your/own/prefix> . Para ver todas las opciones disponibles, simplemente escriba meson configure y meson configure --help para obtener más información.

Instalación del proyecto:

Simplemente escriba meson install y el proyecto se instalará en el prefijo configurado (/usr/local por defecto).

Ejecutando las pruebas:

Para ejecutar la prueba simplemente use meson test . Si deshabilitó la prueba, esto no hará nada.