.\" -*- 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 "FFMPEG-FORMATS 1"
.TH FFMPEG-FORMATS 1 " " "FFmpeg" "راهنمای ابزارهای چندرسانه‌ای"
.if n .ad l
.nh
.SH "نام (NAME)"
ffmpeg\-formats \- قالب‌های ورودی، خروجی، ماکسرها و دی‌ماکسرهای FFmpeg
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند به توصیف قالب‌های پشتیبانی‌شده (ماکسرها و دی‌ماکسرها) ارائه شده توسط کتابخانه libavformat می‌پردازد. این کتابخانه پروتکل‌ها و قالب‌های ظرف (Container) چندرسانه‌ای گوناگون را پردازش می‌کند.
.SH "گزینه‌های قالب (FORMAT OPTIONS)"
.IX Header "FORMAT OPTIONS"
کتابخانه libavformat گزینه‌های سراسری عمومی را فراهم می‌کند که می‌توانند روی تمامی ماکسرها (Muxers) و دی‌ماکسرها (Demuxers) اعمال شوند. همچنین هر قالب می‌تواند گزینه‌های اختصاصی خود را داشته باشد.
.PP
گزینه‌ها می‌توانند با نحو \-\fIoption\fR \fIvalue\fR در ابزارهای FFmpeg یا با مقداردهی ساختار \f(CW\*(C`AVFormatContext\*(C'\fR تنظیم گردند.
.PP
گزینه‌های عمومی اصلی عبارتند از:
.IP "\fBavioflags\fR \fIپرچم‌ها\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "avioflags"
تنظیم پرچم‌های ورودی/خروجی سطح پایین؛ شامل مقادیری چون \f(CWdirect\fR برای کاهش بافرینگ حافظه.
.IP "\fBprobesize\fR \fIبایت\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "probesize"
حداکثر مقدار بایت ورودی که برای شناسایی خودکار قالب و استریم‌ها کاوش (Probe) می‌شود. مقدار پیش‌فرض ۵٬۰۰۰٬۰۰۰ بایت (5MB) است.
.IP "\fBpacket_size\fR \fIاندازه\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "packet_size"
تنظیم اندازه بسته خروجی به بایت.
.IP "\fBfflags\fR \fIپرچم‌ها\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "fflags"
تنظیم پرچم‌های اختصاصی فرمت. مقادیر ممکن:
.RS 4
.IP "\fBflush_packets\fR" 4
تخلیه فوری بسته‌ها در خروجی پس از نوشتن هر بسته.
.IP "\fBignidx\fR" 4
نادیده گرفتن فهرست اندیس فریم‌ها در فایل ورودی.
.IP "\fBgenpts\fR" 4
تولید خودکار برچسب‌های زمانی PTS در صورت عدم وجود در ورودی.
.IP "\fBnofillin\fR" 4
عدم پر کردن خودکار مقادیر مفقود برچسب‌های زمانی با درون‌یابی.
.IP "\fBnoparse\fR" 4
غیرفعال کردن پارسر خودکار کدک‌ها.
.IP "\fBigndts\fR" 4
نادیده گرفتن مقادیر برچسب زمانی رمزگشایی DTS.
.IP "\fBdiscardcorrupt\fR" 4
دور انداختن بسته‌های داده خراب یا مخدوش در جریان ورودی.
.IP "\fBsortdts\fR" 4
تلاش برای بازآرایی و مرتب‌سازی بسته‌ها بر اساس برچسب زمانی DTS.
.IP "\fBfastseek\fR" 4
فعال‌سازی پرش سریع مبتنی بر بایت در قالب‌هایی که پشتیبانی می‌کنند.
.RE
.IP "\fBanalyzeduration\fR \fIمیکروثانیه\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "analyzeduration"
تعیین حداکثر مدت زمانی که برنامه برای بررسی مشخصات جریان‌ها و کدک‌ها تحلیل می‌کند.
.IP "\fBfpsprobesize\fR \fIتعداد\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "fpsprobesize"
تعداد فریم‌های مورد استفاده برای تعیین نرخ فریم در استریم‌های بدون هدر کامل.
.IP "\fBerr_detect, f_err_detect\fR \fIپرچم‌ها\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "err_detect"
تنظیم حساسیت تشخیص خطای قالب: \f(CWcrccheck\fR، \f(CWbitstream\fR، \f(CWbuffer\fR، \f(CWexplode\fR (توقف فوری در صورت بروز هر خطا).
.IP "\fBmax_interleave_delta\fR \fIمیکروثانیه\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "max_interleave_delta"
حداکثر اختلاف زمانی در هم‌تنیدگی بسته‌های صدا و تصویر.
.SH "دی‌ماکسرها (DEMUXERS)"
.IX Header "DEMUXERS"
دی‌ماکسرها مؤلفه‌های نرم‌افزاری هستند که جریان چندرسانه‌ای را از فایل یا استریم کانتینر خوانده و آن را به استریم‌های صوتی، تصویری و زیرنویس اولیه تفکیک می‌کنند.
.PP
مهم‌ترین دی‌ماکسرهای در دسترس:
.IP "\fBmov, mp4, m4a, 3gp\fR" 4
.IX Item "mov, mp4"
دی‌ماکسر کانتینرهای خانواده QuickTime / ISO Base Media Format (MP4).
.IP "\fBmatroska, webm\fR" 4
.IX Item "matroska, webm"
دی‌ماکسر قالب‌های منعطف و مدرن Matroska (MKV) و WebM بر پایه زبان ساخت‌یافته EBML.
.IP "\fBmpegts\fR" 4
.IX Item "mpegts"
دی‌ماکسر استریم‌های انتقالی MPEG-2 Transport Stream پرکاربرد در پخش دیجیتال تلویزیونی (DVB/ATSC) و استریم‌های HLS.
.IP "\fBflv\fR" 4
.IX Item "flv"
دی‌ماکسر فرمت فلش ویدیو (Flash Video) مورد استفاده در پروتکل‌های پخش آنلاین مانند RTMP.
.IP "\fBhls\fR" 4
.IX Item "hls"
دی‌ماکسر پروتکل پخش زنده و تقاضامحور چندنرخی Apple HTTP Live Streaming بر پایه لیست‌های پخش M3U8.
.IP "\fBimage2\fR" 4
.IX Item "image2"
دی‌ماکسر توالی تصاویر تک‌فریم برای خواندن مجموعه‌ای از فایل‌های عکس با الگوی نام‌گذاری (مانند \f(CWimg%03d.png\fR).
.IP "\fBconcat\fR" 4
.IX Item "concat"
دی‌ماکسر اختصاصی الحاق مجازی فایل‌ها بر اساس یک فایل متنی فهرستی ساده بدون نیاز به انکود مجدد.
.SH "ماکسرها (MUXERS)"
.IX Header "MUXERS"
ماکسرها مؤلفه‌هایی هستند که بسته‌های انکودشده صدا، ویدیو و داده را دریافت کرده و آن‌ها را در قالب یک فایل کانتینر استاندارد با یکپارچگی زمانی ترکیب و بسته‌بندی می‌کنند.
.PP
مهم‌ترین ماکسرهای در دسترس:
.IP "\fBmp4 / mov\fR" 4
.IX Item "mp4 / mov muxer"
ماکسر کانتینرهای MP4 و QuickTime.
.Sp
گزینه‌های اختصاصی پرکاربرد:
.RS 4
.IP "\fBmovflags\fR" 4
شامل پرچم‌های مهمی مانند \f(CWfaststart\fR (انتقال جدول اطلاعات موف به ابتدای فایل جهت آغاز پخش بلافاصله پس از شروع دانلود اینترنتی)، \f(CWfrag_keyframe\fR (تقسیم فایل به قطعات مجزا)، و \f(CWempty_moov\fR برای جریان‌های زنده تکه‌تکه (Fragmented MP4).
.RE
.IP "\fBmatroska\fR" 4
.IX Item "matroska muxer"
ماکسر کانتینر چندمنظوره MKV با پشتیبانی نامحدود از استریم‌های موازی صوتی، زیرنویس‌ها و پیوست‌های خط و فونت.
.IP "\fBhls\fR" 4
.IX Item "hls muxer"
ماکسر تولید استریم‌های قطعه‌بندی‌شده HLS شامل تولید خودکار فایل مانیفست M3U8 و فایل‌های قطعه TS یا fMP4.
.IP "\fBsegment\fR" 4
.IX Item "segment"
ماکسر تقسیم خودکار فایل خروجی به بخش‌های کوچک زمانی یا فریم‌کلیدی با الگوی نام‌گذاری مشخص.
.IP "\fBtee\fR" 4
.IX Item "tee"
ماکسر ارسال همزمان یک جریان رسانه‌ای کدگذاری‌شده به چندین مقصد خروجی مجزا (مانند نوشتن روی دیسک هم‌زمان با ارسال زنده به یوتیوب یا توییچ).
.SH "فراداده (METADATA)"
.IX Header "METADATA"
ابزار FFmpeg قادر است تمامی اطلاعات فراداده (Metadata) یک فایل رسانه‌ای را در قالب یک فایل متنی ساده با ساختار شبیه INI استخراج کند و مجدداً با استفاده از ماکسر فراداده بر روی فایل‌های جدید بارگذاری نماید:
.PP
.Vb 2
\&        ffmpeg \-i in.mp4 \-f ffmetadata in.txt
\&        ffmpeg \-i in.mp4 \-i in.txt \-map_metadata 1 \-c copy out.mp4
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBffmpeg\fR\|(1), \fBffplay\fR\|(1), \fBffprobe\fR\|(1),
\&\fBffmpeg\-utils\fR\|(1), \fBffmpeg\-scaler\fR\|(1), \fBffmpeg\-resampler\fR\|(1),
\&\fBffmpeg\-codecs\fR\|(1), \fBffmpeg\-bitstream\-filters\fR\|(1),
\&\fBffmpeg\-devices\fR\|(1), \fBffmpeg\-protocols\fR\|(1), \fBffmpeg\-filters\fR\|(1),
\&\fBlibavformat\fR\|(3)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
توسعه‌دهندگان FFmpeg.
.PP
برای جزئیات بیشتر به تاریخچه گیت پروژه در <\fBhttps://git.ffmpeg.org/ffmpeg\fR> مراجعه نمایید.