مشخص‌کننده‌های استریم (Stream specifiers)

برخی گزینه‌ها برای هر جریان به طور جداگانه اعمال می‌شوند، مانند نرخ بیت (bitrate) یا کدک. مشخص‌کننده‌های استریم برای تعیین دقیق جریان یا جریان‌هایی که یک گزینه مشخص به آن‌ها تعلق دارد به کار می‌روند.

مشخص‌کننده استریم رشته‌ای است که معمولاً به نام گزینه چسبانده شده و با دونقطه از آن جدا می‌شود. برای مثال "-codec:a:1 ac3" حاوی مشخص‌کننده جریان "a:1" است که با دومین جریان صوتی مطابقت دارد؛ بنابراین کدک ac3 را برای دومین جریان صوتی انتخاب می‌کند.

یک مشخص‌کننده استریم می‌تواند با چندین جریان مطابقت داشته باشد تا آن گزینه برای همه آن‌ها اعمال شود. برای مثال مشخص‌کننده استریم در "-b:a 128k" با تمام جریان‌های صوتی مطابقت دارد.

یک مشخص‌کننده استریم خالی با تمام جریان‌ها مطابقت دارد. برای نمونه، "-codec copy"; یا "-codec: copy" تمام جریان‌ها را بدون بازکدگذاری کپی می‌کند.

حالت‌های ممکن مشخص‌کننده‌های استریم عبارتند از:

stream_index

با جریانی که دارای این شناسه (ایندکس) است مطابقت می‌یابد. به عنوان مثال "-threads:1 4" تعداد نخ‌های پردازشی دومین جریان را روی ۴ تنظیم می‌کند. اگر stream_index به عنوان یک مشخص‌کننده جریان اضافی به کار رود (به پایین نگاه کنید)، جریان شماره stream_index را از میان جریان‌های منطبق انتخاب می‌کند. شماره‌گذاری جریان‌ها بر اساس ترتیب جریان‌های شناسایی‌شده توسط libavformat انجام می‌شود، مگر این که یک مشخص‌کننده گروه جریان یا شناسه برنامه نیز تعیین شده باشد که در این صورت بر اساس ترتیب جریان‌ها در آن گروه یا برنامه خواهد بود.

stream_type[:additional_stream_specifier]

پارامتر stream_type یکی از موارد زیر است: 'v' یا 'V' برای ویدیو، 'a' برای صدا، 's' برای زیرنویس، 'd' برای داده و 't' برای پیوست‌ها. مشخصه 'v' با تمام جریان‌های ویدیویی مطابقت دارد، در حالی که 'V' تنها با جریان‌های ویدیویی که تصویر پیوست‌شده، تصویر بندانگشتی ویدیویی یا تصویر روی جلد نیستند مطابقت می‌یابد. اگر additional_stream_specifier استفاده شود، با جریان‌هایی مطابقت می‌یابد که هم دارای این نوع باشند و هم با additional_stream_specifier تطابق داشته باشند. در غیر این صورت، با تمامی جریان‌های نوع مشخص‌شده مطابقت دارد.

g:group_specifier[:additional_stream_specifier]

با جریان‌هایی مطابقت می‌یابد که در گروه دارای مشخص‌کننده group_specifier قرار دارند. اگر additional_stream_specifier به کار رود، با جریان‌هایی مطابقت می‌یابد که هم بخشی از گروه بوده و هم با additional_stream_specifier مطابقت داشته باشند. group_specifier می‌تواند یکی از موارد زیر باشد:

p:program_id[:additional_stream_specifier]

با جریان‌هایی مطابقت می‌یابد که در برنامه با شناسه program_id قرار دارند. اگر additional_stream_specifier به کار رود، با جریان‌هایی که هم بخشی از برنامه بوده و هم با additional_stream_specifier تطابق دارند مطابقت خواهد یافت.

#stream_id or i:stream_id

تطابق با جریان بر اساس شناسه جریان (مانند PID در کانتینر MPEG-TS).

m:key[:value]

با جریان‌هایی مطابقت می‌یابد که تگ متادیتای key با مقدار مشخص‌شده را دارا باشند. اگر value مشخص نشده باشد، با جریان‌هایی که شامل تگ مذکور با هر مقداری باشند تطابق پیدا می‌کند. نویسه دونقطه ':' در key یا value باید با بک‌اسلش اسکیپ شود.

