| FFPROBE-ALL(1) | راهنمای ابزارهای چندرسانهای | FFPROBE-ALL(1) |
نام (NAME)
ffprobe-all - راهنمای کامل کاوشگر و تحلیلگر جریانهای چندرسانهای FFprobe
شرح مختصر (SYNOPSIS)
ffprobe [گزینهها] نشانی_ورودی
توضیحات (DESCRIPTION)
ابزار ffprobe اطلاعات مربوط به استریمها و فایلهای چندرسانهای را گردآوری کرده و آنها را در قالبهای خوانا برای انسان و ماشین چاپ میکند.
به عنوان مثال، میتوان از آن برای بررسی قالب کانتینر مورد استفاده توسط یک جریان چندرسانهای و همچنین قالب و نوع هر یک از استریمهای صوتی، تصویری و متنی موجود در آن استفاده کرد.
اگر یک نشانی اینترنتی یا مسیر فایل به عنوان ورودی مشخص شود، ffprobe تلاش میکند آن را باز کرده و محتوای آن را تحلیل (Probe) کند. در صورتی که فایل باز نشود یا به عنوان یک رسانه معتبر شناسایی نگردد، یک کد خروج مثبت بازگردانده میشود.
خروجی ffprobe به گونهای طراحی شده است که به سادگی توسط اسکریپتها و فیلترهای متنی قابل تجزیه باشد، و از یک یا چند بخش با ساختاری مشخص توسط نویسنده (Writer) انتخابی تشکیل میشود.
گزینهها (OPTIONS)
تمامی گزینههای عددی، چنانچه به نحو دیگری مشخص نشده باشد، یک رشته عددی را به عنوان ورودی میپذیرند که میتواند با پیشوندهای یکای بینالمللی (مانند K، M یا G) همراه باشد.
تعیینکنندههای استریم (Stream specifiers)
برخی گزینهها روی استریمهای خاصی اعمال میشوند. تعیینکنندههای استریم برای مشخص کردن این که کدام استریم هدف گزینه است به کار میروند (مانند a برای صدا، v برای تصویر، s برای زیرنویس).
گزینههای عمومی (Generic options)
- -L, -license
- نمایش مجوز برنامه.
- -h, -?, -help, --help
- نمایش راهنمای ابزار.
- -version
- نمایش نسخه برنامه و کتابخانهها.
- -formats
- نمایش تمامی قالبهای کانتینر در دسترس.
- -codecs
- نمایش تمام کدکهای شناختهشده.
- -decoders
- نمایش دیکودرهای در دسترس.
- -encoders
- نمایش انکودرهای در دسترس.
- -loglevel سطح
- تنظیم سطح گزارشدهی وقایع (quiet, panic, fatal, error, warning, info, verbose, debug).
- عدم چاپ بنر اولیه متنی برنامه.
گزینههای اصلی (Main options)
- -f قالب
- اجبار به استفاده از قالبی مشخص برای ورودی.
- -unit
- نمایش یکای مقادیر چاپشده.
- -prefix
- استفاده از پیشوندهای دهدهی SI برای مقادیر.
- -byte_binary_prefix
- اجبار به استفاده از پیشوندهای دودویی (KiB, MiB, GiB) برای مقادیر بایتی.
- -sexagesimal
- استفاده از فرمت ساعت، دقیقه، ثانیه (HH:MM:SS.MICROSECONDS) برای مقادیر زمانی.
- -pretty
- زیباسازی و قالببندی کاربرپسند مقادیر خروجی (معادل ترکیب -unit -prefix -byte_binary_prefix -sexagesimal).
- -output_format, -of, -print_format نام_نویسنده
- تعیین فرمت چاپ خروجی (مانند default، json، csv، xml، ini، flat).
- -sections
- چاپ ساختار بخشها و مشخصات بخشهای خروجی و خروج از برنامه.
- -select_streams تعیینکننده_استریم
- انتخاب و فیلتر کردن استریمهای مشخص برای نمایش اطلاعات (مانند -select_streams v برای نمایش فقط استریمهای ویدیویی).
- -show_data
- نمایش محتوای بار داده (Payload) به صورت هگزادسیمال و اسکی.
- -show_error
- نمایش اطلاعات خطای مواجهشده در زمان کاوش ورودی.
- -show_format
- نمایش اطلاعات کامل درباره کانتینر و قالب کلی جریان چندرسانهای ورودی.
- -show_entries فهرست_بخشها
- تنظیم دقیق فهرست فیلدها و مدخلهایی که باید چاپ شوند.
- -show_packets
- نمایش اطلاعات جزئی درباره تکتک بستههای داده (Packets) موجود در فایل.
- -show_frames
- نمایش مشخصات تکتک فریمهای ویدیویی، صوتی یا زیرنویس.
- -show_streams
- نمایش اطلاعات تفصیلی تمام استریمهای رسانهای موجود در فایل.
- -show_programs
- نمایش اطلاعات برنامهها و استریمهای وابسته به آنها.
- -show_chapters
- نمایش اطلاعات مربوط به فصلها (Chapters) ذخیرهشده در رسانه.
- -count_frames
- شمارش دقیق تعداد فریمهای موجود در هر استریم با پیمایش کامل فایل.
- -count_packets
- شمارش دقیق تعداد بستههای داده در هر استریم.
- -read_intervals بازه
- خواندن و بررسی تنها بازههای زمانی یا فریمهای مشخصشده از فایل به جای کل فایل.
- -show_pixel_formats
- نمایش اطلاعات تمام قالبهای پیکسلی پشتیبانیشده توسط FFmpeg.
نویسندهها (WRITERS)
نویسنده قالب خروجی مورد استفاده توسط ffprobe را تعیین میکند:
- default
- فرمت پیشفرض متنی مبتنی بر جفتهای کلید=مقدار درون بلوکهای [SECTION] و [/SECTION].
- compact, csv
- خروجی فشرده تکخطی یا مبتنی بر مقادیر جداشده با کاما (CSV).
- flat
- خروجی مسطح خطی مناسب برای تجزیه در اسکریپتهای شل، awk یا پایتون به صورت section.name.key="value".
- ini
- خروجی در قالب ساختار فایلهای پیکربندی INI.
- json
- خروجی شیء ساختاریافته استاندارد JSON مناسب برنامهنویسی وب و پردازش دادهها.
- xml
- خروجی مبتنی بر تگهای سند استاندارد XML.
کد زمانی (TIMECODE)
ابزار ffprobe از استخراج کدهای زمانی (Timecode) موجود در کانتینرها یا استریمهای ویدیویی با گزینه -show_format و -show_streams پشتیبانی میکند.
همچنین ببینید (SEE ALSO)
ffprobe(1), ffmpeg(1), ffplay(1), ffmpeg-utils(1), ffmpeg-scaler(1), ffmpeg-resampler(1), ffmpeg-codecs(1), ffmpeg-bitstream-filters(1), ffmpeg-formats(1), ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)
نویسندگان (AUTHORS)
توسعهدهندگان FFmpeg.
برای اطلاعات نویسندگی به https://git.ffmpeg.org/ffmpeg مراجعه کنید.
| FFmpeg |