.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.de Sp
.if t .sp .5v
.if n .sp
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R
.fi
..
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.de IX
..
.if n .ds AD l
.IX Title "FFPROBE-ALL 1"
.TH FFPROBE-ALL 1 " " "FFmpeg" "راهنمای ابزارهای چندرسانه‌ای"
.if n .ad l
.nh
.SH "نام (NAME)"
ffprobe-all \- راهنمای کامل کاوشگر و تحلیل‌گر جریان‌های چندرسانه‌ای FFprobe
.SH "شرح مختصر (SYNOPSIS)"
.IX Header "SYNOPSIS"
ffprobe [\fIگزینه‌ها\fR] \fIنشانی_ورودی\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار \&\fBffprobe\fR اطلاعات مربوط به استریم‌ها و فایل‌های چندرسانه‌ای را گردآوری کرده و آن‌ها را در قالب‌های خوانا برای انسان و ماشین چاپ می‌کند.
.PP
به عنوان مثال، می‌توان از آن برای بررسی قالب کانتینر مورد استفاده توسط یک جریان چندرسانه‌ای و همچنین قالب و نوع هر یک از استریم‌های صوتی، تصویری و متنی موجود در آن استفاده کرد.
.PP
اگر یک نشانی اینترنتی یا مسیر فایل به عنوان ورودی مشخص شود، \&\fBffprobe\fR تلاش می‌کند آن را باز کرده و محتوای آن را تحلیل (Probe) کند. در صورتی که فایل باز نشود یا به عنوان یک رسانه معتبر شناسایی نگردد، یک کد خروج مثبت بازگردانده می‌شود.
.PP
خروجی ffprobe به گونه‌ای طراحی شده است که به سادگی توسط اسکریپت‌ها و فیلترهای متنی قابل تجزیه باشد، و از یک یا چند بخش با ساختاری مشخص توسط نویسنده (Writer) انتخابی تشکیل می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
تمامی گزینه‌های عددی، چنانچه به نحو دیگری مشخص نشده باشد، یک رشته عددی را به عنوان ورودی می‌پذیرند که می‌تواند با پیشوندهای یکای بین‌المللی (مانند K، M یا G) همراه باشد.
.SS "تعیین‌کننده‌های استریم (Stream specifiers)"
.IX Subsection "Stream specifiers"
برخی گزینه‌ها روی استریم‌های خاصی اعمال می‌شوند. تعیین‌کننده‌های استریم برای مشخص کردن این که کدام استریم هدف گزینه است به کار می‌روند (مانند \f(CWa\fR برای صدا، \f(CWv\fR برای تصویر، \f(CWs\fR برای زیرنویس).
.SS "گزینه‌های عمومی (Generic options)"
.IX Subsection "Generic options"
.IP "\fB\-L, \-license\fR" 4
.IX Item "-L, -license"
نمایش مجوز برنامه.
.IP "\fB\-h, \-?, \-help, \-\-help\fR" 4
.IX Item "-h, -?, -help, --help"
نمایش راهنمای ابزار.
.IP \fB\-version\fR 4
.IX Item "-version"
نمایش نسخه برنامه و کتابخانه‌ها.
.IP \fB\-formats\fR 4
.IX Item "-formats"
نمایش تمامی قالب‌های کانتینر در دسترس.
.IP \fB\-codecs\fR 4
.IX Item "-codecs"
نمایش تمام کدک‌های شناخته‌شده.
.IP \fB\-decoders\fR 4
.IX Item "-decoders"
نمایش دیکودرهای در دسترس.
.IP \fB\-encoders\fR 4
.IX Item "-encoders"
نمایش انکودرهای در دسترس.
.IP "\fB\-loglevel\fR \fIسطح\fR" 4
.IX Item "-loglevel"
تنظیم سطح گزارش‌دهی وقایع (quiet, panic, fatal, error, warning, info, verbose, debug).
.IP \fB\-hide_banner\fR 4
.IX Item "-hide_banner"
عدم چاپ بنر اولیه متنی برنامه.
.SS "گزینه‌های اصلی (Main options)"
.IX Subsection "Main options"
.IP "\fB\-f\fR \fIقالب\fR" 4
.IX Item "-f format"
اجبار به استفاده از قالبی مشخص برای ورودی.
.IP \fB\-unit\fR 4
.IX Item "-unit"
نمایش یکای مقادیر چاپ‌شده.
.IP \fB\-prefix\fR 4
.IX Item "-prefix"
استفاده از پیشوندهای دهدهی SI برای مقادیر.
.IP \fB\-byte_binary_prefix\fR 4
.IX Item "-byte_binary_prefix"
اجبار به استفاده از پیشوندهای دودویی (KiB, MiB, GiB) برای مقادیر بایتی.
.IP \fB\-sexagesimal\fR 4
.IX Item "-sexagesimal"
استفاده از فرمت ساعت، دقیقه، ثانیه (HH:MM:SS.MICROSECONDS) برای مقادیر زمانی.
.IP \fB\-pretty\fR 4
.IX Item "-pretty"
زیباسازی و قالب‌بندی کاربرپسند مقادیر خروجی (معادل ترکیب \-unit \-prefix \-byte_binary_prefix \-sexagesimal).
.IP "\fB\-output_format, \-of, \-print_format\fR \fIنام_نویسنده\fR" 4
.IX Item "-output_format"
تعیین فرمت چاپ خروجی (مانند \f(CWdefault\fR، \f(CWjson\fR، \f(CWcsv\fR، \f(CWxml\fR، \f(CWini\fR، \f(CWflat\fR).
.IP \fB\-sections\fR 4
.IX Item "-sections"
چاپ ساختار بخش‌ها و مشخصات بخش‌های خروجی و خروج از برنامه.
.IP "\fB\-select_streams\fR \fIتعیین‌کننده_استریم\fR" 4
.IX Item "-select_streams"
انتخاب و فیلتر کردن استریم‌های مشخص برای نمایش اطلاعات (مانند \f(CW\-select_streams v\fR برای نمایش فقط استریم‌های ویدیویی).
.IP \fB\-show_data\fR 4
.IX Item "-show_data"
نمایش محتوای بار داده (Payload) به صورت هگزادسیمال و اسکی.
.IP \fB\-show_error\fR 4
.IX Item "-show_error"
نمایش اطلاعات خطای مواجه‌شده در زمان کاوش ورودی.
.IP \fB\-show_format\fR 4
.IX Item "-show_format"
نمایش اطلاعات کامل درباره کانتینر و قالب کلی جریان چندرسانه‌ای ورودی.
.IP "\fB\-show_entries\fR \fIفهرست_بخش‌ها\fR" 4
.IX Item "-show_entries"
تنظیم دقیق فهرست فیلدها و مدخل‌هایی که باید چاپ شوند.
.IP \fB\-show_packets\fR 4
.IX Item "-show_packets"
نمایش اطلاعات جزئی درباره تک‌تک بسته‌های داده (Packets) موجود در فایل.
.IP \fB\-show_frames\fR 4
.IX Item "-show_frames"
نمایش مشخصات تک‌تک فریم‌های ویدیویی، صوتی یا زیرنویس.
.IP \fB\-show_streams\fR 4
.IX Item "-show_streams"
نمایش اطلاعات تفصیلی تمام استریم‌های رسانه‌ای موجود در فایل.
.IP \fB\-show_programs\fR 4
.IX Item "-show_programs"
نمایش اطلاعات برنامه‌ها و استریم‌های وابسته به آن‌ها.
.IP \fB\-show_chapters\fR 4
.IX Item "-show_chapters"
نمایش اطلاعات مربوط به فصل‌ها (Chapters) ذخیره‌شده در رسانه.
.IP \fB\-count_frames\fR 4
.IX Item "-count_frames"
شمارش دقیق تعداد فریم‌های موجود در هر استریم با پیمایش کامل فایل.
.IP \fB\-count_packets\fR 4
.IX Item "-count_packets"
شمارش دقیق تعداد بسته‌های داده در هر استریم.
.IP "\fB\-read_intervals\fR \fIبازه\fR" 4
.IX Item "-read_intervals"
خواندن و بررسی تنها بازه‌های زمانی یا فریم‌های مشخص‌شده از فایل به جای کل فایل.
.IP \fB\-show_pixel_formats\fR 4
.IX Item "-show_pixel_formats"
نمایش اطلاعات تمام قالب‌های پیکسلی پشتیبانی‌شده توسط FFmpeg.
.SH "نویسنده‌ها (WRITERS)"
.IX Header "WRITERS"
نویسنده قالب خروجی مورد استفاده توسط \fBffprobe\fR را تعیین می‌کند:
.IP "\fBdefault\fR" 4
.IX Item "default writer"
فرمت پیش‌فرض متنی مبتنی بر جفت‌های کلید=مقدار درون بلوک‌های [SECTION] و [/SECTION].
.IP "\fBcompact, csv\fR" 4
.IX Item "compact writer"
خروجی فشرده تک‌خطی یا مبتنی بر مقادیر جداشده با کاما (CSV).
.IP "\fBflat\fR" 4
.IX Item "flat writer"
خروجی مسطح خطی مناسب برای تجزیه در اسکریپت‌های شل، awk یا پایتون به صورت \f(CWsection.name.key="value"\fR.
.IP "\fBini\fR" 4
.IX Item "ini writer"
خروجی در قالب ساختار فایل‌های پیکربندی INI.
.IP "\fBjson\fR" 4
.IX Item "json writer"
خروجی شیء ساختاریافته استاندارد JSON مناسب برنامه‌نویسی وب و پردازش داده‌ها.
.IP "\fBxml\fR" 4
.IX Item "xml writer"
خروجی مبتنی بر تگ‌های سند استاندارد XML.
.SH "کد زمانی (TIMECODE)"
.IX Header "TIMECODE"
ابزار \fBffprobe\fR از استخراج کدهای زمانی (Timecode) موجود در کانتینرها یا استریم‌های ویدیویی با گزینه \fB\-show_format\fR و \fB\-show_streams\fR پشتیبانی می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBffprobe\fR\|(1), \fBffmpeg\fR\|(1), \fBffplay\fR\|(1),
\&\fBffmpeg\-utils\fR\|(1), \fBffmpeg\-scaler\fR\|(1), \fBffmpeg\-resampler\fR\|(1),
\&\fBffmpeg\-codecs\fR\|(1), \fBffmpeg\-bitstream\-filters\fR\|(1), \fBffmpeg\-formats\fR\|(1),
\&\fBffmpeg\-devices\fR\|(1), \fBffmpeg\-protocols\fR\|(1), \fBffmpeg\-filters\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
توسعه‌دهندگان FFmpeg.
.PP
برای اطلاعات نویسندگی به <\fBhttps://git.ffmpeg.org/ffmpeg\fR> مراجعه کنید.