disp:dispositions[:additional_stream_specifier]

با جریان‌هایی که دارای ویژگی‌های انتشار (disposition) داده‌شده باشند مطابقت می‌یابد. پارامتر dispositions فهرستی از یک یا چند ویژگی انتشار (به شکلی که توسط گزینه -dispositions چاپ می‌شود) است که با '+' به هم متصل شده‌اند.

u

با جریان‌های دارای پیکربندی قابل استفاده مطابقت می‌یابد؛ کدک باید تعریف شده باشد و اطلاعات اساسی مانند ابعاد ویدیو یا نرخ نمونه‌برداری صدا باید حضور داشته باشند.

توجه داشته باشید که در ffmpeg، تطابق بر اساس متادیتا تنها برای فایل‌های ورودی به درستی کار خواهد کرد.

گزینه‌های عمومی (Generic options)

این گزینه‌ها میان تمامی ابزارهای ff* مشترک هستند.

-L, -license

نمایش مجوز برنامه (License).

-h, -?, -help, --help [arg]

نمایش راهنما. یک پارامتر اختیاری می‌تواند برای چاپ راهنما درباره یک مورد مشخص تعیین شود. اگر هیچ آرگومانی مشخص نشود، تنها گزینه‌های پایه (غیر پیشرفته) ابزار نمایش داده می‌شوند.

مقادیر ممکن برای arg عبارتند از:

-version

نمایش نسخه برنامه.

-buildconf

نمایش پیکربندی بیلد برنامه، یک گزینه در هر خط.

-formats

نمایش قالب‌های موجود (شامل دستگاه‌ها).

-demuxers

نمایش دی‌ماکسرهای در دسترس.

-muxers

نمایش ماکسرهای در دسترس.

-devices

نمایش دستگاه‌های در دسترس.

-codecs

نمایش تمامی کدک‌های شناخته‌شده برای کتابخانه libavcodec.

توجه داشته باشید که واژه 'codec' در سراسر این مستندات به عنوان یک میان‌بر برای آنچه که به شکل دقیق‌تر قالب بیت‌استریم رسانه‌ای نامیده می‌شود، به کار می‌رود.

-decoders

نمایش دیکودرهای در دسترس.

-encoders

نمایش تمامی انکودرهای در دسترس.

-bsfs

نمایش فیلترهای بیت‌استریم موجود.

-protocols

نمایش پروتکل‌های موجود.

-filters

نمایش فیلترهای موجود در libavfilter.

-pix_fmts

نمایش قالب‌های پیکسلی موجود.

-sample_fmts

نمایش قالب‌های نمونه (sample formats) موجود.

-layouts

نمایش نام کانال‌ها و چیدمان‌های استاندارد کانال‌های صوتی.

-dispositions

نمایش ویژگی‌های انتشار استریم (dispositions).

-colors

نمایش نام رنگ‌های شناخته‌شده.

-sources device[,opt1=val1[,opt2=val2]...]

نمایش منابع شناسایی‌شده خودکار دستگاه ورودی. برخی دستگاه‌ها ممکن است نام‌های منبع وابسته به سیستم را ارائه دهند که به صورت خودکار شناسایی نمی‌شوند. نمی‌توان فرض کرد که فهرست برگردانده‌شده همیشه کامل است.

ffmpeg -sources pulse,server=192.168.0.4

-sinks device[,opt1=val1[,opt2=val2]...]

نمایش گیرنده‌های (sinks) شناسایی‌شده خودکار دستگاه خروجی. برخی دستگاه‌ها ممکن است نام‌های گیرنده وابسته به سیستم را ارائه دهند که به صورت خودکار شناسایی نمی‌شوند. نمی‌توان فرض کرد که فهرست برگردانده‌شده همیشه کامل است.

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [flags+]loglevel | -v [flags+]loglevel

تنظیم سطح گزارش‌دهی پیام‌ها (log level) و پرچم‌های مورد استفاده کتابخانه.

پیشوند اختیاری flags می‌تواند شامل مقادیر زیر باشد:

ffmpeg -loglevel repeat+level+verbose -i input output

ffmpeg [...] -loglevel +repeat

-report

