avcpp

AvCpp

غلاف لـ FFmpeg الذي يبسط استخدامه من مشاريع C++.

الوظيفة التالية المغطاة حاليًا:

• فئات المساعدة والأدوات المساعدة الأساسية (AVFrame -> av::AudioSample & av::VideoFrame، AVRational -> av::Rational وما إلى ذلك)
• تنسيقات وسياقات الحاوية muxing وdemuxing
• سياقات برامج الترميز والترميز: التشفير وفك التشفير
• التدفقات (AVStream -> av::Stream)
• المرشحات (الصوت والفيديو): التحليل من السلسلة وإضافة المرشحات يدويًا إلى الرسم البياني وغيرها
• أجهزة إعادة تشكيل الفيديو والصوت SW

يمكنك قراءة الوثائق الكاملة هنا.

متطلبات

• إف إف إم بي إي جي >= 2.0
  • libavformat >= 54.xx
  • libavcodec >= 54.xx
  • libavfilter >= 3.xx
  • ليبافوتيل >= 51.xx
  • libswscale >= 2.xx
  • libswresample >= 0.xx
  • libpostproc >= 52.xx
• دول مجلس التعاون الخليجي >= 5.0 (يتطلب C++11)
• كميك (> 3.19) أو ميسون (> 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: لم أختبر البناء على دبيان.

ملاحظة 2: يحتوي Debian Wheezy repo على FFmpeg 1.0.8 فقط. لقد اختبرت البناء فقط مع 2.x. لذلك نوصي بشدة باستخدام مستودع Wheezy للمنافذ الخلفية.

أوبونتو 18.04 ولينكس منت 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. بشكل افتراضي، يكون الميزون أسرع، ولكن إذا كان مشروعك يستخدم 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

تكامل بيئة التطوير المتكاملة:

هناك امتدادات لمختلف IDEs مثل 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 . إذا قمت بتعطيل الاختبار، فلن يفعل هذا شيئًا.