avcpp

AvCpp

Wrapper para o FFmpeg que simplifica o uso em projetos C++.

Atualmente coberta pela próxima funcionalidade:

• Classes auxiliares e utilitárias principais (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational e assim por diante)
• Formatos de contêiner e contextos de muxagem e demuxação
• Contextos de codecs e codecs: codificação e decodificação
• Fluxos (AVStream -> av::Stream)
• Filtros (áudio e vídeo): análise de string, adição manual de filtros ao gráfico e outros
• Reamostradores SW de vídeo e áudio

Você pode ler a documentação completa aqui.

Requisitos

• FFmpeg >= 2.0
  • formato libav >= 54.xx
  • libavcodec >= 54.xx
  • filtro libav >= 3.xx
  • libavutil >= 51.xx
  • libswscale >= 2.xx
  • libswresample >= 0.xx
  • libpostproc >= 52.xx
• GCC >= 5.0 (C++ 11 é necessário)
• CMake (> 3,19) ou Meson (> 50,0)

Debian, Ubuntu 19.10 e Linux Mint 20.x ou mais recente

Você deve instalar pacotes FFmpeg do site 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: não testei a construção no Debian.

Nota 2: O repositório Debian Wheezy contém apenas FFmpeg 1.0.8. Testei a construção apenas com 2.x. Portanto, é altamente recomendável usar o repositório de back-ports Wheezy.

Ubuntu 18.04 e Linux Mint 19.x

Se você estiver no Ubuntu bionic ou Linux Mint 19.x você deve adicionar ffmpeg-4 PPA:

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

Depois disso basta instalar os mesmos pacotes acima.

---

Construir

Existem duas maneiras de compilar com CMake ou com meson. Por padrão, o meson é mais rápido, mas se o seu projeto usar CMake, essas instruções podem ser melhores para integração.

Construindo com CMake

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

Se a sua versão do Git for tão antiga (consulte o SO para esclarecimentos), você pode simplesmente substituir --recurse-submodules pelo par de git submodule init && git submodule update .

Se o FFmpeg estiver localizado em um local não padrão:

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

Para apontar o prefixo de instalação:

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

Instalar:

sudo make install

ou (para embalagem)

sudo make DESTDIR= < some_prefix > install

Consulte a documentação do CMake para obter mais detalhes que podem abranger alguns casos especiais.

Construindo com méson

Antes de começar a construção, você deve clonar o repositório assim:

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

Integração IDE:

Existem extensões para vários IDEs, como VS Code/Codium, Eclipse, Xcode, etc. Consulte a documentação para obter mais informações.

Construindo o projeto:

Se você não tiver as dependências instaladas, o meson irá baixá-las e compilá-las. Como o ffmpeg é muito grande (cerca de 2.000 arquivos c), você deve considerar usar seu gerenciador de pacotes para instalá-los. Você pode então construir o projeto com os seguintes comandos:

mkdir build
cd build
meson ..
meson compile

Configurando o projeto:

Por padrão, os projetos de amostra e o teste são compilados. Se você não quiser isso, você pode desativá-lo com os seguintes comandos:

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

Você pode definir o prefixo de instalação usando meson --prefix <your/own/prefix> . Para ver todas as opções disponíveis basta digitar meson configure e meson configure --help para obter mais informações.

Instalando o projeto:

Basta digitar meson install e o projeto será instalado no prefixo configurado (/usr/local por padrão).

Executando os testes:

Para executar o teste basta usar meson test . Se você desabilitou o teste, isso não fará nada.