تخلیه کامل خط فرمان و خروجی لاگ در فایلی با نام "program-YYYYMMDD-HHMMSS.log" در دایرکتوری جاری. این فایل می‌تواند برای گزارش اشکالات و باگ‌ها بسیار مفید باشد. این گزینه همچنین به طور ضمنی "-loglevel debug"; را فعال می‌کند.

تنظیم متغیر محیطی FFREPORT به هر مقداری دارای اثری مشابه است. اگر مقدار آن دنباله‌ای از جفت‌های کلید=مقدار جداشده با ':' باشد، این گزینه‌ها بر گزارش اثر خواهند گذاشت؛ اگر مقادیر گزینه‌ها شامل نویسه‌های ویژه یا نویسه جداکننده گزینه‌ها یعنی ':' باشند باید اسکیپ شوند (بخش ``Quoting and escaping'' را در راهنمای ffmpeg-utils ببینید).

گزینه‌های زیر شناخته‌شده هستند:

FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

-hide_banner

جلوگیری از چاپ بنر برنامه.

تمام ابزارهای FFmpeg معمولاً یک اعلان کپی‌رایت، گزینه‌های ساخت و نسخه کتابخانه‌ها را نمایش می‌دهند. این گزینه می‌تواند برای جلوگیری از چاپ این اطلاعات استفاده شود.

-cpuflags flags (global)

امکان تنظیم و پاک‌سازی پرچم‌های پردازنده (CPU) را فراهم می‌سازد. این گزینه برای آزمایش در نظر گرفته شده است. از آن استفاده نکنید مگر این که دقیقاً بدانید چه کاری انجام می‌دهید.

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

پرچم‌های ممکن برای این گزینه عبارتند از:

-cpucount count (global)

بازنویسی مقدار تشخیص تعداد پردازنده‌ها. این گزینه برای اهداف آزمایشی است. از آن استفاده نکنید مگر این که بدانید چه کاری انجام می‌دهید.

ffmpeg -cpucount 2

-max_alloc bytes

تنظیم حداکثر محدودیت اندازه برای تخصیص یک بلوک در حافظه هیپ (heap) توسط خانواده توابع malloc مربوط به ffmpeg. هنگام استفاده از این گزینه احتیاط فوق‌العاده به خرج دهید. اگر عواقب کامل انجام این کار را درک نمی‌کنید از آن استفاده ننمایید. مقدار پیش‌فرض INT_MAX است.

AVOptions

این گزینه‌ها مستقیماً توسط کتابخانه‌های libavformat، libavdevice و libavcodec ارائه می‌شوند. برای مشاهده فهرست AVOptions موجود، از گزینه -help استفاده کنید. آن‌ها به دو دسته تقسیم می‌شوند:

generic

این گزینه‌ها می‌توانند برای هر کانتینر، کدک یا دستگاهی تنظیم شوند. گزینه‌های عمومی ذیل گزینه‌های AVFormatContext برای کانتینرها/دستگاه‌ها و ذیل گزینه‌های AVCodecContext برای کدک‌ها فهرست شده‌اند.

private

این گزینه‌ها مختص کانتینر، دستگاه یا کدک ارائه‌شده هستند. گزینه‌های اختصاصی ذیل کانتینرها/دستگاه‌ها/کدک‌های متناظر با خود فهرست شده‌اند.

برای نمونه، جهت نوشتن یک سربرگ ID3v2.3 به جای ID3v2.4 پیش‌فرض در یک فایل MP3، از گزینه اختصاصی id3v2_version در ماکسر MP3 استفاده کنید:

ffmpeg -i input.flac -id3v2_version 3 out.mp3

تمامی AVOptions کدک برای هر جریان به طور جداگانه هستند، و بنابراین یک مشخص‌کننده استریم باید به آن‌ها متصل شود:

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

در مثال بالا، یک جریان صوتی چندکاناله دوبار برای خروجی مپ شده است. نمونه اول با کدک ac3 و نرخ بیت 640k کدگذاری می‌شود. نمونه دوم به ۲ کانال داون‌میکس شده و با کدک aac کدگذاری می‌گردد. نرخ بیت 128k برای آن با استفاده از ایندکس مطلق جریان خروجی مشخص شده است.

توجه: نحو -nooption نمی‌تواند برای AVOptions بولی استفاده شود، از -option 0/-option 1 استفاده نمایید.

