avcpp

เอวีซีพีพี

Wrapper สำหรับ FFmpeg ที่ทำให้การใช้งานจากโปรเจ็กต์ C++ ง่ายขึ้น

ครอบคลุมฟังก์ชันถัดไปในปัจจุบัน:

• ตัวช่วยหลักและคลาสยูทิลิตี้ (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational และอื่น ๆ )
• รูปแบบคอนเทนเนอร์และบริบท muxing และ demuxing
• บริบทของตัวแปลงสัญญาณและตัวแปลงสัญญาณ: การเข้ารหัสและการถอดรหัส
• สตรีม (AVStream -> av::Stream)
• ตัวกรอง (เสียงและวิดีโอ): การแยกวิเคราะห์จากสตริง การเพิ่มตัวกรองลงในกราฟด้วยตนเอง และอื่นๆ
• SW Video & Audio Resamplers

คุณสามารถอ่านเอกสารฉบับเต็มได้ที่นี่

ความต้องการ

• FFmpeg >= 2.0
  • รูปแบบ libav >= 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 repo มีเพียง FFmpeg 1.0.8 ฉันทดสอบการสร้างด้วย 2.x เท่านั้น ดังนั้นจึงขอแนะนำอย่างยิ่งให้ใช้ repo back-ports ของ 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 ตามค่าเริ่มต้น 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:

มีส่วนขยายสำหรับ IDE ต่างๆ เช่น VS Code/Codium, Eclipse, Xcode ฯลฯ โปรดดูข้อมูลเพิ่มเติมในเอกสาร

กำลังสร้างโครงการ:

หากคุณไม่ได้ติดตั้งการขึ้นต่อกันไว้ meson จะดาวน์โหลดและคอมไพล์มัน เนื่องจาก ffmpeg มีขนาดใหญ่มาก (ไฟล์ประมาณ 2,000 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 หากคุณปิดใช้งานการทดสอบ การดำเนินการนี้จะไม่ทำอะไรเลย