توجه: روش قدیمی و مستندنشده مشخص کردن AVOptions به ازای هر جریان با افزودن پیشوند v/a/s به ابتدای نام گزینه منسوخ شده است و به زودی حذف خواهد شد.

گزینه‌های اصلی (Main options)

-f format

اجبار به استفاده از یک قالب خاص.

-unit

نمایش یکای مقادیر نشان‌داده‌شده.

-prefix

استفاده از پیشوندهای یکای SI برای مقادیر نمایش‌داده‌شده. مگر در حالتی که از گزینه "-byte_binary_prefix" استفاده شود، تمامی پیشوندها دهدهی (decimal) هستند.

-byte_binary_prefix

اجبار به استفاده از پیشوندهای دودویی (باینری) برای مقادیر بر حسب بایت.

-sexagesimal

استفاده از قالب شصت‌گانی HH:MM:SS.MICROSECONDS برای مقادیر زمانی.

-pretty

زیباسازی و خواناتر کردن قالب مقادیر نمایش‌داده‌شده؛ این معادل گزینه‌های "-unit -prefix -byte_binary_prefix -sexagesimal" است.

-output_format, -of, -print_format writer_name[=writer_options]

تنظیم قالب چاپ خروجی.

پارامتر writer_name نام نویسنده خروجی را مشخص می‌کند، و writer_options گزینه‌هایی را که باید به نویسنده ارسال شوند تعیین می‌نماید.

برای نمونه، جهت چاپ خروجی در قالب JSON مشخص کنید:

-output_format json

برای جزئیات بیشتر درباره قالب‌های چاپ خروجی موجود، بخش نویسنده‌ها (Writers) را در ادامه ببینید.

-sections

چاپ ساختار بخش‌ها و اطلاعات مربوط به بخش‌ها و سپس خروج از برنامه. خروجی برای تجزیه توسط ماشین طراحی نشده است.

-select_streams stream_specifier

انتخاب تنها جریان‌های مشخص‌شده توسط stream_specifier. این گزینه تنها بر گزینه‌های مرتبط با جریان‌ها (مانند "show_streams"، "show_packets" و غیره) اثر می‌گذارد.

برای مثال جهت نمایش فقط جریان‌های صوتی، می‌توانید از دستور زیر استفاده کنید:

ffprobe -show_streams -select_streams a INPUT

برای نمایش تنها بسته‌های ویدیویی متعلق به جریان ویدیویی با شناسه ۱:

ffprobe -show_packets -select_streams v:1 INPUT

-show_data

نمایش داده‌های بار اصلی (payload)، به صورت تخلیه (dump) هگزادسیمال و اسکی (قالب‌های دیگر را می‌توان با استفاده از -data_dump_format انتخاب کرد). در ترکیب با گزینه -show_packets، داده‌های بسته‌ها را تخلیه می‌کند. در ترکیب با گزینه -show_streams، داده‌های جانبی و اضافی کدک (extradata) را تخلیه می‌نماید.

تخلیه داده‌ها به عنوان فیلد "data" چاپ می‌شود و ممکن است شامل خطوط جدید باشد.

-show_data_hash algorithm

نمایش هش داده‌های بار اصلی (payload)، برای بسته‌ها همراه با -show_packets و برای داده‌های جانبی کدک همراه با -show_streams.

-data_dump_format format

انتخاب قالب مورد استفاده برای تخلیه داده‌های فعال‌شده با گزینه -show_data. پیش‌فرض "xxd" است که یک قالب هگز‌دامپ سازگار با برنامه مشهور xxd است. همچنین از "base64" نیز پشتیبانی می‌شود.

-show_error

نمایش اطلاعات درباره خطای رخ‌داده هنگام تلاش برای بررسی ورودی.

اطلاعات خطا در بخشی با نام "ERROR" چاپ می‌شود.

-show_format

نمایش اطلاعات درباره قالب کانتینر جریان چندرسانه‌ای ورودی.

تمامی اطلاعات قالب کانتینر در بخشی با نام "FORMAT" چاپ می‌شود.

-show_entries section_entries

تنظیم فهرست ورودی‌ها برای نمایش.

ورودی‌ها بر اساس نحو زیر مشخص می‌شوند: section_entries شامل فهرستی از ورودی‌های بخش است که با ":" از یکدیگر جدا شده‌اند. هر ورودی بخش از یک نام بخش (یا نام یکتا)، و به صورت اختیاری فهرستی از ورودی‌های محلی آن بخش که با "," جدا شده‌اند تشکیل شده است.

اگر نام بخش مشخص شود اما بدون "=" بیاید، تمام ورودی‌ها در خروجی همراه با تمام بخش‌های درون آن چاپ می‌شوند. در غیر این صورت تنها ورودی‌های مشخص‌شده در فهرست ورودی‌های بخش محلی چاپ خواهند شد. به ویژه اگر "=" مشخص شده باشد اما فهرست ورودی‌های محلی خالی باشد، هیچ ورودی برای آن بخش نشان داده نخواهد شد.

توجه داشته باشید که ترتیب مشخص کردن ورودی‌های بخش محلی در خروجی رعایت نمی‌شود و ترتیب نمایش معمول حفظ خواهد شد.

نحو صوری به صورت زیر است:

<LOCAL_SECTION_ENTRIES> ::= <SECTION_ENTRY_NAME>[,<LOCAL_SECTION_ENTRIES>]
<SECTION_ENTRY>         ::= <SECTION_NAME>[=[<LOCAL_SECTION_ENTRIES>]]
<SECTION_ENTRIES>       ::= <SECTION_ENTRY>[:<SECTION_ENTRIES>]

برای نمونه، جهت نمایش تنها ایندکس و نوع هر استریم، و همچنین زمان PTS، زمان مدت، و ایندکس جریان بسته‌ها، می‌توانید این آرگومان را مشخص کنید:

packet=pts_time,duration_time,stream_index : stream=index,codec_type

جهت نمایش تمام ورودی‌های بخش "format"، اما تنها نوع کدک در بخش "stream"، این آرگومان را مشخص کنید:

format : stream=codec_type

برای نمایش تمامی تگ‌ها در بخش‌های stream و format:

stream_tags : format_tags

جهت نمایش تنها تگ "title" (در صورت موجود بودن) در بخش‌های stream:

stream_tags=title

-show_packets

نمایش اطلاعات مربوط به هر یک از بسته‌های موجود در جریان چندرسانه‌ای ورودی.

اطلاعات مربوط به هر بسته به صورت مجزا در بخشی اختصاصی با نام "PACKET" چاپ می‌شود.

-show_frames

نمایش اطلاعات مربوط به هر یک از فریم‌ها و زیرنویس‌های موجود در جریان چندرسانه‌ای ورودی.

اطلاعات برای هر فریم مجزا در بخشی اختصاصی با نام "FRAME" یا "SUBTITLE" چاپ می‌شود.

-show_log loglevel

نمایش اطلاعات گزارش‌گیری (log) دیکودر درباره هر فریم بر اساس مقدار تنظیم‌شده در loglevel (به "-loglevel" نگاه کنید). این گزینه نیازمند "-show_frames" است.

اطلاعات هر پیام لاگ در بخشی اختصاصی با نام "LOG" چاپ می‌شود.

-show_streams

نمایش اطلاعات مربوط به هر یک از جریان‌های رسانه‌ای موجود در جریان چندرسانه‌ای ورودی.

اطلاعات هر جریان رسانه‌ای در بخشی اختصاصی با نام "STREAM" چاپ می‌شود.

-show_programs

نمایش اطلاعات مربوط به برنامه‌ها و جریان‌های آن‌ها موجود در جریان چندرسانه‌ای ورودی.

اطلاعات هر جریان رسانه‌ای در بخشی اختصاصی با نام "PROGRAM_STREAM" چاپ می‌شود.

-show_stream_groups

نمایش اطلاعات درباره گروه‌های جریان و جریان‌های آن‌ها موجود در جریان چندرسانه‌ای ورودی.

اطلاعات هر جریان رسانه‌ای در بخشی اختصاصی با نام "STREAM_GROUP_STREAM" چاپ می‌شود.

-show_chapters

نمایش اطلاعات درباره فصل‌های (chapters) ذخیره‌شده در قالب.

هر فصل در بخشی اختصاصی با نام "CHAPTER" چاپ می‌شود.

-count_frames

شمارش تعداد فریم‌ها در هر جریان و گزارش آن در بخش متناظر با همان جریان.

-count_packets

شمارش تعداد بسته‌ها در هر جریان و گزارش آن در بخش متناظر با همان جریان.

-read_intervals read_intervals

خواندن تنها بازه‌های زمانی مشخص‌شده. آرگومان read_intervals باید دنباله‌ای از مشخصات بازه باشد که با "," از یکدیگر جدا شده‌اند. ffprobe به نقطه شروع بازه پرش (seek) می‌کند و خواندن را از آنجا ادامه خواهد داد.

هر بازه با دو بخش اختیاری مشخص می‌شود که با "%" از هم جدا می‌شوند.

بخش نخست نقطه شروع بازه را تعیین می‌کند. این بخش به صورت یک موقعیت مطلق یا در صورتی که با نویسه "+" شروع شود به عنوان آفست نسبی از موقعیت فعلی تفسیر می‌گردد. اگر بخش اول مشخص نشود، هنگام خواندن این بازه هیچ پرشی انجام نخواهد گرفت.

بخش دوم نقطه پایان بازه را تعیین می‌کند. این بخش به صورت یک موقعیت مطلق یا در صورتی که با نویسه "+" آغاز شود به عنوان آفست نسبی از موقعیت جاری تفسیر می‌شود. اگر مشخصات آفست با "#" شروع شود، به عنوان تعداد بسته‌هایی که باید از ابتدای بازه خوانده شوند (بدون احتساب بسته‌های تخلیه) تفسیر خواهد شد. در صورتی که بخش دوم مشخص نشود، برنامه تا انتهای ورودی را خواهد خواند.

توجه داشته باشید که عمل پرش (seeking) دقیق نیست، از این رو نقطه شروع واقعی بازه ممکن است با موقعیت مشخص‌شده متفاوت باشد. همچنین هنگامی که مدت‌زمان بازه مشخص می‌شود، زمان پایان مطلق با افزودن مدت به نقطه شروع بازه که با پرش در فایل به دست آمده محاسبه خواهد شد، نه با افزودن به مقدار شروع مشخص‌شده.

نحو صوری به صورت زیر است:

<INTERVAL>  ::= [<START>|+<START_OFFSET>][%[<END>|+<END_OFFSET>]]
<INTERVALS> ::= <INTERVAL>[,<INTERVALS>]

در ادامه چند مثال آمده است:

-show_private_data, -private

نمایش داده‌های خصوصی، یعنی داده‌هایی که وابسته به قالب عنصر خاص نمایش‌داده‌شده هستند. این گزینه به طور پیش‌فرض فعال است، اما ممکن است برای کاربردهای خاص نیاز به غیرفعال کردن آن داشته باشید، به عنوان مثال هنگام تولید خروجی XML سازگار با XSD.

-show_program_version

نمایش اطلاعات مرتبط با نسخه برنامه.

اطلاعات نسخه در بخشی با نام "PROGRAM_VERSION" چاپ می‌شود.

-show_library_versions

نمایش اطلاعات مربوط به نسخه کتابخانه‌ها.

اطلاعات نسخه برای هر کتابخانه در بخشی با نام "LIBRARY_VERSION" چاپ می‌شود.

-show_versions

نمایش اطلاعات مرتبط با نسخه‌های برنامه و کتابخانه‌ها. این گزینه معادل تنظیم هم‌زمان هر دو گزینه -show_program_version و -show_library_versions است.

-show_pixel_formats

نمایش اطلاعات درباره تمام قالب‌های پیکسلی پشتیبانی‌شده توسط FFmpeg.

اطلاعات مربوط به هر قالب پیکسلی در بخشی با نام "PIXEL_FORMAT" چاپ می‌شود.

-show_optional_fields value

برخی نویسنده‌ها مانند JSON و XML از چاپ فیلدهایی با مقادیر نامعتبر یا غیرقابل اعمال صرف‌نظر می‌کنند، در حالی که نویسنده‌های دیگر همیشه آن‌ها را چاپ می‌کنند. این گزینه امکان کنترل این رفتار را فراهم می‌سازد. مقادیر معتبر عبارتند از: "always"/1، "never"/0 و "auto"/-1. مقدار پیش‌فرض auto است.

-analyze_frames

تحلیل فریم‌ها و/یا داده‌های جانبی آن‌ها تا بازه خواندن ارائه‌شده، که اطلاعات تکمیلی مفیدی را در سطح جریان فراهم می‌کند. باید حتماً همراه با گزینه -show_streams استفاده شود وگرنه هیچ اثری نخواهد داشت.

در حال حاضر فیلدهای اضافی ارائه‌شده توسط این گزینه در صورت فعال بودن، فیلدهای "closed_captions" و "film_grain" هستند.

برای نمونه، جهت تحلیل ۲۰ ثانیه نخست و پر کردن این فیلدها:

ffprobe -show_streams -analyze_frames -read_intervals "%+20" INPUT

-bitexact

اجبار به خروجی دقیق بیتی (bitexact)؛ برای تولید خروجی که به بیلد خاص وابسته نباشد مفید است.

-i input_url

خواندن input_url.

-o output_url

نوشتن خروجی در output_url. در صورت مشخص نشدن، خروجی به stdout ارسال می‌شود.

-c:media_specifier codec_name

-codec:media_specifier codec_name

اجبار به یک پیاده‌سازی دیکودر خاص برای جریان شناسایی‌شده با media_specifier، که می‌تواند مقادیر "a" (صدا)، "v" (ویدیو)، "s" (زیرنویس) و "d" (داده) را داشته باشد.

default

قالب پیش‌فرض.

چاپ هر بخش به صورت:

[SECTION]
key1=val1
...
keyN=valN
[/SECTION]

تگ‌های متادیتا به عنوان یک خط در بخش مربوطه FORMAT، STREAM، STREAM_GROUP_STREAM یا PROGRAM_STREAM چاپ می‌شوند و دارای پیشوند "TAG:" هستند.

شرح گزینه‌های پذیرفته‌شده به شرح زیر است:

nokey, nk

در صورت تنظیم روی ۱ مشخص می‌کند که کلید هیچ فیلدی چاپ نشود. مقدار پیش‌فرض ۰ است.

noprint_wrappers, nw

در صورت تنظیم روی ۱ مشخص می‌کند که سربرگ و پانویس بخش‌ها چاپ نشوند. مقدار پیش‌فرض ۰ است.

compact, csv

قالب‌های فشرده (Compact) و CSV.

نویسنده "csv" معادل "compact" است، اما از پیش‌فرض‌های متفاوتی پشتیبانی می‌کند.

هر بخش در یک خط چاپ می‌شود. اگر هیچ گزینه‌ای مشخص نشود، خروجی ساختاری به صورت زیر دارد:

section|key1=val1| ... |keyN=valN

تگ‌های متادیتا در بخش مربوطه "format" یا "stream" چاپ می‌شوند. کلید یک تگ متادیتا، در صورت چاپ، دارای پیشوند "tag:" خواهد بود.

شرح گزینه‌های پذیرفته‌شده در زیر آمده است:

item_sep, s

تعیین نویسه‌ای که برای جداسازی فیلدها در خط خروجی به کار می‌رود. باید یک نویسه منفرد قابل چاپ باشد؛ به طور پیش‌فرض "|" است (برای نویسنده "csv" برابر با "," است).

nokey, nk

در صورت تنظیم روی ۱ مشخص می‌کند که کلید هر فیلد چاپ نشود. مقدار پیش‌فرض آن ۰ است (برای نویسنده "csv" برابر با ۱ است).

escape, e

تنظیم حالت اسکیپ مورد استفاده؛ پیش‌فرض "c" است (برای نویسنده "csv" برابر با "csv" است).

می‌تواند یکی از مقادیر زیر را داشته باشد:

print_section, p

در صورتی که مقدار 1 باشد نام بخش را در ابتدای هر خط چاپ می‌کند؛ با مقدار 0 آن را غیرفعال می‌سازد. مقدار پیش‌فرض 1 است.

flat

قالب مسطح (Flat).

خروجی با ساختار آزاد که در آن هر خط شامل یک جفت صریح key=value است، مانند "streams.stream.3.tags.foo=bar". خروجی برای پوسته (shell) اسکیپ شده است، بنابراین تا زمانی که نویسه جداکننده یک نویسه حرفی‌عددی یا زیرخط (underscore) باشد (به گزینه sep_char نگاه کنید)، می‌تواند مستقیماً در اسکریپت‌های sh تعبیه شود.

شرح گزینه‌های پذیرفته‌شده در زیر آمده است:

sep_char, s

نویسه جداکننده‌ای که برای جداسازی فصل، نام بخش، شناسه‌ها و تگ‌های بالقوه در کلید فیلد چاپ‌شده به کار می‌رود.

مقدار پیش‌فرض . است.

hierarchical, h

مشخص می‌کند که آیا مشخصات نام بخش باید سلسله‌مراتبی باشد یا خیر. اگر روی ۱ تنظیم شود، و اگر بیش از یک بخش در فصل جاری وجود داشته باشد، نام بخش با نام فصل پیشوندگذاری خواهد شد. مقدار ۰ این رفتار را غیرفعال می‌کند.

مقدار پیش‌فرض ۱ است.

ini

خروجی در قالب INI.

چاپ خروجی در قالبی بر پایه فایل‌های پیکربندی INI.

قراردادهای زیر در این قالب رعایت می‌شوند:

• تمام کلیدها و مقادیر به صورت UTF-8 هستند
• . جداکننده زیرگروه است
• خط جدید، \t، \f، \b و نویسه‌های مرتبط اسکیپ می‌شوند
• \ نویسه اسکیپ است
• # نشانگر توضیح (comment) است
• = جداکننده کلید/مقدار است
• : استفاده نمی‌شود اما معمولاً به عنوان جداکننده کلید/مقدار شناخته می‌شود

این نویسنده گزینه‌ها را به صورت فهرستی از جفت‌های key=value جداشده با : می‌پذیرد.

شرح گزینه‌های پذیرفته‌شده به شرح زیر است:

hierarchical, h

مشخص می‌کند که آیا مشخصات نام بخش باید سلسله‌مراتبی باشد یا خیر. در صورت تنظیم روی ۱، و اگر بیش از یک بخش در فصل جاری وجود داشته باشد، نام بخش با نام فصل پیشوندگذاری خواهد شد. مقدار ۰ این رفتار را غیرفعال می‌کند.

مقدار پیش‌فرض ۱ است.

json

قالب مبتنی بر JSON.

هر بخش با استفاده از نشانه‌گذاری JSON چاپ می‌شود.

شرح گزینه‌های پذیرفته‌شده به قرار زیر است:

compact, c

در صورت تنظیم روی ۱ خروجی فشرده را فعال می‌کند، به این معنا که هر بخش در یک خط واحد چاپ خواهد شد. مقدار پیش‌فرض ۰ است.

برای کسب اطلاعات بیشتر درباره JSON، نشانی http://www.json.org را ببینید.

xml

قالب مبتنی بر XML.

خروجی XML در فایل توصیف اسکیمای XML با نام ffprobe.xsd که در دایرکتوری datadir برنامه FFmpeg نصب می‌شود، تشریح شده است.

نسخه به‌روزشده این اسکیما را می‌توان در نشانی http://www.ffmpeg.org/schema/ffprobe.xsd یافت که به جدیدترین اسکیمای ثبت‌شده در درخت کدهای منبع توسعه FFmpeg هدایت می‌کند.

توجه داشته باشید که خروجی صادرشده تنها زمانی منطبق با اسکیمای ffprobe.xsd خواهد بود که گزینه‌های سراسری خاص خروجی (unit، prefix، byte_binary_prefix، sexagesimal و غیره) مشخص نشده باشند.

شرح گزینه‌های پذیرفته‌شده در ادامه آمده است:

fully_qualified, q

در صورت تنظیم روی ۱ مشخص می‌کند که آیا خروجی باید به صورت کاملاً واجد شرایط (fully qualified) ارائه شود یا خیر. مقدار پیش‌فرض ۰ است. این گزینه برای تولید فایل XML که بتوان آن را از طریق یک فایل XSD اعتبارسنجی کرد، مورد نیاز است.

xsd_strict, x

در صورت تنظیم روی ۱ بررسی‌های بیشتری را برای اطمینان از سازگاری خروجی با XSD انجام می‌دهد. مقدار پیش‌فرض ۰ است. این گزینه به طور خودکار fully_qualified را روی ۱ تنظیم می‌کند.

برای کسب اطلاعات بیشتر درباره قالب XML، نشانی https://www.w3.org/XML را ببینید.