." -*- 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 "FFPLAY-ALL 1"
.TH FFPLAY-ALL 1 " " "FFmpeg" "راهنمای ابزارهای چندرسانه‌ای"
.if n .ad l
.nh
.SH "نام (NAME)"
ffplay-all \- مستندات جامع پخش‌کننده چندرسانه‌ای FFplay همراه با تمامی کامپوننت‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
ffplay [\fIگزینه‌ها\fR] [\fIنشانی_اینترنتی_ورودی\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامه FFplay یک پخش‌کننده رسانه‌ای بسیار ساده و پرتابل است که از کتابخانه‌های FFmpeg و کتابخانه SDL استفاده می‌کند. این برنامه بیشتر به عنوان بستری برای آزمودن رابط‌های برنامه‌نویسی مختلف FFmpeg به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
تمامی گزینه‌های عددی، چنانچه به نحو دیگری مشخص نشده باشد، یک رشته نشان‌دهنده یک عدد را به عنوان ورودی می‌پذیرند که ممکن است با یکی از پیشوندهای یکای بین‌المللی (SI) مانند \*(AqK\*(Aq، \*(AqM\*(Aq یا \*(AqG\*(Aq همراه باشد.
.PP
اگر حرف \*(Aqi\*(Aq به پیشوند یکای SI الحاق شود، پیشوند کامل به عنوان پیشوند برای مضارب دودویی تفسیر می‌شود که بر پایه توان‌های ۱۰۲۴ به جای توان‌های ۱۰۰۰ هستند. افزودن \*(AqB\*(Aq به پیشوند یکای SI مقدار را در ۸ ضرب می‌کند. این اجازه می‌دهد تا به عنوان مثال از \*(AqKB\*(Aq، \*(AqMiB\*(Aq، \*(AqG\*(Aq و \*(AqB\*(Aq به عنوان پسوندهای عددی استفاده شود.
.PP
گزینه‌هایی که آرگومان دریافت نمی‌کنند، گزینه‌های بولی هستند و مقدار مربوطه را روی درست (true) تنظیم می‌کنند. می‌توان آن‌ها را با افزودن پیشوند "no" به نام گزینه روی نادرست (false) تنظیم کرد. به عنوان مثال استفاده از "\-nofoo" گزینه بولی با نام "foo" را روی false قرار می‌دهد.
.PP
گزینه‌های دارای آرگومان از یک ساختار نحوی ویژه پشتیبانی می‌کنند که در آن آرگومان داده‌شده در خط فرمان به عنوان مسیری به فایلی تفسیر می‌شود که مقدار واقعی آرگومان از آن بارگیری می‌شود. برای استفاده از این قابلیت، یک ممیز رو به جلو \*(Aq/\*(Aq بلافاصله پیش از نام گزینه (پس از خط تیره ابتدایی) اضافه کنید. برای نمونه:
.PP
.Vb 1
\&        ffplay \-/vf filter.script input.mp4
.Ve
.PP
توصیف گراف فیلتر را از فایلی به نام \fIfilter.script\fR بارگیری می‌کند.
.SS "مشخص‌کننده‌های استریم (Stream specifiers)"
.IX Subsection "Stream specifiers"
برخی گزینه‌ها به‌ازای‌هر‌استریم اعمال می‌شوند، مانند نرخ بیت (bitrate) یا کدک. مشخص‌کننده‌های استریم برای تعیین دقیق این‌که یک گزینه به کدام استریم (یا استریم‌ها) تعلق دارد به کار می‌روند.
.PP
مشخص‌کننده استریم رشته‌ای است که عموماً به انتهای نام گزینه الحاق شده و با دو‌نقطه (:) از آن جدا می‌شود. برای مثال، \f(CW\*(C`\-codec:a:1 ac3\*(C'\fR حاوی مشخص‌کننده استریم \f(CW\*(C`a:1\*(C'\fR است که با دومین استریم صوتی مطابقت دارد. بنابراین، کدک ac3 را برای دومین استریم صوتی انتخاب خواهد کرد.
.PP
یک مشخص‌کننده استریم می‌تواند با چندین استریم مطابقت داشته باشد، به طوری که گزینه بر روی تمامی آن‌ها اعمال شود. برای مثال مشخص‌کننده استریم در \f(CW\*(C`\-b:a 128k\*(C'\fR با تمام استریم‌های صوتی مطابقت دارد.
.PP
یک مشخص‌کننده استریم خالی با تمام استریم‌ها مطابقت دارد. برای نمونه، \f(CW\*(C`\-codec copy\*(C'\fR یا \f(CW\*(C`\-codec: copy\*(C'\fR تمامی استریم‌ها را بدون انکود مجدد کپی می‌کند.
.PP
شکل‌های ممکن مشخص‌کننده‌های استریم عبارتند از:
.IP \fIstream_index\fR 4
.IX Item "stream_index"
با استریم دارای این اندیس مطابقت می‌یابد. برای مثال \f(CW\*(C`\-threads:1 4\*(C'\fR تعداد ریسه‌های دومین استریم را روی 4 تنظیم می‌کند. اگر \fIstream_index\fR به عنوان یک مشخص‌کننده استریم اضافی استفاده شود (به پایین مراجعه کنید)، استریم شماره \fIstream_index\fR را از میان استریم‌های منطبق انتخاب می‌نماید. شماره‌گذاری استریم‌ها بر اساس ترتیب استریم‌ها به گونه‌ای است که توسط libavformat شناسایی شده‌اند، مگر زمانی که مشخص‌کننده گروه استریم یا شناسه برنامه (program ID) نیز مشخص شده باشد. در این حالت بر اساس ترتیب استریم‌ها درون آن گروه یا برنامه خواهد بود.
.IP \fIstream_type\fR\fB[:\fR\fIadditional_stream_specifier\fR\fB]\fR 4
.IX Item "stream_type[:additional_stream_specifier]"
پارامتر \fIstream_type\fR یکی از موارد زیر است: \*(Aqv\*(Aq یا \*(AqV\*(Aq برای ویدیو، \*(Aqa\*(Aq برای صدا، \*(Aqs\*(Aq برای زیرنویس، \*(Aqd\*(Aq برای داده، و \*(Aqt\*(Aq برای پیوست‌ها. حرف \*(Aqv\*(Aq با تمام استریم‌های ویدیو مطابقت دارد، در حالی که \*(AqV\*(Aq تنها با استریم‌های ویدیویی مطابقت دارد که تصاویر پیوست‌شده، تصاویر بندانگشتی (thumbnails) یا طرح جلد نیستند. اگر \fIadditional_stream_specifier\fR استفاده شود، با استریم‌هایی مطابقت دارد که هم دارای این نوع باشند و هم با \fIadditional_stream_specifier\fR مطابقت داشته باشند. در غیر این صورت، با تمام استریم‌های از نوع مشخص‌شده مطابقت دارد.
.IP \fBg:\fR\fIgroup_specifier\fR\fB[:\fR\fIadditional_stream_specifier\fR\fB]\fR 4
.IX Item "g:group_specifier[:additional_stream_specifier]"
با استریم‌هایی مطابقت دارد که در گروه دارای مشخص‌کننده \fIgroup_specifier\fR قرار دارند. اگر \fIadditional_stream_specifier\fR استفاده شود، با استریم‌هایی مطابقت دارد که هم بخشی از گروه باشند و هم با \fIadditional_stream_specifier\fR تطابق داشته باشند.
\&\fIgroup_specifier\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fIgroup_index\fR 4
.IX Item "group_index"
تطابق با استریم دارای این اندیس گروه.
.IP "\fB#\fR\fIgroup_id\fR \fBor i:\fR\fIgroup_id\fR" 4
.IX Item "#group_id or i:group_id"
تطابق با استریم دارای این شناسه گروه.
.RE
.RS 4
.RE
.IP \fBp:\fR\fIprogram_id\fR\fB[:\fR\fIadditional_stream_specifier\fR\fB]\fR 4
.IX Item "p:program_id[:additional_stream_specifier]"
با استریم‌هایی مطابقت دارد که در برنامه با شناسه \fIprogram_id\fR قرار دارند. اگر \fIadditional_stream_specifier\fR استفاده شود، با استریم‌هایی مطابقت دارد که هم بخشی از برنامه باشند و هم با \fIadditional_stream_specifier\fR مطابقت داشته باشند.
.IP "\fB#\fR\fIstream_id\fR \fBor i:\fR\fIstream_id\fR" 4
.IX Item "#stream_id or i:stream_id"
تطابق با استریم بر اساس شناسه استریم (مثلاً PID در کانتینر MPEG\-TS).
.IP \fBm:\fR\fIkey\fR\fB[:\fR\fIvalue\fR\fB]\fR 4
.IX Item "m:key[:value]"
با استریم‌هایی مطابقت دارد که تگ متادیتای \fIkey\fR آن‌ها دارای مقدار مشخص‌شده باشد. اگر \fIvalue\fR داده نشود، با استریم‌هایی که حاوی تگ داده‌شده با هر مقداری باشند مطابقت می‌یابد. نویسه دو‌نقطه \*(Aq:\*(Aq در \fIkey\fR یا \fIvalue\fR باید با بک‌اسلش گریز داده شود (escape شود).
.IP \fBdisp:\fR\fIdispositions\fR\fB[:\fR\fIadditional_stream_specifier\fR\fB]\fR 4
.IX Item "disp:dispositions[:additional_stream_specifier]"
با استریم‌های دارای وضعیت(های) مشخص‌شده مطابقت دارد. \fIdispositions\fR فهرستی از یک یا چند وضعیت (همان‌طور که توسط گزینه \fB\-dispositions\fR چاپ می‌شود) است که با \*(Aq+\*(Aq به هم پیوسته‌اند.
.IP \fBu\fR 4
.IX Item "u"
با استریم‌های دارای پیکربندی قابل استفاده مطابقت می‌یابد؛ کدک باید تعریف شده باشد و اطلاعات اساسی مانند ابعاد تصویر یا نرخ نمونه‌برداری صدا باید موجود باشند.
.Sp
توجه داشته باشید که در \fBffplay\fR، تطابق بر اساس متادیتا تنها برای فایل‌های ورودی به درستی کار خواهد کرد.
.SS "گزینه‌های عمومی (Generic options)"
.IX Subsection "Generic options"
این گزینه‌ها میان تمامی ابزارهای مجموعه ff* به اشتراک گذاشته شده‌اند.
.IP "\fB\-L, \-license\fR" 4
.IX Item "-L, -license"
نمایش مجوز برنامه.
.IP "\fB\-h, \-?, \-help, \-\-help [\fR\fIarg\fR\fB]\fR" 4
.IX Item "-h, -?, -help, --help [arg]"
نمایش راهنما. یک پارامتر اختیاری می‌تواند برای دریافت راهنما درباره یک مؤلفه خاص مشخص شود. اگر هیچ آرگومانی مشخص نگردد، تنها گزینه‌های پایه (غیرپیشرفته) ابزار نمایش داده می‌شوند.
.Sp
مقادیر ممکن برای \fIarg\fR عبارتند از:
.RS 4
.IP \fBlong\fR 4
.IX Item "long"
چاپ گزینه‌های پیشرفته ابزار علاوه بر گزینه‌های پایه.
.IP \fBfull\fR 4
.IX Item "full"
چاپ فهرست کامل تمامی گزینه‌ها، شامل گزینه‌های مشترک و اختصاصی برای انکودرها، دیکودرها، دی‌ماکسرها، ماکسرها، فیلترها و غیره.
.IP \fBdecoder=\fR\fIdecoder_name\fR 4
.IX Item "decoder=decoder_name"
چاپ اطلاعات تفصیلی درباره دیکودر با نام \fIdecoder_name\fR. از گزینه \fB\-decoders\fR برای دریافت فهرستی از تمام دیکودرها استفاده کنید.
.IP \fBencoder=\fR\fIencoder_name\fR 4
.IX Item "encoder=encoder_name"
چاپ اطلاعات تفصیلی درباره انکودر با نام \fIencoder_name\fR. از گزینه \fB\-encoders\fR برای دریافت فهرستی از تمام انکودرها استفاده کنید.
.IP \fBdemuxer=\fR\fIdemuxer_name\fR 4
.IX Item "demuxer=demuxer_name"
چاپ اطلاعات تفصیلی درباره دی‌ماکسر با نام \fIdemuxer_name\fR. از گزینه \fB\-formats\fR برای دریافت فهرستی از تمام دی‌ماکسرها و ماکسرها استفاده کنید.
.IP \fBmuxer=\fR\fImuxer_name\fR 4
.IX Item "muxer=muxer_name"
چاپ اطلاعات تفصیلی درباره ماکسر با نام \fImuxer_name\fR. از گزینه \fB\-formats\fR برای دریافت فهرستی از تمام ماکسرها و دی‌ماکسرها استفاده کنید.
.IP \fBfilter=\fR\fIfilter_name\fR 4
.IX Item "filter=filter_name"
چاپ اطلاعات تفصیلی درباره فیلتر با نام \fIfilter_name\fR. از گزینه \fB\-filters\fR برای دریافت فهرستی از تمام فیلترها استفاده کنید.
.IP \fBbsf=\fR\fIbitstream_filter_name\fR 4
.IX Item "bsf=bitstream_filter_name"
چاپ اطلاعات تفصیلی درباره فیلتر بیت‌استریم با نام \fIbitstream_filter_name\fR. از گزینه \fB\-bsfs\fR برای دریافت فهرستی از تمام فیلترهای بیت‌استریم استفاده کنید.
.IP \fBprotocol=\fR\fIprotocol_name\fR 4
.IX Item "protocol=protocol_name"
چاپ اطلاعات تفصیلی درباره پروتکل با نام \fIprotocol_name\fR. از گزینه \fB\-protocols\fR برای دریافت فهرستی از تمام پروتکل‌ها استفاده نمایید.
.RE
.RS 4
.RE
.IP \fB\-version\fR 4
.IX Item "-version"
نمایش نسخه برنامه و کتابخانه‌ها.
.IP \fB\-buildconf\fR 4
.IX Item "-buildconf"
نمایش پیکربندی ساخت (build)، یک گزینه در هر خط.
.IP \fB\-formats\fR 4
.IX Item "-formats"
نمایش قالب‌های در دسترس (شامل دستگاه‌ها).
.IP \fB\-demuxers\fR 4
.IX Item "-demuxers"
نمایش دی‌ماکسرهای در دسترس.
.IP \fB\-muxers\fR 4
.IX Item "-muxers"
نمایش ماکسرهای در دسترس.
.IP \fB\-devices\fR 4
.IX Item "-devices"
نمایش دستگاه‌های در دسترس.
.IP \fB\-codecs\fR 4
.IX Item "-codecs"
نمایش تمام کدک‌های شناخته‌شده برای کتابخانه libavcodec.
.Sp
توجه داشته باشید که اصطلاح \*(Aqcodec\*(Aq در سرتاسر این مستندات به عنوان یک میان‌بر برای آنچه که به طور دقیق‌تر قالب بیت‌استریم رسانه نامیده می‌شود به کار رفته است.
.IP \fB\-decoders\fR 4
.IX Item "-decoders"
نمایش دیکودرهای در دسترس.
.IP \fB\-encoders\fR 4
.IX Item "-encoders"
نمایش تمام انکودرهای در دسترس.
.IP \fB\-bsfs\fR 4
.IX Item "-bsfs"
نمایش فیلترهای بیت‌استریم در دسترس.
.IP \fB\-protocols\fR 4
.IX Item "-protocols"
نمایش پروتکل‌های در دسترس.
.IP \fB\-filters\fR 4
.IX Item "-filters"
نمایش فیلترهای در دسترس کتابخانه libavfilter.
.IP \fB\-pix_fmts\fR 4
.IX Item "-pix_fmts"
نمایش فرمت‌های پیکسل در دسترس.
.IP \fB\-sample_fmts\fR 4
.IX Item "-sample_fmts"
نمایش فرمت‌های نمونه صدای در دسترس.
.IP \fB\-layouts\fR 4
.IX Item "-layouts"
نمایش نام‌های کانال و چیدمان‌های استاندارد کانال.
.IP \fB\-dispositions\fR 4
.IX Item "-dispositions"
نمایش وضعیت‌های استریم.
.IP \fB\-colors\fR 4
.IX Item "-colors"
نمایش نام‌های رنگ شناخته‌شده.
.IP "\fB\-sources\fR \fIdevice\fR\fB[,\fR\fIopt1\fR\fB=\fR\fIval1\fR\fB[,\fR\fIopt2\fR\fB=\fR\fIval2\fR\fB]...]\fR" 4
.IX Item "-sources device[,opt1=val1[,opt2=val2]...]"
نمایش منابع شناسایی‌شده خودکار دستگاه ورودی. برخی دستگاه‌ها ممکن است نام‌های منبع وابسته به سیستم را ارائه دهند که نمی‌توانند به طور خودکار شناسایی شوند. نمی‌توان فرض کرد که فهرست ارائه‌شده همیشه کامل است.
.Sp
.Vb 1
\&        ffmpeg \-sources pulse,server=192.168.0.4
.Ve
.IP "\fB\-sinks\fR \fIdevice\fR\fB[,\fR\fIopt1\fR\fB=\fR\fIval1\fR\fB[,\fR\fIopt2\fR\fB=\fR\fIval2\fR\fB]...]\fR" 4
.IX Item "-sinks device[,opt1=val1[,opt2=val2]...]"
نمایش مقصدهای (sinks) شناسایی‌شده خودکار دستگاه خروجی. برخی دستگاه‌ها ممکن است نام‌های مقصد وابسته به سیستم را ارائه دهند که به صورت خودکار شناسایی نمی‌شوند. نمی‌توان فرض کرد که فهرست ارائه‌شده همیشه کامل است.
.Sp
.Vb 1
\&        ffmpeg \-sinks pulse,server=192.168.0.4
.Ve
.IP "\fB\-loglevel [\fR\fIflags\fR\fB+]\fR\fIloglevel\fR \fB| \-v [\fR\fIflags\fR\fB+]\fR\fIloglevel\fR" 4
.IX Item "-loglevel [flags+]loglevel | -v [flags+]loglevel"
تنظیم سطح لاگ‌گیری و فلگ‌های مورد استفاده توسط کتابخانه.
.Sp
پیشوند اختیاری \fIflags\fR می‌تواند شامل مقادیر زیر باشد:
.RS 4
.IP \fBrepeat\fR 4
.IX Item "repeat"
نشان می‌دهد که خروجی‌های تکراری لاگ نباید به خط اول فشرده شوند و خط "Last message repeated n times" حذف خواهد شد.
.IP \fBlevel\fR 4
.IX Item "level"
نشان می‌دهد که خروجی لاگ باید یک پیشوند \f(CW\*(C`[level]\*(C'\fR را به هر خط پیام بیفزاید. این می‌تواند به عنوان جایگزینی برای رنگ‌آمیزی لاگ استفاده شود، مثلاً هنگام ذخیره خروجی لاگ در فایل.
.IP \fBtime\fR 4
.IX Item "time"
نشان می‌دهد که خطوط لاگ باید با اطلاعات زمان پیشوندگذاری شوند.
.IP \fBdatetime\fR 4
.IX Item "datetime"
نشان می‌دهد که خطوط لاگ باید با اطلاعات تاریخ و زمان پیشوندگذاری شوند.
.RE
.RS 4
.Sp
فلگ‌ها همچنین می‌توانند به تنهایی با افزودن پیشوند \*(Aq+\*(Aq/\*(Aq\-\*(Aq برای فعال/غیرفعال‌سازی یک فلگ منفرد بدون تأثیر بر سایر \fIflags\fR یا تغییر \fIloglevel\fR استفاده شوند. هنگام تنظیم هم‌زمان \fIflags\fR و \fIloglevel\fR، یک جداکننده \*(Aq+\*(Aq میان آخرین مقدار \fIflags\fR و پیش از \fIloglevel\fR انتظار می‌رود.
.Sp
پارامتر \fIloglevel\fR یک رشته یا یک عدد حاوی یکی از مقادیر زیر است:
.IP "\fBquiet, \-8\fR" 4
.IX Item "quiet, -8"
هیچ پیامی نشان ندهد؛ کاملاً ساکت باشد.
.IP "\fBpanic, 0\fR" 4
.IX Item "panic, 0"
تنها خطاهای مرگباری را نمایش دهد که می‌توانند منجر به کرش و فروپاشی فرایند شوند، مانند شکست assertion. در حال حاضر برای موردی استفاده نمی‌شود.
.IP "\fBfatal, 8\fR" 4
.IX Item "fatal, 8"
تنها خطاهای مهلک را نشان دهد. این‌ها خطاهایی هستند که پس از آن‌ها فرایند مطلقاً نمی‌تواند ادامه یابد.
.IP "\fBerror, 16\fR" 4
.IX Item "error, 16"
تمام خطاها را نمایش دهد، از جمله خطاهایی که برنامه قادر به بازیابی از آن‌ها است.
.IP "\fBwarning, 24\fR" 4
.IX Item "warning, 24"
تمام هشدارها و خطاها را نشان دهد. هر پیامی مرتبط با رویدادهای غیرمنتظره یا احتمالاً نادرست نمایش داده خواهد شد.
.IP "\fBinfo, 32\fR" 4
.IX Item "info, 32"
پیام‌های اطلاع‌رسانی را در طول پردازش نمایش دهد. این پیام‌ها علاوه بر هشدارها و خطاها است. این مقدار پیش‌فرض است.
.IP "\fBverbose, 40\fR" 4
.IX Item "verbose, 40"
مشابه \f(CW\*(C`info\*(C'\fR، اما با جزئیات و تفصیل بیشتر.
.IP "\fBdebug, 48\fR" 4
.IX Item "debug, 48"
همه چیز را نمایش دهد، شامل اطلاعات اشکال‌زدایی.
.IP "\fBtrace, 56\fR" 4
.IX Item "trace, 56"
.RE
.RS 4
.Sp
برای مثال جهت فعال‌سازی خروجی تکراری لاگ، افزودن پیشوند \f(CW\*(C`level\*(C'\fR، و تنظیم \fIloglevel\fR روی \f(CW\*(C`verbose\*(C'\fR:
.Sp
\&        ffmpeg \-loglevel repeat+level+verbose \-i input output
.Ve
.Sp
.Sp
مثال دیگری که خروجی تکراری لاگ را بدون تأثیر بر وضعیت جاری فلگ پیشوند \f(CW\*(C`level\*(C'\fR یا \fIloglevel\fR فعال می‌سازد:
.Sp
\&        ffmpeg [...] \-loglevel +repeat
.Ve
.Sp
.Sp
به طور پیش‌فرض برنامه در stderr لاگ می‌اندازد. اگر رنگ‌آمیزی توسط ترمینال پشتیبانی شود، از رنگ‌ها برای نشانه‌گذاری خطاها و هشدارها استفاده می‌گردد. رنگ‌آمیزی لاگ را می‌توان با تنظیم متغیر محیطی \fBAV_LOG_FORCE_NOCOLOR\fR غیرفعال کرد، یا با تنظیم متغیر محیطی \fBAV_LOG_FORCE_COLOR\fR آن را اجباری نمود.
.RE
.IP \fB\-report\fR 4
.IX Item "-report"
ذخیره کامل خط فرمان و خروجی لاگ در فایلی با نام \f(CW\*(C`\fR\f(CIprogram\fR\f(CW\-\fR\f(CIYYYYMMDD\fR\f(CW\-\fR\f(CIHHMMSS\fR\f(CW.log\*(C'\fR در دایرکتوری جاری.
این فایل می‌تواند برای گزارش اشکالات بسیار سودمند باشد.
این گزینه همچنین \f(CW\*(C`\-loglevel debug\*(C'\fR را شامل می‌شود.
.Sp
تنظیم متغیر محیطی \fBFFREPORT\fR روی هر مقداری اثر یکسانی دارد. اگر این مقدار یک دنباله key=value جداشده با \*(Aq:\*(Aq باشد، این گزینه‌ها بر گزارش تأثیر می‌گذارند؛ مقادیر گزینه‌ها چنانچه حاوی نویسه‌های ویژه یا جداکننده گزینه‌ها \*(Aq:\*(Aq باشند باید گریز داده شوند (به بخش "Quoting and escaping" در راهنمای ffmpeg\-utils مراجعه کنید).
.Sp
گزینه‌های زیر شناخته شده هستند:
.RS 4
.IP \fBfile\fR 4
.IX Item "file"
تنظیم نام فایل مورد استفاده برای گزارش؛ \f(CW%p\fR به نام برنامه، \f(CW%t\fR به یک برچسب زمانی و \f(CW\*(C`%%\*(C'\fR به یک \f(CW\*(C`%\*(C'\fR ساده گسترش می‌یابد.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح پرگویی لاگ با یک مقدار عددی (به \f(CW\*(C`\-loglevel\*(C'\fR مراجعه کنید).
.RE
.RS 4
.Sp
برای مثال، جهت ثبت یک گزارش در فایلی با نام \fIffreport.log\fR با استفاده از سطح لاگ \f(CW32\fR (نام مستعار سطح لاگ \f(CW\*(C`info\*(C'\fR):
.Sp
\&        FFREPORT=file=ffreport.log:level=32 ffmpeg \-i input output
.Ve
.Sp
.Sp
خطاها در تجزیه متغیر محیطی مرگبار نیستند و در گزارش ظاهر نخواهند شد.
.RE
.IP \fB\-hide_banner\fR 4
.IX Item "-hide_banner"
جلوگیری از چاپ بنر کپی‌رایت و بیلد.
.Sp
تمامی ابزارهای FFmpeg معمولاً اطلاعیه حق نشر، گزینه‌های ساخت و نسخه‌های کتابخانه‌ها را نمایش می‌دهند. از این گزینه می‌توان برای جلوگیری از چاپ این اطلاعات استفاده کرد.
.IP "\fB\-cpuflags flags (\fR\fIglobal\fR\fB)\fR" 4
.IX Item "-cpuflags flags (global)"
امکان تنظیم و پاک کردن فلگ‌های پردازنده (CPU) را فراهم می‌سازد. این گزینه برای اهداف آزمایشی در نظر گرفته شده است. از آن استفاده نکنید مگر این‌که بدانید چه کاری انجام می‌دهید.
.Sp
\&        ffmpeg \-cpuflags \-sse+mmx ...
\&        ffmpeg \-cpuflags mmx ...
\&        ffmpeg \-cpuflags 0 ...
.Ve
.Sp
.Sp
فلگ‌های ممکن برای این گزینه عبارتند از:
.RS 4
.IP \fBx86\fR 4
.IX Item "x86"
.RS 4
.PD 0
.IP \fBmmx\fR 4
.IX Item "mmx"
.IP \fBmmxext\fR 4
.IX Item "mmxext"
.IP \fBsse\fR 4
.IX Item "sse"
.IP \fBsse2\fR 4
.IX Item "sse2"
.IP \fBsse2slow\fR 4
.IX Item "sse2slow"
.IP \fBsse3\fR 4
.IX Item "sse3"
.IP \fBsse3slow\fR 4
.IX Item "sse3slow"
.IP \fBssse3\fR 4
.IX Item "ssse3"
.IP \fBatom\fR 4
.IX Item "atom"
.IP \fBsse4.1\fR 4
.IX Item "sse4.1"
.IP \fBsse4.2\fR 4
.IX Item "sse4.2"
.IP \fBavx\fR 4
.IX Item "avx"
.IP \fBavx2\fR 4
.IX Item "avx2"
.IP \fBxop\fR 4
.IX Item "xop"
.IP \fBfma3\fR 4
.IX Item "fma3"
.IP \fBfma4\fR 4
.IX Item "fma4"
.IP \fB3dnow\fR 4
.IX Item "3dnow"
.IP \fB3dnowext\fR 4
.IX Item "3dnowext"
.IP \fBbmi1\fR 4
.IX Item "bmi1"
.IP \fBbmi2\fR 4
.IX Item "bmi2"
.IP \fBcmov\fR 4
.IX Item "cmov"
.PD
.RE
.RS 4
.RE
.IP \fBARM\fR 4
.IX Item "ARM"
.RS 4
.PD 0
.IP \fBarmv5te\fR 4
.IX Item "armv5te"
.IP \fBarmv6\fR 4
.IX Item "armv6"
.IP \fBarmv6t2\fR 4
.IX Item "armv6t2"
.IP \fBvfp\fR 4
.IX Item "vfp"
.IP \fBvfpv3\fR 4
.IX Item "vfpv3"
.IP \fBneon\fR 4
.IX Item "neon"
.IP \fBsetend\fR 4
.IX Item "setend"
.PD
.RE
.RS 4
.RE
.IP \fBAArch64\fR 4
.IX Item "AArch64"
.RS 4
.PD 0
.IP \fBarmv8\fR 4
.IX Item "armv8"
.IP \fBvfp\fR 4
.IX Item "vfp"
.IP \fBneon\fR 4
.IX Item "neon"
.PD
.RE
.RS 4
.RE
.IP \fBPowerPC\fR 4
.IX Item "PowerPC"
.RS 4
.PD 0
.IP \fBaltivec\fR 4
.IX Item "altivec"
.PD
.RE
.RS 4
.RE
.IP "\fBSpecific Processors\fR" 4
.IX Item "Specific Processors"
.RS 4
.PD 0
.IP \fBpentium2\fR 4
.IX Item "pentium2"
.IP \fBpentium3\fR 4
.IX Item "pentium3"
.IP \fBpentium4\fR 4
.IX Item "pentium4"
.IP \fBk6\fR 4
.IX Item "k6"
.IP \fBk62\fR 4
.IX Item "k62"
.IP \fBathlon\fR 4
.IX Item "athlon"
.IP \fBathlonxp\fR 4
.IX Item "athlonxp"
.IP \fBk8\fR 4
.IX Item "k8"
.PD
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.IP "\fB\-cpucount\fR \fIcount\fR \fB(\fR\fIglobal\fR\fB)\fR" 4
.IX Item "-cpucount count (global)"
نادیده‌گرفتن تعداد هسته‌های پردازنده شناسایی‌شده. این گزینه برای اهداف آزمایشی در نظر گرفته شده است. از آن استفاده نکنید مگر این‌که بدانید چه کاری انجام می‌دهید.
.Sp
.Vb 1
\&        ffmpeg \-cpucount 2
.Ve
.IP "\fB\-max_alloc\fR \fIbytes\fR" 4
.IX Item "-max_alloc bytes"
تنظیم سقف حداکثر اندازه برای تخصیص یک بلوک در حافظه هیپ (heap) توسط خانواده توابع malloc در ffmpeg. هنگام استفاده از این گزینه \fBنهایت احتیاط\fR را به خرج دهید. اگر از تمام عواقب انجام آن آگاهی ندارید از آن استفاده نکنید. مقدار پیش‌فرض INT_MAX است.
.SS AVOptions
.IX Subsection "AVOptions"
این گزینه‌ها مستقیماً توسط کتابخانه‌های libavformat، libavdevice و libavcodec ارائه می‌شوند. برای مشاهده فهرست AVOptions موجود، از گزینه \fB\-help\fR استفاده کنید. آن‌ها به دو دسته تقسیم می‌شوند:
.IP \fBgeneric\fR 4
.IX Item "generic"
این گزینه‌ها را می‌توان برای هر کانتینر، کدک یا دستگاهی تنظیم کرد. گزینه‌های عمومی برای کانتینرها/دستگاه‌ها ذیل گزینه‌های AVFormatContext و برای کدک‌ها ذیل گزینه‌های AVCodecContext فهرست شده‌اند.
.IP \fBprivate\fR 4
.IX Item "private"
این گزینه‌ها مختص کانتینر، دستگاه یا کدک داده‌شده هستند. گزینه‌های اختصاصی ذیل کانتینرها/دستگاه‌ها/کدک‌های متناظر خود لیست شده‌اند.
.PP
برای مثال جهت نوشتن یک هدر ID3v2.3 به جای هدر پیش‌فرض ID3v2.4 در یک فایل MP3، از گزینه اختصاصی \fBid3v2_version\fR در ماکسر MP3 استفاده کنید:
.PP
.Vb 1
\&        ffmpeg \-i input.flac \-id3v2_version 3 out.mp3
.Ve
.PP
تمامی گزینه‌های AVOptions کدک به‌ازای‌هر‌استریم هستند، و بنابراین باید یک مشخص‌کننده استریم به آن‌ها پیوست شود:
.PP
.Vb 1
\&        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
.Ve
.PP
در مثال فوق، یک استریم صوتی چندکاناله دو بار برای خروجی نگاشت شده است. اولین نمونه با کدک ac3 و نرخ بیت 640k انکود می‌شود. دومین نمونه به ۲ کانال کاهش می‌یابد (downmix) و با کدک aac کدگذاری می‌گردد. نرخ بیت 128k برای آن با استفاده از اندیس مطلق استریم خروجی مشخص شده است.
.PP
نکته: ساختار \fB\-nooption\fR نمی‌تواند برای AVOptions بولی استفاده شود، از \fB\-option 0\fR/\fB\-option 1\fR استفاده کنید.
.PP
نکته: شیوه قدیمی و غیرمستند تعیین AVOptions به‌ازای‌هر‌استریم با افزودن پیشوند v/a/s به ابتدای نام گزینه اکنون منسوخ شده است و به زودی حذف خواهد شد.
.SS "گزینه‌های اصلی (Main options)"
.IX Subsection "Main options"
.IP "\fB\-x\fR \fIعرض\fR" 4
.IX Item "-x width"
اجبار به نمایش با این عرض (عرض تصویر).
.IP "\fB\-y\fR \fIارتفاع\fR" 4
.IX Item "-y height"
اجبار به نمایش با این ارتفاع (ارتفاع تصویر).
.IP \fB\-fs\fR 4
.IX Item "-fs"
شروع در حالت تمام صفحه (fullscreen).
.IP \fB\-an\fR 4
.IX Item "-an"
غیرفعال کردن صدا.
.IP \fB\-vn\fR 4
.IX Item "-vn"
غیرفعال کردن ویدیو.
.IP \fB\-sn\fR 4
.IX Item "-sn"
غیرفعال کردن زیرنویس.
.IP "\fB\-ss\fR \fIموقعیت\fR" 4
.IX Item "-ss pos"
پرش به موقعیت زمانی مشخص‌شده. توجه داشته باشید که در بیشتر قالب‌ها امکان پرش کاملاً دقیق وجود ندارد، بنابراین \fBffplay\fR به نزدیک‌ترین نقطه کلیدی به این موقعیت پرش می‌کند.
.IP "\fB\-t\fR \fIمدت_زمان\fR" 4
.IX Item "-t duration"
پخش به میزان مشخص‌شده از صدا/ویدیو (به ثانیه).
.IP \fB\-bytes\fR 4
.IX Item "-bytes"
پرش بر پایه بایت به جای زمان.
.IP \fB\-seek_interval\fR 4
.IX Item "-seek_interval"
تنظیم فاصله سفارشی پرش (بر حسب ثانیه) هنگام استفاده از کلیدهای چپ/راست. پیش‌فرض ۱۰ ثانیه است.
.IP \fB\-nodisp\fR 4
.IX Item "-nodisp"
غیرفعال کردن نمایش گرافیکی تصویر.
.IP \fB\-noborder\fR 4
.IX Item "-noborder"
نمایش پنجره بدون حاشیه (borderless window).
.IP \fB\-alwaysontop\fR 4
.IX Item "-alwaysontop"
پنجره همواره در بالا قرار داشته باشد.
.IP \fB\-volume\fR 4
.IX Item "-volume"
تنظیم بلندی صدای آغازین. 0 به معنای سکوت و 100 به معنای حجم صدای طبیعی بدون کاهش یا افزایش است.
.IP "\fB\-f\fR \fIقالب\fR" 4
.IX Item "-f fmt"
اجبار قالب فایل ورودی.
.IP "\fB\-window_title\fR \fIعنوان\fR" 4
.IX Item "-window_title title"
تنظیم عنوان پنجره (پیش‌فرض نام فایل ورودی است).
.IP "\fB\-left\fR \fIموقعیت_افقی\fR" 4
.IX Item "-left title"
تنظیم موقعیت افقی x برای سمت چپ پنجره (پیش‌فرض پنجره وسط‌چین است).
.IP "\fB\-top\fR \fIموقعیت_عمودی\fR" 4
.IX Item "-top title"
تنظیم موقعیت عمودی y برای بالای پنجره (پیش‌فرض پنجره وسط‌چین است).
.IP "\fB\-loop\fR \fIتعداد\fR" 4
.IX Item "-loop number"
تکرار پخش فیلم به میزان <تعداد> بار. مقدار 0 به معنای تکرار نامحدود است.
.IP "\fB\-showmode\fR \fIحالت\fR" 4
.IX Item "-showmode mode"
تنظیم حالت نمایش مورد استفاده. مقادیر ممکن عبارتند از:
.RS 4
.IP "\fB0, video\fR" 4
.IX Item "0, video"
نمایش ویدیو
.IP "\fB1, waves\fR" 4
.IX Item "1, waves"
نمایش امواج صوتی
.IP "\fB2, rdft\fR" 4
.IX Item "2, rdft"
نمایش باند فرکانس صوتی با استفاده از RDFT
.RE
.RS 4
.Sp
مقدار پیش‌فرض "video" است. با فشردن کلید \fBw\fR می‌توانید بین حالت‌ها جابه‌جا شوید.
.RE
.IP "\fB\-vf\fR \fIfiltergraph\fR" 4
.IX Item "-vf filtergraph"
ایجاد گراف فیلتر مشخص‌شده و استفاده از آن برای فیلتر کردن استریم ویدیو.
.IP "\fB\-af\fR \fIfiltergraph\fR" 4
.IX Item "-af filtergraph"
گراف فیلتر برای اعمال روی صدای ورودی.
.IP "\fB\-i\fR \fIurl\fR" 4
.IX Item "-i input_url"
خواندن از نشانی ورودی.
.SS "گزینه‌های پیشرفته (Advanced options)"
.IX Subsection "Advanced options"
.IP \fB\-stats\fR 4
.IX Item "-stats"
چاپ آمارهای مختلف پخش شامل مدت استریم، پارامترهای کدک، موقعیت فعلی در استریم و رانش همگام‌سازی صدا/تصویر. برای غیرفعال کردن از \f(CW\*(C`\-nostats\*(C'\fR استفاده کنید.
.IP \fB\-fast\fR 4
.IX Item "-fast"
بهینه‌سازی‌های غیراستاندارد برای افزایش سرعت.
.IP \fB\-genpts\fR 4
.IX Item "-genpts"
تولید pts (برچسب‌های زمانی ارائه).
.IP "\fB\-sync\fR \fIname\fR" 4
.IX Item "-sync type"
تنظیم ساعت مرجع اصلی روی صدا (\f(CW\*(C`type=audio\*(C'\fR)، ویدیو (\f(CW\*(C`type=video\*(C'\fR) یا خارجی (\f(CW\*(C`type=ext\*(C'\fR). پیش‌فرض صدا است.
.IP "\fB\-ast\fR \fIتعیین‌کننده_استریم_صدا\fR" 4
.IX Item "-ast audio_stream_specifier"
انتخاب استریم صوتی دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
.IP "\fB\-vst\fR \fIتعیین‌کننده_استریم_ویدیو\fR" 4
.IX Item "-vst video_stream_specifier"
انتخاب استریم ویدیویی دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
.IP "\fB\-sst\fR \fIتعیین‌کننده_استریم_زیرنویس\fR" 4
.IX Item "-sst subtitle_stream_specifier"
انتخاب استریم زیرنویس دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
.IP \fB\-autoexit\fR 4
.IX Item "-autoexit"
خروج خودکار از برنامه هنگام پایان یافتن پخش ویدیو.
.IP \fB\-exitonkeydown\fR 4
.IX Item "-exitonkeydown"
خروج در صورت فشرده شدن هر کلیدی روی صفحه‌کلید.
.IP \fB\-exitonmousedown\fR 4
.IX Item "-exitonmousedown"
خروج در صورت کلیک شدن هر دکمه‌ای از موش‌واره (ماوس).
.IP "\fB\-codec:\fR\fImedia_specifier\fR\fB \fR\fIcodec_name\fR" 4
.IX Item "-codec:media_specifier codec_name"
اجبار پیاده‌سازی یک دیکودر خاص برای استریم مشخص‌شده با \fImedia_specifier\fR (شامل \f(CW\*(C`a\*(C'\fR برای صدا، \f(CW\*(C`v\*(C'\fR برای ویدیو و \f(CW\*(C`s\*(C'\fR برای زیرنویس).
.IP "\fB\-acodec\fR \fIcodec_name\fR" 4
.IX Item "-acodec codec_name"
اجبار دیکودر صوتی خاص.
.IP "\fB\-vcodec\fR \fIcodec_name\fR" 4
.IX Item "-vcodec codec_name"
اجبار دیکودر ویدیویی خاص.
.IP "\fB\-scodec\fR \fIcodec_name\fR" 4
.IX Item "-scodec codec_name"
اجبار دیکودر زیرنویس خاص.
.IP \fB\-autorotate\fR 4
.IX Item "-autorotate"
چرخش خودکار ویدیو بر اساس فراداده فایل. به طور پیش‌فرض فعال است. برای غیرفعال کردن از \fB\-noautorotate\fR استفاده کنید.
.IP \fB\-framedrop\fR 4
.IX Item "-framedrop"
ریختن فریم‌های ویدیویی (Drop frames) در صورت عدم هماهنگی ویدیو با صدا.
.IP \fB\-infbuf\fR 4
.IX Item "-infbuf"
نامحدود کردن اندازه بافر ورودی، خواندن هرچه سریع‌تر داده‌ها از ورودی.
.IP "\fB\-filter_threads\fR \fInb_threads\fR" 4
.IX Item "-filter_threads nb_threads"
تعیین تعداد رشته‌های پردازشی (threads) مورد استفاده برای پایپ‌لاین فیلتر.
.IP \fB\-enable_vulkan\fR 4
.IX Item "-enable_vulkan"
استفاده از رندرکننده Vulkan به جای رندرکننده داخلی SDL. وابسته به libplacebo است.
.IP \fB\-vulkan_params\fR 4
.IX Item "-vulkan_params"
پیکربندی ولکان (Vulkan) با استفاده از فهرستی از جفت‌های \fIkey\fR=\fIvalue\fR که با «:» از یکدیگر جدا شده‌اند.
.IP \fB\-hwaccel\fR 4
.IX Item "-hwaccel"
استفاده از رمزگشایی با شتاب‌دهنده سخت‌افزاری. فعال کردن این گزینه، رندرکننده ولکان را به صورت خودکار فعال خواهد کرد.
.IP "\fB\-video_bg\fR \fIالگو\fR" 4
.IX Item "-video_bg pattern"
تنظیم الگوی پس‌زمینه ویدیو برای ویدیوهای شفاف (دارای کانال آلفا). برای الگوهای تک‌رنگ ساده می‌توانید از نام رنگ یا کد رنگ به صورتی که در
\&\fBبخش Color در راهنمای ffmpeg\-utils\|(1)\fR
مشخص شده است استفاده کنید.
همچنین می‌توانید از کلمه کلیدی ویژه \f(CW\*(C`tiles\*(C'R برای یک الگوی شطرنجی استفاده کنید که حالت پیش‌فرض نیز است. الگوی \f(CW\*(C`none\*(C'R بدون ترکیب آلفا (alpha blending) رندر را انجام می‌دهد و در واقع کانال آلفا را نادیده می‌گیرد.
.SS "هنگام پخش (While playing)"
.IX Subsection "While playing"
کلیدهای میانبر در زمان پخش:
.IP "\fBq, ESC\fR" 4
.IX Item "q, ESC"
خروج از برنامه.
.IP \fBf\fR 4
.IX Item "f"
جابه‌جایی بین حالت تمام‌صفحه و پنجره‌ای.
.IP "\fBp, فاصله (SPC)\fR" 4
.IX Item "p, SPC"
مکث (Pause) و ادامه پخش.
.IP \fBm\fR 4
.IX Item "m"
قطع/وصل صدا (Mute).
.IP "\fB9, 0\fR" 4
.IX Item "9, 0"
.PD 0
.IP "\fB/, *\fR" 4
.IX Item "/, *"
.PD
کاهش و افزایش حجم صدا به ترتیب.
.IP \fBa\fR 4
.IX Item "a"
جابه‌جایی بین کانال‌های صوتی در برنامه جاری.
.IP \fBv\fR 4
.IX Item "v"
جابه‌جایی بین کانال‌های ویدیویی.
.IP \fBt\fR 4
.IX Item "t"
جابه‌جایی بین کانال‌های زیرنویس در برنامه جاری.
.IP \fBc\fR 4
.IX Item "c"
جابه‌جایی بین برنامه‌ها (Programs).
.IP \fBw\fR 4
.IX Item "w"
جابه‌جایی بین حالت‌های نمایش صوتی یا فیلترهای ویدیویی.
.IP \fBs\fR 4
.IX Item "s"
گام به فریم بعدی (نمایش فریم‌به‌فریم).
.IP "\fBچپ/راست (left/right)\fR" 4
.IX Item "left/right"
پرش به عقب/جلو به میزان ۱۰ ثانیه (یا فاصله سفارشی با \-seek_interval).
.IP "\fBپایین/بالا (down/up)\fR" 4
.IX Item "down/up"
پرش به عقب/جلو به میزان ۱ دقیقه.
.IP "\fBصفحه بعد/صفحه قبل (page down/page up)\fR" 4
.IX Item "page down/page up"
پرش به فصل قبل/بعد (یا ۱۰ دقیقه عقب/جلو در صورت عدم وجود فصل‌ها).
.IP "\fBراست‌کلیک موش‌واره (right mouse click)\fR" 4
.IX Item "right mouse click"
پرش به درصدی از فایل متناظر با عرض پنجره کلیک‌شده.
.IP "\fBدوبار‌کلیک چپ موش‌واره (left mouse double\-click)\fR" 4
.IX Item "left mouse double-click"
تغییر وضعیت تمام صفحه.
.SH "سینتکس و قالب‌ها (SYNTAX)"
.IX Header "SYNTAX"
این بخش سینتکس و قالب‌های مورد استفاده توسط کتابخانه‌ها و ابزارهای FFmpeg را شرح می‌دهد.
.SS "نقل‌قول و گریز (Quoting and escaping)"
.IX Subsection "Quoting and escaping"
ابزار FFmpeg سازوکار نقل‌قول و گریز (Quoting and Escaping) زیر را به کار می‌گیرد، مگر اینکه صریحاً چیز دیگری مشخص شده باشد. قواعد زیر اعمال می‌شوند:
.IP \(bu 4
\&\fB\*(Aq\fR و \fB\e\fR نویسه‌های ویژه هستند (به ترتیب برای نقل‌قول و گریز/اسکیپ استفاده می‌شوند). علاوه بر آن‌ها، بسته به سینتکس خاصی که اسکیپ و نقل‌قول در آن به کار می‌رود ممکن است نویسه‌های ویژهٔ دیگری نیز وجود داشته باشند.
.IP \(bu 4
یک نویسهٔ ویژه با قرار دادن پیشوند \fB\e\fR قبل از آن اسکیپ می‌شود.
.IP \(bu 4
تمام نویسه‌های محصور میان \fB\*(Aq\*(Aq\fR به صورت تحت‌اللفظی (literal) در رشتهٔ پردازش‌شده گنجانده می‌شوند. خود نویسهٔ نقل‌قول \fB\*(Aq\fR نمی‌تواند داخل نقل‌قول قرار گیرد، بنابراین ممکن است لازم باشد نقل‌قول را ببندید و آن را اسکیپ کنید.
.IP \(bu 4
فاصله‌های خالی (whitespaces) ابتدایی و انتهایی، مگر اینکه اسکیپ یا در نقل‌قول قرار گرفته باشند، از رشتهٔ پردازش‌شده حذف می‌شوند.
.PP
توجه داشته باشید که هنگام استفاده از خط فرمان یا یک اسکریپت، ممکن است لازم باشد یک سطح دوم از اسکیپ کردن را اضافه کنید، که به سینتکس زبان پوسته (shell) مورد استفاده بستگی دارد.
.PP
تابع \f(CW\*(C`av_get_token\*(C'\fR تعریف‌شده در \&\fIlibavutil/avstring.h\fR می‌تواند برای تجزیه توکنی که بر اساس قواعد تعریف‌شده در بالا نقل‌قول یا اسکیپ شده است استفاده شود.
.PP
ابزار \fItools/ffescape\fR در درخت منبع FFmpeg می‌تواند برای نقل‌قول یا اسکیپ کردن خودکار یک رشته در اسکریپت استفاده شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اسکیپ کردن رشتهٔ \f(CW\*(C`Crime d\*(AqAmour\*(C'\fR شامل نویسهٔ ویژهٔ \f(CW\*(C`\*(Aq\*(C'\fR:
.Sp
.Vb 1
\&        Crime d\e\*(AqAmour
.Ve
.IP \(bu 4
رشته بالا شامل یک کوتیشن است، بنابراین هنگام قرار دادن آن در نقل‌قول، \f(CW\*(C`\*(Aq\*(C'\fR باید اسکیپ شود:
.Sp
.Vb 1
\&        \*(AqCrime d\*(Aq\e\*(Aq\*(AqAmour\*(Aq
.Ve
.IP \(bu 4
گنجاندن فاصله‌های خالی ابتدایی یا انتهایی با استفاده از نقل‌قول:
.Sp
.Vb 1
\&        \*(Aq  this string starts and ends with whitespaces  \*(Aq
.Ve
.IP \(bu 4
اسکیپ کردن و نقل‌قول می‌توانند با هم ترکیب شوند:
.Sp
.Vb 1
\&        \*(Aq The string \*(Aq\e\*(Aqstring\e\*(Aq\*(Aq is a string \*(Aq
.Ve
.IP \(bu 4
برای گنجاندن یک \fB\e\fR واقعی می‌توانید از اسکیپ کردن یا نقل‌قول استفاده کنید:
.Sp
.Vb 1
\&        \*(Aqc:\efoo\*(Aq can be written as c:\e\efoo
.Ve
.SS "تاریخ (Date)"
.IX Subsection "Date"
سینتکس پذیرفته‌شده عبارت است از:
.PP
.Vb 2
\&        [(YYYY\-MM\-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
\&        now
.Ve
.PP
اگر مقدار برابر با "now" باشد، زمان فعلی را می‌گیرد.
.PP
زمان به عنوان زمان محلی تفسیر می‌شود مگر اینکه Z به آن اضافه شود، که در این صورت به عنوان UTC در نظر گرفته می‌شود.
اگر بخش سال-ماه-روز مشخص نشود، سال-ماه-روز فعلی را در نظر می‌گیرد.
.SS "مدت زمان (Time duration)"
.IX Subsection "Time duration"
دو سینتکس پذیرفته‌شده برای بیان مدت زمان وجود دارد:
.PP
.Vb 1
\&        [\-][<HH>:]<MM>:<SS>[.<m>...]
.Ve
.PP
\&\fIHH\fR تعداد ساعت‌ها، \fIMM\fR تعداد دقیقه‌ها را با حداکثر ۲ رقم، و \fISS\fR تعداد ثانیه‌ها را با حداکثر ۲ رقم بیان می‌کند. مقدار \fIm\fR در انتها مقدار اعشاری را برای \&\fISS\fR بیان می‌نماید.
.PP
\&\fIیا\fR
.PP
.Vb 1
\&        [\-]<S>+[.<m>...][s|ms|us]
.Ve
.PP
\&\fIS\fR تعداد ثانیه‌ها را همراه با بخش اعشاری اختیاری \&\fIm\fR بیان می‌کند. پسوندهای اختیاری \fBs\fR، \fBms\fR یا \fBus\fR به ترتیب نشان‌دهنده تفسیر مقدار بر حسب ثانیه، میلی‌ثانیه یا میکروثانیه هستند.
.PP
در هر دو عبارت، علامت اختیاری \fB\-\fR نشان‌دهنده مدت زمان منفی است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.PP
مثال‌های زیر همگی مدت زمان‌های معتبر هستند:
.IP \fB55\fR 4
.IX Item "55"
55 ثانیه
.IP \fB0.2\fR 4
.IX Item "0.2"
0.2 ثانیه
.IP \fB200ms\fR 4
.IX Item "200ms"
200 میلی‌ثانیه، یعنی 0.2s
.IP \fB200000us\fR 4
.IX Item "200000us"
200000 میکروثانیه، یعنی 0.2s
.IP \fB12:03:45\fR 4
.IX Item "12:03:45"
12 ساعت و 03 دقیقه و 45 ثانیه
.IP \fB23.189\fR 4
.IX Item "23.189"
23.189 ثانیه
.SS "اندازه ویدیو (Video size)"
.IX Subsection "Video size"
اندازه ویدیوی منبع را مشخص می‌کند، می‌تواند رشته‌ای به شکل \&\fIwidth\fRx\fIheight\fR یا نام یکی از اختصارات اندازه باشد.
.PP
اختصارات زیر شناخته‌شده هستند:
.IP \fBntsc\fR 4
.IX Item "ntsc"
720x480
.IP \fBpal\fR 4
.IX Item "pal"
720x576
.IP \fBqntsc\fR 4
.IX Item "qntsc"
352x240
.IP \fBqpal\fR 4
.IX Item "qpal"
352x288
.IP \fBsntsc\fR 4
.IX Item "sntsc"
640x480
.IP \fBspal\fR 4
.IX Item "spal"
768x576
.IP \fBfilm\fR 4
.IX Item "film"
352x240
.IP \fBntsc\-film\fR 4
.IX Item "ntsc-film"
352x240
.IP \fBsqcif\fR 4
.IX Item "sqcif"
128x96
.IP \fBqcif\fR 4
.IX Item "qcif"
176x144
.IP \fBcif\fR 4
.IX Item "cif"
352x288
.IP \fB4cif\fR 4
.IX Item "4cif"
704x576
.IP \fB16cif\fR 4
.IX Item "16cif"
1408x1152
.IP \fBqqvga\fR 4
.IX Item "qqvga"
160x120
.IP \fBqvga\fR 4
.IX Item "qvga"
320x240
.IP \fBvga\fR 4
.IX Item "vga"
640x480
.IP \fBsvga\fR 4
.IX Item "svga"
800x600
.IP \fBxga\fR 4
.IX Item "xga"
1024x768
.IP \fBuxga\fR 4
.IX Item "uxga"
1600x1200
.IP \fBqxga\fR 4
.IX Item "qxga"
2048x1536
.IP \fBsxga\fR 4
.IX Item "sxga"
1280x1024
.IP \fBqsxga\fR 4
.IX Item "qsxga"
2560x2048
.IP \fBhsxga\fR 4
.IX Item "hsxga"
5120x4096
.IP \fBwvga\fR 4
.IX Item "wvga"
852x480
.IP \fBwxga\fR 4
.IX Item "wxga"
1366x768
.IP \fBwsxga\fR 4
.IX Item "wsxga"
1600x1024
.IP \fBwuxga\fR 4
.IX Item "wuxga"
1920x1200
.IP \fBwoxga\fR 4
.IX Item "woxga"
2560x1600
.IP \fBwqsxga\fR 4
.IX Item "wqsxga"
3200x2048
.IP \fBwquxga\fR 4
.IX Item "wquxga"
3840x2400
.IP \fBwhsxga\fR 4
.IX Item "whsxga"
6400x4096
.IP \fBwhuxga\fR 4
.IX Item "whuxga"
7680x4800
.IP \fBcga\fR 4
.IX Item "cga"
320x200
.IP \fBega\fR 4
.IX Item "ega"
640x350
.IP \fBhd480\fR 4
.IX Item "hd480"
852x480
.IP \fBhd720\fR 4
.IX Item "hd720"
1280x720
.IP \fBhd1080\fR 4
.IX Item "hd1080"
1920x1080
.IP \fB2k\fR 4
.IX Item "2k"
2048x1080
.IP \fB2kflat\fR 4
.IX Item "2kflat"
1998x1080
.IP \fB2kscope\fR 4
.IX Item "2kscope"
2048x858
.IP \fB4k\fR 4
.IX Item "4k"
4096x2160
.IP \fB4kflat\fR 4
.IX Item "4kflat"
3996x2160
.IP \fB4kscope\fR 4
.IX Item "4kscope"
4096x1716
.IP \fBnhd\fR 4
.IX Item "nhd"
640x360
.IP \fBhqvga\fR 4
.IX Item "hqvga"
240x160
.IP \fBwqvga\fR 4
.IX Item "wqvga"
400x240
.IP \fBfwqvga\fR 4
.IX Item "fwqvga"
432x240
.IP \fBhvga\fR 4
.IX Item "hvga"
480x320
.IP \fBqhd\fR 4
.IX Item "qhd"
960x540
.IP \fB2kdci\fR 4
.IX Item "2kdci"
2048x1080
.IP \fB4kdci\fR 4
.IX Item "4kdci"
4096x2160
.IP \fBuhd2160\fR 4
.IX Item "uhd2160"
3840x2160
.IP \fBuhd4320\fR 4
.IX Item "uhd4320"
7680x4320
.SS "نرخ فریم ویدیو (Video rate)"
.IX Subsection "Video rate"
نرخ فریم ویدیو را مشخص می‌کند که بر حسب تعداد فریم‌های تولیدشده در هر ثانیه بیان می‌شود. باید رشته‌ای در قالب \&\fIframe_rate_num\fR/\fIframe_rate_den\fR، یک عدد صحیح، یک عدد اعشاری یا یک اختصار معتبر نرخ فریم ویدیو باشد.
.PP
اختصارات زیر شناخته‌شده هستند:
.IP \fBntsc\fR 4
.IX Item "ntsc"
30000/1001
.IP \fBpal\fR 4
.IX Item "pal"
25/1
.IP \fBqntsc\fR 4
.IX Item "qntsc"
30000/1001
.IP \fBqpal\fR 4
.IX Item "qpal"
25/1
.IP \fBsntsc\fR 4
.IX Item "sntsc"
30000/1001
.IP \fBspal\fR 4
.IX Item "spal"
25/1
.IP \fBfilm\fR 4
.IX Item "film"
24/1
.IP \fBntsc\-film\fR 4
.IX Item "ntsc-film"
24000/1001
.SS "نسبت ابعاد (Ratio)"
.IX Subsection "Ratio"
یک نسبت می‌تواند به صورت یک عبارت محاسباتی، یا به شکل \&\fInumerator\fR:\fIdenominator\fR بیان شود.
.PP
توجه داشته باشید که نسبت با مقدار بی‌نهایت (1/0) یا منفی معتبر در نظر گرفته می‌شود، بنابراین اگر می‌خواهید این مقادیر را مستثنی کنید باید مقدار بازگردانده‌شده را بررسی نمایید.
.PP
مقدار تعریف‌نشده می‌تواند با استفاده از رشتهٔ "0:0" بیان شود.
.SS "رنگ (Color)"
.IX Subsection "Color"
می‌تواند نام یک رنگ همان‌طور که در زیر تعریف شده است (تطبیق غیرحساس به حروف بزرگ و کوچک) یا یک توالی \&\f(CW\*(C`[0x|#]RRGGBB[AA]\*(C'\fR باشد که ممکن است با @ و یک رشته به عنوان مولفهٔ آلفا دنبال شود.
.PP
مولفهٔ آلفا ممکن است رشته‌ای متشکل از "0x" و به دنبال آن یک عدد هگزادسیمال یا یک عدد اعشاری بین 0.0 و 1.0 باشد که مقدار شفافیت (opacity) را نشان می‌دهد (\fB0x00\fR یا \fB0.0\fR به معنی کاملاً شفاف، \fB0xff\fR یا \fB1.0\fR به معنی کاملاً مات است). اگر مولفهٔ آلفا مشخص نشود، \fB0xff\fR در نظر گرفته می‌شود.
.PP
رشتهٔ \fBrandom\fR منجر به یک رنگ تصادفی خواهد شد.
.PP
نام‌های رنگ‌های زیر شناخته‌شده هستند:
.IP \fBAliceBlue\fR 4
.IX Item "AliceBlue"
0xF0F8FF
.IP \fBAntiqueWhite\fR 4
.IX Item "AntiqueWhite"
0xFAEBD7
.IP \fBAqua\fR 4
.IX Item "Aqua"
0x00FFFF
.IP \fBAquamarine\fR 4
.IX Item "Aquamarine"
0x7FFFD4
.IP \fBAzure\fR 4
.IX Item "Azure"
0xF0FFFF
.IP \fBBeige\fR 4
.IX Item "Beige"
0xF5F5DC
.IP \fBBisque\fR 4
.IX Item "Bisque"
0xFFE4C4
.IP \fBBlack\fR 4
.IX Item "Black"
0x000000
.IP \fBBlanchedAlmond\fR 4
.IX Item "BlanchedAlmond"
0xFFEBCD
.IP \fBBlue\fR 4
.IX Item "Blue"
0x0000FF
.IP \fBBlueViolet\fR 4
.IX Item "BlueViolet"
0x8A2BE2
.IP \fBBrown\fR 4
.IX Item "Brown"
0xA52A2A
.IP \fBBurlyWood\fR 4
.IX Item "BurlyWood"
0xDEB887
.IP \fBCadetBlue\fR 4
.IX Item "CadetBlue"
0x5F9EA0
.IP \fBChartreuse\fR 4
.IX Item "Chartreuse"
0x7FFF00
.IP \fBChocolate\fR 4
.IX Item "Chocolate"
0xD2691E
.IP \fBCoral\fR 4
.IX Item "Coral"
0xFF7F50
.IP \fBCornflowerBlue\fR 4
.IX Item "CornflowerBlue"
0x6495ED
.IP \fBCornsilk\fR 4
.IX Item "Cornsilk"
0xFFF8DC
.IP \fBCrimson\fR 4
.IX Item "Crimson"
0xDC143C
.IP \fBCyan\fR 4
.IX Item "Cyan"
0x00FFFF
.IP \fBDarkBlue\fR 4
.IX Item "DarkBlue"
0x00008B
.IP \fBDarkCyan\fR 4
.IX Item "DarkCyan"
0x008B8B
.IP \fBDarkGoldenRod\fR 4
.IX Item "DarkGoldenRod"
0xB8860B
.IP \fBDarkGray\fR 4
.IX Item "DarkGray"
0xA9A9A9
.IP \fBDarkGreen\fR 4
.IX Item "DarkGreen"
0x006400
.IP \fBDarkKhaki\fR 4
.IX Item "DarkKhaki"
0xBDB76B
.IP \fBDarkMagenta\fR 4
.IX Item "DarkMagenta"
0x8B008B
.IP \fBDarkOliveGreen\fR 4
.IX Item "DarkOliveGreen"
0x556B2F
.IP \fBDarkorange\fR 4
.IX Item "Darkorange"
0xFF8C00
.IP \fBDarkOrchid\fR 4
.IX Item "DarkOrchid"
0x9932CC
.IP \fBDarkRed\fR 4
.IX Item "DarkRed"
0x8B0000
.IP \fBDarkSalmon\fR 4
.IX Item "DarkSalmon"
0xE9967A
.IP \fBDarkSeaGreen\fR 4
.IX Item "DarkSeaGreen"
0x8FBC8F
.IP \fBDarkSlateBlue\fR 4
.IX Item "DarkSlateBlue"
0x483D8B
.IP \fBDarkSlateGray\fR 4
.IX Item "DarkSlateGray"
0x2F4F4F
.IP \fBDarkTurquoise\fR 4
.IX Item "DarkTurquoise"
0x00CED1
.IP \fBDarkViolet\fR 4
.IX Item "DarkViolet"
0x9400D3
.IP \fBDeepPink\fR 4
.IX Item "DeepPink"
0xFF1493
.IP \fBDeepSkyBlue\fR 4
.IX Item "DeepSkyBlue"
0x00BFFF
.IP \fBDimGray\fR 4
.IX Item "DimGray"
0x696969
.IP \fBDodgerBlue\fR 4
.IX Item "DodgerBlue"
0x1E90FF
.IP \fBFireBrick\fR 4
.IX Item "FireBrick"
0xB22222
.IP \fBFloralWhite\fR 4
.IX Item "FloralWhite"
0xFFFAF0
.IP \fBForestGreen\fR 4
.IX Item "ForestGreen"
0x228B22
.IP \fBFuchsia\fR 4
.IX Item "Fuchsia"
0xFF00FF
.IP \fBGainsboro\fR 4
.IX Item "Gainsboro"
0xDCDCDC
.IP \fBGhostWhite\fR 4
.IX Item "GhostWhite"
0xF8F8FF
.IP \fBGold\fR 4
.IX Item "Gold"
0xFFD700
.IP \fBGoldenRod\fR 4
.IX Item "GoldenRod"
0xDAA520
.IP \fBGray\fR 4
.IX Item "Gray"
0x808080
.IP \fBGreen\fR 4
.IX Item "Green"
0x008000
.IP \fBGreenYellow\fR 4
.IX Item "GreenYellow"
0xADFF2F
.IP \fBHoneyDew\fR 4
.IX Item "HoneyDew"
0xF0FFF0
.IP \fBHotPink\fR 4
.IX Item "HotPink"
0xFF69B4
.IP \fBIndianRed\fR 4
.IX Item "IndianRed"
0xCD5C5C
.IP \fBIndigo\fR 4
.IX Item "Indigo"
0x4B0082
.IP \fBIvory\fR 4
.IX Item "Ivory"
0xFFFFF0
.IP \fBKhaki\fR 4
.IX Item "Khaki"
0xF0E68C
.IP \fBLavender\fR 4
.IX Item "Lavender"
0xE6E6FA
.IP \fBLavenderBlush\fR 4
.IX Item "LavenderBlush"
0xFFF0F5
.IP \fBLawnGreen\fR 4
.IX Item "LawnGreen"
0x7CFC00
.IP \fBLemonChiffon\fR 4
.IX Item "LemonChiffon"
0xFFFACD
.IP \fBLightBlue\fR 4
.IX Item "LightBlue"
0xADD8E6
.IP \fBLightCoral\fR 4
.IX Item "LightCoral"
0xF08080
.IP \fBLightCyan\fR 4
.IX Item "LightCyan"
0xE0FFFF
.IP \fBLightGoldenRodYellow\fR 4
.IX Item "LightGoldenRodYellow"
0xFAFAD2
.IP \fBLightGreen\fR 4
.IX Item "LightGreen"
0x90EE90
.IP \fBLightGrey\fR 4
.IX Item "LightGrey"
0xD3D3D3
.IP \fBLightPink\fR 4
.IX Item "LightPink"
0xFFB6C1
.IP \fBLightSalmon\fR 4
.IX Item "LightSalmon"
0xFFA07A
.IP \fBLightSeaGreen\fR 4
.IX Item "LightSeaGreen"
0x20B2AA
.IP \fBLightSkyBlue\fR 4
.IX Item "LightSkyBlue"
0x87CEFA
.IP \fBLightSlateGray\fR 4
.IX Item "LightSlateGray"
0x778899
.IP \fBLightSteelBlue\fR 4
.IX Item "LightSteelBlue"
0xB0C4DE
.IP \fBLightYellow\fR 4
.IX Item "LightYellow"
0xFFFFE0
.IP \fBLime\fR 4
.IX Item "Lime"
0x00FF00
.IP \fBLimeGreen\fR 4
.IX Item "LimeGreen"
0x32CD32
.IP \fBLinen\fR 4
.IX Item "Linen"
0xFAF0E6
.IP \fBMagenta\fR 4
.IX Item "Magenta"
0xFF00FF
.IP \fBMaroon\fR 4
.IX Item "Maroon"
0x800000
.IP \fBMediumAquaMarine\fR 4
.IX Item "MediumAquaMarine"
0x66CDAA
.IP \fBMediumBlue\fR 4
.IX Item "MediumBlue"
0x0000CD
.IP \fBMediumOrchid\fR 4
.IX Item "MediumOrchid"
0xBA55D3
.IP \fBMediumPurple\fR 4
.IX Item "MediumPurple"
0x9370D8
.IP \fBMediumSeaGreen\fR 4
.IX Item "MediumSeaGreen"
0x3CB371
.IP \fBMediumSlateBlue\fR 4
.IX Item "MediumSlateBlue"
0x7B68EE
.IP \fBMediumSpringGreen\fR 4
.IX Item "MediumSpringGreen"
0x00FA9A
.IP \fBMediumTurquoise\fR 4
.IX Item "MediumTurquoise"
0x48D1CC
.IP \fBMediumVioletRed\fR 4
.IX Item "MediumVioletRed"
0xC71585
.IP \fBMidnightBlue\fR 4
.IX Item "MidnightBlue"
0x191970
.IP \fBMintCream\fR 4
.IX Item "MintCream"
0xF5FFFA
.IP \fBMistyRose\fR 4
.IX Item "MistyRose"
0xFFE4E1
.IP \fBMoccasin\fR 4
.IX Item "Moccasin"
0xFFE4B5
.IP \fBNavajoWhite\fR 4
.IX Item "NavajoWhite"
0xFFDEAD
.IP \fBNavy\fR 4
.IX Item "Navy"
0x000080
.IP \fBOldLace\fR 4
.IX Item "OldLace"
0xFDF5E6
.IP \fBOlive\fR 4
.IX Item "Olive"
0x808000
.IP \fBOliveDrab\fR 4
.IX Item "OliveDrab"
0x6B8E23
.IP \fBOrange\fR 4
.IX Item "Orange"
0xFFA500
.IP \fBOrangeRed\fR 4
.IX Item "OrangeRed"
0xFF4500
.IP \fBOrchid\fR 4
.IX Item "Orchid"
0xDA70D6
.IP \fBPaleGoldenRod\fR 4
.IX Item "PaleGoldenRod"
0xEEE8AA
.IP \fBPaleGreen\fR 4
.IX Item "PaleGreen"
0x98FB98
.IP \fBPaleTurquoise\fR 4
.IX Item "PaleTurquoise"
0xAFEEEE
.IP \fBPaleVioletRed\fR 4
.IX Item "PaleVioletRed"
0xD87093
.IP \fBPapayaWhip\fR 4
.IX Item "PapayaWhip"
0xFFEFD5
.IP \fBPeachPuff\fR 4
.IX Item "PeachPuff"
0xFFDAB9
.IP \fBPeru\fR 4
.IX Item "Peru"
0xCD853F
.IP \fBPink\fR 4
.IX Item "Pink"
0xFFC0CB
.IP \fBPlum\fR 4
.IX Item "Plum"
0xDDA0DD
.IP \fBPowderBlue\fR 4
.IX Item "PowderBlue"
0xB0E0E6
.IP \fBPurple\fR 4
.IX Item "Purple"
0x800080
.IP \fBRed\fR 4
.IX Item "Red"
0xFF0000
.IP \fBRosyBrown\fR 4
.IX Item "RosyBrown"
0xBC8F8F
.IP \fBRoyalBlue\fR 4
.IX Item "RoyalBlue"
0x4169E1
.IP \fBSaddleBrown\fR 4
.IX Item "SaddleBrown"
0x8B4513
.IP \fBSalmon\fR 4
.IX Item "Salmon"
0xFA8072
.IP \fBSandyBrown\fR 4
.IX Item "SandyBrown"
0xF4A460
.IP \fBSeaGreen\fR 4
.IX Item "SeaGreen"
0x2E8B57
.IP \fBSeaShell\fR 4
.IX Item "SeaShell"
0xFFF5EE
.IP \fBSienna\fR 4
.IX Item "Sienna"
0xA0522D
.IP \fBSilver\fR 4
.IX Item "Silver"
0xC0C0C0
.IP \fBSkyBlue\fR 4
.IX Item "SkyBlue"
0x87CEEB
.IP \fBSlateBlue\fR 4
.IX Item "SlateBlue"
0x6A5ACD
.IP \fBSlateGray\fR 4
.IX Item "SlateGray"
0x708090
.IP \fBSnow\fR 4
.IX Item "Snow"
0xFFFAFA
.IP \fBSpringGreen\fR 4
.IX Item "SpringGreen"
0x00FF7F
.IP \fBSteelBlue\fR 4
.IX Item "SteelBlue"
0x4682B4
.IP \fBTan\fR 4
.IX Item "Tan"
0xD2B48C
.IP \fBTeal\fR 4
.IX Item "Teal"
0x008080
.IP \fBThistle\fR 4
.IX Item "Thistle"
0xD8BFD8
.IP \fBTomato\fR 4
.IX Item "Tomato"
0xFF6347
.IP \fBTurquoise\fR 4
.IX Item "Turquoise"
0x40E0D0
.IP \fBViolet\fR 4
.IX Item "Violet"
0xEE82EE
.IP \fBWheat\fR 4
.IX Item "Wheat"
0xF5DEB3
.IP \fBWhite\fR 4
.IX Item "White"
0xFFFFFF
.IP \fBWhiteSmoke\fR 4
.IX Item "WhiteSmoke"
0xF5F5F5
.IP \fBYellow\fR 4
.IX Item "Yellow"
0xFFFF00
.IP \fBYellowGreen\fR 4
.IX Item "YellowGreen"
0x9ACD32
.SS "چینش کانال‌ها (Channel Layout)"
.IX Subsection "Channel Layout"
چینش کانال‌ها آرایش مکانی کانال‌ها را در یک استریم صوتی چندکاناله مشخص می‌کند. برای مشخص کردن چینش کانال، FFmpeg از سینتکس ویژه‌ای استفاده می‌نماید.
.PP
کانال‌های منفرد با یک شناسه همان‌طور که در جدول زیر آمده است مشخص می‌شوند:
.IP \fBFL\fR 4
.IX Item "FL"
جلوی چپ (front left)
.IP \fBFR\fR 4
.IX Item "FR"
جلوی راست (front right)
.IP \fBFC\fR 4
.IX Item "FC"
جلوی مرکز (front center)
.IP \fBLFE\fR 4
.IX Item "LFE"
فرکانس پایین / ساب‌ووفر (low frequency)
.IP \fBBL\fR 4
.IX Item "BL"
عقب چپ (back left)
.IP \fBBR\fR 4
.IX Item "BR"
عقب راست (back right)
.IP \fBFLC\fR 4
.IX Item "FLC"
جلوی متمایل به چپِ مرکز
.IP \fBFRC\fR 4
.IX Item "FRC"
جلوی متمایل به راستِ مرکز
.IP \fBBC\fR 4
.IX Item "BC"
عقب مرکز
.IP \fBSL\fR 4
.IX Item "SL"
سمت چپ (side left)
.IP \fBSR\fR 4
.IX Item "SR"
سمت راست (side right)
.IP \fBTC\fR 4
.IX Item "TC"
بالای مرکز
.IP \fBTFL\fR 4
.IX Item "TFL"
بالای جلو چپ
.IP \fBTFC\fR 4
.IX Item "TFC"
بالای جلو مرکز
.IP \fBTFR\fR 4
.IX Item "TFR"
بالای جلو راست
.IP \fBTBL\fR 4
.IX Item "TBL"
بالای عقب چپ
.IP \fBTBC\fR 4
.IX Item "TBC"
بالای عقب مرکز
.IP \fBTBR\fR 4
.IX Item "TBR"
بالای عقب راست
.IP \fBDL\fR 4
.IX Item "DL"
داون‌میکس چپ
.IP \fBDR\fR 4
.IX Item "DR"
داون‌میکس راست
.IP \fBWL\fR 4
.IX Item "WL"
عریض چپ
.IP \fBWR\fR 4
.IX Item "WR"
عریض راست
.IP \fBSDL\fR 4
.IX Item "SDL"
فراگیر مستقیم چپ
.IP \fBSDR\fR 4
.IX Item "SDR"
فراگیر مستقیم راست
.IP \fBLFE2\fR 4
.IX Item "LFE2"
فرکانس پایین ۲
.PP
ترکیب‌های استاندارد چینش کانال را می‌توان با شناسه‌های زیر مشخص کرد:
.IP \fBmono\fR 4
.IX Item "mono"
FC
.IP \fBstereo\fR 4
.IX Item "stereo"
FL+FR
.IP \fB2.1\fR 4
.IX Item "2.1"
FL+FR+LFE
.IP \fB3.0\fR 4
.IX Item "3.0"
FL+FR+FC
.IP \fB3.0(back)\fR 4
.IX Item "3.0(back)"
FL+FR+BC
.IP \fB4.0\fR 4
.IX Item "4.0"
FL+FR+FC+BC
.IP \fBquad\fR 4
.IX Item "quad"
FL+FR+BL+BR
.IP \fBquad(side)\fR 4
.IX Item "quad(side)"
FL+FR+SL+SR
.IP \fB3.1\fR 4
.IX Item "3.1"
FL+FR+FC+LFE
.IP \fB5.0\fR 4
.IX Item "5.0"
FL+FR+FC+BL+BR
.IP \fB5.0(side)\fR 4
.IX Item "5.0(side)"
FL+FR+FC+SL+SR
.IP \fB4.1\fR 4
.IX Item "4.1"
FL+FR+FC+LFE+BC
.IP \fB5.1\fR 4
.IX Item "5.1"
FL+FR+FC+LFE+BL+BR
.IP \fB5.1(side)\fR 4
.IX Item "5.1(side)"
FL+FR+FC+LFE+SL+SR
.IP \fB6.0\fR 4
.IX Item "6.0"
FL+FR+FC+BC+SL+SR
.IP \fB6.0(front)\fR 4
.IX Item "6.0(front)"
FL+FR+FLC+FRC+SL+SR
.IP \fB3.1.2\fR 4
.IX Item "3.1.2"
FL+FR+FC+LFE+TFL+TFR
.IP \fBhexagonal\fR 4
.IX Item "hexagonal"
FL+FR+FC+BL+BR+BC
.IP \fB6.1\fR 4
.IX Item "6.1"
FL+FR+FC+LFE+BC+SL+SR
.IP \fB6.1\fR 4
.IX Item "6.1"
FL+FR+FC+LFE+BL+BR+BC
.IP \fB6.1(front)\fR 4
.IX Item "6.1(front)"
FL+FR+LFE+FLC+FRC+SL+SR
.IP \fB7.0\fR 4
.IX Item "7.0"
FL+FR+FC+BL+BR+SL+SR
.IP \fB7.0(front)\fR 4
.IX Item "7.0(front)"
FL+FR+FC+FLC+FRC+SL+SR
.IP \fB7.1\fR 4
.IX Item "7.1"
FL+FR+FC+LFE+BL+BR+SL+SR
.IP \fB7.1(wide)\fR 4
.IX Item "7.1(wide)"
FL+FR+FC+LFE+BL+BR+FLC+FRC
.IP \fB7.1(wide\-side)\fR 4
.IX Item "7.1(wide-side)"
FL+FR+FC+LFE+FLC+FRC+SL+SR
.IP \fB5.1.2\fR 4
.IX Item "5.1.2"
FL+FR+FC+LFE+BL+BR+TFL+TFR
.IP \fBoctagonal\fR 4
.IX Item "octagonal"
FL+FR+FC+BL+BR+BC+SL+SR
.IP \fBcube\fR 4
.IX Item "cube"
FL+FR+BL+BR+TFL+TFR+TBL+TBR
.IP \fB5.1.4\fR 4
.IX Item "5.1.4"
FL+FR+FC+LFE+BL+BR+TFL+TFR+TBL+TBR
.IP \fB7.1.2\fR 4
.IX Item "7.1.2"
FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR
.IP \fB7.1.4\fR 4
.IX Item "7.1.4"
FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBL+TBR
.IP \fB7.2.3\fR 4
.IX Item "7.2.3"
FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBC+LFE2
.IP \fB9.1.4\fR 4
.IX Item "9.1.4"
FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR
.IP \fB9.1.6\fR 4
.IX Item "9.1.6"
FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR+TSL+TSR
.IP \fBhexadecagonal\fR 4
.IX Item "hexadecagonal"
FL+FR+FC+BL+BR+BC+SL+SR+WL+WR+TBL+TBR+TBC+TFC+TFL+TFR
.IP \fBbinaural\fR 4
.IX Item "binaural"
BIL+BIR
.IP \fBdownmix\fR 4
.IX Item "downmix"
DL+DR
.IP \fB22.2\fR 4
.IX Item "22.2"
FL+FR+FC+LFE+BL+BR+FLC+FRC+BC+SL+SR+TC+TFL+TFC+TFR+TBL+TBC+TBR+LFE2+TSL+TSR+BFC+BFL+BFR
.PP
یک چینش کانال سفارشی می‌تواند به صورت توالی‌ای از عبارت‌ها که با \*(Aq+\*(Aq جدا شده‌اند مشخص شود. هر عبارت می‌تواند یکی از موارد زیر باشد:
.IP \(bu 4
نام یک کانال منفرد (مانند \fBFL\fR، \fBFR\fR، \fBFC\fR، \fBLFE\fR و غیره)، که هر کدام اختیاری می‌تواند شامل یک نام سفارشی پس از \*(Aq@\*(Aq باشد (مانند \fBFL@Left\fR، \&\fBFR@Right\fR، \fBFC@Center\fR، \fBLFE@Low_Frequency\fR و غیره)
.PP
یک چینش کانال استاندارد می‌تواند با موارد زیر مشخص شود:
.IP \(bu 4
نام یک کانال منفرد (مانند \fBFL\fR، \fBFR\fR، \fBFC\fR، \fBLFE\fR و غیره)
.IP \(bu 4
نام یک چینش کانال استاندارد (مانند \fBmono\fR، \&\fBstereo\fR، \fB4.0\fR، \fBquad\fR، \fB5.0\fR و غیره)
.IP \(bu 4
تعداد کانال‌ها، به صورت ده‌دهی، به همراه \*(Aqc\*(Aq در انتها، که چینش کانال پیش‌فرض را برای آن تعداد کانال ایجاد می‌کند (تابع \&\f(CW\*(C`av_channel_layout_default\*(C'\fR را ببینید). توجه داشته باشید که همه تعداد کانال‌ها چینش پیش‌فرض ندارند.
.IP \(bu 4
تعداد کانال‌ها، به صورت ده‌دهی، به همراه \*(AqC\*(Aq در انتها، که یک چینش کانال ناشناخته را با تعداد کانال مشخص‌شده ارائه می‌دهد. توجه داشته باشید که همه رشته‌های تعیین چینش کانال از چینش‌های کانال ناشناخته پشتیبانی نمی‌کنند.
.IP \(bu 4
یک ماسک چینش کانال، به صورت هگزادسیمال که با "0x" شروع می‌شود (ماکروهای \&\f(CW\*(C`AV_CH_*\*(C'\fR را در \fIlibavutil/channel_layout.h\fR ببینید).
.PP
قبل از نسخه 53 کتابخانه libavutil نویسهٔ انتهایی "c" برای مشخص کردن تعداد کانال‌ها اختیاری بود، اما اکنون الزامی است، در حالی که ماسک چینش کانال می‌تواند به صورت یک عدد ده‌دهی نیز مشخص شود (تنها در صورتی که با "c" یا "C" دنبال نشده باشد).
.PP
همچنین تابع \f(CW\*(C`av_channel_layout_from_string\*(C'\fR تعریف‌شده در \&\fIlibavutil/channel_layout.h\fR را ببینید.
.SH "ارزیابی عبارات محاسباتی (EXPRESSION EVALUATION)"
.IX Header "EXPRESSION EVALUATION"
هنگام ارزیابی یک عبارت حسابی، FFmpeg از یک ارزیاب فرمول داخلی استفاده می‌کند که از طریق رابط \fIlibavutil/eval.h\fR پیاده‌سازی شده است.
.PP
یک عبارت می‌تواند شامل عملگرهای یکانی، دودویی، ثابت‌ها و توابع باشد.
.PP
دو عبارت \fIexpr1\fR و \fIexpr2\fR می‌توانند برای تشکیل عبارت دیگری به شکل "\fIexpr1\fR;\fIexpr2\fR" ترکیب شوند.
\&\fIexpr1\fR و \fIexpr2\fR به نوبت ارزیابی می‌شوند، و عبارت جدید به مقدار \fIexpr2\fR ارزیابی می‌گردد.
.PP
عملگرهای دودویی زیر در دسترس هستند: \f(CW\*(C`+\*(C'\fR، \f(CW\*(C`\-\*(C'\fR،
\&\f(CW\*(C`*\*(C'\fR، \f(CW\*(C`/\*(C'\fR، \f(CW\*(C`^\*(C'\fR.
.PP
عملگرهای یکانی زیر در دسترس هستند: \f(CW\*(C`+\*(C'\fR، \f(CW\*(C`\-\*(C'\fR.
.PP
برخی متغیرهای داخلی می‌توانند برای ذخیره و بارگذاری نتایج واسط استفاده شوند. آن‌ها با استفاده از توابع \f(CW\*(C`ld\*(C'\fR و \f(CW\*(C`st\*(C'\fR با یک آرگومان نمایه متغیر از 0 تا 9 برای تعیین متغیر داخلی مورد نظر قابل دسترسی هستند.
.PP
توابع زیر در دسترس هستند:
.IP \fBabs(x)\fR 4
.IX Item "abs(x)"
محاسبه قدر مطلق \fIx\fR.
.IP \fBacos(x)\fR 4
.IX Item "acos(x)"
محاسبه آرک‌کوسینوس \fIx\fR.
.IP \fBasin(x)\fR 4
.IX Item "asin(x)"
محاسبه آرک‌سینوس \fIx\fR.
.IP \fBatan(x)\fR 4
.IX Item "atan(x)"
محاسبه آرک‌تانژانت \fIx\fR.
.IP "\fBatan2(y, x)\fR" 4
.IX Item "atan2(y, x)"
محاسبه مقدار اصلی آرک‌تانژانت \fIy\fR/\fIx\fR.
.IP "\fBbetween(x, min, max)\fR" 4
.IX Item "between(x, min, max)"
بازگرداندن 1 اگر \fIx\fR بزرگتر یا مساوی \fImin\fR و کوچکتر یا مساوی \fImax\fR باشد، در غیر این صورت 0.
.IP "\fBbitand(x, y)\fR" 4
.IX Item "bitand(x, y)"
.PD 0
.IP "\fBbitor(x, y)\fR" 4
.IX Item "bitor(x, y)"
.PD
محاسبه عملیات بیتی AND یا OR روی \fIx\fR و \fIy\fR.
.Sp
نتایج ارزیابی \fIx\fR و \fIy\fR قبل از اجرای عملیات بیتی به عدد صحیح تبدیل می‌شوند.
.Sp
توجه داشته باشید که هم تبدیل به عدد صحیح و هم تبدیل مجدد به ممیز شناور می‌توانند دقت را کاهش دهند. مراقب نتایج غیرمنتظره برای اعداد بزرگ (معمولاً 2^53 و بزرگتر) باشید.
.IP \fBceil(expr)\fR 4
.IX Item "ceil(expr)"
گرد کردن مقدار عبارت \fIexpr\fR به سمت بالا به نزدیک‌ترین عدد صحیح. برای مثال "ceil(1.5)" برابر "2.0" است.
.IP "\fBclip(x, min, max)\fR" 4
.IX Item "clip(x, min, max)"
بازگرداندن مقدار \fIx\fR محدودشده میان \fImin\fR و \fImax\fR.
.IP \fBcos(x)\fR 4
.IX Item "cos(x)"
محاسبه کوسینوس \fIx\fR.
.IP \fBcosh(x)\fR 4
.IX Item "cosh(x)"
محاسبه کوسینوس هذلولوی (هایپربولیک) \fIx\fR.
.IP "\fBeq(x, y)\fR" 4
.IX Item "eq(x, y)"
بازگرداندن 1 اگر \fIx\fR و \fIy\fR معادل باشند، در غیر این صورت 0.
.IP \fBexp(x)\fR 4
.IX Item "exp(x)"
محاسبه تابع نمایی \fIx\fR (بر مبنای \f(CW\*(C`e\*(C'\fR، عدد اویلر).
.IP \fBfloor(expr)\fR 4
.IX Item "floor(expr)"
گرد کردن مقدار عبارت \fIexpr\fR به سمت پایین به نزدیک‌ترین عدد صحیح. برای مثال "floor(\e-1.5)" برابر "\e-2.0" است.
.IP \fBgauss(x)\fR 4
.IX Item "gauss(x)"
محاسبه تابع گاوس برای \fIx\fR، متناظر با \&\f(CW\*(C`exp(\e-x*x/2) / sqrt(2*PI)\*(C'\fR.
.IP "\fBgcd(x, y)\fR" 4
.IX Item "gcd(x, y)"
بازگرداندن بزرگترین مقسوم‌علیه مشترک (ب.م.م) \fIx\fR و \fIy\fR. اگر هر دو \fIx\fR و \&\fIy\fR برابر 0 باشند یا یکی یا هر دو کمتر از صفر باشند رفتار تعریف‌نشده است.
.IP "\fBgt(x, y)\fR" 4
.IX Item "gt(x, y)"
بازگرداندن 1 اگر \fIx\fR بزرگتر از \fIy\fR باشد، در غیر این صورت 0.
.IP "\fBgte(x, y)\fR" 4
.IX Item "gte(x, y)"
بازگرداندن 1 اگر \fIx\fR بزرگتر یا مساوی \fIy\fR باشد، در غیر این صورت 0.
.IP "\fBhypot(x, y)\fR" 4
.IX Item "hypot(x, y)"
این تابع مشابه تابع C با همین نام است؛ مقدار "sqrt(\fIx\fR*\fIx\fR + \fIy\fR*\fIy\fR)" یعنی طول وتر یک مثلث قائم‌الزاویه با اضلاع به طول \fIx\fR و \fIy\fR، یا فاصله نقطه (\fIx\fR, \fIy\fR) از مبدا مختصات را بازمی‌گرداند.
.IP "\fBif(x, y)\fR" 4
.IX Item "if(x, y)"
ارزیابی \fIx\fR، و اگر نتیجه غیرصفر باشد نتیجه ارزیابی \fIy\fR را بازمی‌گرداند، در غیر این صورت 0.
.IP "\fBif(x, y, z)\fR" 4
.IX Item "if(x, y, z)"
ارزیابی \fIx\fR، و اگر نتیجه غیرصفر باشد نتیجه ارزیابی \fIy\fR، در غیر این صورت نتیجه ارزیابی \fIz\fR را بازمی‌گرداند.
.IP "\fBifnot(x, y)\fR" 4
.IX Item "ifnot(x, y)"
ارزیابی \fIx\fR، و اگر نتیجه صفر باشد نتیجه ارزیابی \fIy\fR را بازمی‌گرداند، در غیر این صورت 0.
.IP "\fBifnot(x, y, z)\fR" 4
.IX Item "ifnot(x, y, z)"
ارزیابی \fIx\fR، و اگر نتیجه صفر باشد نتیجه ارزیابی \fIy\fR، در غیر این صورت نتیجه ارزیابی \fIz\fR را بازمی‌گرداند.
.IP \fBisinf(x)\fR 4
.IX Item "isinf(x)"
بازگرداندن 1.0 اگر \fIx\fR برابر با +/\-INFINITY باشد، در غیر این صورت 0.0.
.IP \fBisnan(x)\fR 4
.IX Item "isnan(x)"
بازگرداندن 1.0 اگر \fIx\fR برابر با NAN باشد، در غیر این صورت 0.0.
.IP \fBld(idx)\fR 4
.IX Item "ld(idx)"
بارگذاری مقدار متغیر داخلی با نمایه \fIidx\fR، که قبلاً با st(\fIidx\fR, \fIexpr\fR) ذخیره شده است. تابع مقدار بارگذاری‌شده را بازمی‌گرداند.
.IP "\fBlerp(x, y, z)\fR" 4
.IX Item "lerp(x, y, z)"
بازگرداندن درون‌یابی خطی میان \fIx\fR و \fIy\fR به میزان \fIz\fR.
.IP \fBlog(x)\fR 4
.IX Item "log(x)"
محاسبه لگاریتم طبیعی \fIx\fR.
.IP "\fBlt(x, y)\fR" 4
.IX Item "lt(x, y)"
بازگرداندن 1 اگر \fIx\fR کوچکتر از \fIy\fR باشد، در غیر این صورت 0.
.IP "\fBlte(x, y)\fR" 4
.IX Item "lte(x, y)"
بازگرداندن 1 اگر \fIx\fR کوچکتر یا مساوی \fIy\fR باشد، در غیر این صورت 0.
.IP "\fBmax(x, y)\fR" 4
.IX Item "max(x, y)"
بازگرداندن بیشینه میان \fIx\fR و \fIy\fR.
.IP "\fBmin(x, y)\fR" 4
.IX Item "min(x, y)"
بازگرداندن کمینه میان \fIx\fR و \fIy\fR.
.IP "\fBmod(x, y)\fR" 4
.IX Item "mod(x, y)"
محاسبه باقیمانده تقسیم \fIx\fR بر \fIy\fR.
.IP \fBnot(expr)\fR 4
.IX Item "not(expr)"
بازگرداندن 1.0 اگر \fIexpr\fR صفر باشد، در غیر این صورت 0.0.
.IP "\fBpow(x, y)\fR" 4
.IX Item "pow(x, y)"
محاسبه توان \fIx\fR به توان \fIy\fR، معادل "(\fIx\fR)^(\fIy\fR)".
.IP \fBprint(t)\fR 4
.IX Item "print(t)"
.PD 0
.IP "\fBprint(t, l)\fR" 4
.IX Item "print(t, l)"
.PD
چاپ مقدار عبارت \fIt\fR با سطح گزارش‌گیری (loglevel) برابر با \fIl\fR. اگر \fIl\fR مشخص نشود، از یک سطح گزارش‌گیری پیش‌فرض استفاده می‌شود.
مقدار عبارت چاپ‌شده را بازمی‌گرداند.
.IP \fBrandom(idx)\fR 4
.IX Item "random(idx)"
بازگرداندن یک مقدار شبه‌تصادفی بین 0.0 و 1.0. مقدار \fIidx\fR نمایه متغیر داخلی مورد استفاده برای ذخیره seed/state است که قبلاً با \f(CWst(idx)\fR ذخیره شده است.
.Sp
برای مقداردهی اولیه seed، باید مقدار seed را به صورت یک عدد صحیح بدون‌علامت ۶۴ بیتی در متغیر داخلی با نمایه \fIidx\fR ذخیره کنید.
.Sp
برای مثال، برای ذخیره seed با مقدار \f(CW42\fR در متغیر داخلی با نمایه \f(CW0\fR و چاپ چند مقدار تصادفی:
.Sp
.Vb 1
\&        st(0,42); print(random(0)); print(random(0)); print(random(0))
.Ve
.IP "\fBrandomi(idx, min, max)\fR" 4
.IX Item "randomi(idx, min, max)"
بازگرداندن یک مقدار شبه‌تصادفی در بازه بین \fImin\fR و \&\fImax\fR. مقدار \fIidx\fR نمایه متغیر داخلی است که برای ذخیره seed/state استفاده خواهد شد، و قبلاً می‌تواند با \f(CWst(idx)\fR ذخیره شده باشد.
.Sp
برای مقداردهی اولیه seed، باید مقدار seed را به صورت یک عدد صحیح بدون‌علامت ۶۴ بیتی در متغیر داخلی با نمایه \fIidx\fR ذخیره کنید.
.IP "\fBroot(expr, max)\fR" 4
.IX Item "root(expr, max)"
یافتن یک مقدار ورودی که تابع نمایش‌داده‌شده توسط \fIexpr\fR با آرگومان \fR\f(BIld\fR\fI\|(0)\fR به ازای آن در بازه 0..\fImax\fR برابر 0 باشد.
.Sp
عبارت در \fIexpr\fR باید نشان‌دهنده یک تابع پیوسته باشد در غیر این صورت نتیجه تعریف‌نشده است.
.Sp
مقدار \&\fR\f(BIld\fR\fI\|(0)\fR برای نشان دادن مقدار ورودی تابع استفاده می‌شود، به این معنی که عبارت داده‌شده چندین بار با مقادیر ورودی مختلف ارزیابی خواهد شد که عبارت می‌تواند از طریق \f(CWld(0)\fR به آن‌ها دسترسی داشته باشد. هنگامی که عبارت به 0 ارزیابی شود، مقدار ورودی مربوطه بازگردانده خواهد شد.
.IP \fBround(expr)\fR 4
.IX Item "round(expr)"
گرد کردن مقدار عبارت \fIexpr\fR به نزدیک‌ترین عدد صحیح. برای مثال "round(1.5)" برابر "2.0" است.
.IP \fBsgn(x)\fR 4
.IX Item "sgn(x)"
محاسبه علامت \fIx\fR.
.IP \fBsin(x)\fR 4
.IX Item "sin(x)"
محاسبه سینوس \fIx\fR.
.IP \fBsinh(x)\fR 4
.IX Item "sinh(x)"
محاسبه سینوس هذلولوی \fIx\fR.
.IP \fBsqrt(expr)\fR 4
.IX Item "sqrt(expr)"
محاسبه ریشه دوم (جذر) \fIexpr\fR. معادل "(\fIexpr\fR)^.5".
.IP \fBsquish(x)\fR 4
.IX Item "squish(x)"
محاسبه عبارت \f(CW\*(C`1/(1 + exp(4*x))\*(C'\fR.
.IP "\fBst(idx, expr)\fR" 4
.IX Item "st(idx, expr)"
ذخیره مقدار عبارت \fIexpr\fR در یک متغیر داخلی. \fIidx\fR نمایه متغیری را مشخص می‌کند که مقدار در آن ذخیره شود، و مقداری از 0 تا 9 است. تابع مقدار ذخیره‌شده در متغیر داخلی را بازمی‌گرداند.
.Sp
مقدار ذخیره‌شده می‌تواند با \f(CWld(var)\fR بازیابی شود.
.Sp
نکته: متغیرها در حال حاضر میان عبارات مختلف به اشتراک گذاشته نمی‌شوند.
.IP \fBtan(x)\fR 4
.IX Item "tan(x)"
محاسبه تانژانت \fIx\fR.
.IP \fBtanh(x)\fR 4
.IX Item "tanh(x)"
محاسبه تانژانت هذلولوی \fIx\fR.
.IP "\fBtaylor(expr, x)\fR" 4
.IX Item "taylor(expr, x)"
.PD 0
.IP "\fBtaylor(expr, x, idx)\fR" 4
.IX Item "taylor(expr, x, idx)"
.PD
ارزیابی یک سری تیلور در \fIx\fR، با توجه به عبارتی که مشتق \f(CWld(idx)\fR\-ام یک تابع را در 0 نشان می‌دهد.
.Sp
هنگامی که سری همگرا نشود، نتیجه تعریف‌نشده است.
.Sp
مقدار \&\fIld(idx)\fR برای نشان دادن مرتبه مشتق در \fIexpr\fR استفاده می‌شود، به این معنی که عبارت داده‌شده چندین بار با مقادیر ورودی مختلف ارزیابی خواهد شد که عبارت می‌تواند از طریق \&\f(CWld(idx)\fR به آن‌ها دسترسی داشته باشد. اگر \fIidx\fR مشخص نشود، 0 فرض می‌شود.
.Sp
نکته: هنگامی که مشتقات را در y به جای 0 دارید، \&\f(CW\*(C`taylor(expr, x\-y)\*(C'\fR می‌تواند استفاده شود.
.IP \fBtime\|(0)\fR 4
.IX Item "time"
بازگرداندن زمان فعلی (ساعت دیواری) بر حسب ثانیه.
.IP \fBtrunc(expr)\fR 4
.IX Item "trunc(expr)"
گرد کردن مقدار عبارت \fIexpr\fR به سمت صفر به نزدیک‌ترین عدد صحیح. برای مثال "trunc(\e-1.5)" برابر "\e-1.0" است.
.IP "\fBwhile(cond, expr)\fR" 4
.IX Item "while(cond, expr)"
ارزیابی عبارت \fIexpr\fR تا زمانی که عبارت \fIcond\fR غیرصفر باشد، و بازگرداندن مقدار آخرین ارزیابی \fIexpr\fR، یا NAN اگر \fIcond\fR همیشه نادرست بوده باشد.
.PP
ثابت‌های زیر در دسترس هستند:
.IP \fBPI\fR 4
.IX Item "PI"
مساحت دیسک واحد، تقریباً 3.14
.IP \fBE\fR 4
.IX Item "E"
\&\fBexp\fR\|(1) (عدد اویلر)، تقریباً 2.718
.IP \fBPHI\fR 4
.IX Item "PHI"
نسبت طلایی (1+\fBsqrt\fR\|(5))/2، تقریباً 1.618
.PP
با فرض اینکه یک عبارت در صورت داشتن مقدار غیرصفر "درست" (true) در نظر گرفته می‌شود، توجه داشته باشید که:
.PP
\&\f(CW\*(C`*\*(C'\fR مانند AND عمل می‌کند
.PP
\&\f(CW\*(C`+\*(C'\fR مانند OR عمل می‌کند
.PP
برای مثال ساختار:
.PP
.Vb 1
\&        if (A AND B) then C
.Ve
.PP
معادل است با:
.PP
.Vb 1
\&        if(A*B, C)
.Ve
.PP
در کد زبان C خود، می‌توانید فهرست توابع یکانی و دودویی را گسترش دهید و ثابت‌های شناخته‌شده را تعریف کنید، به طوری که برای عبارات شما در دسترس باشند.
.PP
ارزیاب همچنین پیشوندهای یکای دستگاه بین‌المللی (SI) را می‌شناسد. اگر \*(Aqi\*(Aq بعد از پیشوند اضافه شود، از پیشوندهای دودویی (باینری) استفاده می‌شود که بر پایه توان‌های 1024 هستند به جای توان‌های 1000.
پسوند \*(AqB\*(Aq مقدار را در ۸ ضرب می‌کند، و می‌تواند بعد از پیشوند یکا اضافه شود یا به تنهایی به کار رود. این امکان استفاده از مثلاً \*(AqKB\*(Aq، \*(AqMiB\*(Aq، \&\*(AqG\*(Aq و \*(AqB\*(Aq را به عنوان پسوند عدد فراهم می‌کند.
.PP
فهرست پیشوندهای بین‌المللی موجود در ادامه می‌آید، همراه با نشان دادن توان‌های متناظر 10 و 2.
.IP \fBy\fR 4
.IX Item "y"
10^\-24 / 2^\-80
.IP \fBz\fR 4
.IX Item "z"
10^\-21 / 2^\-70
.IP \fBa\fR 4
.IX Item "a"
10^\-18 / 2^\-60
.IP \fBf\fR 4
.IX Item "f"
10^\-15 / 2^\-50
.IP \fBp\fR 4
.IX Item "p"
10^\-12 / 2^\-40
.IP \fBn\fR 4
.IX Item "n"
10^\-9 / 2^\-30
.IP \fBu\fR 4
.IX Item "u"
10^\-6 / 2^\-20
.IP \fBm\fR 4
.IX Item "m"
10^\-3 / 2^\-10
.IP \fBc\fR 4
.IX Item "c"
10^\-2
.IP \fBd\fR 4
.IX Item "d"
10^\-1
.IP \fBh\fR 4
.IX Item "h"
10^2
.IP \fBk\fR 4
.IX Item "k"
10^3 / 2^10
.IP \fBK\fR 4
.IX Item "K"
10^3 / 2^10
.IP \fBM\fR 4
.IX Item "M"
10^6 / 2^20
.IP \fBG\fR 4
.IX Item "G"
10^9 / 2^30
.IP \fBT\fR 4
.IX Item "T"
10^12 / 2^40
.IP \fBP\fR 4
.IX Item "P"
10^15 / 2^50
.IP \fBE\fR 4
.IX Item "E"
10^18 / 2^60
.IP \fBZ\fR 4
.IX Item "Z"
10^21 / 2^70
.IP \fBY\fR 4
.IX Item "Y"
10^24 / 2^80
.SH "گزینه‌های کدک (CODEC OPTIONS)"
.IX Header "CODEC OPTIONS"
کتابخانه libavcodec مجموعه‌ای از گزینه‌های عمومی سراسری را فراهم می‌کند که می‌توانند روی تمام انکودرها و دیکودرها تنظیم شوند. علاوه بر این، هر کدک ممکن است از گزینه‌های به‌اصطلاح اختصاصی (private options) پشتیبانی کند که مختص یک کدک معین هستند.
.PP
گاهی اوقات یک گزینه سراسری ممکن است تنها بر نوع خاصی از کدک تأثیر بگذارد، و برای کدک دیگری بی‌معنی بوده یا نادیده گرفته شود، بنابراین باید از مفهوم گزینه‌های تعیین‌شده آگاه باشید. همچنین برخی گزینه‌ها فقط برای دیکود یا انکود در نظر گرفته شده‌اند.
.PP
گزینه‌ها را می‌توان با مشخص کردن \-\fIoption\fR \fIvalue\fR در ابزارهای FFmpeg، یا با تنظیم صریح مقدار در گزینه‌های \&\f(CW\*(C`AVCodecContext\*(C'\fR یا با استفاده از API موجود در \fIlibavutil/opt.h\fR برای کاربردهای برنامه‌نویسی تنظیم کرد.
.PP
فهرست گزینه‌های پشتیبانی‌شده در ادامه می‌آید:
.IP "\fBb\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "b integer (encoding,audio,video)"
تنظیم نرخ بیت بر حسب بیت بر ثانیه. مقدار پیش‌فرض 200K است.
.IP "\fBab\fR \fIinteger\fR \fB(\fR\fIانکود،صدا\fR\fB)\fR" 4
.IX Item "ab integer (encoding,audio)"
تنظیم نرخ بیت صدا (بر حسب بیت بر ثانیه). مقدار پیش‌فرض 128K است.
.IP "\fBbt\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "bt integer (encoding,video)"
تنظیم میزان تلورانس (انحراف مجاز) نرخ بیت ویدیو (بر حسب بیت بر ثانیه). در حالت 1-pass، تلورانس نرخ بیت مشخص می‌کند که کنترل نرخ چقدر مجاز است از مقدار میانگین نرخ بیت هدف انحراف داشته باشد. این به حداقل/حداکثر نرخ بیت ارتباطی ندارد. کاهش بیش از حد تلورانس تأثیر نامطلوبی بر کیفیت خواهد داشت.
.IP "\fBflags\fR \fIflags\fR \fB(\fR\fIدیکود/انکود،صدا،ویدیو،زیرنویس\fR\fB)\fR" 4
.IX Item "flags flags (decoding/encoding,audio,video,subtitles)"
تنظیم پرچم‌های عمومی.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBmv4\fR 4
.IX Item "mv4"
استفاده از چهار بردار حرکت به‌ازای هر ماکروبلاک (mpeg4).
.IP \fBqpel\fR 4
.IX Item "qpel"
استفاده از جبران حرکت 1/4 پیکسلی (qpel).
.IP \fBloop\fR 4
.IX Item "loop"
استفاده از فیلتر حلقه (loop filter).
.IP \fBqscale\fR 4
.IX Item "qscale"
استفاده از مقیاس qscale ثابت.
.IP \fBpass1\fR 4
.IX Item "pass1"
استفاده از کنترل نرخ داخلی 2pass در حالت پاس اول.
.IP \fBpass2\fR 4
.IX Item "pass2"
استفاده از کنترل نرخ داخلی 2pass در حالت پاس دوم.
.IP \fBgray\fR 4
.IX Item "gray"
دیکود/انکود فقط به صورت مقیاس خاکستری (سیاه و سفید).
.IP \fBpsnr\fR 4
.IX Item "psnr"
تنظیم متغیرهای error[?] در حین انکود.
.IP \fBtruncated\fR 4
.IX Item "truncated"
استریم بیت ورودی ممکن است به صورت تصادفی کوتاه یا ناقص شده باشد.
.IP \fBdrop_changed\fR 4
.IX Item "drop_changed"
عدم خروجی دادن فریم‌هایی که پارامترهای آن‌ها با اولین فریم دیکودشده در استریم تفاوت دارد. خطای AVERROR_INPUT_CHANGED هنگام دور انداختن فریم بازگردانده می‌شود.
.IP \fBildct\fR 4
.IX Item "ildct"
استفاده از DCT درهم‌تنیده (interlaced).
.IP \fBlow_delay\fR 4
.IX Item "low_delay"
اجبار تأخیر کم.
.IP \fBglobal_header\fR 4
.IX Item "global_header"
قرار دادن هدرهای سراسری در extradata به جای تک‌تک فریم‌های کلیدی.
.IP \fBbitexact\fR 4
.IX Item "bitexact"
فقط نوشتن داده‌های مستقل از پلتفرم، ساخت و زمان (به جز (I)DCT). این اطمینان حاصل می‌کند که چک‌سام‌های پرونده و داده قابل تکرار بوده و میان پلتفرم‌های مختلف مطابقت دارند. کاربرد اصلی آن در آزمون رگرسیون است.
.IP \fBaic\fR 4
.IX Item "aic"
اعمال کدگذاری پیشرفته اینترا در H263 / پیش‌بینی AC در mpeg4.
.IP \fBilme\fR 4
.IX Item "ilme"
اعمال تخمین حرکت درهم‌تنیده.
.IP \fBcgop\fR 4
.IX Item "cgop"
استفاده از GOP بسته (closed GOP).
.IP \fBoutput_corrupt\fR 4
.IX Item "output_corrupt"
خروجی دادن فریم‌ها حتی اگر احتمال خرابی آن‌ها وجود داشته باشد.
.RE
.RS 4
.RE
.IP "\fBtime_base\fR \fIrational number\fR" 4
.IX Item "time_base rational number"
تنظیم مبنای زمانی کدک.
.Sp
واحد بنیادین زمان (بر حسب ثانیه) است که برچسب‌های زمانی فریم بر پایه آن نشان داده می‌شوند. برای محتوای با نرخ فریم ثابت، مبنای زمانی باید \f(CW\*(C`1 / frame_rate\*(C'\fR باشد و افزایش برچسب زمانی باید دقیقاً 1 باشد.
.IP "\fBg\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "g integer (encoding,video)"
تنظیم اندازه گروه تصاویر (GOP). مقدار پیش‌فرض 12 است.
.IP "\fBar\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،صدا\fR\fB)\fR" 4
.IX Item "ar integer (decoding/encoding,audio)"
تنظیم نرخ نمونه‌برداری صدا (بر حسب هرتز).
.IP "\fBac\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،صدا\fR\fB)\fR" 4
.IX Item "ac integer (decoding/encoding,audio)"
تنظیم تعداد کانال‌های صوتی.
.IP "\fBcutoff\fR \fIinteger\fR \fB(\fR\fIانکود،صدا\fR\fB)\fR" 4
.IX Item "cutoff integer (encoding,audio)"
تنظیم پهنای باند قطع (تنها توسط انکودرهای برگزیده پشتیبانی می‌شود، بخش مستندات مربوطه آن‌ها را ببینید).
.IP "\fBframe_size\fR \fIinteger\fR \fB(\fR\fIانکود،صدا\fR\fB)\fR" 4
.IX Item "frame_size integer (encoding,audio)"
تنظیم اندازه فریم صوتی.
.Sp
هر فریم ارائه‌شده به جز آخرین فریم باید دقیقاً شامل frame_size نمونه به‌ازای هر کانال باشد. در صورتی که کدک CODEC_CAP_VARIABLE_FRAME_SIZE را تنظیم کرده باشد می‌تواند 0 باشد، که در این حالت اندازه فریم محدودیتی ندارد. توسط برخی دیکودرها برای نشان دادن اندازه فریم ثابت تنظیم می‌شود.
.IP "\fBframe_number\fR \fIinteger\fR" 4
.IX Item "frame_number integer"
تنظیم شماره فریم.
.IP "\fBdelay\fR \fIinteger\fR" 4
.IX Item "delay integer"
.PD 0
.IP "\fBqcomp\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "qcomp float (encoding,video)"
.PD
تنظیم فشرده‌سازی مقیاس کوانتیایزر ویدیو (VBR). به عنوان یک ثابت در معادله کنترل نرخ استفاده می‌شود. محدوده توصیه‌شده برای rc_eq پیش‌فرض: 0.0-1.0.
.IP "\fBqblur\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "qblur float (encoding,video)"
تنظیم محو کردن مقیاس کوانتیایزر ویدیو (VBR).
.IP "\fBqmin\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "qmin integer (encoding,video)"
تنظیم حداقل مقیاس کوانتیایزر ویدیو (VBR). باید بین -1 و 69 باشد، مقدار پیش‌فرض 2 است.
.IP "\fBqmax\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "qmax integer (encoding,video)"
تنظیم حداکثر مقیاس کوانتیایزر ویدیو (VBR). باید بین -1 و 1024 باشد، مقدار پیش‌فرض 31 است.
.IP "\fBqdiff\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "qdiff integer (encoding,video)"
تنظیم حداکثر اختلاف میان مقیاس‌های کوانتیایزر (VBR).
.IP "\fBbf\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "bf integer (encoding,video)"
تنظیم حداکثر تعداد فریم‌های B میان فریم‌های غیر B.
.Sp
باید یک عدد صحیح بین -1 و 16 باشد. مقدار 0 به این معنی است که فریم‌های B غیرفعال هستند. اگر از مقدار -1 استفاده شود، یک مقدار خودکار بسته به انکودر انتخاب خواهد شد.
.Sp
مقدار پیش‌فرض 0 است.
.IP "\fBb_qfactor\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "b_qfactor float (encoding,video)"
تنظیم فاکتور QP میان فریم‌های P و B.
.IP "\fBcodec_tag\fR \fIinteger\fR" 4
.IX Item "codec_tag integer"
.PD 0
.IP "\fBbug\fR \fIflags\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "bug flags (decoding,video)"
.PD
دور زدن اشکالات انکودرهایی که به صورت خودکار شناسایی نشده‌اند.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBautodetect\fR 4
.IX Item "autodetect"
.PD 0
.IP \fBxvid_ilace\fR 4
.IX Item "xvid_ilace"
.PD
باگ درهم‌تنیدگی Xvid (در صورت fourcc==XVIX به صورت خودکار شناسایی می‌شود)
.IP \fBump4\fR 4
.IX Item "ump4"
(در صورت fourcc==UMP4 به صورت خودکار شناسایی می‌شود)
.IP \fBno_padding\fR 4
.IX Item "no_padding"
باگ پدینگ (شناسایی خودکار)
.IP \fBamv\fR 4
.IX Item "amv"
.PD 0
.IP \fBqpel_chroma\fR 4
.IX Item "qpel_chroma"
.IP \fBstd_qpel\fR 4
.IX Item "std_qpel"
.PD
qpel استاندارد قدیمی (شناسایی خودکار بر اساس fourcc/نسخه)
.IP \fBqpel_chroma2\fR 4
.IX Item "qpel_chroma2"
.PD 0
.IP \fBdirect_blocksize\fR 4
.IX Item "direct_blocksize"
.PD
باگ direct-qpel-blocksize (شناسایی خودکار بر اساس fourcc/نسخه)
.IP \fBedge\fR 4
.IX Item "edge"
باگ edge padding (شناسایی خودکار بر اساس fourcc/نسخه)
.IP \fBhpel_chroma\fR 4
.IX Item "hpel_chroma"
.PD 0
.IP \fBdc_clip\fR 4
.IX Item "dc_clip"
.IP \fBms\fR 4
.IX Item "ms"
.PD
دور زدن باگ‌های مختلف در دیکودرهای معیوب مایکروسافت.
.IP \fBtrunc\fR 4
.IX Item "trunc"
فریم‌های ناقص/بریده‌شده
.RE
.RS 4
.RE
.IP "\fBstrict\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "strict integer (decoding/encoding,audio,video)"
مشخص کردن میزان سخت‌گیری در پیروی از استانداردها.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBvery\fR 4
.IX Item "very"
انطباق دقیق با یک نسخه قدیمی‌تر و سخت‌گیرانه‌تر از مشخصات فنی یا نرم‌افزار مرجع
.IP \fBstrict\fR 4
.IX Item "strict"
انطباق دقیق با تمام موارد مشخصات فنی صرف‌نظر از پیامدها
.IP \fBnormal\fR 4
.IX Item "normal"
.PD 0
.IP \fBunofficial\fR 4
.IX Item "unofficial"
.PD
اجازه دادن به پسوندهای غیررسمی
.IP \fBexperimental\fR 4
.IX Item "experimental"
اجازه دادن به قابلیت‌های آزمایشی غیراستاندارد، و دیکودرها و انکودرهای آزمایشی (ناتمام/در حال توسعه/آزمایش‌نشده). توجه: دیکودرهای آزمایشی می‌توانند خطرات امنیتی داشته باشند، از این گزینه برای رمزگشایی ورودی‌های غیرقابل اعتماد استفاده نکنید.
.RE
.RS 4
.RE
.IP "\fBb_qoffset\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "b_qoffset float (encoding,video)"
تنظیم آفست QP میان فریم‌های P و B.
.IP "\fBerr_detect\fR \fIflags\fR \fB(\fR\fIدیکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "err_detect flags (decoding,audio,video)"
تنظیم پرچم‌های تشخیص خطا.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBcrccheck\fR 4
.IX Item "crccheck"
تایید CRCهای تعبیه‌شده
.IP \fBbitstream\fR 4
.IX Item "bitstream"
تشخیص انحرافات از مشخصات استریم بیت
.IP \fBbuffer\fR 4
.IX Item "buffer"
تشخیص طول نامناسب بافر استریم بیت
.IP \fBexplode\fR 4
.IX Item "explode"
توقف و خروج از دیکود با تشخیص کوچکترین خطا
.IP \fBignore_err\fR 4
.IX Item "ignore_err"
نادیده گرفتن خطاهای دیکود و ادامه دادن به دیکود. این گزینه در صورتی که قصد تجزیه و تحلیل محتوای یک ویدیو را داشته باشید و بخواهید هر داده‌ای به هر نحو دیکود شود مفید است. این گزینه در صورت وجود خطا منجر به ویدیویی با کیفیت مطلوب برای تماشا نخواهد شد.
.IP \fBcareful\fR 4
.IX Item "careful"
مواردی را که مشخصات را نقض می‌کنند و در عمل دیده نشده‌اند به عنوان خطا در نظر بگیر
.IP \fBcompliant\fR 4
.IX Item "compliant"
تمام موارد عدم انطباق با مشخصات را خطا در نظر بگیر
.IP \fBaggressive\fR 4
.IX Item "aggressive"
مواردی را که یک انکودر عاقل نباید انجام دهد خطا در نظر بگیر
.RE
.RS 4
.RE
.IP "\fBhas_b_frames\fR \fIinteger\fR" 4
.IX Item "has_b_frames integer"
.PD 0
.IP "\fBblock_align\fR \fIinteger\fR" 4
.IX Item "block_align integer"
.IP "\fBrc_override_count\fR \fIinteger\fR" 4
.IX Item "rc_override_count integer"
.IP "\fBmaxrate\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "maxrate integer (encoding,audio,video)"
.PD
تنظیم حداکثر تلورانس نرخ بیت (بر حسب بیت بر ثانیه). نیازمند تنظیم bufsize است.
.IP "\fBminrate\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "minrate integer (encoding,audio,video)"
تنظیم حداقل تلورانس نرخ بیت (بر حسب بیت بر ثانیه). بیشترین کاربرد را در تنظیم انکود CBR دارد، در غیر این صورت کاربرد کمی دارد.
.IP "\fBbufsize\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "bufsize integer (encoding,audio,video)"
تنظیم اندازه بافر کنترل نرخ (بر حسب بیت).
.IP "\fBi_qfactor\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "i_qfactor float (encoding,video)"
تنظیم فاکتور QP میان فریم‌های P و I.
.IP "\fBi_qoffset\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "i_qoffset float (encoding,video)"
تنظیم آفست QP میان فریم‌های P و I.
.IP "\fBdct\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "dct integer (encoding,video)"
تنظیم الگوریتم DCT.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار یک گزینه مناسب (پیش‌فرض)
.IP \fBfastint\fR 4
.IX Item "fastint"
عدد صحیح سریع
.IP \fBint\fR 4
.IX Item "int"
عدد صحیح دقیق
.IP \fBmmx\fR 4
.IX Item "mmx"
.PD 0
.IP \fBaltivec\fR 4
.IX Item "altivec"
.IP \fBfaan\fR 4
.IX Item "faan"
.PD
تبدیل DCT ممیز شناور AAN
.RE
.RS 4
.RE
.IP "\fBlumi_mask\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "lumi_mask float (encoding,video)"
فشرده‌سازی شدیدتر نواحی بسیار روشن نسبت به نواحی متوسط.
.IP "\fBtcplx_mask\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "tcplx_mask float (encoding,video)"
تنظیم ماسک پیچیدگی زمانی (temporal complexity masking).
.IP "\fBscplx_mask\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "scplx_mask float (encoding,video)"
تنظیم ماسک پیچیدگی مکانی (spatial complexity masking).
.IP "\fBp_mask\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "p_mask float (encoding,video)"
تنظیم ماسک‌گذاری بین‌فریمی (inter masking).
.IP "\fBdark_mask\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "dark_mask float (encoding,video)"
فشرده‌سازی شدیدتر نواحی تاریک نسبت به نواحی متوسط.
.IP "\fBidct\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "idct integer (decoding/encoding,video)"
انتخاب پیاده‌سازی IDCT.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
.PD 0
.IP \fBint\fR 4
.IX Item "int"
.IP \fBsimple\fR 4
.IX Item "simple"
.IP \fBsimplemmx\fR 4
.IX Item "simplemmx"
.IP \fBsimpleauto\fR 4
.IX Item "simpleauto"
.PD
انتخاب خودکار یک IDCT سازگار با simple
.IP \fBarm\fR 4
.IX Item "arm"
.PD 0
.IP \fBaltivec\fR 4
.IX Item "altivec"
.IP \fBsh4\fR 4
.IX Item "sh4"
.IP \fBsimplearm\fR 4
.IX Item "simplearm"
.IP \fBsimplearmv5te\fR 4
.IX Item "simplearmv5te"
.IP \fBsimplearmv6\fR 4
.IX Item "simplearmv6"
.IP \fBsimpleneon\fR 4
.IX Item "simpleneon"
.IP \fBxvid\fR 4
.IX Item "xvid"
.IP \fBfaani\fR 4
.IX Item "faani"
.PD
تبدیل IDCT ممیز شناور AAN
.RE
.RS 4
.RE
.IP "\fBslice_count\fR \fIinteger\fR" 4
.IX Item "slice_count integer"
.PD 0
.IP "\fBec\fR \fIflags\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "ec flags (decoding,video)"
.PD
تنظیم راهبرد پنهان‌سازی خطا (Error Concealment).
.Sp
مقادیر ممکن:
.RS 4
.IP \fBguess_mvs\fR 4
.IX Item "guess_mvs"
جستجوی تکرارشونده بردار حرکت (MV) (کند)
.IP \fBdeblock\fR 4
.IX Item "deblock"
استفاده از فیلتر deblock قوی برای ماکروبلاک‌های آسیب‌دیده
.IP \fBfavor_inter\fR 4
.IX Item "favor_inter"
ترجیح پیش‌بینی از فریم قبلی به جای فریم فعلی
.RE
.RS 4
.RE
.IP "\fBbits_per_coded_sample\fR \fIinteger\fR" 4
.IX Item "bits_per_coded_sample integer"
.PD 0
.IP "\fBaspect\fR \fIrational number\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "aspect rational number (encoding,video)"
.PD
تنظیم نسبت ابعاد نمونه (SAR).
.IP "\fBsar\fR \fIrational number\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "sar rational number (encoding,video)"
تنظیم نسبت ابعاد نمونه. نام مستعار برای \fIaspect\fR.
.IP "\fBdebug\fR \fIflags\fR \fB(\fR\fIدیکود/انکود،صدا،ویدیو،زیرنویس\fR\fB)\fR" 4
.IX Item "debug flags (decoding/encoding,audio,video,subtitles)"
چاپ اطلاعات اشکال‌زدایی مشخص.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBpict\fR 4
.IX Item "pict"
اطلاعات تصویر
.IP \fBrc\fR 4
.IX Item "rc"
کنترل نرخ
.IP \fBbitstream\fR 4
.IX Item "bitstream"
.PD 0
.IP \fBmb_type\fR 4
.IX Item "mb_type"
.PD
نوع ماکروبلاک (MB)
.IP \fBqp\fR 4
.IX Item "qp"
پارامتر کوانتیزاسیون به‌ازای هر ماکروبلاک (QP)
.IP \fBmv\fR 4
.IX Item "mv"
بردار حرکت
.IP \fBdct_coeff\fR 4
.IX Item "dct_coeff"
.PD 0
.IP \fBskip\fR 4
.IX Item "skip"
.IP \fBstartcode\fR 4
.IX Item "startcode"
.IP \fBpts\fR 4
.IX Item "pts"
.IP \fBer\fR 4
.IX Item "er"
.PD
تاب‌آوری خطا
.IP \fBmmco\fR 4
.IX Item "mmco"
دستورات مدیریت حافظه (کنترل رفرنس فریم H.264)
.IP \fBbugs\fR 4
.IX Item "bugs"
.PD 0
.IP \fBbuffers\fR 4
.IX Item "buffers"
.PD
عملیات بافر تصویر
.IP \fBthread_ops\fR 4
.IX Item "thread_ops"
عملیات چندرشته‌ای
.IP \fBnomc\fR 4
.IX Item "nomc"
صرف‌نظر کردن از جبران حرکت (فقط رسم بردارها)
.RE
.RS 4
.RE
.IP "\fBcmp\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "cmp integer (encoding,video)"
تنظیم تابع مقایسه تخمین حرکت در سطح پیکسل کامل (full pel me).
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsad\fR 4
.IX Item "sad"
مجموع قدر مطلق تفاضل‌ها، سریع (پیش‌فرض)
.IP \fBsse\fR 4
.IX Item "sse"
مجموع مربعات خطاها
.IP \fBsatd\fR 4
.IX Item "satd"
مجموع قدر مطلق تفاضل‌های تبدیل هادامارد
.IP \fBdct\fR 4
.IX Item "dct"
مجموع قدر مطلق تفاضل‌های تبدیل DCT
.IP \fBpsnr\fR 4
.IX Item "psnr"
مجموع مربعات خطاهای کوانتیزاسیون (اجتناب شود، کیفیت پایین)
.IP \fBbit\fR 4
.IX Item "bit"
تعداد بیت‌های مورد نیاز برای بلوک
.IP \fBrd\fR 4
.IX Item "rd"
بهینه‌سازی نرخ-اعوجاج (RD)، کند
.IP \fBzero\fR 4
.IX Item "zero"
0
.IP \fBvsad\fR 4
.IX Item "vsad"
مجموع قدر مطلق تفاضل‌های عمودی
.IP \fBvsse\fR 4
.IX Item "vsse"
مجموع مربعات تفاضل‌های عمودی
.IP \fBnsse\fR 4
.IX Item "nsse"
مجموع مربعات تفاضل‌ها با حفظ نویز
.IP \fBw53\fR 4
.IX Item "w53"
موجک 5/3، تنها در snow استفاده می‌شود
.IP \fBw97\fR 4
.IX Item "w97"
موجک 9/7، تنها در snow استفاده می‌شود
.IP \fBdctmax\fR 4
.IX Item "dctmax"
.PD 0
.IP \fBchroma\fR 4
.IX Item "chroma"
.PD
.RE
.RS 4
.RE
.IP "\fBsubcmp\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "subcmp integer (encoding,video)"
تنظیم تابع مقایسه تخمین حرکت زیرپیکسل (sub pel me).
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsad\fR 4
.IX Item "sad"
مجموع قدر مطلق تفاضل‌ها، سریع (پیش‌فرض)
.IP \fBsse\fR 4
.IX Item "sse"
مجموع مربعات خطاها
.IP \fBsatd\fR 4
.IX Item "satd"
مجموع قدر مطلق تفاضل‌های تبدیل هادامارد
.IP \fBdct\fR 4
.IX Item "dct"
مجموع قدر مطلق تفاضل‌های تبدیل DCT
.IP \fBpsnr\fR 4
.IX Item "psnr"
مجموع مربعات خطاهای کوانتیزاسیون (اجتناب شود، کیفیت پایین)
.IP \fBbit\fR 4
.IX Item "bit"
تعداد بیت‌های مورد نیاز برای بلوک
.IP \fBrd\fR 4
.IX Item "rd"
بهینه‌سازی نرخ-اعوجاج (RD)، کند
.IP \fBzero\fR 4
.IX Item "zero"
0
.IP \fBvsad\fR 4
.IX Item "vsad"
مجموع قدر مطلق تفاضل‌های عمودی
.IP \fBvsse\fR 4
.IX Item "vsse"
مجموع مربعات تفاضل‌های عمودی
.IP \fBnsse\fR 4
.IX Item "nsse"
مجموع مربعات تفاضل‌ها با حفظ نویز
.IP \fBw53\fR 4
.IX Item "w53"
موجک 5/3، تنها در snow استفاده می‌شود
.IP \fBw97\fR 4
.IX Item "w97"
موجک 9/7، تنها در snow استفاده می‌شود
.IP \fBdctmax\fR 4
.IX Item "dctmax"
.PD 0
.IP \fBchroma\fR 4
.IX Item "chroma"
.PD
.RE
.RS 4
.RE
.IP "\fBmbcmp\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "mbcmp integer (encoding,video)"
تنظیم تابع مقایسه تصمیم‌گیری ماکروبلاک.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsad\fR 4
.IX Item "sad"
مجموع قدر مطلق تفاضل‌ها، سریع (پیش‌فرض)
.IP \fBsse\fR 4
.IX Item "sse"
مجموع مربعات خطاها
.IP \fBsatd\fR 4
.IX Item "satd"
مجموع قدر مطلق تفاضل‌های تبدیل هادامارد
.IP \fBdct\fR 4
.IX Item "dct"
مجموع قدر مطلق تفاضل‌های تبدیل DCT
.IP \fBpsnr\fR 4
.IX Item "psnr"
مجموع مربعات خطاهای کوانتیزاسیون (اجتناب شود، کیفیت پایین)
.IP \fBbit\fR 4
.IX Item "bit"
تعداد بیت‌های مورد نیاز برای بلوک
.IP \fBrd\fR 4
.IX Item "rd"
بهینه‌سازی نرخ-اعوجاج (RD)، کند
.IP \fBzero\fR 4
.IX Item "zero"
0
.IP \fBvsad\fR 4
.IX Item "vsad"
مجموع قدر مطلق تفاضل‌های عمودی
.IP \fBvsse\fR 4
.IX Item "vsse"
مجموع مربعات تفاضل‌های عمودی
.IP \fBnsse\fR 4
.IX Item "nsse"
مجموع مربعات تفاضل‌ها با حفظ نویز
.IP \fBw53\fR 4
.IX Item "w53"
موجک 5/3، تنها در snow استفاده می‌شود
.IP \fBw97\fR 4
.IX Item "w97"
موجک 9/7، تنها در snow استفاده می‌شود
.IP \fBdctmax\fR 4
.IX Item "dctmax"
.PD 0
.IP \fBchroma\fR 4
.IX Item "chroma"
.PD
.RE
.RS 4
.RE
.IP "\fBildctcmp\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "ildctcmp integer (encoding,video)"
تنظیم تابع مقایسه درهم‌تنیده DCT.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsad\fR 4
.IX Item "sad"
مجموع قدر مطلق تفاضل‌ها، سریع (پیش‌فرض)
.IP \fBsse\fR 4
.IX Item "sse"
مجموع مربعات خطاها
.IP \fBsatd\fR 4
.IX Item "satd"
مجموع قدر مطلق تفاضل‌های تبدیل هادامارد
.IP \fBdct\fR 4
.IX Item "dct"
مجموع قدر مطلق تفاضل‌های تبدیل DCT
.IP \fBpsnr\fR 4
.IX Item "psnr"
مجموع مربعات خطاهای کوانتیزاسیون (اجتناب شود، کیفیت پایین)
.IP \fBbit\fR 4
.IX Item "bit"
تعداد بیت‌های مورد نیاز برای بلوک
.IP \fBrd\fR 4
.IX Item "rd"
بهینه‌سازی نرخ-اعوجاج (RD)، کند
.IP \fBzero\fR 4
.IX Item "zero"
0
.IP \fBvsad\fR 4
.IX Item "vsad"
مجموع قدر مطلق تفاضل‌های عمودی
.IP \fBvsse\fR 4
.IX Item "vsse"
مجموع مربعات تفاضل‌های عمودی
.IP \fBnsse\fR 4
.IX Item "nsse"
مجموع مربعات تفاضل‌ها با حفظ نویز
.IP \fBw53\fR 4
.IX Item "w53"
موجک 5/3، تنها در snow استفاده می‌شود
.IP \fBw97\fR 4
.IX Item "w97"
موجک 9/7، تنها در snow استفاده می‌شود
.IP \fBdctmax\fR 4
.IX Item "dctmax"
.PD 0
.IP \fBchroma\fR 4
.IX Item "chroma"
.PD
.RE
.RS 4
.RE
.IP "\fBdia_size\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "dia_size integer (encoding,video)"
تنظیم نوع و اندازه لوزی (diamond) برای تخمین حرکت.
.Sp
مقادیر ممکن:
.RS 4
.IP "\fB(1024, INT_MAX)\fR" 4
.IX Item "(1024, INT_MAX)"
الگوی لوزی تطبیقی با اندازه (1024-INT_MAX)
.IP "\fB(768, 1024]\fR" 4
.IX Item "(768, 1024]"
الگوی شش‌ضلعی تطبیقی (HEX)
.IP "\fB(512, 768]\fR" 4
.IX Item "(512, 768]"
الگوی شش‌ضلعی ناهموار چندمنظوره (UMH)
.IP "\fB(256, 512]\fR" 4
.IX Item "(256, 512]"
الگوی ستاره‌ای تطبیقی
.IP "\fB(\-1,  2)\fR" 4
.IX Item "(-1,  2)"
لوزی با شعاع ۱
.IP "\fB(INT_MIN, \-1)\fR" 4
.IX Item "(INT_MIN, -1)"
الگوی لوزی با اندازه معکوس
.RE
.RS 4
.RE
.IP "\fBlast_pred\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "last_pred integer (encoding,video)"
میزان پیش‌بینی‌کننده‌های حرکت از فریم قبلی.
.IP "\fBprecmp\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "precmp integer (encoding,video)"
تنظیم تابع مقایسه پیش‌پاس تخمین حرکت.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsad\fR 4
.IX Item "sad"
مجموع قدر مطلق تفاضل‌ها، سریع (پیش‌فرض)
.IP \fBsse\fR 4
.IX Item "sse"
مجموع مربعات خطاها
.IP \fBsatd\fR 4
.IX Item "satd"
مجموع قدر مطلق تفاضل‌های تبدیل هادامارد
.IP \fBdct\fR 4
.IX Item "dct"
مجموع قدر مطلق تفاضل‌های تبدیل DCT
.IP \fBpsnr\fR 4
.IX Item "psnr"
مجموع مربعات خطاهای کوانتیزاسیون (اجتناب شود، کیفیت پایین)
.IP \fBbit\fR 4
.IX Item "bit"
تعداد بیت‌های مورد نیاز برای بلوک
.IP \fBrd\fR 4
.IX Item "rd"
بهینه‌سازی نرخ-اعوجاج (RD)، کند
.IP \fBzero\fR 4
.IX Item "zero"
0
.IP \fBvsad\fR 4
.IX Item "vsad"
مجموع قدر مطلق تفاضل‌های عمودی
.IP \fBvsse\fR 4
.IX Item "vsse"
مجموع مربعات تفاضل‌های عمودی
.IP \fBnsse\fR 4
.IX Item "nsse"
مجموع مربعات تفاضل‌ها با حفظ نویز
.IP \fBw53\fR 4
.IX Item "w53"
موجک 5/3، تنها در snow استفاده می‌شود
.IP \fBw97\fR 4
.IX Item "w97"
موجک 9/7، تنها در snow استفاده می‌شود
.IP \fBdctmax\fR 4
.IX Item "dctmax"
.PD 0
.IP \fBchroma\fR 4
.IX Item "chroma"
.PD
.RE
.RS 4
.RE
.IP "\fBpre_dia_size\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "pre_dia_size integer (encoding,video)"
تنظیم نوع و اندازه لوزی برای پیش‌پاس تخمین حرکت.
.IP "\fBsubq\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "subq integer (encoding,video)"
تنظیم کیفیت تخمین حرکت زیرپیکسلی.
.IP "\fBme_range\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "me_range integer (encoding,video)"
تنظیم محدودیت دامنه بردارهای حرکت (1023 برای پخش‌کننده DivX).
.IP "\fBglobal_quality\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "global_quality integer (encoding,audio,video)"
.PD 0
.IP "\fBslice_flags\fR \fIinteger\fR" 4
.IX Item "slice_flags integer"
.IP "\fBmbd\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "mbd integer (encoding,video)"
.PD
تنظیم الگوریتم تصمیم‌گیری ماکروبلاک (حالت با کیفیت بالا).
.Sp
مقادیر ممکن:
.RS 4
.IP \fBsimple\fR 4
.IX Item "simple"
استفاده از mbcmp (پیش‌فرض)
.IP \fBbits\fR 4
.IX Item "bits"
استفاده از کمترین بیت
.IP \fBrd\fR 4
.IX Item "rd"
استفاده از بهترین بهینه‌سازی نرخ-اعوجاج (RD)
.RE
.RS 4
.RE
.IP "\fBrc_init_occupancy\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "rc_init_occupancy integer (encoding,video)"
تنظیم تعداد بیت‌هایی که باید پیش از آغاز دیکود در بافر کنترل نرخ (rc buffer) بارگذاری شوند.
.IP "\fBflags2\fR \fIflags\fR \fB(\fR\fIدیکود/انکود،صدا،ویدیو،زیرنویس\fR\fB)\fR" 4
.IX Item "flags2 flags (decoding/encoding,audio,video,subtitles)"
مقادیر ممکن:
.RS 4
.IP \fBfast\fR 4
.IX Item "fast"
اجازه دادن به ترفندهای افزایش سرعت مغایر با مشخصات استاندارد.
.IP \fBnoout\fR 4
.IX Item "noout"
صرف‌نظر کردن از انکود استریم بیت.
.IP \fBignorecrop\fR 4
.IX Item "ignorecrop"
نادیده گرفتن اطلاعات برش (crop) از sps.
.IP \fBlocal_header\fR 4
.IX Item "local_header"
قرار دادن هدرهای سراسری در هر فریم کلیدی به جای extradata.
.IP \fBchunks\fR 4
.IX Item "chunks"
داده‌های فریم ممکن است به چندین بخش تقسیم شوند.
.IP \fBshowall\fR 4
.IX Item "showall"
نمایش تمام فریم‌ها قبل از اولین فریم کلیدی.
.IP \fBexport_mvs\fR 4
.IX Item "export_mvs"
برون‌ریزی بردارهای حرکت به داده‌های جانبی فریم (\f(CW\*(C`AV_FRAME_DATA_MOTION_VECTORS\*(C'\fR را ببینید) برای کدک‌هایی که پشتیبانی می‌کنند. همچنین \fIdoc/examples/export_mvs.c\fR را ببینید.
.IP \fBskip_manual\fR 4
.IX Item "skip_manual"
صرف‌نظر نکردن از نمونه‌ها و برون‌ریزی اطلاعات پرش به عنوان داده‌های جانبی فریم.
.IP \fBass_ro_flush_noop\fR 4
.IX Item "ass_ro_flush_noop"
عدم بازنشانی فیلد ReadOrder در ASS هنگام flush.
.IP \fBicc_profiles\fR 4
.IX Item "icc_profiles"
تولید/تجزیه پروفایل‌های تعبیه‌شده ICC از/به تگ‌های رنگ‌سنجی (colorimetry).
.IP \fBfixed_frame_size\fR 4
.IX Item "fixed_frame_size"
اجبار انکودرهای صوتی به استفاده از اندازه فریم ثابت.
.RE
.RS 4
.RE
.IP "\fBexport_side_data\fR \fIflags\fR \fB(\fR\fIدیکود/انکود،صدا،ویدیو،زیرنویس\fR\fB)\fR" 4
.IX Item "export_side_data flags (decoding/encoding,audio,video,subtitles)"
مقادیر ممکن:
.RS 4
.IP \fBmvs\fR 4
.IX Item "mvs"
برون‌ریزی بردارهای حرکت در داده‌های جانبی فریم (\f(CW\*(C`AV_FRAME_DATA_MOTION_VECTORS\*(C'\fR را ببینید) برای کدک‌های دارای پشتیبانی. همچنین \fIdoc/examples/export_mvs.c\fR را ببینید.
.IP \fBprft\fR 4
.IX Item "prft"
برون‌ریزی زمان مرجع تولیدکننده انکودر به داده‌های جانبی بسته (\f(CW\*(C`AV_PKT_DATA_PRFT\*(C'\fR را ببینید) برای کدک‌های دارای پشتیبانی.
.IP \fBvenc_params\fR 4
.IX Item "venc_params"
برون‌ریزی پارامترهای انکود ویدیو از طریق داده‌های جانبی فریم (\f(CW\*(C`AV_FRAME_DATA_VIDEO_ENC_PARAMS\*(C'\fR را ببینید) برای کدک‌های دارای پشتیبانی. در حال حاضر H.264 و VP9.
.IP \fBfilm_grain\fR 4
.IX Item "film_grain"
برون‌ریزی پارامترهای دانه فیلم از طریق داده‌های جانبی فریم (\f(CW\*(C`AV_FRAME_DATA_FILM_GRAIN_PARAMS\*(C'\fR را ببینید). در حال حاضر توسط دیکودرهای AV1 پشتیبانی می‌شود.
.IP \fBenhancements\fR 4
.IX Item "enhancements"
برون‌ریزی متاداده‌های بهبود تصویر از طریق داده‌های جانبی فریم، مثلاً LCEVC (به \f(CW\*(C`AV_FRAME_DATA_LCEVC\*(C'\fR مراجعه کنید).
.RE
.RS 4
.RE
.IP "\fBthreads\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "threads integer (decoding/encoding,video)"
تنظیم تعداد رشته‌های پردازشی (threads) مورد استفاده، در صورتی که پیاده‌سازی کدک انتخابی از چندرشتگی پشتیبانی کند.
.Sp
مقادیر ممکن:
.RS 4
.IP "\fBauto, 0\fR" 4
.IX Item "auto, 0"
انتخاب خودکار تعداد رشته‌ها
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBauto\fR است.
.RE
.IP "\fBdc\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "dc integer (encoding,video)"
تنظیم intra_dc_precision.
.IP "\fBnssew\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "nssew integer (encoding,video)"
تنظیم وزن nsse.
.IP "\fBskip_top\fR \fIinteger\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_top integer (decoding,video)"
تنظیم تعداد ردیف‌های ماکروبلاک بالایی که صرف‌نظر می‌شوند.
.IP "\fBskip_bottom\fR \fIinteger\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_bottom integer (decoding,video)"
تنظیم تعداد ردیف‌های ماکروبلاک پایینی که صرف‌نظر می‌شوند.
.IP "\fBprofile\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "profile integer (encoding,audio,video)"
تنظیم پروفایل کدک انکودر. مقدار پیش‌فرض \fBunknown\fR است. پروفایل‌های خاص انکودرها در مستندات انکودر مربوطه شرح داده شده‌اند.
.IP "\fBlevel\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "level integer (encoding,audio,video)"
تنظیم سطح (level) انکودر. این سطح به کدک مشخص بستگی دارد و ممکن است با سطح پروفایل مطابقت داشته باشد. به‌طور پیش‌فرض روی \&\fBunknown\fR تنظیم است.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBunknown\fR 4
.IX Item "unknown"
.RE
.RS 4
.RE
.IP "\fBlowres\fR \fIinteger\fR \fB(\fR\fIدیکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "lowres integer (decoding,audio,video)"
دیکود در وضوح‌های پایین‌تر 1= 1/2، 2=1/4، 3=1/8.
.IP "\fBmblmin\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "mblmin integer (encoding,video)"
تنظیم حداقل مقیاس کوانتیایزر ماکروبلاک (VBR). باید بین -1 و 69 باشد، مقدار پیش‌فرض 2 است.
.IP "\fBmblmax\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "mblmax integer (encoding,video)"
تنظیم حداکثر مقیاس کوانتیایزر ماکروبلاک (VBR). باید بین -1 و 1024 باشد، مقدار پیش‌فرض 31 است.
.IP "\fBskip_loop_filter\fR \fIinteger\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_loop_filter integer (decoding,video)"
.PD 0
.IP "\fBskip_idct\fR        \fIinteger\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_idct        integer (decoding,video)"
.IP "\fBskip_frame\fR       \fIinteger\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_frame       integer (decoding,video)"
.PD
صرف‌نظر کردن از پردازش فیلتر حلقه / IDCT / فریم‌ها بر اساس معیار انتخاب‌شده.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
صرف‌نظر نکردن از هیچ فیلتر حلقه‌ای / فریمی
.IP \fBdefault\fR 4
.IX Item "default"
پیش‌فرض
.IP \fBnoref\fR 4
.IX Item "noref"
صرف‌نظر کردن از فریم‌های غیرمرجع
.IP \fBbidir\fR 4
.IX Item "bidir"
صرف‌نظر کردن از فریم‌های دوطرفه (B)
.IP \fBnokey\fR 4
.IX Item "nokey"
صرف‌نظر کردن از تمام فریم‌ها به جز فریم‌های کلیدی
.IP \fBall\fR 4
.IX Item "all"
صرف‌نظر کردن از تمام فریم‌ها
.RE
.RS 4
.RE
.IP "\fBbidir_refine\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "bidir_refine integer (encoding,video)"
بهبود و اصلاح بردارهای حرکت دوطرفه مورد استفاده در فریم‌های B.
.IP "\fBkeyint_min\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "keyint_min integer (encoding,video)"
حداقل فاصله میان فریم‌های IDR/کلیدی.
.IP "\fBrefs\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "refs integer (encoding,video)"
تعداد فریم‌های مرجع مورد استفاده برای جبران حرکت.
.IP "\fBtrellis\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "trellis integer (encoding,audio,video)"
کوانتیزاسیون بهینه‌سازی نرخ-اعوجاج Trellis.
.IP "\fBmv0_threshold\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "mv0_threshold integer (encoding,video)"
آستانه بردار حرکت صفر (mv0).
.IP "\fBcompression_level\fR \fIinteger\fR \fB(\fR\fIانکود،صدا،ویدیو\fR\fB)\fR" 4
.IX Item "compression_level integer (encoding,audio,video)"
سطح فشرده‌سازی.
.IP "\fBbits_per_raw_sample\fR \fIinteger\fR" 4
.IX Item "bits_per_raw_sample integer"
تعداد بیت‌ها به‌ازای هر نمونه خام.
.IP "\fBchannel_layout\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،صدا\fR\fB)\fR" 4
.IX Item "channel_layout integer (decoding/encoding,audio)"
چینش کانال صوتی.
.IP "\fBrc_max_vbv_use\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "rc_max_vbv_use float (encoding,video)"
.PD 0
.IP "\fBrc_min_vbv_use\fR \fIfloat\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "rc_min_vbv_use float (encoding,video)"
.PD
حداکثر / حداقل استفاده مجاز از بافر VBV.
.IP "\fBcolor_primaries\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
.IX Item "color_primaries integer (decoding/encoding,video)"
.PD
Possible values:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBbt470m\fR 4
.IX Item "bt470m"
BT.470 M
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470 BG
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE 170 M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE 240 M
.IP \fBfilm\fR 4
.IX Item "film"
Film
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.PD 0
.IP \fBsmpte428_1\fR 4
.IX Item "smpte428_1"
.PD
SMPTE ST 428\-1
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
SMPTE 431\-2
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
SMPTE 432\-1
.IP \fBjedec\-p22\fR 4
.IX Item "jedec-p22"
JEDEC P22
.RE
.RS 4
.RE
.IP "\fBcolor_trc\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
.IX Item "color_trc integer (decoding/encoding,video)"
Possible values:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBgamma22\fR 4
.IX Item "gamma22"
BT.470 M
.IP \fBgamma28\fR 4
.IX Item "gamma28"
BT.470 BG
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE 170 M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE 240 M
.IP \fBlinear\fR 4
.IX Item "linear"
Linear
.IP \fBlog\fR 4
.IX Item "log"
.PD 0
.IP \fBlog100\fR 4
.IX Item "log100"
.PD
Log
.IP \fBlog_sqrt\fR 4
.IX Item "log_sqrt"
.PD 0
.IP \fBlog316\fR 4
.IX Item "log316"
.PD
Log square root
.IP \fBiec61966_2_4\fR 4
.IX Item "iec61966_2_4"
.PD 0
.IP \fBiec61966\-2\-4\fR 4
.IX Item "iec61966-2-4"
.PD
IEC 61966\-2\-4
.IP \fBbt1361\fR 4
.IX Item "bt1361"
.PD 0
.IP \fBbt1361e\fR 4
.IX Item "bt1361e"
.PD
BT.1361
.IP \fBiec61966_2_1\fR 4
.IX Item "iec61966_2_1"
.PD 0
.IP \fBiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
.PD
IEC 61966\-2\-1
.IP \fBbt2020_10\fR 4
.IX Item "bt2020_10"
.PD 0
.IP \fBbt2020_10bit\fR 4
.IX Item "bt2020_10bit"
.PD
BT.2020 \- 10 bit
.IP \fBbt2020_12\fR 4
.IX Item "bt2020_12"
.PD 0
.IP \fBbt2020_12bit\fR 4
.IX Item "bt2020_12bit"
.PD
BT.2020 \- 12 bit
.IP \fBsmpte2084\fR 4
.IX Item "smpte2084"
SMPTE ST 2084
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.PD 0
.IP \fBsmpte428_1\fR 4
.IX Item "smpte428_1"
.PD
SMPTE ST 428\-1
.IP \fBarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
ARIB STD\-B67
.RE
.RS 4
.RE
.IP "\fBcolorspace\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4
.IX Item "colorspace integer (decoding/encoding,video)"
Possible values:
.RS 4
.IP \fBrgb\fR 4
.IX Item "rgb"
RGB
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBfcc\fR 4
.IX Item "fcc"
FCC
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470 BG
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE 170 M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE 240 M
.IP \fBycocg\fR 4
.IX Item "ycocg"
YCOCG
.IP \fBbt2020nc\fR 4
.IX Item "bt2020nc"
.PD 0
.IP \fBbt2020_ncl\fR 4
.IX Item "bt2020_ncl"
.PD
BT.2020 NCL
.IP \fBbt2020c\fR 4
.IX Item "bt2020c"
.PD 0
.IP \fBbt2020_cl\fR 4
.IX Item "bt2020_cl"
.PD
BT.2020 CL
.IP \fBsmpte2085\fR 4
.IX Item "smpte2085"
SMPTE 2085
.IP \fBchroma\-derived\-nc\fR 4
.IX Item "chroma-derived-nc"
Chroma\-derived NCL
.IP \fBchroma\-derived\-c\fR 4
.IX Item "chroma-derived-c"
Chroma\-derived CL
.IP \fBictcp\fR 4
.IX Item "ictcp"
ICtCp
.RE
.RS 4
.RE
.IP "\fBcolor_range\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "color_range integer (decoding/encoding,video)"
در صورت استفاده به عنوان پارامتر ورودی، به عنوان راهنمایی برای دیکودر عمل می‌کند که ورودی دارای چه color_range است.
مقادیر ممکن:
.RS 4
.IP \fBtv\fR 4
.IX Item "tv"
.PD 0
.IP \fBmpeg\fR 4
.IX Item "mpeg"
.IP \fBlimited\fR 4
.IX Item "limited"
.PD
محدوده محدود MPEG (219*2^(n\-8))
.IP \fBpc\fR 4
.IX Item "pc"
.PD 0
.IP \fBjpeg\fR 4
.IX Item "jpeg"
.IP \fBfull\fR 4
.IX Item "full"
.PD
محدوده کامل JPEG (2^n\-1)
.RE
.RS 4
.RE
.IP "\fBchroma_sample_location\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "chroma_sample_location integer (decoding/encoding,video)"
موقعیت نمونه‌برداری کروما.
مقادیر ممکن:
.RS 4
.IP \fBleft\fR 4
.IX Item "left"
.PD 0
.IP \fBcenter\fR 4
.IX Item "center"
.IP \fBtopleft\fR 4
.IX Item "topleft"
.IP \fBtop\fR 4
.IX Item "top"
.IP \fBbottomleft\fR 4
.IX Item "bottomleft"
.IP \fBbottom\fR 4
.IX Item "bottom"
.PD
.RE
.RS 4
.RE
.IP "\fBalpha_mode\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "alpha_mode integer (decoding/encoding,video)"
حالت کانال آلفا.
مقادیر ممکن:
.RS 4
.IP \fBpremultiplied\fR 4
.IX Item "premultiplied"
.PD 0
.IP \fBstraight\fR 4
.IX Item "straight"
.PD
.RE
.RS 4
.RE
.IP "\fBlog_level_offset\fR \fIinteger\fR" 4
.IX Item "log_level_offset integer"
تنظیم آفست سطح گزارش‌گیری (log level).
.IP "\fBslices\fR \fIinteger\fR \fB(\fR\fIانکود،ویدیو\fR\fB)\fR" 4
.IX Item "slices integer (encoding,video)"
تعداد اسلایس‌ها، مورد استفاده در انکود موازی.
.IP "\fBthread_type\fR \fIflags\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "thread_type flags (decoding/encoding,video)"
انتخاب روش‌های چندرشتگی برای استفاده.
.Sp
استفاده از \fBframe\fR تأخیر دیکود را به میزان یک فریم به‌ازای هر رشته افزایش می‌دهد، بنابراین کلاینت‌هایی که نمی‌توانند فریم‌های آینده را فراهم کنند نباید از آن استفاده نمایند.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBslice\fR 4
.IX Item "slice"
دیکود همزمان بیش از یک بخش از یک تک فریم.
.Sp
چندرشتگی با استفاده از اسلایس‌ها تنها در صورتی کار می‌کند که ویدیو با اسلایس‌ها انکود شده باشد.
.IP \fBframe\fR 4
.IX Item "frame"
دیکود همزمان بیش از یک فریم.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBslice+frame\fR است.
.RE
.IP "\fBaudio_service_type\fR \fIinteger\fR \fB(\fR\fIانکود،صدا\fR\fB)\fR" 4
.IX Item "audio_service_type integer (encoding,audio)"
تنظیم نوع سرویس صدا.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBma\fR 4
.IX Item "ma"
سرویس اصلی صدا (Main Audio Service)
.IP \fBef\fR 4
.IX Item "ef"
جلوه‌های صوتی (Effects)
.IP \fBvi\fR 4
.IX Item "vi"
ویژه آسیب‌دیدگان بینایی (Visually Impaired)
.IP \fBhi\fR 4
.IX Item "hi"
ویژه آسیب‌دیدگان شنوایی (Hearing Impaired)
.IP \fBdi\fR 4
.IX Item "di"
گفتگو و دیالوگ (Dialogue)
.IP \fBco\fR 4
.IX Item "co"
تفسیر و توضیحات (Commentary)
.IP \fBem\fR 4
.IX Item "em"
وضعیت اضطراری (Emergency)
.IP \fBvo\fR 4
.IX Item "vo"
صداپیشگی و نریشن (Voice Over)
.IP \fBka\fR 4
.IX Item "ka"
کارائوکه (Karaoke)
.RE
.RS 4
.RE
.IP "\fBrequest_sample_fmt\fR \fIsample_fmt\fR \fB(\fR\fIدیکود،صدا\fR\fB)\fR" 4
.IX Item "request_sample_fmt sample_fmt (decoding,audio)"
تنظیم قالب نمونه ترجیحی دیکودرهای صوتی. مقدار پیش‌فرض \&\f(CW\*(C`none\*(C'\fR است.
.IP "\fBpkt_timebase\fR \fIrational number\fR" 4
.IX Item "pkt_timebase rational number"
.PD 0
.IP "\fBsub_charenc\fR \fIencoding\fR \fB(\fR\fIدیکود،زیرنویس\fR\fB)\fR" 4
.IX Item "sub_charenc encoding (decoding,subtitles)"
.PD
تنظیم کدگذاری نویسه‌های زیرنویس ورودی.
.IP "\fBfield_order\fR  \fIfield_order\fR \fB(\fR\fIویدیو\fR\fB)\fR" 4
.IX Item "field_order field_order (video)"
تنظیم/بازنویسی ترتیب فیلدهای ویدیو.
مقادیر ممکن:
.RS 4
.IP \fBprogressive\fR 4
.IX Item "progressive"
ویدیوی پروگرسیو (Progressive)
.IP \fBtt\fR 4
.IX Item "tt"
ویدیوی درهم‌تنیده، فیلد بالایی ابتدا کدگذاری و نمایش داده می‌شود
.IP \fBbb\fR 4
.IX Item "bb"
ویدیوی درهم‌تنیده، فیلد پایینی ابتدا کدگذاری و نمایش داده می‌شود
.IP \fBtb\fR 4
.IX Item "tb"
ویدیوی درهم‌تنیده، بالایی ابتدا کدگذاری، پایینی ابتدا نمایش داده می‌شود
.IP \fBbt\fR 4
.IX Item "bt"
ویدیوی درهم‌تنیده، پایینی ابتدا کدگذاری، بالایی ابتدا نمایش داده می‌شود
.RE
.RS 4
.RE
.IP "\fBskip_alpha\fR \fIbool\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "skip_alpha bool (decoding,video)"
تنظیم روی 1 برای غیرفعال کردن پردازش آلفا (شفافیت). این همانند پرچم \&\fBgray\fR در گزینهٔ \fBflags\fR عمل می‌کند که از اطلاعات کروما به جای آلفا صرف‌نظر می‌نماید. مقدار پیش‌فرض 0 است.
.IP "\fBcodec_whitelist\fR \fIlist\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "codec_whitelist list (input)"
فهرست با کاما جداشده از دیکودرهای مجاز. به‌طور پیش‌فرض تمام دیکودرها مجاز هستند.
.IP "\fBdump_separator\fR \fIstring\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "dump_separator string (input)"
جداکننده مورد استفاده برای تفکیک فیلدهای چاپ‌شده در خط فرمان درباره پارامترهای استریم.
برای مثال، برای جداسازی فیلدها با خطوط جدید و دندانه‌گذاری:
.Sp
.Vb 2
\&        ffprobe \-dump_separator "
\&                                  "  \-i ~/videos/matrixbench_mpeg2.mpg
.Ve
.IP "\fBmax_pixels\fR \fIinteger\fR \fB(\fR\fIدیکود/انکود،ویدیو\fR\fB)\fR" 4
.IX Item "max_pixels integer (decoding/encoding,video)"
حداکثر تعداد پیکسل‌ها به‌ازای هر تصویر. این مقدار می‌تواند برای جلوگیری از خطای کمبود حافظه به دلیل تصاویر بسیار بزرگ استفاده شود.
.IP "\fBapply_cropping\fR \fIbool\fR \fB(\fR\fIدیکود،ویدیو\fR\fB)\fR" 4
.IX Item "apply_cropping bool (decoding,video)"
فعال‌سازی برش (cropping) در صورتی که پارامترهای برش مضربی از تراز مورد نیاز برای پارامترهای چپ و بالا باشند. اگر تراز برقرار نباشد، برش به صورت جزئی اعمال خواهد شد تا تراز حفظ شود.
مقدار پیش‌فرض 1 (فعال) است.
نکته: تراز مورد نیاز بستگی به این دارد که آیا \f(CW\*(C`AV_CODEC_FLAG_UNALIGNED\*(C'\fR تنظیم شده باشد یا خیر و به پردازنده (CPU) وابسته است. مقدار \f(CW\*(C`AV_CODEC_FLAG_UNALIGNED\*(C'\fR از خط فرمان قابل تغییر نیست. همچنین دیکودرهای سخت‌افزاری برش چپ/بالا را اعمال نخواهند کرد.
.SH "دیکودرها (DECODERS)"
.IX Header "DECODERS"
دیکودرها عناصر پیکربندی‌شده‌ای در FFmpeg هستند که امکان رمزگشایی (دیکود کردن) جریان‌های
چندرسانه‌ای را فراهم می‌سازند.
.PP
هنگام پیکربندی بیلد FFmpeg، تمامی دیکودرهای توکار (native) پشتیبانی‌شده به صورت
پیش‌فرض فعال هستند. دیکودرهایی که به یک کتابخانه خارجی نیاز دارند باید به صورت
دستی از طریق گزینه متناظر \f(CW\*(C`\-\-enable\-lib\*(C'\fR فعال شوند. می‌توانید با استفاده از
گزینه پیکربندی \f(CW\*(C`\-\-list\-decoders\*(C'\fR فهرستی از تمام دیکودرهای موجود را مشاهده کنید.
.PP
می‌توانید تمامی دیکودرها را با گزینه پیکربندی
\&\f(CW\*(C`\-\-disable\-decoders\*(C'\fR غیرفعال کنید و دیکودرهای تکی را به صورت انتخابی با
گزینه‌های \f(CW\*(C`\-\-enable\-decoder=\fR\f(CIDECODER\fR\f(CW\*(C'\fR /
\&\f(CW\*(C`\-\-disable\-decoder=\fR\f(CIDECODER\fR\f(CW\*(C'\fR فعال یا غیرفعال نمایید.
.PP
گزینه \f(CW\*(C`\-decoders\*(C'\fR در ابزارهای *ff فهرست دیکودرهای فعال‌شده را نمایش می‌دهد.
.SH "دیکودرهای ویدیو (VIDEO DECODERS)"
.IX Header "VIDEO DECODERS"
توضیحات مربوط به برخی از دیکودرهای ویدیویی در دسترس در ادامه آمده است.
.SS av1
.IX Subsection "av1"
دیکودر AOMedia Video 1 (AV1).
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBoperating_point\fR 4
.IX Item "operating_point"
انتخاب نقطه عملیاتی یک جریان بیت مقیاس‌پذیر AV1 (از 0 تا 31). مقدار پیش‌فرض 0 است.
.SS hevc
.IX Subsection "hevc"
دیکودر HEVC (شناخته‌شده با عنوان ITU\-T H.265 یا ISO/IEC 23008\-2).
.PP
این دیکودر از جریان‌های چندنمایی MV\-HEVC با حداکثر دو نما پشتیبانی می‌کند. نماهایی که باید
به عنوان خروجی ارائه شوند با ارسال فهرستی از شناسه‌های نما به دیکودر (گزینه
\&\fBview_ids\fR) انتخاب می‌گردند. این گزینه می‌تواند به صورت ایستا پیش از مقداردهی اولیه دیکودر، یا
از فراخوان بازگشتی \f(CWget_format()\fR تنظیم شود \- که برای مواردی که تعداد نماها یا شناسه‌ها در حین
دیکود به صورت پویا تغییر می‌کنند مفید است.
.PP
به طور پیش‌فرض تنها لایه پایه دیکود می‌شود.
.PP
توجه داشته باشید که اگر از ابزار خط فرمان \f(CW\*(C`ffmpeg\*(C'\fR استفاده می‌کنید، باید به جای گزینه‌های
ذکرشده در اینجا، از مشخص‌کننده‌های نما همان‌طور که در راهنمای آن مستند شده است استفاده نمایید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP "\fBview_ids (MV\-HEVC)\fR" 4
.IX Item "view_ids (MV-HEVC)"
فهرستی از شناسه‌های نما که باید در خروجی قرار گیرند را مشخص می‌کند. این گزینه همچنین می‌تواند
روی یک مقدار تکی \*(Aq\-1\*(Aq تنظیم شود که باعث می‌شود تمامی نماهای تعریف‌شده در VPS دیکود شده و
به خروجی فرستاده شوند.
.IP "\fBview_ids_available (MV\-HEVC)\fR" 4
.IX Item "view_ids_available (MV-HEVC)"
این گزینه ممکن است توسط فراخوان‌کننده خوانده شود تا آرایه‌ای از شناسه‌های نمای موجود در
VPS فعال را بازیابی کند. این آرایه برای ویدیوی تک‌لایه‌ای خالی است.
.Sp
دقت مقدار این گزینه هنگامی که از فراخوان بازگشتی \&\f(CWget_format()\fR خوانده شود
تضمین شده است. همچنین ممکن است در زمان‌های دیگر (مانند پس از باز کردن دیکودر) تنظیم شود،
اما مقدار آن صرفاً جنبه اطلاع‌رسانی دارد و ممکن است نادرست باشد (مثلاً زمانی که جریان حاوی چندین
VPS NALU متمایز باشد).
.IP "\fBview_pos_available (MV\-HEVC)\fR" 4
.IX Item "view_pos_available (MV-HEVC)"
این گزینه ممکن است توسط فراخوان‌کننده خوانده شود تا آرایه‌ای از موقعیت‌های نما (چپ، راست، یا
نامشخص) موجود در VPS فعال را به عنوان مقادیر \&\f(CW\*(C`AVStereo3DView\*(C'\fR بازیابی کند.
هنگامی که این آرایه در دسترس باشد، عناصر آن بر عناصر متناظر در \fBview_ids_available\fR
اعمال می‌شوند؛ به این معنی که \&\f(CW\*(C`view_pos_available[i]\*(C'\fR موقعیت نمای با شناسه
\&\f(CW\*(C`view_ids_available[i]\*(C'\fR را در بر دارد.
.Sp
همان محدودیت‌های اعتبارسنجی مربوط به \fBview_ids_available\fR بر این گزینه نیز
اعمال می‌شود.
.SS rawvideo
.IX Subsection "rawvideo"
دیکودر ویدیوی خام (Raw video).
.PP
این دیکودر جریان‌های rawvideo را دیکود می‌کند.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP "\fBtop\fR \fItop_field_first\fR" 4
.IX Item "top top_field_first"
تعیین نوع فیلد فرض‌شده برای ویدیوی ورودی.
.RS 4
.IP \fB\-1\fR 4
.IX Item "-1"
ویدیو به عنوان پروگرسیو در نظر گرفته می‌شود (پیش‌فرض)
.IP \fB0\fR 4
.IX Item "0"
حالت ابتدا فیلد پایینی (Bottom-field-first) فرض می‌شود
.IP \fB1\fR 4
.IX Item "1"
حالت ابتدا فیلد بالایی (Top-field-first) فرض می‌شود
.RE
.RS 4
.RE
.SS libdav1d
.IX Subsection "libdav1d"
دیکودر dav1d AV1.
.PP
کتابخانه libdav1d به libavcodec اجازه می‌دهد کدک AOMedia Video 1 (AV1) را دیکود کند.
نیازمند وجود هدرها و کتابخانه libdav1d در زمان پیکربندی است.
باید بیلد را صراحتاً با \f(CW\*(C`\-\-enable\-libdav1d\*(C'\fR پیکربندی کنید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
گزینه‌های زیر توسط پوشش libdav1d پشتیبانی می‌شوند.
.IP \fBmax_frame_delay\fR 4
.IX Item "max_frame_delay"
تنظیم حداکثر تعداد فریم‌هایی که دیکودر می‌تواند در حافظه موقت داخلی بافر کند. مقدار پیش‌فرض 0
است (تشخیص خودکار).
.IP \fBfilmgrain\fR 4
.IX Item "filmgrain"
اعمال گرین فیلم (Film Grain) بر ویدیوی دیکودشده در صورت وجود در استریم بیت. به مقدار پیش‌فرض
داخلی کتابخانه برمی‌گردد.
این گزینه منسوخ شده است و در آینده حذف خواهد شد. برای استخراج پارامترهای گرین فیلم به جای
اعمال مستقیم آن، به گزینه عمومی \&\f(CW\*(C`export_side_data\*(C'\fR مراجعه کنید.
.IP \fBoppoint\fR 4
.IX Item "oppoint"
انتخاب نقطه عملیاتی از جریان بیت مقیاس‌پذیر AV1 (از 0 تا 31). به مقدار پیش‌فرض داخلی
کتابخانه بازمی‌گردد.
.IP \fBalllayers\fR 4
.IX Item "alllayers"
خروجی دادن تمامی لایه‌های فضایی جریان بیت مقیاس‌پذیر AV1. مقدار پیش‌فرض false است.
.SS libdavs2
.IX Subsection "libdavs2"
پوشش دیکودر ویدیوی AVS2\-P2/IEEE1857.4.
.PP
این دیکودر به libavcodec امکان می‌دهد جریان‌های AVS2 را با کتابخانه davs2 دیکود کند.
.SS libuavs3d
.IX Subsection "libuavs3d"
دیکودر ویدیوی AVS3\-P2/IEEE1857.10.
.PP
کتابخانه libuavs3d به libavcodec امکان رمزگشایی جریان‌های AVS3 را می‌دهد.
نیازمند وجود هدرها و کتابخانه libuavs3d در زمان پیکربندی است.
باید بیلد را صراحتاً با \f(CW\*(C`\-\-enable\-libuavs3d\*(C'\fR پیکربندی کنید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
گزینه زیر توسط پوشش libuavs3d پشتیبانی می‌شود.
.IP \fBframe_threads\fR 4
.IX Item "frame_threads"
تنظیم تعداد نخ‌های پردازشی فریم برای استفاده در هنگام دیکود. مقدار پیش‌فرض 0 است (تشخیص خودکار).
.SS libxevd
.IX Subsection "libxevd"
پوشش دیکودر eXtra\-fast Essential Video Decoder (XEVD) برای MPEG\-5 EVC.
.PP
این دیکودر نیازمند وجود هدرها و کتابخانه libxevd در هنگام پیکربندی است. باید بیلد را
صراحتاً با \&\fB\-\-enable\-libxevd\fR پیکربندی کنید.
.PP
وب‌سایت پروژه xevd در <\fBhttps://github.com/mpeg5/xevd\fR> قرار دارد.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
گزینه‌های زیر توسط پوشش libxevd پشتیبانی می‌شوند.
گزینه‌ها یا مقادیر معادل در xevd برای تسهیل مهاجرت درون پرانتز درج شده‌اند.
.PP
برای دستیابی به مستندات دقیق‌تر و جامع‌تر درباره گزینه‌های libxevd،
دستور \f(CW\*(C`xevd_app \-\-help\*(C'\fR را اجرا کنید یا به مستندات libxevd مراجعه نمایید.
.IP "\fBthreads (\fR\fIthreads\fR\fB)\fR" 4
.IX Item "threads (threads)"
اجبار به استفاده از تعداد مشخصی نخ پردازشی (Thread).
.SS "QSV Decoders"
.IX Subsection "QSV Decoders"
خانواده دیکودرهای شتاب‌یافته Intel QuickSync Video (شامل VC1، MPEG\-2، H.264، HEVC،
JPEG/MJPEG، VP8، VP9، AV1، VVC).
.PP
\fIگزینه‌های مشترک (Common Options)\fR
.IX Subsection "Common Options"
.PP
گزینه‌های زیر توسط تمامی دیکودرهای qsv پشتیبانی می‌شوند.
.IP \fIasync_depth\fR 4
.IX Item "async_depth"
عمق موازی‌سازی داخلی؛ هرچه مقدار بالاتر باشد، تاخیر بیشتر خواهد بود.
.IP \fIgpu_copy\fR 4
.IX Item "gpu_copy"
کپی با شتاب GPU میان حافظه ویدیو و حافظه سیستم.
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
.PD 0
.IP \fBon\fR 4
.IX Item "on"
.IP \fBoff\fR 4
.IX Item "off"
.PD
.RE
.RS 4
.RE
.PP
\fIگزینه‌های HEVC (HEVC Options)\fR
.IX Subsection "HEVC Options"
.PP
گزینه‌های اضافی برای hevc_qsv.
.IP \fIload_plugin\fR 4
.IX Item "load_plugin"
یک پلاگین کاربری برای بارگذاری در نشست داخلی.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
.PD 0
.IP \fBhevc_sw\fR 4
.IX Item "hevc_sw"
.IP \fBhevc_hw\fR 4
.IX Item "hevc_hw"
.PD
.RE
.RS 4
.RE
.IP \fIload_plugins\fR 4
.IX Item "load_plugins"
فهرستی جداشده با نویسه دو‌نقطه (:) از شناسه یکتای هگزادسیمال (UID) پلاگین‌ها جهت بارگذاری در یک نشست داخلی.
.SS v210
.IX Subsection "v210"
دیکودر غیرفشرده 4:2:2 ده بیتی (10\-bit).
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBcustom_stride\fR 4
.IX Item "custom_stride"
تنظیم اندازه خط داده‌های v210 بر حسب بایت. مقدار پیش‌فرض 0 است
(تشخیص خودکار). می‌توانید از مقدار ویژه \-1 برای v210 فاقد Stride مانند آنچه در
فایل‌های BOXX دیده می‌شود استفاده کنید.
.SH "دیکودرهای صدا (AUDIO DECODERS)"
.IX Header "AUDIO DECODERS"
توضیحات مربوط به برخی از دیکودرهای صوتی در دسترس در ادامه آمده است.
.SS ac3
.IX Subsection "ac3"
دیکودر صوتی AC\-3.
.PP
این دیکودر بخشی از استانداردهای ATSC A/52:2010 و ETSI TS 102 366 و همچنین
RealAudio 3 غیرمستند (شناخته‌شده با نام dnet) را پیاده‌سازی می‌کند.
.PP
\fIگزینه‌های دیکودر AC\-3 (AC\-3 Decoder Options)\fR
.IX Subsection "AC-3 Decoder Options"
.IP "\fB\-drc_scale\fR \fIvalue\fR" 4
.IX Item "-drc_scale value"
ضریب مقیاس دامنه دینامیکی. ضریبی که بر مقادیر دامنه دینامیکی حاصل از
جریان AC\-3 اعمال می‌شود. این ضریب به صورت نمایی اعمال می‌گردد. مقدار پیش‌فرض 1 است.
سه محدوده ضریب مقیاس قابل توجه وجود دارد:
.RS 4
.IP "\fBdrc_scale == 0\fR" 4
.IX Item "drc_scale == 0"
قابلیت DRC غیرفعال است. صدای با دامنه کامل تولید می‌کند.
.IP "\fB0 < drc_scale <= 1\fR" 4
.IX Item "0 < drc_scale <= 1"
قابلیت DRC فعال است. کسری از مقدار DRC جریان را اعمال می‌کند.
بازتولید صدا در حدی میان دامنه کامل و فشرده‌سازی کامل قرار می‌گیرد.
.IP "\fBdrc_scale > 1\fR" 4
.IX Item "drc_scale > 1"
قابلیت DRC فعال است. مقدار drc_scale را به صورت نامتقارن اعمال می‌کند.
صداهای بلند کاملاً فشرده می‌شوند. صداهای آهسته تقویت می‌گردند.
.RE
.RS 4
.RE
.SS flac
.IX Subsection "flac"
دیکودر صوتی FLAC.
.PP
هدف این دیکودر پیاده‌سازی مشخصات کامل استاندارد FLAC از بنیاد Xiph است.
.PP
\fIگزینه‌های دیکودر FLAC (FLAC Decoder options)\fR
.IX Subsection "FLAC Decoder options"
.IP \fB\-use_buggy_lpc\fR 4
.IX Item "-use_buggy_lpc"
انکودر FLAC در lavc سابقاً جریان‌هایی با مقادیر LPC بالا (مانند مقدار پیش‌فرض) تولید
می‌کرد که دارای باگ بودند. این گزینه امکان دیکود صحیح چنین استریم‌هایی را با استفاده از
منطق قدیمی و معیوب LPC در lavc فراهم می‌سازد.
.SS ffwavesynth
.IX Subsection "ffwavesynth"
سینت سایزر موجی داخلی.
.PP
این دیکودر الگوهای موجی را بر اساس توالی‌های از پیش تعریف‌شده تولید می‌کند. کاربرد آن
صرفاً داخلی است و قالب داده‌هایی که می‌پذیرد به صورت عمومی مستند نشده است.
.SS libgsm
.IX Subsection "libgsm"
پوشش دیکودر libgsm.
.PP
کتابخانه libgsm به libavcodec امکان می‌دهد کدک صوتی نرخ کامل GSM را دیکود کند. نیازمند
وجود هدرها و کتابخانه libgsm در هنگام پیکربندی است. باید بیلد را صراحتاً با
\f(CW\*(C`\-\-enable\-libgsm\*(C'\fR پیکربندی کنید.
.PP
این دیکودر از هر دو گونه استاندارد GSM و گونه متعلق به مایکروسافت پشتیبانی می‌کند.
.SS libilbc
.IX Subsection "libilbc"
پوشش دیکودر libilbc.
.PP
کتابخانه libilbc به libavcodec امکان می‌دهد کدک صوتی نرخ بیت پایین اینترنت (iLBC) را
دیکود کند. نیازمند وجود هدرها و کتابخانه libilbc در حین پیکربندی است. باید بیلد را
صراحتاً با \&\f(CW\*(C`\-\-enable\-libilbc\*(C'\fR پیکربندی نمایید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
گزینه زیر توسط پوشش libilbc پشتیبانی می‌شود.
.IP \fBenhance\fR 4
.IX Item "enhance"
در صورت تنظیم بر روی 1، بهبود کیفیت صدای دیکودشده را فعال می‌کند. مقدار پیش‌فرض
0 است (غیرفعال).
.SS libmpeghdec
.IX Subsection "libmpeghdec"
پوشش دیکودر libmpeghdec.
.PP
کتابخانه libmpeghdec به FFmpeg اجازه می‌دهد تا کدک صوتی سه‌بعدی MPEG\-H 3D را دیکود کند.
نیازمند هدرها و کتابخانه libmpeghdec در هنگام پیکربندی است. باید بیلد را صراحتاً با
\&\f(CW\*(C`\-\-enable\-libmpeghdec \-\-enable\-nonfree\*(C'\fR پیکربندی نمایید.
.SS libopencore\-amrnb
.IX Subsection "libopencore-amrnb"
پوشش دیکودر libopencore\-amrnb.
.PP
کتابخانه libopencore\-amrnb به libavcodec امکان رمزگشایی کدک صوتی چندنرخی تطبیقی باند
باریک (AMR\-NB) را می‌دهد. استفاده از آن مستلزم وجود هدرها و کتابخانه libopencore\-amrnb در
زمان پیکربندی است. باید بیلد را صراحتاً با \f(CW\*(C`\-\-enable\-libopencore\-amrnb\*(C'\fR پیکربندی کنید.
.PP
یک دیکودر بومی در FFmpeg برای AMR\-NB وجود دارد، بنابراین کاربران می‌توانند بدون نیاز
به این کتابخانه فایل‌های AMR\-NB را دیکود کنند.
.SS libopencore\-amrwb
.IX Subsection "libopencore-amrwb"
پوشش دیکودر libopencore\-amrwb.
.PP
کتابخانه libopencore\-amrwb به libavcodec اجازه می‌دهد کدک صوتی چندنرخی تطبیقی باند
پهن (AMR\-WB) را دیکود کند. استفاده از آن مستلزم حضور هدرها و کتابخانه libopencore\-amrwb در
زمان پیکربندی است. باید بیلد را صراحتاً با \f(CW\*(C`\-\-enable\-libopencore\-amrwb\*(C'\fR پیکربندی نمایید.
.PP
یک دیکودر بومی FFmpeg برای AMR\-WB وجود دارد، بنابراین کاربران می‌توانند بدون این کتابخانه نیز
AMR\-WB را رمزگشایی کنند.
.SS libopus
.IX Subsection "libopus"
پوشش دیکودر libopus.
.PP
کتابخانه libopus به libavcodec امکان می‌دهد تا کدک صوتی تعاملی Opus را دیکود نماید.
نیازمند هدرها و کتابخانه libopus در هنگام پیکربندی است. باید بیلد را صراحتاً با
\&\f(CW\*(C`\-\-enable\-libopus\*(C'\fR پیکربندی کنید.
.PP
یک دیکودر بومی در FFmpeg برای Opus وجود دارد، بنابراین کاربران بدون این کتابخانه نیز
قادر به دیکود کردن Opus هستند.
.SH "دیکودرهای زیرنویس (SUBTITLES DECODERS)"
.IX Header "SUBTITLES DECODERS"
.SS libaribb24
.IX Subsection "libaribb24"
دیکودر زیرنویس ARIB STD\-B24.
.PP
پروفایل‌های A و C از استاندارد ARIB STD\-B24 را پیاده‌سازی می‌کند.
.PP
\fIگزینه‌های دیکودر libaribb24 (libaribb24 Decoder Options)\fR
.IX Subsection "libaribb24 Decoder Options"
.IP "\fB\-aribb24\-base\-path\fR \fIpath\fR" 4
.IX Item "-aribb24-base-path path"
مسیر پایه را برای کتابخانه libaribb24 تعیین می‌کند. این مسیر برای خواندن
پرونده‌های پیکربندی (جهت تبدیل‌های سفارشی یونیکد) و ذخیره نمادهای غیرمتنی
به صورت تصویر در آن مکان به کار می‌رود.
.Sp
به طور پیش‌فرض تعیین‌نشده است.
.IP "\fB\-aribb24\-skip\-ruby\-text\fR \fIboolean\fR" 4
.IX Item "-aribb24-skip-ruby-text boolean"
به پوشش دیکودر دستور می‌دهد از بلوک‌های متنی حاوی نویسه‌های نیمه‌ارتفاع
روبی (Ruby text) صرف‌نظر کند.
.Sp
به طور پیش‌فرض فعال است.
.SS libaribcaption
.IX Subsection "libaribcaption"
یک دیکودر دیگر برای زیرنویس ARIB STD\-B24 با استفاده از کتابخانه خارجی \fIlibaribcaption\fR.
.PP
پروفایل‌های A و C از استاندارد ژاپنی ARIB STD\-B24، استاندارد برزیلی ABNT NBR 15606\-1
و نسخه فیلیپینی ISDB\-T را پیاده‌سازی می‌کند.
.PP
نیازمند وجود هدرها و کتابخانه libaribcaption
(<\fBhttps://github.com/xqq/libaribcaption\fR>) در هنگام پیکربندی است.
باید بیلد را صراحتاً با \f(CW\*(C`\-\-enable\-libaribcaption\*(C'\fR پیکربندی کنید.
اگر هر دو دیکودر \fIlibaribb24\fR و \fIlibaribcaption\fR فعال باشند، دیکودر \fIlibaribcaption\fR
اولویت خواهد داشت.
.PP
\fIگزینه‌های دیکودر libaribcaption (libaribcaption Decoder Options)\fR
.IX Subsection "libaribcaption Decoder Options"
.IP "\fB\-sub_type\fR \fIsubtitle_type\fR" 4
.IX Item "-sub_type subtitle_type"
قالب زیرنویس‌های دیکودشده را مشخص می‌کند.
.RS 4
.IP \fBbitmap\fR 4
.IX Item "bitmap"
تصویر گرافیکی (بیت‌مپ).
.IP \fBass\fR 4
.IX Item "ass"
متن فرمت‌بندی‌شده ASS.
.IP \fBtext\fR 4
.IX Item "text"
خروجی ساده مبتنی بر متن بدون قالب‌بندی.
.RE
.RS 4
.Sp
پیش‌فرض همانند دیکودر \fIlibaribb24\fR مقدار \fIass\fR است.
برخی از پخش‌کننده‌های امروزی (مانند \fImpv\fR) برای زیرنویس ARIB انتظار قالب ASS را دارند.
.RE
.IP "\fB\-caption_encoding\fR \fIencoding_scheme\fR" 4
.IX Item "-caption_encoding encoding_scheme"
طرح کدگذاری متن زیرنویس ورودی را مشخص می‌کند.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
تشخیص خودکار انکودینگ متن (پیش‌فرض).
.IP \fBjis\fR 4
.IX Item "jis"
انکودینگ نویسه ۸ بیتی JIS تعریف‌شده در ARIB STD B24.
این انکودینگ در ژاپن برای زیرنویس‌های ISDB استفاده می‌شود.
.IP \fButf8\fR 4
.IX Item "utf8"
انکودینگ UTF\-8 تعریف‌شده در ARIB STD B24.
این انکودینگ در فیلیپین برای زیرنویس‌های ISDB\-T استفاده می‌شود.
.IP \fBlatin\fR 4
.IX Item "latin"
انکودینگ نویسه‌های لاتین تعریف‌شده در ABNT NBR 15606\-1.
این انکودینگ در آمریکای جنوبی برای زیرنویس‌های SBTVD / ISDB\-Tb استفاده می‌گردد.
.RE
.RS 4
.RE
.IP "\fB\-font\fR \fIfont_name[,font_name2,...]\fR" 4
.IX Item "-font font_name[,font_name2,...]"
فهرستی جداشده با کاما از نام‌های خانواده قلم را برای استفاده در رندر زیرنویس
نوع \fIbitmap\fR یا \fIass\fR مشخص می‌کند.
برای زیرنویس نوع \fIass\fR تنها نام اولین فونت استفاده می‌شود.
.Sp
در صورت عدم تعیین، از خانواده قلم پیش‌فرض تعریف‌شده در داخل استفاده می‌گردد.
.IP "\fB\-ass_single_rect\fR \fIboolean\fR" 4
.IX Item "-ass_single_rect boolean"
استاندارد ARIB STD\-B24 مشخص می‌کند که برخی زیرنویس‌ها ممکن است هم‌زمان در موقعیت‌های
متفاوتی نمایش داده شوند (زیرنویس چندمستطیلی).
از آنجا که برخی از پخش‌کننده‌ها (مانند نسخه‌های قدیمی \fImpv\fR) نمی‌توانند چندین مستطیل ASS
را در یک AVSubtitle واحد پردازش کنند، یا چند مستطیل ASS با مدت نامشخص و برچسب زمانی
شروع یکسان را به درستی نمایش دهند، این گزینه می‌تواند رفتار را به گونه‌ای تغییر دهد که تمام
متن‌ها در یک مستطیل واحد ASS نمایش داده شوند.
.Sp
مقدار پیش‌فرض \fIfalse\fR است.
.Sp
اگر پخش‌کننده شما نمی‌تواند AVSubtitleهای دارای چندین مستطیل ASS را به درستی پردازش کند،
این گزینه را روی \fItrue\fR تنظیم کنید یا مقدار \fBASS_SINGLE_RECT=1\fR را تعریف نمایید تا
رفتار پیش‌فرض در زمان کامپایل تغییر کند.
.IP "\fB\-force_outline_text\fR \fIboolean\fR" 4
.IX Item "-force_outline_text boolean"
مشخص می‌کند که آیا همیشه برای تمامی نویسه‌ها خط بیرونی (Outline) رندر شود،
بدون توجه به آنچه سبک نویسه نشان می‌دهد.
.Sp
مقدار پیش‌فرض \fIfalse\fR است.
.IP "\fB\-outline_width\fR \fInumber\fR \fB(0.0 \- 3.0)\fR" 4
.IX Item "-outline_width number (0.0 - 3.0)"
عرض خط دور متن را بر حسب نقطه (نسبی) تعیین می‌کند.
.Sp
مقدار پیش‌فرض \fI1.5\fR است.
.IP "\fB\-ignore_background\fR \fIboolean\fR" 4
.IX Item "-ignore_background boolean"
مشخص می‌کند که آیا از رندر رنگ پس‌زمینه صرف‌نظر شود یا خیر.
.Sp
مقدار پیش‌فرض \fIfalse\fR است.
.IP "\fB\-ignore_ruby\fR \fIboolean\fR" 4
.IX Item "-ignore_ruby boolean"
مشخص می‌کند که آیا از رندر نویسه‌های شبیه به روبی (فوریگانا) صرف‌نظر شود یا خیر.
.Sp
مقدار پیش‌فرض \fIfalse\fR است.
.IP "\fB\-replace_drcs\fR \fIboolean\fR" 4
.IX Item "-replace_drcs boolean"
مشخص می‌کند که آیا نویسه‌های جایگزین DRCS به صورت نویسه‌های یونیکد رندر شوند یا خیر.
.Sp
مقدار پیش‌فرض \fItrue\fR است.
.IP "\fB\-replace_msz_ascii\fR \fIboolean\fR" 4
.IX Item "-replace_msz_ascii boolean"
مشخص می‌کند که آیا نویسه‌های عددی-حرفی تمام‌عرض MSZ (اندازه متوسط؛ نیم‌عرض) با
نویسه‌های نیم‌عرض جایگزین شوند یا خیر.
.Sp
مقدار پیش‌فرض \fItrue\fR است.
.IP "\fB\-replace_msz_japanese\fR \fIboolean\fR" 4
.IX Item "-replace_msz_japanese boolean"
مشخص می‌کند که آیا برخی نویسه‌های ویژه ژاپنی تمام‌عرض MSZ (اندازه متوسط؛ نیم‌عرض) با
نمونه‌های نیم‌عرض جایگزین شوند یا خیر.
.Sp
مقدار پیش‌فرض \fItrue\fR است.
.IP "\fB\-replace_msz_glyph\fR \fIboolean\fR" 4
.IX Item "-replace_msz_glyph boolean"
مشخص می‌کند که در صورت پشتیبانی فونت، آیا نویسه‌های MSZ (اندازه متوسط؛ نیم‌عرض) با
گلیف‌های نیم‌عرض جایگزین شوند یا خیر.
این گزینه تحت موتورهای رندر FreeType یا DirectWrite با قلم‌های سازگار با
Adobe\-Japan1 کار می‌کند؛
مانند IBM Plex Sans JP، Morisawa BIZ UDGothic، Morisawa BIZ UDMincho،
Yu Gothic، Yu Mincho و Meiryo.
.Sp
مقدار پیش‌فرض \fItrue\fR است.
.IP "\fB\-canvas_size\fR \fIimage_size\fR" 4
.IX Item "-canvas_size image_size"
وضوح بوم (Canvas) را جهت رندر زیرنویس‌ها مشخص می‌کند؛ معمولاً این مقدار باید
با اندازه فریم ویدیوی ورودی برابر باشد.
این گزینه تنها زمانی اعمال می‌شود که \f(CW\*(C`\-subtitle_type\*(C'\fR بر روی \fIbitmap\fR تنظیم شده باشد.
.Sp
دیکودر libaribcaption اندازه فریم ورودی را برای رندر بیت‌مپ به صورت زیر فرض می‌کند:
.RS 4
.IP 1. 4
پروفایل PROFILE_A : ابعاد 1440 x 1080 با SAR (PAR) 4:3
.IP 2. 4
پروفایل PROFILE_C : ابعاد 320 x 180 با SAR (PAR) 1:1
.RE
.RS 4
.Sp
اگر ابعاد واقعی فریم ویدیوی ورودی با این فرض‌ها مطابقت نداشته باشد، ممکن است زیرنویس‌های
رندرشده دچار اعوجاج شوند.
برای جلوگیری از اعوجاج، گزینه \f(CW\*(C`\-canvas_size\*(C'\fR را برای مشخص کردن اندازه واقعی ویدیوی
ورودی اضافه کنید.
.Sp
توجه داشته باشید که گزینه \f(CW\*(C`\-canvas_size\*(C'\fR برای ویدیوهایی با ابعاد متفاوت اما با نسبت تصویر
یکسان لازم نیست.
در چنین مواردی اگر \f(CW\*(C`\-canvas_size\*(C'\fR مشخص نشده باشد، زیرنویس متناسب با اندازه واقعی ویدیو
کشیده یا کوچک می‌شود.
در صورتی که \f(CW\*(C`\-canvas_size\*(C'\fR با اندازه متفاوتی مشخص شود، زیرنویس به اندازه تعیین‌شده با
SAR محاسبه‌شده کشیده یا جمع خواهد شد.
.RE
.PP
\fIمثال‌های استفاده از دیکودر libaribcaption (libaribcaption decoder usage examples)\fR
.IX Subsection "libaribcaption decoder usage examples"
.PP
نمایش فایل MPEG\-TS با زیرنویس ARIB توسط ابزار \f(CW\*(C`ffplay\*(C'\fR:
.PP
.Vb 1
\&        ffplay \-sub_type bitmap MPEG.TS
.Ve
.PP
نمایش فایل MPEG\-TS با ابعاد فریم ورودی 1920x1080 توسط ابزار \f(CW\*(C`ffplay\*(C'\fR:
.PP
.Vb 1
\&        ffplay \-sub_type bitmap \-canvas_size 1920x1080 MPEG.TS
.Ve
.PP
گنجاندن زیرنویس ARIB در ویدیوی ترنسکدشده:
.PP
.Vb 1
\&        ffmpeg \-sub_type bitmap \-i src.m2t \-filter_complex "[0:v][0:s]overlay" \-vcodec h264 dest.mp4
.Ve
.SS dvbsub
.IX Subsection "dvbsub"
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBcompute_clut\fR 4
.IX Item "compute_clut"
.RS 4
.PD 0
.IP \fB\-2\fR 4
.IX Item "-2"
.PD
اگر جدول CLUT مطابقی در استریم نباشد، clut را یک‌بار محاسبه کن.
.IP \fB\-1\fR 4
.IX Item "-1"
اگر جدول CLUT مطابقی در استریم نباشد، clut را محاسبه کن.
.IP \fB0\fR 4
.IX Item "0"
هرگز CLUT را محاسبه نکن.
.IP \fB1\fR 4
.IX Item "1"
همیشه CLUT را محاسبه کن و مقدار ارائه‌شده در استریم را نادیده بگیر و جایگزین کن.
.RE
.RS 4
.RE
.IP \fBdvb_substream\fR 4
.IX Item "dvb_substream"
زیرجریان dvb را انتخاب می‌کند، یا در صورت مقدار \-1 (پیش‌فرض) تمام زیرجریان‌ها انتخاب می‌شوند.
.SS dvdsub
.IX Subsection "dvdsub"
این کدک زیرنویس‌های بیت‌مپ استفاده‌شده در DVDها را دیکود می‌کند؛ همین زیرنویس‌ها را می‌توان
در جفت‌فایل‌های VobSub و برخی فایل‌های Matroska نیز یافت.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBpalette\fR 4
.IX Item "palette"
پالت رنگ سراسری استفاده‌شده توسط بیت‌مپ‌ها را مشخص می‌کند. هنگام ذخیره در VobSub،
پالت معمولاً در فایل اندیس مشخص می‌شود؛ در Matroska، پالت در داده‌های اضافه کدک با همان
فرمت VobSub ذخیره می‌گردد. در DVDها پالت در فایل IFO ذخیره می‌شود و بنابراین هنگام خواندن
مستقیم از فایل‌های VOB استخراج‌شده در دسترس نیست.
.Sp
فرمت این گزینه رشته‌ای شامل ۱۶ عدد هگزادسیمال ۲۴ بیتی (بدون پیشوند 0x) است که با
کاما جدا شده‌اند؛ به عنوان مثال: \f(CW\*(C`0d00ee, ee450d, 101010, eaeaea, 0ce60b,
ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1, 7b2a0e, 0d950c, 0f007b, cf0dec,
cfa80c, 7c127b\*(C'\fR.
.IP \fBifo_palette\fR 4
.IX Item "ifo_palette"
مشخص کردن فایل IFO که پالت سراسری از آن استخراج می‌شود (آزمایشی).
.IP \fBforced_subs_only\fR 4
.IX Item "forced_subs_only"
تنها دیکود کردن زیرنویس‌هایی که به عنوان اجباری (Forced) علامت‌گذاری شده‌اند. برخی عنوان‌ها شامل
هر دو زیرنویس اجباری و غیراجباری در یک ترک واحد هستند. تنظیم این فلگ روی \f(CW1\fR تنها
زیرنویس‌های اجباری را حفظ می‌کند. مقدار پیش‌فرض \f(CW0\fR است.
.SS libzvbi\-teletext
.IX Subsection "libzvbi-teletext"
کتابخانه Libzvbi به libavcodec امکان می‌دهد صفحات تله‌تکست DVB و زیرنویس‌های
تله‌تکست DVB را رمزگشایی کند. نیازمند هدرها و کتابخانه libzvbi در هنگام پیکربندی است.
باید بیلد را صراحتاً با \&\f(CW\*(C`\-\-enable\-libzvbi\*(C'\fR پیکربندی کنید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBtxt_page\fR 4
.IX Item "txt_page"
فهرست شماره صفحات تله‌تکست جهت دیکود. صفحاتی که با این فهرست مطابقت نداشته باشند
نادیده گرفته می‌شوند. می‌توانید از رشته ویژه \f(CW\*(C`*\*(C'\fR برای تطبیق با همه صفحات، یا
\f(CW\*(C`subtitle\*(C'\fR برای تمام صفحات زیرنویس استفاده کنید. مقدار پیش‌فرض * است.
.IP \fBtxt_default_region\fR 4
.IX Item "txt_default_region"
تنظیم مجموعه نویسه پیش‌فرض برای دیکود؛ مقداری بین 0 تا 87 (جدول 32، بخش 15 استاندارد
ETS 300 706 را ببینید). مقدار پیش‌فرض \-1 است که پیش‌فرض libzvbi را بازنویسی نمی‌کند.
این گزینه برای برخی مخابره‌های قدیمی سطح 1.0 که نمی‌توانند مجموعه نویسه مناسب را اعلام کنند
لازم است.
.IP \fBtxt_chop_top\fR 4
.IX Item "txt_chop_top"
حذف خط بالایی تله‌تکست. مقدار پیش‌فرض 1 است.
.IP \fBtxt_format\fR 4
.IX Item "txt_format"
مشخص کردن قالب زیرنویس‌های دیکودشده.
.RS 4
.IP \fBbitmap\fR 4
.IX Item "bitmap"
قالب پیش‌فرض؛ باید از این قالب برای صفحات تله‌تکست استفاده کنید، زیرا برخی گرافیک‌ها و
رنگ‌ها در متن ساده یا حتی ASS قابل بیان نیستند.
.IP \fBtext\fR 4
.IX Item "text"
خروجی ساده مبتنی بر متن بدون قالب‌بندی.
.IP \fBass\fR 4
.IX Item "ass"
خروجی فرمت‌بندی‌شده ASS؛ صفحات زیرنویس و صفحات تله‌تکست در استایل‌های متفاوتی
بازگردانده می‌شوند. صفحات زیرنویس به متن تقلیل می‌یابند، اما تلاش می‌شود چیدمان متن و
فرمت‌بندی حفظ گردد.
.RE
.RS 4
.RE
.IP \fBtxt_left\fR 4
.IX Item "txt_left"
آفست افقی (X) بیت‌مپ‌های تولیدشده؛ مقدار پیش‌فرض 0 است.
.IP \fBtxt_top\fR 4
.IX Item "txt_top"
آفست عمودی (Y) بیت‌مپ‌های تولیدشده؛ مقدار پیش‌فرض 0 است.
.IP \fBtxt_chop_spaces\fR 4
.IX Item "txt_chop_spaces"
حذف فاصله‌های ابتدا و انتها و پاک کردن خطوط خالی از متن تولیدشده. این گزینه برای زیرنویس‌های
تله‌تکست که به دلیل نویسه‌های دوبرابر پهن تله‌تکست ممکن است در آغاز یا پایان خطوط دارای فاصله
خالی یا بین خطوط دارای خط خالی باشند مفید است. مقدار پیش‌فرض 1 است.
.IP \fBtxt_duration\fR 4
.IX Item "txt_duration"
تنظیم مدت‌زمان نمایش صفحات یا زیرنویس‌های دیکودشده تله‌تکست بر حسب میلی‌ثانیه. مقدار پیش‌فرض
\-1 است که به معنای بی‌نهایت یا تا زمان رسیدن رویداد زیرنویس بعدی است.
.IP \fBtxt_transparent\fR 4
.IX Item "txt_transparent"
اجبار به پس‌زمینه شفاف در بیت‌مپ‌های تله‌تکست تولیدشده. مقدار پیش‌فرض 0 است که به معنای
پس‌زمینه کدر است.
.IP \fBtxt_opacity\fR 4
.IX Item "txt_opacity"
تنظیم کدر بودن (0\-255) پس‌زمینه تله‌تکست. اگر \&\fBtxt_transparent\fR تنظیم نشده باشد، تنها نویسه‌های
میان کادر شروع و کادر پایان (معمولاً زیرنویس‌ها) را تحت تاثیر قرار می‌دهد. مقدار پیش‌فرض 0 است اگر
\&\fBtxt_transparent\fR تنظیم شده باشد، در غیر این صورت 255 است.
.SH "فیلترهای جریان بیت (BITSTREAM FILTERS)"
.IX Header "BITSTREAM FILTERS"
هنگامی که بیلد FFmpeg خود را پیکربندی می‌کنید، تمامی فیلترهای جریان بیت پشتیبانی‌شده به طور پیش‌فرض فعال هستند. می‌توانید با استفاده از گزینه پیکربندی \f(CW\*(C`\-\-list\-bsfs\*(C'\fR فهرستی از تمام موارد موجود را مشاهده کنید.
.PP
می‌توانید تمامی فیلترهای جریان بیت را با استفاده از گزینه پیکربندی \&\f(CW\*(C`\-\-disable\-bsfs\*(C'\fR غیرفعال کنید، و هر فیلتر جریان بیت را با استفاده از گزینه \f(CW\*(C`\-\-enable\-bsf=BSF\*(C'\fR به صورت گزینشی فعال نمایید، یا یک فیلتر جریان بیت مشخص را با استفاده از گزینه \f(CW\*(C`\-\-disable\-bsf=BSF\*(C'\fR غیرفعال کنید.
.PP
گزینه \f(CW\*(C`\-bsfs\*(C'\fR در ابزارهای ff* فهرستی از تمامی فیلترهای جریان بیت پشتیبانی‌شده گنجانده‌شده در بیلد شما را نمایش می‌دهد.
.PP
ابزارهای ff* گزینه \-bsf را دارند که به ازای هر استریم اعمال می‌شود و فهرستی از فیلترها را که با کاما جدا شده‌اند دریافت می‌کند؛ پارامترهای هر فیلتر پس از علامت \*(Aq=\*(Aq به دنبال نام فیلتر می‌آیند.
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v filter1[=opt1=str1:opt2=str2][,filter2] OUTPUT
.Ve
.PP
در ادامه توضیحات فیلترهای جریان بیت فعلی در دسترس به همراه پارامترهای آن‌ها (در صورت وجود) آورده شده است.
.SS aac_adtstoasc
.IX Subsection "aac_adtstoasc"
تبدیل جریان بیت MPEG\-2/4 AAC ADTS به پیکربندی صوتی ویژه MPEG\-4 (Audio Specific Configuration).
.PP
این فیلتر یک MPEG\-4 AudioSpecificConfig از روی هدر MPEG\-2/4 ADTS ایجاد کرده و هدر ADTS را حذف می‌کند.
.PP
این فیلتر برای نمونه هنگام کپی کردن یک استریم AAC از یک ظرف خام ADTS AAC یا کانتینر MPEG\-TS به MP4A\-LATM، به یک فایل FLV، یا به فایل‌های MOV/MP4 و فرمت‌های مرتبط مانند 3GP یا M4A مورد نیاز است. لطفاً توجه داشته باشید که این فیلتر به صورت خودکار برای MP4A\-LATM و MOV/MP4 و فرمت‌های مرتبط درج می‌شود.
.SS av1_metadata
.IX Subsection "av1_metadata"
اصلاح متادیتای تعبیه‌شده در یک استریم AV1.
.IP \fBtd\fR 4
.IX Item "td"
درج یا حذف OBUهای جداکننده زمانی (temporal delimiter) در تمام واحدهای زمانی استریم.
.RS 4
.IP \fBinsert\fR 4
.IX Item "insert"
درج یک TD در ابتدای هر TU که از قبل فاقد آن است.
.IP \fBremove\fR 4
.IX Item "remove"
حذف TD از ابتدای هر TU که دارای آن است.
.RE
.RS 4
.RE
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
.PD 0
.IP \fBtransfer_characteristics\fR 4
.IX Item "transfer_characteristics"
.IP \fBmatrix_coefficients\fR 4
.IX Item "matrix_coefficients"
.PD
تنظیم فیلدهای توصیف رنگ در استریم (بخش 6.4.2 استاندارد AV1 را ببینید).
.IP \fBcolor_range\fR 4
.IX Item "color_range"
تنظیم محدوده رنگ در استریم (بخش 6.4.2 استاندارد AV1 را ببینید؛ توجه داشته باشید که این فیلد را نمی‌توان برای استریم‌هایی که از مشخصات اصلی BT.709، ویژگی انتقال sRGB و ضرایب ماتریس همانی (RGB) استفاده می‌کنند تنظیم کرد).
.RS 4
.IP \fBtv\fR 4
.IX Item "tv"
محدوده محدود (Limited range).
.IP \fBpc\fR 4
.IX Item "pc"
محدوده کامل (Full range).
.RE
.RS 4
.RE
.IP \fBchroma_sample_position\fR 4
.IX Item "chroma_sample_position"
تنظیم مکان نمونه کروما در استریم (بخش 6.4.2 استاندارد AV1 را ببینید).
این فیلد تنها برای استریم‌های 4:2:0 قابل تنظیم است.
.RS 4
.IP \fBvertical\fR 4
.IX Item "vertical"
موقعیت چپ (منطبق بر پیش‌فرض در MPEG\-2 و H.264).
.IP \fBcolocated\fR 4
.IX Item "colocated"
موقعیت بالا\-چپ.
.RE
.RS 4
.RE
.IP \fBtick_rate\fR 4
.IX Item "tick_rate"
تنظیم نرخ تیک (\fItime_scale / num_units_in_display_tick\fR) در اطلاعات زمان‌بندی هدر دنباله (sequence header).
.IP \fBnum_ticks_per_picture\fR 4
.IX Item "num_ticks_per_picture"
تنظیم تعداد تیک‌ها در هر تصویر برای مشخص کردن این که استریم دارای نرخ فریم ثابت است. در صورتی که \fBtick_rate\fR نیز تنظیم نشده باشد، نادیده گرفته می‌شود.
.IP \fBdelete_padding\fR 4
.IX Item "delete_padding"
حذف OBUهای پدینگ (Padding OBUs).
.SS chomp
.IX Subsection "chomp"
حذف پدینگ صفر در انتهای یک بسته (packet).
.SS dca_core
.IX Subsection "dca_core"
استخراج هسته اصلی از یک استریم DCA/DTS، با صرف‌نظر از پسوندهایی مانند DTS\-HD.
.SS dovi_rpu
.IX Subsection "dovi_rpu"
دستکاری متادیتای Dolby Vision در یک جریان بیت HEVC/AV1، با امکان اختیاری فعال‌سازی فشرده‌سازی متادیتا.
.IP \fBstrip\fR 4
.IX Item "strip"
در صورت فعال بودن، تمامی متادیتای Dolby Vision (رکورد پیکربندی + بلوک‌های داده RPU) از استریم حذف می‌شوند.
.IP \fBcompression\fR 4
.IX Item "compression"
کدام سطح فشرده‌سازی فعال شود.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
بدون فشرده‌سازی متادیتا.
.IP \fBlimited\fR 4
.IX Item "limited"
طرح فشرده‌سازی محدود متادیتا. باید با اکثر دستگاه‌ها سازگار باشد. این حالت پیش‌فرض است.
.IP \fBextended\fR 4
.IX Item "extended"
فشرده‌سازی گسترش‌یافته متادیتا. دستگاه‌ها ملزم به پشتیبانی از آن نیستند. توجه داشته باشید که این سطح در حال حاضر در libavcodec رفتاری همانند \fBlimited\fR دارد.
.RE
.RS 4
.RE
.SS dovi_split
.IX Subsection "dovi_split"
تفکیک یک جریان بیت چندلایه‌ای HEVC با پروفایل ۷ دالبی ویژن (Dolby Vision Profile 7). پروفایل ۷ جریان بیت HEVC لایه ارتقا (enhancement\-layer) را به صورت درهم‌تنیده داخل واحدهای دسترسی لایه پایه حمل می‌کند که درون واحدهای NAL مشخص‌نشده توسط کاربر از نوع ۶۳ (UNSPEC63) بسته‌بندی شده‌اند، و متادیتای RPU نیز به عنوان یک NAL مشخص‌نشده توسط کاربر از نوع ۶۲ (UNSPEC62) در کنار آن قرار دارد.
.IP \fBmode\fR 4
.IX Item "mode"
کدام مؤلفه‌های Dolby Vision در جریان بیت خروجی حفظ شوند.
.RS 4
.IP \fBbl\fR 4
.IX Item "bl"
تنها لایه پایه: حذف تمام UNSPEC63 (لایه EL) و تمام UNSPEC62 (متادیتای RPU). خروجی یک استریم ساده HEVC بدون هیچ نشانگر Dolby Vision خواهد بود. این حالت پیش‌فرض است.
.IP \fBbl_rpu\fR 4
.IX Item "bl_rpu"
لایه پایه به همراه حفظ NAL مربوط به RPU.
.IP \fBel\fR 4
.IX Item "el"
تنها لایه ارتقا: برای هر NAL از نوع UNSPEC63، هدر خارجی دو بایتی NAL حذف شده و بار داده داخلی صادر می‌شود. نتیجه یک جریان بیت مستقل HEVC است. واحد UNSPEC62 (RPU) حذف می‌شود.
.IP \fBel_rpu\fR 4
.IX Item "el_rpu"
لایه ارتقا با حفظ عین به عین NALهای RPU. همانند \fBel\fR، اما NALهای RPU از نوع UNSPEC62 نیز در کنار NALهای بازشده EL صادر می‌شوند.
.RE
.RS 4
.RE
.SS dump_extra
.IX Subsection "dump_extra"
اضافه کردن extradata به ابتدای بسته‌های فیلترشده به جز زمانی که بسته‌های مذکور دقیقاً با همان extradata که قرار است اضافه شود آغاز شده باشند.
.IP \fBfreq\fR 4
.IX Item "freq"
آرگومان اضافی مشخص می‌کند که کدام بسته‌ها باید فیلتر شوند. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBk\fR 4
.IX Item "k"
.PD 0
.IP \fBkeyframe\fR 4
.IX Item "keyframe"
.PD
افزودن extradata به تمام بسته‌های کلیدی (key packets).
.IP \fBe\fR 4
.IX Item "e"
.PD 0
.IP \fBall\fR 4
.IX Item "all"
.PD
افزودن extradata به تمام بسته‌ها.
.RE
.RS 4
.RE
.PP
اگر مشخص نشود، پیش‌فرض \fBk\fR در نظر گرفته می‌شود.
.PP
برای نمونه دستور \fBffmpeg\fR زیر یک هدر سراسری را در بسته‌های H.264 تولیدشده توسط اینکودر \f(CW\*(C`libx264\*(C'\fR اجبار می‌کند (و در نتیجه هدرهای بسته‌های فردی را غیرفعال می‌سازد)، اما با افزودن هدر ذخیره‌شده در extradata به بسته‌های کلیدی، آن‌ها را اصلاح می‌نماید:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-map 0 \-flags:v +global_header \-c:v libx264 \-bsf:v dump_extra out.ts
.Ve
.SS dv_error_marker
.IX Subsection "dv_error_marker"
بلوک‌هایی در DV که به عنوان آسیب‌دیده علامت‌گذاری شده‌اند با بلوک‌هایی با رنگ مشخص‌شده جایگزین می‌شوند.
.IP \fBcolor\fR 4
.IX Item "color"
رنگی که بلوک‌های آسیب‌دیده با آن جایگزین می‌شوند.
.IP \fBsta\fR 4
.IX Item "sta"
یک ماسک ۱۶ بیتی که مشخص می‌کند کدام یک از ۱۶ مقدار ممکن وضعیت خطا باید با بلوک‌های رنگی جایگزین شوند. 0xFFFE مقدار پیش‌فرضی است که تمامی مقادیر وضعیت خطای غیر صفر را جایگزین می‌کند.
.RS 4
.IP \fBok\fR 4
.IX Item "ok"
بدون خطا، بدون پنهان‌سازی (concealment).
.IP \fBerr\fR 4
.IX Item "err"
خطا، بدون پنهان‌سازی.
.IP \fBres\fR 4
.IX Item "res"
رزرو شده.
.IP \fBnotok\fR 4
.IX Item "notok"
خطا یا پنهان‌سازی.
.IP \fBnotres\fR 4
.IX Item "notres"
رزرو نشده.
.IP "\fBAa, Ba, Ca, Ab, Bb, Cb, A, B, C, a, b, erri, erru\fR" 4
.IX Item "Aa, Ba, Ca, Ab, Bb, Cb, A, B, C, a, b, erri, erru"
کد وضعیت خطای خاص.
.RE
.RS 4
.Sp
صفحات ۴۴\-۴۶ یا بخش 5.5 از پیوند زیر را ببینید:
<\fBhttp://web.archive.org/web/20060927044735/http://www.smpte.org/smpte_store/standards/pdf/s314m.pdf\fR>
.RE
.SS eac3_core
.IX Subsection "eac3_core"
استخراج هسته از یک استریم E\-AC\-3، با صرف‌نظر از کانال‌های اضافی.
.SS eia608_to_smpte436m
.IX Subsection "eia608_to_smpte436m"
تبدیل یک استریم \f(CW\*(C`EIA_608\*(C'\fR به یک استریم داده \f(CW\*(C`SMPTE_436M_ANC\*(C'\fR، با بسته‌بندی زیرنویس‌های بسته (closed captions) در بسته‌های CTA\-708 CDP VANC.
.IP \fBline_number\fR 4
.IX Item "line_number"
انتخاب شماره خطی که بسته‌های VANC تولیدشده باید در آن قرار گیرند. معمولاً خط ۹ (پیش‌فرض) یا ۱۱ مد نظر است.
.IP \fBwrapping_type\fR 4
.IX Item "wrapping_type"
انتخاب نوع بسته‌بندی SMPTE 436M، پیش‌فرض \fBvanc_frame\fR است.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBvanc_frame\fR 4
.IX Item "vanc_frame"
فریم VANC (فریم درهم‌بافته یا پیش‌رونده بخش‌بندی‌شده).
.IP \fBvanc_field_1\fR 4
.IX Item "vanc_field_1"
.PD 0
.IP \fBvanc_field_2\fR 4
.IX Item "vanc_field_2"
.IP \fBvanc_progressive_frame\fR 4
.IX Item "vanc_progressive_frame"
.PD
.RE
.RS 4
.RE
.IP \fBsample_coding\fR 4
.IX Item "sample_coding"
انتخاب کدگذاری نمونه SMPTE 436M، پیش‌فرض \fB8bit_luma\fR است.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fB8bit_luma\fR 4
.IX Item "8bit_luma"
نمونه‌های روشنایی (luma) مؤلفه ۸ بیتی.
.IP \fB8bit_color_diff\fR 4
.IX Item "8bit_color_diff"
نمونه‌های تفاضل رنگ مؤلفه ۸ بیتی.
.IP \fB8bit_luma_and_color_diff\fR 4
.IX Item "8bit_luma_and_color_diff"
نمونه‌های روشنایی و تفاضل رنگ مؤلفه ۸ بیتی.
.IP \fB10bit_luma\fR 4
.IX Item "10bit_luma"
نمونه‌های روشنایی مؤلفه ۱۰ بیتی.
.IP \fB10bit_color_diff\fR 4
.IX Item "10bit_color_diff"
نمونه‌های تفاضل رنگ مؤلفه ۱۰ بیتی.
.IP \fB10bit_luma_and_color_diff\fR 4
.IX Item "10bit_luma_and_color_diff"
نمونه‌های روشنایی و تفاضل رنگ مؤلفه ۱۰ بیتی.
.IP \fB8bit_luma_parity_error\fR 4
.IX Item "8bit_luma_parity_error"
نمونه‌های روشنایی مؤلفه ۸ بیتی همراه با خطای پاریتی.
.IP \fB8bit_color_diff_parity_error\fR 4
.IX Item "8bit_color_diff_parity_error"
نمونه‌های تفاضل رنگ مؤلفه ۸ بیتی همراه با خطای پاریتی.
.IP \fB8bit_luma_and_color_diff_parity_error\fR 4
.IX Item "8bit_luma_and_color_diff_parity_error"
نمونه‌های روشنایی و تفاضل رنگ مؤلفه ۸ بیتی همراه با خطای پاریتی.
.RE
.RS 4
.RE
.IP \fBinitial_cdp_sequence_cntr\fR 4
.IX Item "initial_cdp_sequence_cntr"
مقدار اولیه فیلدهای عدد صحیح بدون علامت ۱۶ بیتی \f(CW\*(C`cdp_hdr_sequence_cntr\*(C'\fR و \f(CW\*(C`cdp_ftr_sequence_cntr\*(C'\fR در CDP. پیش‌فرض 0 است.
.IP \fBcdp_frame_rate\fR 4
.IX Item "cdp_frame_rate"
تنظیم فیلد \f(CW\*(C`cdp_frame_rate\*(C'\fR در CDP. این گزینه در عمل زمان‌بندی استریم داده را تغییر نمی‌دهد، بلکه صرفاً مقادیر درج‌شده در آن فیلد را در بسته‌های تولیدشده CDP تغییر می‌دهد. پیش‌فرض \fB30000/1001\fR است.
.SS extract_extradata
.IX Subsection "extract_extradata"
استخراج extradata درون‌باندی (in\-band extradata).
.PP
برخی کدک‌ها اجازه می‌دهند هدرهای بلندمدت (مانند هدرهای دنباله MPEG\-2 یا (VPS/)SPS/PPS در H.264/HEVC) یا به صورت «درون‌باندی» (یعنی به عنوان بخشی از جریان بیت حاوی فریم‌های کدگذاری‌شده) یا «برون‌باندی» (مانند سطح کانتینر) ارسال شوند. این حالت اخیر در اصطلاحات FFmpeg با نام «extradata» شناخته می‌شود.
.PP
این فیلتر جریان بیت هدرهای درون‌باندی را شناسایی کرده و آن‌ها را به عنوان extradata در دسترس قرار می‌دهد.
.IP \fBremove\fR 4
.IX Item "remove"
هنگامی که این گزینه فعال باشد، هدرهای بلندمدت پس از استخراج از جریان بیت حذف می‌شوند.
.SS filter_units
.IX Subsection "filter_units"
حذف واحدهایی با انواعی در مجموعه مشخص‌شده یا خارج از آن از استریم.
.IP \fBpass_types\fR 4
.IX Item "pass_types"
فهرستی از انواع واحد یا محدوده‌ای از انواع واحد برای عبور دادن، در حالی که همه موارد دیگر حذف می‌شوند. این فهرست با \*(Aq|\*(Aq از مقادیر نوع واحد یا محدوده‌ای از مقادیر با \*(Aq\-\*(Aq مشخص می‌شود.
.IP \fBremove_types\fR 4
.IX Item "remove_types"
همانند \fBpass_types\fR، با این تفاوت که واحدهای موجود در مجموعه داده‌شده حذف شده و تمام موارد دیگر عبور داده می‌شوند.
.PP
انواع مورد استفاده توسط pass_types و remove_types متناظر هستند با انواع واحد NAL به نام (nal_unit_type) در H.264، HEVC و H.266 (جدول 7\-1 در مشخصات H.264 و HEVC یا جدول 5 در مشخصات H.266 را ببینید)، مقادیر نشانگر (marker) برای JPEG (بدون پیشوند 0xFF) و کدهای شروع بدون پیشوند کد شروع (یعنی بایت بعد از 0x000001) برای MPEG\-2. برای VP8 و VP9، هر واحد دارای نوع صفر است.
.PP
داده اضافی (Extradata) توسط این تبدیل بدون تغییر باقی می‌ماند، اما توجه داشته باشید اگر استریم شامل مجموعه‌های پارامتر درون‌خطی باشد، در صورت حذف آن‌ها ممکن است خروجی غیرقابل استفاده شود.
.PP
برای نمونه، جهت حذف تمامی واحدهای NAL غیر VCL از یک استریم H.264:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v \*(Aqfilter_units=pass_types=1\-5\*(Aq OUTPUT
.Ve
.PP
جهت حذف تمامی AUDها، SEI و پرکننده‌ها (filler) از یک استریم H.265:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v \*(Aqfilter_units=remove_types=35|38\-40\*(Aq OUTPUT
.Ve
.PP
جهت حذف تمامی داده‌های کاربر از یک استریم MPEG\-2، شامل زیرنویس‌های بسته (Closed Captions):
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v \*(Aqfilter_units=remove_types=178\*(Aq OUTPUT
.Ve
.PP
جهت حذف تمامی SEI از یک استریم H264، شامل زیرنویس‌های بسته:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v \*(Aqfilter_units=remove_types=6\*(Aq OUTPUT
.Ve
.PP
جهت حذف تمامی پیشوندها و پسوندهای SEI از یک استریم HEVC، شامل زیرنویس‌های بسته و HDR پویا:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:v copy \-bsf:v \*(Aqfilter_units=remove_types=39|40\*(Aq OUTPUT
.Ve
.SS hapqa_extract
.IX Subsection "hapqa_extract"
استخراج بخش Rgb یا Alpha از یک فایل HAPQA، بدون فشرده‌سازی مجدد، به منظور ایجاد یک فایل HAPQ یا HAPAlphaOnly.
.IP \fBtexture\fR 4
.IX Item "texture"
بافتی را که باید نگه داشته شود مشخص می‌کند.
.RS 4
.IP \fBcolor\fR 4
.IX Item "color"
.PD 0
.IP \fBalpha\fR 4
.IX Item "alpha"
.PD
.RE
.RS 4
.RE
.PP
تبدیل HAPQA به HAPQ:
.PP
.Vb 1
\&        ffmpeg \-i hapqa_inputfile.mov \-c copy \-bsf:v hapqa_extract=texture=color \-tag:v HapY \-metadata:s:v:0 encoder="HAPQ" hapq_file.mov
.Ve
.PP
تبدیل HAPQA به HAPAlphaOnly:
.PP
.Vb 1
\&        ffmpeg \-i hapqa_inputfile.mov \-c copy \-bsf:v hapqa_extract=texture=alpha \-tag:v HapA \-metadata:s:v:0 encoder="HAPAlpha Only" hapalphaonly_file.mov
.Ve
.SS h264_metadata
.IX Subsection "h264_metadata"
اصلاح متادیتای تعبیه‌شده در یک استریم H.264.
.IP \fBaud\fR 4
.IX Item "aud"
درج یا حذف واحدهای NAL از نوع AUD در تمام واحدهای دسترسی استریم.
.RS 4
.IP \fBpass\fR 4
.IX Item "pass"
.PD 0
.IP \fBinsert\fR 4
.IX Item "insert"
.IP \fBremove\fR 4
.IX Item "remove"
.PD
.RE
.RS 4
.Sp
پیش‌فرض pass است.
.RE
.IP \fBsample_aspect_ratio\fR 4
.IX Item "sample_aspect_ratio"
تنظیم نسبت ابعاد نمونه استریم در پارامترهای VUI. جدول E\-1 در H.264 را ببینید.
.IP \fBoverscan_appropriate_flag\fR 4
.IX Item "overscan_appropriate_flag"
تنظیم این که آیا استریم برای نمایش با overscan مناسب است یا خیر (بخش E.2.1 در H.264 را ببینید).
.IP \fBvideo_format\fR 4
.IX Item "video_format"
.PD 0
.IP \fBvideo_full_range_flag\fR 4
.IX Item "video_full_range_flag"
.PD
تنظیم فرمت ویدیو در استریم (بخش E.2.1 و جدول E\-2 در H.264 را ببینید).
.IP \fBcolour_primaries\fR 4
.IX Item "colour_primaries"
.PD 0
.IP \fBtransfer_characteristics\fR 4
.IX Item "transfer_characteristics"
.IP \fBmatrix_coefficients\fR 4
.IX Item "matrix_coefficients"
.PD
تنظیم توصیف رنگ در استریم (بخش E.2.1 و جدول‌های E\-3، E\-4 و E\-5 در H.264 را ببینید).
.IP \fBchroma_sample_loc_type\fR 4
.IX Item "chroma_sample_loc_type"
تنظیم مکان نمونه کروما در استریم (بخش E.2.1 و شکل E\-1 در H.264 را ببینید).
.IP \fBtick_rate\fR 4
.IX Item "tick_rate"
تنظیم نرخ تیک (time_scale / num_units_in_tick) در پارامترهای VUI. این کوچک‌ترین واحد زمانی قابل نمایش در استریم است و در بسیاری از موارد نرخ فیلد استریم را نشان می‌دهد (دو برابر نرخ فریم).
.IP \fBfixed_frame_rate_flag\fR 4
.IX Item "fixed_frame_rate_flag"
تنظیم این که آیا استریم دارای نرخ فریم ثابت است یا خیر \- معمولاً نشان می‌دهد که نرخ فریم دقیقاً نصف نرخ تیک است، اما معنای دقیق به درهم‌بافتگی و ساختار تصویر وابسته است (بخش E.2.1 و جدول E\-6 در H.264 را ببینید).
.IP \fBzero_new_constraint_set_flags\fR 4
.IX Item "zero_new_constraint_set_flags"
صفر کردن پرچم‌های constraint_set4_flag و constraint_set5_flag در SPS. این بیت‌ها در نسخه قبلی مشخصات H.264 رزرو شده بودند، و از این رو برخی دیکودرهای سخت‌افزاری نیاز دارند که این‌ها صفر باشند. نتیجه صفر کردن این‌ها همچنان یک جریان بیت معتبر است.
.IP \fBcrop_left\fR 4
.IX Item "crop_left"
.PD 0
.IP \fBcrop_right\fR 4
.IX Item "crop_right"
.IP \fBcrop_top\fR 4
.IX Item "crop_top"
.IP \fBcrop_bottom\fR 4
.IX Item "crop_bottom"
.PD
تنظیم آفست‌های برش فریم در SPS. این مقادیر در صورتی که استریم از قبل برش داده شده باشد، جایگزین مقادیر فعلی خواهند شد.
.Sp
این فیلدها بر حسب پیکسل تنظیم می‌شوند. توجه داشته باشید که اگر کروما ساب‌سمپل شده باشد یا استریم درهم‌بافته باشد، ممکن است برخی اندازه‌ها قابل نمایش نباشند (بخش 7.4.2.1.1 در H.264 را ببینید).
.IP \fBsei_user_data\fR 4
.IX Item "sei_user_data"
درج یک رشته به عنوان داده کاربری ثبت‌نشده SEI (unregistered user data). آرگومان باید به فرم \fIUUID+string\fR باشد که در آن UUID به صورت ارقام هگزادسیمال است که احتمالاً با خط تیره جدا شده‌اند، و رشته می‌تواند هر چیزی باشد.
.Sp
برای نمونه، \fB086f3693\-b7b3\-4f2c\-9653\-21492feee5b8+hello\fR رشته «hello» را که به UUID داده‌شده مرتبط است درج می‌کند.
.IP \fBdelete_filler\fR 4
.IX Item "delete_filler"
حذف هر دو واحد NAL پرکننده و پیام‌های پرکننده SEI.
.IP \fBdisplay_orientation\fR 4
.IX Item "display_orientation"
درج، استخراج یا حذف پیام‌های SEI جهت نمایش (Display orientation).
برای نحو و معناشناسی، بخش‌های D.1.27 و D.2.27 استاندارد H.264 را ببینید.
.RS 4
.IP \fBpass\fR 4
.IX Item "pass"
.PD 0
.IP \fBinsert\fR 4
.IX Item "insert"
.IP \fBremove\fR 4
.IX Item "remove"
.IP \fBextract\fR 4
.IX Item "extract"
.PD
.RE
.RS 4
.Sp
پیش‌فرض pass است.
.Sp
حالت درج (insert) همراه با گزینه‌های \f(CW\*(C`rotate\*(C'\fR و \f(CW\*(C`flip\*(C'\fR کار می‌کند.
هرگونه پیام از پیش موجود جهت نمایش در حالت‌های insert یا remove حذف خواهد شد.
حالت استخراج (extract) ماتریس نمایش را به عنوان داده جانبی (side data) به بسته پیوست می‌کند.
.RE
.IP \fBrotate\fR 4
.IX Item "rotate"
تنظیم چرخش در SEI جهت نمایش (زاویه پادساعت‌گرد بر حسب درجه).
محدوده از \-360 تا +360 است. پیش‌فرض NaN است.
.IP \fBflip\fR 4
.IX Item "flip"
تنظیم وارونگی (flip) در SEI جهت نمایش.
.RS 4
.IP \fBhorizontal\fR 4
.IX Item "horizontal"
.PD 0
.IP \fBvertical\fR 4
.IX Item "vertical"
.PD
.RE
.RS 4
.Sp
پیش‌فرض تنظیم‌نشده است.
.RE
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح (level) در SPS. به بخش A.3 و جدول‌های A\-1 تا A\-5 در H.264 مراجعه کنید.
.Sp
آرگومان باید نام یک سطح (برای نمونه \fB4.2\fR)، یک مقدار level_idc (برای نمونه \fB42\fR)، یا نام ویژه \fBauto\fR باشد که نشان می‌دهد فیلتر باید تلاش کند سطح را از ویژگی‌های استریم ورودی حدس بزند.
.SS h264_mp4toannexb
.IX Subsection "h264_mp4toannexb"
تبدیل یک جریان بیت H.264 از حالت طول با پیشوند (length prefixed) به حالت کد شروع با پیشوند (start code prefixed)، مطابق با تعریف در پیوست B از مشخصات ITU\-T H.264.
.PP
این تبدیل برای برخی فرمت‌های پخش زنده، معمولاً فرمت استریم انتقال MPEG\-2 (میکسر \f(CW\*(C`mpegts\*(C'\fR) مورد نیاز است.
.PP
برای نمونه جهت ریمکس کردن یک فایل MP4 حاوی استریم H.264 به فرمت mpegts با \fBffmpeg\fR، می‌توانید از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffmpeg \-i INPUT.mp4 \-codec copy \-bsf:v h264_mp4toannexb OUTPUT.ts
.Ve
.PP
لطفاً توجه داشته باشید که این فیلتر برای فرمت‌های خروجی MPEG\-TS (میکسر \&\f(CW\*(C`mpegts\*(C'\fR) و خام H.264 (میکسر \f(CW\*(C`h264\*(C'\fR) به صورت خودکار درج می‌شود.
.SS h264_redundant_pps
.IX Subsection "h264_redundant_pps"
این فیلتر یک اصلاح ویژه را روی برخی استریم‌های H264 دیسک بلو-ری BDMV که شامل PPSهای زائد هستند اعمال می‌کند. این PPSها پارامترهای نامربوط استریم را تغییر می‌دهند و باعث سردرگمی سایر تبدیلات می‌شوند که به extradata صحیح نیاز دارند.
.PP
اینکودر مورد استفاده در این استریم‌های متأثر، PPSهای اضافی را در سرتاسر استریم اضافه می‌کند و مقدار اولیه QP و فعال بودن یا نبودن پیش‌بینی وزنی را تغییر می‌دهد. این امر پس از کپی کردن استریم در کانتینری با هدر سراسری مشکلاتی ایجاد می‌کند، زیرا PPS آغازین برای ادامه استریم مناسب نیست. به عنوان یک اثر جانبی، برای نمونه، پرش در ویدیو (seeking) تا زمان ظاهر شدن یک PPS جدید خروجی به‌هم‌ریخته ارائه می‌دهد.
.PP
این فیلتر جریان بیت (BSF) این PPSهای اضافی را حذف کرده و هدرهای برش را بازنویسی می‌کند به گونه‌ای که استریم از یک PPS راهنمای منفرد در هدر سراسری استفاده کند، که مشکل را برطرف می‌سازد.
.SS hevc_metadata
.IX Subsection "hevc_metadata"
اصلاح متادیتای تعبیه‌شده در یک استریم HEVC.
.IP \fBaud\fR 4
.IX Item "aud"
درج یا حذف واحدهای NAL از نوع AUD در تمام واحدهای دسترسی استریم.
.RS 4
.IP \fBinsert\fR 4
.IX Item "insert"
.PD 0
.IP \fBremove\fR 4
.IX Item "remove"
.PD
.RE
.RS 4
.RE
.IP \fBsample_aspect_ratio\fR 4
.IX Item "sample_aspect_ratio"
تنظیم نسبت ابعاد نمونه در پارامترهای VUI استریم.
.IP \fBvideo_format\fR 4
.IX Item "video_format"
.PD 0
.IP \fBvideo_full_range_flag\fR 4
.IX Item "video_full_range_flag"
.PD
تنظیم فرمت ویدیو در استریم (بخش E.3.1 و جدول E.2 در H.265 را ببینید).
.IP \fBcolour_primaries\fR 4
.IX Item "colour_primaries"
.PD 0
.IP \fBtransfer_characteristics\fR 4
.IX Item "transfer_characteristics"
.IP \fBmatrix_coefficients\fR 4
.IX Item "matrix_coefficients"
.PD
تنظیم توصیف رنگ در استریم (بخش E.3.1 و جدول‌های E.3، E.4 و E.5 در H.265 را ببینید).
.IP \fBchroma_sample_loc_type\fR 4
.IX Item "chroma_sample_loc_type"
تنظیم مکان نمونه کروما در استریم (بخش E.3.1 و شکل E.1 در H.265 را ببینید).
.IP \fBtick_rate\fR 4
.IX Item "tick_rate"
تنظیم نرخ تیک در پارامترهای VPS و VUI به صورت (time_scale / num_units_in_tick). همراه با \fBnum_ticks_poc_diff_one\fR، این گزینه می‌تواند یک نرخ فریم ثابت در استریم تنظیم کند. توجه داشته باشید که اگر استریم در یک کانتینر باشد، احتمالاً توسط پارامترهای کانتینر نادیده گرفته می‌شود.
.IP \fBnum_ticks_poc_diff_one\fR 4
.IX Item "num_ticks_poc_diff_one"
تنظیم poc_proportional_to_timing_flag در VPS و VUI و استفاده از این مقدار برای تنظیم num_ticks_poc_diff_one_minus1 (بخش‌های 7.4.3.1 و E.3.1 در H.265 را ببینید). اگر \fBtick_rate\fR نیز تنظیم نشده باشد، نادیده گرفته می‌شود.
.IP \fBcrop_left\fR 4
.IX Item "crop_left"
.PD 0
.IP \fBcrop_right\fR 4
.IX Item "crop_right"
.IP \fBcrop_top\fR 4
.IX Item "crop_top"
.IP \fBcrop_bottom\fR 4
.IX Item "crop_bottom"
.PD
تنظیم آفست‌های برش پنجره انطباق (conformance window) در SPS. این مقادیر در صورتی که استریم از قبل برش داده شده باشد، جایگزین مقادیر فعلی خواهند شد.
.Sp
این فیلدها بر حسب پیکسل تنظیم می‌شوند. توجه داشته باشید که در صورت ساب‌سمپل بودن کروما ممکن است برخی اندازه‌ها قابل نمایش نباشند (بخش 7.4.3.2.1 در H.265).
.IP \fBwidth\fR 4
.IX Item "width"
.PD 0
.IP \fBheight\fR 4
.IX Item "height"
.PD
تنظیم عرض و ارتفاع پس از برش.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح (level) در VPS و SPS. بخش A.4 و جدول‌های A.6 و A.7 در H.265 را ببینید.
.Sp
آرگومان باید نام یک سطح (برای نمونه \fB5.1\fR)، یک مقدار \&\fIgeneral_level_idc\fR (برای نمونه \fB153\fR برای سطح 5.1)، یا نام ویژه \fBauto\fR باشد که نشان می‌دهد فیلتر باید تلاش کند سطح را از ویژگی‌های استریم ورودی حدس بزند.
.SS hevc_mp4toannexb
.IX Subsection "hevc_mp4toannexb"
تبدیل یک جریان بیت HEVC/H.265 از حالت با پیشوند طول به حالت با پیشوند کد شروع (همان‌طور که در پیوست B از مشخصات ITU\-T H.265 تعریف شده است).
.PP
این تبدیل برای برخی فرمت‌های پخش زنده، معمولاً فرمت استریم انتقال MPEG\-2 (میکسر \f(CW\*(C`mpegts\*(C'\fR) مورد نیاز است.
.PP
برای نمونه جهت ریمکس کردن یک فایل MP4 حاوی استریم HEVC به فرمت mpegts با \fBffmpeg\fR، می‌توانید از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffmpeg \-i INPUT.mp4 \-codec copy \-bsf:v hevc_mp4toannexb OUTPUT.ts
.Ve
.PP
لطفاً توجه داشته باشید که این فیلتر به صورت خودکار برای فرمت‌های خروجی MPEG\-TS (میکسر \&\f(CW\*(C`mpegts\*(C'\fR) و خام HEVC/H.265 (میکسر \f(CW\*(C`h265\*(C'\fR یا \&\f(CW\*(C`hevc\*(C'\fR) درج می‌شود.
.SS imxdump
.IX Subsection "imxdump"
جریان بیت را اصلاح می‌کند تا در MOV قرار گیرد و توسط دیکودر Final Cut Pro قابل استفاده باشد. این فیلتر تنها برای کدک mpeg2video اعمال می‌شود، و احتمالاً برای Final Cut Pro 7 و نسخه‌های جدیدتر با داشتن \&\fB\-tag:v\fR مناسب نیازی به آن نیست.
.PP
برای نمونه، برای ریمکس کردن ۳۰ مگابایت بر ثانیه NTSC IMX به MOV:
.PP
.Vb 1
\&        ffmpeg \-i input.mxf \-c copy \-bsf:v imxdump \-tag:v mx3n output.mov
.Ve
.SS mjpeg2jpeg
.IX Subsection "mjpeg2jpeg"
تبدیل بسته‌های MJPEG/AVI1 به بسته‌های کامل JPEG/JFIF.
.PP
فرمت MJPEG یک کدک ویدیویی است که در آن هر فریم ویدیو در اصل یک تصویر JPEG است. فریم‌های مجزا را می‌توان بدون اتلاف استخراج کرد، مثلاً با:
.PP
.Vb 1
\&        ffmpeg \-i ../some_mjpeg.avi \-c:v copy frames_%d.jpg
.Ve
.PP
متأسفانه این تکه‌ها تصاویر ناقص JPEG هستند، زیرا بخش DHT مورد نیاز برای دیکود را ندارند. به نقل از <\fBhttp://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml\fR>:
.PP
اوری لی (Avery Lee)، در سال ۲۰۰۱ در گروه خبری rec.video.desktop نوشت: «MJPEG، یا حداقل MJPEG در فایل‌های AVI دارای کد چهارنویسه‌ای (fourcc) از نوع MJPG، یک JPEG محدودشده با یک جدول هافمن ثابت \-\- و *حذف‌شده* \-\- است. تصویر JPEG باید در فضای رنگی YCbCr باشد، باید 4:2:2 باشد، و باید از انکود هافمن پایه استفاده کند، نه محاسباتی یا پیش‌رونده. . . . در واقع می‌توانید فریم‌های MJPEG را استخراج کرده و آن‌ها را با یک دیکودر معمولی JPEG رمزگشایی کنید، اما باید بخش DHT را به آن‌ها اضافه نمایید، در غیر این صورت دیکودر هیچ اطلاعی از نحوه از حالت فشرده خارج کردن داده‌ها نخواهد داشت. جدول دقیق مورد نیاز در مشخصات OpenDML ارائه شده است.»
.PP
این فیلتر جریان بیت، هدر فریم‌های استخراج‌شده از یک استریم MJPEG را (که شناسه هدر AVI1 را حمل می‌کنند و فاقد بخش DHT هستند) وصله می‌کند تا تصاویر JPEG کاملاً استاندارد تولید شوند.
.PP
.Vb 3
\&        ffmpeg \-i mjpeg\-movie.avi \-c:v copy \-bsf:v mjpeg2jpeg frame_%d.jpg
\&        exiftran \-i \-9 frame*.jpg
\&        ffmpeg \-i frame_%d.jpg \-c:v copy rotated.avi
.Ve
.SS mjpegadump
.IX Subsection "mjpegadump"
افزودن یک هدر MJPEG A به جریان بیت، برای امکان‌پذیر ساختن رمزگشایی توسط Quicktime.
.SS mov2textsub
.IX Subsection "mov2textsub"
استخراج یک فایل متنی قابل نمایش از زیرنویس‌های MOV، با حذف هدر متادیتا از هر بسته زیرنویس.
.PP
همچنین فیلتر \fBtext2movsub\fR را ببینید.
.SS mpeg2_metadata
.IX Subsection "mpeg2_metadata"
اصلاح متادیتای تعبیه‌شده در یک استریم MPEG\-2.
.IP \fBdisplay_aspect_ratio\fR 4
.IX Item "display_aspect_ratio"
تنظیم نسبت ابعاد نمایش در استریم.
.Sp
مقادیر ثابت زیر پشتیبانی می‌شوند:
.RS 4
.IP \fB4/3\fR 4
.IX Item "4/3"
.PD 0
.IP \fB16/9\fR 4
.IX Item "16/9"
.IP \fB221/100\fR 4
.IX Item "221/100"
.PD
.RE
.RS 4
.Sp
هر مقدار دیگری باعث می‌شود که به جای آن پیکسل‌های مربعی اعلام شوند (بخش 6.3.3 و جدول 6\-3 در H.262 را ببینید).
.RE
.IP \fBframe_rate\fR 4
.IX Item "frame_rate"
تنظیم نرخ فریم در استریم. این مقدار از جدولی از مقادیر شناخته‌شده همراه با یک ضریب و مقسوم‌علیه کوچک ساخته می‌شود \- اگر مقدار ارائه‌شده دقیقاً قابل نمایش نباشد، نزدیک‌ترین مقدار قابل نمایش استفاده خواهد شد (بخش 6.3.3 و جدول 6\-4 در H.262 را ببینید).
.IP \fBvideo_format\fR 4
.IX Item "video_format"
تنظیم فرمت ویدیو در استریم (بخش 6.3.6 و جدول 6\-6 در H.262 را ببینید).
.IP \fBcolour_primaries\fR 4
.IX Item "colour_primaries"
.PD 0
.IP \fBtransfer_characteristics\fR 4
.IX Item "transfer_characteristics"
.IP \fBmatrix_coefficients\fR 4
.IX Item "matrix_coefficients"
.PD
تنظیم توصیف رنگ در استریم (بخش 6.3.6 و جدول‌های 6\-7، 6\-8 و 6\-9 در H.262 را ببینید).
.SS mpeg4_unpack_bframes
.IX Subsection "mpeg4_unpack_bframes"
باز کردن فریم‌های B بسته‌بندی‌شده به سبک DivX.
.PP
فریم‌های B بسته‌بندی‌شده به سبک DivX فرمت استاندارد و معتبر MPEG\-4 نیستند و صرفاً راهکاری برای زیرسیستم معیوب Video for Windows بودند. آن‌ها فضای بیشتری مصرف می‌کنند، می‌توانند باعث مشکلات جزئی همگام‌سازی AV شوند، برای دیکود به توان CPU بیشتری نیاز دارند (مگر اینکه پخش‌کننده صف تصاویر دیکودشده داشته باشد تا سبک فریم در بسته 2,0,2,0 را جبران کند) و اگر در کانتینرهای استانداردی مانند mp4 یا mpeg\-ps/ts کپی شوند مشکل‌ساز می‌شوند، زیرا ممکن است دیکودرهای MPEG\-4 قادر به دیکود آن‌ها نباشند چون MPEG\-4 معتبر نیستند.
.PP
برای نمونه جهت اصلاح یک فایل AVI حاوی استریم MPEG\-4 با فریم‌های B بسته‌بندی‌شده به سبک DivX با استفاده از \fBffmpeg\fR، می‌توانید از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffmpeg \-i INPUT.avi \-codec copy \-bsf:v mpeg4_unpack_bframes OUTPUT.avi
.Ve
.SS noise
.IX Subsection "noise"
محتوای بسته‌ها را مخدوش می‌کند یا به سادگی آن‌ها را بدون آسیب رساندن به کانتینر دور می‌اندازد (drop). می‌تواند برای تست تصادفی (fuzzing) یا آزمودن تاب‌آوری/پنهان‌سازی خطا استفاده شود.
.PP
پارامترها:
.IP \fBamount\fR 4
.IX Item "amount"
عبارتی را می‌پذیرد که ارزیابی آن به ازای هر بسته تعیین می‌کند هر چند وقت یک‌بار بایت‌ها در آن بسته تغییر داده شوند. مقداری زیر ۰ به فرکانس متغیر منجر خواهد شد. پیش‌فرض 0 است که منجر به عدم تغییر می‌شود. با این حال، اگر نه amount و نه drop مشخص نشده باشند، amount روی \fI\-1\fR تنظیم خواهد شد. برای متغیرهای پذیرفته‌شده به زیر مراجعه کنید.
.IP \fBdrop\fR 4
.IX Item "drop"
عبارتی را می‌پذیرد که به ازای هر بسته ارزیابی می‌شود و مقدار آن مشخص می‌کند که آیا آن بسته دور انداخته شود یا خیر. ارزیابی به یک مقدار مثبت منجر به دور انداختن بسته می‌شود. ارزیابی به یک مقدار منفی منجر به شانس متغیر برای دور انداخته شدن آن می‌شود که تقریباً نسبت معکوس با بزرگی مقدار دارد. پیش‌فرض 0 است که به معنای دور نینداختن است. برای متغیرهای پذیرفته‌شده به زیر مراجعه کنید.
.IP \fBdropamount\fR 4
.IX Item "dropamount"
یک عدد صحیح غیرمنفی را می‌پذیرد که شانس متغیری را برای دور انداخته شدن آن اختصاص می‌دهد که تقریباً نسبت معکوس با مقدار دارد. پیش‌فرض 0 است که منجر به دور نینداختن می‌شود. این گزینه برای سازگاری با گذشته حفظ شده است و معادل تنظیم drop به یک مقدار منفی با همان بزرگی است، یعنی \f(CW\*(C`dropamount=4\*(C'\fR مشابه \f(CW\*(C`drop=\-4\*(C'\fR است. اگر drop نیز مشخص شده باشد نادیده گرفته می‌شود.
.PP
هر دو گزینه \f(CW\*(C`amount\*(C'\fR و \f(CW\*(C`drop\*(C'\fR عبارات حاوی متغیرهای زیر را می‌پذیرند:
.IP \fBn\fR 4
.IX Item "n"
اندیس بسته، با شروع از صفر.
.IP \fBtb\fR 4
.IX Item "tb"
مبنای زمان (timebase) برای برچسب‌های زمانی بسته.
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمان ارائه (presentation timestamp) بسته.
.IP \fBdts\fR 4
.IX Item "dts"
برچسب زمان دیکود (decoding timestamp) بسته.
.IP \fBnopts\fR 4
.IX Item "nopts"
ثابت نمایانگر AV_NOPTS_VALUE.
.IP \fBstartpts\fR 4
.IX Item "startpts"
نخستین مقدار PTS غیر از AV_NOPTS_VALUE که در استریم دیده شده است.
.IP \fBstartdts\fR 4
.IX Item "startdts"
نخستین مقدار DTS غیر از AV_NOPTS_VALUE که در استریم دیده شده است.
.IP \fBduration\fR 4
.IX Item "duration"
.PD 0
.IP \fBd\fR 4
.IX Item "d"
.PD
مدت‌زمان بسته، در واحدهای مبنای زمان.
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت بسته در ورودی؛ در صورت نامشخص بودن یا عدم تنظیم ممکن است \-1 باشد.
.IP \fBsize\fR 4
.IX Item "size"
اندازه بسته، بر حسب بایت.
.IP \fBkey\fR 4
.IX Item "key"
این که آیا بسته به عنوان یک فریم کلیدی (keyframe) علامت‌گذاری شده است یا خیر.
.IP \fBstate\fR 4
.IX Item "state"
یک عدد صحیح شبه‌تصادفی، که عمدتاً از محتوای بار داده بسته مشتق شده است.
.PP
\fIنمونه‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
اعمال تغییر روی هر بایت اما بدون دور انداختن هیچ بسته‌ای:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c copy \-bsf noise=1 output.mkv
.Ve
.PP
دور انداختن تمام بسته‌های ویدیویی که به عنوان فریم کلیدی علامت‌گذاری نشده‌اند پس از برچسب زمان ۳۰ ثانیه، اما بدون تغییر در هیچ‌یک از بسته‌های باقی‌مانده:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c copy \-bsf:v noise=drop=\*(Aqgt(pts*tb\e,30)*not(key)\*(Aq output.mkv
.Ve
.PP
دور انداختن یک ثانیه صوت در هر ۱۰ ثانیه و افزودن مقداری نویز تصادفی به بقیه:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c copy \-bsf:a noise=amount=\-1:drop=\*(Aqbetween(mod(pts*tb\e,10)\e,9\e,10)\*(Aq output.mkv
.Ve
.SS null
.IX Subsection "null"
این فیلتر جریان بیت بسته‌ها را بدون تغییر عبور می‌دهد.
.SS pcm_rechunk
.IX Subsection "pcm_rechunk"
بسته‌بندی مجدد صدای PCM به تعداد ثابتی از نمونه‌ها در هر بسته یا نرخ ثابت بسته در هر ثانیه. این شبیه به \fBفیلتر صوتی asetnsamples\fR است اما به جای فریم‌های صوتی، روی بسته‌های صوتی کار می‌کند.
.IP "\fBnb_out_samples, n\fR" 4
.IX Item "nb_out_samples, n"
تنظیم تعداد نمونه‌ها در هر بسته صوتی خروجی. این تعداد به عنوان تعداد نمونه‌ها \fIبه ازای هر کانال\fR در نظر گرفته می‌شود. مقدار پیش‌فرض 1024 است.
.IP "\fBpad, p\fR" 4
.IX Item "pad, p"
اگر روی ۱ تنظیم شود، فیلتر آخرین بسته صوتی را با سکوت پر می‌کند (pad)، به طوری که تعداد نمونه‌های آن مشابه (یا تقریباً مشابه، \fBframe_rate\fR را ببینید) بسته‌های قبلی باشد. مقدار پیش‌فرض 1 است.
.IP "\fBframe_rate, r\fR" 4
.IX Item "frame_rate, r"
این گزینه باعث می‌شود فیلتر به جای تعداد ثابتی نمونه در هر بسته، تعداد ثابتی بسته در هر ثانیه خروجی دهد. اگر نرخ نمونه صوتی بر نرخ فریم بخش‌پذیر نباشد، تعداد نمونه‌ها ثابت نخواهد بود بلکه اندکی تغییر می‌کند تا هر بسته تا حد ممکن نزدیک به مرز فریم آغاز شود. استفاده از این گزینه نسبت به \fBnb_out_samples\fR اولویت دارد.
.PP
می‌توانید با استفاده از گزینه \fBframe_rate\fR الگوی شناخته‌شده 1602\-1601\-1602\-1601\-1602 صدای 48kHz را برای نرخ فریم NTSC ایجاد کنید:
.PP
.Vb 1
\&        ffmpeg \-f lavfi \-i sine=r=48000:d=1 \-c pcm_s16le \-bsf pcm_rechunk=r=30000/1001 \-f framecrc \-
.Ve
.SS pgs_frame_merge
.IX Subsection "pgs_frame_merge"
ادغام دنباله‌ای از بخش‌های زیرنویس PGS منتهی به یک بخش «پایان مجموعه نمایش» (end of display set) در یک بسته واحد.
.PP
این برای برخی کانتینرهایی که از زیرنویس‌های PGS پشتیبانی می‌کنند (میکسر \f(CW\*(C`matroska\*(C'\fR) مورد نیاز است.
.SS prores_metadata
.IX Subsection "prores_metadata"
اصلاح متادیتای ویژگی‌های رنگ تعبیه‌شده در استریم prores.
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
تنظیم مشخصات اصلی رنگ (color primaries).
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی مشخصات اصلی رنگ (پیش‌فرض).
.IP \fBunknown\fR 4
.IX Item "unknown"
.PD 0
.IP \fBbt709\fR 4
.IX Item "bt709"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.PD
BT601 625
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
BT601 525
.IP \fBbt2020\fR 4
.IX Item "bt2020"
.PD 0
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
.PD
DCI P3
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
P3 D65
.RE
.RS 4
.RE
.IP \fBtransfer_characteristics\fR 4
.IX Item "transfer_characteristics"
تنظیم مشخصه انتقال رنگ (color transfer).
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی مشخصه انتقال (پیش‌فرض).
.IP \fBunknown\fR 4
.IX Item "unknown"
.PD 0
.IP \fBbt709\fR 4
.IX Item "bt709"
.PD
BT 601, BT 709, BT 2020
.IP \fBsmpte2084\fR 4
.IX Item "smpte2084"
SMPTE ST 2084
.IP \fBarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
ARIB STD\-B67
.RE
.RS 4
.RE
.IP \fBmatrix_coefficients\fR 4
.IX Item "matrix_coefficients"
تنظیم ضریب ماتریس (matrix coefficient).
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی فضای رنگ (پیش‌فرض).
.IP \fBunknown\fR 4
.IX Item "unknown"
.PD 0
.IP \fBbt709\fR 4
.IX Item "bt709"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.PD
BT 601
.IP \fBbt2020nc\fR 4
.IX Item "bt2020nc"
.RE
.RS 4
.RE
.PP
تنظیم فضای رنگ Rec709 برای هر فریم فایل:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c copy \-bsf:v prores_metadata=color_primaries=bt709:color_trc=bt709:colorspace=bt709 output.mov
.Ve
.PP
تنظیم پارامترهای Hybrid Log\-Gamma برای هر فریم فایل:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c copy \-bsf:v prores_metadata=color_primaries=bt2020:color_trc=arib\-std\-b67:colorspace=bt2020nc output.mov
.Ve
.SS remove_extra
.IX Subsection "remove_extra"
حذف extradata از بسته‌ها.
.PP
پارامتر زیر را می‌پذیرد:
.IP \fBfreq\fR 4
.IX Item "freq"
مشخص می‌کند که extradata از کدام انواع فریم حذف شود.
.RS 4
.IP \fBk\fR 4
.IX Item "k"
حذف extradata تنها از فریم‌های غیرکلیدی.
.IP \fBkeyframe\fR 4
.IX Item "keyframe"
حذف extradata تنها از فریم‌های کلیدی.
.IP "\fBe, all\fR" 4
.IX Item "e, all"
حذف extradata از تمامی فریم‌ها.
.RE
.RS 4
.RE
.SS setts
.IX Subsection "setts"
تنظیم PTS و DTS در بسته‌ها.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBts\fR 4
.IX Item "ts"
.PD 0
.IP \fBpts\fR 4
.IX Item "pts"
.IP \fBdts\fR 4
.IX Item "dts"
.PD
تنظیم عبارات برای PTS، DTS یا هر دو.
.IP \fBduration\fR 4
.IX Item "duration"
تنظیم عبارت برای مدت‌زمان (duration).
.IP \fBtime_base\fR 4
.IX Item "time_base"
تنظیم مبنای زمان خروجی.
.IP \fBprescale\fR 4
.IX Item "prescale"
تنظیم این که آیا فیلدهای زمان پیش از ارزیابی عبارات به مبنای زمان خروجی تعیین‌شده توسط کاربر تبدیل شوند یا خیر. پیش‌فرض 0 است.
.PP
عبارات از طریق API ارزیابی (eval API) ارزیابی می‌شوند و می‌توانند شامل ثابت‌های زیر باشند:
.IP \fBN\fR 4
.IX Item "N"
شمارش بسته ورودی. با شروع از 0.
.IP \fBTS\fR 4
.IX Item "TS"
برچسب زمان دیمکس در ورودی در صورت وجود گزینه \f(CW\*(C`ts\*(C'\fR یا \f(CW\*(C`dts\*(C'\fR، یا برچسب زمان ارائه در صورت وجود گزینه \f(CW\*(C`pts\*(C'\fR.
.IP \fBPOS\fR 4
.IX Item "POS"
موقعیت اصلی بسته در فایل، یا تعریف‌نشده در صورتی که برای بسته فعلی نامشخص باشد.
.IP \fBDTS\fR 4
.IX Item "DTS"
برچسب زمان دیمکس در ورودی.
.IP \fBPTS\fR 4
.IX Item "PTS"
برچسب زمان ارائه در ورودی.
.IP \fBDURATION\fR 4
.IX Item "DURATION"
مدت‌زمان در ورودی.
.IP \fBSTARTDTS\fR 4
.IX Item "STARTDTS"
مقدار DTS نخستین بسته.
.IP \fBSTARTPTS\fR 4
.IX Item "STARTPTS"
مقدار PTS نخستین بسته.
.IP \fBPREV_INDTS\fR 4
.IX Item "PREV_INDTS"
مقدار DTS ورودی قبلی.
.IP \fBPREV_INPTS\fR 4
.IX Item "PREV_INPTS"
مقدار PTS ورودی قبلی.
.IP \fBPREV_INDURATION\fR 4
.IX Item "PREV_INDURATION"
مدت‌زمان ورودی قبلی.
.IP \fBPREV_OUTDTS\fR 4
.IX Item "PREV_OUTDTS"
مقدار DTS خروجی قبلی.
.IP \fBPREV_OUTPTS\fR 4
.IX Item "PREV_OUTPTS"
مقدار PTS خروجی قبلی.
.IP \fBPREV_OUTDURATION\fR 4
.IX Item "PREV_OUTDURATION"
مدت‌زمان خروجی قبلی.
.IP \fBNEXT_DTS\fR 4
.IX Item "NEXT_DTS"
مقدار DTS ورودی بعدی.
.IP \fBNEXT_PTS\fR 4
.IX Item "NEXT_PTS"
مقدار PTS ورودی بعدی.
.IP \fBNEXT_DURATION\fR 4
.IX Item "NEXT_DURATION"
مدت‌زمان ورودی بعدی.
.IP \fBTB\fR 4
.IX Item "TB"
مبنای زمانی که فیلدهای زمانی در آن بیان می‌شوند. در صورت فعال بودن prescale مبنای زمان خروجی تعیین‌شده توسط کاربر است، و در غیر این صورت مبنای زمان ورودی است.
.IP \fBTB_OUT\fR 4
.IX Item "TB_OUT"
مبنای زمان خروجی.
.IP \fBSR\fR 4
.IX Item "SR"
نرخ نمونه‌برداری استریمی که بسته به آن تعلق دارد.
.IP \fBNOPTS\fR 4
.IX Item "NOPTS"
ثابت AV_NOPTS_VALUE.
.PP
برای نمونه، جهت برابر قرار دادن PTS با DTS (در صورت وجود فریم‌های B توصیه نمی‌شود):
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-c:a copy \-bsf:a setts=pts=DTS out.mkv
.Ve
.SS showinfo
.IX Subsection "showinfo"
ثبت اطلاعات پایه‌ای بسته‌ها در لاگ. عمدتاً برای آزمون، اشکال‌زدایی و توسعه مفید است.
.SS smpte436m_to_eia608
.IX Subsection "smpte436m_to_eia608"
تبدیل یک استریم داده \f(CW\*(C`SMPTE_436M_ANC\*(C'\fR به یک استریم \f(CW\*(C`EIA_608\*(C'\fR، با استخراج زیرنویس‌های بسته از بسته‌های CTA\-708 CDP VANC و نادیده گرفتن تمام داده‌های دیگر.
.SS text2movsub
.IX Subsection "text2movsub"
تبدیل زیرنویس‌های متنی به زیرنویس‌های MOV (همان‌گونه که توسط کدک \f(CW\*(C`mov_text\*(C'\fR استفاده می‌شود) همراه با هدرهای متادیتا.
.PP
همچنین فیلتر \fBmov2textsub\fR را ببینید.
.SS trace_headers
.IX Subsection "trace_headers"
ثبت خروجی ردگیری حاوی تمامی عناصر ساختاری (syntax elements) در هدرهای استریم کدگذاری‌شده (همه چیز بالاتر از سطح بلوک‌های کدگذاری‌شده منفرد). این گزینه می‌تواند برای اشکال‌زدایی مشکلات سطح پایین استریم مفید باشد.
.PP
از AV1، H.264، H.265، (M)JPEG، MPEG\-2 و VP9 پشتیبانی می‌کند، اما بسته به بیلد برنامه ممکن است تنها زیرمجموعه‌ای از این موارد در دسترس باشند.
.SS truehd_core
.IX Subsection "truehd_core"
استخراج هسته اصلی از یک استریم TrueHD، با صرف‌نظر از داده‌های ATMOS.
.SS vp9_metadata
.IX Subsection "vp9_metadata"
اصلاح متادیتای تعبیه‌شده در یک استریم VP9.
.IP \fBcolor_space\fR 4
.IX Item "color_space"
تنظیم مقدار فضای رنگ در هدر فریم. توجه داشته باشید هر فریمی که روی RGB تنظیم شود به صورت ضمنی روی محدوده PC تنظیم خواهد شد و RGB با پروفایل‌های 0 و 2 ناسازگار است.
.RS 4
.IP \fBunknown\fR 4
.IX Item "unknown"
.PD 0
.IP \fBbt601\fR 4
.IX Item "bt601"
.IP \fBbt709\fR 4
.IX Item "bt709"
.IP \fBsmpte170\fR 4
.IX Item "smpte170"
.IP \fBsmpte240\fR 4
.IX Item "smpte240"
.IP \fBbt2020\fR 4
.IX Item "bt2020"
.IP \fBrgb\fR 4
.IX Item "rgb"
.PD
.RE
.RS 4
.RE
.IP \fBcolor_range\fR 4
.IX Item "color_range"
تنظیم مقدار محدوده رنگ در هدر فریم. توجه داشته باشید که هر مقداری که توسط فضای رنگ تحمیل شود، بر این مقدار تقدم خواهد داشت.
.RS 4
.IP \fBtv\fR 4
.IX Item "tv"
.PD 0
.IP \fBpc\fR 4
.IX Item "pc"
.PD
.RE
.RS 4
.RE
.SS vp9_superframe
.IX Subsection "vp9_superframe"
ادغام مجدد فریم‌های نامرئی (alt\-ref) در سوپرفریم‌های VP9. این کار ادغام استریم‌های تقسیم‌شده/بخش‌بندی‌شده VP9 را که در آن‌ها فریم alt\-ref از همتای مرئی خود جدا شده است، اصلاح می‌کند.
.SS vp9_superframe_split
.IX Subsection "vp9_superframe_split"
تقسیم سوپرفریم‌های VP9 به فریم‌های تکی.
.SS vp9_raw_reorder
.IX Subsection "vp9_raw_reorder"
در صورت داشتن یک استریم VP9 با برچسب‌های زمانی درست اما احتمالاً نامرتب، بسته‌های show\-existing\-frame اضافی را برای اصلاح ترتیب درج می‌کند.
.SH "گزینه‌های فرمت (FORMAT OPTIONS)"
.IX Header "FORMAT OPTIONS"
کتابخانه libavformat برخی گزینه‌های سراسری عمومی را ارائه می‌دهد که می‌توانند روی تمامی میکسرها و دیمکسرها تنظیم شوند. علاوه بر این هر میکسر یا دیمکسر ممکن است از گزینه‌های اصطلاحاً اختصاصی (private options) پشتیبانی کند که مختص آن مؤلفه است.
.PP
گزینه‌ها را می‌توان با مشخص کردن \-\fIoption\fR \fIvalue\fR در ابزارهای FFmpeg، یا با تنظیم صریح مقدار در گزینه‌های \&\f(CW\*(C`AVFormatContext\*(C'\fR یا استفاده از API پرونده \fIlibavutil/opt.h\fR برای استفاده برنامه‌نویسی تنظیم کرد.
.PP
فهرست گزینه‌های پشتیبانی‌شده در ادامه آمده است:
.IP "\fBavioflags\fR \fIflags\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "avioflags flags (input/output)"
مقادیر ممکن:
.RS 4
.IP \fBdirect\fR 4
.IX Item "direct"
کاهش بافرینگ.
.RE
.RS 4
.RE
.IP "\fBprobesize\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "probesize integer (input)"
تنظیم اندازه پروب بر حسب بایت، یعنی اندازه داده‌ای که برای به دست آوردن اطلاعات استریم تجزیه و تحلیل می‌شود. مقدار بالاتر در صورتی که اطلاعات در استریم پراکنده باشد، شناسایی اطلاعات بیشتری را امکان‌پذیر می‌سازد، اما تاخیر را افزایش می‌دهد. باید یک عدد صحیح نه کمتر از ۳۲ باشد. به طور پیش‌فرض 5000000 است.
.IP "\fBmax_probe_packets\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "max_probe_packets integer (input)"
تنظیم حداکثر تعداد بسته‌های بافرشده هنگام پروب یک کدک.
پیش‌فرض 2500 بسته است.
.IP "\fBpacketsize\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "packetsize integer (output)"
تنظیم اندازه بسته.
.IP "\fBfflags\fR \fIflags\fR" 4
.IX Item "fflags flags"
تنظیم پرچم‌های فرمت. برخی از آن‌ها برای تعداد محدودی از فرمت‌ها پیاده‌سازی شده‌اند.
.Sp
مقادیر ممکن برای فایل‌های ورودی:
.RS 4
.IP \fBdiscardcorrupt\fR 4
.IX Item "discardcorrupt"
دور انداختن بسته‌های آسیب‌دیده و خراب.
.IP \fBfastseek\fR 4
.IX Item "fastseek"
فعال‌سازی پرش سریع، اما نادقیق برای برخی فرمت‌ها.
.IP \fBgenpts\fR 4
.IX Item "genpts"
تولید PTSهای گمشده در صورت وجود DTS.
.IP \fBigndts\fR 4
.IX Item "igndts"
نادیده گرفتن DTS در صورتی که PTS نیز تنظیم شده باشد. در صورتی که PTS تنظیم شده باشد، مقدار DTS روی NOPTS تنظیم می‌شود. این مورد در صورت تنظیم پرچم \f(CW\*(C`nofillin\*(C'\fR نادیده گرفته می‌شود.
.IP \fBignidx\fR 4
.IX Item "ignidx"
نادیده گرفتن فهرست اندیس (index).
.IP \fBnobuffer\fR 4
.IX Item "nobuffer"
کاهش تاخیر ناشی از بافرینگ در طول تحلیل اولیه استریم‌های ورودی.
.IP \fBnofillin\fR 4
.IX Item "nofillin"
عدم پر کردن مقادیر گمشده در فیلدهای بسته که می‌توانند دقیقاً محاسبه شوند.
.IP \fBnoparse\fR 4
.IX Item "noparse"
غیرفعال کردن AVParsers، این گزینه به \f(CW\*(C`+nofillin\*(C'\fR نیز نیاز دارد.
.IP \fBsortdts\fR 4
.IX Item "sortdts"
تلاش برای درهم‌بافتن بسته‌های خروجی بر اساس DTS. در حال حاضر، تنها برای فایل‌های AVI دارای اندیس در دسترس است.
.RE
.RS 4
.Sp
مقادیر ممکن برای فایل‌های خروجی:
.IP \fBautobsf\fR 4
.IX Item "autobsf"
اعمال خودکار فیلترهای جریان بیت بر اساس نیاز فرمت خروجی. به طور پیش‌فرض فعال است.
.IP \fBbitexact\fR 4
.IX Item "bitexact"
تنها نوشتن داده‌های مستقل از پلتفرم، بیلد و زمان.
این امر تضمین می‌کند که چکسام فایل و داده‌ها بازتولیدپذیر بوده و میان پلتفرم‌ها مطابقت داشته باشد. کاربرد اصلی آن برای تست‌های رگرسیون است.
.IP \fBflush_packets\fR 4
.IX Item "flush_packets"
نوشتن فوری بسته‌ها در خروجی.
.IP \fBshortest\fR 4
.IX Item "shortest"
توقف میکس در انتهای کوتاه‌ترین استریم.
ممکن است افزایش max_interleave_delta برای جلوگیری از خالی شدن استریم‌های طولانی‌تر پیش از رسیدن به EOF نیاز باشد.
.RE
.RS 4
.RE
.IP "\fBseek2any\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "seek2any integer (input)"
اجازه پرش به فریم‌های غیرکلیدی در سطح دیمکسر در صورت پشتیبانی، با تنظیم روی ۱.
پیش‌فرض 0 است.
.IP "\fBanalyzeduration\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "analyzeduration integer (input)"
مشخص کردن اینکه چند میکروثانیه برای پروب ورودی تجزیه و تحلیل شود. مقدار بالاتر شناسایی اطلاعات دقیق‌تر را ممکن می‌سازد، اما تاخیر را افزایش می‌دهد. پیش‌فرض 5,000,000 میکروثانیه = ۵ ثانیه است.
.IP "\fBcryptokey\fR \fIhexadecimal string\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "cryptokey hexadecimal string (input)"
تنظیم کلید رمزگشایی.
.IP "\fBindexmem\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "indexmem integer (input)"
تنظیم حداکثر حافظه مورد استفاده برای اندیس برچسب زمان (به ازای هر استریم).
.IP "\fBrtbufsize\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "rtbufsize integer (input)"
تنظیم حداکثر حافظه مورد استفاده برای بافر کردن فریم‌های بلادرنگ (real\-time).
.IP "\fBfdebug\fR \fIflags\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "fdebug flags (input/output)"
چاپ اطلاعات خاص اشکال‌زدایی.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBts\fR 4
.IX Item "ts"
چاپ اطلاعات برچسب زمان.
.IP \fBid3v2\fR 4
.IX Item "id3v2"
چاپ داده‌های فریم ID3v2 هنگام دیمکس کردن فایل‌های حاوی تگ‌های ID3v2.
.RE
.RS 4
.RE
.IP "\fBmax_delay\fR \fIinteger\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "max_delay integer (input/output)"
تنظیم حداکثر تاخیر میکس یا دیمکس بر حسب میکروثانیه.
.IP "\fBfpsprobesize\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "fpsprobesize integer (input)"
تنظیم تعداد فریم‌های مورد استفاده برای پروب fps.
.IP "\fBaudio_preload\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "audio_preload integer (output)"
تنظیم میکروثانیه‌هایی که بسته‌های صوتی باید زودتر درهم‌بافته شوند.
.IP "\fBchunk_duration\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "chunk_duration integer (output)"
تنظیم میکروثانیه‌ها برای هر چانک (قطعه).
.IP "\fBchunk_size\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "chunk_size integer (output)"
تنظیم اندازه بر حسب بایت برای هر چانک.
.IP "\fBerr_detect, f_err_detect\fR \fIflags\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "err_detect, f_err_detect flags (input)"
تنظیم پرچم‌های تشخیص خطا. پرچم \f(CW\*(C`f_err_detect\*(C'\fR منسوخ شده است و تنها باید از طریق ابزار \fBffmpeg\fR استفاده شود.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBcrccheck\fR 4
.IX Item "crccheck"
تأیید صحت CRCهای تعبیه‌شده.
.IP \fBbitstream\fR 4
.IX Item "bitstream"
تشخیص انحرافات از مشخصات جریان بیت.
.IP \fBbuffer\fR 4
.IX Item "buffer"
تشخیص طول نامناسب جریان بیت.
.IP \fBexplode\fR 4
.IX Item "explode"
لغو دیکود هنگام تشخیص خطاهای جزئی.
.IP \fBcareful\fR 4
.IX Item "careful"
در نظر گرفتن مواردی که مشخصات استاندارد را نقض می‌کنند و در محیط عملیاتی دیده نشده‌اند به عنوان خطا.
.IP \fBcompliant\fR 4
.IX Item "compliant"
در نظر گرفتن تمامی موارد عدم انطباق با مشخصات استاندارد به عنوان خطا.
.IP \fBaggressive\fR 4
.IX Item "aggressive"
در نظر گرفتن کارهایی که یک اینکودر عاقل نباید انجام دهد به عنوان خطا.
.RE
.RS 4
.RE
.IP "\fBmax_interleave_delta\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "max_interleave_delta integer (output)"
تنظیم حداکثر مدت‌زمان بافرینگ برای درهم‌بافی (interleaving). مدت‌زمان بر حسب میکروثانیه بیان می‌شود و پیش‌فرض آن 10000000 (۱۰ ثانیه) است.
.Sp
برای اطمینان از اینکه تمامی استریم‌ها به درستی درهم‌بافته می‌شوند، libavformat پیش از نوشتن هر بسته‌ای در فایل خروجی، منتظر می‌ماند تا دست‌کم یک بسته برای هر استریم در اختیار داشته باشد. هنگامی که برخی استریم‌ها پراکنده (sparse) باشند (یعنی فاصله‌های بزرگی بین بسته‌های پیاپی وجود داشته باشد)، این امر می‌تواند منجر به بافرینگ بیش از حد شود.
.Sp
این فیلد حداکثر اختلاف میان برچسب‌های زمانی نخستین و آخرین بسته موجود در صف میکس را تعیین می‌کند که بالاتر از آن، libavformat صرف‌نظر از اینکه آیا بسته‌ای برای همه استریم‌ها در صف قرار دارد یا خیر، یک بسته را در خروجی می‌نویسد.
.Sp
اگر روی ۰ تنظیم شود، libavformat صرف‌نظر از حداکثر اختلاف برچسب زمان میان بسته‌های بافرشده، به بافر کردن بسته‌ها تا زمانی که بسته‌ای برای هر استریم داشته باشد ادامه می‌دهد.
.IP "\fBuse_wallclock_as_timestamps\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "use_wallclock_as_timestamps integer (input)"
استفاده از ساعت واقعی سیستم به عنوان برچسب زمان در صورت تنظیم روی ۱. پیش‌فرض 0 است.
.IP "\fBavoid_negative_ts\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "avoid_negative_ts integer (output)"
مقادیر ممکن:
.RS 4
.IP \fBmake_non_negative\fR 4
.IX Item "make_non_negative"
شیفت دادن برچسب‌های زمانی برای غیرمنفی کردن آن‌ها.
همچنین توجه داشته باشید که این گزینه تنها بر برچسب‌های زمانی منفی ابتدایی تأثیر می‌گذارد، و نه برچسب‌های زمانی منفی غیریکنواخت.
.IP \fBmake_zero\fR 4
.IX Item "make_zero"
شیفت دادن برچسب‌های زمانی به گونه‌ای که نخستین برچسب زمان 0 باشد.
.IP "\fBauto (پیش‌فرض)\fR" 4
.IX Item "auto (default)"
فعال‌سازی شیفت در صورت لزوم توسط فرمت مقصد.
.IP \fBdisabled\fR 4
.IX Item "disabled"
غیرفعال کردن شیفت برچسب‌های زمانی.
.RE
.RS 4
.Sp
هنگامی که شیفت فعال باشد، تمامی برچسب‌های زمانی خروجی به یک میزان شیفت داده می‌شوند. ناهماهنگی‌های صوتی، ویدیویی و زیرنویس و اختلاف برچسب‌های زمانی نسبی در مقایسه با وضعیت بدون شیفت حفظ می‌شوند.
.RE
.IP "\fBskip_initial_bytes\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "skip_initial_bytes integer (input)"
تنظیم تعداد بایت‌هایی که پیش از خواندن هدر و فریم‌ها باید نادیده گرفته شوند، در صورت تنظیم روی ۱.
پیش‌فرض 0 است.
.IP "\fBcorrect_ts_overflow\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "correct_ts_overflow integer (input)"
اصلاح سرریزهای تکی برچسب زمان در صورت تنظیم روی ۱. پیش‌فرض 1 است.
.IP "\fBflush_packets\fR \fIinteger\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "flush_packets integer (output)"
تخلیه استریم ورودی/خروجی زیرین پس از هر بسته. پیش‌فرض \-1 (خودکار) است، که یعنی پروتکل زیرین تصمیم می‌گیرد؛ مقدار 1 آن را فعال می‌کند و اثر آن کاهش تاخیر است، مقدار 0 آن را غیرفعال می‌کند و ممکن است توان خروجی I/O را در برخی موارد افزایش دهد.
.IP "\fBoutput_ts_offset\fR \fIoffset\fR \fB(\fR\fIخروجی\fR\fB)\fR" 4
.IX Item "output_ts_offset offset (output)"
تنظیم آفست زمانی خروجی.
.Sp
مقدار \&\fIoffset\fR باید مشخصات مدت‌زمان باشد،
بخش \fBمدت‌زمان در راهنمای ffmpeg\-utils\|(1)\fR را ببینید.
.Sp
آفست توسط میکسر به برچسب‌های زمانی خروجی اضافه می‌شود.
.Sp
مشخص کردن یک آفست مثبت بدان معناست که استریم‌های متناظر به اندازه مدت‌زمان مشخص‌شده در \fIoffset\fR به تاخیر انداخته می‌شوند. مقدار پیش‌فرض \f(CW0\fR است (به این معنی که هیچ آفستی اعمال نمی‌شود).
.IP "\fBformat_whitelist\fR \fIlist\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "format_whitelist list (input)"
فهرستی از دیمکسرهای مجاز که با «,» از هم جدا شده‌اند. به طور پیش‌فرض همه مجاز هستند.
.IP "\fBdump_separator\fR \fIstring\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "dump_separator string (input)"
جداکننده مورد استفاده برای تفکیک فیلدهای چاپ‌شده در خط فرمان پیرامون پارامترهای استریم.
برای نمونه، جهت جداسازی فیلدها با خطوط جدید و تورفتگی:
.Sp
.Vb 2
\&        ffprobe \-dump_separator "
\&                                  "  \-i ~/videos/matrixbench_mpeg2.mpg
.Ve
.IP "\fBmax_streams\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "max_streams integer (input)"
حداکثر تعداد استریم‌ها را مشخص می‌کند. این می‌تواند برای رد کردن فایل‌هایی که به دلیل تعداد زیاد استریم‌ها به منابع بسیار زیادی نیاز دارند، استفاده شود.
.IP "\fBskip_estimate_duration_from_pts\fR \fIbool\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "skip_estimate_duration_from_pts bool (input)"
صرف‌نظر از تخمین مدت‌زمان ورودی در صورتی که نیازمند پروب اضافی برای PTS در انتهای فایل باشد.
در حال حاضر برای MPEG\-PS و MPEG\-TS کاربرد دارد.
.IP "\fBduration_probesize\fR \fIinteger\fR \fB(\fR\fIورودی\fR\fB)\fR" 4
.IX Item "duration_probesize integer (input)"
تنظیم اندازه پروب، بر حسب بایت، برای تخمین مدت‌زمان ورودی هنگامی که در عمل نیازمند پروب اضافی برای PTS در انتهای فایل است (در حال حاضر: MPEG\-PS و MPEG\-TS).
این گزینه برای کاربرانی در نظر گرفته شده است که مایل به پروب بهتر مدت‌زمان برای خود فایل، یا به صورت غیرمستقیم مثلاً به دلیل استفاده از دیمکسر concat هستند.
مورد کاربرد معمول یک MPEG\-TS CBR با بیت‌ریت بالا، بافرینگ ویدیویی بالا و پایان تمیز با PTS مشابه برای ویدیو و صوت است: در چنین سناریویی، شکاف فیزیکی بزرگ میان آخرین بسته ویدیویی و آخرین بسته صوتی، خواندن بایت‌های زیادی را برای به دست آوردن مدت‌زمان استریم ویدیو ضروری می‌سازد.
مورد کاربرد دیگر جایی است که رفتار پروب پیش‌فرض تنها به یک فریم ویدیویی تکی می‌رسد که به دلیل مرتب‌سازی مجدد فریم‌ها آخرین فریم استریم نیست، بنابراین مدت‌زمان دقیق نمی‌باشد.
تنظیم این گزینه حتی برای فایل‌های کوچک تأثیر عملکردی دارد زیرا اندازه پروب ثابت است.
رفتار پیش‌فرض یک موازنه چندمنظوره و تا حد زیادی تطبیقی است، اما اندازه پروب برای به دست آوردن مدت‌زمان استریم به هر قیمتی افزایش نخواهد یافت.
باید یک عدد صحیح نه کمتر از ۱، یا ۰ برای رفتار پیش‌فرض باشد.
.IP "\fBstrict, f_strict\fR \fIinteger\fR \fB(\fR\fIورودی/خروجی\fR\fB)\fR" 4
.IX Item "strict, f_strict integer (input/output)"
مشخص می‌کند که استانداردها با چه شدتی رعایت شوند. گزینه \f(CW\*(C`f_strict\*(C'\fR منسوخ شده است و تنها باید از طریق ابزار \fBffmpeg\fR استفاده شود.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBvery\fR 4
.IX Item "very"
انطباق دقیق با نسخه‌ای قدیمی‌تر و سخت‌گیرانه‌تر از مشخصات یا نرم‌افزار مرجع.
.IP \fBstrict\fR 4
.IX Item "strict"
انطباق دقیق با تمامی موارد موجود در مشخصات صرف‌نظر از هر پیامدی.
.IP \fBnormal\fR 4
.IX Item "normal"
.PD 0
.IP \fBunofficial\fR 4
.IX Item "unofficial"
.PD
اجازه استفاده از پسوندهای غیررسمی.
.IP \fBexperimental\fR 4
.IX Item "experimental"
اجازه استفاده از موارد تجربی غیراستاندارد، دیکودرها و اینکودرهای تجربی (ناتمام/در حال توسعه/به خوبی تست‌نشده).
نکته: دیکودرهای تجربی می‌توانند خطر امنیتی ایجاد کنند، از این گزینه برای دیکود ورودی‌های نامطمئن استفاده نکنید.
.RE
.RS 4
.RE
.SS "مشخص‌کننده‌های استریم فرمت (Format stream specifiers)"
.IX Subsection "Format stream specifiers"
مشخص‌کننده‌های استریم فرمت امکان انتخاب یک یا چند استریم را که با ویژگی‌های خاصی مطابقت دارند، فراهم می‌کنند.
.PP
معناشناسی دقیق مشخص‌کننده‌های استریم توسط تابع \&\f(CWavformat_match_stream_specifier()\fR تعریف شده است که در هدر \&\fIlibavformat/avformat.h\fR اعلان گردیده و در بخش \&\fBمشخص‌کننده‌های استریم در راهنمای ffmpeg\|(1)\fR مستند شده است.
.SH "دیمکسرها (DEMUXERS)"
.IX Header "DEMUXERS"
دیمکسرها عناصر پیکربندی‌شده‌ای در FFmpeg هستند که می‌توانند استریم‌های چندرسانه‌ای را از نوع خاصی از فایل بخوانند.
.PP
هنگامی که بیلد FFmpeg خود را پیکربندی می‌کنید، تمامی دیمکسرهای پشتیبانی‌شده به طور پیش‌فرض فعال هستند. می‌توانید با استفاده از گزینه پیکربندی \f(CW\*(C`\-\-list\-demuxers\*(C'\fR فهرستی از تمامی موارد در دسترس را مشاهده کنید.
.PP
می‌توانید تمام دیمکسرها را با استفاده از گزینه پیکربندی \&\f(CW\*(C`\-\-disable\-demuxers\*(C'\fR غیرفعال کنید، و یک دیمکسر منفرد را با گزینه \f(CW\*(C`\-\-enable\-demuxer=\fR\f(CIDEMUXER\fR\f(CW\*(C'\fR به صورت گزینشی فعال نمایید، یا با گزینه \f(CW\*(C`\-\-disable\-demuxer=\fR\f(CIDEMUXER\fR\f(CW\*(C'\fR آن را غیرفعال کنید.
.PP
گزینه \f(CW\*(C`\-demuxers\*(C'\fR در ابزارهای ff* فهرستی از دیمکسرهای فعال را نمایش می‌دهد. از \f(CW\*(C`\-formats\*(C'\fR برای مشاهده فهرست ترکیبی دیمکسرها و میکسرهای فعال استفاده کنید.
.PP
شرح برخی از دیمکسرهای فعلی در دسترس در ادامه آمده است.
.SS aa
.IX Subsection "aa"
دیمکسر فرمت‌های ۲، ۳ و ۴ شرکت Audible.
.PP
این دیمکسر برای دیمکس کردن فایل‌های Audible Format 2, 3, and 4 (.aa) استفاده می‌شود.
.SS aac
.IX Subsection "aac"
دیمکسر جریان انتقال داده‌های صوتی خام (ADTS) از نوع AAC.
.PP
این دیمکسر برای دیمکس کردن یک ورودی ADTS حاوی یک استریم AAC منفرد به همراه هرگونه تگ ID3v1/2 یا APE در آن استفاده می‌شود.
.SS apng
.IX Subsection "apng"
دیمکسر گرافیک شبکه متحرک و قابل حمل (APNG).
.PP
این دیمکسر برای دیمکس کردن فایل‌های APNG استفاده می‌شود.
تمامی هدرها، به جز امضای PNG، تا (اما نه شامل) نخستین چانک fcTL به عنوان extradata ارسال می‌شوند.
سپس فریم‌ها به صورت تمامی چانک‌های میان دو چانک fcTL، یا میان آخرین چانک fcTL و چانک‌های IEND تقسیم می‌شوند.
.IP "\fB\-ignore_loop\fR \fIbool\fR" 4
.IX Item "-ignore_loop bool"
نادیده گرفتن متغیر حلقه در فایل در صورت تنظیم. پیش‌فرض فعال است.
.IP "\fB\-max_fps\fR \fIint\fR" 4
.IX Item "-max_fps int"
حداکثر نرخ فریم بر حسب فریم بر ثانیه. مقدار پیش‌فرض 0 هیچ محدودیتی اعمال نمی‌کند.
.IP "\fB\-default_fps\fR \fIint\fR" 4
.IX Item "-default_fps int"
نرخ فریم پیش‌فرض بر حسب فریم بر ثانیه در زمانی که هیچ مقداری در فایل مشخص نشده باشد (0 به معنای با حداکثر سرعت ممکن است). پیش‌فرض 15 است.
.SS asf
.IX Subsection "asf"
دیمکسر فرمت پیشرفته سیستم‌ها (Advanced Systems Format).
.PP
این دیمکسر برای دیمکس کردن فایل‌های ASF و استریم‌های تحت شبکه MMS استفاده می‌شود.
.IP "\fB\-no_resync_search\fR \fIbool\fR" 4
.IX Item "-no_resync_search bool"
عدم تلاش برای همگام‌سازی مجدد از طریق جستجوی یک کد شروع اختیاری مشخص.
.SS concat
.IX Subsection "concat"
دیمکسر اسکریپت الحاق مجازی (Virtual concatenation).
.PP
این دیمکسر فهرستی از فایل‌ها و سایر دستورالعمل‌ها را از یک فایل متنی خوانده و آن‌ها را یکی پس از دیگری دیمکس می‌کند، درست گویی تمام بسته‌های آن‌ها با هم میکس شده‌اند.
.PP
برچسب‌های زمانی در فایل‌ها به گونه‌ای تنظیم می‌شوند که نخستین فایل از ۰ شروع شود و هر فایل بعدی از جایی که فایل قبلی به پایان رسیده است آغاز گردد. توجه داشته باشید که این کار به صورت سراسری انجام می‌شود و اگر همه استریم‌ها دقیقاً طول یکسانی نداشته باشند ممکن است باعث ایجاد شکاف شود.
.PP
تمامی فایل‌ها باید استریم‌های یکسانی داشته باشند (کدک‌های یکسان، مبنای زمان یکسان و غیره).
.PP
مدت‌زمان هر فایل برای تنظیم برچسب‌های زمانی فایل بعدی استفاده می‌شود: اگر مدت‌زمان نادرست باشد (مثلاً به این دلیل که با استفاده از نرخ بیت محاسبه شده است یا فایل ناقص است)، می‌تواند باعث ایجاد آرتیفکت شود. دستورالعمل \&\f(CW\*(C`duration\*(C'\fR می‌تواند برای بازنویسی مدت‌زمان ذخیره‌شده در هر فایل استفاده شود.
.PP
\fIساختار دستور (Syntax)\fR
.IX Subsection "Syntax"
.PP
اسکریپت یک فایل متنی در استاندارد extended\-ASCII است، با یک دستورالعمل در هر خط. خطوط خالی، فاصله‌های ابتدایی و خطوطی که با \*(Aq#\*(Aq شروع می‌شوند نادیده گرفته می‌شوند. دستورالعمل‌های زیر شناخته می‌شوند:
.ie n .IP "\fR\fB""file path""\fR\fB\fR" 4
.el .IP "\fR\f(CBfile path\fR\fB\fR" 4
.IX Item "file path"
مسیر فایلی که باید خوانده شود؛ نویسه‌های ویژه و فاصله‌ها باید با بک‌اسلش یا نقل‌قول تکی گریز (escape) داده شوند.
.Sp
تمامی دستورالعمل‌های بعدی مربوط به فایل برای آن فایل اعمال می‌شوند.
.ie n .IP "\fR\fB""ffconcat version 1.0""\fR\fB\fR" 4
.el .IP "\fR\f(CBffconcat version 1.0\fR\fB\fR" 4
.IX Item "ffconcat version 1.0"
شناسایی نوع و نسخه اسکریپت.
.Sp
برای اینکه FFmpeg فرمت را به طور خودکار تشخیص دهد، این دستورالعمل باید دقیقاً همان‌گونه که هست (بدون فاصله اضافی یا علامت ترتیب بایت BOM) در نخستین خط اسکریپت قرار گیرد.
.ie n .IP "\fR\fB""duration dur""\fR\fB\fR" 4
.el .IP "\fR\f(CBduration dur\fR\fB\fR" 4
.IX Item "duration dur"
مدت‌زمان فایل. این اطلاعات می‌تواند از فایل مشخص شود؛ مشخص کردن آن در اینجا ممکن است کارآمدتر باشد یا در صورتی که اطلاعات فایل در دسترس یا دقیق نباشد کمک کند.
.Sp
اگر مدت‌زمان برای همه فایل‌ها تنظیم شده باشد، پرش (seek) در کل ویدیوی الحاق‌شده امکان‌پذیر است.
.ie n .IP "\fR\fB""inpoint timestamp""\fR\fB\fR" 4
.el .IP "\fR\f(CBinpoint timestamp\fR\fB\fR" 4
.IX Item "inpoint timestamp"
نقطه ورود فایل. هنگامی که دیمکسر فایل را باز می‌کند، بلافاصله به برچسب زمان مشخص‌شده پرش می‌کند. پرش به گونه‌ای انجام می‌شود که تمامی استریم‌ها بتوانند در نقطه ورود با موفقیت ارائه شوند.
.Sp
این دستورالعمل برای کدک‌های فریم درون‌تصویری (intra frame) بهتر کار می‌کند، زیرا برای کدک‌های غیر درون‌تصویری معمولاً بسته‌های اضافی قبل از نقطه ورود واقعی دریافت خواهید کرد و محتوای دیکودشده به احتمال زیاد شامل فریم‌های قبل از نقطه ورود نیز خواهد بود.
.Sp
برای هر فایل، بسته‌های قبل از نقطه ورود فایل برچسب‌های زمانی کمتری نسبت به برچسب زمان شروع محاسبه‌شده فایل خواهند داشت (در مورد نخستین فایل منفی)، و مدت‌زمان فایل‌ها (در صورت مشخص نشدن توسط دستورالعمل \f(CW\*(C`duration\*(C'\fR) بر اساس نقطه ورود مشخص‌شده آن‌ها کاهش می‌یابد.
.Sp
به دلیل وجود بسته‌های احتمالی قبل از نقطه ورود مشخص‌شده، برچسب‌های زمانی بسته ممکن است میان دو فایل الحاق‌شده هم‌پوشانی داشته باشند.
.ie n .IP "\fR\fB""outpoint timestamp""\fR\fB\fR" 4
.el .IP "\fR\f(CBoutpoint timestamp\fR\fB\fR" 4
.IX Item "outpoint timestamp"
نقطه خروج فایل. هنگامی که دیمکسر به برچسب زمان دیکود مشخص‌شده در هر یک از استریم‌ها می‌رسد، آن را به عنوان شرایط پایان فایل مدیریت کرده و بسته فعلی و تمام بسته‌های باقی‌مانده از همه استریم‌ها را نادیده می‌گیرد.
.Sp
نقطه خروج مانعه‌الجمع است (exclusive)، به این معنی که دیمکسر بسته‌هایی با برچسب زمان دیکود بزرگ‌تر یا مساوی نقطه خروج را خروجی نمی‌دهد.
.Sp
این دستورالعمل برای کدک‌های intra frame و فرمت‌هایی که تمام استریم‌ها در آن‌ها به طور فشرده درهم‌بافته شده‌اند، بهتر کار می‌کند. برای کدک‌های غیر درون‌تصویری معمولاً بسته‌های اضافی با برچسب زمان ارائه پس از نقطه خروج دریافت خواهید کرد، بنابراین محتوای دیکودشده به احتمال زیاد شامل فریم‌های پس از نقطه خروج نیز خواهد بود. اگر استریم‌های شما به طور فشرده درهم‌بافته نشده باشند، ممکن است قبل از نقطه خروج همه بسته‌ها را از همه استریم‌ها دریافت نکنید و تنها قادر به دیکود کردن زودترین استریم تا نقطه خروج باشید.
.Sp
مدت‌زمان فایل‌ها (در صورت مشخص نشدن توسط دستورالعمل \f(CW\*(C`duration\*(C'\fR) بر اساس نقطه خروج مشخص‌شده آن‌ها کاهش خواهد یافت.
.ie n .IP "\fR\fB""file_packet_metadata key=value""\fR\fB\fR" 4
.el .IP "\fR\f(CBfile_packet_metadata key=value\fR\fB\fR" 4
.IX Item "file_packet_metadata key=value"
متادیتای بسته‌های فایل. متادیتای مشخص‌شده برای هر بسته فایل تنظیم خواهد شد. می‌توانید این دستورالعمل را چند بار برای افزودن چندین مدخل متادیتا مشخص کنید.
این دستورالعمل منسوخ شده است، به جای آن از \f(CW\*(C`file_packet_meta\*(C'\fR استفاده کنید.
.ie n .IP "\fR\fB""file_packet_meta key value""\fR\fB\fR" 4
.el .IP "\fR\f(CBfile_packet_meta key value\fR\fB\fR" 4
.IX Item "file_packet_meta key value"
متادیتای بسته‌های فایل. متادیتای مشخص‌شده برای هر بسته فایل تنظیم خواهد شد. می‌توانید این دستورالعمل را چند بار برای افزودن چندین مدخل متادیتا مشخص کنید.
.ie n .IP "\fR\fB""option key value""\fR\fB\fR" 4
.el .IP "\fR\f(CBoption key value\fR\fB\fR" 4
.IX Item "option key value"
گزینه‌ای برای دسترسی، باز کردن و پروب فایل.
می‌تواند چندین بار وجود داشته باشد.
.ie n .IP "\fR\fB""stream""\fR\fB\fR" 4
.el .IP \fR\f(CBstream\fR\fB\fR 4
.IX Item "stream"
معرفی یک استریم در فایل مجازی.
تمامی دستورالعمل‌های بعدی مربوط به استریم، روی آخرین استریم معرفی‌شده اعمال می‌شوند.
برخی ویژگی‌های استریم‌ها باید تنظیم شوند تا شناسایی استریم‌های منطبق در زیرفایل‌ها امکان‌پذیر باشد.
اگر هیچ استریمی در اسکریپت تعریف نشده باشد، استریم‌ها از نخستین فایل کپی می‌شوند.
.ie n .IP "\fR\fB""exact_stream_id id""\fR\fB\fR" 4
.el .IP "\fR\f(CBexact_stream_id id\fR\fB\fR" 4
.IX Item "exact_stream_id id"
تنظیم شناسه (id) استریم.
اگر این دستورالعمل داده شود، رشته با شناسه متناظر در زیرفایل‌ها استفاده خواهد شد.
این به ویژه برای فایل‌های MPEG\-PS (VOB) مفید است، جایی که ترتیب استریم‌ها قابل اعتماد نیست.
.ie n .IP "\fR\fB""stream_meta key value""\fR\fB\fR" 4
.el .IP "\fR\f(CBstream_meta key value\fR\fB\fR" 4
.IX Item "stream_meta key value"
متادیتا برای استریم.
می‌تواند چندین بار وجود داشته باشد.
.ie n .IP "\fR\fB""stream_codec value""\fR\fB\fR" 4
.el .IP "\fR\f(CBstream_codec value\fR\fB\fR" 4
.IX Item "stream_codec value"
کدک برای استریم.
.ie n .IP "\fR\fB""stream_extradata hex_string""\fR\fB\fR" 4
.el .IP "\fR\f(CBstream_extradata hex_string\fR\fB\fR" 4
.IX Item "stream_extradata hex_string"
اطلاعات اضافی (extradata) برای رشته، کدگذاری‌شده به صورت هگزادسیمال.
.ie n .IP "\fR\fB""chapter id start end""\fR\fB\fR" 4
.el .IP "\fR\f(CBchapter id start end\fR\fB\fR" 4
.IX Item "chapter id start end"
افزودن یک فصل (chapter). مقدار \fIid\fR یک شناسه منحصر‌به‌فرد، احتمالاً کوچک و متوالی است.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBsafe\fR 4
.IX Item "safe"
اگر روی ۱ تنظیم شود، مسیرهای فایل و دستورالعمل‌های ناامن را رد می‌کند.
یک مسیر فایل زمانی امن در نظر گرفته می‌شود که شامل مشخصات پروتکل نباشد، نسبی باشد و تمام اجزای آن تنها شامل نویسه‌هایی از مجموعه نویسه‌های قابل حمل (حروف، ارقام، نقطه، زیرخط و خط تیره) باشند و در ابتدای هیچ جزئی نقطه وجود نداشته باشد.
.Sp
اگر روی ۰ تنظیم شود، هر نام فایلی پذیرفته می‌شود.
.Sp
پیش‌فرض 1 است.
.IP \fBauto_convert\fR 4
.IX Item "auto_convert"
اگر روی ۱ تنظیم شود، تلاش می‌کند تبدیلات خودکار را روی داده‌های بسته انجام دهد تا استریم‌ها قابل الحاق شوند.
پیش‌فرض 1 است.
.Sp
در حال حاضر، تنها تبدیل موجود افزودن فیلتر جریان بیت h264_mp4toannexb به استریم‌های H.264 در فرمت MP4 است. این امر به ویژه در صورت وجود تغییرات رزولوشن ضروری است.
.IP \fBsegment_time_metadata\fR 4
.IX Item "segment_time_metadata"
اگر روی ۱ تنظیم شود، هر بسته شامل مقادیر متادیتای بسته \fIlavf.concat.start_time\fR و \&\fIlavf.concat.duration\fR خواهد بود که زمان شروع و مدت‌زمان بخش‌های فایل مربوطه در خروجی الحاق‌شده بر حسب میکروثانیه هستند. متادیتای مدت‌زمان تنها در صورتی تنظیم می‌شود که بر اساس فایل concat شناخته شده باشد.
پیش‌فرض 0 است.
.PP
\fIنمونه‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از نام‌های فایل مطلق و گنجاندن چند توضیح:
.Sp
.Vb 6
\&        # my first filename
\&        file /mnt/share/file\-1.wav
\&        # my second filename including whitespace
\&        file \*(Aq/mnt/share/file 2.wav\*(Aq
\&        # my third filename including whitespace plus single quote
\&        file \*(Aq/mnt/share/file 3\*(Aq\e\*(Aq\*(Aq.wav\*(Aq
.Ve
.IP \(bu 4
امکان پروب خودکار فرمت ورودی، استفاده از نام‌های فایل امن و تنظیم مدت‌زمان نخستین فایل:
.Sp
.Vb 1
\&        ffconcat version 1.0
\&        
\&        file file\-1.wav
\&        duration 20.0
\&        
\&        file subdir/file\-2.wav
.Ve
.SS dash
.IX Subsection "dash"
دیمکسر پخش تطبیقی پویا روی پروتکل HTTP (DASH).
.PP
این دیمکسر تمامی AVStreamهای موجود در مانیفست را ارائه می‌دهد.
با تنظیم پرچم‌های دور انداختن روی AVStreamها، فراخواننده می‌تواند تصمیم بگیرد که در عمل کدام استریم‌ها را دریافت کند.
هر استریم ویژگی‌های \f(CW\*(C`id\*(C'\fR و \f(CW\*(C`bandwidth\*(C'\fR را از \&\f(CW\*(C`<Representation>\*(C'\fR به عنوان کلیدهای متادیتا به ترتیب با نام‌های "id" و "variant_bitrate" منعکس می‌کند.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBcenc_decryption_key\fR 4
.IX Item "cenc_decryption_key"
کلید پیش‌فرض ۱۶ بایتی، در قالب هگزادسیمال، برای رمزگشایی فایل‌های رمزگذاری‌شده با رمزنگاری مشترک ISO موسوم به (CENC/AES\-128 CTR; ISO/IEC 23001\-7).
.IP \fBcenc_decryption_keys\fR 4
.IX Item "cenc_decryption_keys"
دیکشنری از شناسه کلید ۱۶ بایتی => کلید ۱۶ بایتی، هر دو در قالب هگزادسیمال، برای رمزگشایی فایل‌های رمزگذاری‌شده با رمزنگاری مشترک ISO موسوم به (CENC/AES\-128 CTR; ISO/IEC 23001\-7).
.SS dvdvideo
.IX Subsection "dvdvideo"
دیمکسر DVD\-Video، مبتنی بر libdvdnav و libdvdread.
.PP
می‌تواند عناوین DVD، به ویژه PGCهای متوالی را مستقیماً وارد یک خط‌لوله تبدیل کند. دارایی‌های منو مانند ویدیوی پس‌زمینه یا صوت نیز می‌توانند با داشتن مختصات منو (با بهترین تلاش ممکن) دیمکس شوند.
.PP
دستگاه‌های بلوکی (درایوهای DVD)، فایل‌های ISO و ساختارهای دایرکتوری پذیرفته می‌شوند. با قرار دادن \f(CW\*(C`\-f dvdvideo\*(C'\fR در برابر یکی از این ورودی‌ها فعال می‌شود.
.PP
این دیمکسر فاقد هرگونه کد رمزگشایی حفاظتی است. کار با DVDهای رمزگذاری‌شده بر عهده خود شماست و نباید انتظار پشتیبانی در این زمینه داشته باشید.
.PP
پخش زیرین توسط libdvdnav و تجزیه ساختار توسط libdvdread انجام می‌شود. FFmpeg باید با پشتیبانی کتابخانه تحت مجوز GPL و همچنین سوییچ‌های پیکربندی \f(CW\*(C`\-\-enable\-libdvdnav\*(C'\fR و \f(CW\*(C`\-\-enable\-libdvdread\*(C'\fR ساخته شود.
.PP
شما باید «شماره عنوان» دلخواه یا مختصات دقیق PGC/PG را ارائه دهید. بسیاری از پخش‌کننده‌ها و ابزارهای منبع‌باز DVD می‌توانند در ارائه این اطلاعات کمک کنند. در صورت عدم تعیین، دیمکسر به طور پیش‌فرض روی عنوان ۱ تنظیم می‌شود که برای بسیاری از دیسک‌ها کار می‌کند. با این حال، به دلیل انعطاف‌پذیری فرمت، توصیه می‌شود به صورت دستی بررسی شود. دیسک‌های بسیاری وجود دارند که به شکل عجیبی ساخته شده‌اند یا دارای هدرهای نامعتبر هستند.
.PP
اگر ورودی یک درایو واقعی DVD است، لطفاً توجه داشته باشید درایوهایی وجود دارند که ممکن است هنگام خواندن بخش‌های آسیب‌دیده دیسک بدون اعلام خطا، بیت‌های تصادفی بازگردانند که عملاً داده خراب محسوب می‌شود. این موضوع به ویژه در دیسک‌های قدیمی یا خراب‌شده برجسته است. برای تشخیص خرابی به یک گذر دوم و بررسی‌های صحت نیاز است. این مشکل مربوط به FFmpeg نیست.
.PP
\fIپیش‌زمینه (Background)\fR
.IX Subsection "Background"
.PP
قالب DVD\-Video یک فرمت کانتینری مستقیماً قابل دسترسی و خطی به معنای سنتی نیست. در عوض، امکان پخش پیچیده و برنامه‌ریزی‌شده استریم‌های دقیقاً میکس‌شده MPEG\-PS را که در فایل‌های VOB بدون هدر ذخیره شده‌اند، فراهم می‌کند. برای کاربر نهایی، این استریم‌ها به سادگی به عنوان «عنوان‌ها» (titles) شناخته می‌شوند، اما توالی پخش منطقی واقعی توسط یک یا چند «PGC» یا زنجیره‌های گروه برنامه در داخل عنوان تعریف می‌شود. PGC به نوبه خود از چندین «PG» یا برنامه تشکیل شده است که بخش‌های واقعی ویدیو هستند (و برای یک فیلم معمول، به صورت متوالی مرتب شده‌اند). ساختار PGC، همراه با طرح استریم و متادیتا، در فایل‌های IFO ذخیره می‌شوند که باید تجزیه شوند. PGCها را می‌توان با عبارات ساده‌تر به عنوان لیست‌های پخش در نظر گرفت.
.PP
یک پخش‌کننده واقعی DVD برای هدایت مسیر دیمکس کردن، به تعامل رابط کاربری کاربر از طریق منوها و یک ماشین مجازی (VM) داخلی متکی است. به طور کلی، کاربر یا پیمایش می‌کند (از طریق منوها) یا به طور خودکار به PGC انتخابی خود هدایت می‌شود. در طول این فرآیند و پخش پس از آن، ماشین مجازی داخلی پخش‌کننده DVD نیز وضعیتی را حفظ کرده و دستورالعمل‌هایی را اجرا می‌کند که می‌توانند پرش‌هایی به سکتورهای مختلف در حین پخش ایجاد کنند. به همین دلیل است که libdvdnav درگیر است، زیرا خواندن خطی داده‌های MPEG\-PS روی دیسک (فایل‌های VOB) در بسیاری از موارد برای تولید توالی درست کافی نیست.
.PP
ساختارهای فراوان دیگری در DVD وجود دارد (موضوعی طولانی) که در اینجا به آن‌ها پرداخته نمی‌شود. به ویژه بسته‌های NAV توسط این دیمکسر برای ایجاد زمان‌بندی دقیق مدیریت می‌شوند اما به عنوان یک استریم صادر نمی‌گردند. برای یک درک کلی و سطح بالا به پیوند زیر مراجعه کنید:
<\fBhttps://code.videolan.org/videolan/libdvdnav/\-/blob/master/doc/dvd_structures\fR>
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP "\fBtitle\fR \fIint\fR" 4
.IX Item "title int"
شماره عنوان برای پخش. در صورت عدم تنظیم \fBpgc\fR و \fBpg\fR باید تنظیم شود. برای منوها کاربرد ندارد.
پیش‌فرض 0 (خودکار) است که در حال حاضر تنها نخستین عنوان موجود (عنوان ۱) را انتخاب کرده و پیامدهای آن را به کاربر اطلاع می‌دهد.
.IP "\fBchapter_start\fR \fIint\fR" 4
.IX Item "chapter_start int"
شماره فصل، یا PTT (بخش عنوان)، برای شروع. برای منوها کاربرد ندارد.
پیش‌فرض 1 است.
.IP "\fBchapter_end\fR \fIint\fR" 4
.IX Item "chapter_end int"
شماره فصل، یا PTT، برای پایان. برای منوها کاربرد ندارد.
پیش‌فرض 0 است، که یک مقدار ویژه برای علامت‌گذاری پایان در آخرین فصل ممکن است.
.IP "\fBangle\fR \fIint\fR" 4
.IX Item "angle int"
شماره زاویه ویدیو، که اشاره به یک استریم ویدیوی اساساً اضافی دارد که از فریم‌های جایگزین درهم‌بافته در VOBها تشکیل شده است. برای منوها کاربرد ندارد.
پیش‌فرض 1 است.
.IP "\fBregion\fR \fIint\fR" 4
.IX Item "region int"
کد منطقه برای استفاده در پخش. برخی دیسک‌ها ممکن است از این برای پخش پیش‌فرض در یک زاویه خاص در مناطق مختلف استفاده کنند. این گزینه در صورت استفاده به عنوان ورودی، بر کد منطقه درایو واقعی DVD تأثیر نمی‌گذارد. برای منوها کاربرد ندارد.
پیش‌فرض 0، "world" (جهانی) است.
.IP "\fBmenu\fR \fIbool\fR" 4
.IX Item "menu bool"
دیمکس کردن دارایی‌های منو به جای پیمایش یک عنوان. نیازمند مختصات دقیق منو است (\fBmenu_lu\fR، \fBmenu_vts\fR، \fBpgc\fR، \fBpg\fR).
پیش‌فرض false است.
.IP "\fBmenu_lu\fR \fIint\fR" 4
.IX Item "menu_lu int"
زبان منو برای دیمکس. در DVD، منوها بر اساس زبان گروه‌بندی می‌شوند.
پیش‌فرض 1، نخستین واحد زبان است.
.IP "\fBmenu_vts\fR \fIint\fR" 4
.IX Item "menu_vts int"
بخش VTS که منو در آن قرار دارد، یا ۰ در صورتی که یک منوی VMG (سطح ریشه) باشد.
پیش‌فرض 1، منوی نخستین VTS است.
.IP "\fBpgc\fR \fIint\fR" 4
.IX Item "pgc int"
واحد PGC ورودی برای شروع پخش، همراه با \fBpg\fR.
جایگزینی برای تنظیم \fBtitle\fR.
نشانگرهای فصل در حال حاضر پشتیبانی نمی‌شوند.
باید برای منوها صراحتاً تنظیم شود.
پیش‌فرض 0 است که به طور خودکار از مقدار \fBtitle\fR حل می‌شود.
.IP "\fBpg\fR \fIint\fR" 4
.IX Item "pg int"
واحد PG ورودی برای شروع پخش، همراه با \fBpgc\fR.
جایگزینی برای تنظیم \fBtitle\fR.
نشانگرهای فصل در حال حاضر پشتیبانی نمی‌شوند.
پیش‌فرض 1، نخستین PG از PGC است.
.IP "\fBpreindex\fR \fIbool\fR" 4
.IX Item "preindex bool"
فعال‌سازی این گزینه برای داشتن نشانگرهای دقیق فصل (PTT) و اندازه‌گیری دقیق مدت‌زمان است، که نیازمند خواندن آهسته در گذر دوم به منظور اندیس‌گذاری برچسب‌های زمانی نشانگر فصل از بسته‌های NAV است. این یک کار اضافی غیر ایده‌آل برای درایوهای نوری واقعی است. استفاده از این گزینه به همراه نسخه پشتیبان ساختار DVD ذخیره‌شده روی هارد دیسک توصیه می‌شود و سریع‌تر است. با \fBpgc\fR و \fBpg\fR سازگار نیست.
پیش‌فرض 0، false است.
.IP "\fBtrim\fR \fIbool\fR" 4
.IX Item "trim bool"
صرف‌نظر از سلول‌های پدینگ (یعنی سلول‌های کوتاه‌تر از ۱ ثانیه) از ابتدا. دیسک‌های زیادی با بخش‌های پرکننده در ابتدای PGC وجود دارند، که اغلب حاوی داده‌های آشغال هستند و با هدف کنترل سرعت بافرینگ پخش‌کننده واقعی DVD طراحی شده‌اند و هیچ ارزش داده‌ای دیگری ندارند.
برای منوها کاربرد ندارد.
پیش‌فرض 1، true است.
.PP
\fIنمونه‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
باز کردن عنوان ۳ از یک ساختار DVD مشخص:
.Sp
.Vb 1
\&        ffmpeg \-f dvdvideo \-title 3 \-i <path to DVD> ...
.Ve
.IP \(bu 4
باز کردن فصل‌های ۳ تا ۶ از عنوان ۱ از یک ساختار DVD مشخص:
.Sp
.Vb 1
\&        ffmpeg \-f dvdvideo \-chapter_start 3 \-chapter_end 6 \-title 1 \-i <path to DVD> ...
.Ve
.IP \(bu 4
تنها باز کردن فصل ۵ از عنوان ۱ از یک ساختار DVD مشخص:
.Sp
.Vb 1
\&        ffmpeg \-f dvdvideo \-chapter_start 5 \-chapter_end 5 \-title 1 \-i <path to DVD> ...
.Ve
.IP \(bu 4
دیمکس کردن منو با زبان ۱ از VTS 1، PGC 1، شروع از PG 1:
.Sp
.Vb 1
\&        ffmpeg \-f dvdvideo \-menu 1 \-menu_lu 1 \-menu_vts 1 \-pgc 1 \-pg 1 \-i <path to DVD> ...
.Ve
.SS ea
.IX Subsection "ea"
دیمکسر فرمت چندرسانه‌ای Electronic Arts.
.PP
این فرمت توسط بازی‌های مختلف شرکت Electronic Arts استفاده می‌شود.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP "\fBmerge_alpha\fR \fIbool\fR" 4
.IX Item "merge_alpha bool"
معمولاً کانال آلفای VP6 (در صورت وجود) به عنوان استریم ویدیوی ثانویه بازگردانده می‌شود؛ با تنظیم این گزینه می‌توانید دیمکسر را وادار کنید که یک استریم ویدیوی منفرد بازگرداند که علاوه بر ویدیوی معمولی، کانال آلفا را نیز شامل می‌شود.
.SS imf
.IX Subsection "imf"
دیمکسر فرمت مستر با قابلیت تعامل (Interoperable Master Format).
.PP
این دیمکسر استریم‌های صوتی و ویدیویی موجود در یک IMF Composition را طبق مشخصات <\fBhttps://doi.org/10.5594/SMPTE.ST2067\-2.2020\fR> ارائه می‌دهد.
.PP
.Vb 1
\&        ffmpeg [\-assetmaps <path of ASSETMAP1>,<path of ASSETMAP2>,...] \-i <path of CPL> ...
.Ve
.PP
اگر \f(CW\*(C`\-assetmaps\*(C'\fR مشخص نشده باشد، دیمکسر به دنبال فایلی به نام \&\fIASSETMAP.xml\fR در همان دایرکتوری فایل CPL می‌گردد.
.SS "flv, live_flv, kux"
.IX Subsection "flv, live_flv, kux"
دیمکسر فرمت ویدیوی ادوبی فلش (Adobe Flash Video).
.PP
این دیمکسر برای دیمکس کردن فایل‌های FLV و استریم‌های شبکه RTMP استفاده می‌شود. در مورد استریم‌های زنده شبکه، اگر فرمت را اجبار می‌کنید، می‌توانید به جای flv از گزینه live_flv استفاده کنید تا در برابر ناپیوستگی‌های برچسب زمان تاب بیاورد.
فرمت KUX یک گونه از flv است که در پلتفرم Youku استفاده می‌شود.
.PP
.Vb 2
\&        ffmpeg \-f flv \-i myfile.flv ...
\&        ffmpeg \-f live_flv \-i rtmp://<any.server>/anything/key ....
.Ve
.IP "\fB\-flv_metadata\fR \fIbool\fR" 4
.IX Item "-flv_metadata bool"
تخصیص استریم‌ها مطابق با محتوای آرایه onMetaData.
.IP "\fB\-flv_ignore_prevtag\fR \fIbool\fR" 4
.IX Item "-flv_ignore_prevtag bool"
نادیده گرفتن مقدار اندازه تگ قبلی.
.IP "\fB\-flv_full_metadata\fR \fIbool\fR" 4
.IX Item "-flv_full_metadata bool"
خروجی دادن تمامی محتوای onMetadata.
.SS gif
.IX Subsection "gif"
دیمکسر GIF متحرک.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP \fBmin_delay\fR 4
.IX Item "min_delay"
تنظیم حداقل تاخیر معتبر میان فریم‌ها بر حسب صدم ثانیه.
محدوده از 0 تا 6000 است. مقدار پیش‌فرض 2 است.
.IP \fBmax_gif_delay\fR 4
.IX Item "max_gif_delay"
تنظیم حداکثر تاخیر معتبر میان فریم‌ها بر حسب صدم ثانیه.
محدوده از 0 تا 65535 است. مقدار پیش‌فرض 65535 (نزدیک به یازده دقیقه)، حداکثر مقدار مجاز طبق مشخصات استاندارد است.
.IP \fBdefault_delay\fR 4
.IX Item "default_delay"
تنظیم تاخیر پیش‌فرض میان فریم‌ها بر حسب صدم ثانیه.
محدوده از 0 تا 6000 است. مقدار پیش‌فرض 10 است.
.IP \fBignore_loop\fR 4
.IX Item "ignore_loop"
فایل‌های GIF می‌توانند حاوی اطلاعاتی برای تکرار حلقه به تعداد دفعات مشخص (یا نامحدود) باشند. اگر \fBignore_loop\fR روی ۱ تنظیم شود، تنظیمات حلقه از ورودی نادیده گرفته شده و حلقه رخ نخواهد داد. اگر روی ۰ تنظیم شود، چرخه رخ می‌دهد و تعداد دفعات چرخش طبق GIF خواهد بود. مقدار پیش‌فرض 1 است.
.PP
برای نمونه، با فیلتر overlay، قرار دادن یک GIF با تکرار نامحدود روی ویدیویی دیگر:
.PP
.Vb 1
\&        ffmpeg \-i input.mp4 \-ignore_loop 0 \-i input.gif \-filter_complex overlay=shortest=1 out.mkv
.Ve
.PP
توجه داشته باشید که در مثال بالا گزینه shortest برای فیلتر overlay استفاده شده است تا ویدیوی خروجی به اندازه طول کوتاه‌ترین فایل ورودی پایان یابد، که در این حالت \fIinput.mp4\fR است زیرا GIF در این مثال به طور نامحدود تکرار می‌شود.
.SS hls
.IX Subsection "hls"
دیمکسر HLS.
.PP
دیمکسر پخش زنده روی پروتکل HTTP اپل (Apple HTTP Live Streaming).
.PP
این دیمکسر تمامی AVStreamها را از تمامی استریم‌های متغیر ارائه می‌دهد.
فیلد id روی شماره اندیس متغیر نرخ بیت تنظیم شده است. با تنظیم پرچم‌های دور انداختن روی AVStreamها (با فشردن \*(Aqa\*(Aq یا \*(Aqv\*(Aq در ffplay)، فراخواننده می‌تواند تصمیم بگیرد که در عمل کدام استریم‌های متغیر را دریافت کند.
نرخ بیت کل متغیری که استریم به آن تعلق دارد، در یک کلید متادیتا به نام "variant_bitrate" در دسترس است.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP \fBlive_start_index\fR 4
.IX Item "live_start_index"
اندیس بخشی که استریم‌های زنده از آن آغاز شوند (مقادیر منفی از انتها محاسبه می‌شوند).
.IP \fBprefer_x_start\fR 4
.IX Item "prefer_x_start"
ترجیح استفاده از #EXT\-X\-START در صورتی که در لیست پخش باشد به جای live_start_index.
.IP \fBallowed_extensions\fR 4
.IX Item "allowed_extensions"
فهرستی از پسوندهای فایل جداشده با \*(Aq,\*(Aq که hls مجاز به دسترسی به آن‌ها است.
.IP \fBextension_picky\fR 4
.IX Item "extension_picky"
این گزینه پسوندهای غیرمجاز را از پروب کردن مسدود می‌کند.
همچنین ایجاب می‌کند که تمام بخش‌های موجود، پسوندهای منطبق با فرمت داشته باشند به جز mpegts که همیشه مجاز است.
توصیه می‌شود به جای اتکا به پسوندها، لیست‌های سفید را به درستی تنظیم کنید.
به طور پیش‌فرض فعال است.
.IP \fBmax_reload\fR 4
.IX Item "max_reload"
حداکثر تعداد دفعاتی که تلاش می‌شود یک لیست ناکافی مجدداً بارگذاری شود.
مقدار پیش‌فرض 1000 است.
.IP \fBm3u8_hold_counters\fR 4
.IX Item "m3u8_hold_counters"
حداکثر تعداد دفعات بارگذاری m3u8 هنگامی که بدون بخش‌های جدید بازخوانی می‌شود.
مقدار پیش‌فرض 1000 است.
.IP \fBhttp_persistent\fR 4
.IX Item "http_persistent"
استفاده از اتصالات پایدار HTTP. تنها برای استریم‌های HTTP کاربرد دارد.
به طور پیش‌فرض فعال است.
.IP \fBhttp_multiple\fR 4
.IX Item "http_multiple"
استفاده از چندین اتصال HTTP برای دانلود بخش‌های HTTP.
به طور پیش‌فرض برای سرورهای HTTP/1.1 فعال است.
.IP \fBhttp_seekable\fR 4
.IX Item "http_seekable"
استفاده از درخواست‌های جزئی HTTP برای دانلود بخش‌های HTTP.
0 = غیرفعال، 1 = فعال، \-1 = خودکار، پیش‌فرض خودکار است.
.IP \fBseg_format_options\fR 4
.IX Item "seg_format_options"
تنظیم گزینه‌ها برای دیمکسر بخش‌های رسانه‌ای با استفاده از فهرستی از جفت‌های key=value که با \f(CW\*(C`:\*(C'\fR از هم جدا شده‌اند.
.IP \fBseg_max_retry\fR 4
.IX Item "seg_max_retry"
حداکثر تعداد دفعات بارگذاری مجدد یک بخش در صورت بروز خطا، زمانی مفید است که صرف‌نظر از بخش در هنگام خطای شبکه مطلوب نباشد.
مقدار پیش‌فرض 0 است.
.SS image2
.IX Subsection "image2"
دیمکسر فایل تصویر.
.PP
این دیمکسر از فهرستی از فایل‌های تصویر مشخص‌شده توسط یک الگو می‌خواند. نحو و معنای الگو توسط گزینه \fIpattern_type\fR مشخص می‌شود.
.PP
الگو ممکن است شامل پسوندی باشد که برای تعیین خودکار فرمت تصاویر موجود در فایل‌ها استفاده می‌شود.
.PP
اندازه، فرمت پیکسل و فرمت هر تصویر باید برای تمامی فایل‌های موجود در توالی یکسان باشد.
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم برای استریم ویدیو. پیش‌فرض آن 25 است.
.IP \fBloop\fR 4
.IX Item "loop"
در صورت تنظیم روی ۱، روی ورودی حلقه می‌زند. مقدار پیش‌فرض 0 است.
.IP \fBpattern_type\fR 4
.IX Item "pattern_type"
نوع الگوی مورد استفاده برای تفسیر نام فایل ارائه‌شده را انتخاب می‌کند.
.Sp
گزینه \&\fIpattern_type\fR یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال کردن تطبیق الگو، بنابراین ویدیو تنها شامل تصویر مشخص‌شده خواهد بود. اگر نمی‌خواهید از چندین تصویر توالی بسازید و نام فایل‌های شما ممکن است شامل نویسه‌های الگوی ویژه باشد، باید از این گزینه استفاده کنید.
.IP \fBsequence\fR 4
.IX Item "sequence"
انتخاب نوع الگوی توالی، که برای مشخص کردن توالی فایل‌های اندیس‌گذاری‌شده با اعداد متوالی استفاده می‌شود.
.Sp
یک الگوی توالی ممکن است شامل رشته "%d" یا "%0\fIN\fRd" باشد که موقعیت نویسه‌های نمایانگر یک عدد متوالی را در هر نام فایل منطبق با الگو مشخص می‌کند. اگر فرم "%d0\fIN\fRd" استفاده شود، رشته نمایانگر عدد در هر نام فایل با صفر پر می‌شود (0\-padded) و \fIN\fR تعداد کل ارقام پرشده با صفر است که عدد را نشان می‌دهند. نویسه تحت‌اللفظی \*(Aq%\*(Aq می‌تواند در الگو با رشته "%%" مشخص شود.
.Sp
اگر الگوی توالی شامل "%d" یا "%0\fIN\fRd" باشد، نخستین نام فایل از فهرست فایل مشخص‌شده توسط الگو باید شامل عددی باشد که به طور فراگیر بین \fIstart_number\fR و \&\fIstart_number\fR+\fIstart_number_range\fR\-1 قرار داشته باشد، و تمامی اعداد بعدی باید متوالی باشند.
.Sp
برای نمونه الگوی "img\-%03d.bmp" با توالی نام‌های فایلی به شکل \fIimg\-001.bmp\fR، \fIimg\-002.bmp\fR، ...، \&\fIimg\-010.bmp\fR و غیره مطابقت خواهد داشت؛ الگوی "i%%m%%g\-%d.jpg" با توالی نام‌های فایلی به شکل \fIi%m%g\-1.jpg\fR، \&\fIi%m%g\-2.jpg\fR، ...، \fIi%m%g\-10.jpg\fR و غیره مطابقت خواهد داشت.
.Sp
توجه داشته باشید که الگو لزوماً نباید شامل "%d" یا "%0\fIN\fRd" باشد، مثلاً برای تبدیل یک فایل تصویر تکی \fIimg.jpeg\fR می‌توانید از دستور زیر استفاده کنید:
.Sp
.Vb 1
\&        ffmpeg \-i img.jpeg img.png
.Ve
.IP \fBglob\fR 4
.IX Item "glob"
انتخاب نوع الگوی نویسه‌های عام (glob wildcard).
.Sp
الگو مانند یک الگوی \f(CWglob()\fR تفسیر می‌شود. این گزینه تنها زمانی قابل انتخاب است که libavformat با پشتیبانی از globbing کامپایل شده باشد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIsequence\fR است.
.RE
.IP \fBpixel_format\fR 4
.IX Item "pixel_format"
تنظیم فرمت پیکسل تصاویری که باید خوانده شوند. در صورت عدم تعیین، فرمت پیکسل از نخستین فایل تصویر در توالی حدس زده می‌شود.
.IP \fBstart_number\fR 4
.IX Item "start_number"
تنظیم اندیس فایلی که با الگوی فایل تصویر مطابقت دارد تا خواندن از آن آغاز شود. مقدار پیش‌فرض 0 است.
.IP \fBstart_number_range\fR 4
.IX Item "start_number_range"
تنظیم محدوده بازه اندیس برای بررسی هنگام جستجوی نخستین فایل تصویر در توالی، با شروع از \fIstart_number\fR. مقدار پیش‌فرض 5 است.
.IP \fBts_from_file\fR 4
.IX Item "ts_from_file"
اگر روی ۱ تنظیم شود، برچسب زمان فریم را روی زمان اصلاح فایل تصویر تنظیم می‌کند. توجه داشته باشید که یکنواختی برچسب‌های زمانی تضمین نمی‌شود: تصاویر با همان ترتیبی که بدون این گزینه دارند خوانده می‌شوند. مقدار پیش‌فرض 0 است.
اگر روی ۲ تنظیم شود، برچسب زمان فریم را روی زمان اصلاح فایل تصویر با دقت نانوثانیه تنظیم می‌کند.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم اندازه ویدیوی تصاویری که باید خوانده شوند. در صورت عدم تعیین، اندازه ویدیو از نخستین فایل تصویر در توالی حدس زده می‌شود.
.IP \fBexport_path_metadata\fR 4
.IX Item "export_path_metadata"
اگر روی ۱ تنظیم شود، دو فیلد اضافی به متادیتای یافت‌شده در ورودی اضافه می‌کند و آن‌ها را برای سایر فیلترها نیز در دسترس قرار می‌دهد (برای نمونه‌ها فیلتر \fIdrawtext\fR را ببینید). مقدار پیش‌فرض 0 است. فیلدهای اضافی در زیر شرح داده شده‌اند:
.RS 4
.IP \fBlavf.image2dec.source_path\fR 4
.IX Item "lavf.image2dec.source_path"
متناظر با مسیر کامل فایل ورودی در حال خواندن است.
.IP \fBlavf.image2dec.source_basename\fR 4
.IX Item "lavf.image2dec.source_basename"
متناظر با نام پایه (basename) فایل در حال خواندن است.
.RE
.RS 4
.RE
.PP
\fIنمونه‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از \fBffmpeg\fR برای ایجاد یک ویدیو از تصاویر در توالی فایل \fIimg\-001.jpeg\fR، \fIimg\-002.jpeg\fR، ...، با فرض نرخ فریم ورودی ۱۰ فریم بر ثانیه:
.Sp
.Vb 1
\&        ffmpeg \-framerate 10 \-i \*(Aqimg\-%03d.jpeg\*(Aq out.mkv
.Ve
.IP \(bu 4
مانند بالا، اما شروع خواندن از فایلی با اندیس ۱۰۰ در توالی:
.Sp
.Vb 1
\&        ffmpeg \-framerate 10 \-start_number 100 \-i \*(Aqimg\-%03d.jpeg\*(Aq out.mkv
.Ve
.IP \(bu 4
خواندن تصاویر منطبق با الگوی glob از نوع "*.png"، یعنی تمامی فایل‌هایی که با پسوند ".png" پایان می‌یابند:
.Sp
.Vb 1
\&        ffmpeg \-framerate 10 \-pattern_type glob \-i "*.png" out.mkv
.Ve
.SS libgme
.IX Subsection "libgme"
کتابخانه Game Music Emu مجموعه‌ای از شبیه‌سازهای فایل‌های موسیقی بازی‌های ویدیویی است.
.PP
برای اطلاعات بیشتر به <\fBhttps://bitbucket.org/mpyne/game\-music\-emu/overview\fR> مراجعه کنید.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP \fBtrack_index\fR 4
.IX Item "track_index"
اندیس قطعه‌ای (track) را که باید دیمکس شود تنظیم می‌کند. دیمکسر تنها می‌تواند یک قطعه را خروجی دهد. اندیس قطعه‌ها از ۰ شروع می‌شود. پیش‌فرض انتخاب نخستین قطعه است. تعداد قطعه‌ها به عنوان مدخل متادیتای \fItracks\fR صادر می‌شود.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری قطعه صادرشده. محدوده از 1000 تا 999999 است. پیش‌فرض 44100 است.
.IP "\fBmax_size\fR \fI(bytes)\fR" 4
.IX Item "max_size (bytes)"
دیمکسر کل فایل را در حافظه بافر می‌کند. این مقدار را برای تنظیم حداکثر اندازه بافر تغییر دهید، که به نوبه خود به عنوان سقفی برای اندازه فایل‌های قابل خواندن عمل می‌کند.
پیش‌فرض 50 MiB است.
.SS libmodplug
.IX Subsection "libmodplug"
دیمکسر ماژول بر پایه ModPlug
.PP
ببینید: <\fBhttps://github.com/Konstanty/libmodplug\fR>
.PP
یک جریان صوتی ۲ کاناله ۱۶ بیتی با فرکانس 44.1 kHz صادر می‌کند.
به صورت اختیاری، یک جریان ویدیویی ۱۶ رنگ \f(CW\*(C`pal8\*(C'\fR با یا بدون متاداده چاپ‌شده می‌تواند صادر شود.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP \fBnoise_reduction\fR 4
.IX Item "noise_reduction"
اعمال یک فیلتر پایین‌گذر ساده. می‌تواند 1 (روشن) یا 0 (خاموش) باشد. پیش‌فرض 0 است.
.IP \fBreverb_depth\fR 4
.IX Item "reverb_depth"
تنظیم میزان طنین (Reverb). محدوده 0\-100. پیش‌فرض 0 است.
.IP \fBreverb_delay\fR 4
.IX Item "reverb_delay"
تنظیم تأخیر به میلی‌ثانیه، محدود به 40\-250 ms. پیش‌فرض 0 است.
.IP \fBbass_amount\fR 4
.IX Item "bass_amount"
اعمال تقویت بیس معروف به XBass یا megabass. محدوده از 0 (آرام) تا 100 (بلند). پیش‌فرض 0 است.
.IP \fBbass_range\fR 4
.IX Item "bass_range"
تنظیم فرکانس قطع (حد بالای فرکانس‌های بیس). محدوده 10\-100 Hz است. پیش‌فرض 0 است.
.IP \fBsurround_depth\fR 4
.IX Item "surround_depth"
اعمال جلوه صدای فراگیر Dolby Pro\-Logic. محدوده از 0 (آرام) تا 100 (شدید). پیش‌فرض 0 است.
.IP \fBsurround_delay\fR 4
.IX Item "surround_delay"
تنظیم تأخیر صدای فراگیر به میلی‌ثانیه، محدود به 5\-40 ms. پیش‌فرض 0 است.
.IP \fBmax_size\fR 4
.IX Item "max_size"
دیمکسر تمام پرونده را در حافظه بافر می‌کند. این مقدار را برای تنظیم حداکثر اندازه بافر تغییر دهید، که به نوبه خود به عنوان سقف اندازه پرونده‌های قابل خواندن عمل می‌کند. محدوده از 0 تا 100 MiB است. مقدار 0 محدودیت اندازه بافر را حذف می‌کند (توصیه نمی‌شود). پیش‌فرض 5 MiB است.
.IP \fBvideo_stream_expr\fR 4
.IX Item "video_stream_expr"
رشته‌ای که با استفاده از eval API برای تخصیص رنگ‌ها به جریان ویدیویی تولیدشده ارزیابی می‌شود. متغیرهایی که می‌توانند استفاده شوند عبارتند از \f(CW\*(C`x\*(C'\fR، \f(CW\*(C`y\*(C'\fR، \f(CW\*(C`w\*(C'\fR، \f(CW\*(C`h\*(C'\fR، \f(CW\*(C`t\*(C'\fR، \f(CW\*(C`speed\*(C'\fR، \&\f(CW\*(C`tempo\*(C'\fR، \f(CW\*(C`order\*(C'\fR، \f(CW\*(C`pattern\*(C'\fR و \f(CW\*(C`row\*(C'\fR.
.IP \fBvideo_stream\fR 4
.IX Item "video_stream"
تولید جریان ویدیویی. می‌تواند 1 (روشن) یا 0 (خاموش) باشد. پیش‌فرض 0 است.
.IP \fBvideo_stream_w\fR 4
.IX Item "video_stream_w"
تنظیم عرض فریم ویدیو بر حسب \*(Aqchars\*(Aq که در آن هر نویسه نشان‌دهنده ۸ پیکسل است. محدوده 20\-512 است. پیش‌فرض 30 است.
.IP \fBvideo_stream_h\fR 4
.IX Item "video_stream_h"
تنظیم ارتفاع فریم ویدیو بر حسب \*(Aqchars\*(Aq که در آن هر نویسه نشان‌دهنده ۸ پیکسل است. محدوده 20\-512 است. پیش‌فرض 30 است.
.IP \fBvideo_stream_ptxt\fR 4
.IX Item "video_stream_ptxt"
چاپ متاداده روی جریان ویدیو. شامل \f(CW\*(C`speed\*(C'\fR، \f(CW\*(C`tempo\*(C'\fR، \f(CW\*(C`order\*(C'\fR، \f(CW\*(C`pattern\*(C'\fR، \&\f(CW\*(C`row\*(C'\fR و \f(CW\*(C`ts\*(C'\fR (زمان به میلی‌ثانیه). می‌تواند 1 (روشن) یا 0 (خاموش) باشد. پیش‌فرض 1 است.
.SS libopenmpt
.IX Subsection "libopenmpt"
دیمکسر ماژول بر پایه libopenmpt
.PP
برای اطلاعات بیشتر <\fBhttps://lib.openmpt.org/libopenmpt\fR> را ببینید.
.PP
برخی پرونده‌ها چندین زیرآهنگ (تراک) دارند که این مورد را می‌توان با گزینه \fBsubsong\fR تنظیم کرد.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP \fBsubsong\fR 4
.IX Item "subsong"
تنظیم اندیس زیرآهنگ. این مقدار می‌تواند \*(Aqall\*(Aq، \*(Aqauto\*(Aq یا اندیس زیرآهنگ باشد. اندیس‌های زیرآهنگ از 0 شروع می‌شوند. پیش‌فرض \*(Aqauto\*(Aq است.
.Sp
مقدار پیش‌فرض این است که اجازه داده شود libopenmpt انتخاب کند.
.IP \fBlayout\fR 4
.IX Item "layout"
تنظیم چیدمان کانال. مقادیر معتبر چیدمان‌های ۱، ۲ و ۴ کاناله هستند.
مقدار پیش‌فرض STEREO است.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری برای خروجی libopenmpt.
محدوده از 1000 تا INT_MAX است. مقدار پیش‌فرض 48000 است.
.SS mcc
.IX Subsection "mcc"
دیمکسر پرونده‌های MacCaption MCC، که از نسخه‌های 1.0 و 2.0 MCC پشتیبانی می‌کند.
پرونده‌های MCC داده‌های VANC را ذخیره می‌کنند، که می‌تواند شامل زیرنویس‌های بسته‌بندی‌شده (EIA\-608 و CEA\-708)، کدهای زمانی کمکی، داده‌های pan\-scan و غیره باشد.
به طور پیش‌فرض، برای سازگاری عقب‌رو، دیمکسر MCC فقط زیرنویس‌های بسته‌بندی‌شده EIA\-608 و CEA\-708 را استخراج کرده و یک جریان \f(CW\*(C`EIA_608\*(C'\fR بازمی‌گرداند و تمام داده‌های VANC دیگر را نادیده می‌گیرد.
می‌توانید با تنظیم \fB\-eia608_extract 0\fR آن را طوری تغییر دهید که تمام داده‌های VANC را در یک جریان داده \f(CW\*(C`SMPTE_436M_ANC\*(C'\fR برگرداند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تبدیل یک پرونده MCC به قالب Scenarist (SCC):
.Sp
.Vb 1
\&        ffmpeg \-i CC.mcc \-c:s copy CC.scc
.Ve
.Sp
توجه داشته باشید که قالب SCC تنها از EIA\-608 پشتیبانی می‌کند، بنابراین این کار تمام داده‌های دیگر مانند پسوندهای CEA\-708 را دور می‌ریزد.
.IP \(bu 4
ادغام یک پرونده MCC در یک پرونده MXF:
.Sp
.Vb 1
\&        ffmpeg \-i video_and_audio.mxf \-eia608_extract 0 \-i CC.mcc \-c copy \-map 0 \-map 1 out.mxf
.Ve
.Sp
این کار تمام داده‌های VANC را حفظ کرده و آن را به عنوان یک جریان داده \f(CW\*(C`SMPTE_436M_ANC\*(C'\fR درون پرونده MXF خروجی درج می‌کند.
.SS mov/mp4/3gp
.IX Subsection "mov/mp4/3gp"
دیمکسر برای قالب پرونده QuickTime و قالب پرونده رسانه‌ای پایه ISO/IEC (استاندارد ISO/IEC 14496\-12 یا MPEG\-4 Part 12 و ISO/IEC 15444\-12 یا JPEG 2000 Part 12).
.PP
پسوندهای ثبت‌شده: mov, mp4, m4a, 3gp, 3g2, mj2, psp, m4b, ism, ismv, isma, f4v
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBenable_drefs\fR 4
.IX Item "enable_drefs"
فعال‌سازی بارگیری تراک‌های خارجی، به طور پیش‌فرض غیرفعال است.
فعال کردن این گزینه در برخی موارد کاربردی از نظر تئوری می‌تواند اطلاعات را افشا کند.
.IP \fBuse_absolute_path\fR 4
.IX Item "use_absolute_path"
اجازه بارگیری تراک‌های خارجی از طریق مسیرهای مطلق، به طور پیش‌فرض غیرفعال است.
فعال کردن این گزینه خطرات امنیتی به همراه دارد. تنها زمانی باید فعال شود که منبع ورودی کاملاً مطمئن و غیرمخرب باشد.
.IP \fBseek_streams_individually\fR 4
.IX Item "seek_streams_individually"
هنگام پرش (seeking)، نزدیک‌ترین نقطه در هر جریان را به صورت جداگانه شناسایی کرده و بسته‌های آن جریان را از نقطه شناسایی‌شده دیمکس می‌کند. این می‌تواند منجر به توالی متفاوتی از بسته‌ها در مقایسه با دیمکس کردن خطی از ابتدا شود. پیش‌فرض true است.
.IP \fBignore_editlist\fR 4
.IX Item "ignore_editlist"
نادیده گرفتن اتم‌های فهرست ویرایش (edit list). دیمکسر به طور پیش‌فرض اندیس جریان را به گونه‌ای اصلاح می‌کند تا خط زمانی شرح‌داده‌شده توسط فهرست ویرایش را منعکس کند. پیش‌فرض false است.
.IP \fBadvanced_editlist\fR 4
.IX Item "advanced_editlist"
اصلاح اندیس جریان برای انعکاس خط زمانی شرح‌داده‌شده توسط فهرست ویرایش. برای مؤثر بودن این گزینه، \f(CW\*(C`ignore_editlist\*(C'\fR باید روی false تنظیم شده باشد.
اگر هر دوی \f(CW\*(C`ignore_editlist\*(C'\fR و این گزینه روی false تنظیم شوند، تنها ابتدای اندیس جریان اصلاح می‌شود تا زمان مکث اولیه یا برچسب زمانی شروع شرح‌داده‌شده در فهرست ویرایش را منعکس کند. پیش‌فرض true است.
.IP \fBignore_chapters\fR 4
.IX Item "ignore_chapters"
فصل‌ها (chapters) تجزیه نشوند. این شامل برچسب‌ها/لحظات \*(AqHiLight\*(Aq دوربین‌های GoPro نیز می‌شود. توجه داشته باشید که فصل‌ها تنها زمانی تجزیه می‌شوند که ورودی دارای قابلیت پرش (seekable) باشد. پیش‌فرض false است.
.IP \fBuse_mfra_for\fR 4
.IX Item "use_mfra_for"
برای ورودی قطعه‌بندی‌شده (fragmented) با قابلیت پرش، برچسب زمانی شروع قطعه از جعبه دسترسی تصادفی قطعه رسانه (mfra)، در صورت وجود، تنظیم شود.
.Sp
گزینه‌های زیر در دسترس هستند:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
تشخیص خودکار اینکه برچسب‌های زمانی mfra به عنوان PTS یا DTS تنظیم شوند \fI(پیش‌فرض)\fR
.IP \fBdts\fR 4
.IX Item "dts"
تنظیم برچسب‌های زمانی mfra به عنوان DTS
.IP \fBpts\fR 4
.IX Item "pts"
تنظیم برچسب‌های زمانی mfra به عنوان PTS
.IP \fB0\fR 4
.IX Item "0"
از جعبه mfra برای تنظیم برچسب‌های زمانی استفاده نشود
.RE
.RS 4
.RE
.IP \fBuse_tfdt\fR 4
.IX Item "use_tfdt"
برای ورودی قطعه‌بندی‌شده، برچسب زمانی شروع قطعه را بر روی \f(CW\*(C`baseMediaDecodeTime\*(C'\fR از جعبه \f(CW\*(C`tfdt\*(C'\fR تنظیم کند.
پیش‌فرض فعال است، که ترجیح می‌دهد از جعبه \f(CW\*(C`tfdt\*(C'\fR برای تنظیم DTS استفاده کند. غیرفعال کنید تا از \f(CW\*(C`earliest_presentation_time\*(C'\fR از جعبه \f(CW\*(C`sidx\*(C'\fR استفاده شود.
در هر صورت، اگر برچسب زمانی از جعبه \f(CW\*(C`mfra\*(C'\fR موجود باشد و \f(CW\*(C`use_mfra_for\*(C'\fR روی pts یا dts تنظیم شده باشد، از آن استفاده خواهد شد.
.IP \fBexport_all\fR 4
.IX Item "export_all"
صادر کردن جعبه‌های ناشناخته درون جعبه \fIudta\fR به عنوان ورودی‌های متاداده. چهار نویسه اول نوع جعبه به عنوان کلید تنظیم می‌شوند. پیش‌فرض false است.
.IP \fBexport_xmp\fR 4
.IX Item "export_xmp"
صادر کردن کل محتویات جعبه \fIXMP_\fR و جعبه \fIuuid\fR به عنوان یک رشته با کلید \f(CW\*(C`xmp\*(C'\fR. توجه داشته باشید که اگر \f(CW\*(C`export_all\*(C'\fR تنظیم شده باشد اما این گزینه تنظیم نشده باشد، محتویات جعبه \fIXMP_\fR همچنان صادر می‌شود اما با کلید \f(CW\*(C`XMP_\*(C'\fR. پیش‌فرض false است.
.IP \fBactivation_bytes\fR 4
.IX Item "activation_bytes"
کلید ۴ بایتی مورد نیاز برای رمزگشایی پرونده‌های Audible AAX و +AAX. به زیربخش Audible AAX در زیر مراجعه کنید.
.IP \fBaudible_fixed_key\fR 4
.IX Item "audible_fixed_key"
کلید ثابت استفاده‌شده برای رسیدگی به پرونده‌های Audible AAX/AAX+. این مقدار از پیش تنظیم شده است بنابراین نیازی به تعیین آن نیست.
.IP \fBdecryption_key\fR 4
.IX Item "decryption_key"
کلید پیش‌فرض ۱۶ بایتی، در قالب هگز، برای رمزگشایی پرونده‌های رمزگذاری‌شده با رمزگذاری مشترک ISO (استاندارد CENC/AES\-128 CTR؛ ISO/IEC 23001\-7).
.IP \fBdecryption_keys\fR 4
.IX Item "decryption_keys"
دیکشنری از شناسه کلید ۱۶ بایتی => کلید ۱۶ بایتی، هر دو در قالب هگز، برای رمزگشایی پرونده‌های رمزگذاری‌شده با رمزگذاری مشترک ISO (استاندارد CENC/AES\-128 CTR؛ ISO/IEC 23001\-7).
.IP \fBmax_stts_delta\fR 4
.IX Item "max_stts_delta"
دلتاهای نمونه بسیار بالا که در جعبه stts یک trak نوشته شده‌اند ممکن است گاهی هدفمند باشند اما معمولاً به اشتباه نوشته می‌شوند یا برای ذخیره یک مقدار منفی برای تصحیح dts در هنگام برخورد به عنوان اعداد صحیح علامت‌دار ۳۲ بیتی استفاده می‌شوند. این گزینه به کاربر اجازه می‌دهد سقفی تعیین کند که بالاتر از آن دلتا به 1 محدود شود. مقادیر بزرگ‌تر از این حد در صورتی که پس از تبدیل به int32 منفی شوند، برای تنظیم dts بعدی استفاده می‌شوند.
.Sp
واحد آن مقیاس زمانی تراک (time scale) است. محدوده از 0 تا UINT_MAX است. مقدار پیش‌فرض \f(CW\*(C`UINT_MAX \- 48000*10\*(C'\fR است که تا ۱۰ ثانیه تصحیح dts را برای جریان‌های صوتی 48 kHz امکان‌پذیر می‌کند و در عین حال ۹۹.۹٪ از محدوده \f(CW\*(C`uint32\*(C'\fR را پوشش می‌دهد.
.IP \fBinterleaved_read\fR 4
.IX Item "interleaved_read"
درهم‌آمیزی (Interleave) بسته‌ها از چندین تراک در سطح دیمکسر. برای پرونده‌هایی که درهم‌آمیزی نامناسبی دارند، این کار از مشکلات پخش ناشی از فاصله‌های بزرگ بین بسته‌ها در تراک‌های مختلف جلوگیری می‌کند، زیرا MOV/MP4 الزامات جایگذاری بسته ندارند.
با این حال، این کار می‌تواند به دلیل جستجو بین تراک‌ها باعث پرش‌های مکرر و بیش از حد در پرونده‌های بسیار بد درهم‌آمیخته شود؛ بنابراین غیرفعال کردن آن ممکن است از مشکلات ورودی/خروجی (I/O) به قیمت افت کیفیت پخش جلوگیری کند.
.PP
\fIAudible AAX\fR
.IX Subsection "Audible AAX"
.PP
پرونده‌های Audible AAX پرونده‌های M4B رمزگذاری‌شده هستند و می‌توان آن‌ها را با تعیین یک رمز فعال‌سازی ۴ بایتی رمزگشایی کرد.
.PP
.Vb 1
\&        ffmpeg \-activation_bytes 1CEB00DA \-i test.aax \-vn \-c:a copy output.mp4
.Ve
.SS mpegts
.IX Subsection "mpegts"
دیمکسر جریان انتقال (Transport Stream) MPEG\-2.
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBresync_size\fR 4
.IX Item "resync_size"
تنظیم سقف اندازه برای جستجوی یک همگام‌سازی جدید. مقدار پیش‌فرض 65536 است.
.IP \fBskip_unknown_pmt\fR 4
.IX Item "skip_unknown_pmt"
رد کردن PMTها برای برنامه‌هایی که در PAT تعریف نشده‌اند. مقدار پیش‌فرض 0 است.
.IP \fBfix_teletext_pts\fR 4
.IX Item "fix_teletext_pts"
بازنویسی مقادیر PTS و DTS بسته‌های تله‌تکست با برچسب‌های زمانی محاسبه‌شده از PCR اولین برنامه‌ای که جریان تله‌تکست بخشی از آن است و دور ریخته نشده است. مقدار پیش‌فرض 1 است، این گزینه را روی 0 تنظیم کنید اگر می‌خواهید مقادیر PTS و DTS بسته‌های تله‌تکست شما دست‌نخورده باقی بمانند.
.IP \fBts_packetsize\fR 4
.IX Item "ts_packetsize"
گزینه خروجی که حامل اندازه بسته خام بر حسب بایت است.
اندازه بسته خام شناسایی‌شده را نشان می‌دهد، و توسط کاربر قابل تنظیم نیست.
.IP \fBscan_all_pmts\fR 4
.IX Item "scan_all_pmts"
پویش و ترکیب تمام PMTها. مقدار یک عدد صحیح از \-1 تا 1 است (\-1 به معنای تنظیم خودکار، 1 به معنای فعال و 0 به معنای غیرفعال است). مقدار پیش‌فرض \-1 است.
.IP \fBmerge_pmt_versions\fR 4
.IX Item "merge_pmt_versions"
استفاده مجدد از جریان‌های موجود هنگامی که نسخه یک PMT به‌روزرسانی شده و جریان‌های اولیه به PIDهای دیگری منتقل می‌شوند. مقدار پیش‌فرض 0 است.
.IP \fBmax_packet_size\fR 4
.IX Item "max_packet_size"
تنظیم حداکثر اندازه (بر حسب بایت) برای بسته‌های تولیدشده توسط دیمکسر. بارهای داده بالاتر از این اندازه به چندین بسته تقسیم می‌شوند. محدوده از 184 تا INT_MAX/2 است. پیش‌فرض 204800 بایت است.
.SS mpjpeg
.IX Subsection "mpjpeg"
دیمکسر MJPEG کپسوله‌شده در MIME چندبخشی.
.PP
این دیمکسر خواندن MJPEG را ممکن می‌سازد، جایی که هر فریم به عنوان بخشی از یک جریان multipart/x\-mixed\-replace نمایش داده می‌شود.
.IP \fBstrict_mime_boundary\fR 4
.IX Item "strict_mime_boundary"
پیاده‌سازی پیش‌فرض یک استاندارد آسان‌گیرانه را برای تشخیص مرز چندبخشی MIME اعمال می‌کند تا از ناسازگاری با نقاط انتهایی موجود متعددی که جریان MIME MJPEG مناسبی تولید نمی‌کنند جلوگیری شود. روشن کردن این گزینه با تنظیم آن روی 1 منجر به بررسی سخت‌گیرانه‌تر مقدار مرز خواهد شد.
.SS rawvideo
.IX Subsection "rawvideo"
دیمکسر ویدیوی خام (Raw video).
.PP
این دیمکسر امکان خواندن داده‌های ویدیوی خام را فراهم می‌کند. از آنجا که هیچ هدر یا سرآیندی برای مشخص کردن پارامترهای ویدیویی مفروض وجود ندارد، کاربر باید آن‌ها را مشخص کند تا امکان دیکود صحیح داده‌ها وجود داشته باشد.
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم ویدیوی ورودی. مقدار پیش‌فرض 25 است.
.IP \fBpixel_format\fR 4
.IX Item "pixel_format"
تنظیم قالب پیکسلی ویدیوی ورودی. مقدار پیش‌فرض \f(CW\*(C`yuv420p\*(C'\fR است.
.IP \fBstride\fR 4
.IX Item "stride"
تنظیم اندازه خط فریم بر حسب بایت، فقط در صورتی لازم است که لایه پرکننده (padding) اضافی وجود داشته باشد. برای قالب‌های چندصفحه‌ای (multiplane)، مقدار \fBstride\fR فهرستی از اندازه خط برای هر صفحه است.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم اندازه ویدیوی ورودی. این مقدار باید به صورت صریح مشخص شود.
.PP
به عنوان مثال، برای خواندن یک پرونده ویدیوی خام \fIinput.raw\fR با \&\fBffplay\fR، با فرض قالب پیکسلی \f(CW\*(C`rgb24\*(C'\fR، اندازه ویدیوی \f(CW\*(C`320x240\*(C'\fR و نرخ فریم ۱۰ تصویر در ثانیه، از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffplay \-f rawvideo \-pixel_format rgb24 \-video_size 320x240 \-framerate 10 input.raw
.Ve
.PP
برای خواندن یک پرونده rawvideo با \fBffplay\fR، با فرض قالب پیکسلی \f(CW\*(C`yuv420p\*(C'\fR، اندازه ویدیوی \f(CW\*(C`1080x1920\*(C'\fR، ۸ بایت پدینگ در هر خط صفحه Y و ۴ بایت پدینگ در صفحه UV:
.PP
.Vb 1
\&        ffplay \-f rawvideo \-pixel_format yuv420p \-video_size 1080x1920 \-stride 1088,544,544 input.raw
.Ve
.SS rcwt
.IX Subsection "rcwt"
قالب RCWT (زیرنویس‌های خام همراه با زمان \- Raw Captions With Time) یک قالب بومی ابزار ccextractor است؛ ابزاری متن‌باز و پرکاربرد برای پردازش منابع زیرنویس بسته (CC) استانداردهای 608/708. برای اطلاعات بیشتر درباره این قالب، به مستندات آن مراجعه کنید.
.PP
این دیمکسر مشخصات فنی مارس ۲۰۲۴ را پیاده‌سازی می‌کند که از آوریل ۲۰۱۴ پایدار و بدون تغییر باقی مانده است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
رندر کردن CC به ASS با استفاده از دیکودر داخلی:
.Sp
.Vb 1
\&        ffmpeg \-i CC.rcwt.bin CC.ass
.Ve
.Sp
توجه داشته باشید که اگر خروجی شما خالی به نظر می‌رسد، ممکن است مجبور شوید گزینه \fBdata_field\fR دیکودر را به صورت دستی تنظیم کنید تا زیرجریان CC مورد نظر انتخاب شود.
.IP \(bu 4
تبدیل یک نسخه پشتیبان RCWT به قالب Scenarist (SCC):
.Sp
.Vb 1
\&        ffmpeg \-i CC.rcwt.bin \-c:s copy CC.scc
.Ve
.Sp
توجه داشته باشید که قالب SCC از تمام پسوندهای ممکن CC که می‌توانند در RCWT ذخیره شوند (مانند EIA\-708) پشتیبانی نمی‌کند.
.SS sbg
.IX Subsection "sbg"
دیمکسر اسکریپت SBaGen.
.PP
این دیمکسر زبان اسکریپت‌نویسی مورد استفاده توسط SBaGen <\fBhttp://uazu.net/sbagen\fR> را برای تولید جلسات ضربان‌های دوگوشی (binaural beats) می‌خواند. یک اسکریپت SBG به این صورت است:
.PP
.Vb 9
\&        \-SE
\&        a: 300\-2.5/3 440+4.5/0
\&        b: 300\-2.5/0 440+4.5/3
\&        off: \-
\&        NOW      == a
\&        +0:07:00 == b
\&        +0:14:00 == a
\&        +0:21:00 == b
\&        +0:30:00    off
.Ve
.PP
یک اسکریپت SBG می‌تواند برچسب‌های زمانی مطلق و نسبی را با هم ترکیب کند. اگر اسکریپت فقط از برچسب‌های زمانی مطلق (از جمله زمان شروع اسکریپت) یا فقط از برچسب‌های نسبی استفاده کند، ساختار آن ثابت است و تبدیل ساده خواهد بود. از سوی دیگر، اگر اسکریپت هر دو نوع برچسب زمانی را ترکیب کند، مرجع \fINOW\fR برای برچسب‌های زمانی نسبی از ساعت جاری سیستم در زمان خوانده شدن اسکریپت گرفته می‌شود و ساختار اسکریپت طبق آن مرجع تثبیت خواهد شد. این بدان معناست که اگر اسکریپت مستقیماً پخش شود، زمان‌های واقعی تا حد دقت ساعت کنترل‌کننده صدا با برچسب‌های زمانی مطلق مطابقت خواهند داشت، اما اگر کاربر به نحوی پخش را متوقف کند یا پرش زمانی انجام دهد، تمام زمان‌ها متناسب با آن جابه‌جا خواهند شد.
.SS tedcaptions
.IX Subsection "tedcaptions"
زیرنویس‌های JSON مورد استفاده برای <\fBhttp://www.ted.com\fR>.
.PP
سایت TED پیوندهایی به زیرنویس‌ها ارائه نمی‌دهد، اما می‌توان آن‌ها را از صفحه حدس زد. پرونده \fItools/bookmarklets.html\fR از درخت منبع FFmpeg حاوی بوک‌مارکلتی برای آشکارسازی آن‌ها است.
.PP
این دیمکسر گزینه زیر را می‌پذیرد:
.IP \fBstart_time\fR 4
.IX Item "start_time"
تنظیم زمان شروع سخنرانی TED، به میلی‌ثانیه. پیش‌فرض 15000 (15 ثانیه) است. این مقدار برای همگام‌سازی زیرنویس‌ها با ویدیوهای قابل بارگیری استفاده می‌شود، زیرا آن‌ها شامل یک ویدیوی معرفی ۱۵ ثانیه‌ای هستند.
.PP
مثال: تبدیل زیرنویس‌ها به قالبی که اکثر پخش‌کننده‌ها متوجه می‌شوند:
.PP
.Vb 1
\&        ffmpeg \-i http://www.ted.com/talks/subtitles/id/1/lang/en talk1\-en.srt
.Ve
.SS vapoursynth
.IX Subsection "vapoursynth"
پوشش‌دهنده (Wrapper) برای Vapoursynth.
.PP
به دلایل امنیتی، اسکریپت‌های Vapoursynth به صورت خودکار شناسایی نخواهند شد، بنابراین قالب ورودی باید اجبار شود. برای ابزارهای خط فرمان ff*، عبارت \f(CW\*(C`\-f vapoursynth\*(C'\fR را قبل از ورودی \f(CW\*(C`\-i yourscript.vpy\*(C'\fR اضافه کنید.
.PP
این دیمکسر گزینه زیر را می‌پذیرد:
.IP \fBmax_script_size\fR 4
.IX Item "max_script_size"
دیمکسر تمام اسکریپت را در حافظه بافر می‌کند. این مقدار را برای تنظیم حداکثر اندازه بافر تغییر دهید که به نوبه خود به عنوان سقف اندازه اسکریپت‌های قابل خواندن عمل می‌کند.
پیش‌فرض 1 MiB است.
.SS w64
.IX Subsection "w64"
دیمکسر صوتی Sony Wave64.
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP \fBmax_size\fR 4
.IX Item "max_size"
گزینه مشابه برای دیمکسر \fBwav\fR را ببینید.
.SS wav
.IX Subsection "wav"
دیمکسر صوتی RIFF Wave.
.PP
این دیمکسر گزینه‌های زیر را می‌پذیرد:
.IP "\fBignore_length\fR \fIbool\fR" 4
.IX Item "ignore_length bool"
در صورت تنظیم، اندازه چانک \f(CW\*(C`data\*(C'\fR را نادیده گرفته و خواندن را تا انتهای پرونده ادامه می‌دهد.
می‌تواند برای خواندن پرونده‌های خراب یا ناقص که هدر آن‌ها به درستی به‌روزرسانی نشده است مفید باشد، اما پرونده‌هایی که دارای چانک‌های غیرصوتی پس از چانک \f(CW\*(C`data\*(C'\fR هستند را به اشتباه تفسیر می‌کند.
پیش‌فرض غیرفعال است.
.IP \fBmax_size\fR 4
.IX Item "max_size"
تعیین حداکثر اندازه بسته به بایت برای بسته‌های دیمکس‌شده. به طور پیش‌فرض روی 0 تنظیم شده است که به این معنی است که یک مقدار معقول بر اساس قالب ورودی انتخاب می‌شود.
.SS webp
.IX Subsection "webp"
دیمکسر WebP متحرک.
.PP
گزینه‌های زیر را می‌پذیرد:
.IP "\fB\-min_delay\fR \fIint\fR" 4
.IX Item "-min_delay int"
تنظیم حداقل تأخیر معتبر بین فریم‌ها به میلی‌ثانیه.
محدوده از 0 تا 60000 است. مقدار پیش‌فرض 10 است.
.IP "\fB\-max_webp_delay\fR \fIint\fR" 4
.IX Item "-max_webp_delay int"
تنظیم حداکثر تأخیر معتبر بین فریم‌ها به میلی‌ثانیه.
محدوده از 0 تا 16777215 است. مقدار پیش‌فرض 16777215 (بیش از چهار ساعت) است، یعنی حداکثر مقدار مجاز توسط مشخصات فنی.
.IP "\fB\-default_delay\fR \fIint\fR" 4
.IX Item "-default_delay int"
تنظیم تأخیر پیش‌فرض بین فریم‌ها به میلی‌ثانیه.
محدوده از 0 تا 60000 است. مقدار پیش‌فرض 100 است.
.IP "\fB\-ignore_loop\fR \fIbool\fR" 4
.IX Item "-ignore_loop bool"
پرونده‌های WebP می‌توانند حاوی اطلاعاتی برای تکرار (حلقه) به تعداد دفعات مشخص (یا بی‌نهایت) باشند. اگر \fBignore_loop\fR روی true تنظیم شود، تنظیم حلقه از ورودی نادیده گرفته شده و حلقه تکرار رخ نخواهد داد. اگر روی false تنظیم شود، تکرار رخ خواهد داد و تعداد دفعات را مطابق با WebP چرخش می‌دهد. مقدار پیش‌فرض true است.
.IP "\fBusebgcolor\fR \fIbool\fR" 4
.IX Item "usebgcolor bool"
پرونده‌های WebP حاوی یک راهنمای رنگ پس‌زمینه در چانک ANIM هستند، اما مشخصات فنی WebP می‌گوید برنامه‌های نمایشگر ملزم به استفاده از آن نیستند. اگر \fBusebgcolor\fR روی true تنظیم شود، از راهنمای رنگ پس‌زمینه استفاده می‌شود، در غیر این صورت از رنگ سیاه شفاف برای پس‌زمینه استفاده خواهد شد. مقدار پیش‌فرض false است.
.SH "متاداده (METADATA)"
.IX Header "METADATA"
ابزار FFmpeg قادر است متاداده‌ها را از پرونده‌های رسانه‌ای در یک پرونده متنی ساده مشابه INI با کدگذاری UTF\-8 استخراج کرده و سپس با استفاده از مکسر/دیمکسر metadata دوباره آن را بارگیری نماید.
.PP
فرمت پرونده به شرح زیر است:
.IP 1. 4
یک پرونده شامل یک هدر و تعدادی تگ متاداده است که به بخش‌ها تقسیم شده‌اند و هر کدام در خط جداگانه‌ای قرار دارند.
.IP 2. 4
هدر یک رشته \fB;FFMETADATA\fR است، که به دنبال آن شماره نسخه می‌آید (در حال حاضر 1).
.IP 3. 4
تگ‌های متاداده به شکل \fBkey=value\fR هستند.
.IP 4. 4
بلافاصله پس از هدر، متاداده‌های سراسری (global) قرار می‌گیرند.
.IP 5. 4
پس از متاداده‌های سراسری ممکن است بخش‌هایی با متاداده‌های مربوط به هر جریان/هر فصل وجود داشته باشد.
.IP 6. 4
یک بخش با نام بخش با حروف بزرگ (یعنی STREAM یا CHAPTER) در داخل براکت‌ها (\fB[\fR، \fB]\fR) شروع می‌شود و با بخش بعدی یا پایان پرونده خاتمه می‌یابد.
.IP 7. 4
در ابتدای یک بخش فصل ممکن است یک پایه زمانی (timebase) اختیاری وجود داشته باشد که برای مقادیر شروع/پایان استفاده شود. این مقدار باید به فرم \&\fBTIMEBASE=\fR\fInum\fR\fB/\fR\fIden\fR باشد، که در آن \fInum\fR و \fIden\fR اعداد صحیح هستند. اگر پایه زمانی وجود نداشته باشد، زمان‌های شروع/پایان بر حسب نانوثانیه فرض می‌شوند.
.Sp
سپس یک بخش فصل باید شامل زمان‌های شروع و پایان فصل به شکل \&\fBSTART=\fR\fInum\fR، \fBEND=\fR\fInum\fR باشد، که در آن \fInum\fR یک عدد صحیح مثبت است.
.IP 8. 4
خطوط خالی و خطوطی که با \fB;\fR یا \fB#\fR شروع می‌شوند نادیده گرفته می‌شوند.
.IP 9. 4
کلیدها یا مقادیر متاداده حاوی نویسه‌های خاص (\fB=\fR، \fB;\fR، \&\fB#\fR، \fB\e\fR و یک خط جدید) باید با یک بک‌اسلش \fB\e\fR گریز داده شوند.
.IP 10. 4
توجه داشته باشید که فاصله‌های خالی در متاداده (مثلاً \fBfoo = bar\fR) بخشی از تگ در نظر گرفته می‌شوند (در مثال بالا کلید \fBfoo \fR و مقدار \fB bar\fR است).
.PP
یک پرونده ffmetadata ممکن است شبیه این باشد:
.PP
.Vb 4
\&        ;FFMETADATA1
\&        title=bike\e\eshed
\&        ;this is a comment
\&        artist=FFmpeg troll team
\&        
\&        [CHAPTER]
\&        TIMEBASE=1/1000
\&        START=0
\&        #chapter ends at 0:01:00
\&        END=60000
\&        title=chapter \e#1
\&        [STREAM]
\&        title=multi\e
\&        line
.Ve
.PP
با استفاده از مکسر و دیمکسر ffmetadata می‌توان متاداده را از یک پرونده ورودی به یک پرونده ffmetadata استخراج کرد، و سپس پرونده را با پرونده ffmetadata ویرایش‌شده به یک پرونده خروجی تبدیل کد نمود.
.PP
استخراج یک پرونده ffmetadata با \fIffmpeg\fR به این صورت انجام می‌شود:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-f ffmetadata FFMETADATAFILE
.Ve
.PP
درج مجدد اطلاعات متاداده ویرایش‌شده از پرونده FFMETADATAFILE می‌تواند به این صورت انجام شود:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-i FFMETADATAFILE \-map_metadata 1 \-codec copy OUTPUT
.Ve
.SH "گزینه‌های پروتکل (PROTOCOL OPTIONS)"
.IX Header "PROTOCOL OPTIONS"
کتابخانه libavformat برخی گزینه‌های سراسری عمومی را فراهم می‌کند که می‌توانند روی تمامی پروتکل‌ها تنظیم شوند. علاوه بر این، هر پروتکل ممکن است از گزینه‌های به اصطلاح اختصاصی (private options) پشتیبانی کند که مختص آن مؤلفه هستند.
.PP
گزینه‌ها را می‌توان با مشخص کردن \-\fIoption\fR \fIvalue\fR در ابزارهای FFmpeg، یا با تنظیم صریح مقدار در گزینه‌های \f(CW\*(C`AVFormatContext\*(C'\fR یا با استفاده از API پرونده \fIlibavutil/opt.h\fR برای کاربردهای برنامه‌نویسی تنظیم نمود.
.PP
فهرست گزینه‌های پشتیبانی‌شده در ادامه آمده است:
.IP "\fBprotocol_whitelist\fR \fIlist\fR \fB(\fR\fIinput\fR\fB)\fR" 4
.IX Item "protocol_whitelist list (input)"
تنظیم یک فهرست جداشده با کاما (",") از پروتکل‌های مجاز. "ALL" با تمام پروتکل‌ها مطابقت دارد. پروتکل‌هایی که دارای پیشوند "-" هستند غیرفعال می‌شوند.
تمام پروتکل‌ها به طور پیش‌فرض مجاز هستند اما پروتکل‌های استفاده‌شده توسط یک پروتکل دیگر (پروتکل‌های تودرتو) به یک زیرمجموعه به ازای هر پروتکل محدود می‌شوند.
.SH "پروتکل‌ها (PROTOCOLS)"
.IX Header "PROTOCOLS"
پروتکل‌ها عناصر پیکربندی‌شده‌ای در FFmpeg هستند که دسترسی به منابع نیازمند پروتکل‌های خاص را امکان‌پذیر می‌سازند.
.PP
هنگامی که بیلد FFmpeg خود را پیکربندی می‌کنید، تمام پروتکل‌های پشتیبانی‌شده به طور پیش‌فرض فعال هستند. می‌توانید با استفاده از گزینه configure با عنوان "\-\-list\-protocols" فهرست تمام پروتکل‌های موجود را مشاهده نمایید.
.PP
شما می‌توانید با استفاده از گزینه configure با عنوان "\-\-disable\-protocols" تمامی پروتکل‌ها را غیرفعال کنید، و به طور انتخابی یک پروتکل را با استفاده از گزینه "\-\-enable\-protocol=\fIPROTOCOL\fR" فعال نمایید، یا می‌توانید یک پروتکل خاص را با استفاده از گزینه "\-\-disable\-protocol=\fIPROTOCOL\fR" غیرفعال سازید.
.PP
گزینه "\-protocols" در ابزارهای *ff فهرست پروتکل‌های پشتیبانی‌شده را نمایش خواهد داد.
.PP
تمام پروتکل‌ها گزینه‌های زیر را می‌پذیرند:
.IP \fBrw_timeout\fR 4
.IX Item "rw_timeout"
حداکثر زمان انتظار برای تکمیل عملیات خواندن/نوشتن (شبکه)، بر حسب میکروثانیه.
.PP
شرح پروتکل‌های موجود در حال حاضر در ادامه آمده است.
.SS amqp
.IX Subsection "amqp"
پروتکل صف‌بندی پیشرفته پیام (AMQP) نسخه 0\-9\-1 یک پروتکل ارتباطی مبتنی بر کارگزار (broker) با الگوی نشر/اشتراک (publish-subscribe) است.
.PP
برای پشتیبانی از AMQP، ابزار FFmpeg باید با سوییچ \-\-enable\-librabbitmq کامپایل شود. همچنین یک کارگزار مستقل AMQP باید در حال اجرا باشد. یک نمونه کارگزار متن‌باز AMQP، نرم‌افزار RabbitMQ است.
.PP
پس از راه‌اندازی کارگزار، یک کلاینت FFmpeg می‌تواند با استفاده از دستور زیر داده‌ها را به کارگزار ارسال کند:
.PP
.Vb 1
\&        ffmpeg \-re \-i input \-f mpegts amqp://[[user]:[password]@]hostname[:port][/vhost]
.Ve
.PP
که در آن hostname و port (پیش‌فرض 5672) آدرس کارگزار است. کلاینت همچنین می‌تواند یک نام کاربری/رمز عبور برای احراز هویت تعیین کند. مقدار پیش‌فرض برای هر دو فیلد "guest" است. نام میزبان مجازی روی کارگزار می‌تواند با vhost تعیین شود. مقدار پیش‌فرض "/" است.
.PP
چندین مشترک می‌توانند با استفاده از دستور زیر از کارگزار داده‌ها را دریافت کنند:
.PP
.Vb 1
\&        ffplay amqp://[[user]:[password]@]hostname[:port][/vhost]
.Ve
.PP
در RabbitMQ تمام داده‌های منتشرشده به کارگزار از طریق یک اکسچنج (Exchange) خاص جریان می‌یابد، و هر کلاینت مشترک یک صف/بافر اختصاص‌یافته دارد. هنگامی که یک بسته به یک اکسچنج می‌رسد، ممکن است بسته به فیلدهای exchange و routing_key در صف کلاینت کپی شود.
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.IP \fBexchange\fR 4
.IX Item "exchange"
اکسچنج مورد استفاده در کارگزار را تعیین می‌کند. RabbitMQ چندین اکسچنج از پیش تعریف‌شده دارد: "amq.direct" اکسچنج پیش‌فرض است، که در آن ناشر و مشترک باید یک routing_key منطبق داشته باشند؛ "amq.fanout" مانند یک عملیات پخش همگانی است (یعنی داده‌ها فارغ از routing_key به تمام صف‌های موجود در اکسچنج fanout ارسال می‌شوند)؛ و "amq.topic" مشابه "amq.direct" است، اما تطبیق الگوهای پیچیده‌تر را امکان‌پذیر می‌سازد (به مستندات RabbitMQ مراجعه کنید).
.IP \fBrouting_key\fR 4
.IX Item "routing_key"
کلید مسیریابی (routing key) را تنظیم می‌کند. مقدار پیش‌فرض "amqp" است. کلید مسیریابی در اکسچنج‌های "amq.direct" و "amq.topic" استفاده می‌شود تا تصمیم گرفته شود آیا بسته‌ها در صف یک مشترک نوشته شوند یا خیر.
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
حداکثر اندازه هر بسته ارسالی/دریافتی به کارگزار. پیش‌فرض 131072 است. حداقل 4096 و حداکثر هر مقدار بزرگ (قابل نمایش با یک int) است. هنگام دریافت بسته‌ها، این گزینه اندازه بافر داخلی را در FFmpeg تنظیم می‌کند. این مقدار باید برابر یا بزرگتر از اندازه بسته‌های منتشرشده به کارگزار باشد. در غیر این صورت پیام دریافتی ممکن است ناقص (truncate) شود و خطاهای دیکود به بار آورد.
.IP \fBconnection_timeout\fR 4
.IX Item "connection_timeout"
مهلت زمانی اتصال بر حسب ثانیه در حین برقراری اتصال اولیه به کارگزار. مقدار پیش‌فرض rw_timeout است، یا 5 ثانیه اگر rw_timeout تنظیم نشده باشد.
.IP "\fBdelivery_mode\fR \fImode\fR" 4
.IX Item "delivery_mode mode"
حالت تحویل هر پیام ارسالی به کارگزار را تنظیم می‌کند.
مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBpersistent\fR 4
.IX Item "persistent"
حالت تحویل روی "persistent" (2) تنظیم می‌شود. این مقدار پیش‌فرض است.
پیام‌ها ممکن است بسته به تنظیمات کارگزار در دیسک ذخیره شوند.
.IP \fBnon\-persistent\fR 4
.IX Item "non-persistent"
حالت تحویل روی "non\-persistent" (1) تنظیم می‌شود.
پیام‌ها در حافظه کارگزار باقی می‌مانند مگر اینکه کارگزار تحت فشار کمبود حافظه قرار گیرد.
.RE
.RS 4
.RE
.SS async
.IX Subsection "async"
پوشش پرکننده ناهمگام داده برای جریان ورودی.
.PP
پر کردن داده‌ها در یک ریسه (thread) پس‌زمینه، به منظور جداسازی عملیات ورودی/خروجی (I/O) از ریسه دیمکس.
.PP
.Vb 3
\&        async:<URL>
\&        async:http://host/resource
\&        async:cache:http://host/resource
.Ve
.SS bluray
.IX Subsection "bluray"
خواندن لیست پخش بلوری (BluRay).
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBangle\fR 4
.IX Item "angle"
زاویه تصویر بلوری (angle)
.IP \fBchapter\fR 4
.IX Item "chapter"
فصل شروع (1...N)
.IP \fBplaylist\fR 4
.IX Item "playlist"
لیست پخش برای خواندن (BDMV/PLAYLIST/?????.mpls)
.PP
مثال‌ها:
.PP
خواندن طولانی‌ترین لیست پخش از بلوری مانت‌شده در مسیر /mnt/bluray:
.PP
.Vb 1
\&        bluray:/mnt/bluray
.Ve
.PP
خواندن زاویه ۲ از لیست پخش ۴ از بلوری مانت‌شده در /mnt/bluray، با شروع از فصل ۲:
.PP
.Vb 1
\&        \-playlist 4 \-angle 2 \-chapter 2 bluray:/mnt/bluray
.Ve
.SS cache
.IX Subsection "cache"
پوشش حافظه پنهان (کش) برای جریان ورودی.
.PP
ذخیره موقت جریان ورودی در یک پرونده موقت. این قابلیت امکان جستجو (seeking) را برای جریان‌های زنده فراهم می‌آورد.
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBread_ahead_limit\fR 4
.IX Item "read_ahead_limit"
مقدار بر حسب بایت که در هنگام عدم پشتیبانی از جستجو می‌تواند پیشاپیش خوانده شود. محدوده از \-1 تا INT_MAX است. مقدار \-1 برای نامحدود است. مقدار پیش‌فرض 65536 است.
.PP
سینتکس URL به شرح زیر است:
.PP
.Vb 1
\&        cache:<URL>
.Ve
.SS concat
.IX Subsection "concat"
پروتکل الحاق فیزیکی (Concatenation).
.PP
خواندن و جستجو در چندین منبع به صورت متوالی به گونه‌ای که گویی یک منبع واحد هستند.
.PP
یک URL پذیرفته‌شده توسط این پروتکل دارای سینتکس زیر است:
.PP
.Vb 1
\&        concat:<URL1>|<URL2>|...|<URLN>
.Ve
.PP
که در آن \fIURL1\fR، \fIURL2\fR، ...، \fIURLN\fR آدرس‌های منابعی هستند که باید به یکدیگر متصل شوند، و هر یک ممکن است پروتکل متفاوتی را مشخص کند.
.PP
برای نمونه برای خواندن دنباله‌ای از پرونده‌های \fIsplit1.mpeg\fR، \fIsplit2.mpeg\fR، \fIsplit3.mpeg\fR با \fBffplay\fR از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffplay concat:split1.mpeg\e|split2.mpeg\e|split3.mpeg
.Ve
.PP
توجه داشته باشید که ممکن است لازم باشد نویسه "|" را که برای بسیاری از پوسته‌ها (shells) یک نویسه خاص است، گریز دهید.
.SS concatf
.IX Subsection "concatf"
پروتکل الحاق فیزیکی با استفاده از فهرستی از منابع جداشده با شکست خط (line break).
.PP
خواندن و جستجو در چندین منبع به صورت متوالی به گونه‌ای که گویی یک منبع واحد هستند.
.PP
یک URL پذیرفته‌شده توسط این پروتکل دارای سینتکس زیر است:
.PP
.Vb 1
\&        concatf:<URL>
.Ve
.PP
که در آن \fIURL\fR آدرس حاوی فهرستی از منابع جداشده با خطوط جدید است که باید به هم متصل شوند، و هر یک می‌تواند مشخص‌کننده یک پروتکل متفاوت باشد. نویسه‌های خاص باید با بک‌اسلش یا کوتیشن تکی گریز داده شوند. به \fBبخش "Quoting and escaping" در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
.PP
به عنوان مثال برای خواندن دنباله‌ای از پرونده‌های \fIsplit1.mpeg\fR، \fIsplit2.mpeg\fR، \fIsplit3.mpeg\fR که در خطوط جداگانه‌ای در یک پرونده \fIsplit.txt\fR فهرست شده‌اند با \fBffplay\fR از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffplay concatf:split.txt
.Ve
.PP
که در آن \fIsplit.txt\fR شامل خطوط زیر است:
.PP
.Vb 3
\&        split1.mpeg
\&        split2.mpeg
\&        split3.mpeg
.Ve
.SS crypto
.IX Subsection "crypto"
پروتکل خواندن جریان رمزگذاری‌شده با AES.
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBkey\fR 4
.IX Item "key"
تنظیم بلوک باینری کلید رمزگشایی AES از روی نمایش هگزادسیمال ارائه‌شده.
.IP \fBiv\fR 4
.IX Item "iv"
تنظیم بلوک باینری بردار مقداردهی اولیه (IV) رمزگشایی AES از روی نمایش هگزادسیمال ارائه‌شده.
.PP
قالب‌های URL پذیرفته‌شده:
.PP
.Vb 2
\&        crypto:<URL>
\&        crypto+<URL>
.Ve
.SS data
.IX Subsection "data"
داده‌های درون‌خطی در URI. به <\fBhttp://en.wikipedia.org/wiki/Data_URI_scheme\fR> مراجعه کنید.
.PP
برای نمونه، جهت تبدیل یک پرونده GIF که به صورت درون‌خطی داده شده است با \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-i "data:image/gif;base64,R0lGODdhCAAIAMIEAAAAAAAA//8AAP//AP///////////////ywAAAAACAAIAAADF0gEDLojDgdGiJdJqUX02iB4E8Q9jUMkADs=" smiley.png
.Ve
.SS fd
.IX Subsection "fd"
پروتکل دسترسی به توصیف‌کننده پرونده (File descriptor).
.PP
سینتکس پذیرفته‌شده عبارت است از:
.PP
.Vb 1
\&        fd: \-fd <file_descriptor>
.Ve
.PP
اگر \fBfd\fR مشخص نشده باشد، به طور پیش‌فرض توصیف‌کننده پرونده stdout برای نوشتن، و stdin برای خواندن استفاده خواهد شد. بر خلاف پروتکل pipe، پروتکل fd در صورتی که مربوط به یک پرونده معمولی باشد، از قابلیت جستجو (seek) پشتیبانی می‌کند. پروتکل fd به دلایل امنیتی از ارسال توصیف‌کننده پرونده از طریق URL پشتیبانی نمی‌کند.
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBblocksize\fR 4
.IX Item "blocksize"
تنظیم حداکثر اندازه بلوک عملیات I/O، بر حسب بایت. مقدار پیش‌فرض \f(CW\*(C`INT_MAX\*(C'\fR است، که منجر به عدم محدودیت اندازه بلوک درخواستی می‌شود. تنظیم این مقدار روی یک مقدار معقول پایین، زمان واکنش به درخواست قطع عملیات توسط کاربر را بهبود می‌بخشد، که در صورت کند بودن انتقال داده‌ها ارزشمند است.
.IP \fBfd\fR 4
.IX Item "fd"
تنظیم توصیف‌کننده پرونده.
.SS file
.IX Subsection "file"
پروتکل دسترسی به پرونده.
.PP
خواندن از یا نوشتن در یک پرونده.
.PP
یک URL پرونده می‌تواند به این فرم باشد:
.PP
.Vb 1
\&        file:<filename>
.Ve
.PP
که در آن \fIfilename\fR مسیر پرونده برای خواندن است.
.PP
یک URL که پیشوند پروتکل نداشته باشد، به عنوان یک URL پرونده در نظر گرفته می‌شود. بسته به نوع بیلد، یک URL که شبیه به یک مسیر ویندوزی با حرف درایو در ابتدا باشد نیز به عنوان یک URL پرونده در نظر گرفته خواهد شد (معمولاً در بیلدهای سیستم‌های شبه‌یونیکس این‌طور نیست).
.PP
برای نمونه جهت خواندن از یک پرونده \fIinput.mpeg\fR با \fBffmpeg\fR از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        ffmpeg \-i file:input.mpeg output.mpeg
.Ve
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBtruncate\fR 4
.IX Item "truncate"
کوتاه کردن پرونده‌های موجود در هنگام نوشتن، در صورت تنظیم روی 1. مقدار 0 از کوتاه‌سازی جلوگیری می‌کند. مقدار پیش‌فرض 1 است.
.IP \fBblocksize\fR 4
.IX Item "blocksize"
تنظیم حداکثر اندازه بلوک عملیات I/O، بر حسب بایت. مقدار پیش‌فرض \f(CW\*(C`INT_MAX\*(C'\fR است، که منجر به عدم محدودیت اندازه بلوک درخواستی می‌شود. تنظیم این مقدار روی یک اندازه معقول پایین، زمان واکنش به درخواست قطع عملیات توسط کاربر را بهبود می‌بخشد، که برای پرونده‌های روی رسانه‌های کند ارزشمند است.
.IP \fBfollow\fR 4
.IX Item "follow"
اگر روی 1 تنظیم شود، پروتکل خواندن را در انتهای پرونده مجدداً امتحان می‌کند، و اجازه می‌دهد پرونده‌هایی که هنوز در حال نوشتن هستند خوانده شوند. برای پایان یافتن این کار، یا باید از گزینه rw_timeout استفاده کنید، یا از کال‌بک وقفه (برای کاربران API) بهره ببرید. تنظیم این گزینه همچنین اندازه پرونده گزارش‌شده توسط سامانه پرونده را نادیده می‌گیرد.
.IP \fBseekable\fR 4
.IX Item "seekable"
کنترل می‌کند که آیا قابلیت جستجو روی پرونده اعلام شود یا خیر. مقدار 0 به معنی غیرقابل جستجو، و \-1 به معنی خودکار است (قابل جستجو برای پرونده‌های عادی، غیرقابل جستجو برای لوله‌های نام‌گذاری‌شده).
.Sp
بسیاری از دیمکسرها با منابع قابل جستجو و غیرقابل جستجو رفتار متفاوتی دارند؛ بازنویسی این گزینه ممکن است سرعت باز کردن برخی پرونده‌ها را افزایش دهد، البته به بهای از دست دادن برخی ویژگی‌ها (مانند جستجوی دقیق).
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
تنظیم حداکثر اندازه بسته مورداستفاده برای I/O پرونده. مقدار کوچکتر ممکن است مصرف حافظه را کاهش دهد. مقدار بالاتر ممکن است بازده را به ویژه در سامانه‌های پرونده شبکه‌ای افزایش دهد.
.Sp
برای خواندن، در صورت تنظیم صریح، اندازه بافر داخلی پیش‌فرض (32 کیلوبایت) را بازنویسی می‌کند و حداکثر مقدار داده خوانده‌شده در هر عملیات را محدود می‌سازد.
.Sp
برای نوشتن، این گزینه اندازه هر عملیات نوشتن را تعیین می‌کند. مقدار پیش‌فرض ۲۵۶ کیلوبایت برای پرونده‌های معمولی، و ۳۲ کیلوبایت برای سایر موارد است.
.SS ftp
.IX Subsection "ftp"
پروتکل انتقال پرونده (FTP).
.PP
خواندن از یا نوشتن در منابع راه دور با استفاده از پروتکل FTP.
.PP
سینتکس زیر الزامی است:
.PP
.Vb 1
\&        ftp://[user[:password]@]server[:port]/path/to/remote/resource.mpeg
.Ve
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBtimeout\fR 4
.IX Item "timeout"
تنظیم مهلت زمانی بر حسب میکروثانیه برای عملیات سوکت I/O مورد استفاده توسط عملیات سطح پایین زیرین. مقدار پیش‌فرض \-1 است، به این معنی که مهلت زمانی مشخص نشده است.
.IP \fBftp\-user\fR 4
.IX Item "ftp-user"
تنظیم کاربری که برای احراز هویت در سرور FTP استفاده می‌شود. این گزینه توسط کاربر مشخص‌شده در URL پروتکل FTP بازنویسی خواهد شد.
.IP \fBftp\-password\fR 4
.IX Item "ftp-password"
تنظیم رمز عبوری که برای احراز هویت در سرور FTP استفاده می‌شود. این گزینه توسط رمز عبور موجود در URL پروتکل FTP، یا توسط \fBftp\-anonymous\-password\fR در صورت عدم تعیین کاربر، بازنویسی می‌شود.
.IP \fBftp\-anonymous\-password\fR 4
.IX Item "ftp-anonymous-password"
رمز عبور مورد استفاده هنگام ورود به عنوان کاربر ناشناس (anonymous). معمولاً یک آدرس ایمیل باید استفاده شود.
.IP \fBftp\-write\-seekable\fR 4
.IX Item "ftp-write-seekable"
کنترل قابلیت جستجوی اتصال در طول کدگذاری. اگر روی 1 تنظیم شود، فرض می‌شود منبع قابلیت جستجو دارد، اگر روی 0 تنظیم شود، فرض می‌شود قابلیت جستجو ندارد. مقدار پیش‌فرض 0 است.
.PP
نکته: این پروتکل می‌تواند به عنوان خروجی استفاده شود، اما توصیه می‌شود این کار انجام نشود، مگر اینکه احتیاط‌های خاصی لحاظ شده باشد (آزمایش‌ها، پیکربندی سفارشی سرور و غیره). سرورهای مختلف FTP در حین عملیات جستجو رفتار متفاوتی از خود نشان می‌دهند. ابزارهای *ff ممکن است به دلیل محدودیت‌های سرور، محتوای ناقصی تولید کنند.
.SS gopher
.IX Subsection "gopher"
پروتکل گوفر (Gopher).
.SS gophers
.IX Subsection "gophers"
پروتکل گوفرز (Gophers).
.PP
پروتکل گوفر با کپسوله‌سازی TLS.
.SS http
.IX Subsection "http"
پروتکل انتقال ابرمتن (HTTP).
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBseekable\fR 4
.IX Item "seekable"
کنترل قابلیت جستجوی اتصال. اگر روی 1 تنظیم شود، منبع قابل جستجو در نظر گرفته می‌شود، اگر روی 0 تنظیم شود، غیرقابل جستجو فرض می‌شود، و اگر روی \-1 تنظیم شود، تلاش می‌کند تا قابل جستجو بودن را به طور خودکار تشخیص دهد. مقدار پیش‌فرض \-1 است.
.IP \fBchunked_post\fR 4
.IX Item "chunked_post"
در صورت تنظیم روی 1، از حالت قطعه‌بندی‌شده Transfer\-Encoding برای ارسال‌های post استفاده می‌کند، مقدار پیش‌فرض 1 است.
.IP \fBhttp_proxy\fR 4
.IX Item "http_proxy"
تنظیم پروکسی HTTP برای تونل‌زنی، به عنوان مثال http://example.com:1234
.IP \fBheaders\fR 4
.IX Item "headers"
تنظیم هدرهای سفارشی HTTP، می‌تواند هدرهای پیش‌فرض داخلی را بازنویسی کند. مقدار باید رشته‌ای باشد که هدرها را کدگذاری کرده است.
.IP \fBcontent_type\fR 4
.IX Item "content_type"
تنظیم یک نوع محتوای مشخص برای پیام‌های POST یا برای حالت شنود (listen).
.IP \fBuser_agent\fR 4
.IX Item "user_agent"
بازنویسی هدر User\-Agent. در صورت عدم تعیین، پروتکل از رشته‌ای که بیلد libavformat را توصیف می‌کند استفاده خواهد کرد ("Lavf/<version>").
.IP \fBreferer\fR 4
.IX Item "referer"
تنظیم هدر Referer. گنجاندن هدر \*(AqReferer: URL\*(Aq در درخواست HTTP.
.IP \fBmultiple_requests\fR 4
.IX Item "multiple_requests"
استفاده از اتصالات پایدار (Persistent connections) در صورت تنظیم روی 1، مقدار پیش‌فرض 0 است.
.IP \fBrequest_size\fR 4
.IX Item "request_size"
محدود کردن اندازه درخواست‌های ارسال‌شده. این گزینه برای برخی سرورهای ناهنجار که درخواست‌های محدوده (range requests) بدون کران را با افت سرعت (throttle) مواجه می‌کنند، و همچنین هنگام انتظار جستجوهای مکرر، مفید است. به طور پیش‌فرض غیرفعال است (روی 0 تنظیم شده است).
.Sp
توجه داشته باشید که در صورت فعال کردن این گزینه، اکیداً توصیه می‌شود که گزینه \fBmultiple_requests\fR نیز فعال شود و همچنین \fBshort_seek_size\fR روی مقداری برابر یا بالاتر تنظیم گردد. انجام این کار به FFmpeg اجازه می‌دهد تا حد امکان از یک اتصال HTTP منفرد مجدداً استفاده کند.
.IP \fBinitial_request_size\fR 4
.IX Item "initial_request_size"
محدود کردن اندازه درخواست‌های اولیه. مشابه \f(CW\*(C`request_size\*(C'\fR، اما فقط در طول تجزیه اولیه فرمت استفاده می‌شود. برای فرمت‌هایی مانند MXF یا MOV که در حین تجزیه هدر نیازمند جستجوهای مکرر هستند، مفید است. تا زمانی ادامه دارد که دیمکسر یک درخواست خواندن بزرگتر از این اندازه (بدون جستجو در این بین) انجام دهد، و پس از آن پیاده‌سازی طبق معمول به ارسال درخواست‌ها ادامه خواهد داد. به طور پیش‌فرض غیرفعال است (روی 0 تنظیم شده است).
.Sp
توجه داشته باشید که در صورت فعال‌سازی این گزینه، اکیداً توصیه می‌شود گزینه \fBmultiple_requests\fR نیز فعال گردد، و \fBshort_seek_size\fR روی مقداری برابر یا بیشتر تنظیم شود.
.IP \fBpost_data\fR 4
.IX Item "post_data"
تنظیم داده‌های سفارشی HTTP post.
.IP \fBmime_type\fR 4
.IX Item "mime_type"
صادر کردن نوع MIME.
.IP \fBhttp_version\fR 4
.IX Item "http_version"
صادر کردن شماره نسخه پاسخ HTTP. معمولاً "1.0" یا "1.1".
.IP \fBcookies\fR 4
.IX Item "cookies"
تنظیم کوکی‌هایی که باید در درخواست‌های آتی ارسال شوند. فرمت هر کوکی همانند مقدار فیلد پاسخ HTTP با نام Set\-Cookie است. کوکی‌های متعدد می‌توانند با یک نویسه خط جدید جدا شوند.
.IP \fBicy\fR 4
.IX Item "icy"
اگر روی 1 تنظیم شود، متاداده‌های ICY (SHOUTcast) را از سرور درخواست می‌کند. اگر سرور از این ویژگی پشتیبانی کند، برنامه باید متاداده را با خواندن گزینه‌های \fBicy_metadata_headers\fR و \fBicy_metadata_packet\fR بازیابی نماید. مقدار پیش‌فرض 1 است.
.IP \fBicy_metadata_headers\fR 4
.IX Item "icy_metadata_headers"
اگر سرور از متاداده‌های ICY پشتیبانی کند، این گزینه حاوی هدرهای پاسخ HTTP ویژه ICY خواهد بود، که با نویسه‌های خط جدید جدا شده‌اند.
.IP \fBicy_metadata_packet\fR 4
.IX Item "icy_metadata_packet"
اگر سرور از متاداده‌های ICY پشتیبانی کند و \fBicy\fR روی 1 تنظیم شده باشد، این گزینه شامل آخرین بسته متاداده غیرخالی ارسال‌شده توسط سرور خواهد بود. برنامه‌هایی که مایل به دریافت به‌روزرسانی‌های متاداده در میان استریم هستند باید آن را در بازه‌های زمانی منظم بررسی کنند.
.IP \fBmetadata\fR 4
.IX Item "metadata"
تنظیم یک دیکشنری صادرشده حاوی متاداده Icecast از بیت‌استریم، در صورت وجود. فقط با API زبان C کاربرد دارد.
.IP \fBauth_type\fR 4
.IX Item "auth_type"
تنظیم نوع احراز هویت HTTP. گزینه‌ای برای روش احراز هویت Digest وجود ندارد، چرا که این روش ابتدا نیازمند دریافت پارامترهای nonce از سرور است و نمی‌تواند مانند Basic بلافاصله استفاده شود.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
انتخاب خودکار نوع احراز هویت HTTP. این مقدار پیش‌فرض است.
.IP \fBbasic\fR 4
.IX Item "basic"
انتخاب احراز هویت پایه HTTP.
.Sp
احراز هویت پایه یک رشته کدگذاری‌شده با Base64 ارسال می‌کند که شامل نام کاربری و رمز عبور کلاینت است. Base64 شکلی از رمزگذاری نیست و باید معادل ارسال نام کاربری و رمز عبور به صورت متن آشکار در نظر گرفته شود (Base64 یک کدگذاری برگشت‌پذیر است). اگر منبعی نیازمند محافظت است، اکیداً استفاده از یک طرح احراز هویت غیر از احراز هویت پایه را در نظر بگیرید. همراه با احراز هویت پایه باید از HTTPS/TLS استفاده شود. بدون این بهبودهای امنیتی تکمیلی، احراز هویت پایه نباید برای محافظت از اطلاعات حساس یا ارزشمند استفاده گردد.
.RE
.RS 4
.RE
.IP \fBsend_expect_100\fR 4
.IX Item "send_expect_100"
ارسال هدر Expect: 100\-continue برای درخواست‌های POST. اگر روی 1 تنظیم شود ارسال می‌کند، اگر روی 0 تنظیم شود ارسال نخواهد کرد، و اگر روی \-1 تنظیم شود در صورت کاربردی بودن تلاش برای ارسال می‌کند. مقدار پیش‌فرض \-1 است.
.IP \fBlocation\fR 4
.IX Item "location"
یک دیکشنری صادرشده حاوی مکان محتوا. فقط با API زبان C کاربرد دارد.
.IP \fBoffset\fR 4
.IX Item "offset"
تنظیم آفست بایت اولیه.
.IP \fBend_offset\fR 4
.IX Item "end_offset"
تلاش برای محدود کردن درخواست به بایت‌های قبل از این آفست.
.IP \fBmethod\fR 4
.IX Item "method"
هنگامی که به عنوان گزینه کلاینت استفاده شود، متد HTTP را برای درخواست تنظیم می‌کند.
.Sp
هنگامی که به عنوان گزینه سرور استفاده شود، متد HTTP مورد انتظار از کلاینت(ها) را تعیین می‌کند.
اگر متد HTTP مورد انتظار و متد دریافت‌شده یکسان نباشند، پاسخ Bad Request به کلاینت داده خواهد شد.
در صورت عدم تنظیم، در حال حاضر متد HTTP بررسی نمی‌شود. این مورد در آینده با تشخیص خودکار جایگزین خواهد شد.
.IP \fBreconnect\fR 4
.IX Item "reconnect"
اتصال مجدد خودکار در صورت قطع ارتباط پیش از رسیدن به انتهای پرونده (EOF).
.IP \fBreconnect_at_eof\fR 4
.IX Item "reconnect_at_eof"
در صورت تنظیم، با EOF مانند یک خطا رفتار می‌شود و موجب اتصال مجدد می‌گردد؛ این گزینه برای استریم‌های زنده / بی‌پایان کاربردی است.
.IP \fBreconnect_on_network_error\fR 4
.IX Item "reconnect_on_network_error"
اتصال مجدد خودکار در صورت بروز خطاهای TCP/TLS در هنگام اتصال.
.IP \fBreconnect_on_http_error\fR 4
.IX Item "reconnect_on_http_error"
فهرستی جداشده با کاما از کدهای وضعیت HTTP که در صورت وقوع آن‌ها اتصال مجدد برقرار می‌شود. این فهرست می‌تواند شامل کدهای وضعیت خاص (مانند \*(Aq503\*(Aq) یا رشته‌های \*(Aq4xx\*(Aq / \*(Aq5xx\*(Aq باشد.
.IP \fBreconnect_streamed\fR 4
.IX Item "reconnect_streamed"
در صورت تنظیم، حتی جریان‌های جریانی/غیرقابل جستجو در صورت بروز خطا مجدداً متصل خواهند شد.
.IP \fBreconnect_delay_max\fR 4
.IX Item "reconnect_delay_max"
تنظیم حداکثر تأخیر به ثانیه که پس از آن از اتصال مجدد صرف‌نظر می‌شود.
.IP \fBreconnect_max_retries\fR 4
.IX Item "reconnect_max_retries"
تنظیم حداکثر تعداد دفعات تلاش مجدد برای برقراری اتصال. پیش‌فرض تنظیم نشده است.
.IP \fBreconnect_delay_total_max\fR 4
.IX Item "reconnect_delay_total_max"
تنظیم حداکثر تأخیر کل به ثانیه که پس از آن از اتصال مجدد صرف‌نظر می‌شود.
.IP \fBrespect_retry_after\fR 4
.IX Item "respect_retry_after"
در صورت فعال بودن و مواجهه با هدر Retry\-After، تأخیر اتصال مجدد درخواست‌شده در آن رعایت خواهد شد، به جای اینکه از عقب‌نشینی نمایی استفاده شود. برای خطاهای ۴۲۹ و ۵۰۳ مفید است. پیش‌فرض فعال است.
.IP \fBlisten\fR 4
.IX Item "listen"
اگر روی 1 تنظیم شود سرور آزمایشی HTTP را فعال می‌کند. این گزینه می‌تواند برای ارسال داده‌ها هنگام استفاده به عنوان گزینه خروجی، یا خواندن داده‌ها از یک کلاینت با HTTP POST هنگام استفاده به عنوان گزینه ورودی به کار رود.
اگر روی 2 تنظیم شود سرور آزمایشی چندکلاینتی HTTP را فعال می‌کند. این قابلیت هنوز در ffmpeg.c پیاده‌سازی نشده است و بنابراین نباید به عنوان یک گزینه خط فرمان به کار گرفته شود.
.Sp
.Vb 2
\&        # Server side (sending):
\&        ffmpeg \-i somefile.ogg \-c copy \-listen 1 \-f ogg http://<server>:<port>
\&        
\&        # Client side (receiving):
\&        ffmpeg \-i http://<server>:<port> \-c copy somefile.ogg
\&        
\&        # Client can also be done with wget:
\&        wget http://<server>:<port> \-O somefile.ogg
\&        
\&        # Server side (receiving):
\&        ffmpeg \-listen 1 \-i http://<server>:<port> \-c copy somefile.ogg
\&        
\&        # Client side (sending):
\&        ffmpeg \-i somefile.ogg \-chunked_post 0 \-c copy \-f ogg http://<server>:<port>
\&        
\&        # Client can also be done with wget:
\&        wget \-\-post\-file=somefile.ogg http://<server>:<port>
.Ve
.IP \fBresource\fR 4
.IX Item "resource"
منبع درخواست‌شده توسط یک کلاینت، زمانی که سرور آزمایشی HTTP در حال استفاده است.
.IP \fBreply_code\fR 4
.IX Item "reply_code"
کد HTTP بازگردانده‌شده به کلاینت، زمانی که سرور آزمایشی HTTP در حال استفاده است.
.IP \fBshort_seek_size\fR 4
.IX Item "short_seek_size"
تنظیم آستانه بر حسب بایت، برای زمانی که خواندن پیشاپیش (readahead) باید بر جستجو و درخواست جدید HTTP ترجیح داده شود. این به عنوان مثال برای اطمینان از این که از یک اتصال یکسان برای خواندن بسته‌های ویدیویی بزرگ با بسته‌های صوتی کوچک در میان آن‌ها استفاده می‌شود، سودمند است.
.PP
\fIکوکی‌های HTTP (HTTP Cookies)\fR
.IX Subsection "HTTP Cookies"
.PP
برخی درخواست‌های HTTP رد خواهند شد مگر اینکه مقادیر کوکی همراه با درخواست ارسال گردند. گزینه \fBcookies\fR امکان مشخص کردن این کوکی‌ها را فراهم می‌کند. حداقل، هر کوکی باید یک مقدار را به همراه مسیر و دامنه مشخص نماید. درخواست‌های HTTP که هم با دامنه و هم با مسیر مطابقت داشته باشند، به طور خودکار مقدار کوکی را در فیلد هدر HTTP Cookie خواهند گنجاند. چندین کوکی را می‌توان با یک خط جدید از هم تفکیک کرد.
.PP
سینتکس مورد نیاز برای پخش یک جریان با تعیین کوکی به این صورت است:
.PP
.Vb 1
\&        ffplay \-cookies "nlqptid=nltid=tsn; path=/; domain=somedomain.com;" http://somedomain.com/somestream.m3u8
.Ve
.SS Icecast
.IX Subsection "Icecast"
پروتکل Icecast (پخش جریانی به سرورهای Icecast)
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBice_genre\fR 4
.IX Item "ice_genre"
تنظیم سبک (genre) جریان.
.IP \fBice_name\fR 4
.IX Item "ice_name"
تنظیم نام جریان.
.IP \fBice_description\fR 4
.IX Item "ice_description"
تنظیم توضیحات جریان.
.IP \fBice_url\fR 4
.IX Item "ice_url"
تنظیم URL وب‌سایت جریان.
.IP \fBice_public\fR 4
.IX Item "ice_public"
تنظیم اینکه آیا جریان باید عمومی باشد یا خیر.
مقدار پیش‌فرض 0 است (غیرعمومی).
.IP \fBuser_agent\fR 4
.IX Item "user_agent"
بازنویسی هدر User\-Agent. در صورت عدم تعیین، رشته‌ای به فرم "Lavf/<version>" استفاده خواهد شد.
.IP \fBpassword\fR 4
.IX Item "password"
تنظیم رمز عبور نقطه اتصال (mountpoint) در Icecast.
.IP \fBcontent_type\fR 4
.IX Item "content_type"
تنظیم نوع محتوای جریان. در صورتی که متفاوت از audio/mpeg باشد، این گزینه باید تنظیم شود.
.IP \fBlegacy_icecast\fR 4
.IX Item "legacy_icecast"
این گزینه پشتیبانی از نسخه‌های Icecast کمتر از 2.4.0 را فعال می‌کند، که از متد HTTP PUT پشتیبانی نکرده و از متد SOURCE استفاده می‌کنند.
.IP \fBtls\fR 4
.IX Item "tls"
برقراری یک اتصال TLS (HTTPS) به Icecast.
.PP
.Vb 1
\&        icecast://[<username>[:<password>]@]<server>:<port>/<mountpoint>
.Ve
.SS ipfs
.IX Subsection "ipfs"
پشتیبانی از پروتکل سامانه پرونده بین‌سیاره‌ای (IPFS). می‌توان به پرونده‌های ذخیره‌شده در شبکه IPFS از طریق درگاه‌های به اصطلاح گیت‌وی (gateways) دسترسی پیدا کرد. این‌ها نقاط پایانی http(s) هستند. این پروتکل، پروتکل‌های بومی IPFS (یعنی ipfs:// و ipns://) را کپسوله می‌کند تا به چنین گیت‌وی‌هایی ارسال شوند. کاربران می‌توانند (و بهتر است) گره خود را میزبانی نمایند، که بدان معناست این پروتکل برای دسترسی به پرونده‌های موجود در شبکه IPFS از گیت‌وی محلی فرد استفاده خواهد کرد.
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBgateway\fR 4
.IX Item "gateway"
گیت‌وی مورد استفاده را تعریف می‌کند. در صورت عدم تنظیم، پروتکل ابتدا با بررسی \f(CW$IPFS_GATEWAY\fR، \f(CW$IPFS_PATH\fR و \f(CW\*(C`$HOME/.ipfs/\*(C'\fR به ترتیب، تلاش می‌کند گیت‌وی محلی را پیدا کند.
.PP
می‌توان از این پروتکل به ۲ روش استفاده کرد. با استفاده از IPFS:
.PP
.Vb 1
\&        ffplay ipfs://<hash>
.Ve
.PP
یا پروتکل IPNS (که IPNS همان IPFS با قابلیت تغییر است):
.PP
.Vb 1
\&        ffplay ipns://<hash>
.Ve
.SS mmst
.IX Subsection "mmst"
پروتکل MMS (سرور رسانه مایکروسافت) روی TCP.
.SS mmsh
.IX Subsection "mmsh"
پروتکل MMS (سرور رسانه مایکروسافت) روی HTTP.
.PP
سینتکس الزامی عبارت است از:
.PP
.Vb 1
\&        mmsh://<server>[:<port>][/<app>][/<playpath>]
.Ve
.SS md5
.IX Subsection "md5"
پروتکل خروجی MD5.
.PP
هش MD5 داده‌های در حال نوشتن را محاسبه می‌کند، و در زمان بستن، آن را در خروجی تعیین‌شده یا در stdout (در صورت عدم تعیین) می‌نویسد. می‌تواند برای آزمایش مکسرها بدون نوشتن یک پرونده واقعی به کار رود.
.PP
چند مثال در ادامه آمده است:
.PP
.Vb 2
\&        # Write the MD5 hash of the encoded AVI file to the file output.avi.md5.
\&        ffmpeg \-i input.flv \-f avi \-y md5:output.avi.md5
\&        
\&        # Write the MD5 hash of the encoded AVI file to stdout.
\&        ffmpeg \-i input.flv \-f avi \-y md5:
.Ve
.PP
توجه داشته باشید که برخی فرمت‌ها (معمولاً MOV) نیاز دارند که پروتکل خروجی قابلیت جستجو داشته باشد، بنابراین با پروتکل خروجی MD5 با شکست مواجه خواهند شد.
.SS pipe
.IX Subsection "pipe"
پروتکل دسترسی به لوله یونیکس (UNIX pipe).
.PP
خواندن از و نوشتن در لوله‌های یونیکس.
.PP
سینتکس پذیرفته‌شده عبارت است از:
.PP
.Vb 1
\&        pipe:[<number>]
.Ve
.PP
اگر \fBfd\fR مشخص نشده باشد، \fInumber\fR عددی است که با توصیف‌کننده پرونده لوله مطابقت دارد (مثلاً 0 برای stdin، 1 برای stdout، 2 برای stderr). اگر \fInumber\fR مشخص نشده باشد، به طور پیش‌فرض توصیف‌کننده پرونده stdout برای نوشتن، و stdin برای خواندن استفاده خواهد شد.
.PP
برای مثال برای خواندن از stdin با \fBffmpeg\fR:
.PP
.Vb 3
\&        cat test.wav | ffmpeg \-i pipe:0
\&        # ...this is the same as...
\&        cat test.wav | ffmpeg \-i pipe:
.Ve
.PP
برای نوشتن در stdout با \fBffmpeg\fR:
.PP
.Vb 3
\&        ffmpeg \-i test.wav \-f avi pipe:1 | cat > test.avi
\&        # ...this is the same as...
\&        ffmpeg \-i test.wav \-f avi pipe: | cat > test.avi
.Ve
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBblocksize\fR 4
.IX Item "blocksize"
تنظیم حداکثر اندازه بلوک عملیات I/O، بر حسب بایت. مقدار پیش‌فرض \f(CW\*(C`INT_MAX\*(C'\fR است، که به معنی عدم محدود کردن اندازه بلوک درخواستی است. تنظیم این مقدار روی یک مقدار معقول پایین، زمان واکنش به درخواست توقف توسط کاربر را بهبود می‌بخشد، که در صورت کند بودن انتقال داده‌ها سودمند است.
.IP \fBfd\fR 4
.IX Item "fd"
تنظیم توصیف‌کننده پرونده.
.PP
توجه داشته باشید که برخی فرمت‌ها (معمولاً MOV) نیاز دارند که پروتکل خروجی قابلیت جستجو داشته باشد، بنابراین با پروتکل خروجی pipe با شکست مواجه خواهند شد.
.SS prompeg
.IX Subsection "prompeg"
پروتکل FEC مطابق Pro\-MPEG Code of Practice #3 Release 2.
.PP
پروتکل Pro\-MPEG CoP#3 FEC یک سازوکار تصحیح خطای رو به جلو (FEC) با بررسی توازن ۲ بعدی برای جریان‌های انتقال MPEG\-2 ارسال‌شده روی RTP است.
.PP
این پروتکل باید در ارتباط با مکسر \f(CW\*(C`rtp_mpegts\*(C'\fR و پروتکل \f(CW\*(C`rtp\*(C'\fR استفاده شود.
.PP
سینتکس مورد نیاز به این شکل است:
.PP
.Vb 1
\&        \-f rtp_mpegts \-fec prompeg=<option>=<val>... rtp://<hostname>:<port>
.Ve
.PP
پورت‌های UDP مقصد برابر \f(CW\*(C`port + 2\*(C'\fR برای جریان FEC ستونی و \f(CW\*(C`port + 4\*(C'\fR برای جریان FEC سطری هستند.
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBl=\fR\fIn\fR 4
.IX Item "l=n"
تعداد ستون‌ها (4\-20، LxD <= 100)
.IP \fBd=\fR\fIn\fR 4
.IX Item "d=n"
تعداد سطرها (4\-20، LxD <= 100)
.PP
نمونه کاربرد:
.PP
.Vb 1
\&        \-f rtp_mpegts \-fec prompeg=l=8:d=4 rtp://<hostname>:<port>
.Ve
.SS rist
.IX Subsection "rist"
پروتکل انتقال مطمئن جریان اینترنتی (RIST).
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBrist_profile\fR 4
.IX Item "rist_profile"
مقادیر پشتیبانی‌شده:
.RS 4
.IP \fBsimple\fR 4
.IX Item "simple"
.PD 0
.IP \fBmain\fR 4
.IX Item "main"
.PD
این مورد پیش‌فرض است.
.IP \fBadvanced\fR 4
.IX Item "advanced"
.RE
.RS 4
.RE
.IP \fBbuffer_size\fR 4
.IX Item "buffer_size"
تنظیم اندازه بافر داخلی RIST بر حسب میلی‌ثانیه برای ارسال مجدد داده‌ها.
مقدار پیش‌فرض 0 است که به معنای پیش‌فرض librist (۱ ثانیه) می‌باشد. حداکثر مقدار ۳۰ ثانیه است.
.IP \fBfifo_size\fR 4
.IX Item "fifo_size"
اندازه بافر خروجی fifo گیرنده librist بر حسب تعداد بسته‌ها. این مقدار باید توانی از ۲ باشد.
پیش‌فرض 8192 است (در مقابل پیش‌فرض 1024 کتابخانه librist).
.IP "\fBoverrun_nonfatal=\fR\fI1|0\fR" 4
.IX Item "overrun_nonfatal=1|0"
ادامه کار در صورت سرریز بافر fifo کتابخانه librist. مقدار پیش‌فرض 0 است.
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
تنظیم حداکثر اندازه بسته برای ارسال داده‌ها. به طور پیش‌فرض 1316 است.
.IP \fBlog_level\fR 4
.IX Item "log_level"
تنظیم سطح ثبت وقایع (log level) برای پیام‌های لاگ RIST. شما تنها زمانی به تنظیم این گزینه نیاز دارید که به طور صریح بخواهید پیام‌های سطح دیباگ یا شبیه‌سازی از دست رفتن بسته را فعال کنید، در غیر این صورت سطح لاگ عادی رعایت می‌شود.
.IP \fBsecret\fR 4
.IX Item "secret"
تنظیم بازنویسی رمز اختصاصی رمزگذاری، به طور پیش‌فرض تنظیم نشده است.
.IP \fBencryption\fR 4
.IX Item "encryption"
تنظیم نوع رمزگذاری، به طور پیش‌فرض غیرفعال است.
مقادیر قابل قبول 128 و 256 هستند.
.SS rtmp
.IX Subsection "rtmp"
پروتکل پیام‌رسانی بلادرنگ (RTMP).
.PP
پروتکل پیام‌رسانی بلادرنگ (RTMP) برای پخش جریانی محتوای چندرسانه‌ای در یک شبکه TCP/IP به کار می‌رود.
.PP
سینتکس مورد نیاز به شرح زیر است:
.PP
.Vb 1
\&        rtmp://[<username>:<password>@]<server>[:<port>][/<app>][/<instance>][/<playpath>]
.Ve
.PP
پارامترهای پذیرفته‌شده عبارتند از:
.IP \fBusername\fR 4
.IX Item "username"
یک نام کاربری اختیاری (بیشتر برای انتشار محتوا).
.IP \fBpassword\fR 4
.IX Item "password"
یک رمز عبور اختیاری (بیشتر برای انتشار محتوا).
.IP \fBserver\fR 4
.IX Item "server"
آدرس سرور RTMP.
.IP \fBport\fR 4
.IX Item "port"
شماره پورت TCP مورد استفاده (پیش‌فرض 1935 است).
.IP \fBapp\fR 4
.IX Item "app"
نام برنامه‌ای است که باید به آن دسترسی پیدا کرد. معمولاً با مسیری که برنامه روی سرور RTMP در آن نصب شده مطابقت دارد (مانند \fI/ondemand/\fR، \fI/flash/live/\fR و غیره). شما می‌توانید مقدار تجزیه‌شده از URI را از طریق گزینه \f(CW\*(C`rtmp_app\*(C'\fR نیز بازنویسی نمایید.
.IP \fBplaypath\fR 4
.IX Item "playpath"
مسیر یا نام منبعی است که با ارجاع به برنامه مشخص‌شده در \fIapp\fR باید پخش شود، و ممکن است پیشوند "mp4:" داشته باشد. شما می‌توانید مقدار تجزیه‌شده از URI را از طریق گزینه \f(CW\*(C`rtmp_playpath\*(C'\fR نیز بازنویسی کنید.
.IP \fBlisten\fR 4
.IX Item "listen"
عمل به عنوان یک سرور، و گوش دادن به اتصالات ورودی.
.IP \fBtimeout\fR 4
.IX Item "timeout"
حداکثر زمان انتظار برای اتصال ورودی. متضمن گزینه listen است.
.PP
علاوه بر این، پارامترهای زیر می‌توانند از طریق گزینه‌های خط فرمان (یا در کد از طریق \f(CW\*(C`AVOption\*(C'\fRها) تنظیم شوند:
.IP \fBrtmp_app\fR 4
.IX Item "rtmp_app"
نام برنامه برای اتصال در سرور RTMP. این گزینه پارامتر مشخص‌شده در URI را بازنویسی می‌کند.
.IP \fBrtmp_buffer\fR 4
.IX Item "rtmp_buffer"
تنظیم زمان بافر کلاینت بر حسب میلی‌ثانیه. پیش‌فرض 3000 است.
.IP \fBrtmp_conn\fR 4
.IX Item "rtmp_conn"
پارامترهای اتصال دلخواه و اختیاری AMF، که از یک رشته تجزیه می‌شوند، مثلاً مانند \f(CW\*(C`B:1 S:authMe O:1 NN:code:1.23 NS:flag:ok O:0\*(C'\fR.
هر مقدار با یک نویسه تکی مشخص‌کننده نوع شروع می‌شود: B برای بولی، N برای عدد، S برای رشته، O برای شیء (object)، یا Z برای تهی (null)، که به دنبال آن یک دو‌نقطه می‌آید. برای متغیرهای بولی داده‌ها باید 0 یا 1 به ترتیب برای نادرست (FALSE) یا درست (TRUE) باشند. به همین ترتیب برای شیء، داده‌ها باید 0 یا 1 به ترتیب برای پایان یا شروع یک شیء باشند. اقلام داده در اشیاء فرعی می‌توانند نام‌گذاری شوند، با پیشوند کردن نوع با \*(AqN\*(Aq و مشخص کردن نام قبل از مقدار (یعنی \f(CW\*(C`NB:myFlag:1\*(C'\fR). این گزینه ممکن است چندین بار برای ساخت توالی‌های دلخواه AMF استفاده شود.
.IP \fBrtmp_enhanced_codecs\fR 4
.IX Item "rtmp_enhanced_codecs"
مشخص کردن فهرستی از کدک‌هایی که کلاینت اعلام می‌کند در یک جریان بهبودیافته RTMP پشتیبانی می‌کند. این گزینه باید روی یک فهرست جداشده با کاما از مقادیر fourcc تنظیم شود، مانند \f(CW\*(C`hvc1,av01,vp09\*(C'\fR برای چند کدک یا \f(CW\*(C`hvc1\*(C'\fR برای فقط یک کدک. فهرست مشخص‌شده در مشخصه "fourCcLive" از پیام Connect Command Message ارائه خواهد شد.
.IP \fBrtmp_flashver\fR 4
.IX Item "rtmp_flashver"
نسخه پلاگین فلش مورداستفاده برای اجرای پخش‌کننده SWF. مقدار پیش‌فرض LNX 9,0,124,2 است. (هنگام انتشار، مقدار پیش‌فرض FMLE/3.0 (compatible; <libavformat version>) است).
.IP \fBrtmp_flush_interval\fR 4
.IX Item "rtmp_flush_interval"
تعداد بسته‌های تخلیه‌شده در یک درخواست مشترک (فقط در RTMPT). پیش‌فرض 10 است.
.IP \fBrtmp_live\fR 4
.IX Item "rtmp_live"
مشخص کردن اینکه آیا رسانه یک جریان زنده است یا خیر. در جریان‌های زنده ازسرگیری یا جستجو امکان‌پذیر نیست. مقدار پیش‌فرض \f(CW\*(C`any\*(C'\fR است، که به این معنی است مشترک ابتدا تلاش می‌کند جریان زنده مشخص‌شده در playpath را پخش کند. اگر جریان زنده‌ای با آن نام پیدا نشود، جریان ضبط‌شده را پخش می‌نماید. مقادیر ممکن دیگر \f(CW\*(C`live\*(C'\fR و \f(CW\*(C`recorded\*(C'\fR هستند.
.IP \fBrtmp_pageurl\fR 4
.IX Item "rtmp_pageurl"
آدرس وب‌سایتی که رسانه در آن جاسازی شده است. به طور پیش‌فرض هیچ مقداری ارسال نخواهد شد.
.IP \fBrtmp_playpath\fR 4
.IX Item "rtmp_playpath"
شناسه جریان برای پخش یا انتشار. این گزینه پارامتر مشخص‌شده در URI را بازنویسی می‌کند.
.IP \fBrtmp_subscribe\fR 4
.IX Item "rtmp_subscribe"
نام جریان زنده برای اشتراک. به طور پیش‌فرض هیچ مقداری ارسال نخواهد شد. این مقدار تنها در صورتی ارسال می‌شود که این گزینه مشخص شده باشد یا rtmp_live روی live تنظیم شده باشد.
.IP \fBrtmp_swfhash\fR 4
.IX Item "rtmp_swfhash"
هش SHA256 پرونده SWF غیرفشرده (۳۲ بایت).
.IP \fBrtmp_swfsize\fR 4
.IX Item "rtmp_swfsize"
اندازه پرونده SWF غیرفشرده، مورد نیاز برای SWFVerification.
.IP \fBrtmp_swfurl\fR 4
.IX Item "rtmp_swfurl"
نشانی اینترنتی پخش‌کننده SWF برای رسانه. به طور پیش‌فرض هیچ مقداری ارسال نخواهد شد.
.IP \fBrtmp_swfverify\fR 4
.IX Item "rtmp_swfverify"
نشانی اینترنتی پرونده swf پخش‌کننده، جهت محاسبه خودکار هش/اندازه.
.IP \fBrtmp_tcurl\fR 4
.IX Item "rtmp_tcurl"
نشانی اینترنتی جریان هدف. مقدار پیش‌فرض proto://host[:port]/app است.
.IP "\fBtcp_nodelay=\fR\fI1|0\fR" 4
.IX Item "tcp_nodelay=1|0"
تنظیم TCP_NODELAY برای غیرفعال کردن الگوریتم Nagle. مقدار پیش‌فرض 0 است.
.Sp
\fIیادداشت: نوشتن روی سوکت در حال حاضر برای به حداقل رساندن فراخوانی‌های سیستم بهینه‌سازی نشده است و بازدهی / اثر TCP_NODELAY را کاهش می‌دهد.\fR
.IP "\fBtcp_keepalive=\fR\fI1|0\fR" 4
.IX Item "tcp_keepalive=1|0"
فعال کردن سازوکار TCP keepalive برای شناسایی طرف‌های ارتباطی غیرفعال و کمک به حفظ اتصالات بی‌کار طولانی‌مدت. مقدار پیش‌فرض 0 است.
.Sp
تنها گزینه پایه‌ای keepalive (SO_KEEPALIVE) می‌تواند فعال یا غیرفعال شود. پارامترهای تنظیم دقیق وابسته به پلتفرم مانند TCP_KEEPIDLE، TCP_KEEPINTVL یا TCP_KEEPCNT قابل پیکربندی نیستند و از مقادیر پیش‌فرض سیستم عامل استفاده خواهند کرد.
.PP
برای نمونه برای خواندن یک منبع چندرسانه‌ای به نام "sample" از برنامه "vod" از سرور RTMP به نشانی "myserver" با \fBffplay\fR:
.PP
.Vb 1
\&        ffplay rtmp://myserver/vod/sample
.Ve
.PP
برای انتشار در سروری محافظت‌شده با رمز عبور، با ارسال جداگانه نام‌های playpath و app:
.PP
.Vb 1
\&        ffmpeg \-re \-i <input> \-f flv \-rtmp_playpath some/long/path \-rtmp_app long/app/name rtmp://username:password@myserver/
.Ve
.SS rtmpe
.IX Subsection "rtmpe"
پروتکل پیام‌رسانی بلادرنگ رمزگذاری‌شده (RTMPE).
.PP
پروتکل پیام‌رسانی بلادرنگ رمزگذاری‌شده (RTMPE) برای پخش جریانی محتوای چندرسانه‌ای در قالب مولفه‌های استاندارد رمزنگاری، متشکل از تبادل کلید دیفی\-هلمن و HMACSHA256، و تولید یک جفت کلید RC4 استفاده می‌شود.
.SS rtmps
.IX Subsection "rtmps"
پروتکل پیام‌رسانی بلادرنگ روی یک اتصال امن SSL.
.PP
پروتکل پیام‌رسانی بلادرنگ (RTMPS) برای پخش جریانی محتوای چندرسانه‌ای در یک اتصال رمزگذاری‌شده استفاده می‌شود.
.SS rtmpt
.IX Subsection "rtmpt"
پروتکل پیام‌رسانی بلادرنگ تونل‌شده از طریق HTTP.
.PP
پروتکل پیام‌رسانی بلادرنگ تونل‌شده از طریق HTTP (RTMPT) برای پخش جریانی محتوای چندرسانه‌ای در قالب درخواست‌های HTTP به منظور عبور از فایروال‌ها استفاده می‌شود.
.SS rtmpte
.IX Subsection "rtmpte"
پروتکل پیام‌رسانی بلادرنگ رمزگذاری‌شده تونل‌شده از طریق HTTP.
.PP
پروتکل پیام‌رسانی بلادرنگ رمزگذاری‌شده تونل‌شده از طریق HTTP (RTMPTE) برای پخش جریانی محتوای چندرسانه‌ای درون درخواست‌های HTTP به منظور عبور از فایروال‌ها استفاده می‌شود.
.SS rtmpts
.IX Subsection "rtmpts"
پروتکل پیام‌رسانی بلادرنگ تونل‌شده از طریق HTTPS.
.PP
پروتکل پیام‌رسانی بلادرنگ تونل‌شده از طریق HTTPS (RTMPTS) برای پخش جریانی محتوای چندرسانه‌ای درون درخواست‌های HTTPS برای عبور از فایروال‌ها استفاده می‌شود.
.SS libsmbclient
.IX Subsection "libsmbclient"
کتابخانه libsmbclient به فرد امکان می‌دهد منابع شبکه‌ای CIFS/SMB را مدیریت کند.
.PP
سینتکس زیر الزامی است:
.PP
.Vb 1
\&        smb://[[domain:]user[:password@]]server[/share[/path[/file]]]
.Ve
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBtimeout\fR 4
.IX Item "timeout"
تنظیم مهلت زمانی بر حسب میلی‌ثانیه برای عملیات سوکت I/O مورد استفاده توسط عملیات سطح پایین زیرین. مقدار پیش‌فرض \-1 است، به این معنی که مهلت زمانی مشخص نشده است.
.IP \fBtruncate\fR 4
.IX Item "truncate"
کوتاه کردن پرونده‌های موجود در هنگام نوشتن، در صورت تنظیم روی 1. مقدار 0 از کوتاه‌سازی جلوگیری می‌کند. مقدار پیش‌فرض 1 است.
.IP \fBworkgroup\fR 4
.IX Item "workgroup"
تنظیم workgroup مورد استفاده برای برقراری اتصالات. به طور پیش‌فرض workgroup مشخص نشده است.
.PP
برای اطلاعات بیشتر به <\fBhttp://www.samba.org\fR> مراجعه کنید.
.SS libssh
.IX Subsection "libssh"
پروتکل انتقال امن پرونده (SFTP) از طریق libssh
.PP
خواندن از یا نوشتن در منابع راه‌دور با استفاده از پروتکل SFTP.
.PP
سینتکس زیر الزامی است:
.PP
.Vb 1
\&        sftp://[user[:password]@]server[:port]/path/to/remote/resource.mpeg
.Ve
.PP
این پروتکل گزینه‌های زیر را می‌پذیرد:
.IP \fBtimeout\fR 4
.IX Item "timeout"
تنظیم مهلت زمانی عملیات ورودی/خروجی (I/O) سوکت مورد استفاده در عملیات سطح پایین زیرین. به‌طور پیش‌فرض روی \-1 تنظیم شده است، به این معنی که مهلت زمانی مشخص نشده است.
.IP \fBtruncate\fR 4
.IX Item "truncate"
کوتاه‌سازی (Truncate) پرونده‌های موجود هنگام نوشتن، در صورتی که روی 1 تنظیم شود. مقدار 0 مانع از کوتاه‌سازی می‌شود. مقدار پیش‌فرض 1 است.
.IP \fBprivate_key\fR 4
.IX Item "private_key"
تعیین مسیر پرونده حاوی کلید خصوصی برای استفاده در احراز هویت. به‌طور پیش‌فرض libssh کلیدها را در دایرکتوری \fI~/.ssh/\fR جستجو می‌کند.
.PP
مثال: پخش یک پرونده ذخیره‌شده در یک سرور راه‌دور:
.PP
.Vb 1
\&        ffplay sftp://user:password@server_address:22/home/user/resource.mpeg
.Ve
.SS "librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte"
.IX Subsection "librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte"
پروتکل پیام‌رسانی بلادرنگ (RTMP) و انواع آن که از طریق librtmp پشتیبانی می‌شوند.
.PP
نیازمند وجود هدرها و کتابخانه librtmp در زمان پیکربندی است. باید ساخت را صراحتاً با "\-\-enable\-librtmp" پیکربندی کنید. در صورت فعال بودن، این گزینه جایگزین پروتکل بومی RTMP خواهد شد.
.PP
این پروتکل اکثر توابع کلاینت و چند تابع سرور مورد نیاز برای پشتیبانی از RTMP، پروتکل RTMP تانل‌شده در HTTP (RTMPT)، پروتکل RTMP رمزگذاری‌شده (RTMPE)، پروتکل RTMP بر روی SSL/TLS (RTMPS) و انواع تانل‌شده این ساختارهای رمزگذاری‌شده (RTMPTE، RTMPTS) را فراهم می‌کند.
.PP
سینتکس الزامی به صورت زیر است:
.PP
.Vb 1
\&        <rtmp_proto>://<server>[:<port>][/<app>][/<playpath>] <options>
.Ve
.PP
که در آن \fIrtmp_proto\fR یکی از رشته‌های "rtmp"، "rtmpt"، "rtmpe"، "rtmps"، "rtmpte" یا "rtmpts" متناظر با هر نوع از پروتکل RTMP است، و \fIserver\fR، \fIport\fR، \fIapp\fR و \fIplaypath\fR معنای یکسانی با آنچه برای پروتکل بومی RTMP مشخص شده است دارند. \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با فاصله از یکدیگر جدا شده‌اند.
.PP
برای اطلاعات بیشتر به صفحه راهنمای librtmp (دستور man 3 librtmp) مراجعه کنید.
.PP
به عنوان مثال، برای پخش جریانی یک پرونده به صورت بلادرنگ به یک سرور RTMP با استفاده از \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-re \-i myfile \-f flv rtmp://myserver/live/mystream
.Ve
.PP
برای پخش همان جریان با استفاده از \fBffplay\fR:
.PP
.Vb 1
\&        ffplay "rtmp://myserver/live/mystream live=1"
.Ve
.SS rtp
.IX Subsection "rtp"
پروتکل انتقال بلادرنگ (RTP \- Real\-time Transport Protocol).
.PP
سینتکس الزامی برای نشانی (URL) در پروتکل RTP:
.PP
.Vb 1
\&        rtp://<hostname>[:<port>][?<options>]
.Ve
.PP
شناسه \fIport\fR پورت RTP مورد استفاده را تعیین می‌کند.
.PP
شناسه \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر جدا شده‌اند. برای اسکیپ کردن کلیدها و مقادیر می‌توان از کدگذاری درصدی استاندارد (percent\-encoding) و علامت مثبت برای فاصله استفاده کرد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا در کد از طریق \f(CW\*(C`AVOption\*(C'\fRها) نیز تعیین کرد.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP \fBttl=\fR\fIn\fR 4
.IX Item "ttl=n"
تنظیم مقدار TTL (طول عمر) (تنها برای چندپخشی / مالتی‌کست).
.IP \fBrtcpport=\fR\fIn\fR 4
.IX Item "rtcpport=n"
تنظیم پورت RTCP راه‌دور روی \fIn\fR.
.IP "\fBlocalport, local_rtpport, localrtpport=\fR\fIn\fR" 4
.IX Item "localport, local_rtpport, localrtpport=n"
تنظیم پورت RTP محلی روی \fIn\fR.
.Sp
استفاده از نام گزینه localport منسوخ شده است و نباید استفاده شود.
.IP "\fBlocal_rtcpport, localrtcpport=\fR\fIn\fR\fB\*(Aq\fR" 4
.IX Item "local_rtcpport, localrtcpport=n'"
تنظیم پورت RTCP محلی روی \fIn\fR.
.IP \fBpkt_size=\fR\fIn\fR 4
.IX Item "pkt_size=n"
تنظیم حداکثر اندازه بسته (به بایت) روی \fIn\fR.
.IP \fBbuffer_size=\fR\fIsize\fR 4
.IX Item "buffer_size=size"
تنظیم حداکثر اندازه بافر سوکت UDP به بایت.
.IP \fBconnect=0|1\fR 4
.IX Item "connect=0|1"
اجرای دستور \f(CWconnect()\fR بر روی سوکت UDP (در صورت تنظیم روی 1) یا عدم اجرای آن (در صورت تنظیم روی 0).
.IP \fBsources=\fR\fIip\fR\fB[,\fR\fIip\fR\fB]\fR 4
.IX Item "sources=ip[,ip]"
فهرست آدرس‌های IP مجاز مبدأ.
.IP \fBblock=\fR\fIip\fR\fB[,\fR\fIip\fR\fB]\fR 4
.IX Item "block=ip[,ip]"
فهرست آدرس‌های IP مسدودشده (غیرمجاز) مبدأ.
.IP \fBwrite_to_source=0|1\fR 4
.IX Item "write_to_source=0|1"
ارسال بسته‌ها به آدرس مبدأ آخرین بسته دریافت‌شده (در صورت تنظیم روی 1) یا به یک آدرس راه‌دور پیش‌فرض (در صورت تنظیم روی 0).
.IP \fBlocaladdr=\fR\fIaddr\fR 4
.IX Item "localaddr=addr"
آدرس IP محلی رابط شبکه‌ای که برای ارسال بسته‌ها یا پیوستن به گروه‌های مالتی‌کست استفاده می‌شود.
.IP \fBtimeout=\fR\fIn\fR 4
.IX Item "timeout=n"
تنظیم مهلت زمانی (به میکروثانیه) برای عملیات ورودی/خروجی سوکت روی \fIn\fR.
.PP
نکات مهم:
.IP 1. 4
اگر \fBrtcpport\fR تنظیم نشده باشد، پورت RTCP روی مقدار پورت RTP به علاوه 1 تنظیم خواهد شد.
.IP 2. 4
اگر \fBlocalrtpport\fR (پورت RTP محلی) تنظیم نشده باشد، هر پورت در دسترسی برای پورت‌های محلی RTP و RTCP استفاده خواهد شد.
.IP 3. 4
اگر \fBlocalrtcpport\fR (پورت RTCP محلی) تنظیم نشده باشد، روی مقدار پورت محلی RTP به علاوه 1 تنظیم خواهد شد.
.SS rtsp
.IX Subsection "rtsp"
پروتکل جاری‌سازی بلادرنگ (RTSP \- Real\-Time Streaming Protocol).
.PP
از لحاظ فنی RTSP یک گرداننده پروتکل در libavformat نیست، بلکه یک دی‌ماکسر و ماکسر است. دی‌ماکسر از هر دو حالت RTSP استاندارد (با داده‌های منتقل‌شده روی RTP؛ که به عنوان مثال توسط اپل و مایکروسافت استفاده می‌شود) و Real\-RTSP (با داده‌های منتقل‌شده روی RDT) پشتیبانی می‌کند.
.PP
ماکسر می‌تواند برای ارسال یک جریان با استفاده از دستور RTSP ANNOUNCE به سروری که از آن پشتیبانی می‌کند استفاده شود (در حال حاضر Darwin Streaming Server و سرور Mischa Spiegelmock به نشانی <\fBhttps://github.com/revmischa/rtsp\-server\fR>).
.PP
سینتکس الزامی برای یک URL در پروتکل RTSP:
.PP
.Vb 1
\&        rtsp://<hostname>[:<port>]/<path>
.Ve
.PP
گزینه‌ها را می‌توان در خط فرمان \fBffmpeg\fR/\fBffplay\fR، یا در کد از طریق \f(CW\*(C`AVOption\*(C'\fRها یا در تابع \f(CW\*(C`avformat_open_input\*(C'\fR تنظیم کرد.
.PP
\fIMuxer\fR
.IX Subsection "Muxer"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.IP \fBrtsp_transport\fR 4
.IX Item "rtsp_transport"
تنظیم پروتکل‌های انتقال RTSP.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBudp\fR 4
.IX Item "udp"
استفاده از UDP به عنوان پروتکل انتقال لایه زیرین.
.IP \fBtcp\fR 4
.IX Item "tcp"
استفاده از TCP (درهم‌تنیدگی درون کانال کنترلی RTSP) به عنوان پروتکل انتقال لایه زیرین.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fB0\fR است.
.RE
.IP \fBrtsp_flags\fR 4
.IX Item "rtsp_flags"
تنظیم فلگ‌های RTSP.
.Sp
مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBlatm\fR 4
.IX Item "latm"
استفاده از بسته‌بندی MP4A\-LATM به جای MPEG4\-GENERIC برای کدک صوتی AAC.
.IP \fBrfc2190\fR 4
.IX Item "rfc2190"
استفاده از بسته‌بندی RFC 2190 به جای RFC 4629 برای H.263.
.IP \fBskip_rtcp\fR 4
.IX Item "skip_rtcp"
گزارش‌های فرستنده RTCP ارسال نشوند.
.IP \fBh264_mode0\fR 4
.IX Item "h264_mode0"
استفاده از حالت 0 برای H.264 در پروتکل RTP.
.IP \fBsend_bye\fR 4
.IX Item "send_bye"
ارسال بسته‌های RTCP BYE هنگام اتمام کار.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fB0\fR است.
.RE
.IP \fBmin_port\fR 4
.IX Item "min_port"
تنظیم حداقل پورت محلی UDP. مقدار پیش‌فرض 5000 است.
.IP \fBmax_port\fR 4
.IX Item "max_port"
تنظیم حداکثر پورت محلی UDP. مقدار پیش‌فرض 65000 است.
.IP \fBbuffer_size\fR 4
.IX Item "buffer_size"
تنظیم حداکثر اندازه بافر سوکت به بایت.
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
تنظیم حداکثر اندازه بسته ارسالی (به بایت). مقدار پیش‌فرض 1472 است.
.PP
\fIDemuxer\fR
.IX Subsection "Demuxer"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.IP \fBinitial_pause\fR 4
.IX Item "initial_pause"
در صورت تنظیم روی 1، پخش جریان بلافاصله آغاز نمی‌شود. مقدار پیش‌فرض 0 است.
.IP \fBrtsp_transport\fR 4
.IX Item "rtsp_transport"
تنظیم پروتکل‌های انتقال RTSP.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBudp\fR 4
.IX Item "udp"
استفاده از UDP به عنوان پروتکل انتقال لایه زیرین.
.IP \fBtcp\fR 4
.IX Item "tcp"
استفاده از TCP (درهم‌تنیدگی درون کانال کنترلی RTSP) به عنوان پروتکل انتقال لایه زیرین.
.IP \fBudp_multicast\fR 4
.IX Item "udp_multicast"
استفاده از چندپخشی (مالتی‌کست) UDP به عنوان پروتکل انتقال لایه زیرین.
.IP \fBhttp\fR 4
.IX Item "http"
استفاده از تانل HTTP به عنوان پروتکل انتقال لایه زیرین، که برای عبور از پراکسی‌ها مفید است.
.IP \fBhttps\fR 4
.IX Item "https"
استفاده از تانل HTTPS به عنوان پروتکل انتقال لایه زیرین، که برای عبور از پراکسی‌ها مفید است و کاربرد گسترده‌ای در ملاحظات امنیتی دارد.
.RE
.RS 4
.Sp
می‌توان چندین پروتکل انتقال زیرین را مشخص کرد؛ در این حالت آن‌ها یکی‌یکی امتحان می‌شوند (اگر برپایی یکی شکست بخورد، پروتکل بعدی امتحان می‌شود). برای ماکسر، فقط گزینه‌های \fBtcp\fR و \fBudp\fR پشتیبانی می‌شوند.
.RE
.IP \fBrtsp_flags\fR 4
.IX Item "rtsp_flags"
تنظیم فلگ‌های RTSP.
.Sp
مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBfilter_src\fR 4
.IX Item "filter_src"
پذیرش بسته‌ها صرفاً از آدرس و پورت همتای مذاکره‌شده.
.IP \fBlisten\fR 4
.IX Item "listen"
عمل کردن به عنوان سرور و گوش دادن به اتصالات ورودی.
.IP \fBprefer_tcp\fR 4
.IX Item "prefer_tcp"
در صورتی که TCP برای انتقال RTP در RTSP در دسترس باشد، ابتدا TCP امتحان شود.
.IP \fBsatip_raw\fR 4
.IX Item "satip_raw"
صدور جریان خام MPEG\-TS به جای دی‌ماکس کردن. این پرچم صرفاً جریان خام را با PAT/PMT/PIDهای دست‌نخورده اصلی می‌نویسد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBnone\fR است.
.RE
.IP \fBallowed_media_types\fR 4
.IX Item "allowed_media_types"
تنظیم انواع رسانه مجاز برای پذیرش از سرور.
.Sp
فلگ‌های زیر پذیرفته می‌شوند:
.RS 4
.IP \fBvideo\fR 4
.IX Item "video"
.PD 0
.IP \fBaudio\fR 4
.IX Item "audio"
.IP \fBdata\fR 4
.IX Item "data"
.IP \fBsubtitle\fR 4
.IX Item "subtitle"
.PD
.RE
.RS 4
.Sp
به‌طور پیش‌فرض تمام انواع رسانه پذیرفته می‌شوند.
.RE
.IP \fBmin_port\fR 4
.IX Item "min_port"
تنظیم حداقل پورت محلی UDP. مقدار پیش‌فرض 5000 است.
.IP \fBmax_port\fR 4
.IX Item "max_port"
تنظیم حداکثر پورت محلی UDP. مقدار پیش‌فرض 65000 است.
.IP \fBlisten_timeout\fR 4
.IX Item "listen_timeout"
تنظیم حداکثر مهلت زمانی (به ثانیه) برای برقراری اتصال اولیه. تنظیم مقدار بزرگ‌تر از صفر برای \fBlisten_timeout\fR باعث تنظیم گزینه \fBrtsp_flags\fR روی \fBlisten\fR می‌شود. پیش‌فرض \-1 است که به معنی مهلت زمانی نامحدود در هنگام فعال بودن حالت \fBlisten\fR می‌باشد.
.IP \fBreorder_queue_size\fR 4
.IX Item "reorder_queue_size"
تنظیم تعداد بسته‌ها در بافر برای مدیریت بسته‌های نامرتب‌شده.
.IP \fBtimeout\fR 4
.IX Item "timeout"
تنظیم مهلت زمانی ورودی/خروجی سوکت TCP به میکروثانیه.
.IP \fBuser_agent\fR 4
.IX Item "user_agent"
بازنویسی هدر User\-Agent. اگر مشخص نشود، رشته شناسه libavformat به عنوان پیش‌فرض قرار می‌گیرد.
.IP \fBbuffer_size\fR 4
.IX Item "buffer_size"
تنظیم حداکثر اندازه بافر سوکت به بایت.
.PP
هنگام دریافت داده روی UDP، دی‌ماکسر تلاش می‌کند تا بسته‌های دریافتی را بازآرایی و مرتب کند (چرا که ممکن است نامرتب برسند یا کاملاً مفقود شوند). این رفتار را می‌توان با تنظیم حداکثر تأخیر دی‌ماکس روی صفر (از طریق فیلد \f(CW\*(C`max_delay\*(C'\fR در ساختار AVFormatContext) غیرفعال کرد.
.PP
هنگام تماشای جریان‌های چندنرخ‌بیتی Real\-RTSP با استفاده از \fBffplay\fR، جریان‌های نمایشی را می‌توان به ترتیب با \f(CW\*(C`\-vst\*(C'\fR \fIn\fR و \f(CW\*(C`\-ast\*(C'\fR \fIn\fR برای تصویر و صدا مشخص کرد، و می‌توان با فشردن کلیدهای \f(CW\*(C`v\*(C'\fR و \f(CW\*(C`a\*(C'\fR آن‌ها را در حین پخش تغییر داد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
مثال‌های زیر همگی از ابزارهای \fBffplay\fR و \fBffmpeg\fR بهره می‌برند:
.IP \(bu 4
تماشای یک جریان روی UDP با حداکثر تأخیر بازآرایی 0.5 ثانیه:
.Sp
.Vb 1
\&        ffplay \-max_delay 500000 \-rtsp_transport udp rtsp://server/video.mp4
.Ve
.IP \(bu 4
تماشای یک جریان تانل‌شده روی HTTP:
.Sp
.Vb 1
\&        ffplay \-rtsp_transport http rtsp://server/video.mp4
.Ve
.IP \(bu 4
ارسال یک جریان به صورت بلادرنگ به سرور RTSP، جهت تماشای دیگران:
.Sp
.Vb 1
\&        ffmpeg \-re \-i <input> \-f rtsp \-muxdelay 0.1 rtsp://server/live.sdp
.Ve
.IP \(bu 4
دریافت یک جریان به صورت بلادرنگ:
.Sp
.Vb 1
\&        ffmpeg \-rtsp_flags listen \-i rtsp://ownaddress/live.sdp <output>
.Ve
.SS sap
.IX Subsection "sap"
پروتکل اعلان نشست یا Session Announcement Protocol (RFC 2974). این ساختار از نظر فنی یک گرداننده پروتکل در libavformat نیست، بلکه یک ماکسر و دی‌ماکسر است. برای سیگنال‌دهی جریان‌های RTP از طریق اعلان منظم فایل‌های SDP برای جریان‌ها روی یک پورت مجزا استفاده می‌شود.
.PP
\fIMuxer\fR
.IX Subsection "Muxer"
.PP
سینتکس یک URL پروتکل SAP داده‌شده به ماکسر:
.PP
.Vb 1
\&        sap://<destination>[:<port>][?<options>]
.Ve
.PP
بسته‌های RTP به نشانی \fIdestination\fR روی پورت \fIport\fR، یا پورت 5004 در صورت عدم تعیین پورت ارسال می‌شوند. پارامتر \fIoptions\fR فهرستی جداشده با \f(CW\*(C`&\*(C'\fR است. گزینه‌های زیر پشتیبانی می‌شوند:
.IP \fBannounce_addr=\fR\fIaddress\fR 4
.IX Item "announce_addr=address"
تعیین آدرس IP مقصد برای ارسال اعلان‌ها به آن. در صورت حذف، اعلان‌ها به آدرس مالتی‌کست متداول اعلان SAP یعنی 224.2.127.254 (sap.mcast.net)، یا ff0e::2:7ffe در صورتی که \fIdestination\fR یک آدرس IPv6 باشد ارسال می‌شوند.
.IP \fBannounce_port=\fR\fIport\fR 4
.IX Item "announce_port=port"
تعیین پورت برای ارسال اعلان‌ها؛ در صورت مشخص نشدن به طور پیش‌فرض 9875 است.
.IP \fBttl=\fR\fIttl\fR 4
.IX Item "ttl=ttl"
تعیین مقدار طول عمر (TTL) برای اعلان‌ها و بسته‌های RTP؛ مقدار پیش‌فرض 255 است.
.IP \fBsame_port=\fR\fI0|1\fR 4
.IX Item "same_port=0|1"
در صورت تنظیم روی 1، تمام جریان‌های RTP روی یک جفت پورت مشترک ارسال می‌شوند. اگر روی صفر باشد (پیش‌فرض)، هر جریان روی پورتی یکتا ارسال می‌شود، به طوری که هر جریان روی پورتی با 2 شماره بالاتر از جریان قبلی ارسال می‌گردد.
ابزارهای VLC/Live555 برای دریافت جریان نیازمند این هستند که این گزینه روی 1 تنظیم شده باشد. پشته RTP در libavformat جهت دریافت نیازمند آن است که تمام جریان‌ها روی پورت‌های یکتا ارسال شوند.
.PP
دستورات نمونه در ادامه آمده است:
.PP
پخش همگانی یک جریان روی زیرشبکه محلی جهت مشاهده در VLC:
.PP
.Vb 1
\&        ffmpeg \-re \-i <input> \-f sap sap://224.0.0.255?same_port=1
.Ve
.PP
به طور مشابه، برای تماشا در \fBffplay\fR:
.PP
.Vb 1
\&        ffmpeg \-re \-i <input> \-f sap sap://224.0.0.255
.Ve
.PP
و برای تماشا در \fBffplay\fR روی بستر IPv6:
.PP
.Vb 1
\&        ffmpeg \-re \-i <input> \-f sap sap://[ff0e::1:2:3:4]
.Ve
.PP
\fIDemuxer\fR
.IX Subsection "Demuxer"
.PP
سینتکس یک URL پروتکل SAP داده‌شده به دی‌ماکسر:
.PP
.Vb 1
\&        sap://[<address>][:<port>]
.Ve
.PP
پارامتر \fIaddress\fR آدرس مالتی‌کست برای گوش دادن به اعلان‌ها است؛ در صورت حذف، آدرس پیش‌فرض 224.2.127.254 (sap.mcast.net) استفاده می‌شود. پارامتر \fIport\fR پورتی است که روی آن گوش داده می‌شود؛ در صورت حذف 9875 است.
.PP
دی‌ماکسر روی آدرس و پورت مشخص‌شده به اعلان‌ها گوش می‌دهد. به محض دریافت یک اعلان، سعی می‌کند آن جریان خاص را دریافت کند.
.PP
دستورات نمونه در ادامه آمده است:
.PP
پخش اولین جریان اعلان‌شده روی آدرس مالتی‌کست معمول SAP:
.PP
.Vb 1
\&        ffplay sap://
.Ve
.PP
پخش اولین جریان اعلان‌شده روی آدرس مالتی‌کست پیش‌فرض IPv6 برای SAP:
.PP
.Vb 1
\&        ffplay sap://[ff0e::2:7ffe]
.Ve
.SS sctp
.IX Subsection "sctp"
پروتکل انتقال کنترل جریان (SCTP \- Stream Control Transmission Protocol).
.PP
سینتکس پذیرفته‌شده URL:
.PP
.Vb 1
\&        sctp://<host>:<port>[?<options>]
.Ve
.PP
شناسه \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر جدا شده‌اند. برای فرار کلیدها و مقادیر می‌توان از کدگذاری استاندارد درصدی (و علامت مثبت برای فاصله) استفاده کرد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا در کد با \f(CW\*(C`AVOption\*(C'\fRها) نیز تعیین نمود.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP \fBlisten\fR 4
.IX Item "listen"
در صورت تنظیم روی هر مقداری، برای اتصال ورودی گوش می‌دهد. اتصال خروجی به صورت پیش‌فرض انجام می‌شود.
.IP \fBmax_streams\fR 4
.IX Item "max_streams"
تنظیم حداکثر تعداد جریان‌ها. به‌طور پیش‌فرض هیچ محدودیتی تعیین نشده است.
.SS shared
.IX Subsection "shared"
پوشش حافظه پنهان (کَش) امن از نظر ریسه (Thread\-safe)، پایدار و بین‌فرایندی برای جریان‌های ورودی. جریان ورودی را در پرونده‌ای درون دایرکتوری مشخص‌شده کش می‌کند. این پروتکل شبیه به \fBcache\fR است، با این تفاوت که یک کش پایدار روی دیسک دارد که می‌تواند بین چندین فرایند یا دی‌ماکسر حتی به صورت هم‌زمان به اشتراک گذاشته شود.
.PP
نام پرونده کش از درهم‌سازی (هش کردن) URL ورودی به دست می‌آید؛ بنابراین اگر یک URL یکسان برای محتواهای مختلف استفاده شود (مثلاً در نتیجه استفاده از داده‌های POST اضافی برای انتخاب شناسه جریان)، مقداری خطر تداخل وجود دارد. برای جلوگیری از این مشکل، اطمینان حاصل کنید که از این پروتکل صرفاً برای URLهایی استفاده می‌کنید که محتوا را به شکل یکتا شناسایی می‌کنند؛ در غیر این صورت ممکن است ترکیبی به‌هم‌ریخته از منابع دریافت کنید.
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBcache_dir\fR 4
.IX Item "cache_dir"
مسیر دایرکتوری محل ذخیره پرونده‌های کش. این گزینه الزامی است.
.IP \fBblock_shift\fR 4
.IX Item "block_shift"
ضریب انتقال منطقی (log2) اندازه بلوک مورد استفاده برای خواندن/نوشتن‌های داخلی. پیش‌فرض 15 است، یعنی بلوک‌های 32 کیلوبایتی. اگر این مقدار با مقداری که هنگام ایجاد پرونده کش موجود مشخص شده مطابقت نداشته باشد، مقدار مشخص‌شده قبلی به جای آن استفاده خواهد شد.
.IP \fBread_only\fR 4
.IX Item "read_only"
اگر درست (true) باشد، از کش اشتراکی برای خواندن استفاده می‌کند اما هیچ بلوک جدیدی روی آن نمی‌نویسد. پیش‌فرض نادرست (false) است. توجه داشته باشید که حتی با فعال بودن این گزینه، اگر پرونده کش از قبل وجود نداشته باشد، مقداردهی اولیه خواهد شد.
.IP \fBcache_verify\fR 4
.IX Item "cache_verify"
اگر درست (true) باشد، هر داده‌ای که از کش خوانده می‌شود را در برابر جریان ورودی زیرین اعتبارسنجی کرده و هرگونه عدم تطابق را گزارش می‌دهد. توجه داشته باشید که این کار عملاً لایه کش را بی‌فایده می‌سازد. این گزینه صرفاً برای اشکال‌زدایی است.
.IP \fBcache_timeout\fR 4
.IX Item "cache_timeout"
در صورت تنظیم روی یک مقدار غیرصفر، حداکثر زمان (به میکروثانیه) را برای انتظار در دسترس قرار گرفتن داده‌ها مشخص می‌کند، در صورتی که فرایند دیگری هم‌زمان در تلاش برای دریافت و کش کردن همان بلوک باشد. اگر این مهلت به پایان برسد، فرض می‌شود که فرایند دیگر ممکن است در این فاصله متوقف شده یا متلاشی شده باشد.
.Sp
اگر روی صفر تنظیم شود، هیچ انتظاری انجام نمی‌شود و تمام فرایندها بلافاصله برای واکشی همان بلوک‌های گم‌شده توسط خودشان به رقابت می‌پردازند. پیش‌فرض 10000 (10 میلی‌ثانیه) است.
.IP \fBretry_errors\fR 4
.IX Item "retry_errors"
اگر درست باشد (پیش‌فرض)، خطاهای موقت خواندن از جریان ورودی زیرین نادیده گرفته شده و مجدداً تلاش می‌شود. اگر نادرست باشد، هر بلوکی که خواندن از آن پیش‌تر ناموفق بوده به عنوان غیرقابل دسترسی دائمی در نظر گرفته می‌شود.
.PP
سینتکس URL به صورت زیر است:
.PP
.Vb 1
\&        shared:<URL>
.Ve
.SS srt
.IX Subsection "srt"
پروتکل انتقال مطمئن و امن های‌ویژن (SRT) از طریق libsrt.
.PP
سینتکس پشتیبانی‌شده برای نشانی اینترنتی SRT:
.PP
.Vb 1
\&        srt://<hostname>:<port>[?<options>]
.Ve
.PP
بخش \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر جدا شده‌اند. برای گریز (اسکیپ) از کاراکترهای کلیدها و مقادیر می‌توان از کدگذاری استاندارد درصدی (و استفاده از علامت مثبت برای فاصله) بهره برد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا در کد با استفاده از \f(CW\*(C`AVOption\*(C'\fRها) نیز تعیین کرد.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP \fBconnect_timeout=\fR\fImilliseconds\fR 4
.IX Item "connect_timeout=milliseconds"
مهلت زمانی اتصال؛ پروتکل SRT با مهلت زمانی پیش‌فرض اتصال ۳ ثانیه‌ای نمی‌تواند برای RTT بزرگ‌تر از ۱۵۰۰ میلی‌ثانیه (۲ تبادل دست‌تکانی) متصل شود. این گزینه بر حالت‌های اتصال caller و rendezvous اعمال می‌گردد. مهلت زمانی اتصال ۱۰ برابر مقداری است که برای حالت rendezvous تنظیم شده است (که می‌تواند به عنوان یک راهکار موقت برای این مشکل اتصال در نسخه‌های قدیمی‌تر استفاده شود).
.IP \fBffs=\fR\fIbytes\fR 4
.IX Item "ffs=bytes"
اندازه پرچم پرواز یا اندازه پنجره (Flight Flag Size)، بر حسب بایت. پارامتر FFS در واقع یک پارامتر داخلی است و نباید آن را کمتر از \fBrecv_buffer_size\fR و \fBmss\fR تنظیم کنید. مقدار پیش‌فرض آن نسبتاً بزرگ است؛ بنابراین مگر در حالتی که بافر گیرنده بسیار بزرگی تنظیم کنید، نیازی به تغییر این گزینه نخواهید داشت. مقدار پیش‌فرض ۲۵۶۰۰ است.
.IP \fBinputbw=\fR\fIbytes/seconds\fR 4
.IX Item "inputbw=bytes/seconds"
نرخ ورودی اسمی فرستنده، بر حسب بایت بر ثانیه. همراه با \fBoheadbw\fR زمانی که \fBmaxbw\fR روی نسبی (0) تنظیم شده باشد برای محاسبه حداکثر نرخ ارسال در هنگام ارسال بسته‌های بازیابی در کنار جریان اصلی رسانه استفاده می‌شود:
\&\fBinputbw\fR * (100 + \fBoheadbw\fR) / 100
اگر \fBinputbw\fR تعیین نشده باشد در حالی که \fBmaxbw\fR روی نسبی (0) تنظیم است، نرخ ورودی واقعی درون کتابخانه محاسبه می‌گردد. مقدار پیش‌فرض 0 است.
.IP \fBiptos=\fR\fItos\fR 4
.IX Item "iptos=tos"
نوع سرویس IP (IP Type of Service). صرفاً بر فرستنده اعمال می‌شود. مقدار پیش‌فرض 0xB8 است.
.IP \fBipttl=\fR\fIttl\fR 4
.IX Item "ipttl=ttl"
طول عمر IP (IP Time To Live). صرفاً بر فرستنده اعمال می‌شود. مقدار پیش‌فرض 64 است.
.IP \fBlatency=\fR\fImicroseconds\fR 4
.IX Item "latency=microseconds"
تأخیر تحویل بسته مبتنی بر برچسب زمان (Timestamp).
برای مهار کردن جهش‌های ارسال مجدد بسته‌های از دست‌رفته استفاده می‌شود.
این پرچم هر دو گزینه \fBrcvlatency\fR و \fBpeerlatency\fR را روی مقداری یکسان تنظیم می‌کند. توجه داشته باشید که پیش از نسخه 1.3.0 این تنها پرچم برای تنظیم تأخیر بود؛ با این حال این گزینه عملاً معادل تنظیم \fBpeerlatency\fR در زمانی است که سمت مربوطه فرستنده باشد و \fBrcvlatency\fR زمانی که سمت مربوطه گیرنده باشد، و ارسال جریان دوطرفه پشتیبانی نمی‌شود.
.IP \fBlisten_timeout=\fR\fImicroseconds\fR 4
.IX Item "listen_timeout=microseconds"
تنظیم مهلت زمانی گوش دادن سوکت.
.IP \fBmaxbw=\fR\fIbytes/seconds\fR 4
.IX Item "maxbw=bytes/seconds"
حداکثر پهنای باند ارسال، بر حسب بایت بر ثانیه.
\-1 نامحدود (سقف CSRTCC برابر ۳۰ مگابیت بر ثانیه است)
0 نسبی با نرخ ورودی (به \fBinputbw\fR مراجعه کنید)
>0 مقدار سقف مطلق
مقدار پیش‌فرض 0 (نسبی) است.
.IP \fBmode=\fR\fIcaller|listener|rendezvous\fR 4
.IX Item "mode=caller|listener|rendezvous"
حالت اتصال.
\&\fBcaller\fR اتصال کلاینت را باز می‌کند.
\&\fBlistener\fR سرور را برای گوش دادن به اتصالات ورودی راه‌اندازی می‌کند.
\&\fBrendezvous\fR از حالت اتصال دونقطه‌ای Rendez\-Vous استفاده می‌کند.
مقدار پیش‌فرض caller است.
.IP \fBmss=\fR\fIbytes\fR 4
.IX Item "mss=bytes"
حداکثر اندازه سگمنت (Maximum Segment Size)، بر حسب بایت. برای تخصیص بافر و محاسبه نرخ با استفاده از شمارنده بسته با فرض بسته‌های کاملاً پر استفاده می‌شود. کوچک‌ترین MSS میان دو نقطه همتا استفاده خواهد شد. این مقدار در کل اینترنت به صورت پیش‌فرض 1500 است. این مقدار حداکثر اندازه بسته UDP است و تنها می‌تواند کاهش یابد، مگر اینکه از پیکربندی‌های شبکه اختصاصی خاصی استفاده نمایید. مقدار پیش‌فرض 1500 است.
.IP \fBnakreport=\fR\fI1|0\fR 4
.IX Item "nakreport=1|0"
اگر روی 1 تنظیم شود، گیرنده پیام‌های \`UMSG_LOSSREPORT\` را به صورت دوره‌ای ارسال می‌کند تا بسته مفقودشده مجدداً مخابره شود یا عمداً نادیده گرفته شود. مقدار پیش‌فرض 1 است.
.IP \fBoheadbw=\fR\fIpercents\fR 4
.IX Item "oheadbw=percents"
سربار پهنای باند بازیابی فراتر از نرخ ورودی، به درصد.
به \fBinputbw\fR مراجعه کنید. مقدار پیش‌فرض 25% است.
.IP \fBpassphrase=\fR\fIstring\fR 4
.IX Item "passphrase=string"
عبارت عبور رمزگذاری/رمزگشایی HaiCrypt، با طول ۱۰ تا ۷۹ نویسه. عبارت عبور یک راز مشترک میان فرستنده و گیرنده است. برای تولید کلید رمزنگاریِ کلید با بهره‌گیری از PBKDF2 (تابع اشتقاق کلید مبتنی بر گذرواژه) استفاده می‌شود. تنها در صورتی به کار می‌رود که \fBpbkeylen\fR غیرصفر باشد. در گیرنده تنها زمانی استفاده می‌شود که داده‌های دریافتی رمزنگاری شده باشند. عبارت عبور پیکربندی‌شده قابل بازیابی نیست (صرفاً نوشتنی است).
.IP \fBenforced_encryption=\fR\fI1|0\fR 4
.IX Item "enforced_encryption=1|0"
در صورت تعیین به عنوان درست (true)، هر دو طرف اتصال باید عبارت عبور یکسانی تنظیم کرده باشند (از جمله گذرواژه خالی، یعنی بدون رمزگذاری). اگر گذرواژه مطابقت نداشته باشد یا تنها یک سمت رمزگذاری‌نشده باشد، اتصال رد می‌شود. پیش‌فرض درست (true) است.
.IP \fBkmrefreshrate=\fR\fIpackets\fR 4
.IX Item "kmrefreshrate=packets"
تعداد بسته‌های ارسالی که پس از آن کلید رمزگذاری به یک کلید جدید سوئیچ می‌شود. پیش‌فرض \-1 است.
مقدار \-1 به معنای خودکار است (0x1000000 در کتابخانه srt). دامنه این گزینه اعداد صحیح در بازه 0 تا \f(CW\*(C`INT_MAX\*(C'\fR می‌باشد.
.IP \fBkmpreannounce=\fR\fIpackets\fR 4
.IX Item "kmpreannounce=packets"
فاصله زمانی میان ارسال کلید رمزگذاری جدید و زمان رخداد سوئیچ به آن. این مقدار همچنین بر فاصله بعدی میان زمان سوئیچ و زمان منسوخ شدن کلید رمزگذاری قدیمی نیز اعمال می‌گردد. پیش‌فرض \-1 است.
مقدار \-1 به معنای خودکار است (0x1000 در کتابخانه srt). دامنه این گزینه اعداد صحیح در بازه 0 تا \f(CW\*(C`INT_MAX\*(C'\fR می‌باشد.
.IP \fBsnddropdelay=\fR\fImicroseconds\fR 4
.IX Item "snddropdelay=microseconds"
تأخیر اضافه فرستنده پیش از دور انداختن بسته‌ها. این تأخیر به مقدار فاصله زمانی پیش‌فرض دور انداختن اضافه می‌شود.
.Sp
مقدار ویژه \-1: بسته‌ها به هیچ وجه در فرستنده دور انداخته نشوند.
.IP \fBpayload_size=\fR\fIbytes\fR 4
.IX Item "payload_size=bytes"
حداکثر اندازه اعلام‌شده بسته‌ای را تعیین می‌کند که در طی یک فراخوانی واحد به تابع ارسال در حالت زنده (Live) منتقل می‌شود. اگر این مقدار استفاده نمی‌شود مقدار 0 را وارد کنید (که در حالت فایلی پیش‌فرض است).
پیش‌فرض \-1 (خودکار) است، که معمولاً نمایانگر MPEG\-TS می‌باشد؛ اگر قصد دارید از SRT برای ارسال هر نوع دیگری از محتوا استفاده کنید، برای نمونه قرار دادن یک جریان زنده در فریم‌های بسیار کوچک، می‌توانید از حداکثر اندازه فریم بزرگ‌تری استفاده کنید، هرچند نباید از 1456 بایت بیشتر باشد.
.IP \fBpkt_size=\fR\fIbytes\fR 4
.IX Item "pkt_size=bytes"
نام مستعار برای گزینه \fBpayload_size\fR.
.IP \fBpeerlatency=\fR\fImicroseconds\fR 4
.IX Item "peerlatency=microseconds"
مقدار تأخیر (مشابه آنچه در \fBrcvlatency\fR تشریح شد) که توسط سمت فرستنده به عنوان حداقل مقدار برای گیرنده تعیین می‌شود.
.IP \fBpbkeylen=\fR\fIbytes\fR 4
.IX Item "pbkeylen=bytes"
طول کلید رمزنگاری فرستنده، بر حسب بایت.
تنها می‌تواند روی 0، 16، 24 و 32 تنظیم شود.
در صورتی که غیر از 0 باشد رمزگذاری فرستنده را فعال می‌کند.
در گیرنده الزامی نیست (روی 0 تنظیم می‌شود)؛ اندازه کلید در دست‌تکانی HaiCrypt از فرستنده دریافت می‌گردد.
مقدار پیش‌فرض 0 است.
.IP \fBrcvlatency=\fR\fImicroseconds\fR 4
.IX Item "rcvlatency=microseconds"
زمانی که باید از لحظه ارسال بسته تا لحظه تحویل آن به برنامه گیرنده در تابع دریافت سپری گردد.
این زمان باید بافری به قدر کافی بزرگ باشد تا زمان صرف‌شده برای ارسال، زمان RTT به شکلی نامنتظره افزایش‌یافته، و زمان لازم برای ارسال مجدد بسته گمشده UDP را پوشش دهد. مقدار تأخیر مؤثر برابر با بیشینه مقدار این گزینه و مقدار \fBpeerlatency\fR تعیین‌شده توسط طرف مقابل خواهد بود. پیش از نسخه 1.3.0 این گزینه تنها با نام \fBlatency\fR در دسترس بود.
.IP \fBrecv_buffer_size=\fR\fIbytes\fR 4
.IX Item "recv_buffer_size=bytes"
تنظیم اندازه بافر دریافت UDP، بر حسب بایت.
.IP \fBsend_buffer_size=\fR\fIbytes\fR 4
.IX Item "send_buffer_size=bytes"
تنظیم اندازه بافر ارسال UDP، بر حسب بایت.
.IP \fBtimeout=\fR\fImicroseconds\fR 4
.IX Item "timeout=microseconds"
تنظیم مهلت‌های زمانی ایجاد خطا برای عملیات خواندن، نوشتن و اتصال. دقت کنید که کتابخانه SRT مهلت‌های زمانی داخلی دارد که می‌توانند به شکل مجزا کنترل شوند؛ مقدار تعیین‌شده در اینجا تنها یک سقف برای آن‌ها است.
.IP \fBtlpktdrop=\fR\fI1|0\fR 4
.IX Item "tlpktdrop=1|0"
دور انداختن بسته‌های بیش از حد تأخیریافته (Too\-late Packet Drop). در صورت فعال بودن در سمت گیرنده، بسته‌های گم‌شده‌ای را که به موقع تحویل داده نشده‌اند نادیده می‌گیرد و به محض رسیدن زمان پخش بسته‌های بعدی، آن‌ها را به برنامه تحویل می‌دهد. همچنین یک پاسخ تأیید ساختگی (fake ACK) به فرستنده ارسال می‌کند. هنگامی که در فرستنده فعال باشد و در همتای گیرنده نیز فعال گردد، فرستنده بسته‌های قدیمی‌تری را که شانسی برای رسیدن به موقع ندارند دور می‌اندازد. در صورتی که گیرنده از آن پشتیبانی کند، این قابلیت به طور خودکار در فرستنده فعال می‌شد.
.IP \fBsndbuf=\fR\fIbytes\fR 4
.IX Item "sndbuf=bytes"
تنظیم اندازه بافر ارسال، بر حسب بایت.
.IP \fBrcvbuf=\fR\fIbytes\fR 4
.IX Item "rcvbuf=bytes"
تنظیم اندازه بافر دریافت، بر حسب بایت.
.Sp
بافر دریافت نباید از \fBffs\fR بزرگ‌تر باشد.
.IP \fBlossmaxttl=\fR\fIpackets\fR 4
.IX Item "lossmaxttl=packets"
مقداری که تحمل بی‌نظمی (Reorder Tolerance) می‌تواند تا آن رشد کند. هنگامی که تحمل بی‌نظمی بزرگ‌تر از 0 باشد، گزارش مفقودی بسته تا زمانی که آن تعداد بسته دریافت شوند به تأخیر می‌افتد. تحمل بی‌نظمی هر بار که یک بسته "دیرهنگام" می‌رسد که به دلیل مخابره مجدد نبوده است (یعنی وقتی بسته‌های UDP معمولاً نامرتب می‌رسند)، به اندازه تفاوت میان آخرین شماره توالی و شماره توالی این بسته افزایش می‌یابد، و نباید بیشتر از مقدار این گزینه باشد. به صورت پیش‌فرض 0 است، به این معنی که این سازوکار غیرفعال بوده و گزارش مفقودی همیشه بلافاصله پس از بروز هرگونه "شکاف" در توالی‌ها ارسال می‌شود.
.IP \fBminversion\fR 4
.IX Item "minversion"
حداقل نسخه SRT که از سمت همتا مورد نیاز است. اتصال به همتایی که این حداقل نسخه را برآورده نکند پذیرفته نخواهد شد.
.Sp
قالب نسخه در هگز به صورت 0xXXYYZZ برای x.y.z در شکل خوانای انسانی است.
.IP \fBstreamid=\fR\fIstring\fR 4
.IX Item "streamid=string"
رشته‌ای با حداکثر ۵۱۲ نویسه که می‌تواند پیش از اتصال روی سوکت تنظیم شود. این شناسه جریان می‌تواند توسط سمت شنونده از سوکتی که توسط srt_accept بازگردانده شده و توسط سوکتی با این شناسه متصل گردیده، بازیابی شود. پروتکل SRT هیچ تفسیر خاصی بر روی محتویات این رشته اعمال نمی‌کند.
این گزینه در اتصال Rendezvous بی‌معنی است؛ نتیجه ممکن است صرفاً این باشد که یکی از طرفین مقدار طرف دیگر را بازنویسی کند و این که کدام یک حفظ شود تصادفی است.
.IP \fBsrt_streamid=\fR\fIstring\fR 4
.IX Item "srt_streamid=string"
نام مستعار برای \fBstreamid\fR به منظور جلوگیری از تداخل با گزینه خط فرمان ffmpeg.
.IP \fBsmoother=\fR\fIlive|file\fR 4
.IX Item "smoother=live|file"
نوع هموارساز (Smoother) مورد استفاده برای انتقال روی آن سوکت، که مسئول انتقال و کنترل ازدحام است. نوع Smoother باید در هر دو طرف اتصال دقیقاً یکسان باشد، در غیر این صورت اتصال رد خواهد شد.
.IP \fBmessageapi=\fR\fI1|0\fR 4
.IX Item "messageapi=1|0"
در صورت فعال بودن، این سوکت از رابط کاربری پیام (Message API) استفاده می‌کند، در غیر این صورت از رابط بافر (Buffer API) استفاده خواهد کرد. توجه داشته باشید که در حالت زنده (به گزینه \fBtranstype\fR مراجعه کنید) تنها Message API موجود است. در حالت فایلی می‌توانید یکی از دو حالت زیر را انتخاب نمایید:
.Sp
رابط کاربری جریان یا Stream API (حالت پیش‌فرض، زمانی که این گزینه نادرست باشد): در این حالت می‌توانید با یک دستور ارسال به هر میزان که مایلید داده ارسال کنید، یا حتی از توابع اختصاصی برای خواندن مستقیم از فایل استفاده نمایید. سازوکار داخلی کنترل سرعت و ترافیک را مدیریت خواهد کرد. در هنگام دریافت نیز می‌توانید هر اندازه داده را که مایلید واکشی کنید؛ داده‌های استخراج‌نشده برای فراخوانی بعدی منتظر خواهند ماند. در حالت جریانی هیچ مرزی میان بخش‌های داده وجود ندارد.
.Sp
رابط کاربری پیام یا Message API: در این حالت تک دستور ارسالی شما دقیقاً یک قطعه داده دارای مرز مشخص (یک پیام) را منتقل می‌کند. بر خلاف حالت زنده، این پیام می‌تواند در میان چندین بسته UDP گسترش یابد و تنها محدودیت اندازه آن، جا شدن کامل آن در بافر ارسال است. گیرنده باید از بافری به قدر کافی بزرگ برای دریافت پیام بهره ببرد، در غیر این صورت پیام تحویل داده نخواهد شد. در صورتی که پیام ناقص باشد (تمام بسته‌ها نرسیده باشند یا بسته‌ای گم شده باشد) تحویل داده نخواهد شد.
.IP \fBtranstype=\fR\fIlive|file\fR 4
.IX Item "transtype=live|file"
تنظیم نوع انتقال برای سوکت؛ به ویژه تعیین این گزینه چندین پارامتر دیگر را روی مقادیر پیش‌فرض آن‌ها مطابق با الزامات یک نوع انتقال خاص تنظیم می‌نماید.
.Sp
حالت live: گزینه‌ها را مشابه انتقال زنده تنظیم می‌کند. در این حالت باید در هر دستور ارسال تنها به میزانی داده ارسال کنید که درون یک بسته UDP جا شود، و محدود به مقداری باشد که در ابتدا در \fBpayload_size\fR تعریف شده است (مقدار 1316 در این حالت پیش‌فرض است). هیچ کنترل سرعتی در این حالت وجود ندارد و تنها کنترل پهنای باند وجود دارد، در صورتی که تنظیم شده باشد، تا پهنای باند فراتر از ارسال‌های سربار (بسته‌های کنترلی و ارسال مجدد) نرود.
.Sp
حالت file: گزینه‌ها را برای انتقال غیرزنده تنظیم می‌نماید. برای توضیحات تکمیلی به \fBmessageapi\fR مراجعه کنید.
.IP \fBlinger=\fR\fIseconds\fR 4
.IX Item "linger=seconds"
تعداد ثانیه‌هایی که سوکت هنگام بسته شدن در انتظار داده‌های ارسال‌نشده می‌ماند. مقدار پیش‌فرض \-1 است. مقدار \-1 به مفهوم خودکار است (خاموش با 0 ثانیه در حالت زنده، روشن با 180 ثانیه در حالت فایلی). دامنه مقادیر برای این گزینه اعداد صحیح در بازه 0 تا \f(CW\*(C`INT_MAX\*(C'\fR می‌باشد.
.IP \fBtsbpd=\fR\fI1|0\fR 4
.IX Item "tsbpd=1|0"
در صورت فعال بودن، از حالت تحویل بسته مبتنی بر برچسب زمان (Timestamp\-based Packet Delivery) استفاده می‌کند. رفتار پیش‌فرض وابسته به نوع انتقال است: در حالت زنده فعال و در حالت فایلی غیرفعال می‌باشد.
.IP \fBipv6only=\fR\fI1|0\fR 4
.IX Item "ipv6only=1|0"
پذیرش یا عدم پذیرش IPv4 در زمان استفاده از آدرس همه‌پذیر (wildcard) در بستر IPv6. این مورد باید هنگام گوش دادن روی آدرس همه‌پذیر IPv6 تنظیم شود.
.PP
برای اطلاعات بیشتر ببینید: <\fBhttps://github.com/Haivision/srt\fR>.
.SS srtp
.IX Subsection "srtp"
پروتکل امن انتقال بلادرنگ (SRTP \- Secure Real\-time Transport Protocol).
.PP
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \fBsrtp_in_suite\fR 4
.IX Item "srtp_in_suite"
.PD 0
.IP \fBsrtp_out_suite\fR 4
.IX Item "srtp_out_suite"
.PD
انتخاب مجموعه‌های رمزنگاری ورودی و خروجی.
.Sp
مقادیر پشتیبانی‌شده:
.RS 4
.IP \fBAES_CM_128_HMAC_SHA1_80\fR 4
.IX Item "AES_CM_128_HMAC_SHA1_80"
.PD 0
.IP \fBSRTP_AES128_CM_HMAC_SHA1_80\fR 4
.IX Item "SRTP_AES128_CM_HMAC_SHA1_80"
.IP \fBAES_CM_128_HMAC_SHA1_32\fR 4
.IX Item "AES_CM_128_HMAC_SHA1_32"
.IP \fBSRTP_AES128_CM_HMAC_SHA1_32\fR 4
.IX Item "SRTP_AES128_CM_HMAC_SHA1_32"
.PD
.RE
.RS 4
.RE
.IP \fBsrtp_in_params\fR 4
.IX Item "srtp_in_params"
.PD 0
.IP \fBsrtp_out_params\fR 4
.IX Item "srtp_out_params"
.PD
تنظیم پارامترهای رمزنگاری ورودی و خروجی، که توسط یک نمای کدگذاری‌شده با base64 از یک بلوک باینری بیان می‌شوند. ۱۶ بایت اول این بلوک باینری به عنوان کلید اصلی (master key) و ۱۴ بایت بعدی به عنوان سالت اصلی (master salt) استفاده می‌شوند.
.SS subfile
.IX Subsection "subfile"
استخراج مجازی بخشی از یک پرونده یا جریان دیگر.
جریان زیرین باید قابلیت پرش و جستجو (seekable) را داشته باشد.
.PP
گزینه‌های پذیرفته‌شده:
.IP \fBstart\fR 4
.IX Item "start"
آفست شروع بخش استخراج‌شده، بر حسب بایت.
.IP \fBend\fR 4
.IX Item "end"
آفست پایان بخش استخراج‌شده، بر حسب بایت.
در صورت تنظیم روی 0، تا انتهای پرونده استخراج می‌شود.
.PP
مثال‌ها:
.PP
استخراج یک فصل از فایل VOB یک DVD (بخش‌های شروع و پایان به صورت خارجی محاسبه شده و در 2048 ضرب شده‌اند):
.PP
.Vb 1
\&        subfile,,start,153391104,end,268142592,,:/media/dvd/VIDEO_TS/VTS_08_1.VOB
.Ve
.PP
پخش یک فایل AVI مستقیماً از درون یک آرشیو TAR:
.PP
.Vb 1
\&        subfile,,start,183241728,end,366490624,,:archive.tar
.Ve
.PP
پخش یک فایل MPEG\-TS از آفست آغازین تا انتهای فایل:
.PP
.Vb 1
\&        subfile,,start,32815239,end,0,,:video.ts
.Ve
.SS tee
.IX Subsection "tee"
نوشتن خروجی روی چندین پروتکل. خروجی‌های مجزا با علامت | از یکدیگر تفکیک می‌شوند.
.PP
.Vb 1
\&        tee:file://path/to/local/this.avi|file://path/to/local/that.avi
.Ve
.SS tcp
.IX Subsection "tcp"
پروتکل کنترل انتقال (TCP \- Transmission Control Protocol).
.PP
سینتکس الزامی برای یک نشانی اینترنتی (URL) در پروتکل TCP:
.PP
.Vb 1
\&        tcp://<hostname>:<port>[?<options>]
.Ve
.PP
بخش \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر تفکیک شده‌اند. برای گریز (اسکیپ) از کاراکترها در کلیدها و مقادیر می‌توان از کدگذاری استاندارد درصدی (و استفاده از علامت مثبت برای فاصله) استفاده کرد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا درون کد از طریق \f(CW\*(C`AVOption\*(C'\fRها) نیز تعیین کرد.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP \fBlisten=\fR\fI2|1|0\fR 4
.IX Item "listen=2|1|0"
گوش دادن برای یک اتصال ورودی. مقدار 0 شنود را غیرفعال می‌کند، مقدار 1 شنود را در حالت تک‌کلاینتی فعال می‌سازد، و مقدار 2 شنود را در حالت چندکلاینتی فعال می‌کند. مقدار پیش‌فرض 0 است.
.IP \fBlocal_addr=\fR\fIaddr\fR 4
.IX Item "local_addr=addr"
آدرس IP محلی یک رابط شبکه که برای اتصال سوکت tcp استفاده می‌شود.
.IP \fBlocal_port=\fR\fIport\fR 4
.IX Item "local_port=port"
پورت محلی مورد استفاده برای اتصال سوکت tcp.
.IP \fBtimeout=\fR\fImicroseconds\fR 4
.IX Item "timeout=microseconds"
تنظیم مهلت زمانی صدور خطا، بر حسب میکروثانیه.
.Sp
این گزینه تنها در حالت خواندن کاربرد دارد: چنانچه در بازه زمانی طولانی‌تر از این مقدار هیچ داده‌ای دریافت نشود، خطا صادر می‌شود.
.IP \fBlisten_timeout=\fR\fImilliseconds\fR 4
.IX Item "listen_timeout=milliseconds"
تنظیم مهلت زمانی شنود، بر حسب میلی‌ثانیه.
.IP \fBrecv_buffer_size=\fR\fIbytes\fR 4
.IX Item "recv_buffer_size=bytes"
تنظیم اندازه بافر دریافت، بر حسب بایت.
.IP \fBsend_buffer_size=\fR\fIbytes\fR 4
.IX Item "send_buffer_size=bytes"
تنظیم اندازه بافر ارسال، بر حسب بایت.
.IP \fBtcp_nodelay=\fR\fI1|0\fR 4
.IX Item "tcp_nodelay=1|0"
تنظیم TCP_NODELAY برای غیرفعال‌سازی الگوریتم نیگل (Nagle\*(Aqs algorithm). مقدار پیش‌فرض 0 است.
.Sp
\&\fIتذکر: نوشتن روی سوکت در حال حاضر برای به حداقل رساندن فراخوانی‌های سیستمی بهینه‌سازی نشده است و این امر بهره‌وری / اثرگذاری TCP_NODELAY را کاهش می‌دهد.\fR
.IP \fBtcp_mss=\fR\fIbytes\fR 4
.IX Item "tcp_mss=bytes"
تنظیم حداکثر اندازه قطعه (MSS) برای بسته‌های خروجی TCP، بر حسب بایت.
.PP
مثال زیر چگونگی برپایی یک اتصال شنونده TCP را با \fBffmpeg\fR نشان می‌دهد که سپس با \fBffplay\fR مورد دسترسی قرار می‌گیرد:
.PP
.Vb 2
\&        ffmpeg \-i <input> \-f <format> tcp://<hostname>:<port>?listen
\&        ffplay tcp://<hostname>:<port>
.Ve
.SS tls
.IX Subsection "tls"
امنیت لایه انتقال (TLS \- Transport Layer Security) / لایه سوکت‌های امن (SSL \- Secure Sockets Layer).
.PP
سینتکس الزامی برای یک URL در پروتکل TLS/SSL:
.PP
.Vb 1
\&        tls://<hostname>:<port>[?<options>]
.Ve
.PP
بخش \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر تفکیک شده‌اند. برای گریز از کاراکترها در کلیدها و مقادیر می‌توان از کدگذاری درصدی استاندارد (و علامت مثبت برای فاصله) استفاده کرد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا درون کد از طریق \f(CW\*(C`AVOption\*(C'\fRها) نیز تعیین نمود.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP "\fBca_file, cafile=\fR\fIfilename\fR" 4
.IX Item "ca_file, cafile=filename"
پرونده‌ای حاوی گواهی‌های ریشه مرجع صدور گواهی (CA) که به عنوان گواهی‌های مورد اعتماد در نظر گرفته می‌شوند. اگر کتابخانه پیوندشده TLS شامل یک پیش‌فرض باشد ممکن است نیازی به تعیین این گزینه برای کارکرد اعتبارسنجی نباشد، اما تمامی کتابخانه‌ها و پیکربندی‌ها حاوی پیش‌فرض‌های داخلی نیستند.
این پرونده باید در قالب OpenSSL PEM باشد.
.IP "\fBtls_verify, verify=\fR\fI1|0\fR" 4
.IX Item "tls_verify, verify=1|0"
در صورت فعال بودن، تلاش می‌کند همتایی را که با آن در حال ارتباط هستیم تأیید اعتبار کند.
توجه کنید در صورت استفاده از OpenSSL، در حال حاضر این گزینه صرفاً اطمینان حاصل می‌کند که گواهی همتا توسط یکی از گواهی‌های ریشه موجود در پایگاه داده CA امضا شده باشد، اما اعتبارسنجی نمی‌کند که آیا گواهی واقعاً با نام میزبانی که قصد اتصال به آن را داریم تطابق دارد یا خیر (در سایر بک‌اندها، نام میزبان نیز اعتبارسنجی می‌شود).
.Sp
این گزینه به صورت پیش‌فرض فعال است. اعتبارسنجی همتا نیازمند یک پایگاه داده CA است که در برخی حالات باید توسط فراخواننده ارائه گردد.
.IP "\fBcert_file, cert=\fR\fIfilename\fR" 4
.IX Item "cert_file, cert=filename"
پرونده‌ای حاوی گواهی برای استفاده در دست‌تکانی (handshake) با طرف همتا.
(هنگام عمل به عنوان سرور در حالت listen، این مورد معمولاً توسط طرف مقابل الزامی است، در حالی که گواهی‌های کلاینت تنها در تنظیمات خاصی اجباری می‌باشند.)
.IP "\fBkey_file, key=\fR\fIfilename\fR" 4
.IX Item "key_file, key=filename"
پرونده‌ای حاوی کلید خصوصی متناظر با گواهی.
.IP \fBlisten=\fR\fI1|0\fR 4
.IX Item "listen=1|0"
در صورت فعال بودن، برای اتصالات ورودی روی پورت مشخص‌شده گوش فرا می‌دهد و در دست‌تکانی نقش سرور را به جای نقش کلاینت بر عهده می‌گیرد.
.IP \fBhttp_proxy\fR 4
.IX Item "http_proxy"
پراکسی HTTP جهت تانل زدن از طریق آن، به عنوان مثال \f(CW\*(C`http://example.com:1234\*(C'\fR.
پراکسی باید از متد CONNECT پشتیبانی کند.
.PP
خطوط فرمان نمونه:
.PP
برای ساخت یک سرور TLS/SSL که یک جریان ورودی را ارائه می‌دهد:
.PP
.Vb 1
\&        ffmpeg \-i <input> \-f <format> tls://<hostname>:<port>?listen&cert=<server.crt>&key=<server.key>
.Ve
.PP
برای پخش یک جریان از سرور TLS/SSL با بهره‌گیری از \fBffplay\fR:
.PP
.Vb 1
\&        ffplay tls://<hostname>:<port>
.Ve
.SS dtls
.IX Subsection "dtls"
امنیت لایه انتقال دیتاگرام (DTLS \- Datagram Transport Layer Security).
.PP
سینتکس الزامی برای نشانی اینترنتی DTLS:
.PP
.Vb 1
\&        dtls://<hostname>:<port>[?<options>]
.Ve
.PP
بخش \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & از یکدیگر تفکیک شده‌اند. برای گریز از کاراکترها در کلیدها و مقادیر می‌توان از کدگذاری استاندارد درصدی (و علامت مثبت برای فاصله) استفاده کرد.
.PP
گزینه‌ها را می‌توان از طریق گزینه‌های خط فرمان (یا درون کد با \f(CW\*(C`AVOption\*(C'\fRها) نیز تنظیم نمود.
.PP
پروتکل DTLS اغلب گزینه‌ها را با TLS به اشتراک دارد، اما به جای بستر TCP بر روی UDP عمل می‌کند.
.PP
فهرست گزینه‌های پشتیبانی‌شده به شرح زیر است:
.IP "\fBca_file, cafile=\fR\fIfilename\fR" 4
.IX Item "ca_file, cafile=filename"
پرونده‌ای شامل گواهی‌های ریشه مرجع صدور گواهی (CA) برای معتبر شناختن. اگر کتابخانه TLS پیوندشده دارای یک مقدار پیش‌فرض باشد شاید نیازی به تعیین این گزینه برای اعتبارسنجی نباشد، اما تمام کتابخانه‌ها و تنظیمات پیش‌فرض‌های تعبیه‌شده ندارند.
این پرونده باید در قالب OpenSSL PEM باشد.
.IP "\fBtls_verify, verify=\fR\fI1|0\fR" 4
.IX Item "tls_verify, verify=1|0"
در صورت فعال بودن، تلاش می‌کند همتایی را که با آن ارتباط داریم اعتبارسنجی کند.
توجه داشته باشید که با استفاده از OpenSSL، در حال حاضر این گزینه صرفاً اطمینان می‌یابد که گواهی همتا توسط یکی از گواهی‌های ریشه در پایگاه داده CA امضا شده باشد، اما اعتبارسنجی نمی‌کند که آیا گواهی با نام میزبانی که قصد اتصال به آن را داریم تطابق دارد یا خیر.
.Sp
این گزینه به صورت پیش‌فرض فعال است. اعتبارسنجی همتا مستلزم وجود پایگاه داده CA است که در پاره‌ای از موارد باید توسط فراخواننده تأمین شود.
.IP "\fBcert_file, cert=\fR\fIfilename\fR" 4
.IX Item "cert_file, cert=filename"
پرونده‌ای حاوی یک گواهی جهت استفاده در فرایند دست‌تکانی با همتا.
(هنگام عمل در نقش سرور در حالت شنود listen، این گزینه بیشتر توسط همتا الزامی است، در حالی که گواهی‌های کلاینت تنها در شرایط خاصی اجباری می‌شوند.)
.IP "\fBkey_file, key=\fR\fIfilename\fR" 4
.IX Item "key_file, key=filename"
پرونده‌ای شامل کلید خصوصی مربوط به گواهی.
.IP \fBcert_pem=\fR\fIstring\fR 4
.IX Item "cert_pem=string"
رشته PEM گواهی.
.IP \fBkey_pem=\fR\fIstring\fR 4
.IX Item "key_pem=string"
رشته PEM کلید خصوصی.
.IP \fBlisten=\fR\fI1|0\fR 4
.IX Item "listen=1|0"
در صورت فعال بودن، برای اتصالات روی پورت ارائه‌شده گوش فرا می‌دهد و در دست‌تکانی نقش سرور را به جای نقش کلاینت به عهده می‌گیرد.
.IP \fBmtu=\fR\fIsize\fR 4
.IX Item "mtu=size"
تنظیم واحد بیشینه انتقال (MTU) برای بسته‌های DTLS.
.IP \fBuse_srtp=\fR\fI1|0\fR 4
.IX Item "use_srtp=1|0"
فعال‌سازی افزونه use_srtp در پروتکل DTLS.
این گزینه در برنامه‌های کاربردی WebRTC برای برقراری کلیدهای رمزنگاری SRTP از طریق دست‌تکانی DTLS کاربرد دارد. پیش‌فرض غیرفعال است.
.IP \fBexternal_sock=\fR\fI1|0\fR 4
.IX Item "external_sock=1|0"
استفاده از یک سوکت خارجی به جای ایجاد سوکتی جدید.
ارسال این گزینه تنها هنگام تعامل با کد از طریق رابط برنامه‌نویسی کاربردی (API) منطقی است؛ فعال کردن این مورد از طریق رابط خط فرمان (CLI) موجب شکست فوری خواهد شد.
پیش‌فرض غیرفعال است.
.PP
دستورات خط فرمان نمونه:
.PP
جهت ایجاد یک سرور DTLS:
.PP
.Vb 1
\&        ffmpeg \-listen 1 \-i dtls://<hostname>:<port> <output>
.Ve
.PP
جهت ایجاد یک کلاینت DTLS و مخابره داده‌ها به سرور:
.PP
.Vb 1
\&        ffmpeg \-i <input> \-f <format> dtls://<hostname>:<port>
.Ve
.SS udp
.IX Subsection "udp"
پروتکل دیتاگرام کاربر (UDP \- User Datagram Protocol).
.PP
سینتکس الزامی برای یک نشانی در پروتکل UDP:
.PP
.Vb 1
\&        udp://<hostname>:<port>[?<options>]
.Ve
.PP
بخش \fIoptions\fR شامل فهرستی از گزینه‌ها به فرم \fIkey\fR=\fIval\fR است که با علامت & جدا شده‌اند. برای گریز از کاراکترها در کلیدها و مقادیر می‌توان از کدگذاری استاندارد درصدی (و علامت مثبت برای فاصله) استفاده کرد.
.PP
گزینه‌ها را می‌توان همچنین از طریق گزینه‌های خط فرمان (یا در کد با استفاده از \f(CW\*(C`AVOption\*(C'\fRها) تعیین نمود.
.PP
در صورتی که چندریسمانی (threading) روی سیستم فعال باشد، یک بافر حلقوی برای ذخیره داده‌های دریافتی استفاده می‌شود که باعث کاهش اتلاف داده در اثر سرریز بافر سوکت UDP می‌گردد. گزینه‌های \fIfifo_size\fR و \fIoverrun_nonfatal\fR مربوط به این بافر می‌باشند.
.PP
فهرست گزینه‌های پشتیبانی‌شده در ادامه آمده است:
.IP \fBbuffer_size=\fR\fIsize\fR 4
.IX Item "buffer_size=size"
تنظیم حداکثر اندازه بافر سوکت UDP بر حسب بایت. این گزینه بسته به کاربرد سوکت، برای تعیین اندازه بافر دریافت یا ارسال استفاده می‌شود. مقدار پیش‌فرض برای خروجی 32 کیلوبایت و برای ورودی 384 کیلوبایت است. همچنین به \fIfifo_size\fR مراجعه کنید.
.IP \fBbitrate=\fR\fIbitrate\fR 4
.IX Item "bitrate=bitrate"
در صورت تنظیم روی مقداری غیرصفر، خروجی در صورتی که ورودی بسته‌های کافی برای تداوم آن را داشته باشد دارای نرخ بیت ثابت معین خواهد بود.
.IP \fBburst_bits=\fR\fIbits\fR 4
.IX Item "burst_bits=bits"
در زمان استفاده از \fIbitrate\fR، این گزینه حداکثر تعداد بیت‌ها را در جهش‌های ناگهانی بسته (packet bursts) تعیین می‌کند.
.IP \fBlocalport=\fR\fIport\fR 4
.IX Item "localport=port"
بازنویسی پورت UDP محلی جهت اتصال (bind).
.IP \fBlocaladdr=\fR\fIaddr\fR 4
.IX Item "localaddr=addr"
آدرس IP محلی یک رابط شبکه که برای ارسال بسته‌ها یا پیوستن به گروه‌های مالتی‌کست استفاده می‌شود.
.IP \fBpkt_size=\fR\fIsize\fR 4
.IX Item "pkt_size=size"
تنظیم اندازه بسته‌های UDP بر حسب بایت.
.IP \fBreuse=\fR\fI1|0\fR 4
.IX Item "reuse=1|0"
مجاز دانستن یا ممنوع کردن صریح استفاده مجدد از سوکت‌های UDP.
.IP \fBttl=\fR\fIttl\fR 4
.IX Item "ttl=ttl"
تنظیم مقدار طول عمر (TTL) (تنها برای بسترهای چندپخشی یا مالتی‌کست).
.IP \fBdscp=\fR\fIdscp\fR 4
.IX Item "dscp=dscp"
تنظیم فیلد ۶ بیتی DSCP برای بسته‌های خروجی.
.IP \fBconnect=\fR\fI1|0\fR 4
.IX Item "connect=1|0"
مقداردهی اولیه سوکت UDP با تابع \f(CWconnect()\fR. در این حالت، آدرس مقصد نمی‌تواند بعداً با ff_udp_set_remote_url تغییر یابد. اگر آدرس مقصد در ابتدا مشخص نباشد، این گزینه می‌تواند در ff_udp_set_remote_url نیز مشخص گردد.
این امر امکان پی بردن به آدرس مبدأ را برای بسته‌ها توسط getsockname فراهم می‌سازد، و باعث می‌شود در صورت دریافت وضعیت "مقصد غیرقابل دسترس است"، عملیات نوشتن با کد خطای AVERROR(ECONNREFUSED) بازگردد.
برای دریافت، این وضعیت این مزیت را ایجاد می‌کند که بسته‌ها صرفاً از آدرس/پورت مشخص‌شده همتا دریافت شوند.
.IP \fBsources=\fR\fIaddress\fR\fB[,\fR\fIaddress\fR\fB]\fR 4
.IX Item "sources=address[,address]"
دریافت بسته‌ها صرفاً از آدرس‌های مشخص‌شده. در حالت مالتی‌کست، تنها در ترافیک مالتی‌کست ناشی از این آدرس‌ها مشترک می‌شود.
.IP \fBblock=\fR\fIaddress\fR\fB[,\fR\fIaddress\fR\fB]\fR 4
.IX Item "block=address[,address]"
نادیده گرفتن بسته‌های ارسال‌شده از آدرس‌های تعیین‌شده. در حالت مالتی‌کست، این آدرس‌های مبدأ را از اشتراک مالتی‌کست مستثنی می‌سازد.
.IP \fBfifo_size=\fR\fIunits\fR 4
.IX Item "fifo_size=units"
تنظیم اندازه بافر حلقوی دریافت UDP، که بر حسب تعداد بسته‌هایی با اندازه ۱۸۸ بایت بیان می‌شود. در صورت عدم تعیین، مقدار پیش‌فرض 7*4096 خواهد بود.
.IP \fBoverrun_nonfatal=\fR\fI1|0\fR 4
.IX Item "overrun_nonfatal=1|0"
تداوم بقا و ادامه کار در صورت رخداد سرریز بافر حلقوی دریافت UDP. مقدار پیش‌فرض 0 است.
.IP \fBtimeout=\fR\fImicroseconds\fR 4
.IX Item "timeout=microseconds"
تنظیم مهلت زمانی صدور خطا، بر حسب میکروثانیه.
.Sp
این گزینه صرفاً در حالت خواندن مطرح است: اگر در بازه زمانی بیش از این مقدار هیچ داده‌ای نرسد، خطا صادر می‌شود.
.IP \fBbroadcast=\fR\fI1|0\fR 4
.IX Item "broadcast=1|0"
مجاز یا غیرمجاز ساختن صریح ارسال همگانی (broadcast) در UDP.
.Sp
توجه کنید که ارسال همگانی ممکن است در شبکه‌هایی که مجهز به محافظت در برابر طوفان برودکست هستند به درستی کار نکند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از \fBffmpeg\fR جهت ارسال جریان بر بستر UDP به یک نقطه پایانی راه‌دور:
.Sp
.Vb 1
\&        ffmpeg \-i <input> \-f <format> udp://<hostname>:<port>
.Ve
.IP \(bu 4
استفاده از \fBffmpeg\fR جهت ارسال جریان در قالب mpegts بر بستر UDP با استفاده از بسته‌های ۱۸۸ بایتی و یک بافر ورودی بزرگ:
.Sp
.Vb 1
\&        ffmpeg \-i <input> \-f mpegts udp://<hostname>:<port>?pkt_size=188&buffer_size=65535
.Ve
.IP \(bu 4
استفاده از \fBffmpeg\fR جهت دریافت داده روی UDP از یک نقطه پایانی راه‌دور:
.Sp
.Vb 1
\&        ffmpeg \-i udp://[<multicast\-address>]:<port> ...
.Ve
.SS unix
.IX Subsection "unix"
سوکت محلی یونیکس (Unix local socket).
.PP
سینتکس الزامی برای یک URL سوکت یونیکس:
.PP
.Vb 1
\&        unix://<filepath>
.Ve
.PP
پارامترهای زیر می‌توانند از طریق گزینه‌های خط فرمان (یا درون کد از طریق \f(CW\*(C`AVOption\*(C'\fRها) تنظیم شوند:
.IP \fBtimeout\fR 4
.IX Item "timeout"
مهلت زمانی بر حسب میلی‌ثانیه.
.IP \fBlisten\fR 4
.IX Item "listen"
ایجاد سوکت یونیکس در حالت شنود (listening).
.IP \fBtype\fR 4
.IX Item "type"
انتخاب نوع سوکت.
.RS 4
.IP "\fBstream Corresponds to SOCK_STREAM (reliable stream\-oriented)\fR" 4
.IX Item "stream Corresponds to SOCK_STREAM (reliable stream-oriented)"
متناظر با SOCK_STREAM (جریان‌محور و مطمئن).
.PD 0
.IP "\fBdatagram Corresponds to SOCK_DGRAM (unreliable packet\-oriented)\fR" 4
.IX Item "datagram Corresponds to SOCK_DGRAM (unreliable packet-oriented)"
متناظر با SOCK_DGRAM (بسته‌محور و نامطمئن).
.IP "\fBseqpacket Corresponds to SOCK_SEQPACKET (reliable packet\-oriented)\fR" 4
.IX Item "seqpacket Corresponds to SOCK_SEQPACKET (reliable packet-oriented)"
متناظر با SOCK_SEQPACKET (بسته‌محور و مطمئن).
.PD
.RE
.RS 4
.RE
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
حداکثر اندازه بسته برای سوکت‌های بسته‌محور (SOCK_DGRAM و SOCK_SEQPACKET). در صورت بزرگ‌تر بودن از صفر، این مقدار به عنوان \f(CW\*(C`max_packet_size\*(C'\fR استفاده می‌شود. برای SOCK_STREAM نادیده گرفته می‌شود. مقدار پیش‌فرض \f(CW0\fR است.
.SS zmq
.IX Subsection "zmq"
پیام‌رسانی ناهمگام ZeroMQ با استفاده از کتابخانه libzmq.
.PP
این کتابخانه از ارسال جریان‌های تک‌پخشی (unicast) به چندین کلاینت بدون وابستگی به یک سرور خارجی پشتیبانی می‌کند.
.PP
سینتکس الزامی برای ارسال جریان یا اتصال به یک جریان:
.PP
.Vb 1
\&        zmq:tcp://ip\-address:port
.Ve
.PP
مثال:
ایجاد یک جریان محلی (localhost) روی پورت 5555:
.PP
.Vb 1
\&        ffmpeg \-re \-i input \-f mpegts zmq:tcp://127.0.0.1:5555
.Ve
.PP
چندین کلاینت می‌توانند با دستور زیر به جریان متصل شوند:
.PP
.Vb 1
\&        ffplay zmq:tcp://127.0.0.1:5555
.Ve
.PP
ارسال جریان به چندین کلاینت با استفاده از الگوی نشر/اشتراک (Pub\-Sub) پروتکل ZeroMQ پیاده‌سازی شده است. سمت سرور به یک پورت پیوند خورده (bind) و داده‌ها را منتشر می‌نماید. کلاینت‌ها (از طریق آدرس IP و پورت) به سرور وصل شده و در جریان مشترک می‌شوند. ترتیب روشن شدن سرور و کلاینت عموماً اهمیتی ندارد.
.PP
دستور ffmpeg برای پشتیبانی از این پروتکل باید با گزینه \-\-enable\-libzmq کامپایل شده باشد.
.PP
گزینه‌ها را می‌توان در خط فرمان \fBffmpeg\fR/\fBffplay\fR تنظیم کرد. گزینه‌های زیر پشتیبانی می‌شوند:
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
تحمیل حداکثر اندازه بسته برای ارسال/دریافت داده. مقدار پیش‌فرض ۱۳۱٬۰۷۲ بایت است. در سمت سرور، این مقدار حداکثر اندازه بسته‌های ارسالی از طریق ZeroMQ را مشخص می‌کند. در کلاینت‌ها، این گزینه اندازه یک بافر داخلی را برای دریافت بسته‌ها معین می‌سازد. دقت کنید که مقدار pkt_size در کلاینت‌ها باید برابر یا بزرگ‌تر از pkt_size در سرور باشد؛ در غیر این صورت پیام دریافتی ممکن است ناقص مانده و منجر به خطاهای دیکود شود.
.SH "گزینه‌های دستگاه (DEVICE OPTIONS)"
.IX Header "DEVICE OPTIONS"
کتابخانه libavdevice رابطی یکسان با libavformat ارائه می‌دهد. به بیان دیگر، یک دستگاه ورودی مشابه یک دی‌ماکسر و یک دستگاه خروجی مشابه یک ماکسر انگاشته می‌شود، و رابط کاربری و گزینه‌های عمومی دستگاه نیز همان مواردی هستند که توسط libavformat ارائه شده‌اند (به راهنمای ffmpeg\-formats مراجعه کنید).
.PP
علاوه بر این، هر دستگاه ورودی یا خروجی ممکن است از گزینه‌های اصطلاحاً اختصاصی (private options) پشتیبانی کند که مختص آن مؤلفه به شمار می‌روند.
.PP
گزینه‌ها ممکن است با تعیین \-\fIoption\fR \fIvalue\fR در ابزارهای FFmpeg، یا با تنظیم صریح مقدار در گزینه‌های \f(CW\*(C`AVFormatContext\*(C'\fR دستگاه، یا با بهره‌گیری از رابط برنامه‌نویسی \fIlibavutil/opt.h\fR برای مصارف برنامه‌نویسی تنظیم گردند.
.SH "دستگاه‌های ورودی (INPUT DEVICES)"
.IX Header "INPUT DEVICES"
دستگاه‌های ورودی عناصر پیکربندی‌شده‌ای در FFmpeg هستند که دسترسی به داده‌های به‌دست‌آمده از یک دستگاه چندرسانه‌ای متصل به سیستم شما را ممکن می‌سازند.
.PP
هنگامی که بیلد FFmpeg خود را پیکربندی می‌کنید، تمامی دستگاه‌های ورودیِ پشتیبانی‌شده به صورت پیش‌فرض فعال هستند. می‌توانید با استفاده از گزینه پیکربندی "\-\-list\-indevs" فهرستی از تمام موارد موجود را مشاهده کنید.
.PP
می‌توانید با استفاده از گزینه پیکربندی "\-\-disable\-indevs" تمامی دستگاه‌های ورودی را غیرفعال کنید و با استفاده از گزینه "\-\-enable\-indev=\fIINDEV\fR" دستگاهی را به شکل گزینشی فعال نمایید، یا اینکه دستگاه ورودی خاصی را با گزینه "\-\-disable\-indev=\fIINDEV\fR" از کار بیندازید.
.PP
گزینه "\-devices" در ابزارهای ff* فهرست دستگاه‌های ورودی پشتیبانی‌شده را نمایش خواهد داد.
.PP
شرح دستگاه‌های ورودی موجود در ادامه آورده شده است.
.SS alsa
.IX Subsection "alsa"
دستگاه ورودی ALSA (معماری پیشرفته صوتی لینوکس \- Advanced Linux Sound Architecture).
.PP
جهت فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، نیازمند بسته libasound نصب‌شده بر روی سیستم خود هستید.
.PP
این دستگاه امکان ضبط از یک دستگاه ALSA را فراهم می‌آورد. نام دستگاه مورد نظر برای ضبط باید شناسه کارت ALSA باشد.
.PP
یک شناسه ALSA دارای سینتکس زیر است:
.PP
.Vb 1
\&        hw:<CARD>[,<DEV>[,<SUBDEV>]]
.Ve
.PP
که در آن مؤلفه‌های \fIDEV\fR و \fISUBDEV\fR اختیاری می‌باشند.
.PP
سه آرگومان (به ترتیب: \fICARD\fR، \fIDEV\fR و \fISUBDEV\fR) شماره یا شناسه کارت، شماره دستگاه و شماره زیردستگاه را مشخص می‌کنند (\-1 به معنی هر کدام است).
.PP
جهت مشاهده فهرست کارت‌هایی که در حال حاضر توسط سیستم شما شناسایی شده‌اند پرونده‌های \fI/proc/asound/cards\fR و \fI/proc/asound/devices\fR را بررسی نمایید.
.PP
برای نمونه جهت ضبط با \fBffmpeg\fR از یک دستگاه ALSA با شناسه کارت 0، می‌توانید دستور زیر را اجرا کنید:
.PP
.Vb 1
\&        ffmpeg \-f alsa \-i hw:0 alsaout.wav
.Ve
.PP
برای کسب اطلاعات بیشتر ببینید:
<\fBhttp://www.alsa\-project.org/alsa\-doc/alsa\-lib/pcm.html\fR>
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری بر حسب هرتز. پیش‌فرض 48000 است.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها. پیش‌فرض 2 است.
.SS android_camera
.IX Subsection "android_camera"
دستگاه ورودی دوربین اندروید.
.PP
این دستگاه ورودی از واسط برنامه‌نویسی Camera2 NDK اندروید بهره می‌برد که در دستگاه‌های دارای سطح API نسخه ۲۴ به بالا در دسترس است. دردسترس بودن android_camera حین پیکربندی به شکل خودکار تشخیص داده می‌شود.
.PP
این دستگاه امکان تصویربرداری از تمامی دوربین‌های یک دستگاه اندرویدی را که در Camera2 NDK API یکپارچه‌سازی شده‌اند مهیا می‌کند.
.PP
دوربین‌های موجود به صورت داخلی شماره‌گذاری می‌شوند و می‌توان آن‌ها را با شناسه \fIcamera_index\fR برگزید. رشته نام پرونده ورودی نادیده گرفته می‌شود.
.PP
به طور کلی دوربین پشت دارای اندیس 0 و دوربین جلو دارای اندیس 1 می‌باشد.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم ابعاد ویدیو که به صورت رشته‌ای نظیر 640x480 یا hd720 داده می‌شود.
در صورتی که ابعاد درخواستی موجود نباشد یا به طور پیش‌فرض، به نخستین پیکربندی در دسترس گزارش‌شده توسط اندروید بازمی‌گردد.
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم ویدیو.
در صورتی که نرخ فریم درخواستی در دسترس نباشد یا به طور پیش‌فرض (\-1)، به نخستین پیکربندی در دسترس گزارش‌شده توسط اندروید بازمی‌گردد.
.IP \fBcamera_index\fR 4
.IX Item "camera_index"
تنظیم اندیس دوربین مورد استفاده. پیش‌فرض 0 است.
.IP \fBinput_queue_size\fR 4
.IX Item "input_queue_size"
تنظیم حداکثر تعداد فریم‌ها برای بافرسازی. پیش‌فرض 5 است.
.SS avfoundation
.IX Subsection "avfoundation"
دستگاه ورودی AVFoundation.
.PP
چارچوب AVFoundation چارچوب توصیه‌شده فعلی از سوی شرکت اپل برای دریافت جریان‌های رسانه‌ای در OSX >= 10.7 و همچنین iOS است.
.PP
نام پرونده ورودی باید با سینتکس زیر مشخص شود:
.PP
.Vb 1
\&        \-i "[[VIDEO]:[AUDIO]]"
.Ve
.PP
مدخل اول ورودی ویدیو و مدخل دوم ورودی صدا را انتخاب می‌کند.
جریان باید از طریق نام دستگاه یا اندیس دستگاه، آن‌گونه که در فهرست دستگاه‌ها نمایش داده شده است، مشخص شود.
به عنوان جایگزین، دستگاه ورودی ویدیویی و/یا صوتی را می‌توان بر اساس اندیس با استفاده از
.PP
.Vb 1
\&    B<\-video_device_index E<lt>INDEXE<gt>>
.Ve
.PP
و/یا
.PP
.Vb 1
\&    B<\-audio_device_index E<lt>INDEXE<gt>>
.Ve
.PP
انتخاب نمود، که این کار هر نام یا اندیس دستگاه مشخص‌شده در نام پرونده ورودی را بازنویسی می‌کند.
.PP
تمامی دستگاه‌های موجود را می‌توان با استفاده از \fB\-list_devices true\fR برشمرد که کلیه نام‌های دستگاه و اندیس‌های مربوطه را فهرست می‌کند.
.PP
دو نام مستعار برای نام دستگاه وجود دارد:
.ie n .IP """default""" 4
.el .IP \f(CWdefault\fR 4
.IX Item "default"
انتخاب دستگاه پیش‌فرض AVFoundation از نوع متناظر.
.ie n .IP """none""" 4
.el .IP \f(CWnone\fR 4
.IX Item "none"
عدم ضبط نوع رسانه متناظر.
این معادل مشخص کردن نام دستگاه یا اندیس خالی است.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
چارچوب AVFoundation از گزینه‌های زیر پشتیبانی می‌کند:
.IP "\fB\-list_devices <TRUE|FALSE>\fR" 4
.IX Item "-list_devices <TRUE|FALSE>"
در صورت تنظیم روی true، فهرستی از تمامی دستگاه‌های ورودی در دسترس با نمایش کلیه نام‌ها و اندیس‌های دستگاه ارائه می‌شود.
.IP "\fB\-video_device_index <INDEX>\fR" 4
.IX Item "-video_device_index <INDEX>"
مشخص کردن دستگاه ویدیو از طریق اندیس آن. هر مقداری را که در نام پرونده ورودی تعیین شده باشد بازنویسی می‌نماید.
.IP "\fB\-audio_device_index <INDEX>\fR" 4
.IX Item "-audio_device_index <INDEX>"
مشخص کردن دستگاه صوتی از طریق اندیس آن. هر مقداری را که در نام پرونده ورودی تعیین شده باشد بازنویسی می‌نماید.
.IP "\fB\-pixel_format <FORMAT>\fR" 4
.IX Item "-pixel_format <FORMAT>"
درخواست از دستگاه ویدیو برای استفاده از یک قالب پیکسلی خاص.
اگر قالب مشخص‌شده پشتیبانی نشود، فهرستی از قالب‌های موجود ارائه شده و نخستین مورد در این لیست به جای آن استفاده می‌شود. قالب‌های پیکسلی در دسترس عبارتند از:
\&\f(CW\*(C`monob, rgb555be, rgb555le, rgb565be, rgb565le, rgb24, bgr24, 0rgb, bgr0, 0bgr, rgb0,
 bgr48be, uyvy422, yuva444p, yuva444p16le, yuv444p, yuv422p16, yuv422p10, yuv444p10,
 yuv420p, nv12, yuyv422, gray\*(C'\fR
.IP \fB\-framerate\fR 4
.IX Item "-framerate"
تنظیم نرخ فریم دریافت تصویر. پیش‌فرض \f(CW\*(C`ntsc\*(C'\fR است، متناظر با نرخ فریم \f(CW\*(C`30000/1001\*(C'\fR.
.IP \fB\-video_size\fR 4
.IX Item "-video_size"
تنظیم ابعاد فریم ویدیو.
.IP \fB\-capture_cursor\fR 4
.IX Item "-capture_cursor"
ضبط نشانگر ماوس. پیش‌فرض 0 است.
.IP \fB\-capture_mouse_clicks\fR 4
.IX Item "-capture_mouse_clicks"
ضبط کلیک‌های ماوس روی صفحه نمایش. پیش‌فرض 0 است.
.IP \fB\-capture_raw_data\fR 4
.IX Item "-capture_raw_data"
ضبط داده‌های خام دستگاه. پیش‌فرض 0 است.
استفاده از این گزینه ممکن است منجر به دریافت داده‌های لایه زیرین ارائه‌شده به فریم‌ورک AVFoundation شود. برای نمونه برای دستگاه‌های مالتی‌پلکس‌شده که داده‌های خام DV را به فریم‌ورک می‌فرستند (مانند دوربین‌های مبتنی بر نوار)، تنظیم این گزینه روی false منجر به فریم‌های ویدیویی استخراج‌شده منحصراً در قالب پیکسلی تعیین‌شده می‌شود. تنظیم این گزینه روی true منجر به دریافت دست‌نخورده جریان خام DV می‌گردد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
چاپ فهرست دستگاه‌های پشتیبانی‌شده توسط AVFoundation و خروج:
.Sp
.Vb 1
\&        $ ffmpeg \-f avfoundation \-list_devices true \-i ""
.Ve
.IP \(bu 4
ضبط ویدیو از دستگاه ویدیویی 0 و صدا از دستگاه صوتی 0 درون out.avi:
.Sp
.Vb 1
\&        $ ffmpeg \-f avfoundation \-i "0:0" out.avi
.Ve
.IP \(bu 4
ضبط ویدیو از دستگاه ویدیویی 2 و صدا از دستگاه صوتی 1 درون out.avi:
.Sp
.Vb 1
\&        $ ffmpeg \-f avfoundation \-video_device_index 2 \-i ":1" out.avi
.Ve
.IP \(bu 4
ضبط ویدیو از دستگاه ویدیویی پیش‌فرض سیستم با بهره‌گیری از قالب پیکسلی bgr0 بدون ضبط صدا درون out.avi:
.Sp
.Vb 1
\&        $ ffmpeg \-f avfoundation \-pixel_format bgr0 \-i "default:none" out.avi
.Ve
.IP \(bu 4
ضبط داده‌های خام DV از یک دستگاه ورودی مناسب و نوشتن خروجی درون out.dv:
.Sp
.Vb 1
\&        $ ffmpeg \-f avfoundation \-capture_raw_data true \-i "zr100:none" out.dv
.Ve
.SS decklink
.IX Subsection "decklink"
دستگاه ورودی decklink قابلیت‌های دریافت و ضبط را برای دستگاه‌های DeckLink شرکت Blackmagic فراهم می‌آورد.
.PP
جهت فعال‌سازی این دستگاه ورودی، نیازمند DeckLink SDK شرکت Blackmagic هستید و باید پیکربندی را با فلگ‌های متناسب \f(CW\*(C`\-\-extra\-cflags\*(C'\fR و \f(CW\*(C`\-\-extra\-ldflags\*(C'\fR انجام دهید.
در سیستم‌عامل ویندوز، باید فایل‌های IDL را از طریق \fBwidl\fR اجرا نمایید.
.PP
دک‌لینک در خصوص قالب‌هایی که پشتیبانی می‌کند بسیار حساس است. قالب پیکسلی ورودی را می‌توان با گزینه \fBraw_format\fR تنظیم نمود.
نرخ فریم و ابعاد ویدیو برای دستگاه شما باید با دستور \fB\-list_formats 1\fR مشخص گردد. نرخ نمونه‌برداری صوتی همواره ۴۸ کیلوهرتز است و تعداد کانال‌ها می‌تواند ۲، ۸ یا ۱۶ باشد. دقت فرمایید که تمام کانال‌های صوتی درون یک قطعه (ترک) صوتی واحد بسته‌بندی می‌شوند.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBlist_devices\fR 4
.IX Item "list_devices"
در صورت تنظیم روی \fBtrue\fR، فهرستی از دستگاه‌ها را چاپ کرده و خارج می‌شود.
پیش‌فرض \fBfalse\fR است. این گزینه منسوخ شده است؛ لطفاً از گزینه \f(CW\*(C`\-sources\*(C'\fR در ffmpeg برای مشاهده دستگاه‌های ورودی موجود استفاده نمایید.
.IP \fBlist_formats\fR 4
.IX Item "list_formats"
در صورت تنظیم روی \fBtrue\fR، فهرستی از قالب‌های پشتیبانی‌شده را چاپ کرده و خارج می‌شود.
پیش‌فرض \fBfalse\fR است.
.IP "\fBformat_code <FourCC>\fR" 4
.IX Item "format_code <FourCC>"
این گزینه قالب ویدیوی ورودی را روی قالبی که توسط کد FourCC مشخص شده تنظیم می‌کند. جهت مشاهده مقادیر پشتیبانی‌شده برای دستگاه(های) خود از گزینه \fBlist_formats\fR بهره ببرید.
توجه کنید کد FourCC به صورت \fB\*(Aqpal \*(Aq\fR وجود دارد که می‌تواند به فرم \fBpal\fR (سه حرفی) نیز به کار رود.
رفتار پیش‌فرض، تشخیص خودکار قالب ویدیوی ورودی در صورت پشتیبانی سخت‌افزار است.
.IP \fBraw_format\fR 4
.IX Item "raw_format"
تنظیم قالب پیکسلی ویدیوی ضبط‌شده.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
این مقدار پیش‌فرض است و به معنی YUV 422 هشت بیتی یا ARGB هشت بیتی در صورت استفاده از تشخیص خودکار قالب، و در غیر این صورت YUV 422 هشت بیتی است.
.IP \fBuyvy422\fR 4
.IX Item "uyvy422"
قالب ۸ بیتی YUV 422.
.IP \fByuv422p10\fR 4
.IX Item "yuv422p10"
قالب ۱۰ بیتی YUV 422.
.IP \fBargb\fR 4
.IX Item "argb"
قالب ۸ بیتی RGB.
.IP \fBbgra\fR 4
.IX Item "bgra"
قالب ۸ بیتی RGB.
.IP \fBrgb10\fR 4
.IX Item "rgb10"
قالب ۱۰ بیتی RGB.
.RE
.RS 4
.RE
.IP \fBteletext_lines\fR 4
.IX Item "teletext_lines"
در صورت تنظیم روی مقداری غیرصفر، یک جریان تله‌تکست اضافی از داده‌های کمکی عمودی (VANC) استخراج و ضبط می‌گردد. هر دو منبع SD PAL (576i) و HD (1080i یا 1080p) پشتیبانی می‌شوند. در صورت استفاده از منابع HD، بسته‌های OP47 دیکود می‌شوند.
.Sp
این گزینه یک بیت‌ماسک از خطوط ضبط‌شده SD PAL VBI، به ویژه خطوط ۶ تا ۲۲ و ۳۱۸ تا ۳۳۵ است. خط ۶ کم‌ارزش‌ترین بیت (LSB) در ماسک می‌باشد. خطوط برگزیده‌ای که شامل اطلاعات تله‌تکست نباشند نادیده گرفته می‌شوند. می‌توانید از ثابت ویژه \fBall\fR برای انتخاب تمامی خطوط ممکن، یا \fBstandard\fR برای رد کردن خطوط ۶، ۳۱۸ و ۳۱۹ (که با تمام گیرنده‌ها سازگار نیستند) استفاده کنید.
.Sp
برای منابع SD، ابزار ffmpeg باید با \f(CW\*(C`\-\-enable\-libzvbi\*(C'\fR کامپایل شده باشد. برای منابع HD، در مدل‌های کارت قدیمی‌تر DeckLink (پیش از دوران 4K) باید در حالت ۱۰ بیتی اقدام به ضبط کنید.
.IP \fBchannels\fR 4
.IX Item "channels"
تعیین تعداد کانال‌های صوتی برای ضبط. باید \fB2\fR، \fB8\fR یا \fB16\fR باشد.
پیش‌فرض \fB2\fR است.
.IP \fBduplex_mode\fR 4
.IX Item "duplex_mode"
تنظیم حالت دوطرفه/پروفایل دستگاه دک‌لینک. باید یکی از مقادیر \fBunset\fR، \fBhalf\fR، \fBfull\fR، \&\fBone_sub_device_full\fR، \fBone_sub_device_half\fR، \fBtwo_sub_device_full\fR یا \fBfour_sub_device_half\fR باشد.
پیش‌فرض \fBunset\fR است.
.Sp
نکته: از نسخه DeckLink SDK 11.0 ویژگی duplex با ویژگی profile جایگزین شده است. برای DeckLink Duo 2 و DeckLink Quad 2، یک پروفایل بین هر ۲ زیردستگاهی که از اتصالات یکسان استفاده می‌کنند به اشتراک گذاشته می‌شود. برای DeckLink 8K Pro، یک پروفایل میان هر ۴ زیردستگاه مشترک است؛ بنابراین DeckLink 8K Pro از چهار پروفایل پشتیبانی می‌کند.
.Sp
حالت‌های پروفایل معتبر برای DeckLink 8K Pro (با نسخه DeckLink SDK >= 11.0):
\&\fBone_sub_device_full\fR، \fBone_sub_device_half\fR، \fBtwo_sub_device_full\fR و \fBfour_sub_device_half\fR
.Sp
حالت‌های پروفایل معتبر برای DeckLink Quad 2 و DeckLink Duo 2:
\&\fBhalf\fR و \fBfull\fR
.IP \fBtimecode_format\fR 4
.IX Item "timecode_format"
نوع کد زمانی (Timecode) برای درج در متاداده فریم و جریان ویدیو. باید یکی از مقادیر
\&\fBnone\fR، \fBrp188vitc\fR، \fBrp188vitc2\fR، \fBrp188ltc\fR، \&\fBrp188hfr\fR، \fBrp188any\fR، \fBvitc\fR، \fBvitc2\fR یا \fBserial\fR باشد.
پیش‌فرض \fBnone\fR است (درج نمی‌شود).
.Sp
به منظور پشتیبانی صحیح از کدهای زمانی ۵۰/۶۰ فریم بر ثانیه، ترتیب انواع کدهای زمانی استعلام‌شده برای \fBrp188any\fR در محتواهای با نرخ بالاتر از ۳۰ فریم بر ثانیه برابر است با HFR، VITC1، VITC2 و LTC. توجه داشته باشید که این ترتیب با ترتیب مورد استفاده توسط رابط برنامه‌نویسی دک‌لینک که HFR، VITC1، LTC، VITC2 است اندکی تفاوت دارد.
.IP \fBvideo_input\fR 4
.IX Item "video_input"
تنظیم منبع ورودی ویدیو. باید یکی از مقادیر \fBunset\fR، \fBsdi\fR، \fBhdmi\fR، \&\fBoptical_sdi\fR، \fBcomponent\fR، \fBcomposite\fR یا \fBs_video\fR باشد.
پیش‌فرض \fBunset\fR است.
.IP \fBaudio_input\fR 4
.IX Item "audio_input"
تنظیم منبع ورودی صدا. باید یکی از مقادیر \fBunset\fR، \fBembedded\fR، \&\fBaes_ebu\fR، \fBanalog\fR، \fBanalog_xlr\fR، \fBanalog_rca\fR یا \fBmicrophone\fR باشد. پیش‌فرض \fBunset\fR است.
.IP \fBvideo_pts\fR 4
.IX Item "video_pts"
تنظیم منبع برچسب زمان (PTS) بسته ویدیو. باید یکی از مقادیر \fBvideo\fR، \fBaudio\fR، \&\fBreference\fR، \fBwallclock\fR یا \fBabs_wallclock\fR باشد.
پیش‌فرض \fBvideo\fR است.
.IP \fBaudio_pts\fR 4
.IX Item "audio_pts"
تنظیم منبع برچسب زمان بسته صدا. باید یکی از مقادیر \fBvideo\fR، \fBaudio\fR، \&\fBreference\fR، \fBwallclock\fR یا \fBabs_wallclock\fR باشد.
پیش‌فرض \fBaudio\fR است.
.IP \fBdraw_bars\fR 4
.IX Item "draw_bars"
در صورت تنظیم روی \fBtrue\fR، در زمان قطع سیگنال نوارهای رنگی رسم می‌شود.
پیش‌فرض \fBtrue\fR است.
این گزینه منسوخ شده است؛ لطفاً از گزینه \f(CW\*(C`signal_loss_action\*(C'\fR بهره بگیرید.
.IP \fBsignal_loss_action\fR 4
.IX Item "signal_loss_action"
تنظیم اقدامی که باید در هنگام قطع سیگنال انجام پذیرد. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB1, none\fR" 4
.IX Item "1, none"
عدم انجام هیچ کاری در زمان قطع سیگنال. این معمولاً منجر به فریم‌های سیاه می‌شود.
.IP "\fB2, bars\fR" 4
.IX Item "2, bars"
رسم نوارهای رنگی هنگام قطع سیگنال. تنها برای سیگنال‌های ورودی ۸ بیتی پشتیبانی می‌شود.
.IP "\fB3, repeat\fR" 4
.IX Item "3, repeat"
تکرار آخرین فریم ویدیو هنگام قطع سیگنال.
.RE
.RS 4
.Sp
پیش‌فرض \fBbars\fR است.
.RE
.IP \fBqueue_size\fR 4
.IX Item "queue_size"
تنظیم حداکثر اندازه بافر ورودی بر حسب بایت. چنانچه بافر به این مقدار برسد، فریم‌های ورودی دور انداخته می‌شوند.
پیش‌فرض \fB1073741824\fR است.
.IP \fBaudio_depth\fR 4
.IX Item "audio_depth"
تنظیم عمق بیت نمونه صوتی. باید \fB16\fR یا \fB32\fR باشد.
پیش‌فرض \fB16\fR است.
.IP \fBdecklink_copyts\fR 4
.IX Item "decklink_copyts"
در صورت تنظیم روی \fBtrue\fR، برچسب‌های زمانی همان‌گونه که هستند بدون حذف آفست اولیه به جلو هدایت می‌شوند.
پیش‌فرض \fBfalse\fR است.
.IP \fBtimestamp_align\fR 4
.IX Item "timestamp_align"
هم‌ترازسازی زمان آغاز دریافت بر حسب ثانیه. در صورت تنظیم روی مقداری غیرصفر، فریم‌های ورودی دور ریخته می‌شوند تا زمانی که برچسب زمانی سیستم با مقدار پیکربندی‌شده هم‌تراز گردد.
اختلاف هم‌ترازی تا اندازه مدت‌زمان یک فریم تحمل می‌شود.
این مورد برای حفظ همگام‌سازی ورودی در میان N دستگاه سخت‌افزاری مختلف که برای افزونگی "N\-way" به کار گرفته شده‌اند سودمند است. پیش از بهره‌گیری از این گزینه، زمان سیستم دستگاه‌های سخت‌افزاری مختلف باید با پروتکل‌هایی چون NTP یا PTP همگام‌سازی شده باشد.
دقت فرمایید که این روش کاملاً بدون خطا نیست. در برخی شرایط مرزی به دلیل نوسانات زمان‌بندی ریسه‌ها در سیستم‌عامل ممکن است همگام‌سازی ورودی محقق نشود. همگام‌سازی ممکن است به اندازه ۱ فریم یا در موارد نادرتر به اندازه \fBtimestamp_align\fR ثانیه دچار خطا شود.
پیش‌فرض \fB0\fR است.
.IP "\fBwait_for_tc (\fR\fIbool\fR\fB)\fR" 4
.IX Item "wait_for_tc (bool)"
دور ریختن فریم‌ها تا زمانی که فریمی با کد زمانی دریافت گردد. گاهی اوقات کد زمانی سریال همراه با اولین فریم ورودی دریافت نمی‌شود. چنانچه این حالت رخ دهد، کد زمانی ذخیره‌شده جریان نامعتبر خواهد بود. اگر این گزینه روی \fBtrue\fR تنظیم شود، فریم‌های ورودی تا زمان رسیدن فریمی دارای کد زمانی دور انداخته می‌شوند.
گزینه \fItimecode_format\fR باید مشخص شده باشد.
پیش‌فرض \fBfalse\fR است.
.IP \fBenable_klv(\fR\fIbool\fR\fB)\fR 4
.IX Item "enable_klv(bool)"
در صورت تنظیم روی \fBtrue\fR، داده‌های KLV را از خطوط VANC استخراج کرده و بسته‌های KLV را در خروجی منتشر می‌سازد.
بسته‌های KLV VANC بر اساس فیلدهای MID و PSC با یکدیگر پیوند یافته و در یک بسته KLV واحد تجمیع می‌شوند.
پیش‌فرض \fBfalse\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
فهرست کردن دستگاه‌های ورودی:
.Sp
.Vb 1
\&        ffmpeg \-sources decklink
.Ve
.IP \(bu 4
فهرست کردن قالب‌های پشتیبانی‌شده:
.Sp
.Vb 1
\&        ffmpeg \-f decklink \-list_formats 1 \-i \*(AqIntensity Pro\*(Aq
.Ve
.IP \(bu 4
ضبط کلیپ ویدیویی در 1080i50:
.Sp
.Vb 1
\&        ffmpeg \-format_code Hi50 \-f decklink \-i \*(AqIntensity Pro\*(Aq \-c:a copy \-c:v copy output.avi
.Ve
.IP \(bu 4
ضبط کلیپ ویدیویی در 1080i50 ده بیتی:
.Sp
.Vb 1
\&        ffmpeg \-raw_format yuv422p10 \-format_code Hi50 \-f decklink \-i \*(AqUltraStudio Mini Recorder\*(Aq \-c:a copy \-c:v copy output.avi
.Ve
.IP \(bu 4
ضبط کلیپ ویدیویی در 1080i50 با ۱۶ کانال صوتی:
.Sp
.Vb 1
\&        ffmpeg \-channels 16 \-format_code Hi50 \-f decklink \-i \*(AqUltraStudio Mini Recorder\*(Aq \-c:a copy \-c:v copy output.avi
.Ve
.SS dshow
.IX Subsection "dshow"
دستگاه ورودی DirectShow برای ویندوز.
.PP
در حال حاضر صرفاً دستگاه‌های صوتی و تصویری پشتیبانی می‌شوند.
.PP
می‌توان چندین دستگاه را به عنوان ورودی‌های مجزا باز کرد، اما می‌توان آن‌ها را بر روی یک ورودی مشترک نیز باز نمود که این امر باید همگام‌سازی میان آن‌ها را بهبود ببخشد.
.PP
نام ورودی باید در قالب زیر باشد:
.PP
.Vb 1
\&        <TYPE>=<NAME>[:<TYPE>=<NAME>]
.Ve
.PP
که در آن \fITYPE\fR می‌تواند \fIaudio\fR یا \fIvideo\fR باشد، و \fINAME\fR نام دستگاه یا نام جایگزین آن است.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.PP
در صورت مشخص نشدن هیچ گزینه‌ای، از مقادیر پیش‌فرض دستگاه استفاده می‌شود. اگر دستگاه از گزینه‌های درخواستی پشتیبانی نکند، باز کردن آن با شکست مواجه خواهد شد.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم ابعاد ویدیو در ویدیوی ضبط‌شده.
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم در ویدیوی ضبط‌شده.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری (بر حسب هرتز) برای صدای ضبط‌شده.
.IP \fBsample_size\fR 4
.IX Item "sample_size"
تنظیم اندازه نمونه (بر حسب بیت) برای صدای ضبط‌شده.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها در صدای ضبط‌شده.
.IP \fBlist_devices\fR 4
.IX Item "list_devices"
در صورت تنظیم روی \fBtrue\fR، فهرستی از دستگاه‌ها را چاپ کرده و خارج می‌شود.
.IP \fBlist_options\fR 4
.IX Item "list_options"
در صورت تنظیم روی \fBtrue\fR، فهرستی از گزینه‌های دستگاه انتخاب‌شده را چاپ کرده و خارج می‌شود.
.IP \fBvideo_device_number\fR 4
.IX Item "video_device_number"
تنظیم شماره دستگاه ویدیو برای دستگاه‌های دارای نام یکسان (از 0 شروع می‌شود، پیش‌فرض 0 است).
.IP \fBaudio_device_number\fR 4
.IX Item "audio_device_number"
تنظیم شماره دستگاه صوتی برای دستگاه‌های دارای نام یکسان (از 0 شروع می‌شود، پیش‌فرض 0 است).
.IP \fBpixel_format\fR 4
.IX Item "pixel_format"
انتخاب قالب پیکسلی مورد استفاده توسط DirectShow. این گزینه تنها زمانی قابل تنظیم است که کدک ویدیو مشخص نشده باشد یا روی rawvideo تنظیم شده باشد.
.IP \fBaudio_buffer_size\fR 4
.IX Item "audio_buffer_size"
تنظیم اندازه بافر دستگاه صوتی بر حسب میلی‌ثانیه (که بسته به دستگاه می‌تواند مستقیماً بر تأخیر اثر بگذارد).
پیش‌فرض بر استفاده از بافر پیش‌فرض دستگاه صوتی است (معمولاً مضربی از ۵۰۰ میلی‌ثانیه).
تنظیم این مقدار روی رقمی بسیار کوچک می‌تواند کارایی را دچار افت کند.
همچنین ببینید:
<\fBhttp://msdn.microsoft.com/en\-us/library/windows/desktop/dd377582(v=vs.85).aspx\fR>
.IP \fBvideo_pin_name\fR 4
.IX Item "video_pin_name"
انتخاب پین ضبط ویدیو بر پایه نام یا نام جایگزین.
.IP \fBaudio_pin_name\fR 4
.IX Item "audio_pin_name"
انتخاب پین ضبط صدا بر پایه نام یا نام جایگزین.
.IP \fBcrossbar_video_input_pin_number\fR 4
.IX Item "crossbar_video_input_pin_number"
انتخاب شماره پین ورودی ویدیو برای دستگاه کراس‌بار (crossbar). این پین به پین خروجی دیکودر ویدیوی دستگاه کراس‌بار هدایت می‌شود.
توجه کنید تغییر این مقدار می‌تواند بر فراخوانی‌های بعدی اثر بگذارد (یک پیش‌فرض جدید تعیین می‌کند) تا زمانی که راه‌اندازی مجدد سیستم رخ دهد.
.IP \fBcrossbar_audio_input_pin_number\fR 4
.IX Item "crossbar_audio_input_pin_number"
انتخاب شماره پین ورودی صدا برای دستگاه کراس‌بار. این پین به پین خروجی دیکودر صدای دستگاه کراس‌بار هدایت می‌شود.
توجه کنید تغییر این مقدار می‌تواند بر فراخوانی‌های بعدی اثر بگذارد (یک پیش‌فرض جدید تعیین می‌کند) تا زمانی که راه‌اندازی مجدد سیستم رخ دهد.
.IP \fBshow_video_device_dialog\fR 4
.IX Item "show_video_device_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، یک کادر محاوره‌ای برای کاربر نهایی ظاهر می‌شود که به وی امکان می‌دهد ویژگی‌ها و پیکربندی‌های فیلتر ویدیو را به صورت دستی تغییر دهد.
توجه داشته باشید برای دستگاه‌های کراس‌بار، تنظیم مقادیر در این پنجره گاهی جهت جابجایی میان نرخ‌های فریم ورودی PAL (۲۵ فریم بر ثانیه) و NTSC (۲۹٫۹۷ فریم بر ثانیه)، ابعاد، درهم‌بافی و غیره الزامی است. تغییر این مقادیر می‌تواند نرخ‌های اسکن/فریم گوناگون را فعال کرده و مانع بروز نوارهای سبز در پایین تصویر یا خطوط اسکن لرزان گردد.
توجه داشته باشید در برخی دستگاه‌ها تغییر این خصوصیات همچنین می‌تواند بر فراخوانی‌های آینده اثر بگذارد (پیش‌فرض‌های جدید وضع می‌کند) تا زمانی که سیستم ری‌بوت شود.
.IP \fBshow_audio_device_dialog\fR 4
.IX Item "show_audio_device_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، کادر محاوره‌ای نمایشی برای کاربر گشوده می‌شود تا ویژگی‌ها و تنظیمات فیلتر صوتی را به صورت دستی اعمال کند.
.IP \fBshow_video_crossbar_connection_dialog\fR 4
.IX Item "show_video_crossbar_connection_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، هنگام باز کردن یک دستگاه ویدیو، کادر محاوره‌ای برای کاربر نمایش داده می‌شود تا مسیردهی پین‌های کراس‌بار را دستی تغییر دهد.
.IP \fBshow_audio_crossbar_connection_dialog\fR 4
.IX Item "show_audio_crossbar_connection_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، هنگام باز کردن یک دستگاه صدا، کادر محاوره‌ای برای کاربر نمایش داده می‌شود تا مسیردهی پین‌های کراس‌بار را دستی تغییر دهد.
.IP \fBshow_analog_tv_tuner_dialog\fR 4
.IX Item "show_analog_tv_tuner_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، کادری نمایشی برای کاربر باز می‌شود تا کانال‌ها و فرکانس‌های تلویزیون را دستی تغییر دهد.
.IP \fBshow_analog_tv_tuner_audio_dialog\fR 4
.IX Item "show_analog_tv_tuner_audio_dialog"
در صورت تنظیم روی \fBtrue\fR، پیش از آغاز ضبط، پنجره‌ای برای کاربر نمایش داده می‌شود تا صدای تلویزیون را دستی تنظیم نماید (نظیر مونو در برابر استریو، زبان A، B یا C).
.IP \fBaudio_device_load\fR 4
.IX Item "audio_device_load"
بارگذاری یک دستگاه فیلتر ضبط صدا از روی یک پرونده به جای جستجوی آن بر اساس نام. چنانچه فیلتر از سریال‌سازی خصوصیات خود پشتیبانی نماید، می‌تواند پارامترهای اضافی را نیز بارگذاری کند.
جهت بهره‌گیری از این، باید یک منبع ضبط صدا تعیین شود، هرچند می‌تواند هر چیزی حتی یک منبع ساختگی باشد.
.IP \fBaudio_device_save\fR 4
.IX Item "audio_device_save"
ذخیره دستگاه فیلتر ضبط صدای فعلی و پارامترهای آن (در صورت پشتیبانی فیلتر) درون یک پرونده.
در صورت وجود پرونده‌ای با نام مشابه، بازنویسی خواهد شد.
.IP \fBvideo_device_load\fR 4
.IX Item "video_device_load"
بارگذاری یک دستگاه فیلتر ضبط ویدیو از روی یک پرونده به جای جستجوی آن بر اساس نام. چنانچه فیلتر از سریال‌سازی ویژگی‌های خود پشتیبانی کند، می‌تواند پارامترهای دیگر را نیز بارگذاری کند.
برای استفاده باید یک منبع ضبط ویدیو مشخص شود، اما می‌تواند هر چیزی حتی یک منبع فرضی باشد.
.IP \fBvideo_device_save\fR 4
.IX Item "video_device_save"
ذخیره دستگاه فیلتر ضبط ویدیوی فعلی و پارامترهای آن (در صورت پشتیبانی فیلتر) درون یک پرونده.
در صورت وجود پرونده‌ای با همان نام، بازنویسی صورت می‌گیرد.
.IP \fBuse_video_device_timestamps\fR 4
.IX Item "use_video_device_timestamps"
در صورت تنظیم روی \fBfalse\fR، برچسب زمان برای فریم‌های ویدیو به جای برچسب زمان تهیه‌شده توسط دستگاه ضبط، از زمان واقعی سیستم (wallclock) استخراج خواهد شد. این گزینه امکان دور زدن دستگاه‌هایی را که برچسب‌های زمانی غیرقابل اعتماد ارائه می‌دهند فراهم می‌سازد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
چاپ فهرست دستگاه‌های پشتیبانی‌شده توسط DirectShow و خروج:
.Sp
.Vb 1
\&        $ ffmpeg \-list_devices true \-f dshow \-i dummy
.Ve
.IP \(bu 4
باز کردن دستگاه ویدیویی \fICamera\fR:
.Sp
.Vb 1
\&        $ ffmpeg \-f dshow \-i video="Camera"
.Ve
.IP \(bu 4
باز کردن دومین دستگاه ویدیویی با نام \fICamera\fR:
.Sp
.Vb 1
\&        $ ffmpeg \-f dshow \-video_device_number 1 \-i video="Camera"
.Ve
.IP \(bu 4
باز کردن دستگاه ویدیویی \fICamera\fR و دستگاه صوتی \fIMicrophone\fR:
.Sp
.Vb 1
\&        $ ffmpeg \-f dshow \-i video="Camera":audio="Microphone"
.Ve
.IP \(bu 4
چاپ فهرست گزینه‌های پشتیبانی‌شده در دستگاه انتخاب‌شده و خروج:
.Sp
.Vb 1
\&        $ ffmpeg \-list_options true \-f dshow \-i video="Camera"
.Ve
.IP \(bu 4
تعیین نام پین‌ها برای دریافت با نام یا نام جایگزین، تعیین نام جایگزین دستگاه:
.Sp
.Vb 1
\&        $ ffmpeg \-f dshow \-audio_pin_name "Audio Out" \-video_pin_name 2 \-i video=video="@device_pnp_\e\e?\epci#ven_1a0a&dev_6200&subsys_62021461&rev_01#4&e2c7dd6&0&00e1#{65e8773d\-8f56\-11d0\-a3b9\-00a0c9223196}\e{ca465100\-deb0\-4d59\-818f\-8c477184adf6}":audio="Microphone"
.Ve
.IP \(bu 4
پیکربندی یک دستگاه کراس‌بار، با تعیین پین‌های کراس‌بار، و مجاز ساختن کاربر جهت تنظیم ویژگی‌های ضبط تصویر در زمان راه‌اندازی:
.Sp
.Vb 2
\&        $ ffmpeg \-f dshow \-show_video_device_dialog true \-crossbar_video_input_pin_number 0
\&             \-crossbar_audio_input_pin_number 3 \-i video="AVerMedia BDA Analog Capture":audio="AVerMedia BDA Analog Capture"
.Ve
.SS fbdev
.IX Subsection "fbdev"
دستگاه ورودی فریم‌بافر لینوکس (Linux framebuffer).
.PP
فریم‌بافر لینوکس یک لایه انتزاعی مستقل از سخت‌افزار گرافیکی برای نمایش محتوای گرافیکی بر روی نمایشگر رایانه، معمولاً روی کنسول است. دسترسی به آن از طریق یک گره پرونده دستگاه، معمولاً \fI/dev/fb0\fR صورت می‌گیرد.
.PP
برای کسب اطلاعات تفصیلی‌تر پرونده Documentation/fb/framebuffer.txt موجود در درخت سورس لینوکس را مطالعه کنید.
.PP
همچنین ببینید: <\fBhttp://linux\-fbdev.sourceforge.net\fR>، و \fBfbset\fR\|(1).
.PP
برای ضبط از دستگاه فریم‌بافر \fI/dev/fb0\fR با استفاده از \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-f fbdev \-framerate 10 \-i /dev/fb0 out.avi
.Ve
.PP
می‌توانید یک تصویر تک‌اسکرین‌شات را با دستور زیر بگیرید:
.PP
.Vb 1
\&        ffmpeg \-f fbdev \-framerate 1 \-i /dev/fb0 \-frames:v 1 screenshot.jpeg
.Ve
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم. پیش‌فرض 25 است.
.SS gdigrab
.IX Subsection "gdigrab"
دستگاه ضبط صفحه نمایش مبتنی بر Win32 GDI.
.PP
این دستگاه به شما امکان می‌دهد بخشی از نمایشگر را در ویندوز دریافت و ضبط کنید.
.PP
در میان گزینه‌های مربوط به نام پرونده ورودی چنین عناصری موجود هستند:
.PP
.Vb 1
\&        desktop
.Ve
.PP
یا
.PP
.Vb 1
\&        title=<window_title>
.Ve
.PP
یا
.PP
.Vb 1
\&        hwnd=<window_hwnd>
.Ve
.PP
گزینه اول کل دسکتاپ یا ناحیه مشخصی از دسکتاپ را ضبط می‌کند. گزینه‌های دوم و سوم در عوض محتویات یک پنجره واحد را، صرف‌نظر از موقعیت مکانی آن بر روی صفحه نمایش، ضبط می‌نمایند.
.PP
برای مثال، جهت ضبط کل دسکتاپ با استفاده از \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-f gdigrab \-framerate 6 \-i desktop out.mpg
.Ve
.PP
ضبط یک ناحیه 640x480 در مختصات \f(CW\*(C`10,20\*(C'\fR:
.PP
.Vb 1
\&        ffmpeg \-f gdigrab \-framerate 6 \-offset_x 10 \-offset_y 20 \-video_size vga \-i desktop out.mpg
.Ve
.PP
ضبط محتویات پنجره‌ای با نام "Calculator":
.PP
.Vb 1
\&        ffmpeg \-f gdigrab \-framerate 6 \-i title=Calculator out.mpg
.Ve
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBdraw_mouse\fR 4
.IX Item "draw_mouse"
مشخص می‌کند که آیا نشانگر ماوس ترسیم شود یا خیر. از مقدار \f(CW0\fR برای عدم ترسیم نشانگر استفاده کنید. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم دریافت. مقدار پیش‌فرض \f(CW\*(C`ntsc\*(C'\fR است، متناظر با نرخ فریم \f(CW\*(C`30000/1001\*(C'\fR.
.IP \fBshow_region\fR 4
.IX Item "show_region"
نمایش ناحیه ضبط‌شده روی صفحه نمایش.
.Sp
اگر \fIshow_region\fR با مقدار \f(CW1\fR مشخص گردد، ناحیه ضبط روی صفحه نمایش مشخص خواهد شد. با این گزینه، در صورتی که تنها بخشی از صفحه ضبط شود، به آسانی می‌توان فهمید چه بخشی در حال ضبط است.
.Sp
توجه کنید که گزینه \fIshow_region\fR با ضبط محتویات یک پنجره تکی ناسازگار است.
.Sp
برای مثال:
.Sp
.Vb 1
\&        ffmpeg \-f gdigrab \-show_region 1 \-framerate 6 \-video_size cif \-offset_x 10 \-offset_y 20 \-i desktop out.mpg
.Ve
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم ابعاد فریم ویدیو. حالت پیش‌فرض در صورت انتخاب \fIdesktop\fR، ضبط تمام‌صفحه است؛ و در صورت انتخاب \fItitle=window_title\fR ابعاد کامل همان پنجره می‌باشد.
.IP \fBoffset_x\fR 4
.IX Item "offset_x"
هنگام ضبط یک ناحیه با \fIvideo_size\fR، فاصله را از لبه سمت چپ صفحه نمایش یا دسکتاپ تعیین می‌کند.
.Sp
توجه داشته باشید که محاسبه آفست از گوشه سمت چپ بالای مانیتور اصلی در ویندوز انجام می‌گیرد. اگر مانیتوری در سمت چپ مانیتور اصلی خود قرار داده‌اید، برای انتقال ناحیه به آن مانیتور باید از مقدار منفی \fIoffset_x\fR استفاده نمایید.
.IP \fBoffset_y\fR 4
.IX Item "offset_y"
هنگام ضبط یک ناحیه با \fIvideo_size\fR، فاصله را از لبه بالایی صفحه نمایش یا دسکتاپ تعیین می‌کند.
.Sp
توجه داشته باشید که محاسبه آفست از گوشه سمت چپ بالای مانیتور اصلی در ویندوز صورت می‌گیرد. اگر مانیتوری بالای مانیتور اصلی خود دارید، برای انتقال ناحیه به آن مانیتور باید از مقدار منفی \fIoffset_y\fR بهره ببرید.
.SS iec61883
.IX Subsection "iec61883"
دستگاه ورودی FireWire DV/HDV با بهره‌گیری از libiec61883.
.PP
جهت فعال‌سازی این دستگاه ورودی، به کتابخانه‌های libiec61883، libraw1394 و libavc1394 نصب‌شده بر روی سیستم نیاز است. از گزینه پیکربندی \f(CW\*(C`\-\-enable\-libiec61883\*(C'\fR برای کامپایل همراه با این دستگاه استفاده کنید.
.PP
دستگاه ضبط iec61883 از دریافت تصویر از یک دستگاه ویدیویی متصل از طریق گذرگاه IEEE1394 (FireWire)، با بهره‌گیری از libiec61883 و پشته جدید FireWire لینوکس (juju) پشتیبانی می‌نماید. از آنجا که پشته قدیمی FireWire از هسته حذف گردید، این سازوکار به عنوان روش ورودی پیش‌فرض DV/HDV در هسته لینوکس ۲٫۶٫۳۷ و بالاتر محسوب می‌شود.
.PP
پورت FireWire مورد نظر را به عنوان پرونده ورودی تعیین کنید، یا برای گزینش نخستین پورت متصل مقدار "auto" را قرار دهید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBdvtype\fR 4
.IX Item "dvtype"
بازنویسی تشخیص خودکار قالب DV/HDV. این مورد تنها باید در صورتی استفاده شود که تشخیص خودکار کار نکند، یا استفاده از نوع دیگری از دستگاه باید ممنوع گردد. رفتار با دستگاه DV به عنوان HDV (یا برعکس) عمل نخواهد کرد و منجر به رفتارهای پیش‌بینی‌نشده خواهد شد.
مقادیر \fBauto\fR، \fBdv\fR و \fBhdv\fR پشتیبانی می‌شوند.
.IP \fBdvbuffer\fR 4
.IX Item "dvbuffer"
تنظیم حداکثر اندازه بافر برای داده‌های ورودی، بر حسب فریم. برای DV، این یک مقدار دقیق است. برای HDV، از نظر فریم دقیق نیست، چرا که HDV اندازه فریم ثابتی ندارد.
.IP \fBdvguid\fR 4
.IX Item "dvguid"
انتخاب دستگاه ضبط از طریق تعیین GUID آن. عمل ضبط منحصراً از دستگاه مشخص‌شده انجام می‌پذیرد و در صورت پیدا نشدن دستگاهی با GUID داده‌شده با شکست روبرو خواهد شد. این گزینه برای انتخاب ورودی در هنگامی که چندین دستگاه به طور هم‌زمان متصل هستند سودمند است.
جهت آگاهی از GUIDها مسیر /sys/bus/firewire/devices را بررسی فرمایید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
دریافت و نمایش ورودی یک دستگاه FireWire DV/HDV:
.Sp
.Vb 1
\&        ffplay \-f iec61883 \-i auto
.Ve
.IP \(bu 4
دریافت و ذخیره ورودی یک دستگاه FireWire DV/HDV، با استفاده از بافر بسته‌ای به اندازه ۱۰۰٬۰۰۰ بسته چنانچه منبع از نوع HDV باشد:
.Sp
.Vb 1
\&        ffmpeg \-f iec61883 \-i auto \-dvbuffer 100000 out.mpg
.Ve
.SS jack
.IX Subsection "jack"
دستگاه ورودی JACK.
.PP
جهت فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، نیازمند libjack نصب‌شده بر روی سیستم خود می‌باشید.
.PP
یک دستگاه ورودی JACK یک یا چند کلاینت قابل نوشتن JACK (برای هر کانال صوتی یکی) با نام \fIclient_name\fR:input_\fIN\fR ایجاد می‌کند، که در آن \fIclient_name\fR نام ارائه‌شده توسط برنامه و \fIN\fR عددی است که کانال را مشخص می‌سازد.
هر کلاینت نوشتنی، داده‌های دریافت‌شده را به دستگاه ورودی FFmpeg ارسال می‌دارد.
.PP
پس از ایجاد یک یا چند کلاینت خواندنی JACK، باید آن‌ها را به یک یا چند کلاینت نوشتنی JACK متصل نمایید.
.PP
برای اتصال یا قطع ارتباط کلاینت‌های JACK می‌توانید از برنامه‌های \fBjack_connect\fR و \fBjack_disconnect\fR بهره ببرید، یا این کار را از طریق یک واسط گرافیکی مانند \fBqjackctl\fR به انجام برسانید.
.PP
جهت مشاهده فهرست کلاینت‌های JACK و ویژگی‌های آن‌ها می‌توانید دستور \fBjack_lsp\fR را اجرا کنید.
.PP
در ادامه مثالی آورده شده که نحوه ضبط از یک کلاینت خواندنی JACK را با \fBffmpeg\fR نشان می‌دهد:
.PP
.Vb 2
\&        # ایجاد یک کلاینت نوشتنی JACK با نام "ffmpeg".
\&        $ ffmpeg \-f jack \-i ffmpeg \-y out.wav
\&        
\&        # اجرای کلاینت نمونه خواندنی jack_metro.
\&        $ jack_metro \-b 120 \-d 0.2 \-f 4000
\&        
\&        # فهرست کردن کلاینت‌های جاری JACK.
\&        $ jack_lsp \-c
\&        system:capture_1
\&        system:capture_2
\&        system:playback_1
\&        system:playback_2
\&        ffmpeg:input_1
\&        metro:120_bpm
\&        
\&        # اتصال کلاینت metro به کلاینت نوشتنی ffmpeg.
\&        $ jack_connect metro:120_bpm ffmpeg:input_1
.Ve
.PP
برای اطلاعات بیشتر بخوانید:
<\fBhttp://jackaudio.org\fR>
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها. پیش‌فرض 2 است.
.SS kmsgrab
.IX Subsection "kmsgrab"
دستگاه ورودی ویدیویی KMS.
.PP
فریم‌بافر اسکن خروجی KMS متناظر با یک CRTC یا صفحه (plane) مشخص را به عنوان یک شیء DRM که قابلیت ارسال به سایر توابع سخت‌افزاری را دارد دریافت و ضبط می‌کند.
.PP
برای اجرا مستلزم دسترسی DRM master یا مجوز CAP_SYS_ADMIN است.
.PP
اگر مفهوم این موارد را به روشنی متوجه نمی‌شوید، احتمالاً نیازی به این دستگاه ندارید؛ به جای آن گزینه \fBx11grab\fR را بررسی فرمایید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBdevice\fR 4
.IX Item "device"
دستگاه DRM برای ضبط بر روی آن. پیش‌فرض \fB/dev/dri/card0\fR است.
.IP \fBformat\fR 4
.IX Item "format"
قالب پیکسلی فریم‌بافر. چنانچه هسته لینوکس ۵٫۷ یا بالاتر را اجرا کنید این مقدار به صورت خودکار قابل تشخیص است، اما برای نسخه‌های پیشین باید به شکل صریح تعیین گردد. پیش‌فرض \fBbgr0\fR است که متداول‌ترین قالب مورد استفاده توسط کنسول لینوکس و کارساز Xorg X به شمار می‌رود.
.IP \fBformat_modifier\fR 4
.IX Item "format_modifier"
اصلاح‌کننده قالب (format modifier) برای سیگنال‌دهی روی فریم‌های خروجی. این مورد جهت درون‌ریزی (import) صحیح به پاره‌ای از واسط‌های برنامه‌نویسی (APIها) الزامی است. در لینوکس ۵٫۷ و بالاتر می‌تواند به شکل خودکار تشخیص داده شود، اما در صورت نیاز در نسخه‌های پیشین باید به صراحت ارائه شود. برای مقادیر مجاز به مستندات libdrm مراجعه کنید.
.IP \fBcrtc_id\fR 4
.IX Item "crtc_id"
شناسه KMS CRTC جهت تعریف منبع دریافت. اولین صفحه فعال موجود بر روی CRTC تعیین‌شده به کار گرفته خواهد شد.
.IP \fBplane_id\fR 4
.IX Item "plane_id"
شناسه صفحه (plane) KMS جهت تعیین منبع دریافت. در صورتی که هیچ‌یک از \fBcrtc_id\fR یا \fBplane_id\fR مشخص نگردد، به صورت پیش‌فرض نخستین صفحه فعال پیدا شده مورد استفاده قرار می‌گیرد.
.IP \fBframerate\fR 4
.IX Item "framerate"
نرخ فریم ضبط. این گزینه با هیچ‌گونه پرش صفحه (page flipping) یا تغییرات فریم‌بافر همگام نشده است \- بلکه صرفاً فاصله‌ای را که در آن فریم‌بافر نمونه‌برداری می‌شود تعیین می‌کند. نمونه‌برداری سریع‌تر از نرخ نوسازی فریم‌بافر، فریم‌های مستقلی با محتوای یکسان تولید خواهد کرد. پیش‌فرض \f(CW30\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
دریافت از اولین صفحه فعال، بارگیری نتیجه درون فریم‌های عادی و انکود کردن:
این کار صرفاً در صورتی جواب می‌دهد که فریم‌بافر هم خطی و هم قابل نگاشت (mappable) باشد \- در غیر این صورت خروجی ممکن است به هم ریخته شود یا بارگیری با شکست روبرو گردد:
.Sp
.Vb 1
\&        ffmpeg \-f kmsgrab \-i \- \-vf \*(Aqhwdownload,format=bgr0\*(Aq output.mp4
.Ve
.IP \(bu 4
دریافت از CRTC با شناسه 42 در نرخ ۶۰ فریم بر ثانیه، نگاشت نتیجه به VAAPI، تبدیل به NV12 و انکود با فرمت H.264:
.Sp
.Vb 1
\&        ffmpeg \-crtc_id 42 \-framerate 60 \-f kmsgrab \-i \- \-vf \*(Aqhwmap=derive_device=vaapi,scale_vaapi=w=1920:h=1080:format=nv12\*(Aq \-c:v h264_vaapi output.mp4
.Ve
.IP \(bu 4
جهت ضبط تنها بخشی از یک صفحه می‌توان خروجی را کراپ (crop) کرد \- این تکنیک می‌تواند برای ضبط یک پنجره مجزا، مشروط بر اینکه موقعیت مطلق و ابعاد آن معلوم باشد، مورد استفاده قرار گیرد. برای نمونه جهت ضبط و انکود یک‌چهارم مرکزی یک صفحه 1920x1080:
.Sp
.Vb 1
\&        ffmpeg \-f kmsgrab \-i \- \-vf \*(Aqhwmap=derive_device=vaapi,crop=960:540:480:270,scale_vaapi=960:540:nv12\*(Aq \-c:v h264_vaapi output.mp4
.Ve
.SS lavfi
.IX Subsection "lavfi"
دستگاه مجازی ورودی Libavfilter.
.PP
این دستگاه ورودی داده‌ها را از پدهای خروجی باز موجود در یک گراف فیلتر libavfilter می‌خواند.
.PP
برای هر خروجی باز گراف فیلتر، دستگاه ورودی یک جریان متناظر ایجاد می‌کند که به خروجی تولیدشده نگاشت می‌شود. گراف فیلتر از طریق گزینه \fBgraph\fR معین می‌گردد.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBgraph\fR 4
.IX Item "graph"
تعیین گراف فیلتر برای استفاده به عنوان ورودی. هر پد باز خروجی ویدیو باید توسط یک رشته یکتا به صورت "out\fIN\fR" برچسب‌گذاری شود، که در آن \fIN\fR عددی است که از 0 آغاز شده و متناظر با جریان ورودی نگاشت‌شده تولیدی توسط دستگاه است.
نخستین خروجی بدون برچسب به طور خودکار به برچسب "out0" تخصیص می‌یابد، اما سایر خروجی‌ها باید به صراحت مشخص گردند.
.Sp
پسوند "+subcc" می‌تواند به برچسب خروجی پیوست شود تا جریانی اضافی حاوی بسته‌های زیرنویس مخفی (closed captions) متصل به آن خروجی ایجاد کند (به صورت آزمایشی؛ در حال حاضر صرفاً برای EIA\-608 / CEA\-708).
جریان‌های subcc پس از تمام جریان‌های عادی، به ترتیب جریان‌های متناظر ساخته می‌شوند.
برای نمونه چنانچه خروجی‌های "out19+subcc"، "out7+subcc" و تا "out42" موجود باشند، جریان شماره ۴۳ زیرنویس subcc برای جریان شماره ۷ و جریان شماره ۴۴ زیرنویس subcc برای جریان شماره ۱۹ خواهد بود.
.Sp
در صورت عدم تعیین، پیش‌فرض نام فایلی خواهد بود که برای دستگاه ورودی مشخص شده است.
.IP \fBgraph_file\fR 4
.IX Item "graph_file"
تنظیم نام پرونده گراف فیلتر برای خواندن و ارسال به سایر فیلترها. سینتکس گراف فیلتر همانند موردی است که توسط گزینه \fIgraph\fR مشخص شده است.
.IP \fBdumpgraph\fR 4
.IX Item "dumpgraph"
تخلیه گراف درون stderr.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
ایجاد یک جریان ویدیویی رنگی و پخش آن با \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-f lavfi \-graph "color=c=pink [out0]" dummy
.Ve
.IP \(bu 4
مشابه مثال پیشین، اما با استفاده از نام فایل برای تعیین توصیف گراف، و حذف برچسب "out0":
.Sp
.Vb 1
\&        ffplay \-f lavfi color=c=pink
.Ve
.IP \(bu 4
ایجاد سه منبع فیلترشده آزمایشی ویدیویی گوناگون و پخش آن‌ها:
.Sp
.Vb 1
\&        ffplay \-f lavfi \-graph "testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]" test3
.Ve
.IP \(bu 4
خواندن یک جریان صوتی از یک فایل با استفاده از منبع amovie و پخش آن با \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-f lavfi "amovie=test.wav"
.Ve
.IP \(bu 4
خواندن یک جریان صوتی و یک جریان تصویری و پخش آن با \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-f lavfi "movie=test.avi[out0];amovie=test.wav[out1]"
.Ve
.IP \(bu 4
تخلیه فریم‌های دیکودشده به تصویر و ذخیره زیرنویس‌های مخفی در یک فایل پشتیبان RCWT:
.Sp
.Vb 1
\&        ffmpeg \-f lavfi \-i "movie=test.ts[out0+subcc]" \-map v frame%08d.png \-map s \-c copy \-f rcwt subcc.bin
.Ve
.SS libcdio
.IX Subsection "libcdio"
دستگاه ورودی CD صوتی بر پایه libcdio.
.PP
جهت فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، به بسته libcdio نصب‌شده بر روی سیستم نیاز دارید. این ویژگی مستلزم گزینه پیکربندی \f(CW\*(C`\-\-enable\-libcdio\*(C'\fR است.
.PP
این دستگاه اجازه پخش و ضبط داده‌ها از یک Audio\-CD را می‌دهد.
.PP
برای نمونه جهت کپی کردن تمام Audio\-CD موجود در \fI/dev/sr0\fR با استفاده از \fBffmpeg\fR، می‌توانید دستور زیر را اجرا کنید:
.PP
.Vb 1
\&        ffmpeg \-f libcdio \-i /dev/sr0 cd.wav
.Ve
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBspeed\fR 4
.IX Item "speed"
تنظیم سرعت خواندن درایو. مقدار پیش‌فرض 0 است.
.Sp
سرعت بر حسب واحدهای سرعت CD\-ROM تعیین می‌شود. سرعت از طریق تابع \f(CW\*(C`cdio_cddap_speed_set\*(C'\fR در کتابخانه libcdio تنظیم می‌گردد. در بسیاری از درایوهای CD\-ROM، تعیین مقداری بیش از حد بزرگ منجر به استفاده از حداکثر سرعت درایو خواهد شد.
.IP \fBparanoia_mode\fR 4
.IX Item "paranoia_mode"
تنظیم پرچم‌های حالت بازیابی پارانویا (paranoia recovery mode). یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBdisable\fR 4
.IX Item "disable"
.PD 0
.IP \fBverify\fR 4
.IX Item "verify"
.IP \fBoverlap\fR 4
.IX Item "overlap"
.IP \fBneverskip\fR 4
.IX Item "neverskip"
.IP \fBfull\fR 4
.IX Item "full"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBdisable\fR است.
.Sp
برای کسب اطلاعات بیشتر در خصوص حالات بازیابی در دسترس، به مستندات پروژه cdparanoia مراجعه فرمایید.
.RE
.SS libdc1394
.IX Subsection "libdc1394"
دستگاه ورودی IIDC1394 بر پایه کتابخانه‌های libdc1394 و libraw1394.
.PP
نیازمند گزینه پیکربندی \f(CW\*(C`\-\-enable\-libdc1394\*(C'\fR می‌باشد.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم. مقدار پیش‌فرض \f(CW\*(C`ntsc\*(C'\fR است، متناظر با نرخ فریم \f(CW\*(C`30000/1001\*(C'\fR.
.IP \fBpixel_format\fR 4
.IX Item "pixel_format"
انتخاب قالب پیکسلی. پیش‌فرض \f(CW\*(C`uyvy422\*(C'\fR است.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم ابعاد ویدیو به صورت رشته‌ای نظیر \f(CW\*(C`640x480\*(C'\fR یا \f(CW\*(C`hd720\*(C'\fR.
پیش‌فرض \f(CW\*(C`qvga\*(C'\fR است.
.SS openal
.IX Subsection "openal"
دستگاه ورودی OpenAL امکان ضبط صدا را بر روی تمامی سیستم‌های دارای پیاده‌سازی کارآمدی از OpenAL 1.1 مهیا می‌سازد.
.PP
جهت فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، نیازمند هدرها و کتابخانه‌های OpenAL نصب‌شده روی سیستم هستید و باید FFmpeg را با \f(CW\*(C`\-\-enable\-openal\*(C'\fR پیکربندی نمایید.
.PP
هدرها و کتابخانه‌های OpenAL باید به عنوان بخشی از پیاده‌سازی OpenAL شما یا در قالب یک بسته دانلودی اضافی (یک SDK) تأمین شوند. بسته به نوع نصب، ممکن است لازم باشد فلگ‌های بیشتری از طریق \f(CW\*(C`\-\-extra\-cflags\*(C'\fR و \f(CW\*(C`\-\-extra\-ldflags\*(C'\fR تعیین کنید تا سیستم ساخت قادر به یافتن هدرها و کتابخانه‌های OpenAL باشد.
.PP
فهرستی ناقص از پیاده‌سازی‌های OpenAL در ادامه آمده است:
.IP \fBCreative\fR 4
.IX Item "Creative"
پیاده‌سازی رسمی ویندوز، که شتاب‌دهی سخت‌افزاری را همراه با دستگاه‌های پشتیبانی‌شده و بازگشت نرم‌افزاری (fallback) ارائه می‌دهد.
ببینید: <\fBhttp://openal.org\fR>.
.IP "\fBOpenAL Soft\fR" 4
.IX Item "OpenAL Soft"
پیاده‌سازی نرم‌افزاری چندسکویی و متن‌باز (تحت پروانه LGPL). شامل بک‌اندهایی برای متداول‌ترین رابط‌های صوتی در سیستم‌های عامل ویندوز، لینوکس، سولاریس و BSD.
ببینید: <\fBhttp://kcat.strangesoft.net/openal.html\fR>.
.IP \fBApple\fR 4
.IX Item "Apple"
در این پلتفرم، OpenAL بخشی از Core Audio، رابط صوتی رسمی Mac OS X است.
ببینید: <\fBhttp://developer.apple.com/technologies/mac/audio\-and\-video.html\fR>
.PP
این دستگاه به فرد امکان می‌دهد تا از یک دستگاه ورودی صوتی که از طریق OpenAL مدیریت می‌شود صدا را ضبط نماید.
.PP
لازم است نام دستگاه مورد نظر برای ضبط را در نام پرونده ارائه‌شده مشخص نمایید. چنانچه یک رشته تهی ارائه شود، دستگاه به طور خودکار دستگاه پیش‌فرض را برمی‌گزیند. می‌توانید با استفاده از گزینه \fIlist_devices\fR فهرستی از دستگاه‌های پشتیبانی‌شده را به دست آورید.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها در صدای ضبط‌شده. در حال حاضر تنها مقادیر \fB1\fR (مونو) و \fB2\fR (استریو) پشتیبانی می‌شوند.
پیش‌فرض \fB2\fR است.
.IP \fBsample_size\fR 4
.IX Item "sample_size"
تنظیم اندازه نمونه (بر حسب بیت) در صدای ضبط‌شده. در حال حاضر تنها مقادیر \fB8\fR و \fB16\fR پشتیبانی می‌شوند. پیش‌فرض \fB16\fR است.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری (بر حسب هرتز) در صدای ضبط‌شده.
پیش‌فرض \fB44.1k\fR است.
.IP \fBlist_devices\fR 4
.IX Item "list_devices"
در صورت تنظیم روی \fBtrue\fR، فهرستی از دستگاه‌ها را چاپ کرده و خارج می‌شود.
پیش‌فرض \fBfalse\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
چاپ فهرست دستگاه‌های پشتیبانی‌شده OpenAL و خروج:
.PP
.Vb 1
\&        $ ffmpeg \-list_devices true \-f openal \-i dummy out.ogg
.Ve
.PP
ضبط از دستگاه OpenAL موسوم به \fIDR\-BT101 via PulseAudio\fR:
.PP
.Vb 1
\&        $ ffmpeg \-f openal \-i \*(AqDR\-BT101 via PulseAudio\*(Aq out.ogg
.Ve
.PP
ضبط از دستگاه پیش‌فرض (به رشته تهی \*(Aq\*(Aq به عنوان نام پرونده توجه فرمایید):
.PP
.Vb 1
\&        $ ffmpeg \-f openal \-i \*(Aq\*(Aq out.ogg
.Ve
.PP
ضبط هم‌زمان از دو دستگاه، با نوشتن در دو پرونده مجزا درون یک دستور \fBffmpeg\fR واحد:
.PP
.Vb 1
\&        $ ffmpeg \-f openal \-i \*(AqDR\-BT101 via PulseAudio\*(Aq out1.ogg \-f openal \-i \*(AqALSA Default\*(Aq out2.ogg
.Ve
.PP
نکته: تمامی پیاده‌سازی‌های OpenAL از دریافت هم‌زمان از چند دستگاه پشتیبانی نمی‌کنند \- در صورتی که دستور فوق کار نکرد، آخرین نسخه OpenAL Soft را بیازمایید.
.SS oss
.IX Subsection "oss"
دستگاه ورودی سامانه صوتی باز (OSS \- Open Sound System).
.PP
نام پرونده ارائه‌شده به دستگاه ورودی، گره پرونده دستگاه نمایانگر ورودی OSS است و معمولاً روی \fI/dev/dsp\fR تنظیم می‌گردد.
.PP
برای نمونه جهت دریافت صدا از \fI/dev/dsp\fR با استفاده از \fBffmpeg\fR، دستور زیر را اجرا کنید:
.PP
.Vb 1
\&        ffmpeg \-f oss \-i /dev/dsp /tmp/oss.wav
.Ve
.PP
برای کسب آگاهی بیشتر پیرامون OSS ببینید:
<\fBhttp://manuals.opensound.com/usersguide/dsp.html\fR>
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری بر حسب هرتز. پیش‌فرض 48000 است.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها. پیش‌فرض 2 است.
.SS pulse
.IX Subsection "pulse"
دستگاه ورودی PulseAudio.
.PP
جهت فعال‌سازی این دستگاه در پیکربندی باید FFmpeg را با \f(CW\*(C`\-\-enable\-libpulse\*(C'\fR پیکربندی کنید.
.PP
نام پرونده‌ای که به دستگاه ورودی داده می‌شود نام یک دستگاه مبدأ یا رشته "default" است.
.PP
برای مشاهده فهرست دستگاه‌های مبدأ PulseAudio و ویژگی‌های آن‌ها می‌توانید دستور \fBpactl list sources\fR را اجرا نمایید.
.PP
اطلاعات بیشتر پیرامون PulseAudio را می‌توان در <\fBhttp://www.pulseaudio.org\fR> یافت.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBserver\fR 4
.IX Item "server"
اتصال به یک کارساز مشخص PulseAudio، که توسط یک آدرس IP تعیین شده است. در صورت مشخص نشدن از سرور پیش‌فرض استفاده می‌شود.
.IP \fBname\fR 4
.IX Item "name"
تعیین نام برنامه‌ای که PulseAudio هنگام نمایش کلاینت‌های فعال نشان می‌دهد؛ به صورت پیش‌فرض رشته \f(CW\*(C`LIBAVFORMAT_IDENT\*(C'\fR است.
.IP \fBstream_name\fR 4
.IX Item "stream_name"
تعیین نام جریانی که PulseAudio هنگام نمایش جریان‌های فعال نشان می‌دهد؛ به طور پیش‌فرض "record" است.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تعیین نرخ نمونه‌برداری بر حسب هرتز؛ به طور پیش‌فرض 48kHz به کار می‌رود.
.IP \fBchannels\fR 4
.IX Item "channels"
تعیین کانال‌های مورد استفاده؛ به صورت پیش‌فرض روی 2 (استریو) تنظیم شده است.
.IP \fBframe_size\fR 4
.IX Item "frame_size"
این گزینه هیچ عملی انجام نمی‌دهد و منسوخ شده است.
.IP \fBfragment_size\fR 4
.IX Item "fragment_size"
تعیین اندازه قطعه حداقل بافرسازی در PulseAudio بر حسب بایت، که بر میزان تأخیر صوتی اثرگذار است. به طور پیش‌فرض روی میزان داده‌ای معادل ۵۰ میلی‌ثانیه تنظیم است.
.IP \fBwallclock\fR 4
.IX Item "wallclock"
تنظیم مقدار اولیه PTS با استفاده از زمان جاری سیستم. پیش‌فرض 1 است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
ضبط یک جریان از دستگاه پیش‌فرض:
.PP
.Vb 1
\&        ffmpeg \-f pulse \-i default /tmp/pulse.wav
.Ve
.SS sndio
.IX Subsection "sndio"
دستگاه ورودی sndio.
.PP
جهت فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، نیازمند بسته libsndio نصب‌شده بر روی سیستم خود هستید.
.PP
نام پرونده‌ای که به دستگاه ورودی ارائه می‌گردد گره دستگاه نمایانگر دستگاه ورودی sndio است و به طور معمول روی \fI/dev/audio0\fR تنظیم می‌شود.
.PP
برای نمونه جهت ضبط از \fI/dev/audio0\fR با بهره‌گیری از \fBffmpeg\fR دستور زیر را اجرا فرمایید:
.PP
.Vb 1
\&        ffmpeg \-f sndio \-i /dev/audio0 /tmp/oss.wav
.Ve
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تنظیم نرخ نمونه‌برداری بر حسب هرتز. پیش‌فرض 48000 است.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌ها. پیش‌فرض 2 است.
.SS "video4linux2, v4l2"
.IX Subsection "video4linux2, v4l2"
دستگاه ویدیویی ورودی Video4Linux2.
.PP
نام "v4l2" می‌تواند به عنوان نام مستعار برای "video4linux2" استفاده گردد.
.PP
چنانچه FFmpeg با پشتیبانی از v4l\-utils ساخته شده باشد (با استفاده از گزینه پیکربندی \f(CW\*(C`\-\-enable\-libv4l2\*(C'\fR)، امکان بهره‌گیری از آن همراه با گزینه دستگاه ورودی \f(CW\*(C`\-use_libv4l2\*(C'\fR مهیا است.
.PP
نام دستگاه برای دریافت، یک گره پرونده دستگاه است؛ معمولاً سیستم‌های لینوکس هنگام اتصال دستگاه (مانند یک وب‌کم USB) به سیستم چنین گره‌هایی را به شکل خودکار می‌سازند، و دارای نامی به شکل \fI/dev/videoN\fR است که در آن \fIN\fR عددی منتسب به دستگاه مربوطه می‌باشد.
.PP
دستگاه‌های Video4Linux2 عموماً از مجموعه محدودی از ابعاد \fIwidth\fRx\fIheight\fR و نرخ‌های فریم پشتیبانی می‌کنند. می‌توانید با استفاده از دستور \fB\-list_formats all\fR برای دستگاه‌های Video4Linux2 بررسی کنید که کدام موارد پشتیبانی می‌شوند.
برخی دستگاه‌ها نظیر کارت‌های تلویزیون از یک یا چند استاندارد پشتیبانی می‌کنند. امکان مشاهده تمامی استانداردهای پشتیبانی‌شده با استفاده از \fB\-list_standards all\fR وجود دارد.
.PP
پایه زمانی (time base) برای برچسب‌های زمانی ۱ میکروثانیه است. بسته به نسخه هسته و پیکربندی آن، برچسب‌های زمانی ممکن است از ساعت زمان واقعی (با مبدأ مبنای زمانی یونیکس یا Unix Epoch) یا ساعت یکنواخت (monotonic \- با مبدأ در زمان بوت سیستم، بدون تأثیرپذیری از پروتکل NTP یا تغییرات دستی ساعت) استخراج شوند. گزینه \fB\-timestamps abs\fR یا \fB\-ts abs\fR می‌تواند جهت اجبار تبدیل به ساعت زمان واقعی استفاده گردد.
.PP
چند مثال کاربردی از دستگاه video4linux2 با ابزارهای \fBffmpeg\fR و \fBffplay\fR:
.IP \(bu 4
فهرست کردن قالب‌های پشتیبانی‌شده برای یک دستگاه video4linux2:
.Sp
.Vb 1
\&        ffplay \-f video4linux2 \-list_formats all /dev/video0
.Ve
.IP \(bu 4
دریافت و نمایش ورودی یک دستگاه video4linux2:
.Sp
.Vb 1
\&        ffplay \-f video4linux2 \-framerate 30 \-video_size hd720 /dev/video0
.Ve
.IP \(bu 4
دریافت و ذخیره ورودی یک دستگاه video4linux2، با واگذاری نرخ فریم و ابعاد به مقادیر تنظیم‌شده قبلی:
.Sp
.Vb 1
\&        ffmpeg \-f video4linux2 \-input_format mjpeg \-i /dev/video0 out.mpeg
.Ve
.PP
برای کسب اطلاعات تکمیلی در مورد Video4Linux ببینید: <\fBhttp://linuxtv.org\fR>.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBstandard\fR 4
.IX Item "standard"
تنظیم استاندارد. باید نام یک استاندارد پشتیبانی‌شده باشد. برای به دست آوردن فهرستی از استانداردهای پشتیبانی‌شده از گزینه \fBlist_standards\fR استفاده کنید.
.IP \fBchannel\fR 4
.IX Item "channel"
تنظیم شماره کانال ورودی. مقدار پیش‌فرض روی \-1 است، به این معنی که از کانال انتخاب‌شده پیشین استفاده می‌شود.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم ابعاد فریم ویدیو. شناسه باید رشته‌ای به فرم \fIWIDTH\fRx\fIHEIGHT\fR یا یک اختصار معتبر ابعاد باشد.
.IP \fBpixel_format\fR 4
.IX Item "pixel_format"
انتخاب قالب پیکسلی (صرفاً برای ورودی ویدیوی خام معتبر است).
.IP \fBinput_format\fR 4
.IX Item "input_format"
تنظیم قالب پیکسلی ترجیحی (برای ویدیوی خام) یا نام یک کدک. این گزینه به فرد اجازه می‌دهد تا در زمانی که چندین گزینه موجود است، قالب ورودی را برگزیند.
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم ویدیوی ترجیحی.
.IP \fBlist_formats\fR 4
.IX Item "list_formats"
فهرست کردن قالب‌های در دسترس (قالب‌های پیکسلی، کدک‌ها و ابعاد فریم پشتیبانی‌شده) و خروج.
.Sp
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
نمایش تمام قالب‌های در دسترس (فشرده و غیرفشرده).
.IP \fBraw\fR 4
.IX Item "raw"
نمایش صرفاً قالب‌های ویدیوی خام (غیرفشرده).
.IP \fBcompressed\fR 4
.IX Item "compressed"
نمایش صرفاً قالب‌های فشرده‌شده.
.RE
.RS 4
.RE
.IP \fBlist_standards\fR 4
.IX Item "list_standards"
فهرست کردن استانداردهای پشتیبانی‌شده و خروج.
.Sp
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
نمایش تمام استانداردهای پشتیبانی‌شده.
.RE
.RS 4
.RE
.IP "\fBtimestamps, ts\fR" 4
.IX Item "timestamps, ts"
تنظیم نوع برچسب‌های زمانی برای فریم‌های ضبط‌شده.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
استفاده از برچسب‌های زمانی ارائه‌شده توسط هسته.
.IP \fBabs\fR 4
.IX Item "abs"
استفاده از برچسب‌های زمانی مطلق (ساعت واقعی / wall clock).
.IP \fBmono2abs\fR 4
.IX Item "mono2abs"
اجبار تبدیل از برچسب‌های زمانی یکنواخت (monotonic) به مطلق.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`default\*(C'\fR است.
.RE
.IP \fBuse_libv4l2\fR 4
.IX Item "use_libv4l2"
استفاده از توابع تبدیل libv4l2 (v4l\-utils). پیش‌فرض 0 است.
.SS vfwcap
.IX Subsection "vfwcap"
دستگاه ورودی دریافت تصویر VfW (Video for Windows).
.PP
نام پرونده ارائه‌شده به عنوان ورودی، شماره راه‌انداز (درایور) ضبط است که از
0 تا 9 متغیر است. می‌توانید از "list" به عنوان نام پرونده استفاده کنید تا فهرستی از درایورها چاپ شود. هر
نام پرونده دیگری به عنوان دستگاه شماره 0 تفسیر خواهد شد.
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم اندازه فریم ویدیو.
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم دریافت. مقدار پیش‌فرض \f(CW\*(C`ntsc\*(C'\fR است،
که با نرخ فریم \f(CW\*(C`30000/1001\*(C'\fR مطابقت دارد.
.SS x11grab
.IX Subsection "x11grab"
دستگاه ورودی ویدیوی X11.
.PP
برای فعال‌سازی این دستگاه ورودی در هنگام پیکربندی، باید libxcb روی سیستم شما
نصب باشد. این بسته به‌طور خودکار در طول پیکربندی شناسایی خواهد شد.
.PP
این دستگاه امکان ضبط بخشی از یک نمایشگر X11 را فراهم می‌سازد.
.PP
نحو نام پرونده ارائه‌شده به عنوان ورودی به شکل زیر است:
.PP
.Vb 1
\&        [<hostname>]:<display_number>.<screen_number>[+<x_offset>,<y_offset>]
.Ve
.PP
عبارت \&\fIhostname\fR:\fIdisplay_number\fR.\fIscreen_number\fR نام
نمایشگر X11 صفحه‌ای که باید ضبط شود را تعیین می‌کند. \fIhostname\fR می‌تواند
حذف شود، و پیش‌فرض آن "localhost" است. متغیر محیطی
\&\fBDISPLAY\fR شامل نام نمایشگر پیش‌فرض است.
.PP
\&\fIx_offset\fR و \fIy_offset\fR آفست‌های ناحیه ضبط‌شده را نسبت به
گوشه بالا سمت چپ صفحه X11 مشخص می‌کنند. پیش‌فرض آن‌ها 0 است.
.PP
برای اطلاعات دقیق‌تر، به مستندات X11 (مانند \fBman X\fR) مراجعه کنید.
.PP
از برنامه \fBxdpyinfo\fR برای دریافت اطلاعات اولیه درباره ویژگی‌های
نمایشگر X11 خود استفاده کنید (به عنوان مثال جستجوی "name" یا "dimensions" با grep).
.PP
برای مثال جهت ضبط از \fI:0.0\fR با استفاده از \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-f x11grab \-framerate 25 \-video_size cif \-i :0.0 out.mpg
.Ve
.PP
ضبط در موقعیت \f(CW\*(C`10,20\*(C'\fR:
.PP
.Vb 1
\&        ffmpeg \-f x11grab \-framerate 25 \-video_size cif \-i :0.0+10,20 out.mpg
.Ve
.PP
\fIگزینه‌ها (Options)\fR
.IX Subsection "Options"
.IP \fBselect_region\fR 4
.IX Item "select_region"
تعیین این‌که آیا ناحیه ضبط به صورت گرافیکی و با استفاده از نشانگر ماوس انتخاب شود یا خیر.
مقدار \f(CW1\fR از کاربر می‌خواهد که با کلیک و کشیدن (درگ کردن)، ناحیه ضبط را به صورت گرافیکی انتخاب کند.
یک کلیک ساده بدون کشیدن، کل صفحه را انتخاب می‌کند. ناحیه‌ای با پهنا یا ارتفاع صفر نیز کل صفحه را انتخاب
می‌نماید. این گزینه بر گزینه‌های \fIvideo_size\fR، \fIgrab_x\fR و
\&\fIgrab_y\fR بازنویسی می‌شود. مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBdraw_mouse\fR 4
.IX Item "draw_mouse"
تعیین این‌که آیا نشانگر ماوس ترسیم شود یا خیر. مقدار \f(CW0\fR تعیین می‌کند
که نشانگر ترسیم نشود. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBfollow_mouse\fR 4
.IX Item "follow_mouse"
پیروی ناحیه ضبط‌شده از مکان‌نمای ماوس. این آرگومان می‌تواند
\&\f(CW\*(C`centered\*(C'\fR یا تعداد پیکسل \fIPIXELS\fR باشد.
.Sp
هنگامی که با "centered" مشخص شود، ناحیه ضبط از نشانگر ماوس پیروی می‌کند
و نشانگر را در مرکز ناحیه نگه می‌دارد؛ در غیر این صورت، ناحیه تنها زمانی دنبال می‌کند
که نشانگر ماوس به فاصله کمتر از \fIPIXELS\fR (بزرگ‌تر از صفر) از لبه ناحیه برسد.
.Sp
به عنوان مثال:
.Sp
.Vb 1
\&        ffmpeg \-f x11grab \-follow_mouse centered \-framerate 25 \-video_size cif \-i :0.0 out.mpg
.Ve
.Sp
برای پیروی تنها زمانی که نشانگر ماوس به فاصله ۱۰۰ پیکسلی از لبه می‌رسد:
.Sp
.Vb 1
\&        ffmpeg \-f x11grab \-follow_mouse 100 \-framerate 25 \-video_size cif \-i :0.0 out.mpg
.Ve
.IP \fBframerate\fR 4
.IX Item "framerate"
تنظیم نرخ فریم دریافت. مقدار پیش‌فرض \f(CW\*(C`ntsc\*(C'\fR است،
که با نرخ فریم \f(CW\*(C`30000/1001\*(C'\fR مطابقت دارد.
.IP \fBshow_region\fR 4
.IX Item "show_region"
نمایش ناحیه ضبط‌شده روی صفحه نمایش.
.Sp
اگر \fIshow_region\fR برابر با \f(CW1\fR تعیین شود، ناحیه ضبط
روی صفحه نمایش نشان داده خواهد شد. با این گزینه، در صورتی که فقط بخشی از صفحه ضبط شود،
به آسانی می‌توان دریافت که چه قسمتی در حال ضبط است.
.IP \fBregion_border\fR 4
.IX Item "region_border"
تنظیم ضخامت کادر حاشیه ناحیه در صورت استفاده از \fB\-show_region 1\fR.
محدوده مجاز بین 1 تا 128 است و پیش‌فرض 3 می‌باشد (تنها برای x11grab مبتنی بر XCB).
.Sp
به عنوان مثال:
.Sp
.Vb 1
\&        ffmpeg \-f x11grab \-show_region 1 \-framerate 25 \-video_size cif \-i :0.0+10,20 out.mpg
.Ve
.Sp
همراه با \fIfollow_mouse\fR:
.Sp
.Vb 1
\&        ffmpeg \-f x11grab \-follow_mouse centered \-show_region 1 \-framerate 25 \-video_size cif \-i :0.0 out.mpg
.Ve
.IP \fBwindow_id\fR 4
.IX Item "window_id"
ضبط از این پنجره، به جای کل صفحه. مقدار پیش‌فرض 0 است که به
کل صفحه (پنجره ریشه / root window) نگاشت می‌شود.
.Sp
شناسه یک پنجره را می‌توان با استفاده از برنامه \fBxwininfo\fR پیدا کرد، احتمالاً همراه با گزینه‌های \-tree و
\&\-root.
.Sp
اگر بعداً اندازه پنجره بزرگ‌تر شود، ناحیه جدید ضبط نمی‌شود. ویدیو زمانی به پایان می‌رسد
که پنجره بسته شود، پنهان (unmapped، یعنی کمینه‌شده / iconified) گردد یا کوچک‌تر از اندازه ویدیو
شود (که به طور پیش‌فرض همان اندازه اولیه پنجره است).
.Sp
این گزینه گزینه‌های \fBfollow_mouse\fR و \fBselect_region\fR را غیرفعال می‌کند.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تنظیم اندازه فریم ویدیو. پیش‌فرض کل میزکار یا کل پنجره است.
.IP \fBgrab_x\fR 4
.IX Item "grab_x"
.PD 0
.IP \fBgrab_y\fR 4
.IX Item "grab_y"
.PD
تنظیم مختصات ناحیه ضبط. این مقادیر به صورت آفست از
گوشه بالا سمت چپ پنجره X11 بیان می‌شوند و با پارامترهای
\&\fIx_offset\fR و \fIy_offset\fR در نام دستگاه مطابقت دارند. مقدار
پیش‌فرض برای هر دو گزینه 0 است.
.SH "گزینه‌های تغییر نمونه‌برداری (RESAMPLER OPTIONS)"
.IX Header "RESAMPLER OPTIONS"
تغییردهنده نمونه‌برداری صدا از گزینه‌های نام‌برده زیر پشتیبانی می‌کند.
.PP
گزینه‌ها را می‌توان با تعیین \-\fIگزینه\fR \fIمقدار\fR در
ابزارهای FFmpeg، \fIگزینه\fR=\fIمقدار\fR برای فیلتر aresample،
با تنظیم مستقیم مقدار در گزینه‌های
\&\f(CW\*(C`SwrContext\*(C'\fR یا با استفاده از API در \fIlibavutil/opt.h\fR برای
کاربردهای برنامه‌نویسی تنظیم کرد.
.IP "\fBuchl, used_chlayout\fR" 4
.IX Item "uchl, used_chlayout"
تنظیم چینش کانال ورودیِ استفاده‌شده. پیش‌فرض تنظیم‌نشده (unset) است. این گزینه
تنها برای بازنگاشت (remapping) ویژه استفاده می‌شود.
.IP "\fBisr, in_sample_rate\fR" 4
.IX Item "isr, in_sample_rate"
تنظیم نرخ نمونه‌برداری ورودی. مقدار پیش‌فرض 0 است.
.IP "\fBosr, out_sample_rate\fR" 4
.IX Item "osr, out_sample_rate"
تنظیم نرخ نمونه‌برداری خروجی. مقدار پیش‌فرض 0 است.
.IP "\fBisf, in_sample_fmt\fR" 4
.IX Item "isf, in_sample_fmt"
تعیین قالب نمونه‌برداری ورودی. به طور پیش‌فرض روی \f(CW\*(C`none\*(C'\fR تنظیم شده است.
.IP "\fBosf, out_sample_fmt\fR" 4
.IX Item "osf, out_sample_fmt"
تعیین قالب نمونه‌برداری خروجی. به طور پیش‌فرض روی \f(CW\*(C`none\*(C'\fR تنظیم شده است.
.IP "\fBtsf, internal_sample_fmt\fR" 4
.IX Item "tsf, internal_sample_fmt"
تنظیم قالب نمونه‌برداری داخلی. مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
هنگامی که صراحتاً تنظیم نشود، این مورد به صورت خودکار انتخاب خواهد شد.
.IP "\fBichl, in_chlayout\fR" 4
.IX Item "ichl, in_chlayout"
.PD 0
.IP "\fBochl, out_chlayout\fR" 4
.IX Item "ochl, out_chlayout"
.PD
تنظیم چینش کانال ورودی/خروجی.
.Sp
برای نحو مورد نیاز به \fBبخش چینش کانال در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.IP "\fBclev, center_mix_level\fR" 4
.IX Item "clev, center_mix_level"
تنظیم سطح ترکیب (میکس) کانال مرکزی. مقداری است بر حسب دسی‌بل و باید
در بازه [\-32,32] باشد.
.IP "\fBslev, surround_mix_level\fR" 4
.IX Item "slev, surround_mix_level"
تنظیم سطح ترکیب کانال فراگیر (سوراند). مقداری است بر حسب دسی‌بل و باید
در بازه [\-32,32] باشد.
.IP \fBlfe_mix_level\fR 4
.IX Item "lfe_mix_level"
تنظیم سطح ترکیب LFE در کانال‌های غیر LFE. زمانی استفاده می‌شود که ورودی LFE وجود دارد اما
خروجی LFE وجود ندارد. مقداری است بر حسب دسی‌بل و باید
در بازه [\-32,32] باشد.
.IP "\fBrmvol, rematrix_volume\fR" 4
.IX Item "rmvol, rematrix_volume"
تنظیم حجم صدای بازترکیب (rematrix). مقدار پیش‌فرض 1.0 است.
.IP \fBrematrix_maxval\fR 4
.IX Item "rematrix_maxval"
تنظیم حداکثر مقدار خروجی برای بازترکیب.
این مورد می‌تواند برای جلوگیری از برش صدا (clipping) در برابر جلوگیری از کاهش حجم صدا استفاده شود.
مقدار 1.0 از برش صدا جلوگیری می‌کند.
.IP "\fBflags, swr_flags\fR" 4
.IX Item "flags, swr_flags"
تنظیم پرچم‌های مورد استفاده مبدل. مقدار پیش‌فرض 0 است.
.Sp
از پرچم‌های تکی زیر پشتیبانی می‌کند:
.RS 4
.IP \fBres\fR 4
.IX Item "res"
اجبار به تغییر نمونه‌برداری؛ این پرچم تغییر نمونه‌برداری را تحمیل می‌کند حتی زمانی که
نرخ نمونه‌برداری ورودی و خروجی یکسان باشد.
.RE
.RS 4
.RE
.IP \fBdither_scale\fR 4
.IX Item "dither_scale"
تنظیم مقیاس دیتر (dither). مقدار پیش‌فرض 1 است.
.IP \fBdither_method\fR 4
.IX Item "dither_method"
تنظیم روش دیتر. مقدار پیش‌فرض 0 است.
.Sp
مقادیر پشتیبانی‌شده:
.RS 4
.IP \fBrectangular\fR 4
.IX Item "rectangular"
انتخاب دیتر مستطیلی
.IP \fBtriangular\fR 4
.IX Item "triangular"
انتخاب دیتر مثلثی
.IP \fBtriangular_hp\fR 4
.IX Item "triangular_hp"
انتخاب دیتر مثلثی با فیلتر بالاگذر
.IP \fBlipshitz\fR 4
.IX Item "lipshitz"
انتخاب دیتر شکل‌دهی نوفه لیپشیتز (Lipshitz).
.IP \fBshibata\fR 4
.IX Item "shibata"
انتخاب دیتر شکل‌دهی نوفه شیباتا (Shibata).
.IP \fBlow_shibata\fR 4
.IX Item "low_shibata"
انتخاب دیتر شکل‌دهی نوفه شیباتای پایین.
.IP \fBhigh_shibata\fR 4
.IX Item "high_shibata"
انتخاب دیتر شکل‌دهی نوفه شیباتای بالا.
.IP \fBf_weighted\fR 4
.IX Item "f_weighted"
انتخاب دیتر شکل‌دهی نوفه با وزن‌دهی f
.IP \fBmodified_e_weighted\fR 4
.IX Item "modified_e_weighted"
انتخاب دیتر شکل‌دهی نوفه با وزن‌دهی modified\-e
.IP \fBimproved_e_weighted\fR 4
.IX Item "improved_e_weighted"
انتخاب دیتر شکل‌دهی نوفه با وزن‌دهی improved\-e
.RE
.RS 4
.RE
.IP \fBresampler\fR 4
.IX Item "resampler"
تنظیم موتور تغییر نمونه‌برداری. مقدار پیش‌فرض swr است.
.Sp
مقادیر پشتیبانی‌شده:
.RS 4
.IP \fBswr\fR 4
.IX Item "swr"
انتخاب تغییردهنده بومی SW Resampler؛ در این حالت گزینه‌های فیلتر precision و cheby
قابل اعمال نیستند.
.IP \fBsoxr\fR 4
.IX Item "soxr"
انتخاب تغییردهنده SoX Resampler (در صورت وجود)؛ در این حالت جبران‌سازی و گزینه‌های فیلتر
filter_size، phase_shift، exact_rational، filter_type و kaiser_beta
قابل اعمال نیستند.
.RE
.RS 4
.RE
.IP \fBfilter_size\fR 4
.IX Item "filter_size"
تنها برای swr؛ تنظیم اندازه فیلتر تغییر نمونه‌برداری، مقدار پیش‌فرض 32 است.
.IP \fBphase_shift\fR 4
.IX Item "phase_shift"
تنها برای swr؛ تنظیم شیفت فاز تغییر نمونه‌برداری، مقدار پیش‌فرض 10 است و باید در
بازه [0,30] باشد.
.IP \fBlinear_interp\fR 4
.IX Item "linear_interp"
استفاده از درون‌یابی خطی در صورت فعال بودن (پیش‌فرض). اگر می‌خواهید هنگام
شکست exact_rational به جای کیفیت، سرعت حفظ شود، آن را غیرفعال کنید.
.IP \fBexact_rational\fR 4
.IX Item "exact_rational"
تنها برای swr؛ در صورت فعال بودن، تلاش می‌کند بر اساس نرخ نمونه‌برداری ورودی و
خروجی از phase_count دقیق استفاده کند. با این حال، اگر بزرگ‌تر از \f(CW\*(C`1 << phase_shift\*(C'\fR باشد،
مقدار phase_count به عنوان جایگزین برابر با \f(CW\*(C`1 << phase_shift\*(C'\fR خواهد شد. پیش‌فرض فعال است.
.IP \fBcutoff\fR 4
.IX Item "cutoff"
تنظیم نسبت فرکانس قطع (swr: نقطه 6dB؛ soxr: نقطه 0dB)؛ باید یک مقدار
اعشاری بین 0 و 1 باشد. مقدار پیش‌فرض با swr برابر 0.97 و با soxr برابر 0.91 است
(که در نرخ نمونه‌برداری 44100، کل باند صوتی را تا 20kHz حفظ می‌کند).
.IP \fBprecision\fR 4
.IX Item "precision"
تنها برای soxr؛ دقت بر حسب بیت که سیگنال تغییر نمونه‌یافته با آن محاسبه خواهد شد.
مقدار پیش‌فرض 20 (که با دیترینگ مناسب برای عمق بیت مقصد 16 مناسب است)
کیفیت بالای SoX (\*(AqHigh Quality\*(Aq) را به دست می‌دهد؛ مقدار 28 کیفیت بسیار بالای SoX (\*(AqVery High Quality\*(Aq) را ارائه می‌کند.
.IP \fBcheby\fR 4
.IX Item "cheby"
تنها برای soxr؛ انتخاب رول‌آف باند گذر بدون افت (چبیشف / Chebyshev) و تقریب با دقت بالاتر
برای نسبت‌های «گنگ». مقدار پیش‌فرض 0 است.
.IP \fBasync\fR 4
.IX Item "async"
تنها برای swr؛ همگام‌سازی ساده صوتی ۱ پارامتری با برچسب‌های زمانی با استفاده از کشیدن،
فشرده‌سازی، پر کردن و برش دادن. تنظیم این مقدار روی 1 پر کردن و برش دادن را فعال می‌کند؛
مقادیر بزرگ‌تر نشان‌دهنده حداکثر مقدار بر حسب نمونه است که داده‌ها ممکن است در هر ثانیه کشیده یا فشرده شوند.
مقدار پیش‌فرض 0 است، بنابراین هیچ جبرانی برای تطبیق نمونه‌ها با
برچسب‌های زمانی صدا اعمال نمی‌شود.
.IP \fBfirst_pts\fR 4
.IX Item "first_pts"
تنها برای swr؛ فرض می‌کند که اولین pts باید این مقدار باشد. واحد زمان 1 / نرخ نمونه‌برداری است.
این امکان پدگذاری/برش در آغاز جریان را فراهم می‌سازد. به طور پیش‌فرض، هیچ
فرضی درباره pts مورد انتظار اولین فریم وجود ندارد، بنابراین هیچ پدگذاری یا
برشی صورت نمی‌گیرد. به عنوان مثال، در صورتی که یک جریان صوتی پس از جریان ویدیو آغاز شود،
می‌توان این مقدار را روی 0 تنظیم کرد تا ابتدای آن با سکوت پر شود، یا نمونه‌هایی که به دلیل تأخیر انکودر pts منفی دارند بریده شوند.
.IP \fBmin_comp\fR 4
.IX Item "min_comp"
تنها برای swr؛ تنظیم حداقل اختلاف میان برچسب‌های زمانی و داده‌های صوتی (بر حسب
ثانیه) برای آغاز کشیدن/فشرده‌سازی/پر کردن یا برش داده‌ها به منظور تطبیق
با برچسب‌های زمانی. پیش‌فرض این است که کشیدن/فشرده‌سازی/پر کردن و برش غیرفعال است
(\fBmin_comp\fR = \f(CW\*(C`FLT_MAX\*(C'\fR).
.IP \fBmin_hard_comp\fR 4
.IX Item "min_hard_comp"
تنها برای swr؛ تنظیم حداقل اختلاف میان برچسب‌های زمانی و داده‌های صوتی (بر حسب
ثانیه) برای آغاز افزودن/انداختن نمونه‌ها به منظور تطبیق با
برچسب‌های زمانی. این گزینه در واقع آستانه‌ای برای انتخاب میان جبران سخت (برش/پر کردن)
و نرم (فشرده‌سازی/کشیدگی) است. توجه داشته باشید که تمامی جبران‌ها به طور پیش‌فرض
از طریق \fBmin_comp\fR غیرفعال هستند.
پیش‌فرض 0.1 است.
.IP \fBcomp_duration\fR 4
.IX Item "comp_duration"
تنها برای swr؛ تنظیم مدت‌زمان (بر حسب ثانیه) که داده‌ها در طول آن کشیده/فشرده می‌شوند
تا با برچسب‌های زمانی مطابقت یابند. باید یک مقدار اعشاری ممیز شناور مضاعف غیرمنفی باشد؛
مقدار پیش‌فرض 1.0 است.
.IP \fBmax_soft_comp\fR 4
.IX Item "max_soft_comp"
تنها برای swr؛ تنظیم حداکثر ضریبی که داده‌ها با آن کشیده/فشرده می‌شوند تا با برچسب‌های
زمانی مطابقت یابند. باید یک مقدار اعشاری ممیز شناور مضاعف غیرمنفی باشد؛ مقدار پیش‌فرض
0 است.
.IP \fBmatrix_encoding\fR 4
.IX Item "matrix_encoding"
انتخاب انکودینگ استریوی ماتریسی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
انتخاب هیچ (none)
.IP \fBdolby\fR 4
.IX Item "dolby"
انتخاب دالبی (Dolby)
.IP \fBdplii\fR 4
.IX Item "dplii"
انتخاب دالبی پرو لاجیک ۲ (Dolby Pro Logic II)
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.RE
.IP \fBfilter_type\fR 4
.IX Item "filter_type"
تنها برای swr؛ انتخاب نوع فیلتر تغییر نمونه‌برداری. این گزینه تنها بر عملیات
تغییر نمونه‌برداری تأثیر می‌گذارد.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBcubic\fR 4
.IX Item "cubic"
انتخاب مکعبی (cubic)
.IP \fBblackman_nuttall\fR 4
.IX Item "blackman_nuttall"
انتخاب سینک با پنجره بلکمن\-ناتال (Blackman Nuttall)
.IP \fBkaiser\fR 4
.IX Item "kaiser"
انتخاب سینک با پنجره کایزر (Kaiser)
.RE
.RS 4
.RE
.IP \fBkaiser_beta\fR 4
.IX Item "kaiser_beta"
تنها برای swr؛ تنظیم مقدار بتای پنجره کایزر. باید یک مقدار اعشاری در
بازه [2,16] باشد؛ مقدار پیش‌فرض 9 است.
.IP \fBoutput_sample_bits\fR 4
.IX Item "output_sample_bits"
تنها برای swr؛ تنظیم تعداد بیت‌های نمونه خروجی مورد استفاده برای دیترینگ. باید یک عدد صحیح در
بازه [0,64] باشد؛ مقدار پیش‌فرض 0 است، که به معنای عدم استفاده است.
.SH "گزینه‌های مقیاس‌بندی (SCALER OPTIONS)"
.IX Header "SCALER OPTIONS"
مقیاس‌بخش ویدیو از گزینه‌های نام‌برده زیر پشتیبانی می‌کند.
.PP
گزینه‌ها را می‌توان با تعیین \-\fIگزینه\fR \fIمقدار\fR در
ابزارهای FFmpeg تنظیم کرد، به جز چند مورد استثنا که فقط مختص API هستند و در زیر ذکر شده‌اند.
برای کاربردهای برنامه‌نویسی، می‌توان آن‌ها را صراحتاً در گزینه‌های
\&\f(CW\*(C`SwsContext\*(C'\fR یا از طریق API موجود در \fIlibavutil/opt.h\fR تنظیم نمود.
.IP "\fBscaler, scaler_sub\fR" 4
.IX Item "scaler, scaler_sub"
انتخاب الگوریتم مقیاس‌بندی مورد استفاده. مقدار پیش‌فرض برای هر دو \fBauto\fR است.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار. برای \fBscaler_sub\fR، این به معنای همان الگوریتم
\&\fBscaler\fR است. برای \fBscaler\fR، پیش‌فرض روی پرچم مقیاس‌بخش انتخاب‌شده
توسط \fBsws_flags\fR قرار می‌گیرد.
.IP \fBbilinear\fR 4
.IX Item "bilinear"
فیلتر دوخطی (Bilinear؛ معروف به فیلتر مثلثی).
.IP \fBbicubic\fR 4
.IX Item "bicubic"
اسپلاین دومکعبی BC با ۲ تپ (معروف به اسپلاین Mitchell\-Netravali). پارامترهای B و C
را می‌توان با تنظیم \f(CW\*(C`param0\*(C'\fR و \f(CW\*(C`param1\*(C'\fR پیکربندی کرد، که به ترتیب
پیش‌فرض 0.0 و 0.6 دارند.
.IP "\fBpoint, neighbor\fR" 4
.IX Item "point, neighbor"
نمونه‌برداری نقطه‌ای (معروف به نزدیک‌ترین همسایه / nearest neighbor).
.IP \fBarea\fR 4
.IX Item "area"
میانگین‌گیری مساحتی. برای بزرگ‌نمایی (upscaling) معادل \fBbilinear\fR است.
.IP \fBgaussian\fR 4
.IX Item "gaussian"
تقریب فیلتر گوسی با ۲ تپ. پارامتر وضوح (sharpness) را می‌توان
با تنظیم \f(CW\*(C`param0\*(C'\fR پیکربندی کرد، که پیش‌فرض 3.0 است.
.IP \fBsinc\fR 4
.IX Item "sinc"
فیلتر sinc بدون پنجره.
.IP \fBlanczos\fR 4
.IX Item "lanczos"
تغییر نمونه‌برداری لنتسوش (Lanczos؛ سینک با پنجره سینک). تعداد تپ‌های فیلتر را
می‌توان با تنظیم \f(CW\*(C`param0\*(C'\fR پیکربندی کرد، که پیش‌فرض 3 است.
.IP \fBspline\fR 4
.IX Item "spline"
اسپلاین طبیعی دومکعبی بدون پنجره.
.RE
.RS 4
.RE
.IP \fBsws_flags\fR 4
.IX Item "sws_flags"
تنظیم پرچم‌های مقیاس‌بخش. از این گزینه برای تعیین الگوریتم
مقیاس‌بندی نیز استفاده می‌شود، اگرچه این کاربرد به نفع تنظیم \fBscaler\fR منسوخ شده است.
تنها یک الگوریتم واحد می‌تواند انتخاب شود. مقدار پیش‌فرض \fBbicubic\fR است.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBfast_bilinear\fR 4
.IX Item "fast_bilinear"
انتخاب الگوریتم مقیاس‌بندی دوخطی سریع. (منسوخ)
.IP \fBbilinear\fR 4
.IX Item "bilinear"
انتخاب الگوریتم مقیاس‌بندی دوخطی. (منسوخ)
.IP \fBbicubic\fR 4
.IX Item "bicubic"
انتخاب الگوریتم مقیاس‌بندی دومکعبی. (منسوخ)
.IP \fBexperimental\fR 4
.IX Item "experimental"
انتخاب الگوریتم مقیاس‌بندی آزمایشی. (منسوخ)
.IP \fBneighbor\fR 4
.IX Item "neighbor"
انتخاب الگوریتم تغییر مقیاس نزدیک‌ترین همسایه. (منسوخ)
.IP \fBarea\fR 4
.IX Item "area"
انتخاب الگوریتم تغییر مقیاس میانگین‌گیری مساحت. (منسوخ)
.IP \fBbicublin\fR 4
.IX Item "bicublin"
انتخاب الگوریتم مقیاس‌بندی دومکعبی برای مؤلفه روشنایی (luma) و دوخطی برای
مؤلفه‌های رنگ (chroma). (منسوخ)
.IP \fBgauss\fR 4
.IX Item "gauss"
انتخاب الگوریتم تغییر مقیاس گوسی. (منسوخ)
.IP \fBsinc\fR 4
.IX Item "sinc"
انتخاب الگوریتم تغییر مقیاس sinc. (منسوخ)
.IP \fBlanczos\fR 4
.IX Item "lanczos"
انتخاب الگوریتم تغییر مقیاس لنتسوش (Lanczos). پهنای پیش‌فرض (آلفا) 3 است و می‌تواند
با تنظیم \f(CW\*(C`param0\*(C'\fR تغییر یابد. (منسوخ)
.IP \fBspline\fR 4
.IX Item "spline"
انتخاب الگوریتم تغییر مقیاس اسپلاین طبیعی دومکعبی. (منسوخ)
.IP \fBprint_info\fR 4
.IX Item "print_info"
فعال‌سازی چاپ اطلاعات / ثبت وقایع اشکال‌زدایی.
.IP \fBaccurate_rnd\fR 4
.IX Item "accurate_rnd"
فعال‌سازی گرد کردن دقیق.
.IP \fBfull_chroma_int\fR 4
.IX Item "full_chroma_int"
فعال‌سازی درون‌یابی کامل کروما.
.IP \fBfull_chroma_inp\fR 4
.IX Item "full_chroma_inp"
انتخاب ورودی کامل کروما.
.IP \fBbitexact\fR 4
.IX Item "bitexact"
فعال‌سازی خروجی دقیق بیت‌به‌بیت (bitexact).
.IP \fBunstable\fR 4
.IX Item "unstable"
اجازه استفاده از کدهای جدید آزمایشی. ممکن است اندکی بر خروجی تأثیر بگذارد یا حتی
نتایج نادرست تولید کند. تنها برای آزمایش.
.RE
.RS 4
.RE
.IP "\fBsrcw\fR \fI(تنها API)\fR" 4
.IX Item "srcw (API only)"
تنظیم عرض مبدأ.
.IP "\fBsrch\fR \fI(تنها API)\fR" 4
.IX Item "srch (API only)"
تنظیم ارتفاع مبدأ.
.IP "\fBdstw\fR \fI(تنها API)\fR" 4
.IX Item "dstw (API only)"
تنظیم عرض مقصد.
.IP "\fBdsth\fR \fI(تنها API)\fR" 4
.IX Item "dsth (API only)"
تنظیم ارتفاع مقصد.
.IP "\fBsrc_format\fR \fI(تنها API)\fR" 4
.IX Item "src_format (API only)"
تنظیم قالب پیکسلی مبدأ (باید به صورت یک عدد صحیح بیان شود).
.IP "\fBdst_format\fR \fI(تنها API)\fR" 4
.IX Item "dst_format (API only)"
تنظیم قالب پیکسلی مقصد (باید به صورت یک عدد صحیح بیان شود).
.IP "\fBsrc_range\fR \fI(بولی)\fR" 4
.IX Item "src_range (boolean)"
اگر مقدار روی \f(CW1\fR تنظیم شود، نشان‌دهنده دامنه کامل (full range) بودن مبدأ است. مقدار پیش‌فرض
\&\f(CW0\fR است که نشان‌دهنده دامنه محدود (limited range) بودن مبدأ است.
.IP "\fBdst_range\fR \fI(بولی)\fR" 4
.IX Item "dst_range (boolean)"
اگر مقدار روی \f(CW1\fR تنظیم شود، دامنه کامل را برای مقصد فعال می‌کند. مقدار پیش‌فرض
\&\f(CW0\fR است که دامنه محدود را فعال می‌سازد.
.IP "\fBgamma\fR \fI(بولی)\fR" 4
.IX Item "gamma (boolean)"
اگر مقدار روی \f(CW1\fR تنظیم شود، مقیاس‌بندی با تصحیح گاما فعال می‌شود. مقدار پیش‌فرض \f(CW0\fR است.
.IP "\fBparam0, param1\fR" 4
.IX Item "param0, param1"
تنظیم پارامترهای الگوریتم مقیاس‌بندی. مقادیر تعیین‌شده مختص
برخی الگوریتم‌های مقیاس‌بندی هستند و توسط سایرین نادیده گرفته می‌شوند. مقادیر تعیین‌شده
مقادیر عددی ممیز شناور هستند.
.IP \fBsws_dither\fR 4
.IX Item "sws_dither"
تنظیم الگوریتم دیترینگ. یکی از مقادیر زیر را می‌پذیرد.
مقدار پیش‌فرض \fBauto\fR است.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار
.IP \fBnone\fR 4
.IX Item "none"
بدون دیترینگ
.IP \fBbayer\fR 4
.IX Item "bayer"
دیتر بایر (bayer dither)
.IP \fBed\fR 4
.IX Item "ed"
دیتر انتشار خطا (error diffusion dither)
.IP \fBa_dither\fR 4
.IX Item "a_dither"
دیتر حسابی، بر پایه استفاده از جمع
.IP \fBx_dither\fR 4
.IX Item "x_dither"
دیتر حسابی، بر پایه استفاده از xor (الگوهای تصادفی‌تر و کمتر آشکار نسبت به
a_dither).
.RE
.RS 4
.RE
.IP \fBalphablend\fR 4
.IX Item "alphablend"
تنظیم ترکیب آلفا هنگامی که ورودی دارای آلفا است اما خروجی فاقد آن است.
مقدار پیش‌فرض \fBnone\fR است.
.RS 4
.IP \fBuniform_color\fR 4
.IX Item "uniform_color"
ترکیب روی یک رنگ پس‌زمینه یکنواخت
.IP \fBcheckerboard\fR 4
.IX Item "checkerboard"
ترکیب روی صفحه شطرنجی
.IP \fBnone\fR 4
.IX Item "none"
بدون ترکیب
.RE
.RS 4
.RE
.IP \fBsws_backends\fR 4
.IX Item "sws_backends"
تنظیم بک‌اندهای مجاز swscale. این یک گزینه پرچمی است، بنابراین چندین بک‌اند
می‌توانند با یکدیگر ترکیب شوند.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار. بسته به این‌که پرچم \fBunstable\fR تنظیم شده باشد یا خیر،
برابر با \fBstable\fR یا \fBall\fR خواهد بود. این مقدار پیش‌فرض است.
.IP \fBstable\fR 4
.IX Item "stable"
تمامی بک‌اندهای پایدار.
.IP \fBunstable\fR 4
.IX Item "unstable"
تمامی بک‌اندهای ناپایدار.
.IP \fBall\fR 4
.IX Item "all"
تمامی بک‌اندهای در دسترس.
.IP \fBlegacy\fR 4
.IX Item "legacy"
کد موروثی و قدیمی swscale.
.IP \fBc\fR 4
.IX Item "c"
کد مرجع مبتنی بر الگو (Template\-based).
.IP \fBmemcpy\fR 4
.IX Item "memcpy"
مسیر سریع با استفاده از \f(CW\*(C`memcpy\*(C'\fR در libc.
.IP \fBx86\fR 4
.IX Item "x86"
کرنل‌های SIMD معماری x86.
.IP \fBaarch64\fR 4
.IX Item "aarch64"
کرنل‌های NEON معماری AArch64.
.IP \fBspirv\fR 4
.IX Item "spirv"
بک‌اند Vulkan SPIR\-V.
.RE
.RS 4
.RE
.SH "مقدمه فیلترگذاری (FILTERING INTRODUCTION)"
.IX Header "FILTERING INTRODUCTION"
فیلترگذاری در FFmpeg از طریق کتابخانه libavfilter انجام می‌پذیرد.
.PP
در libavfilter، یک فیلتر می‌تواند چندین ورودی و چندین
خروجی داشته باشد.
برای نشان دادن مواردی که امکان‌پذیر است، گراف فیلتر (filtergraph)
زیر را در نظر می‌گیریم.
.PP
.Vb 5
\&                        [main]
\&        input \-\-> split \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-> overlay \-\-> output
\&                    |                             ^
\&                    |[tmp]                  [flip]|
\&                    +\-\-\-\-\-> crop \-\-> vflip \-\-\-\-\-\-\-+
.Ve
.PP
این گراف فیلتر جریان ورودی را به دو جریان تقسیم می‌کند، سپس یکی از
جریان‌ها را از فیلتر crop و سپس فیلتر vflip عبور می‌دهد، پیش از آن‌که با
انداختن آن بر روی جریان دیگر از طریق overlay، آن‌ها را مجدداً ادغام کند. برای رسیدن به این هدف
می‌توانید از دستور زیر استفاده نمایید:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-vf "split [main][tmp]; [tmp] crop=iw:ih/2:0:0, vflip [flip]; [main][flip] overlay=0:H/2" OUTPUT
.Ve
.PP
نتیجه این خواهد بود که نیمه بالایی ویدیو به صورت آینه‌ای
روی نیمه پایینی ویدیوی خروجی قرار می‌گیرد.
.PP
فیلترها در یک زنجیره خطی با کاما (ویرگول انگلیسی) از هم جدا می‌شوند، و زنجیره‌های
خطی متمایز فیلترها با سمیکالن (نقطه‌ویرگول) جدا می‌گردند. در مثال ما،
\&\fIcrop,vflip\fR در یک زنجیره خطی قرار دارند و \fIsplit\fR و
\&\fIoverlay\fR به طور جداگانه در زنجیره دیگری هستند. نقاطی که زنجیره‌های
خطی به هم می‌پیوندند با نام‌هایی محصور در کروشه مشخص می‌شوند. در این
مثال، فیلتر split دو خروجی تولید می‌کند که با برچسب‌های
\&\fI[main]\fR و \fI[tmp]\fR مرتبط شده‌اند.
.PP
جریانی که به دومین خروجی \fIsplit\fR ارسال می‌شود، با برچسب
\&\fI[tmp]\fR، از طریق فیلتر \fIcrop\fR پردازش می‌گردد که نیمه پایینی
ویدیو را برش داده و سپس به صورت عمودی معکوس (flip) می‌کند. فیلتر
\&\fIoverlay\fR در ورودی خود اولین خروجی بدون تغییر فیلتر split را دریافت می‌کند
(که با نام \fI[main]\fR برچسب‌گذاری شده بود)، و خروجی تولیدشده توسط
زنجیره فیلتر \fIcrop,vflip\fR را روی نیمه پایینی آن می‌اندازد.
.PP
برخی فیلترها فهرستی از پارامترها را در ورودی دریافت می‌کنند: این پارامترها
پس از نام فیلتر و یک علامت مساوی مشخص می‌شوند، و با علامت دو‌نقطه (کولن)
از یکدیگر جدا می‌گردند.
.PP
فیلترهایی موسوم به \fIفیلترهای مبدأ (source filters)\fR وجود دارند که فاقد
ورودی صدا/ویدیو هستند، و \fIفیلترهای مقصد (sink filters)\fR که خروجی
صدا/ویدیو نخواهند داشت.
.SH "گراف (GRAPH)"
.IX Header "GRAPH"
برنامه \fIgraph2dot\fR موجود در دایرکتوری \fItools\fR در FFmpeg
می‌تواند برای تجزیه شرح یک گراف فیلتر و ارائه یک نمایش متنی
متناظر به زبان dot استفاده شود.
.PP
دستور:
.PP
.Vb 1
\&        graph2dot \-h
.Ve
.PP
را اجرا کنید تا نحوه استفاده از \fIgraph2dot\fR را مشاهده نمایید.
.PP
سپس می‌توانید شرح dot را به برنامه \fIdot\fR (از مجموعه برنامه‌های graphviz)
ارسال نموده و یک نمایش گرافیکی از گراف فیلتر به دست آورید.
.PP
برای نمونه، دنباله دستورات:
.PP
.Vb 4
\&        echo <GRAPH_DESCRIPTION> | \e
\&        tools/graph2dot \-o graph.tmp && \e
\&        dot \-Tpng graph.tmp \-o graph.png && \e
\&        display graph.png
.Ve
.PP
می‌تواند برای ایجاد و نمایش تصویری به کار رود که گرافِ شرح‌داده‌شده توسط
رشته \fIGRAPH_DESCRIPTION\fR را نشان می‌دهد. توجه داشته باشید که این رشته باید یک
گراف کامل و مستقل باشد که ورودی‌ها و خروجی‌های آن به طور صریح تعریف شده باشند.
برای مثال اگر خط فرمان شما به شکل زیر باشد:
.PP
.Vb 1
\&        ffmpeg \-i infile \-vf scale=640:360 outfile
.Ve
.PP
رشته \fIGRAPH_DESCRIPTION\fR شما باید به صورت زیر باشد:
.PP
.Vb 1
\&        nullsrc,scale=640:360,nullsink
.Ve
.PP
همچنین ممکن است برای شبیه‌سازی یک پرونده ورودی خاص، نیاز به تنظیم پارامترهای
\&\fInullsrc\fR و افزودن یک فیلتر \fIformat\fR داشته باشید.
.SH "شرح گراف فیلتر (FILTERGRAPH DESCRIPTION)"
.IX Header "FILTERGRAPH DESCRIPTION"
یک گراف فیلتر (filtergraph) یک گراف جهت‌دار از فیلترهای متصل به هم است. این گراف
می‌تواند شامل چرخه (دور) باشد و ممکن است چندین پیوند میان یک جفت فیلتر
وجود داشته باشد. هر پیوند دارای یک پد ورودی در یک سو است که آن را به فیلتری
که ورودی را از آن می‌گیرد متصل می‌کند، و یک پد خروجی در سوی دیگر دارد که آن را
به فیلتری که خروجی‌اش را می‌پذیرد پیوند می‌دهد.
.PP
هر فیلتر در یک گراف فیلتر نمونه‌ای از یک کلاس فیلتر ثبت‌شده
در برنامه است، که ویژگی‌ها و تعداد پدهای ورودی و خروجی فیلتر را
تعریف می‌کند.
.PP
فیلتری که هیچ پد ورودی ندارد "مبدأ" (source) نامیده می‌شود، و فیلتری که پد
خروجی ندارد "مقصد" (sink) نام دارد.
.SS "نحو گراف فیلتر (Filtergraph syntax)"
.IX Subsection "Filtergraph syntax"
گراف فیلتر دارای یک نمایش متنی است که توسط گزینه‌های
\&\fB\-filter\fR/\fB\-vf\fR/\fB\-af\fR و
\&\fB\-filter_complex\fR در \fBffmpeg\fR و گزینه‌های
\&\fB\-vf\fR/\fB\-af\fR در \fBffplay\fR، و توسط تابع
\&\f(CWavfilter_graph_parse_ptr()\fR تعریف‌شده در
\&\fIlibavfilter/avfilter.h\fR شناسایی می‌شود.
.PP
یک زنجیره فیلتر (filterchain) شامل دنباله‌ای از فیلترهای متصل به هم است که هر یک
به فیلتر پیشین خود در دنباله متصل است. یک زنجیره فیلتر با فهرستی از
شرح‌های فیلتر که با کاما (",") از هم جدا شده‌اند نشان داده می‌شود.
.PP
یک گراف فیلتر از دنباله‌ای از زنجیره‌های فیلتر تشکیل شده است. دنباله‌ای از زنجیره‌های
فیلتر با فهرستی از شرح‌های زنجیره فیلتر که با سمیکالن (";") از هم جدا شده‌اند
نمایش داده می‌شود.
.PP
یک فیلتر با رشته‌ای به فرم زیر نمایش داده می‌شود:
[\fIin_link_1\fR]...[\fIin_link_N\fR]\fIfilter_name\fR@\fIid\fR=\fIarguments\fR[\fIout_link_1\fR]...[\fIout_link_M\fR]
.PP
عبارت \&\fIfilter_name\fR نام کلاس فیلتری است که فیلترِ شرح داده‌شده
نمونه‌ای از آن است، و باید نام یکی از کلاس‌های فیلتر ثبت‌شده در برنامه
باشد که به صورت اختیاری پس از آن "@\fIid\fR" می‌آید.
پس از نام کلاس فیلتر، به صورت اختیاری رشته "=\fIarguments\fR" قرار می‌گیرد.
.PP
عبارت \&\fIarguments\fR رشته‌ای است که شامل پارامترهای مورد استفاده برای
مقداردهی اولیه نمونه فیلتر است. این رشته می‌تواند یکی از دو فرم زیر را داشته باشد:
.IP \(bu 4
فهرستی از جفت‌های \fIkey=value\fR که با ':' از هم جدا شده‌اند.
.IP \(bu 4
فهرستی از \fIvalue\fR که با ':' جدا شده‌اند. در این حالت، کلیدها همان نام‌های گزینه‌ها
به ترتیبی که اعلان شده‌اند در نظر گرفته می‌شوند. برای نمونه، فیلتر \f(CW\*(C`fade\*(C'\fR
سه گزینه را به این ترتیب اعلان می‌کند: \fBtype\fR، \fBstart_frame\fR و
\&\fBnb_frames\fR. بنابراین فهرست پارامتر \fIin:0:30\fR بدین معناست که مقدار
\&\fIin\fR به گزینه \fBtype\fR، مقدار \fI0\fR به
\&\fBstart_frame\fR و \fI30\fR به \fBnb_frames\fR تخصیص می‌یابد.
.IP \(bu 4
فهرستی جداشده با ':' از مقادیر مستقیم \fIvalue\fR و جفت‌های کامل \fIkey=value\fR به صورت ترکیبی.
مقدار مستقیم \fIvalue\fR باید پیش از جفت‌های \fIkey=value\fR بیاید، و
از همان ترتیب محدودیت‌های بند پیشین پیروی کند. جفت‌های \fIkey=value\fR پس از آن
می‌توانند به هر ترتیب دلخواهی تنظیم شوند.
.PP
اگر مقدار گزینه خود فهرستی از موارد باشد (به عنوان نمونه فیلتر \f(CW\*(C`format\*(C'\fR
فهرستی از قالب‌های پیکسل را می‌گیرد)، موارد موجود در فهرست معمولاً با
\&\fB|\fR از هم جدا می‌شوند.
.PP
فهرست آرگومان‌ها را می‌توان با استفاده از نویسه \fB\(aq\fR به عنوان نشانگر آغاز
و پایان نقل‌قول کرد، و از نویسه \fB\e\fR برای گریز (escape) نویسه‌ها
درون متن نقل‌شده استفاده نمود؛ در غیر این صورت، رشته آرگومان زمانی خاتمه‌یافته تلقی می‌شود
که با نویسه خاص بعدی (متعلق به مجموعه \&\fB[]=;,\fR) مواجه شود.
.PP
نحو ویژه‌ای که در ابزار خط فرمان \fBffmpeg\fR پیاده‌سازی شده، امکان بارگذاری
مقادیر گزینه‌ها را از پرونده‌ها فراهم می‌سازد. این کار با افزودن یک اسلش '/' به ابتدای
نام گزینه انجام می‌شود؛ در این حالت مقدار ارائه‌شده به عنوان مسیری تفسیر می‌شود که
مقدار واقعی از آن بارگذاری می‌گردد. به عنوان مثال:
.PP
.Vb 1
\&        ffmpeg \-i <INPUT> \-vf drawtext=/text=/tmp/some_text <OUTPUT>
.Ve
.PP
متنی که باید ترسیم شود را از \fI/tmp/some_text\fR بارگذاری خواهد کرد. کاربران API که مایل به
پیاده‌سازی قابلیتی مشابه هستند باید از توابع \f(CW\*(C`avfilter_graph_segment_*()\*(C'\fR
همراه با کد سفارشی ورودی/خروجی استفاده کنند.
.PP
نام و آرگومان‌های فیلتر به صورت اختیاری می‌توانند قبل و بعد با
فهرستی از برچسب‌های پیوند (link labels) همراه شوند.
یک برچسب پیوند امکان نام‌گذاری یک پیوند و اتصال آن به یک پد ورودی
یا خروجی فیلتر را فراهم می‌سازد. برچسب‌های پیشین \fIin_link_1\fR
\&... \fIin_link_N\fR، به پدهای ورودی فیلتر متصل می‌شوند،
و برچسب‌های پسین \fIout_link_1\fR ... \fIout_link_M\fR به
پدهای خروجی مرتبط می‌گردند.
.PP
هنگامی که دو برچسب پیوند با نام یکسان در گراف فیلتر یافت شوند،
پیوندی میان پد ورودی و خروجی متناظر ایجاد می‌شود.
.PP
اگر یک پد خروجی برچسب‌گذاری نشده باشد، به طور پیش‌فرض به اولین پد
ورودی بدون برچسب از فیلتر بعدی در زنجیره فیلتر پیوند می‌خورد.
برای مثال در زنجیره فیلتر:
.PP
.Vb 1
\&        nullsrc, split[L1], [L2]overlay, nullsink
.Ve
.PP
نمونه فیلتر split دو پد خروجی دارد و نمونه فیلتر overlay دارای دو
پد ورودی است. اولین پد خروجی split با "L1" برچسب‌گذاری شده،
اولین پد ورودی overlay با "L2" برچسب خورده، و دومین پد خروجی
split به دومین پد ورودی overlay متصل می‌شود، که هر دو بدون برچسب هستند.
.PP
در شرح یک فیلتر، اگر برچسب ورودی اولین فیلتر تعیین نشود،
"in" فرض می‌شود؛ اگر برچسب خروجی آخرین فیلتر مشخص نشود،
"out" در نظر گرفته می‌شود.
.PP
در یک زنجیره فیلتر کامل، تمامی پدهای ورودی و خروجی بدون برچسب فیلترها باید
متصل باشند. یک گراف فیلتر زمانی معتبر شناخته می‌شود که تمامی پدهای
ورودی و خروجی تمام زنجیره‌های فیلتر متصل باشند.
.PP
فضاهای خالی آغازین و پایانی (فاصله، تب، یا سرخط) که نشانه‌ها (tokens) را در
مشخصات گراف فیلتر از هم جدا می‌کنند نادیده گرفته می‌شوند. این بدان معناست که
می‌توان گراف فیلتر را با استفاده از خطوط خالی و فاصله‌ها برای خوانایی بهتر بیان کرد.
.PP
به عنوان مثال، گراف فیلتر:
.PP
.Vb 1
\&        testsrc,split[L1],hflip[L2];[L1][L2] hstack
.Ve
.PP
می‌تواند به صورت زیر نمایش داده شود:
.PP
.Vb 2
\&        testsrc,
\&        split [L1], hflip [L2];
\&        
\&        [L1][L2] hstack
.Ve
.PP
کتابخانه Libavfilter در جاهایی که تبدیل قالب مورد نیاز باشد به طور خودکار
فیلترهای \fBscale\fR را درج می‌کند. می‌توان پرچم‌های swscale را
برای این مقیاس‌بخش‌های درج‌شده خودکار با افزودن عبارت
\&\f(CW\*(C`sws_flags=\fR\f(CIflags\fR\f(CW;\*(C'\fR
به ابتدای شرح گراف فیلتر تعیین نمود.
.PP
در ادامه شرح BNF نحو گراف فیلتر آورده شده است:
.PP
.Vb 8
\&        <NAME>             ::= sequence of alphanumeric characters and \*(Aq_\*(Aq
\&        <FILTER_NAME>      ::= <NAME>["@"<NAME>]
\&        <LINKLABEL>        ::= "[" <NAME> "]"
\&        <LINKLABELS>       ::= <LINKLABEL> [<LINKLABELS>]
\&        <FILTER_ARGUMENTS> ::= sequence of chars (possibly quoted)
\&        <FILTER>           ::= [<LINKLABELS>] <FILTER_NAME> ["=" <FILTER_ARGUMENTS>] [<LINKLABELS>]
\&        <FILTERCHAIN>      ::= <FILTER> [,<FILTERCHAIN>]
\&        <FILTERGRAPH>      ::= [sws_flags=<flags>;] <FILTERCHAIN> [;<FILTERGRAPH>]
.Ve
.SS "نکاتی درباره گریز در گراف فیلتر (Notes on filtergraph escaping)"
.IX Subsection "Notes on filtergraph escaping"
نوشتن شرح گراف فیلتر نیازمند چندین لایه گریز (escaping) است. برای اطلاعات بیشتر
درباره روند گریز، به \fBبخش "نقل‌قول و گریز" در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.PP
اولین سطح گریز بر محتوای مقدار هر گزینه فیلتر تأثیر می‌گذارد، که ممکن است
شامل نویسه خاص \f(CW\*(C`:\*(C'\fR برای جداسازی مقادیر، یا یکی از نویسه‌های
گریز \f(CW\*(C`\e\*(Aq\*(C'\fR باشد.
.PP
سطح دوم گریز بر کل شرح فیلتر تأثیر می‌گذارد، که ممکن است حاوی
نویسه‌های گریز \f(CW\*(C`\e\*(Aq\*(C'\fR یا نویسه‌های خاص \f(CW\*(C`[],;\*(C'\fR
باشد که توسط شرح گراف فیلتر استفاده می‌شوند.
.PP
در نهایت، هنگامی که یک گراف فیلتر را در خط فرمان شل مشخص می‌کنید،
باید یک سطح سوم از گریز را برای نویسه‌های خاص شل که در آن قرار دارند
انجام دهید.
.PP
به عنوان مثال، رشته زیر را در نظر بگیرید که قرار است درون مقدار
\&\fBtext\fR در فیلتر \fBdrawtext\fR قرار گیرد:
.PP
.Vb 1
\&        this is a \*(Aqstring\*(Aq: may contain one, or more, special characters
.Ve
.PP
این رشته حاوی نویسه خاص گریز \f(CW\*(C`\*(Aq\*(C'\fR و نویسه خاص
\&\f(CW\*(C`:\*(C'\fR است، بنابراین باید به این صورت گریز داده شود:
.PP
.Vb 1
\&        text=this is a \e\*(Aqstring\e\*(Aq\e: may contain one, or more, special characters
.Ve
.PP
هنگام قرار دادن شرح فیلتر در شرح گراف فیلتر، سطح دوم گریز لازم است تا
تمامی نویسه‌های خاص گراف فیلتر گریز داده شوند. بنابراین مثال بالا تبدیل می‌شود به:
.PP
.Vb 1
\&        drawtext=text=this is a \e\e\e\*(Aqstring\e\e\e\*(Aq\e\e: may contain one\e, or more\e, special characters
.Ve
.PP
(توجه داشته باشید که علاوه بر نویسه‌های خاص گریز \f(CW\*(C`\e\*(Aq\*(C'\fR،
نویسه \f(CW\*(C`,\*(C'\fR نیز باید گریز داده شود).
.PP
در نهایت یک سطح اضافی از گریز هنگام نوشتن شرح گراف فیلتر در دستور شل مورد نیاز است،
که به قواعد گریز شل مورد استفاده بستگی دارد. برای نمونه، با فرض این‌که
\&\f(CW\*(C`\e\*(C'\fR خاص باشد و نیاز به گریز با یک \f(CW\*(C`\e\*(C'\fR دیگر داشته باشد،
رشته قبلی در نهایت به این صورت خواهد بود:
.PP
.Vb 1
\&        \-vf "drawtext=text=this is a \e\e\e\e\e\e\*(Aqstring\e\e\e\e\e\e\*(Aq\e\e\e\e: may contain one\e\e, or more\e\e, special characters"
.Ve
.PP
به منظور اجتناب از گریزهای دست‌وپاگیر هنگام استفاده از ابزارهای خط فرمانی که
مشخصات فیلتر را به عنوان ورودی می‌پذیرند، توصیه می‌شود از گنجاندن مستقیم فیلتر
یا مشخصات گزینه‌ها در شل خودداری نمایید.
.PP
به عنوان مثال، در مورد \fBفیلتر drawtext\fR، ممکن است ترجیح دهید
از گزینه \fBtextfile\fR به جای \fBtext\fR برای تعیین متنِ
جهت رندر استفاده کنید.
.SH "ویرایش خط زمانی (TIMELINE EDITING)"
.IX Header "TIMELINE EDITING"
برخی فیلترها از گزینه عمومی \fBenable\fR پشتیبانی می‌کنند. برای فیلترهایی که
از ویرایش خط زمانی پشتیبانی می‌کنند، این گزینه می‌تواند روی عبارتی تنظیم شود که
پیش از ارسال یک فریم به فیلتر ارزیابی می‌گردد. اگر حاصل ارزیابی غیرصفر باشد،
فیلتر فعال خواهد شد؛ در غیر این صورت فریم بدون تغییر به فیلتر بعدی
در گراف فیلتر فرستاده می‌شود.
.PP
این عبارت مقادیر زیر را می‌پذیرد:
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بر حسب ثانیه؛ در صورتی که برچسب زمانی ورودی نامشخص باشد برابر NAN است
.IP \fBn\fR 4
.IX Item "n"
شماره ترتیبی فریم ورودی، با شروع از 0
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم ورودی در پرونده، در صورت نامشخص بودن NAN؛ منسوخ شده است،
استفاده نکنید
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع فریم ورودی در صورت ویدیو بودن
.PP
علاوه بر این، این فیلترها از یک دستور \fBenable\fR پشتیبانی می‌کنند که می‌تواند برای
تعریف مجدد عبارت استفاده شود.
.PP
همانند هر گزینه فیلترگذاری دیگر، گزینه \fBenable\fR نیز از همان قواعد پیروی می‌کند.
.PP
برای نمونه، جهت فعال‌سازی یک فیلتر مات‌کننده (\fBsmartblur\fR) از ثانیه 10 تا دقیقه
3، و یک فیلتر منحی‌ها (\fBcurves\fR) با شروع از ثانیه 3:
.PP
.Vb 2
\&        smartblur = enable=\*(Aqbetween(t,10,3*60)\*(Aq,
\&        curves    = enable=\*(Aqgte(t,3)\*(Aq : preset=cross_process
.Ve
.PP
برای مشاهده این‌که کدام فیلترها از خط زمانی پشتیبانی می‌کنند، به \f(CW\*(C`ffmpeg \-filters\*(C'\fR مراجعه کنید.
.SH "تغییر گزینه‌ها در زمان اجرا با دستور (CHANGING OPTIONS AT RUNTIME WITH A COMMAND)"
.IX Header "CHANGING OPTIONS AT RUNTIME WITH A COMMAND"
برخی گزینه‌ها را می‌توان در طول کارکرد فیلتر با استفاده از یک دستور
تغییر داد. این گزینه‌ها در خروجی دستور
\&\fBffmpeg\fR \fB\-h filter=<نام فیلتر>\fR با علامت \*(AqT\*(Aq مشخص شده‌اند.
نام دستور همان نام گزینه است و آرگومان آن مقدار جدید خواهد بود.
.SH "گزینه‌ها برای فیلترهای با چندین ورودی (OPTIONS FOR FILTERS WITH SEVERAL INPUTS)"
.IX Header "OPTIONS FOR FILTERS WITH SEVERAL INPUTS"
برخی فیلترها با چندین ورودی از مجموعه مشترکی از گزینه‌ها پشتیبانی می‌کنند.
این گزینه‌ها را تنها می‌توان با نام آن‌ها تنظیم کرد، نه با نشانه‌گذاری کوتاه.
.IP \fBeof_action\fR 4
.IX Item "eof_action"
اقدامی که در صورت مواجهه با پایان پرونده (EOF) در ورودی ثانویه انجام می‌شود؛ یکی از
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrepeat\fR 4
.IX Item "repeat"
تکرار آخرین فریم (پیش‌فرض).
.IP \fBendall\fR 4
.IX Item "endall"
پایان دادن به هر دو جریان.
.IP \fBpass\fR 4
.IX Item "pass"
عبور دادن ورودی اصلی بدون تغییر.
.RE
.RS 4
.RE
.IP \fBshortest\fR 4
.IX Item "shortest"
در صورت تنظیم روی 1، خروجی را وادار می‌کند با پایان یافتن کوتاه‌ترین
ورودی، خاتمه یابد. مقدار پیش‌فرض 0 است.
.IP \fBrepeatlast\fR 4
.IX Item "repeatlast"
در صورت تنظیم روی 1، فیلتر را وادار می‌کند آخرین فریم جریان‌های ثانویه را
تا انتهای جریان اولیه امتداد دهد. مقدار 0 این رفتار را غیرفعال می‌سازد.
مقدار پیش‌فرض 1 است.
.IP \fBts_sync_mode\fR 4
.IX Item "ts_sync_mode"
میزان دقت در همگام‌سازی جریان‌ها بر اساس برچسب‌های زمانی ورودی ثانویه؛ یکی
از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
فریمی از ورودی ثانویه با نزدیک‌ترین برچسب زمانی کوچک‌تر یا مساوی با
فریم ورودی اولیه.
.IP \fBnearest\fR 4
.IX Item "nearest"
فریمی از ورودی ثانویه با نزدیک‌ترین برچسب زمانی مطلق به فریم ورودی
اولیه.
.RE
.RS 4
.RE
.SH "فیلترهای صوتی (AUDIO FILTERS)"
.IX Header "AUDIO FILTERS"
هنگامی که ساخت FFmpeg خود را پیکربندی می‌کنید، می‌توانید هر یک از
فیلترهای موجود را با استفاده از \f(CW\*(C`\-\-disable\-filters\*(C'\fR غیرفعال کنید.
خروجی configure فیلترهای صوتی موجود در ساخت شما را نشان خواهد داد.
.PP
در ادامه شرحی از فیلترهای صوتی موجود فعلی آمده است.
.SS aap
.IX Subsection "aap"
اعمال الگوریتم پروجکشن افین (Affine Projection) بر روی اولین جریان صوتی با استفاده از دومین جریان صوتی.
.PP
این فیلتر تطبیقی برای تخمین صدای ناشناخته بر اساس چندین نمونه صوتی ورودی استفاده می‌شود.
الگوریتم تصویر افین می‌تواند تعادلی میان پیچیدگی محاسباتی و سرعت همگرایی برقرار کند.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه می‌آید.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر.
.IP \fBprojection\fR 4
.IX Item "projection"
تنظیم مرتبه تصویر (projection).
.IP \fBmu\fR 4
.IX Item "mu"
تنظیم ضریب mu فیلتر.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم ضریب برای مقداردهی اولیه ماتریس کوواریانس داخلی.
.IP \fBout_mode\fR 4
.IX Item "out_mode"
تنظیم نمونه‌های خروجی فیلتر. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBi\fR 4
.IX Item "i"
عبور ورودی اول.
.IP \fBd\fR 4
.IX Item "d"
عبور ورودی دوم.
.IP \fBo\fR 4
.IX Item "o"
عبور اختلاف میان ورودی دومِ مطلوب و برآورد سیگنال خطا.
.IP \fBn\fR 4
.IX Item "n"
عبور اختلاف میان ورودی اول و برآورد سیگنال خطا.
.IP \fBe\fR 4
.IX Item "e"
عبور نمونه‌های برآوردشده سیگنال خطا.
.Sp
مقدار پیش‌فرض \fIo\fR است.
.RE
.RS 4
.RE
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم دقت مورد استفاده هنگام پردازش نمونه‌ها.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه‌برداری داخلی بسته به سایر فیلترها.
.IP \fBfloat\fR 4
.IX Item "float"
همواره از قالب نمونه‌برداری با دقت ممیز شناور یگانه (single\-floating point) استفاده شود.
.IP \fBdouble\fR 4
.IX Item "double"
همواره از قالب نمونه‌برداری با دقت ممیز شناور مضاعف (double\-floating point) استفاده شود.
.RE
.RS 4
.RE
.SS acompressor
.IX Subsection "acompressor"
کمپرسور عمدتاً برای کاهش دامنه دینامیکی یک سیگنال استفاده می‌شود.
به ویژه موسیقی‌های مدرن بیشتر با نسبت بالا فشرده می‌شوند تا
بلندی صدای کلی را بهبود بخشند. این کار برای جلب حداکثر توجه
شنونده، "حجیم کردن" صدا و افزودن "قدرت" بیشتر به قطعه انجام می‌شود.
اگر سیگنالی بیش از حد فشرده شود ممکن است پس از آن کدر یا "مرده" به نظر برسد
یا شروع به "پمپ کردن" کند (که می‌تواند جلوه‌ای قدرتمند باشد
اما ممکن است قطعه را نیز کاملاً خراب کند).
فشرده‌سازی درست، کلید رسیدن به صدای حرفه‌ای و هنر والای میکس و مسترینگ است.
به دلیل تنظیمات پیچیده‌اش، ممکن است زمان زیادی طول بکشد تا حس مناسب برای
این نوع جلوه حاصل شود.
.PP
فشرده‌سازی با تشخیص میزان بلندی صدا فراتر از یک سطح انتخابی
\&\f(CW\*(C`threshold\*(C'\fR و تقسیم آن بر ضریب تعیین‌شده توسط \f(CW\*(C`ratio\*(C'\fR انجام می‌شود.
بنابراین اگر آستانه را روی \-12dB تنظیم کنید و سیگنال شما به \-6dB برسد، نسبت
2:1 منجر به سیگنالی در \-9dB خواهد شد. از آن‌جا که دستکاری دقیق
سیگنال باعث اعوجاج شکل موج می‌شود، کاهش صدا می‌تواند در طول زمان تراز شود.
این کار با تنظیم "Attack" و "Release" انجام می‌پذیرد.
گزینه \f(CW\*(C`attack\*(C'\fR تعیین می‌کند که سیگنال چه مدت باید بالاتر از آستانه بماند
پیش از آن‌که هرگونه کاهشی رخ دهد و \f(CW\*(C`release\*(C'\fR زمانی را تنظیم می‌کند که سیگنال
باید به زیر آستانه سقوط کند تا کاهش صدا مجدداً کم شود. سیگنال‌های کوتاه‌تر
از زمان حمله (attack) انتخابی دست‌نخورده باقی خواهند ماند.
کاهش کلی سیگنال را می‌توان پس از آن با تنظیم \f(CW\*(C`makeup\*(C'\fR جبران کرد.
بنابراین فشرده‌سازی قله‌های سیگنال به میزان حدود 6dB و افزایش makeup به این میزان،
منجر به سیگنالی دو برابر بلندتر از منبع می‌شود. برای دستیابی به ورود ملایم‌تر به فشرده‌سازی،
گزینه \f(CW\*(C`knee\*(C'\fR لبه تیز آستانه را در محدوده دسی‌بل‌های انتخابی صاف و منحنی می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهره (gain) ورودی. پیش‌فرض 1 است. محدوده بین 0.015625 و 64 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد کمپرسور. می‌تواند \f(CW\*(C`upward\*(C'\fR (رو به بالا) یا \f(CW\*(C`downward\*(C'\fR (رو به پایین) باشد.
پیش‌فرض \f(CW\*(C`downward\*(C'\fR است.
.IP \fBthreshold\fR 4
.IX Item "threshold"
اگر سیگنال جریان بالاتر از این سطح برود، بر کاهش بهره
تأثیر خواهد گذاشت.
به طور پیش‌فرض 0.125 است. محدوده بین 0.00097563 و 1 است.
.IP \fBratio\fR 4
.IX Item "ratio"
تنظیم نسبتی که سیگنال با آن کاهش می‌یابد. نسبت 1:2 بدان معناست که اگر سطح
سیگنال 4dB بالاتر از آستانه رفت، پس از کاهش تنها 2dB بالاتر از آستانه خواهد بود.
پیش‌فرض 2 است. محدوده بین 1 و 20 است.
.IP \fBattack\fR 4
.IX Item "attack"
مدت زمان به میلی‌ثانیه که سیگنال باید پیش از شروع کاهش بهره بالاتر از آستانه بماند.
پیش‌فرض 20 است. محدوده بین 0.01 و 2000 است.
.IP \fBrelease\fR 4
.IX Item "release"
مدت زمان به میلی‌ثانیه که سیگنال باید پیش از کاهش یافتن مجددِ تضعیف، به زیر آستانه بیفتد.
پیش‌فرض 250 است. محدوده بین 0.01 و 9000 است.
.IP \fBmakeup\fR 4
.IX Item "makeup"
تنظیم مقداری که سیگنال پس از پردازش تقویت خواهد شد.
پیش‌فرض 1 است. محدوده از 1 تا 64 است.
.IP \fBknee\fR 4
.IX Item "knee"
منحنی کردن زانویی تیز اطراف آستانه برای ورود نرم‌تر به کاهش بهره.
پیش‌فرض 2.82843 است. محدوده بین 1 و 8 است.
.IP \fBlink\fR 4
.IX Item "link"
انتخاب این‌که آیا سطح میانگین (\f(CW\*(C`average\*(C'\fR) میان تمام کانال‌های جریان ورودی
یا کانال بلندتر (\f(CW\*(C`maximum\*(C'\fR) جریان ورودی بر کاهش بهره تأثیر بگذارد.
پیش‌فرض \f(CW\*(C`average\*(C'\fR است.
.IP \fBdetection\fR 4
.IX Item "detection"
تعیین این‌که آیا سیگنال دقیق در حالت \f(CW\*(C`peak\*(C'\fR در نظر گرفته شود یا مقدار RMS در حالت
\&\f(CW\*(C`rms\*(C'\fR. پیش‌فرض \f(CW\*(C`rms\*(C'\fR است که معمولاً روان‌تر است.
.IP \fBmix\fR 4
.IX Item "mix"
میزان استفاده از سیگنال فشرده‌شده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS acontrast
.IX Subsection "acontrast"
فیلتر ساده فشرده‌سازی/گسترش دامنه دینامیکی صدا.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcontrast\fR 4
.IX Item "contrast"
تنظیم کنتراست. پیش‌فرض 33 است. محدوده مجاز بین 0 و 100 است.
.SS acopy
.IX Subsection "acopy"
کپی منبع صوتی ورودی بدون تغییر به خروجی. این فیلتر عمدتاً برای اهداف آزمایشی مفید است.
.SS acrossfade
.IX Subsection "acrossfade"
اعمال محوشدگی متقاطع (cross fade) از یک جریان صوتی ورودی به جریان صوتی ورودی دیگر.
محوشدگی متقاطع برای مدت‌زمان مشخصی در نزدیکی انتهای جریان اول اعمال می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBinputs, n\fR" 4
.IX Item "inputs, n"
تعیین تعداد ورودی‌ها برای محوشدگی متقاطع. هنگام اعمال فید متقاطع روی چندین ورودی،
هر ورودی به ترتیب زنجیره‌بندی شده و فید متقاطع می‌شود، مشابه با
\&\fBفیلتر concat\fR. پیش‌فرض 2 است.
.IP "\fBnb_samples, ns\fR" 4
.IX Item "nb_samples, ns"
تعیین تعداد نمونه‌هایی که جلوه محوشدگی متقاطع باید ادامه داشته باشد.
در پایان جلوه محوشدگی متقاطع، اولین صدای ورودی کاملاً
ساکت خواهد بود. پیش‌فرض 44100 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تعیین مدت زمان جلوه محوشدگی متقاطع. برای نحو پذیرفته‌شده، به
\&\fBبخش مدت زمان در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
به طور پیش‌فرض مدت زمان با \fInb_samples\fR تعیین می‌شود.
در صورت تنظیم، این گزینه به جای \fInb_samples\fR استفاده می‌شود.
.IP "\fBoverlap, o\fR" 4
.IX Item "overlap, o"
تعیین این‌که آیا پایان جریان اول باید با آغاز جریان دوم هم‌پوشانی داشته باشد یا خیر. پیش‌فرض فعال است.
.IP \fBcurve1\fR 4
.IX Item "curve1"
تنظیم منحنی برای انتقال محوشدگی متقاطع برای جریان اول.
.IP \fBcurve2\fR 4
.IX Item "curve2"
تنظیم منحنی برای انتقال محوشدگی متقاطع برای جریان دوم.
.Sp
برای شرح انواع منحنی‌های موجود، شرح فیلتر \fBafade\fR را ببینید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
محوشدگی متقاطع از یک ورودی به ورودی دیگر:
.Sp
.Vb 1
\&        ffmpeg \-i first.flac \-i second.flac \-filter_complex acrossfade=d=10:c1=exp:c2=exp output.flac
.Ve
.IP \(bu 4
محوشدگی متقاطع از یک ورودی به دیگری اما بدون هم‌پوشانی:
.Sp
.Vb 1
\&        ffmpeg \-i first.flac \-i second.flac \-filter_complex acrossfade=d=10:o=0:c1=exp:c2=exp output.flac
.Ve
.Sp
زنجیره‌بندی چندین ورودی همراه با محوشدگی متقاطع میان هر یک:
.Sp
.Vb 1
\&        ffmpeg \-i first.flac \-i second.flac \-i third.flac \-filter_complex acrossfade=n=3 output.flac
.Ve
.SS acrossover
.IX Subsection "acrossover"
تقسیم جریان صوتی به چندین باند فرکانسی.
.PP
این فیلتر جریان صدا را به دو یا چند محدوده فرکانسی تقسیم می‌کند.
جمع بستن مجدد تمامی جریان‌ها خروجی مسطح و یکنواختی به دست می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsplit\fR 4
.IX Item "split"
تنظیم فرکانس‌های تقسیم. این فرکانس‌ها باید مقادیری مثبت و صعودی باشند.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر برای هر تقسیم باند. این گزینه افت فرکانسی (roll\-off) یا شیب
تابع تبدیل فیلتر را کنترل می‌کند.
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fB2nd\fR 4
.IX Item "2nd"
12 dB در هر اکتاو.
.IP \fB4th\fR 4
.IX Item "4th"
24 dB در هر اکتاو.
.IP \fB6th\fR 4
.IX Item "6th"
36 dB در هر اکتاو.
.IP \fB8th\fR 4
.IX Item "8th"
48 dB در هر اکتاو.
.IP \fB10th\fR 4
.IX Item "10th"
60 dB در هر اکتاو.
.IP \fB12th\fR 4
.IX Item "12th"
72 dB در هر اکتاو.
.IP \fB14th\fR 4
.IX Item "14th"
84 dB در هر اکتاو.
.IP \fB16th\fR 4
.IX Item "16th"
96 dB در هر اکتاو.
.IP \fB18th\fR 4
.IX Item "18th"
108 dB در هر اکتاو.
.IP \fB20th\fR 4
.IX Item "20th"
120 dB در هر اکتاو.
.RE
.RS 4
.Sp
پیش‌فرض \fI4th\fR است.
.RE
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بهره ورودی. محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 1 است.
.IP \fBgains\fR 4
.IX Item "gains"
تنظیم بهره خروجی برای هر باند. مقدار پیش‌فرض برای تمامی باندها 1 است.
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم دقت مورد استفاده هنگام پردازش نمونه‌ها.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه‌برداری داخلی بسته به سایر فیلترها.
.IP \fBfloat\fR 4
.IX Item "float"
همواره از قالب نمونه‌برداری با دقت اعشار یگانه استفاده شود.
.IP \fBdouble\fR 4
.IX Item "double"
همواره از قالب نمونه‌برداری با دقت اعشار مضاعف استفاده شود.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تقسیم جریان صوتی ورودی به دو باند (پایین و بالا) با فرکانس تقسیم 1500 Hz،
به طوری که هر باند در جریانی جداگانه قرار گیرد:
.Sp
.Vb 1
\&        ffmpeg \-i in.flac \-filter_complex \*(Aqacrossover=split=1500[LOW][HIGH]\*(Aq \-map \*(Aq[LOW]\*(Aq low.wav \-map \*(Aq[HIGH]\*(Aq high.wav
.Ve
.IP \(bu 4
مشابه مورد بالا، اما با مرتبه فیلتر بالاتر:
.Sp
.Vb 1
\&        ffmpeg \-i in.flac \-filter_complex \*(Aqacrossover=split=1500:order=8th[LOW][HIGH]\*(Aq \-map \*(Aq[LOW]\*(Aq low.wav \-map \*(Aq[HIGH]\*(Aq high.wav
.Ve
.IP \(bu 4
مشابه بالا، اما همراه با باند میانی اضافی (فرکانس‌های بین 1500 و 8000):
.Sp
.Vb 1
\&        ffmpeg \-i in.flac \-filter_complex \*(Aqacrossover=split=1500 8000:order=8th[LOW][MID][HIGH]\*(Aq \-map \*(Aq[LOW]\*(Aq low.wav \-map \*(Aq[MID]\*(Aq mid.wav \-map \*(Aq[HIGH]\*(Aq high.wav
.Ve
.SS acrusher
.IX Subsection "acrusher"
کاهش تفکیک‌پذیری بیتی صدا (bit resolution).
.PP
این فیلتر یک بیت‌کراشر (bit crusher) با قابلیت‌های پیشرفته است. بیت‌کراشر
برای کاهش شنیداری تعداد بیت‌هایی که سیگنال صوتی با آن‌ها نمونه‌برداری شده به کار می‌رود.
این فیلتر به هیچ وجه عمق بیت واقعی را تغییر نمی‌دهد، بلکه صرفاً این جلوه صوتی را ایجاد می‌کند.
محتوایی که عمق بیت آن کاهش یافته باشد خشن‌تر و "دیجیتالی‌تر" به نظر می‌رسد.
این فیلتر حتی قادر است به جای عمق‌های بیتی گسسته، به مقادیر پیوسته گرد کند.
علاوه بر این دارای یک آفست D/C است که منجر به خرد شدن متفاوت
نیمه پایینی و نیمه بالایی سیگنال می‌شود.
یک تنظیم ضدپلگی (Anti\-Aliasing) نیز می‌تواند صداهای خردشده "نرم‌تری" تولید کند.
.PP
یکی دیگر از ویژگی‌های این فیلتر حالت لگاریتمی است.
این تنظیم فواصل خطی میان بیت‌ها را به فواصل لگاریتمی تغییر می‌دهد.
نتیجه کار یک کراشر با صدای بسیار "طبیعی‌تر" است که برای مثال سیگنال‌های ضعیف را قطع (gate) نمی‌کند.
گوش انسان ادراک لگاریتمی دارد، بنابراین این نوع خردسازی بسیار گوش‌نوازتر است.
خردسازی لگاریتمی همچنین قابلیت ضدپلگی را دارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم سطح خروجی.
.IP \fBbits\fR 4
.IX Item "bits"
تنظیم میزان کاهش بیت.
.IP \fBmix\fR 4
.IX Item "mix"
تنظیم میزان ترکیب (mix).
.IP \fBmode\fR 4
.IX Item "mode"
می‌تواند خطی: \f(CW\*(C`lin\*(C'\fR یا لگاریتمی: \f(CW\*(C`log\*(C'\fR باشد.
.IP \fBdc\fR 4
.IX Item "dc"
تنظیم مؤلفه مستقیم (DC).
.IP \fBaa\fR 4
.IX Item "aa"
تنظیم ضدپلگی (anti\-aliasing).
.IP \fBsamples\fR 4
.IX Item "samples"
تنظیم کاهش نمونه‌ها.
.IP \fBlfo\fR 4
.IX Item "lfo"
فعال‌سازی نوسان‌ساز بسامد پایین (LFO). به طور پیش‌فرض غیرفعال است.
.IP \fBlforange\fR 4
.IX Item "lforange"
تنظیم محدوده LFO.
.IP \fBlforate\fR 4
.IX Item "lforate"
تنظیم نرخ LFO.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS acue
.IX Subsection "acue"
به تأخیر انداختن فیلترگذاری صدا تا یک برچسب زمانی مشخص از ساعت سیستم. فیلتر \fBcue\fR
را ببینید.
.SS adeclick
.IX Subsection "adeclick"
حذف نوفه‌های ضربه‌ای (impulsive noise / صدای کلیک و ترق‌تروق) از صدای ورودی.
.PP
نمونه‌هایی که به عنوان نوفه ضربه‌ای تشخیص داده شوند، با استفاده از مدل‌سازی خودبازگشتی (autoregressive)
با نمونه‌های درون‌یابی‌شده جایگزین می‌گردند.
.IP "\fBwindow, w\fR" 4
.IX Item "window, w"
تنظیم اندازه پنجره، بر حسب میلی‌ثانیه. محدوده مجاز از \f(CW10\fR تا
\&\f(CW100\fR است. مقدار پیش‌فرض \f(CW55\fR میلی‌ثانیه است.
این گزینه اندازه پنجره‌ای را که در هر نوبت پردازش می‌شود تعیین می‌کند.
.IP "\fBoverlap, o\fR" 4
.IX Item "overlap, o"
تنظیم هم‌پوشانی پنجره‌ها، به درصدِ اندازه پنجره. محدوده مجاز از
\&\f(CW50\fR تا \f(CW95\fR است. مقدار پیش‌فرض \f(CW75\fR درصد است.
تنظیم این مقدار روی عددی بسیار بالا حذف نوفه‌های ضربه‌ای را بهبود می‌بخشد اما
کل فرآیند را بسیار کندتر می‌کند.
.IP "\fBarorder, a\fR" 4
.IX Item "arorder, a"
تنظیم مرتبه خودبازگشت، به درصد اندازه پنجره. محدوده مجاز از
\&\f(CW0\fR تا \f(CW25\fR است. مقدار پیش‌فرض \f(CW2\fR درصد است. این گزینه همچنین
کیفیت نمونه‌های درون‌یابی‌شده را با استفاده از نمونه‌های سالم مجاور کنترل می‌کند.
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم مقدار آستانه. محدوده مجاز از \f(CW1\fR تا \f(CW100\fR است.
مقدار پیش‌فرض \f(CW2\fR است.
این گزینه شدت نوفه‌های ضربه‌ای که باید حذف شوند را کنترل می‌کند.
هر چه مقدار کمتر باشد، نمونه‌های بیشتری به عنوان نوفه ضربه‌ای تشخیص داده می‌شوند.
.IP "\fBburst, b\fR" 4
.IX Item "burst, b"
تنظیم ادغام رگباری (burst fusion)، به درصد اندازه پنجره. محدوده مجاز \f(CW0\fR تا
\&\f(CW10\fR است. مقدار پیش‌فرض \f(CW2\fR است.
اگر فاصله هر دو نمونه تشخیص‌داده‌شده به عنوان نوفه کمتر از این مقدار باشد، هر
نمونه‌ای که میان آن دو قرار گیرد نیز به عنوان نوفه شناسایی خواهد شد.
.IP "\fBmethod, m\fR" 4
.IX Item "method, m"
تنظیم روش هم‌پوشانی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBadd, a\fR" 4
.IX Item "add, a"
انتخاب روش جمع و هم‌پوشانی (overlap\-add). با این روش حتی نمونه‌هایی که درون‌یابی
نشده‌اند نیز اندکی تغییر می‌کنند.
.IP "\fBsave, s\fR" 4
.IX Item "save, s"
انتخاب روش ذخیره و هم‌پوشانی (overlap\-save). نمونه‌های غیردرون‌یابی‌شده بدون تغییر باقی می‌مانند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`a\*(C'\fR است.
.RE
.SS adeclip
.IX Subsection "adeclip"
حذف نمونه‌های برش‌خورده (clipped) از صدای ورودی.
.PP
نمونه‌هایی که به عنوان کلیپ‌شده تشخیص داده شوند، با استفاده از مدل‌سازی
خودبازگشتی با نمونه‌های درون‌یابی‌شده جایگزین می‌گردند.
.IP "\fBwindow, w\fR" 4
.IX Item "window, w"
تنظیم اندازه پنجره، بر حسب میلی‌ثانیه. محدوده مجاز از \f(CW10\fR تا \f(CW100\fR است.
مقدار پیش‌فرض \f(CW55\fR میلی‌ثانیه است.
این گزینه اندازه پنجره‌ای را تعیین می‌کند که در هر نوبت پردازش خواهد شد.
.IP "\fBoverlap, o\fR" 4
.IX Item "overlap, o"
تنظیم هم‌پوشانی پنجره‌ها، به درصد اندازه پنجره. محدوده مجاز از \f(CW50\fR
تا \f(CW95\fR است. مقدار پیش‌فرض \f(CW75\fR درصد است.
.IP "\fBarorder, a\fR" 4
.IX Item "arorder, a"
تنظیم مرتبه خودبازگشت، به درصد اندازه پنجره. محدوده مجاز از
\&\f(CW0\fR تا \f(CW25\fR است. مقدار پیش‌فرض \f(CW8\fR درصد است. این گزینه همچنین کیفیت
نمونه‌های درون‌یابی‌شده را با استفاده از نمونه‌های سالم مجاور کنترل می‌نماید.
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم مقدار آستانه. محدوده مجاز از \f(CW1\fR تا \f(CW100\fR است.
مقدار پیش‌فرض \f(CW10\fR است. مقادیر بالاتر حساسیت تشخیص کلیپینگ را کمتر می‌کنند.
.IP "\fBhsize, n\fR" 4
.IX Item "hsize, n"
تنظیم اندازه هیستوگرام مورد استفاده برای تشخیص کلیپ‌ها. محدوده مجاز از \f(CW100\fR تا \f(CW9999\fR است.
مقدار پیش‌فرض \f(CW1000\fR است. مقادیر بالاتر شدت تشخیص کلیپینگ را کمتر می‌کنند.
.IP "\fBmethod, m\fR" 4
.IX Item "method, m"
تنظیم روش هم‌پوشانی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBadd, a\fR" 4
.IX Item "add, a"
انتخاب روش overlap\-add. حتی نمونه‌های درون‌یابی‌نشده نیز با این روش اندکی
تغییر می‌کنند.
.IP "\fBsave, s\fR" 4
.IX Item "save, s"
انتخاب روش overlap\-save. نمونه‌های درون‌یابی‌نشده دست‌نخورده باقی می‌مانند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`a\*(C'\fR است.
.RE
.SS adecorrelate
.IX Subsection "adecorrelate"
اعمال ناهمبستگی (decorrelation) بر روی جریان صوتی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstages\fR 4
.IX Item "stages"
تنظیم مراحل ناهمبسته‌سازی در فیلترگذاری. محدوده
مجاز از 1 تا 16 است. مقدار پیش‌فرض 6 است.
.IP \fBseed\fR 4
.IX Item "seed"
تنظیم سید (بذر) تصادفی مورد استفاده برای تعیین تأخیر بر حسب نمونه در کانال‌ها.
.SS adelay
.IX Subsection "adelay"
به تأخیر انداختن یک یا چند کانال صوتی.
.PP
نمونه‌ها در کانال تأخیریافته با سکوت پر می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdelays\fR 4
.IX Item "delays"
تنظیم فهرست تأخیرها بر حسب میلی‌ثانیه برای هر کانال که با \*(Aq|\*(Aq از هم جدا شده‌اند.
تأخیرهای استفاده‌نشده بدون هشدار نادیده گرفته می‌شوند. اگر تعداد تأخیرهای داده‌شده
کمتر از تعداد کانال‌ها باشد، تمام کانال‌های باقی‌مانده بدون تأخیر خواهند بود.
اگر می‌خواهید تعداد دقیق نمونه‌ها را به تأخیر بیندازید، پسوند \*(AqS\*(Aq را به عدد اضافه کنید.
اگر به جای آن می‌خواهید بر حسب ثانیه تأخیر ایجاد کنید، پسوند \*(Aqs\*(Aq را به عدد بیفزایید.
.IP \fBall\fR 4
.IX Item "all"
استفاده از آخرین تأخیر تنظیم‌شده برای تمام کانال‌های باقی‌مانده. به طور پیش‌فرض غیرفعال است.
این گزینه در صورت فعال بودن، نحوه تفسیر گزینه \f(CW\*(C`delays\*(C'\fR را تغییر می‌دهد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تأخیر کانال اول به مدت 1.5 ثانیه، کانال سوم به مدت 0.5 ثانیه و دست‌نخورده گذاشتن
کانال دوم (و هر کانال دیگری که ممکن است وجود داشته باشد):
.Sp
.Vb 1
\&        adelay=1500|0|500
.Ve
.IP \(bu 4
تأخیر کانال دوم به میزان 500 نمونه، کانال سوم به میزان 700 نمونه و دست‌نخورده گذاشتن
کانال اول (و هر کانال دیگری که ممکن است وجود داشته باشد):
.Sp
.Vb 1
\&        adelay=0|500S|700S
.Ve
.IP \(bu 4
تأخیر تمامی کانال‌ها به یک اندازه بر حسب نمونه:
.Sp
.Vb 1
\&        adelay=delays=64S:all=1
.Ve
.SS adenorm
.IX Subsection "adenorm"
اصلاح اعداد زیرنرمال (denormals) در صدا از طریق افزودن نوفه‌ای با سطح بسیار بسیار پایین.
.PP
این فیلتر باید پیش از هر فیلتری قرار گیرد که ممکن است اعداد زیرنرمال تولید کند.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه می‌آید.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح نوفه افزوده‌شده بر حسب دسی‌بل. پیش‌فرض \f(CW\-351\fR است.
محدوده مجاز بین \-451 و \-90 است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع نوفه اضافه‌شده.
.RS 4
.IP \fBdc\fR 4
.IX Item "dc"
افزودن سیگنال DC.
.IP \fBac\fR 4
.IX Item "ac"
افزودن سیگنال AC.
.IP \fBsquare\fR 4
.IX Item "square"
افزودن سیگنال مربعی.
.IP \fBpulse\fR 4
.IX Item "pulse"
افزودن سیگنال پالسی.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`dc\*(C'\fR است.
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS "aderivative, aintegral"
.IX Subsection "aderivative, aintegral"
محاسبه مشتق/انتگرال جریان صوتی.
.PP
اعمال هر دو فیلتر یکی پس از دیگری، صدای اصلی را بازتولید می‌کند.
.SS adrc
.IX Subsection "adrc"
اعمال فیلتر کنترل‌کننده دامنه دینامیکی طیفی بر روی جریان صوتی ورودی.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه می‌آید.
.IP \fBtransfer\fR 4
.IX Item "transfer"
تنظیم عبارت انتقال (transfer expression).
.Sp
این عبارت می‌تواند شامل ثابت‌های زیر باشد:
.RS 4
.IP \fBch\fR 4
.IX Item "ch"
شماره کانال جاری
.IP \fBsn\fR 4
.IX Item "sn"
شماره نمونه جاری
.IP \fBnb_channels\fR 4
.IX Item "nb_channels"
تعداد کانال‌ها
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بر حسب ثانیه
.IP \fBsr\fR 4
.IX Item "sr"
نرخ نمونه‌برداری
.IP \fBp\fR 4
.IX Item "p"
مقدار توان فرکانسی جاری، بر حسب dB
.IP \fBf\fR 4
.IX Item "f"
فرکانس جاری بر حسب Hz
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`p\*(C'\fR است.
.RE
.IP \fBattack\fR 4
.IX Item "attack"
تنظیم زمان حمله (attack) بر حسب میلی‌ثانیه. پیش‌فرض \f(CW50\fR میلی‌ثانیه است.
محدوده مجاز بین 1 تا 1000 میلی‌ثانیه است.
.IP \fBrelease\fR 4
.IX Item "release"
تنظیم زمان رهاسازی (release) بر حسب میلی‌ثانیه. پیش‌فرض \f(CW100\fR میلی‌ثانیه است.
محدوده مجاز بین 5 تا 2000 میلی‌ثانیه است.
.IP \fBchannels\fR 4
.IX Item "channels"
تعیین این‌که کدام کانال‌ها فیلتر شوند؛ به طور پیش‌فرض تمام کانال‌های (\f(CW\*(C`all\*(C'\fR) موجود در جریان صوتی فیلتر می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال فشرده‌سازی طیفی بر تمام فرکانس‌ها با آستانه \-50 dB و نسبت 1:6:
.Sp
.Vb 1
\&        adrc=transfer=\*(Aqif(gt(p,\-50),\-50+(p\-(\-50))/6,p)\*(Aq:attack=50:release=100
.Ve
.IP \(bu 4
مشابه بالا اما با نسبت 1:2 و فیلتر کردن تنها کانال مرکزی جلو (front center):
.Sp
.Vb 1
\&        adrc=transfer=\*(Aqif(gt(p,\-50),\-50+(p\-(\-50))/2,p)\*(Aq:attack=50:release=100:channels=FC
.Ve
.IP \(bu 4
اعمال گیت نویز طیفی بر تمامی فرکانس‌ها با آستانه \-85 dB و با زمان حمله کوتاه و رهاسازی کوتاه:
.Sp
.Vb 1
\&        adrc=transfer=\*(Aqif(lte(p,\-85),p\-800,p)\*(Aq:attack=1:release=5
.Ve
.IP \(bu 4
اعمال گسترش (expansion) طیفی بر تمام فرکانس‌ها با آستانه \-10 dB و نسبت 1:2:
.Sp
.Vb 1
\&        adrc=transfer=\*(Aqif(lt(p,\-10),\-10+(p\-(\-10))*2,p)\*(Aq:attack=50:release=100
.Ve
.IP \(bu 4
اعمال محدودکننده (limiter) به حداکثر \-60 dB برای تمامی فرکانس‌ها، با حمله 2 میلی‌ثانیه و رهاسازی 10 میلی‌ثانیه:
.Sp
.Vb 1
\&        adrc=transfer=\*(Aqmin(p,\-60)\*(Aq:attack=2:release=10
.Ve
.SS adynamicequalizer
.IX Subsection "adynamicequalizer"
اعمال اکولایزر پویا بر روی جریان صوتی ورودی.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه می‌آید.
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه تشخیص مورد استفاده برای تحریک اکولایزر.
تشخیص آستانه از فیلتر تشخیص استفاده می‌کند.
مقدار پیش‌فرض 0 است. محدوده مجاز از 0 تا 100 است.
.IP \fBdfrequency\fR 4
.IX Item "dfrequency"
تنظیم فرکانس تشخیص بر حسب هرتز مورد استفاده برای فیلتر تشخیص جهت آغاز اکولایزر.
مقدار پیش‌فرض 1000 Hz است. محدوده مجاز بین 2 و 1000000 Hz است.
.IP \fBdqfactor\fR 4
.IX Item "dqfactor"
تنظیم ضریب تشدید (رزونانس) تشخیص برای فیلتر تشخیص جهت آغاز اکولایزر.
مقدار پیش‌فرض 1 است. محدوده مجاز از 0.001 تا 1000 است.
.IP \fBtfrequency\fR 4
.IX Item "tfrequency"
تنظیم فرکانس هدف فیلتر اکولایزاسیون.
مقدار پیش‌فرض 1000 Hz است. محدوده مجاز بین 2 و 1000000 Hz است.
.IP \fBtqfactor\fR 4
.IX Item "tqfactor"
تنظیم ضریب رزونانس هدف برای فیلتر اکولایزر هدف.
مقدار پیش‌فرض 1 است. محدوده مجاز از 0.001 تا 1000 است.
.IP \fBattack\fR 4
.IX Item "attack"
تنظیم مقدار زمان بر حسب میلی‌ثانیه که سیگنال حاصل از تشخیص باید فراتر از
آستانه تشخیص برود پیش از آن‌که اکولایزاسیون آغاز شود.
پیش‌فرض 20 است. محدوده مجاز بین 1 و 2000 است.
.IP \fBrelease\fR 4
.IX Item "release"
تنظیم مقدار زمان بر حسب میلی‌ثانیه که سیگنال حاصل از تشخیص باید به زیر
آستانه تشخیص بیفتد پیش از آن‌که اکولایزاسیون پایان یابد.
پیش‌فرض 200 است. محدوده مجاز بین 1 و 2000 است.
.IP \fBratio\fR 4
.IX Item "ratio"
تنظیم نسبتی که بهره اکولایزاسیون با آن افزایش می‌یابد.
پیش‌فرض 1 است. محدوده مجاز بین 0 و 30 است.
.IP \fBmakeup\fR 4
.IX Item "makeup"
تنظیم آفست جبرانی (makeup) که بهره اکولایزاسیون با آن افزایش می‌یابد.
پیش‌فرض 0 است. محدوده مجاز بین 0 و 100 است.
.IP \fBrange\fR 4
.IX Item "range"
تنظیم حداکثر میزان مجاز تضعیف/تقویت (cut/boost). پیش‌فرض 50 است.
محدوده مجاز از 1 تا 200 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد فیلتر؛ می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBlisten\fR 4
.IX Item "listen"
خروجی دادن تنها سیگنال تشخیصِ تفکیک‌شده.
.IP \fBcutbelow\fR 4
.IX Item "cutbelow"
کاهش فرکانس‌های زیر آستانه تشخیص.
.IP \fBcutabove\fR 4
.IX Item "cutabove"
کاهش فرکانس‌های بالای آستانه تشخیص.
.IP \fBboostbelow\fR 4
.IX Item "boostbelow"
تقویت فرکانس‌های زیر آستانه تشخیص.
.IP \fBboostabove\fR 4
.IX Item "boostabove"
تقویت فرکانس‌های بالای آستانه تشخیص.
.RE
.RS 4
.Sp
حالت پیش‌فرض \fBcutbelow\fR است.
.RE
.IP \fBdftype\fR 4
.IX Item "dftype"
تنظیم نوع فیلتر تشخیص؛ می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBbandpass\fR 4
.IX Item "bandpass"
.PD 0
.IP \fBlowpass\fR 4
.IX Item "lowpass"
.IP \fBhighpass\fR 4
.IX Item "highpass"
.IP \fBpeak\fR 4
.IX Item "peak"
.PD
.RE
.RS 4
.Sp
نوع پیش‌فرض \fBbandpass\fR است.
.RE
.IP \fBtftype\fR 4
.IX Item "tftype"
تنظیم نوع فیلتر هدف؛ می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBbell\fR 4
.IX Item "bell"
.PD 0
.IP \fBlowshelf\fR 4
.IX Item "lowshelf"
.IP \fBhighshelf\fR 4
.IX Item "highshelf"
.PD
.RE
.RS 4
.Sp
نوع پیش‌فرض \fBbell\fR است.
.RE
.IP \fBauto\fR 4
.IX Item "auto"
جمع‌آوری خودکار آستانه از فیلتر تشخیص. به طور پیش‌فرض
\&\fBغیرفعال (disabled)\fR است.
این گزینه برای تشخیص آستانه در بازه زمانی خاصی از جریان صوتی ورودی مفید است،
که در این حالت مقدار گزینه در زمان اجرا تغییر داده می‌شود.
.Sp
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBdisabled\fR 4
.IX Item "disabled"
غیرفعال‌سازی استفاده از مقدار آستانه جمع‌آوری‌شده خودکار.
.IP \fBoff\fR 4
.IX Item "off"
توقف انتخاب مقدار آستانه.
.IP \fBon\fR 4
.IX Item "on"
آغاز انتخاب مقدار آستانه.
.IP \fBadaptive\fR 4
.IX Item "adaptive"
انتخاب تطبیقی مقدار آستانه، با محاسبه آنتروپی پنجره لغزان.
.RE
.RS 4
.RE
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم دقت مورد استفاده هنگام پردازش نمونه‌ها.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه‌برداری داخلی بسته به سایر فیلترها.
.IP \fBfloat\fR 4
.IX Item "float"
همواره از قالب نمونه‌برداری با دقت اعشار یگانه استفاده شود.
.IP \fBdouble\fR 4
.IX Item "double"
همواره از قالب نمونه‌برداری با دقت اعشار مضاعف استفاده شود.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS adynamicsmooth
.IX Subsection "adynamicsmooth"
اعمال هموارسازی پویا بر جریان صوتی ورودی.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه می‌آید.
.IP \fBsensitivity\fR 4
.IX Item "sensitivity"
تنظیم میزان حساسیت به نوسانات فرکانسی. پیش‌فرض 2 است.
محدوده مجاز از 0 تا 1e+06 است.
.IP \fBbasefreq\fR 4
.IX Item "basefreq"
تنظیم فرکانس پایه برای هموارسازی. مقدار پیش‌فرض 22050 است.
محدوده مجاز از 2 تا 1e+06 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS aecho
.IX Subsection "aecho"
اعمال پژواک (اکو) بر صدای ورودی.
.PP
پژواک‌ها صداهای بازتابیده‌شده هستند و می‌توانند هنگام صحبت یا فریاد زدن در میان کوه‌ها
(و گاهی ساختمان‌های بزرگ) به صورت طبیعی رخ دهند؛ جلوه‌های اکوی دیجیتال
این رفتار را شبیه‌سازی می‌کنند و اغلب برای کمک به پر کردن صدای
یک ساز یا خواننده به کار می‌روند. اختلاف زمانی میان سیگنال اصلی و
بازتاب، تأخیر (\f(CW\*(C`delay\*(C'\fR) نام دارد و بلندی سیگنال بازتابیده
میزان میرایی/فروپاشی (\f(CW\*(C`decay\*(C'\fR) است.
پژواک‌های متعدد می‌توانند تأخیرها و فروپاشی‌های متفاوتی داشته باشند.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه می‌آید.
.IP \fBin_gain\fR 4
.IX Item "in_gain"
تنظیم بهره ورودی سیگنال بازتاب‌یافته. پیش‌فرض \f(CW0.6\fR است.
.IP \fBout_gain\fR 4
.IX Item "out_gain"
تنظیم بهره خروجی سیگنال بازتاب‌یافته. پیش‌فرض \f(CW0.3\fR است.
.IP \fBdelays\fR 4
.IX Item "delays"
تنظیم فهرست بازه‌های زمانی بر حسب میلی‌ثانیه میان سیگنال اصلی و بازتاب‌ها
که با \*(Aq|\*(Aq از هم جدا شده‌اند. محدوده مجاز برای هر \f(CW\*(C`delay\*(C'\fR برابر با \f(CW\*(C`(0 \- 90000.0]\*(C'\fR است.
پیش‌فرض \f(CW1000\fR است.
.IP \fBdecays\fR 4
.IX Item "decays"
تنظیم فهرست بلندی سیگنال‌های بازتاب‌یافته که با \*(Aq|\*(Aq از هم جدا شده‌اند.
محدوده مجاز برای هر \f(CW\*(C`decay\*(C'\fR برابر با \f(CW\*(C`(0 \- 1.0]\*(C'\fR است.
پیش‌فرض \f(CW0.5\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
به گونه‌ای صدا دهد که گویی دو برابر تعداد سازهای در حال نواختن، ساز نواخته می‌شود:
.Sp
.Vb 1
\&        aecho=0.8:0.88:60:0.4
.Ve
.IP \(bu 4
اگر تأخیر بسیار کوتاه باشد، صدایی شبیه به نواختن موسیقی توسط یک ربات (فلزی) ایجاد می‌شود:
.Sp
.Vb 1
\&        aecho=0.8:0.88:6:0.4
.Ve
.IP \(bu 4
یک تأخیر طولانی‌تر شبیه به کنسرت در هوای آزاد در میان کوه‌ها صدا خواهد داد:
.Sp
.Vb 1
\&        aecho=0.8:0.9:1000:0.3
.Ve
.IP \(bu 4
مشابه مورد بالا اما با یک کوه دیگر:
.Sp
.Vb 1
\&        aecho=0.8:0.9:1000|1800:0.3|0.25
.Ve
.SS aemphasis
.IX Subsection "aemphasis"
فیلتر تأکید صدا (audio emphasis) محتوای برگرفته مستقیم از صفحه‌های گرامافون (LP) یا
CDهای دارای تأکید را با منحنی‌های فیلتر مختلف تولید یا بازسازی می‌کند. برای مثال جهت ضبط موسیقی روی وینیل،
سیگنال ابتدا باید توسط یک فیلتر تغییر داده شود تا نقاط ضعف این رسانه ضبط تعدیل گردد.
هنگامی که محتوا بازپخش می‌شود، باید فیلتر معکوس اعمال گردد تا
اعوجاج پاسخ فرکانسی بازسازی شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهره ورودی.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم بهره خروجی.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت فیلتر. برای بازسازی محتوا از حالت \f(CW\*(C`reproduction\*(C'\fR (بازتولید) استفاده کنید، در غیر این صورت
از حالت \f(CW\*(C`production\*(C'\fR (تولید) استفاده نمایید. پیش‌فرض حالت \f(CW\*(C`reproduction\*(C'\fR است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع فیلتر. رسانه را انتخاب می‌کند. می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBcol\fR 4
.IX Item "col"
انتخاب Columbia.
.IP \fBemi\fR 4
.IX Item "emi"
انتخاب EMI.
.IP \fBbsi\fR 4
.IX Item "bsi"
انتخاب BSI (78RPM).
.IP \fBriaa\fR 4
.IX Item "riaa"
انتخاب RIAA.
.IP \fBcd\fR 4
.IX Item "cd"
انتخاب دیسک فشرده (CD).
.IP \fB50fm\fR 4
.IX Item "50fm"
انتخاب 50µs (FM).
.IP \fB75fm\fR 4
.IX Item "75fm"
انتخاب 75µs (FM).
.IP \fB50kf\fR 4
.IX Item "50kf"
انتخاب 50µs (FM\-KF).
.IP \fB75kf\fR 4
.IX Item "75kf"
انتخاب 75µs (FM\-KF).
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS aeval
.IX Subsection "aeval"
تغییر یک سیگنال صوتی بر اساس عبارت‌های تعیین‌شده.
.PP
این فیلتر یک یا چند عبارت (یکی برای هر کانال) را می‌پذیرد،
که ارزیابی شده و برای اصلاح سیگنال صوتی متناظر استفاده می‌شوند.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBexprs\fR 4
.IX Item "exprs"
تنظیم فهرست عبارت‌ها برای هر کانال جداگانه که با \*(Aq|\*(Aq از هم جدا شده‌اند. اگر
تعداد کانال‌های ورودی بیشتر از تعداد عبارت‌ها باشد، آخرین عبارتِ
مشخص‌شده برای کانال‌های خروجی باقی‌مانده استفاده می‌شود.
.IP "\fBchannel_layout, c\fR" 4
.IX Item "channel_layout, c"
تنظیم چینش کانال خروجی. در صورت عدم تعیین، چینش کانال با
تعداد عبارت‌ها تعیین می‌شود. اگر روی \fBsame\fR تنظیم شود، به طور
پیش‌فرض از همان چینش کانال ورودی استفاده خواهد کرد.
.PP
هر عبارت در \fIexprs\fR می‌تواند شامل ثابت‌ها و توابع زیر باشد:
.IP \fBch\fR 4
.IX Item "ch"
شماره کانال عبارت جاری
.IP \fBn\fR 4
.IX Item "n"
شماره نمونه ارزیابی‌شده، با شروع از 0
.IP \fBs\fR 4
.IX Item "s"
نرخ نمونه‌برداری
.IP \fBt\fR 4
.IX Item "t"
زمان نمونه ارزیابی‌شده بر حسب ثانیه
.IP \fBnb_in_channels\fR 4
.IX Item "nb_in_channels"
.PD 0
.IP \fBnb_out_channels\fR 4
.IX Item "nb_out_channels"
.PD
تعداد کانال‌های ورودی و خروجی
.IP \fBval(CH)\fR 4
.IX Item "val(CH)"
مقدار کانال ورودی با شماره \fICH\fR
.PP
توجه: این فیلتر کند است. برای پردازش سریع‌تر باید از یک فیلتر اختصاصی استفاده کنید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
نصف کردن حجم صدا:
.Sp
.Vb 1
\&        aeval=val(ch)/2:c=same
.Ve
.IP \(bu 4
معکوس کردن فاز کانال دوم:
.Sp
.Vb 1
\&        aeval=val(0)|\-val(1)
.Ve
.SS aexciter
.IX Subsection "aexciter"
یک اکسایتر (Exciter) برای تولید صداهای فرکانس بالا که در سیگنال اصلی
وجود ندارند استفاده می‌شود. این کار با ایجاد اعوجاج‌های هارمونیک در سیگنال
انجام می‌شود که در دامنه‌ای محدود شده و به سیگنال اصلی اضافه می‌گردند.
یک اکسایتر لبه بالایی سیگنال صوتی را ارتقا می‌دهد بدون آن‌که مانند یک اکولایزر
صرفاً فرکانس‌های بالاتر را تقویت کند، تا صدایی "شفاف‌تر" یا "درخشان‌تر" ایجاد نماید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی پیش از پردازش سیگنال.
محدوده مجاز از 0 تا 64 است.
مقدار پیش‌فرض 1 است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم سطح خروجی پس از پردازش سیگنال.
محدوده مجاز از 0 تا 64 است.
مقدار پیش‌فرض 1 است.
.IP \fBamount\fR 4
.IX Item "amount"
تنظیم میزان هارمونیک‌های اضافه‌شده به سیگنال اصلی.
محدوده مجاز از 0 تا 64 است.
مقدار پیش‌فرض 1 است.
.IP \fBdrive\fR 4
.IX Item "drive"
تنظیم میزان هارمونیک‌های جدید تولیدشده.
محدوده مجاز از 0.1 تا 10 است.
مقدار پیش‌فرض 8.5 است.
.IP \fBblend\fR 4
.IX Item "blend"
تنظیم اکتاو هارمونیک‌های جدید ایجادشده.
محدوده مجاز از \-10 تا 10 است.
مقدار پیش‌فرض 0 است.
.IP \fBfreq\fR 4
.IX Item "freq"
تنظیم حد پایین فرکانس تولید هارمونیک‌ها بر حسب هرتز.
محدوده مجاز از 2000 تا 12000 هرتز است.
پیش‌فرض 7500 هرتز است.
.IP \fBceil\fR 4
.IX Item "ceil"
تنظیم حد بالای فرکانس تولید هارمونیک‌ها.
محدوده مجاز از 9999 تا 20000 هرتز است.
اگر مقدار کمتر از 10000 هرتز باشد، هیچ حدی اعمال نمی‌شود.
.IP \fBlisten\fR 4
.IX Item "listen"
بی‌صدا کردن سیگنال اصلی و خروجی دادن تنها هارمونیک‌های افزوده‌شده.
به طور پیش‌فرض غیرفعال است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS afade
.IX Subsection "afade"
اعمال جلوه محو شدن تدریجی ورودی/خروجی (fade\-in/out) بر روی صدای ورودی.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه می‌آید.
.IP "\fBtype, t\fR" 4
.IX Item "type, t"
تعیین نوع جلوه؛ می‌تواند \f(CW\*(C`in\*(C'\fR برای fade\-in، یا
\&\f(CW\*(C`out\*(C'\fR برای جلوه fade\-out باشد. پیش‌فرض \f(CW\*(C`in\*(C'\fR است.
.IP "\fBstart_sample, ss\fR" 4
.IX Item "start_sample, ss"
تعیین شماره نمونه آغازین برای شروع اعمال جلوه محوشدگی.
پیش‌فرض 0 است.
.IP "\fBnb_samples, ns\fR" 4
.IX Item "nb_samples, ns"
تعیین تعداد نمونه‌هایی که جلوه محوشدگی باید ادامه یابد. در
پایان جلوه fade\-in، صدای خروجی همان حجم صدای ورودی را خواهد داشت،
و در پایان انتقال fade\-out، صدای خروجی سکوت خواهد بود. پیش‌فرض 44100 است.
.IP "\fBstart_time, st\fR" 4
.IX Item "start_time, st"
تعیین زمان شروع جلوه محوشدگی. پیش‌فرض 0 است.
مقدار باید به عنوان یک مدت زمان مشخص شود؛ برای نحو پذیرفته‌شده، به
\&\fBبخش مدت زمان در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
در صورت تنظیم، این گزینه به جای \fIstart_sample\fR استفاده می‌شود.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تعیین مدت زمان جلوه محوشدگی. برای نحو پذیرفته‌شده، به
\&\fBبخش مدت زمان در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
در پایان جلوه fade\-in صدای خروجی همان حجم صدای ورودی را خواهد داشت،
و در پایان انتقال fade\-out صدای خروجی سکوت خواهد بود.
به طور پیش‌فرض مدت زمان با \fInb_samples\fR تعیین می‌شود.
در صورت تنظیم، این گزینه به جای \fInb_samples\fR استفاده می‌شود.
.IP \fBcurve\fR 4
.IX Item "curve"
تنظیم منحنی برای انتقال محوشدگی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtri\fR 4
.IX Item "tri"
انتخاب شیب مثلثی و خطی (پیش‌فرض)
.IP \fBqsin\fR 4
.IX Item "qsin"
انتخاب یک‌چهارم موج سینوسی
.IP \fBhsin\fR 4
.IX Item "hsin"
انتخاب نیمه موج سینوسی
.IP \fBesin\fR 4
.IX Item "esin"
انتخاب موج سینوسی نمایی
.IP \fBlog\fR 4
.IX Item "log"
انتخاب لگاریتمی
.IP \fBipar\fR 4
.IX Item "ipar"
انتخاب سهمی معکوس
.IP \fBqua\fR 4
.IX Item "qua"
انتخاب درجه دو (quadratic)
.IP \fBcub\fR 4
.IX Item "cub"
انتخاب درجه سه (مکعبی / cubic)
.IP \fBsqu\fR 4
.IX Item "squ"
انتخاب ریشه دوم (جذر)
.IP \fBcbr\fR 4
.IX Item "cbr"
انتخاب ریشه سوم (فرجه سه)
.IP \fBpar\fR 4
.IX Item "par"
انتخاب سهمی
.IP \fBexp\fR 4
.IX Item "exp"
انتخاب نمایی
.IP \fBiqsin\fR 4
.IX Item "iqsin"
انتخاب یک‌چهارم معکوس موج سینوسی
.IP \fBihsin\fR 4
.IX Item "ihsin"
انتخاب نیمه معکوس موج سینوسی
.IP \fBdese\fR 4
.IX Item "dese"
انتخاب زینِ نمایی مضاعف (double\-exponential seat)
.IP \fBdesi\fR 4
.IX Item "desi"
انتخاب سیگموئید نمایی مضاعف
.IP \fBlosi\fR 4
.IX Item "losi"
انتخاب سیگموئید لجستیک
.IP \fBsinc\fR 4
.IX Item "sinc"
انتخاب تابع سینک (sine cardinal)
.IP \fBisinc\fR 4
.IX Item "isinc"
انتخاب تابع سینک معکوس
.IP \fBquat\fR 4
.IX Item "quat"
انتخاب درجه چهار (quartic)
.IP \fBquatr\fR 4
.IX Item "quatr"
انتخاب ریشه چهارم
.IP \fBqsin2\fR 4
.IX Item "qsin2"
انتخاب مربعِ یک‌چهارم موج سینوسی
.IP \fBhsin2\fR 4
.IX Item "hsin2"
انتخاب مربعِ نیمه موج سینوسی
.IP \fBnofade\fR 4
.IX Item "nofade"
بدون اعمال محوشدگی
.RE
.RS 4
.RE
.IP \fBsilence\fR 4
.IX Item "silence"
تنظیم بهره اولیه برای fade\-in یا بهره نهایی برای fade\-out.
مقدار پیش‌فرض \f(CW0.0\fR است.
.IP \fBunity\fR 4
.IX Item "unity"
تنظیم بهره اولیه برای fade\-out یا بهره نهایی برای fade\-in.
مقدار پیش‌فرض \f(CW1.0\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
محو شدن تدریجی ورودی (Fade in) در ۱۵ ثانیه اول صدا:
.Sp
.Vb 1
\&        afade=t=in:ss=0:d=15
.Ve
.IP \(bu 4
محو شدن تدریجی خروجی (Fade out) در ۲۵ ثانیه پایانی یک صدای ۹۰۰ ثانیه‌ای:
.Sp
.Vb 1
\&        afade=t=out:st=875:d=25
.Ve
.SS afftdn
.IX Subsection "afftdn"
کاهش نوفه نمونه‌های صوتی با استفاده از FFT.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه می‌آید.
.IP "\fBnoise_reduction, nr\fR" 4
.IX Item "noise_reduction, nr"
تنظیم میزان کاهش نوفه بر حسب دسی‌بل، محدوده مجاز 0.01 تا 97 است.
مقدار پیش‌فرض 12 dB است.
.IP "\fBnoise_floor, nf\fR" 4
.IX Item "noise_floor, nf"
تنظیم کف نوفه (noise floor) بر حسب دسی‌بل، محدوده مجاز \-80 تا \-20 است.
مقدار پیش‌فرض \-50 dB است.
.IP "\fBnoise_type, nt\fR" 4
.IX Item "noise_type, nt"
تنظیم نوع نوفه.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBwhite, w\fR" 4
.IX Item "white, w"
انتخاب نوفه سفید.
.IP "\fBvinyl, v\fR" 4
.IX Item "vinyl, v"
انتخاب نوفه صفحه گرامافون (وینیل).
.IP "\fBshellac, s\fR" 4
.IX Item "shellac, s"
انتخاب نوفه صفحه شلاک (صفحه سنگی).
.IP "\fBcustom, c\fR" 4
.IX Item "custom, c"
انتخاب نوفه سفارشی، تعریف‌شده در گزینه \f(CW\*(C`bn\*(C'\fR.
.Sp
مقدار پیش‌فرض نوفه سفید است.
.RE
.RS 4
.RE
.IP "\fBband_noise, bn\fR" 4
.IX Item "band_noise, bn"
تنظیم نمایه نوفه باند سفارشی برای هر یک از ۱۵ باند.
باندها با \*(Aq \*(Aq یا \*(Aq|\*(Aq از هم جدا می‌شوند.
.IP "\fBresidual_floor, rf\fR" 4
.IX Item "residual_floor, rf"
تنظیم کف باقیمانده (residual floor) بر حسب دسی‌بل، محدوده مجاز \-80 تا \-20 است.
مقدار پیش‌فرض \-38 dB است.
.IP "\fBtrack_noise, tn\fR" 4
.IX Item "track_noise, tn"
فعال‌سازی ردیابی کف نوفه. به طور پیش‌فرض غیرفعال است.
با فعال بودن این گزینه، کف نوفه به طور خودکار تنظیم می‌شود.
.IP "\fBtrack_residual, tr\fR" 4
.IX Item "track_residual, tr"
فعال‌سازی ردیابی باقیمانده. به طور پیش‌فرض غیرفعال است.
.IP "\fBoutput_mode, om\fR" 4
.IX Item "output_mode, om"
تنظیم حالت خروجی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBinput, i\fR" 4
.IX Item "input, i"
عبور ورودی بدون تغییر.
.IP "\fBoutput, o\fR" 4
.IX Item "output, o"
عبور صدای فیلترشده از نوفه.
.IP "\fBnoise, n\fR" 4
.IX Item "noise, n"
عبور تنها نوفه.
.Sp
مقدار پیش‌فرض \fIoutput\fR است.
.RE
.RS 4
.RE
.IP "\fBadaptivity, ad\fR" 4
.IX Item "adaptivity, ad"
تنظیم ضریب تطبیق‌پذیری، تعیین می‌کند که تنظیمات بهره برای هر
بین فرکانسی (frequency bin) با چه سرعتی تطبیق یابد. مقدار \fI0\fR تطبیق فوری را فعال می‌کند، در حالی که مقادیر بالاتر
بسیار کندتر واکنش نشان می‌دهند.
محدوده مجاز از \fI0\fR تا \fI1\fR است. مقدار پیش‌فرض \fI0.5\fR است.
.IP "\fBfloor_offset, fo\fR" 4
.IX Item "floor_offset, fo"
تنظیم ضریب آفست کف نوفه. این گزینه برای تعدیل آفست اعمال‌شده بر کف نوفه اندازه‌گیری‌شده
استفاده می‌شود. این گزینه تنها زمانی مؤثر است که ردیابی کف نوفه فعال باشد.
محدوده مجاز از \fI\-2.0\fR تا \fI2.0\fR است. مقدار پیش‌فرض \fI1.0\fR است.
.IP "\fBnoise_link, nl\fR" 4
.IX Item "noise_link, nl"
تنظیم پیوند نوفه مورد استفاده برای صدای چندکاناله.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
استفاده از کف نوفه بدون تغییر کانال.
.IP \fBmin\fR 4
.IX Item "min"
استفاده از حداقل کف نوفه اندازه‌گیری‌شده تمامی کانال‌ها.
.IP \fBmax\fR 4
.IX Item "max"
استفاده از حداکثر کف نوفه اندازه‌گیری‌شده تمامی کانال‌ها.
.IP \fBaverage\fR 4
.IX Item "average"
استفاده از میانگین کف نوفه اندازه‌گیری‌شده تمامی کانال‌ها.
.Sp
مقدار پیش‌فرض \fImin\fR است.
.RE
.RS 4
.RE
.IP "\fBband_multiplier, bm\fR" 4
.IX Item "band_multiplier, bm"
تنظیم ضریب چندبرابرکننده باند، تعیین می‌کند که باندها چقدر در بین‌های فرکانسی پخش شوند.
محدوده مجاز از \fI0.2\fR تا \fI5\fR است. مقدار پیش‌فرض \fI1.25\fR است.
.IP "\fBsample_noise, sn\fR" 4
.IX Item "sample_noise, sn"
تغییر وضعیت دریافت و اندازه‌گیری نمایه نوفه از صدای ورودی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBstart, begin\fR" 4
.IX Item "start, begin"
آغاز دریافت نمونه نوفه.
.IP "\fBstop, end\fR" 4
.IX Item "stop, end"
توقف دریافت نمونه نوفه و اندازه‌گیری نمایه باند نوفه جدید.
.Sp
مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.RE
.RS 4
.RE
.IP "\fBgain_smooth, gs\fR" 4
.IX Item "gain_smooth, gs"
تنظیم شعاع مکانی هموارسازی بهره، مورد استفاده برای هموار کردن بهره‌های اعمال‌شده بر هر بین فرکانسی.
برای کاهش مصنوعات تصادفی نویز موسیقی مفید است.
مقادیر بالاتر هموارسازی بهره‌ها را افزایش می‌دهد.
محدوده مجاز از \f(CW0\fR تا \f(CW50\fR است.
مقدار پیش‌فرض \f(CW0\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از برخی گزینه‌های فوق‌الذکر به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
کاهش نوفه سفید به میزان 10dB، و استفاده از کف نوفه اندازه‌گیری‌شده قبلی \-40dB:
.Sp
.Vb 1
\&        afftdn=nr=10:nf=\-40
.Ve
.IP \(bu 4
کاهش نوفه سفید به میزان 10dB، همچنین تنظیم کف نوفه اولیه روی \-80dB و فعال‌سازی
ردیابی خودکار کف نوفه به طوری که کف نوفه در طول پردازش به تدریج تغییر کند:
.Sp
.Vb 1
\&        afftdn=nr=10:nf=\-80:tn=1
.Ve
.IP \(bu 4
کاهش نوفه به میزان 20dB، با استفاده از کف نوفه \-40dB و استفاده از دستورات برای ثبت نمایه نوفه
در 0.4 ثانیه اول صدای ورودی:
.Sp
.Vb 1
\&        asendcmd=0.0 afftdn sn start,asendcmd=0.4 afftdn sn stop,afftdn=nr=20:nf=\-40
.Ve
.SS afftfilt
.IX Subsection "afftfilt"
اعمال عبارات دلخواه بر روی نمونه‌ها در حوزه فرکانس.
.IP \fBreal\fR 4
.IX Item "real"
تنظیم عبارت بخش حقیقی (real) در حوزه فرکانس برای هر کانال مجزا با تفکیک
توسط \*(Aq|\*(Aq. پیش‌فرض "re" است.
اگر تعداد کانال‌های ورودی بیشتر از تعداد عبارات باشد، آخرین عبارت
تعیین‌شده برای کانال‌های خروجی باقیمانده به کار می‌رود.
.IP \fBimag\fR 4
.IX Item "imag"
تنظیم عبارت بخش موهومی (imaginary) در حوزه فرکانس برای هر کانال مجزا با تفکیک
توسط \*(Aq|\*(Aq. پیش‌فرض "im" است.
.Sp
هر عبارت در \fIreal\fR و \fIimag\fR می‌تواند شامل ثوابت و توابع
زیر باشد:
.RS 4
.IP \fBsr\fR 4
.IX Item "sr"
نرخ نمونه‌برداری
.IP \fBb\fR 4
.IX Item "b"
شماره بین (bin) فرکانسی جاری
.IP \fBnb\fR 4
.IX Item "nb"
تعداد بین‌های موجود
.IP \fBch\fR 4
.IX Item "ch"
شماره کانال عبارت جاری
.IP \fBchs\fR 4
.IX Item "chs"
تعداد کانال‌ها
.IP \fBpts\fR 4
.IX Item "pts"
مقدار pts فریم جاری
.IP \fBre\fR 4
.IX Item "re"
بخش حقیقی جاری از بین فرکانسی کانال جاری
.IP \fBim\fR 4
.IX Item "im"
بخش موهومی جاری از بین فرکانسی کانال جاری
.IP "\fBreal(b, ch)\fR" 4
.IX Item "real(b, ch)"
بازگرداندن مقدار بخش حقیقی بین فرکانسی در موقعیت (\fIbin\fR,\fIchannel\fR)
.IP "\fBimag(b, ch)\fR" 4
.IX Item "imag(b, ch)"
بازگرداندن مقدار بخش موهومی بین فرکانسی در موقعیت (\fIbin\fR,\fIchannel\fR)
.RE
.RS 4
.RE
.IP \fBwin_size\fR 4
.IX Item "win_size"
تنظیم اندازه پنجره. محدوده مجاز از 16 تا 131072 است.
پیش‌فرض \f(CW4096\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP "\fBhann, hanning\fR" 4
.IX Item "hann, hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم همپوشانی پنجره. در صورت تنظیم روی 1، همپوشانی توصیه‌شده برای تابع
پنجره انتخاب‌شده برگزیده می‌شود. پیش‌فرض \f(CW0.75\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
باقی گذاشتن تقریباً فقط فرکانس‌های پایین در صدا:
.Sp
.Vb 1
\&        afftfilt="\*(Aqreal=re * (1\-clip((b/nb)*b,0,1))\*(Aq:imag=\*(Aqim * (1\-clip((b/nb)*b,0,1))\*(Aq"
.Ve
.IP \(bu 4
اعمال جلوه روباتیک کردن:
.Sp
.Vb 1
\&        afftfilt="real=\*(Aqhypot(re,im)*sin(0)\*(Aq:imag=\*(Aqhypot(re,im)*cos(0)\*(Aq:win_size=512:overlap=0.75"
.Ve
.IP \(bu 4
اعمال جلوه نجوا (زمزمه):
.Sp
.Vb 1
\&        afftfilt="real=\*(Aqhypot(re,im)*cos((random(0)*2\-1)*2*3.14)\*(Aq:imag=\*(Aqhypot(re,im)*sin((random(1)*2\-1)*2*3.14)\*(Aq:win_size=128:overlap=0.8"
.Ve
.IP \(bu 4
اعمال شیفت فاز:
.Sp
.Vb 1
\&        afftfilt="real=re*cos(1)\-im*sin(1):imag=re*sin(1)+im*cos(1)"
.Ve
.SS afir
.IX Subsection "afir"
اعمال یک فیلتر دلخواه با پاسخ ضربه متناهی (FIR).
.PP
این فیلتر برای اعمال فیلترهای طولانی FIR طراحی شده است،
تا طول حداکثر ۶۰ ثانیه.
.PP
می‌توان از آن به عنوان جزئی برای فیلترهای کراس‌اوور دیجیتال،
اکولایزاسیون محیط (اتاق)، حذف تداخل صوتی (cross talk)، سنتز میدان صوتی (wavefield synthesis)،
شنیداری‌سازی (auralization)، آمبیوفونیک، آمبیسونیک و فضاسازی (spatialization) استفاده کرد.
.PP
این فیلتر از جریان‌های بعد از جریان اول به عنوان ضرایب FIR استفاده می‌کند.
اگر جریان غیراول شامل یک تک کانال باشد، برای تمام کانال‌های
ورودی در جریان اول استفاده خواهد شد، در غیر این صورت
تعداد کانال‌ها در جریان غیراول باید برابر با
تعداد کانال‌های جریان اول باشد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBdry\fR 4
.IX Item "dry"
تنظیم بهره سیگنال دست‌نخورده (dry). این گزینه بهره ورودی را تنظیم می‌کند.
.IP \fBwet\fR 4
.IX Item "wet"
تنظیم بهره سیگنال فیلترشده (wet). این گزینه بهره خروجی نهایی را تنظیم می‌کند.
.IP \fBlength\fR 4
.IX Item "length"
تنظیم طول فیلتر پاسخ ضربه (IR). پیش‌فرض 1 است، به این معنی که کل IR پردازش می‌شود.
.IP \fBgtype\fR 4
.IX Item "gtype"
این گزینه منسوخ شده است و هیچ کاری انجام نمی‌دهد.
.IP \fBirnorm\fR 4
.IX Item "irnorm"
تنظیم نرم اعمالی بر ضرایب IR قبل از فیلترسازی.
محدوده مجاز از \fI\-1\fR تا \fI2\fR است.
ضرایب IR با نرم بردار محاسبه‌شده که توسط این گزینه تعیین گردیده نرمال‌سازی می‌شوند.
برای مقادیر منفی، هیچ نرمی محاسبه نشده و ضرایب IR اصلاً دستکاری نمی‌شوند.
پیش‌فرض \fI1\fR است.
.IP \fBirlink\fR 4
.IX Item "irlink"
برای IR چندکاناله، اگر این گزینه روی \fItrue\fR تنظیم شود، تمام کانال‌های IR
با حداکثر بهره اندازه‌گیری‌شده ضرایب تمامی کانال‌های IR همان‌طور که با گزینه \f(CW\*(C`irnorm\*(C'\fR تنظیم شده نرمال‌سازی خواهند شد.
در صورت غیرفعال بودن، تمام ضرایب IR در هر کانال IR به طور مستقل نرمال‌سازی می‌شوند.
پیش‌فرض \fItrue\fR است.
.IP \fBirgain\fR 4
.IX Item "irgain"
تنظیم بهره اعمالی بر ضرایب IR قبل از فیلترسازی.
محدوده مجاز 0 تا 1 است. این بهره پس از هرگونه بهره اعمال‌شده توسط گزینه \fIirnorm\fR اعمال می‌شود.
.IP \fBirfmt\fR 4
.IX Item "irfmt"
تنظیم فرمت جریان IR. می‌تواند \f(CW\*(C`mono\*(C'\fR یا \f(CW\*(C`input\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`input\*(C'\fR است.
.IP \fBmaxir\fR 4
.IX Item "maxir"
تنظیم حداکثر مدت مجاز فیلتر پاسخ ضربه بر حسب ثانیه. پیش‌فرض 30 ثانیه است.
محدوده مجاز 0.1 تا 60 ثانیه است.
.IP \fBresponse\fR 4
.IX Item "response"
این گزینه منسوخ شده است و کاری انجام نمی‌دهد.
.IP \fBchannel\fR 4
.IX Item "channel"
این گزینه منسوخ شده است و کاری انجام نمی‌دهد.
.IP \fBsize\fR 4
.IX Item "size"
این گزینه منسوخ شده است و کاری انجام نمی‌دهد.
.IP \fBrate\fR 4
.IX Item "rate"
این گزینه منسوخ شده است و کاری انجام نمی‌دهد.
.IP \fBminp\fR 4
.IX Item "minp"
تنظیم حداقل اندازه پارتیشن برای کانولوشن. پیش‌فرض \fI8192\fR است.
محدوده مجاز از \fI1\fR تا \fI65536\fR است.
مقادیر کمتر میزان تاخیر را به بهای مصرف بالاتر CPU کاهش می‌دهند.
.IP \fBmaxp\fR 4
.IX Item "maxp"
تنظیم حداکثر اندازه پارتیشن برای کانولوشن. پیش‌فرض \fI8192\fR است.
محدوده مجاز از \fI8\fR تا \fI65536\fR است.
مقادیر کمتر ممکن است مصرف CPU را افزایش دهند.
.IP \fBnbirs\fR 4
.IX Item "nbirs"
تنظیم تعداد جریان‌های پاسخ ضربه ورودی که در زمان اجرا قابل تعویض هستند.
محدوده مجاز از \fI1\fR تا \fI32\fR است. پیش‌فرض \fI1\fR است.
.IP \fBir\fR 4
.IX Item "ir"
تنظیم جریان IR مورد استفاده برای کانولوشن، با شروع از \fI0\fR، که همیشه باید کمتر
از مقدار تعیین‌شده توسط گزینه \f(CW\*(C`nbirs\*(C'\fR باشد. پیش‌فرض \fI0\fR است.
این گزینه می‌تواند در حین اجرا از طریق \fBcommands\fR تغییر یابد.
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم میزان دقتی که هنگام پردازش نمونه‌ها استفاده می‌شود.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه داخلی بسته به فیلترهای دیگر.
.IP \fBfloat\fR 4
.IX Item "float"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور تکی (single-floating point).
.IP \fBdouble\fR 4
.IX Item "double"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور دوگانه (double-floating point).
.RE
.RS 4
.Sp
مقدار پیش‌فرض auto است.
.RE
.IP \fBirload\fR 4
.IX Item "irload"
تنظیم زمان بارگذاری جریان IR. می‌تواند \f(CW\*(C`init\*(C'\fR یا \f(CW\*(C`access\*(C'\fR باشد.
گزینه نخست تمام IRها را هنگام مقداردهی اولیه بارگذاری و آماده می‌کند، گزینه دوم
یک‌بار در اولین دسترسی به IR مشخص این کار را انجام می‌دهد.
پیش‌فرض \f(CW\*(C`init\*(C'\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال ریورب به جریان با استفاده از فایل تک‌کاناله IR به عنوان ورودی دوم، دستور کامل با استفاده از ffmpeg:
.Sp
.Vb 1
\&        ffmpeg \-i input.wav \-i middle_tunnel_1way_mono.wav \-lavfi afir output.wav
.Ve
.IP \(bu 4
اعمال پردازش استریوی واقعی با جریان ورودی استریو، و دو پاسخ ضربه استریو برای کانال‌های چپ و راست؛
فایل‌های پاسخ ضربه فایل‌هایی با نام l_ir.wav و r_ir.wav هستند و مقدار گزینه irnorm تنظیم شده است:
.Sp
.Vb 1
\&        "pan=4C|c0=FL|c1=FL|c2=FR|c3=FR[a];amovie=l_ir.wav[LIR];amovie=r_ir.wav[RIR];[LIR][RIR]amerge[ir];[a][ir]afir=irfmt=input:irnorm=1.2,pan=stereo|FL<c0+c2|FR<c1+c3"
.Ve
.IP \(bu 4
مشابه مثال بالا، اما با تنظیم صریح \f(CW\*(C`irgain\*(C'\fR بر روی مقدار تخمینی و با غیرفعال بودن \f(CW\*(C`irnorm\*(C'\fR:
.Sp
.Vb 1
\&        "pan=4C|c0=FL|c1=FL|c2=FR|c3=FR[a];amovie=l_ir.wav[LIR];amovie=r_ir.wav[RIR];[LIR][RIR]amerge[ir];[a][ir]afir=irfmt=input:irgain=\-5dB:irnom=\-1,pan=stereo|FL<c0+c2|FR<c1+c3"
.Ve
.SS aformat
.IX Subsection "aformat"
تنظیم محدودیت‌های فرمت خروجی برای صدای ورودی. چارچوب مربوطه مناسب‌ترین
فرمت را به منظور به حداقل رساندن تبدیل‌ها تطبیق خواهد داد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBsample_fmts, f\fR" 4
.IX Item "sample_fmts, f"
فهرستی جداشده با \*(Aq|\*(Aq از فرمت‌های نمونه درخواستی.
.IP "\fBsample_rates, r\fR" 4
.IX Item "sample_rates, r"
فهرستی جداشده با \*(Aq|\*(Aq از نرخ‌های نمونه‌برداری درخواستی.
.IP "\fBchannel_layouts, cl\fR" 4
.IX Item "channel_layouts, cl"
فهرستی جداشده با \*(Aq|\*(Aq از چیدمان‌های کانال درخواستی.
.Sp
برای نحو مورد نیاز به \fBبخش Channel Layout در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.PP
در صورت حذف یک پارامتر، تمام مقادیر مجاز خواهند بود.
.PP
اجبار خروجی به استریوی 8 بیتی بدون علامت یا 16 بیتی علامت‌دار:
.PP
.Vb 1
\&        aformat=sample_fmts=u8|s16:channel_layouts=stereo
.Ve
.SS afreqshift
.IX Subsection "afreqshift"
اعمال انتقال فرکانس (frequency shift) بر روی نمونه‌های صوتی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBshift\fR 4
.IX Item "shift"
تعیین میزان انتقال فرکانس. محدوده مجاز از \-INT_MAX تا INT_MAX است.
مقدار پیش‌فرض 0.0 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم بهره خروجی اعمالی بر خروجی نهایی. محدوده مجاز از 0.0 تا 1.0 است.
مقدار پیش‌فرض 1.0 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر مورد استفاده برای فیلترسازی. محدوده مجاز از 1 تا 16 است.
مقدار پیش‌فرض 8 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS afwtdn
.IX Subsection "afwtdn"
کاهش نویز باند‌پهن از نمونه‌های ورودی با استفاده از تبدیل ویولت (Wavelets).
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم سیگمای نویز، محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0 است.
این گزینه شدت نویززدایی اعمالی بر نمونه‌های ورودی را کنترل می‌کند.
مفیدترین راه برای تنظیم این گزینه از طریق دسی‌بل است، مثلاً \-45dB.
.IP \fBlevels\fR 4
.IX Item "levels"
تنظیم تعداد سطوح تجزیه ویولت.
محدوده مجاز از 1 تا 12 است.
مقدار پیش‌فرض 10 است.
تنظیم این گزینه روی مقدار بسیار کم باعث عملکرد بسیار ضعیف در نویززدایی می‌شود.
.IP \fBwavet\fR 4
.IX Item "wavet"
تنظیم نوع ویولت برای تجزیه فریم ورودی.
آنها بر اساس تعداد ضرایب، از کمترین به بیشترین مرتب شده‌اند.
ضرایب بیشتر به معنای سرعت کمتر در فیلترسازی، اما در کل کیفیت بهتر است.
ویولت‌های موجود عبارتند از:
.RS 4
.IP \fBsym2\fR 4
.IX Item "sym2"
.PD 0
.IP \fBsym4\fR 4
.IX Item "sym4"
.IP \fBrbior68\fR 4
.IX Item "rbior68"
.IP \fBdeb10\fR 4
.IX Item "deb10"
.IP \fBsym10\fR 4
.IX Item "sym10"
.IP \fBcoif5\fR 4
.IX Item "coif5"
.IP \fBbl3\fR 4
.IX Item "bl3"
.PD
.RE
.RS 4
.RE
.IP \fBpercent\fR 4
.IX Item "percent"
تنظیم درصد نویززدایی کامل. محدوده مجاز از 0 تا 100 درصد است.
مقدار پیش‌فرض 85 درصد یا نویززدایی جزئی است.
.IP \fBprofile\fR 4
.IX Item "profile"
در صورت فعال بودن، نخستین فریم ورودی به عنوان نمایه (پروفایل) نویز استفاده خواهد شد.
اگر نمونه‌های فریم اول حاوی سیگنال غیر‌نویز باشند کارایی بسیار ضعیف خواهد بود.
.IP \fBadaptive\fR 4
.IX Item "adaptive"
در صورت فعال بودن، فریم‌های ورودی برای بررسی حضور نویز تحلیل می‌شوند.
اگر نویز با احتمال بالا شناسایی شود، نمایه فریم ورودی برای
پردازش فریم‌های بعدی استفاده خواهد شد، تا زمانی که فریم نویز جدیدی شناسایی شود.
.IP \fBsamples\fR 4
.IX Item "samples"
تنظیم اندازه فریم منفرد بر حسب تعداد نمونه‌ها. محدوده مجاز از 512 تا
65536 است. اندازه فریم پیش‌فرض 8192 نمونه است.
.IP \fBsoftness\fR 4
.IX Item "softness"
تنظیم نرمی اعمال‌شده درون تابع آستانه‌گذاری. محدوده مجاز از 0 تا
10 است. نرمی پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS agate
.IX Subsection "agate"
گیت (gate) عمدتاً برای کاهش بخش‌های ضعیف‌تر یک سیگنال استفاده می‌شود. این نوع
پردازش سیگنال، نویزهای مزاحم میان سیگنال‌های مفید را کاهش می‌دهد.
.PP
گیتینگ از طریق تشخیص سطح بلندی زیر یک \fIthreshold\fR (آستانه) انتخابی
و تقسیم آن بر ضریب تعیین‌شده با \fIratio\fR انجام می‌شود. کف نویز
از طریق \fIrange\fR تعیین می‌شود. از آنجا که دستکاری دقیق سیگنال
باعث اعوجاج شکل موج می‌گردد، می‌توان کاهش را در طول زمان
تسطیح کرد. این کار با تنظیم \fIattack\fR و \fIrelease\fR صورت می‌گیرد.
.PP
پارامتر \fIattack\fR مشخص می‌کند سیگنال چه مدت باید زیر آستانه بماند
پیش از آنکه کاهشی رخ دهد، و \fIrelease\fR زمانی را تعیین می‌کند که سیگنال
باید بالای آستانه باشد تا میزان کاهش دوباره تقلیل یابد.
سیگنال‌های کوتاه‌تر از زمان حمله انتخاب‌شده دست‌نخورده باقی خواهند ماند.
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی پیش از فیلترسازی.
پیش‌فرض 1 است. محدوده مجاز از 0.015625 تا 64 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد. می‌تواند \f(CW\*(C`upward\*(C'\fR یا \f(CW\*(C`downward\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`downward\*(C'\fR است. اگر روی حالت \f(CW\*(C`upward\*(C'\fR تنظیم شود، بخش‌های بالاتر سیگنال
تقویت شده و محدوده دینامیکی در جهت بالا گسترش می‌یابد.
در غیر این صورت، در حالت \f(CW\*(C`downward\*(C'\fR بخش‌های ضعیف‌تر سیگنال کاهش می‌یابند.
.IP \fBrange\fR 4
.IX Item "range"
تنظیم سطح کاهش بهره هنگامی که سیگنال زیر آستانه است.
پیش‌فرض 0.06125 است. محدوده مجاز از 0 تا 1 است.
تنظیم این گزینه روی 0 کاهش را غیرفعال می‌کند و فیلتر مانند یک اکسپندر رفتار خواهد کرد.
.IP \fBthreshold\fR 4
.IX Item "threshold"
اگر سیگنال به بالای این سطح برسد، کاهش بهره متوقف (رها) می‌شود.
پیش‌فرض 0.125 است. محدوده مجاز از 0 تا 1 است.
.IP \fBratio\fR 4
.IX Item "ratio"
تنظیم نسبتی که سیگنال با آن کاهش می‌یابد.
پیش‌فرض 2 است. محدوده مجاز از 1 تا 9000 است.
.IP \fBattack\fR 4
.IX Item "attack"
مدت زمان بر حسب میلی‌ثانیه که سیگنال باید بالای آستانه برود پیش از آنکه کاهش بهره
متوقف شود.
پیش‌فرض 20 میلی‌ثانیه است. محدوده مجاز از 0.01 تا 9000 است.
.IP \fBrelease\fR 4
.IX Item "release"
مدت زمان بر حسب میلی‌ثانیه که سیگنال باید زیر آستانه بیفتد پیش از آنکه کاهش
دوباره افزایش یابد. پیش‌فرض 250 میلی‌ثانیه است.
محدوده مجاز از 0.01 تا 9000 است.
.IP \fBmakeup\fR 4
.IX Item "makeup"
تنظیم میزان تقویت سیگنال پس از پردازش.
پیش‌فرض 1 است. محدوده مجاز از 1 تا 64 است.
.IP \fBknee\fR 4
.IX Item "knee"
منحنی کردن زانوی تیز در اطراف آستانه به منظور ورود نرم‌تر به کاهش بهره.
پیش‌فرض 2.828427125 است. محدوده مجاز از 1 تا 8 است.
.IP \fBdetection\fR 4
.IX Item "detection"
انتخاب اینکه آیا سیگنال دقیق برای تشخیص لحاظ شود یا سیگنالی شبیه RMS.
پیش‌فرض \f(CW\*(C`rms\*(C'\fR است. می‌تواند \f(CW\*(C`peak\*(C'\fR یا \f(CW\*(C`rms\*(C'\fR باشد.
.IP \fBlink\fR 4
.IX Item "link"
انتخاب اینکه آیا میانگین سطح میان تمام کانال‌ها بر کاهش اثر بگذارد یا کانال بلندتر.
پیش‌فرض \f(CW\*(C`average\*(C'\fR است. می‌تواند \f(CW\*(C`average\*(C'\fR یا \f(CW\*(C`maximum\*(C'\fR باشد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS aiir
.IX Subsection "aiir"
اعمال یک فیلتر دلخواه با پاسخ ضربه نامتناهی (IIR).
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBzeros, z\fR" 4
.IX Item "zeros, z"
تنظیم ضرایب B/صورت/صفرها/انعکاس (reflection).
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم ضرایب A/مخرج/قطب‌ها/نردبانی (ladder).
.IP "\fBgains, k\fR" 4
.IX Item "gains, k"
تنظیم بهره‌های کانال‌ها.
.IP \fBdry_gain\fR 4
.IX Item "dry_gain"
تنظیم بهره ورودی (سیگنال دست‌نخورده).
.IP \fBwet_gain\fR 4
.IX Item "wet_gain"
تنظیم بهره خروجی (سیگنال فیلترشده).
.IP "\fBformat, f\fR" 4
.IX Item "format, f"
تنظیم فرمت ضرایب.
.RS 4
.IP \fBll\fR 4
.IX Item "ll"
تابع مشبک-نردبانی (lattice-ladder function)
.IP \fBsf\fR 4
.IX Item "sf"
تابع انتقال آنالوگ
.IP \fBtf\fR 4
.IX Item "tf"
تابع انتقال دیجیتال
.IP \fBzp\fR 4
.IX Item "zp"
صفرها/قطب‌های صفحه Z، دکارتی (پیش‌فرض)
.IP \fBpr\fR 4
.IX Item "pr"
صفرها/قطب‌های صفحه Z، رادیان قطبی
.IP \fBpd\fR 4
.IX Item "pd"
صفرها/قطب‌های صفحه Z، درجه قطبی
.IP \fBsp\fR 4
.IX Item "sp"
صفرها/قطب‌های صفحه S
.RE
.RS 4
.RE
.IP "\fBprocess, r\fR" 4
.IX Item "process, r"
تنظیم نوع پردازش.
.RS 4
.IP \fBd\fR 4
.IX Item "d"
پردازش مستقیم (direct)
.IP \fBs\fR 4
.IX Item "s"
پردازش سری (serial)
.IP \fBp\fR 4
.IX Item "p"
پردازش موازی (parallel)
.RE
.RS 4
.RE
.IP "\fBprecision, e\fR" 4
.IX Item "precision, e"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBdbl\fR 4
.IX Item "dbl"
ممیز شناور با دقت مضاعف (پیش‌فرض)
.IP \fBflt\fR 4
.IX Item "flt"
ممیز شناور با دقت تکی
.IP \fBi32\fR 4
.IX Item "i32"
اعداد صحیح ۳۲ بیتی
.IP \fBi16\fR 4
.IX Item "i16"
اعداد صحیح ۱۶ بیتی
.RE
.RS 4
.RE
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب فیلتر؛ به طور پیش‌فرض فعال است.
فعال کردن آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP \fBmix\fR 4
.IX Item "mix"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP \fBresponse\fR 4
.IX Item "response"
نمایش پاسخ فرکانسی IR، شامل دامنه (سرخابی)، فاز (سبز) و تاخیر گروهی (زرد) در جریان ویدیویی اضافی.
به طور پیش‌فرض غیرفعال است.
.IP \fBchannel\fR 4
.IX Item "channel"
تنظیم اینکه پاسخ فرکانسی برای کدام کانال IR نمایش داده شود. به طور پیش‌فرض کانال نخست
نمایش داده می‌شود. این گزینه تنها زمانی استفاده می‌شود که \fIresponse\fR فعال باشد.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه جریان ویدیو. این گزینه تنها زمانی استفاده می‌شود که \fIresponse\fR فعال باشد.
.PP
ضرایب در فرمت‌های \f(CW\*(C`tf\*(C'\fR و \f(CW\*(C`sf\*(C'\fR با فاصله از هم جدا می‌شوند و به ترتیب صعودی
هستند.
.PP
ضرایب در فرمت \f(CW\*(C`zp\*(C'\fR با فاصله از هم جدا می‌شوند و ترتیب ضرایب
اهمیتی ندارد. ضرایب در فرمت \f(CW\*(C`zp\*(C'\fR اعداد مختلط با واحد موهومی
\fIi\fR هستند.
.PP
ضرایب و بهره‌های متفاوت می‌توانند برای هر کانال ارائه شوند، در این حالت
از \*(Aq|\*(Aq برای تفکیک ضرایب یا بهره‌ها استفاده کنید. آخرین ضرایب ارائه‌شده
برای تمام کانال‌های باقیمانده به کار خواهند رفت.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال فیلتر شکافی (notch) بیضوی ۲ قطبی در حدود ۵۰۰۰ هرتز برای نرخ نمونه‌برداری ۴۸۰۰۰ هرتز:
.Sp
.Vb 1
\&        aiir=k=1:z=7.957584807809675810E\-1 \-2.575128568908332300 3.674839853930788710 \-2.57512875289799137 7.957586296317130880E\-1:p=1 \-2.86950072432325953 3.63022088054647218 \-2.28075678147272232 6.361362326477423500E\-1:f=tf:r=d
.Ve
.IP \(bu 4
مشابه مثال بالا اما در فرمت \f(CW\*(C`zp\*(C'\fR:
.Sp
.Vb 1
\&        aiir=k=0.79575848078096756:z=0.80918701+0.58773007i 0.80918701\-0.58773007i 0.80884700+0.58784055i 0.80884700\-0.58784055i:p=0.63892345+0.59951235i 0.63892345\-0.59951235i 0.79582691+0.44198673i 0.79582691\-0.44198673i:f=zp:r=s
.Ve
.IP \(bu 4
اعمال فیلتر پایین‌گذر باترورث نرمال‌شده آنالوگ مرتبه ۳، با استفاده از فرمت تابع انتقال آنالوگ:
.Sp
.Vb 1
\&        aiir=z=1.3057 0 0 0:p=1.3057 2.3892 2.1860 1:f=sf:r=d
.Ve
.SS alimiter
.IX Subsection "alimiter"
لیمیتور از بالا رفتن سیگنال ورودی از یک آستانه مطلوب جلوگیری می‌کند.
این لیمیتور از فناوری نگاه‌به‌جلو (lookahead) بهره می‌برد تا از اعوجاج سیگنال شما جلوگیری نماید.
بدین معنی که پس از پردازش سیگنال، تأخیر کوچکی وجود دارد. به یاد داشته
باشید که تأخیری که ایجاد می‌کند، همان زمان حمله (attack) تعیین‌شده است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهره ورودی. پیش‌فرض 1 است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم بهره خروجی. پیش‌فرض 1 است.
.IP \fBlimit\fR 4
.IX Item "limit"
اجازه ندادن به سیگنال‌های بالاتر از این سطح جهت عبور از لیمیتور. پیش‌فرض 1 است.
.IP \fBattack\fR 4
.IX Item "attack"
لیمیتور در این مقدار زمان بر حسب میلی‌ثانیه به سطح تضعیف خود
خواهد رسید. پیش‌فرض 5 میلی‌ثانیه است.
.IP \fBrelease\fR 4
.IX Item "release"
بازگشت از حالت محدودسازی به ضریب تضعیف 1.0 در این مقدار زمان بر حسب میلی‌ثانیه.
پیش‌فرض 50 میلی‌ثانیه است.
.IP \fBasc\fR 4
.IX Item "asc"
هنگامی که کاهش بهره همواره مورد نیاز باشد، کنترل خودکار رهاسازی (ASC) وظیفه رهاسازی به یک
سطح کاهش میانگین را به جای رسیدن به کاهش 0 در زمان رهاسازی بر عهده
می‌گیرد.
.IP \fBasc_level\fR 4
.IX Item "asc_level"
انتخاب میزان اثرگذاری ASC بر زمان رهاسازی؛ مقدار 0 به معنای تقریباً بدون تغییر
در زمان رهاسازی است در حالی که 1 زمان‌های رهاسازی بالاتری تولید می‌کند.
.IP \fBlevel\fR 4
.IX Item "level"
تراز خودکار سطح سیگنال خروجی. به طور پیش‌فرض فعال است.
در صورت فعال بودن، این گزینه صدا را به 0dB نرمال‌سازی می‌کند.
.IP \fBlatency\fR 4
.IX Item "latency"
جبران تأخیر ایجادشده بر اثر بافر نگاه‌به‌جلو که توسط پارامتر attack تنظیم شده است.
همچنین تخلیه داده‌های معتبر صوتی در بافر نگاه‌به‌جلو هنگامی که جریان به انتهای فایل (EOF) می‌رسد.
.PP
بسته به تنظیمات برگزیده، پیشنهاد می‌شود پیش از اعمال این فیلتر،
نرخ نمونه‌برداری ورودی را با \fBaresample\fR به میزان 2x یا 4x افزایش دهید.
.SS allpass
.IX Subsection "allpass"
اعمال یک فیلتر همه‌گذر دو قطبی با فرکانس مرکزی (بر حسب هرتز)
\fIfrequency\fR، و پهنای فیلتر \fIwidth\fR.
یک فیلتر همه‌گذر رابطه فرکانس به فاز صدا را بدون تغییر رابطه فرکانس
به دامنه آن دگرگون می‌سازد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس بر حسب هرتز.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند یک فیلتر در واحدهای width_type.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌ها جهت فیلترسازی؛ به طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به طور پیش‌فرض غیرفعال است.
فعال کردن آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBorder, o\fR" 4
.IX Item "order, o"
تنظیم مرتبه فیلتر، می‌تواند 1 یا 2 باشد. پیش‌فرض 2 است.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه بسته به فیلترهای جانبی.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از فرمت 16 بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از فرمت 32 بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از فرمت ممیز شناور 32 بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از فرمت ممیز شناور 64 بیتی.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس همه‌گذر.
نحو دستور عبارت است از: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type همه‌گذر.
نحو دستور عبارت است از: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای همه‌گذر.
نحو دستور عبارت است از: "\fIwidth\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر mix همه‌گذر.
نحو دستور عبارت است از: "\fImix\fR"
.SS aloop
.IX Subsection "aloop"
حلقه کردن نمونه‌های صوتی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBloop\fR 4
.IX Item "loop"
تنظیم تعداد دورهای حلقه. تنظیم این مقدار روی \-1 منجر به حلقه‌های نامحدود می‌شود.
پیش‌فرض 0 است.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم حداکثر تعداد نمونه‌ها. پیش‌فرض 0 است.
.IP \fBstart\fR 4
.IX Item "start"
تنظیم نخستین نمونه حلقه. پیش‌فرض 0 است.
.IP \fBtime\fR 4
.IX Item "time"
تنظیم زمان شروع حلقه بر حسب ثانیه.
تنها زمانی استفاده می‌شود که گزینه موسوم به \fIstart\fR روی \f(CW\-1\fR تنظیم شده باشد.
.SS amerge
.IX Subsection "amerge"
ادغام دو یا چند جریان صوتی در یک جریان چندکاناله واحد.
.PP
تمام ورودی‌ها باید نرخ نمونه‌برداری و فرمت یکسانی داشته باشند.
.PP
اگر مدت‌زمان ورودی‌ها یکسان نباشد، خروجی همگام با کوتاه‌ترین
جریان متوقف خواهد شد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد ورودی‌ها. پیش‌فرض 2 است.
.IP \fBlayout_mode\fR 4
.IX Item "layout_mode"
این گزینه نحوه تعیین چیدمان کانال‌های خروجی و بازآرایی احتمالی
کانال‌های صوتی حین ادغام را کنترل می‌کند.
.RS 4
.IP \fBlegacy\fR 4
.IX Item "legacy"
این همان حالتی است که فیلتر در گذشته رفتار می‌کرد، از این رو پیش‌فرض است.
.Sp
اگر چیدمان کانال‌های ورودی مشخص و مجزا (disjoint) باشند و بنابراین
سازگار تلقی گردند، چیدمان کانال‌های خروجی متناسب با آن تنظیم شده و
کانال‌ها در صورت لزوم مجدداً مرتب می‌شوند. اگر چیدمان کانال‌های ورودی
مجزا نباشند، برخی از آنها ناشناخته باشند، یا از چیدمان‌های ویژه
کانال، مانند ambisonics استفاده کنند، خروجی ابتدا تمامی کانال‌های ورودی
نخست و سپس تمامی کانال‌های ورودی دوم را به همان ترتیب در بر خواهد داشت، و چیدمان
کانال‌های خروجی همان مقدار پیش‌فرض متناظر با تعداد کل
کانال‌ها خواهد بود.
.Sp
برای نمونه، اگر ورودی نخست 2.1 (FL+FR+LF) باشد و ورودی دوم
FC+BL+BR باشد، خروجی در قالب 5.1 خواهد بود و کانال‌ها به
ترتیب زیر چیده می‌شوند: a1, a2, b1, a3, b2, b3 (که a1 کانال اول
ورودی نخست و b1 کانال اول ورودی دوم است).
.Sp
از سوی دیگر، اگر هر دو ورودی استریو باشند، کانال‌های خروجی به
ترتیب پیش‌فرض خواهند بود: a1, a2, b1, b2، و چیدمان کانال‌ها به طور
اختیاری روی 4.0 تنظیم می‌شود، که ممکن است مقدار مورد انتظار باشد یا نباشد.
.IP \fBreset\fR 4
.IX Item "reset"
این حالت چیدمان کانال‌های ورودی را نادیده می‌گیرد و هیچ بازآرایی روی کانال‌ها انجام نمی‌دهد.
خروجی ابتدا شامل تمامی کانال‌های ورودی اول، سپس تمامی کانال‌های
ورودی دوم به همان ترتیب و به همین ترتیب خواهد بود.
.Sp
چیدمان کانال خروجی صرفاً تعداد کل کانال‌ها را معین خواهد کرد.
.IP \fBnormal\fR 4
.IX Item "normal"
این حالت اطلاعات نام و تخصیص کانال‌ها را از کانال‌های ورودی
حفظ کرده و هیچ بازآرایی روی کانال‌ها صورت نمی‌دهد. خروجی شامل تمام کانال‌های
ورودی نخست، سپس تمامی کانال‌های ورودی دوم به همان ترتیب و غیره خواهد بود.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
ادغام دو فایل مونو به یک جریان استریو:
.Sp
.Vb 1
\&        amovie=left.wav [l] ; amovie=right.mp3 [r] ; [l] [r] amerge
.Ve
.IP \(bu 4
چندین ادغام با فرض ۱ جریان ویدیو و ۶ جریان صدا در \fIinput.mkv\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-filter_complex "[0:1][0:2][0:3][0:4][0:5][0:6] amerge=inputs=6" \-c:a pcm_s16le output.mkv
.Ve
.SS amix
.IX Subsection "amix"
میکس چندین ورودی صوتی درون یک خروجی منفرد.
.PP
توجه داشته باشید که این فیلتر تنها از نمونه‌های ممیز شناور پشتیبانی می‌کند (فیلترهای
صوتی \fIamerge\fR و \fIpan\fR از فرمت‌های زیادی پشتیبانی دارند). اگر ورودی
\fIamix\fR دارای نمونه‌های عدد صحیح باشد، فیلتر \fBaresample\fR به طور
خودکار درج می‌شود تا تبدیل به نمونه‌های شناور را انجام دهد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تعداد ورودی‌ها. در صورت عدم تعیین، مقدار پیش‌فرض 2 است.
.IP \fBduration\fR 4
.IX Item "duration"
نحوه تعیین پایان جریان (end-of-stream).
.RS 4
.IP \fBlongest\fR 4
.IX Item "longest"
مدت زمان طولانی‌ترین ورودی. (پیش‌فرض)
.IP \fBshortest\fR 4
.IX Item "shortest"
مدت زمان کوتاه‌ترین ورودی.
.IP \fBfirst\fR 4
.IX Item "first"
مدت زمان اولین ورودی.
.RE
.RS 4
.RE
.IP \fBdropout_transition\fR 4
.IX Item "dropout_transition"
زمان گذار بر حسب ثانیه، برای بازنرمال‌سازی حجم صدا هنگامی که یک جریان
ورودی خاتمه می‌یابد. مقدار پیش‌فرض 2 ثانیه است.
.IP \fBweights\fR 4
.IX Item "weights"
تعیین وزن هر جریان صوتی ورودی به صورت دنباله‌ای از اعداد جداشده
با فاصله. اگر وزن‌های کمتری نسبت به تعداد ورودی‌ها مشخص شود،
آخرین وزن به ورودی‌های باقیمانده اختصاص می‌یابد.
وزن پیش‌فرض برای هر ورودی 1 است.
.IP \fBnormalize\fR 4
.IX Item "normalize"
مقیاس‌بندی همیشگی ورودی‌ها به جای انجام صرف جمع نمونه‌ها.
در صورتی که ورودی‌ها قبل یا بعد از فیلترسازی نرمال‌سازی نشده باشند و این گزینه غیرفعال باشد،
مراقب اعوجاج و برش شدید (heavy clipping) باشید. به طور پیش‌فرض فعال است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
این دستور ۳ جریان صوتی ورودی را به یک خروجی واحد با همان مدت زمان ورودی نخست و
زمان گذار افت ۳ ثانیه میکس می‌کند:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT1 \-i INPUT2 \-i INPUT3 \-filter_complex amix=inputs=3:duration=first:dropout_transition=3 OUTPUT
.Ve
.IP \(bu 4
این دستور یک جریان ورودی وکال و یک جریان ورودی موسیقی را درون یک خروجی واحد با مدت زمان
طولانی‌ترین ورودی میکس می‌کند. صدای موسیقی یک‌چهارم صدای وکال وزن خواهد داشت، و ورودی‌ها نرمال‌سازی نمی‌شوند:
.Sp
.Vb 1
\&        ffmpeg \-i VOCALS \-i MUSIC \-filter_complex amix=inputs=2:duration=longest:dropout_transition=0:weights="1 0.25":normalize=0 OUTPUT
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBweights\fR 4
.IX Item "weights"
.PD 0
.IP \fBnormalize\fR 4
.IX Item "normalize"
.PD
نحو مشابه گزینه با همین نام است.
.SS amultiply
.IX Subsection "amultiply"
ضرب جریان صوتی نخست در جریان صوتی دوم و ذخیره نتیجه
در جریان صوتی خروجی. عمل ضرب از طریق ضرب هر
نمونه از جریان نخست در نمونه واقع در همان موقعیت از جریان دوم انجام می‌شود.
.PP
با این ضرب مؤلفه‌به‌مؤلفه (element-wise)، می‌توان اثرات محو شدن دامنه (amplitude fades) و
مدولاسیون دامنه (amplitude modulations) ایجاد کرد.
.SS anequalizer
.IX Subsection "anequalizer"
اکولایزر چندبانده پارامتریک مرتبه بالا برای هر کانال.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBparams\fR 4
.IX Item "params"
رشته این گزینه در این قالب است:
"c\fIchn\fR f=\fIcf\fR w=\fIw\fR g=\fIg\fR t=\fIf\fR | ..."
هر باند اکولایزر با \*(Aq|\*(Aq تفکیک می‌شود.
.RS 4
.IP \fBchn\fR 4
.IX Item "chn"
تنظیم شماره کانالی که اکولایزاسیون بر آن اعمال خواهد شد.
اگر ورودی فاقد آن کانال باشد، این مدخل نادیده گرفته می‌شود.
.IP \fBf\fR 4
.IX Item "f"
تنظیم فرکانس مرکزی باند.
اگر ورودی فاقد آن فرکانس باشد، این مدخل نادیده گرفته می‌شود.
.IP \fBw\fR 4
.IX Item "w"
تنظیم پهنای باند بر حسب هرتز.
.IP \fBg\fR 4
.IX Item "g"
تنظیم بهره باند بر حسب دسی‌بل (dB).
.IP \fBt\fR 4
.IX Item "t"
تنظیم نوع فیلتر برای باند، اختیاری است و می‌تواند مقادیر زیر باشد:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
باترورث (Butterworth)، این مقدار پیش‌فرض است.
.IP \fB1\fR 4
.IX Item "1"
چبیشف نوع ۱ (Chebyshev type 1).
.IP \fB2\fR 4
.IX Item "2"
چبیشف نوع ۲ (Chebyshev type 2).
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.IP \fBcurves\fR 4
.IX Item "curves"
با فعال‌سازی این گزینه، پاسخ فرکانسی anequalizer در یک جریان ویدیویی
نمایش داده می‌شود.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه جریان ویدیو. تنها در صورتی سودمند است که گزینه curves فعال باشد.
.IP \fBmgain\fR 4
.IX Item "mgain"
تنظیم حداکثر بهره‌ای که نمایش داده خواهد شد. تنها در صورتی سودمند است که گزینه curves فعال باشد.
تنظیم این مقدار بر روی یک عدد معقول، امکان نمایش بهره ناشی از باندهای
همسایه را فراهم می‌سازد که بسیار به یکدیگر نزدیک هستند و از این رو هنگام
فعال بودن هر دو، بهره بالاتری ایجاد می‌کنند.
.IP \fBfscale\fR 4
.IX Item "fscale"
تنظیم مقیاس فرکانس برای ترسیم پاسخ فرکانسی در خروجی ویدیو.
می‌تواند خطی (linear) یا لگاریتمی (logarithmic) باشد. پیش‌فرض لگاریتمی است.
.IP \fBcolors\fR 4
.IX Item "colors"
تنظیم رنگ منحنی هر کانال که قرار است در جریان ویدیویی نمایش یابد.
این یک فهرست از نام رنگ‌هاست که با فاصله یا با \*(Aq|\*(Aq جدا شده‌اند.
رنگ‌های ناشناخته یا جاافتاده با رنگ سفید جایگزین خواهند شد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
کاهش بهره به میزان 10 برای فرکانس مرکزی 200 هرتز و پهنای 100 هرتز
برای ۲ کانال نخست با استفاده از فیلتر چبیشف نوع ۱:
.Sp
.Vb 1
\&        anequalizer=c0 f=200 w=100 g=\-10 t=1|c1 f=200 w=100 g=\-10 t=1
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBchange\fR 4
.IX Item "change"
تغییر پارامترهای فیلتر موجود.
نحو دستورات عبارت است از: "\fIfN\fR|f=\fIfreq\fR|w=\fIwidth\fR|g=\fIgain\fR"
.Sp
شناسه \fIfN\fR شماره فیلتر موجود است، با شروع از 0؛ در صورت نبود چنین فیلتری
خطا بازگردانده می‌شود.
\fIfreq\fR پارامتر فرکانس جدید را تنظیم می‌کند.
\fIwidth\fR پارامتر پهنای جدید را بر حسب هرتز تنظیم می‌کند.
\fIgain\fR پارامتر بهره جدید را بر حسب دسی‌بل تنظیم می‌کند.
.Sp
فراخوانی کامل فیلتر با asendcmd می‌تواند شبیه به این باشد:
asendcmd=c=\*(Aq4.0 anequalizer change 0|f=200|w=50|g=1\*(Aq,anequalizer=...
.SS anlmdn
.IX Subsection "anlmdn"
کاهش نویز باند‌پهن در نمونه‌های صوتی با بهره‌گیری از الگوریتم میانگین‌های غیرمحلی (Non-Local Means).
.PP
هر نمونه با جستجو برای دیگر نمونه‌ها با زمینه‌های مشابه تطبیق داده می‌شود. این
شباهت زمینه با مقایسه وصله‌های (patches) پیرامونی آنها به اندازه
\fBp\fR تعریف می‌گردد. وصله‌ها در ناحیه‌ای به شعاع \fBr\fR پیرامون نمونه جستجو می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBstrength, s\fR" 4
.IX Item "strength, s"
تنظیم شدت نویززدایی. محدوده مجاز از 0.00001 تا 10000 است. مقدار پیش‌فرض 0.00001 است.
.IP "\fBpatch, p\fR" 4
.IX Item "patch, p"
تنظیم مدت زمان شعاع وصله. محدوده مجاز از 1 تا 100 میلی‌ثانیه است.
مقدار پیش‌فرض 2 میلی‌ثانیه است.
.IP "\fBresearch, r\fR" 4
.IX Item "research, r"
تنظیم مدت زمان شعاع جستجو. محدوده مجاز از 2 تا 300 میلی‌ثانیه است.
مقدار پیش‌فرض 6 میلی‌ثانیه است.
.IP "\fBoutput, o\fR" 4
.IX Item "output, o"
تنظیم حالت خروجی.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBi\fR 4
.IX Item "i"
عبور دادن ورودی بدون تغییر.
.IP \fBo\fR 4
.IX Item "o"
عبور دادن نویززدایی‌شده.
.IP \fBn\fR 4
.IX Item "n"
عبور دادن صرفاً نویز.
.Sp
مقدار پیش‌فرض \fIo\fR است.
.RE
.RS 4
.RE
.IP "\fBsmooth, m\fR" 4
.IX Item "smooth, m"
تنظیم ضریب هموارسازی. مقدار پیش‌فرض \fI11\fR است. محدوده مجاز از \fI1\fR تا \fI1000\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS "anlmf, anlms"
.IX Subsection "anlmf, anlms"
اعمال الگوریتم حداقل میانگین (مربعات|توان چهارم) نرمال‌شده بر جریان صوتی اول با استفاده از جریان صوتی دوم.
.PP
این فیلتر تطبیقی جهت تقلید از یک فیلتر مطلوب با یافتن ضرایب فیلتری به کار می‌رود که
مربوط به تولید حداقل میانگین مربعات سیگنال خطا هستند (تفاضل میان ورودی
صوتی دوم مطلوب و سیگنال واقعی، یعنی ورودی صوتی اول).
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر.
.IP \fBmu\fR 4
.IX Item "mu"
تنظیم مقدار mu فیلتر.
.IP \fBeps\fR 4
.IX Item "eps"
تنظیم مقدار eps فیلتر.
.IP \fBleakage\fR 4
.IX Item "leakage"
تنظیم ضریب نشتی (leakage) فیلتر.
.IP \fBout_mode\fR 4
.IX Item "out_mode"
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBi\fR 4
.IX Item "i"
عبور دادن ورودی نخست.
.IP \fBd\fR 4
.IX Item "d"
عبور دادن ورودی دوم.
.IP \fBo\fR 4
.IX Item "o"
عبور تفاضل میان ورودی دوم مطلوب و تخمین سیگنال خطا.
.IP \fBn\fR 4
.IX Item "n"
عبور تفاضل میان ورودی اول و تخمین سیگنال خطا.
.IP \fBe\fR 4
.IX Item "e"
عبور نمونه‌های تخمینی سیگنال خطا.
.Sp
مقدار پیش‌فرض \fIo\fR است.
.RE
.RS 4
.RE
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم میزان دقت مورد استفاده حین پردازش نمونه‌ها.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه داخلی بسته به سایر فیلترها.
.IP \fBfloat\fR 4
.IX Item "float"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور تک‌دقت (single-floating point).
.IP \fBdouble\fR 4
.IX Item "double"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور دودقت (double-floating point).
.RE
.RS 4
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
یکی از کاربردهای پرشمار این فیلتر کاهش نویز است؛ صدای ورودی با
همان نمونه‌هایی فیلتر می‌شود که به مقدار ثابتی به تأخیر افتاده‌اند، نمونه‌ای از آن برای صدای استریو:
.Sp
.Vb 1
\&        asplit[a][b],[a]adelay=32S|32S[a],[b][a]anlms=order=128:leakage=0.0005:mu=.5:out_mode=o
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها به استثنای گزینه \f(CW\*(C`order\*(C'\fR پشتیبانی می‌کند.
.SS anull
.IX Subsection "anull"
عبور دادن منبع صوتی بدون تغییر به خروجی.
.SS apad
.IX Subsection "apad"
پد کردن انتهای جریان صوتی با سکوت.
.PP
این گزینه می‌تواند همراه با \fB\-shortest\fR در \fBffmpeg\fR به کار رود تا
جریان‌های صوتی را تا طولی برابر با جریان ویدیو بسط دهد.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBpacket_size\fR 4
.IX Item "packet_size"
تنظیم اندازه بسته سکوت. مقدار پیش‌فرض 4096 است.
.IP \fBpad_len\fR 4
.IX Item "pad_len"
تنظیم تعداد نمونه‌های سکوت جهت افزودن به انتها. پس از رسیدن به این
مقدار، جریان خاتمه می‌یابد. این گزینه با \fBwhole_len\fR مانعةالجمع
است.
.IP \fBwhole_len\fR 4
.IX Item "whole_len"
تنظیم حداقل تعداد کل نمونه‌ها در جریان صوتی خروجی. اگر این مقدار
بزرگتر از طول صدای ورودی باشد، سکوت به انتها اضافه می‌شود تا به
این مقدار برسد. این گزینه با \fBpad_len\fR مانعةالجمع است.
.IP \fBpad_dur\fR 4
.IX Item "pad_dur"
تعیین مدت زمان نمونه‌های سکوت جهت اضافه شدن. برای نحو پذیرفته‌شده به
\fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید. تنها زمانی که روی مقدار نامنفی تنظیم شود به کار می‌رود.
.IP \fBwhole_dur\fR 4
.IX Item "whole_dur"
تعیین حداقل مدت زمان کل در جریان صوتی خروجی. برای نحو پذیرفته‌شده به
\fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید. تنها زمانی به کار می‌رود که روی مقدار نامنفی تنظیم شود. اگر مقدار بزرگتر از
طول صدای ورودی باشد، سکوت به انتها افزوده می‌شود تا به آن مقدار برسد.
این گزینه با \fBpad_dur\fR مانعةالجمع است.
.PP
اگر هیچ یک از گزینه‌های \fBpad_len\fR، \fBwhole_len\fR، \fBpad_dur\fR
یا \fBwhole_dur\fR تنظیم نشوند، فیلتر سکوت را به صورت نامحدود به انتهای جریان
ورودی اضافه خواهد کرد.
.PP
توجه داشته باشید که در ffmpeg 4.4 و پیش از آن، مقدار صفر برای \fBpad_dur\fR یا
\fBwhole_dur\fR نیز باعث می‌شد فیلتر سکوت را به طور نامحدود اضافه کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
افزودن ۱۰۲۴ نمونه سکوت به انتهای ورودی:
.Sp
.Vb 1
\&        apad=pad_len=1024
.Ve
.IP \(bu 4
اطمینان از اینکه خروجی صدا حداقل شامل ۱۰۰۰۰ نمونه باشد، و در صورت لزوم
پد کردن ورودی با سکوت:
.Sp
.Vb 1
\&        apad=whole_len=10000
.Ve
.IP \(bu 4
استفاده از \fBffmpeg\fR برای پد کردن ورودی صدا با سکوت، به طوری که
جریان ویدیو همواره کوتاه‌ترین نتیجه را بدهد و هنگام استفاده از گزینه
\fBshortest\fR در فایل خروجی تا انتها تبدیل شود:
.Sp
.Vb 1
\&        ffmpeg \-i VIDEO \-i AUDIO \-filter_complex "[1:0]apad" \-shortest OUTPUT
.Ve
.SS aphaser
.IX Subsection "aphaser"
افزودن جلوه فیزر (phasing) به صدای ورودی.
.PP
فیلتر فیزر مجموعه‌ای از قله‌ها و دره‌ها در طیف فرکانسی ایجاد می‌کند.
موقعیت قله‌ها و دره‌ها مدوله می‌شود تا در طول زمان تغییر کنند و یک جلوه روبش (sweeping) پدید آورند.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه آمده است.
.IP \fBin_gain\fR 4
.IX Item "in_gain"
تنظیم بهره ورودی. پیش‌فرض 0.4 است.
.IP \fBout_gain\fR 4
.IX Item "out_gain"
تنظیم بهره خروجی. پیش‌فرض 0.74 است.
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم تاخیر بر حسب میلی‌ثانیه. پیش‌فرض 3.0 است.
.IP \fBdecay\fR 4
.IX Item "decay"
تنظیم میرایی (decay). پیش‌فرض 0.4 است.
.IP \fBspeed\fR 4
.IX Item "speed"
تنظیم سرعت مدولاسیون بر حسب هرتز. پیش‌فرض 0.5 است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع مدولاسیون. پیش‌فرض مثلثی (triangular) است.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fBtriangular, t\fR" 4
.IX Item "triangular, t"
.PD 0
.IP "\fBsinusoidal, s\fR" 4
.IX Item "sinusoidal, s"
.PD
.RE
.RS 4
.RE
.SS aphaseshift
.IX Subsection "aphaseshift"
اعمال شیفت فاز بر روی نمونه‌های صوتی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBshift\fR 4
.IX Item "shift"
تعیین شیفت فاز. محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0.0 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم بهره خروجی اعمالی بر خروجی نهایی. محدوده مجاز از 0.0 تا 1.0 است.
مقدار پیش‌فرض 1.0 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر مورد استفاده برای فیلترسازی. محدوده مجاز از 1 تا 16 است.
مقدار پیش‌فرض 8 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS apsnr
.IX Subsection "apsnr"
اندازه‌گیری نسبت اوج سیگنال صوتی به نویز (Audio Peak Signal-to-Noise Ratio).
.PP
این فیلتر دو جریان صوتی را به عنوان ورودی دریافت کرده و جریان
صوتی نخست را در خروجی می‌دهد.
نتایج بر حسب دسی‌بل (dB) برای هر کانال در انتهای هر یک از ورودی‌ها ارائه می‌شوند.
.SS apsyclip
.IX Subsection "apsyclip"
اعمال برش روان‌شنیداری (Psychoacoustic clipper) بر روی جریان صوتی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهره ورودی. پیش‌فرض 1 است. محدوده مجاز [0.015625 \- 64] است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم بهره خروجی. پیش‌فرض 1 است. محدوده مجاز [0.015625 \- 64] است.
.IP \fBclip\fR 4
.IX Item "clip"
تنظیم مقدار شروع برش. مقدار پیش‌فرض 0dBFS یا 1 است.
.IP \fBdiff\fR 4
.IX Item "diff"
خروجی دادن صرف نمونه‌های تفاضل؛ برای شنیدن اعوجاج‌های ایجادشده سودمند است.
به طور پیش‌فرض غیرفعال است.
.IP \fBadaptive\fR 4
.IX Item "adaptive"
تنظیم شدت اعوجاج تطبیقی اعمال‌شده. مقدار پیش‌فرض 0.5 است.
محدوده مجاز از 0 تا 1 است.
.IP \fBiterations\fR 4
.IX Item "iterations"
تنظیم تعداد تکرارهای برش‌دهنده روان‌شنیداری.
محدوده مجاز از 1 تا 20 است. مقدار پیش‌فرض 10 است.
.IP \fBlevel\fR 4
.IX Item "level"
تراز خودکار سطح سیگنال خروجی. پیش‌فرض غیرفعال است.
در صورت فعال بودن، صدا را به 0dBFS نرمال‌سازی می‌کند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS apulsator
.IX Subsection "apulsator"
پالس‌ساز صوتی چیزی مابین یک اتوپَنِر (autopanner) و یک ترمولو (tremolo) است.
اما همچنین می‌تواند جلوه‌های استریوی جالبی تولید کند. پالساتور حجم صدای
کانال چپ و راست را بر اساس یک نوسان‌ساز بسامد پایین (LFO) با شکل‌موج‌های
گوناگون و فازهای شیفت‌یافته دگرگون می‌کند.
این فیلتر توانایی تعیین یک آفست میان کانال چپ و
راست را دارد. آفست 0 بدین معنی است که هر دو شکل LFO بر یکدیگر منطبق هستند.
کانال چپ و راست به یک اندازه تغییر می‌کنند \- یک ترمولوی سنتی.
آفست 50% بدین معناست که شکل کانال راست دقیقاً در فاز
شیفت یافته است (یا به اندازه نصف بسامد به عقب منتقل شده) \- پالساتور به عنوان یک
اتوپَنِر عمل می‌کند. در مقدار 1 هر دو منحنی مجدداً منطبق می‌شوند. هر تنظیمی در این بین،
شیفت فاز را بدون فاصله میان تمام مراحل جابجا کرده و صداهای "گذرنده" با
شکل‌موج‌های سینوسی و مثلثی تولید می‌نماید. هرچه آفست را به 1 نزدیک‌تر تنظیم کنید (با شروع از
0.5)، سیگنال با سرعت بیشتری از بلندگوی چپ به راست عبور می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهره ورودی. پیش‌فرض 1 است. محدوده مجاز [0.015625 \- 64] است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم بهره خروجی. پیش‌فرض 1 است. محدوده مجاز [0.015625 \- 64] است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم شکل موجی که LFO استفاده خواهد کرد. می‌تواند یکی از موارد: sine، triangle، square،
sawup یا sawdown باشد. پیش‌فرض sine است.
.IP \fBamount\fR 4
.IX Item "amount"
تنظیم مدولاسیون. تعیین میزان اثرگذاری LFO بر سیگنال اصلی.
.IP \fBoffset_l\fR 4
.IX Item "offset_l"
تنظیم آفست کانال چپ. پیش‌فرض 0 است. محدوده مجاز [0 \- 1] است.
.IP \fBoffset_r\fR 4
.IX Item "offset_r"
تنظیم آفست کانال راست. پیش‌فرض 0.5 است. محدوده مجاز [0 \- 1] است.
.IP \fBwidth\fR 4
.IX Item "width"
تنظیم پهنای پالس. پیش‌فرض 1 است. محدوده مجاز [0 \- 2] است.
.IP \fBtiming\fR 4
.IX Item "timing"
تنظیم حالت زمان‌بندی ممکن. می‌تواند یکی از موارد: bpm، ms یا hz باشد. پیش‌فرض hz است.
.IP \fBbpm\fR 4
.IX Item "bpm"
تنظیم ضرب بر دقیقه (bpm). پیش‌فرض 120 است. محدوده مجاز [30 \- 300] است. تنها در صورتی
به کار می‌رود که timing بر روی bpm تنظیم شده باشد.
.IP \fBms\fR 4
.IX Item "ms"
تنظیم میلی‌ثانیه. پیش‌فرض 500 است. محدوده مجاز [10 \- 2000] است. تنها در صورتی به کار
می‌رود که timing بر روی ms تنظیم شده باشد.
.IP \fBhz\fR 4
.IX Item "hz"
تنظیم بسامد بر حسب هرتز. پیش‌فرض 2 است. محدوده مجاز [0.01 \- 100] است. تنها در صورتی
به کار می‌رود که timing بر روی hz تنظیم شده باشد.
.SS aresample
.IX Subsection "aresample"
بازنمونه‌برداری (resample) صدای ورودی با پارامترهای معین، با استفاده از کتابخانه
libswresample. در صورت عدم تعیین پارامترها، فیلتر به صورت خودکار بین
ورودی و خروجی خود تبدیل را انجام خواهد داد.
.PP
این فیلتر همچنین قادر است داده‌های صوتی را کشیده یا فشرده کند تا با برچسب‌های
زمانی تطبیق یابند، یا سکوت تزریق کند / صدا را برش دهد تا با برچسب‌های زمانی
منطبق شوند، ترکیبی از هر دو را اجرا کند یا هیچ‌کدام را انجام ندهد.
.PP
فیلتر نحو
[\fIsample_rate\fR:]\fIresampler_options\fR را می‌پذیرد، که در آن \fIsample_rate\fR
بیانگر نرخ نمونه‌برداری و \fIresampler_options\fR فهرستی از جفت‌های
\fIkey\fR=\fIvalue\fR جداشده با ":" است. برای فهرست کامل گزینه‌های پشتیبانی‌شده به
\fBبخش "Resampler Options" در راهنمای ffmpeg\-resampler\|(1)\fR
مراجعه کنید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
بازنمونه‌برداری صدای ورودی به نرخ ۴۴۱۰۰ هرتز:
.Sp
.Vb 1
\&        aresample=44100
.Ve
.IP \(bu 4
کشیدن/فشرده‌سازی نمونه‌ها بر اساس برچسب‌های زمانی داده‌شده، با حداکثر جبران ۱۰۰۰
نمونه در ثانیه:
.Sp
.Vb 1
\&        aresample=async=1000
.Ve
.SS areverse
.IX Subsection "areverse"
معکوس کردن یک کلیپ صوتی.
.PP
هشدار: این فیلتر برای بافر کردن کل کلیپ به حافظه نیاز دارد، بنابراین برش زدن (trimming)
توصیه می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
دریافت ۵ ثانیه اول یک کلیپ و معکوس کردن آن.
.Sp
.Vb 1
\&        atrim=end=5,areverse
.Ve
.SS arls
.IX Subsection "arls"
اعمال الگوریتم حداقل مربعات بازگشتی (Recursive Least Squares) بر روی جریان صوتی نخست با استفاده از جریان صوتی دوم.
.PP
این فیلتر تطبیقی جهت تقلید از یک فیلتر مطلوب با یافتن بازگشتی ضرایب فیلتری به کار می‌رود که
مربوط به تولید حداقل تابع هزینه مربعات خطی وزن‌دار سیگنال خطا هستند (تفاضل
میان ورودی صوتی دوم مطلوب و سیگنال واقعی، ورودی صوتی اول).
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر.
.IP \fBlambda\fR 4
.IX Item "lambda"
تنظیم ضریب فراموشی (forgetting factor).
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم ضریب جهت مقداردهی اولیه ماتریس کوواریانس داخلی.
.IP \fBout_mode\fR 4
.IX Item "out_mode"
تنظیم نمونه‌های خروجی فیلتر. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBi\fR 4
.IX Item "i"
عبور دادن ورودی نخست.
.IP \fBd\fR 4
.IX Item "d"
عبور دادن ورودی دوم.
.IP \fBo\fR 4
.IX Item "o"
عبور تفاضل میان ورودی دوم مطلوب و تخمین سیگنال خطا.
.IP \fBn\fR 4
.IX Item "n"
عبور تفاضل میان ورودی اول و تخمین سیگنال خطا.
.IP \fBe\fR 4
.IX Item "e"
عبور نمونه‌های تخمینی سیگنال خطا.
.Sp
مقدار پیش‌فرض \fIo\fR است.
.RE
.RS 4
.RE
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم میزان دقت مورد استفاده حین پردازش نمونه‌ها.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه داخلی بسته به سایر فیلترها.
.IP \fBfloat\fR 4
.IX Item "float"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور تک‌دقت (single-floating point).
.IP \fBdouble\fR 4
.IX Item "double"
استفاده همیشگی از فرمت نمونه با دقت ممیز شناور دودقت (double-floating point).
.RE
.RS 4
.RE
.SS arnndn
.IX Subsection "arnndn"
کاهش نویز گفتار با استفاده از شبکه‌های عصبی بازگشتی (RNN).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBmodel, m\fR" 4
.IX Item "model, m"
تنظیم فایل مدل آموزش‌دیده جهت بارگذاری. این گزینه همواره الزامی است.
.IP \fBmix\fR 4
.IX Item "mix"
تنظیم میزان آمیختن نمونه‌های فیلترشده در خروجی نهایی.
محدوده مجاز از \-1 تا 1 است. مقدار پیش‌فرض 1 است.
مقادیر منفی ویژه هستند؛ آنها تعیین می‌کنند چه مقدار از نویز فیلترشده
در خروجی نهایی فیلتر حفظ شود. این گزینه را روی \-1 تنظیم کنید تا نویز واقعی
حذف‌شده از سیگنال ورودی را بشنوید.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS asdr
.IX Subsection "asdr"
اندازه‌گیری نسبت سیگنال به اعوجاج صوتی (Audio Signal-to-Distortion Ratio).
.PP
این فیلتر دو جریان صوتی را به عنوان ورودی دریافت کرده و جریان صوتی نخست
را در خروجی می‌دهد.
نتایج بر حسب دسی‌بل (dB) برای هر کانال در انتهای هر یک از ورودی‌ها ارائه می‌شوند.
.SS asetnsamples
.IX Subsection "asetnsamples"
تنظیم تعداد نمونه‌ها در هر فریم صوتی خروجی.
.PP
آخرین بسته خروجی ممکن است حاوی تعداد متفاوتی نمونه باشد، زیرا
هنگامی که صدای ورودی پایان خود را اعلان می‌کند، فیلتر تمامی نمونه‌های باقیمانده را
تخلیه (flush) خواهد کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBnb_out_samples, n\fR" 4
.IX Item "nb_out_samples, n"
تنظیم تعداد نمونه‌ها برای هر فریم صوتی خروجی. این عدد به عنوان تعداد نمونه‌ها
\fIبرای هر کانال\fR در نظر گرفته می‌شود.
مقدار پیش‌فرض 1024 است.
.IP "\fBpad, p\fR" 4
.IX Item "pad, p"
اگر روی 1 تنظیم شود، فیلتر فریم صوتی نهایی را با صفرها پد خواهد کرد،
به گونه‌ای که آخرین فریم حاوی همان تعداد نمونه‌های فریم‌های پیشین
باشد. مقدار پیش‌فرض 1 است.
.PP
برای نمونه، جهت تنظیم تعداد نمونه‌های هر فریم بر روی ۱۲۳۴ و
غیرفعال کردن پدینگ برای فریم آخر، از این دستور استفاده کنید:
.PP
.Vb 1
\&        asetnsamples=n=1234:p=0
.Ve
.SS asetrate
.IX Subsection "asetrate"
تنظیم نرخ نمونه‌برداری بدون دگرگون‌سازی داده‌های PCM.
این امر منجر به تغییر در سرعت و زیروبمی (pitch) صدا خواهد شد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تنظیم نرخ نمونه‌برداری خروجی. پیش‌فرض 44100 هرتز است.
.SS ashowinfo
.IX Subsection "ashowinfo"
نمایش یک خط حاوی اطلاعات گوناگون برای هر فریم صوتی ورودی.
صدای ورودی اصلاح یا دگرگون نمی‌شود.
.PP
خط نمایش‌داده‌شده شامل دنباله‌ای از جفت‌های کلید/مقدار به فرم
\fIkey\fR:\fIvalue\fR است.
.PP
مقادیر زیر در خروجی نمایش داده می‌شوند:
.IP \fBn\fR 4
.IX Item "n"
شماره (ترتیبی) فریم ورودی، با شروع از 0.
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمانی نمایش (PTS) فریم ورودی بر حسب واحدهای مبنای زمان؛ مبنای زمان
به پد ورودی فیلتر وابسته است و معمولاً 1/\fIsample_rate\fR می‌باشد.
.IP \fBpts_time\fR 4
.IX Item "pts_time"
برچسب زمانی نمایش فریم ورودی بر حسب ثانیه.
.IP \fBfmt\fR 4
.IX Item "fmt"
فرمت نمونه.
.IP \fBchlayout\fR 4
.IX Item "chlayout"
چیدمان کانال (channel layout).
.IP \fBrate\fR 4
.IX Item "rate"
نرخ نمونه‌برداری برای فریم صوتی.
.IP \fBnb_samples\fR 4
.IX Item "nb_samples"
تعداد نمونه‌ها (برای هر کانال) در فریم.
.IP \fBchecksum\fR 4
.IX Item "checksum"
چک‌سام Adler-32 (چاپ‌شده به صورت هگزادسیمال) از داده‌های صوتی. برای صدای چندصفحه‌ای
(planar)، داده‌ها به گونه‌ای در نظر گرفته می‌شوند که گویی تمام صفحات به هم متصل شده‌اند.
.IP \fBplane_checksums\fR 4
.IX Item "plane_checksums"
فهرستی از چک‌سام‌های Adler-32 برای هر صفحه از داده‌ها.
.SS asisdr
.IX Subsection "asisdr"
اندازه‌گیری نسبت سیگنال به اعوجاج صوتی نامتغیر با مقیاس (Audio Scaled-Invariant Signal-to-Distortion Ratio).
.PP
این فیلتر دو جریان صوتی را به عنوان ورودی دریافت کرده و جریان صوتی نخست
را در خروجی می‌دهد.
نتایج بر حسب دسی‌بل (dB) برای هر کانال در انتهای هر یک از ورودی‌ها ارائه می‌شوند.
.SS asoftclip
.IX Subsection "asoftclip"
اعمال برش نرم صوتی (soft clipping).
.PP
برش نرم نوعی جلوه اعوجاج است که در آن دامنه سیگنال در امتداد یک منحنی
نرم اشباع می‌شود، به جای شکل ناگهانی و خشن برش سخت (hard-clipping).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع برش نرم.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBhard\fR 4
.IX Item "hard"
.PD 0
.IP \fBtanh\fR 4
.IX Item "tanh"
.IP \fBatan\fR 4
.IX Item "atan"
.IP \fBcubic\fR 4
.IX Item "cubic"
.IP \fBexp\fR 4
.IX Item "exp"
.IP \fBalg\fR 4
.IX Item "alg"
.IP \fBquintic\fR 4
.IX Item "quintic"
.IP \fBsin\fR 4
.IX Item "sin"
.IP \fBerf\fR 4
.IX Item "erf"
.PD
.RE
.RS 4
.RE
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه‌ای که برش از آنجا آغاز می‌شود. مقدار پیش‌فرض 0dB یا 1 است.
.IP \fBoutput\fR 4
.IX Item "output"
تنظیم بهره اعمالی بر خروجی. مقدار پیش‌فرض 0dB یا 1 است.
.IP \fBparam\fR 4
.IX Item "param"
تنظیم پارامتر اضافی که تابع سیگموئید را کنترل می‌کند.
.IP \fBoversample\fR 4
.IX Item "oversample"
تنظیم ضریب بیش‌نمونه‌برداری (oversampling factor).
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS aspectralstats
.IX Subsection "aspectralstats"
نمایش اطلاعات آماری حوزه فرکانس درباره کانال‌های صوتی.
آمارها برای هر کانال صوتی و برای هر فریم صوتی محاسبه و به عنوان متادیتا ذخیره می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBwin_size\fR 4
.IX Item "win_size"
تنظیم طول پنجره بر حسب نمونه‌ها. مقدار پیش‌فرض 2048 است.
محدوده مجاز از 32 تا 65536 است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP "\fBhann, hanning\fR" 4
.IX Item "hann, hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم همپوشانی پنجره. محدوده مجاز از \f(CW0\fR
تا \f(CW1\fR است. مقدار پیش‌فرض \f(CW0.5\fR است.
.IP \fBmeasure\fR 4
.IX Item "measure"
انتخاب پارامترهایی که اندازه‌گیری می‌شوند. کلیدهای متادیتا می‌توانند
به عنوان فلگ استفاده شوند، مقدار پیش‌فرض \fBall\fR است که همه پارامترها را اندازه‌گیری می‌کند.
مقدار \fBnone\fR تمام اندازه‌گیری‌ها را غیرفعال می‌سازد.
.PP
فهرستی از هر کلید متادیتا در ادامه آمده است:
.IP \fBmean\fR 4
.IX Item "mean"
.PD 0
.IP \fBvariance\fR 4
.IX Item "variance"
.IP \fBcentroid\fR 4
.IX Item "centroid"
.IP \fBspread\fR 4
.IX Item "spread"
.IP \fBskewness\fR 4
.IX Item "skewness"
.IP \fBkurtosis\fR 4
.IX Item "kurtosis"
.IP \fBentropy\fR 4
.IX Item "entropy"
.IP \fBflatness\fR 4
.IX Item "flatness"
.IP \fBcrest\fR 4
.IX Item "crest"
.IP \fBflux\fR 4
.IX Item "flux"
.IP \fBslope\fR 4
.IX Item "slope"
.IP \fBdecrease\fR 4
.IX Item "decrease"
.IP \fBrolloff\fR 4
.IX Item "rolloff"
.PD
.SS asr
.IX Subsection "asr"
تشخیص خودکار گفتار (Automatic Speech Recognition).
.PP
این فیلتر از PocketSphinx برای تشخیص گفتار بهره می‌برد. برای فعال‌سازی
کامپایل این فیلتر، باید FFmpeg را با
\f(CW\*(C`\-\-enable\-pocketsphinx\*(C'\fR پیکربندی کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrate\fR 4
.IX Item "rate"
تنظیم نرخ نمونه‌برداری صدای ورودی. پیش‌فرض \f(CW16000\fR است.
این مقدار باید با مدل‌های گفتار همخوانی داشته باشد، در غیر این صورت نتایج نامناسبی حاصل می‌شود.
.IP \fBhmm\fR 4
.IX Item "hmm"
تنظیم دایرکتوری حاوی فایل‌های مدل صوتی (acoustic model).
.IP \fBdict\fR 4
.IX Item "dict"
تنظیم فرهنگ لغت تلفظ.
.IP \fBlm\fR 4
.IX Item "lm"
تنظیم فایل مدل زبان.
.IP \fBlmctl\fR 4
.IX Item "lmctl"
تنظیم مجموعه مدل زبان.
.IP \fBlmname\fR 4
.IX Item "lmname"
تعیین اینکه کدام مدل زبان به کار گرفته شود.
.IP \fBlogfn\fR 4
.IX Item "logfn"
تنظیم خروجی برای پیام‌های لاگ.
.PP
این فیلتر گفتار شناسایی‌شده را به صورت متادیتای فریم \f(CW\*(C`lavfi.asr.text\*(C'\fR صادر می‌کند.
.SS astats
.IX Subsection "astats"
نمایش اطلاعات آماری حوزه زمان درباره کانال‌های صوتی.
آمارها برای هر کانال صوتی محاسبه و نمایش داده می‌شوند و،
در صورت امکان، یک مقدار کلی (overall) نیز ارائه می‌گردد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlength\fR 4
.IX Item "length"
طول پنجره کوتاه بر حسب ثانیه، که برای اندازه‌گیری قله و دره RMS استفاده می‌شود.
پیش‌فرض \f(CW0.05\fR (۵۰ میلی‌ثانیه) است. محدوده مجاز \f(CW\*(C`[0 \- 10]\*(C'\fR است.
.IP \fBmetadata\fR 4
.IX Item "metadata"
تنظیم تزریق متادیتا. تمام کلیدهای متادیتا با پیشوند \f(CW\*(C`lavfi.astats.X\*(C'\fR مشخص می‌شوند،
که در آن \f(CW\*(C`X\*(C'\fR شماره کانال با شروع از 1 یا رشته \f(CW\*(C`Overall\*(C'\fR است. پیش‌فرض
غیرفعال است.
.Sp
کلیدهای موجود برای هر کانال عبارتند از:
\fIBit_depth\fR
\fICrest_factor\fR
\fIDC_offset\fR
\fIDynamic_range\fR
\fIEntropy\fR
\fIFlat_factor\fR
\fIMax_difference\fR
\fIMax_level\fR
\fIMean_difference\fR
\fIMin_difference\fR
\fIMin_level\fR
\fINoise_floor\fR
\fINoise_floor_count\fR
\fINumber_of_Infs\fR
\fINumber_of_NaNs\fR
\fINumber_of_denormals\fR
\fIPeak_count\fR
\fIAbs_Peak_count\fR
\fIPeak_level\fR
\fIRMS_difference\fR
\fIRMS_peak\fR
\fIRMS_trough\fR
\fIZero_crossings\fR
\fIZero_crossings_rate\fR
.Sp
و برای \f(CW\*(C`Overall\*(C'\fR:
\fIBit_depth\fR
\fIDC_offset\fR
\fIEntropy\fR
\fIFlat_factor\fR
\fIMax_difference\fR
\fIMax_level\fR
\fIMean_difference\fR
\fIMin_difference\fR
\fIMin_level\fR
\fINoise_floor\fR
\fINoise_floor_count\fR
\fINumber_of_Infs\fR
\fINumber_of_NaNs\fR
\fINumber_of_denormals\fR
\fINumber_of_samples\fR
\fIPeak_count\fR
\fIAbs_Peak_count\fR
\fIPeak_level\fR
\fIRMS_difference\fR
\fIRMS_level\fR
\fIRMS_peak\fR
\fIRMS_trough\fR
.Sp
برای نمونه، یک کلید کامل شبیه \f(CW\*(C`lavfi.astats.1.DC_offset\*(C'\fR یا
\f(CW\*(C`lavfi.astats.Overall.Peak_count\*(C'\fR است.
.Sp
برای شرح کلیدها بخش زیر را مطالعه کنید.
.IP \fBreset\fR 4
.IX Item "reset"
تنظیم تعداد فریم‌هایی که آمارهای تجمعی پیش از بازنشانی روی آنها محاسبه می‌شوند.
پیش‌فرض غیرفعال است.
.IP \fBmeasure_perchannel\fR 4
.IX Item "measure_perchannel"
انتخاب پارامترهایی که برای هر کانال اندازه‌گیری می‌شوند. کلیدهای متادیتا می‌توانند به عنوان فلگ استفاده شوند؛
پیش‌فرض \fBall\fR است که همه چیز را اندازه‌گیری می‌کند.
مقدار \fBnone\fR تمام اندازه‌گیری‌های مختص کانال را غیرفعال می‌سازد.
.IP \fBmeasure_overall\fR 4
.IX Item "measure_overall"
انتخاب پارامترهایی که به صورت کلی اندازه‌گیری می‌شوند. کلیدهای متادیتا می‌توانند به عنوان فلگ استفاده شوند؛
پیش‌فرض \fBall\fR است که همه چیز را اندازه‌گیری می‌کند.
مقدار \fBnone\fR تمام اندازه‌گیری‌های کلی را غیرفعال می‌سازد.
.PP
شرح کلیدهای اندازه‌گیری در ادامه آمده است:
.IP \fBnone\fR 4
.IX Item "none"
بدون اندازه‌گیری
.IP \fBall\fR 4
.IX Item "all"
تمام اندازه‌گیری‌ها
.IP \fBBit_depth\fR 4
.IX Item "Bit_depth"
عمق بیتی کلی صدا، یعنی تعداد بیت‌های استفاده‌شده برای هر نمونه
.IP \fBCrest_factor\fR 4
.IX Item "Crest_factor"
نسبت استاندارد سطح اوج به سطح RMS (توجه: بر حسب دسی‌بل نیست)
.IP \fBDC_offset\fR 4
.IX Item "DC_offset"
میانگین جابجایی دامنه از صفر
.IP \fBDynamic_range\fR 4
.IX Item "Dynamic_range"
محدوده دینامیکی اندازه‌گیری‌شده صدا بر حسب دسی‌بل (dB)
.IP \fBEntropy\fR 4
.IX Item "Entropy"
آنتروپی اندازه‌گیری‌شده در کل صدا؛ آنتروپی با مقداری نزدیک به 1.0 معمولاً برای نویز سفید اندازه گرفته می‌شود
.IP \fBFlat_factor\fR 4
.IX Item "Flat_factor"
فاکتور تختی (یعنی نمونه‌های متوالی با مقدار یکسان) سیگنال در سطوح اوج آن
(یعنی \fIMin_level\fR یا \fIMax_level\fR)
.IP \fBMax_difference\fR 4
.IX Item "Max_difference"
حداکثر تفاضل میان دو نمونه متوالی
.IP \fBMax_level\fR 4
.IX Item "Max_level"
حداکثر سطح نمونه
.IP \fBMean_difference\fR 4
.IX Item "Mean_difference"
میانگین تفاضل میان دو نمونه متوالی، یعنی میانگین تک‌تک اختلافات بین دو نمونه پی‌در‌پی
.IP \fBMin_difference\fR 4
.IX Item "Min_difference"
حداقل تفاضل میان دو نمونه متوالی
.IP \fBMin_level\fR 4
.IX Item "Min_level"
حداقل سطح نمونه
.IP \fBNoise_floor\fR 4
.IX Item "Noise_floor"
حداقل اوج محلی اندازه‌گیری‌شده بر حسب dBFS روی یک پنجره کوتاه
.IP \fBNoise_floor_count\fR 4
.IX Item "Noise_floor_count"
تعداد دفعاتی (نه تعداد نمونه‌ها) که سیگنال به
\fINoise floor\fR رسیده است
.IP \fBNumber_of_Infs\fR 4
.IX Item "Number_of_Infs"
تعداد نمونه‌های با مقدار بی‌نهایت
.IP \fBNumber_of_NaNs\fR 4
.IX Item "Number_of_NaNs"
تعداد نمونه‌های با مقدار NaN (غیرعدد)
.IP \fBNumber_of_denormals\fR 4
.IX Item "Number_of_denormals"
تعداد نمونه‌های با مقدار زیر‌نرمال (subnormal)
.IP \fBNumber_of_samples\fR 4
.IX Item "Number_of_samples"
تعداد نمونه‌ها
.IP \fBPeak_count\fR 4
.IX Item "Peak_count"
تعداد دفعاتی (نه تعداد نمونه‌ها) که سیگنال به \fIMin_level\fR یا \fIMax_level\fR
رسیده است
.IP \fBAbs_Peak_count\fR 4
.IX Item "Abs_Peak_count"
تعداد دفعاتی که قدر مطلق نمونه‌های گرفته‌شده از سیگنال به
حداکثر مقدار مطلق \fIMin_level\fR و \fIMax_level\fR رسیده است
.IP \fBPeak_level\fR 4
.IX Item "Peak_level"
سطح اوج استاندارد اندازه‌گیری‌شده بر حسب dBFS
.IP \fBRMS_difference\fR 4
.IX Item "RMS_difference"
جذر میانگین مربعات تفاضل میان دو نمونه متوالی
.IP \fBRMS_level\fR 4
.IX Item "RMS_level"
سطح استاندارد RMS اندازه‌گیری‌شده بر حسب dBFS
.IP \fBRMS_peak\fR 4
.IX Item "RMS_peak"
.PD 0
.IP \fBRMS_trough\fR 4
.IX Item "RMS_trough"
.PD
مقادیر اوج و فرود برای سطح RMS اندازه‌گیری‌شده در طول یک پنجره کوتاه،
اندازه‌گیری‌شده بر حسب dBFS.
.IP "\fBZero crossings\fR" 4
.IX Item "Zero crossings"
تعداد نقاطی که در آنها شکل‌موج از محور سطح صفر عبور می‌کند
.IP "\fBZero crossings rate\fR" 4
.IX Item "Zero crossings rate"
نرخ گذر از صفر نسبت به تعداد نمونه‌های صوتی
.SS asubboost
.IX Subsection "asubboost"
تقویت بسامدهای ساب‌ووفر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdry\fR 4
.IX Item "dry"
تنظیم بهره سیگنال اصلی، چه مقدار از سیگنال اصلی حفظ شود. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 1.0 است.
.IP \fBwet\fR 4
.IX Item "wet"
تنظیم بهره سیگنال فیلترشده، چه مقدار از سیگنال فیلترشده حفظ شود. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 1.0 است.
.IP \fBboost\fR 4
.IX Item "boost"
تنظیم ضریب حداکثر تقویت. محدوده مجاز از 1 تا 12 است. مقدار پیش‌فرض 2 است.
.IP \fBdecay\fR 4
.IX Item "decay"
تنظیم مقدار بهره میرایی خط تاخیر. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0.0 است.
.IP \fBfeedback\fR 4
.IX Item "feedback"
تنظیم مقدار بهره بازخورد خط تاخیر. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0.9 است.
.IP \fBcutoff\fR 4
.IX Item "cutoff"
تنظیم فرکانس قطع بر حسب هرتز. محدوده مجاز از 50 تا 900 است.
مقدار پیش‌فرض 100 است.
.IP \fBslope\fR 4
.IX Item "slope"
تنظیم میزان شیب برای فرکانس قطع. محدوده مجاز 0.0001 تا 1 است.
مقدار پیش‌فرض 0.5 است.
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم تاخیر. محدوده مجاز از 1 تا 100 است.
مقدار پیش‌فرض 20 است.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم کانال‌ها برای پردازش. مقدار پیش‌فرض تمام کانال‌های موجود است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS asubcut
.IX Subsection "asubcut"
برش بسامدهای ساب‌ووفر.
.PP
این فیلتر امکان تنظیم یک شیب تندتر و سفارشی را
نسبت به فیلتر بالاگذر فراهم می‌سازد و از این رو قادر است
محتوای فرکانسی در باند توقف را بیشتر تضعیف کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcutoff\fR 4
.IX Item "cutoff"
تنظیم فرکانس قطع بر حسب هرتز. محدوده مجاز از 2 تا 200 است.
مقدار پیش‌فرض 20 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر. مقادیر موجود از 3 تا 20 است.
مقدار پیش‌فرض 10 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بهره ورودی. محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS asupercut
.IX Subsection "asupercut"
برش بسامدهای بسیار بالا (super frequencies).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcutoff\fR 4
.IX Item "cutoff"
تنظیم فرکانس قطع بر حسب هرتز. محدوده مجاز از 20000 تا 192000 است.
مقدار پیش‌فرض 20000 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر. مقادیر موجود از 3 تا 20 است.
مقدار پیش‌فرض 10 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بهره ورودی. محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS asuperpass
.IX Subsection "asuperpass"
اعمال فیلتر میان‌گذر باترورث مرتبه بالا.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcenterf\fR 4
.IX Item "centerf"
تنظیم فرکانس مرکزی بر حسب هرتز. محدوده مجاز از 2 تا 999999 است.
مقدار پیش‌فرض 1000 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر. مقادیر موجود از 4 تا 20 است.
مقدار پیش‌فرض 4 است.
.IP \fBqfactor\fR 4
.IX Item "qfactor"
تنظیم ضریب کیفیت (Q-factor). محدوده مجاز از 0.01 تا 100 است. مقدار پیش‌فرض 1 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بهره ورودی. محدوده مجاز از 0 تا 2 است. مقدار پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS asuperstop
.IX Subsection "asuperstop"
اعمال فیلتر میان‌ناگذر باترورث مرتبه بالا.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcenterf\fR 4
.IX Item "centerf"
تنظیم فرکانس مرکزی بر حسب هرتز. محدوده مجاز از 2 تا 999999 است.
مقدار پیش‌فرض 1000 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر. مقادیر موجود از 4 تا 20 است.
مقدار پیش‌فرض 4 است.
.IP \fBqfactor\fR 4
.IX Item "qfactor"
تنظیم ضریب کیفیت (Q-factor). محدوده مجاز از 0.01 تا 100 است. مقدار پیش‌فرض 1 است.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بهره ورودی. محدوده مجاز از 0 تا 2 است. مقدار پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS atempo
.IX Subsection "atempo"
تنظیم سرعت ضرب‌آهنگ (tempo) صدا.
.PP
این فیلتر دقیقاً یک پارامتر را می‌پذیرد، که همان تمپوی صدا است. در صورت عدم
تعیین، فیلتر تمپوی اسمی 1.0 را فرض خواهد کرد. تمپو باید در
محدوده [0.5, 100.0] باشد.
.PP
توجه داشته باشید که تمپوی بالاتر از 2 برخی نمونه‌ها را رد می‌کند تا اینکه
آنها را در هم بیامیزد. اگر به هر دلیلی این مسئله جای نگرانی دارد، همواره می‌توان
چند نمونه از atempo را به صورت زنجیره‌ای به کار بست تا تمپوی حاصل مطلوب
به دست آید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
کند کردن صدا به میزان 80% تمپو:
.Sp
.Vb 1
\&        atempo=0.8
.Ve
.IP \(bu 4
تند کردن صدا به میزان 300% تمپو:
.Sp
.Vb 1
\&        atempo=3
.Ve
.IP \(bu 4
تند کردن صدا به میزان 300% تمپو با زنجیره‌سازی دو فیلتر atempo:
.Sp
.Vb 1
\&        atempo=sqrt(3),atempo=sqrt(3)
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBtempo\fR 4
.IX Item "tempo"
تغییر ضریب مقیاس تمپوی فیلتر.
نحو دستور عبارت است از: "\fItempo\fR"
.SS atilt
.IX Subsection "atilt"
اعمال فیلتر شیب طیفی (spectral tilt) بر روی جریان صوتی.
.PP
این فیلتر هرگونه شیب افت طیفی را بر روی هر باند فرکانسی مشخص‌شده اعمال می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfreq\fR 4
.IX Item "freq"
تنظیم فرکانس مرکزی شیب بر حسب هرتز. پیش‌فرض 10000 هرتز است.
.IP \fBslope\fR 4
.IX Item "slope"
تنظیم جهت شیب. پیش‌فرض 0 است. محدوده مجاز از \-1 تا 1 است.
.IP \fBwidth\fR 4
.IX Item "width"
تنظیم پهنای شیب. پیش‌فرض 1000 است. محدوده مجاز از 100 تا 10000 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم مرتبه فیلتر شیب.
.IP \fBlevel\fR 4
.IX Item "level"
تنظیم سطح بلندی ورودی. محدوده مجاز از 0 تا 4 است.
پیش‌فرض 1 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBcommands\fR پشتیبانی می‌کند.
.SS atrim
.IX Subsection "atrim"
برش دادن ورودی به گونه‌ای که خروجی حاوی یک زیربخش پیوسته از ورودی باشد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBstart\fR 4
.IX Item "start"
برچسب زمانی (بر حسب ثانیه) از شروع بخشی که باید نگه‌داری شود. یعنی نمونه صوتی با
برچسب زمانی \fIstart\fR نخستین نمونه در خروجی خواهد بود.
.IP \fBend\fR 4
.IX Item "end"
تعیین زمان اولین نمونه صوتی که دور ریخته می‌شود، یعنی نمونه صوتی
بلافاصله قبل از نمونه دارای برچسب زمانی \fIend\fR، آخرین نمونه در
خروجی خواهد بود.
.IP \fBstart_pts\fR 4
.IX Item "start_pts"
مشابه \fIstart\fR، به استثنای اینکه این گزینه برچسب زمانی شروع را بر حسب نمونه‌ها
به جای ثانیه تنظیم می‌کند.
.IP \fBend_pts\fR 4
.IX Item "end_pts"
مشابه \fIend\fR، به استثنای اینکه این گزینه برچسب زمانی پایان را بر حسب نمونه‌ها
به جای ثانیه تنظیم می‌کند.
.IP \fBduration\fR 4
.IX Item "duration"
حداکثر مدت‌زمان خروجی بر حسب ثانیه.
.IP \fBstart_sample\fR 4
.IX Item "start_sample"
شماره نخستین نمونه‌ای که باید به خروجی فرستاده شود.
.IP \fBend_sample\fR 4
.IX Item "end_sample"
شماره نخستین نمونه‌ای که باید دور ریخته شود.
.PP
گزینه‌های \fBstart\fR، \fBend\fR و \fBduration\fR به صورت مشخصات
مدت زمان بیان می‌شوند؛ به
\fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
.PP
توجه داشته باشید که دو مجموعه نخست گزینه‌های start/end و گزینه \fBduration\fR
به برچسب زمانی فریم نگاه می‌کنند، در حالی که گزینه‌های دارای پسوند _sample صرفاً
نمونه‌هایی را که از فیلتر عبور می‌کنند می‌شمارند. بنابراین start/end_pts و start/end_sample
هنگامی که برچسب‌های زمانی اشتباه یا غیردقیق باشند یا از صفر آغاز نشوند، نتایج
متفاوتی به بار می‌آورند. همچنین توجه داشته باشید که این فیلتر برچسب‌های زمانی را دگرگون
نمی‌سازد. اگر می‌خواهید برچسب‌های زمانی خروجی از صفر شروع شوند، فیلتر asetpts را
پس از فیلتر atrim قرار دهید.
.PP
اگر چندین گزینه شروع یا پایان تنظیم شوند، این فیلتر تلاش می‌کند به صورت حریصانه (greedy)
عمل کرده و تمام نمونه‌هایی را که حداقل با یکی از محدودیت‌های تعیین‌شده تطابق دارند حفظ کند.
جهت نگه‌داری صرفاً بخشی که به طور همزمان با تمامی محدودیت‌ها تطابق دارد، چندین
فیلتر atrim را به هم زنجیره کنید.
.PP
مقادیر پیش‌فرض به گونه‌ای هستند که تمامی ورودی حفظ می‌شود. بنابراین امکان تنظیم
مثلاً صرف مقادیر پایان وجود دارد تا هر آنچه پیش از زمان مشخص‌شده است نگه داشته شود.
.PP
مثال‌ها:
.IP \(bu 4
دور انداختن همه چیز به جز دقیقه دوم ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-af atrim=60:120
.Ve
.IP \(bu 4
نگه‌داشتن صرفاً ۱۰۰۰ نمونه نخست:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-af atrim=end_sample=1000
.Ve
.SS axcorrelate
.IX Subsection "axcorrelate"
محاسبه همبستگی متقابل پنجره‌ای نرمال‌شده میان دو جریان صوتی ورودی.
.PP
نمونه‌های حاصل همواره بین \-1 و 1 (شامل هر دو) هستند.
اگر نتیجه 1 باشد، بدین معناست که دو نمونه ورودی در آن بخش انتخابی به شدت همبسته هستند.
نتیجه 0 به معنای عدم وجود هیچ‌گونه همبستگی میان آنهاست.
اگر نتیجه \-1 باشد، بدین معناست که دو نمونه ورودی ناهم‌فاز هستند، که یعنی یکدیگر را
خنثی می‌کنند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه بخشی که همبستگی متقابل روی آن محاسبه می‌شود.
پیش‌فرض 256 است. محدوده مجاز از 2 تا 131072 است.
.IP \fBalgo\fR 4
.IX Item "algo"
تنظیم الگوریتم همبستگی متقابل. می‌تواند \f(CW\*(C`slow\*(C'\fR یا \f(CW\*(C`fast\*(C'\fR یا \f(CW\*(C`best\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`best\*(C'\fR است. الگوریتم سریع فرض می‌کند مقادیر میانگین روی هر بخش مفروض
همواره صفر هستند و بنابراین به محاسبات بسیار کمتری نیاز دارد.
این فرض به طور کلی صحیح نیست، اما برای جریان‌های صوتی متداول معتبر است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
محاسبه همبستگی میان کانال‌ها در یک جریان صوتی استریو:
.Sp
.Vb 1
\&        ffmpeg \-i stereo.wav \-af channelsplit,axcorrelate=size=1024:algo=fast correlation.wav
.Ve
.SS bandpass
.IX Subsection "bandpass"
اعمال یک فیلتر میان‌گذر دو قطبی باترورث با فرکانس مرکزی
\fIfrequency\fR، و پهنای باند (در نقطه 3dB) width.
گزینه \fIcsg\fR بهره ثابت دامنه جانبی (بهره اوج = Q) را به جای
حالت پیش‌فرض یعنی بهره اوج ثابت 0dB برمی‌گزیند.
افت فیلتر با نرخ 6dB به ازای هر اکتاو (20dB به ازای هر دهه) است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر. پیش‌فرض \f(CW3000\fR است.
.IP \fBcsg\fR 4
.IX Item "csg"
بهره ثابت دامنه جانبی (constant skirt gain) در صورت تنظیم روی 1. پیش‌فرض 0 است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند فیلتر در واحدهای width_type.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌ها جهت فیلترسازی؛ به طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به طور پیش‌فرض غیرفعال است.
فعال‌سازی آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه بسته به فیلترهای جانبی.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از فرمت 16 بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از فرمت 32 بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از فرمت ممیز شناور 32 بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از فرمت ممیز شناور 64 بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار روی مقداری به اندازه کافی
بزرگ تنظیم شود (بزرگتر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر قطع می‌شود)، فیلترسازی
دارای فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد صرفاً آرتیفکت‌های ناخوشایندی ایجاد خواهد کرد.
.Sp
توجه داشته باشید که تاخیر فیلتر هنگام تنظیم روی یک مقدار غیر صفر دقیقاً به اندازه همین تعداد نمونه خواهد بود.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس میان‌گذر.
نحو دستور عبارت است از: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type میان‌گذر.
نحو دستور عبارت است از: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای میان‌گذر.
نحو دستور عبارت است از: "\fIwidth\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر mix میان‌گذر.
نحو دستور عبارت است از: "\fImix\fR"
.SS bandreject
.IX Subsection "bandreject"
اعمال یک فیلتر میان‌ناگذر دو قطبی باترورث با فرکانس مرکزی
\fIfrequency\fR، و پهنای باند (در نقطه 3dB) \fIwidth\fR.
افت فیلتر با نرخ 6dB به ازای هر اکتاو (20dB به ازای هر دهه) است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر. پیش‌فرض \f(CW3000\fR است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند فیلتر در واحدهای width_type.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌ها جهت فیلترسازی؛ به طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به طور پیش‌فرض غیرفعال است.
فعال‌سازی آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه بسته به فیلترهای جانبی.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از فرمت 16 بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از فرمت 32 بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از فرمت ممیز شناور 32 بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از فرمت ممیز شناور 64 بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار روی مقداری به اندازه کافی
بزرگ تنظیم شود (بزرگتر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر قطع می‌شود)، فیلترسازی
دارای فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد صرفاً آرتیفکت‌های ناخوشایندی ایجاد خواهد کرد.
.Sp
توجه داشته باشید که تاخیر فیلتر هنگام تنظیم روی یک مقدار غیر صفر دقیقاً به اندازه همین تعداد نمونه خواهد بود.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس میان‌ناگذر.
نحو دستور عبارت است از: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type میان‌ناگذر.
نحو دستور عبارت است از: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای میان‌ناگذر.
نحو دستور عبارت است از: "\fIwidth\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر mix میان‌ناگذر.
نحو دستور عبارت است از: "\fImix\fR"
.SS "bass, lowshelf"
.IX Subsection "bass, lowshelf"
تقویت یا برش بسامدهای بم (پایین) صدا با بهره‌گیری از یک فیلتر شلوینگ
دو قطبی با پاسخی شبیه به کنترل‌های تن یک سیستم های-فای (hi-fi) استاندارد.
این امر به عنوان اکولایزاسیون شلوینگ (shelving EQ) نیز شناخته می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
ارائه میزان بهره در 0 هرتز. محدوده مفید آن در حدود \-20
(برای یک برش عمیق) تا +20 (برای یک تقویت قوی) است.
هنگام استفاده از بهره مثبت، مراقب پدیده برش سیگنال (clipping) باشید.
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر؛ از این رو می‌توان از آن جهت
گسترش یا کاهش محدوده بسامدی که قرار است تقویت یا برش داده شود استفاده کرد.
مقدار پیش‌فرض \f(CW100\fR هرتز است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین میزان تندی گذار شلف فیلتر.
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم تعداد قطب‌ها. پیش‌فرض 2 است.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌ها جهت فیلترسازی؛ به طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به طور پیش‌فرض غیرفعال است.
فعال‌سازی آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه بسته به فیلترهای جانبی.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از فرمت 16 بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از فرمت 32 بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از فرمت ممیز شناور 32 بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از فرمت ممیز شناور 64 بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار روی مقداری به اندازه کافی
بزرگ تنظیم شود (بزرگتر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر قطع می‌شود)، فیلترسازی
دارای فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد صرفاً آرتیفکت‌های ناخوشایندی ایجاد خواهد کرد.
.Sp
توجه داشته باشید که تاخیر فیلتر هنگام تنظیم روی یک مقدار غیر صفر دقیقاً به اندازه همین تعداد نمونه خواهد بود.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس bass.
نحو دستور عبارت است از: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type گزینه bass.
نحو دستور عبارت است از: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای bass.
نحو دستور عبارت است از: "\fIwidth\fR"
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تغییر بهره bass.
نحو دستور عبارت است از: "\fIgain\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر mix گزینه bass.
نحو دستور عبارت است از: "\fImix\fR"
.SS biquad
.IX Subsection "biquad"
اعمال یک فیلتر IIR بای‌کواد (biquad) با ضرایب داده‌شده.
به طوری که \fIb0\fR، \fIb1\fR، \fIb2\fR و \fIa0\fR، \fIa1\fR، \fIa2\fR
به ترتیب ضرایب صورت و مخرج هستند،
و گزینه‌های \fIchannels\fR و \fIc\fR مشخص می‌کنند کدام کانال‌ها فیلتر شوند؛ به طور
پیش‌فرض تمامی کانال‌های موجود فیلتر می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBa0\fR 4
.IX Item "a0"
.PD 0
.IP \fBa1\fR 4
.IX Item "a1"
.IP \fBa2\fR 4
.IX Item "a2"
.IP \fBb0\fR 4
.IX Item "b0"
.IP \fBb1\fR 4
.IX Item "b1"
.IP \fBb2\fR 4
.IX Item "b2"
.PD
تغییر پارامتر بای‌کواد.
نحو دستور عبارت است از: "\fIvalue\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌ها جهت فیلترسازی؛ به طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به طور پیش‌فرض غیرفعال است.
فعال‌سازی آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت نمونه بسته به فیلترهای جانبی.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از فرمت 16 بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از فرمت 32 بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از فرمت ممیز شناور 32 بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از فرمت ممیز شناور 64 بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار روی مقداری به اندازه کافی
بزرگ تنظیم شود (بزرگتر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر قطع می‌شود)، فیلترسازی
دارای فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد صرفاً آرتیفکت‌های ناخوشایندی ایجاد خواهد کرد.
.Sp
توجه داشته باشید که تاخیر فیلتر هنگام تنظیم روی یک مقدار غیر صفر دقیقاً به اندازه همین تعداد نمونه خواهد بود.
.SS bs2b
.IX Subsection "bs2b"
تبدیل استریو به دوگوشی (binaural) بائر، که گوش دادن به ضبط‌های صوتی استریو را با
هدفون بهبود می‌بخشد.
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libbs2b\*(C'\fR پیکربندی کنید.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBprofile\fR 4
.IX Item "profile"
سطح کراس‌فید (crossfeed) از پیش تعریف‌شده.
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
سطح پیش‌فرض (fcut=700, feed=50).
.IP \fBcmoy\fR 4
.IX Item "cmoy"
مدار چو موی (Chu Moy) با (fcut=700, feed=60).
.IP \fBjmeier\fR 4
.IX Item "jmeier"
مدار یان مایر (Jan Meier) با (fcut=650, feed=95).
.RE
.RS 4
.RE
.IP \fBfcut\fR 4
.IX Item "fcut"
فرکانس قطع (بر حسب Hz).
.IP \fBfeed\fR 4
.IX Item "feed"
سطح تغذیه فید (بر حسب Hz).
.SS channelmap
.IX Subsection "channelmap"
نگاشت مجدد کانال‌های ورودی به مکان‌های جدید.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBmap\fR 4
.IX Item "map"
نگاشت کانال‌ها از ورودی به خروجی. شناسه فهرستی جداشده با \*(Aq|\*(Aq از نگاشت‌ها است،
که هر یک به شکل \f(CW\*(C`\fR\f(CIin_channel\fR\f(CW\-\fR\f(CIout_channel\fR\f(CW\*(C'\fR یا
\&\f(CW\*(C`\fR\f(CIin_channel\fR\f(CW\*(C'\fR هستند. \fIin_channel\fR می‌تواند نام
کانال ورودی (مانند FL برای چپ جلو) یا شاخص آن در چینش کانال ورودی باشد.
\fIout_channel\fR نام کانال خروجی یا شاخص آن در چینش کانال خروجی است.
اگر \fIout_channel\fR داده نشود، به‌طور ضمنی یک شاخص است که از صفر شروع شده و برای هر
نگاشت یکی افزایش می‌یابد. ترکیب انواع مختلف نگاشت مجاز نیست و منجر به خطای تجزیه می‌شود.
.IP \fBchannel_layout\fR 4
.IX Item "channel_layout"
چینش کانال جریان خروجی. اگر مشخص نشود، فیلتر آن را بر اساس نام‌های \fIout_channel\fR
یا تعداد نگاشت‌ها حدس می‌زند. چینش‌های حدس‌زده‌شده لزوماً شامل کانال‌ها به ترتیب نگاشت‌ها
نخواهند بود.
.PP
اگر هیچ نگاشتی وجود نداشته باشد، فیلتر به‌طور ضمنی کانال‌های ورودی را با حفظ شاخص‌ها
به کانال‌های خروجی نگاشت می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای مثال، با فرض یک پروندهٔ MOV ورودی با صدای 5.1+downmix:
.Sp
.Vb 1
\&        ffmpeg \-i in.mov \-filter \*(Aqchannelmap=map=DL\-FL|DR\-FR\*(Aq out.wav
.Ve
.Sp
یک پروندهٔ WAV خروجی با برچسب استریو از کانال‌های downmix ورودی ایجاد می‌کند.
.IP \(bu 4
برای اصلاح یک پروندهٔ WAV 5.1 که به اشتباه با ترتیب کانال بومی AAC کدگذاری شده است:
.Sp
.Vb 1
\&        ffmpeg \-i in.wav \-filter \*(Aqchannelmap=1|2|0|5|3|4:5.1\*(Aq out.wav
.Ve
.SS channelsplit
.IX Subsection "channelsplit"
تفکیک هر کانال از یک جریان صوتی ورودی به یک جریان خروجی جداگانه.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBchannel_layout\fR 4
.IX Item "channel_layout"
چینش کانال جریان ورودی. پیش‌فرض "stereo" است.
.IP \fBchannels\fR 4
.IX Item "channels"
یک چینش کانال که کانال‌های استخراج‌شونده به عنوان جریان‌های خروجی جداگانه را توصیف
می‌کند یا "all" برای استخراج هر کانال ورودی به عنوان یک جریان جداگانه. پیش‌فرض "all" است.
.Sp
انتخاب کانال‌هایی که در چینش کانال ورودی وجود ندارند منجر به خطا خواهد شد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای مثال، با فرض یک پروندهٔ MP3 استریوی ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i in.mp3 \-filter_complex channelsplit out.mkv
.Ve
.Sp
یک پروندهٔ خروجی ماتروشکا با دو جریان صوتی ایجاد می‌کند، یکی حاوی فقط کانال چپ
و دیگری کانال راست.
.IP \(bu 4
تفکیک یک پروندهٔ WAV 5.1 به پرونده‌های جداگانه به‌ازای هر کانال:
.Sp
.Vb 5
\&        ffmpeg \-i in.wav \-filter_complex
\&        \*(Aqchannelsplit=channel_layout=5.1[FL][FR][FC][LFE][SL][SR]\*(Aq
\&        \-map \*(Aq[FL]\*(Aq front_left.wav \-map \*(Aq[FR]\*(Aq front_right.wav \-map \*(Aq[FC]\*(Aq
\&        front_center.wav \-map \*(Aq[LFE]\*(Aq lfe.wav \-map \*(Aq[SL]\*(Aq side_left.wav \-map \*(Aq[SR]\*(Aq
\&        side_right.wav
.Ve
.IP \(bu 4
استخراج فقط LFE از یک پروندهٔ WAV 5.1:
.Sp
.Vb 2
\&        ffmpeg \-i in.wav \-filter_complex \*(Aqchannelsplit=channel_layout=5.1:channels=LFE[LFE]\*(Aq
\&        \-map \*(Aq[LFE]\*(Aq lfe.wav
.Ve
.SS chorus
.IX Subsection "chorus"
افزودن جلوهٔ کُر (chorus) به صدا.
.PP
می‌تواند صدای یک خواننده را شبیه به گروه همسرایان کند، اما می‌تواند بر روی سازها نیز اعمال شود.
.PP
کُر شبیه به یک جلوهٔ پژواک (echo) با تأخیر کوتاه است، اما در حالی که با پژواک تأخیر
ثابت است، با کُر این تأخیر با مدولاسیون سینوسی یا مثلثی تغییر می‌کند.
عمق مدولاسیون محدوده‌ای را تعیین می‌کند که تأخیر مدوله‌شده قبل یا بعد از تأخیر پخش
می‌شود. از این رو صدای با تأخیر کندتر یا تندتر به نظر می‌رسد، یعنی صدای تأخیریافته حول
صدای اصلی کوک می‌شود، درست مانند یک گروه کُر که در آن برخی صداها کمی خارج از کوک (off-key) هستند.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBin_gain\fR 4
.IX Item "in_gain"
تنظیم بهرهٔ ورودی. پیش‌فرض 0.4 است.
.IP \fBout_gain\fR 4
.IX Item "out_gain"
تنظیم بهرهٔ خروجی. پیش‌فرض 0.4 است.
.IP \fBdelays\fR 4
.IX Item "delays"
تنظیم تأخیرها. یک تأخیر معمولی حدود 40ms تا 60ms است.
.IP \fBdecays\fR 4
.IX Item "decays"
تنظیم کاهش‌ها (decays).
.IP \fBspeeds\fR 4
.IX Item "speeds"
تنظیم سرعت‌ها.
.IP \fBdepths\fR 4
.IX Item "depths"
تنظیم عمق‌ها.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
یک تأخیر منفرد:
.Sp
.Vb 1
\&        chorus=0.7:0.9:55:0.4:0.25:2
.Ve
.IP \(bu 4
دو تأخیر:
.Sp
.Vb 1
\&        chorus=0.6:0.9:50|60:0.4|0.32:0.25|0.4:2|1.3
.Ve
.IP \(bu 4
صدای کُر کامل‌تر با سه تأخیر:
.Sp
.Vb 1
\&        chorus=0.5:0.9:50|60|40:0.4|0.32|0.3:0.25|0.4|0.3:2|2.3|1.3
.Ve
.SS compand
.IX Subsection "compand"
فشرده‌سازی (compress) یا گسترش (expand) محدودهٔ دینامیکی صدا.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBattacks\fR 4
.IX Item "attacks"
.PD 0
.IP \fBdecays\fR 4
.IX Item "decays"
.PD
فهرستی از زمان‌ها بر حسب ثانیه برای هر کانال که در طول آن سطح لحظه‌ای سیگنال ورودی
برای تعیین حجم صدای آن میانگین‌گیری می‌شود. \fIattacks\fR به افزایش حجم صدا و
\fIdecays\fR به کاهش حجم صدا اشاره دارد. در اکثر موقعیت‌ها، زمان حمله (پاسخ به بلندتر شدن صدا)
باید کوتاه‌تر از زمان کاهش باشد، زیرا گوش انسان به صدای بلند ناگهانی حساس‌تر از صدای
آرام ناگهانی است. مقدار معمول برای حمله 0.3 ثانیه و برای کاهش 0.8 ثانیه است.
اگر تعداد حملات و کاهش‌های مشخص‌شده کمتر از تعداد کانال‌ها باشد، آخرین حمله/کاهش تنظیم‌شده
برای تمامی کانال‌های باقی‌مانده استفاده خواهد شد.
.IP \fBpoints\fR 4
.IX Item "points"
فهرستی از نقاط برای تابع انتقال، مشخص‌شده بر حسب dB نسبت به حداکثر دامنهٔ سیگنال ممکن.
هر فهرست نقاط کلیدی باید با دستور زبان زیر تعریف شود: \f(CW\*(C`x0/y0|x1/y1|x2/y2|....\*(C'\fR یا
\&\f(CW\*(C`x0/y0 x1/y1 x2/y2 ....\*(C'\fR
.Sp
مقادیر ورودی باید کاملاً صعودی باشند اما تابع انتقال لزوماً نباید یکنواخت صعودی باشد.
نقطهٔ \f(CW\*(C`0/0\*(C'\fR فرض می‌شود اما ممکن است بازنویسی شود (با \f(CW\*(C`0/out\-dBn\*(C'\fR).
مقادیر معمول برای تابع انتقال عبارتند از \f(CW\*(C`\-70/\-70|\-60/\-20|1/0\*(C'\fR.
.IP \fBsoft\-knee\fR 4
.IX Item "soft-knee"
تنظیم شعاع منحنی بر حسب dB برای تمام اتصالات. پیش‌فرض 0.01 است.
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم بهرهٔ اضافی بر حسب dB برای اعمال در تمام نقاط تابع انتقال. این امکان تنظیم
آسان بهرهٔ کلی را فراهم می‌سازد. پیش‌فرض 0 است.
.IP \fBvolume\fR 4
.IX Item "volume"
تنظیم حجم صدای اولیه، بر حسب dB، که هنگام شروع فیلترسازی برای هر کانال فرض می‌شود.
این به کاربر اجازه می‌دهد سطح اسمی را در ابتدا تعیین کند، تا مثلاً بهرهٔ بسیار بزرگی
پیش از شروع به کار فیلتر compand به سطوح اولیهٔ سیگنال اعمال نشود. مقدار معمول برای صدایی
که در ابتدا آرام است \-90 dB می‌باشد. پیش‌فرض 0 است.
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم تأخیر بر حسب ثانیه. صدای ورودی بلافاصله تحلیل می‌شود، اما صدا پیش از ارسال به
تنظیم‌کنندهٔ حجم صدا دچار تأخیر می‌شود. مشخص کردن تأخیری تقریباً برابر با زمان‌های حمله/کاهش
به فیلتر امکان می‌دهد که به جای حالت واکنشی، به‌طور مؤثر در حالت پیش‌بینانه عمل کند.
پیش‌فرض 0 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مناسب‌سازی موسیقی دارای بخش‌های آرام و بلند برای گوش دادن در محیطی پر سر و صدا:
.Sp
.Vb 1
\&        compand=.3|.3:1|1:\-90/\-60|\-60/\-40|\-40/\-30|\-20/\-20:6:0:\-90:0.2
.Ve
.Sp
مثالی دیگر برای صدایی با بخش‌های نجوا و انفجار:
.Sp
.Vb 1
\&        compand=0|0:1|1:\-90/\-900|\-70/\-70|\-30/\-9|0/\-3:6:0:0:0
.Ve
.IP \(bu 4
یک نویز گیت برای زمانی که نویز در سطحی پایین‌تر از سیگنال است:
.Sp
.Vb 1
\&        compand=.1|.1:.2|.2:\-900/\-900|\-50.1/\-900|\-50/\-50:.01:0:\-90:.1
.Ve
.IP \(bu 4
نویز گیت دیگری، این بار برای زمانی که نویز در سطحی بالاتر از سیگنال است (که آن را از جهاتی شبیه اسکوالچ می‌کند):
.Sp
.Vb 1
\&        compand=.1|.1:.1|.1:\-45.1/\-45.1|\-45/\-900|0/\-900:.01:45:\-90:.1
.Ve
.IP \(bu 4
فشرده‌سازی 2:1 با شروع از \-6dB:
.Sp
.Vb 1
\&        compand=points=\-80/\-80|\-6/\-6|0/\-3.8|20/3.5
.Ve
.IP \(bu 4
فشرده‌سازی 2:1 با شروع از \-9dB:
.Sp
.Vb 1
\&        compand=points=\-80/\-80|\-9/\-9|0/\-5.3|20/2.9
.Ve
.IP \(bu 4
فشرده‌سازی 2:1 با شروع از \-12dB:
.Sp
.Vb 1
\&        compand=points=\-80/\-80|\-12/\-12|0/\-6.8|20/1.9
.Ve
.IP \(bu 4
فشرده‌سازی 2:1 با شروع از \-18dB:
.Sp
.Vb 1
\&        compand=points=\-80/\-80|\-18/\-18|0/\-9.8|20/0.7
.Ve
.IP \(bu 4
فشرده‌سازی 3:1 با شروع از \-15dB:
.Sp
.Vb 1
\&        compand=points=\-80/\-80|\-15/\-15|0/\-10.8|20/\-5.2
.Ve
.IP \(bu 4
کمپرسور/گیت:
.Sp
.Vb 1
\&        compand=points=\-80/\-105|\-62/\-80|\-15.4/\-15.4|0/\-12|20/\-7.6
.Ve
.IP \(bu 4
اکسپندر (گسترش‌دهنده):
.Sp
.Vb 1
\&        compand=attacks=0:points=\-80/\-169|\-54/\-80|\-49.5/\-64.6|\-41.1/\-41.1|\-25.8/\-15|\-10.8/\-4.5|0/0|20/8.3
.Ve
.IP \(bu 4
محدودکنندهٔ سخت (hard limiter) در \-6dB:
.Sp
.Vb 1
\&        compand=attacks=0:points=\-80/\-80|\-6/\-6|20/\-6
.Ve
.IP \(bu 4
محدودکنندهٔ سخت در \-12dB:
.Sp
.Vb 1
\&        compand=attacks=0:points=\-80/\-80|\-12/\-12|20/\-12
.Ve
.IP \(bu 4
نویز گیت سخت در \-35 dB:
.Sp
.Vb 1
\&        compand=attacks=0:points=\-80/\-115|\-35.1/\-80|\-35/\-35|20/20
.Ve
.IP \(bu 4
محدودکنندهٔ نرم (soft limiter):
.Sp
.Vb 1
\&        compand=attacks=0:points=\-80/\-80|\-12.4/\-12.4|\-6/\-8|0/\-6.8|20/\-2.8
.Ve
.SS compensationdelay
.IX Subsection "compensationdelay"
خط تأخیر جبرانی (Compensation Delay Line) یک تأخیر متریک‌محور برای جبران موقعیت‌های
متفاوت میکروفون‌ها یا بلندگوها است.
.PP
برای مثال، شما صدای گیتار را با دو میکروفون قرارگرفته در مکان‌های مختلف ضبط کرده‌اید.
از آنجا که جبههٔ موج صوتی در شرایط عادی سرعت ثابتی دارد، فازبندی میکروفون‌ها می‌تواند
متغیر بوده و به مکان و موقعیت نسبی آن‌ها بستگی دارد. بهترین میکس صوتی زمانی حاصل می‌شود
که این میکروفون‌ها هم‌فاز (همگام) باشند. توجه داشته باشید که فاصلهٔ حدود ۳۰ سانتی‌متر
بین میکروفون‌ها باعث می‌شود یکی از میکروفون‌ها سیگنال را در فاز مخالف (antiphase)
نسبت به میکروفون دیگر دریافت کند. این امر باعث کدر و گرفته شدن میکس نهایی می‌شود.
این فیلتر با افزودن تأخیرهای مختلف به هر ترک میکروفون و همگام ساختن آن‌ها به حل مشکلات
فاز کمک می‌کند.
.PP
بهترین نتیجه زمانی حاصل می‌شود که یک ترک را به عنوان مبنا قرار دهید و سایر ترک‌ها را
یکی‌یکی با آن همگام کنید.
به یاد داشته باشید که تلورانس همگام‌سازی/تأخیر به نرخ نمونه‌برداری نیز بستگی دارد.
نرخ‌های نمونه‌برداری بالاتر تلورانس بیشتری را فراهم می‌کنند.
.PP
فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmm\fR 4
.IX Item "mm"
تنظیم فاصله به میلی‌متر. این فاصلهٔ جبرانی برای تنظیم دقیق است. پیش‌فرض 0 است.
.IP \fBcm\fR 4
.IX Item "cm"
تنظیم فاصله به سانتی‌متر. این فاصلهٔ جبرانی برای محکم‌تر کردن تنظیم فاصله است. پیش‌فرض 0 است.
.IP \fBm\fR 4
.IX Item "m"
تنظیم فاصله به متر. این فاصلهٔ جبرانی برای تنظیم کلی فاصله است. پیش‌فرض 0 است.
.IP \fBdry\fR 4
.IX Item "dry"
تنظیم مقدار خشک. مقدار سیگنال پردازش‌نشده (خشک). پیش‌فرض 0 است.
.IP \fBwet\fR 4
.IX Item "wet"
تنظیم مقدار خیس. مقدار سیگنال پردازش‌شده (خیس). پیش‌فرض 1 است.
.IP \fBtemp\fR 4
.IX Item "temp"
تنظیم دما بر حسب درجه سلسیوس. این دمای محیط است. پیش‌فرض 20 است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS crossfeed
.IX Subsection "crossfeed"
اعمال فیلتر کراس‌فید (crossfeed) هدفون.
.PP
کراس‌فید فرایند ترکیب کانال‌های چپ و راست یک ضبط صوتی استریو است.
این فیلتر عمدتاً برای کاهش تفکیک شدید استریو در فرکانس‌های پایین استفاده می‌شود.
.PP
هدف از این کار تولید صدایی شبیه‌تر به بلندگو برای شنونده است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstrength\fR 4
.IX Item "strength"
تنظیم شدت کراس‌فید. پیش‌فرض 0.2 است. محدودهٔ مجاز از 0 تا 1 است.
این گزینه بهرهٔ فیلتر low-shelf را برای بخش جانبی تصویر استریو تنظیم می‌کند.
پیش‌فرض \-6dB است. حداکثر مقدار مجاز با تنظیم شدت روی 1 برابر \-30db است.
.IP \fBrange\fR 4
.IX Item "range"
تنظیم وسعت صحنهٔ صوتی (soundstage). پیش‌فرض 0.5 است. محدودهٔ مجاز از 0 تا 1 است.
این گزینه فرکانس قطع فیلتر low-shelf را تنظیم می‌کند. پیش‌فرض قطع نزدیک به 1550 Hz است.
با تنظیم range بر روی 1 فرکانس قطع بر روی 2100 Hz تنظیم می‌شود.
.IP \fBslope\fR 4
.IX Item "slope"
تنظیم شیب منحنی فیلتر low-shelf. پیش‌فرض 0.5 است. محدودهٔ مجاز از 0.01 تا 1 است.
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهرهٔ ورودی. پیش‌فرض 0.9 است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم بهرهٔ خروجی. پیش‌فرض 1 است.
.IP \fBblock_size\fR 4
.IX Item "block_size"
تنظیم اندازهٔ بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار به اندازهٔ کافی
بزرگ تنظیم شود (بزرگ‌تر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر کوتاه می‌شود)
فیلترسازی فاز خطی خواهد شد، در غیر این صورت اگر به اندازه کافی بزرگ نباشد فقط مصنوعات
صوتی نامطلوب تولید می‌کند.
.Sp
توجه داشته باشید که تأخیر فیلتر هنگام تنظیم به یک مقدار غیر صفر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS crystalizer
.IX Subsection "crystalizer"
الگوریتمی ساده برای شفاف‌سازی و تیز کردن نویز/سیگنال صوتی.
.PP
این فیلتر تفاوت‌های بین هر نمونهٔ صوتی را به صورت خطی افزایش می‌دهد.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBi\fR 4
.IX Item "i"
تنظیم شدت جلوه (پیش‌فرض: 2.0). باید در محدوده بین \-10.0 تا 0 (صدای بدون تغییر)
تا 10.0 (حداکثر جلوه) باشد. برای معکوس کردن فیلترسازی از مقدار منفی استفاده کنید.
.IP \fBc\fR 4
.IX Item "c"
فعال‌سازی برش (clipping). به‌طور پیش‌فرض فعال است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS dcshift
.IX Subsection "dcshift"
اعمال یک شیفت DC به صدا.
.PP
این گزینه می‌تواند برای حذف یک آفست DC (که شاید ناشی از یک مشکل سخت‌افزاری در زنجیرهٔ
ضبط باشد) از صدا مفید باشد. اثر آفست DC کاهش هدروم (headroom) و در نتیجه کاهش حجم صدا است.
فیلتر \fBastats\fR می‌تواند برای تعیین اینکه آیا یک سیگنال آفست DC دارد یا خیر استفاده شود.
.IP \fBshift\fR 4
.IX Item "shift"
تنظیم شیفت DC، محدودهٔ مجاز [\-1, 1] است. این گزینه میزان شیفت صدا را نشان می‌دهد.
.IP \fBlimitergain\fR 4
.IX Item "limitergain"
اختیاری. باید مقداری بسیار کمتر از 1 داشته باشد (مثلاً 0.05 یا 0.02) و برای جلوگیری از
برش (clipping) استفاده می‌شود.
.SS deesser
.IX Subsection "deesser"
اعمال دی‌اسر (de-essing) بر روی نمونه‌های صوتی.
.IP \fBi\fR 4
.IX Item "i"
تنظیم شدت برای راه‌اندازی de-essing. محدودهٔ مجاز از 0 تا 1 است. پیش‌فرض 0 است.
.IP \fBm\fR 4
.IX Item "m"
تنظیم میزان داکینگ (کاهش سطح) روی بخش زیر (treble) صدا. محدودهٔ مجاز از 0 تا 1 است.
پیش‌فرض 0.5 است.
.IP \fBf\fR 4
.IX Item "f"
میزان محتوای فرکانسی اصلی که باید هنگام de-essing حفظ شود. محدودهٔ مجاز از 0 تا 1 است.
پیش‌فرض 0.5 است.
.IP \fBs\fR 4
.IX Item "s"
تنظیم حالت خروجی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBi\fR 4
.IX Item "i"
عبور ورودی بدون تغییر.
.IP \fBo\fR 4
.IX Item "o"
عبور صدای فیلترشده با حذف حروف سفیری (ess).
.IP \fBe\fR 4
.IX Item "e"
عبور فقط حروف سفیری (ess).
.Sp
مقدار پیش‌فرض \fIo\fR است.
.RE
.RS 4
.RE
.SS dialoguenhance
.IX Subsection "dialoguenhance"
تقویت دیالوگ و مکالمه در صدای استریو.
.PP
این فیلتر ورودی استریو را می‌پذیرد و خروجی کانال‌های فراگیر (surround 3.0) تولید می‌کند.
کانال سنتر جلو (front center) تازه تولیدشده دارای دیالوگ گفتاری تقویت‌شده است که در اصل
در هر دو کانال استریو موجود بود.
این فیلتر کانال‌های چپ جلو و راست جلو را همانند ورودی استریو در خروجی قرار می‌دهد.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBoriginal\fR 4
.IX Item "original"
تنظیم ضریب سنتر اصلی برای نگه‌داری در خروجی کانال سنتر جلو. محدودهٔ مجاز از 0 تا 1 است.
مقدار پیش‌فرض 1 است.
.IP \fBenhance\fR 4
.IX Item "enhance"
تنظیم ضریب تقویت دیالوگ برای اعمال در خروجی کانال سنتر جلو. محدودهٔ مجاز از 0 تا 3 است.
مقدار پیش‌فرض 1 است.
.IP \fBvoice\fR 4
.IX Item "voice"
تنظیم ضریب تشخیص صدا (voice). محدودهٔ مجاز از 2 تا 32 است. مقدار پیش‌فرض 2 است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS drmeter
.IX Subsection "drmeter"
اندازه‌گیری محدودهٔ دینامیکی صدا (DR).
.PP
مقادیر DR برابر 14 و بالاتر در محتوای بسیار پویا یافت می‌شود. مقادیر DR بین 8 تا 13
در محتوای گذرا یافت می‌شود. و هر مقدار کمتر از 8 پویایی بسیار ضعیفی داشته و بسیار فشرده است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlength\fR 4
.IX Item "length"
تنظیم طول پنجره بر حسب ثانیه که برای تقسیم صدا به قطعاتی با طول مساوی استفاده می‌شود.
پیش‌فرض 3 ثانیه است.
.SS dynaudnorm
.IX Subsection "dynaudnorm"
نرمال‌ساز پویای صدا (Dynamic Audio Normalizer).
.PP
این فیلتر مقدار مشخصی بهره (gain) را به صدای ورودی اعمال می‌کند تا دامنهٔ اوج
(peak magnitude) آن را به یک سطح هدف (مانند 0 dBFS) برساند. با این حال، برخلاف
الگوریتم‌های نرمال‌سازی «ساده‌تر»، نرمال‌ساز پویای صدا ضریب بهره را *به‌طور پویا*
برای صدای ورودی دوباره تنظیم می‌کند. این امر امکان اعمال بهرهٔ اضافی را به بخش‌های
«آرام» صدا فراهم می‌آورد و در عین حال از اعوجاج یا برش (clipping) در بخش‌های «بلند»
جلوگیری می‌کند. به عبارت دیگر: نرمال‌ساز پویای صدا حجم صدای بخش‌های آرام و بلند را
«یکدست» می‌کند، به این معنا که حجم صدای هر بخش به همان سطح هدف رسانده می‌شود.
با این حال توجه داشته باشید که نرمال‌ساز پویای صدا این هدف را *بدون* اعمال
«فشرده‌سازی محدودهٔ دینامیکی» محقق می‌سازد. این فیلتر ۱۰۰٪ محدودهٔ دینامیکی را
*درون* هر بخش از پروندهٔ صوتی حفظ خواهد کرد.
.IP "\fBframelen, f\fR" 4
.IX Item "framelen, f"
تنظیم طول فریم بر حسب میلی‌ثانیه. در محدودهٔ 10 تا 8000 میلی‌ثانیه. پیش‌فرض 500 میلی‌ثانیه است.
نرمال‌ساز پویای صدا صدای ورودی را در قطعات کوچک، موسوم به فریم، پردازش می‌کند.
این امر ضروری است زیرا دامنهٔ اوج برای صرفاً یک مقدار نمونه بی‌معنی است. در عوض، ما باید
دامنهٔ اوج را برای یک توالی پیوسته از مقادیر نمونه تعیین کنیم. در حالی که یک نرمال‌ساز
«استاندارد» صرفاً از دامنهٔ اوج کل پرونده استفاده می‌کند، نرمال‌ساز پویای صدا دامنهٔ اوج
را به صورت جداگانه برای هر فریم تعیین می‌نماید. طول فریم بر حسب میلی‌ثانیه مشخص می‌شود.
به‌طور پیش‌فرض، نرمال‌ساز پویای صدا از طول فریم 500 میلی‌ثانیه استفاده می‌کند که مشخص شده
است نتایج خوبی را در اکثر پرونده‌ها ارائه می‌دهد.
توجه داشته باشید که طول دقیق فریم، بر حسب تعداد نمونه‌ها، به‌طور خودکار بر اساس نرخ
نمونه‌برداری پروندهٔ صوتی ورودی مشخص خواهد شد.
.IP "\fBgausssize, g\fR" 4
.IX Item "gausssize, g"
تنظیم اندازهٔ پنجرهٔ فیلتر گاوسی. در محدودهٔ 3 تا 301، باید یک عدد فرد باشد. پیش‌فرض 31 است.
احتمالاً مهم‌ترین پارامتر نرمال‌ساز پویای صدا، \f(CW\*(C`اندازهٔ پنجره\*(C'\fR فیلتر
هموارساز گاوسی است. اندازهٔ پنجرهٔ فیلتر بر حسب فریم، با مرکزیت فریم فعلی مشخص می‌شود.
برای سادگی، این مقدار باید عددی فرد باشد. در نتیجه، مقدار پیش‌فرض 31 فریم فعلی و همچنین
15 فریم قبلی و 15 فریم بعدی را در نظر می‌گیرد. استفاده از یک پنجرهٔ بزرگ‌تر منجر به جلوهٔ
هموارسازی قوی‌تر و بنابراین تغییرات بهرهٔ کمتر، یعنی انطباق کندتر بهره می‌شود. برعکس،
استفاده از یک پنجرهٔ کوچک‌تر منجر به جلوهٔ هموارسازی ضعیف‌تر و در نتیجه تغییرات بهرهٔ بیشتر،
یعنی انطباق سریع‌تر بهره می‌گردد.
به عبارت دیگر، هر چه این مقدار را افزایش دهید، نرمال‌ساز پویای صدا بیشتر مانند یک فیلتر
نرمال‌سازی «سنتی» رفتار خواهد کرد. برعکس، هر چه این مقدار را کاهش دهید، نرمال‌ساز پویای
صدا بیشتر شبیه به یک کمپرسور محدودهٔ دینامیکی عمل خواهد کرد.
.IP "\fBpeak, p\fR" 4
.IX Item "peak, p"
تنظیم مقدار اوج هدف. این گزینه بالاترین سطح دامنهٔ مجاز را برای ورودی صوتی نرمال‌شده
مشخص می‌کند. این فیلتر تلاش می‌کند تا حد ممکن به دامنهٔ اوج هدف نزدیک شود، اما در عین حال
اطمینان حاصل می‌کند که سیگنال نرمال‌شده هرگز از دامنهٔ اوج فراتر نرود. حداکثر ضریب بهرهٔ
محلی یک فریم مستقیماً توسط دامنهٔ اوج هدف تعیین می‌شود. مقدار پیش‌فرض 0.95 است و در نتیجه
یک هدروم ۵٪ به جا می‌گذارد. فراتر رفتن از این مقدار توصیه نمی‌شود.
.IP "\fBmaxgain, m\fR" 4
.IX Item "maxgain, m"
تنظیم حداکثر ضریب بهره. در محدودهٔ 1.0 تا 100.0. پیش‌فرض 10.0 است.
نرمال‌ساز پویای صدا حداکثر ضریب بهرهٔ ممکن (محلی) را برای هر فریم ورودی تعیین می‌کند،
یعنی حداکثر ضریب بهره‌ای که منجر به برش (clipping) یا اعوجاج نشود. حداکثر ضریب بهره
توسط بالاترین دامنهٔ نمونه در آن فریم تعیین می‌شود. با این حال، نرمال‌ساز پویای صدا
حداکثر ضریب بهرهٔ فریم را علاوه بر این توسط یک حداکثر ضریب بهرهٔ از پیش تعیین‌شده
(سراسری) محدود می‌کند. این کار به منظور جلوگیری از ضرایب بهرهٔ بیش از حد در فریم‌های
«ساکت» یا تقریباً ساکت انجام می‌شود. به‌طور پیش‌فرض، حداکثر ضریب بهره 10.0 است. برای
اکثر ورودی‌ها مقدار پیش‌فرض باید کافی باشد و معمولاً افزایش این مقدار توصیه نمی‌شود.
هرچند، برای ورودی‌هایی با حجم صدای کلی بسیار پایین، ممکن است مجاز دانستن ضرایب بهرهٔ
حتی بالاتر ضروری باشد. با این حال توجه داشته باشید که نرمال‌ساز پویای صدا صرفاً یک
آستانهٔ «سخت» اعمال نمی‌کند (یعنی بریدن مقادیر بالای آستانه). در عوض، یک تابع آستانهٔ
«سیگموئید» اعمال خواهد شد. به این ترتیب، ضرایب بهره به‌طور نرم به مقدار آستانه نزدیک
می‌شوند، اما هرگز از آن فراتر نخواهند رفت.
.IP "\fBtargetrms, r\fR" 4
.IX Item "targetrms, r"
تنظیم RMS هدف. در محدودهٔ 0.0 تا 1.0. پیش‌فرض 0.0 \- غیرفعال است.
به‌طور پیش‌فرض، نرمال‌ساز پویای صدا نرمال‌سازی «اوج» (peak) را انجام می‌دهد. این بدان
معناست که حداکثر ضریب بهرهٔ محلی برای هر فریم (صرفاً) توسط نمونه با بالاترین دامنه در آن
فریم تعریف می‌شود. به این ترتیب، نمونه‌ها می‌توانند بدون فراتر رفتن از حداکثر سطح سیگنال،
یعنی بدون برش، تا حد امکان تقویت شوند. با این حال، به صورت اختیاری، نرمال‌ساز پویای صدا
می‌تواند جذر میانگین مربعات فریم، با کوته‌نوشت RMS را نیز در نظر بگیرد. در مهندسی برق،
RMS معمولاً برای تعیین توان یک سیگنال متغیر با زمان استفاده می‌شود. بنابراین در نظر گرفته
می‌شود که RMS تقریب بهتری از «بلندی صدای ادراک‌شده» نسبت به صرفاً بررسی دامنهٔ اوج سیگنال است.
در نتیجه، با تنظیم تمام فریم‌ها روی یک مقدار RMS ثابت، می‌توان یک «بلندی صدای ادراک‌شدهٔ»
یکنواخت برقرار کرد. اگر یک مقدار RMS هدف مشخص شده باشد، ضریب بهرهٔ محلی یک فریم به عنوان
ضریبی تعریف می‌شود که دقیقاً به همان مقدار RMS منجر گردد. با این حال توجه داشته باشید که
حداکثر ضریب بهرهٔ محلی همچنان توسط نمونه با بالاترین دامنه در فریم محدود می‌شود تا از
برش جلوگیری شود.
.IP "\fBcoupling, n\fR" 4
.IX Item "coupling, n"
فعال‌سازی کوپلینگ (اتصال متقابل) کانال‌ها. به‌طور پیش‌فرض فعال است.
به‌طور پیش‌فرض، نرمال‌ساز پویای صدا تمام کانال‌ها را به یک اندازه تقویت می‌کند. این بدان
معناست که ضریب بهرهٔ یکسانی به تمام کانال‌ها اعمال خواهد شد، یعنی حداکثر ضریب بهرهٔ ممکن
توسط «بلندترین» کانال تعیین می‌شود. با این حال، در برخی ضبط‌ها ممکن است حجم صدای
کانال‌های مختلف ناهمگون باشد، مثلاً یک کانال «آرام‌تر» از کانال(های) دیگر باشد. در این
حالت، می‌توان از این گزینه برای غیرفعال کردن کوپلینگ کانال‌ها استفاده کرد. به این ترتیب،
ضریب بهره به‌طور مستقل برای هر کانال و فقط بر اساس بالاترین دامنهٔ نمونه در همان کانال
تعیین خواهد شد. این ویژگی امکان هماهنگ‌سازی حجم صدای کانال‌های مختلف را فراهم می‌کند.
.IP "\fBcorrectdc, c\fR" 4
.IX Item "correctdc, c"
فعال‌سازی تصحیح بایاس DC (آفست DC). به‌طور پیش‌فرض غیرفعال است.
یک سیگنال صوتی (در حوزهٔ زمان) توالی‌ای از مقادیر نمونه است. در نرمال‌ساز پویای صدا این
مقادیر نمونه، بدون در نظر گرفتن قالب ورودی اصلی، در محدودهٔ \-1.0 تا 1.0 نشان داده می‌شوند.
به‌طور معمول، سیگنال صوتی، یا «شکل موج»، باید حول نقطهٔ صفر متمرکز باشد. این بدان معناست
که اگر میانگین تمام نمونه‌ها در یک پرونده یا در یک فریم منفرد را محاسبه کنیم، نتیجه باید
0.0 یا حداقل بسیار نزدیک به آن مقدار باشد. با این حال، اگر انحراف قابل توجهی در مقدار
میانگین از 0.0، در جهت مثبت یا منفی وجود داشته باشد، به عنوان بایاس DC یا آفست DC شناخته
می‌شود. از آنجا که بایاس DC مسلماً نامطلوب است، نرمال‌ساز پویای صدا تصحیح اختیاری بایاس DC
را ارائه می‌دهد.
با فعال بودن تصحیح بایاس DC، نرمال‌ساز پویای صدا مقدار میانگین یا آفست «تصحیح DC» را برای
هر فریم ورودی تعیین کرده و آن مقدار را از تمام مقادیر نمونه‌های فریم تفریق می‌کند که
تضمین می‌نماید آن نمونه‌ها دوباره حول 0.0 متمرکز شوند. همچنین، به منظور جلوگیری از «شکاف‌ها»
در مرزهای فریم، مقادیر آفست تصحیح DC به‌طور نرم بین فریم‌های همسایه درون‌یابی خواهند شد.
.IP "\fBaltboundary, b\fR" 4
.IX Item "altboundary, b"
فعال‌سازی حالت مرزی جایگزین. به‌طور پیش‌فرض غیرفعال است.
نرمال‌ساز پویای صدا همسایگی مشخصی را در اطراف هر فریم در نظر می‌گیرد. این شامل فریم‌های
قبلی و همچنین فریم‌های بعدی می‌شود. با این حال، برای فریم‌های «مرزی» که در ابتدای آغازین
و در انتهای پایانی پروندهٔ صوتی قرار دارند، تمام فریم‌های همسایه در دسترس نیستند. به ویژه،
برای چند فریم اول در پروندهٔ صوتی، فریم‌های قبلی شناخته‌شده نیستند. و به همین ترتیب، برای
چند فریم آخر در پروندهٔ صوتی، فریم‌های بعدی شناخته‌شده نیستند. بنابراین، این پرسش مطرح
می‌شود که چه ضرایب بهره‌ای باید برای فریم‌های ناموجود در ناحیهٔ «مرزی» فرض شود. نرمال‌ساز
پویای صدا دو حالت را برای رسیدگی به این وضعیت پیاده‌سازی می‌کند. حالت مرزی پیش‌فرض ضریب بهرهٔ
دقیقاً 1.0 را برای فریم‌های مفقود در نظر می‌گیرد که به یک «محو شدن تدریجی ورودی» (fade in)
و «محو شدن تدریجی خروجی» (fade out) نرم به ترتیب در ابتدا و انتهای ورودی منجر می‌شود.
.IP "\fBcompress, s\fR" 4
.IX Item "compress, s"
تنظیم ضریب فشرده‌سازی. در محدودهٔ 0.0 تا 30.0. پیش‌فرض 0.0 است.
به‌طور پیش‌فرض، نرمال‌ساز پویای صدا فشرده‌سازی «سنتی» را اعمال نمی‌کند. این بدان معناست
که اوج‌های سیگنال بریده نخواهند شد و بنابراین محدودهٔ دینامیکی کامل درون هر همسایگی
محلی حفظ خواهد شد. با این حال، در برخی موارد ممکن است ترکیب الگوریتم نرمال‌سازی نرمال‌ساز
پویای صدا با یک فشرده‌سازی «سنتی‌تر» مطلوب باشد. برای این منظور، نرمال‌ساز پویای صدا یک
تابع فشرده‌سازی اختیاری (اعمال آستانه) را ارائه می‌دهد. اگر (و تنها اگر) ویژگی فشرده‌سازی
فعال باشد، تمام فریم‌های ورودی پیش از فرایند نرمال‌سازی واقعی توسط یک تابع آستانه‌گذاری با
زانو نرم (soft knee) پردازش خواهند شد. به زبان ساده، تابع آستانه‌گذاری تمام نمونه‌هایی
را که دامنهٔ آن‌ها از یک مقدار آستانهٔ مشخص فراتر می‌رود هرس می‌کند. با این حال، نرمال‌ساز
پویای صدا صرفاً یک مقدار آستانهٔ ثابت را اعمال نمی‌کند. در عوض، مقدار آستانه برای هر فریم
منفرد تنظیم خواهد شد.
به‌طور کلی، پارامترهای کوچک‌تر به فشرده‌سازی قوی‌تر منجر می‌شوند و برعکس. مقادیر زیر 3.0
توصیه نمی‌شوند، زیرا ممکن است اعوجاج قابل شنیدن پدیدار شود.
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم مقدار آستانهٔ هدف. این گزینه پایین‌ترین سطح دامنهٔ مجاز را برای ورودی صوتی که نرمال
خواهد شد مشخص می‌کند. اگر حجم صدای فریم ورودی بالاتر از این مقدار باشد، فریم نرمال خواهد شد.
در غیر این صورت ممکن است فریم اصلاً نرمال نشود. مقدار پیش‌فرض روی 0 تنظیم شده است، که یعنی
تمام فریم‌های ورودی نرمال خواهند شد. این گزینه بیشتر در صورتی مفید است که تقویت نویز
دیجیتال مورد نظر نباشد.
.IP "\fBchannels, h\fR" 4
.IX Item "channels, h"
تعیین کانال‌های مورد نظر برای فیلترسازی، به‌طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBoverlap, o\fR" 4
.IX Item "overlap, o"
تعیین هم‌پوشانی برای فریم‌ها. اگر روی 0 (پیش‌فرض) تنظیم شود هیچ هم‌پوشانی فریمی انجام نمی‌شود.
استفاده از مقادیر >0 و <1 باعث تنظیمات بهرهٔ کمتر محافظه‌کارانه می‌شود، مانند زمانی که
گزینه framelen روی مقدار کوچک‌تری تنظیم شده است؛ اگر مقدار گزینه framelen برای هم‌پوشانی
غیرصفر جبران شود، تنظیمات بهره در طول زمان در مقایسه با حالت هم‌پوشانی صفر روان‌تر خواهد بود.
.IP "\fBcurve, v\fR" 4
.IX Item "curve, v"
تعیین عبارت منحنی نگاشت اوج که قرار است هنگام محاسبهٔ بهرهٔ اعمال‌شده به فریم‌ها استفاده
شود. حداکثر بهرهٔ فریم خروجی همچنان توسط سایر گزینه‌های قبلی ذکرشده برای این فیلتر محدود خواهد بود.
.Sp
عبارت می‌تواند شامل ثوابت زیر باشد:
.RS 4
.IP \fBch\fR 4
.IX Item "ch"
شمارهٔ کانال فعلی
.IP \fBsn\fR 4
.IX Item "sn"
شمارهٔ نمونهٔ فعلی
.IP \fBnb_channels\fR 4
.IX Item "nb_channels"
تعداد کانال‌ها
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بیان‌شده بر حسب ثانیه
.IP \fBsr\fR 4
.IX Item "sr"
نرخ نمونه‌برداری
.IP \fBp\fR 4
.IX Item "p"
مقدار اوج فریم فعلی
.RE
.RS 4
.RE
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS earwax
.IX Subsection "earwax"
آسان‌تر ساختن گوش دادن به صدا با هدفون.
.PP
این فیلتر نشانه‌ها یا سرنخ‌هایی (cues) را به صدای استریوی 44.1kHz (یعنی قالب CD صوتی) اضافه
می‌کند تا هنگام گوش دادن با هدفون، تصویر استریو از داخل سر شما (حالت استاندارد برای هدفون)
به بیرون و در مقابل شنونده (حالت استاندارد برای بلندگوها) منتقل شود.
.PP
پورت‌شده از SoX.
.SS equalizer
.IX Subsection "equalizer"
اعمال یک فیلتر اکولایزر پیک دوقطبی (two-pole peaking EQ). با این فیلتر، سطح سیگنال
در فرکانس انتخابی و اطراف آن می‌تواند افزایش یا کاهش یابد، در حالی که (برخلاف فیلترهای
میان‌گذر و میان‌ناگذر) سطح سیگنال در تمام فرکانس‌های دیگر بدون تغییر باقی می‌ماند.
.PP
به منظور تولید منحنی‌های اکولایزاسیون پیچیده، این فیلتر می‌تواند چندین بار داده شود،
که هر بار با یک فرکانس مرکزی متفاوت همراه است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر بر حسب Hz.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش مشخص کردن پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند فیلتر بر حسب واحدهای width_type.
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تنظیم بهره یا تضعیف مورد نیاز بر حسب dB.
هنگام استفاده از بهرهٔ مثبت مراقب برش (clipping) باشید.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌های مورد نظر برای فیلترسازی، به‌طور پیش‌فرض همه کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad، به‌طور پیش‌فرض غیرفعال است.
فعال کردن آن پاسخ دامنه در DC را به 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه بر اساس فیلترهای پیرامونی.
.IP \fBs16\fR 4
.IX Item "s16"
همیشه استفاده از ۱۶ بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
همیشه استفاده از ۳۲ بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
همیشه استفاده از ممیز شناور ۳۲ بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
همیشه استفاده از ممیز شناور ۶۴ بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازهٔ بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار به اندازهٔ کافی بزرگ
تنظیم شود (بزرگ‌تر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر کوتاه می‌شود)
فیلترسازی فاز خطی خواهد شد، در غیر این صورت اگر به اندازهٔ کافی بزرگ نباشد فقط مصنوعات صوتی
نامطلوب تولید می‌کند.
.Sp
توجه داشته باشید که تأخیر فیلتر هنگام تنظیم به یک مقدار غیر صفر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تضعیف 10 dB در 1000 Hz، با پهنای باند 200 Hz:
.Sp
.Vb 1
\&        equalizer=f=1000:t=h:width=200:g=\-10
.Ve
.IP \(bu 4
اعمال 2 dB بهره در 1000 Hz با ضریب Q برابر 1 و تضعیف 5 dB در 100 Hz با Q برابر 2:
.Sp
.Vb 1
\&        equalizer=f=1000:t=q:w=1:g=2,equalizer=f=100:t=q:w=2:g=\-5
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورهای زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس اکولایزر.
دستور زبان برای این دستور: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type اکولایزر.
دستور زبان برای این دستور: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای باند اکولایزر.
دستور زبان برای این دستور: "\fIwidth\fR"
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تغییر بهرهٔ اکولایزر.
دستور زبان برای این دستور: "\fIgain\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر میکس اکولایزر.
دستور زبان برای این دستور: "\fImix\fR"
.SS extrastereo
.IX Subsection "extrastereo"
افزایش خطی تفاوت بین کانال‌های چپ و راست که نوعی جلوهٔ «زنده» (live) به پخش صدا می‌افزاید.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBm\fR 4
.IX Item "m"
تنظیم ضریب اختلاف (پیش‌فرض: 2.5). مقدار 0.0 به معنای صدای مونو (میانگین هر دو کانال) است،
با 1.0 صدا بدون تغییر خواهد بود، با \-1.0 کانال‌های چپ و راست جابه‌جا می‌شوند.
.IP \fBc\fR 4
.IX Item "c"
فعال‌سازی برش (clipping). به‌طور پیش‌فرض فعال است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS firequalizer
.IX Subsection "firequalizer"
اعمال اکولایزاسیون FIR با استفاده از پاسخ فرکانسی دلخواه.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم معادلهٔ منحنی بهره (بر حسب dB). عبارت می‌تواند شامل متغیرها باشد:
.RS 4
.IP \fBf\fR 4
.IX Item "f"
فرکانس ارزیابی‌شده
.IP \fBsr\fR 4
.IX Item "sr"
نرخ نمونه‌برداری
.IP \fBch\fR 4
.IX Item "ch"
شمارهٔ کانال، در صورت غیرفعال بودن ارزیابی چندکاناله روی 0 تنظیم می‌شود
.IP \fBchid\fR 4
.IX Item "chid"
شناسهٔ کانال، به libavutil/channel_layout.h مراجعه کنید، در صورت غیرفعال بودن
ارزیابی چندکاناله روی اولین شناسهٔ کانال تنظیم می‌شود
.IP \fBchs\fR 4
.IX Item "chs"
تعداد کانال‌ها
.IP \fBchlayout\fR 4
.IX Item "chlayout"
چینش کانال (channel_layout)، به libavutil/channel_layout.h مراجعه کنید
.RE
.RS 4
.Sp
و توابع:
.IP \fBgain_interpolate(f)\fR 4
.IX Item "gain_interpolate(f)"
درون‌یابی بهره در فرکانس f بر اساس gain_entry
.IP \fBcubic_interpolate(f)\fR 4
.IX Item "cubic_interpolate(f)"
همانند gain_interpolate، اما نرم‌تر
.RE
.RS 4
.Sp
این گزینه به عنوان دستور نیز در دسترس است. پیش‌فرض \f(CWgain_interpolate(f)\fR است.
.RE
.IP \fBgain_entry\fR 4
.IX Item "gain_entry"
تنظیم ورودی بهره برای تابع gain_interpolate. عبارت می‌تواند شامل توابع باشد:
.RS 4
.IP "\fBentry(f, g)\fR" 4
.IX Item "entry(f, g)"
ذخیرهٔ ورودی بهره در فرکانس f با مقدار g
.RE
.RS 4
.Sp
این گزینه به عنوان دستور نیز در دسترس است.
.RE
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم تأخیر فیلتر بر حسب ثانیه. مقدار بالاتر به معنای دقت بیشتر است.
پیش‌فرض \f(CW0.01\fR است.
.IP \fBaccuracy\fR 4
.IX Item "accuracy"
تنظیم دقت فیلتر بر حسب Hz. مقدار کمتر به معنای دقت بیشتر است.
پیش‌فرض \f(CW5\fR است.
.IP \fBwfunc\fR 4
.IX Item "wfunc"
تنظیم تابع پنجره. مقادیر قابل قبول عبارتند از:
.RS 4
.IP \fBrectangular\fR 4
.IX Item "rectangular"
پنجرهٔ مستطیلی، زمانی مفید است که منحنی بهره از قبل هموار باشد
.IP \fBhann\fR 4
.IX Item "hann"
پنجرهٔ هان (Hann) (پیش‌فرض)
.IP \fBhamming\fR 4
.IX Item "hamming"
پنجرهٔ همینگ (Hamming)
.IP \fBblackman\fR 4
.IX Item "blackman"
پنجرهٔ بلکمن (Blackman)
.IP \fBnuttall3\fR 4
.IX Item "nuttall3"
پنجرهٔ ناتال مشتق اول پیوستهٔ ۳ جمله‌ای
.IP \fBmnuttall3\fR 4
.IX Item "mnuttall3"
پنجرهٔ ناتال ناپیوستهٔ حداقل ۳ جمله‌ای
.IP \fBnuttall\fR 4
.IX Item "nuttall"
پنجرهٔ ناتال مشتق اول پیوستهٔ ۴ جمله‌ای
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
پنجرهٔ ناتال ناپیوستهٔ حداقل ۴ جمله‌ای (بلکمن\-ناتال)
.IP \fBbharris\fR 4
.IX Item "bharris"
پنجرهٔ بلکمن\-هریس
.IP \fBtukey\fR 4
.IX Item "tukey"
پنجرهٔ توکی (Tukey)
.RE
.RS 4
.RE
.IP \fBfixed\fR 4
.IX Item "fixed"
در صورت فعال بودن، از تعداد ثابتی از نمونه‌های صوتی استفاده می‌کند. این کار سرعت را هنگام
فیلترسازی با تأخیر زیاد بهبود می‌بخشد. پیش‌فرض غیرفعال است.
.IP \fBmulti\fR 4
.IX Item "multi"
فعال‌سازی ارزیابی چندکاناله بر روی بهره. پیش‌فرض غیرفعال است.
.IP \fBzero_phase\fR 4
.IX Item "zero_phase"
فعال‌سازی حالت فاز صفر با کسر برچسب زمانی برای جبران تأخیر.
پیش‌فرض غیرفعال است.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس مورد استفاده توسط بهره. مقادیر قابل قبول عبارتند از:
.RS 4
.IP \fBlinlin\fR 4
.IX Item "linlin"
فرکانس خطی، بهرهٔ خطی
.IP \fBlinlog\fR 4
.IX Item "linlog"
فرکانس خطی، بهرهٔ لگاریتمی (بر حسب dB) (پیش‌فرض)
.IP \fBloglin\fR 4
.IX Item "loglin"
فرکانس لگاریتمی (در مقیاس اکتاو که در آن 20 Hz برابر 0 است)، بهرهٔ خطی
.IP \fBloglog\fR 4
.IX Item "loglog"
فرکانس لگاریتمی، بهرهٔ لگاریتمی
.RE
.RS 4
.RE
.IP \fBdumpfile\fR 4
.IX Item "dumpfile"
تنظیم پرونده برای تخلیه داده‌ها (dump)، مناسب برای gnuplot.
.IP \fBdumpscale\fR 4
.IX Item "dumpscale"
تنظیم مقیاس برای dumpfile. مقادیر قابل قبول همان مقادیر گزینه scale هستند.
پیش‌فرض linlog است.
.IP \fBfft2\fR 4
.IX Item "fft2"
فعال‌سازی کانولوشن ۲ کاناله با استفاده از FFT مختلط. این کار سرعت را به‌طور قابل توجهی بهبود می‌بخشد.
پیش‌فرض غیرفعال است.
.IP \fBmin_phase\fR 4
.IX Item "min_phase"
فعال‌سازی پاسخ ضربه با حداقل فاز (minimum phase). پیش‌فرض غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
پایین‌گذر در 1000 Hz:
.Sp
.Vb 1
\&        firequalizer=gain=\*(Aqif(lt(f,1000), 0, \-INF)\*(Aq
.Ve
.IP \(bu 4
پایین‌گذر در 1000 Hz با gain_entry:
.Sp
.Vb 1
\&        firequalizer=gain_entry=\*(Aqentry(1000,0); entry(1001, \-INF)\*(Aq
.Ve
.IP \(bu 4
اکولایزاسیون سفارشی:
.Sp
.Vb 1
\&        firequalizer=gain_entry=\*(Aqentry(100,0); entry(400, \-4); entry(1000, \-6); entry(2000, 0)\*(Aq
.Ve
.IP \(bu 4
تأخیر بالاتر با فاز صفر برای جبران تأخیر:
.Sp
.Vb 1
\&        firequalizer=delay=0.1:fixed=on:zero_phase=on
.Ve
.IP \(bu 4
پایین‌گذر روی کانال چپ، بالاگذر روی کانال راست:
.Sp
.Vb 2
\&        firequalizer=gain=\*(Aqif(eq(chid,1), gain_interpolate(f), if(eq(chid,2), gain_interpolate(1e6+f), 0))\*(Aq
\&        :gain_entry=\*(Aqentry(1000, 0); entry(1001,\-INF); entry(1e6+1000,0)\*(Aq:multi=on
.Ve
.SS flanger
.IX Subsection "flanger"
اعمال جلوهٔ فلانجر (flanging) به صدا.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم تأخیر پایه بر حسب میلی‌ثانیه. محدوده از 0 تا 30. مقدار پیش‌فرض 0 است.
.IP \fBdepth\fR 4
.IX Item "depth"
تنظیم تأخیر جاروب (sweep) اضافه شده بر حسب میلی‌ثانیه. محدوده از 0 تا 10. مقدار پیش‌فرض 2 است.
.IP \fBregen\fR 4
.IX Item "regen"
تنظیم درصد بازتولید (بازخورد سیگنال تأخیریافته). محدوده از \-95 تا 95. مقدار پیش‌فرض 0 است.
.IP \fBwidth\fR 4
.IX Item "width"
تنظیم درصد سیگنال تأخیریافتهٔ ترکیب‌شده با سیگنال اصلی. محدوده از 0 تا 100. مقدار پیش‌فرض 71 است.
.IP \fBspeed\fR 4
.IX Item "speed"
تنظیم تعداد جاروب‌ها در هر ثانیه (Hz). محدوده از 0.1 تا 10. مقدار پیش‌فرض 0.5 است.
.IP \fBshape\fR 4
.IX Item "shape"
تنظیم شکل موج جاروب، می‌تواند \fItriangular\fR (مثلثی) یا \fIsinusoidal\fR (سینوسی) باشد.
مقدار پیش‌فرض \fIsinusoidal\fR است.
.IP \fBphase\fR 4
.IX Item "phase"
تنظیم درصد شیفت موج جاروب برای چندکاناله. محدوده از 0 تا 100. مقدار پیش‌فرض 25 است.
.IP \fBinterp\fR 4
.IX Item "interp"
تنظیم درون‌یابی خط تأخیر، \fIlinear\fR (خطی) یا \fIquadratic\fR (درجه دوم).
پیش‌فرض \fIlinear\fR است.
.SS haas
.IX Subsection "haas"
اعمال جلوهٔ هاس (Haas effect) به صدا.
.PP
توجه داشته باشید که اعمال این فیلتر بر روی سیگنال‌های مونو بیشترین کاربرد را دارد.
با اعمال این فیلتر بر روی سیگنال‌های مونو، مقداری جهت‌مندی به صدا داده شده و تصویر استریوی آن بسط داده می‌شود.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی. به‌طور پیش‌فرض \fI1\fR یا 0dB است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم سطح خروجی. به‌طور پیش‌فرض \fI1\fR یا 0dB است.
.IP \fBside_gain\fR 4
.IX Item "side_gain"
تنظیم بهرهٔ اعمال‌شده به بخش جانبی سیگنال. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBmiddle_source\fR 4
.IX Item "middle_source"
تنظیم نوع منبع میانی. می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBleft\fR 4
.IX Item "left"
انتخاب کانال چپ.
.IP \fBright\fR 4
.IX Item "right"
انتخاب کانال راست.
.IP \fBmid\fR 4
.IX Item "mid"
انتخاب سیگنال بخش میانی تصویر استریو.
.IP \fBside\fR 4
.IX Item "side"
انتخاب سیگنال بخش جانبی تصویر استریو.
.RE
.RS 4
.RE
.IP \fBmiddle_phase\fR 4
.IX Item "middle_phase"
تغییر فاز میانی. به‌طور پیش‌فرض غیرفعال است.
.IP \fBleft_delay\fR 4
.IX Item "left_delay"
تنظیم تأخیر کانال چپ. به‌طور پیش‌فرض \fI2.05\fR میلی‌ثانیه است.
.IP \fBleft_balance\fR 4
.IX Item "left_balance"
تنظیم تراز (balance) کانال چپ. به‌طور پیش‌فرض \fI\-1\fR است.
.IP \fBleft_gain\fR 4
.IX Item "left_gain"
تنظیم بهرهٔ کانال چپ. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBleft_phase\fR 4
.IX Item "left_phase"
تغییر فاز چپ. به‌طور پیش‌فرض غیرفعال است.
.IP \fBright_delay\fR 4
.IX Item "right_delay"
تنظیم تأخیر کانال راست. به‌طور پیش‌فرض \fI2.12\fR میلی‌ثانیه است.
.IP \fBright_balance\fR 4
.IX Item "right_balance"
تنظیم تراز کانال راست. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBright_gain\fR 4
.IX Item "right_gain"
تنظیم بهرهٔ کانال راست. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBright_phase\fR 4
.IX Item "right_phase"
تغییر فاز راست. به‌طور پیش‌فرض فعال است.
.SS hdcd
.IX Subsection "hdcd"
رمزگشایی داده‌های HDCD (سازگار با وضوح بالا). یک استریم PCM شانزده بیتی با کدهای
HDCD جاسازی‌شده به یک استریم PCM بیست بیتی گسترش می‌یابد.
.PP
این فیلتر از ویژگی‌های Peak Extend و Low-level Gain Adjustment در HDCD پشتیبانی
کرده و پرچم Transient Filter را تشخیص می‌دهد.
.PP
.Vb 1
\&        ffmpeg \-i HDCD16.flac \-af hdcd OUT24.flac
.Ve
.PP
هنگام استفاده از فیلتر با wav، توجه داشته باشید که کدگذاری پیش‌فرض برای wav شانزده بیتی است،
بنابراین استریم ۲۰ بیتی حاصل دوباره به ۱۶ بیت بریده (truncate) خواهد شد. برای دریافت
خروجی PCM بیست و چهار بیتی، از چیزی مانند \fB\-acodec pcm_s24le\fR بعد از فیلتر استفاده کنید.
.PP
.Vb 2
\&        ffmpeg \-i HDCD16.wav \-af hdcd OUT16.wav
\&        ffmpeg \-i HDCD16.wav \-af hdcd \-c:a pcm_s24le OUT24.wav
.Ve
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdisable_autoconvert\fR 4
.IX Item "disable_autoconvert"
غیرفعال‌سازی هرگونه تبدیل خودکار قالب یا نمونه‌برداری مجدد در گراف فیلتر.
.IP \fBprocess_stereo\fR 4
.IX Item "process_stereo"
پردازش هم‌زمان کانال‌های استریو با یکدیگر. اگر target_gain بین کانال‌ها مطابقت نداشته باشد،
آن را نامعتبر در نظر گرفته و از آخرین target_gain معتبر استفاده می‌کند.
.IP \fBcdt_ms\fR 4
.IX Item "cdt_ms"
تنظیم دورهٔ زمانی تایمر تشخیص کد بر حسب میلی‌ثانیه.
.IP \fBforce_pe\fR 4
.IX Item "force_pe"
همیشه اوج‌های بالاتر از \-3dBFS را گسترش بده، حتی اگر PE سیگنال داده نشده باشد.
.IP \fBanalyze_mode\fR 4
.IX Item "analyze_mode"
جایگزینی صدا با یک تون یکنواخت و تنظیم دامنه برای نشان دادن جنبه‌ای خاص از فرایند
رمزگشایی. پرونده خروجی می‌تواند در یک ویرایشگر صوتی در کنار پرونده اصلی برای کمک
به تحلیل بارگذاری شود.
.Sp
\&\f(CW\*(C`analyze_mode=pe:force_pe=true\*(C'\fR می‌تواند برای مشاهدهٔ تمام نمونه‌های بالای سطح PE استفاده شود.
.Sp
حالت‌ها عبارتند از:
.RS 4
.IP "\fB0, off\fR" 4
.IX Item "0, off"
غیرفعال
.IP "\fB1, lle\fR" 4
.IX Item "1, lle"
سطح تنظیم بهره در هر نمونه
.IP "\fB2, pe\fR" 4
.IX Item "2, pe"
نمونه‌هایی که در آن‌ها Peak Extend رخ می‌دهد
.IP "\fB3, cdt\fR" 4
.IX Item "3, cdt"
نمونه‌هایی که تایمر تشخیص کد در آن‌ها فعال است
.IP "\fB4, tgm\fR" 4
.IX Item "4, tgm"
نمونه‌هایی که در آن‌ها بهرهٔ هدف بین کانال‌ها مطابقت ندارد
.RE
.RS 4
.RE
.SS headphone
.IX Subsection "headphone"
اعمال توابع تبدیل وابسته به سر (HRTF) برای ایجاد بلندگوهای مجازی در اطراف کاربر
جهت گوش دادن دوگوشی (binaural) از طریق هدفون.
پاسخ‌های ضربهٔ وابسته به سر (HRIR) از طریق استریم‌های اضافی ارائه می‌شوند؛
برای هر کانال به یک استریم ورودی استریو نیاز است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmap\fR 4
.IX Item "map"
تنظیم نگاشت استریم‌های ورودی برای کانولوشن.
شناسه فهرستی جداشده با \*(Aq|\*(Aq از نام‌های کانال به ترتیبی است که به عنوان ورودی‌های
استریم اضافی به فیلتر داده شده‌اند.
این گزینه همچنین تعداد استریم‌های ورودی را مشخص می‌کند. تعداد استریم‌های ورودی نباید
کمتر از تعداد کانال‌های استریم اول به اضافهٔ یک باشد.
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم بهرهٔ اعمال‌شده به صدا. مقدار بر حسب dB است. پیش‌فرض 0 است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع پردازش. می‌تواند \fItime\fR یا \fIfreq\fR باشد. \fItime\fR پردازش صدا در حوزهٔ
زمان است که کند می‌باشد. \fIfreq\fR پردازش صدا در حوزهٔ فرکانس است که سریع می‌باشد.
پیش‌فرض \fIfreq\fR است.
.IP \fBlfe\fR 4
.IX Item "lfe"
تنظیم بهرهٔ سفارشی برای کانال‌های LFE. مقدار بر حسب dB است. پیش‌فرض 0 است.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازهٔ فریم بر حسب تعداد نمونه‌هایی که به طور همزمان پردازش می‌شوند.
مقدار پیش‌فرض \fI1024\fR است. محدودهٔ مجاز از 1024 تا 96000 است.
.IP \fBhrir\fR 4
.IX Item "hrir"
تنظیم قالب استریم hrir.
مقدار پیش‌فرض \fIstereo\fR است. مقدار جایگزین \fImultich\fR می‌باشد.
اگر مقدار روی \fIstereo\fR تنظیم شود، تعداد استریم‌های اضافی باید بزرگتر یا مساوی
با تعداد کانال‌های ورودی در اولین استریم ورودی باشد. همچنین هر استریم اضافی باید دارای
تعداد کانال‌های استریو باشد.
اگر مقدار روی \fImultich\fR تنظیم شود، تعداد استریم‌های اضافی باید دقیقاً یکی باشد.
همچنین تعداد کانال‌های ورودی استریم اضافی باید مساوی یا بزرگتر از دو برابر تعداد
کانال‌های اولین استریم ورودی باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مثال کامل با استفاده از پرونده‌های wav به عنوان ضرایب همراه با فیلترهای amovie برای
تبدیل کاهشی 7.1 (downmix)؛ هر فیلتر amovie از یک پروندهٔ استریو با ضرایب IR به عنوان ورودی استفاده می‌کند.
پرونده‌ها ضرایب را برای هر موقعیت از بلندگوی مجازی ارائه می‌دهند:
.Sp
.Vb 3
\&        ffmpeg \-i input.wav
\&        \-filter_complex "amovie=azi_270_ele_0_DFC.wav[sr];amovie=azi_90_ele_0_DFC.wav[sl];amovie=azi_225_ele_0_DFC.wav[br];amovie=azi_135_ele_0_DFC.wav[bl];amovie=azi_0_ele_0_DFC.wav,asplit[fc][lfe];amovie=azi_35_ele_0_DFC.wav[fl];amovie=azi_325_ele_0_DFC.wav[fr];[0:a][fl][fr][fc][lfe][bl][br][sl][sr]headphone=FL|FR|FC|LFE|BL|BR|SL|SR"
\&        output.wav
.Ve
.IP \(bu 4
مثال کامل با استفاده از پرونده‌های wav به عنوان ضرایب همراه با فیلترهای amovie برای تبدیل
کاهشی 7.1، اما اکنون در قالب \fImultich\fR \fIhrir\fR:
.Sp
.Vb 2
\&        ffmpeg \-i input.wav \-filter_complex "amovie=minp.wav[hrirs];[0:a][hrirs]headphone=map=FL|FR|FC|LFE|BL|BR|SL|SR:hrir=multich"
\&        output.wav
.Ve
.SS highpass
.IX Subsection "highpass"
اعمال یک فیلتر بالاگذر با فرکانس نقطهٔ 3dB.
فیلتر می‌تواند تک‌قطبی یا دوقطبی (پیش‌فرض) باشد.
شیب افت فیلتر (roll off) برابر با 6dB به‌ازای هر قطب در هر اکتاو (20dB به‌ازای هر قطب در هر دهه) است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس بر حسب Hz. پیش‌فرض 3000 است.
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم تعداد قطب‌ها. پیش‌فرض 2 است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش مشخص کردن پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند فیلتر بر حسب واحدهای width_type.
فقط برای فیلتر دوقطبی اعمال می‌شود.
پیش‌فرض 0.707q است و پاسخ باترورث (Butterworth) می‌دهد.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌های مورد نظر برای فیلترسازی، به‌طور پیش‌فرض همه کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad، به‌طور پیش‌فرض غیرفعال است.
فعال کردن آن پاسخ دامنه در DC را به 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه بر اساس فیلترهای پیرامونی.
.IP \fBs16\fR 4
.IX Item "s16"
همیشه استفاده از ۱۶ بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
همیشه استفاده از ۳۲ بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
همیشه استفاده از ممیز شناور ۳۲ بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
همیشه استفاده از ممیز شناور ۶۴ بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازهٔ بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار به اندازهٔ کافی بزرگ
تنظیم شود (بزرگ‌تر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر کوتاه می‌شود)
فیلترسازی فاز خطی خواهد شد، در غیر این صورت اگر به اندازه کافی بزرگ نباشد فقط مصنوعات صوتی
نامطلوب تولید می‌کند.
.Sp
توجه داشته باشید که تأخیر فیلتر هنگام تنظیم به یک مقدار غیر صفر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورهای زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس بالاگذر.
دستور زبان برای این دستور: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type بالاگذر.
دستور زبان برای این دستور: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای باند بالاگذر.
دستور زبان برای این دستور: "\fIwidth\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر میکس بالاگذر.
دستور زبان برای این دستور: "\fImix\fR"
.SS join
.IX Subsection "join"
الحاق چندین استریم ورودی به یک استریم چندکاناله.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تعداد استریم‌های ورودی. پیش‌فرض 2 است.
.IP \fBchannel_layout\fR 4
.IX Item "channel_layout"
چینش کانال خروجی مورد نظر. پیش‌فرض stereo است.
.IP \fBmap\fR 4
.IX Item "map"
نگاشت کانال‌ها از ورودی‌ها به خروجی. شناسه فهرستی جداشده با \*(Aq|\*(Aq از نگاشت‌ها است،
که هر یک به شکل \f(CW\*(C`\fR\f(CIinput_idx\fR\f(CW.\fR\f(CIin_channel\fR\f(CW\-\fR\f(CIout_channel\fR\f(CW\*(C'\fR
می‌باشند. \fIinput_idx\fR شاخص مبتنی بر صفر استریم ورودی است. \fIin_channel\fR می‌تواند
نام کانال ورودی (مانند FL برای چپ جلو) یا شاخص آن در استریم ورودی مشخص‌شده باشد.
\fIout_channel\fR نام کانال خروجی است.
.PP
فیلتر در صورت عدم تعیین صریح نگاشت‌ها، برای حدس زدن آن‌ها تلاش خواهد کرد. این کار ابتدا با
تلاش برای یافتن یک کانال ورودی تطبیق‌یافتهٔ استفاده‌نشده انجام می‌شود و در صورت عدم موفقیت،
اولین کانال ورودی استفاده‌نشده را انتخاب می‌کند.
.PP
الحاق ۳ ورودی (با چینش‌های کانال به درستی تنظیم‌شده):
.PP
.Vb 1
\&        ffmpeg \-i INPUT1 \-i INPUT2 \-i INPUT3 \-filter_complex join=inputs=3 OUTPUT
.Ve
.PP
ساخت یک خروجی 5.1 از ۶ استریم تک‌کاناله:
.PP
.Vb 3
\&        ffmpeg \-i fl \-i fr \-i fc \-i sl \-i sr \-i lfe \-filter_complex
\&        \*(Aqjoin=inputs=6:channel_layout=5.1:map=0.0\-FL|1.0\-FR|2.0\-FC|3.0\-SL|4.0\-SR|5.0\-LFE\*(Aq
\&        out
.Ve
.SS ladspa
.IX Subsection "ladspa"
بارگذاری یک پلاگین LADSPA (رابط برنامه‌نویسی ساده برای توسعه‌دهندگان صدای لینوکس).
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-ladspa\*(C'\fR پیکربندی کنید.
.IP "\fBfile, f\fR" 4
.IX Item "file, f"
نام کتابخانهٔ پلاگین LADSPA برای بارگذاری را مشخص می‌کند. اگر متغیر محیطی
\fBLADSPA_PATH\fR تعریف شده باشد، پلاگین LADSPA در هر یک از دایرکتوری‌های مشخص‌شده
توسط فهرست جداشده با دونقطه در \fBLADSPA_PATH\fR جستجو می‌شود، در غیر این صورت در مسیرهای
استاندارد LADSPA که به این ترتیب هستند جستجو خواهد شد: \fIHOME/.ladspa/lib/\fR،
\&\fI/usr/local/lib/ladspa/\fR، \fI/usr/lib/ladspa/\fR.
.IP "\fBplugin, p\fR" 4
.IX Item "plugin, p"
پلاگین درون کتابخانه را مشخص می‌کند. برخی کتابخانه‌ها فقط شامل یک پلاگین هستند، اما برخی دیگر
شامل تعداد زیادی از آن‌ها می‌باشند. اگر این گزینه تنظیم نشود، فیلتر تمام پلاگین‌های موجود درون
کتابخانهٔ مشخص‌شده را فهرست می‌کند.
.IP "\fBcontrols, c\fR" 4
.IX Item "controls, c"
تنظیم فهرست جداشده با \*(Aq|\*(Aq از کنترل‌ها که صفر یا چند مقدار ممیز شناور هستند و
رفتار پلاگین بارگذاری‌شده را تعیین می‌کنند (برای مثال تأخیر، آستانه یا بهره).
کنترل‌ها باید با استفاده از دستور زبان زیر تعریف شوند:
c0=\fIvalue0\fR|c1=\fIvalue1\fR|c2=\fIvalue2\fR|..., که در آن
\&\fIvaluei\fR مقدار تنظیم‌شده روی کنترل \fIi\fR\-ام است.
همچنین می‌توانند با دستور زبان زیر نیز تعریف شوند:
\&\fIvalue0\fR|\fIvalue1\fR|\fIvalue2\fR|..., که در آن
\&\fIvaluei\fR مقدار تنظیم‌شده روی کنترل \fIi\fR\-ام است.
اگر \fBcontrols\fR روی \f(CW\*(C`help\*(C'\fR تنظیم شود، تمام کنترل‌های موجود و
محدوده‌های معتبر آن‌ها چاپ می‌شوند.
.IP "\fBsample_rate, s\fR" 4
.IX Item "sample_rate, s"
تعیین نرخ نمونه‌برداری، پیش‌فرض 44100 است. فقط در صورتی استفاده می‌شود که پلاگین ورودی صفر داشته باشد.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها به‌ازای هر کانال در هر فریم خروجی، پیش‌فرض 1024 است. فقط در صورتی استفاده
می‌شود که پلاگین ورودی صفر داشته باشد.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم حداقل مدت‌زمان صدای منبع. برای دستور زبان پذیرفته‌شده به
\&\fBبخش مدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
توجه داشته باشید که مدت‌زمان حاصل ممکن است بیشتر از مدت‌زمان مشخص‌شده باشد، زیرا صدای تولیدشده
همیشه در پایان یک فریم کامل قطع می‌شود.
اگر مشخص نشود، یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود صدا برای همیشه تولید می‌شود.
فقط در صورتی استفاده می‌شود که پلاگین ورودی صفر داشته باشد.
.IP "\fBlatency, l\fR" 4
.IX Item "latency, l"
فعال‌سازی جبران تاخیر (latency)، به‌طور پیش‌فرض غیرفعال است.
فقط در صورتی استفاده می‌شود که پلاگین ورودی داشته باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
فهرست کردن تمام پلاگین‌های موجود در کتابخانهٔ amp (پلاگین نمونه LADSPA):
.Sp
.Vb 1
\&        ladspa=file=amp
.Ve
.IP \(bu 4
فهرست کردن تمام کنترل‌های موجود و محدوده‌های معتبر آن‌ها برای پلاگین \f(CW\*(C`vcf_notch\*(C'\fR
از کتابخانهٔ \f(CW\*(C`VCF\*(C'\fR:
.Sp
.Vb 1
\&        ladspa=f=vcf:p=vcf_notch:c=help
.Ve
.IP \(bu 4
شبیه‌سازی تجهیزات صوتی با کیفیت پایین با استفاده از کتابخانهٔ پلاگین \f(CW\*(C`Computer Music Toolkit\*(C'\fR (CMT):
.Sp
.Vb 1
\&        ladspa=file=cmt:plugin=lofi:controls=c0=22|c1=12|c2=12
.Ve
.IP \(bu 4
افزودن طنین (reverberation) به صدا با استفاده از TAP-plugins
(پلاگین‌های پردازش صوتی تام):
.Sp
.Vb 1
\&        ladspa=file=tap_reverb:tap_reverb
.Ve
.IP \(bu 4
تولید نویز سفید با دامنهٔ 0.2:
.Sp
.Vb 1
\&        ladspa=file=cmt:noise_source_white:c=c0=.2
.Ve
.IP \(bu 4
تولید ۲۰ تیک در دقیقه (bpm) با استفاده از پلاگین \f(CW\*(C`C* Click \- Metronome\*(C'\fR از
کتابخانهٔ \&\f(CW\*(C`C* Audio Plugin Suite\*(C'\fR (CAPS):
.Sp
.Vb 1
\&        ladspa=file=caps:Click:c=c1=20\*(Aq
.Ve
.IP \(bu 4
اعمال جلوهٔ \f(CW\*(C`C* Eq10X2 \- Stereo 10\-band equaliser\*(C'\fR:
.Sp
.Vb 1
\&        ladspa=caps:Eq10X2:c=c0=\-48|c9=\-24|c3=12|c4=2
.Ve
.IP \(bu 4
افزایش حجم صدا به میزان 20dB با استفاده از fast lookahead limiter از مجموعهٔ
\&\f(CW\*(C`SWH Plugins\*(C'\fR استیو هریس:
.Sp
.Vb 1
\&        ladspa=fast_lookahead_limiter_1913:fastLookaheadLimiter:20|0|2
.Ve
.IP \(bu 4
تضعیف فرکانس‌های پایین با استفاده از Multiband EQ از مجموعهٔ
\&\f(CW\*(C`SWH Plugins\*(C'\fR استیو هریس:
.Sp
.Vb 1
\&        ladspa=mbeq_1197:mbeq:\-24|\-24|\-24|0|0|0|0|0|0|0|0|0|0|0|0
.Ve
.IP \(bu 4
کاهش تصویر استریو با استفاده از \f(CW\*(C`Narrower\*(C'\fR از کتابخانهٔ
\f(CW\*(C`C* Audio Plugin Suite\*(C'\fR (CAPS):
.Sp
.Vb 1
\&        ladspa=caps:Narrower
.Ve
.IP \(bu 4
یک نویز سفید دیگر، اکنون با استفاده از کتابخانهٔ \f(CW\*(C`C* Audio Plugin Suite\*(C'\fR (CAPS):
.Sp
.Vb 1
\&        ladspa=caps:White:.2
.Ve
.IP \(bu 4
مقداری نویز فرکتال، با استفاده از کتابخانهٔ \f(CW\*(C`C* Audio Plugin Suite\*(C'\fR (CAPS):
.Sp
.Vb 1
\&        ladspa=caps:Fractal:c=c1=1
.Ve
.IP \(bu 4
نرمال‌سازی پویای حجم صدا با استفاده از پلاگین \f(CW\*(C`VLevel\*(C'\fR:
.Sp
.Vb 1
\&        ladspa=vlevel\-ladspa:vlevel_mono
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورهای زیر پشتیبانی می‌کند:
.IP \fBcN\fR 4
.IX Item "cN"
تغییر مقدار کنترل \fIN\fR\-ام.
.Sp
اگر مقدار مشخص‌شده معتبر نباشد، نادیده گرفته شده و مقدار قبلی حفظ می‌شود.
.SS loudnorm
.IX Subsection "loudnorm"
نرمال‌سازی بلندی صدا بر پایهٔ EBU R128. شامل هر دو حالت نرمال‌سازی پویا و خطی است.
از هر دو حالت تک‌گذر (پخش‌های زنده، پرونده‌ها) و دوگذر (پرونده‌ها) پشتیبانی می‌کند.
این الگوریتم می‌تواند IL، LRA و حداکثر اوج واقعی (true peak) را هدف قرار دهد.
در حالت پویا، برای تشخیص دقیق اوج‌های واقعی، استریم صوتی به 192 kHz فرانویسی (upsample)
خواهد شد.
از گزینهٔ \f(CW\*(C`\-ar\*(C'\fR یا فیلتر \f(CW\*(C`aresample\*(C'\fR برای تنظیم صریح
نرخ نمونه‌برداری خروجی استفاده کنید.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBI, i\fR" 4
.IX Item "I, i"
تنظیم بلندی صدای یکپارچهٔ هدف (integrated loudness).
محدوده از \-70.0 تا \-5.0 است. مقدار پیش‌فرض \-24.0 است.
.IP "\fBLRA, lra\fR" 4
.IX Item "LRA, lra"
تنظیم محدودهٔ بلندی صدای هدف (loudness range).
محدوده از 1.0 تا 50.0 است. مقدار پیش‌فرض 7.0 است.
.IP "\fBTP, tp\fR" 4
.IX Item "TP, tp"
تنظیم حداکثر اوج واقعی (true peak).
محدوده از \-9.0 تا +0.0 است. مقدار پیش‌فرض \-2.0 است.
.IP "\fBmeasured_I, measured_i\fR" 4
.IX Item "measured_I, measured_i"
مقدار IL اندازه‌گیری‌شدهٔ پروندهٔ ورودی.
محدوده از \-99.0 تا +0.0 است.
.IP "\fBmeasured_LRA, measured_lra\fR" 4
.IX Item "measured_LRA, measured_lra"
مقدار LRA اندازه‌گیری‌شدهٔ پروندهٔ ورودی.
محدوده از 0.0 تا 99.0 است.
.IP "\fBmeasured_TP, measured_tp\fR" 4
.IX Item "measured_TP, measured_tp"
مقدار اوج واقعی اندازه‌گیری‌شدهٔ پروندهٔ ورودی.
محدوده از \-99.0 تا +99.0 است.
.IP \fBmeasured_thresh\fR 4
.IX Item "measured_thresh"
آستانهٔ اندازه‌گیری‌شدهٔ پروندهٔ ورودی.
محدوده از \-99.0 تا +0.0 است.
.IP \fBoffset\fR 4
.IX Item "offset"
تنظیم بهرهٔ آفست. بهره پیش از محدودکنندهٔ اوج واقعی اعمال می‌شود.
محدوده از \-99.0 تا +99.0 است. پیش‌فرض +0.0 است.
.IP \fBlinear\fR 4
.IX Item "linear"
نرمال‌سازی از طریق مقیاس‌بندی خطی صدای مبدا.
گزینه‌های \f(CW\*(C`measured_I\*(C'\fR، \f(CW\*(C`measured_LRA\*(C'\fR، \f(CW\*(C`measured_TP\*(C'\fR
و \f(CW\*(C`measured_thresh\*(C'\fR همگی باید مشخص شوند. LRA هدف نباید کمتر از LRA مبدا باشد
و تغییر در بلندی صدای یکپارچه نباید منجر به اوج واقعی شود که از TP هدف فراتر رود.
اگر هر یک از این شرایط برآورده نشود، حالت نرمال‌سازی به \fIdynamic\fR بازمی‌گردد.
گزینه‌ها \f(CW\*(C`true\*(C'\fR یا \f(CW\*(C`false\*(C'\fR هستند. پیش‌فرض \f(CW\*(C`true\*(C'\fR است.
.IP \fBdual_mono\fR 4
.IX Item "dual_mono"
در نظر گرفتن پرونده‌های ورودی مونو به عنوان «dual-mono». اگر یک پروندهٔ مونو برای پخش
بر روی یک سیستم استریو در نظر گرفته شده باشد، اندازه‌گیری EBU R128 آن از نظر ادراکی نادرست
خواهد بود. در صورت تنظیم بر روی \f(CW\*(C`true\*(C'\fR، این گزینه این اثر را جبران خواهد کرد.
پرونده‌های ورودی چندکاناله تحت تأثیر این گزینه قرار نمی‌گیرند.
گزینه‌ها true یا false هستند. پیش‌فرض false است.
.IP \fBprint_format\fR 4
.IX Item "print_format"
تنظیم قالب چاپ آمار. گزینه‌ها summary، json یا none هستند.
مقدار پیش‌فرض none است.
.IP \fBstats_file\fR 4
.IX Item "stats_file"
نوشتن آمار در پروندهٔ مشخص‌شده. قالب توسط \fBprint_format\fR کنترل می‌شود،
که باید تنظیم شده باشد. برای نوشتن در خروجی استاندارد، \f(CW\*(C`\-\*(C'\fR را مشخص کنید.
به‌طور پیش‌فرض تنظیم نشده است.
.SS lowpass
.IX Subsection "lowpass"
اعمال یک فیلتر پایین‌گذر با فرکانس نقطهٔ 3dB.
فیلتر می‌تواند تک‌قطبی یا دوقطبی (پیش‌فرض) باشد.
شیب افت فیلتر (roll off) برابر با 6dB به‌ازای هر قطب در هر اکتاو (20dB به‌ازای هر قطب در هر دهه) است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس بر حسب Hz. پیش‌فرض 500 است.
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم تعداد قطب‌ها. پیش‌فرض 2 است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش مشخص کردن پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین پهنای باند فیلتر بر حسب واحدهای width_type.
فقط برای فیلتر دوقطبی اعمال می‌شود.
پیش‌فرض 0.707q است و پاسخ باترورث (Butterworth) می‌دهد.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
تعیین کانال‌های مورد نظر برای فیلترسازی، به‌طور پیش‌فرض همه کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad، به‌طور پیش‌فرض غیرفعال است.
فعال کردن آن پاسخ دامنه در DC را به 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلترسازی.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه بر اساس فیلترهای پیرامونی.
.IP \fBs16\fR 4
.IX Item "s16"
همیشه استفاده از ۱۶ بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
همیشه استفاده از ۳۲ بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
همیشه استفاده از ممیز شناور ۳۲ بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
همیشه استفاده از ممیز شناور ۶۴ بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازهٔ بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار به اندازهٔ کافی بزرگ
تنظیم شود (بزرگ‌تر از طول پاسخ ضربه که هنگام رسیدن به مقادیر نزدیک به صفر کوتاه می‌شود)
فیلترسازی فاز خطی خواهد شد، در غیر این صورت اگر به اندازه کافی بزرگ نباشد فقط مصنوعات صوتی
نامطلوب تولید می‌کند.
.Sp
توجه داشته باشید که تأخیر فیلتر هنگام تنظیم به یک مقدار غیر صفر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
پایین‌گذر فقط برای کانال LFE؛ اگر LFE موجود نباشد کاری انجام نمی‌دهد:
.Sp
.Vb 1
\&        lowpass=c=LFE
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورهای زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس پایین‌گذر.
دستور زبان برای این دستور: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر width_type پایین‌گذر.
دستور زبان برای این دستور: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای باند پایین‌گذر.
دستور زبان برای این دستور: "\fIwidth\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر میکس پایین‌گذر.
دستور زبان برای این دستور: "\fImix\fR"
.SS lv2
.IX Subsection "lv2"
بارگذاری یک پلاگین LV2 (نسخهٔ ۲ LADSPA).
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-lv2\*(C'\fR پیکربندی کنید.
.IP "\fBplugin, p\fR" 4
.IX Item "plugin, p"
شناسهٔ یکتای منبع (URI) پلاگین را مشخص می‌کند. ممکن است لازم باشد \*(Aq:\*(Aq را اسکیپ کنید.
.IP "\fBcontrols, c\fR" 4
.IX Item "controls, c"
تنظیم فهرست جداشده با \*(Aq|\*(Aq از کنترل‌ها که صفر یا چند مقدار ممیز شناور هستند و
رفتار پلاگین بارگذاری‌شده را تعیین می‌کنند (برای مثال تأخیر، آستانه یا بهره).
اگر \fBcontrols\fR روی \f(CW\*(C`help\*(C'\fR تنظیم شود، تمام کنترل‌های موجود و
محدوده‌های معتبر آن‌ها چاپ می‌شوند.
.IP "\fBsample_rate, s\fR" 4
.IX Item "sample_rate, s"
تعیین نرخ نمونه‌برداری، پیش‌فرض 44100 است. فقط در صورتی استفاده می‌شود که پلاگین ورودی صفر داشته باشد.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها به‌ازای هر کانال در هر فریم خروجی، پیش‌فرض 1024 است. فقط در صورتی استفاده
می‌شود که پلاگین ورودی صفر داشته باشد.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم حداقل مدت‌زمان صدای منبع. برای دستور زبان پذیرفته‌شده به
\&\fBبخش مدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
توجه داشته باشید که مدت‌زمان حاصل ممکن است بیشتر از مدت‌زمان مشخص‌شده باشد، زیرا صدای تولیدشده
همیشه در پایان یک فریم کامل قطع می‌شود.
اگر مشخص نشود، یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود صدا برای همیشه تولید می‌شود.
فقط در صورتی استفاده می‌شود که پلاگین ورودی صفر داشته باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال پلاگین تقویت باس از Calf:
.Sp
.Vb 1
\&        lv2=p=http\e\e\e\e://calf.sourceforge.net/plugins/BassEnhancer:c=amount=2
.Ve
.IP \(bu 4
اعمال پلاگین وینیل از Calf:
.Sp
.Vb 1
\&        lv2=p=http\e\e\e\e://calf.sourceforge.net/plugins/Vinyl:c=drone=0.2|aging=0.5
.Ve
.IP \(bu 4
اعمال پلاگین بیت کراشر از ArtyFX:
.Sp
.Vb 1
\&        lv2=p=http\e\e\e\e://www.openavproductions.com/artyfx#bitta:c=crush=0.3
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌هایی که توسط پلاگین به عنوان دستور صادر شده‌اند پشتیبانی می‌کند.
.SS mcompand
.IX Subsection "mcompand"
فشرده‌سازی یا گسترش چندباندهٔ محدودهٔ دینامیکی صدا.
.PP
صدای ورودی با استفاده از فیلترهای IIR مرتبهٔ چهارم لینک‌ویتز\-رایلی به باندها تقسیم می‌شود.
این شبیه به کراس‌اوور یک بلندگو است و در غیاب عملکرد کمپاندر منجر به پاسخ فرکانسی مسطح می‌شود.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBargs\fR 4
.IX Item "args"
دستور زبان این گزینه عبارت است از:
attack,decay,[attack,decay..] soft\-knee points crossover_frequency [delay [initial_volume [gain]]] | attack,decay ...
برای توضیح هر مورد به مستندات فیلتر compand مراجعه کنید.
.SS pan
.IX Subsection "pan"
میکس کانال‌ها با سطوح بهرهٔ مشخص. این فیلتر چینش کانال خروجی و به دنبال آن مجموعه‌ای از تعاریف
کانال‌ها را می‌پذیرد.
.PP
این فیلتر همچنین برای نگاشت مجدد بهینهٔ کانال‌های یک جریان صوتی طراحی شده است.
.PP
فیلتر پارامترهایی به این شکل را می‌پذیرد:
"\fIl\fR|\fIoutdef\fR|\fIoutdef\fR|..."
.IP \fBl\fR 4
.IX Item "l"
چینش کانال خروجی یا تعداد کانال‌ها
.IP \fBoutdef\fR 4
.IX Item "outdef"
مشخصات کانال خروجی، به شکل:
"\fIout_name\fR=[\fIgain\fR*]\fIin_name\fR[(+\-)[\fIgain\fR*]\fIin_name\fR...]"
.IP \fBout_name\fR 4
.IX Item "out_name"
کانال خروجی برای تعریف، یا نام یک کانال (FL، FR، و غیره) یا شمارهٔ یک کانال (c0، c1، و غیره)
.IP \fBgain\fR 4
.IX Item "gain"
ضریب ضربی برای کانال، مقدار 1 حجم صدا را بدون تغییر باقی می‌گذارد
.IP \fBin_name\fR 4
.IX Item "in_name"
کانال ورودی مورد استفاده، برای جزئیات به out_name مراجعه کنید؛ ترکیب کانال‌های ورودی
نام‌گذاری‌شده و شماره‌گذاری‌شده امکان‌پذیر نیست
.PP
اگر \`=\*(Aq در مشخصات کانال با \`<\*(Aq جایگزین شود، بهره‌ها برای آن مشخصات بازنرمال‌سازی
می‌شوند به طوری که مجموع آن‌ها ۱ شود و در نتیجه از نویز برش (clipping) جلوگیری به عمل آید.
.PP
\fIمثال‌های میکس\fR
.IX Subsection "Mixing examples"
.PP
برای مثال، اگر می‌خواهید تبدیل کاهشی از استریو به مونو انجام دهید، اما با ضریب بزرگ‌تری
برای کانال چپ:
.PP
.Vb 1
\&        pan=1c|c0=0.9*c0+0.1*c1
.Ve
.PP
یک تبدیل کاهشی سفارشی به استریو که به صورت خودکار برای صدای فراگیر ۳، ۴، ۵ و ۷ کاناله عمل می‌کند:
.PP
.Vb 1
\&        pan=stereo| FL < FL + 0.5*FC + 0.6*BL + 0.6*SL | FR < FR + 0.5*FC + 0.6*BR + 0.6*SR
.Ve
.PP
توجه داشته باشید که \fBffmpeg\fR یک سیستم پیش‌فرض تبدیل کاهشی (و افزایشی) را ادغام کرده است
که باید ترجیح داده شود (گزینهٔ "\-ac" را ببینید) مگر اینکه نیازهای بسیار خاصی داشته باشید.
.PP
\fIمثال‌های نگاشت مجدد\fR
.IX Subsection "Remapping examples"
.PP
نگاشت مجدد کانال مؤثر خواهد بود اگر، و فقط اگر:
.IP "*<ضرایب بهره صفر یا یک باشند،>" 4
.IX Item "*<gain coefficients are zeroes or ones,>"
.PD 0
.IP "*<فقط یک ورودی به‌ازای هر کانال خروجی باشد،>" 4
.IX Item "*<only one input per channel output,>"
.PD
.PP
اگر تمامی این شرایط برآورده شوند، فیلتر به کاربر اطلاع می‌دهد ("Pure channel mapping detected")،
و از روشی بهینه‌شده و بدون اتلاف برای انجام نگاشت مجدد استفاده می‌کند.
.PP
برای مثال، اگر یک منبع 5.1 دارید و می‌خواهید با حذف کانال‌های اضافی یک جریان صوتی استریو داشته باشید:
.PP
.Vb 1
\&        pan="stereo| c0=FL | c1=FR"
.Ve
.PP
با فرض همان منبع، می‌توانید کانال‌های چپ جلو و راست جلو را نیز جابه‌جا کرده و چینش کانال ورودی را حفظ کنید:
.PP
.Vb 1
\&        pan="5.1| c0=c1 | c1=c0 | c2=c2 | c3=c3 | c4=c4 | c5=c5"
.Ve
.PP
اگر ورودی یک جریان صوتی استریو است، می‌توانید کانال چپ جلو را بی‌صدا کنید (و همچنان چینش
کانال استریو را حفظ کنید) با:
.PP
.Vb 1
\&        pan="stereo|c1=c1"
.Ve
.PP
همچنان با یک جریان صوتی استریوی ورودی، می‌توانید کانال راست را در هر دو کانال چپ و راست جلو کپی کنید:
.PP
.Vb 1
\&        pan="stereo| c0=FR | c1=FR"
.Ve
.SS replaygain
.IX Subsection "replaygain"
فیلتر اسکنر ReplayGain. این فیلتر یک جریان صوتی را به عنوان ورودی دریافت کرده و آن را
بدون تغییر در خروجی صادر می‌کند.
در پایان فیلترسازی، \f(CW\*(C`track_gain\*(C'\fR و \f(CW\*(C`track_peak\*(C'\fR را نمایش می‌دهد.
.PP
فیلتر گزینه‌های فقط‌خواندنی صادرشدهٔ زیر را می‌پذیرد:
.IP \fBtrack_gain\fR 4
.IX Item "track_gain"
بهرهٔ تِرَک صادرشده بر حسب dB در انتهای جریان.
.IP \fBtrack_peak\fR 4
.IX Item "track_peak"
اوج تِرَک صادرشده در انتهای جریان.
.SS resample
.IX Subsection "resample"
تبدیل قالب نمونهٔ صوتی، نرخ نمونه‌برداری و چینش کانال. این فیلتر برای استفادهٔ مستقیم
در نظر گرفته نشده است.
.SS rubberband
.IX Subsection "rubberband"
اعمال کشش زمانی (time-stretching) و تغییر گام (pitch-shifting) با librubberband.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-librubberband\*(C'\fR پیکربندی کنید.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtempo\fR 4
.IX Item "tempo"
تنظیم ضریب مقیاس ضرباهنگ (tempo).
.IP \fBpitch\fR 4
.IX Item "pitch"
تنظیم ضریب مقیاس گام (pitch).
.IP \fBtransients\fR 4
.IX Item "transients"
تنظیم آشکارساز حالت‌های گذرا (transients).
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIcrisp\fR 4
.IX Item "crisp"
.PD 0
.IP \fImixed\fR 4
.IX Item "mixed"
.IP \fIsmooth\fR 4
.IX Item "smooth"
.PD
.RE
.RS 4
.RE
.IP \fBdetector\fR 4
.IX Item "detector"
تنظیم آشکارساز.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIcompound\fR 4
.IX Item "compound"
.PD 0
.IP \fIpercussive\fR 4
.IX Item "percussive"
.IP \fIsoft\fR 4
.IX Item "soft"
.PD
.RE
.RS 4
.RE
.IP \fBphase\fR 4
.IX Item "phase"
تنظیم فاز.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIlaminar\fR 4
.IX Item "laminar"
.PD 0
.IP \fIindependent\fR 4
.IX Item "independent"
.PD
.RE
.RS 4
.RE
.IP \fBwindow\fR 4
.IX Item "window"
تنظیم اندازهٔ پنجرهٔ پردازش.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIstandard\fR 4
.IX Item "standard"
.PD 0
.IP \fIshort\fR 4
.IX Item "short"
.IP \fIlong\fR 4
.IX Item "long"
.PD
.RE
.RS 4
.RE
.IP \fBsmoothing\fR 4
.IX Item "smoothing"
تنظیم هموارسازی.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIoff\fR 4
.IX Item "off"
.PD 0
.IP \fIon\fR 4
.IX Item "on"
.PD
.RE
.RS 4
.RE
.IP \fBformant\fR 4
.IX Item "formant"
فعال‌سازی حفظ سازندها (formant) هنگام تغییر گام.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIshifted\fR 4
.IX Item "shifted"
.PD 0
.IP \fIpreserved\fR 4
.IX Item "preserved"
.PD
.RE
.RS 4
.RE
.IP \fBpitchq\fR 4
.IX Item "pitchq"
تنظیم کیفیت گام.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIquality\fR 4
.IX Item "quality"
.PD 0
.IP \fIspeed\fR 4
.IX Item "speed"
.IP \fIconsistency\fR 4
.IX Item "consistency"
.PD
.RE
.RS 4
.RE
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم کانال‌ها.
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIapart\fR 4
.IX Item "apart"
.PD 0
.IP \fItogether\fR 4
.IX Item "together"
.PD
.RE
.RS 4
.RE
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورهای زیر پشتیبانی می‌کند:
.IP \fBtempo\fR 4
.IX Item "tempo"
تغییر ضریب مقیاس ضرباهنگ فیلتر.
دستور زبان برای این دستور: "\fItempo\fR"
.IP \fBpitch\fR 4
.IX Item "pitch"
تغییر ضریب مقیاس گام فیلتر.
دستور زبان برای این دستور: "\fIpitch\fR"
.SS sidechaincompress
.IX Subsection "sidechaincompress"
این فیلتر مانند یک کمپرسور معمولی عمل می‌کند، اما قابلیت فشرده‌سازی سیگنال شناسایی‌شده
را با استفاده از سیگنال ورودی دوم دارد.
به دو استریم ورودی نیاز دارد و یک استریم خروجی برمی‌گرداند.
اولین استریم ورودی بسته به سیگنال استریم دوم پردازش خواهد شد.
سپس سیگنال فیلترشده می‌تواند با فیلترهای دیگر در مراحل بعدی پردازش فیلتر شود.
فیلترهای \fBpan\fR و \fBamerge\fR را ببینید.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم بهرهٔ ورودی. پیش‌فرض 1 است. محدوده بین 0.015625 و 64 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد کمپرسور. می‌تواند \f(CW\*(C`upward\*(C'\fR یا \f(CW\*(C`downward\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`downward\*(C'\fR است.
.IP \fBthreshold\fR 4
.IX Item "threshold"
اگر سیگنال استریم دوم از این سطح فراتر رود، بر کاهش بهرهٔ استریم اول تأثیر می‌گذارد.
به‌طور پیش‌فرض 0.125 است. محدوده بین 0.00097563 و 1 است.
.IP \fBratio\fR 4
.IX Item "ratio"
تنظیم نسبتی که سیگنال بر اساس آن کاهش می‌یابد. 1:2 به این معنی است که اگر سطح 4dB بالاتر از
آستانه باشد، پس از کاهش تنها 2dB بالاتر خواهد بود. پیش‌فرض 2 است. محدوده بین 1 و 20 است.
.IP \fBattack\fR 4
.IX Item "attack"
مدت‌زمان به میلی‌ثانیه که سیگنال باید بالای آستانه بماند تا کاهش بهره آغاز شود.
پیش‌فرض 20 است. محدوده بین 0.01 و 2000 است.
.IP \fBrelease\fR 4
.IX Item "release"
مدت‌زمان به میلی‌ثانیه که سیگنال باید به زیر آستانه بیفتد تا کاهش دوباره کم شود.
پیش‌فرض 250 است. محدوده بین 0.01 و 9000 است.
.IP \fBmakeup\fR 4
.IX Item "makeup"
تنظیم مقداری که سیگنال پس از پردازش تقویت خواهد شد.
پیش‌فرض 1 است. محدوده از 1 تا 64 است.
.IP \fBknee\fR 4
.IX Item "knee"
انحنا دادن به زانوی تند در اطراف آستانه برای ورود نرم‌تر به کاهش بهره.
پیش‌فرض 2.82843 است. محدوده بین 1 و 8 است.
.IP \fBlink\fR 4
.IX Item "link"
انتخاب اینکه آیا سطح میانگین (\f(CW\*(C`average\*(C'\fR) بین تمامی کانال‌های استریم سایدچین
یا کانال بلندتر (\f(CW\*(C`maximum\*(C'\fR) بر کاهش تأثیر بگذارد.
پیش‌فرض \f(CW\*(C`average\*(C'\fR است.
.IP \fBdetection\fR 4
.IX Item "detection"
تعیین اینکه آیا سیگنال دقیق در حالت \f(CW\*(C`peak\*(C'\fR در نظر گرفته شود یا یک سیگنال RMS
در حالت \f(CW\*(C`rms\*(C'\fR. پیش‌فرض \f(CW\*(C`rms\*(C'\fR است که عمدتاً نرم‌تر عمل می‌کند.
.IP \fBlevel_sc\fR 4
.IX Item "level_sc"
تنظیم بهرهٔ سایدچین. پیش‌فرض 1 است. محدوده بین 0.015625 و 64 است.
.IP \fBmix\fR 4
.IX Item "mix"
میزان استفاده از سیگنال فشرده‌شده در خروجی. پیش‌فرض 1 است.
محدوده بین 0 و 1 است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مثال کامل ffmpeg با دریافت ۲ ورودی صوتی، که ورودی اول بسته به سیگنال ورودی دوم فشرده شده
و سپس سیگنال فشرده‌شده با ورودی دوم ادغام می‌شود:
.Sp
.Vb 1
\&        ffmpeg \-i main.flac \-i sidechain.flac \-filter_complex "[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress[compr];[compr][mix]amerge"
.Ve
.SS sidechaingate
.IX Subsection "sidechaingate"
یک گیت سایدچین مانند یک نویز گیت معمولی (باند پهن) عمل می‌کند، اما توانایی فیلتر کردن سیگنال
تشخیص‌داده‌شده را پیش از ارسال آن به مرحلهٔ کاهش بهره دارد.
به‌طور معمول یک گیت از سیگنال تمام‌محدوده برای تشخیص سطحی بالاتر از آستانه استفاده می‌کند.
برای مثال: اگر تمامی فرکانس‌های پایین‌تر را از سیگنال سایدچین خود حذف کنید، گیت تنها در صورتی
حجم صدای ترک شما را کاهش می‌دهد که فرکانس‌های بالای کافی وجود نداشته باشد. با این روش قادر خواهید بود
طنین (رزونانس) یک درام طبیعی را کاهش دهید یا «غرش و لرزش» ناشی از ضربات بی‌صداشده از یک گیتار با
دیستورشن شدید را حذف نمایید.
به دو استریم ورودی نیاز دارد و یک استریم خروجی برمی‌گرداند.
اولین استریم ورودی بسته به سیگنال استریم دوم پردازش خواهد شد.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی قبل از فیلترسازی.
پیش‌فرض 1 است. محدودهٔ مجاز از 0.015625 تا 64 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد. می‌تواند \f(CW\*(C`upward\*(C'\fR یا \f(CW\*(C`downward\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`downward\*(C'\fR است. اگر روی حالت \f(CW\*(C`upward\*(C'\fR تنظیم شود،
بخش‌های بالاتر سیگنال تقویت شده و محدودهٔ دینامیکی در جهت صعودی گسترش می‌یابد.
در غیر این صورت، در حالت \f(CW\*(C`downward\*(C'\fR بخش‌های پایین‌تر سیگنال کاهش می‌یابند.
.IP \fBrange\fR 4
.IX Item "range"
تنظیم سطح کاهش بهره هنگامی که سیگنال زیر آستانه است.
پیش‌فرض 0.06125 است. محدودهٔ مجاز از 0 تا 1 است.
تنظیم این مقدار بر روی 0 کاهش را غیرفعال کرده و سپس فیلتر مانند یک اکسپندر رفتار می‌کند.
.IP \fBthreshold\fR 4
.IX Item "threshold"
اگر یک سیگنال به بالاتر از این سطح برسد، کاهش بهره رها (متوقف) می‌شود.
پیش‌فرض 0.125 است. محدودهٔ مجاز از 0 تا 1 است.
.IP \fBratio\fR 4
.IX Item "ratio"
تنظیم نسبتی که سیگنال بر اساس آن کاهش می‌یابد.
پیش‌فرض 2 است. محدودهٔ مجاز از 1 تا 9000 است.
.IP \fBattack\fR 4
.IX Item "attack"
مدت‌زمان به میلی‌ثانیه که سیگنال باید بالای آستانه بماند تا کاهش بهره متوقف شود.
پیش‌فرض 20 میلی‌ثانیه است. محدودهٔ مجاز از 0.01 تا 9000 است.
.IP \fBrelease\fR 4
.IX Item "release"
مدت‌زمان به میلی‌ثانیه که سیگنال باید زیر آستانه بیفتد تا کاهش دوباره افزایش یابد.
پیش‌فرض 250 میلی‌ثانیه است. محدودهٔ مجاز از 0.01 تا 9000 است.
.IP \fBmakeup\fR 4
.IX Item "makeup"
تنظیم مقدار تقویت سیگنال پس از پردازش.
پیش‌فرض 1 است. محدودهٔ مجاز از 1 تا 64 است.
.IP \fBknee\fR 4
.IX Item "knee"
انحنا دادن به زانوی تند در اطراف آستانه برای ورود نرم‌تر به کاهش بهره.
پیش‌فرض 2.828427125 است. محدودهٔ مجاز از 1 تا 8 است.
.IP \fBdetection\fR 4
.IX Item "detection"
انتخاب اینکه آیا سیگنال دقیق برای تشخیص در نظر گرفته شود یا یک سیگنال شبه RMS.
پیش‌فرض rms است. می‌تواند peak یا rms باشد.
.IP \fBlink\fR 4
.IX Item "link"
انتخاب اینکه آیا سطح میانگین بین تمام کانال‌ها یا کانال بلندتر بر کاهش تأثیر بگذارد.
پیش‌فرض average است. می‌تواند average یا maximum باشد.
.IP \fBlevel_sc\fR 4
.IX Item "level_sc"
تنظیم بهرهٔ سایدچین. پیش‌فرض 1 است. محدوده از 0.015625 تا 64 است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS silencedetect
.IX Subsection "silencedetect"
تشخیص سکوت در یک استریم صوتی.
.PP
این فیلتر هنگامی که تشخیص دهد حجم صدای ورودی کمتر یا مساوی با یک مقدار تلورانس نویز برای
مدت‌زمانی بزرگ‌تر یا مساوی با حداقل مدت‌زمان نویز شناسایی‌شده است، پیامی را ثبت می‌کند.
.PP
زمان‌ها و مدت‌زمان چاپ‌شده بر حسب ثانیه بیان می‌شوند. کلید متادادهٔ
\&\f(CW\*(C`lavfi.silence_start\*(C'\fR یا \f(CW\*(C`lavfi.silence_start.X\*(C'\fR
روی اولین فریمی که برچسب زمانی آن مساوی یا بیشتر از مدت‌زمان تشخیص باشد تنظیم می‌شود
و شامل برچسب زمانی اولین فریم سکوت است.
.PP
کلیدهای متادادهٔ \f(CW\*(C`lavfi.silence_duration\*(C'\fR یا
\&\f(CW\*(C`lavfi.silence_duration.X\*(C'\fR و \f(CW\*(C`lavfi.silence_end\*(C'\fR
یا \f(CW\*(C`lavfi.silence_end.X\*(C'\fR روی اولین فریم پس از سکوت تنظیم می‌شوند.
اگر \fBmono\fR فعال باشد و هر کانال به صورت جداگانه ارزیابی شود، کلیدهای دارای پسوند
\&\f(CW\*(C`.X\*(C'\fR استفاده می‌شوند و \f(CW\*(C`X\*(C'\fR متناظر با شمارهٔ کانال است.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBnoise, n\fR" 4
.IX Item "noise, n"
تنظیم تلورانس نویز. می‌تواند بر حسب dB مشخص شود (در صورتی که "dB" به مقدار مشخص‌شده اضافه شود)
یا نسبت دامنه. پیش‌فرض \-60dB یا 0.001 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان سکوت تا زمان اعلان (پیش‌فرض ۲ ثانیه است). برای ساختار نحوی پذیرفته‌شده به
\&\fBبخش مدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR مراجعه کنید.
.IP "\fBmono, m\fR" 4
.IX Item "mono, m"
پردازش جداگانهٔ هر کانال، به جای ترکیب آن‌ها. به‌طور پیش‌فرض غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تشخیص ۵ ثانیه سکوت با تلورانس نویز \-50dB:
.Sp
.Vb 1
\&        silencedetect=n=\-50dB:d=5
.Ve
.IP \(bu 4
مثال کامل با \fBffmpeg\fR برای تشخیص سکوت با تلورانس نویز 0.0001 در \fIsilence.mp3\fR:
.Sp
.Vb 1
\&        ffmpeg \-i silence.mp3 \-af silencedetect=noise=0.0001 \-f null \-
.Ve
.SS silenceremove
.IX Subsection "silenceremove"
حذف سکوت از ابتدا، میانه یا انتهای صدا.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstart_periods\fR 4
.IX Item "start_periods"
این مقدار برای نشان دادن اینکه آیا صدا باید در ابتدای صدا بریده شود یا خیر استفاده می‌شود.
مقدار صفر نشان می‌دهد که هیچ سکوتی نباید از ابتدا بریده شود. هنگام مشخص کردن یک مقدار غیرصفر،
صدا را تا زمانی که نا-سکوت پیدا کند برش می‌دهد. به‌طور معمول، هنگام حذف سکوت از ابتدای صدا،
مقدار \fIstart_periods\fR برابر \f(CW1\fR خواهد بود اما می‌تواند به مقادیر بالاتری افزایش
یابد تا تمام صدا را تا تعداد مشخصی از دوره‌های نا-سکوت برش دهد. مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstart_duration\fR 4
.IX Item "start_duration"
مشخص کردن مقدار زمانی که نا-سکوت باید تشخیص داده شود تا برش صدا متوقف گردد. با افزایش مدت‌زمان،
انفجارهای لحظه‌ای نویز می‌توانند به عنوان سکوت در نظر گرفته شده و بریده شوند.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstart_threshold\fR 4
.IX Item "start_threshold"
این گزینه نشان می‌دهد چه مقدار نمونه باید به عنوان سکوت در نظر گرفته شود. برای صدای دیجیتال،
مقدار \f(CW0\fR ممکن است مناسب باشد اما برای صدای ضبط‌شده از آنالوگ، ممکن است بخواهید این مقدار
را برای در نظر گرفتن نویز پس‌زمینه افزایش دهید. می‌تواند بر حسب dB مشخص شود (در صورتی که "dB"
به مقدار مشخص‌شده اضافه شود) یا نسبت دامنه. مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstart_silence\fR 4
.IX Item "start_silence"
مشخص کردن حداکثر مدت‌زمان سکوت در ابتدا که پس از برش حفظ خواهد شد. پیش‌فرض 0 است، که معادل
حذف تمامی نمونه‌های تشخیص داده شده به عنوان سکوت می‌باشد.
.IP \fBstart_mode\fR 4
.IX Item "start_mode"
مشخص کردن حالت تشخیص پایان سکوت در ابتدای صدای چندکاناله.
می‌تواند \fIany\fR یا \fIall\fR باشد. پیش‌فرض \fIany\fR است.
با \fIany\fR، هر نمونه از هر کانالی که به عنوان نا-سکوت تشخیص داده شود، پایان برش سکوت در ابتدای
استریم صوتی را راه‌اندازی می‌کند.
با \fIall\fR، تنها اگر هر نمونه از تمام کانال‌ها به عنوان نا-سکوت تشخیص داده شود، پایان برش
سکوت در ابتدای استریم صوتی راه‌اندازی خواهد شد، کاربرد محدود.
.IP \fBstop_periods\fR 4
.IX Item "stop_periods"
تنظیم شمارش برای برش سکوت از انتهای صدا. هنگام مشخص کردن یک مقدار مثبت، صدا را پس از یافتن
دورهٔ سکوت مشخص‌شده برش می‌دهد. برای حذف سکوت از میانهٔ یک پرونده، یک مقدار منفی برای
\fIstop_periods\fR مشخص کنید. این مقدار سپس به عنوان یک مقدار مثبت در نظر گرفته می‌شود و برای
نشان دادن این است که اثر باید پردازش را همان‌طور که توسط \fIstop_periods\fR مشخص شده بازراه‌اندازی کند،
که آن را برای حذف دوره‌های سکوت در میانهٔ صدا مناسب می‌سازد.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstop_duration\fR 4
.IX Item "stop_duration"
مشخص کردن مدت‌زمانی از سکوت که باید پیش از توقف کپی صدا وجود داشته باشد. با مشخص کردن مدت‌زمان
بالاتر، سکوتی که مورد نیاز است می‌تواند در صدا باقی بماند.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstop_threshold\fR 4
.IX Item "stop_threshold"
این گزینه همانند \fBstart_threshold\fR است اما برای برش سکوت از انتهای صدا به کار می‌رود.
می‌تواند بر حسب dB مشخص شود (در صورتی که "dB" به مقدار مشخص‌شده پیوست شود) یا نسبت دامنه.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstop_silence\fR 4
.IX Item "stop_silence"
مشخص کردن حداکثر مدت‌زمان سکوت در انتها که پس از برش حفظ خواهد شد. پیش‌فرض 0 است، که معادل
حذف تمام نمونه‌های تشخیص‌داده‌شده به عنوان سکوت می‌باشد.
.IP \fBstop_mode\fR 4
.IX Item "stop_mode"
مشخص کردن حالت تشخیص شروع سکوت پس از آغاز صدای چندکاناله.
می‌تواند \fIany\fR یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
با \fIany\fR، هر نمونه از هر کانالی که به عنوان سکوت تشخیص داده شود، آغاز برش سکوت پس از شروع
استریم صوتی را راه‌اندازی می‌کند، کاربرد محدود.
با \fIall\fR، تنها اگر هر نمونه از تمامی کانال‌ها به عنوان سکوت تشخیص داده شود، آغاز برش سکوت
پس از شروع استریم صوتی راه‌اندازی خواهد شد.
.IP \fBdetection\fR 4
.IX Item "detection"
تنظیم نحوهٔ تشخیص سکوت.
.RS 4
.IP \fBavg\fR 4
.IX Item "avg"
میانگین مقادیر مطلق نمونه‌ها در پنجرهٔ متحرک.
.IP \fBrms\fR 4
.IX Item "rms"
جذر میانگین مربعات مقادیر مطلق نمونه‌ها در پنجرهٔ متحرک.
.IP \fBpeak\fR 4
.IX Item "peak"
حداکثر مقادیر مطلق نمونه‌ها در پنجرهٔ متحرک.
.IP \fBmedian\fR 4
.IX Item "median"
میانهٔ مقادیر مطلق نمونه‌ها در پنجرهٔ متحرک.
.IP \fBptp\fR 4
.IX Item "ptp"
قدر مطلق تفاوت اوج بیشینه تا اوج کمینه نمونه‌ها در پنجرهٔ متحرک.
.IP \fBdev\fR 4
.IX Item "dev"
انحراف معیار مقادیر نمونه‌ها در پنجرهٔ متحرک.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`rms\*(C'\fR است.
.RE
.IP \fBwindow\fR 4
.IX Item "window"
تنظیم مدت‌زمان بر حسب تعداد ثانیه‌ها که برای محاسبهٔ اندازهٔ پنجره بر حسب تعداد نمونه‌ها جهت
تشخیص سکوت استفاده می‌شود. استفاده از \f(CW0\fR عملاً هرگونه پنجره‌بندی را غیرفعال کرده و صرفاً از
یک نمونهٔ منفرد به‌ازای هر کانال برای تشخیص سکوت استفاده می‌کند. در این حالت ممکن است لازم باشد
\fBstart_silence\fR و/یا \fBstop_silence\fR به مقادیر غیرصفر به همراه \fBstart_duration\fR
و/یا \fBstop_duration\fR به مقادیر غیرصفر تنظیم شوند.
مقدار پیش‌فرض \f(CW0.02\fR است. محدودهٔ مجاز از \f(CW0\fR تا \f(CW10\fR است.
.IP \fBtimestamp\fR 4
.IX Item "timestamp"
تنظیم حالت پردازش برچسب زمانی خروجی هر فریم صوتی.
.RS 4
.IP \fBwrite\fR 4
.IX Item "write"
بازنویسی کامل برچسب‌های زمانی، فقط زمان شروع برای اولین فریم خروجی نگه‌داشته می‌شود.
.IP \fBcopy\fR 4
.IX Item "copy"
فریم‌های حذف‌نشده با همان برچسب زمانی فریم صوتی ورودی باقی می‌مانند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`write\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مثال زیر نشان می‌دهد چگونه می‌توان از این فیلتر برای شروع ضبطی استفاده کرد که فاقد تأخیر در ابتدا
(که معمولاً بین فشردن دکمهٔ ضبط و آغاز اجرا رخ می‌دهد) باشد:
.Sp
.Vb 1
\&        silenceremove=start_periods=1:start_duration=5:start_threshold=0.02
.Ve
.IP \(bu 4
حذف تمامی سکوت‌های مشاهده‌شده از ابتدا تا انتها در جایی که بیش از ۱ ثانیه سکوت در صدا وجود دارد:
.Sp
.Vb 1
\&        silenceremove=stop_periods=\-1:stop_duration=1:stop_threshold=\-90dB
.Ve
.IP \(bu 4
حذف تمامی نمونه‌های سکوت دیجیتال با استفاده از تشخیص اوج (peak) از ابتدا تا انتها، در جایی که بیش از
۰ نمونه سکوت دیجیتال در صدا وجود دارد و سکوت دیجیتال در تمامی کانال‌ها در موقعیت‌های یکسان در استریم
تشخیص داده شده است:
.Sp
.Vb 1
\&        silenceremove=window=0:detection=peak:stop_mode=all:start_mode=all:stop_periods=\-1:stop_threshold=0
.Ve
.IP \(bu 4
حذف هر دورهٔ سکوت دومِ مشاهده‌شده از ابتدا تا انتها، در جایی که بیش از ۱ ثانیه سکوت به‌ازای هر دورهٔ
سکوت در صدا وجود دارد:
.Sp
.Vb 1
\&        silenceremove=stop_periods=\-2:stop_duration=1:stop_threshold=\-90dB
.Ve
.IP \(bu 4
مشابه بالا، اما حداکثر 0.5 ثانیه سکوت از هر دورهٔ برش‌خورده نگه‌داشته شود:
.Sp
.Vb 1
\&        silenceremove=stop_periods=\-2:stop_duration=1:stop_threshold=\-90dB:stop_silence=0.5
.Ve
.IP \(bu 4
مشابه بالا، اما حداکثر 1.5 ثانیه سکوت از ابتدای صدا نگه‌داشته شود:
.Sp
.Vb 1
\&        silenceremove=stop_periods=\-2:stop_duration=1:stop_threshold=\-90dB:stop_silence=0.5:start_periods=1:start_duration=1:start_silence=1.5:stop_threshold=\-90dB
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از برخی از گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS sofalizer
.IX Subsection "sofalizer"
فیلتر SOFAlizer از توابع تبدیل وابسته به سر (HRTF) برای ایجاد بلندگوهای مجازی در اطراف کاربر
جهت گوش دادن دوگوشی (binaural) از طریق هدفون استفاده می‌کند (قالب‌های صوتی تا ۹ کانال پشتیبانی می‌شوند).
توابع HRTF در پرونده‌های SOFA ذخیره می‌شوند (برای پایگاه داده به <\fBhttp://www.sofacoustics.org\fR> مراجعه کنید).
فیلتر SOFAlizer در مؤسسهٔ تحقیقات آکوستیک (ARI) فرهنگستان علوم اتریش توسعه یافته است.
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libmysofa\*(C'\fR پیکربندی کنید.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsofa\fR 4
.IX Item "sofa"
تنظیم پروندهٔ SOFA مورد استفاده برای رندر کردن.
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم بهرهٔ اعمال‌شده به صدا. مقدار بر حسب dB است. پیش‌فرض 0 است.
.IP \fBrotation\fR 4
.IX Item "rotation"
تنظیم چرخش بلندگوهای مجازی بر حسب درجه (deg). پیش‌فرض 0 است.
.IP \fBelevation\fR 4
.IX Item "elevation"
تنظیم زاویهٔ فراز (elevation) بلندگوهای مجازی بر حسب درجه (deg). پیش‌فرض 0 است.
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم فاصله بر حسب متر بین بلندگوها و شنونده با HRTFهای میدان نزدیک (near-field).
پیش‌فرض 1 است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع پردازش. می‌تواند \fItime\fR یا \fIfreq\fR باشد. \fItime\fR پردازش صدا در حوزهٔ
زمان است که کند می‌باشد. \fIfreq\fR پردازش صدا در حوزهٔ فرکانس است که سریع می‌باشد.
پیش‌فرض \fIfreq\fR است.
.IP \fBspeakers\fR 4
.IX Item "speakers"
تنظیم موقعیت‌های سفارشی بلندگوهای مجازی. ساختار نحوی برای این گزینه عبارت است از:
<CH> <AZIM> <ELEV>[|<CH> <AZIM> <ELEV>|...].
هر بلندگوی مجازی با نام کوتاه کانال و به دنبال آن آزیموت و فراز بر حسب درجه توصیف می‌شود.
توضیحات هر بلندگوی مجازی با \*(Aq|\*(Aq جدا می‌شود.
برای مثال جهت بازنویسی موقعیت‌های کانال چپ جلو و راست جلو از:
\&\*(Aqspeakers=FL 45 15|FR 345 15\*(Aq استفاده کنید.
توضیحات با نام‌های کانال ناشناخته نادیده گرفته می‌شوند.
.IP \fBlfegain\fR 4
.IX Item "lfegain"
تنظیم بهرهٔ سفارشی برای کانال‌های LFE. مقدار بر حسب dB است. پیش‌فرض 0 است.
.IP \fBframesize\fR 4
.IX Item "framesize"
تنظیم اندازهٔ فریم سفارشی بر حسب تعداد نمونه‌ها. پیش‌فرض 1024 است.
محدودهٔ مجاز از 1024 تا 96000 است. فقط در صورتی استفاده می‌شود که گزینهٔ \fBtype\fR روی
\fIfreq\fR تنظیم شده باشد.
.IP \fBnormalize\fR 4
.IX Item "normalize"
آیا تمام پاسخ‌های ضربه (IR) هنگام وارد کردن پروندهٔ SOFA نرمال‌سازی شوند یا خیر.
به‌طور پیش‌فرض فعال است.
.IP \fBinterpolate\fR 4
.IX Item "interpolate"
آیا در صورت عدم تطابق دقیق موقعیت، نزدیک‌ترین IRها با IRهای همسایه درون‌یابی شوند یا خیر.
به‌طور پیش‌فرض غیرفعال است.
.IP \fBminphase\fR 4
.IX Item "minphase"
حداقل فاز کردن تمامی IRها هنگام بارگذاری پروندهٔ SOFA. به‌طور پیش‌فرض غیرفعال است.
.IP \fBanglestep\fR 4
.IX Item "anglestep"
تنظیم گام زاویهٔ جستجوی همسایه. فقط در صورت فعال بودن گزینهٔ \fIinterpolate\fR استفاده می‌شود.
.IP \fBradstep\fR 4
.IX Item "radstep"
تنظیم گام شعاع جستجوی همسایه. فقط در صورت فعال بودن گزینهٔ \fIinterpolate\fR استفاده می‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از پروندهٔ sofa با نام ClubFritz6:
.Sp
.Vb 1
\&        sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=1
.Ve
.IP \(bu 4
استفاده از پروندهٔ sofa با نام ClubFritz12 و شعاع بزرگ‌تر همراه با چرخش کم:
.Sp
.Vb 1
\&        sofalizer=sofa=/path/to/ClubFritz12.sofa:type=freq:radius=2:rotation=5
.Ve
.IP \(bu 4
مشابه بالا اما با موقعیت‌های سفارشی بلندگو برای چپ جلو، راست جلو، چپ عقب و راست عقب و همچنین با بهرهٔ سفارشی:
.Sp
.Vb 1
\&        "sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=2:speakers=FL 45|FR 315|BL 135|BR 225:gain=28"
.Ve
.SS speechnorm
.IX Subsection "speechnorm"
نرمال‌ساز گفتار (Speech Normalizer).
.PP
این فیلتر هر نیم‌چرخه از نمونه‌های صوتی (مجموعهٔ محلی از نمونه‌ها که همگی بالای صفر یا همگی
زیر صفر و بین دو تقاطع صفر مجاور قرار دارند) را بسته به مقدار آستانه گسترش می‌دهد یا فشرده می‌کند،
به طوری که صدا تحت شرایط کنترل‌شده توسط گزینه‌های زیر به مقدار اوج هدف برسد.
.PP
فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBpeak, p\fR" 4
.IX Item "peak, p"
تنظیم مقدار اوج هدف گسترش. این گزینه بالاترین سطح دامنهٔ مطلق مجاز را برای ورودی صوتی نرمال‌شده
مشخص می‌کند. مقدار پیش‌فرض 0.95 است. محدودهٔ مجاز از 0.0 تا 1.0 است.
.IP "\fBexpansion, e\fR" 4
.IX Item "expansion, e"
تنظیم حداکثر ضریب گسترش. محدودهٔ مجاز از 1.0 تا 50.0 است. مقدار پیش‌فرض 2.0 است.
این گزینه حداکثر گسترش نیم‌چرخهٔ محلی نمونه‌ها را کنترل می‌کند. حداکثر گسترش به گونه‌ای خواهد بود
که مقدار اوج محلی به مقدار اوج هدف برسد اما هرگز از آن فراتر نرود و نسبت بین مقدار اوج جدید و
قبلی از مقدار این گزینه فراتر نرود.
.IP "\fBcompression, c\fR" 4
.IX Item "compression, c"
تنظیم حداکثر ضریب فشرده‌سازی. محدودهٔ مجاز از 1.0 تا 50.0 است. مقدار پیش‌فرض 2.0 است.
این گزینه حداکثر فشرده‌سازی نیم‌چرخهٔ محلی نمونه‌ها را کنترل می‌کند. این گزینه تنها در صورتی
استفاده می‌شود که گزینهٔ \fBthreshold\fR بر روی مقداری بزرگ‌تر از 0.0 تنظیم شده باشد؛ در چنین
مواردی هنگامی که اوج محلی کمتر یا مساوی مقدار تنظیم‌شده توسط \fBthreshold\fR باشد، تمام نمونه‌های
متعلق به نیم‌چرخهٔ آن اوج با ضریب فشرده‌سازی فعلی فشرده خواهند شد.
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم مقدار آستانه. مقدار پیش‌فرض 0.0 است. محدودهٔ مجاز از 0.0 تا 1.0 است.
این گزینه مشخص می‌کند کدام نیم‌چرخه‌های نمونه‌ها فشرده و کدام یک گسترش خواهند یافت.
هر نمونهٔ نیم‌چرخه با مقدار اوج محلی کمتر یا مساوی با مقدار این گزینه با ضریب فشرده‌سازی
فعلی فشرده می‌شود، در غیر این صورت اگر بزرگ‌تر از مقدار آستانه باشد با ضریب گسترش گسترش می‌یابد
تا بتواند به مقدار اوج هدف برسد اما هرگز از آن فراتر نرود.
.IP "\fBraise, r\fR" 4
.IX Item "raise, r"
تنظیم میزان افزایش ضریب گسترش به‌ازای هر نیم‌چرخه از نمونه‌ها. مقدار پیش‌فرض 0.001 است.
محدودهٔ مجاز از 0.0 تا 1.0 است. این گزینه کنترل می‌کند که ضریب گسترش به‌ازای هر نیم‌چرخهٔ جدید
با چه سرعتی افزایش یابد تا به مقدار \fBexpansion\fR برسد.
تنظیم بیش از حد بالای این گزینه ممکن است منجر به اعوجاج شود.
.IP "\fBfall, f\fR" 4
.IX Item "fall, f"
تنظیم میزان افزایش ضریب فشرده‌سازی به‌ازای هر نیم‌چرخه از نمونه‌ها. مقدار پیش‌فرض 0.001 است.
محدودهٔ مجاز از 0.0 تا 1.0 است. این گزینه کنترل می‌کند که ضریب فشرده‌سازی به‌ازای هر نیم‌چرخهٔ
جدید با چه سرعتی افزایش یابد تا به مقدار \fBcompression\fR برسد.
.IP "\fBchannels, h\fR" 4
.IX Item "channels, h"
تعیین کانال‌های مورد نظر برای فیلترسازی، به‌طور پیش‌فرض تمام کانال‌های موجود فیلتر می‌شوند.
.IP "\fBinvert, i\fR" 4
.IX Item "invert, i"
فعال‌سازی فیلترسازی معکوس، به‌طور پیش‌فرض غیرفعال است. این گزینه تفسیر گزینهٔ \fBthreshold\fR
را معکوس می‌کند. در صورت فعال بودن، هر نیم‌چرخه از نمونه‌ها با مقدار اوج محلی کمتر یا مساوی گزینهٔ
\fBthreshold\fR گسترش می‌یابد و در غیر این صورت فشرده خواهد شد.
.IP "\fBlink, l\fR" 4
.IX Item "link, l"
پیوند کانال‌ها هنگام محاسبهٔ بهرهٔ اعمال‌شده به هر نمونه از کانال فیلترشده، به‌طور پیش‌فرض غیرفعال است.
در صورت غیرفعال بودن، محاسبهٔ بهرهٔ هر کانال فیلترشده مستقل است، در غیر این صورت هنگام فعال بودن
این گزینه، حداقل تمام بهره‌های ممکن برای هر کانال فیلترشده استفاده می‌شود.
.IP "\fBrms, m\fR" 4
.IX Item "rms, m"
تنظیم مقدار RMS هدف گسترش. این گزینه بالاترین سطح RMS مجاز را برای ورودی صوتی نرمال‌شده
مشخص می‌کند. مقدار پیش‌فرض 0.0 است و در نتیجه غیرفعال می‌باشد. محدودهٔ مجاز از 0.0 تا 1.0 است.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تقویت ضعیف و کند:
.Sp
.Vb 1
\&        speechnorm=e=3:r=0.00001:l=1
.Ve
.IP \(bu 4
تقویت متوسط و کند:
.Sp
.Vb 1
\&        speechnorm=e=6.25:r=0.00001:l=1
.Ve
.IP \(bu 4
تقویت قوی و سریع:
.Sp
.Vb 1
\&        speechnorm=e=12.5:r=0.0001:l=1
.Ve
.IP \(bu 4
تقویت بسیار قوی و سریع:
.Sp
.Vb 1
\&        speechnorm=e=25:r=0.0001:l=1
.Ve
.IP \(bu 4
تقویت شدید و سریع:
.Sp
.Vb 1
\&        speechnorm=e=50:r=0.0001:l=1
.Ve
.SS stereotools
.IX Subsection "stereotools"
این فیلتر ابزارهای مفیدی را برای مدیریت سیگنال‌های استریو، جهت تبدیل ضبط‌های استریوی M/S به سیگنال L/R ضمن کنترل بر روی پارامترها، یا گسترش تصویر استریوی قطعه اصلی (master track) ارائه می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح ورودی پیش از فیلتر کردن برای هر دو کانال. پیش‌فرض 1 است.
محدوده مجاز از 0.015625 تا 64 است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم سطح خروجی پس از فیلتر کردن برای هر دو کانال. پیش‌فرض 1 است.
محدوده مجاز از 0.015625 تا 64 است.
.IP \fBbalance_in\fR 4
.IX Item "balance_in"
تنظیم تراز (بالانس) ورودی میان هر دو کانال. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBbalance_out\fR 4
.IX Item "balance_out"
تنظیم تراز (بالانس) خروجی میان هر دو کانال. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBsoftclip\fR 4
.IX Item "softclip"
فعال‌سازی برش نرم (softclipping). به‌جای برش خشن دیجیتالی 0dB، منجر به اعوجاج آنالوگ می‌شود. به‌طور پیش‌فرض غیرفعال است.
.IP \fBmutel\fR 4
.IX Item "mutel"
بی‌صدا کردن کانال چپ. به‌طور پیش‌فرض غیرفعال است.
.IP \fBmuter\fR 4
.IX Item "muter"
بی‌صدا کردن کانال راست. به‌طور پیش‌فرض غیرفعال است.
.IP \fBphasel\fR 4
.IX Item "phasel"
تغییر فاز کانال چپ. به‌طور پیش‌فرض غیرفعال است.
.IP \fBphaser\fR 4
.IX Item "phaser"
تغییر فاز کانال راست. به‌طور پیش‌فرض غیرفعال است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت استریو. مقادیر موجود عبارتند از:
.RS 4
.IP \fBlr>lr\fR 4
.IX Item "lr>lr"
چپ/راست به چپ/راست؛ این مقدار پیش‌فرض است.
.IP \fBlr>ms\fR 4
.IX Item "lr>ms"
چپ/راست به Mid/Side.
.IP \fBms>lr\fR 4
.IX Item "ms>lr"
Mid/Side به چپ/راست.
.IP \fBlr>ll\fR 4
.IX Item "lr>ll"
چپ/راست به چپ/چپ.
.IP \fBlr>rr\fR 4
.IX Item "lr>rr"
چپ/راست به راست/راست.
.IP \fBlr>l+r\fR 4
.IX Item "lr>l+r"
چپ/راست به چپ + راست.
.IP \fBlr>rl\fR 4
.IX Item "lr>rl"
چپ/راست به راست/چپ.
.IP \fBms>ll\fR 4
.IX Item "ms>ll"
Mid/Side به چپ/چپ.
.IP \fBms>rr\fR 4
.IX Item "ms>rr"
Mid/Side به راست/راست.
.IP \fBms>rl\fR 4
.IX Item "ms>rl"
Mid/Side به راست/چپ.
.IP \fBlr>l\-r\fR 4
.IX Item "lr>l-r"
چپ/راست به چپ \- راست.
.RE
.RS 4
.RE
.IP \fBslev\fR 4
.IX Item "slev"
تنظیم سطح سیگنال جانبی (side). پیش‌فرض 1 است.
محدوده مجاز از 0.015625 تا 64 است.
.IP \fBsbal\fR 4
.IX Item "sbal"
تنظیم تراز سیگنال جانبی. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBmlev\fR 4
.IX Item "mlev"
تنظیم سطح سیگنال میانی (middle). پیش‌فرض 1 است.
محدوده مجاز از 0.015625 تا 64 است.
.IP \fBmpan\fR 4
.IX Item "mpan"
تنظیم پن (جهت‌گیری) سیگنال میانی. پیش‌فرض 0 است. محدوده مجاز از \-1 تا 1 است.
.IP \fBbase\fR 4
.IX Item "base"
تنظیم پایه استریو میان کانال‌های مونو و معکوس‌شده. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBdelay\fR 4
.IX Item "delay"
تنظیم میزان تأخیر کانال چپ نسبت به راست و برعکس بر حسب میلی‌ثانیه. پیش‌فرض 0 است. محدوده مجاز از \-20 تا 20 است.
.IP \fBsclevel\fR 4
.IX Item "sclevel"
تنظیم سطح S/C. پیش‌فرض 1 است. محدوده مجاز از 1 تا 100 است.
.IP \fBphase\fR 4
.IX Item "phase"
تنظیم فاز استریو به درجه. پیش‌فرض 0 است. محدوده مجاز از 0 تا 360 است.
.IP "\fBbmode_in, bmode_out\fR" 4
.IX Item "bmode_in, bmode_out"
تنظیم حالت تراز برای گزینه balance_in/balance_out.
.Sp
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBbalance\fR 4
.IX Item "balance"
حالت تراز کلاسیک. تضعیف یک کانال در هر زمان.
بهره تا 1 افزایش می‌یابد.
.IP \fBamplitude\fR 4
.IX Item "amplitude"
مشابه حالت کلاسیک بالا اما بهره تا 2 افزایش می‌یابد.
.IP \fBpower\fR 4
.IX Item "power"
توزیع توان برابر، در محدوده \-6dB تا +6dB.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال جلوه‌ای شبیه به کارائوکه:
.Sp
.Vb 1
\&        stereotools=mlev=0.015625
.Ve
.IP \(bu 4
تبدیل سیگنال M/S به L/R:
.Sp
.Vb 1
\&        "stereotools=mode=ms>lr"
.Ve
.SS stereowiden
.IX Subsection "stereowiden"
این فیلتر با تضعیف سیگنال مشترک میان هر دو کانال و ایجاد تأخیر در سیگنال چپ روی راست و برعکس، جلوه استریو را تقویت کرده و پهنای صحنه صوتی را افزایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdelay\fR 4
.IX Item "delay"
مدت زمان تأخیر سیگنال چپ روی راست و برعکس بر حسب میلی‌ثانیه.
پیش‌فرض 20 میلی‌ثانیه است.
.IP \fBfeedback\fR 4
.IX Item "feedback"
میزان بهره در سیگنال دارای تأخیر روی کانال مقابل. یک اثر تأخیری از سیگنال چپ در خروجی راست و برعکس ایجاد می‌کند که به گسترده‌تر شدن تصویر صوتی می‌انجامد. پیش‌فرض 0.3 است.
.IP \fBcrossfeed\fR 4
.IX Item "crossfeed"
تغذیه متقاطع (cross feed) چپ روی راست با فاز معکوس. این پارامتر به حذف بخش مونو کمک می‌کند. اگر مقدار آن 1 باشد، تمامی سیگنال مشترک میان هر دو کانال حذف خواهد شد. پیش‌فرض 0.3 است.
.IP \fBdrymix\fR 4
.IX Item "drymix"
تنظیم سطح سیگنال ورودی اصلی کانال (سیگنال پردازش‌نشده). پیش‌فرض 0.8 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به جز \f(CW\*(C`delay\*(C'\fR به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS superequalizer
.IX Subsection "superequalizer"
اعمال یک اکولایزر ۱۸ بانده.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fB1b\fR 4
.IX Item "1b"
تنظیم بهره باند 65Hz.
.IP \fB2b\fR 4
.IX Item "2b"
تنظیم بهره باند 92Hz.
.IP \fB3b\fR 4
.IX Item "3b"
تنظیم بهره باند 131Hz.
.IP \fB4b\fR 4
.IX Item "4b"
تنظیم بهره باند 185Hz.
.IP \fB5b\fR 4
.IX Item "5b"
تنظیم بهره باند 262Hz.
.IP \fB6b\fR 4
.IX Item "6b"
تنظیم بهره باند 370Hz.
.IP \fB7b\fR 4
.IX Item "7b"
تنظیم بهره باند 523Hz.
.IP \fB8b\fR 4
.IX Item "8b"
تنظیم بهره باند 740Hz.
.IP \fB9b\fR 4
.IX Item "9b"
تنظیم بهره باند 1047Hz.
.IP \fB10b\fR 4
.IX Item "10b"
تنظیم بهره باند 1480Hz.
.IP \fB11b\fR 4
.IX Item "11b"
تنظیم بهره باند 2093Hz.
.IP \fB12b\fR 4
.IX Item "12b"
تنظیم بهره باند 2960Hz.
.IP \fB13b\fR 4
.IX Item "13b"
تنظیم بهره باند 4186Hz.
.IP \fB14b\fR 4
.IX Item "14b"
تنظیم بهره باند 5920Hz.
.IP \fB15b\fR 4
.IX Item "15b"
تنظیم بهره باند 8372Hz.
.IP \fB16b\fR 4
.IX Item "16b"
تنظیم بهره باند 11840Hz.
.IP \fB17b\fR 4
.IX Item "17b"
تنظیم بهره باند 16744Hz.
.IP \fB18b\fR 4
.IX Item "18b"
تنظیم بهره باند 20000Hz.
.SS surround
.IX Subsection "surround"
اعمال فیلتر تبدیل صدای استریو به صدای فراگیر (surround upmix).
.PP
این فیلتر امکان تولید خروجی چندکاناله از یک جریان صوتی را فراهم می‌سازد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBchl_out\fR 4
.IX Item "chl_out"
تنظیم چیدمان کانال خروجی. به‌طور پیش‌فرض، برابر \fI5.1\fR است.
.Sp
برای اطلاع از سینتکس مورد نیاز، \fBبخش Channel Layout در راهنمای ffmpeg\-utils\|(1)\fR
را ببینید.
.IP \fBchl_in\fR 4
.IX Item "chl_in"
تنظیم چیدمان کانال ورودی. به‌طور پیش‌فرض، برابر \fIstereo\fR است.
.Sp
برای اطلاع از سینتکس مورد نیاز، \fBبخش Channel Layout در راهنمای ffmpeg\-utils\|(1)\fR
را ببینید.
.IP \fBlevel_in\fR 4
.IX Item "level_in"
تنظیم سطح بلندی صدای ورودی. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBlevel_out\fR 4
.IX Item "level_out"
تنظیم سطح بلندی صدای خروجی. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBlfe\fR 4
.IX Item "lfe"
فعال‌سازی خروجی کانال LFE (ساب‌ووفر) در صورتی که چیدمان خروجی شامل آن باشد. به‌طور پیش‌فرض فعال است.
.IP \fBlfe_low\fR 4
.IX Item "lfe_low"
تنظیم فرکانس قطع پایین LFE. به‌طور پیش‌فرض \fI128\fR Hz است.
.IP \fBlfe_high\fR 4
.IX Item "lfe_high"
تنظیم فرکانس قطع بالای LFE. به‌طور پیش‌فرض \fI256\fR Hz است.
.IP \fBlfe_mode\fR 4
.IX Item "lfe_mode"
تنظیم حالت LFE، می‌تواند \fIadd\fR یا \fIsub\fR باشد. پیش‌فرض \fIadd\fR است.
در حالت \fIadd\fR، کانال LFE از صدای ورودی تولید شده و به خروجی افزوده می‌شود.
در حالت \fIsub\fR، کانال LFE از صدای ورودی تولید شده و به خروجی افزوده می‌شود اما همچنین کانال LFE خروجی از تمامی کانال‌های خروجی غیر LFE تفریق می‌گردد.
.IP \fBsmooth\fR 4
.IX Item "smooth"
تنظیم شدت هموارسازی زمانی که برای تغییر تدریجی ضرایب هنگام دگرگونی صدای استریو در طول زمان استفاده می‌شود. محدوده مجاز از \fI0.0\fR تا \fI1.0\fR است.
برای بهبود کیفیت خروجی با مقادیر گزینه \fIfocus\fR بزرگ‌تر از \fI0.0\fR مفید است.
پیش‌فرض \fI0.0\fR است. تنها مقادیر درون این بازه و فاقد لبه‌ها مؤثر هستند.
.IP \fBangle\fR 4
.IX Item "angle"
تنظیم زاویه تبدیل صدای فراگیر استریو. محدوده مجاز از \fI0\fR تا \fI360\fR است.
پیش‌فرض \fI90\fR است.
.IP \fBfocus\fR 4
.IX Item "focus"
تنظیم کانون (تمرکز) تبدیل صدای فراگیر استریو. محدوده مجاز از \fI\-1\fR تا \fI1\fR است.
پیش‌فرض \fI0\fR است.
.IP \fBfc_in\fR 4
.IX Item "fc_in"
تنظیم بلندی صدای ورودی جلو-مرکز (front center). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBfc_out\fR 4
.IX Item "fc_out"
تنظیم بلندی صدای خروجی جلو-مرکز. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBfl_in\fR 4
.IX Item "fl_in"
تنظیم بلندی صدای ورودی جلو-چپ (front left). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBfl_out\fR 4
.IX Item "fl_out"
تنظیم بلندی صدای خروجی جلو-چپ. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBfr_in\fR 4
.IX Item "fr_in"
تنظیم بلندی صدای ورودی جلو-راست (front right). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBfr_out\fR 4
.IX Item "fr_out"
تنظیم بلندی صدای خروجی جلو-راست. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBsl_in\fR 4
.IX Item "sl_in"
تنظیم بلندی صدای ورودی کناری-چپ (side left). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBsl_out\fR 4
.IX Item "sl_out"
تنظیم بلندی صدای خروجی کناری-چپ. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBsr_in\fR 4
.IX Item "sr_in"
تنظیم بلندی صدای ورودی کناری-راست (side right). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBsr_out\fR 4
.IX Item "sr_out"
تنظیم بلندی صدای خروجی کناری-راست. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbl_in\fR 4
.IX Item "bl_in"
تنظیم بلندی صدای ورودی عقب-چپ (back left). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbl_out\fR 4
.IX Item "bl_out"
تنظیم بلندی صدای خروجی عقب-چپ. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbr_in\fR 4
.IX Item "br_in"
تنظیم بلندی صدای ورودی عقب-راست (back right). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbr_out\fR 4
.IX Item "br_out"
تنظیم بلندی صدای خروجی عقب-راست. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbc_in\fR 4
.IX Item "bc_in"
تنظیم بلندی صدای ورودی عقب-مرکز (back center). به‌طور پیش‌فرض \fI1\fR است.
.IP \fBbc_out\fR 4
.IX Item "bc_out"
تنظیم بلندی صدای خروجی عقب-مرکز. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBlfe_in\fR 4
.IX Item "lfe_in"
تنظیم بلندی صدای ورودی LFE. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBlfe_out\fR 4
.IX Item "lfe_out"
تنظیم بلندی صدای خروجی LFE. به‌طور پیش‌فرض \fI1\fR است.
.IP \fBallx\fR 4
.IX Item "allx"
تنظیم میزان گسترش تصویر استریو در راستای محور X برای تمام کانال‌ها.
محدوده مجاز از \fI\-1\fR تا \fI15\fR است.
به‌طور پیش‌فرض مقدار منفی \fI\-1\fR است و در نتیجه استفاده نمی‌شود.
.IP \fBally\fR 4
.IX Item "ally"
تنظیم میزان گسترش تصویر استریو در راستای محور Y برای تمام کانال‌ها.
محدوده مجاز از \fI\-1\fR تا \fI15\fR است.
به‌طور پیش‌فرض مقدار منفی \fI\-1\fR است و در نتیجه استفاده نمی‌شود.
.IP "\fBfcx, flx, frx, blx, brx, slx, srx, bcx\fR" 4
.IX Item "fcx, flx, frx, blx, brx, slx, srx, bcx"
تنظیم میزان گسترش تصویر استریو در راستای محور X برای هر کانال مجزا.
محدوده مجاز از \fI0.06\fR تا \fI15\fR است.
به‌طور پیش‌فرض این مقدار \fI0.5\fR است.
.IP "\fBfcy, fly, fry, bly, bry, sly, sry, bcy\fR" 4
.IX Item "fcy, fly, fry, bly, bry, sly, sry, bcy"
تنظیم میزان گسترش تصویر استریو در راستای محور Y برای هر کانال مجزا.
محدوده مجاز از \fI0.06\fR تا \fI15\fR است.
به‌طور پیش‌فرض این مقدار \fI0.5\fR است.
.IP \fBwin_size\fR 4
.IX Item "win_size"
تنظیم اندازه پنجره. محدوده مجاز از \fI1024\fR تا \fI65536\fR است. اندازه پیش‌فرض \fI4096\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره‌بندی (window function).
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP "\fBhann, hanning\fR" 4
.IX Item "hann, hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم میزان همپوشانی پنجره. در صورت تنظیم روی 1، همپوشانی توصیه‌شده برای تابع پنجره انتخاب‌شده اعمال خواهد شد. پیش‌فرض \f(CW0.5\fR است.
.SS tiltshelf
.IX Subsection "tiltshelf"
تقویت یا تضعیف فرکانس‌های پایین‌تر و تضعیف یا تقویت فرکانس‌های بالاتر صدا با استفاده از یک فیلتر قفسه‌ای (shelving) دوقطبی با پاسخی شبیه به کنترل‌های تن صدای سیستم‌های صوتی خانگی (hi-fi).
این روش به عنوان اکولایزاسیون قفسه‌ای (shelving EQ) نیز شناخته می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تعیین بهره در 0 Hz. محدوده مفید آن بین \-20 (برای تضعیف شدید) تا +20 (برای تقویت شدید) است.
هنگام استفاده از بهره مثبت مراقب پدیده برش سیگنال (clipping) باشید.
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر؛ از این گزینه می‌توان برای گسترش یا کاهش محدوده فرکانسی که باید تقویت یا تضعیف شود استفاده کرد.
مقدار پیش‌فرض \f(CW3000\fR Hz است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین شیب گذار قفسه‌ای فیلتر.
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم تعداد قطب‌ها. پیش‌فرض 2 است.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده مجاز بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
مشخص کردن کانال‌هایی که باید فیلتر شوند؛ به‌طور پیش‌فرض تمامی کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به‌طور پیش‌فرض غیرفعال است.
فعال کردن آن پاسخ دامنه در فرکانس DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلتر کردن.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه بسته به فیلترهای اطراف.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از ۱۶ بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از ۳۲ بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از ممیز شناور ۳۲ بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از ممیز شناور ۶۴ بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار روی مقداری به اندازه کافی بزرگ تنظیم شود (بزرگ‌تر از طول پاسخ ضربه که در مقادیر نزدیک به صفر بریده می‌شود)، فیلترسازی دارای فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد آرتیفکت‌های نامطلوبی ایجاد خواهد کرد.
.Sp
توجه داشته باشید در صورت تنظیم مقداری غیر از صفر، تأخیر فیلتر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از برخی گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS "treble, highshelf"
.IX Subsection "treble, highshelf"
تقویت یا تضعیف فرکانس‌های زیر (بالایی) صدا با استفاده از یک فیلتر قفسه‌ای دوقطبی با پاسخی شبیه به کنترل‌های تن صدای استاندارد در تجهیزات صوتی. این روش به عنوان اکولایزاسیون قفسه‌ای (EQ) نیز شناخته می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تعیین میزان بهره در کمترین مقدار میان ~22 kHz و فرکانس نایکوئیست (Nyquist). محدوده مفید آن بین \-20 (برای تضعیف شدید) تا +20 (برای تقویت شدید) است. هنگام استفاده از بهره مثبت مراقب پدیده برش سیگنال (clipping) باشید.
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس مرکزی فیلتر؛ بنابراین می‌تواند برای گسترش یا کاهش محدوده فرکانسی مورد نیاز برای تقویت یا تضعیف به کار رود.
مقدار پیش‌فرض \f(CW3000\fR Hz است.
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تنظیم روش تعیین پهنای باند فیلتر.
.RS 4
.IP \fBh\fR 4
.IX Item "h"
هرتز (Hz)
.IP \fBq\fR 4
.IX Item "q"
ضریب کیفیت (Q-Factor)
.IP \fBo\fR 4
.IX Item "o"
اکتاو (octave)
.IP \fBs\fR 4
.IX Item "s"
شیب (slope)
.IP \fBk\fR 4
.IX Item "k"
کیلوهرتز (kHz)
.RE
.RS 4
.RE
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تعیین شیب گذار قفسه‌ای فیلتر.
.IP "\fBpoles, p\fR" 4
.IX Item "poles, p"
تنظیم تعداد قطب‌ها. پیش‌فرض 2 است.
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
میزان استفاده از سیگنال فیلترشده در خروجی. پیش‌فرض 1 است.
محدوده مجاز بین 0 و 1 است.
.IP "\fBchannels, c\fR" 4
.IX Item "channels, c"
مشخص کردن کانال‌ها جهت فیلتر شدن؛ به‌طور پیش‌فرض تمامی کانال‌های موجود فیلتر می‌شوند.
.IP "\fBnormalize, n\fR" 4
.IX Item "normalize, n"
نرمال‌سازی ضرایب biquad؛ به‌طور پیش‌فرض غیرفعال است.
فعال‌سازی آن پاسخ دامنه در DC را روی 0dB نرمال می‌کند.
.IP "\fBtransform, a\fR" 4
.IX Item "transform, a"
تنظیم نوع تبدیل فیلتر IIR.
.RS 4
.IP \fBdi\fR 4
.IX Item "di"
.PD 0
.IP \fBdii\fR 4
.IX Item "dii"
.IP \fBtdi\fR 4
.IX Item "tdi"
.IP \fBtdii\fR 4
.IX Item "tdii"
.IP \fBlatt\fR 4
.IX Item "latt"
.IP \fBsvf\fR 4
.IX Item "svf"
.IP \fBzdf\fR 4
.IX Item "zdf"
.PD
.RE
.RS 4
.RE
.IP "\fBprecision, r\fR" 4
.IX Item "precision, r"
تنظیم دقت فیلتر کردن.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار قالب نمونه بسته به فیلترهای اطراف.
.IP \fBs16\fR 4
.IX Item "s16"
استفاده همیشگی از ۱۶ بیتی علامت‌دار.
.IP \fBs32\fR 4
.IX Item "s32"
استفاده همیشگی از ۳۲ بیتی علامت‌دار.
.IP \fBf32\fR 4
.IX Item "f32"
استفاده همیشگی از ممیز شناور ۳۲ بیتی.
.IP \fBf64\fR 4
.IX Item "f64"
استفاده همیشگی از ممیز شناور ۶۴ بیتی.
.RE
.RS 4
.RE
.IP "\fBblock_size, b\fR" 4
.IX Item "block_size, b"
تنظیم اندازه بلوک مورد استفاده برای پردازش معکوس IIR. اگر این مقدار به اندازه کافی بزرگ باشد (بزرگ‌تر از طول پاسخ ضربه که در مقادیر نزدیک به صفر بریده می‌شود)، فیلترسازی فاز خطی خواهد شد؛ در غیر این صورت اگر به اندازه کافی بزرگ نباشد آرتیفکت‌های نامطلوبی ایجاد خواهد کرد.
.Sp
توجه داشته باشید در صورت تنظیم مقداری غیر از صفر، تأخیر فیلتر دقیقاً به همین تعداد نمونه خواهد بود.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تغییر فرکانس تریبل.
سینتکس دستور عبارت است از: "\fIfrequency\fR"
.IP "\fBwidth_type, t\fR" 4
.IX Item "width_type, t"
تغییر روش تعیین پهنای باند تریبل.
سینتکس دستور عبارت است از: "\fIwidth_type\fR"
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تغییر پهنای تریبل.
سینتکس دستور عبارت است از: "\fIwidth\fR"
.IP "\fBgain, g\fR" 4
.IX Item "gain, g"
تغییر بهره تریبل.
سینتکس دستور عبارت است از: "\fIgain\fR"
.IP "\fBmix, m\fR" 4
.IX Item "mix, m"
تغییر میزان میکس تریبل.
سینتکس دستور عبارت است از: "\fImix\fR"
.SS tremolo
.IX Subsection "tremolo"
مدولاسیون دامنه سینوسی (Sinusoidal amplitude modulation).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBf\fR 4
.IX Item "f"
فرکانس مدولاسیون بر حسب هرتز. فرکانس‌های مدولاسیون در محدوده ساب‌هارمونیک (20 Hz یا کمتر) منجر به جلوه ترمولو می‌شوند.
این فیلتر همچنین می‌تواند با مشخص کردن فرکانس مدولاسیون بالاتر از 20 Hz به عنوان یک مدولاتور حلقه‌ای (ring modulator) استفاده شود.
محدوده مجاز 0.1 \- 20000.0 است. مقدار پیش‌فرض 5.0 Hz است.
.IP \fBd\fR 4
.IX Item "d"
عمق مدولاسیون به صورت درصدی بین 0.0 \- 1.0.
مقدار پیش‌فرض 0.5 است.
.SS vibrato
.IX Subsection "vibrato"
مدولاسیون فاز سینوسی (Sinusoidal phase modulation).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBf\fR 4
.IX Item "f"
فرکانس مدولاسیون بر حسب هرتز.
محدوده مجاز 0.1 \- 20000.0 است. مقدار پیش‌فرض 5.0 Hz است.
.IP \fBd\fR 4
.IX Item "d"
عمق مدولاسیون به صورت درصدی بین 0.0 \- 1.0.
مقدار پیش‌فرض 0.5 است.
.SS virtualbass
.IX Subsection "virtualbass"
اعمال فیلتر بیس مجازی (Virtual Bass) روی صدا.
.PP
این فیلتر یک ورودی استریو را دریافت کرده و خروجی استریو به همراه کانال LFE (سامانه 2.1 کاناله) تولید می‌کند.
کانال LFE جدیداً تولیدشده دارای بیس مجازی تقویت‌شده است که اصالتاً از هر دو کانال استریو به دست آمده است.
این فیلتر کانال‌های جلو-چپ و جلو-راست را بدون تغییر همان‌طور که در ورودی استریو در دسترس بوده‌اند به خروجی می‌فرستد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcutoff\fR 4
.IX Item "cutoff"
تنظیم فرکانس قطع بیس مجازی. مقدار پیش‌فرض 250 Hz است.
محدوده مجاز از 100 تا 500 Hz است.
.IP \fBstrength\fR 4
.IX Item "strength"
تنظیم شدت بیس مجازی. محدوده مجاز از 0.5 تا 3 است.
مقدار پیش‌فرض 3 است.
.SS volume
.IX Subsection "volume"
تنظیم بلندی صدای ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBvolume\fR 4
.IX Item "volume"
تنظیم عبارت ریاضی مربوط به بلندی صدا.
.Sp
مقادیر خروجی در سقف حداکثر مقدار بریده می‌شوند (clipped).
.Sp
بلندی صدای خروجی بر اساس رابطه زیر به دست می‌آید:
.Sp
.Vb 1
\&        <output_volume> = <volume> * <input_volume>
.Ve
.Sp
مقدار پیش‌فرض برای \fIvolume\fR برابر "1.0" است.
.IP \fBprecision\fR 4
.IX Item "precision"
این پارامتر دقت محاسباتی را نشان می‌دهد.
.Sp
تعیین می‌کند کدام قالب‌های نمونه ورودی مجاز خواهند بود که بر دقت مقیاس‌بندی بلندی صدا تأثیر می‌گذارد.
.RS 4
.IP \fBfixed\fR 4
.IX Item "fixed"
ممیز ثابت ۸ بیتی؛ قالب نمونه ورودی را به U8، S16 و S32 محدود می‌کند.
.IP \fBfloat\fR 4
.IX Item "float"
ممیز شناور ۳۲ بیتی؛ قالب نمونه ورودی را به FLT محدود می‌کند (پیش‌فرض).
.IP \fBdouble\fR 4
.IX Item "double"
ممیز شناور ۶۴ بیتی؛ قالب نمونه ورودی را به DBL محدود می‌کند.
.RE
.RS 4
.RE
.IP \fBreplaygain\fR 4
.IX Item "replaygain"
انتخاب رفتار هنگام مواجهه با داده‌های جانبی ReplayGain در فریم‌های ورودی.
.RS 4
.IP \fBdrop\fR 4
.IX Item "drop"
حذف داده‌های جانبی ReplayGain و نادیده گرفتن محتوای آن (پیش‌فرض).
.IP \fBignore\fR 4
.IX Item "ignore"
نادیده گرفتن داده‌های جانبی ReplayGain، اما نگه‌داشتن آن در فریم.
.IP \fBtrack\fR 4
.IX Item "track"
ترجیح دادن بهره قطعه (track gain) در صورت وجود.
.IP \fBalbum\fR 4
.IX Item "album"
ترجیح دادن بهره آلبوم (album gain) در صورت وجود.
.RE
.RS 4
.RE
.IP \fBreplaygain_preamp\fR 4
.IX Item "replaygain_preamp"
بهره پیش‌تقویت‌کننده بر حسب dB برای اعمال روی بهره انتخابی ReplayGain.
.Sp
مقدار پیش‌فرض برای \fIreplaygain_preamp\fR برابر 0.0 است.
.IP \fBreplaygain_noclip\fR 4
.IX Item "replaygain_noclip"
جلوگیری از برش سیگنال با محدود کردن بهره اعمال‌شده.
.Sp
مقدار پیش‌فرض برای \fIreplaygain_noclip\fR برابر 1 است.
.IP \fBeval\fR 4
.IX Item "eval"
تنظیم زمان ارزیابی عبارت volume.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBonce\fR 4
.IX Item "once"
ارزیابی عبارت تنها یک‌بار در حین راه‌اندازی اولیه فیلتر یا هنگام ارسال دستور \fBvolume\fR
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارت به ازای هر فریم ورودی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBonce\fR است.
.RE
.PP
عبارت volume می‌تواند شامل پارامترهای زیر باشد:
.IP \fBn\fR 4
.IX Item "n"
شماره فریم (شروع از صفر)
.IP \fBnb_channels\fR 4
.IX Item "nb_channels"
تعداد کانال‌ها
.IP \fBnb_consumed_samples\fR 4
.IX Item "nb_consumed_samples"
تعداد نمونه‌های مصرف‌شده توسط فیلتر
.IP \fBnb_samples\fR 4
.IX Item "nb_samples"
تعداد نمونه‌ها در فریم فعلی
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم اصلی در فایل؛ منسوخ شده است، استفاده نکنید
.IP \fBpts\fR 4
.IX Item "pts"
مقدار PTS فریم
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
نرخ نمونه‌برداری
.IP \fBstartpts\fR 4
.IX Item "startpts"
مقدار PTS در ابتدای جریان
.IP \fBstartt\fR 4
.IX Item "startt"
زمان در ابتدای جریان
.IP \fBt\fR 4
.IX Item "t"
زمان فریم
.IP \fBtb\fR 4
.IX Item "tb"
پایه زمانی برچسب زمان (timebase)
.IP \fBvolume\fR 4
.IX Item "volume"
آخرین مقدار تنظیم‌شده برای بلندی صدا
.PP
توجه داشته باشید که وقتی \fBeval\fR روی \fBonce\fR تنظیم شده باشد، تنها متغیرهای \fIsample_rate\fR و \fItb\fR در دسترس هستند و سایر متغیرها برابر با NAN ارزیابی خواهند شد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBvolume\fR 4
.IX Item "volume"
تغییر عبارت بلندی صدا.
این دستور از همان سینتکس گزینه متناظر پیروی می‌کند.
.Sp
در صورتی که عبارت مشخص‌شده نامعتبر باشد، مقدار قبلی حفظ می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
نصف کردن بلندی صدای ورودی:
.Sp
.Vb 3
\&        volume=volume=0.5
\&        volume=volume=1/2
\&        volume=volume=\-6.0206dB
.Ve
.Sp
در تمامی مثال‌های بالا نام کلید \fBvolume\fR را می‌توان حذف کرد، مانند:
.Sp
.Vb 1
\&        volume=0.5
.Ve
.IP \(bu 4
افزایش توان صدای ورودی به اندازه ۶ دسی‌بل با استفاده از دقت ممیز ثابت:
.Sp
.Vb 1
\&        volume=volume=6dB:precision=fixed
.Ve
.IP \(bu 4
کاهش تدریجی صدا پس از ثانیه ۱۰ با دوره ناپدیدسازی ۵ ثانیه‌ای:
.Sp
.Vb 1
\&        volume=\*(Aqif(lt(t,10),1,max(1\-(t\-10)/5,0))\*(Aq:eval=frame
.Ve
.SS volumedetect
.IX Subsection "volumedetect"
تشخیص میزان بلندی صدای ویدیوی ورودی.
.PP
این فیلتر فاقد پارامتر است. تنها از نمونه‌های صحیح علامت‌دار ۱۶ بیتی پشتیبانی می‌کند، بنابراین ورودی در صورت نیاز تبدیل خواهد شد. آمارهای مربوط به بلندی صدا پس از رسیدن به انتهای جریان ورودی در گزارش (log) چاپ می‌شود.
.PP
به‌طور خاص، این فیلتر میانگین بلندی صدا (ریشه میانگین مربعات)، حداکثر بلندی صدا (بر مبنای هر نمونه) و آغاز هیستوگرامی از مقادیر بلندی صدای ثبت‌شده (از حداکثر مقدار تا ۱/۱۰۰۰ تجمعی نمونه‌ها) را نمایش می‌دهد.
.PP
تمامی مقادیر بلندی صدا بر حسب دسی‌بل نسبت به حداکثر مقدار PCM هستند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
نمونه‌ای از خروجی لاگ در ادامه آمده است:
.PP
.Vb 9
\&        [Parsed_volumedetect_0  0xa23120] mean_volume: \-27 dB
\&        [Parsed_volumedetect_0  0xa23120] max_volume: \-4 dB
\&        [Parsed_volumedetect_0  0xa23120] histogram_4db: 6
\&        [Parsed_volumedetect_0  0xa23120] histogram_5db: 62
\&        [Parsed_volumedetect_0  0xa23120] histogram_6db: 286
\&        [Parsed_volumedetect_0  0xa23120] histogram_7db: 1042
\&        [Parsed_volumedetect_0  0xa23120] histogram_8db: 2551
\&        [Parsed_volumedetect_0  0xa23120] histogram_9db: 4609
\&        [Parsed_volumedetect_0  0xa23120] histogram_10db: 8409
.Ve
.PP
این خروجی به این معناست که:
.IP \(bu 4
انرژی میانگین مربعات تقریباً \-27 dB یا 10^\-2.7 است.
.IP \(bu 4
بزرگ‌ترین نمونه در \-4 dB یا دقیق‌تر بین \-4 dB و \-5 dB قرار دارد.
.IP \(bu 4
تعداد ۶ نمونه در \-4 dB، ۶۲ نمونه در \-5 dB، ۲۸۶ نمونه در \-6 dB و غیره وجود دارد.
.PP
به عبارت دیگر، افزایش بلندی صدا به میزان +4 dB هیچ برشی ایجاد نمی‌کند، افزایش آن به میزان +5 dB باعث برش در ۶ نمونه می‌شود و به همین ترتیب.
.SS whisper
.IX Subsection "whisper"
اجرای تشخیص خودکار گفتار با استفاده از مدل Whisper متعلق به OpenAI.
.PP
این فیلتر به عنوان پیش‌نیاز به کتابخانه whisper.cpp نیاز دارد (<https://github.com/ggml-org/whisper.cpp>). پس از نصب کتابخانه می‌توان آن را با دستور زیر فعال کرد:
\&\f(CW\*(C`./configure \-\-enable\-whisper\*(C'\fR.
.PP
این فیلتر گزینه‌های زیر را دارد:
.IP \fBmodel\fR 4
.IX Item "model"
مسیر فایل مدل دانلودشده whisper.cpp (اجباری).
.IP \fBlanguage\fR 4
.IX Item "language"
زبان مورد استفاده برای رونویسی (مقدار \*(Aqauto\*(Aq برای تشخیص خودکار).
مقدار پیش‌فرض: \f(CW"auto"\fR
.IP \fBtranslate\fR 4
.IX Item "translate"
در صورت فعال بودن، متن رونویسی‌شده از زبان مبدا به انگلیسی ترجمه می‌شود. برای فعال کردن این گزینه به یک مدل چندزبانه نیاز است.
مقدار پیش‌فرض: \f(CW"false"\fR
.IP \fBqueue\fR 4
.IX Item "queue"
حداکثر اندازه‌ای که پیش از پردازش صدا با whisper در صف فیلتر قرار می‌گیرد. با مقادیر کوچک، جریان صوتی در دفعات بیشتری پردازش می‌شود، اما کیفیت رونویسی پایین‌تر و توان پردازشی مورد نیاز بالاتر خواهد بود. با مقادیر بزرگ‌تر (مثلاً 10\-20 ثانیه)، نتایج دقیق‌تری با مصرف کمتر CPU حاصل می‌شود (مشابه ابزار whisper-cli)، اما تأخیر رونویسی بالاتر خواهد بود و برای پردازش جریان‌های بی‌درنگ مناسب نیست.
استفاده از گزینه vad_model به همراه مقدار بزرگ برای queue را مد نظر داشته باشید.
مقدار پیش‌فرض: \f(CW"3"\fR
.IP \fBuse_gpu\fR 4
.IX Item "use_gpu"
تعیین فعال بودن پشتیبانی از GPU.
مقدار پیش‌فرض: \f(CW"true"\fR
.IP \fBgpu_device\fR 4
.IX Item "gpu_device"
اندیس دستگاه GPU مورد استفاده.
مقدار پیش‌فرض: \f(CW"0"\fR
.IP \fBdestination\fR 4
.IX Item "destination"
در صورت تنظیم، خروجی رونویسی به فایل یا نشانی وب مشخص‌شده ارسال می‌شود (از یکی از پروتکل‌های AVIO در FFmpeg استفاده کنید)؛ در غیر این صورت، خروجی به صورت پیام‌های اطلاعاتی (info) لاگ خواهد شد.
همچنین خروجی در متادادای فریم تحت عنوان "lavfi.whisper.text" ذخیره می‌شود.
اگر مقصد یک فایل باشد و از قبل وجود داشته باشد، بازنویسی خواهد شد.
.IP \fBformat\fR 4
.IX Item "format"
رشته قالب مقصد؛ می‌تواند "text" (فقط متن رونویسی‌شده به مقصد ارسال می‌شود)، "srt" (قالب زیرنویس) یا "json" باشد.
مقدار پیش‌فرض: \f(CW"text"\fR
.IP \fBmax_len\fR 4
.IX Item "max_len"
حداکثر طول هر قطعه بر حسب نویسه. هنگامی که روی مقداری بزرگ‌تر از 0 تنظیم شود، قطعات رونویسی بر اساس کلمه شکسته می‌شوند تا از این طول فراتر نروند. این گزینه برای تولید زیرنویس با خطوط کوتاه‌تر بسیار کاربردی است.
مقدار پیش‌فرض: \f(CW"0"\fR
.IP \fBvad_model\fR 4
.IX Item "vad_model"
مسیر فایل مدل VAD. در صورت تنظیم، فیلتر یک ماژول تشخیص فعالیت صوتی اضافی (<https://github.com/snakers4/silero-vad>) را بارگذاری می‌کند که برای قطعه‌بندی صف صوتی به کار می‌رود؛ با تنظیم یک مسیر معتبر دریافت شده از مخزن whisper.cpp (مانند "../whisper.cpp/models/ggml-silero-v5.1.2.bin") از این گزینه استفاده کرده و پارامتر queue را به مقداری بالاتر (مانند 20) افزایش دهید.
.IP \fBvad_threshold\fR 4
.IX Item "vad_threshold"
آستانه VAD مورد استفاده.
مقدار پیش‌فرض: \f(CW"0.5"\fR
.IP \fBvad_min_speech_duration\fR 4
.IX Item "vad_min_speech_duration"
حداقل مدت زمان گفتار در VAD.
مقدار پیش‌فرض: \f(CW"0.1"\fR
.IP \fBvad_min_silence_duration\fR 4
.IX Item "vad_min_silence_duration"
حداقل مدت زمان سکوت در VAD.
مقدار پیش‌فرض: \f(CW"0.5"\fR
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اجرای رونویسی گفتار و تولید فایل srt:
.Sp
.Vb 5
\&        ffmpeg \-i input.mp4 \-vn \-af "whisper=model=../whisper.cpp/models/ggml\-base.en.bin\e
\&        :language=en\e
\&        :queue=3\e
\&        :destination=output.srt\e
\&        :format=srt" \-f null \-
.Ve
.IP \(bu 4
اجرای رونویسی گفتار و ارسال خروجی با قالب JSON به یک سرویس HTTP:
.Sp
.Vb 5
\&        ffmpeg \-i input.mp4 \-vn \-af "whisper=model=../whisper.cpp/models/ggml\-base.en.bin\e
\&        :language=en\e
\&        :queue=3\e
\&        :destination=http\e\e://localhost\e\e:3000\e
\&        :format=json\*(Aq \-f null \-
.Ve
.IP \(bu 4
رونویسی صدای ورودی از میکروفون با استفاده از گزینه VAD:
.Sp
.Vb 7
\&        ffmpeg \-loglevel warning \-f pulse \-i default \e
\&        \-af \*(Aqhighpass=f=200,lowpass=f=3000,whisper=model=../whisper.cpp/models/ggml\-medium.bin\e
\&        :language=en\e
\&        :queue=10\e
\&        :destination=\-\e
\&        :format=json\e
\&        :vad_model=../whisper.cpp/models/ggml\-silero\-v5.1.2.bin\*(Aq \-f null \-
.Ve
.SH "سورس‌های صوتی (AUDIO SOURCES)"
.IX Header "AUDIO SOURCES"
در ادامه توصیف سورس‌های صوتی در دسترس ارائه شده است.
.SS abuffer
.IX Subsection "abuffer"
بافر کردن فریم‌های صوتی و در دسترس قرار دادن آن‌ها در زنجیره فیلتر.
.PP
این سورس در اصل برای کاربردهای برنامه‌نویسی و نرم‌افزاری طراحی شده است، به‌ویژه از طریق رابط کاربری تعریف‌شده در \fIlibavfilter/buffersrc.h\fR.
.PP
این سورس پارامترهای زیر را می‌پذیرد:
.IP \fBtime_base\fR 4
.IX Item "time_base"
پایه زمانی (timebase) مورد استفاده برای برچسب‌های زمانی فریم‌های ارسال‌شده. باید یک عدد ممیز شناور یا به فرم \fInumerator\fR/\fIdenominator\fR (صورت/مخرج) باشد.
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
نرخ نمونه‌برداری بافرهای صوتی ورودی.
.IP \fBsample_fmt\fR 4
.IX Item "sample_fmt"
قالب نمونه‌برداری بافرهای صوتی ورودی.
می‌تواند نام یک قالب نمونه یا عدد صحیح معادل آن از شمارش AVSampleFormat در \fIlibavutil/samplefmt.h\fR باشد.
.IP \fBchannel_layout\fR 4
.IX Item "channel_layout"
چیدمان کانال بافرهای صوتی ورودی.
می‌تواند نام یک چیدمان کانال از channel_layout_map در \fIlibavutil/channel_layout.c\fR یا عدد صحیح معادل آن از ماکروهای AV_CH_LAYOUT_* در \fIlibavutil/channel_layout.h\fR باشد.
.IP \fBchannels\fR 4
.IX Item "channels"
تعداد کانال‌های بافرهای صوتی ورودی.
در صورت مشخص شدن هم‌زمان \fIchannels\fR و \fIchannel_layout\fR، مقادیر آن‌ها باید با یکدیگر سازگار باشند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
.Vb 1
\&        abuffer=sample_rate=44100:sample_fmt=s16p:channel_layout=stereo
.Ve
.PP
به سورس دستور می‌دهد تا استریوی علامت‌دار ۱۶ بیتی planar را با نرخ نمونه‌برداری 44100Hz بپذیرد.
از آنجا که قالب نمونه با نام "s16p" متناظر با عدد ۶ و چیدمان کانال "stereo" متناظر با مقدار 0x3 است، این دستور معادل است با:
.PP
.Vb 1
\&        abuffer=sample_rate=44100:sample_fmt=6:channel_layout=0x3
.Ve
.SS aevalsrc
.IX Subsection "aevalsrc"
تولید یک سیگنال صوتی مشخص‌شده با عبارت ریاضی.
.PP
این سورس در ورودی یک یا چند عبارت ریاضی (یکی به ازای هر کانال) را می‌پذیرد که ارزیابی شده و برای تولید سیگنال صوتی متناظر به کار می‌روند.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP \fBexprs\fR 4
.IX Item "exprs"
تنظیم فهرست عبارات جداشده با \*(Aq|\*(Aq برای هر کانال مجزا. در صورتی که گزینه \fBchannel_layout\fR مشخص نشده باشد، چیدمان کانال انتخاب‌شده به تعداد عبارات ارائه‌شده بستگی دارد. در غیر این صورت آخرین عبارت مشخص‌شده برای بقیه کانال‌های خروجی باقیمانده اعمال می‌شود.
.IP "\fBchannel_layout, c\fR" 4
.IX Item "channel_layout, c"
تنظیم چیدمان کانال. تعداد کانال‌ها در چیدمان مشخص‌شده باید برابر با تعداد عبارات ارائه‌شده باشد.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم حداقل مدت زمان صدای تولیدی. برای اطلاع از سینتکس معتبر، \fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR را ببینید.
توجه داشته باشید که مدت زمان حاصل ممکن است بیشتر از مقدار مشخص‌شده باشد، چرا که صدای تولیدشده همیشه در پایان یک فریم کامل بریده می‌شود.
.Sp
در صورت عدم تعیین، یا منفی بودن مقدار مدت زمان، فرض می‌شود که صدا باید برای همیشه تولید شود.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها به ازای هر کانال در هر فریم خروجی؛ پیش‌فرض 1024 است.
.IP "\fBsample_rate, s\fR" 4
.IX Item "sample_rate, s"
مشخص کردن نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.PP
هر عبارت در \fIexprs\fR می‌تواند شامل ثابت‌های زیر باشد:
.IP \fBn\fR 4
.IX Item "n"
شماره نمونه ارزیابی‌شده، شروع از 0
.IP \fBt\fR 4
.IX Item "t"
زمان نمونه ارزیابی‌شده بر حسب ثانیه، شروع از 0
.IP \fBs\fR 4
.IX Item "s"
نرخ نمونه‌برداری
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید سکوت:
.Sp
.Vb 1
\&        aevalsrc=0
.Ve
.IP \(bu 4
تولید سیگنال سینوسی با فرکانس 440 Hz، تنظیم نرخ نمونه‌برداری روی 8000 Hz:
.Sp
.Vb 1
\&        aevalsrc="sin(440*2*PI*t):s=8000"
.Ve
.IP \(bu 4
تولید سیگنال دو کاناله با مشخص کردن صریح چیدمان کانال (جلو-مرکز + عقب-مرکز):
.Sp
.Vb 1
\&        aevalsrc="sin(420*2*PI*t)|cos(430*2*PI*t):c=FC|BC"
.Ve
.IP \(bu 4
تولید نویز سفید:
.Sp
.Vb 1
\&        aevalsrc="\-2+random(0)"
.Ve
.IP \(bu 4
تولید یک سیگنال با مدولاسیون دامنه:
.Sp
.Vb 1
\&        aevalsrc="sin(10*2*PI*t)*sin(880*2*PI*t)"
.Ve
.IP \(bu 4
تولید ضربان دوگوشی (binaural beats) با فرکانس 2.5 Hz روی موج حامل 360 Hz:
.Sp
.Vb 1
\&        aevalsrc="0.1*sin(2*PI*(360\-2.5/2)*t) | 0.1*sin(2*PI*(360+2.5/2)*t)"
.Ve
.SS afdelaysrc
.IX Subsection "afdelaysrc"
تولید ضرایب FIR برای تأخیر کسری (fractional delay).
.PP
جریان حاصل را می‌توان به همراه فیلتر \fBafir\fR برای فیلتر کردن سیگنال صوتی به کار برد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBdelay, d\fR" 4
.IX Item "delay, d"
تنظیم تأخیر کسری. پیش‌فرض 0 است.
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تنظیم نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم. پیش‌فرض 1024 است.
.IP "\fBtaps, t\fR" 4
.IX Item "taps, t"
تنظیم تعداد ضرایب فیلتر در جریان صوتی خروجی.
مقدار پیش‌فرض 0 است.
.IP "\fBchannel_layout, c\fR" 4
.IX Item "channel_layout, c"
چیدمان کانال را تعیین می‌کند و می‌تواند رشته‌ای نمایانگر یک چیدمان کانال باشد.
مقدار پیش‌فرض \fIchannel_layout\fR برابر "stereo" است.
.SS afireqsrc
.IX Subsection "afireqsrc"
تولید ضرایب اکولایزر FIR.
.PP
جریان حاصل را می‌توان به همراه فیلتر \fBafir\fR برای فیلتر کردن سیگنال صوتی به کار برد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBpreset, p\fR" 4
.IX Item "preset, p"
تنظیم پیش‌تنظیم اکولایزر.
پیش‌تنظیم پیش‌فرض \f(CW\*(C`flat\*(C'\fR است.
.Sp
پیش‌تنظیم‌های موجود عبارتند از:
.RS 4
.IP \fBcustom\fR 4
.IX Item "custom"
.PD 0
.IP \fBflat\fR 4
.IX Item "flat"
.IP \fBacoustic\fR 4
.IX Item "acoustic"
.IP \fBbass\fR 4
.IX Item "bass"
.IP \fBbeats\fR 4
.IX Item "beats"
.IP \fBclassic\fR 4
.IX Item "classic"
.IP \fBclear\fR 4
.IX Item "clear"
.IP "\fBdeep bass\fR" 4
.IX Item "deep bass"
.IP \fBdubstep\fR 4
.IX Item "dubstep"
.IP \fBelectronic\fR 4
.IX Item "electronic"
.IP \fBhard\-style\fR 4
.IX Item "hard-style"
.IP \fBhip\-hop\fR 4
.IX Item "hip-hop"
.IP \fBjazz\fR 4
.IX Item "jazz"
.IP \fBmetal\fR 4
.IX Item "metal"
.IP \fBmovie\fR 4
.IX Item "movie"
.IP \fBpop\fR 4
.IX Item "pop"
.IP \fBr&b\fR 4
.IX Item "r&b"
.IP \fBrock\fR 4
.IX Item "rock"
.IP "\fBvocal booster\fR" 4
.IX Item "vocal booster"
.PD
.RE
.RS 4
.RE
.IP "\fBgains, g\fR" 4
.IX Item "gains, g"
تنظیم بهره‌های سفارشی برای هر باند. تنها در صورتی استفاده می‌شود که گزینه preset روی \f(CW\*(C`custom\*(C'\fR تنظیم شده باشد.
بهره‌ها با فاصله‌های خالی (whitespace) جدا می‌شوند و هر بهره بر حسب dBFS مشخص می‌گردد.
پیش‌فرض \f(CW\*(C`0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0\*(C'\fR است.
.IP "\fBbands, b\fR" 4
.IX Item "bands, b"
تنظیم باندهای سفارشی که بهره‌های اکولایزر سفارشی بر اساس آن‌ها تعیین می‌شوند.
این مقادیر باید ترتیبی اکیداً صعودی داشته باشند. تنها در صورتی استفاده می‌شود که گزینه preset روی \f(CW\*(C`custom\*(C'\fR تنظیم شده باشد.
باندها با فاصله‌های خالی جدا می‌شوند و هر باند نمایانگر فرکانس بر حسب Hz است.
پیش‌فرض \f(CW\*(C`25 40 63 100 160 250 400 630 1000 1600 2500 4000 6300 10000 16000 24000\*(C'\fR است.
.IP "\fBtaps, t\fR" 4
.IX Item "taps, t"
تنظیم تعداد ضرایب فیلتر در جریان صوتی خروجی.
مقدار پیش‌فرض \f(CW4096\fR است.
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تنظیم نرخ نمونه‌برداری جریان صوتی خروجی؛ پیش‌فرض \f(CW44100\fR است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها به ازای هر فریم در جریان صوتی خروجی. پیش‌فرض \f(CW1024\fR است.
.IP "\fBinterp, i\fR" 4
.IX Item "interp, i"
تنظیم روش درون‌یابی برای ضرایب اکولایزر FIR. می‌تواند \f(CW\*(C`linear\*(C'\fR یا \f(CW\*(C`cubic\*(C'\fR باشد.
.IP "\fBphase, h\fR" 4
.IX Item "phase, h"
تنظیم نوع فاز فیلتر FIR. می‌تواند \f(CW\*(C`linear\*(C'\fR یا \f(CW\*(C`min\*(C'\fR (حداقل فاز) باشد.
پیش‌فرض فیلتر حداقل فاز (minimum\-phase) است.
.SS afirsrc
.IX Subsection "afirsrc"
تولید ضرایب فیلتر FIR با استفاده از روش نمونه‌برداری فرکانسی.
.PP
جریان حاصل را می‌توان به همراه فیلتر \fBafir\fR برای فیلتر کردن سیگنال صوتی استفاده کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBtaps, t\fR" 4
.IX Item "taps, t"
تنظیم تعداد ضرایب فیلتر در جریان صوتی خروجی.
مقدار پیش‌فرض 1025 است.
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم نقاط فرکانسی که اندازه دامنه و فاز از آنجا تعیین می‌شوند.
این مقادیر باید ترتیبی غیرنزولی داشته باشند، اولین عضو باید 0 و آخرین عضو باید 1 باشد. اعضا با فاصله‌های خالی جدا می‌شوند.
.IP "\fBmagnitude, m\fR" 4
.IX Item "magnitude, m"
تنظیم مقدار دامنه به ازای هر نقطه فرکانسی تعیین‌شده توسط \fBfrequency\fR.
تعداد مقادیر باید با تعداد نقاط فرکانسی برابر باشد.
مقادیر با فاصله‌های خالی جدا می‌شوند.
.IP "\fBphase, p\fR" 4
.IX Item "phase, p"
تنظیم مقدار فاز به ازای هر نقطه فرکانسی تعیین‌شده توسط \fBfrequency\fR.
تعداد مقادیر باید با تعداد نقاط فرکانسی برابر باشد.
مقادیر با فاصله‌های خالی جدا می‌شوند.
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تنظیم نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم. پیش‌فرض 1024 است.
.IP "\fBwin_func, w\fR" 4
.IX Item "win_func, w"
تنظیم تابع پنجره‌بندی. پیش‌فرض blackman است.
.SS anullsrc
.IX Subsection "anullsrc"
سورس صوتی تهی؛ فریم‌های صوتی پردازش‌نشده را بازمی‌گرداند. این فیلتر عمدتاً به عنوان الگو و برای استفاده در ابزارهای تحلیل و خطایابی، یا به عنوان منبعی برای فیلترهایی که داده‌های ورودی را نادیده می‌گیرند (مانند فیلتر سنتز sox) کاربرد دارد.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBchannel_layout, cl\fR" 4
.IX Item "channel_layout, cl"
تعیین چیدمان کانال، می‌تواند عدد صحیح یا رشته‌ای نشان‌دهنده یک چیدمان کانال باشد. مقدار پیش‌فرض \fIchannel_layout\fR برابر "stereo" است.
.Sp
تعریف channel_layout_map در \fIlibavutil/channel_layout.c\fR را برای نگاشت میان رشته‌ها و مقادیر چیدمان کانال بررسی کنید.
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تعیین نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم درخواستی.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت زمان صدای منبع. برای آگاهی از سینتکس مورد پذیرش، \fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR را ببینید.
.Sp
در صورت عدم تعیین، یا منفی بودن مدت زمان بیان‌شده، فرض می‌شود صدا برای همیشه تولید خواهد شد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تنظیم نرخ نمونه‌برداری روی 48000 Hz و چیدمان کانال روی AV_CH_LAYOUT_MONO:
.Sp
.Vb 1
\&        anullsrc=r=48000:cl=4
.Ve
.IP \(bu 4
انجام همان عملیات با سینتکسی واضح‌تر:
.Sp
.Vb 1
\&        anullsrc=r=48000:cl=mono
.Ve
.PP
تمامی پارامترها باید به‌طور صریح تعریف شوند.
.SS flite
.IX Subsection "flite"
تولید گفتار صوتی با استفاده از کتابخانه libflite.
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با سوییچ \f(CW\*(C`\-\-enable\-libflite\*(C'\fR پیکربندی کنید.
.PP
توجه داشته باشید که نسخه‌های قدیمی‌تر از 2.0 کتابخانه flite از نظر همروندی (thread\-safe) امن نیستند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlist_voices\fR 4
.IX Item "list_voices"
اگر روی 1 تنظیم شود، نام صداهای در دسترس را فهرست کرده و بلافاصله خارج می‌شود. مقدار پیش‌فرض 0 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم حداکثر تعداد نمونه‌ها در هر فریم. مقدار پیش‌فرض 512 است.
.IP \fBtextfile\fR 4
.IX Item "textfile"
تنظیم نام فایل حاوی متنی که باید خوانده شود.
.IP \fBtext\fR 4
.IX Item "text"
تنظیم متنی که باید خوانده شود.
.IP "\fBvoice, v\fR" 4
.IX Item "voice, v"
تنظیم صدای مورد استفاده برای تبدیل متن به گفتار. مقدار پیش‌فرض \f(CW\*(C`kal\*(C'\fR است. همچنین گزینه \fIlist_voices\fR را ببینید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
خواندن متن از فایل \fIspeech.txt\fR و تبدیل آن به گفتار با استفاده از صدای استاندارد flite:
.Sp
.Vb 1
\&        flite=textfile=speech.txt
.Ve
.IP \(bu 4
خواندن متن مشخص‌شده با انتخاب صدای \f(CW\*(C`slt\*(C'\fR:
.Sp
.Vb 1
\&        flite=text=\*(AqSo fare thee well, poor devil of a Sub\-Sub, whose commentator I am\*(Aq:voice=slt
.Ve
.IP \(bu 4
ارسال متن ورودی به ffmpeg:
.Sp
.Vb 1
\&        ffmpeg \-f lavfi \-i flite=text=\*(AqSo fare thee well, poor devil of a Sub\-Sub, whose commentator I am\*(Aq:voice=slt
.Ve
.IP \(bu 4
خواندن متن با ابزار \fIffplay\fR با استفاده از \f(CW\*(C`flite\*(C'\fR و دستگاه \f(CW\*(C`lavfi\*(C'\fR:
.Sp
.Vb 1
\&        ffplay \-f lavfi flite=text=\*(AqNo more be grieved for which that thou hast done.\*(Aq
.Ve
.PP
برای دریافت اطلاعات بیشتر درباره libflite، این پیوند را بررسی کنید:
<\fBhttp://www.festvox.org/flite\fR>
.SS anoisesrc
.IX Subsection "anoisesrc"
تولید یک سیگنال صوتی نویز.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تعیین نرخ نمونه‌برداری. مقدار پیش‌فرض 48000 Hz است.
.IP "\fBamplitude, a\fR" 4
.IX Item "amplitude, a"
تعیین دامنه (0.0 \- 1.0) برای جریان صوتی تولیدشده. مقدار پیش‌فرض 1.0 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تعیین مدت زمان جریان صوتی تولیدشده. عدم تعیین این گزینه منجر به تولید نویزی با طول نامتناهی می‌شود.
.IP "\fBcolor, colour, c\fR" 4
.IX Item "color, colour, c"
تعیین رنگ نویز. رنگ‌های نویز در دسترس عبارتند از: white (سفید)، pink (صورتی)، brown (قهوه‌ای)، blue (آبی)، violet (بنفش) و velvet (مخملی). رنگ پیش‌فرض white است.
.IP "\fBseed, s\fR" 4
.IX Item "seed, s"
تعیین یک مقدار بذر (seed) برای مولد اعداد شبه‌تصادفی (PRNG).
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم خروجی؛ پیش‌فرض 1024 است.
.IP \fBdensity\fR 4
.IX Item "density"
تنظیم چگالی (0.0 \- 1.0) برای مولد نویز مخملی (velvet)؛ پیش‌فرض 0.05 است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید ۶۰ ثانیه نویز صورتی، با نرخ نمونه‌برداری 44.1 kHz و دامنه 0.5:
.Sp
.Vb 1
\&        anoisesrc=d=60:c=pink:r=44100:a=0.5
.Ve
.SS hilbert
.IX Subsection "hilbert"
تولید ضرایب FIR تبدیل هیلبرت با مرتبه فرد (odd\-tap).
.PP
جریان حاصل را می‌توان به همراه فیلتر \fBafir\fR برای تغییر فاز ۹۰ درجه‌ای سیگنال استفاده کرد.
.PP
این روش در بسیاری از الگوهای کدگذاری ماتریسی و برای تولید سیگنال تحلیلی به کار می‌رود. این فرآیند معمولاً به صورت ضرب در i (یا j)، واحد موهومی، نمایش داده می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsample_rate, s\fR" 4
.IX Item "sample_rate, s"
تنظیم نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBtaps, t\fR" 4
.IX Item "taps, t"
تنظیم طول فیلتر FIR؛ پیش‌فرض 22051 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم.
.IP "\fBwin_func, w\fR" 4
.IX Item "win_func, w"
تنظیم تابع پنجره‌بندی مورد استفاده هنگام تولید ضرایب FIR.
.SS sinc
.IX Subsection "sinc"
تولید ضرایب فیلتر FIR پایین‌گذر، بالاگذر، میان‌گذر یا میان‌ناگذر sinc با استفاده از پنجره کایزر (kaiser-windowed).
.PP
جریان حاصل را می‌توان به همراه فیلتر \fBafir\fR برای فیلتر کردن سیگنال صوتی به کار برد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
تنظیم نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBnb_samples, n\fR" 4
.IX Item "nb_samples, n"
تنظیم تعداد نمونه‌ها در هر فریم. پیش‌فرض 1024 است.
.IP \fBhp\fR 4
.IX Item "hp"
تنظیم فرکانس بالاگذر. پیش‌فرض 0 است.
.IP \fBlp\fR 4
.IX Item "lp"
تنظیم فرکانس پایین‌گذر. پیش‌فرض 0 است.
اگر فرکانس بالاگذر کمتر از فرکانس پایین‌گذر باشد و فرکانس پایین‌گذر بزرگ‌تر از 0 باشد، فیلتر ضرایب فیلتر میان‌گذر (band\-pass) تولید خواهد کرد، در غیر این صورت ضرایب فیلتر میان‌ناگذر (band\-reject) ایجاد می‌کند.
.IP \fBphase\fR 4
.IX Item "phase"
تنظیم پاسخ فاز فیلتر. پیش‌فرض 50 است. محدوده مجاز از 0 تا 100 است.
.IP \fBbeta\fR 4
.IX Item "beta"
تنظیم بتای پنجره کایزر (Kaiser window beta).
.IP \fBatt\fR 4
.IX Item "att"
تنظیم میزان تضعیف باند توقف (stop\-band attenuation). پیش‌فرض 120dB است، محدوده مجاز از 40 تا 180 dB است.
.IP \fBround\fR 4
.IX Item "round"
فعال‌سازی گرد کردن؛ به‌طور پیش‌فرض غیرفعال است.
.IP \fBhptaps\fR 4
.IX Item "hptaps"
تنظیم تعداد تپ‌ها (ضرایب) برای فیلتر بالاگذر.
.IP \fBlptaps\fR 4
.IX Item "lptaps"
تنظیم تعداد تپ‌ها (ضرایب) برای فیلتر پایین‌گذر.
.SS sine
.IX Subsection "sine"
تولید یک سیگنال صوتی متشکل از یک موج سینوسی با دامنه 1/8.
.PP
این سیگنال صوتی از نظر بیتی کاملاً دقیق (bit\-exact) است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfrequency, f\fR" 4
.IX Item "frequency, f"
تنظیم فرکانس موج حامل. پیش‌فرض 440 Hz است.
.IP "\fBbeep_factor, b\fR" 4
.IX Item "beep_factor, b"
فعال‌سازی یک بوق دوره‌ای در هر ثانیه با فرکانس \fIbeep_factor\fR برابر فرکانس حامل. پیش‌فرض 0 است، به این معنی که صدای بوق غیرفعال است.
.IP "\fBsample_rate, r\fR" 4
.IX Item "sample_rate, r"
مشخص کردن نرخ نمونه‌برداری؛ پیش‌فرض 44100 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
مشخص کردن مدت زمان جریان صوتی تولیدشده.
.IP \fBsamples_per_frame\fR 4
.IX Item "samples_per_frame"
تنظیم تعداد نمونه‌ها در هر فریم خروجی.
.Sp
عبارت ریاضی می‌تواند شامل ثابت‌های زیر باشد:
.RS 4
.IP \fBn\fR 4
.IX Item "n"
شماره ترتیبی فریم صوتی خروجی، شروع از 0.
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمان ارائه (Presentation TimeStamp - PTS) فریم صوتی خروجی، بر حسب واحدهای \fITB\fR.
.IP \fBt\fR 4
.IX Item "t"
مقدار PTS فریم صوتی خروجی، بر حسب ثانیه.
.IP \fBTB\fR 4
.IX Item "TB"
پایه زمانی (timebase) فریم‌های صوتی خروجی.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW1024\fR است.
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک موج سینوسی ساده 440 Hz:
.Sp
.Vb 1
\&        sine
.Ve
.IP \(bu 4
تولید یک موج سینوسی 220 Hz همراه با بوق 880 Hz در هر ثانیه، به مدت ۵ ثانیه:
.Sp
.Vb 3
\&        sine=220:4:d=5
\&        sine=f=220:b=4:d=5
\&        sine=frequency=220:beep_factor=4:duration=5
.Ve
.IP \(bu 4
تولید یک موج سینوسی 1 kHz بر اساس الگوی NTSC به صورت \f(CW\*(C`1602,1601,1602,1601,1602\*(C'\fR:
.Sp
.Vb 1
\&        sine=1000:samples_per_frame=\*(Aqst(0,mod(n,5)); 1602\-not(not(eq(ld(0),1)+eq(ld(0),3)))\*(Aq
.Ve
.SH "سینک‌های صوتی (AUDIO SINKS)"
.IX Header "AUDIO SINKS"
در ادامه توصیف سینک‌های صوتی در دسترس ارائه شده است.
.SS abuffersink
.IX Subsection "abuffersink"
بافر کردن فریم‌های صوتی و در دسترس قرار دادن آن‌ها در انتهای زنجیره فیلتر.
.PP
این سینک در اصل برای کاربردهای برنامه‌نویسی طراحی شده است، به‌ویژه از طریق رابط کاربری تعریف‌شده در \fIlibavfilter/buffersink.h\fR یا سیستم گزینه‌ها.
.PP
این سینک اشاره‌گری به ساختار AVABufferSinkContext را می‌پذیرد که قالب بافرهای ورودی را تعریف می‌کند، تا به عنوان پارامتر مات (opaque) برای راه‌اندازی اولیه به \f(CW\*(C`avfilter_init_filter\*(C'\fR ارسال شود.
.SS anullsink
.IX Subsection "anullsink"
سینک صوتی تهی؛ مطلقاً هیچ کاری با صدای ورودی انجام نمی‌دهد.
این سینک عمدتاً به عنوان یک الگو و برای استفاده در ابزارهای تحلیل و خطایابی مفید است.
.SH "فیلترهای ویدیو (VIDEO FILTERS)"
.IX Header "VIDEO FILTERS"
هنگام پیکربندی ساخت FFmpeg خود، می‌توانید هر یک از فیلترهای موجود را با استفاده از \f(CW\*(C`\-\-disable\-filters\*(C'\fR غیرفعال کنید.
خروجی configure فیلترهای ویدیویی گنجانده‌شده در ساخت شما را نمایش خواهد داد.
.PP
در ادامه توصیف فیلترهای ویدیویی در دسترس فعلی ارائه شده است.
.SS addroi
.IX Subsection "addroi"
علامت‌گذاری یک ناحیه مورد علاقه (Region of Interest - ROI) در یک فریم ویدیویی.
.PP
داده‌های فریم بدون تغییر عبور داده می‌شوند، اما متاداده‌ای به فریم ضمیمه می‌شود که نواحی مورد علاقه را نشان می‌دهد و می‌تواند بر رفتار انکودینگ بعدی تأثیر بگذارد. با اعمال چندباره فیلتر می‌توان چندین ناحیه را علامت‌گذاری کرد.
.IP \fBx\fR 4
.IX Item "x"
فاصله ناحیه بر حسب پیکسل از لبه چپ فریم.
.IP \fBy\fR 4
.IX Item "y"
فاصله ناحیه بر حسب پیکسل از لبه بالایی فریم.
.IP \fBw\fR 4
.IX Item "w"
عرض ناحیه بر حسب پیکسل.
.IP \fBh\fR 4
.IX Item "h"
ارتفاع ناحیه بر حسب پیکسل.
.Sp
پارامترهای \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR عبارات ریاضی هستند و می‌توانند شامل متغیرهای زیر باشند:
.RS 4
.IP \fBiw\fR 4
.IX Item "iw"
عرض فریم ورودی.
.IP \fBih\fR 4
.IX Item "ih"
ارتفاع فریم ورودی.
.RE
.RS 4
.RE
.IP \fBqoffset\fR 4
.IX Item "qoffset"
آفست کوانتیزاسیون برای اعمال در داخل ناحیه.
.Sp
این مقدار باید یک عدد حقیقی در محدوده \-1 تا +1 باشد. مقدار صفر نشان‌دهنده عدم تغییر در کیفیت است. مقدار منفی کیفیت بهتر (کوانتیزاسیون کمتر) و مقدار مثبت کیفیت پایین‌تر (کوانتیزاسیون بیشتر) را درخواست می‌کند.
.Sp
این محدوده به‌گونه‌ای کالیبره شده است که مقادیر حدی نشان‌دهنده بزرگ‌ترین آفست ممکن باشند \- اگر بقیه فریم با بدترین کیفیت ممکن انکود شود، آفست \-1 نشان می‌دهد که این ناحیه در هر صورت باید با بهترین کیفیت ممکن انکود گردد. مقادیر میانی سپس به روشی وابسته به کدک درون‌یابی می‌شوند.
.Sp
برای نمونه، در H.264 ده‌بیتی پارامتر کوانتیزاسیون بین \-12 و 51 تغییر می‌کند. بنابراین یک مقدار نوعی qoffset برابر با \-1/10 نشان می‌دهد که این ناحیه باید با QP حدود یک‌دهمِ کلِ دامنه بهتر از بقیه فریم انکود شود. بنابراین، اگر بیشتر فریم با QP حدود 30 انکود شود، این ناحیه QP حدود 24 دریافت خواهد کرد (آفست تقریبی \-1/10 * (51 \- \-12) = \-6.3). یک مقدار حدی \-1 نشان می‌دهد که این ناحیه صرف‌نظر از چگونگی انکود بقیه فریم باید با بهترین کیفیت ممکن انکود شود \- یعنی باید در QP برابر \-12 انکود گردد.
.IP \fBclear\fR 4
.IX Item "clear"
در صورت تنظیم روی true، قبل از افزودن ناحیه جدید، هر ناحیه مورد علاقه از پیش علامت‌گذاری‌شده روی فریم حذف می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
علامت‌گذاری یک‌چهارم مرکزی فریم به عنوان ناحیه مورد علاقه:
.Sp
.Vb 1
\&        addroi=iw/4:ih/4:iw/2:ih/2:\-1/10
.Ve
.IP \(bu 4
علامت‌گذاری ناحیه‌ای به عرض ۱۰۰ پیکسل در لبه سمت چپ فریم به عنوان ناحیه‌ای بسیار کم‌اهمیت (جهت انکود با کیفیتی بسیار پایین‌تر از بقیه فریم):
.Sp
.Vb 1
\&        addroi=0:0:100:ih:+1/5
.Ve
.SS alphaextract
.IX Subsection "alphaextract"
استخراج مولفه آلفا از ورودی به عنوان یک ویدیوی در مقیاس خاکستری (grayscale). این فیلتر به ویژه همراه با فیلتر \fIalphamerge\fR کاربرد دارد.
.SS alphamerge
.IX Subsection "alphamerge"
افزودن یا جایگزینی مولفه آلفای ورودی اصلی با مقدار مقیاس خاکستری یک ورودی دوم. این فیلتر برای استفاده به همراه \fIalphaextract\fR در نظر گرفته شده است تا امکان انتقال یا ذخیره‌سازی دنباله فریم‌های دارای کانال آلفا را در قالبی که از کانال آلفا پشتیبانی نمی‌کند فراهم سازد.
.PP
برای نمونه، جهت بازسازی فریم‌های کامل از یک ویدیوی معمولی انکودشده با YUV و یک ویدیوی جداگانه ایجادشده با \fIalphaextract\fR، می‌توانید از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        movie=in_alpha.mkv [alpha]; [in][alpha] alphamerge [out]
.Ve
.SS amplify
.IX Subsection "amplify"
تقویت تفاوت‌های میان پیکسل فعلی و پیکسل‌های فریم‌های مجاور در همان موقعیت مکانی پیکسل.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم شعاع فریم. پیش‌فرض 2 است. محدوده مجاز از 1 تا 63 است.
برای مثال، شعاع 3 به فیلتر دستور می‌دهد میانگین 7 فریم را محاسبه کند.
.IP \fBfactor\fR 4
.IX Item "factor"
تنظیم ضریب تقویت تفاوت. پیش‌فرض 2 است. محدوده مجاز از 0 تا 65535 است.
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه برای تقویت تفاوت. هر تفاوتی بزرگ‌تر یا مساوی با این مقدار، پیکسل منبع را تغییر نخواهد داد. پیش‌فرض 10 است.
محدوده مجاز از 0 تا 65535 است.
.IP \fBtolerance\fR 4
.IX Item "tolerance"
تنظیم رواداری (tolerance) برای تقویت تفاوت. هر تفاوتی کمتر از این مقدار، پیکسل منبع را تغییر نخواهد داد. پیش‌فرض 0 است.
محدوده مجاز از 0 تا 65535 است.
.IP \fBlow\fR 4
.IX Item "low"
تنظیم حد پایین برای تغییر پیکسل منبع. پیش‌فرض 65535 است. محدوده مجاز از 0 تا 65535 است.
این گزینه حداکثر مقدار ممکنی را که مقدار پیکسل منبع را کاهش می‌دهد کنترل می‌کند.
.IP \fBhigh\fR 4
.IX Item "high"
تنظیم حد بالا برای تغییر پیکسل منبع. پیش‌فرض 65535 است. محدوده مجاز از 0 تا 65535 است.
این گزینه حداکثر مقدار ممکنی را که مقدار پیکسل منبع را افزایش می‌دهد کنترل می‌کند.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. پیش‌فرض همه (all) است. محدوده مجاز از 0 تا 15 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از \fBدستورات\fR زیر که متناظر با گزینه‌هایی با همین نام هستند پشتیبانی می‌کند:
.IP \fBfactor\fR 4
.IX Item "factor"
.PD 0
.IP \fBthreshold\fR 4
.IX Item "threshold"
.IP \fBtolerance\fR 4
.IX Item "tolerance"
.IP \fBlow\fR 4
.IX Item "low"
.IP \fBhigh\fR 4
.IX Item "high"
.IP \fBplanes\fR 4
.IX Item "planes"
.PD
.SS ass
.IX Subsection "ass"
مشابه فیلتر \fBsubtitles\fR است، با این تفاوت که برای کار کردن به libavcodec و libavformat نیازی ندارد. از سوی دیگر، محدود به فایل‌های زیرنویس ASS (Advanced Substation Alpha) است.
.PP
این فیلتر گزینه‌های \fBfilename\fR/\fBf\fR، \fBoriginal_size\fR،
\&\fBfontsdir\fR و \fBalpha\fR را از فیلتر \fBsubtitles\fR به همراه گزینه زیر می‌پذیرد:
.IP \fBshaping\fR 4
.IX Item "shaping"
تنظیم موتور شکل‌دهی متن (shaping engine).
.Sp
مقادیر در دسترس عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
موتور شکل‌دهی پیش‌فرض libass که بهترین گزینه در دسترس است.
.IP \fBsimple\fR 4
.IX Item "simple"
شکل‌دهنده سریع و مستقل از قلم که تنها قابلیت انجام جایگزینی حروف را دارد.
.IP \fBcomplex\fR 4
.IX Item "complex"
شکل‌دهنده کندتر که از ویژگی‌های OpenType برای جایگزینی‌ها و موقعیت‌یابی حروف استفاده می‌کند. برای رندر صحیح خطوط و زبان‌های پیچیده مانند فارسی، عربی، عبری، دیواناگری و تایلندی ضروری است. نیازمند این است که libass همراه با HarfBuzz کامپایل شده باشد.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
.RE
.SS atadenoise
.IX Subsection "atadenoise"
اعمال یک فیلتر نویزگیر میانگین‌گیر زمانی انطباقی (Adaptive Temporal Averaging Denoiser) به ورودی ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fB0a\fR 4
.IX Item "0a"
تنظیم آستانه A برای پلین اول. پیش‌فرض 0.02 است.
محدوده معتبر بین 0 تا 0.3 است.
.IP \fB0b\fR 4
.IX Item "0b"
تنظیم آستانه B برای پلین اول. پیش‌فرض 0.04 است.
محدوده معتبر بین 0 تا 5 است.
.IP \fB1a\fR 4
.IX Item "1a"
تنظیم آستانه A برای پلین دوم. پیش‌فرض 0.02 است.
محدوده معتبر بین 0 تا 0.3 است.
.IP \fB1b\fR 4
.IX Item "1b"
تنظیم آستانه B برای پلین دوم. پیش‌فرض 0.04 است.
محدوده معتبر بین 0 تا 5 است.
.IP \fB2a\fR 4
.IX Item "2a"
تنظیم آستانه A برای پلین سوم. پیش‌فرض 0.02 است.
محدوده معتبر بین 0 تا 0.3 است.
.IP \fB2b\fR 4
.IX Item "2b"
تنظیم آستانه B برای پلین سوم. پیش‌فرض 0.04 است.
محدوده معتبر بین 0 تا 5 است.
.Sp
آستانه A برای واکنش به تغییرات ناگهانی در سیگنال ورودی و آستانه B برای واکنش به تغییرات پیوسته در سیگنال ورودی طراحی شده است.
.IP \fBs\fR 4
.IX Item "s"
تنظیم تعداد فریم‌هایی که فیلتر برای میانگین‌گیری استفاده خواهد کرد. پیش‌فرض 9 است. باید یک عدد فرد در محدوده [5, 129] باشد.
.IP \fBp\fR 4
.IX Item "p"
تنظیم پلین‌هایی از فریم که فیلتر برای میانگین‌گیری استفاده خواهد کرد. پیش‌فرض همه (all) است.
.IP \fBa\fR 4
.IX Item "a"
تنظیم نوع الگوریتمی که فیلتر برای میانگین‌گیری استفاده خواهد کرد. پیش‌فرض \f(CW\*(C`p\*(C'\fR (موازی) است.
به عنوان جایگزین می‌تواند روی \f(CW\*(C`s\*(C'\fR (سریالی) تنظیم شود.
.Sp
حالت موازی می‌تواند سریع‌تر از سریالی باشد، اما برعکس آن هرگز رخ نمی‌دهد.
حالت موازی در صورت وقوع نخستین تغییری که از آستانه‌ها فراتر رود پردازش را زودتر متوقف می‌کند، در حالی که حالت سریالی پردازش سمت دیگر فریم‌ها را در صورت برابر یا کمتر بودن با آستانه‌ها ادامه می‌دهد.
.IP \fB0s\fR 4
.IX Item "0s"
.PD 0
.IP \fB1s\fR 4
.IX Item "1s"
.IP \fB2s\fR 4
.IX Item "2s"
.PD
تنظیم سیگما برای پلین اول، دوم یا سوم. پیش‌فرض 32767 است.
محدوده معتبر از 0 تا 32767 است.
این گزینه وزن هر پیکسل را در شعاع تعریف‌شده توسط اندازه کنترل می‌کند.
مقدار پیش‌فرض به این معناست که تمامی پیکسل‌ها وزن برابری دارند.
تنظیم این گزینه روی 0 عملاً فیلتر کردن را غیرفعال می‌سازد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی \fBدستورات\fR متناظر با گزینه‌ها به جز گزینه \f(CW\*(C`s\*(C'\fR پشتیبانی می‌کند.
این دستور از همان سینتکس گزینه مربوطه پیروی می‌کند.
.SS avgblur
.IX Subsection "avgblur"
اعمال فیلتر تاری میانگین (average blur).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsizeX\fR 4
.IX Item "sizeX"
تنظیم اندازه شعاع افقی.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. به‌طور پیش‌فرض تمامی پلین‌ها فیلتر می‌شوند.
.IP \fBsizeY\fR 4
.IX Item "sizeY"
تنظیم اندازه شعاع عمودی؛ اگر صفر باشد مشابه \f(CW\*(C`sizeX\*(C'\fR خواهد بود.
پیش‌فرض \f(CW0\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات یکسانی با گزینه‌ها پشتیبانی می‌کند.
این دستور همان سینتکس گزینه متناظر را می‌پذیرد.
.PP
در صورتی که عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.SS backgroundkey
.IX Subsection "backgroundkey"
تبدیل یک پس‌زمینه ایستا به شفافیت.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold\fR 4
.IX Item "threshold"
آستانه برای تشخیص تغییر صحنه.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
درصد شباهت با پس‌زمینه.
.IP \fBblend\fR 4
.IX Item "blend"
تنظیم میزان ترکیب (blend) برای پیکسل‌هایی که مشابه نیستند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS bbox
.IX Subsection "bbox"
محاسبه جعبه مرزی (bounding box) برای پیکسل‌های غیرسیاه در پلین لومای فریم ورودی.
.PP
این فیلتر جعبه مرزی حاوی تمامی پیکسل‌های با مقدار لوما بیشتر از حداقل مقدار مجاز را محاسبه می‌کند.
پارامترهای توصیف‌کننده جعبه مرزی در لاگ فیلتر چاپ می‌شوند.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBmin_val\fR 4
.IX Item "min_val"
تنظیم حداقل مقدار لوما. پیش‌فرض \f(CW16\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS bilateral
.IX Subsection "bilateral"
اعمال فیلتر دوطرفه (bilateral filter)؛ هموارسازی مکانی همراه با حفظ لبه‌ها.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigmaS\fR 4
.IX Item "sigmaS"
تنظیم سیگمای تابع گاوسی برای محاسبه وزن مکانی (spatial weight).
محدوده مجاز بین 0 تا 512 است. پیش‌فرض 0.1 است.
.IP \fBsigmaR\fR 4
.IX Item "sigmaR"
تنظیم سیگمای تابع گاوسی برای محاسبه وزن بازه (range weight).
محدوده مجاز بین 0 تا 1 است. پیش‌فرض 0.1 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. پیش‌فرض تنها پلین اول است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS bitplanenoise
.IX Subsection "bitplanenoise"
نمایش و اندازه‌گیری نویز در سطوح بیتی (bit plane noise).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBbitplane\fR 4
.IX Item "bitplane"
تنظیم پلینی که باید تحلیل شود. پیش‌فرض \f(CW1\fR است.
.IP \fBfilter\fR 4
.IX Item "filter"
فیلتر کردن و حذف پیکسل‌های نویزی از \f(CW\*(C`bitplane\*(C'\fR تنظیم‌شده در بالا.
به‌طور پیش‌فرض غیرفعال است.
.SS "blackdetect, blackdetect_vulkan"
.IX Subsection "blackdetect, blackdetect_vulkan"
تشخیص بازه‌هایی از ویدیو که (تقریباً) کاملاً سیاه هستند. برای تشخیص گذار فصل‌ها، آگهی‌های بازرگانی یا ضبط‌های نامعتبر کاربرد دارد.
.PP
این فیلتر نتایج تحلیل تشخیص خود را هم در لاگ و هم در متادادای فریم ثبت می‌کند. در صورت یافتن قطعه سیاهی با حداقل مدت زمان مشخص‌شده، خطی شامل برچسب‌های زمانی شروع و پایان و همچنین مدت زمان با سطح \f(CW\*(C`info\*(C'\fR در لاگ چاپ می‌شود. علاوه بر این، به ازای هر فریم خطی با سطح \f(CW\*(C`debug\*(C'\fR چاپ می‌شود که میزان سیاهی تشخیص‌داده‌شده برای آن فریم را نشان می‌دهد.
.PP
این فیلتر همچنین متاداده‌ای را با کلید \f(CW\*(C`lavfi.black_start\*(C'\fR به نخستین فریم قطعه سیاه و با کلید \f(CW\*(C`lavfi.black_end\*(C'\fR به نخستین فریم پس از پایان قطعه سیاه ضمیمه می‌کند. مقدار این متاداده برابر با برچسب زمانی فریم است. این متاداده صرف‌نظر از حداقل مدت زمان تعیین‌شده افزوده می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBblack_min_duration, d\fR" 4
.IX Item "black_min_duration, d"
تنظیم حداقل مدت زمان سیاهی تشخیص‌داده‌شده بر حسب ثانیه. باید یک عدد ممیز شناور نامنفی باشد.
.Sp
مقدار پیش‌فرض 2.0 است.
.IP "\fBpicture_black_ratio_th, pic_th\fR" 4
.IX Item "picture_black_ratio_th, pic_th"
تنظیم آستانه برای "سیاه" در نظر گرفتن یک تصویر.
حداقل مقدار برای نسبت زیر را بیان می‌کند:
.Sp
.Vb 1
\&        <nb_black_pixels> / <nb_pixels>
.Ve
.Sp
که به ازای آن تصویر سیاه در نظر گرفته می‌شود.
مقدار پیش‌فرض 0.98 است.
.IP "\fBpixel_black_th, pix_th\fR" 4
.IX Item "pixel_black_th, pix_th"
تنظیم آستانه برای "سیاه" در نظر گرفتن یک پیکسل.
.Sp
این آستانه حداکثر مقدار لومای یک پیکسل را که برای آن پیکسل "سیاه" تلقی می‌شود مشخص می‌کند. مقدار ارائه‌شده طبق معادله زیر مقیاس‌بندی می‌شود:
.Sp
.Vb 1
\&        <absolute_threshold> = <luma_minimum_value> + <pixel_black_th> * <luma_range_size>
.Ve
.Sp
مقادیر \fIluma_range_size\fR و \fIluma_minimum_value\fR به فرمت ویدیوی ورودی بستگی دارند؛ این محدوده برای قالب‌های YUV با دامنه کامل [0\-255] و برای قالب‌های YUV با دامنه محدود [16\-235] است.
.Sp
مقدار پیش‌فرض 0.10 است.
.IP \fBalpha\fR 4
.IX Item "alpha"
در صورت فعال بودن، کانال آلفا به جای کانال لوما بررسی می‌شود. به جای فریم‌های تقریباً سیاه، فریم‌هایی را که (تقریباً) شفاف هستند تشخیص می‌دهد.
.Sp
به‌طور پیش‌فرض غیرفعال است.
.PP
مثال زیر حداکثر آستانه پیکسل را روی حداقل مقدار تنظیم کرده و تنها بازه‌های سیاهی ۲ ثانیه‌ای یا بیشتر را تشخیص می‌دهد:
.PP
.Vb 1
\&        blackdetect=d=2:pix_th=0.00
.Ve
.SS blackframe
.IX Subsection "blackframe"
تشخیص فریم‌هایی که (تقریباً) کاملاً سیاه هستند. برای تشخیص جابجایی فصل‌ها یا پیام‌های بازرگانی مفید است. خطوط خروجی شامل شماره فریمِ فریم تشخیص داده‌شده، درصد سیاهی، موقعیت در فایل در صورت معلوم بودن یا \-1، و برچسب زمان بر حسب ثانیه است.
.PP
برای نمایش خطوط خروجی، باید مقدار loglevel را حداقل روی AV_LOG_INFO تنظیم کنید.
.PP
این فیلتر متادادای فریم \f(CW\*(C`lavfi.blackframe.pblack\*(C'\fR را صادر می‌کند. مقدار آن نمایانگر درصد پیکسل‌هایی در تصویر است که زیر مقدار آستانه قرار دارند.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBamount\fR 4
.IX Item "amount"
درصد پیکسل‌هایی که باید زیر مقدار آستانه باشند؛ پیش‌فرض \f(CW98\fR است.
.IP "\fBthreshold, thresh\fR" 4
.IX Item "threshold, thresh"
آستانه‌ای که کمتر از آن، مقدار پیکسل سیاه در نظر گرفته می‌شود؛ پیش‌فرض \f(CW32\fR است.
.SS blend
.IX Subsection "blend"
ترکیب کردن (Blend) دو فریم ویدیویی در یکدیگر.
.PP
فیلتر \f(CW\*(C`blend\*(C'\fR دو جریان ورودی را دریافت کرده و یک جریان خروجی تولید می‌کند؛ ورودی اول لایه "بالایی" (top) و ورودی دوم لایه "پایینی" (bottom) است. به‌طور پیش‌فرض، خروجی با پایان یافتن طولانی‌ترین ورودی پایان می‌یابد.
.PP
فیلتر \f(CW\*(C`tblend\*(C'\fR (ترکیب زمانی) دو فریم متوالی را از یک تک‌جریان دریافت کرده و نتیجه حاصل از ترکیب فریم جدید بر روی فریم قدیمی را خروجی می‌دهد.
.PP
توصیف گزینه‌های پذیرفته‌شده در ادامه آمده است:
.IP \fBc0_mode\fR 4
.IX Item "c0_mode"
.PD 0
.IP \fBc1_mode\fR 4
.IX Item "c1_mode"
.IP \fBc2_mode\fR 4
.IX Item "c2_mode"
.IP \fBc3_mode\fR 4
.IX Item "c3_mode"
.IP \fBall_mode\fR 4
.IX Item "all_mode"
.PD
تنظیم حالت ترکیب برای مولفه پیکسلی خاص یا تمامی مولفه‌ها در صورت استفاده از \fIall_mode\fR. مقدار پیش‌فرض \f(CW\*(C`normal\*(C'\fR است.
.Sp
مقادیر در دسترس برای حالت‌های مولفه عبارتند از:
.RS 4
.IP \fBaddition\fR 4
.IX Item "addition"
.PD 0
.IP \fBand\fR 4
.IX Item "and"
.IP \fBaverage\fR 4
.IX Item "average"
.IP \fBbleach\fR 4
.IX Item "bleach"
.IP \fBburn\fR 4
.IX Item "burn"
.IP \fBdarken\fR 4
.IX Item "darken"
.IP \fBdifference\fR 4
.IX Item "difference"
.IP \fBdivide\fR 4
.IX Item "divide"
.IP \fBdodge\fR 4
.IX Item "dodge"
.IP \fBexclusion\fR 4
.IX Item "exclusion"
.IP \fBextremity\fR 4
.IX Item "extremity"
.IP \fBfreeze\fR 4
.IX Item "freeze"
.IP \fBgeometric\fR 4
.IX Item "geometric"
.IP \fBglow\fR 4
.IX Item "glow"
.IP \fBgrainextract\fR 4
.IX Item "grainextract"
.IP \fBgrainmerge\fR 4
.IX Item "grainmerge"
.IP \fBhardlight\fR 4
.IX Item "hardlight"
.IP \fBhardmix\fR 4
.IX Item "hardmix"
.IP \fBhardoverlay\fR 4
.IX Item "hardoverlay"
.IP \fBharmonic\fR 4
.IX Item "harmonic"
.IP \fBheat\fR 4
.IX Item "heat"
.IP \fBinterpolate\fR 4
.IX Item "interpolate"
.IP \fBlighten\fR 4
.IX Item "lighten"
.IP \fBlinearlight\fR 4
.IX Item "linearlight"
.IP \fBmultiply\fR 4
.IX Item "multiply"
.IP \fBmultiply128\fR 4
.IX Item "multiply128"
.IP \fBnegation\fR 4
.IX Item "negation"
.IP \fBnormal\fR 4
.IX Item "normal"
.IP \fBor\fR 4
.IX Item "or"
.IP \fBoverlay\fR 4
.IX Item "overlay"
.IP \fBphoenix\fR 4
.IX Item "phoenix"
.IP \fBpinlight\fR 4
.IX Item "pinlight"
.IP \fBreflect\fR 4
.IX Item "reflect"
.IP \fBscreen\fR 4
.IX Item "screen"
.IP \fBsoftdifference\fR 4
.IX Item "softdifference"
.IP \fBsoftlight\fR 4
.IX Item "softlight"
.IP \fBstain\fR 4
.IX Item "stain"
.IP \fBsubtract\fR 4
.IX Item "subtract"
.IP \fBvividlight\fR 4
.IX Item "vividlight"
.IP \fBxor\fR 4
.IX Item "xor"
.PD
.RE
.RS 4
.RE
.IP \fBc0_opacity\fR 4
.IX Item "c0_opacity"
.PD 0
.IP \fBc1_opacity\fR 4
.IX Item "c1_opacity"
.IP \fBc2_opacity\fR 4
.IX Item "c2_opacity"
.IP \fBc3_opacity\fR 4
.IX Item "c3_opacity"
.IP \fBall_opacity\fR 4
.IX Item "all_opacity"
.PD
تنظیم شفافیت/کدری (opacity) ترکیب برای مولفه پیکسلی خاص یا تمامی مولفه‌ها در صورت استفاده از \fIall_opacity\fR. تنها در ترکیب با حالت‌های ترکیب مولفه پیکسلی استفاده می‌شود.
.IP \fBc0_expr\fR 4
.IX Item "c0_expr"
.PD 0
.IP \fBc1_expr\fR 4
.IX Item "c1_expr"
.IP \fBc2_expr\fR 4
.IX Item "c2_expr"
.IP \fBc3_expr\fR 4
.IX Item "c3_expr"
.IP \fBall_expr\fR 4
.IX Item "all_expr"
.PD
تنظیم عبارت ترکیب برای مولفه پیکسلی خاص یا تمامی مولفه‌ها در صورت استفاده از \fIall_expr\fR. توجه داشته باشید در صورت تنظیم این عبارات، گزینه‌های مربوط به حالت ترکیب نادیده گرفته خواهند شد.
.Sp
عبارات می‌توانند از متغیرهای زیر استفاده کنند:
.RS 4
.IP \fBN\fR 4
.IX Item "N"
شماره ترتیبی فریم فیلترشده، شروع از \f(CW0\fR.
.IP \fBX\fR 4
.IX Item "X"
.PD 0
.IP \fBY\fR 4
.IX Item "Y"
.PD
مختصات نمونه پیکسلی فعلی
.IP \fBW\fR 4
.IX Item "W"
.PD 0
.IP \fBH\fR 4
.IX Item "H"
.PD
عرض و ارتفاع پلین در حال فیلتر شدن
.IP \fBSW\fR 4
.IX Item "SW"
.PD 0
.IP \fBSH\fR 4
.IX Item "SH"
.PD
مقیاس عرض و ارتفاع برای پلین در حال فیلتر شدن. این نسبت ابعاد پلین فعلی به پلین لوما است؛ برای نمونه برای یک فریم \f(CW\*(C`yuv420p\*(C'\fR، مقادیر برای پلین لوما برابر با \f(CW\*(C`1,1\*(C'\fR و برای پلین‌های کروما برابر با \f(CW\*(C`0.5,0.5\*(C'\fR است.
.IP \fBT\fR 4
.IX Item "T"
زمان فریم فعلی بر حسب ثانیه.
.IP "\fBTOP, A\fR" 4
.IX Item "TOP, A"
مقدار مولفه پیکسلی در موقعیت فعلی برای فریم اول ویدیو (لایه بالایی).
.IP "\fBBOTTOM, B\fR" 4
.IX Item "BOTTOM, B"
مقدار مولفه پیکسلی در موقعیت فعلی برای فریم دوم ویدیو (لایه پایینی).
.RE
.RS 4
.RE
.PP
فیلتر \f(CW\*(C`blend\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال گذار از لایه پایینی به لایه بالایی در ۱۰ ثانیه نخست:
.Sp
.Vb 1
\&        blend=all_expr=\*(AqA*(if(gte(T,10),1,T/10))+B*(1\-(if(gte(T,10),1,T/10)))\*(Aq
.Ve
.IP \(bu 4
اعمال گذار خطی افقی از لایه بالایی به لایه پایینی:
.Sp
.Vb 1
\&        blend=all_expr=\*(AqA*(X/W)+B*(1\-X/W)\*(Aq
.Ve
.IP \(bu 4
اعمال جلوه شطرنجی ۱در۱:
.Sp
.Vb 1
\&        blend=all_expr=\*(Aqif(eq(mod(X,2),mod(Y,2)),A,B)\*(Aq
.Ve
.IP \(bu 4
اعمال جلوه آشکارسازی (uncover) به سمت چپ:
.Sp
.Vb 1
\&        blend=all_expr=\*(Aqif(gte(N*SW+X,W),A,B)\*(Aq
.Ve
.IP \(bu 4
اعمال جلوه آشکارسازی به سمت پایین:
.Sp
.Vb 1
\&        blend=all_expr=\*(Aqif(gte(Y\-N*SH,0),A,B)\*(Aq
.Ve
.IP \(bu 4
اعمال جلوه آشکارسازی به سمت بالا-چپ:
.Sp
.Vb 1
\&        blend=all_expr=\*(Aqif(gte(T*SH*40+Y,H)*gte((T*40*SW+X)*W/H,W),A,B)\*(Aq
.Ve
.IP \(bu 4
تقسیم قطری ویدیو و نمایش لایه‌های بالا و پایین در هر طرف:
.Sp
.Vb 1
\&        blend=all_expr=\*(Aqif(gt(X,Y*(W/H)),A,B)\*(Aq
.Ve
.IP \(bu 4
نمایش تفاوت‌های میان فریم فعلی و فریم قبلی:
.Sp
.Vb 1
\&        tblend=all_mode=grainextract
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.SS blockdetect
.IX Subsection "blockdetect"
تعیین میزان بلوکی شدن (blockiness) فریم‌ها بدون تغییر دادن فریم‌های ورودی.
.PP
بر اساس مقاله ریمکو مویس و ایهور کیرنکو: "A no\-reference blocking artifact measure for adaptive video processing." کنفرانس پردازش سیگنال اروپا ۲۰۰۵.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBperiod_min\fR 4
.IX Item "period_min"
.PD 0
.IP \fBperiod_max\fR 4
.IX Item "period_max"
.PD
تنظیم حداقل و حداکثر مقادیر برای تعیین شبکه‌های پیکسلی (دوره‌ها).
مقادیر پیش‌فرض [3,24] هستند.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. پیش‌فرض تنها پلین اول است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تعیین میزان بلوکی بودن برای پلین اول و جستجو برای دوره‌ها در بازه [8,32]:
.Sp
.Vb 1
\&        blockdetect=period_min=8:period_max=32:planes=1
.Ve
.SS blurdetect
.IX Subsection "blurdetect"
تعیین میزان تاری (blurriness) فریم‌ها بدون تغییر دادن فریم‌های ورودی.
.PP
بر اساس مقاله مارزیلیانو، پینا و همکاران: "A no\-reference perceptual blur metric."
امکان تقریب مبتنی بر بلوک را فراهم می‌سازد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlow\fR 4
.IX Item "low"
.PD 0
.IP \fBhigh\fR 4
.IX Item "high"
.PD
تنظیم مقادیر آستانه پایین و بالا مورد استفاده در الگوریتم آستانه‌گذاری Canny.
.Sp
آستانه بالا پیکسل‌های لبه "قوی" را انتخاب می‌کند که سپس از طریق اتصال ۸-تایی با پیکسل‌های لبه "ضعیف" که توسط آستانه پایین انتخاب شده‌اند متصل می‌شوند.
.Sp
مقادیر آستانه \fIlow\fR و \fIhigh\fR باید در محدوده [0,1] انتخاب شوند و \fIlow\fR باید کمتر یا مساوی \fIhigh\fR باشد.
.Sp
مقدار پیش‌فرض برای \fIlow\fR برابر \f(CW\*(C`20/255\*(C'\fR و مقدار پیش‌فرض برای \fIhigh\fR برابر \f(CW\*(C`50/255\*(C'\fR است.
.IP \fBradius\fR 4
.IX Item "radius"
تعریف شعاع جستجو در اطراف یک پیکسل لبه برای یافتن بیشینه‌های محلی.
.IP \fBblock_pct\fR 4
.IX Item "block_pct"
تعیین میزان تاری فقط برای مهم‌ترین بلوک‌ها بر حسب درصد.
.IP \fBblock_width\fR 4
.IX Item "block_width"
تعیین میزان تاری برای بلوک‌هایی به عرض \fIblock_width\fR. در صورت تنظیم روی هر مقداری کمتر از 1، هیچ بلوکی استفاده نمی‌شود و کل تصویر صرف‌نظر از \fIblock_height\fR به صورت یکپارچه پردازش می‌گردد.
.IP \fBblock_height\fR 4
.IX Item "block_height"
تعیین میزان تاری برای بلوک‌هایی به ارتفاع \fIblock_height\fR. در صورت تنظیم روی هر مقداری کمتر از 1، هیچ بلوکی استفاده نمی‌شود و کل تصویر صرف‌نظر از \fIblock_width\fR به صورت یکپارچه پردازش می‌گردد.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. پیش‌فرض تنها پلین اول است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تعیین تاری برای ۸۰٪ از مهم‌ترین بلوک‌های 32x32:
.Sp
.Vb 1
\&        blurdetect=block_width=32:block_height=32:block_pct=80
.Ve
.SS bm3d
.IX Subsection "bm3d"
نویززدایی از فریم‌ها با استفاده از الگوریتم تطبیق بلوک سه‌بعدی (Block\-Matching 3D).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم شدت نویززدایی. مقدار پیش‌فرض 1 است.
محدوده مجاز از 0 تا 999.9 است.
الگوریتم نویززدایی به سیگما بسیار حساس است، بنابراین آن را متناسب با منبع تنظیم کنید.
.IP \fBblock\fR 4
.IX Item "block"
تنظیم اندازه پچ محلی. این گزینه ابعاد را در دو بعد تعیین می‌کند.
.IP \fBbstep\fR 4
.IX Item "bstep"
تنظیم گام لغزشی برای پردازش بلوک‌ها. مقدار پیش‌فرض 4 است.
محدوده مجاز از 1 تا 64 است.
مقادیر کوچک‌تر امکان پردازش بلوک‌های مرجع بیشتری را فراهم می‌سازد و سرعت را کاهش می‌دهد.
.IP \fBgroup\fR 4
.IX Item "group"
تنظیم حداکثر تعداد بلوک‌های مشابه برای بعد سوم. مقدار پیش‌فرض 1 است.
هنگام تنظیم روی 1، هیچ تطبیق بلوکی انجام نمی‌شود. مقادیر بزرگ‌تر اجازه حضور بلوک‌های بیشتری را در یک گروه منفرد می‌دهد.
محدوده مجاز از 1 تا 256 است.
.IP \fBrange\fR 4
.IX Item "range"
تنظیم شعاع برای جستجوی تطبیق بلوک. پیش‌فرض 9 است.
محدوده مجاز از 1 تا INT32_MAX است.
.IP \fBmstep\fR 4
.IX Item "mstep"
تنظیم گام میان دو موقعیت جستجو برای تطبیق بلوک. پیش‌فرض 1 است.
محدوده مجاز از 1 تا 64 است. مقادیر کوچک‌تر کندتر هستند.
.IP \fBthmse\fR 4
.IX Item "thmse"
تنظیم آستانه میانگین مربعات خطا برای تطبیق بلوک. محدوده معتبر بین 0 تا INT32_MAX است.
.IP \fBhdthr\fR 4
.IX Item "hdthr"
تنظیم پارامتر آستانه‌گذاری سخت در دامنه تبدیل‌یافته سه‌بعدی.
مقادیر بزرگ‌تر منجر به فیلترسازی قوی‌تر با آستانه‌گذاری سخت در حوزه فرکانس می‌شود.
.IP \fBestim\fR 4
.IX Item "estim"
تنظیم حالت تخمین فیلترسازی. می‌تواند \f(CW\*(C`basic\*(C'\fR یا \f(CW\*(C`final\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`basic\*(C'\fR است.
.IP \fBref\fR 4
.IX Item "ref"
در صورت فعال بودن، فیلتر از جریان دوم برای تطبیق بلوک استفاده خواهد کرد.
به‌طور پیش‌فرض برای مقدار \f(CW\*(C`basic\*(C'\fR در گزینه \fIestim\fR غیرفعال است، و در صورتی که مقدار \fIestim\fR برابر با \f(CW\*(C`final\*(C'\fR باشد همیشه فعال است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. پیش‌فرض تمامی پلین‌های در دسترس به جز آلفا است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
فیلترسازی پایه‌ای با bm3d:
.Sp
.Vb 1
\&        bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic
.Ve
.IP \(bu 4
مشابه مثال بالا، اما فیلتر کردن تنها پلین لوما:
.Sp
.Vb 1
\&        bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic:planes=1
.Ve
.IP \(bu 4
مشابه مثال بالا، اما همراه با هر دو حالت تخمین:
.Sp
.Vb 1
\&        split[a][b],[a]bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic[a],[b][a]bm3d=sigma=3:block=4:bstep=2:group=16:estim=final:ref=1
.Ve
.IP \(bu 4
مشابه مثال بالا، اما همراه با پیش‌فیلترسازی توسط فیلتر \fBnlmeans\fR:
.Sp
.Vb 1
\&        split[a][b],[a]nlmeans=s=3:r=7:p=3[a],[b][a]bm3d=sigma=3:block=4:bstep=2:group=16:estim=final:ref=1
.Ve
.SS boxblur
.IX Subsection "boxblur"
اعمال الگوریتم تاری جعبه‌ای (boxblur) روی ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
.PD 0
.IP "\fBluma_power, lp\fR" 4
.IX Item "luma_power, lp"
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
.IP "\fBchroma_power, cp\fR" 4
.IX Item "chroma_power, cp"
.IP "\fBalpha_radius, ar\fR" 4
.IX Item "alpha_radius, ar"
.IP "\fBalpha_power, ap\fR" 4
.IX Item "alpha_power, ap"
.PD
.PP
توضیحات گزینه‌های مورد پذیرش در ادامه آمده است.
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
.PD 0
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
.IP "\fBalpha_radius, ar\fR" 4
.IX Item "alpha_radius, ar"
.PD
تنظیم یک عبارت برای شعاع جعبه بر حسب پیکسل که برای تار کردن پلین ورودی متناظر استفاده می‌شود.
.Sp
مقدار شعاع باید یک عدد نامنفی باشد، و نباید بزرگ‌تر از مقدار عبارت \f(CW\*(C`min(w,h)/2\*(C'\fR برای پلین‌های لوما و آلفا، و \f(CW\*(C`min(cw,ch)/2\*(C'\fR برای پلین‌های کروما باشد.
.Sp
مقدار پیش‌فرض برای \fBluma_radius\fR برابر "2" است. در صورت عدم تعیین، گزینه‌های \fBchroma_radius\fR و \fBalpha_radius\fR به مقدار متناظر تنظیم‌شده برای \fBluma_radius\fR پیش‌فرض می‌شوند.
.Sp
عبارات می‌توانند شامل ثابت‌های زیر باشند:
.RS 4
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع ورودی بر حسب پیکسل.
.IP \fBcw\fR 4
.IX Item "cw"
.PD 0
.IP \fBch\fR 4
.IX Item "ch"
.PD
عرض و ارتفاع تصویر کرومای ورودی بر حسب پیکسل.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری افقی و عمودی کروما. برای مثال، برای قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.RE
.RS 4
.RE
.IP "\fBluma_power, lp\fR" 4
.IX Item "luma_power, lp"
.PD 0
.IP "\fBchroma_power, cp\fR" 4
.IX Item "chroma_power, cp"
.IP "\fBalpha_power, ap\fR" 4
.IX Item "alpha_power, ap"
.PD
تعیین تعداد دفعاتی که فیلتر boxblur روی پلین متناظر اعمال می‌شود.
.Sp
مقدار پیش‌فرض برای \fBluma_power\fR برابر 2 است. در صورت عدم تعیین، گزینه‌های \fBchroma_power\fR و \fBalpha_power\fR به مقدار متناظر تنظیم‌شده برای \fBluma_power\fR پیش‌فرض می‌شوند.
.Sp
مقدار 0 این جلوه را غیرفعال می‌سازد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال فیلتر boxblur با شعاع‌های لوما، کروما و آلفا تنظیم‌شده روی 2:
.Sp
.Vb 2
\&        boxblur=luma_radius=2:luma_power=1
\&        boxblur=2:1
.Ve
.IP \(bu 4
تنظیم شعاع لوما روی 2، و شعاع‌های آلفا و کروما روی 0:
.Sp
.Vb 1
\&        boxblur=2:1:cr=0:ar=0
.Ve
.IP \(bu 4
تنظیم شعاع‌های لوما و کروما به صورت کسری از ابعاد ویدیو:
.Sp
.Vb 1
\&        boxblur=luma_radius=min(h\e,w)/10:luma_power=1:chroma_radius=min(cw\e,ch)/10:chroma_power=1
.Ve
.SS bwdif
.IX Subsection "bwdif"
دی‌اینترلیس کردن (Deinterlace) ویدیوی ورودی ("bwdif" مخفف عبارت "Bob Weaver Deinterlacing Filter" است).
.PP
دی‌اینترلیس‌سازی انطباقی بر پایه حرکت بر پایه yadif همراه با استفاده از الگوریتم‌های درونیابی w3fdif و مکعبی (cubic).
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت اینترلیس مورد اتخاذ. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, send_frame\fR" 4
.IX Item "0, send_frame"
خروجی دادن یک فریم به ازای هر فریم ورودی.
.IP "\fB1, send_field\fR" 4
.IX Item "1, send_field"
خروجی دادن یک فریم به ازای هر فیلد ورودی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`send_field\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
پاریته فیلد تصویر فرض‌شده برای ویدیوی اینترلیس ورودی. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض تقدم فیلد بالایی (top field first).
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض تقدم فیلد پایینی (bottom field first).
.IP "\fB\-1, auto\fR" 4
.IX Item "-1, auto"
فعال‌سازی تشخیص خودکار پاریته فیلد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر حالت اینترلیس نامشخص باشد یا دیکودر این اطلاعات را صادر نکند، تقدم فیلد بالایی فرض خواهد شد.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
مشخص کردن این‌که کدام فریم‌ها باید دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, all\fR" 4
.IX Item "0, all"
دی‌اینترلیس کردن تمامی فریم‌ها.
.IP "\fB1, interlaced\fR" 4
.IX Item "1, interlaced"
دی‌اینترلیس کردن تنها فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.SS ccrepack
.IX Subsection "ccrepack"
بسته‌بندی مجدد (Repack) داده‌های جانبی زیرنویس بسته CEA\-708 (Closed Captioning).
.PP
این فیلتر ایرادات گوناگون مشاهده‌شده در انکودرهای تجاری در ارتباط با محموله‌های نامعتبر بالادستی CEA\-708 را برطرف می‌کند؛ به‌ویژه تعداد نادرست چندتایی‌ها (مقدار نادرست cc_count برای نرخ فریمِ هدف)، و ترتیب نامناسب چندتایی‌ها (به این معنا که چندتایی‌های CEA\-608 در اولین مدخل‌های محموله قرار نگرفته‌اند).
.SS cas
.IX Subsection "cas"
اعمال فیلتر وضوح‌بخشی انطباقی با کنتراست (Contrast Adaptive Sharpen) بر روی جریان ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstrength\fR 4
.IX Item "strength"
تنظیم شدت وضوح‌بخشی (sharpening). مقدار پیش‌فرض 0 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌هایی که باید فیلتر شوند. مقدار پیش‌فرض فیلتر کردن تمامی پلین‌ها به جز پلین آلفا است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.SS chromahold
.IX Subsection "chromahold"
حذف تمامی اطلاعات رنگی برای همه رنگ‌ها به جز یک رنگ خاص.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
رنگی که با کرومای خنثی جایگزین نخواهد شد.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
درصد شباهت با رنگ فوق.
مقدار 0.01 تنها با رنگ دقیق کلید مطابقت دارد، در حالی که 1.0 با همه چیز مطابقت دارد.
.IP \fBblend\fR 4
.IX Item "blend"
درصد ترکیب.
مقدار 0.0 پیکسل‌ها را یا کاملاً خاکستری می‌کند، یا اصلاً خاکستری نمی‌کند.
مقادیر بالاتر منجر به حفظ رنگ بیشتر می‌شوند.
.IP \fByuv\fR 4
.IX Item "yuv"
اعلام می‌کند که رنگ ارائه‌شده از قبل در فضای رنگی YUV قرار دارد نه RGB.
.Sp
با فعال بودن این گزینه، نام رنگ‌های تحت‌اللفظی مانند "green" یا "red" دیگر معنایی ندارند.
از این گزینه می‌توان برای ارسال مقادیر دقیق YUV به عنوان اعداد هگزادسیمال استفاده کرد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
این دستور از همان سینتکس گزینه متناظر پیروی می‌کند.
.PP
در صورتی که عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.SS chromakey
.IX Subsection "chromakey"
پرده رنگی یا کروماکی (Chroma Keying) در فضای رنگی YUV.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
رنگی که با شفافیت (transparency) جایگزین خواهد شد.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
درصد شباهت با رنگ کلید.
.Sp
مقدار 0.01 تنها با رنگ کلید دقیق مطابقت دارد، در حالی که 1.0 با همه چیز مطابقت دارد.
.IP \fBblend\fR 4
.IX Item "blend"
درصد ترکیب.
.Sp
مقدار 0.0 پیکسل‌ها را یا کاملاً شفاف، یا کاملاً غیرشفاف می‌کند.
.Sp
مقادیر بالاتر منجر به پیکسل‌های نیمه‌شفاف می‌شوند، به‌طوری که هرچه رنگ پیکسل‌ها به رنگ کلید شبیه‌تر باشد، میزان شفافیت بیشتر خواهد بود.
.IP \fByuv\fR 4
.IX Item "yuv"
اعلام می‌کند که رنگ ارسال‌شده از قبل در فضای رنگی YUV است نه RGB.
.Sp
با فعال بودن این گزینه، رنگ‌های تحت‌اللفظی مانند "green" یا "red" دیگر کاربردی ندارند.
از این گزینه می‌توان برای ارسال مقادیر دقیق YUV به عنوان اعداد هگزادسیمال استفاده کرد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
این دستور از همان سینتکس گزینه متناظر پیروی می‌کند.
.PP
در صورتی که عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
شفاف کردن هر پیکسل سبز در تصویر ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i input.png \-vf chromakey=green out.png
.Ve
.IP \(bu 4
قرار دادن یک ویدیوی پرده سبز بر روی یک پس‌زمینه سیاه ایستا:
.Sp
.Vb 1
\&        ffmpeg \-f lavfi \-i color=c=black:s=1280x720 \-i video.mp4 \-shortest \-filter_complex "[1:v]chromakey=0x70de77:0.1:0.2[ckout];[0:v][ckout]overlay[out]" \-map "[out]" output.mkv
.Ve
.SS chromanr
.IX Subsection "chromanr"
کاهش نویز رنگ‌پذیری (chrominance).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthres\fR 4
.IX Item "thres"
تنظیم آستانه برای میانگین‌گیری مقادیر رنگ‌پذیری.
مجموع قدر مطلق اختلاف مولفه‌های پیکسلی Y، U و V پیکسل جاری و پیکسل‌های همسایه که کمتر از این آستانه باشد در میانگین‌گیری استفاده خواهد شد. مولفه روشنایی (Luma) بدون تغییر باقی مانده و به خروجی کپی می‌شود.
مقدار پیش‌فرض 30 است. محدوده مجاز از 1 تا 200 است.
.IP \fBsizew\fR 4
.IX Item "sizew"
تنظیم شعاع افقی مستطیل مورد استفاده برای میانگین‌گیری.
محدوده مجاز از 1 تا 100 است. مقدار پیش‌فرض 5 است.
.IP \fBsizeh\fR 4
.IX Item "sizeh"
تنظیم شعاع عمودی مستطیل مورد استفاده برای میانگین‌گیری.
محدوده مجاز از 1 تا 100 است. مقدار پیش‌فرض 5 است.
.IP \fBstepw\fR 4
.IX Item "stepw"
تنظیم گام افقی هنگام میانگین‌گیری. مقدار پیش‌فرض 1 است.
محدوده مجاز از 1 تا 50 است.
بیشتر برای سرعت بخشیدن به فیلتر کردن مفید است.
.IP \fBsteph\fR 4
.IX Item "steph"
تنظیم گام عمودی هنگام میانگین‌گیری. مقدار پیش‌فرض 1 است.
محدوده مجاز از 1 تا 50 است.
بیشتر برای سرعت بخشیدن به فیلتر کردن مفید است.
.IP \fBthrey\fR 4
.IX Item "threy"
تنظیم آستانه Y برای میانگین‌گیری مقادیر رنگ‌پذیری.
تنظیم کنترل دقیق‌تر برای بیشینه اختلاف مجاز میان مولفه‌های Y پیکسل جاری و پیکسل‌های همسایه.
مقدار پیش‌فرض 200 است. محدوده مجاز از 1 تا 200 است.
.IP \fBthreu\fR 4
.IX Item "threu"
تنظیم آستانه U برای میانگین‌گیری مقادیر رنگ‌پذیری.
تنظیم کنترل دقیق‌تر برای بیشینه اختلاف مجاز میان مولفه‌های U پیکسل جاری و پیکسل‌های همسایه.
مقدار پیش‌فرض 200 است. محدوده مجاز از 1 تا 200 است.
.IP \fBthrev\fR 4
.IX Item "threv"
تنظیم آستانه V برای میانگین‌گیری مقادیر رنگ‌پذیری.
تنظیم کنترل دقیق‌تر برای بیشینه اختلاف مجاز میان مولفه‌های V پیکسل جاری و پیکسل‌های همسایه.
مقدار پیش‌فرض 200 است. محدوده مجاز از 1 تا 200 است.
.IP \fBdistance\fR 4
.IX Item "distance"
تنظیم نوع فاصله مورد استفاده در محاسبات.
.RS 4
.IP \fBmanhattan\fR 4
.IX Item "manhattan"
قدر مطلق اختلاف.
.IP \fBeuclidean\fR 4
.IX Item "euclidean"
مجذور اختلاف.
.RE
.RS 4
.Sp
نوع فاصله پیش‌فرض manhattan است.
.RE
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.SS chromashift
.IX Subsection "chromashift"
تغییر مکان (شیفت) افقی و/یا عمودی پیکسل‌های کروما.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcbh\fR 4
.IX Item "cbh"
تنظیم میزان شیفت افقی کروما-آبی.
.IP \fBcbv\fR 4
.IX Item "cbv"
تنظیم میزان شیفت عمودی کروما-آبی.
.IP \fBcrh\fR 4
.IX Item "crh"
تنظیم میزان شیفت افقی کروما-قرمز.
.IP \fBcrv\fR 4
.IX Item "crv"
تنظیم میزان شیفت عمودی کروما-قرمز.
.IP \fBedge\fR 4
.IX Item "edge"
تنظیم حالت لبه؛ می‌تواند \fIsmear\fR (پیش‌فرض) یا \fIwarp\fR باشد.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS ciescope
.IX Subsection "ciescope"
نمایش نمودار رنگی CIE با پیکسل‌های انداخته‌شده روی آن.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsystem\fR 4
.IX Item "system"
تنظیم سامانه رنگی.
.RS 4
.IP "\fBntsc, 470m\fR" 4
.IX Item "ntsc, 470m"
.PD 0
.IP "\fBebu, 470bg\fR" 4
.IX Item "ebu, 470bg"
.IP \fBsmpte\fR 4
.IX Item "smpte"
.IP \fB240m\fR 4
.IX Item "240m"
.IP \fBapple\fR 4
.IX Item "apple"
.IP \fBwidergb\fR 4
.IX Item "widergb"
.IP \fBcie1931\fR 4
.IX Item "cie1931"
.IP "\fBrec709, hdtv\fR" 4
.IX Item "rec709, hdtv"
.IP "\fBuhdtv, rec2020\fR" 4
.IX Item "uhdtv, rec2020"
.IP \fBdcip3\fR 4
.IX Item "dcip3"
.PD
.RE
.RS 4
.RE
.IP \fBcie\fR 4
.IX Item "cie"
تنظیم سامانه CIE.
.RS 4
.IP \fBxyy\fR 4
.IX Item "xyy"
.PD 0
.IP \fBucs\fR 4
.IX Item "ucs"
.IP \fBluv\fR 4
.IX Item "luv"
.PD
.RE
.RS 4
.RE
.IP \fBgamuts\fR 4
.IX Item "gamuts"
تنظیم وسعت‌های رنگی (gamuts) برای رسم.
.Sp
برای مقادیر موجود گزینه \f(CW\*(C`system\*(C'\fR را ببینید.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ciescope، به‌طور پیش‌فرض 512 تعیین شده است.
.IP "\fBintensity, i\fR" 4
.IX Item "intensity, i"
تنظیم شدت مورد استفاده برای نگاشت مقادیر پیکسل ورودی به نمودار CIE.
.IP \fBcontrast\fR 4
.IX Item "contrast"
تنظیم کنتراست مورد استفاده برای رسم رنگ‌های زبانه که خارج از وسعت رنگی سامانه رنگی فعال هستند.
.IP \fBcorrgamma\fR 4
.IX Item "corrgamma"
تصحیح گامای نمایش داده‌شده روی اسکوپ، به‌طور پیش‌فرض فعال است.
.IP \fBshowwhite\fR 4
.IX Item "showwhite"
نمایش نقطه سفید روی نمودار CIE، به‌طور پیش‌فرض غیرفعال است.
.IP \fBgamma\fR 4
.IX Item "gamma"
تنظیم گامای ورودی. تنها با فضای رنگی ورودی XYZ استفاده می‌شود.
.IP \fBfill\fR 4
.IX Item "fill"
پر کردن با رنگ‌های CIE. به‌طور پیش‌فرض فعال است.
.SS codecview
.IX Subsection "codecview"
بصری‌سازی اطلاعات صادرشده توسط برخی کدک‌ها.
.PP
برخی کدک‌ها می‌توانند اطلاعات را از طریق فریم‌ها با استفاده از داده‌های جانبی (side-data) یا روش‌های دیگر صادر کنند. برای نمونه، برخی کدک‌های مبتنی بر MPEG بردارهای حرکت (motion vectors) را از طریق پرچم \&\fIexport_mvs\fR در گزینه \fBflags2\fR کدک صادر می‌نمایند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBblock\fR 4
.IX Item "block"
نمایش ساختار افراز بلوک با استفاده از صفحه روشنایی (luma).
.IP \fBmv\fR 4
.IX Item "mv"
تنظیم بردارهای حرکتی برای بصری‌سازی.
.Sp
پرچم‌های موجود برای \fImv\fR عبارتند از:
.RS 4
.IP \fBpf\fR 4
.IX Item "pf"
بردارهای حرکت پیش‌بینی‌شده به جلو برای فریم‌های P
.IP \fBbf\fR 4
.IX Item "bf"
بردارهای حرکت پیش‌بینی‌شده به جلو برای فریم‌های B
.IP \fBbb\fR 4
.IX Item "bb"
بردارهای حرکت پیش‌بینی‌شده به عقب برای فریم‌های B
.RE
.RS 4
.RE
.IP \fBqp\fR 4
.IX Item "qp"
نمایش پارامترهای کوانتیزاسیون با استفاده از صفحه‌های کروما.
.IP "\fBmv_type, mvt\fR" 4
.IX Item "mv_type, mvt"
تنظیم نوع بردارهای حرکت برای بصری‌سازی. شامل بردارهای حرکت تمامی فریم‌ها می‌شود مگر آنکه توسط گزینه \fIframe_type\fR مشخص شده باشد.
.Sp
پرچم‌های موجود برای \fImv_type\fR عبارتند از:
.RS 4
.IP \fBfp\fR 4
.IX Item "fp"
بردارهای حرکت پیش‌بینی‌شده به جلو
.IP \fBbp\fR 4
.IX Item "bp"
بردارهای حرکت پیش‌بینی‌شده به عقب
.RE
.RS 4
.RE
.IP "\fBframe_type, ft\fR" 4
.IX Item "frame_type, ft"
تنظیم نوع فریم برای بصری‌سازی بردارهای حرکت آن.
.Sp
پرچم‌های موجود برای \fIframe_type\fR عبارتند از:
.RS 4
.IP \fBif\fR 4
.IX Item "if"
فریم‌های درون‌کدگذاری‌شده (فریم‌های I)
.IP \fBpf\fR 4
.IX Item "pf"
فریم‌های پیش‌بینی‌شده (فریم‌های P)
.IP \fBbf\fR 4
.IX Item "bf"
فریم‌های پیش‌بینی‌شده دوطرفه (فریم‌های B)
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
بصری‌سازی بردارهای حرکت پیش‌بینی‌شده به جلو در تمامی فریم‌ها با استفاده از \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-flags2 +export_mvs input.mp4 \-vf codecview=mv_type=fp
.Ve
.IP \(bu 4
بصری‌سازی بردارهای حرکت چندجهته فریم‌های P و B با استفاده از \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-flags2 +export_mvs input.mp4 \-vf codecview=mv=pf+bf+bb
.Ve
.SS colorbalance
.IX Subsection "colorbalance"
تغییر شدت رنگ‌های اصلی (قرمز، سبز و آبی) فریم‌های ورودی.
.PP
این فیلتر امکان تنظیم یک فریم ورودی را در نواحی سایه‌ها (shadows)، رنگ‌های میانی (midtones) یا روشنی‌ها (highlights) برای ترازهای قرمز-فیروزه‌ای، سبز-ارغوانی یا آبی-زرد فراهم می‌سازد.
.PP
یک مقدار تنظیم مثبت، تراز را به سمت رنگ اصلی و یک مقدار منفی به سمت رنگ مکمل سوق می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrs\fR 4
.IX Item "rs"
.PD 0
.IP \fBgs\fR 4
.IX Item "gs"
.IP \fBbs\fR 4
.IX Item "bs"
.PD
تنظیم سایه‌های قرمز، سبز و آبی (تاریک‌ترین پیکسل‌ها).
.IP \fBrm\fR 4
.IX Item "rm"
.PD 0
.IP \fBgm\fR 4
.IX Item "gm"
.IP \fBbm\fR 4
.IX Item "bm"
.PD
تنظیم رنگ‌های میانی قرمز، سبز و آبی (پیکسل‌های متوسط).
.IP \fBrh\fR 4
.IX Item "rh"
.PD 0
.IP \fBgh\fR 4
.IX Item "gh"
.IP \fBbh\fR 4
.IX Item "bh"
.PD
تنظیم روشنی‌های قرمز، سبز و آبی (روشن‌ترین پیکسل‌ها).
.Sp
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[\-1.0, 1.0]\*(C'\fR است. مقادیر پیش‌فرض \f(CW0\fR هستند.
.IP \fBpl\fR 4
.IX Item "pl"
حفظ روشنایی (lightness) هنگام تغییر تراز رنگ. به‌طور پیش‌فرض غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
افزودن ته‌رنگ قرمز به سایه‌ها:
.Sp
.Vb 1
\&        colorbalance=rs=.3
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colorcontrast
.IX Subsection "colorcontrast"
تنظیم کنتراست رنگ میان مولفه‌های RGB.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrc\fR 4
.IX Item "rc"
تنظیم کنتراست قرمز-فیروزه‌ای. مقدار پیش‌فرض 0.0 است. محدوده مجاز از \-1.0 تا 1.0 است.
.IP \fBgm\fR 4
.IX Item "gm"
تنظیم کنتراست سبز-ارغوانی. مقدار پیش‌فرض 0.0 است. محدوده مجاز از \-1.0 تا 1.0 است.
.IP \fBby\fR 4
.IX Item "by"
تنظیم کنتراست آبی-زرد. مقدار پیش‌فرض 0.0 است. محدوده مجاز از \-1.0 تا 1.0 است.
.IP \fBrcw\fR 4
.IX Item "rcw"
.PD 0
.IP \fBgmw\fR 4
.IX Item "gmw"
.IP \fBbyw\fR 4
.IX Item "byw"
.PD
تنظیم وزن هر یک از مقادیر گزینه‌های \f(CW\*(C`rc\*(C'\fR، \f(CW\*(C`gm\*(C'\fR، \f(CW\*(C`by\*(C'\fR. مقدار پیش‌فرض 0.0 است.
محدوده مجاز از 0.0 تا 1.0 است. اگر تمامی وزن‌ها 0.0 باشند فیلترسازی غیرفعال می‌شود.
.IP \fBpl\fR 4
.IX Item "pl"
تنظیم میزان حفظ روشنایی. مقدار پیش‌فرض 0.0 است. محدوده مجاز از 0.0 تا 1.0 است.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colorcorrect
.IX Subsection "colorcorrect"
تنظیم انتخابی تراز سفیدی رنگ برای سیاهی‌ها و سفیدی‌ها.
این فیلتر در فضای رنگی YUV عمل می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrl\fR 4
.IX Item "rl"
تنظیم نقطه سایه قرمز. محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0 است.
.IP \fBbl\fR 4
.IX Item "bl"
تنظیم نقطه سایه آبی. محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0 است.
.IP \fBrh\fR 4
.IX Item "rh"
تنظیم نقطه روشنی قرمز. محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0 است.
.IP \fBbh\fR 4
.IX Item "bh"
تنظیم نقطه روشنی آبی. محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0 است.
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم میزان اشباع رنگ. محدوده مجاز از \-3.0 تا 3.0 است.
مقدار پیش‌فرض 1 است.
.IP \fBanalyze\fR 4
.IX Item "analyze"
اگر روی مقداری غیر از \f(CW\*(C`manual\*(C'\fR تنظیم شود، تک‌تک فریم‌ها را تحلیل کرده و از پارامترهای مشتق‌شده برای فیلتر کردن فریم خروجی استفاده می‌نماید.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fBmanual\fR 4
.IX Item "manual"
.PD 0
.IP \fBaverage\fR 4
.IX Item "average"
.IP \fBminmax\fR 4
.IX Item "minmax"
.IP \fBmedian\fR 4
.IX Item "median"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`manual\*(C'\fR است.
.RE
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colorchannelmixer
.IX Subsection "colorchannelmixer"
تنظیم فریم‌های ویدیویی ورودی از طریق بازترکیب کانال‌های رنگ.
.PP
این فیلتر یک کانال رنگ را با افزودن مقادیر مربوط به سایر کانال‌های همان پیکسل‌ها اصلاح می‌کند. برای نمونه اگر مقدار مورد نظر برای تغییر قرمز باشد، مقدار خروجی به شکل زیر خواهد بود:
.PP
.Vb 1
\&        <red>=<red>*<rr> + <blue>*<rb> + <green>*<rg> + <alpha>*<ra>
.Ve
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrr\fR 4
.IX Item "rr"
.PD 0
.IP \fBrg\fR 4
.IX Item "rg"
.IP \fBrb\fR 4
.IX Item "rb"
.IP \fBra\fR 4
.IX Item "ra"
.PD
تنظیم سهم کانال‌های ورودی قرمز، سبز، آبی و آلفا برای کانال خروجی قرمز.
پیش‌فرض برای \fIrr\fR برابر با \f(CW1\fR و برای \fIrg\fR، \fIrb\fR و \fIra\fR برابر با \f(CW0\fR است.
.IP \fBgr\fR 4
.IX Item "gr"
.PD 0
.IP \fBgg\fR 4
.IX Item "gg"
.IP \fBgb\fR 4
.IX Item "gb"
.IP \fBga\fR 4
.IX Item "ga"
.PD
تنظیم سهم کانال‌های ورودی قرمز، سبز، آبی و آلفا برای کانال خروجی سبز.
پیش‌فرض برای \fIgg\fR برابر با \f(CW1\fR و برای \fIgr\fR، \fIgb\fR و \fIga\fR برابر با \f(CW0\fR است.
.IP \fBbr\fR 4
.IX Item "br"
.PD 0
.IP \fBbg\fR 4
.IX Item "bg"
.IP \fBbb\fR 4
.IX Item "bb"
.IP \fBba\fR 4
.IX Item "ba"
.PD
تنظیم سهم کانال‌های ورودی قرمز، سبز، آبی و آلفا برای کانال خروجی آبی.
پیش‌فرض برای \fIbb\fR برابر با \f(CW1\fR و برای \fIbr\fR، \fIbg\fR و \fIba\fR برابر با \f(CW0\fR است.
.IP \fBar\fR 4
.IX Item "ar"
.PD 0
.IP \fBag\fR 4
.IX Item "ag"
.IP \fBab\fR 4
.IX Item "ab"
.IP \fBaa\fR 4
.IX Item "aa"
.PD
تنظیم سهم کانال‌های ورودی قرمز، سبز، آبی و آلفا برای کانال خروجی آلفا.
پیش‌فرض برای \fIaa\fR برابر با \f(CW1\fR و برای \fIar\fR، \fIag\fR و \fIab\fR برابر با \f(CW0\fR است.
.Sp
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[\-2.0, 2.0]\*(C'\fR است.
.IP \fBpc\fR 4
.IX Item "pc"
تنظیم حالت حفظ رنگ. مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی حفظ رنگ، این حالت پیش‌فرض است.
.IP \fBlum\fR 4
.IX Item "lum"
حفظ درخشندگی (luminance).
.IP \fBmax\fR 4
.IX Item "max"
حفظ مقدار بیشینه سه‌گانه RGB.
.IP \fBavg\fR 4
.IX Item "avg"
حفظ مقدار میانگین سه‌گانه RGB.
.IP \fBsum\fR 4
.IX Item "sum"
حفظ مقدار مجموع سه‌گانه RGB.
.IP \fBnrm\fR 4
.IX Item "nrm"
حفظ مقدار نرمال‌شده سه‌گانه RGB.
.IP \fBpwr\fR 4
.IX Item "pwr"
حفظ مقدار توان سه‌گانه RGB.
.RE
.RS 4
.RE
.IP \fBpa\fR 4
.IX Item "pa"
تنظیم میزان حفظ رنگ هنگام تغییر رنگ‌ها. محدوده مجاز از \f(CW\*(C`[0.0, 1.0]\*(C'\fR است.
مقدار پیش‌فرض \f(CW0.0\fR است، بنابراین غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
تبدیل منبع به مقیاس خاکستری (grayscale):
.Sp
.Vb 1
\&        colorchannelmixer=.3:.4:.3:0:.3:.4:.3:0:.3:.4:.3
.Ve
.IP \(bu 4
شبیه‌سازی تن‌های سپیا (sepia):
.Sp
.Vb 1
\&        colorchannelmixer=.393:.769:.189:0:.349:.686:.168:0:.272:.534:.131
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colordetect
.IX Subsection "colordetect"
تحلیل فریم‌های ویدیویی برای تعیین محدوده مقادیر موثر و حالت آلفا.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
مجموعه ویژگی‌ها برای تشخیص. ویژگی‌های در دسترس نبوده، مانند حالت آلفا برای تصویر ورودی فاقد کانال آلفا، به‌طور خودکار نادیده گرفته می‌شوند.
.Sp
ترکیبی از پرچم‌های زیر را می‌پذیرد:
.RS 4
.IP \fBcolor_range\fR 4
.IX Item "color_range"
تشخیص اینکه آیا منبع حاوی پیکسل‌های روشنایی (luma) خارج از محدوده محدود (MPEG) است یا خیر، که نشان می‌دهد این یک منبع YUV با محدوده کامل (full range) است.
.IP \fBalpha_mode\fR 4
.IX Item "alpha_mode"
تشخیص اینکه آیا منبع حاوی مقادیر رنگ بالاتر از کانال آلفا است یا خیر، که نشان می‌دهد کانال آلفا مستقیم (straight) است، نه از پیش ضرب‌شده (premultiplied). همچنین بررسی می‌کند که آیا صفحه آلفا کاملاً کدر است یا خیر.
.IP \fBall\fR 4
.IX Item "all"
فعال‌سازی تشخیص تمامی ویژگی‌های بالا. این حالت پیش‌فرض است.
.RE
.RS 4
.RE
.SS colorize
.IX Subsection "colorize"
انداختن یک رنگ یکدست بر روی جریان ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBhue\fR 4
.IX Item "hue"
تنظیم فام رنگ (hue). محدوده مجاز از 0 تا 360 است.
مقدار پیش‌فرض 0 است.
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم اشباع رنگ (saturation). محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0.5 است.
.IP \fBlightness\fR 4
.IX Item "lightness"
تنظیم روشنایی رنگ (lightness). محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0.5 است.
.IP \fBmix\fR 4
.IX Item "mix"
تنظیم آمیختگی روشنایی منبع. به‌طور پیش‌فرض 1.0 تعیین شده است.
محدوده مجاز از 0.0 تا 1.0 است.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colorkey
.IX Subsection "colorkey"
جداسازی رنگ (color keying) در فضای رنگی RGB.
این فیلتر بر روی فریم‌های فرمت 8 بیتی RGB عمل نموده و مولفه آلفای هر پیکسلی را که درون شعاع شباهت رنگ کلید قرار گیرد روی 0 تنظیم می‌کند. مقدار آلفا برای پیکسل‌های خارج از شعاع شباهت به مقدار گزینه blend بستگی دارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
تنظیم رنگی که آلفای آن روی 0 (شفافیت کامل) تنظیم خواهد شد.
بخش \fB"Color" در راهنمای ffmpeg\-utils\fR را ببینید.
پیش‌فرض \f(CW\*(C`black\*(C'\fR است.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
تنظیم شعاع پیرامون رنگ کلید که در محدوده آن سایر رنگ‌ها نیز شفافیت کامل خواهند داشت.
فاصله محاسبه‌شده مربوط به فاصله کسری واحد در فضای سه‌بعدی میان مقادیر RGB رنگ کلید و رنگ پیکسل است. محدوده بین 0.01 تا 1.0 است. مقدار 0.01 با شعاع بسیار کوچکی در اطراف رنگ کلید دقیق مطابقت می‌یابد، در حالی که 1.0 با همه چیز مطابقت دارد.
مقدار پیش‌فرض \f(CW0.01\fR است.
.IP \fBblend\fR 4
.IX Item "blend"
تنظیم چگونگی محاسبه مقدار آلفا برای پیکسل‌هایی که خارج از شعاع شباهت قرار می‌گیرند.
مقدار 0.0 پیکسل‌ها را یا کاملاً شفاف یا کاملاً کدر می‌سازد.
مقادیر بالاتر منجر به پیکسل‌های نیمه‌شفاف می‌شوند، به‌گونه‌ای که هرچه رنگ پیکسل به رنگ کلید شبیه‌تر باشد، شفافیت بیشتر خواهد بود.
محدوده بین 0.0 تا 1.0 است. پیش‌فرض \f(CW0.0\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
شفاف کردن هر پیکسل سبز در تصویر ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i input.png \-vf colorkey=green out.png
.Ve
.IP \(bu 4
انداختن یک ویدیوی پرده سبز بر روی یک تصویر پس‌زمینه ایستا:
.Sp
.Vb 1
\&        ffmpeg \-i background.png \-i video.mp4 \-filter_complex "[1:v]colorkey=0x3BBD1E:0.3:0.2[ckout];[0:v][ckout]overlay[out]" \-map "[out]" output.flv
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار جاری خود باقی می‌ماند.
.SS colorhold
.IX Subsection "colorhold"
حذف تمامی اطلاعات رنگ برای تمامی رنگ‌های RGB به جز یک رنگ خاص.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
رنگی که با خاکستری خنثی جایگزین نخواهد شد.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
درصد شباهت با رنگ فوق.
مقدار 0.01 تنها با رنگ کلید دقیق مطابقت دارد، در حالی که 1.0 با همه چیز مطابقت می‌یابد.
.IP \fBblend\fR 4
.IX Item "blend"
درصد آمیختگی. مقدار 0.0 پیکسل‌ها را کاملاً خاکستری می‌کند.
مقادیر بالاتر منجر به حفظ بیشتر رنگ می‌شوند.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار جاری خود باقی می‌ماند.
.SS colorlevels
.IX Subsection "colorlevels"
تنظیم فریم‌های ویدیویی ورودی با استفاده از سطوح (levels).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrimin\fR 4
.IX Item "rimin"
.PD 0
.IP \fBgimin\fR 4
.IX Item "gimin"
.IP \fBbimin\fR 4
.IX Item "bimin"
.IP \fBaimin\fR 4
.IX Item "aimin"
.PD
تنظیم نقطه سیاه ورودی قرمز، سبز، آبی و آلفا.
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[\-1.0, 1.0]\*(C'\fR است. مقادیر پیش‌فرض \f(CW0\fR هستند.
.IP \fBrimax\fR 4
.IX Item "rimax"
.PD 0
.IP \fBgimax\fR 4
.IX Item "gimax"
.IP \fBbimax\fR 4
.IX Item "bimax"
.IP \fBaimax\fR 4
.IX Item "aimax"
.PD
تنظیم نقطه سفید ورودی قرمز، سبز، آبی و آلفا.
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[\-1.0, 1.0]\*(C'\fR است. مقادیر پیش‌فرض \f(CW1\fR هستند.
.Sp
سطوح ورودی برای روشن‌تر کردن روشنی‌ها (تن‌های روشن)، تاریک‌تر کردن سایه‌ها (تن‌های تاریک)، و تغییر تراز تن‌های روشن و تاریک استفاده می‌شوند.
.IP \fBromin\fR 4
.IX Item "romin"
.PD 0
.IP \fBgomin\fR 4
.IX Item "gomin"
.IP \fBbomin\fR 4
.IX Item "bomin"
.IP \fBaomin\fR 4
.IX Item "aomin"
.PD
تنظیم نقطه سیاه خروجی قرمز، سبز، آبی و آلفا.
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[0, 1.0]\*(C'\fR است. مقادیر پیش‌فرض \f(CW0\fR هستند.
.IP \fBromax\fR 4
.IX Item "romax"
.PD 0
.IP \fBgomax\fR 4
.IX Item "gomax"
.IP \fBbomax\fR 4
.IX Item "bomax"
.IP \fBaomax\fR 4
.IX Item "aomax"
.PD
تنظیم نقطه سفید خروجی قرمز، سبز، آبی و آلفا.
محدوده‌های مجاز برای گزینه‌ها \f(CW\*(C`[0, 1.0]\*(C'\fR است. مقادیر پیش‌فرض \f(CW1\fR هستند.
.Sp
سطوح خروجی امکان انتخاب دستی یک محدوده سطح خروجی مقیدشده را فراهم می‌سازد.
.IP \fBpreserve\fR 4
.IX Item "preserve"
تنظیم حالت حفظ رنگ. مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی حفظ رنگ، این حالت پیش‌فرض است.
.IP \fBlum\fR 4
.IX Item "lum"
حفظ درخشندگی (luminance).
.IP \fBmax\fR 4
.IX Item "max"
حفظ مقدار بیشینه سه‌گانه RGB.
.IP \fBavg\fR 4
.IX Item "avg"
حفظ مقدار میانگین سه‌گانه RGB.
.IP \fBsum\fR 4
.IX Item "sum"
حفظ مقدار مجموع سه‌گانه RGB.
.IP \fBnrm\fR 4
.IX Item "nrm"
حفظ مقدار نرمال‌شده سه‌گانه RGB.
.IP \fBpwr\fR 4
.IX Item "pwr"
حفظ مقدار توان سه‌گانه RGB.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
تاریک‌تر کردن خروجی ویدیو:
.Sp
.Vb 1
\&        colorlevels=rimin=0.058:gimin=0.058:bimin=0.058
.Ve
.IP \(bu 4
افزایش کنتراست:
.Sp
.Vb 1
\&        colorlevels=rimin=0.039:gimin=0.039:bimin=0.039:rimax=0.96:gimax=0.96:bimax=0.96
.Ve
.IP \(bu 4
روشن‌تر کردن خروجی ویدیو:
.Sp
.Vb 1
\&        colorlevels=rimax=0.902:gimax=0.902:bimax=0.902
.Ve
.IP \(bu 4
افزایش روشنایی (brightness):
.Sp
.Vb 1
\&        colorlevels=romin=0.5:gomin=0.5:bomin=0.5
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS colormap
.IX Subsection "colormap"
اعمال نقشه‌های رنگی سفارشی به جریان ویدیو.
.PP
این فیلتر به سه جریان ویدیویی ورودی نیاز دارد.
جریان نخست، جریان ویدیویی است که قرار است فیلتر شود.
جریان‌های ویدیویی دوم و سوم، وصله‌های رنگی را برای نگاشت رنگ مبدا به رنگ مقصد تعیین می‌کنند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBpatch_size\fR 4
.IX Item "patch_size"
تنظیم اندازه وصله جریان ویدیویی مبدا و مقصد بر حسب پیکسل.
.IP \fBnb_patches\fR 4
.IX Item "nb_patches"
تنظیم بیشینه تعداد وصله‌های مورد استفاده از جریان ویدیویی مبدا و مقصد.
مقدار پیش‌فرض، تعداد وصله‌های موجود در جریان‌های ویدیویی اضافی است.
بیشینه تعداد مجاز وصله‌ها \f(CW64\fR است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم تغییرات مورد استفاده برای رنگ‌های مقصد. می‌تواند \f(CW\*(C`relative\*(C'\fR یا \f(CW\*(C`absolute\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`absolute\*(C'\fR است.
.IP \fBkernel\fR 4
.IX Item "kernel"
تنظیم هسته (kernel) مورد استفاده برای اندازه‌گیری تفاوت‌های رنگ میان رنگ‌های نگاشت‌شده.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBeuclidean\fR 4
.IX Item "euclidean"
.PD 0
.IP \fBweuclidean\fR 4
.IX Item "weuclidean"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`euclidean\*(C'\fR است.
.RE
.SS colormatrix
.IX Subsection "colormatrix"
تبدیل ماتریس رنگ.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsrc\fR 4
.IX Item "src"
.PD 0
.IP \fBdst\fR 4
.IX Item "dst"
.PD
مشخص کردن ماتریس رنگ مبدا و مقصد. هر دو مقدار باید تعیین شوند.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBfcc\fR 4
.IX Item "fcc"
FCC
.IP \fBbt601\fR 4
.IX Item "bt601"
BT.601
.IP \fBbt470\fR 4
.IX Item "bt470"
BT.470
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.RE
.RS 4
.RE
.PP
برای نمونه جهت تبدیل از BT.601 به SMPTE\-240M، از این دستور استفاده کنید:
.PP
.Vb 1
\&        colormatrix=bt601:smpte240m
.Ve
.SS colorspace
.IX Subsection "colorspace"
تبدیل فضای رنگی، ویژگی‌های انتقال (transfer characteristics) یا رنگ‌های پایه (color primaries).
اندازه ویدیوی ورودی باید زوج باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBall\fR 4
.IX Item "all"
مشخص کردن تمامی ویژگی‌های رنگ به طور همزمان.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt470m\fR 4
.IX Item "bt470m"
BT.470M
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG
.IP \fBbt601\-6\-525\fR 4
.IX Item "bt601-6-525"
BT.601\-6 525
.IP \fBbt601\-6\-625\fR 4
.IX Item "bt601-6-625"
BT.601\-6 625
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.RE
.RS 4
.RE
.IP \fBspace\fR 4
.IX Item "space"
مشخص کردن فضای رنگی خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBfcc\fR 4
.IX Item "fcc"
FCC
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG یا BT.601\-6 625
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M یا BT.601\-6 525
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBycgco\fR 4
.IX Item "ycgco"
YCgCo
.IP \fBbt2020ncl\fR 4
.IX Item "bt2020ncl"
BT.2020 با درخشندگی غیرثابت
.RE
.RS 4
.RE
.IP \fBtrc\fR 4
.IX Item "trc"
مشخص کردن ویژگی‌های انتقال خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBbt470m\fR 4
.IX Item "bt470m"
BT.470M
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG
.IP \fBgamma22\fR 4
.IX Item "gamma22"
گامای ثابت 2.2
.IP \fBgamma28\fR 4
.IX Item "gamma28"
گامای ثابت 2.8
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M، BT.601\-6 625 یا BT.601\-6 525
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBsrgb\fR 4
.IX Item "srgb"
SRGB
.IP \fBiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
iec61966\-2\-1
.IP \fBiec61966\-2\-4\fR 4
.IX Item "iec61966-2-4"
iec61966\-2\-4
.IP \fBxvycc\fR 4
.IX Item "xvycc"
xvycc
.IP \fBbt2020\-10\fR 4
.IX Item "bt2020-10"
BT.2020 برای محتوای 10 بیتی
.IP \fBbt2020\-12\fR 4
.IX Item "bt2020-12"
BT.2020 برای محتوای 12 بیتی
.RE
.RS 4
.RE
.IP \fBprimaries\fR 4
.IX Item "primaries"
مشخص کردن رنگ‌های پایه خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBbt470m\fR 4
.IX Item "bt470m"
BT.470M
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG یا BT.601\-6 625
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M یا BT.601\-6 525
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBfilm\fR 4
.IX Item "film"
film
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
SMPTE\-431
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
SMPTE\-432
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.IP \fBjedec\-p22\fR 4
.IX Item "jedec-p22"
فسفرهای JEDEC P22
.RE
.RS 4
.RE
.IP \fBrange\fR 4
.IX Item "range"
مشخص کردن محدوده رنگ خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBtv\fR 4
.IX Item "tv"
محدوده TV (محدود)
.IP \fBmpeg\fR 4
.IX Item "mpeg"
محدوده MPEG (محدود)
.IP \fBpc\fR 4
.IX Item "pc"
محدوده PC (کامل)
.IP \fBjpeg\fR 4
.IX Item "jpeg"
محدوده JPEG (کامل)
.RE
.RS 4
.RE
.IP \fBformat\fR 4
.IX Item "format"
مشخص کردن فرمت رنگ خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fByuv420p\fR 4
.IX Item "yuv420p"
YUV 4:2:0 سطح‌بندی‌شده 8 بیتی
.IP \fByuv420p10\fR 4
.IX Item "yuv420p10"
YUV 4:2:0 سطح‌بندی‌شده 10 بیتی
.IP \fByuv420p12\fR 4
.IX Item "yuv420p12"
YUV 4:2:0 سطح‌بندی‌شده 12 بیتی
.IP \fByuv422p\fR 4
.IX Item "yuv422p"
YUV 4:2:2 سطح‌بندی‌شده 8 بیتی
.IP \fByuv422p10\fR 4
.IX Item "yuv422p10"
YUV 4:2:2 سطح‌بندی‌شده 10 بیتی
.IP \fByuv422p12\fR 4
.IX Item "yuv422p12"
YUV 4:2:2 سطح‌بندی‌شده 12 بیتی
.IP \fByuv444p\fR 4
.IX Item "yuv444p"
YUV 4:4:4 سطح‌بندی‌شده 8 بیتی
.IP \fByuv444p10\fR 4
.IX Item "yuv444p10"
YUV 4:4:4 سطح‌بندی‌شده 10 بیتی
.IP \fByuv444p12\fR 4
.IX Item "yuv444p12"
YUV 4:4:4 سطح‌بندی‌شده 12 بیتی
.RE
.RS 4
.RE
.IP \fBfast\fR 4
.IX Item "fast"
انجام یک تبدیل سریع، که از تصحیح گاما/رنگ‌های پایه صرف‌نظر می‌کند. این کار بار پردازشی CPU را به طور چشمگیری کاهش می‌دهد، اما از نظر ریاضی نادرست خواهد بود. برای دریافت خروجی سازگار با آنچه فیلتر colormatrix تولید می‌کند، از fast=1 استفاده نمایید.
.IP \fBdither\fR 4
.IX Item "dither"
مشخص کردن حالت ترام‌زنی (dithering).
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
بدون ترام‌زنی
.IP \fBfsb\fR 4
.IX Item "fsb"
ترام‌زنی فلوید-اشتاینبرگ (Floyd\-Steinberg)
.RE
.RS 4
.RE
.IP \fBwpadapt\fR 4
.IX Item "wpadapt"
حالت انطباق نقطه سفید.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbradford\fR 4
.IX Item "bradford"
انطباق نقطه سفید بردفورد
.IP \fBvonkries\fR 4
.IX Item "vonkries"
انطباق نقطه سفید فون کریس
.IP \fBidentity\fR 4
.IX Item "identity"
انطباق همانی نقطه سفید (یعنی بدون انطباق نقطه سفید)
.RE
.RS 4
.RE
.IP \fBclipgamut\fR 4
.IX Item "clipgamut"
کنترل چگونگی برش دادن (clip) رنگ‌های خارج از گستره که در نتیجه تبدیل فضای رنگی به وجود می‌آیند.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
عدم برش رنگ‌های خارج از گستره.
.IP \fBrgb\fR 4
.IX Item "rgb"
برش مقادیر RGB به محدوده [0, 1] هنگام ساخت LUTهای انتقال گاما.
.RE
.RS 4
.RE
.IP \fBiall\fR 4
.IX Item "iall"
بازنویسی تمامی ویژگی‌های ورودی به طور همزمان. همان مقادیر پذیرفته‌شده برای \fBall\fR.
.IP \fBispace\fR 4
.IX Item "ispace"
بازنویسی فضای رنگی ورودی. همان مقادیر پذیرفته‌شده برای \fBspace\fR.
.IP \fBiprimaries\fR 4
.IX Item "iprimaries"
بازنویسی رنگ‌های پایه ورودی. همان مقادیر پذیرفته‌شده برای \fBprimaries\fR.
.IP \fBitrc\fR 4
.IX Item "itrc"
بازنویسی ویژگی‌های انتقال ورودی. همان مقادیر پذیرفته‌شده برای \fBtrc\fR.
.IP \fBirange\fR 4
.IX Item "irange"
بازنویسی محدوده رنگ ورودی. همان مقادیر پذیرفته‌شده برای \fBrange\fR.
.PP
این فیلتر ویژگی‌های انتقال، فضای رنگ و رنگ‌های پایه را به مقادیر مشخص‌شده توسط کاربر تبدیل می‌کند. مقدار خروجی در صورت عدم تعیین، بر اساس ویژگی "all" بر روی یک مقدار پیش‌فرض تنظیم می‌شود. اگر آن ویژگی نیز مشخص نشده باشد، فیلتر خطایی را ثبت خواهد کرد. محدوده رنگ و فرمت خروجی به طور پیش‌فرض روی همان مقدار محدوده رنگ و فرمت ورودی تنظیم می‌شوند. ویژگی‌های انتقال، فضای رنگ، رنگ‌های پایه و محدوده رنگ ورودی باید روی داده‌های ورودی مشخص باشند. در صورت مفقود بودن هر یک از این موارد، فیلتر خطایی ثبت کرده و هیچ تبدیلی صورت نخواهد گرفت.
.PP
برای نمونه جهت تبدیل ورودی به SMPTE\-240M، از این دستور استفاده کنید:
.PP
.Vb 1
\&        colorspace=smpte240m
.Ve
.SS colortemperature
.IX Subsection "colortemperature"
تنظیم دمای رنگ در ویدیو جهت شبیه‌سازی تغییرات در دمای رنگ محیط.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtemperature\fR 4
.IX Item "temperature"
تنظیم دما بر حسب کلوین. محدوده مجاز از 1000 تا 40000 است.
مقدار پیش‌فرض 6500 کلوین است.
.IP \fBmix\fR 4
.IX Item "mix"
تنظیم میزان آمیختگی با خروجی فیلترشده. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 1 است.
.IP \fBpl\fR 4
.IX Item "pl"
تنظیم میزان حفظ روشنایی. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0 است.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
.SS convolution
.IX Subsection "convolution"
اعمال پیچش (کانولوشن) 3x3، 5x5، 7x7 یا افقی/عمودی تا 49 عنصر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fB0m\fR 4
.IX Item "0m"
.PD 0
.IP \fB1m\fR 4
.IX Item "1m"
.IP \fB2m\fR 4
.IX Item "2m"
.IP \fB3m\fR 4
.IX Item "3m"
.PD
تنظیم ماتریس برای هر صفحه (plane).
ماتریس دنباله‌ای از 9، 25 یا 49 عدد صحیح علامت‌دار در حالت \fIsquare\fR،
و از 1 تا 49 عدد فرد از اعداد صحیح علامت‌دار در حالت \fIrow\fR است.
.IP \fB0rdiv\fR 4
.IX Item "0rdiv"
.PD 0
.IP \fB1rdiv\fR 4
.IX Item "1rdiv"
.IP \fB2rdiv\fR 4
.IX Item "2rdiv"
.IP \fB3rdiv\fR 4
.IX Item "3rdiv"
.PD
تنظیم ضریب تقسیم برای مقدار محاسبه‌شده برای هر صفحه.
در صورت عدم تنظیم یا 0 بودن، برابر با 1 تقسیم بر مجموع تمامی عناصر ماتریس خواهد بود.
.IP \fB0bias\fR 4
.IX Item "0bias"
.PD 0
.IP \fB1bias\fR 4
.IX Item "1bias"
.IP \fB2bias\fR 4
.IX Item "2bias"
.IP \fB3bias\fR 4
.IX Item "3bias"
.PD
تنظیم انحراف (بایاس) برای هر صفحه. این مقدار به حاصل‌ضرب افزوده می‌شود.
برای روشن‌تر یا تاریک‌تر کردن تصویر کلی مفید است. پیش‌فرض 0.0 است.
.IP \fB0mode\fR 4
.IX Item "0mode"
.PD 0
.IP \fB1mode\fR 4
.IX Item "1mode"
.IP \fB2mode\fR 4
.IX Item "2mode"
.IP \fB3mode\fR 4
.IX Item "3mode"
.PD
تنظیم حالت ماتریس برای هر صفحه. می‌تواند \fIsquare\fR، \fIrow\fR یا \fIcolumn\fR باشد.
پیش‌فرض \fIsquare\fR است.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
اعمال وضوح‌بخشی (sharpen):
.Sp
.Vb 1
\&        convolution="0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0"
.Ve
.IP \(bu 4
اعمال مات‌شدگی (blur):
.Sp
.Vb 1
\&        convolution="1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1/9:1/9:1/9:1/9"
.Ve
.IP \(bu 4
اعمال تقویت لبه (edge enhance):
.Sp
.Vb 1
\&        convolution="0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:5:1:1:1:0:128:128:128"
.Ve
.IP \(bu 4
اعمال تشخیص لبه (edge detect):
.Sp
.Vb 1
\&        convolution="0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:5:5:5:1:0:128:128:128"
.Ve
.IP \(bu 4
اعمال آشکارساز لبه لاپلاسی شامل قطرها:
.Sp
.Vb 1
\&        convolution="1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:5:5:5:1:0:128:128:0"
.Ve
.IP \(bu 4
اعمال برجسته‌کاری (emboss):
.Sp
.Vb 1
\&        convolution="\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2"
.Ve
.SS convolve
.IX Subsection "convolve"
اعمال پیچش دوبعدی جریان ویدیو در حوزه فرکانس با استفاده از جریان دوم به عنوان پاسخ ضربه (impulse).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید پردازش شوند.
.IP \fBimpulse\fR 4
.IX Item "impulse"
تنظیم اینکه کدام فریم‌های ویدیویی ضربه پردازش خواهند شد؛ می‌تواند \fIfirst\fR
یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
.PP
فیلتر \f(CW\*(C`convolve\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.SS copy
.IX Subsection "copy"
کپی کردن منبع ویدیویی ورودی بدون تغییر به خروجی. این فیلتر عمدتاً برای اهداف آزمایشی کاربرد دارد.
.SS coreimage
.IX Subsection "coreimage"
فیلترسازی ویدیو بر روی GPU با استفاده از API برنامه CoreImage شرکت اپل در OSX.
.PP
شتاب‌دهی سخت‌افزاری بر پایه یک بافت (context) اوپن‌جی‌ال (OpenGL) است. معمولاً این بدان معناست که پردازش توسط سخت‌افزار ویدیو انجام می‌گیرد. با این حال، پیاده‌سازی‌های نرم‌افزاری OpenGL وجود دارند که نشان می‌دهد هیچ تضمینی برای پردازش سخت‌افزاری وجود ندارد؛ این موضوع به OSX مربوطه بستگی دارد.
.PP
فیلترها و مولدهای تصویر فراوانی توسط اپل ارائه شده‌اند که با تنوع زیادی از گزینه‌ها همراه هستند. فیلتر باید با نام آن به همراه گزینه‌هایش مورد ارجاع قرار گیرد.
.PP
فیلتر coreimage گزینه‌های زیر را می‌پذیرد:
.IP \fBlist_filters\fR 4
.IX Item "list_filters"
فهرست کردن تمامی فیلترها و مولدهای موجود به همراه تمامی گزینه‌های مربوطه و همچنین حداقل و حداکثر مقادیر ممکن در کنار مقادیر پیش‌فرض.
.Sp
.Vb 1
\&        list_filters=true
.Ve
.IP \fBfilter\fR 4
.IX Item "filter"
مشخص کردن تمامی فیلترها با نام و گزینه‌های مربوط به آن‌ها.
از \fIlist_filters\fR برای تعیین تمامی نام‌ها و گزینه‌های معتبر فیلتر استفاده کنید.
گزینه‌های عددی با یک مقدار اعشاری تعیین می‌شوند و به‌طور خودکار به محدوده مقادیر مربوط به خود مقید (clamped) می‌گردند. گزینه‌های برداری و رنگ باید با فهرستی از مقادیر اعشاری جداشده با فاصله تعیین شوند. گریز کاراکترها (escaping) باید انجام شود.
یک نام گزینه ویژه \f(CW\*(C`default\*(C'\fR برای استفاده از گزینه‌های پیش‌فرض یک فیلتر در دسترس است.
.Sp
تعیین \f(CW\*(C`default\*(C'\fR یا دست‌کم یکی از گزینه‌های فیلتر الزامی است.
تمامی گزینه‌های حذف‌شده با مقادیر پیش‌فرض خود به کار می‌روند.
ساختار نحوی رشته فیلتر به شرح زیر است:
.Sp
.Vb 1
\&        filter=<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...][#<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...]][#...]
.Ve
.IP \fBoutput_rect\fR 4
.IX Item "output_rect"
مشخص کردن مستطیلی که خروجی زنجیره فیلتر در آن به داخل تصویر ورودی کپی می‌شود. این مستطیل با فهرستی از مقادیر اعشاری جداشده با فاصله مشخص می‌گردد:
.Sp
.Vb 1
\&        output_rect=x\e y\e width\e height
.Ve
.Sp
در صورت عدم تعیین، مستطیل خروجی برابر با ابعاد تصویر ورودی خواهد بود.
مستطیل خروجی به‌طور خودکار در مرزهای تصویر ورودی برش می‌خورد. مقادیر منفی برای هر مولفه معتبر هستند.
.Sp
.Vb 1
\&        output_rect=25\e 25\e 100\e 100
.Ve
.PP
چندین فیلتر را می‌توان برای پردازش متوالی بدون انتقال‌های GPU-HOST به یکدیگر زنجیر کرد که امکان پردازش سریع زنجیره‌های فیلتر پیچیده را فراهم می‌سازد.
در حال حاضر تنها فیلترهای با صفر (مولدها) یا دقیقاً یک تصویر ورودی (فیلترها) و یک تصویر خروجی پشتیبانی می‌شوند. همچنین، فیلترهای گذار (transition) هنوز همان‌طور که در نظر گرفته شده قابل استفاده نیستند.
.PP
برخی فیلترها بسته به هسته فیلتر مربوطه، تصاویر خروجی را با لایه‌گذاری (padding) اضافی تولید می‌کنند. این لایه‌گذاری به‌طور خودکار حذف می‌شود تا اطمینان حاصل گردد که خروجی فیلتر دارای اندازه‌ای یکسان با تصویر ورودی است.
.PP
برای مولدهای تصویر، اندازه تصویر خروجی به ترتیب با تصویر خروجی قبلی زنجیره فیلتر یا تصویر ورودی کل زنجیره فیلتر تعیین می‌شود. مولدها برای تولید خروجی خود از اطلاعات پیکسلی این تصویر استفاده نمی‌کنند. با این حال، خروجی تولیدشده بر روی این تصویر آمیخته (blended) می‌شود که منجر به پوشش جزئی یا کامل تصویر خروجی می‌گردد.
.PP
منبع ویدیویی \fBcoreimagesrc\fR می‌تواند برای تولید تصاویر ورودی که مستقیماً به زنجیره فیلتر تغذیه می‌شوند به کار رود. با استفاده از آن، ارائه تصاویر ورودی توسط یک منبع ویدیویی دیگر یا یک ویدیوی ورودی الزامی نیست.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
فهرست کردن تمامی فیلترهای در دسترس:
.Sp
.Vb 1
\&        coreimage=list_filters=true
.Ve
.IP \(bu 4
استفاده از فیلتر CIBoxBlur با گزینه‌های پیش‌فرض برای تار کردن یک تصویر:
.Sp
.Vb 1
\&        coreimage=filter=CIBoxBlur@default
.Ve
.IP \(bu 4
استفاده از یک زنجیره فیلتر با CISepiaTone در مقادیر پیش‌فرض و CIVignetteEffect با مرکز آن در 100x100 و شعاع 50 پیکسل:
.Sp
.Vb 1
\&        coreimage=filter=CIBoxBlur@default#CIVignetteEffect@inputCenter=100\e 100@inputRadius=50
.Ve
.IP \(bu 4
استفاده از nullsrc و CIQRCodeGenerator برای ایجاد یک کد QR برای صفحه خانگی FFmpeg، که به عنوان خط فرمان کامل و اسکیپ‌شده برای پوسته استاندارد bash اپل ارائه شده است:
.Sp
.Vb 1
\&        ffmpeg \-f lavfi \-i nullsrc=s=100x100,coreimage=filter=CIQRCodeGenerator@inputMessage=https\e\e\e\e\e://FFmpeg.org@inputCorrectionLevel=H \-frames:v 1 QRCode.png
.Ve
.SS corr
.IX Subsection "corr"
به‌دست آوردن میزان همبستگی (correlation) میان دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی را می‌پذیرد.
.PP
هر دو ویدیوی ورودی برای عملکرد صحیح این فیلتر باید تفکیک‌پذیری و فرمت پیکسلی یکسانی داشته باشند. همچنین فرض می‌شود که هر دو ورودی تعداد فریم‌های برابری دارند که فریم‌به‌فریم با یکدیگر مقایسه می‌شوند.
.PP
همبستگی به‌دست‌آمده به ازای هر مولفه، میانگین، کمینه و بیشینه از طریق سامانه گزارش‌گیری (logging) چاپ می‌شود.
.PP
این فیلتر همبستگی محاسبه‌شده هر فریم را در فراداده فریم ذخیره می‌کند.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
در مثال زیر فایل ورودی \fImain.mpg\fR در حال پردازش با فایل مرجع \fIref.mpg\fR مقایسه می‌شود.
.PP
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mpg \-lavfi corr \-f null \-
.Ve
.SS cover_rect
.IX Subsection "cover_rect"
پوشاندن یک شیء مستطیلی شکل.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcover\fR 4
.IX Item "cover"
مسیر فایل تصویر پوششی اختیاری، باید در فرمت yuv420 باشد.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت پوشش.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBcover\fR 4
.IX Item "cover"
پوشاندن آن با تصویر ارائه‌شده
.IP \fBblur\fR 4
.IX Item "blur"
پوشاندن آن از طریق درون‌یابی پیکسل‌های پیرامونی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIblur\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
پوشاندن یک شیء مستطیلی با تصویر ارائه‌شده از یک ویدیوی مشخص با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i file.ts \-vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
.Ve
.SS crop
.IX Subsection "crop"
برش ویدیوی ورودی به ابعاد داده‌شده.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBw, out_w\fR" 4
.IX Item "w, out_w"
عرض ویدیوی خروجی. مقدار پیش‌فرض \f(CW\*(C`iw\*(C'\fR است.
این عبارت تنها یک بار در حین پیکربندی فیلتر، یا هنگامی که دستور \fBw\fR یا \fBout_w\fR ارسال می‌شود ارزیابی می‌گردد.
.IP "\fBh, out_h\fR" 4
.IX Item "h, out_h"
ارتفاع ویدیوی خروجی. مقدار پیش‌فرض \f(CW\*(C`ih\*(C'\fR است.
این عبارت تنها یک بار در حین پیکربندی فیلتر، یا هنگامی که دستور \fBh\fR یا \fBout_h\fR ارسال می‌شود ارزیابی می‌گردد.
.IP \fBx\fR 4
.IX Item "x"
موقعیت افقی لبه چپ ویدیوی خروجی در ویدیوی ورودی. مقدار پیش‌فرض \f(CW\*(C`(in_w\-out_w)/2\*(C'\fR است.
این عبارت به ازای هر فریم ارزیابی می‌شود.
.IP \fBy\fR 4
.IX Item "y"
موقعیت عمودی لبه بالایی ویدیوی خروجی در ویدیوی ورودی. مقدار پیش‌فرض \f(CW\*(C`(in_h\-out_h)/2\*(C'\fR است.
این عبارت به ازای هر فریم ارزیابی می‌شود.
.IP \fBkeep_aspect\fR 4
.IX Item "keep_aspect"
در صورت تنظیم روی 1، نسبت ابعاد تصویر نمایشی (DAR) خروجی را با تغییر نسبت ابعاد نمونه (SAR) خروجی، مجبور به یکسان بودن با ورودی می‌کند. مقدار پیش‌فرض 0 است.
.IP \fBexact\fR 4
.IX Item "exact"
فعال‌سازی برش دقیق. در صورت فعال بودن، ویدیوهای زیرنمونه‌برداری‌شده دقیقاً در عرض/ارتفاع/x/y تعیین‌شده برش می‌خورند و به نزدیک‌ترین مقدار کوچک‌تر گرد نمی‌شوند.
مقدار پیش‌فرض 0 است.
.PP
پارامترهای \fIout_w\fR، \fIout_h\fR، \fIx\fR و \fIy\fR عباراتی حاوی ثابت‌های زیر هستند:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مقادیر محاسبه‌شده برای \fIx\fR و \fIy\fR. این مقادیر برای هر فریم جدید ارزیابی می‌شوند.
.IP \fBin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fBin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ورودی.
.IP \fBiw\fR 4
.IX Item "iw"
.PD 0
.IP \fBih\fR 4
.IX Item "ih"
.PD
همانند \fIin_w\fR و \fIin_h\fR هستند.
.IP \fBout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fBout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع خروجی (برش‌خورده).
.IP \fBow\fR 4
.IX Item "ow"
.PD 0
.IP \fBoh\fR 4
.IX Item "oh"
.PD
همانند \fIout_w\fR و \fIout_h\fR هستند.
.IP \fBa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی.
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد تصویر نمایشی ورودی، همانند (\fIiw\fR / \fIih\fR) * \fIsar\fR است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری افقی و عمودی کروما. برای مثال برای فرمت پیکسلی "yuv422p" مقدار \fIhsub\fR برابر با 2 و \fIvsub\fR برابر با 1 است.
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، شروع از 0.
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم ورودی در فایل، در صورت نامشخص بودن NAN؛ منسوخ‌شده، استفاده نکنید.
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بر حسب ثانیه. در صورت نامشخص بودن برچسب زمانی ورودی NAN است.
.PP
عبارت برای \fIout_w\fR ممکن است به مقدار \fIout_h\fR وابسته باشد، و عبارت برای \fIout_h\fR ممکن است به \fIout_w\fR وابسته باشد، اما آن‌ها نمی‌توانند به \fIx\fR و \fIy\fR وابسته باشند، زیرا \fIx\fR و \fIy\fR پس از \fIout_w\fR و \fIout_h\fR ارزیابی می‌شوند.
.PP
پارامترهای \fIx\fR و \fIy\fR عبارات مربوط به موقعیت گوشه بالا-چپ ناحیه خروجی (برش‌نخورده) را تعیین می‌کنند. آن‌ها برای هر فریم ارزیابی می‌شوند. اگر مقدار ارزیابی‌شده نامعتبر باشد، به نزدیک‌ترین مقدار معتبر تقریب زده می‌شود.
.PP
عبارت برای \fIx\fR ممکن است به \fIy\fR وابسته باشد، و عبارت برای \fIy\fR ممکن است به \fIx\fR وابسته باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
برش ناحیه‌ای به ابعاد 100x100 در موقعیت (12,34):
.Sp
.Vb 1
\&        crop=100:100:12:34
.Ve
.Sp
با استفاده از گزینه‌های نام‌گذاری‌شده، مثال بالا به این شکل خواهد بود:
.Sp
.Vb 1
\&        crop=w=100:h=100:x=12:y=34
.Ve
.IP \(bu 4
برش ناحیه مرکزی ورودی به ابعاد 100x100:
.Sp
.Vb 1
\&        crop=100:100
.Ve
.IP \(bu 4
برش ناحیه مرکزی ورودی به اندازه 2/3 از ویدیوی ورودی:
.Sp
.Vb 1
\&        crop=2/3*in_w:2/3*in_h
.Ve
.IP \(bu 4
برش مربع مرکزی ویدیوی ورودی:
.Sp
.Vb 2
\&        crop=out_w=in_h
\&        crop=in_h
.Ve
.IP \(bu 4
محدود کردن مستطیل با گوشه بالا-چپ در موقعیت 100:100 و گوشه پایین-راست منطبق بر گوشه پایین-راست تصویر ورودی:
.Sp
.Vb 1
\&        crop=in_w\-100:in_h\-100:100:100
.Ve
.IP \(bu 4
برش 10 پیکسل از حاشیه‌های چپ و راست، و 20 پیکسل از حاشیه‌های بالا و پایین:
.Sp
.Vb 1
\&        crop=in_w\-2*10:in_h\-2*20
.Ve
.IP \(bu 4
نگه‌داشتن تنها ربع پایین-راست تصویر ورودی:
.Sp
.Vb 1
\&        crop=in_w/2:in_h/2:in_w/2:in_h/2
.Ve
.IP \(bu 4
برش ارتفاع برای دستیابی به تناسب طلایی (یونانی):
.Sp
.Vb 1
\&        crop=in_w:1/PHI*in_w
.Ve
.IP \(bu 4
اعمال افکت لرزش:
.Sp
.Vb 1
\&        crop=in_w/2:in_h/2:(in_w\-out_w)/2+((in_w\-out_w)/2)*sin(n/10):(in_h\-out_h)/2 +((in_h\-out_h)/2)*sin(n/7)
.Ve
.IP \(bu 4
اعمال افکت دوربین متزلزل وابسته به برچسب زمانی:
.Sp
.Vb 1
\&        crop=in_w/2:in_h/2:(in_w\-out_w)/2+((in_w\-out_w)/2)*sin(t*10):(in_h\-out_h)/2 +((in_h\-out_h)/2)*sin(t*13)
.Ve
.IP \(bu 4
تنظیم x وابسته به مقدار y:
.Sp
.Vb 1
\&        crop=in_w/2:in_h/2:y:10+10*sin(n/10)
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBw, out_w\fR" 4
.IX Item "w, out_w"
.PD 0
.IP "\fBh, out_h\fR" 4
.IX Item "h, out_h"
.IP \fBx\fR 4
.IX Item "x"
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم عرض/ارتفاع ویدیوی خروجی و موقعیت افقی/عمودی در ویدیوی ورودی.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار جاری خود باقی می‌ماند.
.SS cropdetect
.IX Subsection "cropdetect"
تشخیص خودکار اندازه برش.
.PP
این فیلتر پارامترهای برش مورد نیاز را محاسبه کرده و پارامترهای توصیه‌شده را از طریق سامانه گزارش‌گیری چاپ می‌کند. ابعاد شناسایی‌شده متناظر با ناحیه غیرسیاه یا ناحیه ویدیویی ویدیوی ورودی بر اساس \fImode\fR است.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
بسته به \fImode\fR، تشخیص برش بر پایه صِرف مقدار سیاهی پیکسل‌های اطراف، یا ترکیبی از بردارهای حرکت و پیکسل‌های لبه صورت می‌گیرد.
.RS 4
.IP \fBblack\fR 4
.IX Item "black"
تشخیص پیکسل‌های سیاه پیرامون ویدیوی در حال پخش. برای کنترل دقیق‌تر از گزینه \fIlimit\fR استفاده کنید.
.IP \fBmvedges\fR 4
.IX Item "mvedges"
تشخیص ویدیوی در حال پخش با کمک بردارهای حرکت درون ویدیو و پویش پیکسل‌های لبه که معمولاً مرز یک ویدیوی در حال پخش را تشکیل می‌دهند.
.RE
.RS 4
.RE
.IP \fBlimit\fR 4
.IX Item "limit"
تنظیم آستانه مقدار سیاهی بالاتر، که می‌تواند به صورت اختیاری از هیچ (0) تا همه‌چیز (255 برای فرمت‌های بر پایه 8 بیت) تعیین گردد. مقدار شدتی بیشتر از مقدار تنظیم‌شده غیرسیاه تلقی می‌شود. پیش‌فرض 24 است.
همچنین می‌توانید مقداری بین 0.0 و 1.0 تعیین کنید که بسته به عمق بیتی فرمت پیکسلی مقیاس‌بندی خواهد شد.
.IP \fBround\fR 4
.IX Item "round"
مقداری که عرض/ارتفاع باید بر آن بخش‌پذیر باشد. پیش‌فرض 16 است. آفست به‌طور خودکار جهت مرکز قرار دادن ویدیو تنظیم می‌شود. از 2 برای دریافت تنها ابعاد زوج استفاده کنید (برای ویدیوی 4:2:2 لازم است). مقدار 16 هنگام رمزگذاری با بیشتر کدک‌های ویدیویی بهترین است.
.IP \fBskip\fR 4
.IX Item "skip"
تنظیم تعداد فریم‌های ابتدایی که ارزیابی برای آن‌ها نادیده گرفته می‌شود.
پیش‌فرض 2 است. محدوده بین 0 تا INT_MAX است.
.IP "\fBreset_count, reset\fR" 4
.IX Item "reset_count, reset"
تنظیم شمارنده‌ای که تعیین می‌کند پس از چند فریم cropdetect بزرگ‌ترین ناحیه ویدیویی شناسایی‌شده قبلی را بازنشانی کرده و دوباره برای تشخیص ناحیه بهینه کنونی آغاز کند. مقدار پیش‌فرض 0 است.
.Sp
این گزینه زمانی که لوگوی شبکه‌ها ناحیه ویدیو را دستخوش اعوجاج می‌کند می‌تواند سودمند باشد. مقدار 0 بیانگر «هرگز بازنشانی نکن» است و بزرگ‌ترین ناحیه دیده‌شده در طول پخش را بازمی‌گرداند.
.IP \fBmv_threshold\fR 4
.IX Item "mv_threshold"
تنظیم میزان حرکت بر حسب واحدهای پیکسلی به عنوان آستانه تشخیص حرکت. پیش‌فرض 8 است.
.IP \fBlow\fR 4
.IX Item "low"
.PD 0
.IP \fBhigh\fR 4
.IX Item "high"
.PD
تنظیم مقادیر آستانه پایین و بالا مورد استفاده توسط الگوریتم آستانه‌گذاری کَنی (Canny).
.Sp
آستانه بالا پیکسل‌های لبه "قوی" را برمی‌گزیند، که سپس از طریق اتصال 8 جهته به پیکسل‌های لبه "ضعیف" انتخاب‌شده توسط آستانه پایین متصل می‌شوند.
.Sp
مقادیر آستانه \&\fIlow\fR و \fIhigh\fR باید در بازه [0,1] انتخاب شوند، و \fIlow\fR باید کمتر یا مساوی با \fIhigh\fR باشد.
.Sp
مقدار پیش‌فرض برای \fIlow\fR برابر با \f(CW\*(C`5/255\*(C'\fR و برای \fIhigh\fR برابر با \f(CW\*(C`15/255\*(C'\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
یافتن ناحیه ویدیو احاطه‌شده توسط حاشیه‌های سیاه:
.Sp
.Vb 1
\&        ffmpeg \-i file.mp4 \-vf cropdetect,metadata=mode=print \-f null \-
.Ve
.IP \(bu 4
یافتن یک ناحیه ویدیوی تعبیه‌شده، همراه با تولید بردارهای حرکت از قبل:
.Sp
.Vb 1
\&        ffmpeg \-i file.mp4 \-vf mestimate,cropdetect=mode=mvedges,metadata=mode=print \-f null \-
.Ve
.IP \(bu 4
یافتن یک ناحیه ویدیوی تعبیه‌شده با استفاده از بردارهای حرکت برگرفته از رمزگشا:
.Sp
.Vb 1
\&        ffmpeg \-flags2 +export_mvs \-i file.mp4 \-vf cropdetect=mode=mvedges,metadata=mode=print \-f null \-
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBlimit\fR 4
.IX Item "limit"
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار جاری خود باقی می‌ماند.
.SS cue
.IX Subsection "cue"
به تاخیر انداختن فیلتر کردن ویدیو تا رسیدن به یک برچسب زمانی ساعت دیواری (wallclock). این فیلتر ابتدا به تعداد \fBpreroll\fR فریم را عبور می‌دهد، سپس حداکثر تا \&\fBbuffer\fR فریم را بافر کرده و در انتظار نشانه (cue) می‌ماند. پس از رسیدن به نشانه، فریم‌های بافرشده و همچنین هر فریم بعدی ورودی خود را ارسال می‌کند.
.PP
این فیلتر می‌تواند جهت همگام‌سازی خروجی چندین فرایند ffmpeg برای دستگاه‌های خروجی بلادرنگ مانند decklink به کار رود. با اعمال تاخیر در زنجیره فیلتر و پیش‌بافرسازی فریم‌ها، فرایند می‌تواند تقریباً بلافاصله پس از فرا رسیدن برچسب زمانی ساعت دیواری هدف، داده‌ها را به خروجی منتقل سازد.
.PP
دقت کامل در سطح تک‌تک فریم‌ها تضمین نمی‌شود، ولی خروجی برای برخی کاربردها به اندازه کافی مناسب است.
.IP \fBcue\fR 4
.IX Item "cue"
برچسب زمانی نشانه بیان‌شده در قالب برچسب زمانی یونیکس بر حسب میکروثانیه. پیش‌فرض 0 است.
.IP \fBpreroll\fR 4
.IX Item "preroll"
مدت‌زمان محتوا جهت عبور به عنوان پیش‌رول بر حسب ثانیه. پیش‌فرض 0 است.
.IP \fBbuffer\fR 4
.IX Item "buffer"
حداکثر مدت‌زمان محتوا جهت بافرسازی پیش از انتظار برای نشانه بر حسب ثانیه. پیش‌فرض 0 است.
.SS curves
.IX Subsection "curves"
اعمال تنظیمات رنگ با استفاده از منحنی‌ها.
.PP
این فیلتر مشابه ابزارهای منحنی در نرم‌افزارهای Adobe Photoshop و GIMP است. هر مولفه (قرمز، سبز و آبی) مقادیر خود را توسط \fIN\fR نقطه کلیدی که با یک منحنی هموار به هم پیوند یافته‌اند، تعریف می‌کند. محور x نشان‌دهنده مقادیر پیکسلی فریم ورودی و محور y مقادیر پیکسلی جدیدی است که باید برای فریم خروجی تنظیم شوند.
.PP
به‌طور پیش‌فرض، منحنی یک مولفه با دو نقطه \fI(0;0)\fR و \&\fI(1;1)\fR تعریف می‌شود. این کار خط مستقیمی ایجاد می‌کند که در آن هر مقدار پیکسل اصلی به مقدار خودش "تنظیم" می‌شود، که به معنای عدم تغییر در تصویر است.
.PP
این فیلتر به شما اجازه می‌دهد این دو نقطه را بازتعریف نموده و نقاط بیشتری بیافزایید. منحنی تازه‌ای تعریف خواهد شد تا به نرمی از میان تمامی این مختصات‌های جدید عبور کند. نقاط جدید تعریف‌شده باید روی محور x اکیداً صعودی باشند، و مقادیر \&\fIx\fR و \fIy\fR آن‌ها در بازه \fI[0;1]\fR قرار داشته باشد. منحنی با بهره‌گیری از درون‌یابی اسپلاین مکعبی طبیعی (natural) یا یکنواخت (monotonic)، بسته به گزینه \fIinterp\fR (پیش‌فرض: \f(CW\*(C`natural\*(C'\fR) شکل می‌گیرد. اسپلاین \f(CW\*(C`natural\*(C'\fR به‌طور کلی منحنی هموارتری تولید می‌نماید در حالی که اسپلاین یکنواخت (\f(CW\*(C`pchip\*(C'\fR) یکنواخت بودن گذارها میان نقاط تعیین‌شده را تضمین می‌کند. چنانچه منحنی‌های محاسبه‌شده به خارج از فضاهای برداری بروند، مقادیر مربوطه بریده (clip) خواهند شد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBpreset\fR 4
.IX Item "preset"
انتخاب یکی از پیش‌تنظیم‌های رنگ موجود. این گزینه می‌تواند افزون بر پارامترهای \fBr\fR، \fBg\fR، \fBb\fR به کار رود؛ در این وضعیت، گزینه‌های پسین بر مقادیر پیش‌تنظیم اولویت خواهند داشت.
پیش‌تنظیم‌های در دسترس عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
.PD 0
.IP \fBcolor_negative\fR 4
.IX Item "color_negative"
.IP \fBcross_process\fR 4
.IX Item "cross_process"
.IP \fBdarker\fR 4
.IX Item "darker"
.IP \fBincrease_contrast\fR 4
.IX Item "increase_contrast"
.IP \fBlighter\fR 4
.IX Item "lighter"
.IP \fBlinear_contrast\fR 4
.IX Item "linear_contrast"
.IP \fBmedium_contrast\fR 4
.IX Item "medium_contrast"
.IP \fBnegative\fR 4
.IX Item "negative"
.IP \fBstrong_contrast\fR 4
.IX Item "strong_contrast"
.IP \fBvintage\fR 4
.IX Item "vintage"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.RE
.IP "\fBmaster, m\fR" 4
.IX Item "master, m"
تنظیم نقاط کلیدی اصلی (master). این نقاط نگاشت گذر دوم را تعریف خواهند کرد. این عمل گاهی نگاشت "درخشندگی" یا "مقدار" نامیده می‌شود. این گزینه می‌تواند همراه با \&\fBr\fR، \fBg\fR، \fBb\fR یا \fBall\fR استفاده گردد زیرا همانند یک LUT پس‌پردازش عمل می‌کند.
.IP "\fBred, r\fR" 4
.IX Item "red, r"
تنظیم نقاط کلیدی برای مولفه قرمز.
.IP "\fBgreen, g\fR" 4
.IX Item "green, g"
تنظیم نقاط کلیدی برای مولفه سبز.
.IP "\fBblue, b\fR" 4
.IX Item "blue, b"
تنظیم نقاط کلیدی برای مولفه آبی.
.IP \fBall\fR 4
.IX Item "all"
تنظیم نقاط کلیدی برای تمامی مولفه‌ها (به‌جز master).
می‌تواند افزون بر دیگر گزینه‌های نقاط کلیدی مولفه استفاده گردد. در این صورت، مولفه(های) تنظیم‌نشده به این تنظیم \&\fBall\fR بازگشت می‌نمایند.
.IP \fBpsfile\fR 4
.IX Item "psfile"
مشخص کردن یک فایل منحنی‌های فتوشاپ (\f(CW\*(C`.acv\*(C'\fR) جهت وارد کردن تنظیمات از آن.
.IP \fBplot\fR 4
.IX Item "plot"
ذخیره اسکریپت Gnuplot مربوط به منحنی‌ها در فایل تعیین‌شده.
.IP \fBinterp\fR 4
.IX Item "interp"
مشخص کردن شیوه درون‌یابی. الگوریتم‌های در دسترس عبارتند از:
.RS 4
.IP \fBnatural\fR 4
.IX Item "natural"
اسپلاین مکعبی طبیعی با استفاده از یک چندجمله‌ای مکعبی تکه‌ای که دارای دو مرتبه مشتق‌پذیری پیوسته است.
.IP \fBpchip\fR 4
.IX Item "pchip"
اسپلاین مکعبی یکنوا با استفاده از چندجمله‌ای درون‌یاب هرمیت مکعبی تکه‌ای (PCHIP).
.RE
.RS 4
.RE
.PP
جهت پرهیز از تداخل‌های نحوی در گراف فیلتر، هر فهرست از نقاط کلیدی باید با ساختار نحوی زیر تعریف گردد: \f(CW\*(C`x0/y0 x1/y1 x2/y2 ...\*(C'\fR.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
افزایش اندک سطح میانی رنگ آبی:
.Sp
.Vb 1
\&        curves=blue=\*(Aq0/0 0.5/0.58 1/1\*(Aq
.Ve
.IP \(bu 4
افکت کهنگی (Vintage):
.Sp
.Vb 1
\&        curves=r=\*(Aq0/0.11 .42/.51 1/0.95\*(Aq:g=\*(Aq0/0 0.50/0.48 1/1\*(Aq:b=\*(Aq0/0.22 .49/.44 1/0.8\*(Aq
.Ve
.Sp
در اینجا مختصات‌های زیر را برای هر یک از مولفه‌ها به دست می‌آوریم:
.RS 4
.IP \fIred\fR 4
.IX Item "red"
\&\f(CW\*(C`(0;0.11) (0.42;0.51) (1;0.95)\*(C'\fR
.IP \fIgreen\fR 4
.IX Item "green"
\&\f(CW\*(C`(0;0) (0.50;0.48) (1;1)\*(C'\fR
.IP \fIblue\fR 4
.IX Item "blue"
\&\f(CW\*(C`(0;0.22) (0.49;0.44) (1;0.80)\*(C'\fR
.RE
.RS 4
.RE
.IP \(bu 4
مثال پیشین را می‌توان با پیش‌تنظیم توکار متناظر آن نیز پیاده کرد:
.Sp
.Vb 1
\&        curves=preset=vintage
.Ve
.IP \(bu 4
یا به شکل ساده:
.Sp
.Vb 1
\&        curves=vintage
.Ve
.IP \(bu 4
بهره‌گیری از یک پیش‌تنظیم فتوشاپ و بازتعریف نقاط مولفه سبز:
.Sp
.Vb 1
\&        curves=psfile=\*(AqMyCurvesPresets/purple.acv\*(Aq:green=\*(Aq0/0 0.45/0.53 1/1\*(Aq
.Ve
.IP \(bu 4
مشاهده منحنی‌های پروفایل \f(CW\*(C`cross_process\*(C'\fR با استفاده از \fBffmpeg\fR
و \fBgnuplot\fR:
.Sp
.Vb 2
\&        ffmpeg \-f lavfi \-i color \-vf curves=cross_process:plot=/tmp/curves.plt \-frames:v 1 \-f null \-
\&        gnuplot \-p /tmp/curves.plt
.Ve
.SS datascope
.IX Subsection "datascope"
فیلتر تحلیل داده‌های ویدیو.
.PP
این فیلتر مقادیر شانزده‌شانزدهی (هگزادسیمال) پیکسل‌های بخشی از ویدیو را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیوی خروجی.
.IP \fBx\fR 4
.IX Item "x"
تنظیم آفست افقی x برای برداشت پیکسل‌ها.
.IP \fBy\fR 4
.IX Item "y"
تنظیم آفست عمودی y برای برداشت پیکسل‌ها.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت اسکوپ، می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBmono\fR 4
.IX Item "mono"
رسم مقادیر هگزادسیمال پیکسل‌ها با رنگ سفید روی پس‌زمینه سیاه.
.IP \fBcolor\fR 4
.IX Item "color"
رسم مقادیر هگزادسیمال پیکسل‌ها با رنگ پیکسل ویدیوی ورودی روی پس‌زمینه سیاه.
.IP \fBcolor2\fR 4
.IX Item "color2"
رسم مقادیر هگزادسیمال پیکسل‌ها روی پس‌زمینه رنگی برداشته‌شده از ویدیوی ورودی؛ رنگ متن به گونه‌ای انتخاب می‌شود که همواره خوانا باشد.
.RE
.RS 4
.RE
.IP \fBaxis\fR 4
.IX Item "axis"
رسم شماره سطرها و ستون‌ها در سمت چپ و بالای ویدیو.
.IP \fBopacity\fR 4
.IX Item "opacity"
تنظیم میزان کدر بودن (ناشفافی) پس‌زمینه.
.IP \fBformat\fR 4
.IX Item "format"
تنظیم فرمت نمایش اعداد. می‌تواند \f(CW\*(C`hex\*(C'\fR یا \f(CW\*(C`dec\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`hex\*(C'\fR است.
.IP \fBcomponents\fR 4
.IX Item "components"
تنظیم مولفه‌های پیکسلی جهت نمایش. به‌طور پیش‌فرض تمامی مولفه‌های پیکسل نمایش داده می‌شوند.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها به جز گزینه \f(CW\*(C`size\*(C'\fR پشتیبانی می‌کند.
.SS dblur
.IX Subsection "dblur"
اعمال فیلتر مات‌شدگی جهتی (Directional blur).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBangle\fR 4
.IX Item "angle"
تنظیم زاویه مات‌شدگی جهتی. مقدار پیش‌فرض \f(CW45\fR است.
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم شعاع مات‌شدگی جهتی. مقدار پیش‌فرض \f(CW5\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید فیلتر شوند. به‌طور پیش‌فرض تمامی صفحات فیلتر می‌گردند.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از همان \fBدستورات\fR مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار جاری خود باقی می‌ماند.
.SS dctdnoiz
.IX Subsection "dctdnoiz"
نویززدایی از فریم‌ها با استفاده از DCT دوبعدی (فیلترسازی حوزه فرکانس).
.PP
این فیلتر برای پردازش بلادرنگ (real-time) طراحی نشده است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsigma, s\fR" 4
.IX Item "sigma, s"
تنظیم ثابت سیگمای نویز.
.Sp
این \fIsigma\fR یک آستانه قطعی \f(CW\*(C`3 * sigma\*(C'\fR را تعریف می‌نماید؛ هر ضریب DCT (قدر مطلق) زیر این آستانه حذف خواهد شد.
.Sp
اگر به فیلترسازی پیشرفته‌تری نیاز دارید، \fBexpr\fR را ببینید.
.Sp
پیش‌فرض \f(CW0\fR است.
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم تعداد پیکسل‌های همپوشان برای هر بلوک. از آنجا که فیلتر می‌تواند کند باشد، ممکن است بخواهید این مقدار را کاهش دهید، هرچند به قیمت اثربخشی کمتر فیلتر و ریسک بروز مصنوعات تصویری گوناگون تمام خواهد شد.
.Sp
اگر مقدار همپوشانی اجازه پردازش کل عرض یا ارتفاع ورودی را ندهد، یک هشدار نمایش داده خواهد شد و حاشیه‌های مربوطه نویززدایی نمی‌شوند.
.Sp
مقدار پیش‌فرض \fIblocksize\fR\-1 است که بهترین تنظیم ممکن به شمار می‌رود.
.IP "\fBexpr, e\fR" 4
.IX Item "expr, e"
تنظیم عبارت فاکتور ضریب.
.Sp
برای هر ضریب از یک بلوک DCT، این عبارت به عنوان مقدار ضریب ضرب‌کننده آن ارزیابی خواهد شد.
.Sp
در صورت تنظیم این گزینه، گزینه \fBsigma\fR نادیده گرفته می‌شود.
.Sp
قدر مطلق ضریب از طریق متغیر \fIc\fR در دسترس است.
.IP \fBn\fR 4
.IX Item "n"
تنظیم \fIblocksize\fR با استفاده از تعداد بیت‌ها. عبارت \f(CW\*(C`1<<\fR\f(CIn\fR\f(CW\*(C'\fR مقدار \&\fIblocksize\fR را که همان عرض و ارتفاع بلوک‌های پردازش‌شده است تعریف می‌کند.
.Sp
مقدار پیش‌فرض \fI3\fR (یعنی 8x8) است و برای \&\fIblocksize\fR برابر با 16x16 می‌تواند به \fI4\fR افزایش یابد. توجه داشته باشید که دگرگونی این تنظیم پیامدهای چشمگیری بر سرعت پردازش دارد. همچنین اندازه بلوک بزرگ‌تر لزوماً به معنای نویززدایی بهتر نیست.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.PP
اعمال نویززدایی با \fBsigma\fR برابر با \f(CW4.5\fR:
.PP
.Vb 1
\&        dctdnoiz=4.5
.Ve
.PP
همین عملیات را می‌توان با سامانه عبارات نیز انجام داد:
.PP
.Vb 1
\&        dctdnoiz=e=\*(Aqgte(c, 4.5*3)\*(Aq
.Ve
.PP
نویززدایی پرقدرت با اندازه بلوک \f(CW\*(C`16x16\*(C'\fR:
.PP
.Vb 1
\&        dctdnoiz=15:n=4
.Ve
.SS deband
.IX Subsection "deband"
حذف مصنوعات نواری‌شدن (banding) از ویدیوی ورودی.
این کار با جایگزینی پیکسل‌های نواری‌شده با مقدار میانگین پیکسل‌های مرجع صورت می‌پذیرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fB1thr\fR 4
.IX Item "1thr"
.PD 0
.IP \fB2thr\fR 4
.IX Item "2thr"
.IP \fB3thr\fR 4
.IX Item "3thr"
.IP \fB4thr\fR 4
.IX Item "4thr"
.PD
تنظیم آستانه تشخیص نواری‌شدن برای هر صفحه (plane). مقدار پیش‌فرض 0.02 است.
محدوده معتبر از 0.00003 تا 0.5 است.
چنانچه اختلاف میان پیکسل جاری و پیکسل مرجع کمتر از آستانه باشد، نواری‌شده تلقی خواهد شد.
.IP "\fBrange, r\fR" 4
.IX Item "range, r"
محدوده تشخیص نواری‌شدن بر حسب پیکسل. پیش‌فرض 16 است. در صورت مثبت بودن، یک عدد تصادفی در بازه 0 تا مقدار تعیین‌شده به کار می‌رود. در صورت منفی بودن، مقدار دقیق قدر مطلق استفاده خواهد شد.
این محدوده یک مربع متشکل از چهار پیکسل را در پیرامون پیکسل جاری تعریف می‌کند.
.IP "\fBdirection, d\fR" 4
.IX Item "direction, d"
تنظیم جهت بر حسب رادیان که چهار پیکسل از آن مقایسه می‌شوند. در صورت مثبت بودن، جهت تصادفی از 0 تا جهت تنظیم‌شده انتخاب می‌گردد. در صورت منفی بودن، مقدار دقیق قدر مطلق برگزیده می‌شود. برای نمونه جهت 0، \-PI یا \-2*PI رادیان تنها پیکسل‌های روی همان سطر را انتخاب می‌کند و \-PI/2 تنها پیکسل‌های روی همان ستون را برمی‌گزیند.
.IP "\fBblur, b\fR" 4
.IX Item "blur, b"
در صورت فعال بودن، پیکسل جاری با میانگین مقادیر هر چهار پیکسل پیرامونی مقایسه می‌شود. پیش‌فرض فعال است. در صورت غیرفعال بودن، پیکسل جاری با تمامی چهار پیکسل پیرامونی مقایسه می‌گردد. پیکسل تنها زمانی نواری‌شده تلقی می‌شود که تمام چهار اختلاف با پیکسل‌های پیرامونی کمتر از آستانه باشد.
.IP "\fBcoupling, c\fR" 4
.IX Item "coupling, c"
در صورت فعال بودن، پیکسل جاری اگر و تنها اگر تمامی مولفه‌های پیکسل نواری‌شده باشند تغییر می‌یابد، برای نمونه آستانه تشخیص نواری‌شدن برای همه مولفه‌های رنگ فعال گردد. پیش‌فرض غیرفعال است.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS deblock
.IX Subsection "deblock"
حذف مصنوعات بلوکی‌شدن (blocking) از ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfilter\fR 4
.IX Item "filter"
تنظیم نوع فیلتر، می‌تواند \fIweak\fR (ضعیف) یا \fIstrong\fR (قوی) باشد. پیش‌فرض \fIstrong\fR است.
این گزینه نوع بلوک‌زدایی اعمال‌شده را کنترل می‌کند.
.IP \fBblock\fR 4
.IX Item "block"
تنظیم اندازه بلوک، محدوده مجاز از 4 تا 512 است. پیش‌فرض \fI8\fR است.
.IP \fBalpha\fR 4
.IX Item "alpha"
.PD 0
.IP \fBbeta\fR 4
.IX Item "beta"
.IP \fBgamma\fR 4
.IX Item "gamma"
.IP \fBdelta\fR 4
.IX Item "delta"
.PD
تنظیم آستانه‌های تشخیص بلوکی‌شدن. محدوده مجاز از 0 تا 1 است.
مقادیر پیش‌فرض عبارتند از: \fI0.098\fR برای \fIalpha\fR و \fI0.05\fR برای سایر موارد.
به کار بردن آستانه بالاتر، قدرت بلوک‌زدایی بیشتری فراهم می‌سازد.
تنظیم \fIalpha\fR تشخیص آستانه را دقیقاً در لبه بلوک کنترل می‌کند. گزینه‌های باقی‌مانده تشخیص آستانه در نزدیکی لبه را کنترل می‌نمایند؛ هر یک برای بالا/پایین یا چپ/راست. تنظیم هر یک از این موارد روی \fI0\fR بلوک‌زدایی را غیرفعال می‌سازد.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه‌ها جهت فیلترسازی. پیش‌فرض فیلتر کردن تمامی صفحه‌های موجود است.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
بلوک‌زدایی با فیلتر ضعیف و اندازه بلوک 4 پیکسل:
.Sp
.Vb 1
\&        deblock=filter=weak:block=4
.Ve
.IP \(bu 4
بلوک‌زدایی با فیلتر قوی، اندازه بلوک 4 پیکسل و آستانه‌های سفارشی جهت بلوک‌زدایی لبه‌های بیشتر:
.Sp
.Vb 1
\&        deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05
.Ve
.IP \(bu 4
مشابه بالا، اما تنها با فیلتر کردن صفحه اول:
.Sp
.Vb 1
\&        deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=1
.Ve
.IP \(bu 4
مشابه بالا، اما تنها با فیلتر کردن صفحات دوم و سوم:
.Sp
.Vb 1
\&        deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=6
.Ve
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS decimate
.IX Subsection "decimate"
حذف فریم‌های تکراری در فواصل زمانی منظم.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcycle\fR 4
.IX Item "cycle"
تنظیم تعداد فریم‌هایی که یکی از میان آن‌ها حذف خواهد شد. تنظیم این گزینه روی \&\fIN\fR بدین معناست که یک فریم در هر دسته \fIN\fR تایی از فریم‌ها حذف خواهد شد. پیش‌فرض \f(CW5\fR است.
.IP \fBdupthresh\fR 4
.IX Item "dupthresh"
تنظیم آستانه برای تشخیص تکراری بودن. چنانچه معیار اختلاف برای یک فریم کمتر یا مساوی با این مقدار باشد، به عنوان فریم تکراری قلمداد می‌شود. پیش‌فرض \f(CW1.1\fR است.
.IP \fBscthresh\fR 4
.IX Item "scthresh"
تنظیم آستانه تغییر صحنه. پیش‌فرض \f(CW15\fR است.
.IP \fBblockx\fR 4
.IX Item "blockx"
.PD 0
.IP \fBblocky\fR 4
.IX Item "blocky"
.PD
تنظیم اندازه بلوک‌های محور x و y مورد استفاده در حین محاسبات معیار.
بلوک‌های بزرگ‌تر باعث سرکوب بهتر نویز می‌شوند، اما در تشخیص حرکات کوچک عملکرد ضعیف‌تری دارند. باید توانی از دو باشد. پیش‌فرض \f(CW32\fR است.
.IP \fBppsrc\fR 4
.IX Item "ppsrc"
علامت‌گذاری ورودی اصلی به عنوان ورودی پیش‌پردازش‌شده و فعال‌سازی جریان ورودی منبع دست‌نخورده. این کار اجازه می‌دهد ورودی جهت کمک به محاسبه معیارها با فیلترهای گوناگون پیش‌پردازش شود بدون اینکه فرآیند گزینش فریم دچار افت کیفیت گردد. هنگامی که روی \&\f(CW1\fR تنظیم شود، نخستین جریان برای ورودی پیش‌پردازش‌شده است، و دومین جریان همان منبع دست‌نخورده‌ای است که فریم‌های حفظ‌شده از آن برگزیده می‌شوند. پیش‌فرض \&\f(CW0\fR است.
.IP \fBchroma\fR 4
.IX Item "chroma"
تنظیم اینکه آیا کروما در محاسبات معیار مد نظر قرار گیرد یا خیر. پیش‌فرض \&\f(CW1\fR است.
.IP \fBmixed\fR 4
.IX Item "mixed"
تنظیم اینکه آیا ورودی تنها تا حدی دربردارنده محتوای نیازمند دِسیمِیت است یا خیر.
پیش‌فرض \f(CW\*(C`false\*(C'\fR است.
در صورت فعال بودن، جریان ویدیوی خروجی دارای نرخ فریم متغیر خواهد بود.
.SS deconvolve
.IX Subsection "deconvolve"
اعمال واپیچش (دکانولوشن) دوبعدی جریان ویدیو در حوزه فرکانس با استفاده از جریان دوم به عنوان پاسخ ضربه.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید پردازش شوند.
.IP \fBimpulse\fR 4
.IX Item "impulse"
تنظیم اینکه کدام فریم‌های ویدیویی ضربه پردازش خواهند شد؛ می‌تواند \fIfirst\fR
یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
.IP \fBnoise\fR 4
.IX Item "noise"
تنظیم نویز هنگام انجام تقسیم‌ها. پیش‌فرض \fI0.0000001\fR است. زمانی که عرض و ارتفاع یکسان نباشند و توانی از 2 نباشند، یا اگر جریان پیش از کانولوشن دارای نویز بوده باشد سودمند است.
.PP
فیلتر \f(CW\*(C`deconvolve\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.SS dedot
.IX Subsection "dedot"
کاهش درخشندگی متقاطع (dot-crawl) و رنگ متقاطع (rainbows) از ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBm\fR 4
.IX Item "m"
تنظیم حالت عملیات. می‌تواند ترکیبی از \fIdotcrawl\fR برای کاهش درخشندگی متقاطع و/یا \&\fIrainbows\fR برای کاهش رنگ متقاطع باشد.
.IP \fBlt\fR 4
.IX Item "lt"
تنظیم آستانه مکانی لوما. مقادیر کمتر، میزان کاهش درخشندگی متقاطع را افزایش می‌دهد.
.IP \fBtl\fR 4
.IX Item "tl"
تنظیم تلرانس برای لومای زمانی. مقادیر بالاتر، میزان کاهش درخشندگی متقاطع را افزایش می‌دهد.
.IP \fBtc\fR 4
.IX Item "tc"
تنظیم تلرانس برای تغییرات زمانی کروما. مقادیر بالاتر، میزان کاهش رنگ متقاطع را افزایش می‌دهد.
.IP \fBct\fR 4
.IX Item "ct"
تنظیم آستانه زمانی کروما. مقادیر کمتر، میزان کاهش رنگ متقاطع را افزایش می‌دهد.
.SS deflate
.IX Subsection "deflate"
اعمال افکت فشرده‌سازی لبه (deflate) بر روی ویدیو.
.PP
این فیلتر پیکسل را با میانگین محلی (3x3) تنها با در نظر گرفتن مقادیر کمتر از مقدار خود پیکسل جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن بیشینه تغییرات برای هر صفحه، پیش‌فرض 65535 است.
اگر 0 باشد، صفحه دست‌نخورده باقی خواهد ماند.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS deflicker
.IX Subsection "deflicker"
حذف نوسانات روشنایی زمانی فریم (پرش نور یا flicker).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه فیلتر میانگین متحرک بر حسب فریم. پیش‌فرض 5 است. محدوده مجاز بین 2 تا 129 است.
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت میانگین‌گیری برای هموارسازی تغییرات روشنایی زمانی.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBam\fR 4
.IX Item "am"
میانگین حسابی (Arithmetic mean)
.IP \fBgm\fR 4
.IX Item "gm"
میانگین هندسی (Geometric mean)
.IP \fBhm\fR 4
.IX Item "hm"
میانگین همساز (Harmonic mean)
.IP \fBqm\fR 4
.IX Item "qm"
میانگین مربعی (Quadratic mean)
.IP \fBcm\fR 4
.IX Item "cm"
میانگین مکعبی (Cubic mean)
.IP \fBpm\fR 4
.IX Item "pm"
میانگین توانی (Power mean)
.IP \fBmedian\fR 4
.IX Item "median"
میانه (Median)
.RE
.RS 4
.RE
.IP \fBbypass\fR 4
.IX Item "bypass"
عدم تغییر واقعی فریم. در شرایطی که کاربر تنها خواستار فراداده باشد مفید است.
.SS deinterlace_d3d12
.IX Subsection "deinterlace_d3d12"
دی‌اینترلیس کردن ویدیوی ورودی با استفاده از پردازش ویدیویی شتاب‌یافته با سخت‌افزار D3D12.
.PP
این فیلتر از پردازنده ویدیویی DirectX 12 جهت انجام عمل دی‌اینترلیس بر روی GPU بهره می‌برد، و از هر دو الگوریتم ساده bob و پیشرفته تعریف‌شده توسط درایور (سازگار با حرکت) پشتیبانی می‌کند. این فیلتر نیازمند آن است که ورودی در فرمت پیکسلی سخت‌افزاری \f(CW\*(C`d3d12\*(C'\fR باشد.
.PP
فیلتر به‌طور خودکار سخت‌افزار را برای تعداد مورد نیاز فریم‌های مرجع زمانی (در صورت لزوم) پرس‌وجو کرده و صف فریمی را برای تامین آن‌ها مدیریت می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmethod\fR 4
.IX Item "method"
روش دی‌اینترلیس. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
انتخاب بهترین روش دی‌اینترلیس موجود روی سخت‌افزار.
چنانچه درایور از \f(CW\*(C`custom\*(C'\fR پشتیبانی نماید، آن روش به کار می‌رود؛ در غیر این صورت به \f(CW\*(C`bob\*(C'\fR بازمی‌گردد. این حالت پیش‌فرض است.
.IP \fBbob\fR 4
.IX Item "bob"
دی‌اینترلیس Bob. هر فیلد به‌طور مستقل به ارتفاع کامل فریم مقیاس‌بندی می‌شود. ساده و سریع است، اما ممکن است مصنوعات مشهود bob را روی محتوای دارای حرکت پدید آورد.
.IP \fBcustom\fR 4
.IX Item "custom"
دی‌اینترلیس پیشرفته تعریف‌شده توسط درایور. الگوریتم دقیق وابسته به سخت‌افزار است و معمولاً از روش‌های سازگار با حرکت همراه با فریم‌های مرجع زمانی جهت دستیابی به کیفیت بالاتر بهره می‌جوید.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`default\*(C'\fR است.
.RE
.IP \fBmode\fR 4
.IX Item "mode"
مشخص کردن حالت اینترلیس. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBframe\fR 4
.IX Item "frame"
ارسال یک فریم به ازای هر فریم. نرخ فریم خروجی برابر با نرخ فریم ورودی خواهد بود. این حالت پیش‌فرض است.
.IP \fBfield\fR 4
.IX Item "field"
ارسال یک فریم به ازای هر فیلد. نرخ فریم خروجی دو برابر نرخ فریم ورودی خواهد بود.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`frame\*(C'\fR است.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
مشخص کردن اینکه کدام فریم‌ها دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
دی‌اینترلیس تمامی فریم‌ها. این حالت پیش‌فرض است.
.IP \fBinterlaced\fR 4
.IX Item "interlaced"
تنها دی‌اینترلیس فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند؛ فریم‌های پروگرسیو بدون تغییر عبور داده می‌شوند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
دی‌اینترلیس کردن یک ویدیوی اینترلیس با استفاده از رمزگشایی نرم‌افزاری و بهترین روش دی‌اینترلیس سخت‌افزاری در دسترس:
.Sp
.Vb 3
\&        ffmpeg \-init_hw_device d3d12va=d3d12 \-filter_hw_device d3d12 \-i input.ts \e
\&               \-vf "format=nv12,hwupload,deinterlace_d3d12=method=default,hwdownload,format=nv12" \e
\&               \-c:v libx264 \-crf 18 output.mp4
.Ve
.IP \(bu 4
دی‌اینترلیس با نرخ فیلد (دو برابر نرخ فریم) با استفاده از روش bob همراه با رمزگشایی سخت‌افزاری (پایپ‌لاین کامل d3d12):
.Sp
.Vb 3
\&        ffmpeg \-hwaccel d3d12va \-hwaccel_output_format d3d12 \-i input.ts \e
\&               \-vf "deinterlace_d3d12=method=bob:mode=field" \e
\&               \-c:v h264_d3d12va output.mp4
.Ve
.IP \(bu 4
دی‌اینترلیس تنها برای فریم‌های اینترلیس، و عبور دادن فریم‌های پروگرسیو بدون تغییر:
.Sp
.Vb 3
\&        ffmpeg \-init_hw_device d3d12va=d3d12 \-filter_hw_device d3d12 \-i input.ts \e
\&               \-vf "format=nv12,hwupload,deinterlace_d3d12=deint=interlaced,hwdownload,format=nv12" \e
\&               \-c:v libx264 \-crf 18 output.mp4
.Ve
.SS dejudder
.IX Subsection "dejudder"
حذف لرزش (judder) ناشی از محتوای تل‌سینه نیمه‌اینترلیس.
.PP
لرزش می‌تواند برای نمونه توسط فیلتر \fBpullup\fR ایجاد شود. اگر منبع اصلی محتوای نیمه‌تله‌سینه بوده باشد، خروجی \f(CW\*(C`pullup,dejudder\*(C'\fR دارای نرخ فریم متغیر خواهد بود. ممکن است نرخ فریم ثبت‌شده کانتینر را تغییر دهد. جدا از آن دگرگونی، این فیلتر بر ویدیوی با نرخ فریم ثابت تاثیری نخواهد گذاشت.
.PP
گزینه در دسترس در این فیلتر عبارت است از:
.IP \fBcycle\fR 4
.IX Item "cycle"
مشخص کردن طول پنجره‌ای که لرزش در طول آن تکرار می‌گردد.
.Sp
هر عدد صحیح بزرگ‌تر از 1 را می‌پذیرد. مقادیر سودمند عبارتند از:
.RS 4
.IP \fB4\fR 4
.IX Item "4"
چنانچه نسخه اصلی از 24 به 30 فریم بر ثانیه تله‌سینه شده باشد (فیلم به NTSC).
.IP \fB5\fR 4
.IX Item "5"
چنانچه نسخه اصلی از 25 به 30 فریم بر ثانیه تله‌سینه شده باشد (PAL به NTSC).
.IP \fB20\fR 4
.IX Item "20"
در صورت ترکیب این دو.
.RE
.RS 4
.Sp
پیش‌فرض \fB4\fR است.
.RE
.SS delogo
.IX Subsection "delogo"
حذف نشان (لوگو) شبکه تلویزیونی با درون‌یابی ساده پیکسل‌های پیرامونی. کافی است مستطیلی را روی لوگو تنظیم نموده و ناپدید شدن آن را تماشا کنید (و گاهی حتی چیزی ناخوشایندتر نمایان می‌شود - بر حسب مورد شما ممکن است متفاوت باشد).
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مشخص کردن مختصات گوشه بالا-چپ لوگو. تعیین آن‌ها الزامی است.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
مشخص کردن عرض و ارتفاع لوگو جهت پاک‌سازی. تعیین آن‌ها الزامی است.
.IP \fBshow\fR 4
.IX Item "show"
هنگامی که روی 1 تنظیم شود، یک مستطیل سبز بر روی صفحه ترسیم می‌گردد تا یافتن پارامترهای صحیح \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR ساده‌تر شود. مقدار پیش‌فرض 0 است.
.Sp
مستطیل روی بیرونی‌ترین پیکسل‌هایی ترسیم می‌شود که (تا حدی) با مقادیر درون‌یابی‌شده جایگزین خواهند شد. مقادیر پیکسل‌های پسین بلافاصله بیرون از این مستطیل در هر جهت جهت محاسبه مقادیر پیکسلی درون‌یابی‌شده درون مستطیل به کار گرفته می‌شوند.
.PP
\fIمثال‌ها\fR
.IX Subsection "مثال‌ها"
.IP \(bu 4
تنظیم مستطیلی پوشش‌دهنده ناحیه با مختصات گوشه بالا-چپ 0,0 و ابعاد 100x77:
.Sp
.Vb 1
\&        delogo=x=0:y=0:w=100:h=77
.Ve
.SS derain
.IX Subsection "derain"
حذف باران در تصویر/ویدیوی ورودی با اعمال روش‌های باران‌زدایی بر پایه شبکه‌های عصبی پیچشی (CNN). مدل‌های پشتیبانی‌شده:
.IP \(bu 4
شبکه تجمیع بستر فشردن-و-انگیزش بازگشتی (RESCAN).
<\fBhttp://openaccess.thecvf.com/content_ECCV_2018/papers/Xia_Li_Recurrent_Squeeze\-and\-Excitation_Context_ECCV_2018_paper.pdf\fR> را ببینید.
.PP
اسکریپت‌های آموزش و همچنین تولید مدل در مخزن <\fBhttps://github.com/XueweiMeng/derain_filter.git\fR> ارائه شده‌اند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfilter_type\fR 4
.IX Item "filter_type"
مشخص کردن اینکه از کدام فیلتر استفاده شود. این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBderain\fR 4
.IX Item "derain"
فیلتر باران‌زدایی. برای اجرای فیلتر derain، باید از یک مدل derain استفاده کنید.
.IP \fBdehaze\fR 4
.IX Item "dehaze"
فیلتر مه‌زدایی. برای اجرای فیلتر dehaze، باید از یک مدل dehaze استفاده کنید.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBderain\fR است.
.RE
.IP \fBdnn_backend\fR 4
.IX Item "dnn_backend"
مشخص کردن اینکه از کدام بک‌اند DNN جهت بارگذاری و اجرای مدل استفاده شود. این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtensorflow\fR 4
.IX Item "tensorflow"
بک‌اند TensorFlow. برای فعال‌سازی این بک‌اند باید کتابخانه TensorFlow برای C را نصب نموده (<\fBhttps://www.tensorflow.org/install/lang_c\fR> را ببینید) و FFmpeg را با \&\f(CW\*(C`\-\-enable\-libtensorflow\*(C'\fR پیکربندی کنید.
.RE
.RS 4
.RE
.IP \fBmodel\fR 4
.IX Item "model"
تنظیم مسیر به فایل مدلی که معماری شبکه و پارامترهای آن را مشخص می‌سازد.
توجه داشته باشید که بک‌اندهای مختلف از فرمت‌های فایل گوناگونی استفاده می‌کنند. تنسورفلو تنها می‌تواند فایل‌های مربوط به فرمت خود را بارگذاری نماید.
.PP
جهت دستیابی به قابلیت‌های کامل (همچون اجرای ناهمگام)، لطفاً از فیلتر \fBdnn_processing\fR استفاده نمایید.
.SS deshake
.IX Subsection "deshake"
تلاش برای تصحیح تغییرات کوچک در جابه‌جایی‌های افقی و/یا عمودی. این فیلتر به حذف لرزش دوربین ناشی از نگه‌داشتن دوربین با دست، برخورد به سه‌پایه، حرکت روی وسیله نقلیه و غیره کمک می‌نماید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.IP \fBw\fR 4
.IX Item "w"
.IP \fBh\fR 4
.IX Item "h"
.PD
تعیین یک ناحیه مستطیلی که جستجو برای بردارهای حرکت به آن محدود می‌شود.
در صورت تمایل، جستجو برای بردارهای حرکت را می‌توان به یک ناحیه مستطیلی از فریم که توسط گوشه بالا-چپ، عرض و ارتفاع آن مشخص می‌شود محدود کرد. این پارامترها دارای معنای یکسانی با فیلتر drawbox هستند که می‌تواند جهت بصری‌سازی موقعیت کادر مرزی به کار رود.
.Sp
این گزینه زمانی سودمند است که حرکت همزمان سوژه‌ها درون فریم ممکن است در جستجوی بردار حرکت با حرکت دوربین اشتباه گرفته شود.
.Sp
چنانچه هر یک یا تمامی \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR روی \-1 تنظیم گردند، کل فریم مورد استفاده قرار می‌گیرد. این امر اجازه می‌دهد گزینه‌های پسین بدون نیاز به مشخص کردن کادر مرزی برای جستجوی بردار حرکت تنظیم شوند.
.Sp
پیش‌فرض \- جستجوی کل فریم است.
.IP \fBrx\fR 4
.IX Item "rx"
.PD 0
.IP \fBry\fR 4
.IX Item "ry"
.PD
مشخص کردن بیشینه دامنه حرکت در جهات x و y در بازه 0\-64 پیکسل. پیش‌فرض 16 است.
.IP \fBedge\fR 4
.IX Item "edge"
مشخص کردن شیوه تولید پیکسل‌ها جهت پر کردن فضاهای خالی در لبه‌های فریم. مقادیر در دسترس عبارتند از:
.RS 4
.IP "\fBblank, 0\fR" 4
.IX Item "blank, 0"
پر کردن با صفر در موقعیت‌های خالی
.IP "\fBoriginal, 1\fR" 4
.IX Item "original, 1"
تصویر اصلی در موقعیت‌های خالی
.IP "\fBclamp, 2\fR" 4
.IX Item "clamp, 2"
مقدار کشیده‌شده لبه در موقعیت‌های خالی
.IP "\fBmirror, 3\fR" 4
.IX Item "mirror, 3"
لبه آینه‌ای در موقعیت‌های خالی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBmirror\fR است.
.RE
.IP \fBblocksize\fR 4
.IX Item "blocksize"
مشخص کردن اندازه بلوک جهت استفاده در جستجوی حرکت. بازه 4\-128 پیکسل، پیش‌فرض 8 است.
.IP \fBcontrast\fR 4
.IX Item "contrast"
مشخص کردن آستانه کنتراست برای بلوک‌ها. تنها بلوک‌هایی با کنتراستی فراتر از حد تعیین‌شده (اختلاف میان تاریک‌ترین و روشن‌ترین پیکسل‌ها) مد نظر قرار خواهند گرفت. بازه 1\-255، پیش‌فرض 125 است.
.IP \fBsearch\fR 4
.IX Item "search"
مشخص کردن استراتژی جستجو. مقادیر موجود عبارتند از:
.RS 4
.IP "\fBexhaustive, 0\fR" 4
.IX Item "exhaustive, 0"
تنظیم جستجوی کامل (فراگیر)
.IP "\fBless, 1\fR" 4
.IX Item "less, 1"
تنظیم جستجوی کمتر فراگیر.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBexhaustive\fR است.
.RE
.IP \fBfilename\fR 4
.IX Item "filename"
در صورت تنظیم، گزارش مشروحی از جستجوی حرکت در فایل تعیین‌شده نوشته می‌شود.
.SS despill
.IX Subsection "despill"
حذف آلودگی ناخواسته رنگ‌های پیش‌زمینه، ناشی از بازتاب رنگ پرده سبز یا پرده آبی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع despill مورد استفاده.
.IP \fBmix\fR 4
.IX Item "mix"
تنظیم نحوه تولید نقشه نشتی (spillmap).
.IP \fBexpand\fR 4
.IX Item "expand"
تنظیم میزان خلاص شدن از نشتی‌های همچنان باقی‌مانده.
.IP \fBred\fR 4
.IX Item "red"
کنترل مقدار رنگ قرمز در ناحیه نشتی.
.IP \fBgreen\fR 4
.IX Item "green"
کنترل مقدار رنگ سبز در ناحیه نشتی.
برای پرده سبز باید \-1 باشد.
.IP \fBblue\fR 4
.IX Item "blue"
کنترل مقدار رنگ آبی در ناحیه نشتی.
برای پرده آبی باید \-1 باشد.
.IP \fBbrightness\fR 4
.IX Item "brightness"
کنترل روشنایی ناحیه نشتی، ضمن حفظ رنگ‌ها.
.IP \fBalpha\fR 4
.IX Item "alpha"
اصلاح آلفا برگرفته از نقشه نشتی تولیدشده.
.PP
\fIدستورات\fR
.IX Subsection "دستورات"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS detelecine
.IX Subsection "detelecine"
اعمال معکوس دقیق عملیات تله‌سینه (telecine). نیازمند یک الگوی از پیش تعریف‌شده است که با استفاده از گزینه pattern مشخص می‌شود و باید مشابه با الگوی ارسال‌شده به فیلتر telecine باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfirst_field\fR 4
.IX Item "first_field"
.RS 4
.PD 0
.IP "\fBtop, t\fR" 4
.IX Item "top, t"
.PD
ابتدا فیلد بالایی
.IP "\fBbottom, b\fR" 4
.IX Item "bottom, b"
ابتدا فیلد پایینی
مقدار پیش‌فرض \f(CW\*(C`top\*(C'\fR است.
.RE
.RS 4
.RE
.IP \fBpattern\fR 4
.IX Item "pattern"
رشته‌ای از ارقام نمایانگر الگوی pulldown که مایلید اعمال نمایید.
مقدار پیش‌فرض \f(CW23\fR است.
.IP \fBstart_frame\fR 4
.IX Item "start_frame"
عددی نمایانگر موقعیت نخستین فریم با توجه به الگوی تله‌سینه. این گزینه در صورتی که جریان برش خورده باشد به کار می‌رود. مقدار پیش‌فرض \f(CW0\fR است.
.SS dilation
.IX Subsection "dilation"
اعمال جلوه اتساع (dilation) بر روی ویدیو.
.PP
این فیلتر هر پیکسل را با بیشینه محلی (3x3) جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن بیشینه تغییر برای هر صفحه (plane)، پیش‌فرض 65535 است.
اگر 0 باشد، صفحه بدون تغییر باقی می‌ماند.
.IP \fBcoordinates\fR 4
.IX Item "coordinates"
پرچمی که پیکسل‌های مورد ارجاع را مشخص می‌کند. پیش‌فرض 255 است، یعنی از تمام هشت
پیکسل استفاده می‌شود.
.Sp
نگاشت پرچم‌ها به مختصات محلی 3x3 به این صورت است:
.Sp
.Vb 3
\&    1 2 3
\&    4   5
\&    6 7 8
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به‌عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS displace
.IX Subsection "displace"
جابه‌جایی پیکسل‌ها مطابق با جریان‌های ورودی دوم و سوم.
.PP
این فیلتر سه جریان ورودی می‌گیرد و یک جریان خروجی تولید می‌کند؛ ورودی اول منبع اصلی است،
و ورودی‌های دوم و سوم نقشه‌های جابه‌جایی (displacement maps) هستند.
.PP
ورودی دوم تعیین می‌کند که پیکسل‌ها چقدر در امتداد محور x جابه‌جا شوند،
در حالی که ورودی سوم میزان جابه‌جایی پیکسل‌ها در امتداد محور y را تعیین می‌کند.
اگر یکی از جریان‌های نقشه جابه‌جایی پایان یابد، آخرین فریم از آن نقشه جابه‌جایی
استفاده خواهد شد.
.PP
توجه داشته باشید که نقشه‌های جابه‌جایی پس از ایجاد می‌توانند بارها و بارها مورد استفاده مجدد قرار گیرند.
.PP
در ادامه توضیحات مربوط به گزینه‌های پذیرفته‌شده آمده است.
.IP \fBedge\fR 4
.IX Item "edge"
تنظیم رفتار جابه‌جایی برای پیکسل‌هایی که خارج از محدوده هستند.
.Sp
مقادیر مجاز عبارتند از:
.RS 4
.IP \fBblank\fR 4
.IX Item "blank"
پیکسل‌های ناموجود با پیکسل‌های سیاه جایگزین می‌شوند.
.IP \fBsmear\fR 4
.IX Item "smear"
پیکسل‌های مجاور گسترش می‌یابند تا جایگزین پیکسل‌های ناموجود شوند.
.IP \fBwrap\fR 4
.IX Item "wrap"
پیکسل‌های خارج از محدوده دور زده می‌شوند تا به پیکسل‌های سمت دیگر اشاره کنند.
.IP \fBmirror\fR 4
.IX Item "mirror"
پیکسل‌های خارج از محدوده با پیکسل‌های آینه‌ای جایگزین می‌شوند.
.RE
.RS 4
.Sp
پیش‌فرض \fBsmear\fR است.
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
افزودن جلوه موج‌دار (ripple) به ورودی rgb با اندازه ویدیوی hd720:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-f lavfi \-i nullsrc=s=hd720,lutrgb=128:128:128 \-f lavfi \-i nullsrc=s=hd720,geq=\*(Aqr=128+30*sin(2*PI*X/400+T):g=128+30*sin(2*PI*X/400+T):b=128+30*sin(2*PI*X/400+T)\*(Aq \-lavfi \*(Aq[0][1][2]displace\*(Aq OUTPUT
.Ve
.IP \(bu 4
افزودن جلوه موج (wave) به ورودی rgb با اندازه ویدیوی hd720:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-f lavfi \-i nullsrc=hd720,geq=\*(Aqr=128+80*(sin(sqrt((X\-W/2)*(X\-W/2)+(Y\-H/2)*(Y\-H/2))/220*2*PI+T)):g=128+80*(sin(sqrt((X\-W/2)*(X\-W/2)+(Y\-H/2)*(Y\-H/2))/220*2*PI+T)):b=128+80*(sin(sqrt((X\-W/2)*(X\-W/2)+(Y\-H/2)*(Y\-H/2))/220*2*PI+T))\*(Aq \-lavfi \*(Aq[1]split[x][y],[0][x][y]displace\*(Aq OUTPUT
.Ve
.SS dnn_classify
.IX Subsection "dnn_classify"
انجام دسته‌بندی با شبکه‌های عصبی عمیق بر اساس کادرهای مرزی (bounding boxes).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdnn_backend\fR 4
.IX Item "dnn_backend"
تعیین بَک‌اند DNN مورد استفاده برای بارگذاری و اجرای مدل. این گزینه در حال حاضر
تنها openvino را می‌پذیرد، بَک‌اندهای tensorflow اضافه خواهند شد.
.IP \fBmodel\fR 4
.IX Item "model"
تنظیم مسیر فایل مدل که معماری شبکه و پارامترهای آن را مشخص می‌کند.
توجه داشته باشید که بَک‌اندهای مختلف از قالب‌های فایل متفاوتی استفاده می‌کنند.
.IP \fBinput\fR 4
.IX Item "input"
تنظیم نام ورودی شبکه dnn.
.IP \fBoutput\fR 4
.IX Item "output"
تنظیم نام خروجی شبکه dnn.
.IP \fBconfidence\fR 4
.IX Item "confidence"
تنظیم آستانه اطمینان (پیش‌فرض: 0.5).
.IP \fBlabels\fR 4
.IX Item "labels"
تنظیم مسیر فایل برچسب‌ها که نگاشت بین شناسه برچسب و نام آن را مشخص می‌کند.
هر نام برچسب در یک خط نوشته می‌شود، فاصله‌های انتهایی و خطوط خالی نادیده گرفته می‌شوند.
خط اول نام شناسه برچسب 0 است،
و خط دوم نام شناسه برچسب 1، و به همین ترتیب.
در صورتی که فایل برچسب ارائه نشود، شناسه برچسب به عنوان نام در نظر گرفته می‌شود.
.IP \fBbackend_configs\fR 4
.IX Item "backend_configs"
تنظیم پیکربندی‌هایی که به بَک‌اند ارسال می‌شوند.
.Sp
برای بَک‌اند tensorflow، می‌توانید پیکربندی‌های آن را با گزینه‌های \fBsess_config\fR تنظیم کنید؛
لطفاً از tools/python/tf_sess_config.py برای دریافت پیکربندی‌های مناسب سیستم خود استفاده نمایید.
.SS dnn_detect
.IX Subsection "dnn_detect"
تشخیص اشیاء با شبکه‌های عصبی عمیق.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdnn_backend\fR 4
.IX Item "dnn_backend"
تعیین بَک‌اند DNN مورد استفاده برای بارگذاری و اجرای مدل. این گزینه در حال حاضر
تنها openvino را می‌پذیرد، بَک‌اندهای tensorflow اضافه خواهند شد.
.IP \fBmodel\fR 4
.IX Item "model"
تنظیم مسیر فایل مدل که معماری شبکه و پارامترهای آن را مشخص می‌کند.
توجه داشته باشید که بَک‌اندهای مختلف از قالب‌های فایل متفاوتی استفاده می‌کنند.
.IP \fBinput\fR 4
.IX Item "input"
تنظیم نام ورودی شبکه dnn.
.IP \fBoutput\fR 4
.IX Item "output"
تنظیم نام خروجی شبکه dnn.
.IP \fBconfidence\fR 4
.IX Item "confidence"
تنظیم آستانه اطمینان (پیش‌فرض: 0.5).
.IP \fBlabels\fR 4
.IX Item "labels"
تنظیم مسیر فایل برچسب‌ها که نگاشت بین شناسه برچسب و نام آن را مشخص می‌کند.
هر نام برچسب در یک خط نوشته می‌شود، فاصله‌های انتهایی و خطوط خالی نادیده گرفته می‌شوند.
خط اول نام شناسه برچسب 0 است (معمولاً \*(Aqbackground\*(Aq)،
و خط دوم نام شناسه برچسب 1، و به همین ترتیب.
در صورتی که فایل برچسب ارائه نشود، شناسه برچسب به عنوان نام در نظر گرفته می‌شود.
.IP \fBbackend_configs\fR 4
.IX Item "backend_configs"
تنظیم پیکربندی‌هایی که به بَک‌اند ارسال می‌شوند. برای استفاده از اجرای ناهمگام، async را تنظیم کنید (پیش‌فرض: تنظیم‌شده).
اگر بَک‌اند از اجرای ناهمگام پشتیبانی نکند، به اجرای همگام بازمی‌گردد.
.SS dnn_processing
.IX Subsection "dnn_processing"
انجام پردازش تصویر با شبکه‌های عصبی عمیق. این فیلتر به همراه فیلتر دیگری کار می‌کند
که قالب پیکسلی فریم را به آنچه شبکه dnn نیاز دارد تبدیل می‌نماید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdnn_backend\fR 4
.IX Item "dnn_backend"
تعیین بَک‌اند DNN مورد استفاده برای بارگذاری و اجرای مدل. این گزینه
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtensorflow\fR 4
.IX Item "tensorflow"
بَک‌اند TensorFlow. برای فعال‌سازی این بَک‌اند
باید کتابخانه TensorFlow for C را نصب کنید (ببینید
<\fBhttps://www.tensorflow.org/install/lang_c\fR>) و FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libtensorflow\*(C`\fR پیکربندی نمایید.
.IP \fBopenvino\fR 4
.IX Item "openvino"
بَک‌اند OpenVINO. برای فعال‌سازی این بَک‌اند
باید کتابخانه OpenVINO for C را بیلد و نصب کنید (ببینید
<\fBhttps://github.com/openvinotoolkit/openvino/blob/master/build\-instruction.md\fR>) و FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libopenvino\*(C`\fR پیکربندی نمایید (اگر فایل‌های هدر و کتابخانه‌ها در مسیرهای سیستمی نصب نشده باشند،
ممکن است \-\extra\-cflags=\-I... \-\extra\-ldflags=\-L... مورد نیاز باشد).
.IP \fBtorch\fR 4
.IX Item "torch"
بَک‌اند Libtorch. برای فعال‌سازی این بَک‌اند باید کتابخانه Libtorch
for C++ را بیلد و نصب کنید. لطفاً نسخه cxx11 ABI را دانلود نمایید (ببینید
<\fBhttps://pytorch.org/get\-started/locally\fR>)
و FFmpeg را با \f(CW\*(C`\-\-enable\-libtorch
\&\-\extra\-cflags=\-I/libtorch_root/libtorch/include
\&\-\extra\-cflags=\-I/libtorch_root/libtorch/include/torch/csrc/api/include
\&\-\extra\-ldflags=\-L/libtorch_root/libtorch/lib/\*(C`\fR پیکربندی کنید.
.IP \fBonnx\fR 4
.IX Item "onnx"
بَک‌اند ONNX Runtime. برای فعال‌سازی این بَک‌اند باید کتابخانه
ONNX Runtime را نصب کنید (ببینید <\fBhttps://onnxruntime.ai\fR>) و FFmpeg
را با \f(CW\*(C`\-\-enable\-libonnxruntime\*(C`\fR پیکربندی نمایید.
.Sp
بَک‌اند فعلی ONNX Runtime تانسورهای ورودی و خروجی 4 بعدی
با چینش NCHW و نوع داده ممیز شناور 32 بیتی (ONNX
\&\f(CW\*(C`FLOAT\*(C`\fR) را انتظار دارد؛ مدل‌هایی با نوع داده صحیح یا سایر انواع (مانند
\&\f(CW\*(C`UINT8\*(C`\fR) پشتیبانی نمی‌شوند و در زمان بارگذاری رد خواهند شد.
مدل‌هایی که از چینش NHWC یا سایر رتبه‌ها استفاده می‌کنند هنوز
پشتیبانی نمی‌شوند. فقط مدل‌های تک‌ورودی پشتیبانی می‌شوند؛ بَک‌اند
هنگام اجرای مدل دقیقاً یک تانسور ورودی را متصل می‌کند.
.Sp
گزینه‌های \fBinput\fR و \fBoutput\fR برای بَک‌اند ONNX Runtime
اختیاری هستند؛ در صورت حذف آن‌ها، بَک‌اند نام‌های تانسور را
از نشست (session) استخراج می‌کند.
.Sp
بَک‌اند ONNX Runtime استنتاج را به‌صورت همگام با استفاده از یک درخواست
استنتاج واحد اجرا می‌کند. بنابراین گزینه‌های مشترک \fBasync\fR و \fBnireq\fR
هیچ تأثیری برای \f(CW\*(C`dnn_backend=onnx\*(C`\fR ندارند؛ استنتاج صرف‌نظر از
مقادیر آن‌ها همیشه به‌صورت همگام اجرا می‌شود.
.RE
.RS 4
.RE
.IP \fBmodel\fR 4
.IX Item "model"
تنظیم مسیر فایل مدل که معماری شبکه و پارامترهای آن را مشخص می‌کند.
توجه داشته باشید که بَک‌اندهای مختلف از قالب‌های فایل متفاوتی استفاده می‌کنند. بَک‌اندهای TensorFlow، OpenVINO،
Libtorch و ONNX Runtime فقط می‌توانند فایل‌های مربوط به قالب‌های خاص خود را بارگذاری نمایند.
.IP \fBinput\fR 4
.IX Item "input"
تنظیم نام ورودی شبکه dnn. برای بَک‌اند TensorFlow الزامی است؛
برای بَک‌اند ONNX Runtime اختیاری است.
.IP \fBoutput\fR 4
.IX Item "output"
تنظیم نام خروجی شبکه dnn. برای بَک‌اند TensorFlow الزامی است؛
برای بَک‌اند ONNX Runtime اختیاری است.
.IP \fBbackend_configs\fR 4
.IX Item "backend_configs"
تنظیم پیکربندی‌هایی که به بَک‌اند ارسال می‌شوند. برای استفاده از اجرای ناهمگام، async را تنظیم کنید (پیش‌فرض: تنظیم‌شده).
اگر بَک‌اند از اجرای ناهمگام پشتیبانی نکند، به اجرای همگام بازمی‌گردد.
.Sp
برای بَک‌اند tensorflow، می‌توانید پیکربندی‌های آن را با گزینه‌های \fBsess_config\fR تنظیم کنید؛
لطفاً از tools/python/tf_sess_config.py برای دریافت پیکربندی‌های بَک‌اند TensorFlow مناسب سیستم خود استفاده نمایید.
.IP \fBdevice\fR 4
.IX Item "device"
تنظیم دستگاه برای اجرای مدل. برای بَک‌اند ONNX Runtime این گزینه ارائه‌دهنده
اجرا را انتخاب می‌کند: \f(CW\*(C`cpu\*(C`\fR (پیش‌فرض)، \f(CW\*(C`cuda\*(C`\fR (پردازنده گرافیکی NVIDIA)،
\&\f(CW\*(C`dml\*(C`\fR (DirectML، فقط ویندوز) یا \f(CW\*(C`vitisai\*(C`\fR (NPU معماری AMD Ryzen AI).
.IP \fBdevice_id\fR 4
.IX Item "device_id"
تنظیم شناسه دستگاه مورد استفاده توسط ارائه‌دهندگان اجرای GPU (مانند \f(CW\*(C`cuda\*(C`\fR یا
\&\f(CW\*(C`dml\*(C`\fR) برای بَک‌اند ONNX Runtime. پیش‌فرض 0 است.
.IP \fBthreads_per_operation\fR 4
.IX Item "threads_per_operation"
فقط بَک‌اند ONNX Runtime. تنظیم تعداد نخ‌های پردازنده (CPU threads) مورد استفاده به ازای هر عملگر ONNX
Runtime در هنگام اجرا با \f(CW\*(C`device=cpu\*(C`\fR. پیش‌فرض 0 است (اجازه به ONNX
Runtime برای انتخاب خودکار). روی ارائه‌دهندگان GPU/NPU تأثیری ندارد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
حذف باران در فریم rgb24 با can.pb (فیلتر \fBderain\fR را ببینید):
.Sp
.Vb 1
\&        ./ffmpeg \-i rain.jpg \-vf format=rgb24,dnn_processing=dnn_backend=tensorflow:model=can.pb:input=x:output=y derain.jpg
.Ve
.IP \(bu 4
پردازش کانال Y با srcnn.pb (فیلتر \fBsr\fR را ببینید) برای فریم با yuv420p (قالب‌های سطحی YUV پشتیبانی می‌شوند):
.Sp
.Vb 1
\&        ./ffmpeg \-i 480p.jpg \-vf format=yuv420p,scale=w=iw*2:h=ih*2,dnn_processing=dnn_backend=tensorflow:model=srcnn.pb:input=x:output=y \-y srcnn.jpg
.Ve
.IP \(bu 4
پردازش کانال Y با espcn.pb (فیلتر \fBsr\fR را ببینید)، که اندازه فریم را تغییر می‌دهد، برای قالب yuv420p (قالب‌های سطحی YUV پشتیبانی می‌شوند)؛
لطفاً از tools/python/tf_sess_config.py برای دریافت پیکربندی‌های بَک‌اند TensorFlow متناسب با سیستم خود استفاده کنید.
.Sp
.Vb 1
\&        ./ffmpeg \-i 480p.jpg \-vf format=yuv420p,dnn_processing=dnn_backend=tensorflow:model=espcn.pb:input=x:output=y:backend_configs=sess_config=0x10022805320e09cdccccccccccec3f20012a01303801 \-y tmp.espcn.jpg
.Ve
.SS drawbox
.IX Subsection "drawbox"
ترسیم یک کادر (box) رنگی بر روی تصویر ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
عباراتی که مختصات گوشه بالا سمت چپ کادر را مشخص می‌کنند. پیش‌فرض 0 است.
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
عباراتی که عرض و ارتفاع کادر را مشخص می‌کنند؛ اگر 0 باشند به عنوان
عرض و ارتفاع ورودی تفسیر می‌شوند. پیش‌فرض 0 است.
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
تعیین رنگ کادری که ترسیم می‌شود. برای ساختار نحوی کلی این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید. اگر مقدار ویژه
\&\f(CW\*(C`invert\*(C`\fR استفاده شود، رنگ لبه کادر مانند ویدیو اما با
روشنایی (luma) معکوس خواهد بود.
.IP "\fBthickness, t\fR" 4
.IX Item "thickness, t"
عبارتی که ضخامت لبه کادر را تنظیم می‌کند.
مقدار \f(CW\*(C`fill\*(C`\fR یک کادر توپر ایجاد می‌کند. مقدار پیش‌فرض \f(CW3\fR است.
.Sp
برای مشاهده فهرست ثابت‌های پذیرفته‌شده به بخش زیر مراجعه کنید.
.IP \fBreplace\fR 4
.IX Item "replace"
در صورتی که ورودی دارای کانال آلفا باشد کاربرد دارد. با مقدار \f(CW1\fR، پیکسل‌های کادر ترسیم‌شده
روی رنگ و پیکسل‌های آلفای ویدیو بازنویسی می‌شوند.
پیش‌فرض \f(CW0\fR است، که کادر را روی ورودی ترکیب می‌کند و آلفای ویدیو را دست‌نخورده باقی می‌گذارد.
.PP
پارامترهای \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR و \fIt\fR عباراتی شامل
ثابت‌های زیر هستند:
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی (display aspect ratio)، معادل با (\fIw\fR / \fIh\fR) * \fIsar\fR است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری کروما به‌صورت افقی و عمودی. برای مثال برای
قالب پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP "\fBin_h, ih\fR" 4
.IX Item "in_h, ih"
.PD 0
.IP "\fBin_w, iw\fR" 4
.IX Item "in_w, iw"
.PD
عرض و ارتفاع ورودی.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی (sample aspect ratio).
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مختصات آفست x و y در جایی که کادر ترسیم می‌شود.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع کادر ترسیم‌شده.
.IP \fBbox_source\fR 4
.IX Item "box_source"
منبع کادر در صورتی که بخواهید از داده‌های کادر در کادرهای مرزی تشخیص (detection bboxes) داده‌های جانبی (side data) استفاده کنید، می‌تواند روی side_data_detection_bboxes تنظیم شود.
.Sp
اگر \fIbox_source\fR تنظیم شود، مقادیر \fIx\fR، \fIy\fR، \fIwidth\fR و \fIheight\fR نادیده گرفته شده و
همچنان از داده‌های کادر در detection bboxes داده‌های جانبی استفاده خواهد شد. بنابراین اگر از منبع کادر
اطمینان ندارید لطفاً از این پارامتر استفاده نکنید.
.IP \fBt\fR 4
.IX Item "t"
ضخامت کادر ترسیم‌شده.
.Sp
این ثابت‌ها به عبارات \fIx\fR، \fIy\fR، \fIw\fR، \fIh\fR و \fIt\fR اجازه می‌دهند به
یکدیگر ارجاع دهند، بنابراین می‌توانید برای مثال \f(CW\*(C`y=x/dar\*(C`\fR یا \f(CW\*(C`h=w/dar\*(C`\fR را مشخص کنید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
ترسیم یک کادر سیاه در اطراف لبه تصویر ورودی:
.Sp
.Vb 1
\&        drawbox
.Ve
.IP \(bu 4
ترسیم کادری با رنگ قرمز و شفافیت (opacity) ۵۰٪:
.Sp
.Vb 1
\&        drawbox=10:20:200:60:red@0.5
.Ve
.Sp
مثال قبلی را می‌توان به این صورت نیز مشخص کرد:
.Sp
.Vb 1
\&        drawbox=x=10:y=20:w=200:h=60:color=red@0.5
.Ve
.IP \(bu 4
پر کردن کادر با رنگ صورتی:
.Sp
.Vb 1
\&        drawbox=x=10:y=10:w=100:h=100:color=pink@0.5:t=fill
.Ve
.IP \(bu 4
ترسیم یک ماسک ۲ پیکسلی قرمز با نسبت 2.40:1:
.Sp
.Vb 1
\&        drawbox=x=\-t:y=0.5*(ih\-iw/2.4)\-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن
حفظ می‌شود.
.SS drawgraph
.IX Subsection "drawgraph"
رسم نمودار با استفاده از متادیتای ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBm1\fR 4
.IX Item "m1"
تنظیم کلید متادیتای فریم اول که مقادیر متادیتا از آن برای رسم نمودار استفاده خواهد شد.
.IP \fBfg1\fR 4
.IX Item "fg1"
تنظیم عبارت رنگ پیش‌زمینه اول.
.IP \fBm2\fR 4
.IX Item "m2"
تنظیم کلید متادیتای فریم دوم که مقادیر متادیتا از آن برای رسم نمودار استفاده خواهد شد.
.IP \fBfg2\fR 4
.IX Item "fg2"
تنظیم عبارت رنگ پیش‌زمینه دوم.
.IP \fBm3\fR 4
.IX Item "m3"
تنظیم کلید متادیتای فریم سوم که مقادیر متادیتا از آن برای رسم نمودار استفاده خواهد شد.
.IP \fBfg3\fR 4
.IX Item "fg3"
تنظیم عبارت رنگ پیش‌زمینه سوم.
.IP \fBm4\fR 4
.IX Item "m4"
تنظیم کلید متادیتای فریم چهارم که مقادیر متادیتا از آن برای رسم نمودار استفاده خواهد شد.
.IP \fBfg4\fR 4
.IX Item "fg4"
تنظیم عبارت رنگ پیش‌زمینه چهارم.
.IP \fBmin\fR 4
.IX Item "min"
تنظیم حداقل مقدار متادیتا.
.IP \fBmax\fR 4
.IX Item "max"
تنظیم حداکثر مقدار متادیتا.
.IP \fBbg\fR 4
.IX Item "bg"
تنظیم رنگ پس‌زمینه نمودار. پیش‌فرض سفید (white) است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت نمودار.
.Sp
مقادیر مجاز برای mode عبارتند از:
.RS 4
.IP \fBbar\fR 4
.IX Item "bar"
.PD 0
.IP \fBdot\fR 4
.IX Item "dot"
.IP \fBline\fR 4
.IX Item "line"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`line\*(C`\fR است.
.RE
.IP \fBslide\fR 4
.IX Item "slide"
تنظیم حالت اسلاید (لغزش).
.Sp
مقادیر مجاز برای slide عبارتند از:
.RS 4
.IP \fBframe\fR 4
.IX Item "frame"
رسم فریم جدید هنگام رسیدن به حاشیه سمت راست.
.IP \fBreplace\fR 4
.IX Item "replace"
جایگزینی ستون‌های قدیمی با ستون‌های جدید.
.IP \fBscroll\fR 4
.IX Item "scroll"
اسکرول از راست به چپ.
.IP \fBrscroll\fR 4
.IX Item "rscroll"
اسکرول از چپ به راست.
.IP \fBpicture\fR 4
.IX Item "picture"
رسم یک تصویر تکی.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`frame\*(C`\fR است.
.RE
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه ویدیوی نمودار. برای ساختار نحوی این گزینه،
\fBبخش "Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`900x256\*(C`\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی. مقدار پیش‌فرض \f(CW25\fR است.
.Sp
عبارات رنگ پیش‌زمینه می‌توانند از متغیرهای زیر استفاده کنند:
.RS 4
.IP \fBMIN\fR 4
.IX Item "MIN"
حداقل مقدار متادیتا.
.IP \fBMAX\fR 4
.IX Item "MAX"
حداکثر مقدار متادیتا.
.IP \fBVAL\fR 4
.IX Item "VAL"
مقدار فعلی کلید متادیتا.
.RE
.RS 4
.Sp
رنگ به‌صورت 0xAABBGGRR تعریف می‌شود.
.RE
.PP
مثال با استفاده از متادیتا از فیلتر \fBsignalstats\fR:
.PP
.Vb 1
\&        signalstats,drawgraph=lavfi.signalstats.YAVG:min=0:max=255
.Ve
.PP
مثال با استفاده از متادیتا از فیلتر \fBebur128\fR:
.PP
.Vb 1
\&        ebur128=metadata=1,adrawgraph=lavfi.r128.M:min=\-120:max=5
.Ve
.SS drawgrid
.IX Subsection "drawgrid"
رسم یک توری (grid) بر روی تصویر ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
عباراتی که مختصات نقطه‌ای از تقاطع شبکه را مشخص می‌کنند (به منظور پیکربندی آفست). پیش‌فرض هر دو 0 است.
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
عباراتی که عرض و ارتفاع سلول شبکه را مشخص می‌کنند؛ اگر 0 باشند به عنوان عرض و ارتفاع ورودی،
به ترتیب، منهای \f(CW\*(C`thickness\*(C`\fR تفسیر می‌شوند تا تصویر قاب‌بندی شود.
پیش‌فرض 0 است.
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
تعیین رنگ شبکه. برای ساختار نحوی کلی این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید. اگر مقدار ویژه
\f(CW\*(C`invert\*(C`\fR استفاده شود، رنگ شبکه همانند ویدیو اما با
روشنایی (luma) معکوس خواهد بود.
.IP "\fBthickness, t\fR" 4
.IX Item "thickness, t"
عبارتی که ضخامت خطوط شبکه را تنظیم می‌کند. مقدار پیش‌فرض \f(CW1\fR است.
.Sp
برای مشاهده فهرست ثابت‌های پذیرفته‌شده به بخش زیر مراجعه کنید.
.IP \fBreplace\fR 4
.IX Item "replace"
در صورتی که ورودی دارای کانال آلفا باشد کاربرد دارد. با مقدار \f(CW1\fR، پیکسل‌های شبکه ترسیم‌شده
روی رنگ و پیکسل‌های آلفای ویدیو بازنویسی می‌شوند.
پیش‌فرض \f(CW0\fR است، که شبکه را روی ورودی ترکیب می‌کند و آلفای ویدیو دست‌نخورده باقی می‌ماند.
.PP
پارامترهای \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR و \fIt\fR عباراتی شامل
ثابت‌های زیر هستند:
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی (display aspect ratio)، معادل با (\fIw\fR / \fIh\fR) * \fIsar\fR است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری کروما به‌صورت افقی و عمودی. برای مثال برای
قالب پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP "\fBin_h, ih\fR" 4
.IX Item "in_h, ih"
.PD 0
.IP "\fBin_w, iw\fR" 4
.IX Item "in_w, iw"
.PD
عرض و ارتفاع سلول شبکه ورودی.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی (sample aspect ratio).
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مختصات x و y نقطه‌ای از تقاطع شبکه (به منظور پیکربندی آفست).
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع سلول رسم‌شده.
.IP \fBt\fR 4
.IX Item "t"
ضخامت سلول رسم‌شده.
.Sp
این ثابت‌ها به عبارات \fIx\fR، \fIy\fR، \fIw\fR، \fIh\fR و \fIt\fR اجازه می‌دهند به
یکدیگر ارجاع دهند، بنابراین می‌توانید برای مثال \f(CW\*(C`y=x/dar\*(C`\fR یا \f(CW\*(C`h=w/dar\*(C`\fR را مشخص کنید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
رسم یک شبکه با سلول‌های 100x100 پیکسل، ضخامت 2 پیکسل، با رنگ قرمز و شفافیت ۵۰٪:
.Sp
.Vb 1
\&        drawgrid=width=100:height=100:thickness=2:color=red@0.5
.Ve
.IP \(bu 4
رسم یک شبکه 3x3 سفید با شفافیت ۵۰٪:
.Sp
.Vb 1
\&        drawgrid=w=iw/3:h=ih/3:t=2:c=white@0.5
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن
حفظ می‌شود.
.SS drawtext
.IX Subsection "drawtext"
ترسیم یک رشته متنی یا متن حاصل از یک فایل مشخص بر روی ویدیو، با استفاده از
کتابخانه libfreetype.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libfreetype\*(C`\fR و \f(CW\*(C`\-\-enable\-libharfbuzz\*(C`\fR پیکربندی کنید.
برای فعال‌سازی قلم جایگزین پیش‌فرض (fallback) و گزینه \fIfont\fR باید
FFmpeg را با \f(CW\*(C`\-\-enable\-libfontconfig\*(C`\fR پیکربندی نمایید.
برای فعال‌سازی گزینه \fItext_shaping\fR، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libfribidi\*(C`\fR پیکربندی کنید.
.PP
\fIساختار نحوی (Syntax)\fR
.IX Subsection "Syntax"
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBbox\fR 4
.IX Item "box"
برای ترسیم کادری در اطراف متن با استفاده از رنگ پس‌زمینه به کار می‌رود.
مقدار آن باید 1 (فعال) یا 0 (غیرفعال) باشد.
مقدار پیش‌فرض \fIbox\fR برابر 0 است.
.IP \fBboxborderw\fR 4
.IX Item "boxborderw"
تنظیم عرض حاشیه‌ای که با استفاده از \fIboxcolor\fR در اطراف کادر کشیده می‌شود.
مقدار باید با استفاده از یکی از قالب‌های زیر مشخص شود:
.RS 4
.ie n .IP "*<""boxborderw=10"" تنظیم عرض تمام حاشیه‌ها روی 10>" 4
.el .IP "*<\f(CWboxborderw=10\fR تنظیم عرض تمام حاشیه‌ها روی 10>" 4
.IX Item "*<boxborderw=10 set the width of all the borders to 10>"
.PD 0
.ie n .IP "*<""boxborderw=10|20"" تنظیم عرض حاشیه‌های بالا و پایین روی 10>" 4
.el .IP "*<\f(CWboxborderw=10|20\fR تنظیم عرض حاشیه‌های بالا و پایین روی 10>" 4
.IX Item "*<boxborderw=10|20 set the width of the top and bottom borders to 10>"
.PD
.Vb 1
\&    and the width of the left and right borders to 20
.Ve
.ie n .IP "*<""boxborderw=10|20|30"" تنظیم عرض حاشیه بالا روی 10، عرض>" 4
.el .IP "*<\f(CWboxborderw=10|20|30\fR تنظیم عرض حاشیه بالا روی 10، عرض>" 4
.IX Item "*<boxborderw=10|20|30 set the width of the top border to 10, the width>"
.Vb 1
\&    of the bottom border to 30 and the width of the left and right borders to 20
.Ve
.ie n .IP "*<""boxborderw=10|20|30|40"" تنظیم عرض حاشیه‌ها روی 10 (بالا)، 20 (راست)،>" 4
.el .IP "*<\f(CWboxborderw=10|20|30|40\fR تنظیم عرض حاشیه‌ها روی 10 (بالا)، 20 (راست)،>" 4
.IX Item "*<boxborderw=10|20|30|40 set the borders width to 10 (top), 20 (right),>"
.Vb 1
\&    30 (bottom), 40 (left)
.Ve
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIboxborderw\fR برابر "0" است.
.RE
.IP \fBboxcolor\fR 4
.IX Item "boxcolor"
رنگ مورد استفاده برای ترسیم کادر در اطراف متن. برای ساختار نحوی این
گزینه، \fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
مقدار پیش‌فرض \fIboxcolor\fR برابر "white" است.
.IP \fBline_spacing\fR 4
.IX Item "line_spacing"
تنظیم فاصله بین خطوط بر حسب پیکسل. مقدار پیش‌فرض \fIline_spacing\fR برابر 0 است.
.IP \fBtext_align\fR 4
.IX Item "text_align"
تنظیم تراز عمودی و افقی متن نسبت به مرزهای کادر.
مقدار ترکیبی از پرچم‌ها است: یکی برای تراز عمودی (T=بالا،
M=وسط، B=پایین) و دیگری برای تراز افقی (L=چپ، C=مرکز، R=راست).
لطفاً توجه داشته باشید که نویسه‌های تب (tab) فقط با تراز افقی چپ پشتیبانی می‌شوند.
.IP \fBy_align\fR 4
.IX Item "y_align"
مشخص می‌کند که مقدار \fIy\fR به چه چیزی ارجاع دارد. مقادیر ممکن عبارتند از:
.RS 4
.ie n .IP "*<""text"" بالای بلندترین گلیف اولین خط متن در \fIy\fR قرار می‌گیرد>" 4
.el .IP "*<\f(CWtext\fR بالای بلندترین گلیف اولین خط متن در \fIy\fR قرار می‌گیرد>" 4
.IX Item "*<text the top of the highest glyph of the first text line is placed at y>"
.PD 0
.ie n .IP "*<""baseline"" خط مبنای اولین خط متن در \fIy\fR قرار می‌گیرد>" 4
.el .IP "*<\f(CWbaseline\fR خط مبنای اولین خط متن در \fIy\fR قرار می‌گیرد>" 4
.IX Item "*<baseline the baseline of the first text line is placed at y>"
.ie n .IP "*<""font"" خط مبنای اولین خط متن در \fIy\fR به اضافه>" 4
.el .IP "*<\f(CWfont\fR خط مبنای اولین خط متن در \fIy\fR به اضافه>" 4
.IX Item "*<font the baseline of the first text line is placed at y plus the>"
.PD
.Vb 1
\&    ascent (in pixels) defined in the font metrics
.Ve
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIy_align\fR به دلیل سازگاری رو به عقب "text" است.
.RE
.IP \fBborderw\fR 4
.IX Item "borderw"
تنظیم عرض حاشیه‌ای که با استفاده از \fIbordercolor\fR در اطراف متن کشیده می‌شود.
مقدار پیش‌فرض \fIborderw\fR برابر 0 است.
.IP \fBbordercolor\fR 4
.IX Item "bordercolor"
تنظیم رنگ مورد استفاده برای ترسیم حاشیه در اطراف متن. برای ساختار نحوی این
گزینه، \fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
مقدار پیش‌فرض \fIbordercolor\fR برابر "black" است.
.IP \fBexpansion\fR 4
.IX Item "expansion"
انتخاب نحوه بسط دادن \fItext\fR. می‌تواند یکی از مقادیر \f(CW\*(C`none\*(C`\fR،
\&\f(CW\*(C`strftime\*(C`\fR (منسوخ‌شده) یا \f(CW\*(C`normal\*(C`\fR (پیش‌فرض) باشد. برای جزئیات به
بخش \fBdrawtext_expansion، بسط متن (Text expansion)\fR در زیر مراجعه کنید.
.IP \fBbasetime\fR 4
.IX Item "basetime"
تنظیم زمان شروع برای شمارش. مقدار بر حسب میکروثانیه است. فقط در
حالت منسوخ‌شده بسط \f(CW\*(C`strftime\*(C`\fR اعمال می‌شود. برای شبیه‌سازی در حالت بسط نرمال،
از تابع \f(CW\*(C`pts\*(C`\fR استفاده کنید و زمان شروع (بر حسب ثانیه) را
به عنوان آرگومان دوم ارائه دهید.
.IP \fBfix_bounds\fR 4
.IX Item "fix_bounds"
در صورت فعال بودن، مختصات متن برای جلوگیری از برش‌خوردگی (clipping) بررسی و اصلاح می‌شود.
.IP \fBfontcolor\fR 4
.IX Item "fontcolor"
رنگ مورد استفاده برای ترسیم فونت‌ها. برای ساختار نحوی این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
مقدار پیش‌فرض \fIfontcolor\fR برابر "black" است.
.IP \fBfontcolor_expr\fR 4
.IX Item "fontcolor_expr"
رشته‌ای که به همان شیوه \fItext\fR بسط داده می‌شود تا مقدار پویای
\&\fIfontcolor\fR به دست آید. به‌طور پیش‌فرض این گزینه مقداری خالی دارد و
پردازش نمی‌شود. وقتی این گزینه تنظیم شود، گزینه \fIfontcolor\fR را بازنویسی می‌کند.
.IP \fBfont\fR 4
.IX Item "font"
خانواده قلم مورد استفاده برای رسم متن. به‌طور پیش‌فرض Sans است.
.IP \fBfontfile\fR 4
.IX Item "fontfile"
فایل قلم مورد استفاده برای رسم متن. مسیر فایل باید درج شود.
در صورتی که پشتیبانی از fontconfig غیرفعال باشد، این پارامتر الزامی است.
.IP \fBalpha\fR 4
.IX Item "alpha"
رسم متن با اعمال ترکیب آلفا (alpha blending). مقدار می‌تواند
عددی بین 0.0 و 1.0 باشد.
این عبارت متغیرهای \fIx, y\fR را نیز می‌پذیرد.
مقدار پیش‌فرض 1 است.
لطفاً \fIfontcolor_expr\fR را ببینید.
.IP \fBfontsize\fR 4
.IX Item "fontsize"
اندازه قلم مورد استفاده برای رسم متن.
مقدار پیش‌فرض \fIfontsize\fR برابر 16 است.
.IP \fBtext_shaping\fR 4
.IX Item "text_shaping"
در صورت تنظیم روی 1، تلاش می‌کند تا پیش از رسم متن، شکل‌دهی مناسب را به آن اعمال کند (برای مثال، معکوس کردن
ترتیب متن راست‌به‌چپ و اتصال حروف عربی و فارسی).
در غیر این صورت، متن را دقیقاً همان‌طور که داده شده رسم می‌کند.
به‌طور پیش‌فرض 1 است (در صورت پشتیبانی).
.IP \fBft_load_flags\fR 4
.IX Item "ft_load_flags"
پرچم‌های مورد استفاده برای بارگذاری قلم‌ها.
.Sp
این پرچم‌ها با پرچم‌های متناظر پشتیبانی‌شده توسط libfreetype مطابقت دارند و
ترکیبی از مقادیر زیر هستند:
.RS 4
.IP \fIdefault\fR 4
.IX Item "default"
.PD 0
.IP \fIno_scale\fR 4
.IX Item "no_scale"
.IP \fIno_hinting\fR 4
.IX Item "no_hinting"
.IP \fIrender\fR 4
.IX Item "render"
.IP \fIno_bitmap\fR 4
.IX Item "no_bitmap"
.IP \fIvertical_layout\fR 4
.IX Item "vertical_layout"
.IP \fIforce_autohint\fR 4
.IX Item "force_autohint"
.IP \fIcrop_bitmap\fR 4
.IX Item "crop_bitmap"
.IP \fIpedantic\fR 4
.IX Item "pedantic"
.IP \fIignore_global_advance_width\fR 4
.IX Item "ignore_global_advance_width"
.IP \fIno_recurse\fR 4
.IX Item "no_recurse"
.IP \fIignore_transform\fR 4
.IX Item "ignore_transform"
.IP \fImonochrome\fR 4
.IX Item "monochrome"
.IP \fIlinear_design\fR 4
.IX Item "linear_design"
.IP \fIno_autohint\fR 4
.IX Item "no_autohint"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض "default" است.
.Sp
برای اطلاعات بیشتر به مستندات پرچم‌های FT_LOAD_* در
libfreetype مراجعه کنید.
.RE
.IP \fBshadowcolor\fR 4
.IX Item "shadowcolor"
رنگ مورد استفاده برای رسم سایه در پشت متن رسم‌شده. برای
ساختار نحوی این گزینه، \fBبخش "Color" در
راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
مقدار پیش‌فرض \fIshadowcolor\fR برابر "black" است.
.IP \fBboxw\fR 4
.IX Item "boxw"
تنظیم عرض کادری که در اطراف متن رسم می‌شود.
مقدار پیش‌فرض \fIboxw\fR به‌طور خودکار متناسب با عرض متن محاسبه می‌شود.
.IP \fBboxh\fR 4
.IX Item "boxh"
تنظیم ارتفاع کادری که در اطراف متن رسم می‌شود.
مقدار پیش‌فرض \fIboxh\fR به‌طور خودکار متناسب با ارتفاع متن محاسبه می‌شود.
.IP \fBshadowx\fR 4
.IX Item "shadowx"
.PD 0
.IP \fBshadowy\fR 4
.IX Item "shadowy"
.PD
آفست‌های x و y برای موقعیت سایه متن نسبت به
موقعیت متن. این مقادیر می‌توانند مثبت یا منفی
باشند. مقدار پیش‌فرض هر دو "0" است.
.IP \fBstart_number\fR 4
.IX Item "start_number"
شماره فریم شروع برای متغیر n/frame_num. مقدار پیش‌فرض
"0" است.
.IP \fBtabsize\fR 4
.IX Item "tabsize"
اندازه بر حسب تعداد فاصله‌ها جهت استفاده در رندر تب (tab).
مقدار پیش‌فرض 4 است.
.IP \fBtimecode\fR 4
.IX Item "timecode"
تنظیم نمایش اولیه تایم‌کد در قالب "hh:mm:ss[:;.]ff".
می‌تواند همراه با پارامتر text یا بدون آن استفاده شود. گزینه \fItimecode_rate\fR
باید مشخص شود.
.IP "\fBtimecode_rate, rate, r\fR" 4
.IX Item "timecode_rate, rate, r"
تنظیم نرخ فریم تایم‌کد (فقط تایم‌کد). مقدار به نزدیک‌ترین عدد صحیح
گرد می‌شود. حداقل مقدار "1" است.
تایم‌کد Drop\-frame برای نرخ‌های فریم 30 و 60 پشتیبانی می‌شود.
.IP \fBtc24hmax\fR 4
.IX Item "tc24hmax"
در صورت تنظیم روی 1، خروجی گزینه timecode پس از 24 ساعت به صفر بازمی‌گردد.
پیش‌فرض 0 است (غیرفعال).
.IP \fBtext\fR 4
.IX Item "text"
رشته متنی برای رسم. متن باید دنباله‌ای از نویسه‌های
کدگذاری‌شده با UTF\-8 باشد.
در صورتی که هیچ فایلی با پارامتر \fItextfile\fR مشخص نشده باشد،
این پارامتر الزامی است.
.IP \fBtextfile\fR 4
.IX Item "textfile"
یک فایل متنی حاوی متنی که باید رسم شود. متن باید دنباله‌ای
از نویسه‌های کدگذاری‌شده با UTF\-8 باشد.
.Sp
در صورتی که هیچ رشته متنی با پارامتر \fItext\fR مشخص نشده باشد،
این پارامتر الزامی است.
.Sp
اگر هر دو پارامتر \fItext\fR و \fItextfile\fR مشخص شوند، یک خطا صادر می‌شود.
.IP \fBtext_source\fR 4
.IX Item "text_source"
در صورتی که بخواهید از داده‌های متنی در detection bboxes داده‌های جانبی استفاده کنید، text source باید روی side_data_detection_bboxes تنظیم شود.
.Sp
اگر text source تنظیم شود، \fItext\fR و \fItextfile\fR نادیده گرفته می‌شوند و همچنان
از داده‌های متنی در detection bboxes داده‌های جانبی استفاده خواهد شد. بنابراین اگر درباره
منبع متن مطمئن نیستید، لطفاً از این پارامتر استفاده نکنید.
.IP \fBreload\fR 4
.IX Item "reload"
فایل \fItextfile\fR در بازه فریمی مشخص‌شده مجدداً بارگذاری خواهد شد.
اطمینان حاصل کنید که \fItextfile\fR را به‌طور اتمیک به‌روزرسانی نمایید، در غیر این صورت ممکن است به‌طور ناقص خوانده شده
یا حتی با شکست مواجه شود.
محدوده مجاز از 0 تا INT_MAX است. پیش‌فرض 0 است.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
عباراتی که آفست‌های محل رسم متن درون فریم ویدیو را مشخص می‌کنند.
این مقادیر نسبت به حاشیه بالا/چپ تصویر خروجی سنجیده می‌شوند.
.Sp
مقدار پیش‌فرض \fIx\fR و \fIy\fR برابر "0" است.
.Sp
برای مشاهده فهرست ثابت‌ها و توابع پذیرفته‌شده به بخش زیر مراجعه نمایید.
.PP
پارامترهای \fIx\fR و \fIy\fR عباراتی حاوی
ثابت‌ها و توابع زیر هستند:
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی (display aspect ratio)، معادل با (\fIw\fR / \fIh\fR) * \fIsar\fR است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری کرومای افقی و عمودی. برای مثال برای
قالب پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP "\fBline_h, lh\fR" 4
.IX Item "line_h, lh"
ارتفاع هر خط از متن
.IP "\fBmain_h, h, H\fR" 4
.IX Item "main_h, h, H"
ارتفاع ورودی
.IP "\fBmain_w, w, W\fR" 4
.IX Item "main_w, w, W"
عرض ورودی
.IP "\fBmax_glyph_a, ascent\fR" 4
.IX Item "max_glyph_a, ascent"
حداکثر فاصله از خط مبنا (baseline) تا بالاترین مختصات شبکه که
برای قرار دادن نقطه محیطی گلیف استفاده می‌شود، برای تمامی گلیف‌های
رندرشده.
به دلیل جهت‌گیری شبکه با محور Y رو به بالا، این مقدار مثبت است.
.IP "\fBmax_glyph_d, descent\fR" 4
.IX Item "max_glyph_d, descent"
حداکثر فاصله از خط مبنا تا پایین‌ترین مختصات شبکه که برای
قرار دادن نقطه محیطی گلیف استفاده می‌شود، برای تمامی گلیف‌های رندرشده.
به دلیل جهت‌گیری شبکه با محور Y رو به بالا، این مقدار منفی است.
.IP \fBmax_glyph_h\fR 4
.IX Item "max_glyph_h"
حداکثر ارتفاع گلیف، یعنی حداکثر ارتفاع برای تمامی گلیف‌های
موجود در متن رندرشده، که معادل با \fIascent\fR \-
\&\fIdescent\fR است.
.IP \fBmax_glyph_w\fR 4
.IX Item "max_glyph_w"
حداکثر عرض گلیف، یعنی حداکثر عرض برای تمامی گلیف‌های
موجود در متن رندرشده
.IP \fBfont_a\fR 4
.IX Item "font_a"
اندازه صعود (ascent) تعریف‌شده در سنجه‌های قلم (font metrics)
.IP \fBfont_d\fR 4
.IX Item "font_d"
اندازه فرود (descent) تعریف‌شده در سنجه‌های قلم
.IP \fBtop_a\fR 4
.IX Item "top_a"
حداکثر صعود گلیف‌های اولین خط متن
.IP \fBbottom_d\fR 4
.IX Item "bottom_d"
حداکثر فرود گلیف‌های آخرین خط متن
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، شروع از 0
.IP "\fBrand(min, max)\fR" 4
.IX Item "rand(min, max)"
بازگرداندن یک عدد تصادفی بین \fImin\fR و \fImax\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی (sample aspect ratio).
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بیان‌شده بر حسب ثانیه، اگر برچسب زمانی ورودی ناشناخته باشد NAN است
.IP "\fBtext_h, th\fR" 4
.IX Item "text_h, th"
ارتفاع متن رندرشده
.IP "\fBtext_w, tw\fR" 4
.IX Item "text_w, tw"
عرض متن رندرشده
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مختصات آفست x و y در جایی که متن رسم می‌شود.
.Sp
این پارامترها به عبارات \fIx\fR و \fIy\fR اجازه می‌دهند به
یکدیگر ارجاع دهند، بنابراین می‌توانید برای مثال \f(CW\*(C`y=x/dar\*(C'\fR را مشخص کنید.
.IP \fBpict_type\fR 4
.IX Item "pict_type"
یک توصیف یک‌نویسه‌ای از نوع تصویر (picture type) فریم فعلی.
.IP \fBpkt_pos\fR 4
.IX Item "pkt_pos"
موقعیت بسته (packet) فعلی در فایل یا جریان ورودی
(بر حسب بایت، از ابتدای ورودی). مقدار \-1 نشان می‌دهد
این اطلاعات در دسترس نیست.
.IP \fBduration\fR 4
.IX Item "duration"
مدت‌زمان بسته فعلی، بر حسب ثانیه.
.IP \fBpkt_size\fR 4
.IX Item "pkt_size"
اندازه بسته فعلی (بر حسب بایت).
.PP
\fIبسط متن (Text expansion)\fR
.IX Subsection "Text expansion"
.PP
اگر \fBexpansion\fR روی \f(CW\*(C`strftime\*(C'\fR تنظیم شده باشد، فیلتر
توالی‌های پذیرفته‌شده توسط تابع C بنام \f(CW\*(C`strftime\*(C'\fR را در متن ارائه‌شده
شناسایی کرده و آن‌ها را مطابق با آن بسط می‌دهد. مستندات
\&\f(CW\*(C`strftime\*(C'\fR را بررسی کنید. این ویژگی به نفع بسط \f(CW\*(C`normal\*(C'\fR
با توابع بسط \f(CW\*(C`gmtime\*(C'\fR یا \f(CW\*(C`localtime\*(C'\fR منسوخ شده است.
.PP
اگر \fBexpansion\fR روی \f(CW\*(C`none\*(C'\fR تنظیم شده باشد، متن عیناً چاپ می‌شود.
.PP
اگر \fBexpansion\fR روی \f(CW\*(C`normal\*(C'\fR تنظیم شده باشد (که حالت پیش‌فرض است)،
سازوکار بسط زیر استفاده می‌شود.
.PP
نویسه بک‌اسلش \fB\e\fR، اگر پس از آن هر نویسه‌ای بیاید، همیشه به
نویسه دوم بسط داده می‌شود.
.PP
توالی‌هایی به شکل \f(CW\*(C`%{...}\*(C'\fR بسط داده می‌شوند. متن بین
آکولادها یک نام تابع است که احتمالاً آرگومان‌هایی با علامت \*(Aq:\*(Aq از آن جدا شده‌اند.
اگر آرگومان‌ها شامل نویسه‌های ویژه یا جداکننده‌ها (\*(Aq:\*(Aq یا \*(Aq}\*(Aq) باشند،
باید گریز داده شوند (escaped).
.PP
توجه داشته باشید که آن‌ها احتمالاً باید هم به عنوان مقدار برای گزینه \fBtext\fR
در رشته آرگومان فیلتر و هم به عنوان آرگومان فیلتر در توصیف
filtergraph، و احتمالاً برای پوسته (shell) نیز گریز داده شوند، که تا چهار
سطح گریز را تشکیل می‌دهد؛ استفاده از یک فایل متنی با گزینه \fBtextfile\fR از
این مشکلات جلوگیری می‌کند.
.PP
توابع زیر در دسترس هستند:
.IP "\fBexpr, e\fR" 4
.IX Item "expr, e"
نتیجه ارزیابی عبارت.
.Sp
باید یک آرگومان برای تعیین عبارتی که باید ارزیابی شود بپذیرد،
که همان ثابت‌ها و توابع مقادیر \fIx\fR و
\&\fIy\fR را می‌پذیرد. توجه داشته باشید که همه ثابت‌ها نباید استفاده شوند؛ برای
مثال اندازه متن هنگام ارزیابی عبارت شناخته‌شده نیست، بنابراین
ثابت‌های \fItext_w\fR و \fItext_h\fR مقداری تعریف‌نشده خواهند
داشت.
.IP "\fBexpr_int_format, eif\fR" 4
.IX Item "expr_int_format, eif"
ارزیابی مقدار عبارت و خروجی به صورت عدد صحیح قالب‌بندی‌شده.
.Sp
آرگومان اول عبارتی است که باید ارزیابی شود، درست مانند تابع \fIexpr\fR.
آرگومان دوم قالب خروجی را مشخص می‌کند. مقادیر مجاز عبارتند از \fBx\fR،
\&\fBX\fR، \fBd\fR و \fBu\fR. با آن‌ها دقیقاً مانند تابع
\&\f(CW\*(C`printf\*(C'\fR رفتار می‌شود.
پارامتر سوم اختیاری است و تعداد موقعیت‌های اشغال‌شده توسط خروجی را تعیین می‌کند.
می‌تواند برای افزودن فاصله‌گذاری با صفر (padding) از سمت چپ استفاده شود.
.IP \fBgmtime\fR 4
.IX Item "gmtime"
زمان اجرای فیلتر، بیان‌شده بر حسب UTC.
می‌تواند یک آرگومان بپذیرد: یک رشته قالب تابع C بنام \f(CW\*(C`strftime\*(C'\fR.
رشته قالب برای پشتیبانی از متغیر \fI%[1\-6]N\fR که کسر ثانیه را با
تعداد ارقام مشخص اختیاری چاپ می‌کند گسترش یافته است.
.IP \fBlocaltime\fR 4
.IX Item "localtime"
زمان اجرای فیلتر، بیان‌شده بر حسب منطقه زمانی محلی.
می‌تواند یک آرگومان بپذیرد: یک رشته قالب تابع C بنام \f(CW\*(C`strftime\*(C'\fR.
رشته قالب برای پشتیبانی از متغیر \fI%[1\-6]N\fR که کسر ثانیه را با
تعداد ارقام مشخص اختیاری چاپ می‌کند گسترش یافته است.
.IP \fBmetadata\fR 4
.IX Item "metadata"
متادیتای فریم. یک یا دو آرگومان می‌گیرد.
.Sp
آرگومان اول الزامی است و کلید متادیتا را مشخص می‌کند.
.Sp
آرگومان دوم اختیاری است و یک مقدار پیش‌فرض را تعیین می‌کند که در صورت پیدا نشدن
یا خالی بودن کلید متادیتا استفاده می‌شود.
.Sp
متادیتای موجود را می‌توان با بررسی ورودی‌هایی که با TAG در هر بخش فریم
شروع می‌شوند و با اجرای \f(CW\*(C`ffprobe \-show_frames\*(C'\fR چاپ می‌شوند،
شناسایی کرد.
.Sp
متادیتای رشته‌ای تولیدشده در فیلترهایی که به
فیلتر drawtext منتهی می‌شوند نیز در دسترس هستند.
.IP "\fBn, frame_num\fR" 4
.IX Item "n, frame_num"
شماره فریم، شروع از 0.
.IP \fBpict_type\fR 4
.IX Item "pict_type"
توصیف یک‌نویسه‌ای از نوع تصویر فعلی.
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمانی فریم فعلی.
.Sp
می‌تواند تا سه آرگومان بپذیرد.
.Sp
آرگومان اول قالب برچسب زمانی است؛ پیش‌فرض آن \f(CW\*(C`flt\*(C'\fR
برای ثانیه‌ها به صورت عدد اعشاری با دقت میکروثانیه است؛ \f(CW\*(C`hms\*(C'\fR نشان‌دهنده
یک برچسب زمانی قالب‌بندی‌شده \fI[\-]HH:MM:SS.mmm\fR با دقت میلی‌ثانیه است.
\&\f(CW\*(C`gmtime\*(C'\fR نشان‌دهنده برچسب زمانی فریم در قالب زمان UTC است؛
\&\f(CW\*(C`localtime\*(C'\fR نشان‌دهنده برچسب زمانی فریم در قالب
زمان منطقه زمانی محلی است.
.Sp
آرگومان دوم یک آفست است که به برچسب زمانی اضافه می‌شود.
.Sp
اگر قالب روی \f(CW\*(C`hms\*(C'\fR تنظیم شده باشد، یک آرگومان سوم \f(CW\*(C`24HH\*(C'\fR ممکن است
ارائه شود تا بخش ساعت برچسب زمانی قالب‌بندی‌شده را در قالب 24 ساعته
(00\-23) نشان دهد.
.Sp
اگر قالب روی \f(CW\*(C`localtime\*(C'\fR یا \f(CW\*(C`gmtime\*(C'\fR تنظیم شده باشد، ممکن است یک
آرگومان سوم ارائه شود: یک رشته قالب تابع C بنام \f(CW\*(C`strftime\*(C'\fR.
به‌طور پیش‌فرض، از قالب \fIYYYY\-MM\-DD HH:MM:SS\fR استفاده خواهد شد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تغییر پارامترها از طریق دستورات پشتیبانی می‌کند:
.IP \fBreinit\fR 4
.IX Item "reinit"
تغییر پارامترهای فیلتر موجود.
.Sp
ساختار نحوی برای آرگومان همانند فراخوانی فیلتر است، برای مثال:
.Sp
.Vb 1
\&        fontsize=56:fontcolor=green:text=\*(AqHello World\*(Aq
.Ve
.Sp
فراخوانی کامل فیلتر با sendcmd شبیه به این خواهد بود:
.Sp
.Vb 1
\&        sendcmd=c=\*(Aq56.0 drawtext reinit fontsize=56\e:fontcolor=green\e:text=Hello\e\e World\*(Aq
.Ve
.Sp
اگر کل آرگومان نتواند تجزیه شده یا به عنوان مقادیر معتبر اعمال شود، فیلتر
با پارامترهای موجود خود ادامه خواهد داد.
.PP
گزینه‌های زیر نیز به عنوان \fBدستورات\fR پشتیبانی می‌شوند:
.IP *<x> 4
.IX Item "*<x>"
.PD 0
.IP *<y> 4
.IX Item "*<y>"
.IP *<alpha> 4
.IX Item "*<alpha>"
.IP *<fontsize> 4
.IX Item "*<fontsize>"
.IP *<fontcolor> 4
.IX Item "*<fontcolor>"
.IP *<boxcolor> 4
.IX Item "*<boxcolor>"
.IP *<bordercolor> 4
.IX Item "*<bordercolor>"
.IP *<shadowcolor> 4
.IX Item "*<shadowcolor>"
.IP *<box> 4
.IX Item "*<box>"
.IP *<boxw> 4
.IX Item "*<boxw>"
.IP *<boxh> 4
.IX Item "*<boxh>"
.IP *<boxborderw> 4
.IX Item "*<boxborderw>"
.IP *<line_spacing> 4
.IX Item "*<line_spacing>"
.IP *<text_align> 4
.IX Item "*<text_align>"
.IP *<shadowx> 4
.IX Item "*<shadowx>"
.IP *<shadowy> 4
.IX Item "*<shadowy>"
.IP *<borderw> 4
.IX Item "*<borderw>"
.PD
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
رسم "Test Text" با قلم FreeSerif، با استفاده از مقادیر پیش‌فرض برای
پارامترهای اختیاری.
.Sp
.Vb 1
\&        drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text=\*(AqTest Text\*(Aq"
.Ve
.IP \(bu 4
رسم \*(AqTest Text\*(Aq با قلم FreeSerif با اندازه 24 در موقعیت x=100
و y=50 (شمارش از گوشه بالا سمت چپ صفحه)، رنگ متن زرد همراه با کادری قرمز در اطراف آن
است. هم متن و هم کادر شفافیت 20٪ دارند.
.Sp
.Vb 2
\&        drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text=\*(AqTest Text\*(Aq:\e
\&                  x=100: y=50: fontsize=24: fontcolor=yellow@0.2: box=1: boxcolor=red@0.2"
.Ve
.Sp
توجه داشته باشید که اگر از فاصله درون فهرست پارامترها استفاده نشود، علامت‌های نقل‌قول دوگانه
ضروری نیستند.
.IP \(bu 4
نمایش متن در مرکز فریم ویدیو:
.Sp
.Vb 1
\&        drawtext="fontsize=30:fontfile=FreeSerif.ttf:text=\*(Aqhello world\*(Aq:x=(w\-text_w)/2:y=(h\-text_h)/2"
.Ve
.IP \(bu 4
نمایش متن در یک موقعیت تصادفی، با تغییر به یک موقعیت جدید در هر 30 ثانیه:
.Sp
.Vb 1
\&        drawtext="fontsize=30:fontfile=FreeSerif.ttf:text=\*(Aqhello world\*(Aq:x=if(eq(mod(t\e,30)\e,0)\e,rand(0\e,(w\-text_w))\e,x):y=if(eq(mod(t\e,30)\e,0)\e,rand(0\e,(h\-text_h))\e,y)"
.Ve
.IP \(bu 4
نمایش یک خط متنی در حال لغزش از راست به چپ در آخرین سطر فریم ویدیو.
فرض می‌شود فایل \fILONG_LINE\fR شامل یک سطر تکی
بدون خطوط جدید (newline) است.
.Sp
.Vb 1
\&        drawtext="fontsize=15:fontfile=FreeSerif.ttf:text=LONG_LINE:y=h\-line_h:x=\-50*t"
.Ve
.IP \(bu 4
نمایش محتوای فایل \fICREDITS\fR از زیر فریم و اسکرول به سمت بالا.
.Sp
.Vb 1
\&        drawtext="fontsize=20:fontfile=FreeSerif.ttf:textfile=CREDITS:y=h\-20*t"
.Ve
.IP \(bu 4
رسم یک حرف سبز تکی "g"، در مرکز ویدیوی ورودی.
خط مبنای گلیف در نصف ارتفاع صفحه قرار می‌گیرد.
.Sp
.Vb 1
\&        drawtext="fontsize=60:fontfile=FreeSerif.ttf:fontcolor=green:text=g:x=(w\-max_glyph_w)/2:y=h/2\-ascent"
.Ve
.IP \(bu 4
نمایش متن به مدت 1 ثانیه در هر 3 ثانیه:
.Sp
.Vb 1
\&        drawtext="fontfile=FreeSerif.ttf:fontcolor=white:x=100:y=x/dar:enable=lt(mod(t\e,3)\e,1):text=\*(Aqblink\*(Aq"
.Ve
.IP \(bu 4
استفاده از fontconfig برای تنظیم قلم. توجه داشته باشید که دو‌نقطه‌ها باید گریز داده شوند.
.Sp
.Vb 1
\&        drawtext=\*(Aqfontfile=Linux Libertine O\-40\e\e:style=Semibold:text=FFmpeg\*(Aq
.Ve
.IP \(bu 4
رسم "Test Text" با اندازه قلم وابسته به ارتفاع ویدیو.
.Sp
.Vb 1
\&        drawtext="text=\*(AqTest Text\*(Aq: fontsize=h/30: x=(w\-text_w)/2: y=(h\-text_h*2)"
.Ve
.IP \(bu 4
چاپ تاریخ یک انکود بلادرنگ (مستندات تابع C بنام
\&\f(CW\*(C`strftime\*(C'\fR را ببینید):
.Sp
.Vb 1
\&        drawtext=\*(Aqfontfile=FreeSans.ttf:text=%{localtime\e:%a %b %d %Y}\*(Aq
.Ve
.IP \(bu 4
نمایش محو شدن و پدیدار شدن متن (ظاهر/ناپدید شدن):
.Sp
.Vb 6
\&        #!/bin/sh
\&        DS=1.0 # display start
\&        DE=10.0 # display end
\&        FID=1.5 # fade in duration
\&        FOD=5 # fade out duration
\&        ffplay \-f lavfi "color,drawtext=text=TEST:fontsize=50:fontfile=FreeSerif.ttf:fontcolor_expr=ff0000%{eif\e\e\e\e: clip(255*(1*between(t\e\e, $DS + $FID\e\e, $DE \- $FOD) + ((t \- $DS)/$FID)*between(t\e\e, $DS\e\e, $DS + $FID) + (\-(t \- $DE)/$FOD)*between(t\e\e, $DE \- $FOD\e\e, $DE) )\e\e, 0\e\e, 255) \e\e\e\e: x\e\e\e\e: 2 }"
.Ve
.IP \(bu 4
تراز کردن افقی چندین متن جداگانه. توجه داشته باشید که \fBmax_glyph_a\fR
و مقدار \fBfontsize\fR در آفست \fBy\fR لحاظ شده‌اند.
.Sp
.Vb 2
\&        drawtext=fontfile=FreeSans.ttf:text=DOG:fontsize=24:x=10:y=20+24\-max_glyph_a,
\&        drawtext=fontfile=FreeSans.ttf:text=cow:fontsize=24:x=80:y=20+24\-max_glyph_a
.Ve
.IP \(bu 4
رسم متادیتای ویژه \fIlavf.image2dec.source_basename\fR روی هر فریم در صورت
وجود چنین متادیتایی. در غیر این صورت، رسم رشته "NA". توجه داشته باشید که دیمکسر image2
برای در دسترس بودن فیلدهای متادیتای ویژه برای فیلترها باید دارای گزینه
\&\fB\-export_path_metadata 1\fR باشد.
.Sp
.Vb 1
\&        drawtext="fontsize=20:fontcolor=white:fontfile=FreeSans.ttf:text=\*(Aq%{metadata\e:lavf.image2dec.source_basename\e:NA}\*(Aq:x=10:y=10"
.Ve
.PP
برای اطلاعات بیشتر درباره libfreetype، ببینید:
<\fBhttp://www.freetype.org\fR>.
.PP
برای اطلاعات بیشتر درباره fontconfig، ببینید:
<\fBhttp://freedesktop.org/software/fontconfig/fontconfig\-user.html\fR>.
.PP
برای اطلاعات بیشتر درباره libfribidi، ببینید:
<\fBhttp://fribidi.org\fR>.
.PP
برای اطلاعات بیشتر درباره libharfbuzz، ببینید:
<\fBhttps://github.com/harfbuzz/harfbuzz\fR>.
.SS drawvg
.IX Subsection "drawvg"
رسم گرافیک‌های برداری بر روی فریم‌های ویدیو، از طریق اجرای اسکریپتی نوشته‌شده
به یک زبان سفارشی بنام VGS (\fIVector Graphics Script\fR).
.PP
مستندات این زبان را می‌توان در
\&\fBdrawvg \- Language Reference\fR یافت. نسخه‌ای از این مرجع
همراه با مثال‌های رندرشده در آدرس
<\fBhttps://ayosec.github.io/ffmpeg\-drawvg/playground/docs/langref.html\fR> در دسترس است.
.PP
گرافیک‌ها با استفاده از <\fBhttps://cairographics.org\fR> رندر می‌شوند.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-cairo\*(C'\fR پیکربندی کنید.
.PP
\fIپارامترها (Parameters)\fR
.IX Subsection "Parameters"
.PP
باید یکی از مقادیر \f(CW\*(C`script\*(C'\fR یا \f(CW\*(C`file\*(C'\fR تنظیم شود.
.IP "\fBs, script\fR" 4
.IX Item "s, script"
سورس اسکریپت برای رسم گرافیک‌ها.
.IP \fBfile\fR 4
.IX Item "file"
مسیر فایل برای بارگذاری سورس اسکریپت.
.PP
\fIقالب‌های پیکسلی (Pixel Formats)\fR
.IX Subsection "Pixel Formats"
.PP
از آنجا که Cairo فقط از تصاویر RGB پشتیبانی می‌کند، در صورتی که ویدیوی ورودی قالب دیگری
داشته باشد (مانند YUV 4:2:0)، پیش از اجرای اسکریپت، ویدیو به قالبی سازگار با
Cairo تبدیل می‌شود. سپس باید از فیلتر \fBformat\fR یا
گزینه \f(CW\*(C`\-pix_fmt\*(C'\fR برای تبدیل آن به قالب مورد انتظار در خروجی
استفاده نمایید.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
رسم خط دور یک بیضی:
.Sp
.Vb 4
\&        ffmpeg \-i input.webm \e
\&            \-vf \*(Aqdrawvg=ellipse (w/2) (h/2) (w/3) (h/3) stroke\*(Aq \e
\&            \-pix_fmt yuv420p \e
\&            output.webm
.Ve
.IP \(bu 4
رسم یک مربع در حال چرخش در وسط فریم:
.Sp
اسکریپت مربوط به drawvg در فایل \f(CW\*(C`draw.vgs\*(C'\fR قرار دارد:
.Sp
.Vb 5
\&        translate (w/2) (h/2)
\&        rotate t
\&        rect \-100 \-100 200 200
\&        setcolor red@0.5
\&        fill
.Ve
.Sp
سپس:
.Sp
.Vb 1
\&        ffmpeg \-i input.webm \-vf \*(Aqdrawvg=file=draw.vgs,format=yuv420p\*(Aq output.webm
.Ve
.SS edgedetect
.IX Subsection "edgedetect"
تشخیص و رسم لبه‌ها. این فیلتر از الگوریتم لبه‌یابی کنی (Canny Edge Detection) استفاده می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlow\fR 4
.IX Item "low"
.PD 0
.IP \fBhigh\fR 4
.IX Item "high"
.PD
تنظیم مقادیر آستانه پایین و بالا مورد استفاده توسط الگوریتم آستانه‌گذاری Canny.
.Sp
آستانه بالا پیکسل‌های لبه "قوی" را انتخاب می‌کند، که سپس از طریق اتصال
8 جهته با پیکسل‌های لبه "ضعیف" انتخاب‌شده توسط آستانه پایین مرتبط می‌شوند.
.Sp
مقادیر آستانه \fIlow\fR و \fIhigh\fR باید در محدوده
[0,1] انتخاب شوند، و \fIlow\fR باید کمتر یا مساوی با \fIhigh\fR باشد.
.Sp
مقدار پیش‌فرض برای \fIlow\fR برابر \f(CW\*(C`20/255\*(C'\fR و مقدار پیش‌فرض برای \fIhigh\fR
برابر \f(CW\*(C`50/255\*(C'\fR است.
.IP \fBmode\fR 4
.IX Item "mode"
تعیین حالت رسم.
.RS 4
.IP \fBwires\fR 4
.IX Item "wires"
رسم خطوط سفید/خاکستری بر روی پس‌زمینه سیاه.
.IP \fBcolormix\fR 4
.IX Item "colormix"
ترکیب رنگ‌ها برای ایجاد جلوه نقاشی/کارتونی.
.IP \fBcanny\fR 4
.IX Item "canny"
اعمال لبه‌یاب Canny بر روی تمامی صفحه‌های انتخابی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIwires\fR است.
.RE
.IP \fBplanes\fR 4
.IX Item "planes"
انتخاب صفحه‌ها برای فیلتر کردن. به‌طور پیش‌فرض تمامی صفحه‌های در دسترس فیلتر می‌شوند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
لبه‌یابی استاندارد با مقادیر سفارشی برای آستانه‌گذاری هیسترزیس:
.Sp
.Vb 1
\&        edgedetect=low=0.1:high=0.4
.Ve
.IP \(bu 4
جلوه نقاشی بدون آستانه‌گذاری:
.Sp
.Vb 1
\&        edgedetect=mode=colormix:high=0
.Ve
.SS elbg
.IX Subsection "elbg"
اعمال جلوه پوستر‌سازی (posterize) با استفاده از الگوریتم ELBG (Enhanced LBG).
.PP
برای هر تصویر ورودی، این فیلتر نگاشت بهینه را از ورودی به خروجی با توجه
به طول کتاب‌کد (codebook length)، یعنی تعداد رنگ‌های مجزای خروجی، محاسبه می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBcodebook_length, l\fR" 4
.IX Item "codebook_length, l"
تنظیم طول کتاب‌کد. مقدار باید یک عدد صحیح مثبت باشد و بیانگر
تعداد رنگ‌های مجزای خروجی است. مقدار پیش‌فرض 256 است.
.IP "\fBnb_steps, n\fR" 4
.IX Item "nb_steps, n"
تنظیم حداکثر تعداد تکرارها برای محاسبه نگاشت بهینه.
هرچه مقدار بیشتر باشد نتیجه بهتر و زمان محاسبات بیشتر خواهد بود. مقدار پیش‌فرض 1 است.
.IP "\fBseed, s\fR" 4
.IX Item "seed, s"
تنظیم سید تصادفی، باید یک عدد صحیح در محدوده بین 0 و
UINT32_MAX باشد. در صورت عدم تعیین، یا در صورت تنظیم صریح روی \-1، فیلتر
تلاش می‌کند بر مبنای بهترین تلاش از یک سید تصادفی مناسب استفاده کند.
.IP \fBpal8\fR 4
.IX Item "pal8"
تنظیم قالب پیکسلی خروجی pal8. این گزینه با طول کتاب‌کد
بزرگ‌تر از 256 کار نمی‌کند. پیش‌فرض غیرفعال است.
.IP \fBuse_alpha\fR 4
.IX Item "use_alpha"
گنجاندن مقادیر آلفا در محاسبات کوانتایزیشن. امکان ایجاد
تصاویر خروجی پالت‌دار (مانند PNG8) را با ترکیب روان چندگانه آلفا فراهم می‌سازد.
.SS entropy
.IX Subsection "entropy"
اندازه‌گیری آنتروپی سطح خاکستری در هیستوگرام کانال‌های رنگ فریم‌های ویدیو.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
می‌تواند \fInormal\fR یا \fIdiff\fR باشد. پیش‌فرض \fInormal\fR است.
.Sp
حالت \fIdiff\fR آنتروپی مقادیر دلتای هیستوگرام، یعنی تفاوت‌های مطلق
میان مقادیر هیستوگرام همسایه را اندازه‌گیری می‌کند.
.SS epx
.IX Subsection "epx"
اعمال فیلتر بزرگ‌نمایی EPX که برای هنر پیکسلی (pixel art) طراحی شده است.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم بعد مقیاس‌بندی: \f(CW2\fR برای \f(CW\*(C`2xEPX\*(C'\fR، و \f(CW3\fR برای
\&\f(CW\*(C`3xEPX\*(C'\fR.
پیش‌فرض \f(CW3\fR است.
.SS eq
.IX Subsection "eq"
تنظیم روشنایی، کنتراست، اشباع رنگ و تنظیم تقریبی گاما.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcontrast\fR 4
.IX Item "contrast"
تنظیم عبارت کنتراست. مقدار باید یک عدد ممیز شناور در محدوده
\&\f(CW\-1000.0\fR تا \f(CW1000.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBbrightness\fR 4
.IX Item "brightness"
تنظیم عبارت روشنایی. مقدار باید یک عدد ممیز شناور در
محدوده \f(CW\-1.0\fR تا \f(CW1.0\fR باشد. مقدار پیش‌فرض "0" است.
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم عبارت اشباع رنگ. مقدار باید یک عدد ممیز شناور در
محدوده \f(CW0.0\fR تا \f(CW3.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBgamma\fR 4
.IX Item "gamma"
تنظیم عبارت گاما. مقدار باید یک عدد ممیز شناور در محدوده
\&\f(CW0.1\fR تا \f(CW10.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBgamma_r\fR 4
.IX Item "gamma_r"
تنظیم عبارت گاما برای رنگ قرمز. مقدار باید یک عدد ممیز شناور در
محدوده \f(CW0.1\fR تا \f(CW10.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBgamma_g\fR 4
.IX Item "gamma_g"
تنظیم عبارت گاما برای رنگ سبز. مقدار باید یک عدد ممیز شناور در محدوده
\&\f(CW0.1\fR تا \f(CW10.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBgamma_b\fR 4
.IX Item "gamma_b"
تنظیم عبارت گاما برای رنگ آبی. مقدار باید یک عدد ممیز شناور در محدوده
\&\f(CW0.1\fR تا \f(CW10.0\fR باشد. مقدار پیش‌فرض "1" است.
.IP \fBgamma_weight\fR 4
.IX Item "gamma_weight"
تنظیم عبارت وزن گاما. می‌تواند برای کاهش اثر یک مقدار گامای بالا
بر روی نواحی روشن تصویر به کار رود، برای مثال جلوگیری از
بیش‌از‌حد تقویت شدن آن‌ها و تبدیل شدن به رنگ سفید خالص. مقدار باید یک عدد ممیز شناور
در محدوده \f(CW0.0\fR تا \f(CW1.0\fR باشد. مقدار \f(CW0.0\fR تصحیح
گاما را به‌طور کامل غیرفعال می‌کند در حالی که \f(CW1.0\fR آن را با
قدرت کامل اعمال می‌نماید. پیش‌فرض "1" است.
.IP \fBeval\fR 4
.IX Item "eval"
تعیین زمان ارزیابی عبارات مربوط به روشنایی، کنتراست، اشباع و
گاما.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
ارزیابی عبارات تنها یک بار در طول مقداردهی اولیه فیلتر یا
هنگام پردازش یک دستور
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارات به ازای هر فریم ورودی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.RE
.PP
عبارات پارامترهای زیر را می‌پذیرند:
.IP \fBn\fR 4
.IX Item "n"
شمارنده فریم ورودی با شروع از 0
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت بایتی بسته متناظر در فایل ورودی، اگر مشخص نشده باشد
NAN است؛ منسوخ‌شده، استفاده نکنید
.IP \fBr\fR 4
.IX Item "r"
نرخ فریم ویدیوی ورودی، اگر نرخ فریم ورودی ناشناخته باشد NAN است
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بیان‌شده بر حسب ثانیه، اگر برچسب زمانی ورودی ناشناخته باشد NAN است
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBcontrast\fR 4
.IX Item "contrast"
تنظیم عبارت کنتراست.
.IP \fBbrightness\fR 4
.IX Item "brightness"
تنظیم عبارت روشنایی.
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم عبارت اشباع رنگ.
.IP \fBgamma\fR 4
.IX Item "gamma"
تنظیم عبارت گاما.
.IP \fBgamma_r\fR 4
.IX Item "gamma_r"
تنظیم عبارت gamma_r.
.IP \fBgamma_g\fR 4
.IX Item "gamma_g"
تنظیم عبارت gamma_g.
.IP \fBgamma_b\fR 4
.IX Item "gamma_b"
تنظیم عبارت gamma_b.
.IP \fBgamma_weight\fR 4
.IX Item "gamma_weight"
تنظیم عبارت gamma_weight.
.Sp
این دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن
حفظ می‌شود.
.SS erosion
.IX Subsection "erosion"
اعمال جلوه سایش (erosion) بر روی ویدیو.
.PP
این فیلتر هر پیکسل را با کمینه محلی (3x3) جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن بیشینه تغییر برای هر صفحه (plane)، پیش‌فرض 65535 است.
اگر 0 باشد، صفحه بدون تغییر باقی می‌ماند.
.IP \fBcoordinates\fR 4
.IX Item "coordinates"
پرچمی که پیکسل‌های مورد ارجاع را مشخص می‌کند. پیش‌فرض 255 است، یعنی از تمام هشت
پیکسل استفاده می‌شود.
.Sp
نگاشت پرچم‌ها به مختصات محلی 3x3 به این صورت است:
.Sp
.Vb 3
\&    1 2 3
\&    4   5
\&    6 7 8
.Ve
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به‌عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS estdif
.IX Subsection "estdif"
واسازی (deinterlace) ویدیوی ورودی ("estdif" مخفف "Edge Slope
Tracing Deinterlacing Filter" است).
.PP
فیلتری صرفاً مکانی (spatial) که از الگوریتم ردیابی شیب لبه
برای درون‌یابی خطوط ناموجود استفاده می‌کند.
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت درهم‌بافی مورد نظر. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBframe\fR 4
.IX Item "frame"
خروجی یک فریم به ازای هر فریم.
.IP \fBfield\fR 4
.IX Item "field"
خروجی یک فریم به ازای هر فیلد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`field\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
زوجیت فیلد تصویر که برای ویدیوی درهم‌بافته ورودی فرض می‌شود. یکی
از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtff\fR 4
.IX Item "tff"
فرض می‌کند فیلد بالا اول است.
.IP \fBbff\fR 4
.IX Item "bff"
فرض می‌کند فیلد پایین اول است.
.IP \fBauto\fR 4
.IX Item "auto"
فعال‌سازی تشخیص خودکار زوجیت فیلد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر درهم‌بافی ناشناخته باشد یا دیکودر این اطلاعات را ارائه ندهد،
فیلد بالا به عنوان فیلد اول فرض خواهد شد.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین فریم‌هایی که باید واسازی شوند. یکی از مقادیر
زیر را می‌پذیرد:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
واسازی تمامی فریم‌ها.
.IP \fBinterlaced\fR 4
.IX Item "interlaced"
تنها واسازی فریم‌هایی که به عنوان درهم‌بافته علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.IP \fBrslope\fR 4
.IX Item "rslope"
تعیین شعاع جستجو برای ردیابی شیب لبه. مقدار پیش‌فرض 1 است.
محدوده مجاز از 1 تا 15 است.
.IP \fBredge\fR 4
.IX Item "redge"
تعیین شعاع جستجو برای بهترین تطبیق لبه. مقدار پیش‌فرض 2 است.
محدوده مجاز از 0 تا 15 است.
.IP \fBecost\fR 4
.IX Item "ecost"
تعیین هزینه لبه برای تطبیق لبه. مقدار پیش‌فرض 2 است.
محدوده مجاز از 0 تا 50 است.
.IP \fBmcost\fR 4
.IX Item "mcost"
تعیین هزینه میانی برای تطبیق لبه. مقدار پیش‌فرض 1 است.
محدوده مجاز از 0 تا 50 است.
.IP \fBdcost\fR 4
.IX Item "dcost"
تعیین هزینه فاصله برای تطبیق لبه. مقدار پیش‌فرض 1 است.
محدوده مجاز از 0 تا 50 است.
.IP \fBinterp\fR 4
.IX Item "interp"
تعیین درون‌یابی مورد استفاده. پیش‌فرض درون‌یابی 4 نقطه‌ای است. یکی
از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fB2p\fR 4
.IX Item "2p"
درون‌یابی دو نقطه‌ای.
.IP \fB4p\fR 4
.IX Item "4p"
درون‌یابی چهار نقطه‌ای.
.IP \fB6p\fR 4
.IX Item "6p"
درون‌یابی شش نقطه‌ای.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS exposure
.IX Subsection "exposure"
تنظیم نوردهی (exposure) جریان ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBexposure\fR 4
.IX Item "exposure"
تنظیم تصحیح نوردهی بر حسب EV. محدوده مجاز از \-3.0 تا 3.0 EV است.
مقدار پیش‌فرض 0 EV است.
.IP \fBblack\fR 4
.IX Item "black"
تنظیم تصحیح سطح سیاهی (black level). محدوده مجاز از \-1.0 تا 1.0 است.
مقدار پیش‌فرض 0 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS extractplanes
.IX Subsection "extractplanes"
استخراج مؤلفه‌های کانال رنگ از جریان ویدیوی ورودی به
جریان‌های ویدیویی خاکستری (grayscale) جداگانه.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه(ها) جهت استخراج.
.Sp
مقادیر مجاز برای planes عبارتند از:
.RS 4
.IP \fBy\fR 4
.IX Item "y"
.PD 0
.IP \fBu\fR 4
.IX Item "u"
.IP \fBv\fR 4
.IX Item "v"
.IP \fBa\fR 4
.IX Item "a"
.IP \fBr\fR 4
.IX Item "r"
.IP \fBg\fR 4
.IX Item "g"
.IP \fBb\fR 4
.IX Item "b"
.PD
.RE
.RS 4
.Sp
انتخاب صفحه‌هایی که در ورودی موجود نیستند منجر به بروز خطا خواهد شد.
این بدان معناست که نمی‌توانید صفحه‌های \f(CW\*(C`r\*(C'\fR، \f(CW\*(C`g\*(C'\fR، \f(CW\*(C`b\*(C'\fR را
همزمان با صفحه‌های \f(CW\*(C`y\*(C'\fR، \f(CW\*(C`u\*(C'\fR، \f(CW\*(C`v\*(C'\fR انتخاب نمایید.
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
استخراج مؤلفه‌های کانال رنگ روشنایی (luma)، u و v از فریم ویدیوی ورودی
به 3 خروجی خاکستری:
.Sp
.Vb 1
\&        ffmpeg \-i video.avi \-filter_complex \*(Aqextractplanes=y+u+v[y][u][v]\*(Aq \-map \*(Aq[y]\*(Aq y.avi \-map \*(Aq[u]\*(Aq u.avi \-map \*(Aq[v]\*(Aq v.avi
.Ve
.SS fade
.IX Subsection "fade"
اعمال جلوه محوشدگی تدریجی (fade\-in/out) به ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBtype, t\fR" 4
.IX Item "type, t"
نوع جلوه می‌تواند "in" برای محوشدگی به داخل (fade\-in)، یا "out" برای محوشدگی
به خارج (fade\-out) باشد.
پیش‌فرض \f(CW\*(C`in\*(C'\fR است.
.IP "\fBstart_frame, s\fR" 4
.IX Item "start_frame, s"
تعیین شماره فریمی که اعمال جلوه محوشدگی
از آن آغاز می‌شود. پیش‌فرض 0 است.
.IP "\fBnb_frames, n\fR" 4
.IX Item "nb_frames, n"
تعداد فریم‌هایی که جلوه محوشدگی طول می‌کشد. در پایان
جلوه fade\-in، ویدیوی خروجی شدت یکسانی با ویدیوی ورودی خواهد داشت.
در پایان گذار fade\-out، ویدیوی خروجی با \fBcolor\fR
انتخابی پر خواهد شد.
پیش‌فرض 25 است.
.IP \fBalpha\fR 4
.IX Item "alpha"
اگر روی 1 تنظیم شود، تنها کانال آلفا محو می‌شود (در صورتی که در ورودی وجود داشته باشد).
مقدار پیش‌فرض 0 است.
.IP "\fBstart_time, st\fR" 4
.IX Item "start_time, st"
تعیین برچسب زمانی (بر حسب ثانیه) فریمی که اعمال جلوه محوشدگی
از آن آغاز می‌شود. اگر هر دو مقدار start_frame و start_time مشخص شوند، محوشدگی در
هر کدام که دیرتر بیاید آغاز خواهد شد. پیش‌فرض 0 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تعداد ثانیه‌هایی که جلوه محوشدگی باید ادامه یابد. در پایان
جلوه fade\-in ویدیوی خروجی شدت یکسانی با ویدیوی ورودی خواهد داشت،
در پایان گذار fade\-out ویدیوی خروجی با \fBcolor\fR
انتخابی پر خواهد شد.
اگر هر دو پارامتر duration و nb_frames مشخص شوند، duration استفاده می‌شود. پیش‌فرض 0 است
(به‌طور پیش‌فرض از nb_frames استفاده می‌شود).
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
تعیین رنگ محوشدگی. پیش‌فرض "black" (سیاه) است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال fade in بر روی 30 فریم اول ویدیو:
.Sp
.Vb 1
\&        fade=in:0:30
.Ve
.Sp
دستور فوق معادل است با:
.Sp
.Vb 1
\&        fade=t=in:s=0:n=30
.Ve
.IP \(bu 4
اعمال fade out بر روی 45 فریم پایانی یک ویدیوی 200 فریمی:
.Sp
.Vb 2
\&        fade=out:155:45
\&        fade=type=out:start_frame=155:nb_frames=45
.Ve
.IP \(bu 4
اعمال fade in بر روی 25 فریم اول و fade out بر روی 25 فریم پایانی یک ویدیوی 1000 فریمی:
.Sp
.Vb 1
\&        fade=in:0:25, fade=out:975:25
.Ve
.IP \(bu 4
زرد کردن 5 فریم اول، سپس اعمال fade in از فریم 5 تا 24:
.Sp
.Vb 1
\&        fade=in:5:20:color=yellow
.Ve
.IP \(bu 4
اعمال fade in بر روی آلفا در طول 25 فریم اول ویدیو:
.Sp
.Vb 1
\&        fade=in:0:25:alpha=1
.Ve
.IP \(bu 4
سیاه کردن 5.5 ثانیه اول، سپس اعمال fade in به مدت 0.5 ثانیه:
.Sp
.Vb 1
\&        fade=t=in:st=5.5:d=0.5
.Ve
.SS feedback
.IX Subsection "feedback"
اعمال فیلتر ویدیویی فیدبک (بازخورد).
.PP
این فیلتر فریم‌های ورودی برش‌خورده را به خروجی دوم ارسال می‌کند.
از آنجا می‌توان آن را با سایر فیلترهای ویدیو فیلتر کرد.
پس از اینکه فیلتر فریم را از ورودی دوم دریافت کرد، آن فریم
روی فریم اصلی ورودی اول ترکیب شده و به خروجی اول
فرستاده می‌شود.
.PP
کاربرد متداول آن، فیلتر کردن تنها بخشی از فریم است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم موقعیت گوشه بالا سمت چپ برش.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم اندازه برش.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
مات کردن تنها بخش مستطیلی بالا سمت چپ فریم ویدیو با اندازه 100x100 با فیلتر gblur:
.Sp
.Vb 1
\&        [in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]gblur=8[blurin]
.Ve
.IP \(bu 4
ترسیم کادر سیاه روی بخش بالا سمت چپ فریم ویدیو با اندازه 100x100 با فیلتر drawbox:
.Sp
.Vb 1
\&        [in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]drawbox=x=0:y=0:w=100:h=100:t=100[blurin]
.Ve
.IP \(bu 4
پیکسلی کردن بخش مستطیلی فریم ویدیو با اندازه 100x100 با فیلتر pixelize:
.Sp
.Vb 1
\&        [in][blurin]feedback=x=320:y=240:w=100:h=100[out][blurout];[blurout]pixelize[blurin]
.Ve
.SS fftdnoiz
.IX Subsection "fftdnoiz"
نویززدایی فریم‌ها با استفاده از FFT سه‌بعدی (فیلترسازی در حوزه فرکانس).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم ثابت سیگمای نویز. این گزینه قدرت نویززدایی را تعیین می‌کند.
مقدار پیش‌فرض 1 است. محدوده مجاز از 0 تا 30 است.
استفاده از مقدار سیگمای بسیار بالا همراه با همپوشانی کم ممکن است باعث ایجاد مصنوعات بلوکی (blocking artifacts) شود.
.IP \fBamount\fR 4
.IX Item "amount"
تنظیم میزان نویززدایی. به‌طور پیش‌فرض تمامی نویزهای شناسایی‌شده کاهش می‌یابند.
مقدار پیش‌فرض 1 است. محدوده مجاز از 0 تا 1 است.
.IP \fBblock\fR 4
.IX Item "block"
تنظیم اندازه بلوک بر حسب پیکسل، پیش‌فرض 32 است، می‌تواند از 8 تا 256 باشد.
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم همپوشانی بلوک‌ها. پیش‌فرض 0.5 است. محدوده مجاز از 0.2 تا 0.8 است.
.IP \fBmethod\fR 4
.IX Item "method"
تنظیم روش نویززدایی. پیش‌فرض \f(CW\*(C`wiener\*(C'\fR است، همچنین می‌تواند \f(CW\*(C`hard\*(C'\fR باشد.
.IP \fBprev\fR 4
.IX Item "prev"
تنظیم تعداد فریم‌های پیشین مورد استفاده برای نویززدایی. به‌طور پیش‌فرض روی 0 تنظیم شده است.
.IP \fBnext\fR 4
.IX Item "next"
تنظیم تعداد فریم‌های بعدی مورد استفاده برای نویززدایی. به‌طور پیش‌فرض روی 0 تنظیم شده است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه‌هایی که فیلتر خواهند شد، به‌طور پیش‌فرض تمامی صفحه‌های موجود به جز
آلفا فیلتر می‌شوند.
.SS fftfilt
.IX Subsection "fftfilt"
اعمال عبارات دلخواه بر روی نمونه‌ها در حوزه فرکانس
.IP \fBdc_Y\fR 4
.IX Item "dc_Y"
تنظیم مقدار dc (بهره) صفحه روشنایی (luma) تصویر. فیلتر
یک مقدار صحیح در محدوده \f(CW0\fR تا \f(CW1000\fR را می‌پذیرد. مقدار
پیش‌فرض روی \f(CW0\fR تنظیم شده است.
.IP \fBdc_U\fR 4
.IX Item "dc_U"
تنظیم مقدار dc (بهره) اولین صفحه کرومای تصویر. فیلتر
یک مقدار صحیح در محدوده \f(CW0\fR تا \f(CW1000\fR را می‌پذیرد. مقدار
پیش‌فرض روی \f(CW0\fR تنظیم شده است.
.IP \fBdc_V\fR 4
.IX Item "dc_V"
تنظیم مقدار dc (بهره) دومین صفحه کرومای تصویر. فیلتر
یک مقدار صحیح در محدوده \f(CW0\fR تا \f(CW1000\fR را می‌پذیرد. مقدار
پیش‌فرض روی \f(CW0\fR تنظیم شده است.
.IP \fBweight_Y\fR 4
.IX Item "weight_Y"
تنظیم عبارت وزن در حوزه فرکانس برای صفحه روشنایی (luma).
.IP \fBweight_U\fR 4
.IX Item "weight_U"
تنظیم عبارت وزن در حوزه فرکانس برای اولین صفحه کروما.
.IP \fBweight_V\fR 4
.IX Item "weight_V"
تنظیم عبارت وزن در حوزه فرکانس برای دومین صفحه کروما.
.IP \fBeval\fR 4
.IX Item "eval"
تعیین زمان ارزیابی عبارات.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
ارزیابی عبارات تنها یک بار در طول مقداردهی اولیه فیلتر.
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارات به ازای هر فریم ورودی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.Sp
این فیلتر متغیرهای زیر را می‌پذیرد:
.RE
.IP \fBX\fR 4
.IX Item "X"
.PD 0
.IP \fBY\fR 4
.IX Item "Y"
.PD
مختصات نمونه فعلی.
.IP \fBW\fR 4
.IX Item "W"
.PD 0
.IP \fBH\fR 4
.IX Item "H"
.PD
عرض و ارتفاع تصویر.
.IP \fBN\fR 4
.IX Item "N"
شماره فریم ورودی، شروع از 0.
.IP \fBWS\fR 4
.IX Item "WS"
.PD 0
.IP \fBHS\fR 4
.IX Item "HS"
.PD
اندازه آرایه FFT برای پردازش افقی و عمودی.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
بالاگذر (High\-pass):
.Sp
.Vb 1
\&        fftfilt=dc_Y=128:weight_Y=\*(Aqsquish(1\-(Y+X)/100)\*(Aq
.Ve
.IP \(bu 4
پایین‌گذر (Low\-pass):
.Sp
.Vb 1
\&        fftfilt=dc_Y=0:weight_Y=\*(Aqsquish((Y+X)/100\-1)\*(Aq
.Ve
.IP \(bu 4
واضح‌سازی (Sharpen):
.Sp
.Vb 1
\&        fftfilt=dc_Y=0:weight_Y=\*(Aq1+squish(1\-(Y+X)/100)\*(Aq
.Ve
.IP \(bu 4
تاری (Blur):
.Sp
.Vb 1
\&        fftfilt=dc_Y=0:weight_Y=\*(Aqexp(\-4 * ((Y+X)/(W+H)))\*(Aq
.Ve
.SS field
.IX Subsection "field"
استخراج یک فیلد تکی از یک تصویر درهم‌بافته با استفاده از محاسبات گام (stride arithmetic)
برای جلوگیری از هدر رفتن زمان پردازنده (CPU). فریم‌های خروجی به عنوان
غیر درهم‌بافته علامت‌گذاری می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtype\fR 4
.IX Item "type"
مشخص می‌کند که فیلد بالا استخراج شود (اگر مقدار \f(CW0\fR یا
\&\f(CW\*(C`top\*(C'\fR باشد) یا فیلد پایین (اگر مقدار \f(CW1\fR یا
\&\f(CW\*(C`bottom\*(C'\fR باشد).
.SS fieldhint
.IX Subsection "fieldhint"
ایجاد فریم‌های جدید با کپی کردن فیلدهای بالا و پایین از فریم‌های اطراف
ارائه‌شده به عنوان اعداد توسط فایل راهنما (hint).
.IP \fBhint\fR 4
.IX Item "hint"
تنظیم فایل حاوی راهنماها: شماره فریم‌های مطلق/نسبی.
.Sp
باید به ازای هر فریم در یک کلیپ، یک سطر وجود داشته باشد. هر سطر باید حاوی دو
عدد جداشده با ویرگول باشد، که احتمالاً به دنبال آن‌ها \f(CW\*(C`\-\*(C'\fR یا \f(CW\*(C`+\*(C'\fR می‌آید.
اعداد ارائه‌شده در هر سطر فایل نمی‌توانند خارج از [N\-1,N+1] باشند که در آن N
شماره فریم فعلی برای حالت \f(CW\*(C`absolute\*(C'\fR است، یا خارج از محدوده [\-1, 1]
برای حالت \f(CW\*(C`relative\*(C'\fR. عدد اول مشخص می‌کند که فیلد بالا از کدام فریم برداشته شود
و عدد دوم مشخص می‌کند که فیلد پایین از کدام فریم برداشته شود.
.Sp
اگر با \f(CW\*(C`+\*(C'\fR اختیاری دنبال شود، فریم خروجی به عنوان درهم‌بافته علامت‌گذاری خواهد شد،
وگرنه اگر با \f(CW\*(C`\-\*(C'\fR دنبال شود، فریم خروجی به عنوان پیش‌رونده علامت‌گذاری می‌شود، و در غیر این صورت
مانند فریم ورودی علامت‌گذاری خواهد شد.
اگر با \f(CW\*(C`t\*(C'\fR اختیاری دنبال شود، فریم خروجی تنها از فیلد بالا استفاده می‌کند، یا در
صورت وجود \f(CW\*(C`b\*(C'\fR تنها از فیلد پایین استفاده خواهد کرد.
اگر سطری با \f(CW\*(C`#\*(C'\fR یا \f(CW\*(C`;\*(C'\fR شروع شود، آن سطر نادیده گرفته می‌شود.
.IP \fBmode\fR 4
.IX Item "mode"
می‌تواند \f(CW\*(C`absolute\*(C'\fR یا \f(CW\*(C`relative\*(C'\fR یا \f(CW\*(C`pattern\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`absolute\*(C'\fR است.
حالت \f(CW\*(C`pattern\*(C'\fR همانند حالت \f(CW\*(C`relative\*(C'\fR است، به جز اینکه در آخرین ورودی فایل اگر
فریم‌های بیشتری برای پردازش وجود داشته باشند، فایل \f(CW\*(C`hint\*(C'\fR به نقطه شروع بازگردانده می‌شود.
.PP
مثالی از چند سطر اول فایل \f(CW\*(C`hint\*(C'\fR برای حالت \f(CW\*(C`relative\*(C'\fR:
.PP
.Vb 10
\&        0,0 \- # first frame
\&        1,0 \- # second frame, use third\*(Aqs frame top field and second\*(Aqs frame bottom field
\&        1,0 \- # third frame, use fourth\*(Aqs frame top field and third\*(Aqs frame bottom field
\&        1,0 \-
\&        0,0 \-
\&        0,0 \-
\&        1,0 \-
\&        1,0 \-
\&        1,0 \-
\&        0,0 \-
\&        0,0 \-
\&        1,0 \-
\&        1,0 \-
\&        1,0 \-
\&        0,0 \-
.Ve
.SS fieldmatch
.IX Subsection "fieldmatch"
فیلتر تطبیق فیلد برای تله‌سین معکوس (inverse telecine). هدف آن بازسازی
فریم‌های پیش‌رونده (progressive) از یک جریان تله‌سین‌شده است. این فیلتر فریم‌های تکراری
را حذف نمی‌کند، بنابراین برای دستیابی به یک تله‌سین معکوس کامل، \f(CW\*(C`fieldmatch\*(C'\fR باید با یک
فیلتر کاهش فریم (decimation) مانند \fBdecimate\fR در گراف فیلتر دنبال شود.
.PP
تفکیک تطبیق فیلد و کاهش فریم عمدتاً به دلیل امکان
قرار دادن یک فیلتر واسازی (de\-interlacing) جایگزین (fallback) بین این دو است.
اگر منبع دارای محتوای ترکیبی تله‌سین‌شده و درهم‌بافته واقعی باشد،
\&\f(CW\*(C`fieldmatch\*(C'\fR قادر به تطبیق فیلدها برای بخش‌های درهم‌بافته نخواهد بود.
اما این فریم‌های شانه‌ای‌شکل (combed) باقی‌مانده به عنوان درهم‌بافته علامت‌گذاری می‌شوند، و بدین ترتیب می‌توانند
پیش از اعمال decimation، توسط فیلتری پس از آن مانند \fByadif\fR واسازی شوند.
.PP
علاوه بر گزینه‌های مختلف پیکربندی، \f(CW\*(C`fieldmatch\*(C'\fR می‌تواند یک
جریان دوم اختیاری را نیز بپذیرد که از طریق گزینه \fBppsrc\fR فعال می‌شود. در صورت
فعال بودن، بازسازی فریم‌ها بر اساس فیلدها و فریم‌های
این جریان دوم خواهد بود. این ویژگی امکان پیش‌پردازش ورودی اول را به منظور
کمک به الگوریتم‌های مختلف فیلتر فراهم می‌سازد، در حالی که خروجی بدون اتلاف باقی می‌ماند
(با فرض تطبیق مناسب فیلدها). به‌طور معمول، یک نویززدای آگاه از فیلد،
یا تنظیمات روشنایی/کنتراست می‌توانند کمک‌کننده باشند.
.PP
توجه داشته باشید که این فیلتر از همان الگوریتم‌های TIVTC/TFM (پروژه AviSynth)
و VIVTC/VFM (پروژه VapourSynth) استفاده می‌کند. دومی یک کلون سبک از TFM است
که \f(CW\*(C`fieldmatch\*(C'\fR بر اساس آن ساخته شده است. اگرچه معناشناسی و کاربرد آن‌ها بسیار
نزدیک است، اما برخی رفتارها و نام گزینه‌ها می‌توانند متفاوت باشند.
.PP
فیلتر \fBdecimate\fR در حال حاضر فقط برای ورودی با نرخ فریم ثابت (CFR) کار می‌کند.
اگر ورودی شما دارای محتوای ترکیبی تله‌سین‌شده (30fps) و پیش‌رونده با نرخ فریم
پایین‌تر مانند 24fps است، از زنجیره فیلتر زیر برای تولید جریان cfr مورد نیاز
استفاده کنید: \f(CW\*(C`dejudder,fps=30000/1001,fieldmatch,decimate\*(C'\fR.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBorder\fR 4
.IX Item "order"
تعیین ترتیب فیلد فرضی جریان ورودی. مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
تشخیص خودکار زوجیت (استفاده از مقدار زوجیت داخلی FFmpeg).
.IP \fBbff\fR 4
.IX Item "bff"
فرض فیلد پایین اول است.
.IP \fBtff\fR 4
.IX Item "tff"
فرض فیلد بالا اول است.
.RE
.RS 4
.Sp
توجه داشته باشید که گاهی توصیه می‌شود به زوجیت اعلام‌شده توسط
جریان اعتماد نکنید.
.Sp
مقدار پیش‌فرض \fIauto\fR است.
.RE
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت یا راهبرد تطبیق مورد استفاده. حالت \fBpc\fR ایمن‌ترین حالت است از این
نظر که تا حد امکان خطر ایجاد لرزش ناشی از فریم‌های تکراری را در پی ندارد،
اما اگر ویرایش‌های بد یا فیلدهای ترکیبی (blended) وجود داشته باشد، در نهایت منجر به
تولید فریم‌های شانه‌ای می‌شود در حالی که ممکن است یک تطبیق خوب واقعاً وجود داشته باشد. از سوی
دیگر، حالت \fBpcn_ub\fR از نظر ایجاد لرزش پرخطرترین است،
اما تقریباً همیشه در صورت وجود یک فریم خوب، آن را خواهد یافت. مقادیر دیگر
از نظر خطر ایجاد لرزش و تولید فریم‌های تکراری در برابر یافتن تطبیق‌های خوب در بخش‌هایی
با ویرایش‌های بد، فیلدهای تنهاافتاده، فیلدهای ترکیبی و غیره همگی در نقطه‌ای میان \fBpc\fR و \fBpcn_ub\fR قرار دارند.
.Sp
جزئیات بیشتر درباره p/c/n/u/b در بخش \fBمفهوم p/c/n/u/b\fR در دسترس است.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBpc\fR 4
.IX Item "pc"
تطبیق 2 جهته (p/c)
.IP \fBpc_n\fR 4
.IX Item "pc_n"
تطبیق 2 جهته، و تلاش برای تطبیق 3‌ام در صورت باقی ماندن حالت شانه‌ای (p/c + n)
.IP \fBpc_u\fR 4
.IX Item "pc_u"
تطبیق 2 جهته، و تلاش برای تطبیق 3‌ام (همان ترتیب) در صورت باقی ماندن حالت شانه‌ای (p/c + u)
.IP \fBpc_n_ub\fR 4
.IX Item "pc_n_ub"
تطبیق 2 جهته، تلاش برای تطبیق 3‌ام در صورت باقی ماندن حالت شانه‌ای، و تلاش برای تطبیق‌های 4‌ام/5‌ام در
صورت ادامه حالت شانه‌ای (p/c + n + u/b)
.IP \fBpcn\fR 4
.IX Item "pcn"
تطبیق 3 جهته (p/c/n)
.IP \fBpcn_ub\fR 4
.IX Item "pcn_ub"
تطبیق 3 جهته، و تلاش برای تطبیق‌های 4‌ام/5‌ام در صورتی که هر 3 تطبیق اولیه
به عنوان شانه‌ای تشخیص داده شوند (p/c/n + u/b)
.RE
.RS 4
.Sp
پرانتزهای انتهایی نشان‌دهنده تطبیق‌هایی هستند که با فرض \fBorder\fR=\fItff\fR (و \fBfield\fR روی \fIauto\fR یا
\&\fItop\fR) برای آن حالت استفاده می‌شوند.
.Sp
از نظر سرعت، حالت \fBpc\fR تا حد زیادی سریع‌ترین و \fBpcn_ub\fR
کندترین حالت است.
.Sp
مقدار پیش‌فرض \fIpc_n\fR است.
.RE
.IP \fBppsrc\fR 4
.IX Item "ppsrc"
علامت‌گذاری جریان ورودی اصلی به عنوان یک ورودی پیش‌پردازش‌شده، و فعال‌سازی جریان ورودی ثانویه
به عنوان منبع تمیز جهت انتخاب فیلدها از آن. برای جزئیات بیشتر به بخش مقدمه فیلتر
مراجعه کنید. این گزینه شبیه به قابلیت \fBclip2\fR از
VFM/TFM است.
.Sp
مقدار پیش‌فرض \f(CW0\fR (غیرفعال) است.
.IP \fBfield\fR 4
.IX Item "field"
تنظیم فیلدی که تطبیق از آن انجام می‌گیرد. توصیه می‌شود این گزینه روی مقداری مشابه
\&\fBorder\fR تنظیم شود مگر اینکه با آن تنظیم دچار شکست در تطبیق شوید. در
شرایط خاص، تغییر فیلدی که تطبیق از آن صورت می‌گیرد می‌تواند
تأثیر بسزایی بر کارایی تطبیق داشته باشد. مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
خودکار (همان مقدار \fBorder\fR).
.IP \fBbottom\fR 4
.IX Item "bottom"
تطبیق از فیلد پایین.
.IP \fBtop\fR 4
.IX Item "top"
تطبیق از فیلد بالا.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIauto\fR است.
.RE
.IP \fBmchroma\fR 4
.IX Item "mchroma"
تعیین اینکه آیا کروما در طول مقایسه‌های تطبیق لحاظ شود یا خیر. در بیشتر
موارد توصیه می‌شود این گزینه فعال باقی بماند. تنها در صورتی باید این گزینه را روی \f(CW0\fR
تنظیم کنید که کلیپ شما مشکلات شدید کروما مانند رنگین‌کمانی شدید یا سایر
مصنوعات را داشته باشد. تنظیم این مقدار روی \f(CW0\fR می‌تواند برای بالا بردن سرعت
به بهای از دست رفتن مقداری دقت نیز استفاده شود.
.Sp
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBy0\fR 4
.IX Item "y0"
.PD 0
.IP \fBy1\fR 4
.IX Item "y1"
.PD
این گزینه‌ها یک باند محرومیت (exclusion band) تعریف می‌کنند که سطرهای بین \fBy0\fR و
\&\fBy1\fR را از شرکت در تصمیم‌گیری تطبیق فیلد مستثنی می‌کند. یک باند
محرومیت می‌تواند برای نادیده گرفتن زیرنویس‌ها، لوگو، یا سایر مواردی که ممکن است
در تطبیق اختلال ایجاد کنند استفاده شود. \fBy0\fR سطر اسکن شروع و
\&\fBy1\fR سطر پایان را تنظیم می‌کند؛ تمامی سطرهای میان \fBy0\fR و
\&\fBy1\fR (شامل خود \fBy0\fR و \fBy1\fR) نادیده گرفته خواهند شد. تنظیم
\&\fBy0\fR و \fBy1\fR روی مقداری یکسان، این قابلیت را غیرفعال می‌کند.
مقادیر پیش‌فرض \fBy0\fR و \fBy1\fR برابر \f(CW0\fR است.
.IP \fBscthresh\fR 4
.IX Item "scthresh"
تنظیم آستانه تشخیص تغییر صحنه به عنوان درصدی از حداکثر تغییر در
صفحه روشنایی (luma). مقادیر مناسب در محدوده \f(CW\*(C`[8.0, 14.0]\*(C'\fR قرار دارند. تشخیص تغییر
صحنه تنها در صورت \fBcombmatch\fR=\fIsc\fR مرتبط است. محدوده مجاز برای
\&\fBscthresh\fR برابر \f(CW\*(C`[0.0, 100.0]\*(C'\fR است.
.Sp
مقدار پیش‌فرض \f(CW12.0\fR است.
.IP \fBcombmatch\fR 4
.IX Item "combmatch"
هنگامی که \fBcombmatch\fR روی \fInone\fR نباشد، \f(CW\*(C`fieldmatch\*(C'\fR هنگام
تصمیم‌گیری درباره انتخاب تطبیق نهایی، امتیازهای شانه‌ای (combed scores) تطبیق‌ها را
لحاظ خواهد کرد. مقادیر موجود عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
عدم تطبیق نهایی بر اساس امتیازهای شانه‌ای.
.IP \fBsc\fR 4
.IX Item "sc"
امتیازهای شانه‌ای تنها هنگام تشخیص تغییر صحنه استفاده می‌شوند.
.IP \fBfull\fR 4
.IX Item "full"
استفاده همیشگی از امتیازهای شانه‌ای.
.RE
.RS 4
.Sp
پیش‌فرض \fIsc\fR است.
.RE
.IP \fBcombdbg\fR 4
.IX Item "combdbg"
اجبار \f(CW\*(C`fieldmatch\*(C'\fR به محاسبه معیارهای شانه‌ای برای تطبیق‌های خاص و
چاپ آن‌ها. این تنظیم در واژگان TFM/VFM با عنوان \fBmicout\fR شناخته می‌شود.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
بدون محاسبه اجباری.
.IP \fBpcn\fR 4
.IX Item "pcn"
اجبار محاسبات p/c/n.
.IP \fBpcnub\fR 4
.IX Item "pcnub"
اجبار محاسبات p/c/n/u/b.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fInone\fR است.
.RE
.IP \fBcthresh\fR 4
.IX Item "cthresh"
این آستانه حالت شانه‌ای مساحت مورد استفاده برای تشخیص فریم‌های شانه‌ای است. این گزینه
اساساً کنترل می‌کند که حالت شانه‌ای چقدر باید "قوی" یا "نمایان" باشد تا تشخیص داده شود.
مقادیر بزرگ‌تر به این معناست که حالت شانه‌ای باید نمایان‌تر باشد و مقادیر کوچک‌تر به این معناست که حالت شانه‌ای
می‌تواند کمتر نمایان یا قوی باشد و همچنان تشخیص داده شود. تنظیمات معتبر از
\&\f(CW\-1\fR (هر پیکسل به عنوان شانه‌ای تشخیص داده می‌شود) تا \f(CW255\fR (هیچ پیکسلی
به عنوان شانه‌ای تشخیص داده نمی‌شود) است. این اساساً یک مقدار اختلاف پیکسلی است. یک محدوده
مناسب \f(CW\*(C`[8, 12]\*(C'\fR است.
.Sp
مقدار پیش‌فرض \f(CW9\fR است.
.IP \fBchroma\fR 4
.IX Item "chroma"
تعیین اینکه آیا کروما در تصمیم‌گیری فریم شانه‌ای لحاظ شود یا خیر. این گزینه را
تنها در صورتی غیرفعال کنید که منبع شما مشکلات کروما (رنگین‌کمانی و غیره) داشته باشد که
در صورت فعال بودن کروما باعث بروز مشکل در تشخیص فریم شانه‌ای شوند. در واقع،
استفاده از \fBchroma\fR=\fI0\fR معمولاً قابل‌اعتمادتر است، مگر در حالتی
که در منبع حالت شانه‌ای فقط در کروما وجود داشته باشد.
.Sp
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBblockx\fR 4
.IX Item "blockx"
.PD 0
.IP \fBblocky\fR 4
.IX Item "blocky"
.PD
به ترتیب اندازه ابعاد پنجره مورد استفاده در طول تشخیص فریم شانه‌ای در راستای
محور x و محور y را تنظیم می‌کنند. این به اندازه ناحیه‌ای مربوط می‌شود که در آن
لازم است پیکسل‌های \fBcombpel\fR به عنوان شانه‌ای تشخیص داده شوند تا یک فریم
به عنوان شانه‌ای اعلام شود. برای اطلاعات بیشتر به توضیحات پارامتر \fBcombpel\fR مراجعه کنید.
مقادیر ممکن هر عددی از توان‌های 2 است که با 4 شروع شده و
تا 512 ادامه می‌یابد.
.Sp
مقدار پیش‌فرض \f(CW16\fR است.
.IP \fBcombpel\fR 4
.IX Item "combpel"
تعداد پیکسل‌های شانه‌ای درون هر یک از بلوک‌های با ابعاد \fBblocky\fR در
\&\fBblockx\fR روی فریم تا فریم به عنوان شانه‌ای تشخیص
داده شود. در حالی که \fBcthresh\fR میزان "نمایان بودن" حالت شانه‌ای را کنترل می‌کند، این
تنظیم کنترل می‌کند که "چه مقدار" حالت شانه‌ای باید در هر ناحیه محلی (پنجره‌ای
تعریف‌شده توسط تنظیمات \fBblockx\fR و \fBblocky\fR) روی فریم وجود داشته باشد.
حداقل مقدار \f(CW0\fR و حداکثر مقدار \f(CW\*(C`blocky x blockx\*(C'\fR است (که در آن
نقطه هیچ فریمی هرگز به عنوان شانه‌ای تشخیص داده نخواهد شد). این تنظیم در واژگان
TFM/VFM با عنوان \fBMI\fR شناخته می‌شود.
.Sp
مقدار پیش‌فرض \f(CW80\fR است.
.PP
\fIمفهوم p/c/n/u/b\fR
.IX Subsection "p/c/n/u/b meaning"
.PP
p/c/n
.IX Subsection "p/c/n"
.PP
جریان تله‌سین‌شده زیر را فرض می‌کنیم:
.PP
.Vb 2
\&        Top fields:     1 2 2 3 4
\&        Bottom fields:  1 2 3 4 4
.Ve
.PP
اعداد با فریم پیش‌رونده‌ای که فیلدها به آن مربوط می‌شوند مطابقت دارند. در اینجا،
دو فریم اول پیش‌رونده هستند، فریم‌های ۳ و ۴ شانه‌ای هستند، و به همین ترتیب.
.PP
هنگامی که \f(CW\*(C`fieldmatch\*(C'\fR پیکربندی می‌شود تا تطبیقی را از فیلد پایین
اجرا کند (\fBfield\fR=\fIbottom\fR)، این جریان ورودی به این صورت تبدیل می‌شود:
.PP
.Vb 3
\&        Input stream:
\&                        T     1 2 2 3 4
\&                        B     1 2 3 4 4   <\-\- matching reference
\&        
\&        Matches:              c c n n c
\&        
\&        Output stream:
\&                        T     1 2 3 4 4
\&                        B     1 2 3 4 4
.Ve
.PP
در نتیجه تطبیق فیلد، مشاهده می‌کنیم که برخی فریم‌ها تکرار می‌شوند.
برای اجرای یک تله‌سین معکوس کامل، باید پس از این عملیات به یک فیلتر decimation
تکیه کنید. به عنوان مثال فیلتر \fBdecimate\fR را ببینید.
.PP
همین عملیات با تطبیق از فیلدهای بالا (\fBfield\fR=\fItop\fR)
به این صورت خواهد بود:
.PP
.Vb 3
\&        Input stream:
\&                        T     1 2 2 3 4   <\-\- matching reference
\&                        B     1 2 3 4 4
\&        
\&        Matches:              c c p p c
\&        
\&        Output stream:
\&                        T     1 2 2 3 4
\&                        B     1 2 2 3 4
.Ve
.PP
در این مثال‌ها می‌توانیم ببینیم که \fIp\fR، \fIc\fR و \fIn\fR چه مفهومی دارند؛
اساساً آن‌ها به فریم و فیلد با زوجیت مخالف ارجاع می‌دهند:
.IP "*<\fIp\fR با فیلد با زوجیت مخالف در فریم قبلی تطبیق می‌یابد>" 4
.IX Item "*<p matches the field of the opposite parity in the previous frame>"
.PD 0
.IP "*<\fIc\fR با فیلد با زوجیت مخالف در فریم فعلی تطبیق می‌یابد>" 4
.IX Item "*<c matches the field of the opposite parity in the current frame>"
.IP "*<\fIn\fR با فیلد با زوجیت مخالف در فریم بعدی تطبیق می‌یابد>" 4
.IX Item "*<n matches the field of the opposite parity in the next frame>"
.PD
.PP
u/b
.IX Subsection "u/b"
.PP
تطبیق‌های \fIu\fR و \fIb\fR از این نظر تا حدی ویژه هستند که بر اساس
پرچم زوجیت مخالف تطبیق می‌یابند. در مثال‌های زیر فرض می‌کنیم که
در حال حاضر در حال تطبیق فریم ۲ هستیم (Top:2, bottom:2). با توجه به تطبیق،
یک \*(Aqx\*(Aq در بالا و پایین هر یک از فیلدهای تطبیق‌یافته قرار داده می‌شود.
.PP
با تطبیق از پایین (\fBfield\fR=\fIbottom\fR):
.PP
.Vb 1
\&        Match:           c         p           n          b          u
\&        
\&                         x       x               x        x          x
\&          Top          1 2 2     1 2 2       1 2 2      1 2 2      1 2 2
\&          Bottom       1 2 3     1 2 3       1 2 3      1 2 3      1 2 3
\&                         x         x           x        x              x
\&        
\&        Output frames:
\&                         2          1          2          2          2
\&                         2          2          2          1          3
.Ve
.PP
با تطبیق از بالا (\fBfield\fR=\fItop\fR):
.PP
.Vb 1
\&        Match:           c         p           n          b          u
\&        
\&                         x         x           x        x              x
\&          Top          1 2 2     1 2 2       1 2 2      1 2 2      1 2 2
\&          Bottom       1 2 3     1 2 3       1 2 3      1 2 3      1 2 3
\&                         x       x               x        x          x
\&        
\&        Output frames:
\&                         2          2          2          1          2
\&                         2          1          3          2          2
.Ve
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
تله‌سین معکوس ساده برای یک جریان تله‌سین‌شده با فیلد بالا اول:
.PP
.Vb 1
\&        fieldmatch=order=tff:combmatch=none, decimate
.Ve
.PP
تله‌سین معکوس پیشرفته، همراه با راهکار جایگزین \fByadif\fR برای فریم‌هایی که همچنان شانه‌ای هستند:
.PP
.Vb 1
\&        fieldmatch=order=tff:combmatch=full, yadif=deint=interlaced, decimate
.Ve
.SS fieldorder
.IX Subsection "fieldorder"
تبدیل ترتیب فیلد ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBorder\fR 4
.IX Item "order"
ترتیب فیلد خروجی. مقادیر معتبر عبارتند از \fItff\fR برای فیلد بالا اول یا \fIbff\fR
برای فیلد پایین اول.
.PP
مقدار پیش‌فرض \fBtff\fR است.
.PP
این تبدیل با انتقال محتوای تصویر به اندازه یک سطر به سمت بالا یا پایین،
و پر کردن سطر باقی‌مانده با محتوای مناسب تصویر انجام می‌شود.
این روش با بیشتر مبدل‌های ترتیب فیلد پخش تلویزیونی سازگار است.
.PP
اگر ویدیوی ورودی به عنوان درهم‌بافته پرچم‌گذاری نشده باشد، یا از پیش
به عنوان دارنده ترتیب فیلد خروجی مورد نیاز پرچم‌گذاری شده باشد، این فیلتر
تغییری در ویدیوی ورودی ایجاد نمی‌کند.
.PP
این ویژگی هنگام تبدیل به یا از متریال PAL DV،
که فیلد پایین اول است، بسیار مفید واقع می‌شود.
.PP
برای مثال:
.PP
.Vb 1
\&        ffmpeg \-i in.vob \-vf "fieldorder=bff" out.dv
.Ve
.SS fillborders
.IX Subsection "fillborders"
پر کردن حاشیه‌های ویدیوی ورودی، بدون تغییر ابعاد جریان ویدیو.
گاهی اوقات ویدیو در چهار لبه ممکن است داده‌های زائد و نامطلوب داشته باشد و شاید نخواهید
ویدیوی ورودی را برش (crop) دهید تا اندازه تصویر مضربی از یک عدد مشخص باقی بماند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBleft\fR 4
.IX Item "left"
تعداد پیکسل‌ها برای پر کردن از حاشیه چپ.
.IP \fBright\fR 4
.IX Item "right"
تعداد پیکسل‌ها برای پر کردن از حاشیه راست.
.IP \fBtop\fR 4
.IX Item "top"
تعداد پیکسل‌ها برای پر کردن از حاشیه بالا.
.IP \fBbottom\fR 4
.IX Item "bottom"
تعداد پیکسل‌ها برای پر کردن از حاشیه پایین.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت پر کردن.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBsmear\fR 4
.IX Item "smear"
پر کردن پیکسل‌ها با استفاده از بیرونی‌ترین پیکسل‌ها
.IP \fBmirror\fR 4
.IX Item "mirror"
پر کردن پیکسل‌ها با استفاده از آینه‌کاری (تقارن نیم‌نمونه)
.IP \fBfixed\fR 4
.IX Item "fixed"
پر کردن پیکسل‌ها با مقدار ثابت
.IP \fBreflect\fR 4
.IX Item "reflect"
پر کردن پیکسل‌ها با استفاده از بازتاب (تقارن تمام‌نمونه)
.IP \fBwrap\fR 4
.IX Item "wrap"
پر کردن پیکسل‌ها با استفاده از پیچش (wrapping)
.IP \fBfade\fR 4
.IX Item "fade"
محو کردن پیکسل‌ها به یک مقدار ثابت
.IP \fBmargins\fR 4
.IX Item "margins"
پر کردن پیکسل‌ها در بالا و پایین با میانگین وزنی پیکسل‌های نزدیک حاشیه‌ها
.RE
.RS 4
.Sp
پیش‌فرض \fIsmear\fR است.
.RE
.IP \fBcolor\fR 4
.IX Item "color"
تنظیم رنگ برای پیکسل‌ها در حالت fixed یا fade. پیش‌فرض \fIblack\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
دستور همان ساختار نحوی گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن
حفظ می‌شود.
.SS find_rect
.IX Subsection "find_rect"
یافتن یک شیء مستطیلی در ویدیوی ورودی.
.PP
شیء مورد جستجو باید به صورت یک تصویر gray8 که با گزینه
\&\fBobject\fR تعیین می‌شود، مشخص گردد.
.PP
برای هر تطبیق ممکن، یک امتیاز محاسبه می‌شود. اگر امتیاز به آستانه مشخص‌شده
برسد، شیء پیدا شده تلقی می‌گردد.
.PP
اگر ویدیوی ورودی حاوی چندین نمونه از آن شیء باشد، فیلتر تنها
یکی از آن‌ها را پیدا خواهد کرد.
.PP
هنگامی که یک شیء پیدا می‌شود، ورودی‌های متادیتای زیر در فریم
منطبق تنظیم می‌شوند:
.IP \fBlavfi.rect.w\fR 4
.IX Item "lavfi.rect.w"
عرض شیء
.IP \fBlavfi.rect.h\fR 4
.IX Item "lavfi.rect.h"
ارتفاع شیء
.IP \fBlavfi.rect.x\fR 4
.IX Item "lavfi.rect.x"
موقعیت x شیء
.IP \fBlavfi.rect.y\fR 4
.IX Item "lavfi.rect.y"
موقعیت y شیء
.IP \fBlavfi.rect.score\fR 4
.IX Item "lavfi.rect.score"
امتیاز تطبیق شیء یافت‌شده
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBobject\fR 4
.IX Item "object"
مسیر فایل تصویر شیء، باید در قالب gray8 باشد.
.IP \fBthreshold\fR 4
.IX Item "threshold"
آستانه تشخیص، بیان‌شده به صورت یک عدد اعشاری در محدوده 0\-1.
.Sp
مقدار آستانه 0.01 به معنای فقط تطبیق‌های دقیق است، و آستانه 0.99 یعنی
تقریباً همه چیز منطبق می‌شود.
.Sp
مقدار پیش‌فرض 0.5 است.
.IP \fBmipmaps\fR 4
.IX Item "mipmaps"
تعداد سطوح mipmap، پیش‌فرض 3 است.
.IP "\fBxmin, ymin, xmax, ymax\fR" 4
.IX Item "xmin, ymin, xmax, ymax"
مستطیلی را که جستجو در آن انجام می‌شود مشخص می‌کند.
.IP \fBdiscard\fR 4
.IX Item "discard"
دور انداختن فریم‌هایی که در آن‌ها شیء تشخیص داده نشده است. پیش‌فرض غیرفعال است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
پوشاندن یک شیء مستطیلی با تصویر ارائه‌شده در یک ویدیوی مشخص با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i file.ts \-vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
.Ve
.IP \(bu 4
یافتن موقعیت یک شیء در هر فریم با استفاده از \fBffprobe\fR و نوشتن
آن در یک فایل لاگ:
.Sp
.Vb 3
\&        ffprobe \-f lavfi movie=test.mp4,find_rect=object=object.pgm:threshold=0.3 \e
\&          \-show_entries frame=pkt_pts_time:frame_tags=lavfi.rect.x,lavfi.rect.y \e
\&          \-of csv \-o find_rect.csv
.Ve
.SS floodfill
.IX Subsection "floodfill"
پر کردن سیلابی یک ناحیه با مقادیر یکسان مؤلفه‌های پیکسلی با مقادیری دیگر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
تنظیم مختصات x پیکسل.
.IP \fBy\fR 4
.IX Item "y"
تنظیم مختصات y پیکسل.
.IP \fBs0\fR 4
.IX Item "s0"
تنظیم مقدار مؤلفه مبدأ شماره 0.
.IP \fBs1\fR 4
.IX Item "s1"
تنظیم مقدار مؤلفه مبدأ شماره 1.
.IP \fBs2\fR 4
.IX Item "s2"
تنظیم مقدار مؤلفه مبدأ شماره 2.
.IP \fBs3\fR 4
.IX Item "s3"
تنظیم مقدار مؤلفه مبدأ شماره 3.
.IP \fBd0\fR 4
.IX Item "d0"
تنظیم مقدار مؤلفه مقصد شماره 0.
.IP \fBd1\fR 4
.IX Item "d1"
تنظیم مقدار مؤلفه مقصد شماره 1.
.IP \fBd2\fR 4
.IX Item "d2"
تنظیم مقدار مؤلفه مقصد شماره 2.
.IP \fBd3\fR 4
.IX Item "d3"
تنظیم مقدار مؤلفه مقصد شماره 3.
.SS format
.IX Subsection "format"
تبدیل ویدیوی ورودی به یکی از قالب‌های پیکسلی مشخص‌شده.
Libavfilter تلاش خواهد کرد قالبی را انتخاب کند که به عنوان ورودی برای
فیلتر بعدی مناسب باشد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBpix_fmts\fR 4
.IX Item "pix_fmts"
فهرستی از نام‌های قالب پیکسلی جداشده با \*(Aq|\*(Aq، مانند
"pix_fmts=yuv420p|monow|rgb24".
.IP \fBcolor_spaces\fR 4
.IX Item "color_spaces"
فهرستی از نام‌های فضای رنگ جداشده با \*(Aq|\*(Aq، مانند
"color_spaces=bt709|bt470bg|bt2020nc".
.IP \fBcolor_ranges\fR 4
.IX Item "color_ranges"
فهرستی از نام‌های محدوده رنگ جداشده با \*(Aq|\*(Aq، مانند
"color_ranges=tv|pc".
.IP \fBalpha_modes\fR 4
.IX Item "alpha_modes"
فهرستی از نام‌های حالت آلفا جداشده با \*(Aq|\*(Aq، مانند
"alpha_modes=straight|premultiplied".
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تبدیل ویدیوی ورودی به قالب \fIyuv420p\fR
.Sp
.Vb 1
\&        format=pix_fmts=yuv420p
.Ve
.Sp
تبدیل ویدیوی ورودی به هر یک از قالب‌های موجود در فهرست
.Sp
.Vb 1
\&        format=pix_fmts=yuv420p|yuv444p|yuv410p
.Ve
.SS fps
.IX Subsection "fps"
تبدیل ویدیو به نرخ فریم ثابت مشخص‌شده با تکثیر یا حذف فریم‌ها بر حسب نیاز.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBfps\fR 4
.IX Item "fps"
نرخ فریم خروجی مورد نظر. عبارات حاوی ثابت‌های زیر را می‌پذیرد:
.RS 4
.IP \fBsource_fps\fR 4
.IX Item "source_fps"
نرخ فریم ورودی
.IP \fBntsc\fR 4
.IX Item "ntsc"
نرخ فریم NTSC برابر با \f(CW\*(C`30000/1001\*(C'\fR
.IP \fBpal\fR 4
.IX Item "pal"
نرخ فریم PAL برابر با \f(CW25.0\fR
.IP \fBfilm\fR 4
.IX Item "film"
نرخ فریم فیلم برابر با \f(CW24.0\fR
.IP \fBntsc_film\fR 4
.IX Item "ntsc_film"
نرخ فریم NTSC\-film برابر با \f(CW\*(C`24000/1001\*(C'\fR
.RE
.RS 4
.Sp
پیش‌فرض \f(CW25\fR است.
.RE
.IP \fBstart_time\fR 4
.IX Item "start_time"
فرض می‌کند نخستین PTS باید مقدار داده‌شده بر حسب ثانیه باشد. این گزینه امکان پدینگ/بریدن (padding/trimming) در آغاز جریان را فراهم می‌کند. به‌طور پیش‌فرض، هیچ فرضی درباره PTS مورد انتظار فریم اول در نظر گرفته نمی‌شود، بنابراین هیچ پدینگ یا بریدنی انجام نمی‌شود. برای نمونه، می‌توان آن را روی 0 تنظیم کرد تا چنانچه یک جریان ویدیو پس از جریان صوتی آغاز شود، ابتدای آن با نسخه‌های تکراری از اولین فریم پر شود، یا هر فریمی با PTS منفی بریده شود.
.IP \fBround\fR 4
.IX Item "round"
روش گرد کردن برچسب زمانی (PTS).
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fBzero\fR 4
.IX Item "zero"
گرد کردن به سمت 0
.IP \fBinf\fR 4
.IX Item "inf"
گرد کردن در جهت مخالف 0
.IP \fBdown\fR 4
.IX Item "down"
گرد کردن به سمت \-infinity
.IP \fBup\fR 4
.IX Item "up"
گرد کردن به سمت +infinity
.IP \fBnear\fR 4
.IX Item "near"
گرد کردن به نزدیک‌ترین
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`near\*(C'\fR است.
.RE
.IP \fBeof_action\fR 4
.IX Item "eof_action"
عملیاتی که هنگام خواندن آخرین فریم انجام می‌شود.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fBround\fR 4
.IX Item "round"
استفاده از همان روش گرد کردن برچسب زمانی مورد استفاده برای سایر فریم‌ها.
.IP \fBpass\fR 4
.IX Item "pass"
عبور دادن آخرین فریم در صورتی که مدت زمان ورودی هنوز به پایان نرسیده باشد.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`round\*(C'\fR است.
.RE
.PP
به عنوان جایگزین، گزینه‌ها را می‌توان به‌صورت یک رشته تخت مشخص کرد:
\&\fIfps\fR[:\fIstart_time\fR[:\fIround\fR]].
.PP
همچنین فیلتر \fBsetpts\fR را ببینید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
یک کاربرد معمول به منظور تنظیم fps روی 25:
.Sp
.Vb 1
\&        fps=fps=25
.Ve
.IP \(bu 4
تنظیم fps روی 24، با استفاده از نام اختصاری و روش گرد کردن به نزدیک‌ترین مقدار:
.Sp
.Vb 1
\&        fps=fps=film:round=near
.Ve
.SS framepack
.IX Subsection "framepack"
بسته‌بندی دو جریان ویدیویی مختلف در یک ویدیوی استریوسکوپیک (سه‌بعدی)، همراه با تنظیم متادیتای مناسب روی کدک‌های پشتیبانی‌شده. دو نما باید اندازه و نرخ فریم یکسانی داشته باشند و پردازش زمانی که ویدیوی کوتاه‌تر به پایان برسد متوقف خواهد شد. لطفاً توجه داشته باشید که می‌توانید به‌راحتی ویژگی‌های نما را با فیلترهای \fBscale\fR و \fBfps\fR تنظیم نمایید.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBformat\fR 4
.IX Item "format"
فرمت بسته‌بندی مورد نظر. مقادیر پشتیبانی‌شده عبارتند از:
.RS 4
.IP \fBsbs\fR 4
.IX Item "sbs"
نماها کنار یکدیگر قرار می‌گیرند (پیش‌فرض).
.IP \fBtab\fR 4
.IX Item "tab"
نماها روی یکدیگر قرار می‌گیرند.
.IP \fBlines\fR 4
.IX Item "lines"
نماها به‌صورت خطی (سطری) بسته‌بندی می‌شوند.
.IP \fBcolumns\fR 4
.IX Item "columns"
نماها به‌صورت ستونی بسته‌بندی می‌شوند.
.IP \fBframeseq\fR 4
.IX Item "frameseq"
نماها به‌صورت توالی زمانی در هم تنیده می‌شوند.
.RE
.RS 4
.RE
.PP
چند مثال:
.PP
.Vb 2
\&        # Convert left and right views into a frame\-sequential video
\&        ffmpeg \-i LEFT \-i RIGHT \-filter_complex framepack=frameseq OUTPUT
\&        
\&        # Convert views into a side\-by\-side video with the same output resolution as the input
\&        ffmpeg \-i LEFT \-i RIGHT \-filter_complex [0:v]scale=w=iw/2[left],[1:v]scale=w=iw/2[right],[left][right]framepack=sbs OUTPUT
.Ve
.SS framerate
.IX Subsection "framerate"
تغییر نرخ فریم از طریق درون‌یابی فریم‌های خروجی ویدیویی جدید از فریم‌های سورس (منبع).
.PP
این فیلتر برای عملکرد صحیح با رسانه‌های درهم‌بافته (interlaced) طراحی نشده است. اگر می‌خواهید نرخ فریم رسانه درهم‌بافته را تغییر دهید، باید پیش از این فیلتر عملیات deinterlace و پس از این فیلتر عملیات re\-interlace را انجام دهید.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBfps\fR 4
.IX Item "fps"
تعداد فریم بر ثانیه در خروجی را تعیین می‌کند. این گزینه را می‌توان به‌صورت یک مقدار تنها نیز مشخص کرد. پیش‌فرض \f(CW50\fR است.
.IP \fBinterp_start\fR 4
.IX Item "interp_start"
آغاز بازه‌ای را تعیین می‌کند که فریم خروجی در آن به‌صورت درون‌یابی خطی از دو فریم ساخته می‌شود. بازه [\f(CW0\fR\-\f(CW255\fR] است، پیش‌فرض \f(CW15\fR است.
.IP \fBinterp_end\fR 4
.IX Item "interp_end"
پایان بازه‌ای را تعیین می‌کند که فریم خروجی در آن به‌صورت درون‌یابی خطی از دو فریم ساخته می‌شود. بازه [\f(CW0\fR\-\f(CW255\fR] است، پیش‌فرض \f(CW240\fR است.
.IP \fBscene\fR 4
.IX Item "scene"
سطحی را مشخص می‌کند که در آن تغییر صحنه تشخیص داده می‌شود به‌صورت مقداری بین 0 تا 100 برای نشان دادن یک صحنه جدید؛ مقدار پایین بیانگر احتمال کم فریم جاری در معرفی یک صحنه جدید است، در حالی که مقدار بالاتر به این معنی است که فریم جاری با احتمال بیشتری یک صحنه جدید است.
پیش‌فرض \f(CW8.2\fR است.
.IP \fBflags\fR 4
.IX Item "flags"
پرچم‌های تأثیرگذار بر فرایند فیلتر را تعیین می‌کند.
.Sp
مقدار موجود برای \fIflags\fR عبارت است از:
.RS 4
.IP "\fBscene_change_detect, scd\fR" 4
.IX Item "scene_change_detect, scd"
فعال‌سازی تشخیص تغییر صحنه با استفاده از مقدار گزینه \fIscene\fR.
این پرچم به‌طور پیش‌فرض فعال است.
.RE
.RS 4
.RE
.SS frc_amf
.IX Subsection "frc_amf"
دو برابر کردن نرخ فریم با استفاده از تبدیل‌کننده نرخ فریم (FRC) ارائه‌شده توسط کتابخانه AMD Advanced Media Framework جهت شتاب‌دهی سخت‌افزاری.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBengine_type\fR 4
.IX Item "engine_type"
تعیین موتوری که برای اجرای سایه‌زن‌ها (shaders) استفاده می‌شود.
.RS 4
.IP \fBdx11\fR 4
.IX Item "dx11"
DirectX 11.
.IP \fBdx12\fR 4
.IX Item "dx12"
DirectX 12 (مقدار پیش‌فرض).
.RE
.RS 4
.RE
.IP \fBenable\fR 4
.IX Item "enable"
مقدار بولی: فعال/غیرفعال‌سازی FRC. مقدار پویا، می‌تواند در زمان اجرا بدون مقداردهی اولیه مجدد فیلتر تغییر داده شود. (مقدار پیش‌فرض: فعال).
.IP \fBfallback_mode\fR 4
.IX Item "fallback_mode"
رفتار بازگشتی در صورت اطمینان پایین به درون‌یابی.
.RS 4
.IP \fBduplicate\fR 4
.IX Item "duplicate"
تکرار فریم.
.IP \fBblend\fR 4
.IX Item "blend"
ترکیب ملایم (blend) دو فریم با یکدیگر (مقدار پیش‌فرض).
.RE
.RS 4
.RE
.IP \fBindicator\fR 4
.IX Item "indicator"
مقدار بولی: نمایش مربع نشانگر FRC در گوشه بالا سمت چپ ویدیو (مقدار پیش‌فرض: غیرفعال).
.IP \fBprofile\fR 4
.IX Item "profile"
سطح جستجوی حرکتی سلسله‌مراتبی.
.RS 4
.IP \fBlow\fR 4
.IX Item "low"
سطوح کمتر جستجوی حرکتی سلسله‌مراتبی.
تنها برای رزولوشن‌های بسیار پایین توصیه می‌شود.
.IP \fBhigh\fR 4
.IX Item "high"
برای هر رزولوشنی تا 1440p توصیه می‌شود. (مقدار پیش‌فرض)
.IP \fBsuper\fR 4
.IX Item "super"
سطوح بیشتر جستجوی حرکتی سلسله‌مراتبی. برای رزولوشن‌های 1440p یا بالاتر توصیه می‌شود.
.RE
.RS 4
.RE
.IP \fBmv_search_mode\fR 4
.IX Item "mv_search_mode"
حالت عملکردی جستجوی حرکت.
.RS 4
.IP \fBnative\fR 4
.IX Item "native"
انجام جستجوی حرکت روی رزولوشن کامل تصاویر منبع.
.IP \fBperformance\fR 4
.IX Item "performance"
انجام جستجوی حرکت روی تصاویر منبع با مقیاس کاهش‌یافته.
برای عملکرد بهتر در APU یا GPUهای رده‌پایین توصیه می‌شود.
.RE
.RS 4
.RE
.IP \fBuse_future_frame\fR 4
.IX Item "use_future_frame"
مقدار بولی: فعال‌سازی وابستگی به فریم آینده، کیفیت را به بهای تأخیر بهبود می‌بخشد (مقدار پیش‌فرض: فعال).
.SS framestep
.IX Subsection "framestep"
انتخاب یک فریم از هر N فریم.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBstep\fR 4
.IX Item "step"
انتخاب فریم پس از هر \f(CW\*(C`step\*(C'\fR فریم.
مقادیر مجاز اعداد صحیح مثبت بزرگ‌تر از 0 هستند. مقدار پیش‌فرض \f(CW1\fR است.
.SS freezedetect
.IX Subsection "freezedetect"
تشخیص ویدیوی متوقف‌شده (فریز شده).
.PP
این فیلتر هنگامی که تشخیص دهد ویدیوی ورودی در طول مدت‌زمان مشخص‌شده هیچ تغییر قابل توجهی در محتوا نداشته است، پیامی را ثبت کرده و متادیتای فریم را تنظیم می‌کند. تشخیص فریز ویدیو میانگین قدر مطلق تفاوت تمامی مؤلفه‌های فریم‌های ویدیو را محاسبه کرده و آن را با کف نوفه (noise floor) مقایسه می‌کند.
.PP
زمان‌ها و مدت‌زمان چاپ‌شده بر حسب ثانیه بیان می‌شوند. کلید متادیتای \f(CW\*(C`lavfi.freezedetect.freeze_start\*(C'\fR روی نخستین فریمی که برچسب زمانی آن برابر یا بیشتر از مدت‌زمان تشخیص باشد تنظیم می‌شود و شامل برچسب زمانی نخستین فریم فریز است. کلیدهای متادیتای \f(CW\*(C`lavfi.freezedetect.freeze_duration\*(C'\fR و \f(CW\*(C`lavfi.freezedetect.freeze_end\*(C'\fR روی نخستین فریم پس از فریز تنظیم می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBnoise, n\fR" 4
.IX Item "noise, n"
تنظیم میزان تحمل نویز. می‌تواند بر حسب dB (در صورتی که "dB" به مقدار مشخص‌شده پیوست شده باشد) یا به عنوان نسبت تفاوت بین 0 و 1 مشخص شود. پیش‌فرض \-60dB یا 0.001 است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان فریز تا زمان ارسال اعلان (پیش‌فرض 2 ثانیه است).
.SS freezeframes
.IX Subsection "freezeframes"
ثابت نگه‌داشتن (فریز کردن) فریم‌های ویدیو.
.PP
این فیلتر فریم‌های ویدیو را با استفاده از فریمی از ورودی دوم ثابت نگه می‌دارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfirst\fR 4
.IX Item "first"
تنظیم شماره نخستین فریمی که فریز از آن آغاز می‌شود.
.IP \fBlast\fR 4
.IX Item "last"
تنظیم شماره آخرین فریمی که فریز در آن پایان می‌یابد.
.IP \fBreplace\fR 4
.IX Item "replace"
تنظیم شماره فریم از ورودی دوم که به جای فریم‌های جایگزین‌شده استفاده خواهد شد.
.SS frei0r
.IX Subsection "frei0r"
اعمال یک جلوه (افکت) frei0r روی ویدیوی ورودی.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید هدر frei0r را نصب کرده و FFmpeg را با \f(CW\*(C`\-\-enable\-frei0r\*(C'\fR پیکربندی کنید.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBfilter_name\fR 4
.IX Item "filter_name"
نام جلوه frei0r برای بارگذاری. اگر متغیر محیطی \fBFREI0R_PATH\fR تعریف شده باشد، جلوه frei0r در هر یک از دایرکتوری‌های مشخص‌شده توسط فهرست جداشده با دونقطه در \fBFREI0R_PATH\fR جستجو می‌شود. در غیر این صورت، مسیرهای استاندارد frei0r به این ترتیب جستجو می‌شوند:
\&\fIHOME/.frei0r\-1/lib/\fR، \fI/usr/local/lib/frei0r\-1/\fR،
\&\fI/usr/lib/frei0r\-1/\fR.
.IP \fBfilter_params\fR 4
.IX Item "filter_params"
فهرستی از پارامترهای جداشده با \*(Aq|\*(Aq برای ارسال به جلوه frei0r.
.PP
یک پارامتر جلوه frei0r می‌تواند یک مقدار بولی (مقدار آن یا "y" یا "n" است)، یک عدد ممیز شناور با دقت مضاعف (double)، یک رنگ (مشخص‌شده به‌صورت \fIR\fR/\fIG\fR/\fIB\fR، که در آن \fIR\fR، \fIG\fR و \fIB\fR اعداد ممیز شناور بین 0.0 و 1.0 شامل خود آن‌ها هستند) یا یک شرح رنگ آن‌گونه که در \fBبخش "Color" در راهنمای ffmpeg\-utils\fR مشخص شده است، یک موقعیت (مشخص‌شده به‌صورت \fIX\fR/\fIY\fR، که در آن \fIX\fR و \fIY\fR اعداد ممیز شناور هستند) و/یا یک رشته باشد.
.PP
تعداد و انواع پارامترها به جلوه بارگذاری‌شده بستگی دارد. اگر پارامتر یک جلوه مشخص نشود، مقدار پیش‌فرض تنظیم می‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال جلوه distort0r، با تنظیم دو پارامتر نخست از نوع double:
.Sp
.Vb 1
\&        frei0r=filter_name=distort0r:filter_params=0.5|0.01
.Ve
.IP \(bu 4
اعمال جلوه colordistance، که یک رنگ را به عنوان پارامتر نخست می‌پذیرد:
.Sp
.Vb 3
\&        frei0r=colordistance:0.2/0.3/0.4
\&        frei0r=colordistance:violet
\&        frei0r=colordistance:0x112233
.Ve
.IP \(bu 4
اعمال جلوه perspective، با تعیین موقعیت‌های بالا\-چپ و بالا\-راست تصویر:
.Sp
.Vb 1
\&        frei0r=perspective:0.2/0.2|0.8/0.2
.Ve
.PP
برای اطلاعات بیشتر، ببینید:
<\fBhttp://frei0r.dyne.org\fR>
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از گزینه \fBfilter_params\fR به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS fspp
.IX Subsection "fspp"
اعمال پس‌پردازش سریع و ساده. این نسخه سریع‌تری از \fBspp\fR است.
.PP
تبدیل (I)DCT را به مراحل افقی/عمودی تقسیم می‌کند. برخلاف فیلتر پس‌پردازش ساده، یکی از آن‌ها یک بار در هر بلوک انجام می‌شود، نه در هر پیکسل. این امر سرعت بسیار بالاتری را فراهم می‌سازد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBquality\fR 4
.IX Item "quality"
تنظیم کیفیت. این گزینه تعداد سطوح برای میانگین‌گیری را تعیین می‌کند. یک عدد صحیح در محدوده 4\-5 می‌پذیرد. مقدار پیش‌فرض \f(CW4\fR است.
.IP \fBqp\fR 4
.IX Item "qp"
تحمیل یک پارامتر کوانتیزاسیون ثابت. یک عدد صحیح در محدوده 0\-63 می‌پذیرد. در صورت عدم تنظیم، فیلتر از QP جریان ویدیو (در صورت وجود) استفاده خواهد کرد.
.IP \fBstrength\fR 4
.IX Item "strength"
تنظیم قدرت فیلتر. یک عدد صحیح در محدوده \-15 تا 32 می‌پذیرد. مقادیر پایین‌تر به معنای جزئیات بیشتر اما آرتیفکت‌های بیشتر است، در حالی که مقادیر بالاتر تصویر را نرم‌تر اما تارتر می‌کنند. مقدار پیش‌فرض \f(CW0\fR است − بهینه از نظر PSNR.
.IP \fBuse_bframe_qp\fR 4
.IX Item "use_bframe_qp"
فعال‌سازی استفاده از QP فریم‌های B در صورت تنظیم روی \f(CW1\fR. استفاده از این گزینه ممکن است باعث لرزش و پرش تصویر (flicker) شود زیرا فریم‌های B معمولاً دارای QP بزرگتری هستند. پیش‌فرض \f(CW0\fR (غیرفعال) است.
.SS fsync
.IX Subsection "fsync"
همگام‌سازی فریم‌های ویدیو با نگاشت خارجی از یک فایل.
.PP
به ازای هر PTS ورودیِ ارائه‌شده در فایل نگاشت، به تعداد لازم فریم حذف یا ایجاد می‌کند تا توالی فریم‌های خروجی داده‌شده در فایل نگاشت بازسازی شود.
.PP
این فیلتر برای بازسازی فریم‌های خروجی ناشی از تبدیل نرخ فریم توسط فیلتر \fBfps\fR مفید است که با استفاده از گزینه \f(CW\*(C`\-stats_mux_pre\*(C'\fR در ffmpeg درون یک فایل نگاشت ثبت شده باشد، و انجام پردازش‌های بعدی روی فریم‌های متناظر، مانند مقایسه کیفیت.
.PP
هر خط از فایل نگاشت باید شامل سه مورد به ازای هر فریم ورودی باشد: PTS ورودی (ده‌دهی)، PTS خروجی (ده‌دهی) و پایه زمانی (TIMEBASE) خروجی (ده‌دهی/ده‌دهی)، که با یک فاصله جدا شده‌اند. این فرمت فایل با خروجی \f(CW\*(C`\-stats_mux_pre_fmt="{ptsi} {pts} {tb}"\*(C'\fR مطابقت دارد.
.PP
این فیلتر فرض می‌کند فایل نگاشت بر اساس افزایش PTS ورودی مرتب شده است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfile, f\fR" 4
.IX Item "file, f"
نام فایل نگاشت مورد استفاده.
.PP
مثال:
.PP
.Vb 2
\&        # Convert a video to 25 fps and record a MAP_FILE file with the default format of this filter
\&        ffmpeg \-i INPUT \-vf fps=fps=25 \-stats_mux_pre MAP_FILE \-stats_mux_pre_fmt "{ptsi} {pts} {tb}" OUTPUT
\&        
\&        # Sort MAP_FILE by increasing input PTS
\&        sort \-n MAP_FILE
\&        
\&        # Use INPUT, OUTPUT and the MAP_FILE from above to compare the corresponding frames in INPUT and OUTPUT via SSIM
\&        ffmpeg \-i INPUT \-i OUTPUT \-filter_complex \*(Aq[0:v]fsync=file=MAP_FILE[ref];[1:v][ref]ssim\*(Aq \-f null \-
.Ve
.SS gblur
.IX Subsection "gblur"
اعمال فیلتر مات‌کننده گوسی (Gaussian blur).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم سیگمای افقی، انحراف معیار مات‌شدگی گوسی. پیش‌فرض \f(CW0.5\fR است.
.IP \fBsteps\fR 4
.IX Item "steps"
تنظیم تعداد گام‌ها برای تقریب گوسی. پیش‌فرض \f(CW1\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام پلان‌ها فیلتر شوند. به‌طور پیش‌فرض تمام پلان‌ها فیلتر می‌شوند.
.IP \fBsigmaV\fR 4
.IX Item "sigmaV"
تنظیم سیگمای عمودی، اگر منفی باشد همانند \f(CW\*(C`sigma\*(C'\fR خواهد بود.
پیش‌فرض \f(CW\-1\fR است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه با گزینه‌ها پشتیبانی می‌کند.
دستور همان نحو گزینه مربوطه را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار فعلی خود باقی می‌ماند.
.SS geq
.IX Subsection "geq"
اعمال معادله عمومی بر روی هر پیکسل.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBlum_expr, lum\fR" 4
.IX Item "lum_expr, lum"
تنظیم عبارت لوما.
.IP "\fBcb_expr, cb\fR" 4
.IX Item "cb_expr, cb"
تنظیم عبارت رنگ‌مایه آبی (chrominance blue).
.IP "\fBcr_expr, cr\fR" 4
.IX Item "cr_expr, cr"
تنظیم عبارت رنگ‌مایه قرمز (chrominance red).
.IP "\fBalpha_expr, a\fR" 4
.IX Item "alpha_expr, a"
تنظیم عبارت آلفا.
.IP "\fBred_expr, r\fR" 4
.IX Item "red_expr, r"
تنظیم عبارت قرمز.
.IP "\fBgreen_expr, g\fR" 4
.IX Item "green_expr, g"
تنظیم عبارت سبز.
.IP "\fBblue_expr, b\fR" 4
.IX Item "blue_expr, b"
تنظیم عبارت آبی.
.PP
فضای رنگی مطابق با گزینه‌های مشخص‌شده انتخاب می‌شود. اگر یکی از گزینه‌های
\&\fBlum_expr\fR، \fBcb_expr\fR یا \fBcr_expr\fR مشخص شود، فیلتر به‌طور خودکار یک فضای رنگی YCbCr را انتخاب خواهد کرد. اگر یکی از گزینه‌های \fBred_expr\fR، \fBgreen_expr\fR یا \fBblue_expr\fR مشخص شود، یک فضای رنگی RGB را انتخاب می‌کند.
.PP
اگر یکی از عبارات رنگ‌مایه تعریف نشده باشد، به عبارت دیگر رجوع می‌کند. اگر هیچ عبارت آلفایی مشخص نشده باشد، به مقدار کدر (opaque) ارزیابی می‌شود. اگر هیچ‌یک از عبارات رنگ‌مایه مشخص نشده باشند، به عبارت لوما ارزیابی خواهند شد.
.PP
عبارات می‌توانند از متغیرها و توابع زیر استفاده کنند:
.IP \fBN\fR 4
.IX Item "N"
شماره ترتیبی فریم فیلترشده، که از \f(CW0\fR آغاز می‌شود.
.IP \fBX\fR 4
.IX Item "X"
.PD 0
.IP \fBY\fR 4
.IX Item "Y"
.PD
مختصات نمونه جاری.
.IP \fBW\fR 4
.IX Item "W"
.PD 0
.IP \fBH\fR 4
.IX Item "H"
.PD
عرض و ارتفاع تصویر.
.IP \fBSW\fR 4
.IX Item "SW"
.PD 0
.IP \fBSH\fR 4
.IX Item "SH"
.PD
مقیاس عرض و ارتفاع بسته به پلانی که در حال حاضر فیلتر می‌شود. این مقدار نسبت میان تعداد پیکسل‌های پلان لومای متناظر و پلان جاری است. برای نمونه، برای YUV4:2:0 این مقادیر برای پلان لوما برابر با \f(CW\*(C`1,1\*(C'\fR و برای پلان‌های کروما برابر با \f(CW\*(C`0.5,0.5\*(C'\fR هستند.
.IP \fBT\fR 4
.IX Item "T"
زمان فریم جاری، بیان‌شده بر حسب ثانیه.
.IP "\fBp(x, y)\fR" 4
.IX Item "p(x, y)"
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از پلان جاری را برمی‌گرداند.
.IP "\fBlum(x, y)\fR" 4
.IX Item "lum(x, y)"
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از پلان لوما را برمی‌گرداند.
.IP "\fBcb(x, y)\fR" 4
.IX Item "cb(x, y)"
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از پلان کرومای تفاضل آبی را برمی‌گرداند. در صورت عدم وجود چنین پلانی 0 برمی‌گرداند.
.IP "\fBcr(x, y)\fR" 4
.IX Item "cr(x, y)"
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از پلان کرومای تفاضل قرمز را برمی‌گرداند. در صورت عدم وجود چنین پلانی 0 برمی‌گرداند.
.IP "\fBr(x, y)\fR" 4
.IX Item "r(x, y)"
.PD 0
.IP "\fBg(x, y)\fR" 4
.IX Item "g(x, y)"
.IP "\fBb(x, y)\fR" 4
.IX Item "b(x, y)"
.PD
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از مؤلفه قرمز/سبز/آبی را برمی‌گرداند. در صورت عدم وجود چنین مؤلفه‌ای 0 برمی‌گرداند.
.IP "\fBalpha(x, y)\fR" 4
.IX Item "alpha(x, y)"
مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) از پلان آلفا را برمی‌گرداند. در صورت عدم وجود چنین پلانی 0 برمی‌گرداند.
.IP "\fBpsum(x,y), lumsum(x, y), cbsum(x,y), crsum(x,y), rsum(x,y), gsum(x,y), bsum(x,y), alphasum(x,y)\fR" 4
.IX Item "psum(x,y), lumsum(x, y), cbsum(x,y), crsum(x,y), rsum(x,y), gsum(x,y), bsum(x,y), alphasum(x,y)"
مجموع مقادیر نمونه‌ها در مستطیل از (0,0) تا (x,y)؛ این گزینه امکان به دست آوردن مجموع نمونه‌ها درون یک مستطیل را فراهم می‌سازد. توابع بدون پسوند sum را ببینید.
.IP \fBinterpolation\fR 4
.IX Item "interpolation"
یکی از روش‌های درون‌یابی را تنظیم می‌کند:
.RS 4
.IP "\fBnearest, n\fR" 4
.IX Item "nearest, n"
.PD 0
.IP "\fBbilinear, b\fR" 4
.IX Item "bilinear, b"
.PD
.RE
.RS 4
.Sp
پیش‌فرض bilinear است.
.RE
.PP
برای توابع، چنانچه \fIx\fR و \fIy\fR خارج از ناحیه باشند، مقدار به‌طور خودکار به نزدیک‌ترین لبه برش (clip) داده می‌شود.
.PP
لطفاً توجه داشته باشید که این فیلتر می‌تواند از چندین رشته (thread) استفاده کند که در این صورت هر برش (slice) وضعیت عبارت مخصوص به خود را خواهد داشت. اگر می‌خواهید تنها از یک وضعیت عبارت واحد استفاده کنید چرا که عبارات شما به وضعیت قبلی وابسته هستند، باید تعداد رشته‌های فیلتر را به 1 محدود کنید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
معکوس کردن افقی تصویر:
.Sp
.Vb 1
\&        geq=p(W\-X\e,Y)
.Ve
.IP \(bu 4
تولید یک موج سینوسی دوبعدی، با زاویه \f(CW\*(C`PI/3\*(C'\fR و طول موج 100 پیکسل:
.Sp
.Vb 1
\&        geq=128 + 100*sin(2*(PI/100)*(cos(PI/3)*(X\-50*T) + sin(PI/3)*Y)):128:128
.Ve
.IP \(bu 4
تولید یک نور متحرک جذاب و شگفت‌انگیز:
.Sp
.Vb 1
\&        nullsrc=s=256x256,geq=random(1)/hypot(X\-cos(N*0.07)*W/2\-W/2\e,Y\-sin(N*0.09)*H/2\-H/2)^2*1000000*sin(N*0.02):128:128
.Ve
.IP \(bu 4
تولید یک جلوه برجسته‌سازی (emboss) سریع:
.Sp
.Vb 1
\&        format=gray,geq=lum_expr=\*(Aq(p(X,Y)+(256\-p(X\-4,Y\-4)))/2\*(Aq
.Ve
.IP \(bu 4
تغییر مؤلفه‌های RGB بسته به موقعیت پیکسل:
.Sp
.Vb 1
\&        geq=r=\*(AqX/W*r(X,Y)\*(Aq:g=\*(Aq(1\-X/W)*g(X,Y)\*(Aq:b=\*(Aq(H\-Y)/H*b(X,Y)\*(Aq
.Ve
.IP \(bu 4
ایجاد یک گرادیان شعاعی با اندازه‌ای مشابه با ورودی (همچنین فیلتر \fBvignette\fR را ببینید):
.Sp
.Vb 1
\&        geq=lum=255*gauss((X/W\-0.5)*3)*gauss((Y/H\-0.5)*3)/gauss(0)/gauss(0),format=gray
.Ve
.SS gradfun
.IX Subsection "gradfun"
رفع آرتیفکت‌های نواری‌شدن (banding) که گاهی با کوتاه شدن عمق رنگ به 8 بیت در نواحی تقریباً یکدست ایجاد می‌شوند.
گرادیان‌هایی که باید در محل نوارها باشند را درون‌یابی کرده و آن‌ها را دیتر (dither) می‌کند.
.PP
این فیلتر تنها برای بازپخش طراحی شده است. از آن پیش از فشرده‌سازی با اتلاف استفاده نکنید، چرا که فشرده‌سازی تمایل به حذف دیتر و بازگرداندن نوارها دارد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBstrength\fR 4
.IX Item "strength"
حداکثر مقداری که فیلتر بر اساس آن هر پیکسل را تغییر می‌دهد. این مقدار همچنین آستانه تشخیص نواحی تقریباً یکدست است. مقادیر قابل قبول از .51 تا 64 متغیر است؛ مقدار پیش‌فرض 1.2 است. مقادیر خارج از محدوده به محدوده معتبر برش داده می‌شوند.
.IP \fBradius\fR 4
.IX Item "radius"
محدوده همسایگی برای برازش گرادیان. یک شعاع بزرگتر گرادیان‌های نرم‌تری ایجاد می‌کند، اما همچنین از تغییر پیکسل‌های نزدیک به نواحی دارای جزئیات توسط فیلتر جلوگیری می‌نماید. مقادیر قابل قبول 8\-32 هستند؛ مقدار پیش‌فرض 16 است. مقادیر خارج از محدوده به محدوده معتبر برش داده می‌شوند.
.PP
به عنوان جایگزین، گزینه‌ها را می‌توان به‌صورت یک رشته تخت مشخص کرد:
\&\fIstrength\fR[:\fIradius\fR]
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال فیلتر با قدرت \f(CW3.5\fR و شعاع \f(CW8\fR:
.Sp
.Vb 1
\&        gradfun=3.5:8
.Ve
.IP \(bu 4
مشخص کردن شعاع، با صرف‌نظر از قدرت (که به مقدار پیش‌فرض بازمی‌گردد):
.Sp
.Vb 1
\&        gradfun=radius=8
.Ve
.SS graphmonitor
.IX Subsection "graphmonitor"
نمایش آمارهای مختلف گراف فیلتر (filtergraph).
.PP
با این فیلتر می‌توان کل گراف فیلتر را اشکال‌زدایی کرد؛
به‌ویژه مشکلات مربوط به پر شدن پیوندها با فریم‌های صف‌بندی‌شده.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه خروجی ویدیو. پیش‌فرض \fIhd720\fR است.
.IP "\fBopacity, o\fR" 4
.IX Item "opacity, o"
تنظیم میزان کدری (opacity) ویدیو. پیش‌فرض \fI0.9\fR است. محدوده مجاز از \fI0\fR تا \fI1\fR است.
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم پرچم‌های حالت خروجی.
.Sp
مقادیر موجود برای پرچم‌ها عبارتند از:
.RS 4
.IP \fBfull\fR 4
.IX Item "full"
بدون هرگونه فیلترسازی. پیش‌فرض.
.IP \fBcompact\fR 4
.IX Item "compact"
تنها نمایش فیلترهایی که دارای فریم‌های صف‌بندی‌شده هستند.
.IP \fBnozero\fR 4
.IX Item "nozero"
تنها نمایش فیلترهایی با آمارهای غیرصفر.
.IP \fBnoeof\fR 4
.IX Item "noeof"
تنها نمایش فیلترهایی با وضعیت غیر\-eof.
.IP \fBnodisabled\fR 4
.IX Item "nodisabled"
تنها نمایش فیلترهایی که در خط زمانی فعال هستند.
.RE
.RS 4
.RE
.IP "\fBflags, f\fR" 4
.IX Item "flags, f"
تنظیم پرچم‌هایی که فعال بودن نمایش آمارها در ویدیو را تعیین می‌کنند.
.Sp
مقادیر موجود برای پرچم‌ها عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
تمامی پرچم‌ها خاموش می‌شوند.
.IP \fBall\fR 4
.IX Item "all"
تمامی پرچم‌ها روشن می‌شوند.
.IP \fBqueue\fR 4
.IX Item "queue"
نمایش تعداد فریم‌های صف‌بندی‌شده در هر پیوند.
.IP \fBframe_count_in\fR 4
.IX Item "frame_count_in"
نمایش تعداد فریم‌های دریافت شده از فیلتر.
.IP \fBframe_count_out\fR 4
.IX Item "frame_count_out"
نمایش تعداد فریم‌های تحویل داده شده توسط فیلتر.
.IP \fBframe_count_delta\fR 4
.IX Item "frame_count_delta"
نمایش مقدار دلتای تعداد فریم‌ها میان دو مقدار فوق.
.IP \fBpts\fR 4
.IX Item "pts"
نمایش pts فریم فیلترشده جاری.
.IP \fBpts_delta\fR 4
.IX Item "pts_delta"
نمایش دلتای pts میان فریم جاری و فریم قبلی.
.IP \fBtime\fR 4
.IX Item "time"
نمایش زمان فریم فیلترشده جاری.
.IP \fBtime_delta\fR 4
.IX Item "time_delta"
نمایش دلتای زمان میان فریم جاری و فریم قبلی.
.IP \fBtimebase\fR 4
.IX Item "timebase"
نمایش پایه زمانی (time base) برای پیوند فیلتر.
.IP \fBformat\fR 4
.IX Item "format"
نمایش فرمت استفاده‌شده برای پیوند فیلتر.
.IP \fBsize\fR 4
.IX Item "size"
نمایش اندازه ویدیو یا تعداد کانال‌های صوتی در صورت استفاده از صوت توسط پیوند فیلتر.
.IP \fBrate\fR 4
.IX Item "rate"
نمایش نرخ فریم ویدیو یا نرخ نمونه‌برداری در صورت استفاده از صوت توسط پیوند فیلتر.
.IP \fBeof\fR 4
.IX Item "eof"
نمایش وضعیت خروجی پیوند.
.IP \fBsample_count_in\fR 4
.IX Item "sample_count_in"
نمایش تعداد نمونه‌های دریافت شده از فیلتر.
.IP \fBsample_count_out\fR 4
.IX Item "sample_count_out"
نمایش تعداد نمونه‌های تحویل داده شده توسط فیلتر.
.IP \fBsample_count_delta\fR 4
.IX Item "sample_count_delta"
نمایش مقدار دلتای تعداد نمونه‌ها میان دو مقدار فوق.
.IP \fBdisabled\fR 4
.IX Item "disabled"
نمایش وضعیت فیلتر در خط زمانی.
.RE
.RS 4
.RE
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم حد بالای نرخ ویدیوی جریان خروجی، مقدار پیش‌فرض \fI25\fR است.
این گزینه تضمین می‌کند که نرخ فریم ویدیوی خروجی بالاتر از این مقدار نخواهد بود.
.SS grayworld
.IX Subsection "grayworld"
فیلتر پایداری رنگ که تصحیح رنگ را بر اساس فرض جهان خاکستری (grayworld assumption) اعمال می‌کند.
.PP
ببینید: <\fBhttps://www.researchgate.net/publication/275213614_A_New_Color_Correction_Method_for_Underwater_Imaging\fR>
.PP
این الگوریتم از نور خطی استفاده می‌کند، بنابراین داده‌های ورودی باید از پیش خطی‌سازی شده باشند (و احتمالاً به‌درستی تگ‌گذاری شوند).
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-vf zscale=transfer=linear,grayworld,zscale=transfer=bt709,format=yuv420p OUTPUT
.Ve
.SS greyedge
.IX Subsection "greyedge"
یک فیلتر دگرگونی پایداری رنگ که نورپردازی صحنه را از طریق الگوریتم لبه خاکستری تخمین زده و رنگ‌های صحنه را متناسب با آن تصحیح می‌کند.
.PP
ببینید: <\fBhttps://staff.science.uva.nl/th.gevers/pub/GeversTIP07.pdf\fR>
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdifford\fR 4
.IX Item "difford"
مرتبه مشتق‌گیری اعمال‌شده روی صحنه. باید در محدوده [0,2] انتخاب شود و مقدار پیش‌فرض 1 است.
.IP \fBminknorm\fR 4
.IX Item "minknorm"
پارامتر مینکوفسکی مورد استفاده برای محاسبه فاصله مینکوفسکی. باید در محدوده [0,20] انتخاب شود و مقدار پیش‌فرض 1 است. برای دریافت مقدار بیشینه به‌جای محاسبه فاصله مینکوفسکی، روی 0 تنظیم شود.
.IP \fBsigma\fR 4
.IX Item "sigma"
انحراف معیار مات‌شدگی گوسی که روی صحنه اعمال می‌شود. باید در محدوده [0,1024.0] انتخاب شود و مقدار پیش‌فرض = 1 است. مقدار floor( \fIsigma\fR * \fBbreak_off_sigma\fR\|(3) ) چنانچه \fIdifford\fR بزرگتر از 0 باشد نمی‌تواند برابر با 0 باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
لبه خاکستری:
.Sp
.Vb 1
\&        greyedge=difford=1:minknorm=5:sigma=2
.Ve
.IP \(bu 4
لبه بیشینه:
.Sp
.Vb 1
\&        greyedge=difford=1:minknorm=0:sigma=2
.Ve
.SS guided
.IX Subsection "guided"
اعمال فیلتر هدایت‌شده برای هموارسازی با حفظ لبه‌ها، مه‌زدایی و موارد دیگر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم شعاع جعبه بر حسب پیکسل.
محدوده مجاز 1 تا 20 است. پیش‌فرض 3 است.
.IP \fBeps\fR 4
.IX Item "eps"
تنظیم پارامتر تنظیم‌سازی (regularization) (به توان دو).
محدوده مجاز 0 تا 1 است. پیش‌فرض 0.01 است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت فیلتر. می‌تواند \f(CW\*(C`basic\*(C'\fR یا \f(CW\*(C`fast\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`basic\*(C'\fR است.
.IP \fBsub\fR 4
.IX Item "sub"
تنظیم نسبت زیرنمونه‌برداری (subsampling) برای حالت \f(CW\*(C`fast\*(C'\fR.
محدوده 2 تا 64 است. پیش‌فرض 4 است.
در حالت \f(CW\*(C`basic\*(C'\fR هیچ زیرنمونه‌برداری رخ نمی‌دهد.
.IP \fBguidance\fR 4
.IX Item "guidance"
تنظیم حالت هدایت. می‌تواند \f(CW\*(C`off\*(C'\fR یا \f(CW\*(C`on\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`off\*(C'\fR است.
اگر \f(CW\*(C`off\*(C'\fR باشد، یک ورودی تکی مورد نیاز است.
اگر \f(CW\*(C`on\*(C'\fR باشد، دو ورودی با وضوح و فرمت پیکسل یکسان مورد نیاز است.
ورودی دوم به عنوان راهنما عمل می‌کند.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلان‌ها برای فیلترسازی. پیش‌فرض تنها پلان اول است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
هموارسازی با حفظ لبه‌ها با استفاده از فیلتر هدایت‌شده:
.Sp
.Vb 1
\&        ffmpeg \-i in.png \-vf guided out.png
.Ve
.IP \(bu 4
مه‌زدایی، فیلترسازی انتقال ساختار، ارتقای جزئیات با فیلتر هدایت‌شده.
برای تولید تصویر راهنما، به مقاله "Guided Image Filtering" مراجعه کنید.
ببینید: <\fBhttp://kaiminghe.com/publications/pami12guidedfilter.pdf\fR>.
.Sp
.Vb 1
\&        ffmpeg \-i in.png \-i guidance.png \-filter_complex guided=guidance=on out.png
.Ve
.SS haldclut
.IX Subsection "haldclut"
اعمال یک Hald CLUT روی یک جریان ویدیو.
.PP
ورودی اول جریان ویدیویی جهت پردازش است و ورودی دوم Hald CLUT می‌باشد.
ورودی Hald CLUT می‌تواند یک تصویر ساده یا یک جریان ویدیویی کامل باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBclut\fR 4
.IX Item "clut"
تعیین اینکه کدام فریم‌های ویدیویی CLUT از جریان ورودی دوم پردازش خواهند شد؛
می‌تواند \fIfirst\fR یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
.IP \fBshortest\fR 4
.IX Item "shortest"
اجبار به پایان یافتن هنگامی که کوتاه‌ترین ورودی پایان یابد. پیش‌فرض \f(CW0\fR است.
.IP \fBrepeatlast\fR 4
.IX Item "repeatlast"
ادامه اعمال آخرین CLUT پس از پایان جریان. مقدار
\&\f(CW0\fR فیلتر را پس از رسیدن به آخرین فریم CLUT غیرفعال می‌کند.
پیش‌فرض \f(CW1\fR است.
.PP
\&\f(CW\*(C`haldclut\*(C'\fR همچنین گزینه‌های درون‌یابی مشابه با \fBlut3d\fR دارد (هر دو فیلتر بخش‌های داخلی مشترکی دارند).
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
اطلاعات بیشتر درباره Hald CLUT را می‌توانید در وب‌سایت Eskil Steenberg (نویسنده Hald CLUT) به نشانی <\fBhttp://www.quelsolaar.com/technology/clut.html\fR> بیابید.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از گزینه \f(CW\*(C`interp\*(C'\fR به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.PP
\fIمثال‌های جریان کار\fR
.IX Subsection "Workflow examples"
.PP
جریان ویدیویی Hald CLUT
.IX Subsection "Hald CLUT video stream"
.PP
تولید یک جریان یکتای Hald CLUT که با جلوه‌های گوناگون تغییر یافته است:
.PP
.Vb 1
\&        ffmpeg \-f lavfi \-i B<haldclutsrc>=8 \-vf "hue=H=2*PI*t:s=sin(2*PI*t)+1, curves=cross_process" \-t 10 \-c:v ffv1 clut.nut
.Ve
.PP
نکته: اطمینان حاصل کنید که از یک کدک بدون اتلاف (lossless) استفاده می‌کنید.
.PP
سپس با استفاده از \f(CW\*(C`haldclut\*(C'\fR آن را روی یک جریان تصادفی اعمال کنید:
.PP
.Vb 1
\&        ffmpeg \-f lavfi \-i mandelbrot \-i clut.nut \-filter_complex \*(Aq[0][1] haldclut\*(Aq \-t 20 mandelclut.mkv
.Ve
.PP
فیلتر Hald CLUT بر روی ۱۰ ثانیه نخست (مدت‌زمان \fIclut.nut\fR) اعمال خواهد شد، سپس آخرین تصویر آن جریان CLUT بر روی فریم‌های باقی‌مانده از جریان \f(CW\*(C`mandelbrot\*(C'\fR اعمال می‌شود.
.PP
Hald CLUT همراه با پیش‌نمایش
.IX Subsection "Hald CLUT with preview"
.PP
یک Hald CLUT فرض می‌شود تصویری مربعی به اندازه \f(CW\*(C`Level*Level*Level\*(C'\fR در \f(CW\*(C`Level*Level*Level\*(C'\fR پیکسل باشد. برای یک Hald CLUT داده‌شده، FFmpeg بزرگ‌ترین مربع ممکن را با شروع از گوشه بالا سمت چپ تصویر انتخاب می‌کند. پیکسل‌های اضافه (پدینگ) باقی‌مانده (پایین یا راست) نادیده گرفته خواهند شد. از این ناحیه می‌توان برای افزودن پیش‌نمایشی از Hald CLUT استفاده کرد.
.PP
معمولاً، Hald CLUT تولیدشده زیر توسط فیلتر \f(CW\*(C`haldclut\*(C'\fR پشتیبانی خواهد شد:
.PP
.Vb 5
\&        ffmpeg \-f lavfi \-i B<haldclutsrc>=8 \-vf "
\&           pad=iw+320 [padded_clut];
\&           smptebars=s=320x256, split [a][b];
\&           [padded_clut][a] overlay=W\-320:h, curves=color_negative [main];
\&           [main][b] overlay=W\-320" \-frames:v 1 clut.png
.Ve
.PP
این شامل تصویر اصلی و پیش‌نمایشی از جلوه اثرگذار CLUT است: نوارهای رنگی SMPTE در بالا\-راست نمایش داده می‌شوند و در زیر آن نوارهای رنگی مشابهی که با تغییرات رنگ پردازش شده‌اند قرار دارند.
.PP
سپس، اثر این Hald CLUT را می‌توان با دستور زیر مشاهده کرد:
.PP
.Vb 1
\&        ffplay input.mkv \-vf "movie=clut.png, [in] haldclut"
.Ve
.SS hflip
.IX Subsection "hflip"
معکوس کردن افقی ویدیوی ورودی.
.PP
برای نمونه، جهت معکوس کردن افقی ویدیوی ورودی با \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-i in.avi \-vf "hflip" out.avi
.Ve
.SS histeq
.IX Subsection "histeq"
این فیلتر تعدیل سراسری هیستوگرام رنگی را به‌صورت فریم‌به‌فریم اعمال می‌کند.
.PP
می‌تواند برای تصحیح ویدیویی که دارای دامنه فشرده‌ای از شدت‌های پیکسل است استفاده شود. فیلتر شدت‌های پیکسل را مجدداً توزیع می‌کند تا توزیع آن‌ها در سرتاسر دامنه شدت تعدیل و یکدست شود. می‌توان آن را به عنوان یک "فیلتر کنتراست با تنظیم خودکار" در نظر گرفت. این فیلتر تنها برای تصحیح ویدیوی سورس آسیب‌دیده یا ضبط‌شده با کیفیت نامناسب کاربرد دارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstrength\fR 4
.IX Item "strength"
تعیین میزان تعدیل اعمال‌شونده. با کاهش قدرت، توزیع شدت‌های پیکسل بیشتر و بیشتر به فریم ورودی نزدیک می‌شود. مقدار باید یک عدد ممیز شناور در محدوده [0,1] باشد و پیش‌فرض آن 0.200 است.
.IP \fBintensity\fR 4
.IX Item "intensity"
تنظیم حداکثر شدتی که می‌تواند تولید شود و مقیاس‌بندی مناسب مقادیر خروجی. قدرت باید بر حسب نیاز تنظیم شود و سپس در صورت لزوم شدت محدود گردد تا از رنگ‌پریدگی (washing\-out) جلوگیری شود. مقدار باید یک عدد ممیز شناور در محدوده [0,1] باشد و پیش‌فرض آن 0.210 است.
.IP \fBantibanding\fR 4
.IX Item "antibanding"
تنظیم سطح ضد نواری‌شدن (antibanding). در صورت فعال بودن، فیلتر روشنایی پیکسل‌های خروجی را به مقدار اندکی به‌صورت تصادفی تغییر می‌دهد تا از نواری‌شدن هیستوگرام جلوگیری شود. مقادیر ممکن عبارتند از \f(CW\*(C`none\*(C'\fR، \f(CW\*(C`weak\*(C'\fR یا \f(CW\*(C`strong\*(C'\fR. پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.SS histogram
.IX Subsection "histogram"
محاسبه و ترسیم هیستوگرام توزیع رنگ برای ویدیوی ورودی.
.PP
هیستوگرام محاسبه‌شده، نمایشی از توزیع مؤلفه‌های رنگ در یک تصویر است.
.PP
هیستوگرام استاندارد توزیع مؤلفه‌های رنگ را در یک تصویر نمایش می‌دهد. نمودار رنگی را برای هر مؤلفه رنگ نمایش می‌دهد. توزیع مؤلفه‌های Y، U، V، A یا R، G، B را بسته به فرمت ورودی در فریم جاری نشان می‌دهد. زیر هر نمودار یک مقیاس‌سنج مؤلفه رنگ نمایش داده می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlevel_height\fR 4
.IX Item "level_height"
تنظیم ارتفاع سطح. مقدار پیش‌فرض \f(CW200\fR است.
محدوده مجاز [50, 2048] است.
.IP \fBscale_height\fR 4
.IX Item "scale_height"
تنظیم ارتفاع مقیاس رنگ. مقدار پیش‌فرض \f(CW12\fR است.
محدوده مجاز [0, 40] است.
.IP \fBdisplay_mode\fR 4
.IX Item "display_mode"
تنظیم حالت نمایش.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBstack\fR 4
.IX Item "stack"
نمودارهای هر مؤلفه رنگ در زیر یکدیگر قرار می‌گیرند.
.IP \fBparade\fR 4
.IX Item "parade"
نمودارهای هر مؤلفه رنگ در کنار یکدیگر قرار می‌گیرند.
.IP \fBoverlay\fR 4
.IX Item "overlay"
اطلاعاتی همانند \f(CW\*(C`parade\*(C'\fR ارائه می‌دهد، با این تفاوت که نمودارهای معرف مؤلفه‌های رنگ مستقیماً روی یکدیگر منطبق می‌شوند.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`stack\*(C'\fR است.
.RE
.IP \fBlevels_mode\fR 4
.IX Item "levels_mode"
تنظیم حالت سطوح. می‌تواند \f(CW\*(C`linear\*(C'\fR یا \f(CW\*(C`logarithmic\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`linear\*(C'\fR است.
.IP \fBcomponents\fR 4
.IX Item "components"
تنظیم اینکه کدام مؤلفه‌های رنگ نمایش داده شوند.
پیش‌فرض \f(CW7\fR است.
.IP \fBfgopacity\fR 4
.IX Item "fgopacity"
تنظیم میزان کدری پیش‌زمینه. پیش‌فرض \f(CW0.7\fR است.
.IP \fBbgopacity\fR 4
.IX Item "bgopacity"
تنظیم میزان کدری پس‌زمینه. پیش‌فرض \f(CW0.5\fR است.
.IP \fBcolors_mode\fR 4
.IX Item "colors_mode"
تنظیم حالت رنگ‌ها.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBwhiteonblack\fR 4
.IX Item "whiteonblack"
.PD 0
.IP \fBblackonwhite\fR 4
.IX Item "blackonwhite"
.IP \fBwhiteongray\fR 4
.IX Item "whiteongray"
.IP \fBblackongray\fR 4
.IX Item "blackongray"
.IP \fBcoloronblack\fR 4
.IX Item "coloronblack"
.IP \fBcoloronwhite\fR 4
.IX Item "coloronwhite"
.IP \fBcolorongray\fR 4
.IX Item "colorongray"
.IP \fBblackoncolor\fR 4
.IX Item "blackoncolor"
.IP \fBwhiteoncolor\fR 4
.IX Item "whiteoncolor"
.IP \fBgrayoncolor\fR 4
.IX Item "grayoncolor"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`whiteonblack\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
محاسبه و ترسیم هیستوگرام:
.Sp
.Vb 1
\&        ffplay \-i input \-vf histogram
.Ve
.SS hqdn3d
.IX Subsection "hqdn3d"
این یک فیلتر کاهش نوفه (نویززدایی) سه‌بعدی با کیفیت/دقت بالا است. هدف آن کاهش نویز تصویر، تولید تصاویر نرم و بی‌حرکت ساختن واقعی تصاویر ثابت است. این فیلتر باید قابلیت فشرده‌سازی را بهبود بخشد.
.PP
این فیلتر پارامترهای اختیاری زیر را می‌پذیرد:
.IP \fBluma_spatial\fR 4
.IX Item "luma_spatial"
یک عدد ممیز شناور نامنفی که قدرت مکانی لوما را تعیین می‌کند. پیش‌فرض آن 4.0 است.
.IP \fBchroma_spatial\fR 4
.IX Item "chroma_spatial"
یک عدد ممیز شناور نامنفی که قدرت مکانی کروما را تعیین می‌کند. پیش‌فرض آن 3.0*\fIluma_spatial\fR/4.0 است.
.IP \fBluma_tmp\fR 4
.IX Item "luma_tmp"
یک عدد ممیز شناور که قدرت زمانی لوما را تعیین می‌کند. پیش‌فرض آن 6.0*\fIluma_spatial\fR/4.0 است.
.IP \fBchroma_tmp\fR 4
.IX Item "chroma_tmp"
یک عدد ممیز شناور که قدرت زمانی کروما را تعیین می‌کند. پیش‌فرض آن \fIluma_tmp\fR*\fIchroma_spatial\fR/\fIluma_spatial\fR است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از \fBدستوراتی\fR (\fBcommands\fR) مشابه با گزینه‌ها پشتیبانی می‌کند.
دستور همان نحو گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار فعلی خود باقی می‌ماند.
.SS hwdownload
.IX Subsection "hwdownload"
دانلود فریم‌های سخت‌افزاری به حافظه سیستم.
.PP
ورودی باید به‌صورت فریم‌های سخت‌افزاری و خروجی یک فرمت غیر سخت‌افزاری باشد. همه فرمت‌ها در خروجی پشتیبانی نخواهند شد \- ممکن است لازم باشد بلافاصله پس از آن در گراف یک فیلتر \fBformat\fR اضافی درج شود تا خروجی در یک فرمت پشتیبانی‌شده به دست آید.
.SS hwmap
.IX Subsection "hwmap"
نگاشت فریم‌های سخت‌افزاری به حافظه سیستم یا به دستگاهی دیگر.
.PP
این فیلتر چندین حالت عملکردی مختلف دارد؛ اینکه کدام‌یک استفاده شود به فرمت‌های ورودی و خروجی بستگی دارد:
.IP \(bu 4
ورودی فریم سخت‌افزاری، خروجی فریم عادی
.Sp
فریم‌های ورودی را به حافظه سیستم نگاشت کرده و آن‌ها را به خروجی ارسال می‌کند. اگر فریم سخت‌افزاری اصلی بعداً مورد نیاز باشد (برای مثال، پس از قرار دادن لایه روی بخشی از آن)، فیلتر \fBhwmap\fR می‌تواند مجدداً در حالت بعدی برای بازیابی آن استفاده شود.
.IP \(bu 4
ورودی فریم عادی، خروجی فریم سخت‌افزاری
.Sp
اگر ورودی در واقع یک فریم سخت‌افزاری نگاشت‌شده با نرم‌افزار باشد، آن را لغو نگاشت (unmap) می‌کند \- یعنی فریم سخت‌افزاری اصلی را بازمی‌گرداند.
.Sp
در غیر این صورت، باید یک دستگاه مشخص شود. ایجاد سطوح سخت‌افزاری جدید بر روی آن دستگاه برای خروجی، سپس نگاشت مجدد آن‌ها به فرمت نرم‌افزاری در ورودی و ارسال آن فریم‌ها به فیلتر قبلی. این عمل سپس شبیه فیلتر \fBhwupload\fR رفتار خواهد کرد، اما ممکن است زمانی که ورودی از قبل در یک فرمت سازگار باشد بتواند از یک کپی اضافی جلوگیری نماید.
.IP \(bu 4
ورودی و خروجی فریم سخت‌افزاری
.Sp
باید دستگاهی برای خروجی عرضه شود، خواه به‌طور مستقیم یا با گزینه \fBderive_device\fR. دستگاه‌های ورودی و خروجی باید از انواع متفاوتی بوده و سازگار باشند \- معنای دقیق این امر وابسته به سیستم است، اما معمولاً به این معنی است که آن‌ها باید به همان زمینه سخت‌افزاری زیرین ارجاع دهند (برای نمونه، به همان کارت گرافیک اشاره داشته باشند).
.Sp
اگر فریم‌های ورودی در ابتدا روی دستگاه خروجی ایجاد شده بودند، برای بازیابی فریم‌های اصلی لغو نگاشت انجام دهید.
.Sp
در غیر این صورت، فریم‌ها را به دستگاه خروجی نگاشت کنید \- فریم‌های سخت‌افزاری جدیدی روی خروجی متناظر با فریم‌های ورودی ایجاد کنید.
.PP
پارامترهای اضافی زیر پذیرفته می‌شوند:
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت نگاشت فریم. ترکیبی از:
.RS 4
.IP \fIread\fR 4
.IX Item "read"
فریم نگاشت‌شده باید قابل خواندن باشد.
.IP \fIwrite\fR 4
.IX Item "write"
فریم نگاشت‌شده باید قابل نوشتن باشد.
.IP \fIoverwrite\fR 4
.IX Item "overwrite"
نگاشت همیشه کل فریم را بازنویسی خواهد کرد.
.Sp
این ممکن است در برخی موارد عملکرد را بهبود بخشد، زیرا نیازی به بارگذاری محتویات اصلی فریم نیست.
.IP \fIdirect\fR 4
.IX Item "direct"
نگاشت نباید هیچ‌گونه کپی‌برداری را شامل شود.
.Sp
نگاشت‌های غیرمستقیم به کپی‌هایی از فریم‌ها در مواردی ایجاد می‌شوند که یا نگاشت مستقیم ممکن نیست یا ویژگی‌های غیرمنتظره‌ای دارد. تنظیم این پرچم تضمین می‌کند که نگاشت به‌صورت مستقیم باشد و اگر این امکان‌پذیر نباشد با شکست مواجه می‌شود.
.RE
.RS 4
.Sp
در صورت عدم تعیین، پیش‌فرض \fIread+write\fR است.
.RE
.IP "\fBderive_device\fR \fItype\fR" 4
.IX Item "derive_device type"
به‌جای استفاده از دستگاه ارائه‌شده هنگام مقداردهی اولیه، یک دستگاه جدید از نوع \fItype\fR را از دستگاهی که فریم‌های ورودی روی آن قرار دارند مشتق می‌کند.
.IP \fBreverse\fR 4
.IX Item "reverse"
در نگاشت سخت‌افزار به سخت‌افزار، نگاشت به‌صورت معکوس انجام شود \- فریم‌ها در مقصد (sink) ایجاد شده و به مبدا بازگردانده شوند. این ممکن است در برخی موارد لازم باشد که نگاشت در یک جهت مورد نیاز است اما تنها جهت مخالف توسط دستگاه‌های مورد استفاده پشتیبانی می‌شود.
.Sp
این گزینه خطرناک است \- در صورتی که هرگونه محدودیت اضافی روی خروجی فیلتر قبلی وجود داشته باشد، ممکن است آن فیلتر را به روش‌های تعریف‌نشده‌ای خراب کند. بدون درک کامل پیامدهای استفاده از آن، از این گزینه استفاده نکنید.
.SS hwupload
.IX Subsection "hwupload"
بارگذاری فریم‌های حافظه سیستم بر روی سطوح سخت‌افزاری.
.PP
دستگاه مورد نظر برای بارگذاری باید هنگام مقداردهی اولیه فیلتر مشخص شود. در صورت استفاده از ffmpeg، دستگاه مناسب را با گزینه \fB\-filter_hw_device\fR یا گزینه \fBderive_device\fR انتخاب کنید. دستگاه‌های ورودی و خروجی باید از انواع متفاوتی بوده و سازگار باشند \- معنای دقیق این وابسته به سیستم است، اما معمولاً به این معنی است که آن‌ها باید به همان زمینه سخت‌افزاری زیرین ارجاع دهند (برای نمونه، به همان کارت گرافیک اشاره داشته باشند).
.PP
پارامترهای اضافی زیر پذیرفته می‌شوند:
.IP "\fBderive_device\fR \fItype\fR" 4
.IX Item "derive_device type"
به‌جای استفاده از دستگاه ارائه‌شده هنگام مقداردهی اولیه، یک دستگاه جدید از نوع \fItype\fR را از دستگاهی که فریم‌های ورودی روی آن قرار دارند مشتق می‌کند.
.SS hwupload_cuda
.IX Subsection "hwupload_cuda"
بارگذاری فریم‌های حافظه سیستم بر روی یک دستگاه CUDA.
.PP
پارامترهای اختیاری زیر را می‌پذیرد:
.IP \fBdevice\fR 4
.IX Item "device"
شماره دستگاه CUDA جهت استفاده
.SS hqx
.IX Subsection "hqx"
اعمال یک فیلتر بزرگ‌نمایی با کیفیت بالا که برای هنر پیکسلی (pixel art) طراحی شده است. این فیلتر در اصل توسط Maxim Stepin ایجاد شد.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم بعد مقیاس‌بندی: \f(CW2\fR برای \f(CW\*(C`hq2x\*(C'\fR، \f(CW3\fR برای
\&\f(CW\*(C`hq3x\*(C'\fR و \f(CW4\fR برای \f(CW\*(C`hq4x\*(C'\fR.
پیش‌فرض \f(CW3\fR است.
.SS hstack
.IX Subsection "hstack"
چیدن افقی (کنار هم قرار دادن) ویدیوهای ورودی.
.PP
تمامی جریان‌ها باید دارای فرمت پیکسلی یکسان و ارتفاع یکسان باشند.
.PP
توجه داشته باشید که این فیلتر سریع‌تر از استفاده از فیلترهای \fBoverlay\fR و \fBpad\fR برای ایجاد همان خروجی است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد جریان‌های ورودی. پیش‌فرض 2 است.
.IP \fBshortest\fR 4
.IX Item "shortest"
در صورت تنظیم روی 1، خروجی را مجبور می‌کند زمانی که کوتاه‌ترین ورودی به پایان برسد، پایان یابد. مقدار پیش‌فرض 0 است.
.SS hsvhold
.IX Subsection "hsvhold"
تبدیل یک محدوده مشخص HSV به مقادیر خاکستری.
.PP
این فیلتر تفاوت رنگ میان رنگ HSV تنظیم‌شده در گزینه‌ها و رنگ‌های اندازه‌گیری‌شده در جریان ویدیو را اندازه می‌گیرد. بسته به گزینه‌ها، رنگ‌های خروجی را می‌توان به خاکستری تغییر داد یا خیر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBhue\fR 4
.IX Item "hue"
تنظیم مقدار فام که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-360 تا 360 است. مقدار پیش‌فرض 0 است.
.IP \fBsat\fR 4
.IX Item "sat"
تنظیم مقدار اشباع که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-1 تا 1 است. مقدار پیش‌فرض 0 است.
.IP \fBval\fR 4
.IX Item "val"
تنظیم مقدار روشنایی (value) که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-1 تا 1 است. مقدار پیش‌فرض 0 است.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
تنظیم درصد شباهت با رنگ کلیدی.
محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 0.01 است.
.Sp
مقدار 0.00001 تنها دقیقاً با رنگ کلیدی تطابق دارد، در حالی که 1.0 با همه چیز مطابقت پیدا می‌کند.
.IP \fBblend\fR 4
.IX Item "blend"
درصد ترکیب (blend).
محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 0 است.
.Sp
مقدار 0.0 باعث می‌شود پیکسل‌ها یا کاملاً خاکستری باشند یا اصلاً خاکستری نباشند.
.Sp
مقادیر بالاتر منجر به پیکسل‌های خاکستری بیشتری می‌شوند، به طوری که هرچه رنگ پیکسل‌ها به رنگ کلیدی شبیه‌تر باشد، پیکسل خاکستری‌تر خواهد بود.
.SS hsvkey
.IX Subsection "hsvkey"
تبدیل یک محدوده مشخص HSV به شفافیت.
.PP
این فیلتر تفاوت رنگ میان رنگ HSV تنظیم‌شده در گزینه‌ها و رنگ‌های اندازه‌گیری‌شده در جریان ویدیو را اندازه می‌گیرد. بسته به گزینه‌ها، رنگ‌های خروجی را می‌توان با افزودن کانال آلفا به شفاف تغییر داد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBhue\fR 4
.IX Item "hue"
تنظیم مقدار فام که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-360 تا 360 است. مقدار پیش‌فرض 0 است.
.IP \fBsat\fR 4
.IX Item "sat"
تنظیم مقدار اشباع که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-1 تا 1 است. مقدار پیش‌فرض 0 است.
.IP \fBval\fR 4
.IX Item "val"
تنظیم مقدار روشنایی که در محاسبه تفاوت رنگ استفاده خواهد شد.
محدوده مجاز از \-1 تا 1 است. مقدار پیش‌فرض 0 است.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
تنظیم درصد شباهت با رنگ کلیدی.
محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 0.01 است.
.Sp
مقدار 0.00001 تنها دقیقاً با رنگ کلیدی تطابق دارد، در حالی که 1.0 با همه چیز مطابقت پیدا می‌کند.
.IP \fBblend\fR 4
.IX Item "blend"
درصد ترکیب.
محدوده مجاز از 0 تا 1 است. مقدار پیش‌فرض 0 است.
.Sp
مقدار 0.0 باعث می‌شود پیکسل‌ها یا کاملاً شفاف باشند یا اصلاً شفاف نباشند.
.Sp
مقادیر بالاتر منجر به پیکسل‌های نیمه‌شفاف می‌شوند، به طوری که هرچه رنگ پیکسل‌ها به رنگ کلیدی شبیه‌تر باشد، شفافیت بیشتر خواهد بود.
.SS hue
.IX Subsection "hue"
تغییر دادن فام و/یا اشباع ورودی.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBh\fR 4
.IX Item "h"
زاویه فام را بر حسب درجه مشخص می‌کند. یک عبارت را می‌پذیرد و پیش‌فرض آن "0" است.
.IP \fBs\fR 4
.IX Item "s"
اشباع را در محدوده [\-10,10] مشخص می‌کند. یک عبارت را می‌پذیرد و پیش‌فرض آن "1" است.
.IP \fBH\fR 4
.IX Item "H"
زاویه فام را بر حسب رادیان مشخص می‌کند. یک عبارت را می‌پذیرد و پیش‌فرض آن "0" است.
.IP \fBb\fR 4
.IX Item "b"
روشنایی (brightness) را در محدوده [\-10,10] مشخص می‌کند. یک عبارت را می‌پذیرد و پیش‌فرض آن "0" است.
.PP
گزینه‌های \fBh\fR و \fBH\fR مانعة‌الجمع هستند و نمی‌توان آن‌ها را همزمان مشخص کرد.
.PP
مقادیر گزینه‌های \fBb\fR، \fBh\fR، \fBH\fR و \fBs\fR عباراتی حاوی ثابت‌های زیر هستند:
.IP \fBn\fR 4
.IX Item "n"
شمارش فریم ورودی با شروع از 0
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمانی نمایش فریم ورودی بیان‌شده در واحدهای پایه زمانی
.IP \fBr\fR 4
.IX Item "r"
نرخ فریم ویدیوی ورودی، NAN در صورتی که نرخ فریم ورودی نامشخص باشد
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بیان‌شده بر حسب ثانیه، NAN در صورتی که برچسب زمانی ورودی نامشخص باشد
.IP \fBtb\fR 4
.IX Item "tb"
پایه زمانی ویدیوی ورودی
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تنظیم فام روی 90 درجه و اشباع روی 1.0:
.Sp
.Vb 1
\&        hue=h=90:s=1
.Ve
.IP \(bu 4
همان دستور اما با بیان فام بر حسب رادیان:
.Sp
.Vb 1
\&        hue=H=PI/2:s=1
.Ve
.IP \(bu 4
چرخاندن فام و نوسان دادن اشباع میان 0 و 2 در طول مدت‌زمان 1 ثانیه:
.Sp
.Vb 1
\&        hue="H=2*PI*t: s=sin(2*PI*t)+1"
.Ve
.IP \(bu 4
اعمال یک جلوه محو شدن تدریجی (fade\-in) اشباع ۳ ثانیه‌ای با شروع از 0:
.Sp
.Vb 1
\&        hue="s=min(t/3\e,1)"
.Ve
.Sp
عبارت کلی fade\-in را می‌توان به‌صورت زیر نوشت:
.Sp
.Vb 1
\&        hue="s=min(0\e, max((t\-START)/DURATION\e, 1))"
.Ve
.IP \(bu 4
اعمال یک جلوه ناپدید شدن تدریجی (fade\-out) اشباع ۳ ثانیه‌ای با شروع از ثانیه ۵:
.Sp
.Vb 1
\&        hue="s=max(0\e, min(1\e, (8\-t)/3))"
.Ve
.Sp
عبارت کلی fade\-out را می‌توان به‌صورت زیر نوشت:
.Sp
.Vb 1
\&        hue="s=max(0\e, min(1\e, (START+DURATION\-t)/DURATION))"
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBb\fR 4
.IX Item "b"
.PD 0
.IP \fBs\fR 4
.IX Item "s"
.IP \fBh\fR 4
.IX Item "h"
.IP \fBH\fR 4
.IX Item "H"
.PD
تغییر دادن فام و/یا اشباع و/یا روشنایی ویدیوی ورودی.
دستور همان نحو گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت مشخص‌شده معتبر نباشد، در مقدار فعلی خود باقی می‌ماند.
.SS huesaturation
.IX Subsection "huesaturation"
اعمال تنظیمات فام\-اشباع\-شدت روی جریان ویدیوی ورودی.
.PP
این فیلتر در فضای رنگی RGB عمل می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBhue\fR 4
.IX Item "hue"
تنظیم میزان جابجایی فام بر حسب درجه برای اعمال. پیش‌فرض 0 است.
محدوده مجاز از \-180 تا 180 است.
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم میزان جابجایی اشباع. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBintensity\fR 4
.IX Item "intensity"
تنظیم میزان جابجایی شدت. پیش‌فرض 0 است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBcolors\fR 4
.IX Item "colors"
تعیین اینکه کدام رنگ‌های اصلی و مکمل تنظیم خواهند شد.
این گزینه با ارائه یک یا چند مقدار تنظیم می‌شود.
این می‌تواند چندین رنگ را به‌طور همزمان انتخاب کند. به‌طور پیش‌فرض تمام رنگ‌ها انتخاب شده‌اند.
.RS 4
.IP \fBr\fR 4
.IX Item "r"
تنظیم قرمزها.
.IP \fBy\fR 4
.IX Item "y"
تنظیم زردها.
.IP \fBg\fR 4
.IX Item "g"
تنظیم سبزها.
.IP \fBc\fR 4
.IX Item "c"
تنظیم فیروزه‌ای‌ها (سیان).
.IP \fBb\fR 4
.IX Item "b"
تنظیم آبی‌ها.
.IP \fBm\fR 4
.IX Item "m"
تنظیم سرخابی‌ها (ماژنتا).
.IP \fBa\fR 4
.IX Item "a"
تنظیم تمام رنگ‌ها.
.RE
.RS 4
.RE
.IP \fBstrength\fR 4
.IX Item "strength"
تنظیم قدرت فیلترسازی. محدوده مجاز از 0 تا 100 است.
مقدار پیش‌فرض 1 است.
.IP "\fBrw, gw, bw\fR" 4
.IX Item "rw, gw, bw"
تنظیم وزن برای هر مؤلفه RGB. محدوده مجاز از 0 تا 1 است.
به‌طور پیش‌فرض روی 0.333، 0.334، 0.333 تنظیم شده است.
این گزینه‌ها در پردازش اشباع و روشنایی استفاده می‌شوند.
.IP \fBlightness\fR 4
.IX Item "lightness"
تنظیم حفظ روشنایی؛ به‌طور پیش‌فرض غیرفعال است.
تنظیم فام‌ها می‌تواند روشنایی را نسبت به سه‌گانه اصلی RGB تغییر دهد،
با فعال بودن این گزینه روشنایی در همان مقدار حفظ می‌شود.
.SS hysteresis
.IX Subsection "hysteresis"
رشد دادن جریان اول درون جریان دوم با متصل کردن مؤلفه‌ها.
این امر امکان ساخت ماسک‌های لبه پایدارتر و مستحکم‌تر را فراهم می‌سازد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام پلان‌ها به‌صورت تصویر بیتی (bitmap) پردازش خواهند شد؛ پلان‌های پردازش‌نشده از جریان اول کپی می‌شوند.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلان‌ها پردازش خواهند شد.
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه مورد استفاده در فیلترسازی. اگر مقدار مؤلفه پیکسل بالاتر از این مقدار باشد، الگوریتم فیلتر برای اتصال مؤلفه‌ها فعال می‌شود.
مقدار پیش‌فرض 0 است.
.PP
فیلتر \f(CW\*(C`hysteresis\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.SS iccdetect
.IX Subsection "iccdetect"
تشخیص فضای رنگی از روی یک پروفایل ICC جاسازی‌شده (در صورت وجود)، و به‌روزرسانی متناظر برچسب‌های (تگ‌های) فریم.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBforce\fR 4
.IX Item "force"
در صورت درست بودن (true)، تگ‌های فضای رنگی موجود در فریم همواره با مقادیر تشخیص داده شده از یک پروفایل ICC بازنویسی می‌شوند. در غیر این صورت، تنها زمانی تخصیص داده می‌شوند که حاوی \f(CW\*(C`unknown\*(C'\fR باشند. به‌طور پیش‌فرض فعال است.
.SS iccgen
.IX Subsection "iccgen"
تولید پروفایل‌های ICC و پیوست کردن آن‌ها به فریم‌ها.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
.PD 0
.IP \fBcolor_trc\fR 4
.IX Item "color_trc"
.PD
پیکربندی فضای رنگی که پروفایل ICC برای آن تولید خواهد شد. مقدار پیش‌فرض
\&\f(CW\*(C`auto\*(C'\fR این مقدار را از متادیتای فریم ورودی استنتاج می‌کند، که بر حسب مورد به‌طور پیش‌فرض BT.709/sRGB در نظر گرفته می‌شود.
.Sp
فیلتر \fBsetparams\fR را برای فهرستی از مقادیر ممکن مشاهده کنید، اما توجه داشته باشید که \f(CW\*(C`unknown\*(C'\fR برای این فیلتر یک مقدار معتبر به شمار نمی‌رود.
.IP \fBforce\fR 4
.IX Item "force"
در صورت درست بودن (true)، یک پروفایل ICC حتی اگر یک پروفایل ICC از پیش موجود را بازنویسی کند، تولید خواهد شد. به‌طور پیش‌فرض غیرفعال است.
.SS identity
.IX Subsection "identity"
به دست آوردن امتیاز همانی (identity score) میان دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی می‌گیرد.
.PP
هر دو ویدیوی ورودی باید رزولوشن و فرمت پیکسلی یکسانی داشته باشند تا این فیلتر به‌درستی کار کند. همچنین فرض می‌شود که هر دو ورودی تعداد فریم یکسانی دارند که تک‌به‌تک با یکدیگر مقایسه می‌شوند.
.PP
امتیاز همانی به دست آمده به ازای هر مؤلفه، میانگین، کمینه و بیشینه از طریق سیستم لاگ چاپ می‌شود.
.PP
این فیلتر امتیازهای همانی محاسبه‌شده برای هر فریم را در متادیتای فریم ذخیره می‌کند.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
در مثال زیر، فایل ورودی \fImain.mpg\fR در حال پردازش با فایل مرجع \fIref.mpg\fR مقایسه می‌شود.
.PP
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mpg \-lavfi identity \-f null \-
.Ve
.SS idet
.IX Subsection "idet"
تشخیص نوع درهم‌بافتگی (interlacing) ویدیو.
.PP
این فیلتر تلاش می‌کند تشخیص دهد که آیا فریم‌های ورودی درهم‌بافته (interlaced)، پیش‌رونده (progressive)، فیلد بالا اول (top field first) یا فیلد پایین اول (bottom field first) هستند. همچنین تلاش می‌کند فیلدهایی که میان فریم‌های مجاور تکرار شده‌اند (نشانه‌ای از تله‌سینه) را تشخیص دهد.
.PP
تشخیص تک‌فریمی تنها فریم‌های بلافاصله مجاور را هنگام طبقه‌بندی هر فریم در نظر می‌گیرد.
تشخیص چندفریمی تاریخچه طبقه‌بندی فریم‌های قبلی را در بر می‌گیرد.
.PP
این فیلتر این مقادیر متادیتا را در لاگ ثبت خواهد کرد:
.IP \fBsingle.current_frame\fR 4
.IX Item "single.current_frame"
نوع فریم جاری تشخیص داده شده با استفاده از تشخیص تک‌فریمی. یکی از موارد:
\&\`\`tff\*(Aq\*(Aq (فیلد بالا اول)، \`\`bff\*(Aq\*(Aq (فیلد پایین اول)،
\&\`\`progressive\*(Aq\*(Aq، یا \`\`undetermined\*(Aq\*(Aq
.IP \fBsingle.tff\fR 4
.IX Item "single.tff"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان فیلد بالا اول با استفاده از تشخیص تک‌فریمی.
.IP \fBmultiple.tff\fR 4
.IX Item "multiple.tff"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان فیلد بالا اول با استفاده از تشخیص چندفریمی.
.IP \fBsingle.bff\fR 4
.IX Item "single.bff"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان فیلد پایین اول با استفاده از تشخیص تک‌فریمی.
.IP \fBmultiple.current_frame\fR 4
.IX Item "multiple.current_frame"
نوع فریم جاری تشخیص داده شده با استفاده از تشخیص چندفریمی. یکی از موارد:
\&\`\`tff\*(Aq\*(Aq (فیلد بالا اول)، \`\`bff\*(Aq\*(Aq (فیلد پایین اول)،
\&\`\`progressive\*(Aq\*(Aq، یا \`\`undetermined\*(Aq\*(Aq
.IP \fBmultiple.bff\fR 4
.IX Item "multiple.bff"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان فیلد پایین اول با استفاده از تشخیص چندفریمی.
.IP \fBsingle.progressive\fR 4
.IX Item "single.progressive"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان progressive با استفاده از تشخیص تک‌فریمی.
.IP \fBmultiple.progressive\fR 4
.IX Item "multiple.progressive"
تعداد تجمعی فریم‌های تشخیص داده شده به عنوان progressive با استفاده از تشخیص چندفریمی.
.IP \fBsingle.undetermined\fR 4
.IX Item "single.undetermined"
تعداد تجمعی فریم‌هایی که با استفاده از تشخیص تک‌فریمی قابل طبقه‌بندی نبودند.
.IP \fBmultiple.undetermined\fR 4
.IX Item "multiple.undetermined"
تعداد تجمعی فریم‌هایی که با استفاده از تشخیص چندفریمی قابل طبقه‌بندی نبودند.
.IP \fBrepeated.current_frame\fR 4
.IX Item "repeated.current_frame"
کدام فیلد در فریم جاری نسبت به فریم قبلی تکرار شده است. یکی از موارد \`\`neither\*(Aq\*(Aq، \`\`top\*(Aq\*(Aq، یا \`\`bottom\*(Aq\*(Aq.
.IP \fBrepeated.neither\fR 4
.IX Item "repeated.neither"
تعداد تجمعی فریم‌های بدون فیلد تکراری.
.IP \fBrepeated.top\fR 4
.IX Item "repeated.top"
تعداد تجمعی فریم‌هایی که فیلد بالای آن‌ها از فیلد بالای فریم قبلی تکرار شده است.
.IP \fBrepeated.bottom\fR 4
.IX Item "repeated.bottom"
تعداد تجمعی فریم‌هایی که فیلد پایین آن‌ها از فیلد پایین فریم قبلی تکرار شده است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBintl_thres\fR 4
.IX Item "intl_thres"
تنظیم آستانه درهم‌بافتگی.
.IP \fBprog_thres\fR 4
.IX Item "prog_thres"
تنظیم آستانه پیش‌رونده.
.IP \fBrep_thres\fR 4
.IX Item "rep_thres"
آستانه تشخیص فیلد تکراری.
.IP \fBhalf_life\fR 4
.IX Item "half_life"
تعداد فریم‌هایی که پس از آن سهم یک فریم مشخص در آمار نصف می‌شود (یعنی تنها 0.5 در طبقه‌بندی خود سهم خواهد داشت). پیش‌فرض 0 به این معناست که به تمام فریم‌های دیده‌شده وزن کامل 1.0 برای همیشه داده می‌شود.
.IP \fBanalyze_interlaced_flag\fR 4
.IX Item "analyze_interlaced_flag"
هنگامی که این مقدار 0 نباشد، idet از تعداد فریم‌های مشخص‌شده برای تعیین اینکه آیا پرچم درهم‌بافتگی دقیق است یا خیر استفاده می‌کند؛ فریم‌های نامشخص شمرده نخواهند شد. اگر پرچم دقیق تشخیص داده شود، بدون هیچ‌گونه محاسبات بیشتر استفاده خواهد شد، و چنانچه نادرست تشخیص داده شود، بدون هیچ‌گونه محاسبات بیشتر پاک خواهد شد. این امکان، درج فیلتر idet را به عنوان روشی با بار محاسباتی کم جهت پاکسازی پرچم درهم‌بافتگی فراهم می‌سازد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.PP
بررسی ترتیب فیلدهای ۳۶۰ فریم نخست در یک ویدیو با جزئیات کامل:
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-filter:v idet,metadata=mode=print \-frames:v 360 \-an \-f null \-
.Ve
.PP
فیلتر idet متادیتای تجزیه‌وتحلیل را به هر فریم اضافه می‌کند که سپس دور ریخته خواهد شد. در پایان، فیلتر همچنین یک گزارش نهایی همراه با آمار چاپ خواهد کرد.
.SS il
.IX Subsection "il"
جداسازی فیلدها (deinterleave) یا درهم‌آمیزی فیلدها (interleave).
.PP
این فیلتر امکان پردازش فیلدهای تصاویر درهم‌بافته را بدون انجام deinterlace بر روی آن‌ها فراهم می‌کند. جداسازی فیلدها فریم ورودی را به ۲ فیلد (به اصطلاح نیم‌تصویر) تقسیم می‌نماید. خطوط فرد به نیمه بالایی تصویر خروجی و خطوط زوج به نیمه پایینی منتقل می‌شوند. می‌توانید آن‌ها را به‌طور مستقل پردازش (فیلتر) کرده و سپس مجدداً درهم بیامیزید (re\-interleave کنید).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBluma_mode, l\fR" 4
.IX Item "luma_mode, l"
.PD 0
.IP "\fBchroma_mode, c\fR" 4
.IX Item "chroma_mode, c"
.IP "\fBalpha_mode, a\fR" 4
.IX Item "alpha_mode, a"
.PD
مقادیر موجود برای \fIluma_mode\fR، \fIchroma_mode\fR و \fIalpha_mode\fR عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
هیچ کاری انجام نده.
.IP "\fBdeinterleave, d\fR" 4
.IX Item "deinterleave, d"
جداسازی فیلدها، با قرار دادن یکی بالای دیگری.
.IP "\fBinterleave, i\fR" 4
.IX Item "interleave, i"
درهم‌آمیزی فیلدها. معکوس کردن اثر جداسازی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.RE
.IP "\fBluma_swap, ls\fR" 4
.IX Item "luma_swap, ls"
.PD 0
.IP "\fBchroma_swap, cs\fR" 4
.IX Item "chroma_swap, cs"
.IP "\fBalpha_swap, as\fR" 4
.IX Item "alpha_swap, as"
.PD
تعویض فیلدهای لوما/کروما/آلفا. جابجایی خطوط زوج و فرد. مقدار پیش‌فرض \f(CW0\fR است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS inflate
.IX Subsection "inflate"
اعمال جلوه اتساع (بادکردن) روی ویدیو.
.PP
این فیلتر پیکسل را با میانگین محلی (3x3) تنها با در نظر گرفتن مقادیر بالاتر از پیکسل جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن حداکثر تغییر برای هر پلان، پیش‌فرض 65535 است.
اگر 0 باشد، پلان بدون تغییر باقی خواهد ماند.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS "interlace, interlace_vulkan"
.IX Subsection "interlace, interlace_vulkan"
فیلتر درهم‌بافتن ساده از روی محتوای پیش‌رونده (progressive). این فیلتر خطوط بالایی (یا پایینی) فریم‌های فرد را با خطوط پایینی (یا بالایی) فریم‌های زوج در هم می‌آمیزد، نرخ فریم را نصف کرده و ارتفاع تصویر را حفظ می‌نماید.
.PP
.Vb 9
\&           Original        Original             New Frame
\&           Frame 'j'      Frame 'j+1'             (tff)
\&          ==========      ===========       ==================
\&            Line 0  -------------------->    Frame 'j' Line 0
\&            Line 1          Line 1  ---->   Frame 'j+1' Line 1
\&            Line 2 -------------------->    Frame 'j' Line 2
\&            Line 3          Line 3  ---->   Frame 'j+1' Line 3
\&             ...             ...                   ...
\&        New Frame + 1 will be generated by Frame 'j+2' and Frame 'j+3' and so on
.Ve
.PP
این فیلتر پارامترهای اختیاری زیر را می‌پذیرد:
.IP \fBscan\fR 4
.IX Item "scan"
تعیین می‌کند که آیا فریم درهم‌بافته از خطوط زوج (tff \- پیش‌فرض) یا فرد (bff) فریم پیش‌رونده گرفته شود.
.IP \fBlowpass\fR 4
.IX Item "lowpass"
فیلتر پایین‌گذر عمودی برای جلوگیری از لرزش ناشی از درهم‌بافتگی (twitter interlacing) و کاهش الگوهای موآره.
.RS 4
.IP "\fB0, off\fR" 4
.IX Item "0, off"
غیرفعال‌سازی فیلتر پایین‌گذر عمودی
.IP "\fB1, linear\fR" 4
.IX Item "1, linear"
فعال‌سازی فیلتر خطی (پیش‌فرض)
.IP "\fB2, complex\fR" 4
.IX Item "2, complex"
فعال‌سازی فیلتر پیچیده. این گزینه لرزش و موآره را اندکی کمتر کاهش می‌دهد اما جزئیات و احساس وضوح ذهنی را بهتر حفظ می‌کند.
.RE
.RS 4
.RE
.SS kerndeint
.IX Subsection "kerndeint"
تبدیل ویدیوی ورودی از حالت درهم‌بافته به پیش‌رونده (deinterlace) با اعمال روش انطباقی هسته Donald Graft. روی بخش‌های درهم‌بافته ویدیو کار می‌کند تا فریم‌های پیش‌رونده تولید نماید.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه آمده است:
.IP \fBthresh\fR 4
.IX Item "thresh"
تنظیم آستانه‌ای که بر میزان تحمل فیلتر هنگام تعیین اینکه آیا یک خط از پیکسل‌ها باید پردازش شود یا خیر، تأثیر می‌گذارد. باید یک عدد صحیح در محدوده [0,255] باشد و پیش‌فرض آن 10 است. مقدار 0 منجر به اعمال فرایند بر روی تک‌تک پیکسل‌ها خواهد شد.
.IP \fBmap\fR 4
.IX Item "map"
در صورت تنظیم روی 1، پیکسل‌هایی که از مقدار آستانه فراتر رفته‌اند را با رنگ سفید رنگ‌آمیزی می‌کند.
پیش‌فرض 0 است.
.IP \fBorder\fR 4
.IX Item "order"
تنظیم ترتیب فیلدها. در صورت تنظیم روی 1 فیلدها را جابجا می‌کند و در صورت تنظیم روی 0 فیلدها را دست‌نخورده باقی می‌گذارد. پیش‌فرض 0 است.
.IP \fBsharp\fR 4
.IX Item "sharp"
در صورت تنظیم روی 1، وضوح‌بخشی (sharpening) اضافی را فعال می‌کند. پیش‌فرض 0 است.
.IP \fBtwoway\fR 4
.IX Item "twoway"
در صورت تنظیم روی 1، وضوح‌بخشی دوطرفه را فعال می‌کند. پیش‌فرض 0 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال مقادیر پیش‌فرض:
.Sp
.Vb 1
\&        kerndeint=thresh=10:map=0:order=0:sharp=0:twoway=0
.Ve
.IP \(bu 4
فعال‌سازی وضوح‌بخشی اضافی:
.Sp
.Vb 1
\&        kerndeint=sharp=1
.Ve
.IP \(bu 4
رنگ‌آمیزی پیکسل‌های پردازش‌شده با رنگ سفید:
.Sp
.Vb 1
\&        kerndeint=map=1
.Ve
.SS kirsch
.IX Subsection "kirsch"
اعمال عملگر کرش (Kirsch) بر روی جریان ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام پلان‌ها پردازش خواهند شد، پلان‌های پردازش‌نشده کپی می‌شوند.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلان‌ها پردازش خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلتر ضرب خواهد شد.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلتر اضافه خواهد شد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS lagfun
.IX Subsection "lagfun"
به‌روزرسانی آرام پیکسل‌های تیره‌تر.
.PP
این فیلتر باعث می‌شود فلاش‌های کوتاه نور طولانی‌تر به نظر برسند.
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdecay\fR 4
.IX Item "decay"
تنظیم ضریب زوال (decay). پیش‌فرض .95 است. محدوده مجاز از 0 تا 1 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام پلان‌ها فیلتر شوند. پیش‌فرض همه است. محدوده مجاز از 0 تا 15 است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS lenscorrection
.IX Subsection "lenscorrection"
تصحیح اعوجاج شعاعی لنز.
.PP
این فیلتر می‌تواند برای تصحیح اعوجاج شعاعی که در اثر استفاده از لنزهای واید (زاویه باز) حاصل می‌شود و در نتیجه راست‌نمایی دوباره تصویر استفاده شود. برای یافتن پارامترهای مناسب می‌توان از ابزارهای موجود، برای نمونه به عنوان بخشی از opencv، یا به‌سادگی از روش آزمون و خطا استفاده کرد. برای استفاده از opencv از نمونه کالیبراسیون (زیر samples/cpp) در سورس‌های opencv استفاده کرده و ضرایب k1 و k2 را از ماتریس حاصل استخراج کنید.
.PP
توجه داشته باشید که عملاً همین فیلتر در ابزارهای منبع‌باز Krita و Digikam از پروژه KDE در دسترس است.
.PP
برخلاف فیلتر \fBvignette\fR که می‌تواند برای جبران خطاهای لنز نیز به کار رود، این فیلتر اعوجاج تصویر را تصحیح می‌کند، در حالی که \fBvignette\fR توزیع روشنایی را اصلاح می‌نماید؛ بنابراین ممکن است بخواهید در برخی موارد هر دو فیلتر را با هم استفاده کنید، هرچند باید به ترتیب آن‌ها توجه داشته باشید، یعنی اینکه وینیتینگ باید قبل یا بعد از تصحیح لنز اعمال شود.
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcx\fR 4
.IX Item "cx"
مختصات نسبی x نقطه کانونی تصویر، و در نتیجه مرکز اعوجاج. این مقدار بازه [0,1] دارد و به‌صورت کسری از عرض تصویر بیان می‌شود. پیش‌فرض 0.5 است.
.IP \fBcy\fR 4
.IX Item "cy"
مختصات نسبی y نقطه کانونی تصویر، و در نتیجه مرکز اعوجاج. این مقدار بازه [0,1] دارد و به‌صورت کسری از ارتفاع تصویر بیان می‌شود. پیش‌فرض 0.5 است.
.IP \fBk1\fR 4
.IX Item "k1"
ضریب عبارت تصحیح درجه دو. این مقدار بازه [\-1,1] دارد. 0 به معنای عدم تصحیح است. پیش‌فرض 0 است.
.IP \fBk2\fR 4
.IX Item "k2"
ضریب عبارت تصحیح درجه دو مضاعف. این مقدار بازه [\-1,1] دارد. 0 به معنای عدم تصحیح است. پیش‌فرض 0 است.
.IP \fBi\fR 4
.IX Item "i"
تنظیم نوع درون‌یابی. می‌تواند \f(CW\*(C`nearest\*(C'\fR یا \f(CW\*(C`bilinear\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`nearest\*(C'\fR است.
.IP \fBfc\fR 4
.IX Item "fc"
تعیین رنگ پیکسل‌های نگاشت‌نشده. برای نحو این گزینه،
\&\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
رنگ پیش‌فرض \f(CW\*(C`black@0\*(C'\fR است.
.PP
فرمولی که تصحیح را تولید می‌کند به شرح زیر است:
.PP
\&\fIr_src\fR = \fIr_tgt\fR * (1 + \fIk1\fR * (\fIr_tgt\fR / \fIr_0\fR)^2 + \fIk2\fR * (\fIr_tgt\fR / \fIr_0\fR)^4)
.PP
که در آن \fIr_0\fR نصف قطر تصویر است و \fIr_src\fR و \fIr_tgt\fR به ترتیب فواصل از نقطه کانونی در تصاویر سورس و هدف هستند.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.SS lensfun
.IX Subsection "lensfun"
اعمال تصحیح لنز از طریق کتابخانه lensfun (<\fBhttp://lensfun.sourceforge.net\fR>).
.PP
فیلتر \f(CW\*(C`lensfun\*(C'\fR برای اعمال تصحیح لنز به سازنده دوربین، مدل دوربین و مدل لنز نیاز دارد. این فیلتر پایگاه‌داده lensfun را بارگذاری کرده و برای یافتن مدخل‌های دوربین و لنز متناظر در پایگاه‌داده آن را جستجو می‌نماید. تا زمانی که این مدخل‌ها با گزینه‌های داده‌شده یافت شوند، فیلتر می‌تواند تصحیحات را روی فریم‌ها انجام دهد. توجه داشته باشید که رشته‌های ناقص باعث می‌شوند فیلتر بهترین تطابق را با گزینه‌های داده‌شده انتخاب کند و فیلتر مدل‌های انتخاب‌شده دوربین و لنز را در خروجی لاگ می‌نماید (با سطح "info"). شما باید سازنده، مدل دوربین و مدل لنز را مشخص کنید چرا که این موارد الزامی هستند.
.PP
برای به دست آوردن فهرستی از سازندگان و مدل‌های موجود، یکی از گزینه‌های \f(CW\*(C`make\*(C'\fR یا \f(CW\*(C`model\*(C'\fR یا هر دوی آن‌ها را خالی بگذارید. فیلتر فهرست کامل را با سطح \f(CW\*(C`INFO\*(C'\fR به لاگ ارسال خواهد کرد. ستون نخست سازنده و ستون دوم مدل است. برای دریافت فهرستی از لنزهای موجود، مقادیر دلخواهی برای سازنده و مدل تعیین کرده و گزینه \f(CW\*(C`lens_model\*(C'\fR را خالی بگذارید. فیلتر فهرست کامل لنزها را با سطح \f(CW\*(C`INFO\*(C'\fR در لاگ ارسال خواهد کرد. ابزار ffmpeg پس از چاپ این فهرست خارج می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmake\fR 4
.IX Item "make"
سازنده دوربین (برای نمونه، "Canon"). این گزینه الزامی است.
.IP \fBmodel\fR 4
.IX Item "model"
مدل دوربین (برای نمونه، "Canon EOS 100D"). این گزینه الزامی است.
.IP \fBlens_model\fR 4
.IX Item "lens_model"
مدل لنز (برای نمونه، "Canon EF\-S 18\-55mm f/3.5\-5.6 IS STM"). این گزینه الزامی است.
.IP \fBdb_path\fR 4
.IX Item "db_path"
مسیر کامل به پوشه پایگاه‌داده لنز. در صورت عدم تنظیم، فیلتر تلاش می‌کند پایگاه‌داده را از مسیر نصب هنگام کامپایل کتابخانه بارگذاری کند. پیش‌فرض تنظیم‌نشده است.
.IP \fBmode\fR 4
.IX Item "mode"
نوع تصحیح برای اعمال. مقادیر زیر گزینه‌های معتبر هستند:
.RS 4
.IP \fBvignetting\fR 4
.IX Item "vignetting"
فعال‌سازی رفع تیرگی حاشیه (vignetting) لنز.
.IP \fBgeometry\fR 4
.IX Item "geometry"
فعال‌سازی اصلاح هندسه لنز. این حالت پیش‌فرض است.
.IP \fBsubpixel\fR 4
.IX Item "subpixel"
فعال‌سازی اصلاح انحراف رنگی (chromatic aberrations).
.IP \fBvig_geo\fR 4
.IX Item "vig_geo"
فعال‌سازی اصلاح تیرگی حاشیه لنز و هندسه لنز.
.IP \fBvig_subpixel\fR 4
.IX Item "vig_subpixel"
فعال‌سازی اصلاح تیرگی حاشیه لنز و انحراف رنگی.
.IP \fBdistortion\fR 4
.IX Item "distortion"
فعال‌سازی اصلاح همزمان هندسه لنز و انحراف رنگی.
.IP \fBall\fR 4
.IX Item "all"
فعال‌سازی تمامی تصحیحات ممکن.
.RE
.RS 4
.RE
.IP \fBfocal_length\fR 4
.IX Item "focal_length"
فاصله کانونی تصویر/ویدیو (بزرگ‌نمایی؛ برای ویدیو ثابت فرض می‌شود). برای نمونه، یک لنز 18\-\-55mm دارای محدوده فاصله کانونی [18\-\-55] است، بنابراین هنگام استفاده از آن لنز باید مقداری در آن بازه انتخاب شود. پیش‌فرض 18 است.
.IP \fBaperture\fR 4
.IX Item "aperture"
دیافراگم تصویر/ویدیو (برای ویدیو ثابت فرض می‌شود). توجه داشته باشید که دیافراگم تنها برای تصحیح تیرگی حاشیه به کار می‌رود. پیش‌فرض 3.5 است.
.IP \fBfocus_distance\fR 4
.IX Item "focus_distance"
فاصله فوکوس تصویر/ویدیو (برای ویدیو ثابت فرض می‌شود). توجه داشته باشید که فاصله فوکوس تنها برای تیرگی حاشیه استفاده می‌شود و تأثیر ناچیزی بر روند تصحیح تیرگی حاشیه دارد. در صورت نامشخص بودن، آن را روی مقدار پیش‌فرض (که 1000 است) رها کنید.
.IP \fBscale\fR 4
.IX Item "scale"
ضریب مقیاس که پس از تبدیل اعمال می‌شود. پس از تصحیح، ویدیو لزوماً مستطیل‌شکل نخواهد بود. این پارامتر تعیین می‌کند که چه مقدار از تصویر حاصل نمایان باشد. مقدار 0 به این معناست که یک مقدار به‌طور خودکار انتخاب می‌شود تا ناحیه نگاشت‌نشده اندکی در تصویر خروجی وجود داشته باشد یا اصلاً وجود نداشته باشد. 1.0 به معنای عدم انجام مقیاس‌بندی اضافی است. مقادیر پایین‌تر ممکن است منجر به نمایان شدن بخش بیشتری از تصویر تصحیح‌شده گردند، در حالی که مقادیر بالاتر ممکن است از نواحی نگاشت‌نشده در خروجی جلوگیری کنند.
.IP \fBtarget_geometry\fR 4
.IX Item "target_geometry"
هندسه هدف تصویر/ویدیوی خروجی. مقادیر زیر گزینه‌های معتبر هستند:
.RS 4
.IP "\fBrectilinear (پیش‌فرض)\fR" 4
.IX Item "rectilinear (پیش‌فرض)"
.PD 0
.IP \fBfisheye\fR 4
.IX Item "fisheye"
.IP \fBpanoramic\fR 4
.IX Item "panoramic"
.IP \fBequirectangular\fR 4
.IX Item "equirectangular"
.IP \fBfisheye_orthographic\fR 4
.IX Item "fisheye_orthographic"
.IP \fBfisheye_stereographic\fR 4
.IX Item "fisheye_stereographic"
.IP \fBfisheye_equisolid\fR 4
.IX Item "fisheye_equisolid"
.IP \fBfisheye_thoby\fR 4
.IX Item "fisheye_thoby"
.PD
.RE
.RS 4
.RE
.IP \fBreverse\fR 4
.IX Item "reverse"
اعمال معکوس تصحیح تصویر (به جای تصحیح اعوجاج، اعمال آن).
.IP \fBinterpolation\fR 4
.IX Item "interpolation"
نوع درون‌یابی مورد استفاده هنگام تصحیح اعوجاج. مقادیر زیر گزینه‌های معتبر هستند:
.RS 4
.IP \fBnearest\fR 4
.IX Item "nearest"
.PD 0
.IP "\fBlinear (پیش‌فرض)\fR" 4
.IX Item "linear (پیش‌فرض)"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.PD
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال تصحیح لنز با سازنده "Canon"، مدل دوربین "Canon EOS 100D"، و مدل لنز "Canon EF\-S 18\-55mm f/3.5\-5.6 IS STM" با فاصله کانونی "18" و دیافراگم "8.0":
.Sp
.Vb 1
\&        ffmpeg \-i input.mov \-vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF\-S 18\-55mm f/3.5\-5.6 IS STM":focal_length=18:aperture=8 \-c:v h264 \-b:v 8000k output.mov
.Ve
.IP \(bu 4
اعمال همان مورد قبلی، اما تنها برای ۵ ثانیه نخست ویدیو:
.Sp
.Vb 1
\&        ffmpeg \-i input.mov \-vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF\-S 18\-55mm f/3.5\-5.6 IS STM":focal_length=18:aperture=8:enable=\*(Aqlte(t\e,5)\*(Aq \-c:v h264 \-b:v 8000k output.mov
.Ve
.SS lcevc
.IX Subsection "lcevc"
فیلتر Low Complexity Enhancement Video Codec بر اساس liblcevc_dec
(<\fBhttps://github.com/v\-novaltd/LCEVCdec\fR>).
.SS libplacebo
.IX Subsection "libplacebo"
فیلتر پردازشی منعطف با شتاب‌دهی GPU بر پایه libplacebo
(<\fBhttps://code.videolan.org/videolan/libplacebo\fR>).
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
گزینه‌های این فیلتر به بخش‌های زیر تقسیم می‌شوند:
.PP
حالت خروجی
.IX Subsection "Output mode"
.PP
این گزینه‌ها حالت کلی خروجی را کنترل می‌کنند. به‌طور پیش‌فرض، libplacebo تلاش خواهد کرد کالریمتری (colorimetry) و اندازه سورس را تا حد امکان حفظ کند، اما هرگونه فیلم گرین (film grain) تعبیه‌شده، متادیتای دالبی ویژن یا SAR آنامورفیک موجود در فریم‌های سورس را اعمال خواهد کرد.
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد ورودی‌ها. این گزینه می‌تواند در کنار متغیر \f(CW\*(C`idx\*(C'\fR برای قرار دادن/ترکیب چند ورودی درون فریم خروجی استفاده شود. این امر عملاً قابلیت‌هایی مشابه با \fBhstack\fR، \fBoverlay\fR و غیره را فعال می‌سازد.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقادیر پیش‌فرض \f(CW\*(C`iw\*(C'\fR و
\&\f(CW\*(C`ih\*(C'\fR هستند.
.Sp
عبارات مشابه با فیلتر \fBscale\fR را مجاز می‌داند.
.IP \fBcrop_x\fR 4
.IX Item "crop_x"
.PD 0
.IP \fBcrop_y\fR 4
.IX Item "crop_y"
.PD
تنظیم عبارات برش x/y ورودی، مقادیر پیش‌فرض \f(CW\*(C`(iw\-cw)/2\*(C'\fR و
\&\f(CW\*(C`(ih\-ch)/2\*(C'\fR هستند.
.IP \fBcrop_w\fR 4
.IX Item "crop_w"
.PD 0
.IP \fBcrop_h\fR 4
.IX Item "crop_h"
.PD
تنظیم عبارات عرض/ارتفاع برش ورودی، مقادیر پیش‌فرض \f(CW\*(C`iw\*(C'\fR و
\&\f(CW\*(C`ih\*(C'\fR هستند.
.IP \fBpos_x\fR 4
.IX Item "pos_x"
.PD 0
.IP \fBpos_y\fR 4
.IX Item "pos_y"
.PD
تنظیم عبارات جای‌گذاری x/y خروجی، مقادیر پیش‌فرض \f(CW\*(C`(ow\-pw)/2\*(C'\fR
و \f(CW\*(C`(oh\-ph)/2\*(C'\fR هستند.
.IP \fBpos_w\fR 4
.IX Item "pos_w"
.PD 0
.IP \fBpos_h\fR 4
.IX Item "pos_h"
.PD
تنظیم عبارات عرض/ارتفاع جای‌گذاری خروجی، مقادیر پیش‌فرض \f(CW\*(C`ow\*(C'\fR
و \f(CW\*(C`oh\*(C'\fR هستند.
.IP \fBrotate\fR 4
.IX Item "rotate"
چرخاندن فریم ورودی در جهت عقربه‌های ساعت با زاویه مشخص‌شده.
.RS 4
.IP "\fB0, 360\fR" 4
.IX Item "0, 360"
.PD 0
.IP \fB90\fR 4
.IX Item "90"
.IP \fB180\fR 4
.IX Item "180"
.IP \fB270\fR 4
.IX Item "270"
.PD
.RE
.RS 4
.RE
.IP \fBfps\fR 4
.IX Item "fps"
تنظیم نرخ فریم خروجی. این می‌تواند گویا باشد، مانند \f(CW\*(C`60000/1001\*(C'\fR. اگر روی رشته خاص \f(CW\*(C`none\*(C'\fR (پیش‌فرض) تنظیم شود، برچسب‌های زمانی ورودی بدون تغییر به خروجی منتقل می‌شوند. در غیر این صورت، فریم‌های ویدیوی ورودی در صورت نیاز درون‌یابی می‌شوند تا ویدیو به نرخ فریم هدف مشخص‌شده تغییر مقیاس داده شود، به روشی که توسط گزینه \fBframe_mixer\fR تعیین می‌گردد.
.IP \fBformat\fR 4
.IX Item "format"
بازنویسی فرمت خروجی. در صورت عدم تنظیم (پیش‌فرض)، فریم‌ها با همان فرمت فریم‌های ورودی مربوطه خروجی داده می‌شوند. در غیر این صورت، تبدیل فرمت انجام خواهد شد.
.IP \fBforce_original_aspect_ratio\fR 4
.IX Item "force_original_aspect_ratio"
.PD 0
.IP \fBforce_divisible_by\fR 4
.IX Item "force_divisible_by"
.PD
عملکردی مشابه با گزینه‌های هم‌نام در فیلتر \fBscale\fR دارند. توجه داشته باشید که
\&\fBforce_divisible_by\fR با \f(CW\*(C`fit_sense=constraint\*(C'\fR نیز کار می‌کند.
.IP \fBreset_sar\fR 4
.IX Item "reset_sar"
در صورت فعال بودن، فریم‌های خروجی همواره دارای نسبت ابعاد پیکسلی برابر 1:1 خواهند بود. در صورت غیرفعال بودن (پیش‌فرض)، هرگونه عدم تطابق نسبت ابعاد، از جمله مواردی مانند منابع ویدیویی آنامورفیک، به نسبت ابعاد پیکسلی خروجی منتقل می‌شود.
.IP \fBnormalize_sar\fR 4
.IX Item "normalize_sar"
مانند \fBreset_sar\fR، اما به جای کشیدن محتوای ویدیو برای پر کردن نسبت ابعاد خروجی جدید، محتوا در صورت لزوم پدینگ (افزودن کادر) یا برش (crop) داده می‌شود. با \fBfit_mode\fR مانعة‌الجمع است. به‌طور پیش‌فرض غیرفعال است.
.IP \fBpad_crop_ratio\fR 4
.IX Item "pad_crop_ratio"
نسبتی (بین \f(CW0.0\fR و \f(CW1.0\fR) میان پدینگ و برش را در زمانی که نسبت ابعاد ورودی با نسبت ابعاد خروجی مطابقت ندارد و \fBnormalize_sar\fR برقرار است، مشخص می‌کند. مقدار پیش‌فرض \f(CW0.0\fR همواره محتوا را با حاشیه‌های سیاه پد می‌کند، در حالی که مقدار \f(CW1.0\fR همواره بخش‌هایی از محتوا را برش می‌دهد. مقادیر میانی امکان‌پذیر است و به ترکیبی از این دو رویکرد می‌انجامد.
.IP \fBfit_mode\fR 4
.IX Item "fit_mode"
تعیین استراتژی برازش محتوا بر اساس فهرستی از حالت‌های از پیش تعریف‌شده. نحوه قرارگیری تصویر ورودی درون مستطیل برش مقصد (همان‌طور که توسط \f(CW\*(C`pos_x/y\*(C'\fR و \f(CW\*(C`pos_w/h\*(C'\fR تعریف شده است) را تعیین می‌کند. نام‌ها و پیاده‌سازی‌های آن‌ها از ویژگی \*(Aqobject\-fit\*(Aq در CSS برگرفته شده است. توجه داشته باشید که این گزینه با \fBnormalize_sar\fR مانعة‌الجمع است. پیش‌فرض \f(CW\*(C`fill\*(C'\fR است. مقادیر معتبر عبارتند از:
.RS 4
.IP \fBfill\fR 4
.IX Item "fill"
کشیدن ورودی به مستطیل خروجی، با نادیده گرفتن عدم تطابق نسبت ابعاد. توجه داشته باشید مگر اینکه \fBreset_sar\fR نیز فعال باشد، خروجی همچنان تگ نسبت ابعاد پیکسلی صحیح را خواهد داشت.
.IP \fBcontain\fR 4
.IX Item "contain"
مقیاس‌بندی ورودی برای قرار گرفتن در داخل خروجی، با حفظ نسبت ابعاد از طریق پدینگ. معادل \fBnormalize_sar\fR با \fBpad_crop_ratio\fR تنظیم‌شده روی \f(CW0.0\fR.
.IP \fBcover\fR 4
.IX Item "cover"
مقیاس‌بندی ورودی برای پر کردن خروجی، با حفظ نسبت ابعاد از طریق برش. معادل \fBnormalize_sar\fR با \fBpad_crop_ratio\fR تنظیم‌شده روی \f(CW1.0\fR.
.IP "\fBnone, place\fR" 4
.IX Item "none, place"
عدم مقیاس‌بندی ورودی. ورودی در اندازه طبیعی خود درون مستطیل خروجی قرار می‌گیرد؛ که ممکن است به پدینگ یا برش اضافی منجر شود.
.IP \fBscale_down\fR 4
.IX Item "scale_down"
کاهش مقیاس ورودی تا اندازه مورد نیاز برای جا شدن در داخل خروجی. بسته به اینکه ورودی بزرگتر از خروجی باشد یا نه، معادل \f(CW\*(C`contain\*(C'\fR یا \f(CW\*(C`none\*(C'\fR خواهد بود.
.RE
.RS 4
.RE
.IP \fBfit_sense\fR 4
.IX Item "fit_sense"
هنگام استفاده از \fBfit_mode\fR، این گزینه نحوه اعمال استراتژی برازش در برابر وضوح خروجی مشخص‌شده را کنترل می‌کند. با \fBforce_original_aspect_ratio\fR مانعة‌الجمع است. مقادیر معتبر عبارتند از:
.RS 4
.IP \fBtarget\fR 4
.IX Item "target"
وضوح خروجی محاسبه‌شده به عنوان اندازه دقیق فریم خروجی در نظر گرفته می‌شود. این رفتار پیش‌فرض است.
.IP \fBconstraint\fR 4
.IX Item "constraint"
وضوح خروجی محاسبه‌شده یک مرجع اندازه است که حالت برازش در برابر آن اعمال می‌شود و اندازه واقعی فریم را بر حسب نیاز برای جا شدن محتوا بزرگ یا کوچک می‌کند.
.RE
.RS 4
.RE
.IP \fBfillcolor\fR 4
.IX Item "fillcolor"
تنظیم رنگ مورد استفاده برای پر کردن ناحیه خروجی که توسط تصویر خروجی پوشانده نشده است، برای نمونه در نتیجه \fBnormalize_sar\fR. برای نحو کلی این گزینه، \fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید. پیش‌فرض \f(CW\*(C`black@0\*(C'\fR است.
.IP \fBcorner_rounding\fR 4
.IX Item "corner_rounding"
رندر کردن فریم‌ها با گوشه‌های گرد. مقدار داده‌شده به‌صورت یک عدد ممیز شناور در محدوده \f(CW0.0\fR تا \f(CW1.0\fR، درجه نسبی گرد کردن را از کاملاً مربعی تا کاملاً دایره‌ای نشان می‌دهد. به عبارت دیگر، شعاع را تقسیم بر نصف طول ضلع کوچکتر به دست می‌دهد. پیش‌فرض \f(CW0.0\fR است.
.IP \fBlut\fR 4
.IX Item "lut"
مشخص کردن یک LUT سفارشی (در فرمت .cube ادوبی) برای اعمال روی رنگ‌ها به عنوان بخشی از تبدیل رنگ. تفسیر دقیق به مقدار \fBlut_type\fR بستگی دارد.
.IP \fBlut_type\fR 4
.IX Item "lut_type"
کنترل تفسیر مقادیر رنگ ورودی و خروجی LUT مشخص‌شده به عنوان \fBlut\fR. مقادیر معتبر عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
تفسیر LUT را به‌طور خودکار از متادیتای تگ‌شده انتخاب می‌کند و در غیر این صورت به \fBnative\fR بازمی‌گردد. (پیش‌فرض)
.IP \fBnative\fR 4
.IX Item "native"
روی محتوای خام تصویر در فضای رنگی RGB بومی آن (نور غیرخطی)، پیش از تبدیل به فضای رنگی خروجی اعمال می‌شود.
.IP \fBnormalized\fR 4
.IX Item "normalized"
روی محتوای تصویر RGB نرمال‌شده، در نور خطی، پیش از تبدیل به فضای رنگی خروجی اعمال می‌شود.
.IP \fBconversion\fR 4
.IX Item "conversion"
تبدیل از فضای رنگی تصویر به فضای رنگی خروجی را کاملاً جایگزین می‌کند. در صورت وجود چنین LUTی، بالاترین اولویت را دارد و هرگونه پروفایل ICC و همچنین گزینه‌های مربوط به تون‌مپینگ و کالریمتری خروجی (\fBcolor_primaries\fR، \fBcolor_trc\fR) را بازنویسی می‌کند.
.RE
.RS 4
.RE
.IP \fBextra_opts\fR 4
.IX Item "extra_opts"
ارسال گزینه‌های پیکربندی داخلی اضافی libplacebo. این گزینه‌ها را می‌توان به‌صورت فهرستی از جفت‌های \fIkey\fR=\fIvalue\fR جداشده با \*(Aq:\*(Aq مشخص کرد. مثال زیر نشان می‌دهد که چگونه یک هسته فیلتر سفارشی ("EWA LanczosSharp") را پیکربندی کرده و از آن برای دو برابر کردن رزولوشن تصویر ورودی استفاده نمایید:
.Sp
.Vb 1
\&        \-vf "libplacebo=w=iw*2:h=ih*2:extra_opts=\*(Aqupscaler=custom\e:upscaler_preset=ewa_lanczos\e:upscaler_blur=0.9812505644269356\*(Aq"
.Ve
.IP \fBshader_cache\fR 4
.IX Item "shader_cache"
مسیر فایل یک دایرکتوری کش که libplacebo برای ذخیره و بارگذاری اشیاء شیدر کش‌شده استفاده خواهد کرد. این کش به‌طور خودکار پاکسازی نمی‌شود. اگر مسیر به جداکننده دایرکتوری ختم نشود، نام فایل‌های تولیدشده عملاً با آخرین جزء مسیر پیشوند می‌خورند. تمامی دایرکتوری‌ها باید از قبل وجود داشته باشند.
.Sp
.Vb 1
\&        \-vf "libplacebo=shader_cache=/tmp/pl\-shader\-"
.Ve
.IP \fBcolorspace\fR 4
.IX Item "colorspace"
.PD 0
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
.IP \fBcolor_trc\fR 4
.IX Item "color_trc"
.IP \fBrange\fR 4
.IX Item "range"
.IP \fBchroma_location\fR 4
.IX Item "chroma_location"
.PD
پیکربندی فضای رنگی که فریم‌های خروجی در آن تحویل داده می‌شوند. مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR فریم‌ها را با همان فرمت فریم‌های ورودی خروجی می‌دهد که منجر به عدم تغییر می‌شود. برای هر مقدار دیگر، تبدیل انجام خواهد شد.
.Sp
فیلتر \fBsetparams\fR را برای فهرستی از مقادیر ممکن مشاهده کنید.
.IP \fBalpha_mode\fR 4
.IX Item "alpha_mode"
انتخاب حالت آلفای خروجی مورد نظر، هنگامی که فرمت خروجی دارای کانال آلفا باشد. فیلتر \fBsetparams\fR را برای فهرستی از مقادیر ممکن ببینید.
.IP \fBapply_filmgrain\fR 4
.IX Item "apply_filmgrain"
اعمال فیلم گرین (مانند AV1 یا H.274) در صورت وجود در فریم‌های سورس، و حذف آن از خروجی. به‌طور پیش‌فرض فعال است.
.IP \fBapply_dolbyvision\fR 4
.IX Item "apply_dolbyvision"
اعمال متادیتای RPU دالبی ویژن در صورت وجود در فریم‌های سورس، و حذف آن از خروجی. به‌طور پیش‌فرض فعال است. توجه داشته باشید که دالبی ویژن همواره BT.2020+PQ خروجی خواهد داد و متادیتای معمول فریم ورودی را بازنویسی می‌کند. این مقادیر همچنین به عنوان مقادیر \f(CW\*(C`auto\*(C'\fR برای گزینه‌های مربوط به خروجی فریم انتخاب خواهند شد.
.PP
علاوه بر ثابت‌های عبارات مستندشده برای فیلتر \fBscale\fR، گزینه‌های \fBcrop_w\fR، \fBcrop_h\fR، \fBcrop_x\fR، \fBcrop_y\fR، \fBpos_w\fR، \fBpos_h\fR، \fBpos_x\fR و \fBpos_y\fR همچنین می‌توانند شامل ثابت‌های زیر باشند:
.IP "\fBin_idx, idx\fR" 4
.IX Item "in_idx, idx"
شاخص عددی (بر مبنای 0) جریان ورودی فعال جاری.
.IP "\fBcrop_w, cw\fR" 4
.IX Item "crop_w, cw"
.PD 0
.IP "\fBcrop_h, ch\fR" 4
.IX Item "crop_h, ch"
.PD
مقادیر محاسبه‌شده \fBcrop_w\fR و \fBcrop_h\fR.
.IP "\fBpos_w, pw\fR" 4
.IX Item "pos_w, pw"
.PD 0
.IP "\fBpos_h, ph\fR" 4
.IX Item "pos_h, ph"
.PD
مقادیر محاسبه‌شده \fBpos_w\fR و \fBpos_h\fR.
.IP "\fBin_t, t\fR" 4
.IX Item "in_t, t"
برچسب زمانی فریم ورودی، بر حسب ثانیه. NAN در صورتی که برچسب زمانی ورودی نامشخص باشد.
.IP "\fBout_t, ot\fR" 4
.IX Item "out_t, ot"
برچسب زمانی فریم ورودی، بر حسب ثانیه. NAN در صورتی که برچسب زمانی ورودی نامشخص باشد.
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، با شروع از 0.
.PP
مقیاس‌بندی
.IX Subsection "Scaling"
.PP
گزینه‌های این بخش کنترل می‌کنند که libplacebo چگونه افزایش مقیاس (upscaling) و (در صورت لزوم) کاهش مقیاس (downscaling) را انجام دهد. توجه داشته باشید که libplacebo همواره در داخل روی محتوای 4:4:4 عمل می‌کند، بنابراین هر فرمت کرومای زیرنمونه‌برداری‌شده مانند \f(CW\*(C`yuv420p\*(C'\fR لزوماً به عنوان بخشی از فرایند رندر کردن فرونمونه‌برداری و فرونمونگی خواهد شد. این بدان معناست که مقیاس‌بندی ممکن است حتی در صورتی که رزولوشن مبدا و مقصد یکسان باشد نیز اعمال شود.
.IP \fBupscaler\fR 4
.IX Item "upscaler"
.PD 0
.IP \fBdownscaler\fR 4
.IX Item "downscaler"
.PD
پیکربندی هسته فیلتر مورد استفاده برای افزایش و کاهش مقیاس. پیش‌فرض‌های مربوطه \f(CW\*(C`spline36\*(C'\fR و \f(CW\*(C`mitchell\*(C'\fR هستند. برای فهرست کامل مقادیر ممکن، \f(CW\*(C`help\*(C'\fR را به این گزینه‌ها ارسال کنید. مهم‌ترین مقادیر عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
استفاده از نمونه‌برداری بافت توکار GPU (معمولاً bilinear) را تحمیل می‌کند. بسیار سریع اما با کیفیت پایین، به‌ویژه هنگام کاهش مقیاس.
.IP \fBbilinear\fR 4
.IX Item "bilinear"
درون‌یابی دوخطی (bilinear). معمولاً می‌تواند روی GPUها بدون بار اضافی انجام شود، مگر زمانی که این کار منجر به پلگی (aliasing) شود. سریع و کم‌کیفیت.
.IP \fBnearest\fR 4
.IX Item "nearest"
درون‌یابی نزدیک‌ترین همسایه. واضح اما با پلگی و اعوجاج بالا.
.IP \fBoversample\fR 4
.IX Item "oversample"
الگوریتمی که از نظر بصری مشابه درون‌یابی نزدیک‌ترین همسایه است اما تلاش می‌کند نسبت ابعاد پیکسل را حفظ کند. برای هنر پیکسلی مناسب است، چرا که منجر به حداقل اعوجاج در ظاهر هنری می‌شود.
.IP \fBlanczos\fR 4
.IX Item "lanczos"
هسته استاندارد درون‌یابی sinc\-sinc.
.IP \fBspline36\fR 4
.IX Item "spline36"
تقریب اسپلاین مکعبی لنسوس. هیچ تفاوتی در عملکرد ندارد، اما حلقه‌زنی بسیار اندک‌تری دارد.
.IP \fBewa_lanczos\fR 4
.IX Item "ewa_lanczos"
نسخه میانگین وزنی بیضوی لنسوس، بر اساس یک هسته jinc\-jinc. این روش معمولاً تنها با عنوان "مقیاس‌بندی Jinc" نیز شناخته می‌شود. کند اما با کیفیت بسیار بالا.
.IP \fBgaussian\fR 4
.IX Item "gaussian"
هسته گوسی. ویژگی‌های ریاضی ایده‌آل خاصی دارد، اما از نظر بصری بسیار تار است.
.IP \fBmitchell\fR 4
.IX Item "mitchell"
اسپلاین مکعبی BC با پارامترهای توصیه‌شده توسط Mitchell و Netravali. حلقه‌زنی بسیار کم.
.RE
.RS 4
.RE
.IP \fBframe_mixer\fR 4
.IX Item "frame_mixer"
هسته مورد استفاده برای ترکیب زمانی فریم‌ها را کنترل می‌کند. مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است که ترکیب فریم را غیرفعال می‌کند. برای فهرست کامل مقادیر ممکن، \f(CW\*(C`help\*(C'\fR را به این گزینه ارسال کنید. مهم‌ترین مقادیر عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
ترکیب فریم را غیرفعال می‌کند و نتیجه‌ای معادل معانی "نزدیک‌ترین همسایه" می‌دهد.
.IP \fBoversample\fR 4
.IX Item "oversample"
نمونه‌برداری فراتر از حد (oversample) از ویدیوی ورودی برای ایجاد جلوه‌ای از نوع "حرکت روان" (Smooth Motion): اگر یک فریم خروجی دقیقاً روی نقطه انتقال میان دو فریم ویدیو بیفتد، با توجه به هم‌پوشانی نسبی ترکیب می‌شود. هر زمان که حفظ ظاهر ذهنی اولیه مد نظر باشد، این گزینه توصیه می‌شود.
.IP \fBmitchell_clamp\fR 4
.IX Item "mitchell_clamp"
هسته فیلتر بزرگتر که فریم‌های متعددی را به شیوه‌ای روان درون‌یابی می‌کند که برای حذف حلقه‌زنی و سایر آرتیفکت‌ها تا حد امکان طراحی شده است. هر زمان که حداکثر روانی بصری مد نظر باشد، این گزینه توصیه می‌شود.
.IP \fBlinear\fR 4
.IX Item "linear"
ترکیب/محو شدن خطی میان فریم‌ها. به‌ویژه برای ساخت اسلایدشوها مفید است.
.RE
.RS 4
.RE
.IP \fBantiringing\fR 4
.IX Item "antiringing"
ضد حلقه‌زنی را فعال می‌کند (برای فیلترهای غیر EWA). مقدار (بین \f(CW0.0\fR و \f(CW1.0\fR) قدرت الگوریتم ضد حلقه‌زنی را پیکربندی می‌کند. در صورت تنظیم بیش از حد بالا ممکن است پلگی (aliasing) را افزایش دهد. به‌طور پیش‌فرض غیرفعال است.
.IP \fBsigmoid\fR 4
.IX Item "sigmoid"
فعال‌سازی فشرده‌سازی سیگموئید در طول افزایش مقیاس. حلقه‌زنی را اندکی کاهش می‌دهد. به‌طور پیش‌فرض فعال است.
.PP
درهم‌بافتگی‌زدایی (Deinterlacing)
.IX Subsection "Deinterlacing"
.PP
عملیات Deinterlacing به‌طور خودکار هنگامی که فریم‌ها به عنوان درهم‌بافته تگ‌گذاری شده باشند پشتیبانی می‌شود، با این حال فریم‌ها deinterlace نمی‌شوند مگر اینکه یک الگوریتم deinterlacing انتخاب شود.
.IP \fBdeinterlace\fR 4
.IX Item "deinterlace"
الگوریتم deinterlacing برای استفاده.
.RS 4
.IP \fBweave\fR 4
.IX Item "weave"
بدون deinterlacing، فیلدها را در یک فریم تکی در هم می‌بافد. این مقدار پیش‌فرض است.
.IP \fBbob\fR 4
.IX Item "bob"
دی‌اینترلیس باب ساده، صرفاً تکرار دو باره هر خط فیلد.
.IP \fByadif\fR 4
.IX Item "yadif"
فیلتر دی‌اینترلیس دیگری. برای جزئیات بیشتر فیلتر \fByadif\fR را ببینید.
.IP \fBbwdif\fR 4
.IX Item "bwdif"
فیلتر دی‌اینترلیس باب ویور. برای جزئیات بیشتر فیلتر \fBbwdif\fR را ببینید.
.RE
.RS 4
.RE
.IP \fBskip_spatial_check\fR 4
.IX Item "skip_spatial_check"
صرف‌نظر از بررسی مکانی deinterlacing هنگام استفاده از دی‌اینترلیس \f(CW\*(C`yadif\*(C'\fR.
.IP \fBsend_fields\fR 4
.IX Item "send_fields"
خروجی دادن یک فریم برای هر فیلد، به جای هر فریم. توجه داشته باشید که این گزینه همواره نرخ فریم خروجی تگ‌شده را دو برابر می‌کند، حتی اگر ورودی شامل فریم‌های درهم‌بافته نباشد. به‌طور پیش‌فرض غیرفعال است.
.PP
حذف نوار (Debanding)
.IX Subsection "Debanding"
.PP
ابزار Libplacebo همراه با یک فیلتر توکار حذف نوار (debanding) ارائه می‌شود که در خنثی‌سازی بسیاری از منابع رایج نواری‌شدن و بلوکی‌شدن عالی عمل می‌کند. روشن کردن این گزینه هر زمان که کیفیت مد نظر باشد به‌شدت توصیه می‌شود.
.IP \fBdeband\fR 4
.IX Item "deband"
الگوریتم (سریع) debanding را فعال می‌کند. به‌طور پیش‌فرض غیرفعال است.
.IP \fBdeband_iterations\fR 4
.IX Item "deband_iterations"
تعداد تکرارهای الگوریتم debanding. هر تکرار با شعاع به‌طور تدریجی افزایش‌یافته (و آستانه کاهش‌یافته) انجام می‌شود. مقادیر توصیه‌شده در محدوده \f(CW1\fR تا \f(CW4\fR هستند. پیش‌فرض \f(CW1\fR است.
.IP \fBdeband_threshold\fR 4
.IX Item "deband_threshold"
قدرت فیلتر debanding. اعداد بالاتر منجر به debanding تهاجمی‌تر می‌شوند. پیش‌فرض \f(CW4.0\fR است.
.IP \fBdeband_radius\fR 4
.IX Item "deband_radius"
شعاع فیلتر debanding. یک شعاع بالاتر برای گرادیان‌های آرام بهتر است، در حالی که یک شعاع کمتر برای گرادیان‌های تند مناسب‌تر است. پیش‌فرض \f(CW16.0\fR است.
.IP \fBdeband_grain\fR 4
.IX Item "deband_grain"
مقدار گرین (دانه‌بندی) اضافی خروجی برای اضافه کردن. به پنهان کردن نواقص کمک می‌کند. پیش‌فرض \f(CW6.0\fR است.
.PP
تنظیم رنگ
.IX Subsection "Color adjustment"
.PP
مجموعه‌ای از کنترل‌های رنگی ذهنی. چندان دقیق نیست، بنابراین اثر واقعی تا حدودی بسته به رنگ‌های پایه و فضای رنگی ورودی متفاوت خواهد بود.
.IP \fBbrightness\fR 4
.IX Item "brightness"
تقویت روشنایی، بین \f(CW\-1.0\fR و \f(CW1.0\fR. پیش‌فرض \f(CW0.0\fR است.
.IP \fBcontrast\fR 4
.IX Item "contrast"
بهره کنتراست، بین \f(CW0.0\fR و \f(CW16.0\fR. پیش‌فرض \f(CW1.0\fR است.
.IP \fBsaturation\fR 4
.IX Item "saturation"
بهره اشباع، بین \f(CW0.0\fR و \f(CW16.0\fR. پیش‌فرض \f(CW1.0\fR است.
.IP \fBhue\fR 4
.IX Item "hue"
تغییر فام بر حسب رادیان، بین \f(CW\-3.14\fR و \f(CW3.14\fR. پیش‌فرض \f(CW0.0\fR است. این گزینه زیربردار UV را می‌چرخاند و برای ورودی‌های RGB به‌طور پیش‌فرض ضرایب BT.709 در نظر گرفته می‌شود.
.IP \fBgamma\fR 4
.IX Item "gamma"
تنظیم گاما، بین \f(CW0.0\fR و \f(CW16.0\fR. پیش‌فرض \f(CW1.0\fR است.
.IP \fBtemperature\fR 4
.IX Item "temperature"
تنظیم دمای رنگ. مقادیر پایین‌تر خروجی را گرم‌تر/قرمزتر می‌کنند (تا \f(CW1667\fR)، در حالی که مقادیر بالاتر خروجی را خنک‌تر/آبی‌تر می‌کنند (تا \f(CW25000\fR). پیش‌فرض \f(CW6500\fR (سفید خنثی) است.
.IP \fBcones\fR 4
.IX Item "cones"
مدل مخروطی برای شبیه‌سازی کوررنگی. هر ترکیبی از \f(CW\*(C`l\*(C'\fR، \f(CW\*(C`m\*(C'\fR و \f(CW\*(C`s\*(C'\fR را می‌پذیرد. چند مثال:
.RS 4
.IP \fBm\fR 4
.IX Item "m"
دوترانومالی / دوترانوپیا (مربوط به 3%\-4% از جمعیت)
.IP \fBl\fR 4
.IX Item "l"
پروتانومالی / پروتانوپیا (مربوط به 1%\-2% از جمعیت)
.IP \fBl+m\fR 4
.IX Item "l+m"
تک‌رنگ‌بینی (مونوکروماتیسم، بسیار نادر)
.IP \fBl+m+s\fR 4
.IX Item "l+m+s"
آکروماتوپسی (از دست دادن کامل دید در روز، بسیار نادر)
.RE
.RS 4
.RE
.IP \fBcone\-strength\fR 4
.IX Item "cone-strength"
ضریب بهره برای مخروط‌های مشخص‌شده توسط \f(CW\*(C`cones\*(C'\fR، بین \f(CW0.0\fR و \f(CW10.0\fR. مقدار \f(CW1.0\fR منجر به عدم تغییر در دید رنگی می‌شود. مقدار \f(CW0.0\fR (پیش‌فرض) از دست رفتن کامل آن مخروط‌ها را شبیه‌سازی می‌کند. مقادیر بالاتر از \f(CW1.0\fR منجر به اغراق در تفاوت میان مخروط‌ها می‌شوند، که ممکن است به جبران کاهش دید رنگی کمک کند.
.PP
تشخیص پیک
.IX Subsection "Peak detection"
.PP
برای کمک به مدیریت سورس‌هایی که تنها متادیتای استاتیک HDR10 دارند (یا اصلاً برچسبی ندارند)، libplacebo از کامپیوت شیدر تحلیل فریم داخلی خود برای تجزیه‌وتحلیل فریم‌های سورس و انطباق تابع تون‌مپینگ به‌صورت بلادرنگ استفاده می‌کند. اگر این کار بسیار کند باشد، یا اگر به نتایج فریم‌به‌فریم کاملاً تکرارپذیر نیاز باشد، توصیه می‌شود این قابلیت خاموش شود.
.IP \fBpeak_detect\fR 4
.IX Item "peak_detect"
فعال‌سازی تشخیص پیک HDR. مقادیر استاتیک MaxCLL/MaxFALL را به نفع تشخیص پویا از ورودی نادیده می‌گیرد. توجه داشته باشید که مقادیر تشخیص داده شده مجدداً روی فریم‌های خروجی نوشته نمی‌شوند، بلکه صرفاً فرایند تون‌مپینگ داخلی را هدایت می‌کنند. به‌طور پیش‌فرض فعال است.
.IP \fBsmoothing_period\fR 4
.IX Item "smoothing_period"
دوره هموارسازی تشخیص پیک، بین \f(CW0.0\fR و \f(CW1000.0\fR. مقادیر بالاتر منجر به پاسخ‌دهی کندتر تشخیص پیک به تغییرات ورودی می‌شوند. پیش‌فرض \f(CW20.0\fR است.
.IP \fBscene_threshold_low\fR 4
.IX Item "scene_threshold_low"
.PD 0
.IP \fBscene_threshold_high\fR 4
.IX Item "scene_threshold_high"
.PD
آستانه‌های پایین و بالا برای تشخیص تغییر صحنه. بیان‌شده در مقیاس لگاریتمی بین \f(CW0.0\fR و \f(CW100.0\fR. به ترتیب پیش‌فرض \f(CW1.0\fR و \f(CW3.0\fR هستند. تنظیم هر یک روی یک مقدار منفی این قابلیت را غیرفعال می‌کند.
.IP \fBpercentile\fR 4
.IX Item "percentile"
کدام صدک از هیستوگرام روشنایی فریم به عنوان پیک منبع برای تون‌مپینگ استفاده شود. پیش‌فرض \f(CW99.995\fR است که یک مقدار نسبتاً محافظه‌کارانه است. تنظیم این مقدار روی \f(CW100.0\fR اندازه‌گیری هیستوگرام فریم را غیرفعال کرده و به جای آن از پیک روشنایی واقعی برای تون‌مپینگ استفاده می‌کند.
.PP
نگاشت تون (Tone mapping)
.IX Subsection "Tone mapping"
.PP
گزینه‌های این بخش نحوه انجام تون‌مپینگ و گاموت‌مپینگ توسط libplacebo را هنگام مواجهه با عدم تطابق بین محتوای با طیف گسترده (wide\-gamut) یا HDR کنترل می‌کنند. به‌طور کلی، libplacebo به برچسب‌گذاری دقیق سورس و اطلاعات گاموت مانیتور مسترینگ برای دستیابی به بهترین نتایج متکی است.
.IP \fBgamut_mode\fR 4
.IX Item "gamut_mode"
نحوه مدیریت رنگ‌های خارج از گاموت که می‌توانند در نتیجه گاموت‌مپینگ کالریمتری رخ دهند:
.RS 4
.IP \fBclip\fR 4
.IX Item "clip"
هیچ کاری انجام نده، صرفاً رنگ‌های خارج از محدوده را به حجم RGB برش (clip) بزن. کیفیت پایین اما بسیار سریع.
.IP \fBperceptual\fR 4
.IX Item "perceptual"
برش نرم رنگ‌ها به حجم گاموت به‌صورت ادراکی. این حالت پیش‌فرض است.
.IP \fBrelative\fR 4
.IX Item "relative"
برش سخت کالریمتری نسبی. مشابه \f(CW\*(C`perceptual\*(C'\fR اما بدون نقطه زانویی نرم.
.IP \fBsaturation\fR 4
.IX Item "saturation"
مپینگ اشباع، رنگ‌های اولیه را مستقیماً به رنگ‌های اولیه در فضای RGB مپ می‌کند. به جز برای گرافیک‌های رایانه‌ای مصنوعی که در آن‌ها نمایشگر روشن و اشباع مد نظر است، توصیه نمی‌شود.
.IP \fBabsolute\fR 4
.IX Item "absolute"
برش سخت کالریمتری مطلق. هیچ تنظیمی برای نقطه سفید انجام نمی‌دهد.
.IP \fBdesaturate\fR 4
.IX Item "desaturate"
رنگ‌های خارج از گاموت را به‌شدت به سمت سفید غیراشباع می‌کند، ضمن اینکه درخشندگی (luminance) را حفظ می‌نماید. تمایل به تحریف ظاهر بصری اشیاء روشن دارد.
.IP \fBdarken\fR 4
.IX Item "darken"
روشنایی محتوا را به‌صورت خطی کاهش می‌دهد تا جزئیات اشباع‌شده حفظ شوند، و به دنبال آن رنگ‌های خارج از گاموت باقی‌مانده را برش می‌زند.
.IP \fBwarn\fR 4
.IX Item "warn"
برجسته‌سازی پیکسل‌های خارج از گاموت (با معکوس کردن/علامت‌گذاری آن‌ها).
.IP \fBlinear\fR 4
.IX Item "linear"
کروماسیتی کل تصویر را به‌صورت خطی کاهش می‌دهد تا در حجم رنگ هدف جا شود. هنگام استفاده از این گزینه روی سورس‌های BT.2020 بدون متادیتای مسترینگ مناسب دقت کنید، زیرا انجام این کار منجر به عدم اشباع بیش از حد می‌شود.
.RE
.RS 4
.RE
.IP \fBtonemapping\fR 4
.IX Item "tonemapping"
الگوریتم تون‌مپینگ برای استفاده. مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار بر اساس اکتشافی‌های داخلی. این مقدار پیش‌فرض است.
.IP \fBclip\fR 4
.IX Item "clip"
هیچ تون‌مپینگی انجام نمی‌دهد، صرفاً رنگ‌های خارج از محدوده را برش می‌زند. دقت رنگ عالی را برای رنگ‌های داخل محدوده حفظ می‌کند اما اطلاعات خارج از محدوده را کاملاً از بین می‌برد. هیچ انطباق نقطه سیاهی انجام نمی‌دهد. غیرقابل‌پیکربندی.
.IP \fBst2094\-40\fR 4
.IX Item "st2094-40"
تابع EETF از ضمیمه B استاندارد SMPTE ST 2094\-40، که منحنی‌های بزیه حاصل از متادیتای پویای HDR10+ را برای انجام تون‌مپینگ اعمال می‌کند. تابع OOTF مورد استفاده بر اساس نسبت میان درخشندگی‌های پیک هدف و واقعی نمایشگر تنظیم می‌شود.
.IP \fBst2094\-10\fR 4
.IX Item "st2094-10"
تابع EETF از ضمیمه B.2 استاندارد SMPTE ST 2094\-10، که علاوه بر بیشینه/کمینه، میانگین درخشندگی سیگنال ورودی را نیز در نظر می‌گیرد. پارامتر کنتراست قابل تنظیم بر شیب بخش خروجی خطی تأثیر می‌گذارد، که پیش‌فرض آن \f(CW1.0\fR برای عدم افزایش/کاهش کنتراست است. توجه داشته باشید که این گزینه در حال حاضر کنترل‌های ذهنی بهره/آفست/گامای تعریف‌شده در ضمیمه B.3 را شامل نمی‌شود.
.IP \fBbt.2390\fR 4
.IX Item "bt.2390"
تابع EETF از گزارش ITU\-R Report BT.2390، یک کاهش منحنی هرمیت با بخش خطی. آفست نقطه زانو (knee point) قابل پیکربندی است. توجه داشته باشید که این پارامتر به‌جای مقدار \f(CW0.5\fR در مشخصات ITU\-R، به‌طور پیش‌فرض روی \f(CW1.0\fR تنظیم شده است.
.IP \fBbt.2446a\fR 4
.IX Item "bt.2446a"
تابع EETF از گزارش ITU\-R Report BT.2446، روش A. برای سورس‌های HDR به‌خوبی مسترشده طراحی شده است. می‌تواند برای هر دو تون‌مپینگ مستقیم و معکوس استفاده شود. غیرقابل‌پیکربندی.
.IP \fBspline\fR 4
.IX Item "spline"
اسپلاین ساده متشکل از دو چندجمله‌ای، متصل‌شده با یک نقطه لولای منفرد. پارامتر نقطه لولا را (در فضای PQ) مشخص می‌کند که پیش‌فرض آن \f(CW0.30\fR است. می‌تواند برای هر دو تون‌مپینگ مستقیم و معکوس استفاده شود.
.IP \fBreinhard\fR 4
.IX Item "reinhard"
الگوریتم تون‌مپینگ سراسری غیرخطی و ساده. پارامتر، ضریب کنتراست محلی در پیک نمایشگر را مشخص می‌کند. اساساً، پارامتر \f(CW0.5\fR به این معناست که سفید مرجع حدوداً نصف زمانی که برش زده می‌شود روشن خواهد بود. پیش‌فرض \f(CW0.5\fR است که ساده‌ترین فرمول‌بندی این تابع را نتیجه می‌دهد.
.IP \fBmobius\fR 4
.IX Item "mobius"
تعمیم الگوریتم تون‌مپینگ راینهارد (reinhard) برای پشتیبانی از یک شیب خطی اضافی نزدیک به سیاه. پارامتر تون‌مپینگ موازنه میان بخش خطی و بخش غیرخطی را نشان می‌دهد. اساساً برای یک پارامتر \fIx\fR معین، هر مقدار رنگ زیر \fIx\fR به‌صورت خطی مپ می‌شود، در حالی که مقادیر بالاتر به‌صورت غیرخطی تون‌مپ می‌شوند. مقادیر نزدیک به \f(CW1.0\fR این منحنی را مانند \f(CW\*(C`clip\*(C'\fR و مقادیر نزدیک به \f(CW0.0\fR آن را مانند \f(CW\*(C`reinhard\*(C'\fR رفتار می‌دهند. مقدار پیش‌فرض \f(CW0.3\fR است که تعادل خوبی بین دقت کالریمتری و حفظ جزئیات خارج از گاموت برقرار می‌سازد.
.IP \fBhable\fR 4
.IX Item "hable"
الگوریتم تون‌مپینگ فیلمیک و تکه‌تکه توسعه‌یافته توسط جان هیبل (John Hable) برای استفاده در بازی Uncharted 2، الهام‌گرفته از الگوریتم تون‌مپینگ مشابه مورد استفاده توسط کداک. با استفاده از آن در بازی‌های ویدیویی با رندرینگ HDR محبوبیت یافت. هر دو جزئیات تیره و روشن را به‌خوبی حفظ می‌کند، اما با این نقطه‌ضعف همراه است که میانگین روشنایی را به‌طور قابل توجهی تغییر می‌دهد. این تا حدودی شبیه به \f(CW\*(C`reinhard\*(C'\fR با پارامتر \f(CW0.24\fR است.
.IP \fBgamma\fR 4
.IX Item "gamma"
برازش یک تابع گاما (توانی) برای انتقال میان فضاهای رنگی سورس و مقصد، که عملاً منجر به یک زانوی سخت ادراکی متصل‌کننده دو بخش تقریباً خطی می‌شود. این امر جزئیات را در تمام مقیاس‌ها نسبتاً دقیق حفظ می‌کند، اما می‌تواند منجر به تصویری با ظاهر مات یا کدر شود. پارامتر به عنوان نقطه قطع استفاده می‌شود که پیش‌فرض آن \f(CW0.5\fR است.
.IP \fBlinear\fR 4
.IX Item "linear"
کشیدن خطی محدوده ورودی به محدوده خروجی، در فضای PQ. این تمام جزئیات را به‌طور دقیق حفظ می‌کند، اما به روشنایی میانگین کاملاً متفاوتی منجر می‌شود. می‌تواند علاوه بر تون‌مپینگ معمولی برای تون‌مپینگ معکوس نیز استفاده شود. پارامتر می‌تواند به عنوان یک ضریب بهره خطی اضافی استفاده شود (پیش‌فرض \f(CW1.0\fR).
.RE
.RS 4
.RE
.IP \fBtonemapping_param\fR 4
.IX Item "tonemapping_param"
برای توابع تون‌مپینگ قابل تنظیم، این پارامتر می‌تواند برای تنظیم دقیق رفتار منحنی استفاده شود. به مستندات \f(CW\*(C`tonemapping\*(C'\fR مراجعه کنید. مقدار پیش‌فرض \f(CW0.0\fR با تنظیمات پیش‌فرض ترجیحی منحنی جایگزین می‌شود.
.IP \fBinverse_tonemapping\fR 4
.IX Item "inverse_tonemapping"
در صورت فعال بودن، این فیلتر همچنین تلاش خواهد کرد سیگنال‌های SDR را بکشد تا حجم رنگ خروجی HDR را پر کند. به‌طور پیش‌فرض غیرفعال است.
.IP \fBtonemapping_lut_size\fR 4
.IX Item "tonemapping_lut_size"
اندازه LUT تون‌مپینگ، بین \f(CW2\fR و \f(CW1024\fR. پیش‌فرض \f(CW256\fR است. توجه داشته باشید که این مقدار هنگام ترکیب با \f(CW\*(C`peak_detect\*(C'\fR به توان دو می‌رسد.
.IP \fBcontrast_recovery\fR 4
.IX Item "contrast_recovery"
قدرت بازیابی کنتراست. در صورت تنظیم روی مقداری بالاتر از \f(CW0.0\fR، تصویر سورس به مؤلفه‌های با فرکانس بالا و فرکانس پایین تقسیم می‌شود و بخشی از تصویر با فرکانس بالا مجدداً به خروجی تون‌مپ‌شده اضافه می‌گردد. ممکن است برای برخی سورس‌های HDR باعث ایجاد آرتیفکت‌های حلقه‌زنی بیش از حد شود، اما می‌تواند وضوح ذهنی و جزئیات باقی‌مانده در تصویر پس از تون‌مپینگ را بهبود بخشد. پیش‌فرض \f(CW0.30\fR است.
.IP \fBcontrast_smoothness\fR 4
.IX Item "contrast_smoothness"
اندازه هسته پایین‌گذر بازیابی کنتراست. پیش‌فرض \f(CW3.5\fR است. افزایش یا کاهش این مقدار تأثیر اساسی بر ظاهر بصری خواهد داشت. هنگام غیرفعال بودن \f(CW\*(C`contrast_recovery\*(C'\fR هیچ تأثیری ندارد.
.PP
دیترینگ (Dithering)
.IX Subsection "Dithering"
.PP
به‌طور پیش‌فرض، libplacebo هر زمان که لازم باشد عمل دیترینگ را انجام می‌دهد، که شامل رندر کردن به هر فرمت عدد صحیح زیر دقت ۱۶ بیتی می‌شود. توصیه می‌شود همیشه این گزینه روشن بماند، زیرا عدم انجام آن ممکن است منجر به نواری‌شدن قابل مشاهده در خروجی شود، حتی اگر فیلتر \f(CW\*(C`debanding\*(C'\fR فعال باشد. در صورت نیاز به حداکثر کارایی، به جای غیرفعال کردن دیترینگ از \f(CW\*(C`ordered_fixed\*(C'\fR استفاده کنید.
.IP \fBdithering\fR 4
.IX Item "dithering"
روش دیترینگ مورد استفاده. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
دیترینگ را کاملاً غیرفعال می‌کند. ممکن است منجر به نواری‌شدن قابل مشاهده شود.
.IP \fBblue\fR 4
.IX Item "blue"
دیتر با نویز شبه‌آبی. این حالت پیش‌فرض است.
.IP \fBordered\fR 4
.IX Item "ordered"
الگوی دیتر مرتب‌شده قابل تنظیم.
.IP \fBordered_fixed\fR 4
.IX Item "ordered_fixed"
دیتر مرتب‌شده سریع‌تر با اندازه ثابت \f(CW6\fR. بدون بافت.
.IP \fBwhite\fR 4
.IX Item "white"
دیتر با نویز سفید. بدون بافت.
.RE
.RS 4
.RE
.IP \fBdither_lut_size\fR 4
.IX Item "dither_lut_size"
اندازه LUT دیتر، به‌صورت لگاریتم مبنای ۲ بین \f(CW1\fR و \f(CW8\fR. پیش‌فرض
\&\f(CW6\fR است، که متناظر با اندازه LUT برابر با \f(CW\*(C`64x64\*(C'\fR است.
.IP \fBdither_temporal\fR 4
.IX Item "dither_temporal"
دیترینگ زمانی را فعال می‌کند. به‌طور پیش‌فرض غیرفعال است.
.PP
شیدرهای سفارشی
.IX Subsection "Custom shaders"
.PP
ابزار libplacebo از تعدادی شیدر سفارشی بر اساس نحو mpv .hook GLSL پشتیبانی می‌کند. مجموعه‌ای از چنین شیدرهایی را می‌توان در اینجا یافت:
<\fBhttps://github.com/mpv\-player/mpv/wiki/User\-Scripts#user\-shaders\fR>
.PP
شرح کامل فرمت شیدر mpv خارج از دامنه این بخش است، اما خلاصه‌ای از آن را می‌توان در اینجا یافت:
<\fBhttps://mpv.io/manual/master/#options\-glsl\-shader\fR>
.IP \fBcustom_shader_path\fR 4
.IX Item "custom_shader_path"
مسیر یک فایل شیدر سفارشی را برای بارگذاری در زمان اجرا مشخص می‌کند.
.IP \fBcustom_shader_bin\fR 4
.IX Item "custom_shader_bin"
یک شیدر سفارشی کامل را به‌صورت یک رشته خام مشخص می‌کند.
.PP
اشکال‌زدایی / کارایی
.IX Subsection "Debugging / performance"
.PP
تمامی گزینه‌های این بخش به‌طور پیش‌فرض خاموش هستند. آن‌ها ممکن است هنگام تلاش برای دریافت حداکثر کارایی به بهای کیفیت مفید باشند.
.IP \fBskip_aa\fR 4
.IX Item "skip_aa"
غیرفعال‌سازی ضد پلگی (anti\-aliasing) هنگام کاهش مقیاس.
.IP \fBdisable_linear\fR 4
.IX Item "disable_linear"
غیرفعال‌سازی مقیاس‌بندی نور خطی.
.IP \fBdisable_builtin\fR 4
.IX Item "disable_builtin"
غیرفعال‌سازی نمونه‌برداری توکار GPU (اجبار به استفاده از LUT).
.IP \fBdisable_fbos\fR 4
.IX Item "disable_fbos"
غیرفعال‌سازی اجباری FBOها، که منجر به از دست رفتن تقریباً تمام قابلیت‌ها می‌شود، اما حداکثر سرعت ممکن را ارائه می‌دهد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر تقریباً از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR (\fBcommands\fR) پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تون‌مپ کردن ورودی به خروجی با گاموت استاندارد BT.709:
.Sp
.Vb 1
\&        libplacebo=colorspace=bt709:color_primaries=bt709:color_trc=bt709:range=tv
.Ve
.IP \(bu 4
تغییر مقیاس ورودی برای جا شدن در 1080p استاندارد، همراه با مقیاس‌بندی کیفیت بالا:
.Sp
.Vb 1
\&        libplacebo=w=1920:h=1080:force_original_aspect_ratio=decrease:normalize_sar=true:upscaler=ewa_lanczos:downscaler=ewa_lanczos
.Ve
.IP \(bu 4
درون‌یابی ورودی با FPS پایین / VFR به خروجی هموار ثابت 60 فریم بر ثانیه:
.Sp
.Vb 1
\&        libplacebo=fps=60:frame_mixer=mitchell_clamp
.Ve
.IP \(bu 4
تبدیل ورودی به JPEG استاندارد sRGB:
.Sp
.Vb 1
\&        libplacebo=format=yuv420p:colorspace=bt470bg:color_primaries=bt709:color_trc=iec61966\-2\-1:range=pc
.Ve
.IP \(bu 4
استفاده از تنظیمات باکیفیت‌تر رفع نواری‌شدن (debanding):
.Sp
.Vb 1
\&        libplacebo=deband=true:deband_iterations=3:deband_radius=8:deband_threshold=6
.Ve
.IP \(bu 4
اجرای این فیلتر روی CPU، در سیستم‌هایی با Mesa نصب‌شده (و با غیرفعال بودن پرهزینه‌ترین گزینه‌ها):
.Sp
.Vb 1
\&        ffmpeg ... \-init_hw_device vulkan:llvmpipe ... \-vf libplacebo=upscaler=none:downscaler=none:peak_detect=false
.Ve
.IP \(bu 4
متوقف کردن اعمال فیلم گرین AV1/H.274 مبتنی بر CPU در رمزگشا، به نفع انجام آن با این فیلتر. توجه داشته باشید که این کار تنها در صورتی مزیت محسوب می‌شود که فریم‌ها یا از قبل روی GPU باشند یا از libplacebo برای اهداف دیگری استفاده کنید، زیرا در غیر این صورت رفت و برگشت به VRAM هرگونه افزایش سرعت مورد انتظار را خنثی خواهد کرد.
.Sp
.Vb 1
\&        ffmpeg \-export_side_data +film_grain ... \-vf libplacebo=apply_filmgrain=true
.Ve
.IP \(bu 4
تعامل با رمزگشای سخت‌افزاری VAAPI برای جلوگیری از رفت و برگشت از طریق RAM:
.Sp
.Vb 1
\&        ffmpeg \-init_hw_device vulkan \-hwaccel vaapi \-hwaccel_output_format vaapi ... \-vf libplacebo
.Ve
.SS libvmaf
.IX Subsection "libvmaf"
محاسبه امتیاز VMAF (Video Multi\-Method Assessment Fusion) برای یک جفت ویدیوی ورودی مرجع/تحریف‌شده.
.PP
ورودی نخست، ویدیوی تحریف‌شده و ورودی دوم، ویدیوی مرجع است.
.PP
امتیاز VMAF به‌دست‌آمده از طریق سامانه لاگ‌گیری چاپ می‌شود.
.PP
این فیلتر به عنوان پیش‌نیاز به کتابخانه vmaf نتفلیکس (libvmaf) نیاز دارد.
پس از نصب کتابخانه می‌توان با دستور زیر آن را فعال کرد:
\&\f(CW\*(C`./configure \-\-enable\-libvmaf\*(C'\fR.
.PP
این فیلتر گزینه‌های زیر را دارد:
.IP \fBmodel\fR 4
.IX Item "model"
فهرستی از مدل‌های vmaf که با \`|\` از هم جدا شده‌اند. هر مدل را می‌توان با تعدادی پارامتر پیکربندی کرد.
مقدار پیش‌فرض: \f(CW"version=vmaf_v0.6.1"\fR
.IP \fBfeature\fR 4
.IX Item "feature"
فهرستی از ویژگی‌ها که با \`|\` از هم جدا شده‌اند. هر ویژگی را می‌توان با تعدادی پارامتر پیکربندی کرد.
.IP \fBlog_path\fR 4
.IX Item "log_path"
تنظیم مسیر فایلی که برای ذخیره فایل‌های گزارش (لاگ) استفاده می‌شود.
.IP \fBlog_fmt\fR 4
.IX Item "log_fmt"
تنظیم فرمت فایل گزارش (xml، json، csv، یا sub).
.IP \fBpool\fR 4
.IX Item "pool"
تنظیم روش ادغام (pool) مورد استفاده برای محاسبه vmaf.
گزینه‌ها عبارتند از \f(CW\*(C`min\*(C'\fR، \f(CW\*(C`harmonic_mean\*(C'\fR یا \f(CW\*(C`mean\*(C'\fR (پیش‌فرض).
.IP \fBn_threads\fR 4
.IX Item "n_threads"
تنظیم تعداد ریسه‌ها (threads) جهت استفاده هنگام مقداردهی اولیه libvmaf.
مقدار پیش‌فرض: \f(CW0\fR، بدون ریسه.
.IP \fBn_subsample\fR 4
.IX Item "n_subsample"
تنظیم فاصله زیرنمونه‌برداری فریم‌ها.
.PP
این فیلتر از گزینه‌های \fBframesync\fR نیز پشتیبانی می‌کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
در مثال‌های زیر، ویدیوی تحریف‌شده \fIdistorted.mpg\fR با فایل مرجع \fIreference.mpg\fR مقایسه می‌شود.
.IP \(bu 4
کاربرد پایه:
.Sp
.Vb 1
\&        ffmpeg \-i distorted.mpg \-i reference.mpg \-lavfi libvmaf=log_path=output.xml \-f null \-
.Ve
.IP \(bu 4
مثال با چند مدل:
.Sp
.Vb 1
\&        ffmpeg \-i distorted.mpg \-i reference.mpg \-lavfi libvmaf=\*(Aqmodel=version=vmaf_v0.6.1\e\e:name=vmaf|version=vmaf_v0.6.1neg\e\e:name=vmaf_neg\*(Aq \-f null \-
.Ve
.IP \(bu 4
مثال با چند ویژگی اضافی:
.Sp
.Vb 1
\&        ffmpeg \-i distorted.mpg \-i reference.mpg \-lavfi libvmaf=\*(Aqfeature=name=psnr|name=ciede\*(Aq \-f null \-
.Ve
.IP \(bu 4
مثال با گزینه‌ها و کانتینرهای مختلف:
.Sp
.Vb 1
\&        ffmpeg \-i distorted.mpg \-i reference.mkv \-lavfi "[0:v]settb=AVTB,setpts=PTS\-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS\-STARTPTS[ref];[main][ref]libvmaf=log_fmt=json:log_path=output.json" \-f null \-
.Ve
.SS libvmaf_cuda
.IX Subsection "libvmaf_cuda"
این نگارش CUDA فیلتر \fBlibvmaf\fR است. این فیلتر فقط فریم‌های CUDA را می‌پذیرد.
.PP
این فیلتر به عنوان پیش‌نیاز به کتابخانه vmaf نتفلیکس (libvmaf) نیاز دارد.
پس از نصب کتابخانه می‌توان با دستور زیر آن را فعال کرد:
\&\f(CW\*(C`./configure \-\-enable\-nonfree \-\-enable\-ffnvcodec \-\-enable\-libvmaf\*(C'\fR.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
کاربرد پایه که رمزگشایی سخت‌افزاری CUVID و تغییر مقیاس CUDA را با \fBscale_cuda\fR نشان می‌دهد:
.Sp
.Vb 9
\&        ffmpeg \e
\&            \-hwaccel cuda \-hwaccel_output_format cuda \-codec:v av1_cuvid \-i dis.obu \e
\&            \-hwaccel cuda \-hwaccel_output_format cuda \-codec:v av1_cuvid \-i ref.obu \e
\&            \-filter_complex "
\&                [0:v]scale_cuda=format=yuv420p[dis]; \e
\&                [1:v]scale_cuda=format=yuv420p[ref]; \e
\&                [dis][ref]libvmaf_cuda=log_fmt=json:log_path=output.json
\&            " \e
\&            \-f null \-
.Ve
.SS limitdiff
.IX Subsection "limitdiff"
اعمال فیلتر تفاضل محدود با استفاده از جریان ویدیویی دوم و در صورت تمایل جریان ویدیویی سوم.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه برای مجاز دانستن تفاوت‌های مشخص میان جریان‌های ویدیویی.
هر مقدار اختلاف مطلق کمتر یا دقیقاً برابر با این آستانه، مؤلفه‌های پیکسل را از نخستین جریان ویدیویی انتخاب خواهد کرد.
.IP \fBelasticity\fR 4
.IX Item "elasticity"
تنظیم کشسانی (elasticity) آستانه‌گذاری نرم هنگام پردازش جریان‌های ویدیویی.
این مقدار ضربدر مقدار اول شده و آستانه دوم را تعیین می‌کند.
هر مقدار اختلاف مطلق بیشتر یا دقیقاً برابر با آستانه دوم، مؤلفه‌های پیکسل را از دومین جریان ویدیویی انتخاب خواهد کرد. برای مقادیر بین این دو آستانه، از درون‌یابی خطی میان جریان ویدیویی اول و دوم استفاده خواهد شد.
.IP \fBreference\fR 4
.IX Item "reference"
فعال‌سازی پردازش جریان ویدیویی مرجع (سوم). به‌طور پیش‌فرض غیرفعال است.
در صورت تنظیم، از این جریان ویدیویی برای محاسبه اختلاف مطلق با جریان ویدیویی اول استفاده خواهد شد.
.IP \fBplanes\fR 4
.IX Item "planes"
مشخص می‌کند کدام پلین‌ها پردازش شوند. پیش‌فرض تمام پلین‌های موجود است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به جز گزینه \fBreference\fR به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS limiter
.IX Subsection "limiter"
محدود کردن مقادیر مؤلفه‌های پیکسل به محدوده مشخص‌شده [min, max].
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmin\fR 4
.IX Item "min"
کران پایین. مقدار پیش‌فرض، کمترین مقدار مجاز برای ورودی است.
.IP \fBmax\fR 4
.IX Item "max"
کران بالا. مقدار پیش‌فرض، بیشترین مقدار مجاز برای ورودی است.
.IP \fBplanes\fR 4
.IX Item "planes"
مشخص می‌کند کدام پلین‌ها پردازش شوند. پیش‌فرض تمام پلین‌های موجود است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS loop
.IX Subsection "loop"
تکرار (حلقه کردن) فریم‌های ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBloop\fR 4
.IX Item "loop"
تنظیم تعداد دفعات تکرار حلقه. تنظیم این مقدار روی \-1 منجر به حلقه‌های نامحدود می‌شود.
پیش‌فرض 0 است.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم حداکثر اندازه بر حسب تعداد فریم‌ها. پیش‌فرض 0 است.
.IP \fBstart\fR 4
.IX Item "start"
تنظیم نخستین فریم حلقه. پیش‌فرض 0 است.
.IP \fBtime\fR 4
.IX Item "time"
تنظیم زمان شروع حلقه بر حسب ثانیه.
تنها در صورتی استفاده می‌شود که گزینه \fIstart\fR روی \f(CW\-1\fR تنظیم شده باشد.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تکرار بی‌پایان اولین تک‌فریم:
.Sp
.Vb 1
\&        loop=loop=\-1:size=1:start=0
.Ve
.IP \(bu 4
تکرار ۱۰ باره اولین تک‌فریم:
.Sp
.Vb 1
\&        loop=loop=10:size=1:start=0
.Ve
.IP \(bu 4
تکرار ۵ باره ۱۰ فریم نخست:
.Sp
.Vb 1
\&        loop=loop=5:size=10:start=0
.Ve
.SS lut1d
.IX Subsection "lut1d"
اعمال یک جدول جستجوی یک‌بعدی (1D LUT) بر روی یک ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfile\fR 4
.IX Item "file"
تنظیم نام فایل جدول جستجوی یک‌بعدی (1D LUT).
.Sp
فرمت‌های پشتیبانی‌شده در حال حاضر:
.RS 4
.IP \fBcube\fR 4
.IX Item "cube"
Iridas
.IP \fBcsp\fR 4
.IX Item "csp"
cineSpace
.RE
.RS 4
.RE
.IP \fBinterp\fR 4
.IX Item "interp"
انتخاب حالت درون‌یابی.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBnearest\fR 4
.IX Item "nearest"
استفاده از مقادیر نزدیک‌ترین نقطه تعریف‌شده.
.IP \fBlinear\fR 4
.IX Item "linear"
درون‌یابی مقادیر با استفاده از درون‌یابی خطی.
.IP \fBcosine\fR 4
.IX Item "cosine"
درون‌یابی مقادیر با استفاده از درون‌یابی کسینوسی.
.IP \fBcubic\fR 4
.IX Item "cubic"
درون‌یابی مقادیر با استفاده از درون‌یابی مکعبی.
.IP \fBspline\fR 4
.IX Item "spline"
درون‌یابی مقادیر با استفاده از درون‌یابی اسپلاین.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS lut3d
.IX Subsection "lut3d"
اعمال یک جدول جستجوی سه‌بعدی (3D LUT) بر روی یک ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfile\fR 4
.IX Item "file"
تنظیم نام فایل جدول جستجوی سه‌بعدی (3D LUT).
.Sp
فرمت‌های پشتیبانی‌شده در حال حاضر:
.RS 4
.IP \fB3dl\fR 4
.IX Item "3dl"
AfterEffects
.IP \fBcube\fR 4
.IX Item "cube"
Iridas
.IP \fBdat\fR 4
.IX Item "dat"
DaVinci
.IP \fBm3d\fR 4
.IX Item "m3d"
Pandora
.IP \fBcsp\fR 4
.IX Item "csp"
cineSpace
.RE
.RS 4
.RE
.IP \fBinterp\fR 4
.IX Item "interp"
انتخاب حالت درون‌یابی.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBnearest\fR 4
.IX Item "nearest"
استفاده از مقادیر نزدیک‌ترین نقطه تعریف‌شده.
.IP \fBtrilinear\fR 4
.IX Item "trilinear"
درون‌یابی مقادیر با استفاده از ۸ نقطه تعیین‌کننده یک مکعب.
.IP \fBtetrahedral\fR 4
.IX Item "tetrahedral"
درون‌یابی مقادیر با استفاده از یک چهاروجهی (تتراهدرون).
.IP \fBpyramid\fR 4
.IX Item "pyramid"
درون‌یابی مقادیر با استفاده از یک هرم.
.IP \fBprism\fR 4
.IX Item "prism"
درون‌یابی مقادیر با استفاده از یک منشور.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از گزینه \f(CW\*(C`interp\*(C'\fR به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS lumakey
.IX Subsection "lumakey"
تبدیل مقادیر معینی از روشنایی (luma) به شفافیت.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم روشنایی که به عنوان پایه برای شفافیت استفاده می‌شود.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBtolerance\fR 4
.IX Item "tolerance"
تنظیم محدوده مقادیر روشنایی برای حذف شدن (keyed out).
مقدار پیش‌فرض \f(CW0.01\fR است.
.IP \fBsoftness\fR 4
.IX Item "softness"
تنظیم محدوده نرمی (softness). مقدار پیش‌فرض \f(CW0\fR است.
از این گزینه برای کنترل گذار تدریجی از شفافیت صفر تا کامل استفاده کنید.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
این دستور ساختار نحوی مشابه با گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.SS "lut, lutrgb, lutyuv"
.IX Subsection "lut, lutrgb, lutyuv"
محاسبه یک جدول جستجو (look\-up table) جهت پیوند دادن هر مقدار ورودی مؤلفه پیکسل به یک مقدار خروجی، و اعمال آن بر روی ویدیوی ورودی.
.PP
\&\fIlutyuv\fR جدول جستجو را بر روی یک ویدیوی ورودی YUV اعمال می‌کند، و \fIlutrgb\fR بر روی ویدیوی ورودی RGB.
.PP
این فیلترها پارامترهای زیر را می‌پذیرند:
.IP \fBc0\fR 4
.IX Item "c0"
تنظیم عبارت مؤلفه پیکسلی نخست
.IP \fBc1\fR 4
.IX Item "c1"
تنظیم عبارت مؤلفه پیکسلی دوم
.IP \fBc2\fR 4
.IX Item "c2"
تنظیم عبارت مؤلفه پیکسلی سوم
.IP \fBc3\fR 4
.IX Item "c3"
تنظیم عبارت مؤلفه پیکسلی چهارم، مربوط به مؤلفه آلفا
.IP \fBr\fR 4
.IX Item "r"
تنظیم عبارت مؤلفه قرمز (red)
.IP \fBg\fR 4
.IX Item "g"
تنظیم عبارت مؤلفه سبز (green)
.IP \fBb\fR 4
.IX Item "b"
تنظیم عبارت مؤلفه آبی (blue)
.IP \fBa\fR 4
.IX Item "a"
عبارت مؤلفه آلفا (alpha)
.IP \fBy\fR 4
.IX Item "y"
تنظیم عبارت مؤلفه Y/روشنایی (luma)
.IP \fBu\fR 4
.IX Item "u"
تنظیم عبارت مؤلفه U/Cb
.IP \fBv\fR 4
.IX Item "v"
تنظیم عبارت مؤلفه V/Cr
.PP
هر یک از آن‌ها عبارت مورد استفاده برای محاسبه جدول جستجو را برای مقادیر مؤلفه پیکسل متناظر مشخص می‌کند.
.PP
مؤلفه دقیقی که به هر یک از گزینه‌های \fIc*\fR اختصاص می‌یابد به فرمت ورودی بستگی دارد.
.PP
فیلتر \fIlut\fR در ورودی به فرمت‌های پیکسلی YUV یا RGB نیاز دارد، \fIlutrgb\fR به فرمت‌های پیکسلی RGB در ورودی نیاز دارد، و \fIlutyuv\fR به YUV نیاز دارد.
.PP
عبارت‌ها می‌توانند شامل ثابت‌ها و توابع زیر باشند:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
پهنا و ارتفاع ورودی.
.IP \fBval\fR 4
.IX Item "val"
مقدار ورودی برای مؤلفه پیکسل.
.IP \fBclipval\fR 4
.IX Item "clipval"
مقدار ورودی، محدودشده به محدوده \fIminval\fR\-\fImaxval\fR.
.IP \fBmaxval\fR 4
.IX Item "maxval"
حداکثر مقدار برای مؤلفه پیکسل.
.IP \fBminval\fR 4
.IX Item "minval"
حداقل مقدار برای مؤلفه پیکسل.
.IP \fBnegval\fR 4
.IX Item "negval"
مقدار منفی‌شده (معکوس) برای مقدار مؤلفه پیکسل، محدودشده به محدوده \fIminval\fR\-\fImaxval\fR؛ این متناظر با عبارت "maxval\-clipval+minval" است.
.IP \fBclip(val)\fR 4
.IX Item "clip(val)"
مقدار محاسبه‌شده در \fIval\fR، محدودشده به محدوده \fIminval\fR\-\fImaxval\fR.
.IP \fBgammaval(gamma)\fR 4
.IX Item "gammaval(gamma)"
مقدار تصحیح گامای محاسبه‌شده برای مقدار مؤلفه پیکسل، محدودشده به محدوده \fIminval\fR\-\fImaxval\fR. این متناظر با عبارت زیر است:
"pow((clipval\-minval)/(maxval\-minval)\e,\fIgamma\fR)*(maxval\-minval)+minval"
.PP
تمام عبارت‌ها به‌طور پیش‌فرض برابر با "clipval" هستند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
معکوس (نگاتیو) کردن ویدیوی ورودی:
.Sp
.Vb 2
\&        lutrgb="r=maxval+minval\-val:g=maxval+minval\-val:b=maxval+minval\-val"
\&        lutyuv="y=maxval+minval\-val:u=maxval+minval\-val:v=maxval+minval\-val"
.Ve
.Sp
عبارت بالا با دستور زیر یکسان است:
.Sp
.Vb 2
\&        lutrgb="r=negval:g=negval:b=negval"
\&        lutyuv="y=negval:u=negval:v=negval"
.Ve
.IP \(bu 4
معکوس کردن روشنایی (luma):
.Sp
.Vb 1
\&        lutyuv=y=negval
.Ve
.IP \(bu 4
حذف مؤلفه‌های رنگی (chroma) و تبدیل ویدیو به یک تصویر با طیف خاکستری:
.Sp
.Vb 1
\&        lutyuv="u=128:v=128"
.Ve
.IP \(bu 4
اعمال یک جلوه سوختگی روشنایی (luma burning):
.Sp
.Vb 1
\&        lutyuv="y=2*val"
.Ve
.IP \(bu 4
حذف مؤلفه‌های سبز و آبی:
.Sp
.Vb 1
\&        lutrgb="g=0:b=0"
.Ve
.IP \(bu 4
تنظیم یک مقدار ثابت برای کانال آلفا در ورودی:
.Sp
.Vb 1
\&        format=rgba,lutrgb=a="maxval\-minval/2"
.Ve
.IP \(bu 4
تصحیح گامای روشنایی با ضریب 0.5:
.Sp
.Vb 1
\&        lutyuv=y=gammaval(0.5)
.Ve
.IP \(bu 4
دور انداختن کم‌ارزش‌ترین بیت‌های روشنایی:
.Sp
.Vb 1
\&        lutyuv=y=\*(Aqbitand(val, 128+64+32)\*(Aq
.Ve
.IP \(bu 4
جلوه‌ای شبیه به تکنی‌کالر (Technicolor):
.Sp
.Vb 1
\&        lutyuv=u=\*(Aq(val\-maxval/2)*2+maxval/2\*(Aq:v=\*(Aq(val\-maxval/2)*2+maxval/2\*(Aq
.Ve
.SS "lut2, tlut2"
.IX Subsection "lut2, tlut2"
فیلتر \f(CW\*(C`lut2\*(C'\fR دو جریان ورودی دریافت کرده و یک جریان را در خروجی می‌دهد.
.PP
فیلتر \f(CW\*(C`tlut2\*(C'\fR (جدول جستجوی زمانی ۲) دو فریم متوالی را از یک جریان واحد دریافت می‌کند.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBc0\fR 4
.IX Item "c0"
تنظیم عبارت مؤلفه پیکسلی نخست
.IP \fBc1\fR 4
.IX Item "c1"
تنظیم عبارت مؤلفه پیکسلی دوم
.IP \fBc2\fR 4
.IX Item "c2"
تنظیم عبارت مؤلفه پیکسلی سوم
.IP \fBc3\fR 4
.IX Item "c3"
تنظیم عبارت مؤلفه پیکسلی چهارم، مربوط به مؤلفه آلفا
.IP \fBd\fR 4
.IX Item "d"
تنظیم عمق بیت خروجی، تنها برای فیلتر \f(CW\*(C`lut2\*(C'\fR در دسترس است. به‌طور پیش‌فرض 0 است، به این معنی که عمق بیت به‌طور خودکار از فرمت ورودی نخست انتخاب می‌شود.
.PP
فیلتر \f(CW\*(C`lut2\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
هر یک از آن‌ها عبارت مورد استفاده برای محاسبه جدول جستجو را برای مقادیر مؤلفه پیکسلی متناظر مشخص می‌کند.
.PP
مؤلفه دقیقی که به هر یک از گزینه‌های \fIc*\fR اختصاص می‌یابد به فرمت ورودی‌ها بستگی دارد.
.PP
عبارت‌ها می‌توانند شامل ثابت‌های زیر باشند:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
پهنا و ارتفاع ورودی.
.IP \fBx\fR 4
.IX Item "x"
مقدار ورودی نخست برای مؤلفه پیکسل.
.IP \fBy\fR 4
.IX Item "y"
مقدار ورودی دوم برای مؤلفه پیکسل.
.IP \fBbdx\fR 4
.IX Item "bdx"
عمق بیت ویدیوی ورودی نخست.
.IP \fBbdy\fR 4
.IX Item "bdy"
عمق بیت ویدیوی ورودی دوم.
.PP
تمام عبارت‌ها به‌طور پیش‌فرض برابر با "x" هستند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR به جز گزینه \f(CW\*(C`d\*(C'\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
برجسته‌سازی تفاوت‌ها میان دو جریان ویدیویی RGB:
.Sp
.Vb 1
\&        lut2=\*(Aqifnot(x\-y,0,pow(2,bdx)\-1):ifnot(x\-y,0,pow(2,bdx)\-1):ifnot(x\-y,0,pow(2,bdx)\-1)\*(Aq
.Ve
.IP \(bu 4
برجسته‌سازی تفاوت‌ها میان دو جریان ویدیویی YUV:
.Sp
.Vb 1
\&        lut2=\*(Aqifnot(x\-y,0,pow(2,bdx)\-1):ifnot(x\-y,pow(2,bdx\-1),pow(2,bdx)\-1):ifnot(x\-y,pow(2,bdx\-1),pow(2,bdx)\-1)\*(Aq
.Ve
.IP \(bu 4
نمایش حداکثر اختلاف میان دو جریان ویدیویی:
.Sp
.Vb 1
\&        lut2=\*(Aqif(lt(x,y),0,if(gt(x,y),pow(2,bdx)\-1,pow(2,bdx\-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)\-1,pow(2,bdx\-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)\-1,pow(2,bdx\-1)))\*(Aq
.Ve
.SS maskedclamp
.IX Subsection "maskedclamp"
محدود کردن (Clamp) نخستین جریان ورودی بر اساس دومین و سومین جریان ورودی.
.PP
مقدار جریان نخست را به گونه‌ای بازمی‌گرداند که بین (جریان ورودی دوم \- \f(CW\*(C`undershoot\*(C'\fR) و (جریان ورودی سوم + \f(CW\*(C`overshoot\*(C'\fR) قرار گیرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBundershoot\fR 4
.IX Item "undershoot"
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBovershoot\fR 4
.IX Item "overshoot"
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم این‌که کدام پلین‌ها به صورت بیت‌مپ پردازش شوند؛ پلین‌های پردازش‌نشده از جریان نخست کپی خواهند شد.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلین‌ها پردازش می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS maskedmax
.IX Subsection "maskedmax"
ادغام دومین و سومین جریان ورودی در جریان خروجی با استفاده از تفاضل‌های مطلق میان دومین جریان ورودی و نخستین جریان ورودی، و تفاضل مطلق میان سومین جریان ورودی و نخستین جریان ورودی. اگر تفاضل مطلق دوم بزرگ‌تر از اولی باشد، مقدار انتخاب‌شده از جریان ورودی دوم خواهد بود و در غیر این صورت از سومین جریان ورودی انتخاب می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم این‌که کدام پلین‌ها به صورت بیت‌مپ پردازش شوند؛ پلین‌های پردازش‌نشده از جریان نخست کپی خواهند شد.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلین‌ها پردازش می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS maskedmerge
.IX Subsection "maskedmerge"
ادغام نخستین جریان ورودی با دومین جریان ورودی با استفاده از وزن‌های تفکیک‌شده به ازای هر پیکسل در سومین جریان ورودی.
.PP
مقدار 0 در مؤلفه پیکسلی جریان سوم بدین معناست که مؤلفه پیکسلی جریان نخست بدون تغییر بازگردانده می‌شود، در حالی که مقدار بیشینه (مانند 255 برای ویدیوهای ۸ بیتی) یعنی مؤلفه پیکسلی جریان دوم بدون تغییر بازگردانده می‌شود. مقادیر میانی میزان ادغام میان مؤلفه‌های پیکسلی هر دو جریان ورودی را تعیین می‌کنند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم این‌که کدام پلین‌ها به صورت بیت‌مپ پردازش شوند؛ پلین‌های پردازش‌نشده از جریان نخست کپی خواهند شد.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلین‌ها پردازش می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS maskedmin
.IX Subsection "maskedmin"
ادغام دومین و سومین جریان ورودی در جریان خروجی با استفاده از تفاضل‌های مطلق میان دومین جریان ورودی و نخستین جریان ورودی، و تفاضل مطلق میان سومین جریان ورودی و نخستین جریان ورودی. اگر تفاضل مطلق دوم کمتر از اولی باشد، مقدار از دومین جریان ورودی انتخاب می‌شود و در غیر این صورت از سومین جریان ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم این‌که کدام پلین‌ها به صورت بیت‌مپ پردازش شوند؛ پلین‌های پردازش‌نشده از جریان نخست کپی خواهند شد.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلین‌ها پردازش می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS maskedthreshold
.IX Subsection "maskedthreshold"
انتخاب پیکسل‌ها از طریق مقایسه تفاضل مطلق دو جریان ویدیویی با یک آستانه ثابت.
.PP
اگر تفاضل مطلق بین مؤلفه پیکسلی جریان ویدیویی اول و دوم مساوی یا کمتر از آستانه مشخص‌شده توسط کاربر باشد، مؤلفه پیکسلی از جریان ویدیویی اول انتخاب می‌شود، در غیر این صورت مؤلفه پیکسلی از جریان ویدیویی دوم انتخاب خواهد شد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold\fR 4
.IX Item "threshold"
تنظیم آستانه مورد استفاده هنگام انتخاب پیکسل‌ها بر اساس تفاضل مطلق از دو جریان ویدیویی ورودی.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم این‌که کدام پلین‌ها به صورت بیت‌مپ پردازش شوند؛ پلین‌های پردازش‌نشده از جریان دوم کپی خواهند شد.
به‌طور پیش‌فرض با مقدار 0xf، تمام پلین‌ها پردازش می‌شوند.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد فیلتر. می‌تواند \f(CW\*(C`abs\*(C'\fR یا \f(CW\*(C`diff\*(C'\fR باشد.
مقدار پیش‌فرض \f(CW\*(C`abs\*(C'\fR است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS maskfun
.IX Subsection "maskfun"
ایجاد ماسک از ویدیوی ورودی.
.PP
به عنوان مثال، برای ایجاد ماسک‌های حرکتی پس از فیلتر \f(CW\*(C`tblend\*(C'\fR سودمند است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlow\fR 4
.IX Item "low"
تنظیم آستانه پایین. هر مؤلفه پیکسلی کمتر یا دقیقاً برابر با این مقدار روی 0 تنظیم خواهد شد.
.IP \fBhigh\fR 4
.IX Item "high"
تنظیم آستانه بالا. هر مؤلفه پیکسلی بیشتر از این مقدار روی حداکثر مقدار مجاز برای فرمت پیکسلی فعلی تنظیم خواهد شد.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌ها جهت فیلتر کردن؛ به‌طور پیش‌فرض تمام پلین‌های موجود فیلتر می‌شوند.
.IP \fBfill\fR 4
.IX Item "fill"
پر کردن تمامی پیکسل‌های فریم با این مقدار.
.IP \fBsum\fR 4
.IX Item "sum"
تنظیم حداکثر میانگین مقدار پیکسل برای فریم. اگر مجموع تمام مؤلفه‌های پیکسلی از این میانگین بیشتر شود، فریم خروجی به‌طور کامل با مقدار تعیین‌شده توسط گزینه \fIfill\fR پر خواهد شد.
معمولاً هنگام استفاده در ترکیب با فیلتر \f(CW\*(C`tblend\*(C'\fR برای تغییر صحنه‌ها سودمند است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS mcdeint
.IX Subsection "mcdeint"
اعمال دی‌اینترلیس با جبران حرکت (motion\-compensation deinterlacing).
.PP
این فیلتر در ورودی به یک فیلد به ازای هر فریم نیاز دارد و بنابراین باید همراه با yadif=1/3 یا معادل آن استفاده شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت دی‌اینترلیس کردن.
.Sp
یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBfast\fR 4
.IX Item "fast"
.PD 0
.IP \fBmedium\fR 4
.IX Item "medium"
.IP \fBslow\fR 4
.IX Item "slow"
.PD
استفاده از تخمین حرکت تکرارشونده
.IP \fBextra_slow\fR 4
.IX Item "extra_slow"
شبیه به \fBslow\fR، اما از چندین فریم مرجع استفاده می‌کند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBfast\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
تنظیم زوجیت فیلد تصویر فرض‌شده برای ویدیوی ورودی. باید یکی از مقادیر زیر باشد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض بر برتری فیلد بالایی (top field first)
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض بر برتری فیلد پایینی (bottom field first)
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBbff\fR است.
.RE
.IP \fBqp\fR 4
.IX Item "qp"
تنظیم پارامتر کوانتایزیشن (QP) به ازای هر بلوک مورد استفاده در انکودر داخلی.
.Sp
مقادیر بالاتر باید منجر به میدان بردارهای حرکتی هموارتر شوند، اما بهینگی بردارهای منفرد کمتر خواهد بود. مقدار پیش‌فرض 1 است.
.SS median
.IX Subsection "median"
انتخاب پیکسل میانه از یک مستطیل مشخص که با شعاع تعریف می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم اندازه شعاع افقی. مقدار پیش‌فرض \f(CW1\fR است.
محدوده مجاز عدد صحیح از 1 تا 127 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌های پردازش. پیش‌فرض \f(CW15\fR است که تمام پلین‌های موجود را شامل می‌شود.
.IP \fBradiusV\fR 4
.IX Item "radiusV"
تنظیم اندازه شعاع عمودی. مقدار پیش‌فرض \f(CW0\fR است.
محدوده مجاز عدد صحیح از 0 تا 127 است.
در صورت 0 بودن، مقدار از گزینه افقی \f(CW\*(C`radius\*(C'\fR برداشته می‌شود.
.IP \fBpercentile\fR 4
.IX Item "percentile"
تنظیم صدک میانه (percentile). مقدار پیش‌فرض \f(CW0.5\fR است.
مقدار پیش‌فرض \f(CW0.5\fR همواره مقادیر میانه را انتخاب می‌کند، در حالی که \f(CW0\fR مقادیر کمینه و \f(CW1\fR مقادیر بیشینه را انتخاب خواهد کرد.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
این دستور ساختار نحوی مشابه با گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.SS mergeplanes
.IX Subsection "mergeplanes"
ادغام مؤلفه‌های کانال رنگ از چندین جریان ویدیویی.
.PP
این فیلتر حداکثر تا ۴ جریان ورودی را می‌پذیرد و پلین‌های ورودی انتخابی را در ویدیوی خروجی ادغام می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmapping\fR 4
.IX Item "mapping"
تنظیم نگاشت پلین ورودی به خروجی. پیش‌فرض \f(CW0\fR است.
.Sp
نگاشت‌ها به صورت یک بیت‌مپ مشخص می‌شوند. این مقدار باید به صورت یک عدد در مبنای ۱۶ (هگزادسیمال) در قالب 0xAa[Bb[Cc[Dd]]] مشخص گردد. عبارت \*(AqAa\*(Aq نگاشت نخستین پلین جریان خروجی را توصیف می‌کند. \*(AqA\*(Aq شماره جریان ورودی مورد استفاده را تنظیم می‌کند (از 0 تا 3)، و \*(Aqa\*(Aq شماره پلین ورودی متناظر مورد استفاده را تعیین می‌کند (از 0 تا 3). بقیه نگاشت‌ها نیز مشابه هستند؛ \*(AqBb\*(Aq نگاشت پلین دوم جریان خروجی، \*(AqCc\*(Aq نگاشت پلین سوم جریان خروجی و \*(AqDd\*(Aq نگاشت پلین چهارم جریان خروجی را توصیف می‌کند.
.IP \fBformat\fR 4
.IX Item "format"
تنظیم فرمت پیکسلی خروجی. پیش‌فرض \f(CW\*(C`yuva444p\*(C'\fR است.
.IP \fBmap0s\fR 4
.IX Item "map0s"
.PD 0
.IP \fBmap1s\fR 4
.IX Item "map1s"
.IP \fBmap2s\fR 4
.IX Item "map2s"
.IP \fBmap3s\fR 4
.IX Item "map3s"
.PD
تنظیم نگاشت جریان ورودی به جریان خروجی برای N\-امین پلین خروجی. پیش‌فرض \f(CW0\fR است.
.IP \fBmap0p\fR 4
.IX Item "map0p"
.PD 0
.IP \fBmap1p\fR 4
.IX Item "map1p"
.IP \fBmap2p\fR 4
.IX Item "map2p"
.IP \fBmap3p\fR 4
.IX Item "map3p"
.PD
تنظیم نگاشت پلین ورودی به خروجی برای N\-امین پلین خروجی. پیش‌فرض \f(CW0\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
ادغام سه جریان ویدیویی خاکستری (gray) با پهنا و ارتفاع یکسان در یک جریان ویدیویی واحد:
.Sp
.Vb 1
\&        [a0][a1][a2]mergeplanes=0x001020:yuv444p
.Ve
.IP \(bu 4
ادغام جریان نخست yuv444p و دومین جریان ویدیویی خاکستری در یک جریان ویدیویی yuva444p:
.Sp
.Vb 1
\&        [a0][a1]mergeplanes=0x00010210:yuva444p
.Ve
.IP \(bu 4
جابه‌جایی پلین Y و A در جریان yuva444p:
.Sp
.Vb 1
\&        format=yuva444p,mergeplanes=0x03010200:yuva444p
.Ve
.IP \(bu 4
جابه‌جایی پلین U و V در جریان yuv420p:
.Sp
.Vb 1
\&        format=yuv420p,mergeplanes=0x000201:yuv420p
.Ve
.IP \(bu 4
تبدیل یک کلیپ rgb24 به yuv444p:
.Sp
.Vb 1
\&        format=rgb24,mergeplanes=0x000102:yuv444p
.Ve
.SS mestimate
.IX Subsection "mestimate"
تخمین و صادر کردن بردارهای حرکت با استفاده از الگوریتم‌های تطبیق بلوک.
بردارهای حرکت در داده‌های جانبی فریم ذخیره می‌شوند تا توسط سایر فیلترها مورد استفاده قرار گیرند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmethod\fR 4
.IX Item "method"
مشخص کردن روش تخمین حرکت. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBesa\fR 4
.IX Item "esa"
الگوریتم جستجوی جامع (Exhaustive search algorithm).
.IP \fBtss\fR 4
.IX Item "tss"
الگوریتم جستجوی سه‌مرحله‌ای (Three step search algorithm).
.IP \fBtdls\fR 4
.IX Item "tdls"
الگوریتم جستجوی لگاریتمی دوبعدی (Two dimensional logarithmic search algorithm).
.IP \fBntss\fR 4
.IX Item "ntss"
الگوریتم جستجوی سه‌مرحله‌ای نوین (New three step search algorithm).
.IP \fBfss\fR 4
.IX Item "fss"
الگوریتم جستجوی چهارمرحله‌ای (Four step search algorithm).
.IP \fBds\fR 4
.IX Item "ds"
الگوریتم جستجوی الماسی (Diamond search algorithm).
.IP \fBhexbs\fR 4
.IX Item "hexbs"
الگوریتم جستجوی مبتنی بر شش‌ضلعی (Hexagon\-based search algorithm).
.IP \fBepzs\fR 4
.IX Item "epzs"
الگوریتم جستجوی ناحیه‌ای پیش‌بین ارتقایافته (Enhanced predictive zonal search algorithm).
.IP \fBumh\fR 4
.IX Item "umh"
الگوریتم جستجوی چند شش‌ضلعی ناهمگون (Uneven multi\-hexagon search algorithm).
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBesa\fR است.
.RE
.IP \fBmb_size\fR 4
.IX Item "mb_size"
اندازه ماکروبلوک. پیش‌فرض \f(CW16\fR است.
.IP \fBsearch_param\fR 4
.IX Item "search_param"
پارامتر جستجو. پیش‌فرض \f(CW7\fR است.
.SS mestimate_d3d12
.IX Subsection "mestimate_d3d12"
تخمین و صادر کردن بردارهای حرکت با شتاب‌دهی سخت‌افزاری D3D12.
این فیلتر از قابلیت‌های تخمین حرکت سخت‌افزاری GPU موجود در APIهای ویدیویی DirectX 12 بهره می‌برد تا نسبت به فیلتر مبتنی بر نرم‌افزار \f(CW\*(C`mestimate\*(C'\fR بهبود کارایی چشمگیری به دست آورد.
.PP
بردارهای حرکت در داده‌های جانبی فریم ذخیره می‌شوند تا توسط سایر فیلترها مورد استفاده قرار گیرند.
.PP
این فیلتر مستلزم آن است که ورودی در فرمت پیکسلی سخت‌افزاری \f(CW\*(C`d3d12\*(C'\fR باشد.
این فیلتر از دقت یک‌چهارم پیکسل برای تخمین بردار حرکت استفاده می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmb_size\fR 4
.IX Item "mb_size"
اندازه ماکروبلوک. تنها مقادیر \f(CW8\fR و \f(CW16\fR پشتیبانی می‌شوند.
پیش‌فرض \f(CW16\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
تخمین بردارهای حرکت با شتاب‌دهی سخت‌افزاری D3D12 با بلوک‌های 16x16، و بصری‌سازی آن‌ها:
.PP
.Vb 3
\&        ffmpeg \-hwaccel d3d12va \-hwaccel_output_format d3d12 \-i input.mp4 \e
\&                \-vf mestimate_d3d12=mb_size=16,hwdownload,format=nv12,codecview=mv=pf \e
\&                \-c:v libx264 \-preset fast \-b:v 5M output.mp4
.Ve
.SS midequalizer
.IX Subsection "midequalizer"
اعمال جلوه تعدیل تصویر میانه (Midway Image Equalization) با استفاده از دو جریان ویدیویی.
.PP
تعدیل تصویر میانه یک جفت تصویر را به گونه‌ای تنظیم می‌کند که هیستوگرام یکسانی داشته باشند، ضمن این‌که پویایی (داینامیک) آن‌ها تا حد امکان حفظ می‌شود. این فیلتر به عنوان نمونه برای تطبیق نوردهی حاصل از یک جفت دوربین استریو سودمند است.
.PP
این فیلتر دارای دو ورودی و یک خروجی است که باید فرمت پیکسلی یکسانی داشته باشند، اما ممکن است اندازه‌های متفاوتی داشته باشند. خروجی فیلتر ورودی نخست است که با هیستوگرام میانه هر دو ورودی تنظیم شده است.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌های پردازش. پیش‌فرض \f(CW15\fR است که تمام پلین‌های موجود را شامل می‌شود.
.SS minterpolate
.IX Subsection "minterpolate"
تبدیل ویدیو به نرخ فریم مشخص‌شده با استفاده از درون‌یابی حرکتی (motion interpolation).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfps\fR 4
.IX Item "fps"
مشخص کردن نرخ فریم خروجی. این مقدار می‌تواند گویا باشد مانند \f(CW\*(C`60000/1001\*(C'\fR. اگر مقدار \fIfps\fR کمتر از نرخ فریم مبدأ باشد، فریم‌ها حذف (drop) می‌شوند. پیش‌فرض \f(CW60\fR است.
.IP \fBmi_mode\fR 4
.IX Item "mi_mode"
حالت درون‌یابی حرکت. مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBdup\fR 4
.IX Item "dup"
تکرار فریم قبلی یا بعدی برای درون‌یابی فریم‌های جدید.
.IP \fBblend\fR 4
.IX Item "blend"
ترکیب فریم‌های مبدأ. فریم درون‌یابی‌شده میانگین فریم‌های قبلی و بعدی است.
.IP \fBmci\fR 4
.IX Item "mci"
درون‌یابی با جبران حرکت (Motion compensated interpolation). هنگام انتخاب این حالت، گزینه‌های زیر مؤثر خواهند بود:
.RS 4
.IP \fBmc_mode\fR 4
.IX Item "mc_mode"
حالت جبران حرکت. مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBobmc\fR 4
.IX Item "obmc"
جبران حرکت بلوکی هم‌پوشان (Overlapped block motion compensation).
.IP \fBaobmc\fR 4
.IX Item "aobmc"
جبران حرکت بلوکی هم‌پوشان تطبیقی. ضرایب وزن‌دهی پنجره به‌طور تطبیقی با توجه به میزان اطمینان بردارهای حرکتی همسایه کنترل می‌شوند تا از هموارسازی بیش‌ازحد کاسته شود.
.RE
.RS 4
.Sp
حالت پیش‌فرض \fBobmc\fR است.
.RE
.IP \fBme_mode\fR 4
.IX Item "me_mode"
حالت تخمین حرکت. مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBbidir\fR 4
.IX Item "bidir"
تخمین حرکت دوجهته. بردارهای حرکت برای هر فریم مبدأ در هر دو جهت روبه‌جلو و روبه‌عقب تخمین زده می‌شوند.
.IP \fBbilat\fR 4
.IX Item "bilat"
تخمین حرکت دوطرفه (Bilateral). بردارهای حرکت مستقیماً برای فریم درون‌یابی‌شده تخمین زده می‌شوند.
.RE
.RS 4
.Sp
حالت پیش‌فرض \fBbilat\fR است.
.RE
.IP \fBme\fR 4
.IX Item "me"
الگوریتم مورد استفاده برای تخمین حرکت. مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBesa\fR 4
.IX Item "esa"
الگوریتم جستجوی جامع (Exhaustive search algorithm).
.IP \fBtss\fR 4
.IX Item "tss"
الگوریتم جستجوی سه‌مرحله‌ای (Three step search algorithm).
.IP \fBtdls\fR 4
.IX Item "tdls"
الگوریتم جستجوی لگاریتمی دوبعدی (Two dimensional logarithmic search algorithm).
.IP \fBntss\fR 4
.IX Item "ntss"
الگوریتم جستجوی سه‌مرحله‌ای نوین (New three step search algorithm).
.IP \fBfss\fR 4
.IX Item "fss"
الگوریتم جستجوی چهارمرحله‌ای (Four step search algorithm).
.IP \fBds\fR 4
.IX Item "ds"
الگوریتم جستجوی الماسی (Diamond search algorithm).
.IP \fBhexbs\fR 4
.IX Item "hexbs"
الگوریتم جستجوی مبتنی بر شش‌ضلعی (Hexagon\-based search algorithm).
.IP \fBepzs\fR 4
.IX Item "epzs"
الگوریتم جستجوی ناحیه‌ای پیش‌بین ارتقایافته (Enhanced predictive zonal search algorithm).
.IP \fBumh\fR 4
.IX Item "umh"
الگوریتم جستجوی چند شش‌ضلعی ناهمگون (Uneven multi\-hexagon search algorithm).
.RE
.RS 4
.Sp
الگوریتم پیش‌فرض \fBepzs\fR است.
.RE
.IP \fBmb_size\fR 4
.IX Item "mb_size"
اندازه ماکروبلوک. پیش‌فرض \f(CW16\fR است.
.IP \fBsearch_param\fR 4
.IX Item "search_param"
پارامتر جستجوی تخمین حرکت. پیش‌فرض \f(CW32\fR است.
.IP \fBvsbmc\fR 4
.IX Item "vsbmc"
فعال‌سازی جبران حرکت بلوکی با اندازه متغیر. تخمین حرکت با اندازه‌های بلوک کوچک‌تر در مرزهای اشیاء اعمال می‌شود تا تاری آن‌ها کاهش یابد. پیش‌فرض \f(CW0\fR (غیرفعال) است.
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.IP \fBscd\fR 4
.IX Item "scd"
روش تشخیص تغییر صحنه. تغییر صحنه موجب می‌شود بردارهای حرکت در جهتی تصادفی قرار گیرند. تشخیص تغییر صحنه، فریم‌های درون‌یابی‌شده را با فریم‌های تکراری جایگزین می‌کند. ممکن است برای سایر حالت‌ها لازم نباشد. مقادیر زیر پذیرفته می‌شوند:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی تشخیص تغییر صحنه.
.IP \fBfdiff\fR 4
.IX Item "fdiff"
تفاضل فریم. مقادیر پیکسلی متناظر مقایسه می‌شوند و در صورت برآورده شدن آستانه \fIscd_threshold\fR، تغییر صحنه تشخیص داده می‌شود.
.RE
.RS 4
.Sp
روش پیش‌فرض \fBfdiff\fR است.
.RE
.IP \fBscd_threshold\fR 4
.IX Item "scd_threshold"
آستانه تشخیص تغییر صحنه. پیش‌فرض \f(CW10.\fR است.
.SS mix
.IX Subsection "mix"
مخلوط کردن چند جریان ورودی ویدیو در یک جریان ویدیویی واحد.
.PP
توضیحات مربوط به گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBinputs\fR 4
.IX Item "inputs"
تعداد ورودی‌ها. در صورت عدم تعیین، مقدار پیش‌فرض 2 است.
.IP \fBweights\fR 4
.IX Item "weights"
مشخص کردن وزن هر جریان ویدیویی ورودی به صورت یک دنباله.
هر وزن با فاصله (space) جدا می‌شود. اگر تعداد وزن‌ها کمتر از تعداد فریم‌ها (\fIframes\fR) باشد، آخرین وزن مشخص‌شده برای تمامی وزن‌های تعیین‌نشده باقی‌مانده استفاده خواهد شد.
.IP \fBscale\fR 4
.IX Item "scale"
مشخص کردن مقیاس؛ در صورت تنظیم، در مجموع حاصلضرب هر وزن در مقادیر پیکسلی ضرب می‌شود تا مقدار پیکسلی مقصد نهایی حاصل شود. به‌طور پیش‌فرض، \fIscale\fR به‌طور خودکار متناسب با مجموع وزن‌ها مقیاس‌بندی می‌شود.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌ها جهت فیلتر کردن. پیش‌فرض همه پلین‌ها است. محدوده مجاز از 0 تا 15 است.
.IP \fBduration\fR 4
.IX Item "duration"
مشخص کردن چگونگی تعیین پایان جریان.
.RS 4
.IP \fBlongest\fR 4
.IX Item "longest"
مدت‌زمان طولانی‌ترین ورودی. (پیش‌فرض)
.IP \fBshortest\fR 4
.IX Item "shortest"
مدت‌زمان کوتاه‌ترین ورودی.
.IP \fBfirst\fR 4
.IX Item "first"
مدت‌زمان نخستین ورودی.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBweights\fR 4
.IX Item "weights"
.PD 0
.IP \fBscale\fR 4
.IX Item "scale"
.IP \fBplanes\fR 4
.IX Item "planes"
.PD
ساختار نحوی مشابه با گزینه هم‌نام است.
.SS monochrome
.IX Subsection "monochrome"
تبدیل ویدیو به تصویر با طیف خاکستری با استفاده از فیلتر رنگی سفارشی.
.PP
توضیحات مربوط به گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBcb\fR 4
.IX Item "cb"
تنظیم نقطه آبی کروما (chroma blue). محدوده مجاز از \-1 تا 1 است.
مقدار پیش‌فرض 0 است.
.IP \fBcr\fR 4
.IX Item "cr"
تنظیم نقطه قرمز کروما (chroma red). محدوده مجاز از \-1 تا 1 است.
مقدار پیش‌فرض 0 است.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه فیلتر رنگ. محدوده مجاز از .1 تا 10 است.
مقدار پیش‌فرض 1 است.
.IP \fBhigh\fR 4
.IX Item "high"
تنظیم شدت روشنایی‌ها (highlights). محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض 0 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS morpho
.IX Subsection "morpho"
این فیلتر امکان اعمال تبدیلات ریخت‌شناسی (مورفولوژیکی) اصلی مقیاس خاکستری، یعنی فرسایش (erode) و اتساع (dilate) را با ساختارهای دلخواه تعیین‌شده در دومین جریان ورودی فراهم می‌کند.
.PP
برخلاف پیاده‌سازی ساده و کارایی بسیار کندتر در فیلترهای \fBerosion\fR و \fBdilation\fR، هنگامی که سرعت اهمیت حیاتی دارد باید به جای آن‌ها از فیلتر \f(CW\*(C`morpho\*(C'\fR استفاده شود.
.PP
توضیحات مربوط به گزینه‌های پذیرفته‌شده در ادامه آمده است:
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم تبدیل ریخت‌شناسی جهت اعمال، می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBerode\fR 4
.IX Item "erode"
.PD 0
.IP \fBdilate\fR 4
.IX Item "dilate"
.IP \fBopen\fR 4
.IX Item "open"
.IP \fBclose\fR 4
.IX Item "close"
.IP \fBgradient\fR 4
.IX Item "gradient"
.IP \fBtophat\fR 4
.IX Item "tophat"
.IP \fBblackhat\fR 4
.IX Item "blackhat"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`erode\*(C'\fR است.
.RE
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌ها جهت فیلتر کردن؛ به‌طور پیش‌فرض تمامی پلین‌ها به جز آلفا فیلتر می‌شوند.
.IP \fBstructure\fR 4
.IX Item "structure"
تنظیم این‌که کدام فریم‌های ویدیویی ساختار از جریان ورودی دوم پردازش شوند؛ می‌تواند \fIfirst\fR یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
.PP
فیلتر \f(CW\*(C`morpho\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.SS mpdecimate
.IX Subsection "mpdecimate"
حذف (Drop) فریم‌هایی که تفاوت چندانی با فریم قبلی ندارند به منظور کاهش نرخ فریم.
.PP
کاربرد اصلی این فیلتر برای انکودینگ با بیت‌ریت بسیار پایین (مانند استریم روی مودم دیال‌آپ) است، اما از نظر تئوری می‌توان از آن برای اصلاح فیلم‌هایی که تله‌سینه معکوس آن‌ها به نادرستی انجام شده است نیز استفاده کرد.
.PP
توضیحات مربوط به گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBmax\fR 4
.IX Item "max"
تنظیم حداکثر تعداد فریم‌های متوالی که می‌توانند حذف شوند (در صورت مثبت بودن)، یا حداقل فاصله بین فریم‌های حذف‌شده (در صورت منفی بودن). اگر مقدار 0 باشد، فریم بدون توجه به تعداد فریم‌های متوالی حذف‌شده قبلی، حذف می‌شود.
.Sp
مقدار پیش‌فرض 0 است.
.IP \fBkeep\fR 4
.IX Item "keep"
تنظیم حداکثر تعداد فریم‌های مشابه متوالی جهت نادیده‌گرفتن پیش از شروع به حذف آن‌ها.
اگر مقدار 0 باشد، فریم بدون توجه به تعداد فریم‌های مشابه متوالی پیشین، حذف می‌شود.
.Sp
مقدار پیش‌فرض 0 است.
.IP \fBhi\fR 4
.IX Item "hi"
.PD 0
.IP \fBlo\fR 4
.IX Item "lo"
.IP \fBfrac\fR 4
.IX Item "frac"
.PD
تنظیم مقادیر آستانه حذف فریم.
.Sp
مقادیر \fBhi\fR و \fBlo\fR برای بلوک‌های پیکسلی 8x8 هستند و تفاوت واقعی مقادیر پیکسل‌ها را نشان می‌دهند، بنابراین آستانه 64 متناظر با ۱ واحد تفاوت برای هر پیکسل، یا همان مقدار به شکل متفاوتی توزیع‌شده بر روی بلوک است.
.Sp
یک فریم کاندیدای حذف است اگر هیچ بلوک 8x8 بیشتر از آستانه \fBhi\fR تفاوت نداشته باشد، و بیش از کسری از بلوک‌ها به میزان \fBfrac\fR (مقدار 1 به معنای کل تصویر است) اختلافی بیش از آستانه \fBlo\fR نداشته باشند.
.Sp
مقدار پیش‌فرض برای \fBhi\fR برابر 64*12، مقدار پیش‌فرض برای \fBlo\fR برابر 64*5 و مقدار پیش‌فرض برای \fBfrac\fR برابر 0.33 است.
.SS msad
.IX Subsection "msad"
به دست آوردن میانگین مجموع تفاضل‌های مطلق (MSAD \- Mean Sum of Absolute Differences) میان دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی می‌گیرد.
.PP
برای عملکرد صحیح این فیلتر، هر دو ویدیوی ورودی باید رزولوشن و فرمت پیکسلی یکسانی داشته باشند. همچنین فرض می‌شود که هر دو ورودی تعداد فریم‌های برابری دارند که یک‌به‌یک مقایسه می‌شوند.
.PP
مقادیر MSAD به دست آمده به تفکیک مؤلفه، میانگین، کمینه و بیشینه از طریق سامانه لاگ‌گیری چاپ می‌شوند.
.PP
این فیلتر مقدار MSAD محاسبه‌شده هر فریم را در متادیتای فریم ذخیره می‌کند.
.PP
این فیلتر از گزینه‌های \fBframesync\fR نیز پشتیبانی می‌کند.
.PP
در مثال زیر، فایل ورودی در حال پردازش \fImain.mpg\fR با فایل مرجع \fIref.mpg\fR مقایسه می‌شود.
.PP
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mpg \-lavfi msad \-f null \-
.Ve
.SS multiply
.IX Subsection "multiply"
ضرب مقادیر پیکسلی نخستین جریان ویدیویی در مقادیر پیکسلی دومین جریان ویدیویی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس اعمال‌شده بر جریان ویدیویی دوم. به‌طور پیش‌فرض \f(CW1\fR است.
محدوده مجاز از \f(CW0\fR تا \f(CW9\fR است.
.IP \fBoffset\fR 4
.IX Item "offset"
تنظیم آفست (انحراف) اعمال‌شده بر جریان ویدیویی دوم. به‌طور پیش‌فرض \f(CW0.5\fR است.
محدوده مجاز از \f(CW\-1\fR تا \f(CW1\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
مشخص کردن پلین‌هایی از جریان ویدیویی ورودی که پردازش خواهند شد.
به‌طور پیش‌فرض تمام پلین‌ها پردازش می‌شوند.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.SS negate
.IX Subsection "negate"
معکوس کردن (نگاتیو کردن) ویدیوی ورودی.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBcomponents\fR 4
.IX Item "components"
تنظیم مؤلفه‌ها جهت معکوس‌سازی.
.Sp
مقادیر موجود برای مؤلفه‌ها عبارتند از:
.RS 4
.IP \fBy\fR 4
.IX Item "y"
.PD 0
.IP \fBu\fR 4
.IX Item "u"
.IP \fBv\fR 4
.IX Item "v"
.IP \fBa\fR 4
.IX Item "a"
.IP \fBr\fR 4
.IX Item "r"
.IP \fBg\fR 4
.IX Item "g"
.IP \fBb\fR 4
.IX Item "b"
.PD
.RE
.RS 4
.RE
.IP \fBnegate_alpha\fR 4
.IX Item "negate_alpha"
با مقدار 1، مؤلفه آلفا (در صورت وجود) معکوس می‌شود. مقدار پیش‌فرض 0 است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
.SS nlmeans
.IX Subsection "nlmeans"
نویززدایی فریم‌ها با استفاده از الگوریتم میانگین‌های غیرمحلی (Non\-Local Means).
.PP
هر پیکسل با بررسی سایر پیکسل‌ها با زمینه‌های مشابه تنظیم می‌شود. این شباهت زمینه با مقایسه وصله‌های پیرامونی آن‌ها با اندازه \fBp\fRx\fBp\fR تعریف می‌گردد. وصله‌ها در ناحیه‌ای به ابعاد \fBr\fRx\fBr\fR در اطراف پیکسل جستجو می‌شوند.
.PP
توجه داشته باشید که ناحیه جستجو مراکز وصله‌ها را تعیین می‌کند، به این معنی که برخی از وصله‌ها از پیکسل‌های خارج از آن ناحیه جستجو تشکیل خواهند شد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBs\fR 4
.IX Item "s"
تنظیم قدرت نویززدایی. پیش‌فرض 1.0 است. باید در محدوده [1.0, 30.0] باشد.
.IP \fBp\fR 4
.IX Item "p"
تنظیم اندازه وصله (patch). پیش‌فرض 7 است. باید یک عدد فرد در محدوده [0, 99] باشد.
.IP \fBpc\fR 4
.IX Item "pc"
مشابه با \fBp\fR اما برای پلین‌های کروما.
.Sp
مقدار پیش‌فرض \fI0\fR و به معنای خودکار است.
.IP \fBr\fR 4
.IX Item "r"
تنظیم اندازه ناحیه جستجو. پیش‌فرض 15 است. باید یک عدد فرد در محدوده [0, 99] باشد.
.IP \fBrc\fR 4
.IX Item "rc"
مشابه با \fBr\fR اما برای پلین‌های کروما.
.Sp
مقدار پیش‌فرض \fI0\fR و به معنای خودکار است.
.SS nnedi
.IX Subsection "nnedi"
دی‌اینترلیس ویدیو با استفاده از درون‌یابی جهت‌دار لبه با شبکه عصبی (neural network edge directed interpolation).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBweights\fR 4
.IX Item "weights"
گزینه اجباری؛ بدون فایل باینری فیلتر نمی‌تواند کار کند.
در حال حاضر این فایل در نشانی زیر قابل دریافت است:
https://github.com/dubhater/vapoursynth\-nnedi3/blob/master/src/nnedi3_weights.bin
.IP \fBdeint\fR 4
.IX Item "deint"
تنظیم فریم‌ها برای دی‌اینترلیس؛ به‌طور پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
می‌تواند \f(CW\*(C`all\*(C'\fR یا \f(CW\*(C`interlaced\*(C'\fR باشد.
.IP \fBfield\fR 4
.IX Item "field"
تنظیم حالت عملکرد.
.Sp
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBaf\fR 4
.IX Item "af"
استفاده از پرچم‌های فریم، هر دو فیلد.
.IP \fBa\fR 4
.IX Item "a"
استفاده از پرچم‌های فریم، تک فیلد.
.IP \fBt\fR 4
.IX Item "t"
استفاده فقط از فیلد بالایی.
.IP \fBb\fR 4
.IX Item "b"
استفاده فقط از فیلد پایینی.
.IP \fBtf\fR 4
.IX Item "tf"
استفاده از هر دو فیلد، ابتدا فیلد بالایی.
.IP \fBbf\fR 4
.IX Item "bf"
استفاده از هر دو فیلد، ابتدا فیلد پایینی.
.RE
.RS 4
.RE
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم پلین‌های پردازش؛ به‌طور پیش‌فرض فیلتر تمامی پلین‌ها را پردازش می‌کند.
.IP \fBnsize\fR 4
.IX Item "nsize"
تنظیم اندازه همسایگی محلی در اطراف هر پیکسل، که توسط شبکه عصبی پیش‌بین استفاده می‌شود.
.Sp
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBs8x6\fR 4
.IX Item "s8x6"
.PD 0
.IP \fBs16x6\fR 4
.IX Item "s16x6"
.IP \fBs32x6\fR 4
.IX Item "s32x6"
.IP \fBs48x6\fR 4
.IX Item "s48x6"
.IP \fBs8x4\fR 4
.IX Item "s8x4"
.IP \fBs16x4\fR 4
.IX Item "s16x4"
.IP \fBs32x4\fR 4
.IX Item "s32x4"
.PD
.RE
.RS 4
.RE
.IP \fBnns\fR 4
.IX Item "nns"
تنظیم تعداد نورون‌ها در شبکه عصبی پیش‌بین.
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBn16\fR 4
.IX Item "n16"
.PD 0
.IP \fBn32\fR 4
.IX Item "n32"
.IP \fBn64\fR 4
.IX Item "n64"
.IP \fBn128\fR 4
.IX Item "n128"
.IP \fBn256\fR 4
.IX Item "n256"
.PD
.RE
.RS 4
.RE
.IP \fBqual\fR 4
.IX Item "qual"
کنترل تعداد پیش‌بینی‌های مختلف شبکه عصبی که برای محاسبه مقدار خروجی نهایی با هم ادغام می‌شوند. می‌تواند \f(CW\*(C`fast\*(C'\fR، پیش‌فرض یا \f(CW\*(C`slow\*(C'\fR باشد.
.IP \fBetype\fR 4
.IX Item "etype"
تنظیم مجموعه وزن‌های مورد استفاده در پیش‌بین.
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP "\fBa, abs\fR" 4
.IX Item "a, abs"
وزن‌های آموزش‌دیده برای کمینه‌سازی خطای مطلق
.IP "\fBs, mse\fR" 4
.IX Item "s, mse"
وزن‌های آموزش‌دیده برای کمینه‌سازی خطای مربعات
.RE
.RS 4
.RE
.IP \fBpscrn\fR 4
.IX Item "pscrn"
کنترل این‌که آیا از شبکه عصبی پیش‌غربال‌گر (prescreener) برای تصمیم‌گیری در مورد این‌که کدام پیکسل‌ها باید توسط شبکه عصبی پیش‌بین پردازش شوند و کدامیک با درون‌یابی مکعبی ساده قابل رسیدگی هستند استفاده شود یا خیر.
پیش‌غربال‌گر آموزش دیده است تا بداند آیا درون‌یابی مکعبی برای یک پیکسل کافی خواهد بود یا باید توسط شبکه عصبی پیش‌بین پیش‌بینی شود.
پیچیدگی محاسباتی شبکه عصبی پیش‌غربال‌گر بسیار کمتر از شبکه عصبی پیش‌بین است. از آنجا که بیشتر پیکسل‌ها را می‌توان با درون‌یابی مکعبی پردازش کرد، استفاده از پیش‌غربال‌گر عموماً منجر به پردازش بسیار سریع‌تر می‌شود.
پیش‌غربال‌گر کاملاً دقیق است، بنابراین تفاوت بین استفاده از آن و عدم استفاده از آن تقریباً همیشه نامحسوس است.
.Sp
می‌تواند یکی از مقادیر زیر باشد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
.PD 0
.IP \fBoriginal\fR 4
.IX Item "original"
.IP \fBnew\fR 4
.IX Item "new"
.IP \fBnew2\fR 4
.IX Item "new2"
.IP \fBnew3\fR 4
.IX Item "new3"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`new\*(C'\fR است.
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها، به جز گزینه \fIweights\fR پشتیبانی می‌کند.
.SS noformat
.IX Subsection "noformat"
مجبور ساختن libavfilter به عدم استفاده از هر یک از فرمت‌های پیکسلی مشخص‌شده برای ورودی فیلتر بعدی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBpix_fmts\fR 4
.IX Item "pix_fmts"
فهرستی از نام‌های فرمت پیکسلی جداشده با \*(Aq|\*(Aq، مانند
pix_fmts=yuv420p|monow|rgb24".
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
مجبور ساختن libavfilter به استفاده از فرمتی متفاوت از \fIyuv420p\fR برای ورودی به فیلتر vflip:
.Sp
.Vb 1
\&        noformat=pix_fmts=yuv420p,vflip
.Ve
.IP \(bu 4
تبدیل ویدیوی ورودی به هر یک از فرمت‌هایی که در این فهرست وجود ندارند:
.Sp
.Vb 1
\&        noformat=yuv420p|yuv444p|yuv410p
.Ve
.SS noise
.IX Subsection "noise"
افزودن نویز بر روی فریم ورودی ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBall_seed\fR 4
.IX Item "all_seed"
.PD 0
.IP \fBc0_seed\fR 4
.IX Item "c0_seed"
.IP \fBc1_seed\fR 4
.IX Item "c1_seed"
.IP \fBc2_seed\fR 4
.IX Item "c2_seed"
.IP \fBc3_seed\fR 4
.IX Item "c3_seed"
.PD
تنظیم سید (بذر) نویز برای مؤلفه پیکسلی خاص، یا برای تمام مؤلفه‌های پیکسلی در صورت استفاده از \fIall_seed\fR. مقدار پیش‌فرض \f(CW123457\fR است.
.IP "\fBall_strength, alls\fR" 4
.IX Item "all_strength, alls"
.PD 0
.IP "\fBc0_strength, c0s\fR" 4
.IX Item "c0_strength, c0s"
.IP "\fBc1_strength, c1s\fR" 4
.IX Item "c1_strength, c1s"
.IP "\fBc2_strength, c2s\fR" 4
.IX Item "c2_strength, c2s"
.IP "\fBc3_strength, c3s\fR" 4
.IX Item "c3_strength, c3s"
.PD
تنظیم شدت نویز برای مؤلفه پیکسلی خاص یا تمام مؤلفه‌های پیکسلی در صورت استفاده از \fIall_strength\fR. مقدار پیش‌فرض \f(CW0\fR است. محدوده مجاز [0, 100] است.
.IP "\fBall_flags, allf\fR" 4
.IX Item "all_flags, allf"
.PD 0
.IP "\fBc0_flags, c0f\fR" 4
.IX Item "c0_flags, c0f"
.IP "\fBc1_flags, c1f\fR" 4
.IX Item "c1_flags, c1f"
.IP "\fBc2_flags, c2f\fR" 4
.IX Item "c2_flags, c2f"
.IP "\fBc3_flags, c3f\fR" 4
.IX Item "c3_flags, c3f"
.PD
تنظیم فلگ‌های مؤلفه پیکسلی یا تنظیم پرچم‌ها برای تمام مؤلفه‌ها در صورت استفاده از \fIall_flags\fR.
مقادیر موجود برای پرچم‌های مؤلفه عبارتند از:
.RS 4
.IP \fBa\fR 4
.IX Item "a"
نویز زمانی میانگین‌گیری‌شده (هموارتر)
.IP \fBp\fR 4
.IX Item "p"
ترکیب نویز تصادفی با یک الگوی (نیمه) منظم
.IP \fBt\fR 4
.IX Item "t"
نویز زمانی (الگوی نویز بین فریم‌ها تغییر می‌کند)
.IP \fBu\fR 4
.IX Item "u"
نویز یکنواخت (در غیر این صورت گاوسی)
.RE
.RS 4
.RE
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
افزودن نویز زمانی و یکنواخت به ویدیوی ورودی:
.PP
.Vb 1
\&        noise=alls=20:allf=t+u
.Ve
.SS normalize
.IX Subsection "normalize"
نرمال‌سازی ویدیوی RGB (معروف به کشش هیستوگرام، کشش کنتراست).
ببینید: https://en.wikipedia.org/wiki/Normalization_(image_processing)
.PP
برای هر کانال از هر فریم، فیلتر محدوده ورودی را محاسبه کرده و آن را به صورت خطی به محدوده خروجی مشخص‌شده توسط کاربر نگاشت می‌کند. محدوده خروجی به‌طور پیش‌فرض کل محدوده دینامیکی از سیاه خالص تا سفید خالص است.
.PP
می‌توان از هموارسازی زمانی (temporal smoothing) روی محدوده ورودی برای کاهش سوسوزدن (تغییرات سریع روشنایی) ناشی از ورود یا خروج اشیاء کوچک تیره یا روشن به صحنه استفاده کرد. این شبیه به نوردهی خودکار (کنترل خودکار بهره) در یک دوربین ویدیویی است و مانند دوربین ویدیویی، ممکن است موجب دوره‌ای از بیش‌نوردهی یا کم‌نوردهی ویدیو شود.
.PP
کانال‌های R، G، B را می‌توان به صورت مستقل نرمال کرد که ممکن است باعث مقداری تغییر رنگ (color shifting) شود، یا به صورت پیوندیافته با یکدیگر به عنوان یک تک‌کانال، که از تغییر رنگ جلوگیری می‌کند. نرمال‌سازی پیوندیافته فام رنگ (hue) را حفظ می‌کند. نرمال‌سازی مستقل این کار را نمی‌کند، بنابراین می‌توان از آن برای حذف برخی خطاهای رنگی (color casts) استفاده کرد. نرمال‌سازی مستقل و پیوندیافته را می‌توان با هر نسبتی ترکیب کرد.
.PP
فیلتر normalize گزینه‌های زیر را می‌پذیرد:
.IP \fBblackpt\fR 4
.IX Item "blackpt"
.PD 0
.IP \fBwhitept\fR 4
.IX Item "whitept"
.PD
رنگ‌هایی که محدوده خروجی را تعریف می‌کنند. کمترین مقدار ورودی به \fIblackpt\fR نگاشت می‌شود. بیشترین مقدار ورودی به \fIwhitept\fR نگاشت می‌شود. مقادیر پیش‌فرض به ترتیب سیاه و سفید هستند. مشخص کردن رنگ سفید برای \fIblackpt\fR و سیاه برای \fIwhitept\fR ویدیوی نرمال‌شده با رنگ معکوس ارائه می‌دهد. سایه‌های خاکستری می‌توانند برای کاهش محدوده دینامیکی (کنتراست) استفاده شوند. مشخص کردن رنگ‌های اشباع در اینجا می‌تواند جلوه‌های جالبی ایجاد کند.
.IP \fBsmoothing\fR 4
.IX Item "smoothing"
تعداد فریم‌های قبلی جهت استفاده برای هموارسازی زمانی. محدوده ورودی هر کانال با استفاده از میانگین متحرک روی فریم فعلی و \fIsmoothing\fR فریم پیشین هموار می‌شود. پیش‌فرض 0 است (بدون هموارسازی زمانی).
.IP \fBindependence\fR 4
.IX Item "independence"
کنترل نسبت نرمال‌سازی مستقل کانال‌ها (تغییردهنده رنگ) به نرمال‌سازی پیوندیافته (حفظ‌کننده رنگ). مقدار 0.0 کاملاً پیوندیافته و 1.0 کاملاً مستقل است. پیش‌فرض 1.0 (کاملاً مستقل) است.
.IP \fBstrength\fR 4
.IX Item "strength"
قدرت کلی فیلتر. مقدار 1.0 قدرت کامل است. مقدار 0.0 یک عملیات بی‌اثر نسبتاً پرهزینه است. پیش‌فرض 1.0 (قدرت کامل) است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها، به جز گزینه \fIsmoothing\fR پشتیبانی می‌کند.
این دستور ساختار نحوی مشابه با گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
کشش کنتراست ویدیو برای استفاده از تمام محدوده دینامیکی، بدون هموارسازی زمانی؛ بسته به محتوای مبدأ ممکن است سوسو بزند:
.PP
.Vb 1
\&        normalize=blackpt=black:whitept=white:smoothing=0
.Ve
.PP
همانند بالا، اما با ۵۰ فریم هموارسازی زمانی؛ بسته به محتوای مبدأ سوسوزدن باید کاهش یابد:
.PP
.Vb 1
\&        normalize=blackpt=black:whitept=white:smoothing=50
.Ve
.PP
همانند بالا، اما با نرمال‌سازی کانال‌های پیوندیافته با حفظ فام رنگ:
.PP
.Vb 1
\&        normalize=blackpt=black:whitept=white:smoothing=50:independence=0
.Ve
.PP
همانند بالا، اما با نصف قدرت:
.PP
.Vb 1
\&        normalize=blackpt=black:whitept=white:smoothing=50:independence=0:strength=0.5
.Ve
.PP
نگاشت تاریک‌ترین رنگ ورودی به قرمز، روشن‌ترین رنگ ورودی به فیروزه‌ای:
.PP
.Vb 1
\&        normalize=blackpt=red:whitept=cyan
.Ve
.SS null
.IX Subsection "null"
عبور دادن منبع ویدیو به خروجی بدون هیچ تغییری.
.SS ocio
.IX Subsection "ocio"
فیلتر کتابخانه OpenColorIO
.PP
این فیلتر به شما امکان می‌دهد مدیریت رنگ را با استفاده از کتابخانه OpenColorIO انجام دهید.
برای جزئیات بیشتر به https://opencolorio.org مراجعه کنید. برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با \f(CW\*(C`\-\-enable\-libopencolorio\*(C'\fR پیکربندی کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBconfig\fR 4
.IX Item "config"
به‌طور پیش‌فرض فیلتر از پیکربندی OCIO تعریف‌شده توسط متغیر محیطی OCIO استفاده خواهد کرد، اما این پارامتر به شما امکان می‌دهد مکان آن را به‌طور صریح مشخص کنید.
اگر به تازگی کار را آغاز کرده‌اید، می‌توانید از config=ocio://studio\-config\-v1.0.0_aces\-v1.3_ocio\-v2.1 استفاده کنید که یکی از پیش‌فرض‌های داخلی را مشخص می‌کند.
.IP \fBinput\fR 4
.IX Item "input"
تنظیم فضای رنگی ورودی.
.IP \fBoutput\fR 4
.IX Item "output"
تنظیم فضای رنگی خروجی.
.IP \fBdisplay\fR 4
.IX Item "display"
تنظیم فضای رنگی نمایشگر، در ترکیب با view استفاده می‌شود.
.IP \fBview\fR 4
.IX Item "view"
تنظیم فضای رنگی نما (view)، در ترکیب با display استفاده می‌شود.
.IP \fBinverse\fR 4
.IX Item "inverse"
هنگام استفاده در ترکیب با display و view، این گزینه تبدیل را معکوس می‌کند، بنابراین از یک display/view به "فضای رنگی ورودی" می‌رود.
.IP \fBfiletransform\fR 4
.IX Item "filetransform"
به شما امکان می‌دهد به جای فایل پیکربندی OCIO، یک فایل تبدیل خارجی مشخص کنید. این گزینه برای اعمال یک تبدیل منفرد بدون نیاز به یک فایل پیکربندی کامل OCIO سودمند است.
.IP \fBformat\fR 4
.IX Item "format"
به شما اجازه می‌دهد فرمت پیکسلی (pix_fmt) خروجی فیلتر OCIO را تعیین کنید. این مقدار *حتماً* باید یک فضای رنگی RGB باشد، بنابراین شما محدود به گزینه‌های rgb24، rgba، rgb48، rgba48، gbrp10، gbrp12، gbrpf32le و gbrapf32le هستید؛ برای اغلب موارد انکودینگ rgb48 توصیه می‌شود.
.IP \fBcontext_params\fR 4
.IX Item "context_params"
به شما اجازه می‌دهد پارامترهای زمینه اضافی را برای فیلتر OCIO مشخص کنید. این یک فهرست از جفت‌های key=value است که با دونقطه از هم جدا شده‌اند.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
نگاشت از ACEScg به ACEScct، با این فرض که فایل OCIO از طریق متغیر محیطی OCIO تعریف شده است.
.PP
.Vb 1
\&        input=ACEScg:output=ACEScct:format=rgb48
.Ve
.PP
نگاشت از ACEScg به یک نمایشگر sRGB با استفاده از تبدیل نمای "ACES 1.0 \- SDR Video"، با این فرض که فایل OCIO از طریق متغیر محیطی OCIO تعریف شده است. توجه داشته باشید که باید آرگومان را درون گیومه قرار دهید تا مطمئن شوید فاصله‌ها به درستی تفسیر می‌شوند.
.PP
.Vb 1
\&        input=ACEScg:display=sRGB \- Display:view=ACES 1.0 \- SDR Video:format=rgb48
.Ve
.PP
همانند بالا اما با استفاده از فایل OCIO به نام studio\-config\-v1.0.0_aces\-v1.3_ocio\-v2.1_ns.ocio به جای متغیر محیطی OCIO.
.PP
.Vb 1
\&        config=studio\-config\-v1.0.0_aces\-v1.3_ocio\-v2.1_ns.ocio:input=ACEScg:display=sRGB \- Display:view=ACES 1.0 \- SDR Video:format=rgb48
.Ve
.PP
اگر در حال تبدیل به YCrCb هستید، همچنان باید ماتریس رنگ را برای تبدیل تنظیم کنید. این یک مثال خوب از ترکیب این دو است.
.PP
.Vb 1
\&        ffmpeg \-y \-i SOURCEFRAMES.%05d.exr \-c:v libx265 \-vf "ocio=input=ACEScg:output=ACEScct:format=rgb48,scale=in_color_matrix=bt709:out_color_matrix=bt709,format=yuv444p10"  OUTPUTFILE.mov
.Ve
.SS ocr
.IX Subsection "ocr"
تشخیص نوری نویسه‌ها (OCR \- Optical Character Recognition)
.PP
این فیلتر از Tesseract برای تشخیص نوری نویسه‌ها استفاده می‌کند. برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با \f(CW\*(C`\-\-enable\-libtesseract\*(C'\fR پیکربندی کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdatapath\fR 4
.IX Item "datapath"
تنظیم مسیر داده‌ها به داده‌های tesseract. پیش‌فرض استفاده از مقداری است که هنگام نصب تعیین شده بود.
.IP \fBlanguage\fR 4
.IX Item "language"
تنظیم زبان، پیش‌فرض "eng" است.
.IP \fBwhitelist\fR 4
.IX Item "whitelist"
تنظیم فهرست مجاز نویسه‌ها.
.IP \fBblacklist\fR 4
.IX Item "blacklist"
تنظیم فهرست غیرمجاز نویسه‌ها.
.PP
این فیلتر متن تشخیص‌داده‌شده را به عنوان متادیتای فریم \f(CW\*(C`lavfi.ocr.text\*(C'\fR صادر می‌کند.
این فیلتر میزان اطمینان کلمات تشخیص‌داده‌شده را به عنوان متادیتای فریم \f(CW\*(C`lavfi.ocr.confidence\*(C'\fR صادر می‌کند.
.SS ocv
.IX Subsection "ocv"
اعمال تبدیل ویدیویی با استفاده از libopencv.
.PP
برای فعال‌سازی این فیلتر، کتابخانه و هدرهای libopencv را نصب کرده و FFmpeg را با \f(CW\*(C`\-\-enable\-libopencv\*(C'\fR پیکربندی کنید.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBfilter_name\fR 4
.IX Item "filter_name"
نام فیلتر libopencv برای اعمال.
.IP \fBfilter_params\fR 4
.IX Item "filter_params"
پارامترهایی که به فیلتر libopencv ارسال می‌شوند. در صورت عدم تعیین، مقادیر پیش‌فرض فرض خواهند شد.
.PP
برای اطلاعات دقیق‌تر به مستندات رسمی libopencv مراجعه فرمایید:
<\fBhttp://docs.opencv.org/master/modules/imgproc/doc/filtering.html\fR>
.PP
چندین فیلتر libopencv پشتیبانی می‌شوند؛ به بخش‌های زیر مراجعه کنید.
.PP
\fIdilate\fR
.IX Subsection "dilate"
.PP
اتساع یک تصویر با استفاده از یک عنصر ساختاری مشخص.
این متناظر با تابع \f(CW\*(C`cvDilate\*(C'\fR در libopencv است.
.PP
پارامترهای زیر را می‌پذیرد: \fIstruct_el\fR|\fInb_iterations\fR.
.PP
\&\fIstruct_el\fR یک عنصر ساختاری را نشان می‌دهد و ساختار نحوی زیر را دارد:
\&\fIcols\fRx\fIrows\fR+\fIanchor_x\fRx\fIanchor_y\fR/\fIshape\fR
.PP
\&\fIcols\fR و \fIrows\fR نشان‌دهنده تعداد ستون‌ها و ردیف‌های عنصر ساختاری هستند، \fIanchor_x\fR و \fIanchor_y\fR نقطه لنگر (anchor point)، و \fIshape\fR شکل عنصر ساختاری است. \fIshape\fR باید "rect" یا "cross" یا "ellipse" یا "custom" باشد.
.PP
اگر مقدار \fIshape\fR برابر "custom" باشد، باید رشته‌ای با فرمت "=\fIfilename\fR" به دنبال آن بیاید. فرض می‌شود فایلی با نام \fIfilename\fR یک تصویر باینری را نشان می‌دهد که در آن هر نویسه قابل چاپ متناظر با یک پیکسل روشن است. هنگامی که یک \fIshape\fR سفارشی استفاده می‌شود، \fIcols\fR و \fIrows\fR نادیده گرفته شده و تعداد ستون‌ها و ردیف‌های فایل خوانده‌شده به جای آن فرض می‌شود.
.PP
مقدار پیش‌فرض برای \fIstruct_el\fR برابر "3x3+0x0/rect" است.
.PP
\&\fInb_iterations\fR تعداد دفعاتی را مشخص می‌کند که تبدیل بر روی تصویر اعمال می‌شود، و پیش‌فرض آن 1 است.
.PP
چند مثال:
.PP
.Vb 2
\&        # استفاده از مقادیر پیش‌فرض
\&        ocv=dilate
\&
\&        # اتساع با استفاده از عنصر ساختاری صلیب 5x5، با دو تکرار
\&        ocv=filter_name=dilate:filter_params=5x5+2x2/cross|2
\&
\&        # خواندن شکل از فایل diamond.shape، با دو تکرار.
\&        # فایل diamond.shape ممکن است شامل الگویی از نویسه‌ها مانند این باشد:
\&        #   *
\&        #  ***
\&        # *****
\&        #  ***
\&        #   *
\&        # ستون‌ها و ردیف‌های مشخص‌شده نادیده گرفته می‌شوند
\&        # اما مختصات نقطه لنگر نادیده گرفته نمی‌شوند
\&        ocv=dilate:0x0+2x2/custom=diamond.shape|2
.Ve
.PP
\fIerode\fR
.IX Subsection "erode"
.PP
فرسایش یک تصویر با استفاده از یک عنصر ساختاری مشخص.
این متناظر با تابع \f(CW\*(C`cvErode\*(C'\fR در libopencv است.
.PP
پارامترهای \fIstruct_el\fR:\fInb_iterations\fR را با همان ساختار نحوی و مفاهیم فیلتر \fBdilate\fR می‌پذیرد.
.PP
\fIsmooth\fR
.IX Subsection "smooth"
.PP
هموارسازی ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌گیرد:
\&\fItype\fR|\fIparam1\fR|\fIparam2\fR|\fIparam3\fR|\fIparam4\fR.
.PP
\&\fItype\fR نوع فیلتر هموارسازی جهت اعمال است، و باید یکی از مقادیر زیر باشد: "blur"، "blur_no_scale"، "median"، "gaussian" یا "bilateral". مقدار پیش‌فرض "gaussian" است.
.PP
معنای \fIparam1\fR، \fIparam2\fR، \fIparam3\fR و \fIparam4\fR به نوع فیلتر هموارسازی بستگی دارد. \fIparam1\fR و \fIparam2\fR مقادیر عدد صحیح مثبت یا 0 را می‌پذیرند. \fIparam3\fR و \fIparam4\fR مقادیر اعشاری (ممیز شناور) را می‌پذیرند.
.PP
مقدار پیش‌فرض برای \fIparam1\fR برابر 3 است. مقدار پیش‌فرض برای سایر پارامترها 0 است.
.PP
این پارامترها متناظر با پارامترهای اختصاص‌یافته به تابع \f(CW\*(C`cvSmooth\*(C'\fR در libopencv هستند.
.SS oscilloscope
.IX Subsection "oscilloscope"
اسیلوسکوپ ویدیویی دوبعدی.
.PP
سودمند برای اندازه‌گیری پاسخ ضربه مکانی، پاسخ‌های پله، تأخیرهای کروما و غیره.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
تنظیم موقعیت افقی (x) مرکز اسکوپ.
.IP \fBy\fR 4
.IX Item "y"
تنظیم موقعیت عمودی (y) مرکز اسکوپ.
.IP \fBs\fR 4
.IX Item "s"
تنظیم اندازه اسکوپ، نسبت به قطر فریم.
.IP \fBt\fR 4
.IX Item "t"
تنظیم شیب/چرخش اسکوپ.
.IP \fBo\fR 4
.IX Item "o"
تنظیم کدر بودن (opacity) رد نما.
.IP \fBtx\fR 4
.IX Item "tx"
تنظیم موقعیت افقی (x) مرکز رد نما.
.IP \fBty\fR 4
.IX Item "ty"
تنظیم موقعیت عمودی (y) مرکز رد نما.
.IP \fBtw\fR 4
.IX Item "tw"
تنظیم عرض رد نما، نسبت به عرض فریم.
.IP \fBth\fR 4
.IX Item "th"
تنظیم ارتفاع رد نما، نسبت به ارتفاع فریم.
.IP \fBc\fR 4
.IX Item "c"
تنظیم مؤلفه‌هایی که باید ردیابی شوند. به‌طور پیش‌فرض سه مؤلفه نخست را ردیابی می‌کند.
.IP \fBg\fR 4
.IX Item "g"
ترسیم شبکه شطرنجی رد نما. به‌طور پیش‌فرض فعال است.
.IP \fBst\fR 4
.IX Item "st"
ترسیم برخی آمارها. به‌طور پیش‌فرض فعال است.
.IP \fBsc\fR 4
.IX Item "sc"
ترسیم اسکوپ. به‌طور پیش‌فرض فعال است.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستوراتی مشابه گزینه‌ها پشتیبانی می‌کند.
این دستور ساختار نحوی مشابه با گزینه متناظر را می‌پذیرد.
.PP
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
بررسی کامل نخستین ردیف فریم ویدیو:
.Sp
.Vb 1
\&        oscilloscope=x=0.5:y=0:s=1
.Ve
.IP \(bu 4
بررسی کامل آخرین ردیف فریم ویدیو:
.Sp
.Vb 1
\&        oscilloscope=x=0.5:y=1:s=1
.Ve
.IP \(bu 4
بررسی کامل خط پنجم از یک فریم ویدیویی با ارتفاع 1080:
.Sp
.Vb 1
\&        oscilloscope=x=0.5:y=5/1080:s=1
.Ve
.IP \(bu 4
بررسی کامل آخرین ستون فریم ویدیو:
.Sp
.Vb 1
\&        oscilloscope=x=1:y=0.5:s=1:t=1
.Ve
.SS overlay
.IX Subsection "overlay"
هم‌پوشانی یک ویدیو بر روی ویدیوی دیگر.
.PP
این فیلتر دو ورودی دریافت کرده و یک خروجی ارائه می‌دهد. ورودی نخست ویدیوی "اصلی" (main) است که ورودی دوم روی آن هم‌پوشانی می‌شود.
.PP
پارامترهای زیر را می‌پذیرد:
.PP
توضیحات مربوط به گزینه‌های پذیرفته‌شده در ادامه آمده است:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم عبارت برای مختصات x و y ویدیوی هم‌پوشانی‌شده روی ویدیوی اصلی. مقدار پیش‌فرض برای هر دو عبارت "0" است. در صورتی که عبارت نامعتبر باشد، روی مقداری بسیار بزرگ تنظیم می‌شود (به این معنی که هم‌پوشانی درون ناحیه قابل مشاهده خروجی نمایش داده نخواهد شد).
.IP \fBeof_action\fR 4
.IX Item "eof_action"
به \fBframesync\fR مراجعه کنید.
.IP \fBeval\fR 4
.IX Item "eval"
تنظیم زمان ارزیابی عبارت‌های \fBx\fR و \fBy\fR.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
تنها یک بار در طول مقداردهی اولیه فیلتر یا هنگام پردازش یک دستور عبارت‌ها را ارزیابی می‌کند
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارت‌ها به ازای هر فریم ورودی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBframe\fR است.
.RE
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBframesync\fR مراجعه کنید.
.IP \fBformat\fR 4
.IX Item "format"
تنظیم فرمت برای ویدیوی خروجی.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fByuv420\fR 4
.IX Item "yuv420"
اجبار خروجی صفحه‌ای (planar) با فرمت YUV 4:2:0 ۸ بیتی
.IP \fByuv420p10\fR 4
.IX Item "yuv420p10"
اجبار خروجی صفحه‌ای با فرمت YUV 4:2:0 ۱۰ بیتی
.IP \fByuv422\fR 4
.IX Item "yuv422"
اجبار خروجی صفحه‌ای با فرمت YUV 4:2:2 ۸ بیتی
.IP \fByuv422p10\fR 4
.IX Item "yuv422p10"
اجبار خروجی صفحه‌ای با فرمت YUV 4:2:2 ۱۰ بیتی
.IP \fByuv444\fR 4
.IX Item "yuv444"
اجبار خروجی صفحه‌ای با فرمت YUV 4:4:4 ۸ بیتی
.IP \fByuv444p10\fR 4
.IX Item "yuv444p10"
اجبار خروجی صفحه‌ای با فرمت YUV 4:4:4 ۱۰ بیتی
.IP \fBrgb\fR 4
.IX Item "rgb"
اجبار خروجی بسته‌بندی‌شده (packed) با فرمت RGB ۸ بیتی
.IP \fBgbrp\fR 4
.IX Item "gbrp"
اجبار خروجی صفحه‌ای با فرمت RGB ۸ بیتی
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار فرمت
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fByuv420\fR است.
.RE
.IP \fBrepeatlast\fR 4
.IX Item "repeatlast"
به \fBframesync\fR مراجعه کنید.
.IP \fBalpha\fR 4
.IX Item "alpha"
تنظیم فرمت آلفای ویدیوی هم‌پوشانی‌شده؛ می‌تواند \fIstraight\fR یا \fIpremultiplied\fR یا \fIauto\fR برای انتخاب خودکار حالت آلفا باشد.
پیش‌فرض \fIauto\fR است.
.PP
عبارت‌های \fBx\fR و \fBy\fR می‌توانند شامل پارامترهای زیر باشند:
.IP "\fBmain_w, W\fR" 4
.IX Item "main_w, W"
.PD 0
.IP "\fBmain_h, H\fR" 4
.IX Item "main_h, H"
.PD
عرض و ارتفاع ورودی اصلی.
.IP "\fBoverlay_w, w\fR" 4
.IX Item "overlay_w, w"
.PD 0
.IP "\fBoverlay_h, h\fR" 4
.IX Item "overlay_h, h"
.PD
عرض و ارتفاع ورودی هم‌پوشانی.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مقادیر محاسبه‌شده برای \fIx\fR و \fIy\fR. این مقادیر برای هر فریم جدید ارزیابی می‌شوند.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری افقی و عمودی کروما برای فرمت خروجی. به عنوان مثال برای فرمت پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، با شروع از 0
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم ورودی در فایل، در صورت نامشخص بودن NAN؛ منسوخ شده است، استفاده نکنید
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی، بر حسب ثانیه. اگر برچسب زمانی ورودی ناشناخته باشد برابر NAN است.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
توجه داشته باشید که متغیرهای \fIn\fR و \fIt\fR تنها زمانی در دسترس هستند که ارزیابی به ازای هر فریم (\fIper frame\fR) انجام شود، و در صورتی که \fBeval\fR روی \fBinit\fR تنظیم شده باشد به NAN ارزیابی می‌شوند.
.PP
توجه داشته باشید که فریم‌ها به ترتیب برچسب زمانی از هر ویدیوی ورودی گرفته می‌شوند؛ بنابراین اگر برچسب‌های زمانی اولیه آن‌ها متفاوت باشد، ایده خوبی است که هر دو ورودی را از یک فیلتر \fIsetpts=PTS\-STARTPTS\fR عبور دهید تا همانند مثال فیلتر \fImovie\fR، هر دو با یک برچسب زمانی صفر یکسان آغاز شوند.
.PP
می‌توانید هم‌پوشانی‌های بیشتری را به صورت زنجیره‌ای متصل کنید، اما باید کارایی چنین رویکردی را بیازمایید.
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تغییر مقادیر x و y ورودی هم‌پوشانی.
این دستور ساختار نحوی مشابه با گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت مشخص‌شده معتبر نباشد، مقدار فعلی آن حفظ می‌شود.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
رسم هم‌پوشانی در فاصله ۱۰ پیکسلی از گوشه پایین سمت راست ویدیوی اصلی:
.Sp
.Vb 1
\&        overlay=main_w\-overlay_w\-10:main_h\-overlay_h\-10
.Ve
.Sp
با استفاده از گزینه‌های نام‌دار، مثال بالا به این صورت درمی‌آید:
.Sp
.Vb 1
\&        overlay=x=main_w\-overlay_w\-10:y=main_h\-overlay_h\-10
.Ve
.IP \(bu 4
درج یک لوگوی PNG شفاف در گوشه پایین سمت چپ ورودی، با استفاده از ابزار \fBffmpeg\fR همراه با گزینه \f(CW\*(C`\-filter_complex\*(C'\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input \-i logo \-filter_complex \*(Aqoverlay=10:main_h\-overlay_h\-10\*(Aq output
.Ve
.IP \(bu 4
درج ۲ لوگوی PNG شفاف مختلف (لوگوی دوم در گوشه پایین سمت راست) با استفاده از ابزار \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input \-i logo1 \-i logo2 \-filter_complex \*(Aqoverlay=x=10:y=H\-h\-10,overlay=x=W\-w\-10:y=H\-h\-10\*(Aq output
.Ve
.IP \(bu 4
افزودن یک لایه رنگی شفاف بر روی ویدیوی اصلی؛ عبارت \f(CW\*(C`WxH\*(C'\fR باید اندازه ورودی اصلی فیلتر overlay را مشخص کند:
.Sp
.Vb 1
\&        color=color=red@.3:size=WxH [over]; [in][over] overlay [out]
.Ve
.IP \(bu 4
پخش ویدیوی اصلی و نسخه فیلترشده (در اینجا با فیلتر deshake) در کنار هم با استفاده از ابزار \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay input.avi \-vf \*(Aqsplit[a][b]; [a]pad=iw*2:ih[src]; [b]deshake[filt]; [src][filt]overlay=w\*(Aq
.Ve
.Sp
دستور بالا معادل دستور زیر است:
.Sp
.Vb 1
\&        ffplay input.avi \-vf \*(Aqsplit[b], pad=iw*2[src], [b]deshake, [src]overlay=w\*(Aq
.Ve
.IP \(bu 4
ایجاد یک هم‌پوشانی کشویی که از سمت چپ پدیدار شده و از زمان 2 به سمت بخش بالای راست صفحه حرکت می‌کند:
.Sp
.Vb 1
\&        overlay=x=\*(Aqif(gte(t,2), \-w+(t\-2)*20, NAN)\*(Aq:y=0
.Ve
.IP \(bu 4
ترکیب خروجی با قرار دادن دو ویدیوی ورودی در کنار یکدیگر:
.Sp
.Vb 7
\&        ffmpeg \-i left.avi \-i right.avi \-filter_complex "
\&        nullsrc=size=200x100 [background];
\&        [0:v] setpts=PTS\-STARTPTS, scale=100x100 [left];
\&        [1:v] setpts=PTS\-STARTPTS, scale=100x100 [right];
\&        [background][left]       overlay=shortest=1       [background+left];
\&        [background+left][right] overlay=shortest=1:x=100 [left+right]
\&        "
.Ve
.IP \(bu 4
ماسک کردن ۱۰ تا ۲۰ ثانیه از یک ویدیو با اعمال فیلتر delogo بر روی یک بخش:
.Sp
.Vb 3
\&        ffmpeg \-i test.avi \-codec:v:0 wmv2 \-ar 11025 \-b:v 9000k \e
\&        \-vf \*(Aq[in]split[split_main][split_delogo];[split_delogo]trim=start=360:end=371,delogo=0:0:640:480[delogoed];[split_main][delogoed]overlay=eof_action=pass[out]\*(Aq \e
\&        masked.avi
.Ve
.IP \(bu 4
زنجیر کردن چندین هم‌پوشانی به صورت آبشاری:
.Sp
.Vb 6
\&        nullsrc=s=200x200 [bg];
\&        testsrc=s=100x100, split=4 [in0][in1][in2][in3];
\&        [in0] lutrgb=r=0, [bg]   overlay=0:0     [mid0];
\&        [in1] lutrgb=g=0, [mid0] overlay=100:0   [mid1];
\&        [in2] lutrgb=b=0, [mid1] overlay=0:100   [mid2];
\&        [in3] null,       [mid2] overlay=100:100 [out0]
.Ve
.SS owdenoise
.IX Subsection "owdenoise"
اعمال نویززدای موجک فراتکمیل (Overcomplete Wavelet denoiser).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdepth\fR 4
.IX Item "depth"
تنظیم عمق.
.Sp
مقادیر عمق بزرگ‌تر، مؤلفه‌های فرکانس پایین را بیشتر نویززدایی می‌کنند، اما سرعت فیلتر کردن را کاهش می‌دهند.
.Sp
باید یک عدد صحیح در محدوده 8\-16 باشد، پیش‌فرض \f(CW8\fR است.
.IP "\fBluma_strength, ls\fR" 4
.IX Item "luma_strength, ls"
تنظیم قدرت روشنایی (luma).
.Sp
باید یک مقدار ممیز شناور در محدوده 0\-1000 باشد، پیش‌فرض \f(CW1.0\fR است.
.IP "\fBchroma_strength, cs\fR" 4
.IX Item "chroma_strength, cs"
تنظیم قدرت کروما (chroma).
.Sp
باید یک مقدار ممیز شناور در محدوده 0\-1000 باشد، پیش‌فرض \f(CW1.0\fR است.
.SS pad
.IX Subsection "pad"
افزودن فاصله‌گذاری (پدینگ \- padding) به تصویر ورودی، و قرار دادن ورودی اصلی در مختصات \fIx\fR و \fIy\fR ارائه‌شده.
.PP
پارامترهای زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
مشخص کردن عبارتی برای اندازه تصویر خروجی همراه با فاصله‌گذاری‌های اضافه‌شده. اگر مقدار \fIwidth\fR یا \fIheight\fR برابر 0 باشد، اندازه ورودی متناظر برای خروجی استفاده می‌شود.
.Sp
عبارت \fIwidth\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIheight\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIwidth\fR و \fIheight\fR برابر 0 است.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مشخص کردن آفست‌ها برای قرار دادن تصویر ورودی در ناحیه پدینگ، نسبت به حاشیه بالا/چپ تصویر خروجی.
.Sp
عبارت \fIx\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIy\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIx\fR و \fIy\fR برابر 0 است.
.Sp
اگر \fIx\fR یا \fIy\fR به یک عدد منفی ارزیابی شوند، تغییر داده خواهند شد تا تصویر ورودی در مرکز ناحیه پدینگ قرار گیرد.
.IP \fBcolor\fR 4
.IX Item "color"
مشخص کردن رنگ ناحیه پدینگ. برای ساختار نحوی این گزینه، به \fBبخش "Color" در راهنمای ffmpeg\-utils\fR مراجعه کنید.
.Sp
مقدار پیش‌فرض \fIcolor\fR برابر "black" است.
.IP \fBeval\fR 4
.IX Item "eval"
مشخص کردن زمان ارزیابی عبارت‌های \fIwidth\fR، \fIheight\fR، \fIx\fR و \fIy\fR.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
تنها یک بار در طول مقداردهی اولیه فیلتر یا هنگام پردازش یک دستور، عبارت‌ها ارزیابی می‌شوند.
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارت‌ها به ازای هر فریم ورودی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.RE
.IP \fBaspect\fR 4
.IX Item "aspect"
پدینگ بر اساس نسبت تصویر (aspect) به جای یک رزولوشن مشخص.
.PP
مقادیر گزینه‌های \fIwidth\fR، \fIheight\fR، \fIx\fR و \fIy\fR عبارت‌هایی شامل ثابت‌های زیر هستند:
.IP \fBin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fBin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ویدیوی ورودی.
.IP \fBiw\fR 4
.IX Item "iw"
.PD 0
.IP \fBih\fR 4
.IX Item "ih"
.PD
همانند \fIin_w\fR و \fIin_h\fR هستند.
.IP \fBout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fBout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع خروجی (اندازه ناحیه پدینگ‌شده)، همان‌گونه که توسط عبارت‌های \fIwidth\fR و \fIheight\fR مشخص شده است.
.IP \fBow\fR 4
.IX Item "ow"
.PD 0
.IP \fBoh\fR 4
.IX Item "oh"
.PD
همانند \fIout_w\fR و \fIout_h\fR هستند.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
آفست‌های x و y همان‌طور که توسط عبارت‌های \fIx\fR و \fIy\fR مشخص شده است، یا در صورتی که هنوز تعیین نشده باشد برابر NAN.
.IP \fBa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت تصویر نمونه ورودی (sample aspect ratio).
.IP \fBdar\fR 4
.IX Item "dar"
نسبت تصویر نمایش ورودی (display aspect ratio)، همانند (\fIiw\fR / \fIih\fR) * \fIsar\fR است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری افقی و عمودی کروما. برای مثال برای فرمت پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
افزودن فاصله‌گذاری با رنگ "violet" به ویدیوی ورودی. اندازه ویدیوی خروجی 640x480 است، و گوشه بالا\-چپ ویدیوی ورودی در ستون 0، ردیف 40 قرار می‌گیرد:
.Sp
.Vb 1
\&        pad=640:480:0:40:violet
.Ve
.Sp
مثال بالا معادل دستور زیر است:
.Sp
.Vb 1
\&        pad=width=640:height=480:x=0:y=40:color=violet
.Ve
.IP \(bu 4
پدینگ ورودی برای رسیدن به خروجی با ابعادی که به میزان 3/2 افزایش یافته است، و قرار دادن ویدیوی ورودی در مرکز ناحیه پدینگ:
.Sp
.Vb 1
\&        pad="3/2*iw:3/2*ih:(ow\-iw)/2:(oh\-ih)/2"
.Ve
.IP \(bu 4
پدینگ ورودی جهت دستیابی به یک خروجی مربعی با اندازه‌ای برابر با بیشترین مقدار بین عرض و ارتفاع ورودی، و قرار دادن ویدیوی ورودی در مرکز ناحیه پدینگ:
.Sp
.Vb 1
\&        pad="max(iw\e,ih):ow:(ow\-iw)/2:(oh\-ih)/2"
.Ve
.IP \(bu 4
پدینگ ورودی جهت به دست آوردن نسبت نهایی عرض به ارتفاع 16:9:
.Sp
.Vb 1
\&        pad="ih*16/9:ih:(ow\-iw)/2:(oh\-ih)/2"
.Ve
.IP \(bu 4
در مورد ویدیوی آنامورفیک، برای تنظیم صحیح نسبت تصویر نمایش خروجی، لازم است از \fIsar\fR در عبارت استفاده شود، مطابق با رابطه زیر:
.Sp
.Vb 2
\&        (ih * X / ih) * sar = output_dar
\&        X = output_dar / sar
.Ve
.Sp
بنابراین مثال قبلی باید به شکل زیر تغییر کند:
.Sp
.Vb 1
\&        pad="ih*16/9/sar:ih:(ow\-iw)/2:(oh\-ih)/2"
.Ve
.IP \(bu 4
دو برابر کردن اندازه خروجی و قرار دادن ویدیوی ورودی در گوشه پایین\-راست ناحیه پدینگ‌شده خروجی:
.Sp
.Vb 1
\&        pad="2*iw:2*ih:ow\-iw:oh\-ih"
.Ve
.SS palettegen
.IX Subsection "palettegen"
تولید یک پالت رنگی (palette) برای کل یک جریان ویدیویی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmax_colors\fR 4
.IX Item "max_colors"
تنظیم حداکثر تعداد رنگ‌ها برای کوانتایز کردن در پالت.
نکته: پالت همچنان شامل ۲۵۶ رنگ خواهد بود؛ خانه‌های استفاده‌نشده پالت سیاه خواهند بود.
.IP \fBreserve_transparent\fR 4
.IX Item "reserve_transparent"
ایجاد پالتی با حداکثر ۲۵۵ رنگ و رزرو آخرین رنگ برای شفافیت. رزرو رنگ شفافیت برای بهینه‌سازی GIF سودمند است. در صورت عدم تنظیم، حداکثر تعداد رنگ‌ها در پالت ۲۵۶ خواهد بود. احتمالاً می‌خواهید این گزینه را برای یک تصویر مستقل غیرفعال کنید.
به‌طور پیش‌فرض تنظیم شده است.
.IP \fBtransparency_color\fR 4
.IX Item "transparency_color"
تنظیم رنگی که به عنوان پس‌زمینه برای شفافیت استفاده خواهد شد.
.IP \fBstats_mode\fR 4
.IX Item "stats_mode"
تنظیم حالت آمارگیری.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBfull\fR 4
.IX Item "full"
محاسبه هیستوگرام کامل فریم.
.IP \fBdiff\fR 4
.IX Item "diff"
محاسبه هیستوگرام تنها برای بخشی که با فریم قبلی تفاوت دارد. این امر ممکن است در صورت ثابت بودن پس‌زمینه، اهمیت بیشتری به بخش متحرک ورودی شما بدهد.
.IP \fBsingle\fR 4
.IX Item "single"
محاسبه هیستوگرام جدید برای هر فریم.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fIfull\fR است.
.RE
.PP
این فیلتر همچنین متادیتای فریم \f(CW\*(C`lavfi.color_quant_ratio\*(C'\fR (\f(CW\*(C`nb_color_in / nb_color_out\*(C'\fR) را صادر می‌کند که می‌توانید برای ارزیابی میزان کوانتایزاسیون رنگ پالت از آن استفاده کنید. این اطلاعات در سطح گزارش‌گیری \fIinfo\fR نیز قابل مشاهده است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک پالت معرف از یک ویدیوی مشخص با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-vf palettegen palette.png
.Ve
.SS paletteuse
.IX Subsection "paletteuse"
استفاده از یک پالت برای کاهش نمونه (downsample) یک جریان ویدیویی ورودی.
.PP
این فیلتر دو ورودی دریافت می‌کند: یک جریان ویدیو و یک پالت. پالت باید تصویری به اندازه ۲۵۶ پیکسل باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdither\fR 4
.IX Item "dither"
انتخاب حالت دیترینگ (dithering). الگوریتم‌های موجود عبارتند از:
.RS 4
.IP \fBbayer\fR 4
.IX Item "bayer"
دیترینگ مرتب‌شده بایر 8x8 (قطعی)
.IP \fBheckbert\fR 4
.IX Item "heckbert"
دیترینگ طبق تعریف پل هکبرت در سال ۱۹۸۲ (پخش خطای ساده).
نکته: این دیترینگ گاهی "نادرست" در نظر گرفته می‌شود و به عنوان مرجع گنجانده شده است.
.IP \fBfloyd_steinberg\fR 4
.IX Item "floyd_steinberg"
دیترینگ فلوید و اشتاینبرگ (پخش خطا)
.IP \fBsierra2\fR 4
.IX Item "sierra2"
دیترینگ فرانکی سیرا نسخه ۲ (پخش خطا)
.IP \fBsierra2_4a\fR 4
.IX Item "sierra2_4a"
دیترینگ فرانکی سیرا نسخه ۲ "Lite" (پخش خطا)
.IP \fBsierra3\fR 4
.IX Item "sierra3"
دیترینگ فرانکی سیرا نسخه ۳ (پخش خطا)
.IP \fBburkes\fR 4
.IX Item "burkes"
دیترینگ برکس (پخش خطا)
.IP \fBatkinson\fR 4
.IX Item "atkinson"
دیترینگ اتکینسون توسط بیل اتکینسون در شرکت اپل (پخش خطا)
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی دیترینگ.
.RE
.RS 4
.Sp
پیش‌فرض \fIsierra2_4a\fR است.
.RE
.IP \fBbayer_scale\fR 4
.IX Item "bayer_scale"
هنگامی که دیترینگ \fIbayer\fR انتخاب شده باشد، این گزینه مقیاس الگو را تعیین می‌کند (میزان وضوح الگوی خطوط متقاطع). یک مقدار کم به معنای الگوی واضح‌تر برای اثر نواری کمتر است، و مقدار بالاتر به معنای الگوی کمتر قابل مشاهده به قیمت ایجاد اثر نواری (banding) بیشتر است.
.Sp
این گزینه باید یک مقدار عدد صحیح در محدوده [0,5] باشد. پیش‌فرض \fI2\fR است.
.IP \fBdiff_mode\fR 4
.IX Item "diff_mode"
در صورت تنظیم، ناحیه مورد پردازش را تعیین می‌کند
.RS 4
.IP \fBrectangle\fR 4
.IX Item "rectangle"
تنها مستطیل در حال تغییر مجدداً پردازش خواهد شد. این شبیه به مکانیزم فشرده‌سازی برش/آفست در GIF است. این گزینه می‌تواند در صورت تغییر تنها بخشی از تصویر برای افزایش سرعت سودمند باشد، و کاربردهایی از جمله محدود کردن دامنه دیترینگ پخش خطا (\fBdither\fR) به مستطیلی که صحنه متحرک را در بر می‌گیرد دارد (اگر صحنه چندان تغییر نکند، منجر به خروجی قطعی‌تر و در نتیجه نویز متحرک کمتر و فشرده‌سازی بهتر GIF می‌شود).
.RE
.RS 4
.Sp
پیش‌فرض \fInone\fR است.
.RE
.IP \fBnew\fR 4
.IX Item "new"
گرفتن پالت جدید برای هر فریم خروجی.
.IP \fBalpha_threshold\fR 4
.IX Item "alpha_threshold"
تنظیم آستانه آلفا برای شفافیت. مقادیر آلفا بالاتر از این آستانه کاملاً کدر در نظر گرفته می‌شوند، و مقادیر پایین‌تر از این آستانه کاملاً شفاف در نظر گرفته خواهند شد.
.Sp
این گزینه باید یک مقدار عدد صحیح در محدوده [0,255] باشد. پیش‌فرض \fI128\fR است.
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از یک پالت (برای مثال تولیدشده با \fBpalettegen\fR) جهت انکود یک GIF با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-i palette.png \-lavfi paletteuse output.gif
.Ve
.SS perspective
.IX Subsection "perspective"
تصحیح پرسپکتیو ویدیویی که به صورت عمود بر صفحه تصویربرداری نشده است.
.PP
توضیحات مربوط به پارامترهای پذیرفته‌شده در ادامه آمده است.
.IP \fBx0\fR 4
.IX Item "x0"
.PD 0
.IP \fBy0\fR 4
.IX Item "y0"
.IP \fBx1\fR 4
.IX Item "x1"
.IP \fBy1\fR 4
.IX Item "y1"
.IP \fBx2\fR 4
.IX Item "x2"
.IP \fBy2\fR 4
.IX Item "y2"
.IP \fBx3\fR 4
.IX Item "x3"
.IP \fBy3\fR 4
.IX Item "y3"
.PD
تنظیم عبارت مختصات برای گوشه‌های بالا\-چپ، بالا\-راست، پایین\-چپ و پایین\-راست.
مقادیر پیش‌فرض \f(CW\*(C`0:0:W:0:0:H:W:H\*(C'\fR هستند که با آن‌ها پرسپکتیو بدون تغییر باقی خواهد ماند.
اگر گزینه \f(CW\*(C`sense\*(C'\fR روی \f(CW\*(C`source\*(C'\fR تنظیم شده باشد، نقاط مشخص‌شده به گوشه‌های مقصد ارسال می‌شوند. اگر گزینه \f(CW\*(C`sense\*(C'\fR روی \f(CW\*(C`destination\*(C'\fR تنظیم شده باشد، گوشه‌های مبدأ به مختصات مشخص‌شده ارسال خواهند شد.
.Sp
عبارت‌ها می‌توانند از متغیرهای زیر استفاده کنند:
.RS 4
.IP \fBW\fR 4
.IX Item "W"
.PD 0
.IP \fBH\fR 4
.IX Item "H"
.PD
عرض و ارتفاع فریم ویدیو.
.IP \fBin\fR 4
.IX Item "in"
شمارنده فریم ورودی.
.IP \fBon\fR 4
.IX Item "on"
شمارنده فریم خروجی.
.RE
.RS 4
.RE
.IP \fBinterpolation\fR 4
.IX Item "interpolation"
تنظیم درون‌یابی جهت تصحیح پرسپکتیو.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlinear\fR 4
.IX Item "linear"
.PD 0
.IP \fBcubic\fR 4
.IX Item "cubic"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBlinear\fR است.
.RE
.IP \fBsense\fR 4
.IX Item "sense"
تنظیم تفسیر گزینه‌های مختصات.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, source\fR" 4
.IX Item "0, source"
ارسال نقطه موجود در مبدأ که با مختصات داده‌شده مشخص شده است به گوشه‌های مقصد.
.IP "\fB1, destination\fR" 4
.IX Item "1, destination"
ارسال گوشه‌های مبدأ به نقطه‌ای در مقصد که با مختصات داده‌شده مشخص شده است.
.Sp
مقدار پیش‌فرض \fBsource\fR است.
.RE
.RS 4
.RE
.IP \fBeval\fR 4
.IX Item "eval"
تنظیم زمان ارزیابی عبارت‌ها برای مختصات‌های \fBx0,y0,...x3,y3\fR.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
تنها یک بار در طول مقداردهی اولیه فیلتر یا هنگام پردازش یک دستور عبارت‌ها را ارزیابی می‌کند
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارت‌ها به ازای هر فریم ورودی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.RE
.SS phase
.IX Subsection "phase"
به تأخیر انداختن ویدیوی اینترلیس (interlaced) به اندازه مدت‌زمان یک فیلد، به طوری که ترتیب فیلدها تغییر کند.
.PP
کاربرد مورد نظر، اصلاح فیلم‌های PAL است که با ترتیب فیلد معکوس نسبت به تبدیل فیلم\-به\-ویدیو ضبط (کپچر) شده‌اند.
.PP
توضیحات مربوط به پارامترهای پذیرفته‌شده در ادامه آمده است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت فاز.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBt\fR 4
.IX Item "t"
کپچر با ترتیب فیلد بالایی نخست (top\-first)، انتقال پایینی نخست (bottom\-first).
فیلتر فیلد پایینی را به تأخیر می‌اندازد.
.IP \fBb\fR 4
.IX Item "b"
کپچر با ترتیب فیلد پایینی نخست (bottom\-first)، انتقال بالایی نخست (top\-first).
فیلتر فیلد بالایی را به تأخیر می‌اندازد.
.IP \fBp\fR 4
.IX Item "p"
کپچر و انتقال با ترتیب فیلد یکسان. این حالت فقط برای ارجاع در مستندات سایر گزینه‌ها وجود دارد، اما اگر واقعاً آن را انتخاب کنید، فیلتر با وفاداری هیچ کاری انجام نخواهد داد.
.IP \fBa\fR 4
.IX Item "a"
ترتیب فیلد کپچر به‌طور خودکار توسط پرچم‌های فیلد تعیین می‌شود، انتقال معکوس.
فیلتر با استفاده از پرچم‌های فیلد، به صورت فریم به فریم بین حالت‌های \fBt\fR و \fBb\fR انتخاب می‌کند. اگر اطلاعات فیلد در دسترس نباشد، درست مانند \fBu\fR عمل خواهد کرد.
.IP \fBu\fR 4
.IX Item "u"
کپچر نامشخص یا متغیر، انتقال معکوس.
فیلتر با تحلیل تصاویر و انتخاب گزینه‌ای که بهترین تطابق را بین فیلدها ایجاد می‌کند، به صورت فریم به فریم بین \fBt\fR و \fBb\fR انتخاب می‌کند.
.IP \fBT\fR 4
.IX Item "T"
کپچر top\-first، انتقال نامشخص یا متغیر.
فیلتر با استفاده از تحلیل تصویر بین \fBt\fR و \fBp\fR انتخاب می‌کند.
.IP \fBB\fR 4
.IX Item "B"
کپچر bottom\-first، انتقال نامشخص یا متغیر.
فیلتر با استفاده از تحلیل تصویر بین \fBb\fR و \fBp\fR انتخاب می‌کند.
.IP \fBA\fR 4
.IX Item "A"
کپچر تعیین‌شده توسط پرچم‌های فیلد، انتقال نامشخص یا متغیر.
فیلتر با استفاده از پرچم‌های فیلد و تحلیل تصویر بین \fBt\fR، \fBb\fR و \fBp\fR انتخاب می‌کند. اگر اطلاعات فیلد در دسترس نباشد، درست مانند \fBU\fR عمل می‌کند. این حالت پیش‌فرض است.
.IP \fBU\fR 4
.IX Item "U"
هر دو حالت کپچر و انتقال نامشخص یا متغیر.
فیلتر تنها با استفاده از تحلیل تصویر بین \fBt\fR، \fBb\fR و \fBp\fR انتخاب می‌کند.
.RE
.RS 4
.RE
.PP
\fIدستورات (Commands)\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS photosensitivity
.IX Subsection "photosensitivity"
کاهش انواع مختلف فلش‌ها در ویدیو، جهت کمک به کاربرانی که مبتلا به صرع (epilepsy) هستند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBframes, f\fR" 4
.IX Item "frames, f"
تنظیم تعداد فریم‌های مورد استفاده هنگام فیلتر کردن. پیش‌فرض 30 است.
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم ضریب آستانه تشخیص. پیش‌فرض 1 است.
مقادیر کمتر سخت‌گیرانه‌تر هستند.
.IP \fBskip\fR 4
.IX Item "skip"
تنظیم تعداد پیکسل‌هایی که هنگام نمونه‌برداری از فریم‌ها نادیده گرفته می‌شوند. پیش‌فرض 1 است.
محدوده مجاز از 1 تا 1024 است.
.IP \fBbypass\fR 4
.IX Item "bypass"
رها کردن فریم‌ها بدون تغییر. به‌طور پیش‌فرض غیرفعال است.
.SS pixdesctest
.IX Subsection "pixdesctest"
فیلتر آزمون توصیف‌گر قالب پیکسل، که عمدتاً برای آزمون‌های داخلی مفید است.
ویدیوی خروجی باید با ویدیوی ورودی برابر باشد.
.PP
برای مثال:
.PP
.Vb 1
\&        format=monow, pixdesctest
.Ve
.PP
می‌تواند برای آزمایش تعریف توصیف‌گر قالب پیکسل monowhite به کار رود.
.SS pixelize
.IX Subsection "pixelize"
اعمال پیکسل‌سازی (شطرنجی کردن) بر روی استریم ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم ابعاد بلوک که برای پیکسل‌سازی استفاده خواهد شد.
مقدار پیش‌فرض \f(CW16\fR است.
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت پیکسل‌سازی استفاده‌شده.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fBavg\fR 4
.IX Item "avg"
.PD 0
.IP \fBmin\fR 4
.IX Item "min"
.IP \fBmax\fR 4
.IX Item "max"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`avg\*(C'\fR است.
.RE
.IP "\fBplanes, p\fR" 4
.IX Item "planes, p"
تنظیم صفحاتی که باید فیلتر شوند. پیش‌فرض فیلتر کردن تمامی صفحه‌ها است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS pixscope
.IX Subsection "pixscope"
نمایش مقادیر نمونه کانال‌های رنگی. عمدتاً برای بررسی رنگ و سطوح مفید است.
حداقل تفکیک‌پذیری پشتیبانی‌شده 640x480 است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
تنظیم موقعیت X اسکوپ، آفست نسبی در محور X.
.IP \fBy\fR 4
.IX Item "y"
تنظیم موقعیت Y اسکوپ، آفست نسبی در محور Y.
.IP \fBw\fR 4
.IX Item "w"
تنظیم عرض اسکوپ.
.IP \fBh\fR 4
.IX Item "h"
تنظیم ارتفاع اسکوپ.
.IP \fBo\fR 4
.IX Item "o"
تنظیم میزان مات بودن پنجره. این پنجره همچنین شامل آمار مربوط به ناحیه پیکسلی است.
.IP \fBwx\fR 4
.IX Item "wx"
تنظیم موقعیت X پنجره، آفست نسبی در محور X.
.IP \fBwy\fR 4
.IX Item "wy"
تنظیم موقعیت Y پنجره، آفست نسبی در محور Y.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از همان \fBدستورات\fR به عنوان گزینه‌ها پشتیبانی می‌کند.
.SS pp7
.IX Subsection "pp7"
اعمال فیلتر پس‌پردازش 7 (Postprocessing filter 7). این گونه‌ای از فیلتر \fBspp\fR است،
مشابه با spp = 6 به همراه DCT هفت نقطه‌ای، که در آن تنها نمونه مرکزی پس از IDCT
استفاده می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBqp\fR 4
.IX Item "qp"
اجبار یک پارامتر کوانتیزاسیون ثابت. یک عدد صحیح در محدوده
0 تا 63 را می‌پذیرد. در صورت عدم تنظیم، فیلتر از QP موجود در استریم ویدیو
(در صورت وجود) استفاده خواهد کرد.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت آستانه‌گذاری. حالت‌های موجود عبارتند از:
.RS 4
.IP \fBhard\fR 4
.IX Item "hard"
تنظیم آستانه‌گذاری سخت.
.IP \fBsoft\fR 4
.IX Item "soft"
تنظیم آستانه‌گذاری نرم (اثر de\-ringing بهتر، اما احتمالاً محوتر).
.IP \fBmedium\fR 4
.IX Item "medium"
تنظیم آستانه‌گذاری متوسط (نتایج خوب، پیش‌فرض).
.RE
.RS 4
.RE
.SS premultiply
.IX Subsection "premultiply"
اعمال جلوه پیش‌ضرب آلفا (alpha premultiply) روی استریم ویدیوی ورودی با استفاده از
صفحه اول استریم دوم به عنوان آلفا.
.PP
هر دو استریم باید ابعاد و قالب پیکسلی یکسانی داشته باشند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که پردازش خواهند شد، صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمامی صفحات پردازش خواهند شد.
.IP \fBinplace\fR 4
.IX Item "inplace"
عدم نیاز به ورودی دوم برای پردازش، در عوض استفاده از صفحه آلفا از استریم ورودی.
.SS premultiply_dynamic
.IX Subsection "premultiply_dynamic"
پیش‌ضرب یا لغو پیش‌ضرب پویا روی استریم ویدیوی ورودی بر اساس نیاز،
جهت تطابق با ملزومات گراف فیلتر پایین‌دست. این تقریباً
معادل یکی از موارد \f(CW\*(C`premultiply:inplace=yes\*(C'\fR یا
\&\f(CW\*(C`unpremultiply:inplace=yes\*(C'\fR است، و در غیر این صورت بدون عملیات (noop) خواهد بود.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که پردازش خواهند شد، صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمامی صفحات پردازش خواهند شد.
.SS prewitt
.IX Subsection "prewitt"
اعمال عملگر پِرویت (prewitt operator) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که پردازش خواهند شد، صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمامی صفحات پردازش خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلترشده ضرب خواهد شد.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلترشده اضافه خواهد شد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS pseudocolor
.IX Subsection "pseudocolor"
تغییر رنگ‌های فریم در ویدیو با رنگ‌های کاذب (pseudocolors).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBc0\fR 4
.IX Item "c0"
تنظیم عبارت مؤلفه اول پیکسل
.IP \fBc1\fR 4
.IX Item "c1"
تنظیم عبارت مؤلفه دوم پیکسل
.IP \fBc2\fR 4
.IX Item "c2"
تنظیم عبارت مؤلفه سوم پیکسل
.IP \fBc3\fR 4
.IX Item "c3"
تنظیم عبارت مؤلفه چهارم پیکسل، متناظر با مؤلفه آلفا
.IP "\fBindex, i\fR" 4
.IX Item "index, i"
تنظیم مؤلفه‌ای که به عنوان پایه برای تغییر رنگ‌ها استفاده می‌شود
.IP "\fBpreset, p\fR" 4
.IX Item "preset, p"
انتخاب یکی از LUTهای توکار. به‌طور پیش‌فرض روی none تنظیم شده است.
.Sp
LUTهای موجود:
.RS 4
.IP \fBmagma\fR 4
.IX Item "magma"
.PD 0
.IP \fBinferno\fR 4
.IX Item "inferno"
.IP \fBplasma\fR 4
.IX Item "plasma"
.IP \fBviridis\fR 4
.IX Item "viridis"
.IP \fBturbo\fR 4
.IX Item "turbo"
.IP \fBcividis\fR 4
.IX Item "cividis"
.IP \fBrange1\fR 4
.IX Item "range1"
.IP \fBrange2\fR 4
.IX Item "range2"
.IP \fBshadows\fR 4
.IX Item "shadows"
.IP \fBhighlights\fR 4
.IX Item "highlights"
.IP \fBsolar\fR 4
.IX Item "solar"
.IP \fBnominal\fR 4
.IX Item "nominal"
.IP \fBpreferred\fR 4
.IX Item "preferred"
.IP \fBtotal\fR 4
.IX Item "total"
.IP \fBspectral\fR 4
.IX Item "spectral"
.IP \fBcool\fR 4
.IX Item "cool"
.IP \fBheat\fR 4
.IX Item "heat"
.IP \fBfiery\fR 4
.IX Item "fiery"
.IP \fBblues\fR 4
.IX Item "blues"
.IP \fBgreen\fR 4
.IX Item "green"
.IP \fBhelix\fR 4
.IX Item "helix"
.PD
.RE
.RS 4
.RE
.IP \fBopacity\fR 4
.IX Item "opacity"
تنظیم میزان مات بودن رنگ‌های خروجی. محدوده مجاز از 0 تا 1 است.
مقدار پیش‌فرض روی 1 تنظیم شده است.
.PP
هر یک از گزینه‌های عبارت، عبارتی را مشخص می‌کند که برای محاسبه جدول جستجو (LUT)
جهت مقادیر مؤلفه پیکسلی متناظر استفاده می‌شود.
.PP
عبارت‌ها می‌توانند شامل ثوابت و توابع زیر باشند:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع ورودی.
.IP \fBval\fR 4
.IX Item "val"
مقدار ورودی برای مؤلفه پیکسل.
.IP "\fBymin, umin, vmin, amin\fR" 4
.IX Item "ymin, umin, vmin, amin"
حداقل مقدار مجاز مؤلفه.
.IP "\fBymax, umax, vmax, amax\fR" 4
.IX Item "ymax, umax, vmax, amax"
حداکثر مقدار مجاز مؤلفه.
.PP
پیش‌فرض تمامی عبارت‌ها "val" است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تغییر مقادیر روشنایی (luma) بیش از حد بالا به یک گرادیان:
.Sp
.Vb 1
\&        pseudocolor="\*(Aqif(between(val,ymax,amax),lerp(ymin,ymax,(val\-ymax)/(amax\-ymax)),\-1):if(between(val,ymax,amax),lerp(umax,umin,(val\-ymax)/(amax\-ymax)),\-1):if(between(val,ymax,amax),lerp(vmin,vmax,(val\-ymax)/(amax\-ymax)),\-1):\-1\*(Aq"
.Ve
.SS psnr
.IX Subsection "psnr"
به دست آوردن میانگین، حداکثر و حداقل مقدار PSNR (نسبت بیشینه سیگنال به نویز)
میان دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی را دریافت می‌کند؛ ورودی اول به عنوان منبع «اصلی» (main) در نظر گرفته شده
و بدون تغییر به خروجی منتقل می‌شود. ورودی دوم به عنوان ویدیوی «مرجع» (reference)
برای محاسبه PSNR استفاده می‌شود.
.PP
برای عملکرد صحیح این فیلتر، هر دو ویدیوی ورودی باید تفکیک‌پذیری و قالب پیکسلی
یکسان داشته باشند. همچنین فرض می‌شود هر دو ورودی دارای تعداد فریم‌های برابری هستند
که به صورت فریم‌به‌فریم مقایسه می‌شوند.
.PP
میانگین PSNR حاصل‌شده از طریق سامانه گزارش‌گیری (logging) چاپ می‌شود.
.PP
فیلتر مقدار انباشته‌شده MSE (میانگین مربعات خطا) مربوط به هر فریم را ذخیره می‌کند،
و در پایان پردازش، میانگین آن به طور مساوی در تمامی فریم‌ها محاسبه شده
و فرمول زیر برای به دست آوردن PSNR اعمال می‌گردد:
.PP
.Vb 1
\&        PSNR = 10*log10(MAX^2/MSE)
.Ve
.PP
که در آن MAX میانگین حداکثر مقادیر هر مؤلفه تصویر است.
.PP
در ادامه شرح پارامترهای پذیرفته‌شده آمده است.
.IP "\fBstats_file, f\fR" 4
.IX Item "stats_file, f"
در صورت تعیین، فیلتر از پرونده نام‌برده برای ذخیره PSNR هر تک فریم
استفاده می‌کند. هنگامی که نام پرونده برابر با "\-" باشد، داده‌ها به خروجی
استاندارد فرستاده می‌شوند.
.IP \fBstats_version\fR 4
.IX Item "stats_version"
مشخص می‌کند کدام نسخه از قالب پرونده آمار استفاده شود. جزئیات
هر قالب در زیر نوشته شده است.
مقدار پیش‌فرض 1 است.
.IP \fBoutput_max\fR 4
.IX Item "output_max"
تعیین می‌کند که آیا مقدار حداکثر در گزارش آمار خروجی داده شود یا خیر.
مقدار پیش‌فرض 0 است.
نیاز به stats_version >= 2 دارد. اگر این گزینه تنظیم شود و stats_version < 2 باشد،
فیلتر یک خطا برمی‌گرداند.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
پرونده چاپ‌شده در صورت انتخاب \fIstats_file\fR، شامل دنباله‌ای از
جفت‌های کلید/مقدار به صورت \fIkey\fR:\fIvalue\fR برای هر جفت فریم
مقایسه‌شده است.
.PP
اگر یک \fIstats_version\fR بزرگتر از 1 مشخص شود، یک خط سربرگ پیش از
فهرست آمار جفت‌فریم‌ها قرار می‌گیرد، با جفت‌های کلید/مقدار مطابق با
قالب فریم به همراه پارامترهای زیر:
.IP \fBpsnr_log_version\fR 4
.IX Item "psnr_log_version"
نسخه قالب پرونده گزارش. با \fIstats_version\fR مطابقت خواهد داشت.
.IP \fBfields\fR 4
.IX Item "fields"
فهرستی جداشده با کاما از پارامترهای به ازای هر جفت‌فریم گنجانده‌شده در
گزارش.
.PP
شرح هر پارامتر نشان‌داده‌شده به ازای هر جفت‌فریم در ادامه آمده است:
.IP \fBn\fR 4
.IX Item "n"
شماره ترتیبی فریم ورودی، شروع از 1
.IP \fBmse_avg\fR 4
.IX Item "mse_avg"
میانگین مربعات خطای تفاضل پیکسل‌به‌پیکسل فریم‌های مقایسه‌شده،
میانگین‌گیری‌شده در تمامی مؤلفه‌های تصویر.
.IP "\fBmse_y, mse_u, mse_v, mse_r, mse_g, mse_b, mse_a\fR" 4
.IX Item "mse_y, mse_u, mse_v, mse_r, mse_g, mse_b, mse_a"
میانگین مربعات خطای تفاضل پیکسل‌به‌پیکسل فریم‌های مقایسه‌شده
برای مؤلفه مشخص‌شده توسط پسوند.
.IP "\fBpsnr_y, psnr_u, psnr_v, psnr_r, psnr_g, psnr_b, psnr_a\fR" 4
.IX Item "psnr_y, psnr_u, psnr_v, psnr_r, psnr_g, psnr_b, psnr_a"
نسبت بیشینه سیگنال به نویز فریم‌های مقایسه‌شده برای مؤلفه
مشخص‌شده توسط پسوند.
.IP "\fBmax_avg, max_y, max_u, max_v\fR" 4
.IX Item "max_avg, max_y, max_u, max_v"
حداکثر مقدار مجاز برای هر کانال، و میانگین در تمامی کانال‌ها.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای مثال:
.Sp
.Vb 2
\&        movie=ref_movie.mpg, setpts=PTS\-STARTPTS [main];
\&        [main][ref] psnr="stats_file=stats.log" [out]
.Ve
.Sp
در این مثال پرونده ورودیِ در حال پردازش با پرونده مرجع \fIref_movie.mpg\fR
مقایسه می‌شود. مقدار PSNR هر فریم منفرد در \fIstats.log\fR ذخیره
می‌شود.
.IP \(bu 4
مثال دیگری با کانتینرهای متفاوت:
.Sp
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mkv \-lavfi  "[0:v]settb=AVTB,setpts=PTS\-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS\-STARTPTS[ref];[main][ref]psnr" \-f null \-
.Ve
.SS pullup
.IX Subsection "pullup"
فیلتر معکوس‌سازی Pulldown (تله‌سینه معکوس)، با توانایی مدیریت محتوای ترکیبی
hard\-telecine، پروگرسیو 24000/1001 فریم بر ثانیه، و پروگرسیو 30000/1001 فریم بر ثانیه.
.PP
فیلتر pullup به گونه‌ای طراحی شده است که در تصمیم‌گیری‌های خود از زمینه و اطلاعات آینده بهره ببرد.
این فیلتر بدون حالت (stateless) است، به این معنا که روی الگویی خاص قفل نمی‌شود،
بلکه به فیلدهای پس از آن نگاه می‌کند تا تطابق‌ها را شناسایی کرده و فریم‌های پروگرسیو را بازسازی نماید.
.PP
برای تولید محتوا با نرخ فریم یکنواخت، فیلتر fps را پس از pullup قرار دهید؛
در صورتی که نرخ فریم ورودی 29.97fps است از \f(CW\*(C`fps=24000/1001\*(C'\fR،
و برای 30fps و ورودی (نادر) تله‌سینه‌شده 25fps از \f(CW\*(C`fps=24\*(C'\fR استفاده کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBjl\fR 4
.IX Item "jl"
.PD 0
.IP \fBjr\fR 4
.IX Item "jr"
.IP \fBjt\fR 4
.IX Item "jt"
.IP \fBjb\fR 4
.IX Item "jb"
.PD
این گزینه‌ها به ترتیب مقدار حاشیه‌های اضافی ("junk") برای نادیده گرفتن در سمت چپ، راست، بالا، و
پایین تصویر را تعیین می‌کنند. چپ و راست در واحدهای 8 پیکسلی هستند،
در حالی که بالا و پایین در واحدهای 2 خطی می‌باشند.
مقدار پیش‌فرض 8 پیکسل در هر طرف است.
.IP \fBsb\fR 4
.IX Item "sb"
تنظیم شکست‌های دقیق (strict breaks). تنظیم این گزینه روی 1 شانس
تولید فریم تصادفی نامطابق توسط فیلتر را کاهش می‌دهد، اما همچنین ممکن است باعث
افت تعداد زیادی از فریم‌ها در طول سکانس‌های با حرکت سریع شود.
برعکس، تنظیم آن روی \-1 باعث می‌شود فیلتر فیلدها را آسان‌تر تطبیق دهد.
این ممکن است به پردازش ویدیویی که در آن تاری جزئی بین فیلدها وجود دارد کمک کند،
اما همچنین ممکن است باعث وجود فریم‌های درهم‌بافته در خروجی شود.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBmp\fR 4
.IX Item "mp"
تنظیم صفحه سنجه (metric plane) برای استفاده. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBl\fR 4
.IX Item "l"
استفاده از صفحه روشنایی (luma).
.IP \fBu\fR 4
.IX Item "u"
استفاده از صفحه رنگی آبی (chroma blue).
.IP \fBv\fR 4
.IX Item "v"
استفاده از صفحه رنگی قرمز (chroma red).
.RE
.RS 4
.Sp
این گزینه ممکن است برای استفاده از صفحه رنگی به‌جای صفحه پیش‌فرض روشنایی
جهت انجام محاسبات فیلتر تنظیم شود. این کار ممکن است دقت را روی محتوای منبع
بسیار تمیز بهبود بخشد، اما به احتمال زیاد دقت را کاهش خواهد داد، به ویژه اگر
نویز کروما (اثر رنگین‌کمانی) یا هرگونه ویدیوی مقیاس خاکستری وجود داشته باشد.
هدف اصلی از تنظیم \fBmp\fR روی یک صفحه کروما، کاهش بار CPU
و امکان استفاده از pullup به صورت بلادرنگ در رایانه‌های کند است.
.RE
.PP
برای بهترین نتایج (بدون فریم‌های تکراری در پرونده خروجی)
تغییر نرخ فریم خروجی ضروری است. برای مثال، برای تله‌سینه معکوس ورودی NTSC:
.PP
.Vb 1
\&        ffmpeg \-i input \-vf pullup \-r 24000/1001 ...
.Ve
.SS qp
.IX Subsection "qp"
تغییر پارامترهای کوانتیزاسیون ویدیو (QP).
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBqp\fR 4
.IX Item "qp"
تنظیم عبارت برای پارامتر کوانتیزاسیون.
.PP
این عبارت از طریق رابط ارزیابی (eval API) ارزیابی می‌شود و می‌تواند از جمله
شامل ثوابت زیر باشد:
.IP \fIknown\fR 4
.IX Item "known"
1 اگر ایندکس 129 نباشد، در غیر این صورت 0.
.IP \fIqp\fR 4
.IX Item "qp"
ایندکس متوالی که از \-129 تا 128 شروع می‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
معادله‌ای مانند:
.Sp
.Vb 1
\&        qp=2+2*sin(PI*qp)
.Ve
.SS qrencode
.IX Subsection "qrencode"
تولید یک کد QR با استفاده از کتابخانه libqrencode (ببینید
<\fBhttps://fukuchi.org/works/qrencode\fR>)، و همپوشانی آن بر روی فریم
جاری.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libqrencode\*(C'\fR پیکربندی کنید.
.PP
کد QR از متن یا الگوی متنی ارائه‌شده تولید می‌شود. کد QR
مربوطه بر اساس گزینه‌های مشخص‌شده مقیاس‌بندی شده و روی خروجی ویدیو
همپوشانی می‌شود.
.PP
در صورتی که هیچ متنی تعیین نشود، هیچ کد QR همپوشانی نمی‌گردد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBqrcode_width, q\fR" 4
.IX Item "qrcode_width, q"
.PD 0
.IP "\fBpadded_qrcode_width, Q\fR" 4
.IX Item "padded_qrcode_width, Q"
.PD
تعیین یک عبارت برای عرض کد QR رندرشده، با و بدون
حاشیه (padding). عبارت \fIqrcode_width\fR می‌تواند به مقدار تعیین‌شده توسط
عبارت \fIpadded_qrcode_width\fR ارجاع دهد و برعکس.
به‌طور پیش‌فرض \fIpadded_qrcode_width\fR روی \fIqrcode_width\fR تنظیم شده است، به این معنی که
هیچ حاشیه‌ای وجود ندارد.
.Sp
این عبارت‌ها برای هر فریم جدید ارزیابی می‌شوند.
.Sp
برای جزئیات به بخش \fBعبارت‌های qrencode\fR مراجعه کنید.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تعیین یک عبارت برای موقعیت‌دهی گوشه بالا\-چپ کد QR دارای حاشیه. عبارت
\&\fIx\fR می‌تواند به مقدار تعیین‌شده توسط عبارت \fIy\fR ارجاع دهد و
برعکس.
.Sp
به‌طور پیش‌فرض \fIx\fR و \fIy\fR روی \fI0\fR تنظیم شده‌اند، به این معنی که کد QR
در گوشه بالا\-چپ ورودی قرار می‌گیرد.
.Sp
این عبارت‌ها برای هر فریم جدید ارزیابی می‌شوند.
.Sp
برای جزئیات به بخش \fBعبارت‌های qrencode\fR مراجعه کنید.
.IP "\fBcase_sensitive, cs\fR" 4
.IX Item "case_sensitive, cs"
دستور به libqrencode جهت استفاده از کدگذاری حساس به حروف کوچک و بزرگ. این مورد به‌طور
پیش‌فرض فعال است. می‌توان آن را برای کاهش اندازه کدگذاری QR غیرفعال کرد.
.IP "\fBlevel, l\fR" 4
.IX Item "level, l"
تعیین سطح تصحیح خطای کدگذاری QR. با سطح تصحیح بالاتر،
اندازه کدگذاری افزایش می‌یابد اما کد در برابر خرابی مقاوم‌تر خواهد بود.
سطح پایین‌تر \fIL\fR است.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBL\fR 4
.IX Item "L"
.PD 0
.IP \fBM\fR 4
.IX Item "M"
.IP \fBQ\fR 4
.IX Item "Q"
.IP \fBH\fR 4
.IX Item "H"
.PD
.RE
.RS 4
.RE
.IP \fBexpansion\fR 4
.IX Item "expansion"
انتخاب نحوه بسط متن ورودی. می‌تواند یکی از مقادیر \f(CW\*(C`none\*(C'\fR یا
\&\f(CW\*(C`normal\*(C'\fR (پیش‌فرض) باشد. برای جزئیات به بخش \fBبسط متن qrencode\fR
در زیر مراجعه کنید.
.IP \fBtext\fR 4
.IX Item "text"
.PD 0
.IP \fBtextfile\fR 4
.IX Item "textfile"
.PD
تعریف متنی که باید رندر شود. در صورتی که هیچ‌یک تعیین نشود، هیچ کد QR کدگذاری نمی‌شود
(صرفاً یک فریم رنگی خالی).
.Sp
در صورتی که بسط متن فعال باشد، با متن مانند یک الگوی متنی رفتار می‌شود که از سازوکار
بسط qrencode استفاده می‌کند. برای جزئیات به بخش \fBبسط متن
qrencode\fR در زیر مراجعه کنید.
.IP "\fBbackground_color, bc\fR" 4
.IX Item "background_color, bc"
.PD 0
.IP "\fBforeground_color, fc\fR" 4
.IX Item "foreground_color, fc"
.PD
تنظیم رنگ کد QR و رنگ پس‌زمینه. مقدار پیش‌فرض
\&\fIforeground_color\fR برابر "black" و مقدار پیش‌فرض \fIbackground_color\fR
برابر "white" است.
.Sp
برای نحو گزینه‌های رنگ، \fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.PP
\fIعبارت‌های qrencode\fR
.IX Subsection "qrencode Expressions"
.PP
عبارت‌های تعیین‌شده توسط گزینه‌ها شامل ثوابت و توابع زیر هستند:
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی، همانند (\fIw\fR / \fIh\fR) * \fIsar\fR است
.IP \fBduration\fR 4
.IX Item "duration"
مدت زمان فریم جاری، بر حسب ثانیه
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری رنگی افقی و عمودی. برای مثال برای
قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP "\fBmain_h, H\fR" 4
.IX Item "main_h, H"
ارتفاع ورودی
.IP "\fBmain_w, W\fR" 4
.IX Item "main_w, W"
عرض ورودی
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، شروع از 0
.IP \fBpict_type\fR 4
.IX Item "pict_type"
عددی که نوع تصویر را نشان می‌دهد
.IP "\fBqr_w, w\fR" 4
.IX Item "qr_w, w"
عرض کد QR کدگذاری‌شده
.IP "\fBrendered_qr_w, q\fR" 4
.IX Item "rendered_qr_w, q"
.PD 0
.IP "\fBrendered_padded_qr_w, Q\fR" 4
.IX Item "rendered_padded_qr_w, Q"
.PD
عرض کد QR رندرشده، بدون و با حاشیه.
.Sp
این پارامترها به عبارت‌های \fIq\fR و \fIQ\fR اجازه می‌دهند به یکدیگر ارجاع
دهند، بنابراین می‌توانید به عنوان مثال \f(CW\*(C`q=3/4*Q\*(C'\fR را تعیین کنید.
.IP "\fBrand(min, max)\fR" 4
.IX Item "rand(min, max)"
بازگرداندن یک عدد تصادفی بین \fImin\fR و \fImax\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بیان‌شده به ثانیه، NAN در صورتی که برچسب زمانی ورودی ناشناخته باشد
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مختصات آفست x و y در جایی که متن رسم می‌شود.
.Sp
این پارامترها به عبارت‌های \fIx\fR و \fIy\fR اجازه می‌دهند به یکدیگر ارجاع
دهند، بنابراین می‌توانید به عنوان مثال \f(CW\*(C`y=x/dar\*(C'\fR را تعیین کنید.
.PP
\fIبسط متن qrencode\fR
.IX Subsection "qrencode Text expansion"
.PP
اگر \fBexpansion\fR روی \f(CW\*(C`none\*(C'\fR تنظیم شود، متن عیناً چاپ می‌شود.
.PP
اگر \fBexpansion\fR روی \f(CW\*(C`normal\*(C'\fR (که پیش‌فرض است) تنظیم شود،
سازوکار بسط زیر استفاده می‌شود.
.PP
نویسه بک‌اسلش \fB\e\fR، همراه با هر نویسه‌ای پس از آن، همواره به
نویسه دوم بسط می‌یابد.
.PP
دنباله‌هایی به فرم \f(CW\*(C`%{...}\*(C'\fR بسط داده می‌شوند. متن میان
آکولادها یک نام تابع است که احتمالاً آرگومان‌هایی جداشده با \*(Aq:\*(Aq به دنبال آن می‌آیند.
اگر آرگومان‌ها شامل نویسه‌های خاص یا جداکننده‌ها (\*(Aq:\*(Aq یا \*(Aq}\*(Aq) باشند،
باید اسکیپ شوند.
.PP
توجه داشته باشید که آنها احتمالاً باید به عنوان مقدار گزینه \fBtext\fR
در رشته آرگومان فیلتر و به عنوان آرگومان فیلتر در شرح گراف فیلتر، و احتمالاً
برای پوسته نیز اسکیپ شوند، که تا چهار سطح اسکیپ ایجاد می‌کند؛ استفاده از
یک پرونده متنی با گزینه \fBtextfile\fR از این مشکلات جلوگیری می‌کند.
.PP
توابع زیر در دسترس هستند:
.IP "\fBn, frame_num\fR" 4
.IX Item "n, frame_num"
بازگرداندن شماره فریم
.IP \fBpts\fR 4
.IX Item "pts"
بازگرداندن برچسب زمانی نمایش (PTS) فریم جاری.
.Sp
می‌تواند تا دو آرگومان دریافت کند.
.Sp
آرگومان اول قالب برچسب زمانی است؛ پیش‌فرض \f(CW\*(C`flt\*(C'\fR برای
ثانیه‌ها به صورت یک عدد اعشاری با دقت میکروثانیه است؛ \f(CW\*(C`hms\*(C'\fR نشان‌دهنده
برچسب زمانی قالب‌بندی‌شده \fI[\-]HH:MM:SS.mmm\fR با دقت میلی‌ثانیه است.
\&\f(CW\*(C`gmtime\*(C'\fR نشان‌دهنده برچسب زمانی فریم در قالب زمان UTC است؛
\&\f(CW\*(C`localtime\*(C'\fR نشان‌دهنده برچسب زمانی فریم در قالب زمان منطقه زمانی
محلی است. اگر قالب روی \f(CW\*(C`hms24hh\*(C'\fR تنظیم شود، زمان در قالب ۲۴ ساعته
(00\-23) قالب‌بندی می‌شود.
.Sp
آرگومان دوم یک آفست است که به برچسب زمانی اضافه می‌شود.
.Sp
اگر قالب روی \f(CW\*(C`localtime\*(C'\fR یا \f(CW\*(C`gmtime\*(C'\fR تنظیم شود، آرگومان سومی نیز ممکن است
ارائه شود: یک رشته قالب تابع C از نوع \f(CW\*(C`strftime\*(C'\fR. به‌طور پیش‌فرض،
قالب \fIYYYY\-MM\-DD HH:MM:SS\fR استفاده خواهد شد.
.IP "\fBexpr, e\fR" 4
.IX Item "expr, e"
محاسبه مقدار عبارت و خروجی دادن آن به صورت یک عدد اعشاری مضاعف (double).
.Sp
باید یک آرگومان دریافت کند که عبارت مورد ارزیابی را مشخص می‌کند، و
ثوابت و توابع تعریف‌شده در \fBqrencode_expressions\fR را می‌پذیرد.
.IP "\fBexpr_formatted, ef\fR" 4
.IX Item "expr_formatted, ef"
محاسبه مقدار عبارت و خروجی دادن آن به صورت یک رشته قالب‌بندی‌شده.
.Sp
آرگومان اول عبارتی است که باید ارزیابی شود، دقیقاً همانند تابع \fIexpr\fR.
آرگومان دوم قالب خروجی را مشخص می‌کند. مقادیر مجاز عبارتند از \fBx\fR،
\&\fBX\fR، \fBd\fR و \fBu\fR. با آنها دقیقاً مانند تابع
\&\f(CW\*(C`printf\*(C'\fR رفتار می‌شود.
پارامتر سوم اختیاری است و تعداد موقعیت‌های اشغال‌شده توسط خروجی را تعیین می‌کند.
می‌توان از آن برای افزودن پدینگ صفر از سمت چپ استفاده کرد.
.IP \fBgmtime\fR 4
.IX Item "gmtime"
زمانی که فیلتر در آن در حال اجرا است، بیان‌شده به وقت UTC.
می‌تواند یک آرگومان بپذیرد: رشته قالب تابع C از نوع \f(CW\*(C`strftime\*(C'\fR.
این رشته قالب برای پشتیبانی از متغیر \fI%[1\-6]N\fR گسترش یافته است
که کسرهای ثانیه را با تعداد ارقام اختیاری مشخص‌شده چاپ می‌کند.
.IP \fBlocaltime\fR 4
.IX Item "localtime"
زمانی که فیلتر در آن در حال اجرا است، بیان‌شده به وقت منطقه زمانی محلی.
می‌تواند یک آرگومان بپذیرد: رشته قالب تابع C از نوع \f(CW\*(C`strftime\*(C'\fR.
این رشته قالب برای پشتیبانی از متغیر \fI%[1\-6]N\fR گسترش یافته است
که کسرهای ثانیه را با تعداد ارقام اختیاری مشخص‌شده چاپ می‌کند.
.IP \fBmetadata\fR 4
.IX Item "metadata"
متاداده فریم. یک یا دو آرگومان می‌گیرد.
.Sp
آرگومان اول اجباری است و کلید متاداده را مشخص می‌کند.
.Sp
آرگومان دوم اختیاری است و یک مقدار پیش‌فرض را مشخص می‌کند، که در صورت
یافت نشدن کلید متاداده یا خالی بودن آن استفاده می‌شود.
.Sp
متاداده‌های موجود را می‌توان با بررسی ورودی‌هایی که با TAG شروع می‌شوند و در هر
بخش فریم با اجرای \f(CW\*(C`ffprobe \-show_frames\*(C'\fR چاپ می‌شوند، شناسایی کرد.
.Sp
متاداده‌های متنی تولیدشده در فیلترهای منتهی به فیلتر qrencode نیز در دسترس هستند.
.IP "\fBrand(min, max)\fR" 4
.IX Item "rand(min, max)"
بازگرداندن یک عدد تصادفی بین \fImin\fR و \fImax\fR
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک کد QR شامل متن مشخص‌شده با اندازه پیش‌فرض، همپوشانی‌شده
در گوشه بالا\-چپ ویدیوی ورودی با اندازه پیش‌فرض:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org
.Ve
.IP \(bu 4
همانند مورد زیر، اما انتخاب رنگ‌های آبی روی صورتی:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org:bc=pink@0.5:fc=blue
.Ve
.IP \(bu 4
قرار دادن کد QR در گوشه پایین\-راست ویدیوی ورودی:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org:x=W\-Q:y=H\-Q
.Ve
.IP \(bu 4
تولید یک کد QR با عرض 200 پیکسل و حاشیه، به طوری که عرض دارای حاشیه
4/3 عرض کد QR باشد:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org:q=200:Q=4/3*q
.Ve
.IP \(bu 4
تولید یک کد QR با عرض دارای حاشیه 200 پیکسل و حاشیه، به طوری که عرض
کد QR برابر 3/4 عرض دارای حاشیه باشد:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org:Q=200:q=3/4*Q
.Ve
.IP \(bu 4
تنظیم کد QR به صورت کسری از عرض ویدیوی ورودی:
.Sp
.Vb 1
\&        qrencode=text=www.ffmpeg.org:q=W/5
.Ve
.IP \(bu 4
تولید یک کد QR شامل شماره فریم:
.Sp
.Vb 1
\&        qrencode=text=%{n}
.Ve
.IP \(bu 4
تولید یک کد QR شامل برچسب زمانی GMT:
.Sp
.Vb 1
\&        qrencode=text=%{gmtime}
.Ve
.IP \(bu 4
تولید یک کد QR شامل برچسب زمانی بیان‌شده به صورت عدد اعشاری:
.Sp
.Vb 1
\&        qrencode=text=%{pts}
.Ve
.SS quirc
.IX Subsection "quirc"
شناسایی و رمزگشایی یک کد QR با استفاده از کتابخانه libquirc (ببینید
<\fBhttps://github.com/dlbeer/quirc\fR>)، و چاپ موقعیت‌ها و محموله
(payload) کدهای QR شناسایی‌شده به عنوان متاداده.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libquirc\*(C'\fR پیکربندی کنید.
.PP
به ازای هر کد QR یافت‌شده در ویدیوی ورودی، مدخل‌هایی از متاداده با
پیشوند \fIlavfi.quirc.N\fR اضافه می‌شود، که در آن \fIN\fR شاخص مربوط به
کد QR با شروع از 0 است.
.PP
شرح هر مقدار متاداده در ادامه آمده است:
.IP \fBlavfi.quirc.count\fR 4
.IX Item "lavfi.quirc.count"
تعداد کدهای QR یافت‌شده؛ در صورتی که هیچ کدی یافت نشود تنظیم نمی‌شود
.IP \fBlavfi.quirc.N.corner.M.x\fR 4
.IX Item "lavfi.quirc.N.corner.M.x"
.PD 0
.IP \fBlavfi.quirc.N.coreer.M.y\fR 4
.IX Item "lavfi.quirc.N.coreer.M.y"
.PD
موقعیت‌های x/y چهار گوشه مربع حاوی کد QR،
که در آن \fIM\fR شاخص گوشه با شروع از 0 است
.IP \fBlavfi.quirc.N.payload\fR 4
.IX Item "lavfi.quirc.N.payload"
محموله (payload) کد QR
.SS random
.IX Subsection "random"
تخلیه فریم‌های ویدیویی از حافظه موقت (کَش) داخلی فریم‌ها با ترتیبی تصادفی.
هیچ فریمی دور ریخته نمی‌شود.
با الهام از فیلتر nervous در \fBfrei0r\fR.
.IP \fBframes\fR 4
.IX Item "frames"
تنظیم اندازه کَش داخلی بر حسب تعداد فریم، در محدوده \f(CW2\fR تا
\&\f(CW512\fR. پیش‌فرض \f(CW30\fR است.
.IP \fBseed\fR 4
.IX Item "seed"
تنظیم سید (seed) برای مولد اعداد تصادفی؛ باید یک عدد صحیح بین
\&\f(CW0\fR و \f(CW\*(C`UINT32_MAX\*(C'\fR باشد. در صورت عدم تعیین، یا در صورتی که صراحتاً
کمتر از \f(CW0\fR تنظیم شود، فیلتر تلاش می‌کند تا بر پایه بیشترین تلاش یک سید تصادفی
مناسب استفاده کند.
.SS readeia608
.IX Subsection "readeia608"
خواندن اطلاعات زیرنویس پنهان (EIA\-608) از خطوط بالایی یک فریم ویدیو.
.PP
این فیلتر متاداده فریم را برای \f(CW\*(C`lavfi.readeia608.X.cc\*(C'\fR و
\&\f(CW\*(C`lavfi.readeia608.X.line\*(C'\fR اضافه می‌کند، که در آن \f(CW\*(C`X\*(C'\fR شماره خط شناسایی‌شده
حاوی داده‌های EIA\-608 (شروع از 0) است. شرح هر مقدار متاداده در ادامه آمده است:
.IP \fBlavfi.readeia608.X.cc\fR 4
.IX Item "lavfi.readeia608.X.cc"
دو بایت ذخیره‌شده به عنوان داده EIA\-608 (چاپ‌شده در مبنای شانزده).
.IP \fBlavfi.readeia608.X.line\fR 4
.IX Item "lavfi.readeia608.X.line"
شماره خطی که داده‌های EIA\-608 روی آن شناسایی و خوانده شدند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBscan_min\fR 4
.IX Item "scan_min"
تنظیم خط برای شروع پویش جهت داده‌های EIA\-608. پیش‌فرض \f(CW0\fR است.
.IP \fBscan_max\fR 4
.IX Item "scan_max"
تنظیم خط برای پایان پویش جهت داده‌های EIA\-608. پیش‌فرض \f(CW29\fR است.
.IP \fBspw\fR 4
.IX Item "spw"
تنظیم نسبت عرض رزروشده برای تشخیص کد همگام‌سازی (sync code).
پیش‌فرض \f(CW0.27\fR است. محدوده مجاز \f(CW\*(C`[0.1 \- 0.7]\*(C'\fR است.
.IP \fBchp\fR 4
.IX Item "chp"
فعال‌سازی بررسی بیت توازن (parity bit). در صورت بروز خطای توازن، فیلتر
\&\f(CW0x00\fR را برای آن نویسه خروجی می‌دهد. پیش‌فرض false است.
.IP \fBlp\fR 4
.IX Item "lp"
اعمال فیلتر پایین‌گذر بر روی خطوط پیش از پردازش بیشتر. پیش‌فرض فعال است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
خروجی دادن یک پرونده csv همراه با زمان نمایش و دو خط اول از داده‌های زیرنویس EIA\-608 شناسایی‌شده.
.Sp
.Vb 1
\&        ffprobe \-f lavfi \-i movie=captioned_video.mov,readeia608 \-show_entries frame=pts_time:frame_tags=lavfi.readeia608.0.cc,lavfi.readeia608.1.cc \-of csv
.Ve
.SS readvitc
.IX Subsection "readvitc"
خواندن اطلاعات کد زمانی بازه عمودی (VITC) از خطوط بالایی یک
فریم ویدیو.
.PP
در صورتی که یک کد زمانی معتبر شناسایی شده باشد، این فیلتر کلید متاداده فریم
\&\f(CW\*(C`lavfi.readvitc.tc_str\*(C'\fR را با مقدار کد زمانی اضافه می‌کند. کلید متاداده دیگر با نام
\&\f(CW\*(C`lavfi.readvitc.found\*(C'\fR بسته به اینکه داده‌های کد زمانی یافت شده باشد یا خیر
روی 0/1 تنظیم می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBscan_max\fR 4
.IX Item "scan_max"
تنظیم حداکثر تعداد خطوط برای پویش جهت داده‌های VITC. اگر مقدار روی
\&\f(CW\-1\fR تنظیم شود، کل فریم ویدیو پویش می‌شود. پیش‌فرض \f(CW45\fR است.
.IP \fBthr_b\fR 4
.IX Item "thr_b"
تنظیم آستانه روشنایی (luma) برای رنگ سیاه. اعداد اعشاری در محدوده [0.0,1.0] را می‌پذیرد،
مقدار پیش‌فرض \f(CW0.2\fR است. این مقدار باید برابر یا کمتر از \f(CW\*(C`thr_w\*(C'\fR باشد.
.IP \fBthr_w\fR 4
.IX Item "thr_w"
تنظیم آستانه روشنایی (luma) برای رنگ سفید. اعداد اعشاری در محدوده [0.0,1.0] را می‌پذیرد،
مقدار پیش‌فرض \f(CW0.6\fR است. این مقدار باید برابر یا بیشتر از \f(CW\*(C`thr_b\*(C'\fR باشد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
شناسایی و رسم داده‌های VITC بر روی فریم ویدیو؛ اگر VITC معتبری شناسایی نشود،
رسم \f(CW\*(C`\-\-:\-\-:\-\-:\-\-\*(C'\fR به عنوان نگه‌دارنده مکان:
.Sp
.Vb 1
\&        ffmpeg \-i input.avi \-filter:v \*(Aqreadvitc,drawtext=fontfile=FreeMono.ttf:text=%{metadata\e\e:lavfi.readvitc.tc_str\e\e:\-\-\e\e\e\e\e\e:\-\-\e\e\e\e\e\e:\-\-\e\e\e\e\e\e:\-\-}:x=(w\-tw)/2:y=400\-ascent\*(Aq
.Ve
.SS remap
.IX Subsection "remap"
نگاشت مجدد پیکسل‌ها با استفاده از استریم ویدیوی ورودی دوم: Xmap و سوم: Ymap.
.PP
پیکسل مقصد در موقعیت (X, Y) از موقعیت منبع (x, y) برداشته می‌شود
که در آن x = Xmap(X, Y) و y = Ymap(X, Y) است. اگر مقادیر نگاشت خارج از محدوده باشند، مقدار
صفر برای پیکسل مقصد استفاده خواهد شد.
.PP
استریم‌های ویدیوی ورودی Xmap و Ymap باید ابعاد یکسانی داشته باشند. استریم ویدیوی خروجی
ابعاد استریم‌های ویدیویی Xmap/Ymap را خواهد داشت.
استریم‌های ویدیوی ورودی Xmap و Ymap تک‌کاناله با عمق ۱۶ بیت هستند.
.IP \fBformat\fR 4
.IX Item "format"
تعیین قالب پیکسلی خروجی از این فیلتر. می‌تواند \f(CW\*(C`color\*(C'\fR یا \f(CW\*(C`gray\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`color\*(C'\fR است.
.IP \fBfill\fR 4
.IX Item "fill"
تعیین رنگ پیکسل‌های نگاشت‌نشده. برای نحو این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید. رنگ پیش‌فرض \f(CW\*(C`black\*(C'\fR است.
.SS removegrain
.IX Subsection "removegrain"
فیلتر removegrain یک نویزگیر مکانی (spatial denoiser) برای ویدیوی پروگرسیو است.
.IP \fBm0\fR 4
.IX Item "m0"
تنظیم حالت برای صفحه اول.
.IP \fBm1\fR 4
.IX Item "m1"
تنظیم حالت برای صفحه دوم.
.IP \fBm2\fR 4
.IX Item "m2"
تنظیم حالت برای صفحه سوم.
.IP \fBm3\fR 4
.IX Item "m3"
تنظیم حالت برای صفحه چهارم.
.PP
محدوده حالت از 0 تا 24 است. شرح هر حالت در ادامه آمده است:
.IP \fI0\fR 4
.IX Item "0"
رها کردن صفحه ورودی بدون تغییر. پیش‌فرض.
.IP \fI1\fR 4
.IX Item "1"
برش پیکسل با حداقل و حداکثر 8 پیکسل همسایه.
.IP \fI2\fR 4
.IX Item "2"
برش پیکسل با دومین حداقل و حداکثر 8 پیکسل همسایه.
.IP \fI3\fR 4
.IX Item "3"
برش پیکسل با سومین حداقل و حداکثر 8 پیکسل همسایه.
.IP \fI4\fR 4
.IX Item "4"
برش پیکسل با چهارمین حداقل و حداکثر 8 پیکسل همسایه.
این معادل یک فیلتر میانه (median filter) است.
.IP \fI5\fR 4
.IX Item "5"
برش حساس به خط که کمترین تغییر را ایجاد می‌کند.
.IP \fI6\fR 4
.IX Item "6"
برش حساس به خط، حالت میانی.
.IP \fI7\fR 4
.IX Item "7"
برش حساس به خط، حالت میانی.
.IP \fI8\fR 4
.IX Item "8"
برش حساس به خط، حالت میانی.
.IP \fI9\fR 4
.IX Item "9"
برش حساس به خط روی خطی که در آن پیکسل‌های همسایه نزدیک‌ترین هستند.
.IP \fI10\fR 4
.IX Item "10"
جایگزینی پیکسل هدف با نزدیک‌ترین همسایه.
.IP \fI11\fR 4
.IX Item "11"
محو کردن هسته افقی و عمودی [1 2 1].
.IP \fI12\fR 4
.IX Item "12"
همانند حالت 11.
.IP \fI13\fR 4
.IX Item "13"
حالت Bob، درونیابی فیلد بالایی از روی خطی که در آن پیکسل‌های
همسایه نزدیک‌ترین هستند.
.IP \fI14\fR 4
.IX Item "14"
حالت Bob، درونیابی فیلد پایینی از روی خطی که در آن پیکسل‌های
همسایه نزدیک‌ترین هستند.
.IP \fI15\fR 4
.IX Item "15"
حالت Bob، درونیابی فیلد بالایی. همانند 13 اما با یک فرمول
درونیابی پیچیده‌تر.
.IP \fI16\fR 4
.IX Item "16"
حالت Bob، درونیابی فیلد پایینی. همانند 14 اما با یک فرمول
درونیابی پیچیده‌تر.
.IP \fI17\fR 4
.IX Item "17"
برش پیکسل با حداقل و حداکثرِ به ترتیب حداکثر و
حداقلِ هر جفت از پیکسل‌های همسایه روبرو.
.IP \fI18\fR 4
.IX Item "18"
برش حساس به خط با استفاده از همسایه‌های روبرو که بیشترین فاصله آنها از
پیکسل جاری کمترین است.
.IP \fI19\fR 4
.IX Item "19"
جایگزینی پیکسل با میانگین 8 همسایه آن.
.IP \fI20\fR 4
.IX Item "20"
میانگین‌گیری از 9 پیکسل (محو کردن افقی و عمودی [1 1 1]).
.IP \fI21\fR 4
.IX Item "21"
برش پیکسل‌ها با استفاده از میانگین‌های همسایه روبرو.
.IP \fI22\fR 4
.IX Item "22"
همانند حالت 21 اما ساده‌تر و سریع‌تر.
.IP \fI23\fR 4
.IX Item "23"
حذف لبه‌ها و هاله‌های کوچک، اما مشهور به بی‌فایده بودن.
.IP \fI24\fR 4
.IX Item "24"
مشابه با 23.
.SS removelogo
.IX Subsection "removelogo"
حذف لوگوی شبکه تلویزیونی، با استفاده از یک پرونده تصویری برای تعیین اینکه کدام
پیکسل‌ها لوگو را تشکیل می‌دهند. این فیلتر با پر کردن پیکسل‌های تشکیل‌دهنده
لوگو با پیکسل‌های مجاور کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfilename, f\fR" 4
.IX Item "filename, f"
تنظیم پرونده بیت‌مپ فیلتر، که می‌تواند هر قالب تصویری پشتیبانی‌شده توسط
libavformat باشد. عرض و ارتفاع پرونده تصویر باید با ابعاد استریم
ویدیوی در حال پردازش مطابقت داشته باشد.
.PP
پیکسل‌های دارای مقدار صفر در تصویر بیت‌مپ ارائه‌شده، به عنوان بخشی از لوگو
در نظر گرفته نمی‌شوند؛ پیکسل‌های غیرصفر بخشی از لوگو محسوب می‌شوند. اگر
از رنگ سفید (255) برای لوگو و سیاه (0) برای بقیه تصویر استفاده کنید،
مطمئن خواهید بود. برای ساخت بیت‌مپ فیلتر، توصیه می‌شود از یک فریم سیاه
که لوگو روی آن قابل مشاهده است اسکرین‌شات بگیرید، و سپس یک یا دو بار
از فیلتر آستانه (threshold) و به دنبال آن فیلتر سایش (erode) استفاده کنید.
.PP
در صورت نیاز، لکه‌های کوچک را می‌توان به صورت دستی اصلاح کرد. به یاد داشته باشید
که اگر پیکسل‌های لوگو پوشش داده نشوند، کیفیت فیلتر به شدت کاهش می‌یابد.
علامت‌گذاری بیش از حد پیکسل‌ها به عنوان بخشی از لوگو آسیب چندانی نمی‌زند،
اما مقدار محوکردگی مورد نیاز برای پوشاندن روی تصویر را افزایش می‌دهد و اطلاعات
بیشتری را نسبت به آنچه لازم است از بین می‌برد؛ همچنین پیکسل‌های اضافی
در یک لوگوی بزرگ سرعت پردازش را کاهش می‌دهند.
.SS repeatfields
.IX Subsection "repeatfields"
این فیلتر از پرچم repeat_field موجود در سربرگ‌های Video ES استفاده کرده و
فیلدها را بر پایه مقدار آن به صورت سخت (hard repeat) تکرار می‌کند.
.SS reverse
.IX Subsection "reverse"
معکوس کردن یک کلیپ ویدیویی.
.PP
هشدار: این فیلتر برای بافر کردن کل کلیپ به حافظه نیاز دارد، بنابراین
برش زدن (trimming) پیشنهاد می‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
گرفتن ۵ ثانیه اول یک کلیپ و معکوس کردن آن:
.Sp
.Vb 1
\&        trim=end=5,reverse
.Ve
.SS rgbashift
.IX Subsection "rgbashift"
تغییر مکان (شیفت) افقی و/یا عمودی پیکسل‌های R/G/B/A.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrh\fR 4
.IX Item "rh"
تنظیم مقدار جابه‌جایی افقی رنگ قرمز.
.IP \fBrv\fR 4
.IX Item "rv"
تنظیم مقدار جابه‌جایی عمودی رنگ قرمز.
.IP \fBgh\fR 4
.IX Item "gh"
تنظیم مقدار جابه‌جایی افقی رنگ سبز.
.IP \fBgv\fR 4
.IX Item "gv"
تنظیم مقدار جابه‌جایی عمودی رنگ سبز.
.IP \fBbh\fR 4
.IX Item "bh"
تنظیم مقدار جابه‌جایی افقی رنگ آبی.
.IP \fBbv\fR 4
.IX Item "bv"
تنظیم مقدار جابه‌جایی عمودی رنگ آبی.
.IP \fBah\fR 4
.IX Item "ah"
تنظیم مقدار جابه‌جایی افقی آلفا.
.IP \fBav\fR 4
.IX Item "av"
تنظیم مقدار جابه‌جایی عمودی آلفا.
.IP \fBedge\fR 4
.IX Item "edge"
تنظیم حالت لبه؛ می‌تواند \fIsmear\fR (پیش‌فرض) یا \fIwarp\fR باشد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS roberts
.IX Subsection "roberts"
اعمال عملگر متقاطع رابرتز (roberts cross operator) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که پردازش خواهند شد، صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمامی صفحات پردازش خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلترشده ضرب خواهد شد.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلترشده اضافه خواهد شد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS rotate
.IX Subsection "rotate"
چرخش ویدیو با یک زاویه دلخواه بر حسب رادیان.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.PP
در ادامه شرح پارامترهای اختیاری آمده است.
.IP "\fBangle, a\fR" 4
.IX Item "angle, a"
تنظیم یک عبارت برای زاویه‌ای که ویدیوی ورودی بر اساس آن در جهت
عقربه‌های ساعت می‌چرخد، بر حسب تعداد رادیان. یک مقدار منفی منجر به
چرخش در خلاف جهت عقربه‌های ساعت خواهد شد. به‌طور پیش‌فرض روی "0" تنظیم شده است.
.Sp
این عبارت برای هر فریم ارزیابی می‌شود.
.IP "\fBout_w, ow\fR" 4
.IX Item "out_w, ow"
تنظیم عبارت عرض خروجی؛ مقدار پیش‌فرض "iw" است.
این عبارت فقط یک‌بار در طول پیکربندی ارزیابی می‌شود.
.IP "\fBout_h, oh\fR" 4
.IX Item "out_h, oh"
تنظیم عبارت ارتفاع خروجی؛ مقدار پیش‌فرض "ih" است.
این عبارت فقط یک‌بار در طول پیکربندی ارزیابی می‌شود.
.IP \fBbilinear\fR 4
.IX Item "bilinear"
فعال‌سازی درونیابی دوخطی (bilinear) در صورت تنظیم روی 1؛ مقدار 0 آن را
غیرفعال می‌کند. مقدار پیش‌فرض 1 است.
.IP "\fBfillcolor, c\fR" 4
.IX Item "fillcolor, c"
تنظیم رنگ مورد استفاده برای پر کردن ناحیه خروجی که توسط تصویر
چرخانده‌شده پوشش داده نمی‌شود. برای نحو کلی این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
اگر مقدار ویژه "none" انتخاب شود، هیچ پس‌زمینه‌ای رسم نمی‌شود
(برای مثال در حالتی که پس‌زمینه هرگز نشان داده نمی‌شود مفید است).
.Sp
مقدار پیش‌فرض "black" است.
.PP
عبارت‌های مربوط به زاویه و اندازه خروجی می‌توانند شامل ثوابت و توابع
زیر باشند:
.IP \fBn\fR 4
.IX Item "n"
شماره ترتیبی فریم ورودی، شروع از 0. پیش از فیلتر شدن اولین فریم
همواره NAN است.
.IP \fBt\fR 4
.IX Item "t"
زمان بر حسب ثانیه برای فریم ورودی؛ هنگام پیکربندی فیلتر روی 0 تنظیم
می‌شود. پیش از فیلتر شدن اولین فریم همواره NAN است.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری رنگی افقی و عمودی. برای مثال برای قالب
پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP "\fBin_w, iw\fR" 4
.IX Item "in_w, iw"
.PD 0
.IP "\fBin_h, ih\fR" 4
.IX Item "in_h, ih"
.PD
عرض و ارتفاع ویدیوی ورودی
.IP "\fBout_w, ow\fR" 4
.IX Item "out_w, ow"
.PD 0
.IP "\fBout_h, oh\fR" 4
.IX Item "out_h, oh"
.PD
عرض و ارتفاع خروجی، یعنی اندازه ناحیه حاشیه‌دار (padded) مشخص‌شده
توسط عبارت‌های \fIwidth\fR و \fIheight\fR
.IP \fBrotw(a)\fR 4
.IX Item "rotw(a)"
.PD 0
.IP \fBroth(a)\fR 4
.IX Item "roth(a)"
.PD
حداقل عرض/ارتفاع مورد نیاز برای دربرگرفتن کامل ویدیوی ورودی
چرخانده‌شده به اندازه \fIa\fR رادیان.
.Sp
این موارد تنها هنگام محاسبه عبارت‌های \fBout_w\fR و
\&\fBout_h\fR در دسترس هستند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
چرخش ورودی به اندازه PI/6 رادیان در جهت عقربه‌های ساعت:
.Sp
.Vb 1
\&        rotate=PI/6
.Ve
.IP \(bu 4
چرخش ورودی به اندازه PI/6 رادیان در خلاف جهت عقربه‌های ساعت:
.Sp
.Vb 1
\&        rotate=\-PI/6
.Ve
.IP \(bu 4
چرخش ورودی به اندازه 45 درجه در جهت عقربه‌های ساعت:
.Sp
.Vb 1
\&        rotate=45*PI/180
.Ve
.IP \(bu 4
اعمال یک چرخش ثابت با دوره تناوب T، شروع از زاویه PI/3:
.Sp
.Vb 1
\&        rotate=PI/3+2*PI*t/T
.Ve
.IP \(bu 4
ایجاد نوسان در چرخش ویدیوی ورودی با دوره تناوب T
ثانیه و دامنه A رادیان:
.Sp
.Vb 1
\&        rotate=A*sin(2*PI/T*t)
.Ve
.IP \(bu 4
چرخش ویدیو، اندازه خروجی طوری انتخاب می‌شود که کل ویدیوی
ورودیِ در حال چرخش همواره کاملاً درون خروجی جا گیرد:
.Sp
.Vb 1
\&        rotate=\*(Aq2*PI*t:ow=hypot(iw,ih):oh=ow\*(Aq
.Ve
.IP \(bu 4
چرخش ویدیو، کاهش اندازه خروجی به گونه‌ای که هرگز هیچ پس‌زمینه‌ای
نشان داده نشود:
.Sp
.Vb 1
\&        rotate=2*PI*t:ow=\*(Aqmin(iw,ih)/sqrt(2)\*(Aq:oh=ow:c=none
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBa, angle\fR" 4
.IX Item "a, angle"
تنظیم عبارت زاویه.
این دستور همان نحو گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت تعیین‌شده نامعتبر باشد، روی مقدار جاری خود باقی
می‌ماند.
.SS sab
.IX Subsection "sab"
اعمال محوکردگی تطبیقی با شکل (Shape Adaptive Blur).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
تنظیم شدت فیلتر محوکننده روشنایی؛ باید مقداری در محدوده 0.1\-4.0 باشد، مقدار
پیش‌فرض 1.0 است. یک مقدار بزرگتر منجر به تصویری تارتر و پردازشی
کندتر خواهد شد.
.IP "\fBluma_pre_filter_radius, lpfr\fR" 4
.IX Item "luma_pre_filter_radius, lpfr"
تنظیم شعاع پیش‌فیلتر روشنایی؛ باید مقداری در محدوده 0.1\-2.0 باشد، مقدار
پیش‌فرض 1.0 است.
.IP "\fBluma_strength, ls\fR" 4
.IX Item "luma_strength, ls"
تنظیم حداکثر اختلاف میان پیکسل‌ها در روشنایی برای اینکه همچنان در نظر گرفته شوند؛ باید
مقداری در محدوده 0.1\-100.0 باشد، مقدار پیش‌فرض 1.0 است.
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
تنظیم شدت فیلتر محوکننده رنگ؛ باید مقداری در محدوده \-0.9\-4.0 باشد. یک
مقدار بزرگتر منجر به تصویری تارتر و پردازشی کندتر
خواهد شد.
.IP "\fBchroma_pre_filter_radius, cpfr\fR" 4
.IX Item "chroma_pre_filter_radius, cpfr"
تنظیم شعاع پیش‌فیلتر رنگ؛ باید مقداری در محدوده \-0.9\-2.0 باشد.
.IP "\fBchroma_strength, cs\fR" 4
.IX Item "chroma_strength, cs"
تنظیم حداکثر اختلاف میان پیکسل‌ها در رنگ برای اینکه همچنان در نظر گرفته شوند؛
باید مقداری در محدوده \-0.9\-100.0 باشد.
.PP
مقدار هر گزینه رنگ (chroma) در صورتی که صراحتاً مشخص نشود، روی مقدار
گزینه روشنایی (luma) متناظر تنظیم می‌شود.
.SS scale
.IX Subsection "scale"
تغییر مقیاس (تغییر اندازه) ویدیوی ورودی، با استفاده از کتابخانه libswscale.
.PP
فیلتر scale با تغییر دادن نسبت ابعاد نمونه خروجی، نسبت ابعاد نمایش
خروجی را مجبور می‌کند که با ورودی یکسان باشد.
.PP
اگر قالب تصویر ورودی با قالب درخواست‌شده توسط فیلتر بعدی متفاوت باشد،
فیلتر scale ورودی را به قالب درخواست‌شده تبدیل خواهد کرد.
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
این فیلتر گزینه‌های زیر، هر یک از گزینه‌های پشتیبانی‌شده توسط
مقیاس‌بند libswscale، و همچنین هر یک از گزینه‌های \fBframesync\fR را می‌پذیرد.
.PP
برای فهرست کامل گزینه‌های مقیاس‌بند به \fBراهنمای ffmpeg\-scaler\fR
مراجعه کنید.
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض ابعاد
ورودی است.
.Sp
اگر مقدار \fIwidth\fR یا \fIw\fR برابر 0 باشد، عرض ورودی برای
خروجی استفاده می‌شود. اگر مقدار \fIheight\fR یا \fIh\fR برابر 0 باشد، ارتفاع ورودی
برای خروجی استفاده می‌شود.
.Sp
اگر یکی و فقط یکی از مقادیر برابر \-n با n >= 1 باشد، فیلتر scale
مقداری را استفاده می‌کند که نسبت ابعاد تصویر ورودی را حفظ کند، که
از بعد مشخص‌شده دیگر محاسبه می‌شود. پس از آن با این حال، مطمئن خواهد شد
که بعد محاسبه‌شده بر n بخش‌پذیر است و در صورت لزوم مقدار را تعدیل
می‌کند.
.Sp
اگر هر دو مقدار برابر \-n با n >= 1 باشند، رفتار کاملاً مشابه
تنظیم هر دو مقدار روی 0 خواهد بود، همان‌طور که پیش‌تر شرح داده شد.
.Sp
برای فهرست ثوابت پذیرفته‌شده جهت استفاده در عبارت بعد به زیر
مراجعه کنید.
.IP \fBeval\fR 4
.IX Item "eval"
تعیین زمان ارزیابی عبارت‌های \fIwidth\fR و \fIheight\fR. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
تنها یک‌بار ارزیابی عبارت‌ها در طول مقداردهی اولیه فیلتر یا هنگام پردازش یک دستور.
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارت‌ها برای هر فریم ورودی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.RE
.IP \fBinterl\fR 4
.IX Item "interl"
تنظیم حالت درهم‌بافی (interlacing). مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fB1\fR 4
.IX Item "1"
اجبار مقیاس‌بندی آگاه از درهم‌بافی.
.IP \fB0\fR 4
.IX Item "0"
عدم اعمال مقیاس‌بندی درهم‌بافته.
.IP \fB\-1\fR 4
.IX Item "-1"
انتخاب مقیاس‌بندی آگاه از درهم‌بافی بسته به اینکه فریم‌های منبع
به عنوان درهم‌بافته نشانه‌گذاری شده باشند یا خیر.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fB0\fR است.
.RE
.IP \fBflags\fR 4
.IX Item "flags"
تنظیم فلگ‌های مقیاس‌بندی libswscale. برای فهرست کامل مقادیر
به \fBراهنمای ffmpeg\-scaler\fR مراجعه کنید.
در صورت عدم تعیین صریح، فیلتر فلگ‌های پیش‌فرض را اعمال
می‌کند.
.IP "\fBparam0, param1\fR" 4
.IX Item "param0, param1"
تنظیم پارامترهای ورودی libswscale برای الگوریتم‌های مقیاس‌بندی که به آنها نیاز دارند. برای
مستندات کامل به \fBراهنمای ffmpeg\-scaler\fR
مراجعه کنید. در صورت عدم تعیین صریح، فیلتر پارامترهای
خالی اعمال می‌کند.
.IP \fBintent\fR 4
.IX Item "intent"
تنظیم قصد رندرینگ (rendering intent) مربوط به ICC برای استفاده هنگام تبدیل میان فضاهای رنگی
مختلف. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBperceptual\fR 4
.IX Item "perceptual"
استفاده از منحنی نگاشت تنالیته و گاموت با هدایت ادراکی (perceptual). جزئیات دقیق
نگاشت مورداستفاده ممکن است در هر زمان تغییر کند و نباید به عنوان مقداری پایدار به آن اتکا شود.
این قصد رندرینگ برای مشاهده نهایی محتوای تصویر/ویدیو در تنظیمات
مشاهده معمول توصیه می‌شود.
.IP \fBrelative_colorimetric\fR 4
.IX Item "relative_colorimetric"
برش استاتیک رنگ‌های خارج از گاموت با استفاده از یک منحنی برش رنگ‌سنجی که
تلاش می‌کند کم‌اختلاف‌ترین رنگ درون گاموت را از نظر رنگ‌سنجی پیدا کند. این
قصد تطبیق نقطه سفید و تطبیق نقطه سیاه را انجام می‌دهد. این مقدار
پیش‌فرض است. این قصد رندرینگ در هر جایی که بازتولید وفادارانه رنگ‌ها از
بالاترین اهمیت برخوردار است، حتی به بهای برش خوردن، توصیه می‌شود.
.IP \fBabsolute_colorimetric\fR 4
.IX Item "absolute_colorimetric"
برش سخت رنگ‌های خارج از گاموت بدون هیچ تلاشی برای بازتولید نقطه
سفید یا سیاه. این قصد، رنگ‌های درون گاموت را روی نمایشگر خروجی نسبت 1:1 همان‌گونه
که در نمایشگر مرجع ظاهر می‌شوند بازتولید می‌کند، با فرض اینکه نمایشگر خروجی
به درستی کالیبره شده باشد.
.IP \fBsaturation\fR 4
.IX Item "saturation"
انجام نگاشت اشباع \- یعنی کشیدن حجم رنگ ورودی
مستقیماً روی حجم رنگ خروجی، به روشی غیرخطی که ظاهر سیگنال
اصلی را تا حد امکان حفظ کند. این قصد برای ارزیابی محتوای
سیگنال توصیه می‌شود، زیرا منجر به هیچ‌گونه برشی نخواهد شد. این حالت تقریباً
مشابه انجام ندادن هیچ‌گونه نگاشت رنگی است، گرچه هنوز رنگ‌های اصلی نمایشگر
مسترینگ و هرگونه تفاوت در TRC کدگذاری را در نظر می‌گیرد.
.RE
.RS 4
.RE
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیو. برای نحو این گزینه،
\fBبخش "Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBin_color_matrix\fR 4
.IX Item "in_color_matrix"
.PD 0
.IP \fBout_color_matrix\fR 4
.IX Item "out_color_matrix"
.PD
تنظیم نوع فضای رنگی YCbCr ورودی/خروجی.
.Sp
این گزینه امکان بازنویسی مقدار خودکار تشخیص‌داده‌شده را فراهم می‌کند و همچنین اجازه می‌دهد
یک مقدار خاص برای خروجی و انکودر تحمیل شود.
.Sp
در صورت عدم تعیین، نوع فضای رنگی به قالب پیکسل بستگی دارد.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار.
.IP \fBbt709\fR 4
.IX Item "bt709"
قالب منطبق با توصیه‌نامه BT.709 اتحادیه بین‌المللی مخابرات (ITU).
.IP \fBfcc\fR 4
.IX Item "fcc"
تنظیم فضای رنگی منطبق با کمیسیون ارتباطات فدرال ایالات متحده (FCC)
مجموعه قوانین مقررات فدرال (CFR) عنوان 47 سال (2003) بند 73.682 (a).
.IP \fBbt601\fR 4
.IX Item "bt601"
.PD 0
.IP \fBbt470\fR 4
.IX Item "bt470"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.PD
تنظیم فضای رنگی منطبق با:
.RS 4
.IP \(bu 4
توصیه‌نامه BT.601 بخش ارتباطات رادیویی اتحادیه بین‌المللی مخابرات (ITU\-R)
.IP \(bu 4
توصیه‌نامه ITU\-R Rec. BT.470\-6 (1998) سامانه‌های B، B1، و G
.IP \(bu 4
انجمن مهندسان فیلم و تلویزیون (SMPTE) استاندارد ST 170:2004
.RE
.RS 4
.RE
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
تنظیم فضای رنگی منطبق با SMPTE ST 240:1999.
.IP \fBbt2020\fR 4
.IX Item "bt2020"
تنظیم فضای رنگی منطبق با سیستم روشنایی غیرثابت ITU\-R BT.2020.
.RE
.RS 4
.RE
.IP \fBin_range\fR 4
.IX Item "in_range"
.PD 0
.IP \fBout_range\fR 4
.IX Item "out_range"
.PD
تنظیم محدوده نمونه YCbCr ورودی/خروجی.
.Sp
این گزینه اجازه می‌دهد مقدار تشخیص‌داده‌شده خودکار بازنویسی شود و همچنین امکان تحمیل
یک مقدار خاص برای خروجی و انکودر را می‌دهد. در صورت عدم تعیین،
محدوده به قالب پیکسل بستگی دارد. مقادیر ممکن:
.RS 4
.IP \fBauto/unknown\fR 4
.IX Item "auto/unknown"
انتخاب خودکار.
.IP \fBjpeg/full/pc\fR 4
.IX Item "jpeg/full/pc"
تنظیم محدوده کامل (0\-255 در مورد روشنایی ۸ بیتی).
.IP \fBmpeg/limited/tv\fR 4
.IX Item "mpeg/limited/tv"
تنظیم محدوده "MPEG" (16\-235 در مورد روشنایی ۸ بیتی).
.RE
.RS 4
.RE
.IP \fBin_chroma_loc\fR 4
.IX Item "in_chroma_loc"
.PD 0
.IP \fBout_chroma_loc\fR 4
.IX Item "out_chroma_loc"
.PD
تنظیم موقعیت مکانی نمونه کروما در ورودی/خروجی. در صورت عدم تعیین، کرومای در مرکز قرار گرفته
(center\-sited) به‌طور پیش‌فرض استفاده می‌شود. مقادیر ممکن:
.RS 4
.IP "\fBauto, unknown\fR" 4
.IX Item "auto, unknown"
.PD 0
.IP \fBleft\fR 4
.IX Item "left"
.IP \fBcenter\fR 4
.IX Item "center"
.IP \fBtopleft\fR 4
.IX Item "topleft"
.IP \fBtop\fR 4
.IX Item "top"
.IP \fBbottomleft\fR 4
.IX Item "bottomleft"
.IP \fBbottom\fR 4
.IX Item "bottom"
.PD
.RE
.RS 4
.RE
.IP \fBin_primaries\fR 4
.IX Item "in_primaries"
.PD 0
.IP \fBout_primaries\fR 4
.IX Item "out_primaries"
.PD
تنظیم رنگ‌های اصلی (primaries) در RGB ورودی/خروجی.
.Sp
این گزینه اجازه می‌دهد مقدار تشخیص‌داده‌شده خودکار بازنویسی شود و همچنین امکان تحمیل
یک مقدار خاص برای خروجی و انکودر را می‌دهد. مقادیر ممکن:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار. این مقدار پیش‌فرض است.
.IP \fBbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fBbt470m\fR 4
.IX Item "bt470m"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
.IP \fBfilm\fR 4
.IX Item "film"
.IP \fBbt2020\fR 4
.IX Item "bt2020"
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
.IP \fBjedec\-p22\fR 4
.IX Item "jedec-p22"
.IP \fBebu3213\fR 4
.IX Item "ebu3213"
.PD
.RE
.RS 4
.RE
.IP \fBin_transfer\fR 4
.IX Item "in_transfer"
.PD 0
.IP \fBout_transfer\fR 4
.IX Item "out_transfer"
.PD
تنظیم منحنی پاسخ انتقال (TRC) ورودی/خروجی.
.Sp
این گزینه اجازه می‌دهد مقدار تشخیص‌داده‌شده خودکار بازنویسی شود و همچنین امکان تحمیل
یک مقدار خاص برای خروجی و انکودر را می‌دهد. مقادیر ممکن:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
انتخاب خودکار. این مقدار پیش‌فرض است.
.IP \fBbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fBbt470m\fR 4
.IX Item "bt470m"
.IP \fBgamma22\fR 4
.IX Item "gamma22"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.IP \fBgamma28\fR 4
.IX Item "gamma28"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
.IP \fBlinear\fR 4
.IX Item "linear"
.IP \fBiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
.IP \fBsrgb\fR 4
.IX Item "srgb"
.IP \fBiec61966\-2\-4\fR 4
.IX Item "iec61966-2-4"
.IP \fBxvycc\fR 4
.IX Item "xvycc"
.IP \fBbt1361e\fR 4
.IX Item "bt1361e"
.IP \fBbt2020\-10\fR 4
.IX Item "bt2020-10"
.IP \fBbt2020\-12\fR 4
.IX Item "bt2020-12"
.IP \fBsmpte2084\fR 4
.IX Item "smpte2084"
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.IP \fBarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
.PD
.RE
.RS 4
.RE
.IP \fBforce_original_aspect_ratio\fR 4
.IX Item "force_original_aspect_ratio"
فعال‌سازی کاهش یا افزایش عرض یا ارتفاع ویدیوی خروجی در صورت لزوم جهت
حفظ نسبت ابعاد اصلی. مقادیر ممکن:
.RS 4
.IP \fBdisable\fR 4
.IX Item "disable"
مقیاس‌بندی ویدیو طبق مشخصات تعیین‌شده و غیرفعال کردن این ویژگی.
.IP \fBdecrease\fR 4
.IX Item "decrease"
ابعاد ویدیوی خروجی در صورت نیاز به طور خودکار کاهش می‌یابد.
.IP \fBincrease\fR 4
.IX Item "increase"
ابعاد ویدیوی خروجی در صورت نیاز به طور خودکار افزایش می‌یابد.
.RE
.RS 4
.Sp
یک کاربرد مفید این گزینه زمانی است که حداکثر تفکیک‌پذیری مجاز یک دستگاه
خاص را می‌دانید و می‌توانید از این گزینه برای محدود کردن ویدیوی خروجی به آن،
همراه با حفظ نسبت ابعاد استفاده کنید. برای مثال، دستگاه A امکان پخش
1280x720 را می‌دهد، و ویدیوی شما 1920x800 است. استفاده از این گزینه (تنظیم آن
روی decrease) و تعیین 1280x720 در خط فرمان، خروجی را برابر
1280x533 می‌سازد.
.Sp
لطفاً توجه داشته باشید که این موضوع با تعیین \-1 برای \fBw\fR
یا \fBh\fR متفاوت است؛ برای کارکرد این گزینه همچنان باید وضوح خروجی را
مشخص کنید.
.RE
.IP \fBforce_divisible_by\fR 4
.IX Item "force_divisible_by"
اطمینان حاصل می‌کند که هر دو بعد خروجی، عرض و ارتفاع، در هنگام استفاده به همراه
\fBforce_original_aspect_ratio\fR بر عدد صحیح ارائه‌شده بخش‌پذیر باشند. این گزینه
مشابه استفاده از \f(CW\*(C`\-n\*(C'\fR در گزینه‌های \fBw\fR و \fBh\fR عمل می‌کند.
.Sp
این گزینه به مقدار تنظیم‌شده برای \fBforce_original_aspect_ratio\fR احترام می‌گذارد،
و تفکیک‌پذیری را متناسب با آن افزایش یا کاهش می‌دهد. نسبت ابعاد ویدیو
ممکن است اندکی دستخوش تغییر شود.
.Sp
این گزینه می‌تواند زمانی مفید باشد که نیاز دارید با استفاده از \fBforce_original_aspect_ratio\fR،
یک ویدیو درون یک تفکیک‌پذیری معین جا گیرد یا از آن فراتر رود، اما محدودیت‌های
انکودر روی بخش‌پذیری عرض یا ارتفاع نیز وجود دارد.
.IP \fBreset_sar\fR 4
.IX Item "reset_sar"
فعال‌سازی این گزینه منجر به ریست شدن SAR خروجی روی 1 می‌شود.
علاوه بر این، اگر کاربر مقیاس‌بندی متناسب را از طریق عبارت‌های عرض یا
ارتفاع درخواست کند، برای مثال \f(CW\*(C`w=\-4:h=360\*(C'\fR یا \f(CW\*(C`w=iw/2:h=\-1\*(C'\fR
یا با فعال کردن \f(CW\*(C`force_original_aspect_ratio\*(C'\fR، آن‌گاه DAR ورودی
در نظر گرفته شده و خروجی به گونه‌ای مقیاس‌بندی می‌شود که پیکسل‌های مربعی تولید کند.
پیش‌فرض false است.
.PP
مقادیر گزینه‌های \fBw\fR و \fBh\fR عبارت‌هایی
شامل ثوابت زیر هستند:
.IP \fIin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fIin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ورودی
.IP \fIiw\fR 4
.IX Item "iw"
.PD 0
.IP \fIih\fR 4
.IX Item "ih"
.PD
این موارد با \fIin_w\fR و \fIin_h\fR یکسان هستند.
.IP \fIout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fIout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع (مقیاس‌شده) خروجی
.IP \fIow\fR 4
.IX Item "ow"
.PD 0
.IP \fIoh\fR 4
.IX Item "oh"
.PD
این موارد با \fIout_w\fR و \fIout_h\fR یکسان هستند.
.IP \fIa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR
.IP \fIsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی
.IP \fIdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی. محاسبه‌شده از \f(CW\*(C`(iw / ih) * sar\*(C'\fR.
.IP \fIhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fIvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری رنگی افقی و عمودی ورودی. برای مثال برای
قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP \fIohsub\fR 4
.IX Item "ohsub"
.PD 0
.IP \fIovsub\fR 4
.IX Item "ovsub"
.PD
مقادیر زیرنمونه‌برداری رنگی افقی و عمودی خروجی. برای مثال برای
قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP \fIn\fR 4
.IX Item "n"
شماره (ترتیبی) فریم ورودی، شروع از 0.
تنها با \f(CW\*(C`eval=frame\*(C'\fR در دسترس است.
.IP \fIt\fR 4
.IX Item "t"
برچسب زمانی نمایش فریم ورودی، بیان‌شده به صورت تعداد
ثانیه‌ها. تنها با \f(CW\*(C`eval=frame\*(C'\fR در دسترس است.
.IP \fIpos\fR 4
.IX Item "pos"
موقعیت (آفست بایتی) فریم در استریم ورودی، یا NaN در صورتی که
این اطلاعات در دسترس نباشد و/یا بی‌معنی باشد (برای مثال در مورد ویدیوی ساختگی).
تنها با \f(CW\*(C`eval=frame\*(C'\fR در دسترس است.
منسوخ‌شده، استفاده نکنید.
.IP "\fIref_w, rw\fR" 4
.IX Item "ref_w, rw"
.PD 0
.IP "\fIref_h, rh\fR" 4
.IX Item "ref_h, rh"
.IP \fIref_a\fR 4
.IX Item "ref_a"
.IP "\fIref_dar, rdar\fR" 4
.IX Item "ref_dar, rdar"
.IP \fIref_n\fR 4
.IX Item "ref_n"
.IP \fIref_t\fR 4
.IX Item "ref_t"
.IP \fIref_pos\fR 4
.IX Item "ref_pos"
.PD
معادل موارد بالا، اما برای یک ورودی مرجع دوم. اگر هر یک از این
متغیرها وجود داشته باشند، این فیلتر دو ورودی را می‌پذیرد.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مقیاس‌بندی ویدیوی ورودی به اندازه 200x100
.Sp
.Vb 1
\&        scale=w=200:h=100
.Ve
.Sp
این معادل است با:
.Sp
.Vb 1
\&        scale=200:100
.Ve
.Sp
یا:
.Sp
.Vb 1
\&        scale=200x100
.Ve
.IP \(bu 4
مشخص کردن یک نام اختصاری برای اندازه خروجی:
.Sp
.Vb 1
\&        scale=qcif
.Ve
.Sp
که همچنین می‌تواند به صورت زیر نوشته شود:
.Sp
.Vb 1
\&        scale=size=qcif
.Ve
.IP \(bu 4
مقیاس‌بندی ورودی به 2 برابر:
.Sp
.Vb 1
\&        scale=w=2*iw:h=2*ih
.Ve
.IP \(bu 4
مورد بالا همانند این است:
.Sp
.Vb 1
\&        scale=2*in_w:2*in_h
.Ve
.IP \(bu 4
مقیاس‌بندی ورودی به 2 برابر با تحمیل مقیاس‌بندی درهم‌بافته:
.Sp
.Vb 1
\&        scale=2*iw:2*ih:interl=1
.Ve
.IP \(bu 4
مقیاس‌بندی ورودی به نصف اندازه:
.Sp
.Vb 1
\&        scale=w=iw/2:h=ih/2
.Ve
.IP \(bu 4
افزایش عرض، و تنظیم ارتفاع به همان اندازه:
.Sp
.Vb 1
\&        scale=3/2*iw:ow
.Ve
.IP \(bu 4
تطابق با تناسب یونانی:
.Sp
.Vb 2
\&        scale=iw:1/PHI*iw
\&        scale=ih*PHI:ih
.Ve
.IP \(bu 4
افزایش ارتفاع، و تنظیم عرض به 3/2 ارتفاع:
.Sp
.Vb 1
\&        scale=w=3/2*oh:h=3/5*ih
.Ve
.IP \(bu 4
افزایش اندازه، به طوری که اندازه مضربی از مقادیر زیرنمونه‌برداری
رنگی باشد:
.Sp
.Vb 1
\&        scale="trunc(3/2*iw/hsub)*hsub:trunc(3/2*ih/vsub)*vsub"
.Ve
.IP \(bu 4
افزایش عرض به حداکثر 500 پیکسل،
همراه با حفظ همان نسبت ابعاد ورودی:
.Sp
.Vb 1
\&        scale=w=\*(Aqmin(500\e, iw*3/2):h=\-1\*(Aq
.Ve
.IP \(bu 4
مربعی کردن پیکسل‌ها با ترکیب scale و setsar:
.Sp
.Vb 1
\&        scale=\*(Aqtrunc(ih*dar):ih\*(Aq,setsar=1/1
.Ve
.IP \(bu 4
مربعی کردن پیکسل‌ها با استفاده از reset_sar،
همراه با اطمینان از اینکه تفکیک‌پذیری حاصل زوج باشد (مورد نیاز توسط برخی کُدک‌ها):
.Sp
.Vb 1
\&        scale=\*(Aq\-2:ih\-mod(ih,2):reset_sar=1\*(Aq
.Ve
.IP \(bu 4
مقیاس‌بندی دقیق به هدف، اما ریست کردن SAR روی 1:
.Sp
.Vb 1
\&        scale=\*(Aq400:300:reset_sar=1\*(Aq
.Ve
.IP \(bu 4
مقیاس‌بندی به ابعاد زوج که درون 400x300 جا گیرند، با حفظ SAR ورودی:
.Sp
.Vb 1
\&        scale=\*(Aq400:300:force_original_aspect_ratio=decrease:force_divisible_by=2\*(Aq
.Ve
.IP \(bu 4
مقیاس‌بندی برای تولید پیکسل‌های مربعی با ابعاد زوج که درون 400x300 جا گیرند:
.Sp
.Vb 1
\&        scale=\*(Aq400:300:force_original_aspect_ratio=decrease:force_divisible_by=2:reset_sar=1\*(Aq
.Ve
.IP \(bu 4
مقیاس‌بندی یک استریم زیرنویس (sub) برای مطابقت با اندازه ویدیوی اصلی (main) پیش
از همپوشانی. ("scale2ref")
.Sp
.Vb 1
\&        \*(Aq[main]split[a][b]; [ref][a]scale=rw:rh[c]; [b][c]overlay\*(Aq
.Ve
.IP \(bu 4
مقیاس‌بندی یک لوگو به 1/10 ارتفاع ویدیو، ضمن حفظ
نسبت ابعاد نمایش آن.
.Sp
.Vb 1
\&        [logo\-in][video\-in]scale=w=oh*dar:h=rh/10[logo\-out]
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی.
این دستور همان نحو گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت تعیین‌شده نامعتبر باشد، روی مقدار جاری خود باقی
می‌ماند.
.SS scharr
.IX Subsection "scharr"
اعمال عملگر شار (scharr operator) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که پردازش خواهند شد، صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمامی صفحات پردازش خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلترشده ضرب خواهد شد.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلترشده اضافه خواهد شد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS scroll
.IX Subsection "scroll"
پیمایش (اسکرول) افقی و/یا عمودی ویدیوی ورودی با سرعت ثابت.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBhorizontal, h\fR" 4
.IX Item "horizontal, h"
تنظیم سرعت پیمایش افقی. پیش‌فرض 0 است. محدوده مجاز از \-1 تا 1 است.
مقادیر منفی جهت پیمایش را تغییر می‌دهند.
.IP "\fBvertical, v\fR" 4
.IX Item "vertical, v"
تنظیم سرعت پیمایش عمودی. پیش‌فرض 0 است. محدوده مجاز از \-1 تا 1 است.
مقادیر منفی جهت پیمایش را تغییر می‌دهند.
.IP \fBhpos\fR 4
.IX Item "hpos"
تنظیم موقعیت اولیه پیمایش افقی. پیش‌فرض 0 است. محدوده مجاز از 0 تا 1 است.
.IP \fBvpos\fR 4
.IX Item "vpos"
تنظیم موقعیت اولیه پیمایش عمودی. پیش‌فرض 0 است. محدوده مجاز از 0 تا 1 است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از \fBدستورات\fR زیر پشتیبانی می‌کند:
.IP "\fBhorizontal, h\fR" 4
.IX Item "horizontal, h"
تنظیم سرعت پیمایش افقی.
.IP "\fBvertical, v\fR" 4
.IX Item "vertical, v"
تنظیم سرعت پیمایش عمودی.
.SS scdet
.IX Subsection "scdet"
تشخیص تغییر صحنه در ویدیو.
.PP
این فیلتر متاداده فریم را با mafd بین فریم و امتیاز صحنه تنظیم کرده،
و فریم را به فیلتر بعدی ارسال می‌کند تا بتوانند از این متاداده برای
تشخیص تغییر صحنه یا موارد دیگر استفاده کنند.
.PP
علاوه بر این، هنگامی که این فیلتر تغییر صحنه را با \fBthreshold\fR تشخیص دهد،
پیامی را ثبت کرده و متاداده فریم را تنظیم می‌کند.
.PP
کلیدهای متاداده \f(CW\*(C`lavfi.scd.mafd\*(C'\fR با mafd برای هر فریم تنظیم می‌شوند.
.PP
کلیدهای متاداده \f(CW\*(C`lavfi.scd.score\*(C'\fR با امتیاز تغییر صحنه برای هر فریم
جهت تشخیص تغییر صحنه تنظیم می‌شوند.
.PP
کلیدهای متاداده \f(CW\*(C`lavfi.scd.time\*(C'\fR با زمان فریم فیلترشده جاری که
تغییر صحنه را با \fBthreshold\fR تشخیص می‌دهد تنظیم می‌شوند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBthreshold, t\fR" 4
.IX Item "threshold, t"
تنظیم آستانه تشخیص تغییر صحنه به صورت درصدی از حداکثر تغییر. مقادیر
مناسب در محدوده \f(CW\*(C`[8.0, 14.0]\*(C'\fR هستند. محدوده برای \fBthreshold\fR
برابر \f(CW\*(C`[0., 100.]\*(C'\fR است.
.Sp
مقدار پیش‌فرض \f(CW10.\fR است.
.IP "\fBsc_pass, s\fR" 4
.IX Item "sc_pass, s"
تنظیم پرچم برای عبور دادن فریم‌های تغییر صحنه به فیلتر بعدی. مقدار پیش‌فرض \f(CW0\fR است.
اگر می‌خواهید تنها اسنپ‌شات فریم‌های تغییر صحنه را دریافت کنید، می‌توانید آن را فعال نمایید.
.SS selectivecolor
.IX Subsection "selectivecolor"
تنظیم فیروزه‌ای، ارغوانی، زرد و سیاه (CMYK) برای محدوده‌های خاصی از رنگ‌ها (مانند
"reds"، "yellows"، "greens"، "cyans" و ...). محدوده تنظیم توسط «خلوص»
رنگ (یعنی اینکه از پیش چقدر اشباع شده است) تعریف می‌شود.
.PP
این فیلتر مشابه ابزار Selective Color در ادوبی فتوشاپ است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcorrection_method\fR 4
.IX Item "correction_method"
انتخاب روش اصلاح رنگ.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBabsolute\fR 4
.IX Item "absolute"
تنظیمات مشخص‌شده عیناً اعمال می‌شوند (به مقدار مؤلفه پیکسل اصلی اضافه/کم
می‌شوند).
.IP \fBrelative\fR 4
.IX Item "relative"
تنظیمات مشخص‌شده نسبت به مقدار مؤلفه اصلی هستند.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`absolute\*(C'\fR است.
.RE
.IP \fBreds\fR 4
.IX Item "reds"
تنظیمات برای پیکسل‌های قرمز (پیکسل‌هایی که مؤلفه قرمز در آنها بیشترین است)
.IP \fByellows\fR 4
.IX Item "yellows"
تنظیمات برای پیکسل‌های زرد (پیکسل‌هایی که مؤلفه آبی در آنها کمترین است)
.IP \fBgreens\fR 4
.IX Item "greens"
تنظیمات برای پیکسل‌های سبز (پیکسل‌هایی که مؤلفه سبز در آنها بیشترین است)
.IP \fBcyans\fR 4
.IX Item "cyans"
تنظیمات برای پیکسل‌های فیروزه‌ای (پیکسل‌هایی که مؤلفه قرمز در آنها کمترین است)
.IP \fBblues\fR 4
.IX Item "blues"
تنظیمات برای پیکسل‌های آبی (پیکسل‌هایی که مؤلفه آبی در آنها بیشترین است)
.IP \fBmagentas\fR 4
.IX Item "magentas"
تنظیمات برای پیکسل‌های ارغوانی (پیکسل‌هایی که مؤلفه سبز در آنها کمترین است)
.IP \fBwhites\fR 4
.IX Item "whites"
تنظیمات برای پیکسل‌های سفید (پیکسل‌هایی که تمامی مؤلفه‌ها در آنها بیشتر از 128 است)
.IP \fBneutrals\fR 4
.IX Item "neutrals"
تنظیمات برای تمامی پیکسل‌ها به جز سیاه خالص و سفید خالص
.IP \fBblacks\fR 4
.IX Item "blacks"
تنظیمات برای پیکسل‌های سیاه (پیکسل‌هایی که تمامی مؤلفه‌ها در آنها کمتر از 128 است)
.IP \fBpsfile\fR 4
.IX Item "psfile"
تعیین یک پرونده selective color فتوشاپ (\f(CW\*(C`.asv\*(C'\fR) برای وارد کردن تنظیمات از آن.
.PP
تمامی تنظیمات (\fBreds\fR، \fByellows\fR، ...) تا ۴ مقدار اعشاری
جداشده با فاصله را در محدوده [\-1,1] می‌پذیرند،
که به ترتیب برای تنظیم مقدار فیروزه‌ای، ارغوانی، زرد و سیاه برای پیکسل‌های
محدوده خود به کار می‌روند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
افزایش ۵۰ درصدی فیروزه‌ای و کاهش ۳۳ درصدی زرد در تمامی نواحی سبز، و
افزایش ۲۷ درصدی ارغوانی در نواحی آبی:
.Sp
.Vb 1
\&        selectivecolor=greens=.5 0 \-.33 0:blues=0 .27
.Ve
.IP \(bu 4
استفاده از یک پیش‌تنظیم selective color فتوشاپ:
.Sp
.Vb 1
\&        selectivecolor=psfile=MySelectiveColorPresets/Misty.asv
.Ve
.SS separatefields
.IX Subsection "separatefields"
فیلتر \f(CW\*(C`separatefields\*(C'\fR یک ورودی ویدیویی مبتنی بر فریم را دریافت کرده و هر
فریم را به فیلدهای تشکیل‌دهنده آن تقسیم می‌کند، که کلیپی جدید با نصف ارتفاع،
دو برابر نرخ فریم و دو برابر تعداد فریم تولید می‌نماید.
.PP
این فیلتر از اطلاعات غلبه فیلد در فریم استفاده می‌کند تا تصمیم بگیرد کدام فیلد
از هر جفت فیلد ابتدا در خروجی قرار گیرد.
اگر اشتباه عمل کرد، پیش از فیلتر \f(CW\*(C`separatefields\*(C'\fR از فیلتر \fBsetfield\fR استفاده کنید.
.SS "setdar, setsar"
.IX Subsection "setdar, setsar"
فیلتر \f(CW\*(C`setdar\*(C'\fR نسبت ابعاد نمایش (DAR) را برای ویدیوی
خروجی فیلتر تنظیم می‌کند.
.PP
این کار با تغییر دادن نسبت ابعاد نمونه (معروف به پیکسل) مشخص‌شده،
مطابق با معادله زیر انجام می‌شود:
.PP
.Vb 1
\&        <DAR> = <HORIZONTAL_RESOLUTION> / <VERTICAL_RESOLUTION> * <SAR>
.Ve
.PP
به یاد داشته باشید که فیلتر \f(CW\*(C`setdar\*(C'\fR ابعاد پیکسلی فریم ویدیو
را تغییر نمی‌دهد. همچنین، نسبت ابعاد نمایش تنظیم‌شده توسط این فیلتر ممکن است
توسط فیلترهای بعدی در زنجیره فیلتر تغییر کند، برای مثال در صورت تغییر مقیاس
یا اگر فیلتر دیگری از "setdar" یا "setsar" اعمال شود.
.PP
فیلتر \f(CW\*(C`setsar\*(C'\fR نسبت ابعاد نمونه (معروف به پیکسل) را برای
ویدیوی خروجی فیلتر تنظیم می‌کند.
.PP
توجه داشته باشید که در نتیجه اعمال این فیلتر، نسبت ابعاد نمایش خروجی
مطابق با معادله فوق تغییر خواهد کرد.
.PP
به یاد داشته باشید که نسبت ابعاد نمونه تنظیم‌شده توسط فیلتر \f(CW\*(C`setsar\*(C'\fR
ممکن است توسط فیلترهای بعدی در زنجیره فیلتر تغییر کند، برای مثال اگر فیلتر دیگری
از "setsar" یا "setdar" اعمال شود.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.ie n .IP "\fBr, ratio, dar (\fR\fB""setdar""\fR\fB only), sar (\fR\fB""setsar""\fR\fB only)\fR" 4
.el .IP "\fBr, ratio, dar (\fR\f(CBsetdar\fR\fB only), sar (\fR\f(CBsetsar\fR\fB only)\fR" 4
.IX Item "r, ratio, dar (setdar only), sar (setsar only)"
تنظیم نسبت ابعاد مورد استفاده توسط فیلتر.
.Sp
پارامتر می‌تواند یک رشته عدد اعشاری، یا یک عبارت باشد. اگر پارامتر
مشخص نشود، مقدار "0" در نظر گرفته می‌شود، به این معنی که همان مقدار
ورودی استفاده می‌شود.
.IP \fBmax\fR 4
.IX Item "max"
تنظیم حداکثر مقدار عدد صحیح برای استفاده در بیان صورت و
مخرج هنگام کاهش نسبت ابعاد بیان‌شده به یک کسر گویا.
مقدار پیش‌فرض \f(CW100\fR است.
.PP
پارامتر \fIsar\fR عبارتی شامل ثوابت زیر است:
.IP "\fBw, h\fR" 4
.IX Item "w, h"
عرض و ارتفاع ورودی.
.IP \fBa\fR 4
.IX Item "a"
همانند \fIw\fR / \fIh\fR.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی.
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی. همانند
(\fIw\fR / \fIh\fR) * \fIsar\fR است.
.IP "\fBhsub, vsub\fR" 4
.IX Item "hsub, vsub"
مقادیر زیرنمونه‌برداری رنگی افقی و عمودی. برای مثال، برای
قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای تغییر نسبت ابعاد نمایش به 16:9، یکی از موارد زیر را مشخص کنید:
.Sp
.Vb 2
\&        setdar=dar=1.77777
\&        setdar=dar=16/9
.Ve
.IP \(bu 4
برای تغییر نسبت ابعاد نمونه به 10:11، مشخص کنید:
.Sp
.Vb 1
\&        setsar=sar=10/11
.Ve
.IP \(bu 4
برای تنظیم نسبت ابعاد نمایش 16:9، و تعیین حداکثر مقدار عدد صحیح
1000 در ساده‌سازی نسبت ابعاد، از این دستور استفاده کنید:
.Sp
.Vb 1
\&        setdar=ratio=16/9:max=1000
.Ve
.SS setfield
.IX Subsection "setfield"
تحمیل فیلد برای فریم ویدیوی خروجی.
.PP
فیلتر \f(CW\*(C`setfield\*(C'\fR فیلد نوع درهم‌بافی را برای فریم‌های
خروجی نشانه‌گذاری می‌کند. این فیلتر فریم ورودی را تغییر نمی‌دهد، بلکه تنها
ویژگی متناظر را تنظیم می‌کند، که بر نحوه رفتار فیلترهای بعدی (مانند
\&\f(CW\*(C`fieldorder\*(C'\fR یا \f(CW\*(C`yadif\*(C'\fR) با فریم تأثیر می‌گذارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی فیلد.
.IP \fBbff\fR 4
.IX Item "bff"
نشانه‌گذاری فریم به عنوان فیلد پایینی اول (bottom\-field\-first).
.IP \fBtff\fR 4
.IX Item "tff"
نشانه‌گذاری فریم به عنوان فیلد بالایی اول (top\-field\-first).
.IP \fBprog\fR 4
.IX Item "prog"
نشانه‌گذاری فریم به عنوان پروگرسیو.
.RE
.RS 4
.RE
.SS setparams
.IX Subsection "setparams"
تحمیل پارامتر فریم برای فریم ویدیوی خروجی.
.PP
فیلتر \f(CW\*(C`setparams\*(C'\fR درهم‌بافی و محدوده رنگ را برای فریم‌های
خروجی نشانه‌گذاری می‌کند. این فیلتر فریم ورودی را تغییر نمی‌دهد، بلکه تنها
ویژگی متناظر را تنظیم می‌کند، که بر نحوه برخورد فیلترها/انکودرها با
فریم تأثیر می‌گذارد.
.IP \fBfield_mode\fR 4
.IX Item "field_mode"
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی فیلد (پیش‌فرض).
.IP \fBbff\fR 4
.IX Item "bff"
نشانه‌گذاری فریم به عنوان فیلد پایینی اول (bottom\-field\-first).
.IP \fBtff\fR 4
.IX Item "tff"
نشانه‌گذاری فریم به عنوان فیلد بالایی اول (top\-field\-first).
.IP \fBprog\fR 4
.IX Item "prog"
نشانه‌گذاری فریم به عنوان پروگرسیو.
.RE
.RS 4
.RE
.IP \fBrange\fR 4
.IX Item "range"
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی محدوده رنگ (پیش‌فرض).
.IP "\fBunspecified, unknown\fR" 4
.IX Item "unspecified, unknown"
نشانه‌گذاری فریم به عنوان محدوده رنگ نامشخص.
.IP "\fBlimited, tv, mpeg\fR" 4
.IX Item "limited, tv, mpeg"
نشانه‌گذاری فریم به عنوان محدوده محدود (limited range).
.IP "\fBfull, pc, jpeg\fR" 4
.IX Item "full, pc, jpeg"
نشانه‌گذاری فریم به عنوان محدوده کامل (full range).
.RE
.RS 4
.RE
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
تنظیم رنگ‌های اصلی (primaries).
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی رنگ‌های اصلی (پیش‌فرض).
.IP \fBbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fBunknown\fR 4
.IX Item "unknown"
.IP \fBbt470m\fR 4
.IX Item "bt470m"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
.IP \fBfilm\fR 4
.IX Item "film"
.IP \fBbt2020\fR 4
.IX Item "bt2020"
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
.IP \fBjedec\-p22\fR 4
.IX Item "jedec-p22"
.PD
.RE
.RS 4
.RE
.IP \fBcolor_trc\fR 4
.IX Item "color_trc"
تنظیم تابع انتقال رنگ (TRC).
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی TRC رنگ (پیش‌فرض).
.IP \fBbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fBunknown\fR 4
.IX Item "unknown"
.IP \fBbt470m\fR 4
.IX Item "bt470m"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
.IP \fBlinear\fR 4
.IX Item "linear"
.IP \fBlog100\fR 4
.IX Item "log100"
.IP \fBlog316\fR 4
.IX Item "log316"
.IP \fBiec61966\-2\-4\fR 4
.IX Item "iec61966-2-4"
.IP \fBbt1361e\fR 4
.IX Item "bt1361e"
.IP \fBiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
.IP \fBbt2020\-10\fR 4
.IX Item "bt2020-10"
.IP \fBbt2020\-12\fR 4
.IX Item "bt2020-12"
.IP \fBsmpte2084\fR 4
.IX Item "smpte2084"
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
.IP \fBarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
.PD
.RE
.RS 4
.RE
.IP \fBcolorspace\fR 4
.IX Item "colorspace"
تنظیم فضای رنگی.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی فضای رنگی (پیش‌فرض).
.IP \fBgbr\fR 4
.IX Item "gbr"
.PD 0
.IP \fBbt709\fR 4
.IX Item "bt709"
.IP \fBunknown\fR 4
.IX Item "unknown"
.IP \fBfcc\fR 4
.IX Item "fcc"
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
.IP \fBycgco\fR 4
.IX Item "ycgco"
.IP \fBbt2020nc\fR 4
.IX Item "bt2020nc"
.IP \fBbt2020c\fR 4
.IX Item "bt2020c"
.IP \fBsmpte2085\fR 4
.IX Item "smpte2085"
.IP \fBchroma\-derived\-nc\fR 4
.IX Item "chroma-derived-nc"
.IP \fBchroma\-derived\-c\fR 4
.IX Item "chroma-derived-c"
.IP \fBictcp\fR 4
.IX Item "ictcp"
.PD
.RE
.RS 4
.RE
.IP \fBchroma_location\fR 4
.IX Item "chroma_location"
تنظیم موقعیت مکانی نمونه کروما.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان موقعیت کروما (پیش‌فرض).
.IP "\fBunspecified, unknown\fR" 4
.IX Item "unspecified, unknown"
.PD 0
.IP \fBleft\fR 4
.IX Item "left"
.IP \fBcenter\fR 4
.IX Item "center"
.IP \fBtopleft\fR 4
.IX Item "topleft"
.IP \fBtop\fR 4
.IX Item "top"
.IP \fBbottomleft\fR 4
.IX Item "bottomleft"
.IP \fBbottom\fR 4
.IX Item "bottom"
.PD
.RE
.RS 4
.RE
.IP \fBalpha_mode\fR 4
.IX Item "alpha_mode"
تنظیم حالت آلفا.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان حالت آلفا (پیش‌فرض).
.IP "\fBunspecified, unknown\fR" 4
.IX Item "unspecified, unknown"
.PD 0
.IP \fBpremultiplied\fR 4
.IX Item "premultiplied"
.IP \fBstraight\fR 4
.IX Item "straight"
.PD
.RE
.RS 4
.RE
.SS shear
.IX Subsection "shear"
اعمال تبدیل برشی (shear transform) بر روی ویدیوی ورودی.
.PP
این فیلتر از گزینه‌های زیر پشتیبانی می‌کند:
.IP \fBshx\fR 4
.IX Item "shx"
ضریب برش در راستای محور X. مقدار پیش‌فرض 0 است.
محدوده مجاز از \-2 تا 2 است.
.IP \fBshy\fR 4
.IX Item "shy"
ضریب برش در راستای محور Y. مقدار پیش‌فرض 0 است.
محدوده مجاز از \-2 تا 2 است.
.IP "\fBfillcolor, c\fR" 4
.IX Item "fillcolor, c"
تنظیم رنگ مورد استفاده برای پر کردن ناحیه خروجی که توسط ویدیوی
تبدیل‌یافته پوشش داده نمی‌شود. برای نحو کلی این گزینه،
\fBبخش "Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
اگر مقدار ویژه "none" انتخاب شود، هیچ پس‌زمینه‌ای چاپ نمی‌شود
(برای مثال در حالتی که پس‌زمینه هرگز نشان داده نمی‌شود مفید است).
.Sp
مقدار پیش‌فرض "black" است.
.IP \fBinterp\fR 4
.IX Item "interp"
تنظیم نوع درونیابی. می‌تواند \f(CW\*(C`bilinear\*(C'\fR یا \f(CW\*(C`nearest\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`bilinear\*(C'\fR است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS showinfo
.IX Subsection "showinfo"
نمایش یک خط حاوی اطلاعات گوناگون برای هر فریم ویدیوی ورودی.
ویدیوی ورودی تغییر نمی‌کند.
.PP
این فیلتر از گزینه‌های زیر پشتیبانی می‌کند:
.IP \fBchecksum\fR 4
.IX Item "checksum"
محاسبه چکسام (checksum) هر صفحه. به‌طور پیش‌فرض فعال است.
.IP \fBudu_sei_as_ascii\fR 4
.IX Item "udu_sei_as_ascii"
تلاش برای چاپ داده‌های کاربر در SEI ثبت‌نشده به صورت نویسه اسکی در صورت امکان،
و در غیر این صورت در قالب هگز.
.PP
خط نشان‌داده‌شده شامل دنباله‌ای از جفت‌های کلید/مقدار به فرم
\&\fIkey\fR:\fIvalue\fR است.
.PP
مقادیر زیر در خروجی نشان داده می‌شوند:
.IP \fBn\fR 4
.IX Item "n"
شماره (ترتیبی) فریم ورودی، شروع از 0.
.IP \fBpts\fR 4
.IX Item "pts"
برچسب زمانی نمایش (PTS) فریم ورودی، بیان‌شده بر حسب تعداد
واحدهای پایه زمانی. واحد پایه زمانی به پد ورودی فیلتر بستگی دارد.
.IP \fBpts_time\fR 4
.IX Item "pts_time"
برچسب زمانی نمایش فریم ورودی، بیان‌شده بر حسب ثانیه.
.IP \fBfmt\fR 4
.IX Item "fmt"
نام قالب پیکسل.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه فریم ورودی، بیان‌شده به فرم
\&\fInum\fR/\fIden\fR.
.IP \fBs\fR 4
.IX Item "s"
اندازه فریم ورودی. برای نحو این گزینه،
\fBبخش "Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBi\fR 4
.IX Item "i"
نوع حالت درهم‌بافته ("P" برای "پروگرسیو"، "T" برای فیلد بالایی اول، "B"
برای فیلد پایینی اول).
.IP \fBiskey\fR 4
.IX Item "iskey"
این مقدار در صورتی که فریم یک فریم کلیدی باشد 1، و در غیر این صورت 0 است.
.IP \fBtype\fR 4
.IX Item "type"
نوع تصویر فریم ورودی ("I" برای فریم نوع I، "P" برای
فریم نوع P، "B" برای فریم نوع B، یا "?" برای یک نوع ناشناخته).
همچنین به مستندات شمارش \f(CW\*(C`AVPictureType\*(C'\fR و
تابع \f(CW\*(C`av_get_picture_type_char\*(C'\fR تعریف‌شده در
\&\fIlibavutil/avutil.h\fR مراجعه کنید.
.IP \fBchecksum\fR 4
.IX Item "checksum"
چکسام Adler\-32 (چاپ‌شده در مبنای شانزده) از تمامی صفحات فریم ورودی.
.IP \fBplane_checksum\fR 4
.IX Item "plane_checksum"
چکسام Adler\-32 (چاپ‌شده در مبنای شانزده) از هر صفحه فریم ورودی،
بیان‌شده به فرم "[\fIc0\fR \fIc1\fR \fIc2\fR \fIc3\fR]".
.IP \fBmean\fR 4
.IX Item "mean"
مقدار میانگین پیکسل‌ها در هر صفحه فریم ورودی، بیان‌شده به فرم
"[\fImean0\fR \fImean1\fR \fImean2\fR \fImean3\fR]".
.IP \fBstdev\fR 4
.IX Item "stdev"
انحراف معیار مقادیر پیکسل در هر صفحه فریم ورودی، بیان‌شده
به فرم "[\fIstdev0\fR \fIstdev1\fR \fIstdev2\fR \fIstdev3\fR]".
.SS showpalette
.IX Subsection "showpalette"
نمایش پالت ۲۵۶ رنگ هر فریم. این فیلتر تنها برای فریم‌های دارای قالب
پیکسلی \fIpal8\fR مرتبط است.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBs\fR 4
.IX Item "s"
تنظیم اندازه کادر مورد استفاده برای نمایش یک مدخل رنگ پالت. پیش‌فرض
\&\f(CW30\fR است (برای یک کادر پیکسلی \f(CW\*(C`30x30\*(C'\fR).
.SS shuffleframes
.IX Subsection "shuffleframes"
تغییر ترتیب و/یا تکثیر و/یا حذف فریم‌های ویدیو.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmapping\fR 4
.IX Item "mapping"
تنظیم شاخص‌های مقصد فریم‌های ورودی.
این یک فهرست جداشده با فاصله یا \*(Aq|\*(Aq از شاخص‌ها است که فریم‌های ورودی را به فریم‌های
خروجی نگاشت می‌کند. تعداد شاخص‌ها همچنین حداکثر مقداری را که هر شاخص می‌تواند داشته باشد مشخص می‌کند.
شاخص \*(Aq\-1\*(Aq معنای ویژه‌ای دارد و آن حذف فریم است.
.PP
فریم اول دارای شاخص 0 است. مقدار پیش‌فرض حفظ ورودی بدون تغییر است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
جابه‌جا کردن فریم دوم و سوم از هر سه فریم ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-vf "shuffleframes=0 2 1" OUTPUT
.Ve
.IP \(bu 4
جابه‌جا کردن فریم دهم و اول از هر ده فریم ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-vf "shuffleframes=9 1 2 3 4 5 6 7 8 0" OUTPUT
.Ve
.SS shufflepixels
.IX Subsection "shufflepixels"
تغییر ترتیب پیکسل‌ها در فریم‌های ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBdirection, d\fR" 4
.IX Item "direction, d"
تنظیم جهت بازآرایی (shuffle). می‌تواند جهت مستقیم یا معکوس باشد.
جهت پیش‌فرض مستقیم است.
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت بازآرایی. می‌تواند حالت افقی، عمودی یا بلوکی باشد.
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم اندازه بلوک بازآرایی. در مورد حالت بازآرایی افقی تنها بخش عرض
اندازه استفاده می‌شود، و در مورد حالت بازآرایی عمودی تنها بخش ارتفاع
اندازه استفاده می‌شود.
.IP "\fBseed, s\fR" 4
.IX Item "seed, s"
تنظیم سید (seed) تصادفی مورد استفاده در بازآرایی پیکسل‌ها. عمدتاً برای این مفید است
که بتوان فرایند فیلتر را برای به دست آوردن ورودی اصلی معکوس کرد.
برای مثال، جهت معکوس کردن بازآرایی مستقیم باید از همان پارامترها
و دقیقاً همان سید استفاده کرده و جهت را روی معکوس (inverse) تنظیم کنید.
.SS shuffleplanes
.IX Subsection "shuffleplanes"
تغییر ترتیب و/یا تکثیر صفحات ویدیویی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmap0\fR 4
.IX Item "map0"
شاخص صفحه ورودی برای استفاده به عنوان اولین صفحه خروجی.
.IP \fBmap1\fR 4
.IX Item "map1"
شاخص صفحه ورودی برای استفاده به عنوان دومین صفحه خروجی.
.IP \fBmap2\fR 4
.IX Item "map2"
شاخص صفحه ورودی برای استفاده به عنوان سومین صفحه خروجی.
.IP \fBmap3\fR 4
.IX Item "map3"
شاخص صفحه ورودی برای استفاده به عنوان چهارمین صفحه خروجی.
.PP
صفحه اول دارای شاخص 0 است. مقدار پیش‌فرض حفظ ورودی بدون تغییر است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
جابه‌جا کردن صفحات دوم و سوم ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-vf shuffleplanes=0:2:1:3 OUTPUT
.Ve
.SS signalstats
.IX Subsection "signalstats"
ارزیابی معیارهای بصری گوناگون که به تعیین مشکلات مرتبط
با دیجیتالی کردن رسانه‌های ویدیویی آنالوگ کمک می‌کنند.
.PP
به‌طور پیش‌فرض این فیلتر این مقادیر متاداده را ثبت می‌کند:
.IP \fBYMIN\fR 4
.IX Item "YMIN"
نمایش حداقل مقدار Y موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBYLOW\fR 4
.IX Item "YLOW"
نمایش مقدار Y در صدک ۱۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBYAVG\fR 4
.IX Item "YAVG"
نمایش میانگین مقدار Y درون فریم ورودی. بیان‌شده در محدوده
[0\-255].
.IP \fBYHIGH\fR 4
.IX Item "YHIGH"
نمایش مقدار Y در صدک ۹۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBYMAX\fR 4
.IX Item "YMAX"
نمایش حداکثر مقدار Y موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBUMIN\fR 4
.IX Item "UMIN"
نمایش حداقل مقدار U موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBULOW\fR 4
.IX Item "ULOW"
نمایش مقدار U در صدک ۱۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBUAVG\fR 4
.IX Item "UAVG"
نمایش میانگین مقدار U درون فریم ورودی. بیان‌شده در محدوده
[0\-255].
.IP \fBUHIGH\fR 4
.IX Item "UHIGH"
نمایش مقدار U در صدک ۹۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBUMAX\fR 4
.IX Item "UMAX"
نمایش حداکثر مقدار U موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBVMIN\fR 4
.IX Item "VMIN"
نمایش حداقل مقدار V موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBVLOW\fR 4
.IX Item "VLOW"
نمایش مقدار V در صدک ۱۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBVAVG\fR 4
.IX Item "VAVG"
نمایش میانگین مقدار V درون فریم ورودی. بیان‌شده در محدوده
[0\-255].
.IP \fBVHIGH\fR 4
.IX Item "VHIGH"
نمایش مقدار V در صدک ۹۰٪ درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBVMAX\fR 4
.IX Item "VMAX"
نمایش حداکثر مقدار V موجود درون فریم ورودی. بیان‌شده در
محدوده [0\-255].
.IP \fBSATMIN\fR 4
.IX Item "SATMIN"
نمایش حداقل مقدار اشباع موجود درون فریم ورودی.
بیان‌شده در محدوده [0\-~181.02].
.IP \fBSATLOW\fR 4
.IX Item "SATLOW"
نمایش مقدار اشباع در صدک ۱۰٪ درون فریم ورودی.
بیان‌شده در محدوده [0\-~181.02].
.IP \fBSATAVG\fR 4
.IX Item "SATAVG"
نمایش میانگین مقدار اشباع درون فریم ورودی. بیان‌شده در محدوده
[0\-~181.02].
.IP \fBSATHIGH\fR 4
.IX Item "SATHIGH"
نمایش مقدار اشباع در صدک ۹۰٪ درون فریم ورودی.
بیان‌شده در محدوده [0\-~181.02].
.IP \fBSATMAX\fR 4
.IX Item "SATMAX"
نمایش حداکثر مقدار اشباع موجود درون فریم ورودی.
بیان‌شده در محدوده [0\-~181.02].
.IP \fBHUEMED\fR 4
.IX Item "HUEMED"
نمایش مقدار میانه برای فام درون فریم ورودی. بیان‌شده در محدوده
[0\-360].
.IP \fBHUEAVG\fR 4
.IX Item "HUEAVG"
نمایش مقدار میانگین برای فام درون فریم ورودی. بیان‌شده در محدوده
[0\-360].
.IP \fBYDIF\fR 4
.IX Item "YDIF"
نمایش میانگین اختلاف مقدار نمونه بین تمامی مقادیر صفحه Y
در فریم جاری و مقادیر متناظر فریم ورودی قبلی.
بیان‌شده در محدوده [0\-255].
.IP \fBUDIF\fR 4
.IX Item "UDIF"
نمایش میانگین اختلاف مقدار نمونه بین تمامی مقادیر صفحه U
در فریم جاری و مقادیر متناظر فریم ورودی قبلی.
بیان‌شده در محدوده [0\-255].
.IP \fBVDIF\fR 4
.IX Item "VDIF"
نمایش میانگین اختلاف مقدار نمونه بین تمامی مقادیر صفحه V
در فریم جاری و مقادیر متناظر فریم ورودی قبلی.
بیان‌شده در محدوده [0\-255].
.IP \fBYBITDEPTH\fR 4
.IX Item "YBITDEPTH"
نمایش عمق بیت صفحه Y در فریم جاری.
بیان‌شده در محدوده [0\-16].
.IP \fBUBITDEPTH\fR 4
.IX Item "UBITDEPTH"
نمایش عمق بیت صفحه U در فریم جاری.
بیان‌شده در محدوده [0\-16].
.IP \fBVBITDEPTH\fR 4
.IX Item "VBITDEPTH"
نمایش عمق بیت صفحه V در فریم جاری.
بیان‌شده در محدوده [0\-16].
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstat\fR 4
.IX Item "stat"
.PD 0
.IP \fBout\fR 4
.IX Item "out"
.PD
\&\fBstat\fR شکل اضافی تحلیل تصویر را مشخص می‌کند.
\&\fBout\fR ویدیو را با هایلایت کردن نوع مشخص‌شده از پیکسل‌ها خروجی می‌دهد.
.Sp
هر دو گزینه مقادیر زیر را می‌پذیرند:
.RS 4
.IP \fBtout\fR 4
.IX Item "tout"
شناسایی پیکسل‌های \fIپرت زمانی\fR (temporal outliers). یک \fIپرت زمانی\fR پیکسلی
است که برخلاف پیکسل‌های مجاور در همان فیلد است. نمونه‌هایی از پرت‌های زمانی
شامل نتایج افت ویدیو، گرفتگی هد، یا مشکلات ردیابی نوار است.
.IP \fBvrep\fR 4
.IX Item "vrep"
شناسایی \fIتکرار خط عمودی\fR. تکرار خط عمودی شامل
ردیف‌های مشابهی از پیکسل‌ها درون یک فریم است. در ویدیوی ذاتاً دیجیتال تکرار خط
عمودی رایج است، اما این الگو در ویدیوی دیجیتالی‌شده از یک منبع آنالوگ
نامعمول است. هنگامی که در ویدیوی حاصل از دیجیتالی کردن یک منبع آنالوگ
رخ می‌دهد، می‌تواند نشان‌دهنده پنهان‌سازی ناشی از جبران‌کننده افت سیگنال باشد.
.IP \fBbrng\fR 4
.IX Item "brng"
شناسایی پیکسل‌هایی که خارج از محدوده مجاز پخش قرار می‌گیرند.
.RE
.RS 4
.RE
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
تنظیم رنگ هایلایت برای گزینه \fBout\fR. رنگ پیش‌فرض
زرد است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
خروجی دادن داده‌های سنجه‌های مختلف ویدیو:
.Sp
.Vb 1
\&        ffprobe \-f lavfi movie=example.mov,signalstats="stat=tout+vrep+brng" \-show_frames
.Ve
.IP \(bu 4
خروجی دادن داده‌های خاص در مورد مقادیر حداقل و حداکثر صفحه Y به ازای هر فریم:
.Sp
.Vb 1
\&        ffprobe \-f lavfi movie=example.mov,signalstats \-show_entries frame_tags=lavfi.signalstats.YMAX,lavfi.signalstats.YMIN
.Ve
.IP \(bu 4
پخش ویدیو در حین هایلایت کردن پیکسل‌های خارج از محدوده پخش به رنگ قرمز.
.Sp
.Vb 1
\&        ffplay example.mov \-vf signalstats="out=brng:color=red"
.Ve
.IP \(bu 4
پخش ویدیو با متاداده signalstats رسم‌شده بر روی فریم.
.Sp
.Vb 1
\&        ffplay example.mov \-vf signalstats=stat=brng+vrep+tout,drawtext=fontfile=FreeSerif.ttf:textfile=signalstat_drawtext.txt
.Ve
.Sp
محتوای signalstat_drawtext.txt استفاده‌شده در دستور عبارت است از:
.Sp
.Vb 5
\&        time %{pts:hms}
\&        Y (%{metadata:lavfi.signalstats.YMIN}\-%{metadata:lavfi.signalstats.YMAX})
\&        U (%{metadata:lavfi.signalstats.UMIN}\-%{metadata:lavfi.signalstats.UMAX})
\&        V (%{metadata:lavfi.signalstats.VMIN}\-%{metadata:lavfi.signalstats.VMAX})
\&        saturation maximum: %{metadata:lavfi.signalstats.SATMAX}
.Ve
.SS signature
.IX Subsection "signature"
امضای ویدیویی (Video Signature) استاندارد MPEG\-7 را محاسبه می‌کند. این فیلتر می‌تواند بیش از یک ورودی را مدیریت کند. در این حالت تطابق میان ورودی‌ها نیز می‌تواند به صورت اضافی محاسبه شود. فیلتر همواره ورودی اول را بدون تغییر عبور می‌دهد. امضای هر استریم را می‌توان در یک پرونده نوشت.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdetectmode\fR 4
.IX Item "detectmode"
فعال یا غیرفعال کردن فرایند تطابق.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBoff\fR 4
.IX Item "off"
غیرفعال کردن محاسبه تطابق (پیش‌فرض).
.IP \fBfull\fR 4
.IX Item "full"
محاسبه تطابق برای تمام ویدیو و تعیین اینکه آیا کل ویدیو مطابقت دارد یا تنها بخش‌هایی از آن.
.IP \fBfast\fR 4
.IX Item "fast"
محاسبه فقط تا زمانی که یک تطابق پیدا شود یا ویدیو به پایان برسد. در برخی موارد باید سریع‌تر باشد.
.RE
.RS 4
.RE
.IP \fBnb_inputs\fR 4
.IX Item "nb_inputs"
تنظیم تعداد ورودی‌ها. مقدار گزینه باید یک عدد صحیح غیرمنفی باشد. مقدار پیش‌فرض 1 است.
.IP \fBfilename\fR 4
.IX Item "filename"
تنظیم مسیری که خروجی در آن نوشته می‌شود. اگر بیش از یک ورودی وجود داشته باشد، مسیر باید یک الگو (prototype) باشد، یعنی حاوی \f(CW%d\fR یا \f(CW%0nd\fR (که در آن n یک عدد صحیح مثبت است) باشد که با شماره ورودی جایگزین خواهد شد. اگر نام پرونده‌ای مشخص نشود، هیچ خروجی نوشته نخواهد شد. این حالت پیش‌فرض است.
.IP \fBformat\fR 4
.IX Item "format"
انتخاب قالب خروجی.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBbinary\fR 4
.IX Item "binary"
استفاده از بازنمایی دودویی مشخص‌شده (پیش‌فرض).
.IP \fBxml\fR 4
.IX Item "xml"
استفاده از بازنمایی xml مشخص‌شده.
.RE
.RS 4
.RE
.IP \fBth_d\fR 4
.IX Item "th_d"
تنظیم آستانه برای تشخیص یک کلمه به عنوان مشابه. مقدار گزینه باید یک عدد صحیح بزرگ‌تر از صفر باشد. مقدار پیش‌فرض 9000 است.
.IP \fBth_dc\fR 4
.IX Item "th_dc"
تنظیم آستانه برای تشخیص تمام کلمات به عنوان مشابه. مقدار گزینه باید یک عدد صحیح بزرگ‌تر از صفر باشد. مقدار پیش‌فرض 60000 است.
.IP \fBth_xh\fR 4
.IX Item "th_xh"
تنظیم آستانه برای تشخیص فریم‌ها به عنوان مشابه. مقدار گزینه باید یک عدد صحیح بزرگ‌تر از صفر باشد. مقدار پیش‌فرض 116 است.
.IP \fBth_di\fR 4
.IX Item "th_di"
تنظیم حداقل طول یک توالی بر حسب فریم برای شناسایی آن به عنوان توالی منطبق. مقدار گزینه باید یک مقدار صحیح غیرمنفی باشد. مقدار پیش‌فرض 0 است.
.IP \fBth_it\fR 4
.IX Item "th_it"
تنظیم حداقل نسبت فریم‌های منطبق به کل فریم‌ها. مقدار گزینه باید یک مقدار اعشاری با دقت مضاعف (double) بین 0 و 1 باشد. مقدار پیش‌فرض 0.5 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای محاسبه امضای یک ویدیوی ورودی و ذخیره آن در signature.bin:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-vf signature=filename=signature.bin \-map 0:v \-f null \-
.Ve
.IP \(bu 4
برای تشخیص اینکه آیا دو ویدیو مطابقت دارند یا خیر و ذخیره امضاها در قالب XML در signature0.xml و signature1.xml:
.Sp
.Vb 1
\&        ffmpeg \-i input1.mkv \-i input2.mkv \-filter_complex "[0:v][1:v] signature=nb_inputs=2:detectmode=full:format=xml:filename=signature%d.xml" \-map :v \-f null \-
.Ve
.SS siti
.IX Subsection "siti"
محاسبه امتیازهای اطلاعات مکانی (SI) و اطلاعات زمانی (TI) برای یک ویدیو، مطابق با تعریف توصیه‌نامه ITU\-T Rec. P.910 (11/21): روش‌های ارزیابی کیفی ذهنی ویدیو برای کاربردهای چندرسانه‌ای. فایل PDF در <\fBhttps://www.itu.int/rec/T\-REC\-P.910\-202111\-S/en\fR> در دسترس است. توجه داشته باشید که این یک پیاده‌سازی قدیمی است که مربوط به یک توصیه‌نامه منسوخ‌شده می‌باشد. برای آخرین نسخه به ITU\-T Rec. P.910 (07/22) در <\fBhttps://www.itu.int/rec/T\-REC\-P.910\-202207\-I/en\fR> مراجعه کنید.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBprint_summary\fR 4
.IX Item "print_summary"
اگر روی 1 تنظیم شود، آمارهای خلاصه در کنسول چاپ می‌شوند. پیش‌فرض 0 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
برای محاسبه معیارهای SI/TI و چاپ خلاصه:
.Sp
.Vb 1
\&        ffmpeg \-i input.mp4 \-vf siti=print_summary=1 \-f null \-
.Ve
.SS smartblur
.IX Subsection "smartblur"
تار کردن (بلور کردن) ویدیوی ورودی بدون تأثیر بر خطوط پیرامونی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
تنظیم شعاع روشنایی (luma). مقدار گزینه باید یک عدد اعشاری در محدوده [0.1,5.0] باشد که واریانس فیلتر گوسی مورد استفاده برای تار کردن تصویر را مشخص می‌کند (هرچه بزرگ‌تر باشد، کندتر خواهد بود). مقدار پیش‌فرض 1.0 است.
.IP "\fBluma_strength, ls\fR" 4
.IX Item "luma_strength, ls"
تنظیم شدت روشنایی (luma). مقدار گزینه باید یک عدد اعشاری در محدوده [\-1.0,1.0] باشد که میزان تاری را پیکربندی می‌کند. مقداری در بازه [0.0,1.0] تصویر را تار می‌کند، در حالی که مقداری در بازه [\-1.0,0.0] تصویر را شارپ (واضح) می‌کند. مقدار پیش‌فرض 1.0 است.
.IP "\fBluma_threshold, lt\fR" 4
.IX Item "luma_threshold, lt"
تنظیم آستانه روشنایی (luma) مورد استفاده به عنوان ضریبی برای تعیین اینکه آیا یک پیکسل باید تار شود یا خیر. مقدار گزینه باید یک عدد صحیح در محدوده [\-30,30] باشد. مقدار 0 تمام تصویر را فیلتر می‌کند، مقداری در بازه [0,30] نواحی تخت را فیلتر می‌کند و مقداری در بازه [\-30,0] لبه‌ها را فیلتر خواهد کرد. مقدار پیش‌فرض 0 است.
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
تنظیم شعاع رنگ (chroma). مقدار گزینه باید یک عدد اعشاری در محدوده [0.1,5.0] باشد که واریانس فیلتر گوسی مورد استفاده برای تار کردن تصویر را مشخص می‌کند (هرچه بزرگ‌تر باشد، کندتر خواهد بود). مقدار پیش‌فرض برابر با \fBluma_radius\fR است.
.IP "\fBchroma_strength, cs\fR" 4
.IX Item "chroma_strength, cs"
تنظیم شدت رنگ (chroma). مقدار گزینه باید یک عدد اعشاری در محدوده [\-1.0,1.0] باشد که تاری را پیکربندی می‌کند. مقداری در بازه [0.0,1.0] تصویر را تار می‌کند در حالی که مقداری در بازه [\-1.0,0.0] تصویر را شارپ می‌کند. مقدار پیش‌فرض برابر با \fBluma_strength\fR است.
.IP "\fBchroma_threshold, ct\fR" 4
.IX Item "chroma_threshold, ct"
تنظیم آستانه رنگ (chroma) مورد استفاده به عنوان ضریبی برای تعیین اینکه آیا یک پیکسل باید تار شود یا خیر. مقدار گزینه باید یک عدد صحیح در محدوده [\-30,30] باشد. مقدار 0 تمام تصویر را فیلتر می‌کند، مقداری در بازه [0,30] نواحی تخت را فیلتر می‌کند و مقداری در بازه [\-30,0] لبه‌ها را فیلتر می‌کند. مقدار پیش‌فرض برابر با \fBluma_threshold\fR است.
.IP "\fBalpha_radius, ar\fR" 4
.IX Item "alpha_radius, ar"
تنظیم شعاع آلفا. مقدار گزینه باید یک عدد اعشاری در محدوده [0.1,5.0] باشد که واریانس فیلتر گوسی مورد استفاده برای تار کردن تصویر را مشخص می‌کند (هرچه بزرگ‌تر باشد، کندتر خواهد بود). مقدار پیش‌فرض برابر با \fBluma_radius\fR است.
.IP "\fBalpha_strength, as\fR" 4
.IX Item "alpha_strength, as"
تنظیم شدت آلفا. مقدار گزینه باید یک عدد اعشاری در محدوده [\-1.0,1.0] باشد که تاری را پیکربندی می‌کند. مقداری در بازه [0.0,1.0] تصویر را تار می‌کند، در حالی که مقداری در بازه [\-1.0,0.0] تصویر را شارپ می‌کند. مقدار پیش‌فرض برابر با \fBluma_strength\fR است.
.IP "\fBalpha_threshold, at\fR" 4
.IX Item "alpha_threshold, at"
تنظیم آستانه آلفا مورد استفاده به عنوان ضریبی برای تعیین اینکه آیا یک پیکسل باید تار شود یا خیر. مقدار گزینه باید یک عدد صحیح در محدوده [\-30,30] باشد. مقدار 0 کل تصویر را فیلتر می‌کند، مقداری در بازه [0,30] نواحی تخت را فیلتر می‌کند و مقداری در بازه [\-30,0] لبه‌ها را فیلتر می‌کند. مقدار پیش‌فرض برابر با \fBluma_threshold\fR است.
.PP
اگر یکی از گزینه‌های chroma یا alpha صراحتاً تنظیم نشود، مقدار متناظر آن در luma تنظیم خواهد شد.
.SS sobel
.IX Subsection "sobel"
اعمال عملگر سوبل (sobel) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام صفحات (planes) پردازش خواهند شد؛ صفحات پردازش‌نشده کپی می‌شوند. با مقدار پیش‌فرض 0xf، تمام صفحات پردازش خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلترشده ضرب خواهد شد.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلترشده اضافه خواهد شد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمام گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS spp
.IX Subsection "spp"
اعمال یک فیلتر پس‌پردازش ساده که تصویر را در چندین شیفت (یا در صورت سطح کیفیت \fBquality\fR برابر با \f(CW6\fR، در تمام شیفت‌ها) فشرده و بازفشرده‌سازی می‌کند و نتایج را میانگین می‌گیرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBquality\fR 4
.IX Item "quality"
تنظیم کیفیت. این گزینه تعداد سطوح برای میانگین‌گیری را مشخص می‌کند. یک عدد صحیح در محدوده 0\-6 می‌پذیرد. در صورت تنظیم روی \f(CW0\fR، فیلتر هیچ اثری نخواهد داشت. مقدار \f(CW6\fR به معنای بالاترین کیفیت است. به ازای هر واحد افزایش در این مقدار، سرعت تقریباً به ضریب 2 کاهش می‌یابد. مقدار پیش‌فرض \f(CW3\fR است.
.IP \fBqp\fR 4
.IX Item "qp"
اجبار یک پارامتر کوانتیزاسیون (QP) ثابت. در صورت عدم تنظیم، فیلتر از QP استریم ویدیو (در صورت وجود) استفاده خواهد کرد.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت آستانه‌گذاری. حالت‌های موجود عبارتند از:
.RS 4
.IP \fBhard\fR 4
.IX Item "hard"
تنظیم آستانه‌گذاری سخت (پیش‌فرض).
.IP \fBsoft\fR 4
.IX Item "soft"
تنظیم آستانه‌گذاری نرم (اثر بهتر در حذف اثرات حلقه‌ای، اما احتمالاً تارتر).
.RE
.RS 4
.RE
.IP \fBuse_bframe_qp\fR 4
.IX Item "use_bframe_qp"
در صورت تنظیم روی \f(CW1\fR، استفاده از QP فریم‌های B را فعال می‌کند. استفاده از این گزینه ممکن است سبب سوسوزدن شود زیرا فریم‌های B معمولاً دارای QP بزرگ‌تری هستند. پیش‌فرض \f(CW0\fR (غیرفعال) است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBquality, level\fR" 4
.IX Item "quality, level"
تنظیم سطح کیفیت. مقدار \f(CW\*(C`max\*(C'\fR را می‌توان برای تنظیم حداکثر سطح، در حال حاضر \f(CW6\fR، استفاده کرد.
.SS sr
.IX Subsection "sr"
مقیاس‌بندی ورودی با اعمال یکی از روش‌های وضوح فوق‌العاده (super\-resolution) مبتنی بر شبکه‌های عصبی پیچشی (CNN). مدل‌های پشتیبانی‌شده:
.IP \(bu 4
مدل شبکه عصبی پیچشی با وضوح فوق‌العاده (SRCNN).
<\fBhttps://arxiv.org/abs/1501.00092\fR> را ببینید.
.IP \(bu 4
مدل شبکه عصبی پیچشی زیرپیکسلی کارآمد (ESPCN).
<\fBhttps://arxiv.org/abs/1609.05158\fR> را ببینید.
.PP
اسکریپت‌های آموزش و همچنین اسکریپت‌های ذخیره پرونده مدل (.pb) را می‌توان در
<\fBhttps://github.com/XueweiMeng/sr/tree/sr_dnn_native\fR> یافت. مخزن اصلی در
<\fBhttps://github.com/HighVoltageRocknRoll/sr.git\fR> قرار دارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdnn_backend\fR 4
.IX Item "dnn_backend"
تعیین اینکه از کدام بک‌اند DNN برای بارگذاری و اجرای مدل استفاده شود. این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtensorflow\fR 4
.IX Item "tensorflow"
بک‌اند TensorFlow. برای فعال کردن این بک‌اند باید کتابخانه TensorFlow for C را نصب کنید (به
<\fBhttps://www.tensorflow.org/install/lang_c\fR> مراجعه کنید) و FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libtensorflow\*(C'\fR پیکربندی نمایید.
.RE
.RS 4
.RE
.IP \fBmodel\fR 4
.IX Item "model"
تنظیم مسیر پرونده مدل که معماری شبکه و پارامترهای آن را مشخص می‌کند. توجه داشته باشید که بک‌اندهای مختلف از قالب‌های پرونده متفاوتی استفاده می‌کنند. بک‌اندهای TensorFlow و OpenVINO تنها می‌توانند پرونده‌های قالب مخصوص خود را بارگذاری کنند.
.IP \fBscale_factor\fR 4
.IX Item "scale_factor"
تنظیم ضریب مقیاس برای مدل SRCNN. مقادیر مجاز \f(CW2\fR، \f(CW3\fR و \f(CW4\fR هستند. مقدار پیش‌فرض \f(CW2\fR است. ضریب مقیاس برای مدل SRCNN ضروری است، زیرا ورودی را که با استفاده از مقیاس‌بندی دو‌مکعبی (bicubic) با ضریب مقیاس مناسب بزرگ شده است می‌پذیرد.
.PP
برای دسترسی به قابلیت‌های کامل (مانند اجرای ناهمگام)، لطفاً از فیلتر \fBdnn_processing\fR استفاده کنید.
.SS sr_amf
.IX Subsection "sr_amf"
افزایش مقیاس (بزرگ‌نمایی اندازه) برای ویدیوی ورودی با استفاده از کتابخانه چارچوب رسانه‌ای پیشرفته AMD (AMF) جهت شتاب‌دهی سخت‌افزاری. استفاده از الگوریتم‌های پیشرفته برای بزرگ‌نمایی با کیفیت خروجی بالاتر. تنظیم پهنا و ارتفاع خروجی به همان روش فیلتر \fBscale\fR کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض ابعاد ورودی است.
.Sp
همان عبارت‌های فیلتر \fBscale\fR را مجاز می‌داند.
.IP \fBalgorithm\fR 4
.IX Item "algorithm"
تنظیم الگوریتم مورد استفاده برای مقیاس‌بندی:
.RS 4
.IP \fIbilinear\fR 4
.IX Item "bilinear"
دو‌خطی (Bilinear)
.IP \fIbicubic\fR 4
.IX Item "bicubic"
دو‌مکعبی (Bicubic)
.IP \fIsr1\-0\fR 4
.IX Item "sr1-0"
ویدیوی SR1.0
این مقدار پیش‌فرض است
.IP \fIpoint\fR 4
.IX Item "point"
نقطه‌ای (Point)
.IP \fIsr1\-1\fR 4
.IX Item "sr1-1"
ویدیوی SR1.1
.RE
.RS 4
.RE
.IP \fBsharpness\fR 4
.IX Item "sharpness"
کنترل شارپ‌سازی مقیاس‌بند باکیفیت (hq scaler). این مقدار یک عدد اعشاری در محدوده [0.0, 2.0] است.
.IP \fBformat\fR 4
.IX Item "format"
کنترل قالب پیکسلی خروجی. به‌طور پیش‌فرض، یا در صورت عدم تعیین، از قالب پیکسلی ورودی استفاده می‌شود.
.IP \fBkeep\-ratio\fR 4
.IX Item "keep-ratio"
اجبار مقیاس‌بند به حفظ نسبت ابعاد تصویر ورودی هنگامی که اندازه خروجی دارای نسبت ابعاد متفاوتی است. مقدار پیش‌فرض false است.
.IP \fBfill\fR 4
.IX Item "fill"
مشخص می‌کند که آیا تصویر خروجی خارج از ناحیه مورد نظر، که تمام سطح خروجی را پر نمی‌کند، باید با یک رنگ یکدست پر شود یا خیر.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مقیاس‌بندی ورودی به 720p با حفظ نسبت ابعاد و اطمینان از اینکه خروجی yuv420p است.
.Sp
.Vb 1
\&        sr_amf=\-2:720:format=yuv420p
.Ve
.IP \(bu 4
بزرگ‌نمایی به 4K با الگوریتم ویدیو SR1.1.
.Sp
.Vb 1
\&        sr_amf=4096:2160:algorithm=sr1\-1
.Ve
.SS ssim
.IX Subsection "ssim"
محاسبه معیار شباهت ساختاری (SSIM) میان دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی را دریافت می‌کند؛ ورودی اول منبع «اصلی» تلقی می‌شود و بدون تغییر به خروجی فرستاده می‌شود. ورودی دوم به عنوان ویدیوی «مرجع» برای محاسبه SSIM استفاده می‌شود.
.PP
هر دو ویدیوی ورودی باید دارای وضوح و قالب پیکسلی یکسانی باشند تا این فیلتر به درستی کار کند. همچنین فرض می‌شود هر دو ورودی دارای تعداد فریم‌های یکسانی هستند که یک به یک مقایسه می‌شوند.
.PP
این فیلتر مقدار SSIM محاسبه‌شده برای هر فریم را ذخیره می‌کند.
.PP
شرح پارامترهای پذیرفته‌شده در ادامه آمده است:
.IP "\fBstats_file, f\fR" 4
.IX Item "stats_file, f"
در صورت مشخص شدن، فیلتر از پرونده نام‌برده برای ذخیره SSIM هر تک‌فریم استفاده خواهد کرد. هنگامی که نام پرونده برابر با "\-" باشد، داده‌ها به خروجی استاندارد فرستاده می‌شوند.
.PP
پرونده چاپ‌شده در صورت انتخاب \fIstats_file\fR، شامل توالی‌ای از جفت‌های کلید/مقدار به شکل \fIkey\fR:\fIvalue\fR برای هر جفت فریم مقایسه‌شده است.
.PP
شرح هر یک از پارامترهای نمایش‌داده‌شده در ادامه آمده است:
.IP \fBn\fR 4
.IX Item "n"
شماره ترتیبی فریم ورودی، با شروع از 1
.IP "\fBY, U, V, R, G, B\fR" 4
.IX Item "Y, U, V, R, G, B"
مقدار SSIM فریم‌های مقایسه‌شده برای مؤلفه مشخص‌شده با پسوند.
.IP \fBAll\fR 4
.IX Item "All"
مقدار SSIM فریم‌های مقایسه‌شده برای کل فریم.
.IP \fBdB\fR 4
.IX Item "dB"
مشابه موارد بالا اما در قالب بازنمایی دسی‌بل (dB).
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
به عنوان مثال:
.Sp
.Vb 2
\&        movie=ref_movie.mpg, setpts=PTS\-STARTPTS [main];
\&        [main][ref] ssim="stats_file=stats.log" [out]
.Ve
.Sp
در این مثال پرونده ورودی در حال پردازش با پرونده مرجع \fIref_movie.mpg\fR مقایسه می‌شود. مقدار SSIM هر تک‌فریم در \fIstats.log\fR ذخیره می‌شود.
.IP \(bu 4
مثال دیگری با محاسبه همزمان هر دو معیار psnr و ssim:
.Sp
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mpg \-lavfi  "ssim;[0:v][1:v]psnr" \-f null \-
.Ve
.IP \(bu 4
مثال دیگری با کانتینرهای مختلف:
.Sp
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mkv \-lavfi  "[0:v]settb=AVTB,setpts=PTS\-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS\-STARTPTS[ref];[main][ref]ssim" \-f null \-
.Ve
.SS stereo3d
.IX Subsection "stereo3d"
تبدیل میان قالب‌های مختلف تصویر برجسته‌نما (stereoscopic).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBin\fR 4
.IX Item "in"
تنظیم قالب تصویر برجسته‌نمای ورودی.
.Sp
مقادیر موجود برای قالب‌های تصویر ورودی عبارتند از:
.RS 4
.IP \fBsbsl\fR 4
.IX Item "sbsl"
کنار هم موازی (چشم چپ در چپ، چشم راست در راست)
.IP \fBsbsr\fR 4
.IX Item "sbsr"
کنار هم ضربدری (چشم راست در چپ، چشم چپ در راست)
.IP \fBsbs2l\fR 4
.IX Item "sbs2l"
کنار هم موازی با وضوح نصف پهنا
(چشم چپ در چپ، چشم راست در راست)
.IP \fBsbs2r\fR 4
.IX Item "sbs2r"
کنار هم ضربدری با وضوح نصف پهنا
(چشم راست در چپ، چشم چپ در راست)
.IP \fBabl\fR 4
.IX Item "abl"
.PD 0
.IP \fBtbl\fR 4
.IX Item "tbl"
.PD
بالا\-پایین (چشم چپ در بالا، چشم راست در پایین)
.IP \fBabr\fR 4
.IX Item "abr"
.PD 0
.IP \fBtbr\fR 4
.IX Item "tbr"
.PD
بالا\-پایین (چشم راست در بالا، چشم چپ در پایین)
.IP \fBab2l\fR 4
.IX Item "ab2l"
.PD 0
.IP \fBtb2l\fR 4
.IX Item "tb2l"
.PD
بالا\-پایین با وضوح نصف ارتفاع
(چشم چپ در بالا، چشم راست در پایین)
.IP \fBab2r\fR 4
.IX Item "ab2r"
.PD 0
.IP \fBtb2r\fR 4
.IX Item "tb2r"
.PD
بالا\-پایین با وضوح نصف ارتفاع
(چشم راست در بالا، چشم چپ در پایین)
.IP \fBal\fR 4
.IX Item "al"
فریم‌های متناوب (ابتدا چشم چپ، سپس چشم راست)
.IP \fBar\fR 4
.IX Item "ar"
فریم‌های متناوب (ابتدا چشم راست، سپس چشم چپ)
.IP \fBirl\fR 4
.IX Item "irl"
ردیف‌های درهم‌تنیده (چشم چپ ردیف بالایی، چشم راست از ردیف بعدی شروع می‌شود)
.IP \fBirr\fR 4
.IX Item "irr"
ردیف‌های درهم‌تنیده (چشم راست ردیف بالایی، چشم چپ از ردیف بعدی شروع می‌شود)
.IP \fBicl\fR 4
.IX Item "icl"
ستون‌های درهم‌تنیده، ابتدا چشم چپ
.IP \fBicr\fR 4
.IX Item "icr"
ستون‌های درهم‌تنیده، ابتدا چشم راست
.Sp
مقدار پیش‌فرض \fBsbsl\fR است.
.RE
.RS 4
.RE
.IP \fBout\fR 4
.IX Item "out"
تنظیم قالب تصویر برجسته‌نمای خروجی.
.RS 4
.IP \fBsbsl\fR 4
.IX Item "sbsl"
کنار هم موازی (چشم چپ در چپ، چشم راست در راست)
.IP \fBsbsr\fR 4
.IX Item "sbsr"
کنار هم ضربدری (چشم راست در چپ، چشم چپ در راست)
.IP \fBsbs2l\fR 4
.IX Item "sbs2l"
کنار هم موازی با وضوح نصف پهنا
(چشم چپ در چپ، چشم راست در راست)
.IP \fBsbs2r\fR 4
.IX Item "sbs2r"
کنار هم ضربدری با وضوح نصف پهنا
(چشم راست در چپ، چشم چپ در راست)
.IP \fBabl\fR 4
.IX Item "abl"
.PD 0
.IP \fBtbl\fR 4
.IX Item "tbl"
.PD
بالا\-پایین (چشم چپ در بالا، چشم راست در پایین)
.IP \fBabr\fR 4
.IX Item "abr"
.PD 0
.IP \fBtbr\fR 4
.IX Item "tbr"
.PD
بالا\-پایین (چشم راست در بالا، چشم چپ در پایین)
.IP \fBab2l\fR 4
.IX Item "ab2l"
.PD 0
.IP \fBtb2l\fR 4
.IX Item "tb2l"
.PD
بالا\-پایین با وضوح نصف ارتفاع
(چشم چپ در بالا، چشم راست در پایین)
.IP \fBab2r\fR 4
.IX Item "ab2r"
.PD 0
.IP \fBtb2r\fR 4
.IX Item "tb2r"
.PD
بالا\-پایین با وضوح نصف ارتفاع
(چشم راست در بالا، چشم چپ در پایین)
.IP \fBal\fR 4
.IX Item "al"
فریم‌های متناوب (ابتدا چشم چپ، سپس چشم راست)
.IP \fBar\fR 4
.IX Item "ar"
فریم‌های متناوب (ابتدا چشم راست، سپس چشم چپ)
.IP \fBirl\fR 4
.IX Item "irl"
ردیف‌های درهم‌تنیده (چشم چپ ردیف بالایی، چشم راست از ردیف بعدی شروع می‌شود)
.IP \fBirr\fR 4
.IX Item "irr"
ردیف‌های درهم‌تنیده (چشم راست ردیف بالایی، چشم چپ از ردیف بعدی شروع می‌شود)
.IP \fBarbg\fR 4
.IX Item "arbg"
آناگلیف قرمز/آبی خاکستری
(فیلتر قرمز روی چشم چپ، فیلتر آبی روی چشم راست)
.IP \fBargg\fR 4
.IX Item "argg"
آناگلیف قرمز/سبز خاکستری
(فیلتر قرمز روی چشم چپ، فیلتر سبز روی چشم راست)
.IP \fBarcg\fR 4
.IX Item "arcg"
آناگلیف قرمز/فیروزه‌ای خاکستری
(فیلتر قرمز روی چشم چپ، فیلتر فیروزه‌ای روی چشم راست)
.IP \fBarch\fR 4
.IX Item "arch"
آناگلیف قرمز/فیروزه‌ای نیمه‌رنگی
(فیلتر قرمز روی چشم چپ، فیلتر فیروزه‌ای روی چشم راست)
.IP \fBarcc\fR 4
.IX Item "arcc"
آناگلیف قرمز/فیروزه‌ای رنگی
(فیلتر قرمز روی چشم چپ، فیلتر فیروزه‌ای روی چشم راست)
.IP \fBarcd\fR 4
.IX Item "arcd"
آناگلیف قرمز/فیروزه‌ای بهینه‌شده با تصویرسازی حداقل مربعات دوبوآ
(فیلتر قرمز روی چشم چپ، فیلتر فیروزه‌ای روی چشم راست)
.IP \fBagmg\fR 4
.IX Item "agmg"
آناگلیف سبز/سرخابی خاکستری
(فیلتر سبز روی چشم چپ، فیلتر سرخابی روی چشم راست)
.IP \fBagmh\fR 4
.IX Item "agmh"
آناگلیف سبز/سرخابی نیمه‌رنگی
(فیلتر سبز روی چشم چپ، فیلتر سرخابی روی چشم راست)
.IP \fBagmc\fR 4
.IX Item "agmc"
آناگلیف سبز/سرخابی رنگی
(فیلتر سبز روی چشم چپ، فیلتر سرخابی روی چشم راست)
.IP \fBagmd\fR 4
.IX Item "agmd"
آناگلیف سبز/سرخابی بهینه‌شده با تصویرسازی حداقل مربعات دوبوآ
(فیلتر سبز روی چشم چپ، فیلتر سرخابی روی چشم راست)
.IP \fBaybg\fR 4
.IX Item "aybg"
آناگلیف زرد/آبی خاکستری
(فیلتر زرد روی چشم چپ، فیلتر آبی روی چشم راست)
.IP \fBaybh\fR 4
.IX Item "aybh"
آناگلیف زرد/آبی نیمه‌رنگی
(فیلتر زرد روی چشم چپ، فیلتر آبی روی چشم راست)
.IP \fBaybc\fR 4
.IX Item "aybc"
آناگلیف زرد/آبی رنگی
(فیلتر زرد روی چشم چپ، فیلتر آبی روی چشم راست)
.IP \fBaybd\fR 4
.IX Item "aybd"
آناگلیف زرد/آبی بهینه‌شده با تصویرسازی حداقل مربعات دوبوآ
(فیلتر زرد روی چشم چپ، فیلتر آبی روی چشم راست)
.IP \fBml\fR 4
.IX Item "ml"
خروجی تک‌کاناله (فقط چشم چپ)
.IP \fBmr\fR 4
.IX Item "mr"
خروجی تک‌کاناله (فقط چشم راست)
.IP \fBchl\fR 4
.IX Item "chl"
شطرنجی، ابتدا چشم چپ
.IP \fBchr\fR 4
.IX Item "chr"
شطرنجی، ابتدا چشم راست
.IP \fBicl\fR 4
.IX Item "icl"
ستون‌های درهم‌تنیده، ابتدا چشم چپ
.IP \fBicr\fR 4
.IX Item "icr"
ستون‌های درهم‌تنیده، ابتدا چشم راست
.IP \fBhdmi\fR 4
.IX Item "hdmi"
بسته‌بندی فریم HDMI
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBarcd\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تبدیل ویدیوی ورودی از حالت کنار هم موازی به آناگلیف زرد/آبی دوبوآ:
.Sp
.Vb 1
\&        stereo3d=sbsl:aybd
.Ve
.IP \(bu 4
تبدیل ویدیوی ورودی از بالا\-پایین (چشم چپ در بالا، چشم راست در پایین) به کنار هم ضربدری:
.Sp
.Vb 1
\&        stereo3d=abl:sbsr
.Ve
.SS "streamselect, astreamselect"
.IX Subsection "streamselect, astreamselect"
انتخاب استریم‌های ویدیویی یا صوتی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد ورودی‌ها. پیش‌فرض 2 است.
.IP \fBmap\fR 4
.IX Item "map"
تنظیم اندیس‌های ورودی برای نگاشت مجدد به خروجی‌ها.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
فیلترهای \f(CW\*(C`streamselect\*(C'\fR و \f(CW\*(C`astreamselect\*(C'\fR از دستورات زیر پشتیبانی می‌کنند:
.IP \fBmap\fR 4
.IX Item "map"
تنظیم اندیس‌های ورودی برای نگاشت مجدد به خروجی‌ها.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
انتخاب استریم اول برای 5 ثانیه نخست و استریم دوم برای مابقی زمان:
.Sp
.Vb 1
\&        sendcmd=\*(Aq5.0 streamselect map 1\*(Aq,streamselect=inputs=2:map=0
.Ve
.IP \(bu 4
مشابه مورد بالا، اما برای صدا:
.Sp
.Vb 1
\&        asendcmd=\*(Aq5.0 astreamselect map 1\*(Aq,astreamselect=inputs=2:map=0
.Ve
.SS subtitles
.IX Subsection "subtitles"
ترسیم زیرنویس بر روی ویدیوی ورودی با استفاده از کتابخانه libass.
.PP
برای فعال‌سازی کامپایل این فیلتر، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libass\*(C'\fR پیکربندی کنید. این فیلتر همچنین برای تبدیل پرونده زیرنویس ارائه‌شده به قالب زیرنویس ASS (Advanced Substation Alpha)، نیازمند ساختی همراه با libavcodec و libavformat است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBfilename, f\fR" 4
.IX Item "filename, f"
تنظیم نام پرونده زیرنویس جهت خواندن. تعیین آن الزامی است.
.IP \fBoriginal_size\fR 4
.IX Item "original_size"
تعیین اندازه ویدیوی اصلی، یعنی ویدیویی که پرونده ASS برای آن ساخته شده است. برای نحو این گزینه، به
\&\fBبخش "Video size" در راهنمای ffmpeg\-utils\fR مراجعه کنید.
به دلیل یک نقص طراحی در محاسبات نسبت ابعاد ASS، این گزینه برای مقیاس‌بندی صحیح قلم‌ها در صورت تغییر نسبت ابعاد ضروری است.
.IP \fBfontsdir\fR 4
.IX Item "fontsdir"
تنظیم مسیر پوشه‌ای حاوی قلم‌ها که می‌تواند توسط فیلتر استفاده شود.
این قلم‌ها علاوه بر مواردی که ارائه‌دهنده قلم استفاده می‌کند، به کار گرفته خواهند شد.
.IP \fBalpha\fR 4
.IX Item "alpha"
پردازش کانال آلفا؛ به‌طور پیش‌فرض کانال آلفا دست‌نخورده باقی می‌ماند.
.IP \fBcharenc\fR 4
.IX Item "charenc"
تنظیم کدگذاری نویسه‌های زیرنویس ورودی. فقط برای فیلتر \f(CW\*(C`subtitles\*(C'\fR. تنها زمانی مفید است که کدگذاری UTF\-8 نباشد.
.IP "\fBstream_index, si\fR" 4
.IX Item "stream_index, si"
تنظیم اندیس استریم زیرنویس. فقط برای فیلتر \f(CW\*(C`subtitles\*(C'\fR.
.IP \fBforce_style\fR 4
.IX Item "force_style"
بازنویسی سبک پیش‌فرض یا پارامترهای اطلاعات اسکریپت زیرنویس. رشته‌ای حاوی جفت‌های \f(CW\*(C`KEY=VALUE\*(C'\fR با قالب سبک ASS را می‌پذیرد که با "," از هم جدا شده‌اند.
.IP \fBwrap_unicode\fR 4
.IX Item "wrap_unicode"
شکستن خطوط بر اساس الگوریتم شکستن خط یونیکد. در دسترس بودن آن نیازمند حداقل نسخه 0.17.0 کتابخانه libass (یا LIBASS_VERSION 0x01600010) است، \fIو\fR libass باید همراه با libunibreak ساخته شده باشد.
.Sp
این گزینه به‌طور پیش‌فرض به جز برای ASS بومی فعال است.
.IP \fBshaping\fR 4
.IX Item "shaping"
تنظیم موتور شکل‌دهی متن.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
موتور شکل‌دهی پیش‌فرض libass که بهترین گزینه در دسترس است.
.IP \fBsimple\fR 4
.IX Item "simple"
شکل‌دهنده سریع و مستقل از قلم که تنها می‌تواند جایگزینی‌ها را انجام دهد.
.IP \fBcomplex\fR 4
.IX Item "complex"
شکل‌دهنده کندتر با استفاده از OpenType برای جایگزینی‌ها و موقعیت‌یابی. برای رندر صحیح خطوط پیچیده مانند فارسی/عربی، عبری، دواناگاری و تایلندی ضروری است. نیازمند ساخت libass با HarfBuzz می‌باشد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
.RE
.PP
اگر کلید اول مشخص نشود، فرض می‌شود که مقدار اول \fBfilename\fR را مشخص می‌کند.
.PP
به عنوان مثال، برای رندر کردن پرونده \fIsub.srt\fR روی ویدیوی ورودی، از دستور زیر استفاده کنید:
.PP
.Vb 1
\&        subtitles=sub.srt
.Ve
.PP
که معادل است با:
.PP
.Vb 1
\&        subtitles=filename=sub.srt
.Ve
.PP
برای رندر استریم زیرنویس پیش‌فرض از پرونده \fIvideo.mkv\fR، استفاده کنید از:
.PP
.Vb 1
\&        subtitles=video.mkv
.Ve
.PP
برای رندر دومین استریم زیرنویس از آن پرونده، استفاده کنید از:
.PP
.Vb 1
\&        subtitles=video.mkv:si=1
.Ve
.PP
برای اینکه استریم زیرنویس از \fIsub.srt\fR با 80% آبی شفاف و با قلم \f(CW\*(C`DejaVu Serif\*(C'\fR نمایش داده شود، استفاده کنید از:
.PP
.Vb 1
\&        subtitles=sub.srt:force_style=\*(AqFontname=DejaVu Serif,PrimaryColour=&HCCFF0000\*(Aq
.Ve
.SS super2xsai
.IX Subsection "super2xsai"
مقیاس‌بندی ورودی به میزان 2 برابر و هموارسازی با استفاده از الگوریتم مقیاس‌بندی هنر پیکسلی Super2xSaI (Scale and Interpolate).
.PP
برای بزرگ‌نمایی تصاویر هنر پیکسلی بدون کاهش وضوح مفید است.
.SS swaprect
.IX Subsection "swaprect"
جابجا کردن دو ناحیه مستطیلی در ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBw\fR 4
.IX Item "w"
تنظیم پهنای شیء.
.IP \fBh\fR 4
.IX Item "h"
تنظیم ارتفاع شیء.
.IP \fBx1\fR 4
.IX Item "x1"
تنظیم مختصات x مستطیل اول.
.IP \fBy1\fR 4
.IX Item "y1"
تنظیم مختصات y مستطیل اول.
.IP \fBx2\fR 4
.IX Item "x2"
تنظیم مختصات x مستطیل دوم.
.IP \fBy2\fR 4
.IX Item "y2"
تنظیم مختصات y مستطیل دوم.
.Sp
تمام عبارت‌ها یک بار برای هر فریم ارزیابی می‌شوند.
.PP
تمام گزینه‌ها عبارت‌هایی هستند که شامل ثابت‌های زیر می‌باشند:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
پهنا و ارتفاع ورودی.
.IP \fBa\fR 4
.IX Item "a"
همان \fIw\fR / \fIh\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه (sample aspect ratio) ورودی
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش (display aspect ratio) ورودی، معادل (\fIw\fR / \fIh\fR) * \fIsar\fR
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، با شروع از 0.
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی بر حسب ثانیه. اگر برچسب زمانی ورودی ناشناخته باشد، NAN است.
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم ورودی در پرونده، در صورت ناشناخته بودن NAN است؛ منسوخ‌شده، استفاده نکنید
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمام گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS swapuv
.IX Subsection "swapuv"
جابجا کردن صفحات U و V.
.SS tblend
.IX Subsection "tblend"
آمیختن فریم‌های متوالی ویدیو.
.PP
\fBblend\fR را ببینید
.SS telecine
.IX Subsection "telecine"
اعمال فرایند تله‌سینه (telecine) بر روی ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBfirst_field\fR 4
.IX Item "first_field"
.RS 4
.PD 0
.IP "\fBtop, t\fR" 4
.IX Item "top, t"
.PD
ابتدا فیلد بالایی
.IP "\fBbottom, b\fR" 4
.IX Item "bottom, b"
ابتدا فیلد پایینی
مقدار پیش‌فرض \f(CW\*(C`top\*(C'\fR است.
.RE
.RS 4
.RE
.IP \fBpattern\fR 4
.IX Item "pattern"
رشته‌ای از اعداد که الگوی pulldown مورد نظر برای اعمال را مشخص می‌کند.
مقدار پیش‌فرض \f(CW23\fR است.
.PP
.Vb 1
\&        Some typical patterns:
\&        
\&        NTSC output (30i):
\&        27.5p: 32222
\&        24p: 23 (classic)
\&        24p: 2332 (preferred)
\&        20p: 33
\&        18p: 334
\&        16p: 3444
\&        
\&        PAL output (25i):
\&        27.5p: 12222
\&        24p: 222222222223 ("Euro pulldown")
\&        16.67p: 33
\&        16p: 33333334
.Ve
.SS thistogram
.IX Subsection "thistogram"
محاسبه و رسم هیستوگرام توزیع رنگ برای ویدیوی ورودی در طول زمان.
.PP
برخلاف فیلتر ویدیویی \fBhistogram\fR که تنها هیستوگرام یک تک‌فریم ورودی را در زمانی مشخص نشان می‌دهد، این فیلتر هیستوگرام‌های پیشین به تعداد فریم‌های مشخص‌شده با گزینه \f(CW\*(C`width\*(C'\fR را نیز نمایش می‌دهد.
.PP
هیستوگرام محاسبه‌شده بازنمایی توزیع مؤلفه‌های رنگ در یک تصویر است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
تنظیم پهنای خروجی یک مؤلفه رنگ منفرد. مقدار پیش‌فرض \f(CW0\fR است.
مقدار \f(CW0\fR به این معنی است که پهنا از ویدیوی ورودی گرفته خواهد شد.
این گزینه همچنین تعداد هیستوگرام‌های گذشته جهت نگهداری را مشخص می‌کند.
محدوده مجاز [0, 8192] است.
.IP "\fBdisplay_mode, d\fR" 4
.IX Item "display_mode, d"
تنظیم حالت نمایش.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBstack\fR 4
.IX Item "stack"
نمودارهای هر مؤلفه رنگ زیر یکدیگر قرار می‌گیرند.
.IP \fBparade\fR 4
.IX Item "parade"
نمودارهای هر مؤلفه رنگ کنار یکدیگر قرار می‌گیرند.
.IP \fBoverlay\fR 4
.IX Item "overlay"
اطلاعاتی مشابه با \f(CW\*(C`parade\*(C'\fR ارائه می‌دهد، با این تفاوت که نمودارهای معرف مؤلفه‌های رنگ مستقیماً روی یکدیگر قرار می‌گیرند (روی هم انداخته می‌شوند).
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`stack\*(C'\fR است.
.RE
.IP "\fBlevels_mode, m\fR" 4
.IX Item "levels_mode, m"
تنظیم حالت. می‌تواند \f(CW\*(C`linear\*(C'\fR (خطی) یا \f(CW\*(C`logarithmic\*(C'\fR (لگاریتمی) باشد.
پیش‌فرض \f(CW\*(C`linear\*(C'\fR است.
.IP "\fBcomponents, c\fR" 4
.IX Item "components, c"
تنظیم مؤلفه‌های رنگی جهت نمایش.
پیش‌فرض \f(CW7\fR است.
.IP "\fBbgopacity, b\fR" 4
.IX Item "bgopacity, b"
تنظیم کدر بودن پس‌زمینه. پیش‌فرض \f(CW0.9\fR است.
.IP "\fBenvelope, e\fR" 4
.IX Item "envelope, e"
نمایش پوش (envelope). به‌طور پیش‌فرض غیرفعال است.
.IP "\fBecolor, ec\fR" 4
.IX Item "ecolor, ec"
تنظیم رنگ پوش. پیش‌فرض \f(CW\*(C`gold\*(C'\fR است.
.IP \fBslide\fR 4
.IX Item "slide"
تنظیم حالت اسلاید (لغزش).
.Sp
مقادیر موجود برای اسلاید عبارتند از:
.RS 4
.IP \fBframe\fR 4
.IX Item "frame"
رسم فریم جدید هنگام رسیدن به حاشیه راست.
.IP \fBreplace\fR 4
.IX Item "replace"
جایگزینی ستون‌های قدیمی با ستون‌های جدید.
.IP \fBscroll\fR 4
.IX Item "scroll"
پیمایش از راست به چپ.
.IP \fBrscroll\fR 4
.IX Item "rscroll"
پیمایش از چپ به راست.
.IP \fBpicture\fR 4
.IX Item "picture"
رسم یک تصویر منفرد.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`replace\*(C'\fR است.
.RE
.SS threshold
.IX Subsection "threshold"
اعمال اثر آستانه‌گذاری بر روی استریم ویدیو.
.PP
این فیلتر برای انجام آستانه‌گذاری نیازمند چهار استریم ویدیویی است.
استریم اول استریمی است که در حال فیلتر کردن آن هستیم.
استریم دوم حامل مقادیر آستانه است، استریم سوم مقادیر حداقل را نگه می‌دارد،
و آخرین استریم، یعنی استریم چهارم، مقادیر حداکثر را نگه می‌دارد.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین اینکه کدام صفحات پردازش خواهند شد؛ صفحات پردازش‌نشده کپی می‌شوند.
با مقدار پیش‌فرض 0xf، تمام صفحات پردازش خواهند شد.
.PP
به عنوان مثال، اگر مقدار مؤلفه پیکسل استریم اول کمتر از مقدار آستانه مؤلفه پیکسل از استریم دوم (آستانه) باشد، مقدار استریم سوم انتخاب خواهد شد، در غیر این صورت مقدار مؤلفه پیکسل استریم چهارم انتخاب می‌شود.
.PP
با استفاده از فیلتر منبع رنگ (color)، می‌توان انواع مختلفی از آستانه‌گذاری را انجام داد:
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمام گزینه‌ها به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
آستانه‌گذاری دودویی، با استفاده از رنگ خاکستری به عنوان آستانه:
.Sp
.Vb 1
\&        ffmpeg \-i 320x240.avi \-f lavfi \-i color=gray \-f lavfi \-i color=black \-f lavfi \-i color=white \-lavfi threshold output.avi
.Ve
.IP \(bu 4
آستانه‌گذاری دودویی معکوس، با استفاده از رنگ خاکستری به عنوان آستانه:
.Sp
.Vb 1
\&        ffmpeg \-i 320x240.avi \-f lavfi \-i color=gray \-f lavfi \-i color=white \-f lavfi \-i color=black \-lavfi threshold output.avi
.Ve
.IP \(bu 4
آستانه‌گذاری دودویی برشی (truncate)، با استفاده از رنگ خاکستری به عنوان آستانه:
.Sp
.Vb 1
\&        ffmpeg \-i 320x240.avi \-f lavfi \-i color=gray \-i 320x240.avi \-f lavfi \-i color=gray \-lavfi threshold output.avi
.Ve
.IP \(bu 4
آستانه‌گذاری به صفر، با استفاده از رنگ خاکستری به عنوان آستانه:
.Sp
.Vb 1
\&        ffmpeg \-i 320x240.avi \-f lavfi \-i color=gray \-f lavfi \-i color=white \-i 320x240.avi \-lavfi threshold output.avi
.Ve
.IP \(bu 4
آستانه‌گذاری معکوس به صفر، با استفاده از رنگ خاکستری به عنوان آستانه:
.Sp
.Vb 1
\&        ffmpeg \-i 320x240.avi \-f lavfi \-i color=gray \-i 320x240.avi \-f lavfi \-i color=white \-lavfi threshold output.avi
.Ve
.SS thumbnail
.IX Subsection "thumbnail"
انتخاب شاخص‌ترین فریم (نمای بندانگشتی) در یک توالی مشخص از فریم‌های متوالی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم اندازه دسته فریم‌ها جهت تحلیل؛ در یک مجموعه از \fIn\fR فریم، فیلتر یکی از آن‌ها را برمی‌گزیند و سپس دسته بعدی از \fIn\fR فریم را تا انتها پردازش می‌کند. پیش‌فرض \f(CW100\fR است.
.IP \fBlog\fR 4
.IX Item "log"
تنظیم سطح گزارش جهت نمایش آمارهای فریم برگزیده.
پیش‌فرض \f(CW\*(C`info\*(C'\fR است.
.PP
از آنجا که فیلتر توالی کل فریم‌ها را دنبال می‌کند، مقدار بزرگ‌تر \fIn\fR منجر به مصرف حافظه بالاتر خواهد شد، بنابراین مقدار بالا توصیه نمی‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استخراج یک تصویر به ازای هر 50 فریم:
.Sp
.Vb 1
\&        thumbnail=50
.Ve
.IP \(bu 4
مثال کامل ساخت تصویر بندانگشتی با \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i in.avi \-vf thumbnail,scale=300:200 \-frames:v 1 out.png
.Ve
.SS tile
.IX Subsection "tile"
کاشی‌کاری (چیدمان کنار هم) چندین فریم متوالی در کنار یکدیگر.
.PP
فیلتر \fBuntile\fR می‌تواند عمل معکوس آن را انجام دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlayout\fR 4
.IX Item "layout"
تنظیم اندازه شبکه به شکل \f(CW\*(C`COLUMNSxROWS\*(C'\fR (ستون‌هاxسطرها). محدوده تا UINT_MAX سلول است.
پیش‌فرض \f(CW\*(C`6x5\*(C'\fR است.
.IP \fBnb_frames\fR 4
.IX Item "nb_frames"
تنظیم حداکثر تعداد فریم‌ها جهت رندر در ناحیه داده‌شده. باید کمتر یا مساوی با \fIw\fRx\fIh\fR باشد. مقدار پیش‌فرض \f(CW0\fR است، به این معنی که از تمام ناحیه استفاده خواهد شد.
.IP \fBmargin\fR 4
.IX Item "margin"
تنظیم حاشیه مرز بیرونی بر حسب پیکسل. محدوده از 0 تا 1024 است. پیش‌فرض \f(CW0\fR است.
.IP \fBpadding\fR 4
.IX Item "padding"
تنظیم ضخامت مرز درونی (یعنی تعداد پیکسل‌های میان فریم‌ها). برای گزینه‌های فاصله‌گذاری پیشرفته‌تر (مانند مقادیر متفاوت برای لبه‌ها)، به فیلتر ویدیویی pad مراجعه کنید. محدوده از 0 تا 1024 است. پیش‌فرض \f(CW0\fR است.
.IP \fBcolor\fR 4
.IX Item "color"
تعیین رنگ ناحیه بلااستفاده. برای نحو این گزینه، به
\&\fBبخش "Color" در راهنمای ffmpeg\-utils\fR مراجعه کنید.
مقدار پیش‌فرض \fIcolor\fR برابر با "black" است.
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم تعداد فریم‌های همپوشان هنگام کاشی‌کاری چندین فریم متوالی در کنار هم.
مقدار باید بین \f(CW0\fR و \fInb_frames \- 1\fR باشد. پیش‌فرض \f(CW0\fR است.
.IP \fBinit_padding\fR 4
.IX Item "init_padding"
تنظیم تعداد فریم‌هایی که در ابتدا قبل از نمایش اولین فریم خروجی خالی می‌مانند.
این گزینه مشخص می‌کند چه زمانی اولین فریم خروجی دریافت می‌شود.
مقدار باید بین \f(CW0\fR و \fInb_frames \- 1\fR باشد. پیش‌فرض \f(CW0\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید کاشی‌های PNG با ابعاد 8x8 از تمام فریم‌های کلیدی (\fB\-skip_frame nokey\fR) در یک فیلم:
.Sp
.Vb 1
\&        ffmpeg \-skip_frame nokey \-i file.avi \-vf \*(Aqscale=128:72,tile=8x8\*(Aq \-an \-fps_mode passthrough keyframes%03d.png
.Ve
.Sp
گزینه \fB\-fps_mode passthrough\fR برای جلوگیری از تکثیر هر فریم خروجی توسط \fBffmpeg\fR جهت تطبیق با نرخ فریم شناسایی‌شده اصلی ضروری است.
.IP \(bu 4
نمایش \f(CW5\fR تصویر در ناحیه‌ای به ابعاد \f(CW\*(C`3x2\*(C'\fR فریم، با \f(CW7\fR پیکسل فاصله میان آن‌ها، و \f(CW2\fR پیکسل حاشیه اولیه، با استفاده از ترکیبی از گزینه‌های ترتیبی و نام‌دار:
.Sp
.Vb 1
\&        tile=3x2:nb_frames=5:padding=7:margin=2
.Ve
.SS tiltandshift
.IX Subsection "tiltandshift"
اعمال اثر شیفت و تیلت (tilt\-and\-shift).
.PP
چه اتفاقی می‌افتد اگر زمان و فضا را وارونه کنید؟
.PP
به‌طور معمول یک ویدیو از چندین فریم تشکیل شده است که هر یک لحظه متفاوتی از زمان را نشان می‌دهند و صحنه‌ای را به تصویر می‌کشند که در فضای ضبط‌شده توسط فریم تکامل می‌یابد. این فیلتر نقطه مقابل این مفهوم است و از عکاسی تیلت و شیفت الهام گرفته است.
.PP
یک فریم فیلترشده شامل کل خط زمانی رویدادهای سازنده توالی است، و این با قرار دادن برشی از پیکسل‌های هر فریم در یک تک‌فریم به دست می‌آید. با این حال، از آنجا که فریم‌هایی با پهنای بی‌نهایت وجود ندارند، این کار تا پهنای فریم ورودی انجام می‌شود، و ویدیو با جابجایی (شیفت) یک ستون به ازای هر فریم بعدی بازسازی می‌شود. به منظور نگاشت فضا به زمان، فیلتر هر فریم ورودی را نیز کج (تیلت) می‌کند تا حرکت حفظ شود. این کار با انتخاب تدریجی یک ستون متفاوت از هر فریم ورودی محقق می‌شود.
.PP
نتیجه نهایی نوعی اختلاف‌منظر (پارالاکس) معکوس است، به‌گونه‌ای که اشیاء دوردست بسیار سریع‌تر از اشیاء جلو حرکت می‌کنند. شرایط ایده‌آل برای این اثر ویدیویی زمانی است که یا حرکت بسیار کمی وجود داشته باشد و پس‌زمینه ایستا باشد، یا زمانی که حرکت زیادی وجود داشته باشد و عمق میدان بسیار وسیعی حاکم باشد (مثلاً نمای سراسرنما/پانورامای وسیع، هنگام حرکت در قطار).
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBtilt\fR 4
.IX Item "tilt"
تیلت کردن ویدیو هنگام شیفت (پیش‌فرض). در صورت عدم تنظیم، ویدیو تصویری ایستا را می‌لغزاند که از ستون اول هر فریم تشکیل شده است.
.IP \fBstart\fR 4
.IX Item "start"
در آغاز فیلتر کردن چه کاری انجام شود (زیر را ببینید).
.IP \fBend\fR 4
.IX Item "end"
در پایان فیلتر کردن چه کاری انجام شود (زیر را ببینید).
.IP \fBhold\fR 4
.IX Item "hold"
چند ستون قبل از شروع فیلتر کردن عبور داده شود.
.IP \fBpad\fR 4
.IX Item "pad"
چند ستون قبل از پایان فیلتر کردن درج شود.
.PP
به‌طور معمول فیلتر از همان فریم اول شیفت و تیلت را انجام می‌دهد و پس از دریافت آخرین فریم متوقف می‌شود. با این حال، قبل از شروع فیلتر کردن، می‌توان ویدیوی عادی را حفظ کرد تا این اثر به آرامی در جای خود بلغزد و بنشیند. به همین ترتیب، آخرین فریم ویدیو را می‌توان در پایان بازسازی کرد. متناوباً می‌توان کار را به سادگی با رنگ سیاه شروع کرد و به پایان رساند.
.IP \fBnone\fR 4
.IX Item "none"
فیلتر کردن بلافاصله شروع می‌شود و پس از دریافت آخرین فریم پایان می‌یابد.
.IP \fBframe\fR 4
.IX Item "frame"
فریم‌های اول یا آخرین فریم در حین پردازش دست‌نخورده باقی می‌مانند.
.IP \fBblack\fR 4
.IX Item "black"
رنگ سیاه در ابتدا یا در انتهای فیلتر کردن افزوده می‌شود.
.SS tinterlace
.IX Subsection "tinterlace"
انجام انواع مختلف درهم‌تنیدگی فیلد زمانی (temporal field interlacing).
.PP
فریم‌ها با شروع از 1 شمرده می‌شوند، بنابراین اولین فریم ورودی فرد در نظر گرفته می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
تعیین حالت درهم‌تنیدگی. این گزینه را می‌توان به عنوان یک مقدار تنها نیز مشخص کرد. برای فهرست مقادیر این گزینه به ادامه مطلب مراجعه کنید.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP "\fBmerge, 0\fR" 4
.IX Item "merge, 0"
انتقال فریم‌های فرد به فیلد بالایی و فریم‌های زوج به فیلد پایینی، که فریمی با ارتفاع دوبرابر در نصف نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        
\&        Output:
\&        11111                           33333
\&        22222                           44444
\&        11111                           33333
\&        22222                           44444
\&        11111                           33333
\&        22222                           44444
\&        11111                           33333
\&        22222                           44444
.Ve
.IP "\fBdrop_even, 1\fR" 4
.IX Item "drop_even, 1"
فقط فریم‌های فرد را خروجی می‌دهد و فریم‌های زوج دور انداخته می‌شوند، که فریمی با ارتفاع بدون تغییر در نصف نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        
\&        Output:
\&        11111                           33333
\&        11111                           33333
\&        11111                           33333
\&        11111                           33333
.Ve
.IP "\fBdrop_odd, 2\fR" 4
.IX Item "drop_odd, 2"
فقط فریم‌های زوج را خروجی می‌دهد و فریم‌های فرد دور انداخته می‌شوند، که فریمی با ارتفاع بدون تغییر در نصف نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        
\&        Output:
\&                        22222                           44444
\&                        22222                           44444
\&                        22222                           44444
\&                        22222                           44444
.Ve
.IP "\fBpad, 3\fR" 4
.IX Item "pad, 3"
گسترش هر فریم به ارتفاع کامل، اما پر کردن خطوط متناوب با رنگ سیاه، که فریمی با ارتفاع دوبرابر در همان نرخ فریم ورودی تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        
\&        Output:
\&        11111           .....           33333           .....
\&        .....           22222           .....           44444
\&        11111           .....           33333           .....
\&        .....           22222           .....           44444
\&        11111           .....           33333           .....
\&        .....           22222           .....           44444
\&        11111           .....           33333           .....
\&        .....           22222           .....           44444
.Ve
.IP "\fBinterleave_top, 4\fR" 4
.IX Item "interleave_top, 4"
درهم‌تنیدن فیلد بالایی از فریم‌های فرد با فیلد پایینی از فریم‌های زوج، که فریمی با ارتفاع بدون تغییر در نصف نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111<\-         22222           33333<\-         44444
\&        11111           22222<\-         33333           44444<\-
\&        11111<\-         22222           33333<\-         44444
\&        11111           22222<\-         33333           44444<\-
\&        
\&        Output:
\&        11111                           33333
\&        22222                           44444
\&        11111                           33333
\&        22222                           44444
.Ve
.IP "\fBinterleave_bottom, 5\fR" 4
.IX Item "interleave_bottom, 5"
درهم‌تنیدن فیلد پایینی از فریم‌های فرد با فیلد بالایی از فریم‌های زوج، که فریمی با ارتفاع بدون تغییر در نصف نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222<\-         33333           44444<\-
\&        11111<\-         22222           33333<\-         44444
\&        11111           22222<\-         33333           44444<\-
\&        11111<\-         22222           33333<\-         44444
\&        
\&        Output:
\&        22222                           44444
\&        11111                           33333
\&        22222                           44444
\&        11111                           33333
.Ve
.IP "\fBinterlacex2, 6\fR" 4
.IX Item "interlacex2, 6"
دو برابر کردن نرخ فریم با ارتفاع بدون تغییر. فریم‌هایی درج می‌شوند که هر یک شامل دومین فیلد زمانی از فریم ورودی قبلی و اولین فیلد زمانی از فریم ورودی بعدی هستند. این حالت به پرچم top_field_first وابسته است. برای نمایشگرهای ویدیوی درهم‌تنیده بدون همگام‌سازی فیلد مفید است.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&         11111           22222           33333           44444
\&        11111           22222           33333           44444
\&         11111           22222           33333           44444
\&        
\&        Output:
\&        11111   22222   22222   33333   33333   44444   44444
\&         11111   11111   22222   22222   33333   33333   44444
\&        11111   22222   22222   33333   33333   44444   44444
\&         11111   11111   22222   22222   33333   33333   44444
.Ve
.IP "\fBmergex2, 7\fR" 4
.IX Item "mergex2, 7"
انتقال فریم‌های فرد به فیلد بالایی و فریم‌های زوج به فیلد پایینی، که فریمی با ارتفاع دوبرابر در همان نرخ فریم تولید می‌کند.
.Sp
.Vb 3
\&         \-\-\-\-\-\-> time
\&        Input:
\&        Frame 1         Frame 2         Frame 3         Frame 4
\&        
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        11111           22222           33333           44444
\&        
\&        Output:
\&        11111           33333           33333           55555
\&        22222           22222           44444           44444
\&        11111           33333           33333           55555
\&        22222           22222           44444           44444
\&        11111           33333           33333           55555
\&        22222           22222           44444           44444
\&        11111           33333           33333           55555
\&        22222           22222           44444           44444
.Ve
.RE
.RS 4
.Sp
مقادیر عددی منسوخ شده‌اند اما به دلایل سازگاری عقبرو پذیرفته می‌شوند.
.Sp
حالت پیش‌فرض \f(CW\*(C`merge\*(C'\fR است.
.RE
.IP \fBflags\fR 4
.IX Item "flags"
تعیین پرچم‌های مؤثر بر فرایند فیلتر.
.Sp
مقادیر موجود برای \fIflags\fR عبارتند از:
.RS 4
.IP "\fBlow_pass_filter, vlpf\fR" 4
.IX Item "low_pass_filter, vlpf"
فعال‌سازی فیلتر پایین‌گذر عمودی خطی در فیلتر.
فیلتر کردن پایین‌گذر عمودی هنگام ایجاد یک مقصد درهم‌تنیده از یک منبع پیش‌رونده (progressive) حاوی جزئیات عمودی با فرکانس بالا الزامی است. فیلتر کردن باعث کاهش لرزش بین‌خطی و الگوهای موآره در حالت درهم‌تنیده می‌شود.
.IP "\fBcomplex_filter, cvlpf\fR" 4
.IX Item "complex_filter, cvlpf"
فعال‌سازی فیلتر پایین‌گذر عمودی پیچیده.
این گزینه لرزش بین‌خطی و الگوهای موآره را اندکی کمتر کاهش می‌دهد اما جزئیات و حس ذهنی وضوح را بهتر حفظ می‌کند.
.IP \fBbypass_il\fR 4
.IX Item "bypass_il"
گذر دادن فریم‌هایی که از پیش درهم‌تنیده هستند، و تنها تنظیم نرخ فریم.
.RE
.RS 4
.Sp
فیلتر کردن پایین‌گذر عمودی و گذر دادن فریم‌های از پیش درهم‌تنیده تنها می‌تواند برای \fBmode\fRهای \fIinterleave_top\fR و \fIinterleave_bottom\fR فعال شود.
.RE
.SS tmedian
.IX Subsection "tmedian"
انتخاب پیکسل‌های میانه (median) از چندین فریم متوالی ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم شعاع فیلتر میانه.
پیش‌فرض 1 است. محدوده مجاز از 1 تا 127 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW15\fR است که با آن تمام صفحات پردازش می‌شوند.
.IP \fBpercentile\fR 4
.IX Item "percentile"
تنظیم صدک میانه. مقدار پیش‌فرض \f(CW0.5\fR است.
مقدار پیش‌فرض \f(CW0.5\fR همواره مقادیر میانه را انتخاب می‌کند، در حالی که \f(CW0\fR مقادیر کمینه و \f(CW1\fR مقادیر بیشینه را انتخاب خواهد کرد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به جز گزینه \f(CW\*(C`radius\*(C'\fR به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS tmidequalizer
.IX Subsection "tmidequalizer"
اعمال افکت همسان‌سازی ویدیویی میان‌راهی زمانی (Temporal Midway Video Equalization).
.PP
همسان‌سازی ویدیویی میان‌راهی یک توالی از فریم‌های ویدیو را به گونه‌ای تنظیم می‌کند که دارای هیستوگرام‌های یکسان باشند، در حالی که پویایی (dynamics) آن‌ها را تا حد ممکن حفظ می‌کند. این ویژگی برای مثال جهت تطبیق نوردهی (exposure) در یک توالی از فریم‌های ویدیو مفید است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBradius\fR 4
.IX Item "radius"
تنظیم شعاع فیلتر کردن. پیش‌فرض \f(CW5\fR است. محدوده مجاز از 1 تا 127 است.
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم سیگمای فیلتر کردن. پیش‌فرض \f(CW0.5\fR است. این گزینه شدت فیلتر کردن را کنترل می‌کند.
تنظیم این گزینه روی 0 عملاً هیچ کاری انجام نمی‌دهد.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید پردازش شوند. پیش‌فرض \f(CW15\fR است که تمام صفحات موجود است.
.SS tmix
.IX Subsection "tmix"
آمیختن فریم‌های متوالی ویدیو.
.PP
توضیحات گزینه‌های پذیرفته‌شده در ادامه آمده است:
.IP \fBframes\fR 4
.IX Item "frames"
تعداد فریم‌های متوالی برای آمیختن. در صورت مشخص نشدن، مقدار پیش‌فرض 3 است.
.IP \fBweights\fR 4
.IX Item "weights"
مشخص کردن وزن هر فریم ویدیوی ورودی.
هر وزن با فاصله (فاصله خالی) جدا می‌شود. اگر تعداد وزن‌ها کمتر از تعداد \fIframes\fR باشد، آخرین وزن مشخص‌شده برای تمام وزن‌های باقی‌مانده استفاده خواهد شد.
.IP \fBscale\fR 4
.IX Item "scale"
مشخص کردن مقیاس (scale)؛ اگر تنظیم شود در مجموع حاصل‌ضرب هر وزن در مقادیر پیکسل ضرب می‌شود تا مقدار نهایی پیکسل مقصد به‌دست آید. به طور پیش‌فرض، \fIscale\fR به صورت خودکار با مجموع وزن‌ها مقیاس‌بندی می‌شود.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید فیلتر شوند. پیش‌فرض همه صفحات است. محدوده مجاز از 0 تا 15 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
میانگین‌گیری از 7 فریم متوالی:
.Sp
.Vb 1
\&        tmix=frames=7:weights="1 1 1 1 1 1 1"
.Ve
.IP \(bu 4
اعمال یک کانولوشن زمانی ساده:
.Sp
.Vb 1
\&        tmix=frames=3:weights="\-1 3 \-1"
.Ve
.IP \(bu 4
مشابه مورد بالا اما تنها نمایش تفاوت‌های زمانی:
.Sp
.Vb 1
\&        tmix=frames=3:weights="\-1 2 \-1":scale=1
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBweights\fR 4
.IX Item "weights"
.PD 0
.IP \fBscale\fR 4
.IX Item "scale"
.IP \fBplanes\fR 4
.IX Item "planes"
.PD
نحوه نوشتن مشابه گزینه با همین نام است.
.SS tonemap
.IX Subsection "tonemap"
نگاشت تن (Tone map) رنگ‌ها از محدوده‌های دینامیکی مختلف.
.PP
این فیلتر انتظار داده‌هایی با ممیز شناور با دقت یگانه (single precision) دارد، زیرا نیاز به کار روی مقادیر خارج از محدوده دارد (و می‌تواند آنها را در خروجی تولید کند). فیلتر دیگری مانند \fBzscale\fR برای تبدیل فریم حاصل به یک قالب قابل استفاده مورد نیاز است.
.PP
الگوریتم‌های نگاشت تن پیاده‌سازی‌شده تنها روی نور خطی (linear light) کار می‌کنند، بنابراین داده‌های ورودی باید از قبل خطی‌سازی شده باشند (و احتمالاً با برچسب‌های رنگی صحیح نشانه‌گذاری شده باشند).
.PP
.Vb 1
\&        ffmpeg \-i INPUT \-vf zscale=transfer=linear,tonemap=clip,zscale=transfer=bt709,format=yuv420p OUTPUT
.Ve
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtonemap\fR 4
.IX Item "tonemap"
تنظیم الگوریتم نگاشت تن برای استفاده.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fInone\fR 4
.IX Item "none"
هیچ نگاشت تنی اعمال نشود، فقط اشباع رنگ پیکسل‌های بیش از حد روشن کاهش یابد (desaturate).
.IP \fIclip\fR 4
.IX Item "clip"
برش سخت (Hard\-clip) مقادیر خارج از محدوده. از این حالت برای دقت رنگ بی‌نقص در مقادیر درون محدوده استفاده کنید، در حالی که مقادیر خارج از محدوده دگرگون می‌شوند.
.IP \fIlinear\fR 4
.IX Item "linear"
کشش کل وسعت رنگ (gamut) مرجع به یک مضرب خطی از نمایشگر.
.IP \fIgamma\fR 4
.IX Item "gamma"
برازش یک تبدیل لگاریتمی میان منحنی‌های تن.
.IP \fIreinhard\fR 4
.IX Item "reinhard"
حفظ روشنایی کلی تصویر با یک منحنی ساده، با استفاده از کنتراست غیرخطی که منجر به مسطح شدن جزئیات و کاهش دقت رنگ می‌شود.
.IP \fIhable\fR 4
.IX Item "hable"
حفظ بهتر جزئیات تاریک و روشن نسبت به \fIreinhard\fR، به قیمت اندکی تیره کردن همه‌چیز. زمانی از آن استفاده کنید که حفظ جزئیات مهم‌تر از دقت رنگ و روشنایی باشد.
.IP \fImobius\fR 4
.IX Item "mobius"
نگاشت نرم مقادیر خارج از محدوده، در حالی که کنتراست و رنگ‌ها برای محتوای درون محدوده تا حد ممکن حفظ می‌شود. زمانی از آن استفاده کنید که دقت رنگ مهم‌تر از حفظ جزئیات باشد.
.RE
.RS 4
.Sp
پیش‌فرض none است.
.RE
.IP \fBparam\fR 4
.IX Item "param"
تنظیم دقیق الگوریتم نگاشت تن.
.Sp
این گزینه بر الگوریتم‌های زیر تأثیر می‌گذارد:
.RS 4
.IP \fInone\fR 4
.IX Item "none"
نادیده گرفته می‌شود.
.IP \fIlinear\fR 4
.IX Item "linear"
ضریب مقیاس مورد استفاده هنگام کشش را تعیین می‌کند.
پیش‌فرض 1.0 است.
.IP \fIgamma\fR 4
.IX Item "gamma"
توان تابع را تعیین می‌کند.
پیش‌فرض 1.8 است.
.IP \fIclip\fR 4
.IX Item "clip"
تعیین یک ضریب خطی اضافی برای ضرب در سیگنال پیش از برش.
پیش‌فرض 1.0 است.
.IP \fIreinhard\fR 4
.IX Item "reinhard"
تعیین ضریب کنتراست محلی در اوج روشنایی نمایشگر.
پیش‌فرض 0.5 است، به این معنی که مقادیر درون دامنه (in\-gamut) تقریباً نصف روشنایی حالت برش را خواهند داشت.
.IP \fIhable\fR 4
.IX Item "hable"
نادیده گرفته می‌شود.
.IP \fImobius\fR 4
.IX Item "mobius"
تعیین نقطه گذار از تبدیل خطی به موبیوس. تضمین می‌شود که تمام مقادیر زیر این نقطه به صورت 1:1 نگاشت شوند. هرچه مقدار بالاتر باشد، نتیجه دقیق‌تر خواهد بود اما به بهای از دست رفتن جزئیات روشن تمام می‌شود.
پیش‌فرض 0.3 است که به دلیل شیب تند اولیه، رنگ‌های درون محدوده را همچنان با دقت قابل توجهی حفظ می‌کند.
.RE
.RS 4
.RE
.IP \fBdesat\fR 4
.IX Item "desat"
اعمال کاهش اشباع رنگ (desaturation) برای بخش‌های روشن (highlights) که از این سطح روشنایی فراتر می‌روند. هرچه این پارامتر بالاتر باشد، اطلاعات رنگ بیشتری حفظ خواهد شد. این تنظیم با تبدیل (نرم) رنگ‌ها به سفید، از ایجاد رنگ‌های سوخته و غیرطبیعی در هایلایت‌های شدید جلوگیری می‌کند. این کار به قیمت کاهش اطلاعات رنگ‌های خارج از محدوده، حس طبیعی‌تری به تصاویر می‌دهد.
.Sp
مقدار پیش‌فرض 2.0 تا حدی محافظه‌کارانه است و اغلب فقط روی آسمان یا سطوحی که مستقیماً نور خورشید به آن‌ها می‌تابد اعمال می‌شود. مقدار 0.0 این گزینه را غیرفعال می‌کند.
.Sp
این گزینه تنها در صورتی کار می‌کند که فریم ورودی دارای برچسب رنگی پشتیبانی‌شده باشد.
.IP \fBpeak\fR 4
.IX Item "peak"
بازنویسی اوج سیگنال/اسمی/مرجع با این مقدار. هنگامی مفید است که اطلاعات اوج تعبیه‌شده در متادیتای نمایشگر قابل اعتماد نباشد یا هنگام نگاشت تن از یک محدوده پایین‌تر به یک محدوده بالاتر.
.SS tpad
.IX Subsection "tpad"
افزودن موقت پدینگ به فریم‌های ویدیو (حاشیه‌گذاری زمانی).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstart\fR 4
.IX Item "start"
تعیین تعداد فریم‌های تأخیر پیش از جریان ویدیوی ورودی. پیش‌فرض 0 است.
.IP \fBstop\fR 4
.IX Item "stop"
تعیین تعداد فریم‌های پدینگ پس از جریان ویدیوی ورودی.
برای پدینگ نامحدود روی \-1 تنظیم کنید. پیش‌فرض 0 است.
.IP \fBstart_mode\fR 4
.IX Item "start_mode"
تنظیم نوع فریم‌های اضافه‌شده به ابتدای جریان.
می‌تواند \fIadd\fR یا \fIclone\fR باشد.
با \fIadd\fR فریم‌هایی با رنگ یکدست اضافه می‌شوند.
با \fIclone\fR فریم‌ها شبیه‌سازی‌شده از فریم نخست هستند.
پیش‌فرض \fIadd\fR است.
.IP \fBstop_mode\fR 4
.IX Item "stop_mode"
تنظیم نوع فریم‌های اضافه‌شده به انتهای جریان.
می‌تواند \fIadd\fR یا \fIclone\fR باشد.
با \fIadd\fR فریم‌هایی با رنگ یکدست اضافه می‌شوند.
با \fIclone\fR فریم‌ها شبیه‌سازی‌شده از فریم پایانی هستند.
پیش‌فرض \fIadd\fR است.
.IP "\fBstart_duration, stop_duration\fR" 4
.IX Item "start_duration, stop_duration"
تعیین مدت‌زمان تأخیر شروع/پایان. برای ساختار نحوی پذیرفته‌شده به
\&\fBبخش مدت‌زمان (Time duration) در دفترچه راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
این گزینه‌ها جایگزین \fIstart\fR و \fIstop\fR می‌شوند. پیش‌فرض 0 است.
.IP \fBcolor\fR 4
.IX Item "color"
تعیین رنگ ناحیه پدینگ‌شده. برای ساختار نحوی این گزینه،
\&\fBبخش "Color" در دفترچه راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
مقدار پیش‌فرض \fIcolor\fR برابر "black" است.
.SS transpose
.IX Subsection "transpose"
ترانهادن سطرهای ویدیوی ورودی با ستون‌های آن و در صورت تمایل برگرداندن (flip) آن.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBdir\fR 4
.IX Item "dir"
تعیین جهت ترانهش.
.Sp
می‌تواند مقادیر زیر را به خود بگیرد:
.RS 4
.IP "\fB0, 4, cclock_flip\fR" 4
.IX Item "0, 4, cclock_flip"
چرخش 90 درجه پادساعت‌گرد و برگرداندن عمودی (پیش‌فرض)، یعنی:
.Sp
.Vb 3
\&        L.R     L.l
\&        . . \->  . .
\&        l.r     R.r
.Ve
.IP "\fB1, 5, clock\fR" 4
.IX Item "1, 5, clock"
چرخش 90 درجه ساعت‌گرد، یعنی:
.Sp
.Vb 3
\&        L.R     l.L
\&        . . \->  . .
\&        l.r     r.R
.Ve
.IP "\fB2, 6, cclock\fR" 4
.IX Item "2, 6, cclock"
چرخش 90 درجه پادساعت‌گرد، یعنی:
.Sp
.Vb 3
\&        L.R     R.r
\&        . . \->  . .
\&        l.r     L.l
.Ve
.IP "\fB3, 7, clock_flip\fR" 4
.IX Item "3, 7, clock_flip"
چرخش 90 درجه ساعت‌گرد و برگرداندن عمودی، یعنی:
.Sp
.Vb 3
\&        L.R     r.R
\&        . . \->  . .
\&        l.r     l.L
.Ve
.RE
.RS 4
.Sp
برای مقادیر بین 4\-7، ترانهش تنها در صورتی انجام می‌شود که هندسه ویدیوی ورودی پرتره (عمودی) باشد و نه لنداسکیپ (افقی). این مقادیر منسوخ شده‌اند و به جای آن‌ها باید از گزینه \f(CW\*(C`passthrough\*(C'\fR استفاده شود.
.Sp
مقادیر عددی منسوخ شده‌اند و باید به نفع ثابت‌های نمادین کنار گذاشته شوند.
.RE
.IP \fBpassthrough\fR 4
.IX Item "passthrough"
اگر هندسه ورودی با مقدار مشخص‌شده مطابقت داشته باشد، ترانهش اعمال نشود. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
همواره ترانهش اعمال شود.
.IP \fBportrait\fR 4
.IX Item "portrait"
حفظ هندسه پرتره (زمانی که \fIheight\fR >= \fIwidth\fR).
.IP \fBlandscape\fR 4
.IX Item "landscape"
حفظ هندسه لنداسکیپ (زمانی که \fIwidth\fR >= \fIheight\fR).
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`none\*(C'\fR است.
.RE
.PP
برای مثال، جهت چرخش 90 درجه ساعت‌گرد و حفظ چیدمان پرتره:
.PP
.Vb 1
\&        transpose=dir=1:passthrough=portrait
.Ve
.PP
دستور بالا می‌تواند به صورت زیر نیز مشخص شود:
.PP
.Vb 1
\&        transpose=1:portrait
.Ve
.SS trim
.IX Subsection "trim"
برش ورودی به گونه‌ای که خروجی شامل یک بخش پیوسته از ورودی باشد.
.PP
پارامترهای زیر را می‌پذیرد:
.IP \fBstart\fR 4
.IX Item "start"
تعیین زمان شروع بخش نگه‌داشته‌شده؛ یعنی فریمی با برچسب زمانی \fIstart\fR نخستین فریم در خروجی خواهد بود.
.IP \fBend\fR 4
.IX Item "end"
تعیین زمان نخستین فریمی که دور انداخته می‌شود؛ یعنی فریمی که بلافاصله پیش از فریم با برچسب زمانی \fIend\fR قرار دارد، آخرین فریم خروجی خواهد بود.
.IP \fBstart_pts\fR 4
.IX Item "start_pts"
مشابه \fIstart\fR است، با این تفاوت که این گزینه برچسب زمانی شروع را بر حسب واحدهای پایه زمانی (timebase) به جای ثانیه تنظیم می‌کند.
.IP \fBend_pts\fR 4
.IX Item "end_pts"
مشابه \fIend\fR است، با این تفاوت که این گزینه برچسب زمانی پایان را بر حسب واحدهای پایه زمانی (timebase) به جای ثانیه تنظیم می‌کند.
.IP \fBduration\fR 4
.IX Item "duration"
حداکثر مدت زمان خروجی بر حسب ثانیه.
.IP \fBstart_frame\fR 4
.IX Item "start_frame"
شماره نخستین فریمی که باید به خروجی منتقل شود.
.IP \fBend_frame\fR 4
.IX Item "end_frame"
شماره نخستین فریمی که باید دور انداخته شود.
.PP
مقادیر \fBstart\fR، \fBend\fR و \fBduration\fR به صورت مشخصات مدت‌زمان بیان می‌شوند؛ برای ساختار نحوی پذیرفته‌شده به
\&\fBبخش مدت‌زمان (Time duration) در دفترچه راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.PP
توجه داشته باشید که دو دسته اول از گزینه‌های start/end و گزینه \fBduration\fR به برچسب زمانی فریم نگاه می‌کنند، در حالی که گونه‌های _frame صرفاً فریم‌هایی را که از فیلتر عبور می‌کنند می‌شمارند. همچنین توجه داشته باشید که این فیلتر برچسب‌های زمانی را تغییر نمی‌دهد. اگر می‌خواهید برچسب‌های زمانی خروجی از صفر شروع شوند، یک فیلتر setpts بعد از فیلتر trim درج کنید.
.PP
اگر چندین گزینه شروع یا پایان تنظیم شوند، این فیلتر حریصانه تلاش می‌کند و تمام فریم‌هایی را که حداقل با یکی از محدودیت‌های مشخص‌شده مطابقت دارند نگه می‌دارد. برای نگه‌داشتن تنها بخشی که هم‌زمان با تمام محدودیت‌ها مطابقت دارد، چندین فیلتر trim را زنجیره‌ای کنید.
.PP
مقادیر پیش‌فرض به گونه‌ای هستند که کل ورودی نگه داشته می‌شود. بنابراین می‌توان مثلاً تنها مقادیر پایان را تنظیم کرد تا همه چیز پیش از زمان مشخص‌شده نگه داشته شود.
.PP
مثال‌ها:
.IP \(bu 4
دور انداختن همه‌چیز به جز دقیقه دوم ورودی:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-vf trim=60:120
.Ve
.IP \(bu 4
نگه‌داشتن تنها ثانیه اول:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-vf trim=duration=1
.Ve
.SS unpremultiply
.IX Subsection "unpremultiply"
اعمال افکت وارون پیش‌ضرب آلفا (unpremultiply) بر جریان ویدیوی ورودی با استفاده از نخستین صفحه از جریان دوم به عنوان آلفا.
.PP
هر دو جریان باید ابعاد و قالب پیکسلی یکسانی داشته باشند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که پردازش می‌شوند؛ صفحات پردازش‌نشده کپی خواهند شد.
به طور پیش‌فرض با مقدار 0xf، تمام صفحات پردازش می‌شوند.
.Sp
اگر قالب دارای 1 یا 2 مؤلفه باشد، روشنایی (luma) بیت 0 است.
اگر قالب دارای 3 یا 4 مؤلفه باشد:
برای قالب‌های RGB، بیت 0 سبز، بیت 1 آبی و بیت 2 قرمز است؛
برای قالب‌های YUV، بیت 0 روشنایی (luma)، بیت 1 فام رنگ U و بیت 2 فام رنگ V است.
کانال آلفا در صورت وجود، همواره آخرین بیت است.
.IP \fBinplace\fR 4
.IX Item "inplace"
برای پردازش نیازی به ورودی دوم نیست، در عوض از صفحه آلفای جریان ورودی استفاده می‌شود.
.SS unsharp
.IX Subsection "unsharp"
واضح‌سازی (Sharpen) یا تار کردن (blur) ویدیوی ورودی.
.PP
پارامترهای زیر را می‌پذیرد:
.IP "\fBluma_msize_x, lx\fR" 4
.IX Item "luma_msize_x, lx"
تنظیم اندازه افقی ماتریس روشنایی (luma). باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBluma_msize_y, ly\fR" 4
.IX Item "luma_msize_y, ly"
تنظیم اندازه عمودی ماتریس روشنایی (luma). باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBluma_amount, la\fR" 4
.IX Item "luma_amount, la"
تنظیم شدت افکت روشنایی. باید یک عدد ممیز شناور باشد، مقادیر منطقی بین \-1.5 و 1.5 قرار دارند.
.Sp
مقادیر منفی ویدیوی ورودی را تار می‌کنند، در حالی که مقادیر مثبت آن را واضح می‌سازند؛ مقدار صفر افکت را غیرفعال می‌کند.
.Sp
مقدار پیش‌فرض 1.0 است.
.IP "\fBchroma_msize_x, cx\fR" 4
.IX Item "chroma_msize_x, cx"
تنظیم اندازه افقی ماتریس رنگ (chroma). باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBchroma_msize_y, cy\fR" 4
.IX Item "chroma_msize_y, cy"
تنظیم اندازه عمودی ماتریس رنگ (chroma). باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBchroma_amount, ca\fR" 4
.IX Item "chroma_amount, ca"
تنظیم شدت افکت رنگ. باید یک عدد ممیز شناور باشد، مقادیر منطقی بین \-1.5 و 1.5 قرار دارند.
.Sp
مقادیر منفی ویدیوی ورودی را تار می‌کنند، در حالی که مقادیر مثبت آن را واضح می‌سازند؛ مقدار صفر افکت را غیرفعال می‌کند.
.Sp
مقدار پیش‌فرض 0.0 است.
.IP "\fBalpha_msize_x, ax\fR" 4
.IX Item "alpha_msize_x, ax"
تنظیم اندازه افقی ماتریس آلفا. باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBalpha_msize_y, ay\fR" 4
.IX Item "alpha_msize_y, ay"
تنظیم اندازه عمودی ماتریس آلفا. باید یک عدد صحیح فرد بین 3 و 23 باشد. مقدار پیش‌فرض 5 است.
.IP "\fBalpha_amount, aa\fR" 4
.IX Item "alpha_amount, aa"
تنظیم شدت افکت آلفا. باید یک عدد ممیز شناور باشد، مقادیر منطقی بین \-1.5 و 1.5 قرار دارند.
.Sp
مقادیر منفی ویدیوی ورودی را تار می‌کنند، در حالی که مقادیر مثبت آن را واضح می‌سازند؛ مقدار صفر افکت را غیرفعال می‌کند.
.Sp
مقدار پیش‌فرض 0.0 است.
.PP
تمامی پارامترها اختیاری هستند و پیش‌فرض آن‌ها معادل رشته \*(Aq5:5:1.0:5:5:0.0\*(Aq است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال افکت واضح‌سازی شدید روشنایی:
.Sp
.Vb 1
\&        unsharp=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5
.Ve
.IP \(bu 4
اعمال تاری شدید روی هر دو پارامتر روشنایی و رنگ:
.Sp
.Vb 1
\&        unsharp=7:7:\-2:7:7:\-2
.Ve
.SS untile
.IX Subsection "untile"
تجزیه ویدیویی متشکل از تصاویر کاشی‌کاری‌شده (tiled) به تصاویر مجزا.
.PP
نرخ فریم ویدیوی خروجی برابر است با نرخ فریم ویدیوی ورودی ضرب در تعداد کاشی‌ها.
.PP
این فیلتر عکس عمل \fBtile\fR را انجام می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBlayout\fR 4
.IX Item "layout"
تنظیم اندازه شبکه (یعنی تعداد سطرها و ستون‌ها). برای ساختار نحوی این گزینه،
\&\fBبخش "Video size" در دفترچه راهنمای ffmpeg\-utils\fR را بررسی کنید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک ویدیوی 1 ثانیه‌ای از یک پرونده تصویر ثابت شامل 25 فریم که به صورت عمودی روی هم چیده شده‌اند، مانند یک حلقه فیلم آنالوگ:
.Sp
.Vb 1
\&        ffmpeg \-r 1 \-i image.jpg \-vf untile=1x25 movie.mkv
.Ve
.SS uspp
.IX Subsection "uspp"
اعمال یک فیلتر پس‌پردازش فوق‌العاده آهسته/ساده که تصویر را در چندین انتقال (shift) مختلف (یا در سطح کیفی \fBquality\fR برابر \f(CW8\fR، در تمامی شیفت‌ها) فشرده و باز می‌کند و از نتایج میانگین می‌گیرد.
.PP
تفاوت این فیلتر با رفتار spp در این است که uspp عملاً هر حالت را با libavcodec Snow کدگذاری و کدگشایی می‌کند، در حالی که spp از یک DCT ساده‌شده 8x8 فقط درون‌فریمی (intra only) شبیه به MJPEG استفاده می‌نماید.
.PP
این فیلتر در نسخه‌های FFmpeg بین 5.0 و 6.0 در دسترس نیست.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBquality\fR 4
.IX Item "quality"
تنظیم کیفیت. این گزینه تعداد سطوح را برای میانگین‌گیری تعیین می‌کند. یک عدد صحیح در محدوده 0\-8 می‌پذیرد. در صورت تنظیم روی \f(CW0\fR، فیلتر هیچ اثری نخواهد داشت. مقدار \f(CW8\fR به معنای بالاترین کیفیت است. به ازای هر واحد افزایش این مقدار، سرعت تقریباً به نصف کاهش می‌یابد. مقدار پیش‌فرض \f(CW3\fR است.
.IP \fBqp\fR 4
.IX Item "qp"
اجبار به استفاده از یک پارامتر کوانتیزاسیون ثابت. در صورت تنظیم نشدن، فیلتر از QP جریان ویدیو (در صورت وجود) استفاده خواهد کرد.
.IP \fBcodec\fR 4
.IX Item "codec"
استفاده از کدک مشخص‌شده به جای snow.
.SS v360
.IX Subsection "v360"
تبدیل ویدیوهای ۳۶۰ درجه بین قالب‌های مختلف.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinput\fR 4
.IX Item "input"
.PD 0
.IP \fBoutput\fR 4
.IX Item "output"
.PD
تنظیم قالب ویدیوی ورودی/خروجی.
.Sp
قالب‌های موجود:
.RS 4
.IP \fBe\fR 4
.IX Item "e"
.PD 0
.IP \fBequirect\fR 4
.IX Item "equirect"
.PD
تصویرسازی متساوی‌المستطیل (Equirectangular projection).
.IP \fBc3x2\fR 4
.IX Item "c3x2"
.PD 0
.IP \fBc6x1\fR 4
.IX Item "c6x1"
.IP \fBc1x6\fR 4
.IX Item "c1x6"
.PD
نگاشت مکعبی (Cubemap) با چیدمان 3x2/6x1/1x6.
.Sp
گزینه‌های اختصاصی این قالب:
.RS 4
.IP \fBin_pad\fR 4
.IX Item "in_pad"
.PD 0
.IP \fBout_pad\fR 4
.IX Item "out_pad"
.PD
تنظیم نسبت پدینگ (حاشیه) برای نگاشت مکعبی ورودی/خروجی. مقادیر به صورت اعشاری.
.Sp
نمونه مقادیر:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
بدون پدینگ.
.IP \fB0.01\fR 4
.IX Item "0.01"
۱٪ از هر وجه پدینگ است. برای نمونه، با تفکیک‌پذیری 1920x1280 اندازه هر وجه 640x640 خواهد بود و پدینگ از هر طرف ۳ پیکسل است. (640 * 0.01 = 6 پیکسل)
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{0\fR} است.
حداکثر مقدار \fB\fR\f(CB@samp\fR\fB{0.1\fR} است.
.RE
.IP \fBfin_pad\fR 4
.IX Item "fin_pad"
.PD 0
.IP \fBfout_pad\fR 4
.IX Item "fout_pad"
.PD
تنظیم پدینگ ثابت برای نگاشت مکعبی ورودی/خروجی. مقادیر به پیکسل است.
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{0\fR} است. در صورت بزرگتر بودن از صفر، سایر گزینه‌های پدینگ را نادیده می‌گیرد (override می‌کند).
.IP \fBin_forder\fR 4
.IX Item "in_forder"
.PD 0
.IP \fBout_forder\fR 4
.IX Item "out_forder"
.PD
تنظیم ترتیب وجه‌ها برای نگاشت مکعبی ورودی/خروجی. برای هر موقعیت یک جهت را انتخاب کنید.
.Sp
نشانه‌های جهت‌ها:
.RS 4
.IP \fBr\fR 4
.IX Item "r"
راست (right)
.IP \fBl\fR 4
.IX Item "l"
چپ (left)
.IP \fBu\fR 4
.IX Item "u"
بالا (up)
.IP \fBd\fR 4
.IX Item "d"
پایین (down)
.IP \fBf\fR 4
.IX Item "f"
جلو (forward)
.IP \fBb\fR 4
.IX Item "b"
عقب (back)
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{rludfb\fR} است.
.RE
.IP \fBin_frot\fR 4
.IX Item "in_frot"
.PD 0
.IP \fBout_frot\fR 4
.IX Item "out_frot"
.PD
تنظیم چرخش وجه‌ها برای نگاشت مکعبی ورودی/خروجی. برای هر موقعیت یک زاویه انتخاب کنید.
.Sp
نشانه‌های زوایا:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
۰ درجه در جهت ساعت‌گرد
.IP \fB1\fR 4
.IX Item "1"
۹۰ درجه در جهت ساعت‌گرد
.IP \fB2\fR 4
.IX Item "2"
۱۸۰ درجه در جهت ساعت‌گرد
.IP \fB3\fR 4
.IX Item "3"
۲۷۰ درجه در جهت ساعت‌گرد
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{000000\fR} است.
.RE
.RE
.RS 4
.RE
.IP \fBeac\fR 4
.IX Item "eac"
نگاشت مکعبی هم‌زاویه (Equi\-Angular Cubemap).
.IP \fBflat\fR 4
.IX Item "flat"
.PD 0
.IP \fBgnomonic\fR 4
.IX Item "gnomonic"
.IP \fBrectilinear\fR 4
.IX Item "rectilinear"
.PD
ویدیوی معمولی (Regular video).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید (field of view) افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBdfisheye\fR 4
.IX Item "dfisheye"
چشم‌ماهی دوگانه (Dual fisheye).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBbarrel\fR 4
.IX Item "barrel"
.PD 0
.IP \fBfb\fR 4
.IX Item "fb"
.IP \fBbarrelsplit\fR 4
.IX Item "barrelsplit"
.PD
قالب‌های ۳۶۰ درجه فیس‌بوک (Facebook).
.IP \fBsg\fR 4
.IX Item "sg"
قالب برجسته‌نگاری (Stereographic format).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBmercator\fR 4
.IX Item "mercator"
قالب مرکاتور (Mercator format).
.IP \fBball\fR 4
.IX Item "ball"
قالب کروی (Ball format)، اعوجاج قابل توجهی به سمت عقب ایجاد می‌کند.
.IP \fBhammer\fR 4
.IX Item "hammer"
قالب تصویرسازی نقشه هامر\-آیتوف (Hammer\-Aitoff).
.IP \fBsinusoidal\fR 4
.IX Item "sinusoidal"
قالب تصویرسازی نقشه سینوسی (Sinusoidal).
.IP \fBfisheye\fR 4
.IX Item "fisheye"
تصویرسازی چشم‌ماهی (Fisheye projection).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBpannini\fR 4
.IX Item "pannini"
تصویرسازی پانینی (Pannini projection).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
تنظیم پارامتر پانینی خروجی.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
تنظیم پارامتر پانینی ورودی.
.RE
.RS 4
.RE
.IP \fBcylindrical\fR 4
.IX Item "cylindrical"
تصویرسازی استوانه‌ای (Cylindrical projection).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBperspective\fR 4
.IX Item "perspective"
تصویرسازی پرسپکتیو (Perspective projection). \fI(فقط خروجی)\fR
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBv_fov\fR 4
.IX Item "v_fov"
تنظیم پارامتر پرسپکتیو.
.RE
.RS 4
.RE
.IP \fBtetrahedron\fR 4
.IX Item "tetrahedron"
تصویرسازی چهاروجهی (Tetrahedron projection).
.IP \fBtsp\fR 4
.IX Item "tsp"
تصویرسازی هرم مربعی بریده‌شده (Truncated square pyramid projection).
.IP \fBhe\fR 4
.IX Item "he"
.PD 0
.IP \fBhequirect\fR 4
.IX Item "hequirect"
.PD
تصویرسازی نیمه‌متساوی‌المستطیل (Half equirectangular projection).
.IP \fBequisolid\fR 4
.IX Item "equisolid"
قالب هم‌زاویه متقارن (Equisolid format).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBog\fR 4
.IX Item "og"
قالب اورتوگرافیک (Orthographic format).
.Sp
گزینه‌های اختصاصی قالب:
.RS 4
.IP \fBh_fov\fR 4
.IX Item "h_fov"
.PD 0
.IP \fBv_fov\fR 4
.IX Item "v_fov"
.IP \fBd_fov\fR 4
.IX Item "d_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری خروجی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.IP \fBih_fov\fR 4
.IX Item "ih_fov"
.PD 0
.IP \fBiv_fov\fR 4
.IX Item "iv_fov"
.IP \fBid_fov\fR 4
.IX Item "id_fov"
.PD
تنظیم میدان دید افقی/عمودی/قطری ورودی. مقادیر بر حسب درجه.
.Sp
اگر میدان دید قطری تنظیم شود، جایگزین میدان دید افقی و عمودی خواهد شد.
.RE
.RS 4
.RE
.IP \fBoctahedron\fR 4
.IX Item "octahedron"
تصویرسازی هشت‌وجهی (Octahedron projection).
.IP \fBcylindricalea\fR 4
.IX Item "cylindricalea"
تصویرسازی استوانه‌ای هم‌مساحت (Cylindrical Equal Area projection).
.RE
.RS 4
.RE
.IP \fBinterp\fR 4
.IX Item "interp"
تنظیم روش درونیابی.\fIتوجه: روش‌های درونیابی پیچیده‌تر برای اجرا به حافظه بسیار بیشتری نیاز دارند.\fR
.Sp
روش‌های موجود:
.RS 4
.IP \fBnear\fR 4
.IX Item "near"
.PD 0
.IP \fBnearest\fR 4
.IX Item "nearest"
.PD
نزدیک‌ترین همسایه (Nearest neighbour).
.IP \fBline\fR 4
.IX Item "line"
.PD 0
.IP \fBlinear\fR 4
.IX Item "linear"
.PD
درونیابی دوسطحی (Bilinear).
.IP \fBlagrange9\fR 4
.IX Item "lagrange9"
درونیابی لاگرانژ ۹ (Lagrange9).
.IP \fBcube\fR 4
.IX Item "cube"
.PD 0
.IP \fBcubic\fR 4
.IX Item "cubic"
.PD
درونیابی دومکعبی (Bicubic).
.IP \fBlanc\fR 4
.IX Item "lanc"
.PD 0
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.PD
درونیابی لانچوز (Lanczos).
.IP \fBsp16\fR 4
.IX Item "sp16"
.PD 0
.IP \fBspline16\fR 4
.IX Item "spline16"
.PD
درونیابی اسپیلاین ۱۶ (Spline16).
.IP \fBgauss\fR 4
.IX Item "gauss"
.PD 0
.IP \fBgaussian\fR 4
.IX Item "gaussian"
.PD
درونیابی گاوسی (Gaussian).
.IP \fBmitchell\fR 4
.IX Item "mitchell"
درونیابی میچل (Mitchell).
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{line\fR} است.
.RE
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم تفکیک‌پذیری (رزولوشن) ویدیوی خروجی.
.Sp
تفکیک‌پذیری پیش‌فرض به قالب‌ها بستگی دارد.
.IP \fBin_stereo\fR 4
.IX Item "in_stereo"
.PD 0
.IP \fBout_stereo\fR 4
.IX Item "out_stereo"
.PD
تنظیم قالب استریوی ورودی/خروجی.
.RS 4
.IP \fB2d\fR 4
.IX Item "2d"
دوبعدی مونو (2D mono)
.IP \fBsbs\fR 4
.IX Item "sbs"
کنار هم (Side by side)
.IP \fBtb\fR 4
.IX Item "tb"
بالا پایین (Top bottom)
.RE
.RS 4
.Sp
مقدار پیش‌فرض برای قالب ورودی و خروجی \fR\f(CB@samp\fR\fB{2d\fR} است.
.RE
.IP \fByaw\fR 4
.IX Item "yaw"
.PD 0
.IP \fBpitch\fR 4
.IX Item "pitch"
.IP \fBroll\fR 4
.IX Item "roll"
.PD
تنظیم چرخش برای ویدیوی خروجی. مقادیر بر حسب درجه.
.IP \fBrorder\fR 4
.IX Item "rorder"
تنظیم ترتیب چرخش برای ویدیوی خروجی. برای هر موقعیت یک مورد را انتخاب کنید.
.RS 4
.IP "\fBy, Y\fR" 4
.IX Item "y, Y"
یاو / چرخش افقی (yaw)
.IP "\fBp, P\fR" 4
.IX Item "p, P"
پیچ / زاویه شیب (pitch)
.IP "\fBr, R\fR" 4
.IX Item "r, R"
رول / غلتش (roll)
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fR\f(CB@samp\fR\fB{ypr\fR} است.
.RE
.IP \fBh_flip\fR 4
.IX Item "h_flip"
.PD 0
.IP \fBv_flip\fR 4
.IX Item "v_flip"
.IP \fBd_flip\fR 4
.IX Item "d_flip"
.PD
برگرداندن ویدیوی خروجی به صورت افقی (جابجایی چپ\-راست) / عمودی (جابجایی بالا\-پایین) / در عمق (جابجایی عقب\-جلو). مقادیر بولی.
.IP \fBih_flip\fR 4
.IX Item "ih_flip"
.PD 0
.IP \fBiv_flip\fR 4
.IX Item "iv_flip"
.PD
تعیین این که آیا ویدیوی ورودی به صورت افقی/عمودی برگردانده شود یا خیر. مقادیر بولی.
.IP \fBin_trans\fR 4
.IX Item "in_trans"
تعیین این که آیا ویدیوی ورودی ترانهاده (transposed) شود یا خیر. مقدار بولی، به طور پیش‌فرض غیرفعال است.
.IP \fBout_trans\fR 4
.IX Item "out_trans"
تعیین این که آیا ویدیوی خروجی نیاز به ترانهش دارد یا خیر. مقدار بولی، به طور پیش‌فرض غیرفعال است.
.IP \fBh_offset\fR 4
.IX Item "h_offset"
.PD 0
.IP \fBv_offset\fR 4
.IX Item "v_offset"
.PD
تنظیم آفست غیرمحوری افقی/عمودی خروجی. مقدار پیش‌فرض روی 0 تنظیم شده است.
محدوده مجاز از \-1 تا 1 است.
.IP \fBalpha_mask\fR 4
.IX Item "alpha_mask"
ساخت ماسک در صفحه آلفا برای تمام پیکسل‌های نگاشت‌نشده با علامت‌گذاری آنها به عنوان کاملاً شفاف. مقدار بولی، به طور پیش‌فرض غیرفعال است.
.IP \fBreset_rot\fR 4
.IX Item "reset_rot"
بازنشانی چرخش ویدیوی خروجی. مقدار بولی، به طور پیش‌فرض غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تبدیل ویدیوی متساوی‌المستطیل به نگاشت مکعبی با چیدمان 3x2 و پدینگ ۱٪ با استفاده از درونیابی دومکعبی:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-vf v360=e:c3x2:cubic:out_pad=0.01 output.mkv
.Ve
.IP \(bu 4
استخراج نمای عقب از نگاشت مکعبی هم‌زاویه:
.Sp
.Vb 1
\&        ffmpeg \-i input.mkv \-vf v360=eac:flat:yaw=180 output.mkv
.Ve
.IP \(bu 4
تبدیل نگاشت مکعبی هم‌زاویه ترانهاده و به صورت افقی برگردانده‌شده در قالب استریوی کنار هم به قالب استریوی متساوی‌المستطیل بالا-پایین:
.Sp
.Vb 1
\&        v360=eac:equirect:in_stereo=sbs:in_trans=1:ih_flip=1:out_stereo=tb
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از زیرمجموعه‌ای از گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS vaguedenoiser
.IX Subsection "vaguedenoiser"
اعمال یک حذف‌کننده نویز (denoiser) مبتنی بر موجک (wavelet).
.PP
این فیلتر هر فریم را از ورودی ویدیو با استفاده از Cohen\-Daubechies\-Feauveau 9/7 به دامنه موجک تبدیل می‌کند. سپس مقداری فیلتر روی ضرایب به‌دست‌آمده اعمال می‌نماید. پس از آن تبدیل معکوس موجک انجام می‌دهد. با توجه به ویژگی‌های موجک، این روش باید نتیجه‌ای هموار و نویز کاهش‌یافته را بدون محو کردن ویژگی‌های تصویر به همراه داشته باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold\fR 4
.IX Item "threshold"
شدت فیلتر کردن. هرچه بالاتر باشد، ویدیو بیشتر فیلتر خواهد شد.
آستانه‌گذاری سخت (Hard thresholding) می‌تواند پیش از آنکه ویدیو بیش از حد فیلترشده به نظر برسد، از آستانه بالاتری نسبت به آستانه‌گذاری نرم استفاده کند. مقدار پیش‌فرض 2 است.
.IP \fBmethod\fR 4
.IX Item "method"
روش فیلتر کردنی که فیلتر استفاده خواهد کرد.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBhard\fR 4
.IX Item "hard"
تمام مقادیر زیر آستانه صفر می‌شوند.
.IP \fBsoft\fR 4
.IX Item "soft"
تمام مقادیر زیر آستانه صفر می‌شوند. تمام مقادیر بالاتر به اندازه آستانه کاهش می‌یابند.
.IP \fBgarrote\fR 4
.IX Item "garrote"
ضرایب را مقیاس‌بندی یا صفر می‌کند \- حالتی بینابین آستانه‌گذاری (بیشتر) نرم و (کمتر) سخت.
.RE
.RS 4
.Sp
پیش‌فرض garrote است.
.RE
.IP \fBnsteps\fR 4
.IX Item "nsteps"
تعداد دفعاتی که موجک تصویر را تجزیه می‌کند. تصویر نمی‌تواند فراتر از یک نقطه مشخص تجزیه شود (معمولاً 8 برای یک فریم 640x480 \- زیرا 2^9 = 512 > 480). مقادیر معتبر اعداد صحیح بین 1 و 32 هستند. مقدار پیش‌فرض 6 است.
.IP \fBpercent\fR 4
.IX Item "percent"
حذف نویز جزئی یا کامل (کاهش محدود ضرایب)، از 0 تا 100. مقدار پیش‌فرض 85 است.
.IP \fBplanes\fR 4
.IX Item "planes"
فهرستی از صفحاتی که باید پردازش شوند. به طور پیش‌فرض تمام صفحات پردازش می‌شوند.
.IP \fBtype\fR 4
.IX Item "type"
نوع آستانه‌ای که فیلتر استفاده خواهد کرد.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBuniversal\fR 4
.IX Item "universal"
آستانه مورد استفاده برای تمام تجزیه‌ها یکسان است.
.IP \fBbayes\fR 4
.IX Item "bayes"
آستانه مورد استفاده به ضرایب هر تجزیه نیز بستگی دارد.
.RE
.RS 4
.Sp
پیش‌فرض universal است.
.RE
.SS varblur
.IX Subsection "varblur"
اعمال فیلتر تاری متغیر با استفاده از جریان ویدیوی دوم برای تنظیم شعاع تاری.
جریان دوم باید ابعاد یکسانی داشته باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmin_r\fR 4
.IX Item "min_r"
تنظیم حداقل شعاع مجاز. محدوده مجاز از 0 تا 254 است. پیش‌فرض 0 است.
.IP \fBmax_r\fR 4
.IX Item "max_r"
تنظیم حداکثر شعاع مجاز. محدوده مجاز از 1 تا 255 است. پیش‌فرض 8 است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحاتی که باید پردازش شوند. به طور پیش‌فرض، همه استفاده می‌شوند.
.PP
فیلتر \f(CW\*(C`varblur\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS vectorscope
.IX Subsection "vectorscope"
نمایش مقادیر ۲ مؤلفه رنگی در نمودار دوبعدی (که وکتوراسکوپ نامیده می‌شود).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت وکتوراسکوپ.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBgray\fR 4
.IX Item "gray"
.PD 0
.IP \fBtint\fR 4
.IX Item "tint"
.PD
مقادیر خاکستری در نمودار نمایش داده می‌شوند؛ روشنایی بالاتر به این معنی است که پیکسل‌های بیشتری دارای مقدار رنگی یکسان برای آن مؤلفه در آن موقعیت از نمودار هستند. این حالت پیش‌فرض است.
.IP \fBcolor\fR 4
.IX Item "color"
مقادیر خاکستری در نمودار نمایش داده می‌شوند. مقادیر پیکسل‌های اطراف که در فریم ویدیو وجود ندارند، با گرادیانی از ۲ مؤلفه رنگ که با گزینه‌های \f(CW\*(C`x\*(C'\fR و \f(CW\*(C`y\*(C'\fR تنظیم شده‌اند رسم می‌شوند. مؤلفه رنگ سوم ایستا (استاتیک) است.
.IP \fBcolor2\fR 4
.IX Item "color2"
مقادیر مؤلفه‌های رنگ واقعی موجود در فریم ویدیو در نمودار نمایش داده می‌شوند.
.IP \fBcolor3\fR 4
.IX Item "color3"
مشابه color2 اما تکرار بالاتر مقادیر یکسان \f(CW\*(C`x\*(C'\fR و \f(CW\*(C`y\*(C'\fR در نمودار، مقدار مؤلفه رنگ دیگر را افزایش می‌دهد که با مقادیر پیش‌فرض \f(CW\*(C`x\*(C'\fR و \f(CW\*(C`y\*(C'\fR روشنایی (درخشندگی) است.
.IP \fBcolor4\fR 4
.IX Item "color4"
رنگ‌های واقعی موجود در فریم ویدیو در نمودار نمایش داده می‌شوند. اگر دو رنگ مختلف به یک موقعیت در نمودار نگاشت شوند، رنگ با مقدار بالاتر از مؤلفه‌ای که در نمودار وجود ندارد انتخاب می‌شود.
.IP \fBcolor5\fR 4
.IX Item "color5"
مقادیر خاکستری در نمودار نمایش داده می‌شوند. مشابه \f(CW\*(C`color\*(C'\fR اما مؤلفه رنگ سوم از گرادیان شعاعی انتخاب می‌شود.
.RE
.RS 4
.RE
.IP \fBx\fR 4
.IX Item "x"
تعیین این که کدام مؤلفه رنگ روی محور X نشان داده شود. پیش‌فرض \f(CW1\fR است.
.IP \fBy\fR 4
.IX Item "y"
تعیین این که کدام مؤلفه رنگ روی محور Y نشان داده شود. پیش‌فرض \f(CW2\fR است.
.IP "\fBintensity, i\fR" 4
.IX Item "intensity, i"
تنظیم شدت، مورد استفاده در حالت‌های: gray، color، color3 و color5 برای افزایش روشنایی مؤلفه رنگی که فراوانی موقعیت (X, Y) را در نمودار نشان می‌دهد.
.IP "\fBenvelope, e\fR" 4
.IX Item "envelope, e"
.RS 4
.PD 0
.IP \fBnone\fR 4
.IX Item "none"
.PD
بدون پوش (envelope)، این حالت پیش‌فرض است.
.IP \fBinstant\fR 4
.IX Item "instant"
پوش آنی، حتی تاریک‌ترین تک‌پیکسل نیز به وضوح برجسته خواهد شد.
.IP \fBpeak\fR 4
.IX Item "peak"
نگه‌داشتن مقادیر بیشینه و کمینه ارائه‌شده در نمودار در طول زمان. از این طریق همچنان می‌توانید مقادیر خارج از محدوده را بدون نگاه مداوم به وکتوراسکوپ تشخیص دهید.
.IP \fBpeak+instant\fR 4
.IX Item "peak+instant"
ترکیب هم‌زمان پوش اوج و آنی.
.RE
.RS 4
.RE
.IP "\fBgraticule, g\fR" 4
.IX Item "graticule, g"
تنظیم نوع شبکه مدرج (graticule) برای رسم.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
.PD 0
.IP \fBgreen\fR 4
.IX Item "green"
.IP \fBcolor\fR 4
.IX Item "color"
.IP \fBinvert\fR 4
.IX Item "invert"
.PD
.RE
.RS 4
.RE
.IP "\fBopacity, o\fR" 4
.IX Item "opacity, o"
تنظیم کدر بودن (شفافیت معکوس) شبکه مدرج.
.IP "\fBflags, f\fR" 4
.IX Item "flags, f"
تنظیم پرچم‌های شبکه مدرج.
.RS 4
.IP \fBwhite\fR 4
.IX Item "white"
رسم شبکه مدرج برای نقطه سفید.
.IP \fBblack\fR 4
.IX Item "black"
رسم شبکه مدرج برای نقطه سیاه.
.IP \fBname\fR 4
.IX Item "name"
رسم نام‌های کوتاه نقاط رنگی.
.RE
.RS 4
.RE
.IP "\fBbgopacity, b\fR" 4
.IX Item "bgopacity, b"
تنظیم کدر بودن پس‌زمینه.
.IP "\fBlthreshold, l\fR" 4
.IX Item "lthreshold, l"
تنظیم آستانه پایین برای مؤلفه رنگی که روی محور X یا Y نمایش داده نمی‌شود.
مقادیر پایین‌تر از این مقدار نادیده گرفته می‌شوند. پیش‌فرض 0 است.
توجه داشته باشید که این مقدار در حداکثر مقدار ممکن واقعی که یک مؤلفه پیکسل می‌تواند داشته باشد ضرب می‌شود. بنابراین برای ورودی 8\-بیتی و مقدار آستانه پایین 0.1، آستانه واقعی برابر است با 0.1 * 255 = 25.
.IP "\fBhthreshold, h\fR" 4
.IX Item "hthreshold, h"
تنظیم آستانه بالا برای مؤلفه رنگی که روی محور X یا Y نمایش داده نمی‌شود.
مقادیر بالاتر از این مقدار نادیده گرفته می‌شوند. پیش‌فرض 1 است.
توجه داشته باشید که این مقدار در حداکثر مقدار ممکن واقعی که یک مؤلفه پیکسل می‌تواند داشته باشد ضرب می‌شود. بنابراین برای ورودی 8\-بیتی و مقدار آستانه بالا 0.9، آستانه واقعی برابر است با 0.9 * 255 = 230.
.IP "\fBcolorspace, c\fR" 4
.IX Item "colorspace, c"
تعیین فضای رنگی مورد استفاده هنگام رسم شبکه مدرج.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
.PD 0
.IP \fB601\fR 4
.IX Item "601"
.IP \fB709\fR 4
.IX Item "709"
.PD
.RE
.RS 4
.Sp
پیش‌فرض auto است.
.RE
.IP "\fBtint0, t0\fR" 4
.IX Item "tint0, t0"
.PD 0
.IP "\fBtint1, t1\fR" 4
.IX Item "tint1, t1"
.PD
تنظیم ته‌رنگ (tint) برای حالت وکتوراسکوپ gray/tint. به طور پیش‌فرض هر دو گزینه صفر هستند.
این به معنای نبود ته‌رنگ است و خروجی به رنگ خاکستری باقی می‌ماند.
.SS vidstabdetect
.IX Subsection "vidstabdetect"
تحلیل پایداری ویدیو / لرزش‌گیری (deshaking). انجام پاس 1 از 2، برای پاس 2 به
\&\fBvidstabtransform\fR مراجعه کنید.
.PP
این فیلتر پرونده‌ای حاوی اطلاعات تبدیلات چرخش و انتقال نسبی فریم‌های بعدی تولید می‌کند که سپس توسط فیلتر \fBvidstabtransform\fR استفاده می‌شود.
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libvidstab\*(C'\fR پیکربندی کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBresult\fR 4
.IX Item "result"
تنظیم مسیر پرونده‌ای که برای نوشتن اطلاعات تبدیلات استفاده می‌شود.
مقدار پیش‌فرض \fItransforms.trf\fR است.
.IP \fBshakiness\fR 4
.IX Item "shakiness"
تنظیم میزان لرزش ویدیو و سرعت حرکت دوربین. این گزینه یک عدد صحیح در بازه 1\-10 می‌پذیرد؛ مقدار 1 به معنای لرزش کم و مقدار 10 به معنای لرزش شدید است. مقدار پیش‌فرض 5 است.
.IP \fBaccuracy\fR 4
.IX Item "accuracy"
تنظیم دقت فرایند تشخیص. باید مقداری در بازه 1\-15 باشد. مقدار 1 به معنای دقت کم و مقدار 15 به معنای دقت زیاد است. مقدار پیش‌فرض 15 است.
.IP \fBstepsize\fR 4
.IX Item "stepsize"
تنظیم اندازه گام (stepsize) فرایند جستجو. ناحیه اطراف مقدار کمینه با تفکیک‌پذیری 1 پیکسل پویش می‌شود. مقدار پیش‌فرض 6 است.
.IP \fBmincontrast\fR 4
.IX Item "mincontrast"
تنظیم حداقل کنتراست. میدان اندازه‌گیری محلی زیر این مقدار دور انداخته می‌شود. باید یک مقدار ممیز شناور در بازه 0\-1 باشد. مقدار پیش‌فرض 0.3 است.
.IP \fBtripod\fR 4
.IX Item "tripod"
تنظیم شماره فریم مرجع برای حالت سه‌پایه (tripod).
.Sp
در صورت فعال بودن، حرکت فریم‌ها با یک فریم مرجع در استریم فیلترشده که با شماره مشخص‌شده تعیین می‌شود، مقایسه می‌گردد. ایده این است که تمام حرکات در یک صحنه کم‌وبیش ایستا جبران شوند و نمای دوربین کاملاً ثابت نگه داشته شود.
.Sp
اگر روی 0 تنظیم شود، غیرفعال خواهد بود. شمارش فریم‌ها از 1 شروع می‌شود.
.IP \fBshow\fR 4
.IX Item "show"
نمایش میدان‌ها و تبدیلات در فریم‌های خروجی حاصل. یک عدد صحیح در بازه 0\-2 می‌پذیرد. مقدار پیش‌فرض 0 است که هرگونه مصورسازی را غیرفعال می‌کند.
.IP \fBfileformat\fR 4
.IX Item "fileformat"
قالب پرونده داده‌های تبدیلات برای نوشتن.
مقادیر پذیرفتنی عبارتند از:
.RS 4
.IP \fBascii\fR 4
.IX Item "ascii"
متن ساده خوانا برای انسان
.IP \fBbinary\fR 4
.IX Item "binary"
قالب دودویی، تقریباً 40% کوچک‌تر از \f(CW\*(C`ascii\*(C'\fR. (\fIپیش‌فرض\fR)
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از مقادیر پیش‌فرض:
.Sp
.Vb 1
\&        vidstabdetect
.Ve
.IP \(bu 4
تحلیل فیلم با لرزش شدید و قرار دادن نتایج در پرونده
\&\fImytransforms.trf\fR:
.Sp
.Vb 1
\&        vidstabdetect=shakiness=10:accuracy=15:result="mytransforms.trf"
.Ve
.IP \(bu 4
مصورسازی نتیجه تبدیلات درونی در ویدیوی حاصل:
.Sp
.Vb 1
\&        vidstabdetect=show=1
.Ve
.IP \(bu 4
تحلیل یک ویدیو با لرزش متوسط با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i input \-vf vidstabdetect=shakiness=5:show=1 dummy.avi
.Ve
.SS vidstabtransform
.IX Subsection "vidstabtransform"
پایداری ویدیو / لرزش‌گیری: پاس 2 از 2،
برای پاس 1 به \fBvidstabdetect\fR مراجعه کنید.
.PP
خواندن یک پرونده با اطلاعات تبدیل برای هر فریم و اعمال/جبران‌سازی آن‌ها. این فیلتر به همراه فیلتر \fBvidstabdetect\fR می‌تواند برای لرزش‌گیری ویدیوها استفاده شود. همچنین ببینید
<\fBhttp://public.hronopik.de/vid.stab\fR>. استفاده از فیلتر \fBunsharp\fR نیز مهم است، به بخش زیر مراجعه کنید.
.PP
برای فعال‌سازی کامپایل این فیلتر باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libvidstab\*(C'\fR پیکربندی کنید.
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.IP \fBinput\fR 4
.IX Item "input"
تنظیم مسیر پرونده مورد استفاده برای خواندن تبدیلات. مقدار پیش‌فرض
\&\fItransforms.trf\fR است.
.IP \fBsmoothing\fR 4
.IX Item "smoothing"
تنظیم تعداد فریم‌ها (مقدار*2 + 1) مورد استفاده برای فیلتر پایین‌گذر حرکات دوربین. مقدار پیش‌فرض 10 است.
.Sp
برای مثال مقدار 10 به این معنی است که از 21 فریم (10 فریم در گذشته و 10 فریم در آینده) برای هموارسازی حرکت در ویدیو استفاده می‌شود. مقدار بزرگ‌تر منجر به ویدیوی هموارتر می‌شود، اما شتاب دوربین (حرکات pan/tilt) را محدود می‌کند. 0 یک حالت خاص است که در آن دوربین ثابت شبیه‌سازی می‌شود.
.IP \fBoptalgo\fR 4
.IX Item "optalgo"
تنظیم الگوریتم بهینه‌سازی مسیر دوربین.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBgauss\fR 4
.IX Item "gauss"
فیلتر پایین‌گذر هسته گاوسی روی حرکت دوربین (پیش‌فرض)
.IP \fBavg\fR 4
.IX Item "avg"
میانگین‌گیری روی تبدیلات
.RE
.RS 4
.RE
.IP \fBmaxshift\fR 4
.IX Item "maxshift"
تنظیم حداکثر تعداد پیکسل‌ها برای جابجایی فریم‌ها. مقدار پیش‌فرض \-1 است، به معنای نامحدود.
.IP \fBmaxangle\fR 4
.IX Item "maxangle"
تنظیم حداکثر زاویه بر حسب رادیان (درجه*PI/180) برای چرخش فریم‌ها. مقدار پیش‌فرض \-1 است، به معنای نامحدود.
.IP \fBcrop\fR 4
.IX Item "crop"
تعیین نحوه برخورد با حاشیه‌هایی که ممکن است به دلیل جبران‌سازی حرکت نمایان شوند.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBkeep\fR 4
.IX Item "keep"
نگه‌داشتن اطلاعات تصویر از فریم پیشین (پیش‌فرض)
.IP \fBblack\fR 4
.IX Item "black"
پر کردن حاشیه با رنگ سیاه
.RE
.RS 4
.RE
.IP \fBinvert\fR 4
.IX Item "invert"
معکوس کردن تبدیلات در صورت تنظیم روی 1. مقدار پیش‌فرض 0 است.
.IP \fBrelative\fR 4
.IX Item "relative"
در نظر گرفتن تبدیلات به صورت نسبی به فریم پیشین در صورت تنظیم روی 1، و مطلق در صورت تنظیم روی 0. مقدار پیش‌فرض 0 است.
.IP \fBzoom\fR 4
.IX Item "zoom"
تنظیم درصد بزرگ‌نمایی (zoom). مقدار مثبت منجر به اثر بزرگ‌نمایی (zoom\-in) و مقدار منفی منجر به اثر کوچک‌نمایی (zoom\-out) می‌شود. مقدار پیش‌فرض 0 است (بدون بزرگ‌نمایی).
.IP \fBoptzoom\fR 4
.IX Item "optzoom"
تنظیم بزرگ‌نمایی بهینه برای جلوگیری از ایجاد حاشیه‌ها.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
غیرفعال
.IP \fB1\fR 4
.IX Item "1"
مقدار بزرگ‌نمایی ایستای بهینه تعیین می‌شود (تنها حرکات بسیار شدید منجر به حاشیه‌های مشهود می‌شوند) (پیش‌فرض)
.IP \fB2\fR 4
.IX Item "2"
مقدار بزرگ‌نمایی تطبیقی بهینه تعیین می‌شود (هیچ حاشیه‌ای نمایان نخواهد شد)، به \fBzoomspeed\fR مراجعه کنید.
.RE
.RS 4
.Sp
توجه داشته باشید که مقدار داده‌شده در zoom به مقدار محاسبه‌شده در اینجا اضافه می‌شود.
.RE
.IP \fBzoomspeed\fR 4
.IX Item "zoomspeed"
تنظیم حداکثر درصد بزرگ‌نمایی در هر فریم (در صورتی که \fBoptzoom\fR روی 2 تنظیم شده باشد فعال می‌شود). بازه از 0 تا 5 است، مقدار پیش‌فرض 0.25 است.
.IP \fBinterpol\fR 4
.IX Item "interpol"
تعیین نوع درون‌یابی (interpolation).
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBno\fR 4
.IX Item "no"
بدون درون‌یابی
.IP \fBlinear\fR 4
.IX Item "linear"
خطی فقط به صورت افقی
.IP \fBbilinear\fR 4
.IX Item "bilinear"
خطی در هر دو جهت (پیش‌فرض)
.IP \fBbicubic\fR 4
.IX Item "bicubic"
مکعبی در هر دو جهت (کند)
.RE
.RS 4
.RE
.IP \fBtripod\fR 4
.IX Item "tripod"
فعال‌سازی حالت سه‌پایه مجازی در صورت تنظیم روی 1، که معادل
\&\f(CW\*(C`relative=0:smoothing=0\*(C'\fR است. مقدار پیش‌فرض 0 است.
.Sp
همچنین از گزینه \f(CW\*(C`tripod\*(C'\fR در \fBvidstabdetect\fR استفاده کنید.
.IP \fBdebug\fR 4
.IX Item "debug"
افزایش سطح جزئیات گزارش‌ها در صورت تنظیم روی 1. همچنین حرکات سراسری شناسایی‌شده در پرونده موقت \fIglobal_motions.trf\fR نوشته می‌شوند. مقدار پیش‌فرض 0 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از \fBffmpeg\fR برای یک پایداری‌سازی معمول با مقادیر پیش‌فرض:
.Sp
.Vb 1
\&        ffmpeg \-i inp.mpeg \-vf vidstabtransform,unsharp=5:5:0.8:3:3:0.4 inp_stabilized.mpeg
.Ve
.Sp
به استفاده از فیلتر \fBunsharp\fR که همواره توصیه می‌شود توجه کنید.
.IP \(bu 4
بزرگ‌نمایی کمی بیشتر و بارگذاری داده‌های تبدیل از یک پرونده مشخص:
.Sp
.Vb 1
\&        vidstabtransform=zoom=5:input="mytransforms.trf"
.Ve
.IP \(bu 4
هموارسازی باز هم بیشتر ویدیو:
.Sp
.Vb 1
\&        vidstabtransform=smoothing=30
.Ve
.SS vflip
.IX Subsection "vflip"
برگرداندن (flip) عمودی ویدیوی ورودی.
.PP
برای مثال، برای برگرداندن عمودی یک ویدیو با \fBffmpeg\fR:
.PP
.Vb 1
\&        ffmpeg \-i in.avi \-vf "vflip" out.avi
.Ve
.SS vfrdet
.IX Subsection "vfrdet"
تشخیص نرخ فریم متغیر ویدیو.
.PP
این فیلتر سعی می‌کند تشخیص دهد که آیا ورودی نرخ فریم متغیر دارد یا ثابت.
.PP
در پایان، تعداد فریم‌هایی که با delta pts متغیر تشخیص داده شده‌اند و فریم‌هایی با delta pts ثابت را در خروجی نمایش می‌دهد.
اگر فریم‌هایی با دلتای متغیر وجود داشته باشند، کمینه، بیشینه و میانگین دلتای مشاهده‌شده را نیز نشان خواهد داد.
.SS vibrance
.IX Subsection "vibrance"
تقویت یا تغییر اشباع رنگ (saturation).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBintensity\fR 4
.IX Item "intensity"
تنظیم شدت تقویت در صورت مثبت بودن مقدار یا شدت تغییر در صورت منفی بودن مقدار.
پیش‌فرض 0 است. بازه مجاز از \-2 تا 2 است.
.IP \fBrbal\fR 4
.IX Item "rbal"
تنظیم تعادل رنگ قرمز. پیش‌فرض 1 است. بازه مجاز از \-10 تا 10 است.
.IP \fBgbal\fR 4
.IX Item "gbal"
تنظیم تعادل رنگ سبز. پیش‌فرض 1 است. بازه مجاز از \-10 تا 10 است.
.IP \fBbbal\fR 4
.IX Item "bbal"
تنظیم تعادل رنگ آبی. پیش‌فرض 1 است. بازه مجاز از \-10 تا 10 است.
.IP \fBrlum\fR 4
.IX Item "rlum"
تنظیم ضریب روشنایی (luma) قرمز.
.IP \fBglum\fR 4
.IX Item "glum"
تنظیم ضریب روشنایی (luma) سبز.
.IP \fBblum\fR 4
.IX Item "blum"
تنظیم ضریب روشنایی (luma) آبی.
.IP \fBalternate\fR 4
.IX Item "alternate"
اگر \f(CW\*(C`intensity\*(C'\fR منفی باشد و این گزینه روی 1 تنظیم شود، رنگ‌ها تغییر خواهند کرد،
در غیر این صورت اشباع رنگ‌ها کمتر شده و بیشتر به سمت خاکستری میل می‌کنند.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS vif
.IX Subsection "vif"
به دست آوردن میانگین VIF (Visual Information Fidelity) بین دو ویدیوی ورودی.
.PP
این فیلتر دو ویدیوی ورودی می‌گیرد.
.PP
هر دو ویدیوی ورودی باید رزولوشن و قالب پیکسلی یکسانی داشته باشند تا این فیلتر به درستی کار کند. همچنین فرض می‌شود که هر دو ورودی تعداد فریم‌های یکسانی دارند که یک‌به‌یک با هم مقایسه می‌شوند.
.PP
امتیاز میانگین VIF به دست آمده از طریق سیستم گزارش‌گیری (logging) چاپ می‌شود.
.PP
فیلتر امتیاز VIF محاسبه‌شده برای هر فریم را ذخیره می‌کند.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
در مثال زیر پرونده ورودی \fImain.mpg\fR که در حال پردازش است با پرونده مرجع \fIref.mpg\fR مقایسه می‌شود.
.PP
.Vb 1
\&        ffmpeg \-i main.mpg \-i ref.mpg \-lavfi vif \-f null \-
.Ve
.SS vignette
.IX Subsection "vignette"
ایجاد یا معکوس کردن افکت وینیت (vignetting) طبیعی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBangle, a\fR" 4
.IX Item "angle, a"
تنظیم عبارت زاویه لنز به عنوان تعدادی رادیان.
.Sp
مقدار در بازه \f(CW\*(C`[0,PI/2]\*(C'\fR محدود (clip) می‌شود.
.Sp
مقدار پیش‌فرض: \f(CW"PI/5"\fR
.IP \fBx0\fR 4
.IX Item "x0"
.PD 0
.IP \fBy0\fR 4
.IX Item "y0"
.PD
تنظیم عبارات مختصات مرکز. به طور پیش‌فرض به ترتیب \f(CW"w/2"\fR و \f(CW"h/2"\fR.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت مستقیم/معکوس (forward/backward).
.Sp
حالت‌های موجود عبارتند از:
.RS 4
.IP \fBforward\fR 4
.IX Item "forward"
هر چه فاصله از نقطه مرکزی بیشتر شود، تصویر تاریک‌تر می‌شود.
.IP \fBbackward\fR 4
.IX Item "backward"
هر چه فاصله از نقطه مرکزی بیشتر شود، تصویر روشن‌تر می‌شود.
این حالت می‌تواند برای معکوس کردن افکت وینیت استفاده شود، هرچند هنوز هیچ تشخیص خودکاری برای استخراج \fBangle\fR لنز و سایر تنظیمات وجود ندارد. همچنین می‌تواند برای ایجاد یک افکت سوختگی (burning) استفاده شود.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBforward\fR است.
.RE
.IP \fBeval\fR 4
.IX Item "eval"
تنظیم حالت ارزیابی عبارات (\fBangle\fR، \fBx0\fR، \fBy0\fR).
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
ارزیابی عبارات فقط یک بار در طول مقداردهی اولیه فیلتر.
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارات برای هر فریم ورودی. این حالت بسیار کندتر از حالت \fBinit\fR است زیرا نیاز دارد تمام مقیاس‌بندها دوباره محاسبه شوند، اما امکان استفاده از عبارات پویای پیشرفته را فراهم می‌کند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBinit\fR است.
.RE
.IP \fBdither\fR 4
.IX Item "dither"
تنظیم دیترینگ (dithering) برای کاهش اثرات نواری دایره‌ای (circular banding). پیش‌فرض \f(CW1\fR (فعال) است.
.IP \fBaspect\fR 4
.IX Item "aspect"
تنظیم نسبت ابعاد وینیت. این تنظیم امکان تغییر شکل وینیت را فراهم می‌کند.
تنظیم این مقدار روی SAR ورودی، یک وینیت مستطیلی متناسب با ابعاد ویدیو ایجاد می‌کند.
.Sp
پیش‌فرض \f(CW\*(C`1/1\*(C'\fR است.
.PP
\fIعبارات\fR
.IX Subsection "Expressions"
.PP
عبارات \fBalpha\fR، \fBx0\fR و \fBy0\fR می‌توانند شامل پارامترهای زیر باشند:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع ورودی
.IP \fBn\fR 4
.IX Item "n"
شماره فریم ورودی، شروع از 0
.IP \fBpts\fR 4
.IX Item "pts"
زمان برچسب زمانی نمایش (PTS) فریم ویدیوی فیلترشده، بیان‌شده در واحدهای \fITB\fR، در صورت تعریف نشدن NAN
.IP \fBr\fR 4
.IX Item "r"
نرخ فریم ویدیوی ورودی، در صورت نامشخص بودن نرخ فریم ورودی NAN
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی نمایش (PTS) فریم ویدیوی فیلترشده، بیان‌شده به ثانیه، در صورت تعریف نشدن NAN
.IP \fBtb\fR 4
.IX Item "tb"
پایه زمانی (time base) ویدیوی ورودی
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال یک افکت وینیت قوی ساده:
.Sp
.Vb 1
\&        vignette=PI/4
.Ve
.IP \(bu 4
ایجاد یک وینیت چشمک‌زن:
.Sp
.Vb 1
\&        vignette=\*(AqPI/4+random(1)*PI/50\*(Aq:eval=frame
.Ve
.SS vmafmotion
.IX Subsection "vmafmotion"
به دست آوردن میانگین امتیاز حرکت VMAF یک ویدیو.
این یکی از معیارهای سازنده VMAF است.
.PP
امتیاز حرکت میانگین به دست آمده از طریق سیستم گزارش‌گیری چاپ می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBstats_file\fR 4
.IX Item "stats_file"
در صورت تعیین، فیلتر از پرونده نام‌برده برای ذخیره امتیاز حرکت هر فریم نسبت به فریم قبلی استفاده می‌کند.
وقتی نام پرونده برابر "\-" باشد، داده‌ها به خروجی استاندارد فرستاده می‌شوند.
.PP
مثال:
.PP
.Vb 1
\&        ffmpeg \-i ref.mpg \-vf vmafmotion \-f null \-
.Ve
.SS vpp_amf
.IX Subsection "vpp_amf"
مقیاس‌بندی (تغییر اندازه) و تبدیل فضای رنگی، ویژگی‌های انتقال یا رنگ‌های اصلی برای ویدیوی ورودی، با استفاده از کتابخانه AMD Advanced Media Framework برای شتاب‌دهی سخت‌افزاری.
تنظیم عرض و ارتفاع خروجی به همان شیوه فیلتر \fBscale\fR کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض ابعاد ورودی است.
.Sp
عبارات یکسانی مانند فیلتر \fBscale\fR را مجاز می‌داند.
.IP \fBscale_type\fR 4
.IX Item "scale_type"
تنظیم الگوریتم مورد استفاده برای مقیاس‌بندی:
.RS 4
.IP \fIbilinear\fR 4
.IX Item "bilinear"
دوسطحی (Bilinear)
.Sp
این حالت پیش‌فرض است.
.IP \fIbicubic\fR 4
.IX Item "bicubic"
دومکعبی (Bicubic)
.RE
.RS 4
.RE
.IP \fBformat\fR 4
.IX Item "format"
قالب پیکسلی خروجی را کنترل می‌کند. به طور پیش‌فرض، یا در صورت عدم تعیین، از قالب پیکسلی ورودی استفاده می‌شود.
.IP \fBforce_original_aspect_ratio\fR 4
.IX Item "force_original_aspect_ratio"
.PD 0
.IP \fBforce_divisible_by\fR 4
.IX Item "force_divisible_by"
.PD
مانند گزینه‌های مشابه در فیلتر \fBscale\fR کار می‌کنند.
.IP \fBreset_sar\fR 4
.IX Item "reset_sar"
مانند گزینه مشابه در فیلتر \fBscale\fR کار می‌کند.
.IP \fBin_color_range\fR 4
.IX Item "in_color_range"
بازنویسی محدوده رنگ ورودی.
.IP \fBout_color_range\fR 4
.IX Item "out_color_range"
تعیین محدوده رنگ خروجی.
.Sp
مقادیر پذیرفته‌شده برای in_trc و out_trc عبارتند از:
.RS 4
.IP \fBstudio\fR 4
.IX Item "studio"
محدوده رنگ استودیویی (یا محدود، یا MPEG).
.IP \fBfull\fR 4
.IX Item "full"
محدوده رنگ کامل (یا JPEG).
.RE
.RS 4
.RE
.IP \fBcolor_profile\fR 4
.IX Item "color_profile"
تعیین تمامی مشخصه‌های رنگ به طور همزمان.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBbt601\fR 4
.IX Item "bt601"
BT.601
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.RE
.RS 4
.RE
.IP \fBin_trc\fR 4
.IX Item "in_trc"
بازنویسی ویژگی‌های انتقال ورودی.
.IP \fBout_trc\fR 4
.IX Item "out_trc"
تعیین ویژگی‌های انتقال خروجی.
.Sp
مقادیر پذیرفته‌شده برای in_trc و out_trc عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBgamma22\fR 4
.IX Item "gamma22"
گامای ثابت 2.2
.IP \fBgamma28\fR 4
.IX Item "gamma28"
گامای ثابت 2.8
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBlinear\fR 4
.IX Item "linear"
خطی (Linear)
.IP \fBlog\fR 4
.IX Item "log"
LOG
.IP \fBlog\-sqrt\fR 4
.IX Item "log-sqrt"
LOG_SQRT
.IP \fBiec61966\-2\-4\fR 4
.IX Item "iec61966-2-4"
iec61966\-2\-4
.IP \fBbt1361\-ecg\fR 4
.IX Item "bt1361-ecg"
BT1361_ECG
.IP \fBiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
iec61966\-2\-1
.IP \fBbt2020\-10\fR 4
.IX Item "bt2020-10"
BT.2020 برای محتوای 10\-بیتی
.IP \fBbt2020\-12\fR 4
.IX Item "bt2020-12"
BT.2020 برای محتوای 12\-بیتی
.IP \fBsmpte2084\fR 4
.IX Item "smpte2084"
SMPTE2084
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
SMPTE428
.IP \fBarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
ARIB_STD_B67
.RE
.RS 4
.RE
.IP \fBin_primaries\fR 4
.IX Item "in_primaries"
بازنویسی رنگ‌های اصلی ورودی.
.IP \fBout_primaries\fR 4
.IX Item "out_primaries"
تعیین رنگ‌های اصلی خروجی.
.Sp
مقادیر پذیرفته‌شده برای in_primaries و out_primaries عبارتند از:
.RS 4
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBbt470m\fR 4
.IX Item "bt470m"
BT.470M
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG یا BT.601\-6 625
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M یا BT.601\-6 525
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBfilm\fR 4
.IX Item "film"
فیلم (film)
.IP \fBbt2020\fR 4
.IX Item "bt2020"
BT.2020
.IP \fBsmpte428\fR 4
.IX Item "smpte428"
SMPTE\-428
.IP \fBsmpte431\fR 4
.IX Item "smpte431"
SMPTE\-431
.IP \fBsmpte432\fR 4
.IX Item "smpte432"
SMPTE\-432
.IP \fBjedec\-p22\fR 4
.IX Item "jedec-p22"
فسفرهای JEDEC P22
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مقیاس‌بندی ورودی به 720p با حفظ نسبت ابعاد و اطمینان از اینکه خروجی yuv420p است:
.Sp
.Vb 1
\&        vpp_amf=\-2:720:format=yuv420p
.Ve
.IP \(bu 4
افزایش مقیاس به 4K و تغییر نمایه رنگ به bt2020:
.Sp
.Vb 1
\&        vpp_amf=4096:2160:color_profile=bt2020
.Ve
.IP \(bu 4
بازنویسی رنگ‌های اصلی ورودی و ویژگی‌های انتقال ورودی، و تغییر هر دو به bt709:
.Sp
.Vb 1
\&        vpp_amf=color_profile=bt2020:in_trc=smpte2084:in_primaries=bt2020:out_trc=bt709:out_primaries=bt709
.Ve
.SS vstack
.IX Subsection "vstack"
چیدمان عمودی ویدیوهای ورودی روی یکدیگر.
.PP
تمام استریم‌ها باید دارای قالب پیکسلی و عرض یکسانی باشند.
.PP
توجه داشته باشید که این فیلتر سریع‌تر از استفاده از فیلترهای \fBoverlay\fR و \fBpad\fR برای ایجاد همان خروجی است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد استریم‌های ورودی. پیش‌فرض 2 است.
.IP \fBshortest\fR 4
.IX Item "shortest"
در صورت تنظیم روی 1، خروجی را وادار می‌کند با پایان یافتن کوتاه‌ترین ورودی خاتمه یابد. مقدار پیش‌فرض 0 است.
.SS w3fdif
.IX Subsection "w3fdif"
دی‌اینترلیس کردن (Deinterlace) ویدیوی ورودی ("w3fdif" مخفف "Weston 3 Field Deinterlacing Filter" است).
.PP
فیلتر دی‌اینترلیس ۳ میدانی وستون، بر پایه فرایند شرح‌داده‌شده توسط مارتین وستون برای بخش تحقیق و توسعه بی‌بی‌سی (BBC R&D) و پیاده‌سازی‌شده بر اساس الگوریتم دی‌اینترلیس نوشته‌شده توسط جیم ایستربروک برای BBC R&D، از ضرایب فیلتر محاسبه‌شده توسط BBC R&D استفاده می‌کند.
.PP
این فیلتر از اطلاعات تسلط میدان (field\-dominance) در فریم برای تصمیم‌گیری درباره اینکه کدام میدان از هر جفت میدان در ابتدا در خروجی قرار گیرد، استفاده می‌کند.
اگر این تصمیم اشتباه بود، پیش از فیلتر \f(CW\*(C`w3fdif\*(C'\fR از فیلتر \fBsetfield\fR استفاده کنید.
.PP
دو مجموعه ضریب فیلتر وجود دارد که "ساده" (simple) و "پیچیده" (complex) نامیده می‌شوند. اینکه کدام مجموعه از ضرایب فیلتر استفاده شود را می‌توان با ارسال یک پارامتر اختیاری تنظیم کرد:
.IP \fBfilter\fR 4
.IX Item "filter"
تنظیم ضرایب فیلتر اینترلیس. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBsimple\fR 4
.IX Item "simple"
مجموعه ضرایب فیلتر ساده.
.IP \fBcomplex\fR 4
.IX Item "complex"
مجموعه ضرایب فیلتر پیچیده‌تر.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBcomplex\fR است.
.RE
.IP \fBmode\fR 4
.IX Item "mode"
حالت اینترلیس برای اتخاذ. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBframe\fR 4
.IX Item "frame"
خروجی دادن یک فریم به ازای هر فریم.
.IP \fBfield\fR 4
.IX Item "field"
خروجی دادن یک فریم به ازای هر میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`field\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
توازن (parity) میدان تصویر که برای ویدیوی اینترلیس ورودی فرض می‌شود. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBtff\fR 4
.IX Item "tff"
فرض می‌شود میدان بالایی در ابتدا است (top field first).
.IP \fBbff\fR 4
.IX Item "bff"
فرض می‌شود میدان پایینی در ابتدا است (bottom field first).
.IP \fBauto\fR 4
.IX Item "auto"
فعال‌سازی تشخیص خودکار توازن میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر حالت اینترلیس ناشناخته باشد یا رمزگشا این اطلاعات را صادر نکند، فرض می‌شود که میدان بالایی در ابتدا است.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین اینکه کدام فریم‌ها دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
دی‌اینترلیس کردن تمامی فریم‌ها.
.IP \fBinterlaced\fR 4
.IX Item "interlaced"
فقط دی‌اینترلیس کردن فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBall\fR است.
.RE
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از \fBدستورات\fR مشابهی مانند گزینه‌ها پشتیبانی می‌کند.
.SS waveform
.IX Subsection "waveform"
پایشگر شکل‌موج (waveform) ویدیو.
.PP
پایشگر شکل‌موج، شدت مؤلفه‌های رنگ را ترسیم می‌کند. به طور پیش‌فرض فقط روشنایی (luma). هر ستون از شکل‌موج متناظر با یک ستون از پیکسل‌ها در ویدیوی مبدأ است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
می‌تواند \f(CW\*(C`row\*(C'\fR (سطری) یا \f(CW\*(C`column\*(C'\fR (ستونی) باشد. پیش‌فرض \f(CW\*(C`column\*(C'\fR است.
در حالت سطری، نمودار در سمت چپ نشان‌دهنده مقدار مؤلفه رنگ 0 و سمت راست نشان‌دهنده مقدار 255 است. در حالت ستونی، سمت بالا نشان‌دهنده مقدار مؤلفه رنگ 0 و سمت پایین نشان‌دهنده مقدار 255 است.
.IP "\fBintensity, i\fR" 4
.IX Item "intensity, i"
تنظیم شدت. مقادیر کوچک‌تر برای پی بردن به اینکه چه تعداد مقدار با روشنایی یکسان در سطرها/ستون‌های ورودی توزیع شده‌اند مفید است.
مقدار پیش‌فرض \f(CW0.04\fR است. بازه مجاز [0, 1] است.
.IP "\fBmirror, r\fR" 4
.IX Item "mirror, r"
تنظیم حالت آینه‌ای. \f(CW0\fR به معنای بدون آینه و \f(CW1\fR به معنای آینه‌ای است.
در حالت آینه‌ای، مقادیر بالاتر در سمت چپ برای حالت \f(CW\*(C`row\*(C'\fR و در بالا برای حالت \f(CW\*(C`column\*(C'\fR نمایش داده می‌شوند. پیش‌فرض \f(CW1\fR (آینه‌ای) است.
.IP "\fBdisplay, d\fR" 4
.IX Item "display, d"
تنظیم حالت نمایش.
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBoverlay\fR 4
.IX Item "overlay"
اطلاعاتی همسان با حالت \f(CW\*(C`parade\*(C'\fR ارائه می‌دهد، با این تفاوت که نمودارهای نشان‌دهنده مؤلفه‌های رنگ مستقیماً روی یکدیگر قرار می‌گیرند.
.Sp
این حالت نمایش، تشخیص تفاوت‌ها یا شباهت‌های نسبی در نواحی هم‌پوشان مؤلفه‌های رنگی را که قرار است یکسان باشند، مانند سفید، خاکستری یا سیاه خنثی، آسان‌تر می‌کند.
.IP \fBstack\fR 4
.IX Item "stack"
نمایش نمودارهای جداگانه برای مؤلفه‌های رنگ کنار هم در حالت \f(CW\*(C`row\*(C'\fR یا زیر یکدیگر در حالت \f(CW\*(C`column\*(C'\fR.
.IP \fBparade\fR 4
.IX Item "parade"
نمایش نمودارهای جداگانه برای مؤلفه‌های رنگ کنار هم در حالت \f(CW\*(C`column\*(C'\fR یا زیر یکدیگر در حالت \f(CW\*(C`row\*(C'\fR.
.Sp
استفاده از این حالت نمایش، تشخیص ته‌رنگ‌ها (color casts) را در سایه‌روشن‌ها و تاریکی‌های تصویر با مقایسه خطوط کانتور بالا و پایین هر شکل‌موج آسان می‌کند. از آنجا که رنگ‌های سفید، خاکستری و سیاه با مقادیر دقیقاً مساوی از قرمز، سبز و آبی مشخص می‌شوند، نواحی خنثی تصویر باید سه شکل‌موج با عرض/ارتفاع تقریباً برابر نمایش دهند. در غیر این صورت، تصحیح با انجام تنظیمات سطح روی سه شکل‌موج آسان خواهد بود.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`stack\*(C'\fR است.
.RE
.IP "\fBcomponents, c\fR" 4
.IX Item "components, c"
تنظیم مؤلفه‌های رنگی مورد نمایش. پیش‌فرض 1 است، که به معنای تنها روشنایی (luma) یا مؤلفه رنگ قرمز در صورت قرار داشتن ورودی در فضای رنگی RGB است. اگر برای مثال روی 7 تنظیم شود، هر 3 مؤلفه رنگی موجود (در صورت وجود) را نمایش می‌دهد.
.IP "\fBenvelope, e\fR" 4
.IX Item "envelope, e"
.RS 4
.PD 0
.IP \fBnone\fR 4
.IX Item "none"
.PD
بدون پوش (envelope)، این حالت پیش‌فرض است.
.IP \fBinstant\fR 4
.IX Item "instant"
پوش لحظه‌ای، مقادیر کمینه و بیشینه ارائه‌شده در نمودار حتی با مقدار کوچک \f(CW\*(C`step\*(C'\fR به راحتی قابل مشاهده خواهند بود.
.IP \fBpeak\fR 4
.IX Item "peak"
نگه‌داشتن مقادیر کمینه و بیشینه ارائه‌شده در نمودار در طول زمان. از این طریق می‌توانید مقادیر خارج از محدوده را بدون نگاه مداوم به شکل‌موج‌ها تشخیص دهید.
.IP \fBpeak+instant\fR 4
.IX Item "peak+instant"
ترکیب هر دو پوش اوج (peak) و لحظه‌ای (instant) با یکدیگر.
.RE
.RS 4
.RE
.IP "\fBfilter, f\fR" 4
.IX Item "filter, f"
.RS 4
.PD 0
.IP \fBlowpass\fR 4
.IX Item "lowpass"
.PD
بدون فیلتر، این حالت پیش‌فرض است.
.IP \fBflat\fR 4
.IX Item "flat"
ترکیب روشنایی (luma) و رنگ (chroma) با یکدیگر.
.IP \fBaflat\fR 4
.IX Item "aflat"
مشابه موارد بالا، اما تفاوت بین رنگ آبی و قرمز را نشان می‌دهد.
.IP \fBxflat\fR 4
.IX Item "xflat"
مشابه موارد بالا، اما از رنگ‌های متفاوتی استفاده می‌کند.
.IP \fByflat\fR 4
.IX Item "yflat"
مشابه موارد بالا، اما مجدداً با رنگ‌های متفاوت.
.IP \fBchroma\fR 4
.IX Item "chroma"
فقط نمایش رنگ (chroma).
.IP \fBcolor\fR 4
.IX Item "color"
نمایش مقدار رنگ واقعی روی شکل‌موج.
.IP \fBacolor\fR 4
.IX Item "acolor"
مشابه مورد بالا، اما با روشنایی که بسامد مقادیر رنگ را نشان می‌دهد.
.RE
.RS 4
.RE
.IP "\fBgraticule, g\fR" 4
.IX Item "graticule, g"
تنظیم اینکه کدام شبکه مدرج (graticule) نمایش داده شود.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
عدم نمایش شبکه مدرج.
.IP \fBgreen\fR 4
.IX Item "green"
نمایش شبکه مدرج سبز که محدوده‌های قانونی پخش (broadcast) را نشان می‌دهد.
.IP \fBorange\fR 4
.IX Item "orange"
نمایش شبکه مدرج نارنجی که محدوده‌های قانونی پخش را نشان می‌دهد.
.IP \fBinvert\fR 4
.IX Item "invert"
نمایش شبکه مدرج معکوس که محدوده‌های قانونی پخش را نشان می‌دهد.
.RE
.RS 4
.RE
.IP "\fBopacity, o\fR" 4
.IX Item "opacity, o"
تنظیم کدر بودن (opacity) شبکه مدرج.
.IP "\fBflags, fl\fR" 4
.IX Item "flags, fl"
تنظیم پرچم‌های شبکه مدرج.
.RS 4
.IP \fBnumbers\fR 4
.IX Item "numbers"
رسم اعداد بالای خطوط. به طور پیش‌فرض فعال است.
.IP \fBdots\fR 4
.IX Item "dots"
رسم نقطه به جای خط.
.RE
.RS 4
.RE
.IP "\fBscale, s\fR" 4
.IX Item "scale, s"
تنظیم مقیاس مورد استفاده برای نمایش شبکه مدرج.
.RS 4
.IP \fBdigital\fR 4
.IX Item "digital"
.PD 0
.IP \fBmillivolts\fR 4
.IX Item "millivolts"
.IP \fBire\fR 4
.IX Item "ire"
.PD
.RE
.RS 4
.Sp
پیش‌فرض digital است.
.RE
.IP "\fBbgopacity, b\fR" 4
.IX Item "bgopacity, b"
تنظیم کدر بودن پس‌زمینه.
.IP "\fBtint0, t0\fR" 4
.IX Item "tint0, t0"
.PD 0
.IP "\fBtint1, t1\fR" 4
.IX Item "tint1, t1"
.PD
تنظیم ته‌رنگ خروجی.
تنها با فیلتر lowpass و زمانی که حالت نمایش overlay نیست و قالب‌های پیکسلی ورودی RGB نیستند استفاده می‌شود.
.IP "\fBfitmode, fm\fR" 4
.IX Item "fitmode, fm"
تنظیم نسبت ابعاد نمونه (SAR) فریم‌های خروجی ویدیو.
می‌تواند برای پیکربندی شکل‌موج استفاده شود تا در یکی از جهات بیش از حد کشیده نشود.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
تنظیم نسبت ابعاد نمونه روی 1/1.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم نسبت ابعاد نمونه برای مطابقت با اندازه ویدیوی ورودی.
.RE
.RS 4
.Sp
پیش‌فرض \fBnone\fR است.
.RE
.IP \fBinput\fR 4
.IX Item "input"
تنظیم قالب‌های ورودی برای انتخاب توسط فیلتر.
می‌تواند \fBall\fR برای انتخاب از میان تمامی قالب‌های موجود،
یا \fBfirst\fR برای انتخاب نخستین قالب موجود باشد.
پیش‌فرض \fBfirst\fR است.
.SS "weave, doubleweave"
.IX Subsection "weave, doubleweave"
فیلتر \f(CW\*(C`weave\*(C'\fR یک ورودی ویدیویی مبتنی بر میدان (field\-based) را می‌گیرد و هر دو میدان متوالی را در یک فریم ادغام می‌کند و یک کلیپ جدید با ارتفاع دوبرابر، نرخ فریم نصف و تعداد فریم نصف تولید می‌کند.
.PP
فیلتر \f(CW\*(C`doubleweave\*(C'\fR همانند \f(CW\*(C`weave\*(C'\fR کار می‌کند اما بدون نصف کردن نرخ فریم و تعداد فریم‌ها.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBfirst_field\fR 4
.IX Item "first_field"
تنظیم میدان اول. مقادیر موجود عبارتند از:
.RS 4
.IP "\fBtop, t\fR" 4
.IX Item "top, t"
تنظیم فریم به صورت میدان بالایی در ابتدا (top\-field\-first).
.IP "\fBbottom, b\fR" 4
.IX Item "bottom, b"
تنظیم فریم به صورت میدان پایینی در ابتدا (bottom\-field\-first).
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اینترلیس کردن ویدیو با استفاده از فیلترهای \fBselect\fR و \fBseparatefields\fR:
.Sp
.Vb 1
\&        separatefields,select=eq(mod(n,4),0)+eq(mod(n,4),3),weave
.Ve
.SS xbr
.IX Subsection "xbr"
اعمال فیلتر بزرگ‌نمایی باکیفیت xBR که برای پیکسل آرت (pixel art) طراحی شده است. این فیلتر از مجموعه‌ای از قوانین تشخیص لبه پیروی می‌کند، ببینید
<\fBhttps://forums.libretro.com/t/xbr\-algorithm\-tutorial/123\fR>.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم ابعاد مقیاس‌بندی: \f(CW2\fR برای \f(CW\*(C`2xBR\*(C'\fR، \f(CW3\fR برای
\&\f(CW\*(C`3xBR\*(C'\fR و \f(CW4\fR برای \f(CW\*(C`4xBR\*(C'\fR.
پیش‌فرض \f(CW3\fR است.
.SS xcorrelate
.IX Subsection "xcorrelate"
اعمال همبستگی متقابل نرمال‌شده (normalized cross\-correlation) میان استریم ویدیوی ورودی اول و دوم.
.PP
ابعاد استریم ویدیوی ورودی دوم باید کوچک‌تر از استریم ویدیوی ورودی اول باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه‌هایی که باید پردازش شوند.
.IP \fBsecondary\fR 4
.IX Item "secondary"
تنظیم اینکه کدام فریم‌های ویدیوی ثانویه از استریم ویدیوی ورودی دوم پردازش شوند،
می‌تواند \fIfirst\fR یا \fIall\fR باشد. پیش‌فرض \fIall\fR است.
.PP
فیلتر \f(CW\*(C`xcorrelate\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.SS xfade
.IX Subsection "xfade"
اعمال محوشدگی متقاطع (cross fade) از یک استریم ویدیوی ورودی به استریم ویدیوی ورودی دیگر.
محوشدگی متقاطع برای مدت‌زمان مشخص اعمال می‌شود.
.PP
هر دو ورودی باید دارای نرخ فریم ثابت بوده و تفکیک‌پذیری، قالب پیکسلی، نرخ فریم و پایه زمانی یکسانی داشته باشند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtransition\fR 4
.IX Item "transition"
تنظیم یکی از جلوه‌های گذار (transition) موجود:
.RS 4
.IP \fBcustom\fR 4
.IX Item "custom"
.PD 0
.IP \fBfade\fR 4
.IX Item "fade"
.IP \fBwipeleft\fR 4
.IX Item "wipeleft"
.IP \fBwiperight\fR 4
.IX Item "wiperight"
.IP \fBwipeup\fR 4
.IX Item "wipeup"
.IP \fBwipedown\fR 4
.IX Item "wipedown"
.IP \fBslideleft\fR 4
.IX Item "slideleft"
.IP \fBslideright\fR 4
.IX Item "slideright"
.IP \fBslideup\fR 4
.IX Item "slideup"
.IP \fBslidedown\fR 4
.IX Item "slidedown"
.IP \fBcirclecrop\fR 4
.IX Item "circlecrop"
.IP \fBrectcrop\fR 4
.IX Item "rectcrop"
.IP \fBdistance\fR 4
.IX Item "distance"
.IP \fBfadeblack\fR 4
.IX Item "fadeblack"
.IP \fBfadewhite\fR 4
.IX Item "fadewhite"
.IP \fBradial\fR 4
.IX Item "radial"
.IP \fBsmoothleft\fR 4
.IX Item "smoothleft"
.IP \fBsmoothright\fR 4
.IX Item "smoothright"
.IP \fBsmoothup\fR 4
.IX Item "smoothup"
.IP \fBsmoothdown\fR 4
.IX Item "smoothdown"
.IP \fBcircleopen\fR 4
.IX Item "circleopen"
.IP \fBcircleclose\fR 4
.IX Item "circleclose"
.IP \fBvertopen\fR 4
.IX Item "vertopen"
.IP \fBvertclose\fR 4
.IX Item "vertclose"
.IP \fBhorzopen\fR 4
.IX Item "horzopen"
.IP \fBhorzclose\fR 4
.IX Item "horzclose"
.IP \fBdissolve\fR 4
.IX Item "dissolve"
.IP \fBpixelize\fR 4
.IX Item "pixelize"
.IP \fBdiagtl\fR 4
.IX Item "diagtl"
.IP \fBdiagtr\fR 4
.IX Item "diagtr"
.IP \fBdiagbl\fR 4
.IX Item "diagbl"
.IP \fBdiagbr\fR 4
.IX Item "diagbr"
.IP \fBhlslice\fR 4
.IX Item "hlslice"
.IP \fBhrslice\fR 4
.IX Item "hrslice"
.IP \fBvuslice\fR 4
.IX Item "vuslice"
.IP \fBvdslice\fR 4
.IX Item "vdslice"
.IP \fBhblur\fR 4
.IX Item "hblur"
.IP \fBfadegrays\fR 4
.IX Item "fadegrays"
.IP \fBwipetl\fR 4
.IX Item "wipetl"
.IP \fBwipetr\fR 4
.IX Item "wipetr"
.IP \fBwipebl\fR 4
.IX Item "wipebl"
.IP \fBwipebr\fR 4
.IX Item "wipebr"
.IP \fBsqueezeh\fR 4
.IX Item "squeezeh"
.IP \fBsqueezev\fR 4
.IX Item "squeezev"
.IP \fBzoomin\fR 4
.IX Item "zoomin"
.IP \fBfadefast\fR 4
.IX Item "fadefast"
.IP \fBfadeslow\fR 4
.IX Item "fadeslow"
.IP \fBhlwind\fR 4
.IX Item "hlwind"
.IP \fBhrwind\fR 4
.IX Item "hrwind"
.IP \fBvuwind\fR 4
.IX Item "vuwind"
.IP \fBvdwind\fR 4
.IX Item "vdwind"
.IP \fBcoverleft\fR 4
.IX Item "coverleft"
.IP \fBcoverright\fR 4
.IX Item "coverright"
.IP \fBcoverup\fR 4
.IX Item "coverup"
.IP \fBcoverdown\fR 4
.IX Item "coverdown"
.IP \fBrevealleft\fR 4
.IX Item "revealleft"
.IP \fBrevealright\fR 4
.IX Item "revealright"
.IP \fBrevealup\fR 4
.IX Item "revealup"
.IP \fBrevealdown\fR 4
.IX Item "revealdown"
.PD
.RE
.RS 4
.Sp
جلوه گذار پیش‌فرض fade است.
.RE
.IP \fBduration\fR 4
.IX Item "duration"
تنظیم مدت‌زمان محوشدگی متقاطع به ثانیه.
بازه 0 تا 60 ثانیه است.
مدت‌زمان پیش‌فرض 1 ثانیه است.
.IP \fBoffset\fR 4
.IX Item "offset"
تنظیم نقطه شروع محوشدگی متقاطع نسبت به استریم ورودی اول به ثانیه.
میزان آفست پیش‌فرض 0 است.
.IP \fBexpr\fR 4
.IX Item "expr"
تنظیم عبارت برای جلوه گذار سفارشی.
.Sp
عبارات می‌توانند از متغیرها و توابع زیر استفاده کنند:
.RS 4
.IP \fBX\fR 4
.IX Item "X"
.PD 0
.IP \fBY\fR 4
.IX Item "Y"
.PD
مختصات نمونه کنونی.
.IP \fBW\fR 4
.IX Item "W"
.PD 0
.IP \fBH\fR 4
.IX Item "H"
.PD
عرض و ارتفاع تصویر.
.IP \fBP\fR 4
.IX Item "P"
پیشرفت جلوه گذار.
.IP \fBPLANE\fR 4
.IX Item "PLANE"
صفحه در حال پردازش کنونی.
.IP \fBA\fR 4
.IX Item "A"
مقدار بازگشتی ورودی اول در موقعیت و صفحه کنونی.
.IP \fBB\fR 4
.IX Item "B"
مقدار بازگشتی ورودی دوم در موقعیت و صفحه کنونی.
.IP "\fBa0(x, y)\fR" 4
.IX Item "a0(x, y)"
.PD 0
.IP "\fBa1(x, y)\fR" 4
.IX Item "a1(x, y)"
.IP "\fBa2(x, y)\fR" 4
.IX Item "a2(x, y)"
.IP "\fBa3(x, y)\fR" 4
.IX Item "a3(x, y)"
.PD
بازگرداندن مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) مؤلفه اول/دوم/سوم/چهارم ورودی اول.
.IP "\fBb0(x, y)\fR" 4
.IX Item "b0(x, y)"
.PD 0
.IP "\fBb1(x, y)\fR" 4
.IX Item "b1(x, y)"
.IP "\fBb2(x, y)\fR" 4
.IX Item "b2(x, y)"
.IP "\fBb3(x, y)\fR" 4
.IX Item "b3(x, y)"
.PD
بازگرداندن مقدار پیکسل در موقعیت (\fIx\fR,\fIy\fR) مؤلفه اول/دوم/سوم/چهارم ورودی دوم.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
محوشدگی متقاطع از یک ویدیوی ورودی به ویدیوی ورودی دیگر، با گذار fade و مدت‌زمان گذار 2 ثانیه که در آفست 5 ثانیه‌ای آغاز می‌شود:
.Sp
.Vb 1
\&        ffmpeg \-i first.mp4 \-i second.mp4 \-filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4
.Ve
.SS xmedian
.IX Subsection "xmedian"
انتخاب پیکسل‌های میانه (median) از چندین ویدیوی ورودی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد ورودی‌ها.
پیش‌فرض 3 است. بازه مجاز از 3 تا 255 است.
اگر تعداد ورودی‌ها عددی زوج باشد، نتیجه مقدار میانگین بین دو مقدار میانه خواهد بود.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه‌هایی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW15\fR است که با آن همه صفحه‌ها پردازش می‌شوند.
.IP \fBpercentile\fR 4
.IX Item "percentile"
تنظیم صدک میانه. مقدار پیش‌فرض \f(CW0.5\fR است.
مقدار پیش‌فرض \f(CW0.5\fR همیشه مقادیر میانه را انتخاب می‌کند، در حالی که \f(CW0\fR مقادیر کمینه و \f(CW1\fR مقادیر بیشینه را انتخاب خواهد کرد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمامی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند، به جز گزینه \f(CW\*(C`inputs\*(C'\fR.
.SS xpsnr
.IX Subsection "xpsnr"
به دست آوردن میانگین (در تمام فریم‌های ورودی) و کمینه (در تمام میانگین‌های صفحه‌های رنگی) نسبت سیگنال به نویز اوج وزن‌دهی‌شده ادراکی تعمیم‌یافته (XPSNR) میان دو ویدیوی ورودی.
.PP
معیار XPSNR یک الگوریتم اندازه‌گیری اعوجاج با پیچیدگی پایین و با انگیزه روانی\-دیداری (psychovisually) برای ارزیابی تفاوت بین دو استریم ویدیو یا تصویر است. این معیار به‌ویژه برای تعیین کمّی عینی اعوجاج‌های ناشی از کدک‌های ویدیویی و تصویری، به عنوان جایگزینی برای آزمون ذهنی رسمی مفید است. مقادیر لگاریتمی خروجی XPSNR در محدوده‌ای مشابه با ارزیابی‌های سنتی \fBpsnr\fR قرار دارند اما برداشت‌های انسانی از کیفیت کدگذاری دیداری را بهتر بازتاب می‌دهند. جزئیات بیشتر درباره معیار XPSNR، که اساساً بیانگر یک گونه وزن‌دهی‌شده بلوکی از معیار PSNR است، در مقالات آزاد زیر قابل دسترسی است:
.IP \(bu 4
C. R. Helmrich, M. Siekmann, S. Becker, S. Bosse, D. Marpe, and T. Wiegand, "XPSNR: A
Low\-Complexity Extension of the Perceptually Weighted Peak Signal\-to\-Noise Ratio for
High\-Resolution Video Quality Assessment," in Proc. IEEE Int. Conf. Acoustics, Speech,
Sig. Process. (ICASSP), virt./online, May 2020. <\fBwww.ecodis.de/xpsnr.htm\fR>
.IP \(bu 4
C. R. Helmrich, S. Bosse, H. Schwarz, D. Marpe, and T. Wiegand, "A Study of the
Extended Perceptually Weighted Peak Signal\-to\-Noise Ratio (XPSNR) for Video Compression
with Different Resolutions and Bit Depths," ITU Journal: ICT Discoveries, vol. 3, no.
1, pp. 65 \- 72, May 2020. <\fBhttp://handle.itu.int/11.1002/pub/8153d78b\-en\fR>
.PP
هنگام انتشار نتایج ارزیابی‌های XPSNR به دست آمده مثلاً با استفاده از این فیلتر FFmpeg، ارجاع به مقالات فوق به عنوان روشی برای مستندسازی اکیداً توصیه می‌شود. این فیلتر به دو ویدیوی ورودی نیاز دارد. ورودی اول به عنوان منبع مرجع (معمولاً بدون اعوجاج) در نظر گرفته شده و بدون تغییر به خروجی منتقل می‌شود، در حالی که ورودی دوم سیگنال آزمون (دارای اعوجاج) است. به جز عمق بیتی (bit depth)، این دو ویدیوی ورودی باید دارای قالب پیکسلی یکسانی باشند. علاوه بر این، برای بهترین عملکرد، هر دو ویدیوی ورودی مورد مقایسه باید در قالب رنگی YCbCr باشند.
.PP
مقادیر کلی به دست آمده XPSNR ذکرشده در بالا از طریق سیستم گزارش‌گیری چاپ می‌شوند. در صورت ورودی با چندین صفحه رنگی، پیشنهاد می‌کنیم کمینه میانگین XPSNR گزارش شود.
.PP
پارامتر زیر که رفتاری مشابه با پارامتر فیلتر \fBpsnr\fR دارد پذیرفته می‌شود:
.IP "\fBstats_file, f\fR" 4
.IX Item "stats_file, f"
در صورت تعیین، فیلتر از پرونده نام‌برده برای ذخیره مقدار XPSNR هر فریم منفرد و صفحه رنگی استفاده می‌کند. وقتی نام پرونده برابر "\-" باشد، آن داده‌ها به خروجی استاندارد فرستاده می‌شوند.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تحلیل XPSNR دو ویدیوی HD با تفکیک‌پذیری 1080p با نام‌های ref_source.yuv و test_video.yuv، هر دو با نرخ 24 فریم بر ثانیه، با قالب رنگی 4:2:0، عمق بیتی 8، و خروجی در یک پرونده لاگ به نام "xpsnr.log":
.Sp
.Vb 2
\&        ffmpeg \-s 1920x1080 \-framerate 24 \-pix_fmt yuv420p \-i ref_source.yuv \-s 1920x1080 \-framerate
\&        24 \-pix_fmt yuv420p \-i test_video.yuv \-lavfi xpsnr="stats_file=xpsnr.log" \-f null \-
.Ve
.IP \(bu 4
تحلیل XPSNR دو ویدیوی UHD با تفکیک‌پذیری 2160p با نام‌های ref_source.yuv با عمق بیتی 8 و test_video.yuv با عمق بیتی 10، هر دو با نرخ 60 فریم بر ثانیه با قالب رنگی 4:2:0، بدون خروجی پرونده لاگ:
.Sp
.Vb 2
\&        ffmpeg \-s 3840x2160 \-framerate 60 \-pix_fmt yuv420p \-i ref_source.yuv \-s 3840x2160 \-framerate
\&        60 \-pix_fmt yuv420p10le \-i test_video.yuv \-lavfi xpsnr="stats_file=\-" \-f null \-
.Ve
.SS xstack
.IX Subsection "xstack"
چیدمان ورودی‌های ویدیو در یک طرح‌بندی (layout) سفارشی.
.PP
تمام استریم‌ها باید دارای قالب پیکسلی یکسانی باشند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
تنظیم تعداد استریم‌های ورودی. پیش‌فرض 2 است.
.IP \fBlayout\fR 4
.IX Item "layout"
تعیین طرح‌بندی ورودی‌ها.
این گزینه نیازمند آن است که پیکربندی طرح‌بندی دلخواه صریحاً توسط کاربر تعیین شود.
این گزینه موقعیت هر ورودی ویدیو را در خروجی مشخص می‌کند. هر ورودی با \*(Aq|\*(Aq جدا می‌شود.
عدد اول نشان‌دهنده ستون و عدد دوم نشان‌دهنده سطر است.
اعداد از 0 شروع می‌شوند و با \*(Aq_\*(Aq جدا می‌گردند. به صورت اختیاری می‌توان از wX و hX استفاده کرد که در آن X ورودی ویدیویی است که عرض یا ارتفاع از آن گرفته می‌شود.
در صورت جداسازی با \*(Aq+\*(Aq می‌توان از چندین مقدار استفاده کرد. در چنین حالتی مقادیر با یکدیگر جمع می‌شوند.
.Sp
توجه داشته باشید که اگر ورودی‌ها دارای اندازه‌های متفاوتی باشند ممکن است فاصله‌های خالی ایجاد شود، زیرا تمام فریم ویدیوی خروجی پر نخواهد شد. به طور مشابه، اگر موقعیت ویدیوها فضای کافی برای فریم کامل ویدیوهای مجاور باقی نگذارد، ویدیوها می‌توانند روی یکدیگر هم‌پوشانی داشته باشند.
.Sp
برای 2 ورودی، یک طرح‌بندی پیش‌فرض \f(CW\*(C`0_0|w0_0\*(C'\fR (معادل \f(CW\*(C`grid=2x1\*(C'\fR) تنظیم شده است. در تمام موارد دیگر، یک طرح‌بندی یا یک شبکه (grid) باید توسط کاربر تنظیم شود. در هر زمان تنها یکی از گزینه‌های \f(CW\*(C`grid\*(C'\fR یا \f(CW\*(C`layout\*(C'\fR را می‌توان تعیین کرد. تعیین هر دوی آن‌ها منجر به خطا خواهد شد.
.IP \fBgrid\fR 4
.IX Item "grid"
تعیین یک شبکه (grid) با اندازه ثابت از ورودی‌ها.
این گزینه برای ایجاد یک شبکه با اندازه ثابت از استریم‌های ورودی استفاده می‌شود. اندازه شبکه را به صورت \f(CW\*(C`COLUMNSxROWS\*(C'\fR تنظیم کنید. باید به تعداد \f(CW\*(C`ROWS * COLUMNS\*(C'\fR استریم ورودی وجود داشته باشد و آن‌ها به صورت یک شبکه با \f(CW\*(C`ROWS\*(C'\fR سطر و \f(CW\*(C`COLUMNS\*(C'\fR ستون چیده خواهند شد. هنگام استفاده از این گزینه، هر استریم ورودی درون یک سطر باید ارتفاع یکسانی داشته باشد و تمامی سطرها باید عرض یکسانی داشته باشند.
.Sp
اگر \f(CW\*(C`grid\*(C'\fR تنظیم شود، گزینه \f(CW\*(C`inputs\*(C'\fR نادیده گرفته شده و به طور ضمنی روی \f(CW\*(C`ROWS * COLUMNS\*(C'\fR تنظیم می‌شود.
.Sp
برای 2 ورودی، یک شبکه پیش‌فرض \f(CW\*(C`2x1\*(C'\fR (معادل \f(CW\*(C`layout=0_0|w0_0\*(C'\fR) تنظیم شده است. در تمام موارد دیگر، یک طرح‌بندی یا یک شبکه باید توسط کاربر تنظیم شود. در هر زمان تنها یکی از گزینه‌های \f(CW\*(C`grid\*(C'\fR یا \f(CW\*(C`layout\*(C'\fR را می‌توان تعیین کرد. تعیین هر دوی آن‌ها منجر به خطا خواهد شد.
.IP \fBshortest\fR 4
.IX Item "shortest"
در صورت تنظیم روی 1، خروجی را وادار می‌کند با پایان یافتن کوتاه‌ترین ورودی خاتمه یابد. مقدار پیش‌فرض 0 است.
.IP \fBfill\fR 4
.IX Item "fill"
در صورت تنظیم روی یک رنگ معتبر، تمام پیکسل‌های استفاده‌نشده با آن رنگ پر می‌شوند.
به طور پیش‌فرض fill روی none تنظیم شده است، بنابراین غیرفعال است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
نمایش 4 ورودی در یک شبکه 2x2.
.Sp
طرح‌بندی:
.Sp
.Vb 2
\&        input1(0, 0)  | input3(w0, 0)
\&        input2(0, h0) | input4(w0, h0)
\&
\&
\&        
\&        xstack=inputs=4:layout=0_0|0_h0|w0_0|w0_h0
.Ve
.Sp
توجه داشته باشید که اگر ورودی‌ها دارای اندازه‌های متفاوتی باشند، ممکن است فاصله‌های خالی یا هم‌پوشانی رخ دهد.
.IP \(bu 4
نمایش 4 ورودی در یک شبکه 1x4.
.Sp
طرح‌بندی:
.Sp
.Vb 4
\&        input1(0, 0)
\&        input2(0, h0)
\&        input3(0, h0+h1)
\&        input4(0, h0+h1+h2)
\&
\&
\&        
\&        xstack=inputs=4:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2
.Ve
.Sp
توجه داشته باشید که اگر ورودی‌ها دارای عرض‌های متفاوتی باشند، فضای استفاده‌نشده ظاهر خواهد شد.
.IP \(bu 4
نمایش 9 ورودی در یک شبکه 3x3.
.Sp
طرح‌بندی:
.Sp
.Vb 3
\&        input1(0, 0)       | input4(w0, 0)      | input7(w0+w3, 0)
\&        input2(0, h0)      | input5(w0, h0)     | input8(w0+w3, h0)
\&        input3(0, h0+h1)   | input6(w0, h0+h1)  | input9(w0+w3, h0+h1)
\&
\&
\&        
\&        xstack=inputs=9:layout=0_0|0_h0|0_h0+h1|w0_0|w0_h0|w0_h0+h1|w0+w3_0|w0+w3_h0|w0+w3_h0+h1
.Ve
.Sp
توجه داشته باشید که اگر ورودی‌ها دارای اندازه‌های متفاوتی باشند، ممکن است فاصله‌های خالی یا هم‌پوشانی رخ دهد.
.IP \(bu 4
نمایش 16 ورودی در یک شبکه 4x4.
.Sp
طرح‌بندی:
.Sp
.Vb 4
\&        input1(0, 0)       | input5(w0, 0)       | input9 (w0+w4, 0)       | input13(w0+w4+w8, 0)
\&        input2(0, h0)      | input6(w0, h0)      | input10(w0+w4, h0)      | input14(w0+w4+w8, h0)
\&        input3(0, h0+h1)   | input7(w0, h0+h1)   | input11(w0+w4, h0+h1)   | input15(w0+w4+w8, h0+h1)
\&        input4(0, h0+h1+h2)| input8(w0, h0+h1+h2)| input12(w0+w4, h0+h1+h2)| input16(w0+w4+w8, h0+h1+h2)
\&
\&
\&        
\&        xstack=inputs=16:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2|w0_0|w0_h0|w0_h0+h1|w0_h0+h1+h2|w0+w4_0|
\&        w0+w4_h0|w0+w4_h0+h1|w0+w4_h0+h1+h2|w0+w4+w8_0|w0+w4+w8_h0|w0+w4+w8_h0+h1|w0+w4+w8_h0+h1+h2
.Ve
.Sp
توجه داشته باشید که اگر ورودی‌ها دارای اندازه‌های متفاوتی باشند، ممکن است فاصله‌های خالی یا هم‌پوشانی رخ دهد.
.SS yadif
.IX Subsection "yadif"
دی‌اینترلیس کردن ویدیوی ورودی ("yadif" به معنای "yet another deinterlacing filter" است).
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت اینترلیس برای اتخاذ. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, send_frame\fR" 4
.IX Item "0, send_frame"
خروجی دادن یک فریم به ازای هر فریم.
.IP "\fB1, send_field\fR" 4
.IX Item "1, send_field"
خروجی دادن یک فریم به ازای هر میدان.
.IP "\fB2, send_frame_nospatial\fR" 4
.IX Item "2, send_frame_nospatial"
مشابه \f(CW\*(C`send_frame\*(C'\fR، اما بررسی اینترلیس مکانی را نادیده می‌گیرد.
.IP "\fB3, send_field_nospatial\fR" 4
.IX Item "3, send_field_nospatial"
مشابه \f(CW\*(C`send_field\*(C'\fR، اما بررسی اینترلیس مکانی را نادیده می‌گیرد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`send_frame\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
توازن میدان تصویر که برای ویدیوی اینترلیس ورودی فرض می‌شود. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض می‌شود میدان بالایی در ابتدا است.
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض می‌شود میدان پایینی در ابتدا است.
.IP "\fB\-1, auto\fR" 4
.IX Item "-1, auto"
فعال‌سازی تشخیص خودکار توازن میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر حالت اینترلیس ناشناخته باشد یا رمزگشا این اطلاعات را صادر نکند، فرض می‌شود که میدان بالایی در ابتدا است.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین اینکه کدام فریم‌ها دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, all\fR" 4
.IX Item "0, all"
دی‌اینترلیس کردن تمام فریم‌ها.
.IP "\fB1, interlaced\fR" 4
.IX Item "1, interlaced"
فقط دی‌اینترلیس کردن فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.SS yaepblur
.IX Subsection "yaepblur"
اعمال فیلتر تاری (blur) با حفظ لبه‌ها ("yaepblur" مخفف "yet another edge preserving blur filter" است).
این الگوریتم در منبع زیر شرح داده شده است:
"J. S. Lee, Digital image enhancement and noise filtering by use of local statistics, IEEE Trans. Pattern Anal. Mach. Intell. PAMI\-2, 1980."
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBradius, r\fR" 4
.IX Item "radius, r"
تنظیم شعاع پنجره. مقدار پیش‌فرض 3 است.
.IP "\fBplanes, p\fR" 4
.IX Item "planes, p"
تنظیم صفحه‌هایی که باید فیلتر شوند. پیش‌فرض تنها صفحه اول است.
.IP "\fBsigma, s\fR" 4
.IX Item "sigma, s"
تنظیم شدت تاری. مقدار پیش‌فرض 128 است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از \fBدستورات\fR مشابهی مانند گزینه‌ها پشتیبانی می‌کند.
.SS zoompan
.IX Subsection "zoompan"
اعمال جلوه بزرگ‌نمایی و حرکت افقی/عمودی (Zoom & Pan).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBzoom, z\fR" 4
.IX Item "zoom, z"
تنظیم عبارت بزرگ‌نمایی. بازه 1\-10 است. پیش‌فرض 1 است.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم عبارات x و y. پیش‌فرض 0 است.
.IP \fBd\fR 4
.IX Item "d"
تنظیم عبارت مدت‌زمان بر حسب تعداد فریم‌ها.
این گزینه تعیین می‌کند که جلوه برای یک تصویر ورودی منفرد چند فریم دوام داشته باشد. پیش‌فرض 90 است.
.IP \fBs\fR 4
.IX Item "s"
تنظیم اندازه تصویر خروجی، پیش‌فرض \*(Aqhd720\*(Aq است.
.IP \fBfps\fR 4
.IX Item "fps"
تنظیم نرخ فریم خروجی، پیش‌فرض \*(Aq25\*(Aq است.
.PP
هر عبارت می‌تواند شامل ثابت‌های زیر باشد:
.IP "\fBin_w, iw\fR" 4
.IX Item "in_w, iw"
عرض ورودی.
.IP "\fBin_h, ih\fR" 4
.IX Item "in_h, ih"
ارتفاع ورودی.
.IP "\fBout_w, ow\fR" 4
.IX Item "out_w, ow"
عرض خروجی.
.IP "\fBout_h, oh\fR" 4
.IX Item "out_h, oh"
ارتفاع خروجی.
.IP \fBin\fR 4
.IX Item "in"
شمارش فریم ورودی.
.IP \fBon\fR 4
.IX Item "on"
شمارش فریم خروجی.
.IP "\fBin_time, it\fR" 4
.IX Item "in_time, it"
برچسب زمانی ورودی بیان‌شده به ثانیه. در صورت نامشخص بودن برچسب زمانی ورودی NAN است.
.IP "\fBout_time, time, ot\fR" 4
.IX Item "out_time, time, ot"
برچسب زمانی خروجی بیان‌شده به ثانیه.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
آخرین موقعیت \*(Aqx\*(Aq و \*(Aqy\*(Aq محاسبه‌شده از عبارت \*(Aqx\*(Aq و \*(Aqy\*(Aq برای فریم ورودی کنونی.
.IP \fBpx\fR 4
.IX Item "px"
.PD 0
.IP \fBpy\fR 4
.IX Item "py"
.PD
موقعیت‌های \*(Aqx\*(Aq و \*(Aqy\*(Aq آخرین فریم خروجی فریم ورودی پیشین یا 0 در صورتی که هنوز چنین فریمی وجود نداشته باشد (نخستین فریم ورودی).
.IP \fBzoom\fR 4
.IX Item "zoom"
آخرین بزرگ‌نمایی محاسبه‌شده از عبارت \*(Aqz\*(Aq برای فریم ورودی کنونی.
.IP \fBpzoom\fR 4
.IX Item "pzoom"
آخرین بزرگ‌نمایی محاسبه‌شده آخرین فریم خروجی فریم ورودی پیشین.
.IP \fBduration\fR 4
.IX Item "duration"
تعداد فریم‌های خروجی برای فریم ورودی کنونی. برای هر فریم ورودی از عبارت \*(Aqd\*(Aq محاسبه می‌شود.
.IP \fBpduration\fR 4
.IX Item "pduration"
تعداد فریم‌های خروجی ایجادشده برای فریم ورودی پیشین.
.IP \fBa\fR 4
.IX Item "a"
عدد کسری: عرض ورودی / ارتفاع ورودی
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه (sample aspect ratio)
.IP \fBdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش (display aspect ratio)
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
بزرگ‌نمایی تا 1.5 برابر و همزمان جابجایی به نقطه‌ای نزدیک به مرکز تصویر:
.Sp
.Vb 1
\&        zoompan=z=\*(Aqmin(zoom+0.0015,1.5)\*(Aq:d=700:x=\*(Aqif(gte(zoom,1.5),x,x+1/a)\*(Aq:y=\*(Aqif(gte(zoom,1.5),y,y+1)\*(Aq:s=640x360
.Ve
.IP \(bu 4
بزرگ‌نمایی تا 1.5 برابر و جابجایی همواره در مرکز تصویر:
.Sp
.Vb 1
\&        zoompan=z=\*(Aqmin(zoom+0.0015,1.5)\*(Aq:d=700:x=\*(Aqiw/2\-(iw/zoom/2)\*(Aq:y=\*(Aqih/2\-(ih/zoom/2)\*(Aq
.Ve
.IP \(bu 4
مشابه مورد بالا اما بدون مکث:
.Sp
.Vb 1
\&        zoompan=z=\*(Aqmin(max(zoom,pzoom)+0.0015,1.5)\*(Aq:d=1:x=\*(Aqiw/2\-(iw/zoom/2)\*(Aq:y=\*(Aqih/2\-(ih/zoom/2)\*(Aq
.Ve
.IP \(bu 4
بزرگ‌نمایی 2 برابر در مرکز تصویر تنها برای ثانیه اول ویدیوی ورودی:
.Sp
.Vb 1
\&        zoompan=z=\*(Aqif(between(in_time,0,1),2,1)\*(Aq:d=1:x=\*(Aqiw/2\-(iw/zoom/2)\*(Aq:y=\*(Aqih/2\-(ih/zoom/2)\*(Aq
.Ve
.SS zscale
.IX Subsection "zscale"
مقیاس‌بندی (تغییر اندازه) ویدیوی ورودی با استفاده از کتابخانه z.lib:
<\fBhttps://github.com/sekrit\-twc/zimg\fR>. برای فعال‌سازی کامپایل این
فیلتر باید FFmpeg را با \f(CW\*(C`\-\-enable\-libzimg\*(C'\fR پیکربندی کنید.
.PP
فیلتر zscale با تغییر نسبت ابعاد نمونه خروجی، نسبت ابعاد نمایش خروجی را مجبور می‌کند با ورودی یکسان باشد.
.PP
اگر قالب تصویر ورودی با قالب درخواست‌شده توسط فیلتر بعدی متفاوت باشد، فیلتر zscale ورودی را به قالب درخواست‌شده تبدیل می‌کند.
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض همان ابعاد ورودی است.
.Sp
اگر مقدار \fIwidth\fR یا \fIw\fR برابر 0 باشد، عرض ورودی برای خروجی استفاده می‌شود. اگر مقدار \fIheight\fR یا \fIh\fR برابر 0 باشد، ارتفاع ورودی برای خروجی استفاده می‌شود.
.Sp
اگر یکی و فقط یکی از مقادیر برابر \-n با n >= 1 باشد، فیلتر zscale از مقداری استفاده می‌کند که نسبت ابعاد تصویر ورودی را حفظ کند که از بعد مشخص‌شده دیگر محاسبه می‌شود. پس از آن، اطمینان حاصل می‌کند که بعد محاسبه‌شده بر n بخش‌پذیر است و در صورت لزوم مقدار را تنظیم می‌کند.
.Sp
اگر هر دو مقدار برابر \-n با n >= 1 باشند، رفتار دقیقاً مشابه حالتی خواهد بود که هر دو مقدار روی 0 تنظیم شده باشند همان‌طور که پیش‌تر توضیح داده شد.
.Sp
برای فهرست ثابت‌های پذیرفته‌شده جهت استفاده در عبارت ابعاد، به بخش زیر مراجعه کنید.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیو. برای نحو نگارش این گزینه، \fBبخش "Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP "\fBdither, d\fR" 4
.IX Item "dither, d"
تنظیم نوع دیتر (dither).
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fInone\fR 4
.IX Item "none"
.PD 0
.IP \fIordered\fR 4
.IX Item "ordered"
.IP \fIrandom\fR 4
.IX Item "random"
.IP \fIerror_diffusion\fR 4
.IX Item "error_diffusion"
.PD
.RE
.RS 4
.Sp
پیش‌فرض none است.
.RE
.IP "\fBfilter, f\fR" 4
.IX Item "filter, f"
تنظیم نوع فیلتر تغییر اندازه.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIpoint\fR 4
.IX Item "point"
.PD 0
.IP \fIbilinear\fR 4
.IX Item "bilinear"
.IP \fIbicubic\fR 4
.IX Item "bicubic"
.IP \fIspline16\fR 4
.IX Item "spline16"
.IP \fIspline36\fR 4
.IX Item "spline36"
.IP \fIspline64\fR 4
.IX Item "spline64"
.IP \fIlanczos\fR 4
.IX Item "lanczos"
.PD
.RE
.RS 4
.Sp
پیش‌فرض bilinear است.
.RE
.IP "\fBrange, r\fR" 4
.IX Item "range, r"
تنظیم محدوده رنگ.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fIlimited\fR 4
.IX Item "limited"
.IP \fIfull\fR 4
.IX Item "full"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBprimaries, p\fR" 4
.IX Item "primaries, p"
تنظیم رنگ‌های اصلی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI170m\fR 4
.IX Item "170m"
.IP \fI240m\fR 4
.IX Item "240m"
.IP \fI2020\fR 4
.IX Item "2020"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBtransfer, t\fR" 4
.IX Item "transfer, t"
تنظیم ویژگی‌های انتقال.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI601\fR 4
.IX Item "601"
.IP \fIlinear\fR 4
.IX Item "linear"
.IP \fI2020_10\fR 4
.IX Item "2020_10"
.IP \fI2020_12\fR 4
.IX Item "2020_12"
.IP \fIsmpte2084\fR 4
.IX Item "smpte2084"
.IP \fIiec61966\-2\-1\fR 4
.IX Item "iec61966-2-1"
.IP \fIarib\-std\-b67\fR 4
.IX Item "arib-std-b67"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBmatrix, m\fR" 4
.IX Item "matrix, m"
تنظیم ماتریس فضای رنگی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI470bg\fR 4
.IX Item "470bg"
.IP \fI170m\fR 4
.IX Item "170m"
.IP \fI2020_ncl\fR 4
.IX Item "2020_ncl"
.IP \fI2020_cl\fR 4
.IX Item "2020_cl"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBrangein, rin\fR" 4
.IX Item "rangein, rin"
تنظیم محدوده رنگ ورودی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fIlimited\fR 4
.IX Item "limited"
.IP \fIfull\fR 4
.IX Item "full"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBprimariesin, pin\fR" 4
.IX Item "primariesin, pin"
تنظیم رنگ‌های اصلی ورودی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI170m\fR 4
.IX Item "170m"
.IP \fI240m\fR 4
.IX Item "240m"
.IP \fI2020\fR 4
.IX Item "2020"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBtransferin, tin\fR" 4
.IX Item "transferin, tin"
تنظیم ویژگی‌های انتقال ورودی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI601\fR 4
.IX Item "601"
.IP \fIlinear\fR 4
.IX Item "linear"
.IP \fI2020_10\fR 4
.IX Item "2020_10"
.IP \fI2020_12\fR 4
.IX Item "2020_12"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBmatrixin, min\fR" 4
.IX Item "matrixin, min"
تنظیم ماتریس فضای رنگی ورودی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fI709\fR 4
.IX Item "709"
.IP \fIunspecified\fR 4
.IX Item "unspecified"
.IP \fI470bg\fR 4
.IX Item "470bg"
.IP \fI170m\fR 4
.IX Item "170m"
.IP \fI2020_ncl\fR 4
.IX Item "2020_ncl"
.IP \fI2020_cl\fR 4
.IX Item "2020_cl"
.PD
.RE
.RS 4
.RE
.IP "\fBchromal, c\fR" 4
.IX Item "chromal, c"
تنظیم موقعیت رنگ (chroma) خروجی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fIleft\fR 4
.IX Item "left"
.IP \fIcenter\fR 4
.IX Item "center"
.IP \fItopleft\fR 4
.IX Item "topleft"
.IP \fItop\fR 4
.IX Item "top"
.IP \fIbottomleft\fR 4
.IX Item "bottomleft"
.IP \fIbottom\fR 4
.IX Item "bottom"
.PD
.RE
.RS 4
.RE
.IP "\fBchromalin, cin\fR" 4
.IX Item "chromalin, cin"
تنظیم موقعیت رنگ (chroma) ورودی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIinput\fR 4
.IX Item "input"
.PD 0
.IP \fIleft\fR 4
.IX Item "left"
.IP \fIcenter\fR 4
.IX Item "center"
.IP \fItopleft\fR 4
.IX Item "topleft"
.IP \fItop\fR 4
.IX Item "top"
.IP \fIbottomleft\fR 4
.IX Item "bottomleft"
.IP \fIbottom\fR 4
.IX Item "bottom"
.PD
.RE
.RS 4
.RE
.IP \fBnpl\fR 4
.IX Item "npl"
تنظیم روشنایی اوج نامی (nominal peak luminance).
.IP \fBparam_a\fR 4
.IX Item "param_a"
پارامتر A برای فیلترهای مقیاس‌بندی. پارامتر "b" برای دومکعبی (bicubic)، و تعداد شاخه‌ها (taps) برای لانچوس (lanczos).
.IP \fBparam_b\fR 4
.IX Item "param_b"
پارامتر B برای فیلترهای مقیاس‌بندی. پارامتر "c" برای دومکعبی.
.PP
مقادیر گزینه‌های \fBw\fR و \fBh\fR عباراتی هستند که شامل ثابت‌های زیر می‌باشند:
.IP \fIin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fIin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ورودی
.IP \fIiw\fR 4
.IX Item "iw"
.PD 0
.IP \fIih\fR 4
.IX Item "ih"
.PD
همانند \fIin_w\fR و \fIin_h\fR هستند.
.IP \fIout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fIout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع خروجی (مقیاس‌شده)
.IP \fIow\fR 4
.IX Item "ow"
.PD 0
.IP \fIoh\fR 4
.IX Item "oh"
.PD
همانند \fIout_w\fR و \fIout_h\fR هستند.
.IP \fIa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR
.IP \fIsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه ورودی
.IP \fIdar\fR 4
.IX Item "dar"
نسبت ابعاد نمایش ورودی. محاسبه‌شده از \f(CW\*(C`(iw / ih) * sar\*(C'\fR.
.IP \fIhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fIvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری رنگ (chroma subsample) افقی و عمودی ورودی. برای مثال برای قالب پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.IP \fIohsub\fR 4
.IX Item "ohsub"
.PD 0
.IP \fIovsub\fR 4
.IX Item "ovsub"
.PD
مقادیر زیرنمونه‌برداری رنگ افقی و عمودی خروجی. برای مثال برای قالب پیکسلی "yuv422p" مقدار \fIhsub\fR برابر 2 و \fIvsub\fR برابر 1 است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی.
دستور همان نحو نگارش گزینه متناظر را می‌پذیرد.
.Sp
اگر عبارت مشخص‌شده معتبر نباشد، مقدار کنونی خود را حفظ می‌کند.
.SH "CUDA VIDEO FILTERS"
.IX Header "CUDA VIDEO FILTERS"
در ادامه شرحی از فیلترهای ویدیویی Nvidia CUDA موجود ارائه شده است.
.PP
پیش‌نیازها:
.IP "*<Install Nvidia CUDA Toolkit>" 4
.IX Item "*<Install Nvidia CUDA Toolkit>"
.PP
نکته: اگر FFmpeg در طول پیکربندی Nvidia CUDA Toolkit را تشخیص دهد، فیلترهای CUDA را به طور خودکار بدون نیاز به هیچ پرچم اضافی فعال می‌کند. اگر می‌خواهید آن‌ها را صریحاً فعال کنید، از گزینه‌های زیر استفاده نمایید:
.ie n .IP "*<Configure FFmpeg with ""\-\-enable\-cuda\-nvcc \-\-enable\-nonfree"".>" 4
.el .IP "*<Configure FFmpeg with \f(CW\-\-enable\-cuda\-nvcc \-\-enable\-nonfree\fR.>" 4
.IX Item "*<Configure FFmpeg with --enable-cuda-nvcc --enable-nonfree.>"
.PD 0
.ie n .IP "*<Configure FFmpeg with ""\-\-enable\-cuda\-llvm"". Additional requirement: ""llvm"" lib must be installed.>" 4
.el .IP "*<Configure FFmpeg with \f(CW\-\-enable\-cuda\-llvm\fR. Additional requirement: \f(CWllvm\fR lib must be installed.>" 4
.IX Item "*<Configure FFmpeg with --enable-cuda-llvm. Additional requirement: llvm lib must be installed.>"
.PD
.PP
اجرای فیلترهای CUDA نیازمند آن است که یک دستگاه سخت‌افزاری را مقداردهی اولیه کرده و آن دستگاه را به تمام فیلترها در هر گراف فیلتری ارسال کنید.
.IP "\fB\-init_hw_device cuda[=\fR\fIname\fR\fB][:\fR\fIdevice\fR\fB[,\fR\fIkey=value\fR\fB...]]\fR" 4
.IX Item "-init_hw_device cuda[=name][:device[,key=value...]]"
مقداردهی اولیه یک دستگاه سخت‌افزاری جدید از نوع \fIcuda\fR به نام \fIname\fR، با استفاده از پارامترهای دستگاه داده‌شده.
.IP "\fB\-filter_hw_device\fR \fIname\fR" 4
.IX Item "-filter_hw_device name"
ارسال دستگاه سخت‌افزاری با نام \fIname\fR به تمامی فیلترها در هر گراف فیلتر.
.PP
برای کسب اطلاعات دقیق‌تر به <\fBhttps://www.ffmpeg.org/ffmpeg.html#Advanced\-Video\-options\fR> مراجعه کنید
.IP \(bu 4
مثال از مقداردهی اولیه دومین دستگاه CUDA در سیستم و اجرای فیلترهای scale_cuda و bilateral_cuda روی آن:
.Sp
.Vb 3
\&        ./ffmpeg \-hwaccel cuda \-hwaccel_output_format cuda \-i input.mp4 \-init_hw_device cuda:1 \-filter_complex \e
\&        "[0:v]scale_cuda=format=yuv444p[scaled_video];[scaled_video]bilateral_cuda=window_size=9:sigmaS=3.0:sigmaR=50.0" \e
\&        \-an \-sn \-c:v h264_nvenc \-cq 20 out.mp4
.Ve
.PP
از آنجا که فیلترهای CUDA منحصراً روی حافظه GPU کار می‌کنند، داده‌های فریم گاهی اوقات باید پیش از پردازش به سطوح سخت‌افزاری مرتبط با دستگاه CUDA مناسب بارگذاری شوند (\fBhwupload\fR)، و پس از آن در صورت نیاز به حافظه عادی بازگردانده شوند (\fBhwdownload\fR). اینکه آیا \fBhwupload\fR یا \fBhwdownload\fR ضروری است یا خیر، به گردش کار خاص بستگی دارد:
.ie n .IP "*<If the input frames are already in GPU memory (e.g., when using ""\-hwaccel cuda"" or ""\-hwaccel_output_format cuda""), explicit use of \fBhwupload\fR is not needed, as the data is already in the appropriate memory space.>" 4
.el .IP "*<If the input frames are already in GPU memory (e.g., when using \f(CW\-hwaccel cuda\fR or \f(CW\-hwaccel_output_format cuda\fR), explicit use of \fBhwupload\fR is not needed, as the data is already in the appropriate memory space.>" 4
.IX Item "*<If the input frames are already in GPU memory (e.g., when using -hwaccel cuda or -hwaccel_output_format cuda), explicit use of hwupload is not needed, as the data is already in the appropriate memory space.>"
.PD 0
.IP "*<If the input frames are in CPU memory (e.g., software\-decoded frames or frames processed by CPU\-based filters), it is necessary to use \fBhwupload\fR to transfer the data to GPU memory for CUDA processing.>" 4
.IX Item "*<If the input frames are in CPU memory (e.g., software-decoded frames or frames processed by CPU-based filters), it is necessary to use hwupload to transfer the data to GPU memory for CUDA processing.>"
.IP "*<If the output of the CUDA filters needs to be further processed by software\-based filters or saved in a format not supported by GPU\-based encoders, \fBhwdownload\fR is required to transfer the data back to CPU memory.>" 4
.IX Item "*<If the output of the CUDA filters needs to be further processed by software-based filters or saved in a format not supported by GPU-based encoders, hwdownload is required to transfer the data back to CPU memory.>"
.PD
.PP
توجه داشته باشید که \fBhwupload\fR داده‌ها را روی سطحی با همان طرح‌بندی فریم نرم‌افزاری بارگذاری می‌کند، بنابراین ممکن است لازم باشد بلافاصله پیش از \fBhwupload\fR یک فیلتر \fBformat\fR اضافه کنید تا مطمئن شوید ورودی در قالب درستی قرار دارد. به طور مشابه، \fBhwdownload\fR ممکن است از همه قالب‌های خروجی پشتیبانی نکند، بنابراین ممکن است لازم باشد یک فیلتر \fBformat\fR اضافی بلافاصله پس از \fBhwdownload\fR در گراف فیلتر قرار داده شود تا سازگاری تضمین شود.
.SS bilateral_cuda
.IX Subsection "bilateral_cuda"
فیلتر دوطرفه (bilateral) شتاب‌یافته با CUDA، یک فیلتر حفظ‌کننده لبه.
این فیلتر به لطف استفاده از شتاب‌دهی GPU از نظر ریاضی دقیق است.
برای بهترین کیفیت خروجی، از زیرنمونه‌برداری رنگ یک‌به‌یک، یعنی قالب yuv444p استفاده کنید.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigmaS\fR 4
.IX Item "sigmaS"
تنظیم سیگما برای تابع گاوسی جهت محاسبه وزن مکانی، که سیگمای مکان (sigma space) نیز نامیده می‌شود.
بازه مجاز 0.1 تا 512 است. پیش‌فرض 0.1 است.
.IP \fBsigmaR\fR 4
.IX Item "sigmaR"
تنظیم سیگما برای تابع گاوسی جهت محاسبه وزن محدوده رنگ، که سیگمای رنگ (sigma color) نیز نامیده می‌شود.
بازه مجاز 0.1 تا 512 است. پیش‌فرض 0.1 است.
.IP \fBwindow_size\fR 4
.IX Item "window_size"
تنظیم اندازه پنجره تابع دوطرفه برای تعیین تعداد همسایه‌ها جهت حلقه زدن روی آن‌ها.
اگر عدد واردشده زوج باشد، یک واحد به طور خودکار به آن اضافه می‌شود.
بازه مجاز 1 تا 255 است. پیش‌فرض 1 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال فیلتر دوطرفه روی یک ویدیو:
.Sp
.Vb 8
\&        ./ffmpeg \-v verbose \e
\&        \-hwaccel cuda \-hwaccel_output_format cuda \-i input.mp4  \e
\&        \-init_hw_device cuda \e
\&        \-filter_complex \e
\&        " \e
\&        [0:v]scale_cuda=format=yuv444p[scaled_video];
\&        [scaled_video]bilateral_cuda=window_size=9:sigmaS=3.0:sigmaR=50.0" \e
\&        \-an \-sn \-c:v h264_nvenc \-cq 20 out.mp4
.Ve
.SS bwdif_cuda
.IX Subsection "bwdif_cuda"
دی‌اینترلیس کردن ویدیوی ورودی با استفاده از الگوریتم \fBbwdif\fR، اما پیاده‌سازی‌شده در CUDA تا بتواند به عنوان بخشی از یک خط‌لوله شتاب‌یافته با GPU به همراه nvdec و/یا nvenc کار کند.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت اینترلیس برای اتخاذ. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, send_frame\fR" 4
.IX Item "0, send_frame"
خروجی دادن یک فریم به ازای هر فریم.
.IP "\fB1, send_field\fR" 4
.IX Item "1, send_field"
خروجی دادن یک فریم به ازای هر میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`send_field\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
توازن میدان تصویر که برای ویدیوی اینترلیس ورودی فرض می‌شود. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض می‌شود میدان بالایی در ابتدا است.
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض می‌شود میدان پایینی در ابتدا است.
.IP "\fB\-1, auto\fR" 4
.IX Item "-1, auto"
فعال‌سازی تشخیص خودکار توازن میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر حالت اینترلیس ناشناخته باشد یا رمزگشا این اطلاعات را صادر نکند، فرض می‌شود که میدان بالایی در ابتدا است.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین اینکه کدام فریم‌ها دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, all\fR" 4
.IX Item "0, all"
دی‌اینترلیس کردن تمامی فریم‌ها.
.IP "\fB1, interlaced\fR" 4
.IX Item "1, interlaced"
فقط دی‌اینترلیس کردن فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.SS chromakey_cuda
.IX Subsection "chromakey_cuda"
حذف رنگ پس‌زمینه (color/chroma keying) در فضای رنگی YUV با شتاب‌دهی CUDA.
.PP
این فیلتر مانند فیلتر کروماکی معمولی کار می‌کند اما روی فریم‌های CUDA عمل می‌نماید.
برای جزئیات و پارامترهای بیشتر به \fBchromakey\fR مراجعه کنید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
شفاف کردن تمام پیکسل‌های سبز در ویدیوی ورودی و استفاده از آن به عنوان یک لایه روی ویدیوی دیگر:
.Sp
.Vb 10
\&        ./ffmpeg \e
\&            \-hwaccel cuda \-hwaccel_output_format cuda \-i input_green.mp4  \e
\&            \-hwaccel cuda \-hwaccel_output_format cuda \-i base_video.mp4 \e
\&            \-init_hw_device cuda \e
\&            \-filter_complex \e
\&            " \e
\&                [0:v]chromakey_cuda=0x25302D:0.1:0.12:1[overlay_video]; \e
\&                [1:v]scale_cuda=format=yuv420p[base]; \e
\&                [base][overlay_video]overlay_cuda" \e
\&            \-an \-sn \-c:v h264_nvenc \-cq 20 output.mp4
.Ve
.IP \(bu 4
پردازش دو منبع نرم‌افزاری، همراه با بارگذاری صریح فریم‌ها:
.Sp
.Vb 9
\&        ./ffmpeg \-init_hw_device cuda=cuda \-filter_hw_device cuda \e
\&            \-f lavfi \-i color=size=800x600:color=white,format=yuv420p \e
\&            \-f lavfi \-i yuvtestsrc=size=200x200,format=yuv420p \e
\&            \-filter_complex \e
\&            " \e
\&                [0]hwupload[under]; \e
\&                [1]hwupload,chromakey_cuda=green:0.1:0.12[over]; \e
\&                [under][over]overlay_cuda" \e
\&            \-c:v hevc_nvenc \-cq 18 \-preset slow output.mp4
.Ve
.SS colorspace_cuda
.IX Subsection "colorspace_cuda"
پیاده‌سازی شتاب‌یافته با CUDA از فیلتر فضای رنگی (colorspace).
.PP
این فیلتر در مقایسه با فیلتر نرم‌افزاری colorspace به هیچ وجه از نظر قابلیت کامل نیست و در حال حاضر فقط از تبدیل محدوده رنگ بین محدوده jpeg/کامل و mpeg/محدود پشتیبانی می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrange\fR 4
.IX Item "range"
تعیین محدوده رنگ خروجی.
.Sp
مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBtv\fR 4
.IX Item "tv"
محدوده تلویزیونی (محدود)
.IP \fBmpeg\fR 4
.IX Item "mpeg"
محدوده MPEG (محدود)
.IP \fBpc\fR 4
.IX Item "pc"
محدوده PC (کامل)
.IP \fBjpeg\fR 4
.IX Item "jpeg"
محدوده JPEG (کامل)
.RE
.RS 4
.RE
.SS overlay_cuda
.IX Subsection "overlay_cuda"
قرار دادن یک ویدیو روی ویدیوی دیگر (overlay).
.PP
این نسخه CUDA از فیلتر \fBoverlay\fR است.
این فیلتر تنها فریم‌های CUDA را می‌پذیرد. قالب‌های پیکسلی ورودی زیربنایی باید مطابقت داشته باشند.
.PP
این فیلتر دو ورودی می‌گیرد و یک خروجی دارد. ورودی اول ویدیوی "اصلی" است که ورودی دوم روی آن قرار می‌گیرد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم عبارات برای مختصات x و y ویدیوی قرار داده‌شده روی ویدیوی اصلی.
.Sp
آن‌ها می‌توانند شامل پارامترهای زیر باشند:
.RS 4
.IP "\fBmain_w, W\fR" 4
.IX Item "main_w, W"
.PD 0
.IP "\fBmain_h, H\fR" 4
.IX Item "main_h, H"
.PD
عرض و ارتفاع ورودی اصلی.
.IP "\fBoverlay_w, w\fR" 4
.IX Item "overlay_w, w"
.PD 0
.IP "\fBoverlay_h, h\fR" 4
.IX Item "overlay_h, h"
.PD
عرض و ارتفاع ورودی لایه رویی (overlay).
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مقادیر محاسبه‌شده برای \fIx\fR و \fIy\fR. آن‌ها برای هر فریم جدید ارزیابی می‌شوند.
.IP \fBn\fR 4
.IX Item "n"
شاخص ترتیبی فریم ورودی اصلی، شروع از 0.
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت آفست بایتی فریم ورودی اصلی در پرونده، در صورت نامشخص بودن NAN. منسوخ‌شده، استفاده نکنید.
.IP \fBt\fR 4
.IX Item "t"
برچسب زمانی فریم ورودی اصلی، بیان‌شده به ثانیه، در صورت نامشخص بودن NAN.
.RE
.RS 4
.Sp
مقدار پیش‌فرض برای هر دو عبارت "0" است.
.RE
.IP \fBeval\fR 4
.IX Item "eval"
تنظیم زمان ارزیابی عبارات \fBx\fR و \fBy\fR.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBinit\fR 4
.IX Item "init"
ارزیابی عبارات یک بار در حین مقداردهی اولیه فیلتر یا هنگام پردازش یک دستور.
.IP \fBframe\fR 4
.IX Item "frame"
ارزیابی عبارات برای هر فریم ورودی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBframe\fR است.
.RE
.IP \fBeof_action\fR 4
.IX Item "eof_action"
به \fBframesync\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBframesync\fR مراجعه کنید.
.IP \fBrepeatlast\fR 4
.IX Item "repeatlast"
به \fBframesync\fR مراجعه کنید.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.SS pad_cuda
.IX Subsection "pad_cuda"
افزودن حاشیه (padding) به استریم ویدیوی ورودی با استفاده از CUDA.
.PP
این فیلتر نسخه شتاب‌یافته با CUDA از فیلتر \fBpad\fR است. این فیلتر همان گزینه‌ها و عبارات را می‌پذیرد و همان قابلیت اصلی را ارائه می‌دهد.
برای شرح دقیق گزینه‌های موجود، لطفاً مستندات فیلتر \fBpad\fR را ببینید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
افزودن یک حاشیه سیاه 200 پیکسلی به تمام جهات فریم ویدیو:
.Sp
.Vb 1
\&        ffmpeg \-hwaccel cuda \-hwaccel_output_format cuda \-i input.mp4 \-vf "pad_cuda=w=iw+400:h=ih+400:x=200:y=200" \-c:v h264_nvenc out.mp4
.Ve
.IP \(bu 4
افزودن حاشیه به ویدیوی ورودی برای رسیدن به نسبت ابعاد 16:9، پر شده با رنگ "blue":
.Sp
.Vb 1
\&        ffmpeg \-hwaccel cuda \-hwaccel_output_format cuda \-i input.mp4 \-vf "pad_cuda=w=ih*16/9/sar:h=ih:x=(ow\-iw)/2:y=(oh\-ih)/2:color=blue" \-c:v h264_nvenc out.mp4
.Ve
.SS scale_cuda
.IX Subsection "scale_cuda"
مقیاس‌بندی (تغییر اندازه) و تبدیل (قالب پیکسلی) ویدیوی ورودی با استفاده از هسته‌های شتاب‌یافته CUDA.
تنظیم عرض و ارتفاع خروجی به همان شیوه فیلتر \fBscale\fR کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض ابعاد ورودی است.
.Sp
عبارات یکسانی مانند فیلتر \fBscale\fR را مجاز می‌داند.
.IP \fBinterp_algo\fR 4
.IX Item "interp_algo"
تنظیم الگوریتم مورد استفاده برای مقیاس‌بندی:
.RS 4
.IP \fInearest\fR 4
.IX Item "nearest"
نزدیک‌ترین همسایه (Nearest neighbour)
.Sp
اگر پارامترهای ورودی با خروجی مورد نظر مطابقت داشته باشند، به طور پیش‌فرض استفاده می‌شود.
.IP \fIbilinear\fR 4
.IX Item "bilinear"
دوسطحی (Bilinear)
.IP \fIbicubic\fR 4
.IX Item "bicubic"
دومکعبی (Bicubic)
.Sp
این حالت پیش‌فرض است.
.IP \fIlanczos\fR 4
.IX Item "lanczos"
لانچوس (Lanczos)
.RE
.RS 4
.RE
.IP \fBformat\fR 4
.IX Item "format"
قالب پیکسلی خروجی را کنترل می‌کند. به طور پیش‌فرض، یا در صورت عدم تعیین، از قالب پیکسلی ورودی استفاده می‌شود.
.Sp
این فیلتر از تبدیل بین قالب‌های پیکسلی YUV و RGB پشتیبانی نمی‌کند.
.IP \fBpassthrough\fR 4
.IX Item "passthrough"
اگر روی 0 تنظیم شود، هر فریم حتی اگر هیچ تبدیلی لازم نباشد پردازش می‌شود. این حالت می‌تواند برای استفاده از فیلتر به عنوان بافر برای یک مصرف‌کننده فریم پایینی که مخزن فریم محدود رمزگشا را تخلیه می‌کند، مفید باشد.
.Sp
اگر روی 1 تنظیم شود، در صورتی که فریم‌ها با پارامترهای خروجی مورد نظر مطابقت داشته باشند بدون تغییر عبور داده می‌شوند. این رفتار پیش‌فرض است.
.IP \fBuse_filters\fR 4
.IX Item "use_filters"
اگر روی 1 تنظیم شود، به جای استفاده از هسته‌های سایه‌زن تابع‌ثابت، با یک جدول مراجعه (LUT) وزن سراسری فیلتر می‌کند. بسته به سخت‌افزار ممکن است سریع‌تر یا کندتر باشد. مقدار \f(CW\*(C`auto\*(C'\fR (پیش‌فرض) این ویژگی را در صورت لزوم برای ضدپلگی (anti\-aliasing) صحیح هنگام کاهش مقیاس به طور خودکار فعال می‌کند.
.IP \fBparam\fR 4
.IX Item "param"
پارامتر خاص الگوریتم.
.Sp
بر منحنی‌های الگوریتم bicubic تأثیر می‌گذارد.
.IP \fBforce_original_aspect_ratio\fR 4
.IX Item "force_original_aspect_ratio"
.PD 0
.IP \fBforce_divisible_by\fR 4
.IX Item "force_divisible_by"
.PD
مشابه گزینه‌های هم‌نام در فیلتر \fBscale\fR کار می‌کنند.
.IP \fBreset_sar\fR 4
.IX Item "reset_sar"
مشابه گزینه هم‌نام در فیلتر \fBscale\fR کار می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مقیاس‌بندی ورودی به 720p با حفظ نسبت ابعاد و اطمینان از اینکه خروجی yuv420p است:
.Sp
.Vb 1
\&        scale_cuda=\-2:720:format=yuv420p
.Ve
.IP \(bu 4
افزایش مقیاس به 4K با استفاده از الگوریتم نزدیک‌ترین همسایه:
.Sp
.Vb 1
\&        scale_cuda=4096:2160:interp_algo=nearest
.Ve
.IP \(bu 4
هیچ تبدیل یا مقیاس‌بندی انجام ندهد، اما تمام فریم‌های ورودی را در فریم‌های تازه تخصیص‌یافته کپی کند. این می‌تواند برای مدیریت یک زنجیره فیلتر و کدگذاری که در غیر این صورت مخزن فریم‌های رمزگشاها را تخلیه می‌کند مفید باشد:
.Sp
.Vb 1
\&        scale_cuda=passthrough=0
.Ve
.SS thumbnail_cuda
.IX Subsection "thumbnail_cuda"
انتخاب نماینده‌ترین فریم در یک دنباله مشخص از فریم‌های متوالی با استفاده از CUDA.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم اندازه دسته فریم‌ها برای تحلیل؛ در مجموعه‌ای از \fIn\fR فریم، فیلتر یکی از آن‌ها را انتخاب کرده و سپس دسته بعدی از \fIn\fR فریم را تا پایان پردازش می‌کند. پیش‌فرض \f(CW100\fR است.
.PP
از آنجا که فیلتر رد کل دنباله فریم‌ها را نگه می‌دارد، مقدار بزرگ‌تر \fIn\fR منجر به مصرف حافظه بیشتر خواهد شد، بنابراین مقدار بالا توصیه نمی‌شود.
.PP
\fIمثال\fR
.IX Subsection "Example"
.IP \(bu 4
بندانگشتی‌ها از هر دسته \fIn\fR=150 فریمی استخراج می‌شوند و در هر دسته یک فریم انتخاب می‌شود. فریم‌های انتخاب‌شده سپس با \fBscale_cuda\fR مقیاس‌بندی می‌شوند:
.Sp
.Vb 1
\&        ./ffmpeg  \-hwaccel cuda \-hwaccel_output_format cuda  \-i ./input.mp4 \-vf "thumbnail_cuda=150,scale_cuda=1920:1080,hwdownload,format=nv12" ./output/out%03d.png
.Ve
.SS transpose_cuda
.IX Subsection "transpose_cuda"
جابجایی سطرها با ستون‌ها در ویدیوی ورودی و برگرداندن (flip) اختیاری آن.
برای مثال‌های دقیق‌تر فیلتر ویدیویی \fBtranspose\fR را ببینید که عمدتاً گزینه‌های یکسانی دارد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBdir\fR 4
.IX Item "dir"
تعیین جهت ترانهش (transposition).
.Sp
می‌تواند مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBcclock_flip\fR 4
.IX Item "cclock_flip"
چرخش ۹۰ درجه خلاف جهت عقربه‌های ساعت و برگرداندن عمودی. (پیش‌فرض)
.IP \fBclock\fR 4
.IX Item "clock"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت.
.IP \fBcclock\fR 4
.IX Item "cclock"
چرخش ۹۰ درجه خلاف جهت عقربه‌های ساعت.
.IP \fBclock_flip\fR 4
.IX Item "clock_flip"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت و برگرداندن عمودی.
.IP \fBreversal\fR 4
.IX Item "reversal"
چرخش ۱۸۰ درجه.
.IP \fBhflip\fR 4
.IX Item "hflip"
برگرداندن افقی.
.IP \fBvflip\fR 4
.IX Item "vflip"
برگرداندن عمودی.
.RE
.RS 4
.RE
.IP \fBpassthrough\fR 4
.IX Item "passthrough"
در صورتی که هندسه ورودی با هندسه مشخص‌شده توسط مقدار تعیین‌شده مطابقت داشته باشد، ترانهش اعمال نشود. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
همواره ترانهش اعمال شود. (پیش‌فرض)
.IP \fBportrait\fR 4
.IX Item "portrait"
حفظ هندسه عمودی (پرتره) (زمانی که \fIheight\fR >= \fIwidth\fR).
.IP \fBlandscape\fR 4
.IX Item "landscape"
حفظ هندسه افقی (لنداسکیپ) (زمانی که \fIwidth\fR >= \fIheight\fR).
.RE
.RS 4
.RE
.SS yadif_cuda
.IX Subsection "yadif_cuda"
دی‌اینترلیس کردن ویدیوی ورودی با استفاده از الگوریتم \fByadif\fR، اما پیاده‌سازی‌شده در CUDA تا بتواند به عنوان بخشی از یک خط‌لوله شتاب‌یافته با GPU به همراه nvdec و/یا nvenc کار کند.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت اینترلیس برای اتخاذ. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, send_frame\fR" 4
.IX Item "0, send_frame"
خروجی دادن یک فریم به ازای هر فریم.
.IP "\fB1, send_field\fR" 4
.IX Item "1, send_field"
خروجی دادن یک فریم به ازای هر میدان.
.IP "\fB2, send_frame_nospatial\fR" 4
.IX Item "2, send_frame_nospatial"
مشابه \f(CW\*(C`send_frame\*(C'\fR، اما بررسی اینترلیس مکانی را نادیده می‌گیرد.
.IP "\fB3, send_field_nospatial\fR" 4
.IX Item "3, send_field_nospatial"
مشابه \f(CW\*(C`send_field\*(C'\fR، اما بررسی اینترلیس مکانی را نادیده می‌گیرد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`send_frame\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
توازن میدان تصویر که برای ویدیوی اینترلیس ورودی فرض می‌شود. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض می‌شود میدان بالایی در ابتدا است.
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض می‌شود میدان پایینی در ابتدا است.
.IP "\fB\-1, auto\fR" 4
.IX Item "-1, auto"
فعال‌سازی تشخیص خودکار توازن میدان.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر حالت اینترلیس ناشناخته باشد یا رمزگشا این اطلاعات را صادر نکند، فرض می‌شود که میدان بالایی در ابتدا است.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین اینکه کدام فریم‌ها دی‌اینترلیس شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, all\fR" 4
.IX Item "0, all"
دی‌اینترلیس کردن تمام فریم‌ها.
.IP "\fB1, interlaced\fR" 4
.IX Item "1, interlaced"
فقط دی‌اینترلیس کردن فریم‌هایی که به عنوان اینترلیس علامت‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.SH "OPENCL VIDEO FILTERS"
.IX Header "OPENCL VIDEO FILTERS"
در ادامه شرحی از فیلترهای ویدیویی OpenCL موجود ارائه شده است.
.PP
برای فعال‌سازی کامپایل این فیلترها باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-opencl\*(C'\fR پیکربندی کنید.
.PP
اجرای فیلترهای OpenCL نیازمند آن است که یک دستگاه سخت‌افزاری را مقداردهی اولیه کرده و آن دستگاه را به تمام فیلترها در هر گراف فیلتری ارسال کنید.
.IP "\fB\-init_hw_device opencl[=\fR\fIname\fR\fB][:\fR\fIdevice\fR\fB[,\fR\fIkey=value\fR\fB...]]\fR" 4
.IX Item "-init_hw_device opencl[=name][:device[,key=value...]]"
مقداردهی اولیه یک دستگاه سخت‌افزاری جدید از نوع \fIopencl\fR به نام \fIname\fR، با استفاده از پارامترهای دستگاه داده‌شده.
.IP "\fB\-filter_hw_device\fR \fIname\fR" 4
.IX Item "-filter_hw_device name"
ارسال دستگاه سخت‌افزاری با نام \fIname\fR به تمامی فیلترها در هر گراف فیلتر.
.PP
برای کسب اطلاعات دقیق‌تر به <\fBhttps://www.ffmpeg.org/ffmpeg.html#Advanced\-Video\-options\fR> مراجعه کنید
.IP \(bu 4
مثال از انتخاب دستگاه اول روی پلتفرم دوم و اجرای فیلتر avgblur_opencl با پارامترهای پیش‌فرض روی آن:
.Sp
.Vb 1
\&        \-init_hw_device opencl=gpu:1.0 \-filter_hw_device gpu \-i INPUT \-vf "hwupload, avgblur_opencl, hwdownload" OUTPUT
.Ve
.PP
از آنجا که فیلترهای OpenCL قادر به دسترسی به داده‌های فریم در حافظه عادی نیستند، تمام داده‌های فریم باید پیش از استفاده در سطوح سخت‌افزاری متصل به دستگاه مناسب بارگذاری شوند (\fBhwupload\fR) و سپس به حافظه عادی بازگردانده شوند (\fBhwdownload\fR). توجه داشته باشید که \fBhwupload\fR روی سطحی با همان طرح‌بندی فریم نرم‌افزاری بارگذاری می‌کند، بنابراین ممکن است لازم باشد بلافاصله پیش از آن یک فیلتر \fBformat\fR اضافه کنید تا ورودی به قالب درستی تبدیل شود و \fBhwdownload\fR از همه قالب‌ها در خروجی پشتیبانی نمی‌کند \- ممکن است لازم باشد یک فیلتر \fBformat\fR اضافی بلافاصله پس از آن در گراف درج شود تا خروجی در یک قالب پشتیبانی‌شده به دست آید.
.SS avgblur_opencl
.IX Subsection "avgblur_opencl"
اعمال فیلتر تاری میانگین (average blur).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsizeX\fR 4
.IX Item "sizeX"
تنظیم اندازه شعاع افقی.
بازه \f(CW\*(C`[1, 1024]\*(C'\fR و مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تنظیم صفحه‌هایی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW0xf\fR است که با آن همه صفحه‌ها پردازش می‌شوند.
.IP \fBsizeY\fR 4
.IX Item "sizeY"
تنظیم اندازه شعاع عمودی. بازه \f(CW\*(C`[1, 1024]\*(C'\fR و مقدار پیش‌فرض \f(CW0\fR است. اگر صفر باشد، مقدار \f(CW\*(C`sizeX\*(C'\fR استفاده خواهد شد.
.PP
\fIمثال\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال فیلتر تاری میانگین با اندازه افقی و عمودی 3، که هر پیکسل خروجی را روی مقدار میانگین ناحیه 7x7 متمرکز بر آن در ورودی تنظیم می‌کند. برای پیکسل‌های روی لبه‌های تصویر، این ناحیه فراتر از مرزهای تصویر گسترش نمی‌یابد، و بنابراین از مختصات خارج از محدوده در محاسبات استفاده نمی‌شود:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, avgblur_opencl=3, hwdownload" OUTPUT
.Ve
.SS boxblur_opencl
.IX Subsection "boxblur_opencl"
الگوریتم تاری جعبه‌ای (boxblur) را روی ویدیوی ورودی اعمال می‌کند.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
.PD 0
.IP "\fBluma_power, lp\fR" 4
.IX Item "luma_power, lp"
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
.IP "\fBchroma_power, cp\fR" 4
.IX Item "chroma_power, cp"
.IP "\fBalpha_radius, ar\fR" 4
.IX Item "alpha_radius, ar"
.IP "\fBalpha_power, ap\fR" 4
.IX Item "alpha_power, ap"
.PD
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP "\fBluma_radius, lr\fR" 4
.IX Item "luma_radius, lr"
.PD 0
.IP "\fBchroma_radius, cr\fR" 4
.IX Item "chroma_radius, cr"
.IP "\fBalpha_radius, ar\fR" 4
.IX Item "alpha_radius, ar"
.PD
عبارتی را برای شعاع جعبه بر حسب پیکسل تعیین می‌کند که برای محو کردن صفحه ورودی مربوطه استفاده می‌شود.
.Sp
مقدار شعاع باید یک عدد غیرمنفی باشد، و نباید بزرگ‌تر از مقدار عبارت \f(CW\*(C`min(w,h)/2\*(C'\fR برای صفحه‌های روشنایی (luma) و آلفا (alpha)، و عبارت \f(CW\*(C`min(cw,ch)/2\*(C'\fR برای صفحه‌های رنگی (chroma) باشد.
.Sp
مقدار پیش‌فرض برای \fBluma_radius\fR برابر "2" است. در صورت عدم تعیین، مقدار \fBchroma_radius\fR و \fBalpha_radius\fR به صورت پیش‌فرض برابر با مقدار تعیین‌شده برای \fBluma_radius\fR خواهد بود.
.Sp
عبارات می‌توانند حاوی ثابت‌های زیر باشند:
.RS 4
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع ورودی بر حسب پیکسل.
.IP \fBcw\fR 4
.IX Item "cw"
.PD 0
.IP \fBch\fR 4
.IX Item "ch"
.PD
عرض و ارتفاع تصویر رنگی (chroma) ورودی بر حسب پیکسل.
.IP \fBhsub\fR 4
.IX Item "hsub"
.PD 0
.IP \fBvsub\fR 4
.IX Item "vsub"
.PD
مقادیر زیرنمونه‌برداری افقی و عمودی کروما. برای مثال، برای قالب پیکسلی "yuv422p"، مقدار \fIhsub\fR برابر ۲ و \fIvsub\fR برابر ۱ است.
.RE
.RS 4
.RE
.IP "\fBluma_power, lp\fR" 4
.IX Item "luma_power, lp"
.PD 0
.IP "\fBchroma_power, cp\fR" 4
.IX Item "chroma_power, cp"
.IP "\fBalpha_power, ap\fR" 4
.IX Item "alpha_power, ap"
.PD
مشخص می‌کند که فیلتر boxblur چند بار بر روی صفحه مربوطه اعمال شود.
.Sp
مقدار پیش‌فرض برای \fBluma_power\fR برابر 2 است. در صورت عدم تعیین، مقادیر \fBchroma_power\fR و \fBalpha_power\fR به طور پیش‌فرض برابر با مقدار تعیین‌شده برای \fBluma_power\fR خواهد بود.
.Sp
مقدار 0 این جلوه را غیرفعال می‌کند.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.PP
فیلتر boxblur را اعمال می‌کند و هر پیکسل خروجی را بر روی میانگین مقادیر شعاع‌های جعبه‌ای \fIluma_radius\fR، \fIchroma_radius\fR و \fIalpha_radius\fR به ترتیب برای هر صفحه تنظیم می‌کند. فیلتر به تعداد \fIluma_power\fR، \fIchroma_power\fR و \fIalpha_power\fR بار بر روی صفحه مربوطه اعمال خواهد شد. برای پیکسل‌های روی لبه‌های تصویر، شعاع فراتر از مرزهای تصویر گسترش نمی‌یابد، بنابراین مختصات خارج از محدوده در محاسبات استفاده نمی‌شوند.
.IP \(bu 4
اعمال یک فیلتر boxblur با تنظیم شعاع روشنایی (luma)، کروما و آلفا روی 2 و توان روشنایی، کروما و آلفا روی 3. فیلتر 3 بار با شعاع جعبه 2 برای تمام صفحات تصویر اجرا خواهد شد.
.Sp
.Vb 2
\&        \-i INPUT \-vf "hwupload, boxblur_opencl=luma_radius=2:luma_power=3, hwdownload" OUTPUT
\&        \-i INPUT \-vf "hwupload, boxblur_opencl=2:3, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال یک فیلتر boxblur با تنظیم شعاع روشنایی روی 2، luma_power روی 1، chroma_radius روی 4، chroma_power روی 5، alpha_radius روی 3 و alpha_power روی 7.
.Sp
برای صفحه روشنایی (luma)، یک شعاع جعبه 2x2 یک‌بار اجرا خواهد شد.
.Sp
برای صفحه کروما (chroma)، یک شعاع جعبه 4x4 پنج بار اجرا خواهد شد.
.Sp
برای صفحه آلفا (alpha)، یک شعاع جعبه 3x3 هفت بار اجرا خواهد شد.
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, boxblur_opencl=2:1:4:5:3:7, hwdownload" OUTPUT
.Ve
.SS colorkey_opencl
.IX Subsection "colorkey_opencl"
کلیدگذاری رنگی (color keying) در فضای رنگی RGB.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
رنگی که با شفافیت جایگزین خواهد شد.
.IP \fBsimilarity\fR 4
.IX Item "similarity"
درصد شباهت با رنگ کلید.
.Sp
مقدار 0.01 فقط دقیقاً با رنگ کلید مطابقت دارد، در حالی که 1.0 با همه چیز مطابقت دارد.
.IP \fBblend\fR 4
.IX Item "blend"
درصد آمیختگی (blend).
.Sp
مقدار 0.0 پیکسل‌ها را یا کاملاً شفاف می‌کند، یا اصلاً شفاف نمی‌کند.
.Sp
مقادیر بالاتر منجر به پیکسل‌های نیمه‌شفاف می‌شوند، و هرچه رنگ پیکسل‌ها به رنگ کلید شبیه‌تر باشد، شفافیت بیشتری خواهند داشت.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
شفاف کردن هر پیکسل مایل به سبز در ورودی با مقداری آمیختگی اندک:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, colorkey_opencl=green:0.3:0.1, hwdownload" OUTPUT
.Ve
.SS convolution_opencl
.IX Subsection "convolution_opencl"
اعمال کانولوشن با ماتریس 3x3، 5x5 یا 7x7.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fB0m\fR 4
.IX Item "0m"
.PD 0
.IP \fB1m\fR 4
.IX Item "1m"
.IP \fB2m\fR 4
.IX Item "2m"
.IP \fB3m\fR 4
.IX Item "3m"
.PD
تنظیم ماتریس برای هر صفحه.
ماتریس دنباله‌ای از 9، 25 یا 49 عدد علامت‌دار است.
مقدار پیش‌فرض برای هر صفحه \f(CW\*(C`0 0 0 0 1 0 0 0 0\*(C'\fR است.
.IP \fB0rdiv\fR 4
.IX Item "0rdiv"
.PD 0
.IP \fB1rdiv\fR 4
.IX Item "1rdiv"
.IP \fB2rdiv\fR 4
.IX Item "2rdiv"
.IP \fB3rdiv\fR 4
.IX Item "3rdiv"
.PD
تنظیم ضریب برای مقدار محاسبه‌شده در هر صفحه.
در صورت عدم تنظیم یا مقدار 0، برابر مجموع تمام عناصر ماتریس خواهد بود.
مقدار گزینه باید یک عدد اعشاری بزرگ‌تر یا مساوی \f(CW0.0\fR باشد. مقدار پیش‌فرض \f(CW1.0\fR است.
.IP \fB0bias\fR 4
.IX Item "0bias"
.PD 0
.IP \fB1bias\fR 4
.IX Item "1bias"
.IP \fB2bias\fR 4
.IX Item "2bias"
.IP \fB3bias\fR 4
.IX Item "3bias"
.PD
تنظیم بایاس (bias) برای هر صفحه. این مقدار به حاصل ضرب اضافه می‌شود.
برای روشن‌تر یا تاریک‌تر کردن تصویر کلی مفید است.
مقدار گزینه باید یک عدد اعشاری بزرگ‌تر یا مساوی \f(CW0.0\fR باشد. مقدار پیش‌فرض \f(CW0.0\fR است.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال شارپ کردن (تیز کردن تصویر):
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0:0 \-1 0 \-1 5 \-1 0 \-1 0, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال تاری (blur):
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1/9:1/9:1/9:1/9, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال برجسته‌سازی لبه‌ها (edge enhance):
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:0 0 0 \-1 1 0 0 0 0:5:1:1:1:0:128:128:128, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال تشخیص لبه (edge detect):
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:0 1 0 1 \-4 1 0 1 0:5:5:5:1:0:128:128:128, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال آشکارساز لبه لاپلاسی شامل قطرها:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:1 1 1 1 \-8 1 1 1 1:5:5:5:1:0:128:128:0, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال نقش‌برجسته (emboss):
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, convolution_opencl=\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2:\-2 \-1 0 \-1 1 1 0 1 2, hwdownload" OUTPUT
.Ve
.SS erosion_opencl
.IX Subsection "erosion_opencl"
اعمال جلوه فرسایش (erosion) روی ویدیو.
.PP
این فیلتر هر پیکسل را با کمینه محلی (3x3) جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن حداکثر تغییر برای هر صفحه. محدوده \f(CW\*(C`[0, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW65535\fR است.
اگر \f(CW0\fR باشد، صفحه بدون تغییر باقی خواهد ماند.
.IP \fBcoordinates\fR 4
.IX Item "coordinates"
پرچمی که پیکسل‌های مورد ارجاع را مشخص می‌کند.
محدوده \f(CW\*(C`[0, 255]\*(C'\fR و مقدار پیش‌فرض \f(CW255\fR است، یعنی از تمام هشت پیکسل استفاده می‌شود.
.Sp
پرچم‌ها برای ناحیه مختصات محلی 3x3 متمرکز بر \f(CW\*(C`x\*(C'\fR:
.Sp
.Vb 1
\&    1 2 3
\&
\&    4 x 5
\&
\&    6 7 8
.Ve
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال فیلتر فرسایش با threshold0 برابر 30، threshold1 برابر 40، threshold2 برابر 50 و coordinates برابر 231، که هر پیکسل خروجی را بر روی کمینه محلی بین پیکسل‌های 1، 2، 3، 6، 7، 8 از ناحیه 3x3 متمرکز بر آن در ورودی تنظیم می‌کند. اگر تفاوت بین پیکسل ورودی و کمینه محلی بیشتر از آستانه صفحه مربوطه باشد، پیکسل خروجی بر روی مقدار (پیکسل ورودی منهای آستانه صفحه مربوطه) تنظیم خواهد شد.
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, erosion_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
.Ve
.SS deshake_opencl
.IX Subsection "deshake_opencl"
فیلتر تثبیت‌کننده ویدیو (لرزش‌گیر) بر پایه نقاط مشخصه.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtripod\fR 4
.IX Item "tripod"
با جلوگیری از هرگونه حرکت دوربین نسبت به فریم اصلی، یک سه‌پایه را شبیه‌سازی می‌کند. مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBdebug\fR 4
.IX Item "debug"
نمایش یا عدم نمایش اطلاعات اشکال‌زدایی اضافی، چه در خروجی پردازش‌شده و چه در کنسول.
.Sp
توجه داشته باشید که برای مشاهده خروجی اشکال‌زدایی در کنسول، باید شناسه \f(CW\*(C`\-v verbose\*(C'\fR را نیز به ffmpeg ارسال کنید.
.Sp
مشاهده تطابق نقاط در ویدیوی خروجی فقط برای ورودی RGB پشتیبانی می‌شود.
.Sp
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBadaptive_crop\fR 4
.IX Item "adaptive_crop"
انجام یا عدم انجام برش اندک در لبه‌ها جهت کاهش مقدار پیکسل‌های آینه‌ای‌شده.
.Sp
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBrefine_features\fR 4
.IX Item "refine_features"
اصلاح یا عدم اصلاح نقاط مشخصه در سطح زیرپیکسل (sub-pixel).
.Sp
این گزینه را می‌توان برای بهبود جزئی عملکرد به قیمت کاهش دقت خاموش کرد.
.Sp
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBsmooth_strength\fR 4
.IX Item "smooth_strength"
قدرت هموارسازی اعمال‌شده به مسیر دوربین از \f(CW0.0\fR تا \f(CW1.0\fR.
.Sp
مقدار \f(CW1.0\fR حداکثر قدرت هموارسازی است در حالی که مقادیر کمتر از آن منجر به هموارسازی کمتری می‌شوند.
.Sp
مقدار \f(CW0.0\fR باعث می‌شود که فیلتر به صورت تطبیقی قدرت هموارسازی را بر مبنای هر فریم انتخاب کند.
.Sp
مقدار پیش‌فرض \f(CW0.0\fR است.
.IP \fBsmooth_window_multiplier\fR 4
.IX Item "smooth_window_multiplier"
کنترل اندازه پنجره هموارسازی (تعداد فریم‌های بافرشده برای تعیین اطلاعات حرکت).
.Sp
اندازه پنجره هموارسازی با ضرب کردن نرخ فریم ویدیو در این عدد تعیین می‌شود.
.Sp
مقادیر قابل قبول در محدوده \f(CW0.1\fR تا \f(CW10.0\fR قرار دارند.
.Sp
مقادیر بزرگ‌تر مقدار داده‌های حرکتی در دسترس را برای تعیین نحوه هموارسازی مسیر دوربین افزایش می‌دهند و به‌طور بالقوه نرمی حرکت را بهبود می‌بخشند، اما تأخیر و مصرف حافظه را نیز افزایش می‌دهند.
.Sp
مقدار پیش‌فرض \f(CW2.0\fR است.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
تثبیت یک ویدیو با قدرت هموارسازی ثابت و متوسط:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, deshake_opencl=smooth_strength=0.5, hwdownload" OUTPUT
.Ve
.IP \(bu 4
تثبیت ویدیو همراه با اشکال‌زدایی (هم در کنسول و هم در ویدیوی رندرشده):
.Sp
.Vb 1
\&        \-i INPUT \-filter_complex "[0:v]format=rgba, hwupload, deshake_opencl=debug=1, hwdownload, format=rgba, format=yuv420p" \-v verbose OUTPUT
.Ve
.SS dilation_opencl
.IX Subsection "dilation_opencl"
اعمال جلوه اتساع (dilation) روی ویدیو.
.PP
این فیلتر هر پیکسل را با بیشینه محلی (3x3) جایگزین می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBthreshold0\fR 4
.IX Item "threshold0"
.PD 0
.IP \fBthreshold1\fR 4
.IX Item "threshold1"
.IP \fBthreshold2\fR 4
.IX Item "threshold2"
.IP \fBthreshold3\fR 4
.IX Item "threshold3"
.PD
محدود کردن حداکثر تغییر برای هر صفحه. محدوده \f(CW\*(C`[0, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW65535\fR است.
اگر \f(CW0\fR باشد، صفحه بدون تغییر باقی خواهد ماند.
.IP \fBcoordinates\fR 4
.IX Item "coordinates"
پرچمی که پیکسل‌های مورد ارجاع را مشخص می‌کند.
محدوده \f(CW\*(C`[0, 255]\*(C'\fR و مقدار پیش‌فرض \f(CW255\fR است، یعنی از تمام هشت پیکسل استفاده می‌شود.
.Sp
پرچم‌ها برای ناحیه مختصات محلی 3x3 متمرکز بر \f(CW\*(C`x\*(C'\fR:
.Sp
.Vb 1
\&    1 2 3
\&
\&    4 x 5
\&
\&    6 7 8
.Ve
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال فیلتر اتساع با threshold0 برابر 30، threshold1 برابر 40، threshold2 برابر 50 و coordinates برابر 231، که هر پیکسل خروجی را بر روی بیشینه محلی بین پیکسل‌های 1، 2، 3، 6، 7، 8 از ناحیه 3x3 متمرکز بر آن در ورودی تنظیم می‌کند. اگر تفاوت بین پیکسل ورودی و بیشینه محلی بیشتر از آستانه صفحه مربوطه باشد، پیکسل خروجی بر روی مقدار (پیکسل ورودی به علاوه آستانه صفحه مربوطه) تنظیم خواهد شد.
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, dilation_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
.Ve
.SS nlmeans_opencl
.IX Subsection "nlmeans_opencl"
فیلتر کاهش نویز میانگین غیرمحلی (Non-local Means) از طریق OpenCL؛ این فیلتر همان گزینه‌های فیلتر \fBnlmeans\fR را می‌پذیرد.
.SS overlay_opencl
.IX Subsection "overlay_opencl"
هم‌پوشانی یک ویدیو بر روی ویدیوی دیگر.
.PP
این فیلتر دو ورودی می‌گیرد و یک خروجی دارد. ورودی اول ویدیوی «اصلی» است که ورودی دوم بر روی آن هم‌پوشانی می‌شود.
این فیلتر نیازمند چیدمان حافظه یکسان برای تمام ورودی‌ها است. بنابراین ممکن است تبدیل قالب (فرمت) لازم باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
تنظیم مختصات x ویدیوی روکش‌شده بر روی ویدیوی اصلی.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBy\fR 4
.IX Item "y"
تنظیم مختصات y ویدیوی روکش‌شده بر روی ویدیوی اصلی.
مقدار پیش‌فرض \f(CW0\fR است.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
هم‌پوشانی یک تصویر LOGO در گوشه بالا-چپ ویدیوی INPUT. هر دو ورودی دارای قالب yuv420p هستند.
.Sp
.Vb 1
\&        \-i INPUT \-i LOGO \-filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
.Ve
.IP \(bu 4
ورودی‌ها چیدمان حافظه یکسانی برای کانال‌های رنگی دارند، لایه روکش دارای صفحه آلفای اضافه است، مانند اینکه INPUT دارای قالب yuv420p باشد و LOGO دارای قالب yuva420p.
.Sp
.Vb 1
\&        \-i INPUT \-i LOGO \-filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
.Ve
.SS pad_opencl
.IX Subsection "pad_opencl"
افزودن حاشیه (padding) به تصویر ورودی و قرار دادن ورودی اصلی در مختصات ارائه‌شده \fIx\fR، \fIy\fR.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تعیین یک عبارت برای اندازه تصویر خروجی با احتساب حاشیه‌های اضافه‌شده. اگر مقدار \fIwidth\fR یا \fIheight\fR برابر 0 باشد، اندازه ورودی متناظر برای خروجی استفاده می‌شود.
.Sp
عبارت \fIwidth\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIheight\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIwidth\fR و \fIheight\fR برابر 0 است.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تعیین آفست‌ها برای قرار دادن تصویر ورودی در ناحیه حاشیه‌بندی‌شده نسبت به مرز بالا/چپ تصویر خروجی.
.Sp
عبارت \fIx\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIy\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIx\fR و \fIy\fR برابر 0 است.
.Sp
اگر \fIx\fR یا \fIy\fR به یک عدد منفی ارزیابی شوند، تغییر داده خواهند شد تا تصویر ورودی در مرکز ناحیه حاشیه‌بندی‌شده قرار گیرد.
.IP \fBcolor\fR 4
.IX Item "color"
تعیین رنگ ناحیه حاشیه‌بندی‌شده. برای ساختار نحوی این گزینه،
بخش \fB"Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBaspect\fR 4
.IX Item "aspect"
حاشیه‌بندی بر اساس یک نسبت تصویر به جای یک وضوح.
.PP
مقادیر گزینه‌های \fIwidth\fR، \fIheight\fR، \fIx\fR و \fIy\fR عباراتی حاوی ثابت‌های زیر هستند:
.IP \fBin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fBin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ویدیوی ورودی.
.IP \fBiw\fR 4
.IX Item "iw"
.PD 0
.IP \fBih\fR 4
.IX Item "ih"
.PD
این موارد همانند \fIin_w\fR و \fIin_h\fR هستند.
.IP \fBout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fBout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع خروجی (اندازه ناحیه حاشیه‌بندی‌شده)، همان‌طور که توسط عبارات \fIwidth\fR و \fIheight\fR تعیین شده است.
.IP \fBow\fR 4
.IX Item "ow"
.PD 0
.IP \fBoh\fR 4
.IX Item "oh"
.PD
این موارد همانند \fIout_w\fR و \fIout_h\fR هستند.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
آفست‌های x و y همان‌طور که توسط عبارات \fIx\fR و \fIy\fR مشخص شده‌اند، یا در صورت عدم تعیین NAN.
.IP \fBa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت تصویر نمونه (SAR) ورودی
.IP \fBdar\fR 4
.IX Item "dar"
نسبت تصویر نمایش (DAR) ورودی، همانند (\fIiw\fR / \fIih\fR) * \fIsar\fR
.SS prewitt_opencl
.IX Subsection "prewitt_opencl"
عملگر پرویت (<\fBhttps://en.wikipedia.org/wiki/Prewitt_operator\fR>) را روی استریم ویدیوی ورودی اعمال می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW0xf\fR است که به وسیله آن تمام صفحات پردازش می‌شوند.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلتر ضرب خواهد شد.
محدوده \f(CW\*(C`[0.0, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW1.0\fR است.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلتر اضافه خواهد شد.
محدوده \f(CW\*(C`[\-65535, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW0.0\fR است.
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال عملگر پرویت با scale تنظیم‌شده روی 2 و delta روی 10.
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, prewitt_opencl=scale=2:delta=10, hwdownload" OUTPUT
.Ve
.SS program_opencl
.IX Subsection "program_opencl"
فیلتر کردن ویدیو با استفاده از یک برنامه OpenCL.
.IP \fBsource\fR 4
.IX Item "source"
پرونده سورس برنامه OpenCL.
.IP \fBkernel\fR 4
.IX Item "kernel"
نام کرنل در برنامه.
.IP \fBinputs\fR 4
.IX Item "inputs"
تعداد ورودی‌های فیلتر. پیش‌فرض 1 است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
اندازه فریم‌های خروجی. پیش‌فرض همانند ورودی اول است.
.PP
فیلتر \f(CW\*(C`program_opencl\*(C'\fR همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
پرونده سورس برنامه باید شامل یک تابع کرنل با نام مشخص‌شده باشد که برای هر صفحه خروجی یک‌بار اجرا خواهد شد. هر اجرا بر روی یک صفحه به عنوان یک NDRange دو‌بعدی سراسری مجزا با یک work\-item برای هر پیکسلی که باید تولید شود در صف قرار می‌گیرد. بنابراین آفست شناسه سراسری (global ID) برای هر work\-item، مختصات یک پیکسل در تصویر مقصد است.
.PP
تابع کرنل باید آرگومان‌های زیر را دریافت کند:
.IP \(bu 4
تصویر مقصد، \fI_\|_write_only image2d_t\fR.
.Sp
این تصویر خروجی خواهد شد؛ کرنل باید کل آن را بنویسد.
.IP \(bu 4
شاخص فریم، \fIunsigned int\fR.
.Sp
این یک شمارنده است که از صفر شروع می‌شود و برای هر فریم یکی افزایش می‌یابد.
.IP \(bu 4
تصاویر مبدأ، \fI_\|_read_only image2d_t\fR.
.Sp
این‌ها جدیدترین تصاویر در هر ورودی هستند. کرنل می‌تواند برای تولید خروجی از آن‌ها بخواند، اما نمی‌تواند در آن‌ها بنویسد.
.PP
برنامه‌های نمونه:
.IP \(bu 4
کپی کردن ورودی در خروجی (خروجی باید هم‌اندازه ورودی باشد).
.Sp
.Vb 5
\&        _\|_kernel void copy(_\|_write_only image2d_t destination,
\&                           unsigned int index,
\&                           _\|_read_only  image2d_t source)
\&        {
\&            const sampler_t sampler = CLK_NORMALIZED_COORDS_FALSE;
\&        
\&            int2 location = (int2)(get_global_id(0), get_global_id(1));
\&        
\&            float4 value = read_imagef(source, sampler, location);
\&        
\&            write_imagef(destination, location, value);
\&        }
.Ve
.IP \(bu 4
اعمال یک تبدیل ساده، چرخاندن ورودی به میزانی که با شمارنده شاخص افزایش می‌یابد. مقادیر پیکسل‌ها توسط نمونه‌بردار به صورت خطی درون‌یابی می‌شوند، و خروجی نیازی ندارد که ابعادی یکسان با ورودی داشته باشد.
.Sp
.Vb 6
\&        _\|_kernel void rotate_image(_\|_write_only image2d_t dst,
\&                                   unsigned int index,
\&                                   _\|_read_only  image2d_t src)
\&        {
\&            const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
\&                                       CLK_FILTER_LINEAR);
\&        
\&            float angle = (float)index / 100.0f;
\&        
\&            float2 dst_dim = convert_float2(get_image_dim(dst));
\&            float2 src_dim = convert_float2(get_image_dim(src));
\&        
\&            float2 dst_cen = dst_dim / 2.0f;
\&            float2 src_cen = src_dim / 2.0f;
\&        
\&            int2   dst_loc = (int2)(get_global_id(0), get_global_id(1));
\&        
\&            float2 dst_pos = convert_float2(dst_loc) \- dst_cen;
\&            float2 src_pos = {
\&                cos(angle) * dst_pos.x \- sin(angle) * dst_pos.y,
\&                sin(angle) * dst_pos.x + cos(angle) * dst_pos.y
\&            };
\&            src_pos = src_pos * src_dim / dst_dim;
\&        
\&            float2 src_loc = src_pos + src_cen;
\&        
\&            if (src_loc.x < 0.0f      || src_loc.y < 0.0f ||
\&                src_loc.x > src_dim.x || src_loc.y > src_dim.y)
\&                write_imagef(dst, dst_loc, 0.5f);
\&            else
\&                write_imagef(dst, dst_loc, read_imagef(src, sampler, src_loc));
\&        }
.Ve
.IP \(bu 4
ترکیب کردن دو ورودی با یکدیگر، با تغییر میزان استفاده از هر ورودی متناسب با شمارنده شاخص.
.Sp
.Vb 7
\&        _\|_kernel void blend_images(_\|_write_only image2d_t dst,
\&                                   unsigned int index,
\&                                   _\|_read_only  image2d_t src1,
\&                                   _\|_read_only  image2d_t src2)
\&        {
\&            const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
\&                                       CLK_FILTER_LINEAR);
\&        
\&            float blend = (cos((float)index / 50.0f) + 1.0f) / 2.0f;
\&        
\&            int2  dst_loc = (int2)(get_global_id(0), get_global_id(1));
\&            int2 src1_loc = dst_loc * get_image_dim(src1) / get_image_dim(dst);
\&            int2 src2_loc = dst_loc * get_image_dim(src2) / get_image_dim(dst);
\&        
\&            float4 val1 = read_imagef(src1, sampler, src1_loc);
\&            float4 val2 = read_imagef(src2, sampler, src2_loc);
\&        
\&            write_imagef(dst, dst_loc, val1 * blend + val2 * (1.0f \- blend));
\&        }
.Ve
.SS remap_opencl
.IX Subsection "remap_opencl"
نگاشت مجدد پیکسل‌ها با استفاده از استریم ویدیوی ورودی دوم: Xmap و سوم: Ymap.
.PP
پیکسل مقصد در موقعیت (X, Y) از موقعیت سورس (x, y) برداشته می‌شود که در آن x = Xmap(X, Y) و y = Ymap(X, Y) است. اگر مقادیر نگاشت خارج از محدوده باشند، مقدار صفر برای پیکسل در مقصد استفاده خواهد شد.
.PP
استریم‌های ویدیویی ورودی Xmap و Ymap باید ابعاد یکسانی داشته باشند. استریم ویدیوی خروجی ابعاد استریم‌های ویدیویی Xmap/Ymap را خواهد داشت.
استریم‌های ویدیویی ورودی Xmap و Ymap قالب پیکسلی اعشاری ۳۲ بیتی و تک‌کاناله دارند.
.IP \fBinterp\fR 4
.IX Item "interp"
تعیین درون‌یابی مورد استفاده برای نگاشت مجدد پیکسل‌ها.
مقادیر مجاز عبارتند از \f(CW\*(C`near\*(C'\fR و \f(CW\*(C`linear\*(C'\fR.
مقدار پیش‌فرض \f(CW\*(C`linear\*(C'\fR است.
.IP \fBfill\fR 4
.IX Item "fill"
تعیین رنگ پیکسل‌های نگاشت‌نشده. برای ساختار نحوی این گزینه،
بخش \fB"Color" در راهنمای ffmpeg\-utils\fR را
بررسی کنید. رنگ پیش‌فرض \f(CW\*(C`black\*(C'\fR است.
.SS roberts_opencl
.IX Subsection "roberts_opencl"
اعمال عملگر متقاطع رابرتز (<\fBhttps://en.wikipedia.org/wiki/Roberts_cross\fR>) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW0xf\fR است که با آن تمام صفحات پردازش می‌شوند.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلتر ضرب خواهد شد.
محدوده \f(CW\*(C`[0.0, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW1.0\fR است.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلتر اضافه خواهد شد.
محدوده \f(CW\*(C`[\-65535, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW0.0\fR است.
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال عملگر متقاطع رابرتز با scale تنظیم‌شده روی 2 و delta روی 10
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, roberts_opencl=scale=2:delta=10, hwdownload" OUTPUT
.Ve
.SS sobel_opencl
.IX Subsection "sobel_opencl"
اعمال عملگر سوبل (<\fBhttps://en.wikipedia.org/wiki/Sobel_operator\fR>) بر روی استریم ویدیوی ورودی.
.PP
این فیلتر گزینه زیر را می‌پذیرد:
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW0xf\fR است که با آن تمام صفحات پردازش می‌شوند.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقداری که در نتیجه فیلتر ضرب خواهد شد.
محدوده \f(CW\*(C`[0.0, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW1.0\fR است.
.IP \fBdelta\fR 4
.IX Item "delta"
تنظیم مقداری که به نتیجه فیلتر اضافه خواهد شد.
محدوده \f(CW\*(C`[\-65535, 65535]\*(C'\fR و مقدار پیش‌فرض \f(CW0.0\fR است.
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
اعمال عملگر سوبل با scale تنظیم‌شده روی 2 و delta روی 10
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, sobel_opencl=scale=2:delta=10, hwdownload" OUTPUT
.Ve
.SS tonemap_opencl
.IX Subsection "tonemap_opencl"
انجام تبدیل HDR(PQ/HLG) به SDR همراه با نگاشت تن (tone\-mapping).
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBtonemap\fR 4
.IX Item "tonemap"
تعیین عملگر نگاشت تن مورد استفاده. همانند گزینه tonemap در فیلتر \fBtonemap\fR است.
.IP \fBparam\fR 4
.IX Item "param"
تنظیم دقیق الگوریتم نگاشت تن. همانند گزینه param در فیلتر \fBtonemap\fR است.
.IP \fBdesat\fR 4
.IX Item "desat"
اعمال اشباع‌زدایی (desaturation) برای های‌لایت‌هایی که از این سطح روشنایی فراتر می‌روند. هرچه این پارامتر بالاتر باشد، اطلاعات رنگی بیشتری حفظ خواهد شد. این تنظیم با تبدیل (نرم و یکنواخت) به رنگ سفید، از رنگ‌های به شکل غیرطبیعی سوخته در های‌لایت‌های بسیار شدید جلوگیری می‌کند. این کار باعث می‌شود تصاویر طبیعی‌تر به نظر برسند، به قیمت کاهش اطلاعات مربوط به رنگ‌های خارج از محدوده.
.Sp
مقدار پیش‌فرض 0.5 است، و الگوریتم در اینجا در حال حاضر کمی با نسخه CPU فیلتر tonemap متفاوت است. مقدار 0.0 این گزینه را غیرفعال می‌کند.
.IP \fBthreshold\fR 4
.IX Item "threshold"
پارامترهای الگوریتم نگاشت تن برای هر صحنه به طور دقیق تنظیم می‌شوند. و از یک آستانه برای تشخیص تغییر صحنه استفاده می‌شود. اگر فاصله میانگین روشنایی فریم فعلی و میانگین متحرک فعلی از مقدار آستانه فراتر رود، میانگین و اوج روشنایی صحنه مجدداً محاسبه خواهد شد.
مقدار پیش‌فرض 0.2 است.
.IP \fBformat\fR 4
.IX Item "format"
تعیین قالب پیکسلی خروجی.
.Sp
قالب‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.RS 4
.IP \fIp010\fR 4
.IX Item "p010"
.PD 0
.IP \fInv12\fR 4
.IX Item "nv12"
.PD
.RE
.RS 4
.RE
.IP "\fBrange, r\fR" 4
.IX Item "range, r"
تنظیم محدوده رنگ خروجی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fItv/mpeg\fR 4
.IX Item "tv/mpeg"
.PD 0
.IP \fIpc/jpeg\fR 4
.IX Item "pc/jpeg"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBprimaries, p\fR" 4
.IX Item "primaries, p"
تنظیم مشخصه‌های رنگ‌های اولیه (primaries) خروجی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fIbt2020\fR 4
.IX Item "bt2020"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.IP "\fBtransfer, t\fR" 4
.IX Item "transfer, t"
تنظیم مشخصه‌های تابع انتقال خروجی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fIbt2020\fR 4
.IX Item "bt2020"
.PD
.RE
.RS 4
.Sp
پیش‌فرض bt709 است.
.RE
.IP "\fBmatrix, m\fR" 4
.IX Item "matrix, m"
تنظیم ماتریس فضای رنگی خروجی.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fIbt709\fR 4
.IX Item "bt709"
.PD 0
.IP \fIbt2020\fR 4
.IX Item "bt2020"
.PD
.RE
.RS 4
.Sp
پیش‌فرض همانند ورودی است.
.RE
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
تبدیل ویدیوی HDR(PQ/HLG) به قالب p010 با ویژگی تابع انتقال bt2020 با استفاده از عملگر خطی (linear).
.Sp
.Vb 1
\&        \-i INPUT \-vf "format=p010,hwupload,tonemap_opencl=t=bt2020:tonemap=linear:format=p010,hwdownload,format=p010" OUTPUT
.Ve
.SS unsharp_opencl
.IX Subsection "unsharp_opencl"
تیز کردن (شارپ) یا محو کردن (بلور) ویدیوی ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBluma_msize_x, lx\fR" 4
.IX Item "luma_msize_x, lx"
تنظیم اندازه افقی ماتریس روشنایی (luma).
محدوده \f(CW\*(C`[1, 23]\*(C'\fR و مقدار پیش‌فرض \f(CW5\fR است.
.IP "\fBluma_msize_y, ly\fR" 4
.IX Item "luma_msize_y, ly"
تنظیم اندازه عمودی ماتریس روشنایی (luma).
محدوده \f(CW\*(C`[1, 23]\*(C'\fR و مقدار پیش‌فرض \f(CW5\fR است.
.IP "\fBluma_amount, la\fR" 4
.IX Item "luma_amount, la"
تنظیم قدرت جلوه روشنایی (luma).
محدوده \f(CW\*(C`[\-10, 10]\*(C'\fR و مقدار پیش‌فرض \f(CW1.0\fR است.
.Sp
مقادیر منفی ویدیوی ورودی را محو می‌کنند، در حالی که مقادیر مثبت آن را تیز می‌کنند؛ مقدار صفر این جلوه را غیرفعال می‌کند.
.IP "\fBchroma_msize_x, cx\fR" 4
.IX Item "chroma_msize_x, cx"
تنظیم اندازه افقی ماتریس کروما (chroma).
محدوده \f(CW\*(C`[1, 23]\*(C'\fR و مقدار پیش‌فرض \f(CW5\fR است.
.IP "\fBchroma_msize_y, cy\fR" 4
.IX Item "chroma_msize_y, cy"
تنظیم اندازه عمودی ماتریس کروما (chroma).
محدوده \f(CW\*(C`[1, 23]\*(C'\fR و مقدار پیش‌فرض \f(CW5\fR است.
.IP "\fBchroma_amount, ca\fR" 4
.IX Item "chroma_amount, ca"
تنظیم قدرت جلوه کروما (chroma).
محدوده \f(CW\*(C`[\-10, 10]\*(C'\fR و مقدار پیش‌فرض \f(CW0.0\fR است.
.Sp
مقادیر منفی ویدیوی ورودی را محو می‌کنند، در حالی که مقادیر مثبت آن را تیز می‌کنند؛ مقدار صفر این جلوه را غیرفعال می‌کند.
.PP
تمام پارامترها اختیاری هستند و به صورت پیش‌فرض معادل رشته \*(Aq5:5:1.0:5:5:0.0\*(Aq می‌باشند.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
اعمال جلوه تیز کردن قوی روشنایی:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, unsharp_opencl=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5, hwdownload" OUTPUT
.Ve
.IP \(bu 4
اعمال تاری قوی برای هر دو پارامتر روشنایی و کروما:
.Sp
.Vb 1
\&        \-i INPUT \-vf "hwupload, unsharp_opencl=7:7:\-2:7:7:\-2, hwdownload" OUTPUT
.Ve
.SS xfade_opencl
.IX Subsection "xfade_opencl"
ایجاد انتقال تدریجی متقاطع (cross fade) میان دو ویدیو با جلوه گذار سفارشی با استفاده از OpenCL.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtransition\fR 4
.IX Item "transition"
تنظیم یکی از جلوه‌های گذار ممکن.
.RS 4
.IP \fBcustom\fR 4
.IX Item "custom"
انتخاب جلوه گذار سفارشی؛ شرح گذار واقعی از گزینه‌های source و kernel برداشته خواهد شد.
.IP \fBfade\fR 4
.IX Item "fade"
.PD 0
.IP \fBwipeleft\fR 4
.IX Item "wipeleft"
.IP \fBwiperight\fR 4
.IX Item "wiperight"
.IP \fBwipeup\fR 4
.IX Item "wipeup"
.IP \fBwipedown\fR 4
.IX Item "wipedown"
.IP \fBslideleft\fR 4
.IX Item "slideleft"
.IP \fBslideright\fR 4
.IX Item "slideright"
.IP \fBslideup\fR 4
.IX Item "slideup"
.IP \fBslidedown\fR 4
.IX Item "slidedown"
.PD
گذار پیش‌فرض fade است.
.RE
.RS 4
.RE
.IP \fBsource\fR 4
.IX Item "source"
پرونده سورس برنامه OpenCL برای گذار سفارشی.
.IP \fBkernel\fR 4
.IX Item "kernel"
تنظیم نام کرنل مورد استفاده برای گذار سفارشی از پرونده سورس برنامه.
.IP \fBduration\fR 4
.IX Item "duration"
تنظیم مدت‌زمان گذار ویدیویی.
.IP \fBoffset\fR 4
.IX Item "offset"
تنظیم زمان شروع گذار نسبت به ویدیوی اول.
.PP
پرونده سورس برنامه باید شامل یک تابع کرنل با نام مشخص‌شده باشد که برای هر صفحه از خروجی یک‌بار اجرا خواهد شد. هر اجرا بر روی یک صفحه به عنوان یک NDRange دو‌بعدی سراسری مجزا با یک work\-item برای هر پیکسلی که باید تولید شود در صف قرار می‌گیرد. بنابراین آفست شناسه سراسری برای هر work\-item، مختصات یک پیکسل در تصویر مقصد است.
.PP
تابع کرنل باید آرگومان‌های زیر را دریافت کند:
.IP \(bu 4
تصویر مقصد، \fI_\|_write_only image2d_t\fR.
.Sp
این تصویر خروجی خواهد شد؛ کرنل باید کل آن را بنویسد.
.IP \(bu 4
تصویر سورس اول، \fI_\|_read_only image2d_t\fR.
تصویر سورس دوم، \fI_\|_read_only image2d_t\fR.
.Sp
این‌ها جدیدترین تصاویر در هر ورودی هستند. کرنل می‌تواند برای تولید خروجی از آن‌ها بخواند، اما نمی‌تواند در آن‌ها بنویسد.
.IP \(bu 4
میزان پیشرفت گذار، \fIfloat\fR. این مقدار همیشه بین 0 و 1 (شامل خود آن‌ها) است.
.PP
برنامه‌های نمونه:
.IP \(bu 4
اعمال جلوه گذار پرده نقطه‌ای (dots curtain):
.Sp
.Vb 11
\&        _\|_kernel void blend_images(_\|_write_only image2d_t dst,
\&                                   _\|_read_only  image2d_t src1,
\&                                   _\|_read_only  image2d_t src2,
\&                                   float progress)
\&        {
\&            const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
\&                                       CLK_FILTER_LINEAR);
\&            int2  p = (int2)(get_global_id(0), get_global_id(1));
\&            float2 rp = (float2)(get_global_id(0), get_global_id(1));
\&            float2 dim = (float2)(get_image_dim(src1).x, get_image_dim(src1).y);
\&            rp = rp / dim;
\&        
\&            float2 dots = (float2)(20.0, 20.0);
\&            float2 center = (float2)(0,0);
\&            float2 unused;
\&        
\&            float4 val1 = read_imagef(src1, sampler, p);
\&            float4 val2 = read_imagef(src2, sampler, p);
\&            bool next = distance(fract(rp * dots, &unused), (float2)(0.5, 0.5)) < (progress / distance(rp, center));
\&        
\&            write_imagef(dst, p, next ? val1 : val2);
\&        }
.Ve
.SH "فیلترهای ویدیویی VAAPI (VAAPI VIDEO FILTERS)"
.IX Header "VAAPI VIDEO FILTERS"
فیلترهای ویدیویی VAAPI معمولاً همراه با دیکودر VAAPI و اینکودر VAAPI استفاده می‌شوند. در ادامه شرح فیلترهای ویدیویی VAAPI آمده است.
.PP
برای فعال‌سازی کامپایل این فیلترها باید FFmpeg را با شناسه
\&\f(CW\*(C`\-\-enable\-vaapi\*(C'\fR پیکربندی کنید.
.PP
برای استفاده از فیلترهای vaapi، باید دستگاه vaapi را به درستی راه‌اندازی کنید. برای اطلاعات بیشتر، لطفاً <\fBhttps://trac.ffmpeg.org/wiki/Hardware/VAAPI\fR> را مطالعه فرمایید.
.SS overlay_vaapi
.IX Subsection "overlay_vaapi"
هم‌پوشانی یک ویدیو بر روی ویدیوی دیگر.
.PP
این فیلتر دو ورودی می‌گیرد و یک خروجی دارد. ورودی اول ویدیوی «اصلی» است که ورودی دوم بر روی آن هم‌پوشانی می‌شود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تنظیم عبارات برای مختصات x و y ویدیوی روکش‌شده
بر روی ویدیوی اصلی.
.Sp
مقدار پیش‌فرض برای هر دو عبارت "0" است.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارات برای عرض و ارتفاع ویدیوی روکش‌شده
بر روی ویدیوی اصلی.
.Sp
مقادیر پیش‌فرض برابر \*(Aqoverlay_iw\*(Aq برای \*(Aqw\*(Aq و \*(Aqoverlay_ih*w/overlay_iw\*(Aq برای \*(Aqh\*(Aq هستند.
.Sp
این عبارات می‌توانند شامل پارامترهای زیر باشند:
.RS 4
.IP "\fBmain_w, W\fR" 4
.IX Item "main_w, W"
.PD 0
.IP "\fBmain_h, H\fR" 4
.IX Item "main_h, H"
.PD
عرض و ارتفاع ورودی اصلی.
.IP \fBoverlay_iw\fR 4
.IX Item "overlay_iw"
.PD 0
.IP \fBoverlay_ih\fR 4
.IX Item "overlay_ih"
.PD
عرض و ارتفاع ورودی لایه روکش (overlay).
.IP "\fBoverlay_w, w\fR" 4
.IX Item "overlay_w, w"
.PD 0
.IP "\fBoverlay_h, h\fR" 4
.IX Item "overlay_h, h"
.PD
عرض و ارتفاع خروجی لایه روکش (overlay).
.IP "\fBoverlay_x, x\fR" 4
.IX Item "overlay_x, x"
.PD 0
.IP "\fBoverlay_y, y\fR" 4
.IX Item "overlay_y, y"
.PD
موقعیت لایه روکش در داخل ورودی اصلی
.RE
.RS 4
.RE
.IP \fBalpha\fR 4
.IX Item "alpha"
تنظیم شفافیت ویدیوی روکش‌شده. محدوده مجاز 0.0 تا 1.0 است.
مقدار بالاتر به معنای شفافیت کمتر است.
مقدار پیش‌فرض \f(CW1.0\fR است.
.IP \fBeof_action\fR 4
.IX Item "eof_action"
به \fBframesync\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBframesync\fR مراجعه کنید.
.IP \fBrepeatlast\fR 4
.IX Item "repeatlast"
به \fBframesync\fR مراجعه کنید.
.PP
این فیلتر همچنین از گزینه‌های \fBframesync\fR پشتیبانی می‌کند.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
هم‌پوشانی یک تصویر LOGO در گوشه بالا-چپ ویدیوی INPUT. هر دو ورودی برای این فیلتر با قالب yuv420p هستند.
.Sp
.Vb 1
\&        \-i INPUT \-i LOGO \-filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_vaapi" OUTPUT
.Ve
.IP \(bu 4
هم‌پوشانی یک تصویر LOGO در آفست (200, 100) از گوشه بالا-چپ ویدیوی INPUT.
ورودی‌ها چیدمان حافظه یکسانی برای کانال‌های رنگی دارند، لایه روکش دارای صفحه آلفای اضافه است، مانند اینکه INPUT دارای قالب yuv420p و LOGO دارای قالب yuva420p باشد.
.Sp
.Vb 1
\&        \-i INPUT \-i LOGO \-filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_vaapi=x=200:y=100:w=400:h=300:alpha=1.0, hwdownload, format=nv12" OUTPUT
.Ve
.SS tonemap_vaapi
.IX Subsection "tonemap_vaapi"
انجام نگاشت تن (tone\-mapping) از نوع HDR به SDR یا HDR به HDR.
این فیلتر در حال حاضر تنها HDR10 را به عنوان ورودی می‌پذیرد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBformat\fR 4
.IX Item "format"
تعیین قالب پیکسلی خروجی.
.Sp
پیش‌فرض nv12 برای نگاشت تن HDR به SDR و p010 برای نگاشت تن HDR به HDR است.
.IP "\fBprimaries, p\fR" 4
.IX Item "primaries, p"
تنظیم مشخصه‌های رنگ‌های اولیه خروجی.
.Sp
پیش‌فرض bt709 برای نگاشت تن HDR به SDR و همانند ورودی برای نگاشت تن HDR به HDR است.
.IP "\fBtransfer, t\fR" 4
.IX Item "transfer, t"
تنظیم مشخصه‌های تابع انتقال خروجی.
.Sp
پیش‌فرض bt709 برای نگاشت تن HDR به SDR و همانند ورودی برای نگاشت تن HDR به HDR است.
.IP "\fBmatrix, m\fR" 4
.IX Item "matrix, m"
تنظیم ماتریس فضای رنگی خروجی.
.Sp
پیش‌فرض bt709 برای نگاشت تن HDR به SDR و همانند ورودی برای نگاشت تن HDR به HDR است.
.IP \fBdisplay\fR 4
.IX Item "display"
تنظیم حجم رنگ نمایشگر مرجع مسترینگ در خروجی. این گزینه به صورت فهرستی جداشده با \*(Aq|\*(Aq از دو مقدار داده می‌شود و دو مقدار با فاصله از یکدیگر تفکیک شده‌اند. این گزینه مشخصه‌های اولیه نمایشگر x و y را به ترتیب G، B، R، سپس نقطه سفید x و y و درخشش اسمی حداقل و حداکثر نمایشگر را تنظیم می‌کند.
.Sp
در صورت تنظیم این گزینه، نگاشت تن HDR به HDR انجام خواهد شد.
.IP \fBlight\fR 4
.IX Item "light"
تنظیم اطلاعات سطح نور محتوا در خروجی. این گزینه ۲ مقدار جداشده با فاصله را می‌پذیرد، ورودی اول حداکثر سطح نور و ورودی دوم حداکثر سطح نور میانگین است.
.Sp
این گزینه برای نگاشت تن HDR به SDR نادیده گرفته می‌شود و برای نگاشت تن HDR به HDR اختیاری است.
.PP
\fIExample\fR
.IX Subsection "Example"
.IP \(bu 4
تبدیل ویدیوی HDR(HDR10) به قالب p010 با ویژگی انتقال bt2020
.Sp
.Vb 1
\&        tonemap_vaapi=format=p010:t=bt2020\-10
.Ve
.IP \(bu 4
تبدیل ویدیوی HDR به ویدیوی HDR
.Sp
.Vb 1
\&        tonemap_vaapi=display=7500\e 3000|34000\e 16000|13250\e 34500|15635\e 16450|500\e 10000000
.Ve
.SS hstack_vaapi
.IX Subsection "hstack_vaapi"
چیدمان افقی ویدیوهای ورودی در کنار یکدیگر.
.PP
این گونهٔ تحت VA\-API از فیلتر \fBhstack\fR است؛ هر استریم ورودی ممکن است ارتفاع متفاوتی داشته باشد، این فیلتر هر استریم ورودی را ضمن حفظ نسبت تصویر اصلی، به سمت بالا/پایین مقیاس‌بندی خواهد کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBhstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBhstack\fR مراجعه کنید.
.IP \fBheight\fR 4
.IX Item "height"
تنظیم ارتفاع خروجی. اگر روی 0 تنظیم شود، این فیلتر ارتفاع خروجی را برابر با ارتفاع نخستین استریم ورودی قرار می‌دهد. مقدار پیش‌فرض 0 است.
.SS vstack_vaapi
.IX Subsection "vstack_vaapi"
چیدمان عمودی ویدیوهای ورودی روی یکدیگر.
.PP
این گونهٔ تحت VA\-API از فیلتر \fBvstack\fR است؛ هر استریم ورودی ممکن است عرض متفاوتی داشته باشد، این فیلتر هر استریم ورودی را ضمن حفظ نسبت تصویر اصلی، به سمت بالا/پایین مقیاس‌بندی خواهد کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBvstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBvstack\fR مراجعه کنید.
.IP \fBwidth\fR 4
.IX Item "width"
تنظیم عرض خروجی. اگر روی 0 تنظیم شود، این فیلتر عرض خروجی را برابر با عرض نخستین استریم ورودی قرار می‌دهد. مقدار پیش‌فرض 0 است.
.SS xstack_vaapi
.IX Subsection "xstack_vaapi"
چیدمان ورودی‌های ویدیویی در یک قالب و ساختار سفارشی.
.PP
این گونهٔ تحت VA\-API از فیلتر \fBxstack\fR است؛ هر استریم ورودی ممکن است اندازه متفاوتی داشته باشد، این فیلتر هر استریم ورودی را به اندازه خروجی داده‌شده یا اندازه اولین استریم ورودی مقیاس‌بندی می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBxstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBxstack\fR مراجعه کنید.
.IP \fBlayout\fR 4
.IX Item "layout"
به \fBxstack\fR مراجعه کنید.
علاوه بر این، به کاربر امکان می‌دهد اندازه خروجی را برای هر استریم ورودی مشخص کند.
.Sp
.Vb 1
\&        xstack_vaapi=inputs=4:layout=0_0_1920x1080|0_h0_1920x1080|w0_0_1920x1080|w0_h0_1920x1080
.Ve
.IP \fBgrid\fR 4
.IX Item "grid"
به \fBxstack\fR مراجعه کنید.
.IP \fBgrid_tile_size\fR 4
.IX Item "grid_tile_size"
تنظیم اندازه خروجی برای هر استریم ورودی در هنگام تنظیم \fBgrid\fR. اگر این گزینه تنظیم نشود، این فیلتر به صورت پیش‌فرض اندازه خروجی را برابر با اندازه نخستین استریم ورودی قرار می‌دهد. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBfill\fR 4
.IX Item "fill"
به \fBxstack\fR مراجعه کنید.
.SS pad_vaapi
.IX Subsection "pad_vaapi"
افزودن حاشیه (padding) به تصویر ورودی و قرار دادن ورودی اصلی در مختصات ارائه‌شده \fIx\fR، \fIy\fR.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
تعیین یک عبارت برای اندازه تصویر خروجی با احتساب حاشیه‌های اضافه‌شده. اگر مقدار \fIwidth\fR یا \fIheight\fR برابر 0 باشد، اندازه ورودی متناظر برای خروجی استفاده می‌شود.
.Sp
عبارت \fIwidth\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIheight\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIwidth\fR و \fIheight\fR برابر 0 است.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
تعیین آفست‌ها برای قرار دادن تصویر ورودی در ناحیه حاشیه‌بندی‌شده نسبت به مرز بالا/چپ تصویر خروجی.
.Sp
عبارت \fIx\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت \fIy\fR ارجاع دهد و برعکس.
.Sp
مقدار پیش‌فرض \fIx\fR و \fIy\fR برابر 0 است.
.Sp
اگر \fIx\fR یا \fIy\fR به یک عدد منفی ارزیابی شوند، تغییر داده خواهند شد تا تصویر ورودی در مرکز ناحیه حاشیه‌بندی‌شده قرار گیرد.
.IP \fBcolor\fR 4
.IX Item "color"
تعیین رنگ ناحیه حاشیه‌بندی‌شده. برای ساختار نحوی این گزینه،
بخش \fB"Color" در راهنمای ffmpeg\-utils\fR را
بررسی کنید.
.IP \fBaspect\fR 4
.IX Item "aspect"
حاشیه‌بندی بر اساس یک نسبت تصویر به جای یک وضوح.
.PP
مقادیر گزینه‌های \fIwidth\fR، \fIheight\fR، \fIx\fR و \fIy\fR عباراتی حاوی ثابت‌های زیر هستند:
.IP \fBin_w\fR 4
.IX Item "in_w"
.PD 0
.IP \fBin_h\fR 4
.IX Item "in_h"
.PD
عرض و ارتفاع ویدیوی ورودی.
.IP \fBiw\fR 4
.IX Item "iw"
.PD 0
.IP \fBih\fR 4
.IX Item "ih"
.PD
این موارد همانند \fIin_w\fR و \fIin_h\fR هستند.
.IP \fBout_w\fR 4
.IX Item "out_w"
.PD 0
.IP \fBout_h\fR 4
.IX Item "out_h"
.PD
عرض و ارتفاع خروجی (اندازه ناحیه حاشیه‌بندی‌شده)، همان‌طور که توسط عبارات \fIwidth\fR و \fIheight\fR تعیین شده است.
.IP \fBow\fR 4
.IX Item "ow"
.PD 0
.IP \fBoh\fR 4
.IX Item "oh"
.PD
این موارد همانند \fIout_w\fR و \fIout_h\fR هستند.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
آفست‌های x و y همان‌طور که توسط عبارات \fIx\fR و \fIy\fR مشخص شده‌اند، یا در صورت عدم تعیین NAN.
.IP \fBa\fR 4
.IX Item "a"
همانند \fIiw\fR / \fIih\fR
.IP \fBsar\fR 4
.IX Item "sar"
نسبت تصویر نمونه (SAR) ورودی
.IP \fBdar\fR 4
.IX Item "dar"
نسبت تصویر نمایش (DAR) ورودی، همانند (\fIiw\fR / \fIih\fR) * \fIsar\fR
.SS drawbox_vaapi
.IX Subsection "drawbox_vaapi"
رسم یک جعبه رنگی روی تصویر ورودی.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
عباراتی که مختصات گوشه بالا-چپ جعبه را مشخص می‌کنند. مقدار پیش‌فرض آن 0 است.
.IP "\fBwidth, w\fR" 4
.IX Item "width, w"
.PD 0
.IP "\fBheight, h\fR" 4
.IX Item "height, h"
.PD
عباراتی که عرض و ارتفاع جعبه را مشخص می‌کنند؛ اگر 0 باشند به عنوان عرض و ارتفاع ورودی تفسیر می‌شوند. پیش‌فرض 0 است.
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
تعیین رنگ جعبه‌ای که رسم می‌شود. برای ساختار نحوی عمومی این گزینه،
بخش \fB"Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP "\fBthickness, t\fR" 4
.IX Item "thickness, t"
عبارتی که ضخامت لبه جعبه را تعیین می‌کند.
مقدار \f(CW\*(C`fill\*(C'\fR یک جعبه توپُر ایجاد خواهد کرد. مقدار پیش‌فرض \f(CW3\fR است.
.Sp
فهرست ثابت‌های پذیرفته‌شده را در زیر مشاهده کنید.
.IP \fBreplace\fR 4
.IX Item "replace"
با مقدار \f(CW1\fR، پیکسل‌های جعبه رسم‌شده جایگزین پیکسل‌های رنگ و آلفای ویدیو خواهند شد.
پیش‌فرض \f(CW0\fR است که جعبه را روی ویدیوی ورودی ترکیب می‌کند.
.PP
پارامترهای \fIx\fR، \fIy\fR، \fIw\fR، \fIh\fR و \fIt\fR عباراتی حاوی ثابت‌های زیر هستند:
.IP "\fBin_h, ih\fR" 4
.IX Item "in_h, ih"
.PD 0
.IP "\fBin_w, iw\fR" 4
.IX Item "in_w, iw"
.PD
عرض و ارتفاع ورودی.
.IP \fBx\fR 4
.IX Item "x"
.PD 0
.IP \fBy\fR 4
.IX Item "y"
.PD
مختصات آفست x و y که جعبه در آن رسم می‌شود.
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
عرض و ارتفاع جعبه رسم‌شده.
.IP \fBt\fR 4
.IX Item "t"
ضخامت جعبه رسم‌شده.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
رسم یک جعبه سیاه در اطراف لبه تصویر ورودی:
.Sp
.Vb 1
\&        drawbox
.Ve
.IP \(bu 4
رسم یک جعبه با رنگ قرمز و کدر بودن (opacity) ۵۰٪:
.Sp
.Vb 1
\&        drawbox=10:20:200:60:red@0.5
.Ve
.Sp
مثال قبلی را می‌توان به این صورت نیز مشخص کرد:
.Sp
.Vb 1
\&        drawbox=x=10:y=20:w=200:h=60:color=red@0.5
.Ve
.IP \(bu 4
پر کردن جعبه با رنگ صورتی:
.Sp
.Vb 1
\&        drawbox=x=10:y=10:w=100:h=100:color=pink@0.5:t=fill
.Ve
.IP \(bu 4
رسم یک ماسک ۲ پیکسلی قرمز با نسبت تصویر ۲.۴۰:۱:
.Sp
.Vb 1
\&        drawbox=x=\-t:y=0.5*(ih\-iw/2.4)\-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red
.Ve
.SH "فیلترهای ویدیویی VIDEOTOOLBOX (VIDEOTOOLBOX VIDEO FILTERS)"
.IX Header "VIDEOTOOLBOX VIDEO FILTERS"
در ادامه شرح فیلترهای ویدیویی VideoToolbox که در حال حاضر در دسترس هستند آمده است.
.PP
فیلتر VideoToolbox به چارچوب VideoToolbox وابسته است و هنگام ساخت FFmpeg برای یک پلتفرم شرکت اپل مانند macOS به طور خودکار شناسایی می‌شود. در صورت غیرفعال بودن شناسایی خودکار، گزینه
\&\f(CW\*(C`\-\-enable\-videotoolbox\*(C'\fR را به configure اضافه کنید.
.SS scale_vt
.IX Subsection "scale_vt"
مقیاس‌بندی و تبدیل پارامترهای رنگ با استفاده از VTPixelTransferSession.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBw\fR 4
.IX Item "w"
.PD 0
.IP \fBh\fR 4
.IX Item "h"
.PD
تنظیم عبارت ابعاد ویدیوی خروجی. مقدار پیش‌فرض ابعاد ورودی است.
.IP \fBcolor_matrix\fR 4
.IX Item "color_matrix"
تنظیم ماتریس فضای رنگی خروجی.
.IP \fBcolor_primaries\fR 4
.IX Item "color_primaries"
تنظیم مشخصه‌های رنگ‌های اولیه خروجی.
.IP \fBcolor_transfer\fR 4
.IX Item "color_transfer"
تنظیم مشخصه‌های تابع انتقال خروجی.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
انجام تبدیل HDR به SDR، و مقیاس‌بندی به نصف اندازه ورودی
.Sp
.Vb 10
\&        ffmpeg \-hwaccel videotoolbox \e
\&                \-hwaccel_output_format videotoolbox_vld \e
\&                \-i hdr.mov \e
\&                \-c:v hevc_videotoolbox \e
\&                \-profile:v main \e
\&                \-b:v 3M \e
\&                \-vf scale_vt=w=iw/2:h=ih/2:color_matrix=bt709:color_primaries=bt709:color_transfer=bt709 \e
\&                \-c:a copy \e
\&                \-tag:v hvc1 \e
\&                sdr.mp4
.Ve
.SS transpose_vt
.IX Subsection "transpose_vt"
ترانهادن سطرها و ستون‌ها در ویدیوی ورودی و برگرداندن اختیاری آن (flip).
برای مثال‌های عمیق‌تر، فیلتر ویدیویی \fBtranspose\fR را مشاهده کنید که عمدتاً گزینه‌های یکسانی دارد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBdir\fR 4
.IX Item "dir"
تعیین جهت ترانهش (transposition).
.Sp
می‌تواند مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBcclock_flip\fR 4
.IX Item "cclock_flip"
چرخش ۹۰ درجه در خلاف جهت عقربه‌های ساعت و برگرداندن عمودی (پیش‌فرض).
.IP \fBclock\fR 4
.IX Item "clock"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت.
.IP \fBcclock\fR 4
.IX Item "cclock"
چرخش ۹۰ درجه در خلاف جهت عقربه‌های ساعت.
.IP \fBclock_flip\fR 4
.IX Item "clock_flip"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت و برگرداندن عمودی.
.IP \fBhflip\fR 4
.IX Item "hflip"
برگرداندن افقی ویدیوی ورودی.
.IP \fBvflip\fR 4
.IX Item "vflip"
برگرداندن عمودی ویدیوی ورودی.
.RE
.RS 4
.RE
.IP \fBpassthrough\fR 4
.IX Item "passthrough"
عدم اعمال ترانهش در صورتی که هندسه ورودی با مقدار مشخص‌شده مطابقت داشته باشد. این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
همواره ترانهش اعمال شود (پیش‌فرض).
.IP \fBportrait\fR 4
.IX Item "portrait"
حفظ هندسه عمودی (پرتره) (زمانی که \fIheight\fR >= \fIwidth\fR).
.IP \fBlandscape\fR 4
.IX Item "landscape"
حفظ هندسه افقی (لندسکیپ) (زمانی که \fIwidth\fR >= \fIheight\fR).
.RE
.RS 4
.RE
.SH "فیلترهای ویدیویی VULKAN (VULKAN VIDEO FILTERS)"
.IX Header "VULKAN VIDEO FILTERS"
در ادامه شرح فیلترهای ویدیویی Vulkan که در حال حاضر در دسترس هستند آمده است.
.PP
برای فعال‌سازی کامپایل این فیلترها باید FFmpeg را با شناسه
\&\f(CW\*(C`\-\-enable\-vulkan\*(C'\fR پیکربندی کنید، و یک کامپایلر SPIR\-V (\f(CW\*(C`glslc\*(C'\fR یا
\&\f(CW\*(C`glslangValidator\*(C'\fR) را در زمان ساخت در دسترس داشته باشید.
.PP
اجرای فیلترهای Vulkan نیازمند راه‌اندازی اولیه یک دستگاه سخت‌افزاری و ارسال آن دستگاه به تمامی فیلترها در هر گراف فیلتر است.
.IP "\fB\-init_hw_device vulkan[=\fR\fIname\fR\fB][:\fR\fIdevice\fR\fB[,\fR\fIkey=value\fR\fB...]]\fR" 4
.IX Item "-init_hw_device vulkan[=name][:device[,key=value...]]"
راه‌اندازی اولیه یک دستگاه سخت‌افزاری جدید از نوع \fIvulkan\fR با نام \fIname\fR، با استفاده از پارامترهای دستگاه و گزینه‌های داده‌شده در \fIkey=value\fR. گزینه‌های زیر پشتیبانی می‌شوند:
.RS 4
.IP \fBdebug\fR 4
.IX Item "debug"
در صورت تنظیم روی 1، لایه‌های اعتبارسنجی را فعال می‌کند.
.IP \fBlinear_images\fR 4
.IX Item "linear_images"
تخصیص تصاویر خطی. برای دیکودینگ کاربرد ندارد.
.IP \fBdisable_multiplane\fR 4
.IX Item "disable_multiplane"
غیرفعال کردن تصاویر چندصفحه‌ای. برای دیکودینگ کاربرد ندارد.
.IP \fBavoid_host_import\fR 4
.IX Item "avoid_host_import"
اجتناب از واردسازی‌های حافظه میزبان پویا، به نفع استفاده از یک \fBmemcpy()\fR معمولی درون بافری که از قبل نگاشت شده است.
.RE
.RS 4
.RE
.IP "\fB\-filter_hw_device\fR \fIname\fR" 4
.IX Item "-filter_hw_device name"
ارسال دستگاه سخت‌افزاری با نام \fIname\fR به تمامی فیلترها در هر گراف فیلتر.
.PP
برای اطلاعات دقیق‌تر، <\fBhttps://www.ffmpeg.org/ffmpeg.html#Advanced\-Video\-options\fR> را مشاهده کنید.
.IP \(bu 4
نمونه‌ای از انتخاب اولین دستگاه و اجرای فیلتر nlmeans_vulkan با پارامترهای پیش‌فرض روی آن:
.Sp
.Vb 1
\&        \-init_hw_device vulkan=vk:0 \-filter_hw_device vk \-i INPUT \-vf "hwupload,nlmeans_vulkan,hwdownload" OUTPUT
.Ve
.PP
از آنجا که فیلترهای Vulkan قادر به دسترسی به داده‌های فریم در حافظه عادی نیستند، تمامی داده‌های فریم باید پیش از استفاده به سطوح سخت‌افزاری متصل به دستگاه مناسب بارگذاری شوند (\fBhwupload\fR) و سپس مجدداً به حافظه عادی دانلود شوند (\fBhwdownload\fR). توجه داشته باشید که \fBhwupload\fR داده‌ها را در فریمی با همان چیدمان فریم نرم‌افزاری بارگذاری می‌کند، بنابراین ممکن است لازم باشد بلافاصله قبل از آن یک فیلتر \fBformat\fR اضافه کنید تا ورودی به قالب مناسب تبدیل شود؛ و \fBhwdownload\fR نیز از تمامی قالب‌ها در خروجی پشتیبانی نمی‌کند \- معمولاً لازم است بلافاصله پس از آن در گراف یک فیلتر \fBformat\fR اضافی درج شود تا خروجی در یک قالب پشتیبانی‌شده به دست آید.
.SS avgblur_vulkan
.IX Subsection "avgblur_vulkan"
اعمال یک فیلتر محوکننده میانگین (average blur)، پیاده‌سازی‌شده بر روی GPU با استفاده از Vulkan.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsizeX\fR 4
.IX Item "sizeX"
تنظیم اندازه شعاع افقی.
محدوده \f(CW\*(C`[1, 32]\*(C'\fR و مقدار پیش‌فرض \f(CW3\fR است.
.IP \fBsizeY\fR 4
.IX Item "sizeY"
تنظیم اندازه شعاع عمودی. محدوده \f(CW\*(C`[1, 32]\*(C'\fR و مقدار پیش‌فرض \f(CW3\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که باید فیلتر شوند. مقدار پیش‌فرض \f(CW0xf\fR است که با آن تمام صفحات پردازش می‌شوند.
.SS blend_vulkan
.IX Subsection "blend_vulkan"
ترکیب و آمیختن دو فریم Vulkan در یکدیگر.
.PP
فیلتر \f(CW\*(C`blend\*(C'\fR دو استریم ورودی می‌گیرد و یک استریم خروجی می‌دهد؛ ورودی اول لایه «رویی» و ورودی دوم لایه «زیرین» است. به صورت پیش‌فرض، خروجی زمانی پایان می‌یابد که طولانی‌ترین ورودی خاتمه یابد.
.PP
شرح گزینه‌های پذیرفته‌شده در ادامه آمده است.
.IP \fBc0_mode\fR 4
.IX Item "c0_mode"
.PD 0
.IP \fBc1_mode\fR 4
.IX Item "c1_mode"
.IP \fBc2_mode\fR 4
.IX Item "c2_mode"
.IP \fBc3_mode\fR 4
.IX Item "c3_mode"
.IP \fBall_mode\fR 4
.IX Item "all_mode"
.PD
تنظیم حالت آمیختگی برای یک مؤلفه پیکسلی خاص یا تمام مؤلفه‌های پیکسلی در صورت استفاده از \fIall_mode\fR. مقدار پیش‌فرض \f(CW\*(C`normal\*(C'\fR است.
.Sp
مقادیر موجود برای حالت‌های مؤلفه عبارتند از:
.RS 4
.IP \fBnormal\fR 4
.IX Item "normal"
.PD 0
.IP \fBmultiply\fR 4
.IX Item "multiply"
.PD
.RE
.RS 4
.RE
.SS bwdif_vulkan
.IX Subsection "bwdif_vulkan"
فیلتر حذف درهم‌بافتگی (deinterlacer) با استفاده از \fBbwdif\fR، الگوریتم "Bob Weaver Deinterlacing Filter"، پیاده‌سازی‌شده روی GPU با استفاده از Vulkan.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
حالت درهم‌بافتگی اتخاذشده. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, send_frame\fR" 4
.IX Item "0, send_frame"
خروجی دادن یک فریم به ازای هر فریم.
.IP "\fB1, send_field\fR" 4
.IX Item "1, send_field"
خروجی دادن یک فریم به ازای هر فیلد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`send_field\*(C'\fR است.
.RE
.IP \fBparity\fR 4
.IX Item "parity"
برابری فیلد تصویر فرض‌شده برای ویدیوی درهم‌بافته ورودی. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, tff\fR" 4
.IX Item "0, tff"
فرض اینکه فیلد بالایی اول است (top field first).
.IP "\fB1, bff\fR" 4
.IX Item "1, bff"
فرض اینکه فیلد پایینی اول است (bottom field first).
.IP "\fB\-1, auto\fR" 4
.IX Item "-1, auto"
فعال‌سازی تشخیص خودکار تقدم فیلد.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`auto\*(C'\fR است.
اگر درهم‌بافتگی ناشناخته باشد یا دیکودر این اطلاعات را صادر نکند، اولویت با فیلد بالایی فرض خواهد شد.
.RE
.IP \fBdeint\fR 4
.IX Item "deint"
تعیین فریم‌هایی که باید درهم‌بافتگی‌زدایی شوند. یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP "\fB0, all\fR" 4
.IX Item "0, all"
حذف درهم‌بافتگی از تمام فریم‌ها.
.IP "\fB1, interlaced\fR" 4
.IX Item "1, interlaced"
تنها حذف درهم‌بافتگی از فریم‌هایی که به عنوان درهم‌بافته نشانه‌گذاری شده‌اند.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`all\*(C'\fR است.
.RE
.SS chromaber_vulkan
.IX Subsection "chromaber_vulkan"
اعمال جلوه‌ای که ابیراهی رنگی (chromatic aberration) را شبیه‌سازی می‌کند. با ورودی‌های RGB بهترین نتیجه را دارد، اما با ورودی‌های YCbCr نیز جلوه مشابهی فراهم می‌کند.
.IP \fBdist_x\fR 4
.IX Item "dist_x"
ضریب جابجایی افقی. موقعیت هر پیکسل کروما با شروع از مرکز تصویر، در این مقدار ضرب خواهد شد. پیش‌فرض \f(CW0\fR است.
.IP \fBdist_y\fR 4
.IX Item "dist_y"
به طور مشابه، ضریب جابجایی عمودی را تعیین می‌کند. پیش‌فرض \f(CW0\fR است.
.SS color_vulkan
.IX Subsection "color_vulkan"
سورس ویدیویی که یک فریم Vulkan با رنگ یکدست ایجاد می‌کند.
برای بنچمارک یا هم‌پوشانی مفید است.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBcolor\fR 4
.IX Item "color"
رنگ مورد استفاده. نام یا مقدار هگزادسیمال.
مقدار پیش‌فرض \f(CW\*(C`black\*(C'\fR است.
.IP \fBsize\fR 4
.IX Item "size"
اندازه فریم خروجی. مقدار پیش‌فرض \f(CW\*(C`1920x1080\*(C'\fR است.
.IP \fBrate\fR 4
.IX Item "rate"
نرخ فریم خروجی. مقدار پیش‌فرض \f(CW60\fR فریم در ثانیه است.
.IP \fBduration\fR 4
.IX Item "duration"
مدت‌زمان ویدیو. مقدار پیش‌فرض \f(CW\-0.000001\fR است.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت تصویر نمونه سیگنال ویدیویی. مقدار پیش‌فرض \f(CW\*(C`1/1\*(C'\fR است.
.IP \fBformat\fR 4
.IX Item "format"
قالب پیکسلی فریم‌های Vulkan خروجی. مقدار پیش‌فرض \f(CW\*(C`yuv444p\*(C'\fR است.
.IP \fBout_range\fR 4
.IX Item "out_range"
تنظیم محدوده نمونه YCbCr خروجی.
.Sp
این گزینه اجازه می‌دهد مقدار شناسایی‌شده خودکار بازنویسی شود و همچنین امکان تحمیل یک مقدار خاص مورد استفاده برای خروجی و اینکودر را فراهم می‌کند. در صورت عدم تعیین، محدوده به قالب پیکسلی بستگی دارد. مقادیر ممکن:
.RS 4
.IP \fBauto/unknown\fR 4
.IX Item "auto/unknown"
انتخاب خودکار.
.IP \fBjpeg/full/pc\fR 4
.IX Item "jpeg/full/pc"
تنظیم محدوده کامل (0\-255 در صورت روشنایی ۸ بیتی).
.IP \fBmpeg/limited/tv\fR 4
.IX Item "mpeg/limited/tv"
تنظیم محدوده "MPEG" (16\-235 در صورت روشنایی ۸ بیتی).
.RE
.RS 4
.RE
.SS vflip_vulkan
.IX Subsection "vflip_vulkan"
تصویر را به صورت عمودی برمی‌گرداند.
.SS hflip_vulkan
.IX Subsection "hflip_vulkan"
تصویر را به صورت افقی برمی‌گرداند.
.SS flip_vulkan
.IX Subsection "flip_vulkan"
تصویر را در راستای هر دو محور عمودی و افقی برمی‌گرداند.
.SS gblur_vulkan
.IX Subsection "gblur_vulkan"
اعمال فیلتر محوکننده گاوسی (Gaussian blur) بر روی فریم‌های Vulkan.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsigma\fR 4
.IX Item "sigma"
تنظیم سیگما افقی، انحراف معیار تاری گاوسی. پیش‌فرض \f(CW0.5\fR است.
.IP \fBsigmaV\fR 4
.IX Item "sigmaV"
تنظیم سیگما عمودی؛ اگر منفی باشد برابر \f(CW\*(C`sigma\*(C'\fR خواهد بود.
پیش‌فرض \f(CW\-1\fR است.
.IP \fBplanes\fR 4
.IX Item "planes"
تعیین صفحاتی که باید فیلتر شوند. به طور پیش‌فرض تمام صفحات فیلتر می‌شوند.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه کرنل در راستای محور افقی. پیش‌فرض \f(CW19\fR است.
.IP \fBsizeV\fR 4
.IX Item "sizeV"
تنظیم اندازه کرنل در راستای محور عمودی. پیش‌فرض \f(CW0\fR است
که باعث استفاده از مقداری مشابه با \fIsize\fR می‌شود.
.SS nlmeans_vulkan
.IX Subsection "nlmeans_vulkan"
کاهش نویز فریم‌ها با استفاده از الگوریتم میانگین غیرمحلی (Non\-Local Means)، پیاده‌سازی‌شده بر روی GPU با استفاده از Vulkan.
از قالب‌های پیکسلی بیشتری نسبت به \fBnlmeans\fR یا \fBnlmeans_opencl\fR پشتیبانی می‌کند، از جمله پشتیبانی از کانال آلفا.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBs\fR 4
.IX Item "s"
تنظیم قدرت کاهش نویز برای تمامی مؤلفه‌ها. پیش‌فرض 1.0 است. باید در محدوده [0.0, 100.0] باشد.
.IP \fBp\fR 4
.IX Item "p"
تنظیم اندازه وصله (patch size) برای تمام صفحات. پیش‌فرض 7 است. باید یک عدد فرد در محدوده [0, 99] باشد.
.IP \fBr\fR 4
.IX Item "r"
تنظیم اندازه جستجو (research size). پیش‌فرض 15 است. باید یک عدد فرد در محدوده [0, 99] باشد.
.IP \fBt\fR 4
.IX Item "t"
تنظیم موازی‌سازی (parallelism). پیش‌فرض 8 است. باید عددی در محدوده [1, 64] باشد.
مقادیر بزرگ‌تر حافظه ویدیویی (VRAM) بیشتری مصرف می‌کنند اما لزوماً منجر به سرعت بیشتر نمی‌شوند.
مقدار بهینه به سخت‌افزار و ورودی وابسته است.
.IP \fBs0\fR 4
.IX Item "s0"
.PD 0
.IP \fBs1\fR 4
.IX Item "s1"
.IP \fBs2\fR 4
.IX Item "s2"
.IP \fBs3\fR 4
.IX Item "s3"
.PD
تنظیم قدرت کاهش نویز برای یک مؤلفه خاص. پیش‌فرض \fI1.0\fR و برابر با \fBs\fR است.
باید در محدوده [0.0, 100.0] باشد. مقدار 0.0 کاهش نویز را در آن مؤلفه غیرفعال می‌کند.
.IP \fBp0\fR 4
.IX Item "p0"
.PD 0
.IP \fBp1\fR 4
.IX Item "p1"
.IP \fBp2\fR 4
.IX Item "p2"
.IP \fBp3\fR 4
.IX Item "p3"
.PD
تنظیم اندازه وصله برای یک مؤلفه خاص. پیش‌فرض \fI7\fR و برابر با \fBp\fR است.
باید یک عدد فرد در محدوده [0, 99] باشد.
.SS overlay_vulkan
.IX Subsection "overlay_vulkan"
هم‌پوشانی یک ویدیو بر روی ویدیوی دیگر.
.PP
دو ورودی می‌گیرد و یک خروجی دارد. ورودی اول ویدیوی «اصلی» است که ورودی دوم بر روی آن هم‌پوشانی می‌شود.
این فیلتر نیازمند این است که تمام ورودی‌ها از قالب پیکسلی یکسانی استفاده کنند. بنابراین ممکن است تبدیل قالب لازم باشد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBx\fR 4
.IX Item "x"
تنظیم مختصات x ویدیوی روکش‌شده بر روی ویدیوی اصلی.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBy\fR 4
.IX Item "y"
تنظیم مختصات y ویدیوی روکش‌شده بر روی ویدیوی اصلی.
مقدار پیش‌فرض \f(CW0\fR است.
.SS transpose_vulkan
.IX Subsection "transpose_vulkan"
ترانهادن سطرها و ستون‌ها در ویدیوی ورودی و برگرداندن اختیاری آن (flip).
برای مثال‌های عمیق‌تر، فیلتر ویدیویی \fBtranspose\fR را مشاهده کنید که عمدتاً گزینه‌های یکسانی دارد.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBdir\fR 4
.IX Item "dir"
تعیین جهت ترانهش (transposition).
.Sp
می‌تواند مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBcclock_flip\fR 4
.IX Item "cclock_flip"
چرخش ۹۰ درجه در خلاف جهت عقربه‌های ساعت و برگرداندن عمودی (پیش‌فرض).
.IP \fBclock\fR 4
.IX Item "clock"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت.
.IP \fBcclock\fR 4
.IX Item "cclock"
چرخش ۹۰ درجه در خلاف جهت عقربه‌های ساعت.
.IP \fBclock_flip\fR 4
.IX Item "clock_flip"
چرخش ۹۰ درجه در جهت عقربه‌های ساعت و برگرداندن عمودی.
.RE
.RS 4
.RE
.IP \fBpassthrough\fR 4
.IX Item "passthrough"
عدم اعمال ترانهش در صورتی که هندسه ورودی با مقدار مشخص‌شده مطابقت داشته باشد. مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
همواره ترانهش اعمال شود (پیش‌فرض).
.IP \fBportrait\fR 4
.IX Item "portrait"
حفظ هندسه عمودی (پرتره) (زمانی که \fIheight\fR >= \fIwidth\fR).
.IP \fBlandscape\fR 4
.IX Item "landscape"
حفظ هندسه افقی (لندسکیپ) (زمانی که \fIwidth\fR >= \fIheight\fR).
.RE
.RS 4
.RE
.SH "فیلترهای ویدیویی QSV (QSV VIDEO FILTERS)"
.IX Header "QSV VIDEO FILTERS"
در ادامه شرح فیلترهای ویدیویی QSV که در حال حاضر در دسترس هستند آمده است.
.PP
برای فعال‌سازی کامپایل این فیلترها باید FFmpeg را با شناسه
\&\f(CW\*(C`\-\-enable\-libmfx\*(C'\fR یا \f(CW\*(C`\-\-enable\-libvpl\*(C'\fR پیکربندی کنید.
.PP
برای استفاده از فیلترهای QSV، باید دستگاه QSV را به درستی راه‌اندازی کنید. برای اطلاعات بیشتر، لطفاً <\fBhttps://trac.ffmpeg.org/wiki/Hardware/QuickSync\fR> را مطالعه فرمایید.
.SS hstack_qsv
.IX Subsection "hstack_qsv"
چیدمان افقی ویدیوهای ورودی در کنار یکدیگر.
.PP
این گونهٔ تحت QSV از فیلتر \fBhstack\fR است؛ هر استریم ورودی ممکن است ارتفاع متفاوتی داشته باشد، این فیلتر هر استریم ورودی را ضمن حفظ نسبت تصویر اصلی، به سمت بالا/پایین مقیاس‌بندی خواهد کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBhstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBhstack\fR مراجعه کنید.
.IP \fBheight\fR 4
.IX Item "height"
تنظیم ارتفاع خروجی. اگر روی 0 تنظیم شود، این فیلتر ارتفاع خروجی را برابر با ارتفاع نخستین استریم ورودی قرار می‌دهد. مقدار پیش‌فرض 0 است.
.SS vstack_qsv
.IX Subsection "vstack_qsv"
چیدمان عمودی ویدیوهای ورودی روی یکدیگر.
.PP
این گونهٔ تحت QSV از فیلتر \fBvstack\fR است؛ هر استریم ورودی ممکن است عرض متفاوتی داشته باشد، این فیلتر هر استریم ورودی را ضمن حفظ نسبت تصویر اصلی، به سمت بالا/پایین مقیاس‌بندی خواهد کرد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBvstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBvstack\fR مراجعه کنید.
.IP \fBwidth\fR 4
.IX Item "width"
تنظیم عرض خروجی. اگر روی 0 تنظیم شود، این فیلتر عرض خروجی را برابر با عرض نخستین استریم ورودی قرار می‌دهد. مقدار پیش‌فرض 0 است.
.SS xstack_qsv
.IX Subsection "xstack_qsv"
چیدمان ورودی‌های ویدیویی در یک قالب و ساختار سفارشی.
.PP
این گونهٔ تحت QSV از فیلتر \fBxstack\fR است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBinputs\fR 4
.IX Item "inputs"
به \fBxstack\fR مراجعه کنید.
.IP \fBshortest\fR 4
.IX Item "shortest"
به \fBxstack\fR مراجعه کنید.
.IP \fBlayout\fR 4
.IX Item "layout"
به \fBxstack\fR مراجعه کنید.
علاوه بر این، به کاربر امکان می‌دهد اندازه خروجی را برای هر استریم ورودی مشخص کند.
.Sp
.Vb 1
\&        xstack_qsv=inputs=4:layout=0_0_1920x1080|0_h0_1920x1080|w0_0_1920x1080|w0_h0_1920x1080
.Ve
.IP \fBgrid\fR 4
.IX Item "grid"
به \fBxstack\fR مراجعه کنید.
.IP \fBgrid_tile_size\fR 4
.IX Item "grid_tile_size"
تنظیم اندازه خروجی برای هر استریم ورودی در هنگام تنظیم \fBgrid\fR. اگر این گزینه تنظیم نشود، این فیلتر به صورت پیش‌فرض اندازه خروجی را برابر با اندازه نخستین استریم ورودی تنظیم خواهد کرد. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBfill\fR 4
.IX Item "fill"
به \fBxstack\fR مراجعه کنید.
.SH "سورس‌های ویدیویی (VIDEO SOURCES)"
.IX Header "VIDEO SOURCES"
در ادامه شرح سورس‌های ویدیویی که در حال حاضر در دسترس هستند آمده است.
.SS buffer
.IX Subsection "buffer"
بافر کردن فریم‌های ویدیو و در دسترس قرار دادن آن‌ها برای زنجیره فیلتر.
.PP
این سورس عمدتاً برای استفاده برنامه‌نویسی‌شده در نظر گرفته شده است، به ویژه از طریق رابط تعریف‌شده در \fIlibavfilter/buffersrc.h\fR.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تعیین اندازه (عرض و ارتفاع) فریم‌های ویدیویی بافرشده. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBwidth\fR 4
.IX Item "width"
عرض ویدیوی ورودی.
.IP \fBheight\fR 4
.IX Item "height"
ارتفاع ویدیوی ورودی.
.IP \fBpix_fmt\fR 4
.IX Item "pix_fmt"
رشته‌ای که نشان‌دهنده قالب پیکسلی فریم‌های ویدیویی بافرشده است.
می‌تواند عددی متناظر با یک قالب پیکسلی، یا نام یک قالب پیکسلی باشد.
.IP \fBtime_base\fR 4
.IX Item "time_base"
تعیین پایه زمانی فرض‌شده برای برچسب‌های زمانی فریم‌های بافرشده.
.IP \fBframe_rate\fR 4
.IX Item "frame_rate"
تعیین نرخ فریم مورد انتظار برای استریم ویدیو.
.IP \fBcolorspace\fR 4
.IX Item "colorspace"
رشته‌ای که نشان‌دهنده فضای رنگی فریم‌های ویدیویی بافرشده است.
می‌تواند عددی متناظر با یک فضای رنگی، یا نام یک فضای رنگی باشد.
.IP \fBrange\fR 4
.IX Item "range"
رشته‌ای که نشان‌دهنده محدوده رنگی فریم‌های ویدیویی بافرشده است.
می‌تواند عددی متناظر با یک محدوده رنگی، یا نام یک محدوده رنگی باشد.
.IP \fBalpha_mode\fR 4
.IX Item "alpha_mode"
رشته‌ای که نشان‌دهنده حالت آلفای فریم‌های ویدیویی بافرشده است.
می‌تواند عددی متناظر با یک حالت آلفا، یا نام یک حالت آلفا باشد.
.IP "\fBpixel_aspect, sar\fR" 4
.IX Item "pixel_aspect, sar"
نسبت تصویر نمونه (پیکسل) در ویدیوی ورودی.
.IP \fBhw_frames_ctx\fR 4
.IX Item "hw_frames_ctx"
هنگام استفاده از یک قالب پیکسلی سخت‌افزاری، این گزینه باید ارجاعی به یک AVHWFramesContext باشد که فریم‌های ورودی را توصیف می‌کند.
.PP
برای مثال:
.PP
.Vb 1
\&        buffer=width=320:height=240:pix_fmt=yuv410p:time_base=1/24:sar=1
.Ve
.PP
به سورس دستور می‌دهد فریم‌های ویدیویی با اندازه 320x240 و قالب "yuv410p" را بپذیرد، با فرض 1/24 به عنوان پایه زمانی برچسب‌های زمانی و پیکسل‌های مربعی (نسبت تصویر نمونه 1:1).
از آنجا که قالب پیکسلی با نام "yuv410p" متناظر با عدد 6 است (تعریف شمارشی AVPixelFormat در \fIlibavutil/pixfmt.h\fR را بررسی کنید)، این مثال متناظر است با:
.PP
.Vb 1
\&        buffer=size=320x240:pixfmt=6:time_base=1/24:pixel_aspect=1/1
.Ve
.PP
به عنوان روشی جایگزین، گزینه‌ها را می‌توان به عنوان یک رشته مسطح مشخص کرد، اما این ساختار نحوی منسوخ شده است:
.PP
\&\fIwidth\fR:\fIheight\fR:\fIpix_fmt\fR:\fItime_base.num\fR:\fItime_base.den\fR:\fIpixel_aspect.num\fR:\fIpixel_aspect.den\fR
.SS cellauto
.IX Subsection "cellauto"
ایجاد یک الگو که توسط یک خودکاره سلولی ابتدایی (cellular automaton) تولید می‌شود.
.PP
وضعیت اولیه خودکاره سلولی را می‌توان از طریق گزینه‌های
\&\fBfilename\fR و \fBpattern\fR تعریف کرد. اگر چنین گزینه‌هایی
تعیین نشوند، وضعیت اولیه به صورت تصادفی ایجاد می‌شود.
.PP
در هر فریم جدید، یک سطر جدید در ویدیو با نتیجه نسل بعدی خودکاره سلولی پر می‌شود. رفتار فیلتر در هنگام پر شدن کامل فریم توسط گزینه \fBscroll\fR تعیین می‌گردد.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBfilename, f\fR" 4
.IX Item "filename, f"
خواندن وضعیت اولیه خودکاره سلولی، یعنی سطر شروع، از
پرونده مشخص‌شده.
در پرونده، هر نویسه غیر از فاصله خالی (non\-whitespace) به عنوان یک سلول زنده در نظر گرفته می‌شود، یک خط جدید سطر را خاتمه می‌دهد، و نویسه‌های بعدی در پرونده نادیده گرفته خواهند شد.
.IP "\fBpattern, p\fR" 4
.IX Item "pattern, p"
خواندن وضعیت اولیه خودکاره سلولی، یعنی سطر شروع، از
رشته مشخص‌شده.
.Sp
هر نویسه غیر از فاصله خالی در رشته به عنوان یک سلول زنده در نظر گرفته می‌شود، یک خط جدید سطر را خاتمه می‌دهد، و نویسه‌های بعدی در رشته نادیده گرفته خواهند شد.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ ویدیو، یعنی تعداد فریم‌های تولیدشده در هر ثانیه.
پیش‌فرض 25 است.
.IP "\fBrandom_fill_ratio, ratio\fR" 4
.IX Item "random_fill_ratio, ratio"
تنظیم نسبت پر کردن تصادفی برای سطر اولیه خودکاره سلولی.
این یک مقدار عددی اعشاری در محدوده 0 تا 1 است و مقدار پیش‌فرض آن
1/PHI می‌باشد.
.Sp
این گزینه در صورت مشخص شدن یک پرونده یا یک الگو نادیده گرفته می‌شود.
.IP "\fBrandom_seed, seed\fR" 4
.IX Item "random_seed, seed"
تنظیم بذر تصادفی (seed) برای پر کردن تصادفی سطر اولیه؛ باید یک عدد صحیح بین 0 و UINT32_MAX باشد. در صورت عدم تعیین، یا در صورت تنظیم صریح روی \-1، فیلتر سعی خواهد کرد بر پایه بهترین تلاش از یک بذر تصادفی مناسب استفاده کند.
.IP \fBrule\fR 4
.IX Item "rule"
تنظیم قاعده خودکاره سلولی، که عددی در محدوده 0 تا 255 است.
مقدار پیش‌فرض 110 است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیوی خروجی. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
اگر \fBfilename\fR یا \fBpattern\fR مشخص شده باشد، اندازه به طور پیش‌فرض روی عرض سطر وضعیت اولیه مشخص‌شده تنظیم می‌شود، و ارتفاع روی \fIwidth\fR * PHI تنظیم خواهد شد.
.Sp
اگر \fBsize\fR تنظیم شود، باید حاوی عرض رشته الگوی مشخص‌شده باشد، و الگوی مشخص‌شده در مرکز سطر بزرگ‌تر قرار خواهد گرفت.
.Sp
اگر نام پرونده یا رشته الگو مشخص نشود، مقدار اندازه به طور پیش‌فرض "320x518" خواهد بود (که برای وضعیت اولیه تصادفی تولیدشده استفاده می‌شود).
.IP \fBscroll\fR 4
.IX Item "scroll"
اگر روی 1 تنظیم شود، هنگامی که تمام سطرهای خروجی پر شدند، خروجی را به سمت بالا پیمایش می‌کند. اگر روی 0 تنظیم شود، سطر جدید تولیدشده درست پس از پر شدن سطر انتهایی، روی سطر بالایی بازنویسی می‌شود.
پیش‌فرض 1 است.
.IP "\fBstart_full, full\fR" 4
.IX Item "start_full, full"
اگر روی 1 تنظیم شود، خروجی را قبل از ارسال فریم اول، به طور کامل با سطرهای تولیدشده پر می‌کند.
این رفتار پیش‌فرض است؛ برای غیرفعال کردن مقدار را روی 0 تنظیم کنید.
.IP \fBstitch\fR 4
.IX Item "stitch"
اگر روی 1 تنظیم شود، لبه‌های چپ و راست سطر را به یکدیگر وصل می‌کند.
این رفتار پیش‌فرض است؛ برای غیرفعال کردن مقدار را روی 0 تنظیم کنید.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
خواندن وضعیت اولیه از \fIpattern\fR و تعیین خروجی با اندازه 200x400.
.Sp
.Vb 1
\&        cellauto=f=pattern:s=200x400
.Ve
.IP \(bu 4
تولید یک سطر اولیه تصادفی با عرض ۲۰۰ سلول، با نسبت پر کردن ۲/۳:
.Sp
.Vb 1
\&        cellauto=ratio=2/3:s=200x200
.Ve
.IP \(bu 4
ایجاد یک الگو که توسط قاعده 18 با شروع از یک سلول زنده منفرد متمرکز در سطر اولیه با عرض 100 تولید می‌شود:
.Sp
.Vb 1
\&        cellauto=p=@s=100x400:full=0:rule=18
.Ve
.IP \(bu 4
تعیین یک الگوی اولیه پیچیده‌تر:
.Sp
.Vb 1
\&        cellauto=p=\*(Aq@@ @ @@\*(Aq:s=100x400:full=0:rule=18
.Ve
.SS coreimagesrc
.IX Subsection "coreimagesrc"
سورس ویدیویی تولیدشده بر روی GPU با استفاده از API بخش CoreImage شرکت اپل در OSX.
.PP
این سورس ویدیویی نسخه تخصصی فیلتر ویدیویی \fBcoreimage\fR است.
برای تولید محتوا، از یک تولیدکننده CoreImage در ابتدای زنجیره فیلترهای اعمال‌شده استفاده کنید.
.PP
سورس ویدیویی coreimagesrc گزینه‌های زیر را می‌پذیرد:
.IP \fBlist_generators\fR 4
.IX Item "list_generators"
فهرست کردن تمام مولدهای موجود به همراه تمامی گزینه‌های مربوطه و مقادیر حداقل و حداکثر ممکن در کنار مقادیر پیش‌فرض.
.Sp
.Vb 1
\&        list_generators=true
.Ve
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیوی تولیدشده. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`320x240\*(C'\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تعیین نرخ فریم ویدیوی تولیدشده، به عنوان تعداد فریم‌های تولیدشده در ثانیه. باید رشته‌ای در قالب
\&\fIframe_rate_num\fR/\fIframe_rate_den\fR، یک عدد صحیح، یک عدد اعشاری یا یک اختصار معتبر نرخ فریم ویدیو باشد. مقدار پیش‌فرض "25" است.
.IP \fBsar\fR 4
.IX Item "sar"
تنظیم نسبت تصویر نمونه ویدیوی تولیدشده.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان ویدیوی تولیدشده.
بخش \fBمدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR را
برای ساختار نحوی پذیرفته‌شده مشاهده کنید.
.Sp
اگر تعیین نشود، یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود که ویدیو برای همیشه تولید خواهد شد.
.PP
علاوه بر این، تمامی گزینه‌های فیلتر ویدیویی \fBcoreimage\fR پذیرفته می‌شوند.
می‌توان از یک زنجیره فیلتر کامل برای پردازش بیشتر ورودی تولیدشده بدون انتقال میان پردازنده و میزبان (CPU\-HOST) استفاده کرد. برای جزئیات به مستندات و مثال‌های \fBcoreimage\fR مراجعه کنید.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
استفاده از CIQRCodeGenerator برای ایجاد کد QR برای صفحه خانگی FFmpeg، ارائه‌شده به عنوان خط فرمان کامل و گریزدار برای پوسته استاندارد bash اپل:
.Sp
.Vb 1
\&        ffmpeg \-f lavfi \-i coreimagesrc=s=100x100:filter=CIQRCodeGenerator@inputMessage=https\e\e\e\e\e://FFmpeg.org/@inputCorrectionLevel=H \-frames:v 1 QRCode.png
.Ve
.Sp
این مثال معادل مثال QRCode در \fBcoreimage\fR بدون نیاز به سورس ویدیویی nullsrc است.
.SS ddagrab
.IX Subsection "ddagrab"
ضبط دسکتاپ ویندوز از طریق API تکثیر دسکتاپ (Desktop Duplication API).
.PP
این فیلتر منحصراً فریم‌های سخت‌افزاری D3D11 را برای انکود یا پردازش روی GPU برمی‌گرداند. بنابراین برای هر نوع پردازش نرم‌افزاری، یک \fBhwdownload\fR صریح مورد نیاز است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBoutput_idx\fR 4
.IX Item "output_idx"
شاخص خروجی DXGI برای ضبط.
.Sp
معمولاً متناظر با شاخصی است که ویندوز به صفحه نمایش داده است منهای یک، بنابراین از 0 شروع می‌شود.
.Sp
پیش‌فرض خروجی 0 است.
.IP \fBdraw_mouse\fR 4
.IX Item "draw_mouse"
رسم یا عدم رسم مکان‌نمای ماوس.
.Sp
پیش‌فرض true است.
.Sp
تنها مکان‌نماهای سخت‌افزاری را تحت تأثیر قرار می‌دهد. اگر یک بازی یا برنامه مکان‌نمای خود را رندر کند، همواره ضبط خواهد شد.
.IP \fBframerate\fR 4
.IX Item "framerate"
حداکثر نرخ فریمی که دسکتاپ با آن ضبط خواهد شد \- فاصله بین فریم‌های متوالی کوچک‌تر از معکوس نرخ فریم نخواهد بود. هنگامی که
\&\fIdup_frames\fR برابر true باشد (پیش‌فرض) و دسکتاپ به اندازه کافی به‌روزرسانی نشود، فیلتر فریم قبلی را تکثیر خواهد کرد. توجه داشته باشید که هیچ بافرینگی در پس‌زمینه انجام نمی‌شود، بنابراین هنگامی که فیلتر به اندازه کافی فراخوانی نشود، فاصله واقعی بین فریم‌ها ممکن است به طور قابل توجهی بزرگ‌تر باشد.
.Sp
پیش‌فرض 30 FPS است.
.IP \fBvideo_size\fR 4
.IX Item "video_size"
تعیین اندازه ویدیوی ضبط‌شده.
.Sp
پیش‌فرض اندازه کامل صفحه نمایش است.
.Sp
در صورتی که کوچک‌تر از اندازه صفحه باشد، از پایین/راست بریده می‌شود.
.IP \fBoffset_x\fR 4
.IX Item "offset_x"
آفست افقی ویدیوی ضبط‌شده.
.IP \fBoffset_y\fR 4
.IX Item "offset_y"
آفست عمودی ویدیوی ضبط‌شده.
.IP \fBoutput_fmt\fR 4
.IX Item "output_fmt"
قالب خروجی مورد نظر فیلتر.
پیش‌فرض 8 بیتی BGRA است.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
تمامی قالب‌های خروجی پشتیبانی‌شده را به DDA ارسال می‌کند و آنچه را که DDA تصمیم به استفاده از آن می‌گیرد برمی‌گرداند.
.IP \fB8bit\fR 4
.IX Item "8bit"
.PD 0
.IP \fBbgra\fR 4
.IX Item "bgra"
.PD
قالب‌های ۸ بیتی همیشه کار می‌کنند و DDA در صورت لزوم به آن‌ها تبدیل خواهد کرد.
.IP \fB10bit\fR 4
.IX Item "10bit"
.PD 0
.IP \fBx2bgr10\fR 4
.IX Item "x2bgr10"
.PD
اگر قالب ۱۰ بیتی درخواست شود اما در دسترس نباشد، راه‌اندازی اولیه فیلتر با شکست مواجه خواهد شد.
.RE
.RS 4
.RE
.IP \fBdup_frames\fR 4
.IX Item "dup_frames"
هنگامی که این گزینه روی true تنظیم شود (پیش‌فرض)، فیلتر در صورت عدم به‌روزرسانی دسکتاپ، فریم‌ها را تکرار می‌کند تا نرخ فریم هدف را تقریباً ثابت نگه دارد. هنگامی که این گزینه روی false تنظیم شود، فیلتر منتظر به‌روزرسانی دسکتاپ می‌ماند (در این حالت فاصله‌های بین فریم‌ها ممکن است به طور چشمگیری متفاوت باشند).
.PP
\fIExamples\fR
.IX Subsection "Examples"
.PP
ضبط صفحه اصلی و اینکود با استفاده از nvenc:
.PP
.Vb 1
\&        ffmpeg \-f lavfi \-i ddagrab \-c:v h264_nvenc \-cq 18 output.mp4
.Ve
.PP
شما همچنین می‌توانید از دستگاه lavfi صرف‌نظر کرده و مستقیماً از فیلتر استفاده کنید.
همچنین دانلود فریم و انکود با libx264 را نشان می‌دهد.
در این حالت تعیین صریح قالب خروجی الزامی است:
.PP
.Vb 1
\&        ffmpeg \-filter_complex ddagrab=output_idx=1:framerate=60,hwdownload,format=bgra \-c:v libx264 \-crf 18 output.mp4
.Ve
.PP
اگر می‌خواهید تنها بخشی از دسکتاپ را ضبط کنید، می‌توان این کار را با مشخص کردن یک اندازه کوچک‌تر و آفست‌های آن در صفحه به انجام رساند:
.PP
.Vb 1
\&        ddagrab=video_size=800x600:offset_x=100:offset_y=100
.Ve
.SS gfxcapture
.IX Subsection "gfxcapture"
ضبط پنجره‌ها یا مانیتورها با استفاده از API مربوط به Windows.Graphics.Capture.
.PP
این سورس ضبط با سربار کم از پنجره‌های برنامه‌ها یا کل مانیتورها را فراهم می‌کند.
این فیلتر فریم‌های سخت‌افزاری را در قالب \f(CW\*(C`d3d11\*(C'\fR خروجی می‌دهد؛ در صورتی که فریم‌ها در حافظه سیستم مورد نیاز باشند از \f(CW\*(C`hwdownload,format=\*(C'\fR استفاده کنید.
.PP
پنجره‌ای که باید ضبط شود را می‌توان از طریق عبارات باقاعده (regex) روی عنوان، نام کلاس یا نام فایل اجرایی پشتیبان آن، با دستگیره‌های بومی (handles) صریح، یا با شاخص مانیتور یا دستگیره بومی صریح انتخاب کرد. یک پنجره برای انتخاب شدن باید با تمام عبارات ارائه‌شده مطابقت داشته باشد. نخستین پنجره منطبق، به هر ترتیبی که ویندوز آن‌ها را بازگرداند، برداشته خواهد شد.
.PP
دستگیره‌های صریح (\fBhwnd\fR، \fBhmonitor\fR) اولویت بالاتری نسبت به انتخاب بر اساس الگو یا شاخص دارند. اگر نه دستگیره‌ها و نه شاخص مانیتور داده نشوند، اولین پنجره منطبق با عبارات باقاعده ارائه‌شده ضبط می‌شود.
.PP
این سورس یک FPS ثابت را حفظ نمی‌کند. فریم‌ها را با هر نرخی که ترکیب‌کننده (compositor) ارائه می‌دهد بازمی‌گرداند، و فقط توسط \fBmax_framerate\fR محدود می‌شود.
اگر به نرخ ثابتی نیاز دارید، باید یک فیلتر fps اضافه کنید تا بر حسب نیاز فریم‌ها را حذف یا تکرار کند.
.PP
اگر سورس ضبط در میانه ضبط ناپدید شود (پنجره بسته شود، مانیتور قطع شود)، فیلتر EOF برمی‌گرداند.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP \fBwindow_title\fR 4
.IX Item "window_title"
عبارت باقاعده ECMAScript که با عنوان پنجره مطابقت داده می‌شود. از پیشوند \f(CW\*(C`(?i)\*(C'\fR به سبک PCRE برای تطابق بدون تمایز حروف کوچک و بزرگ پشتیبانی می‌کند.
.IP \fBwindow_class\fR 4
.IX Item "window_class"
همانند \fBwindow_title\fR، اما با نام کلاس پنجره مطابقت داده می‌شود.
.IP \fBwindow_exe\fR 4
.IX Item "window_exe"
همانند \fBwindow_title\fR، اما با نام پرونده اجرایی فرایند پنجره مطابقت داده می‌شود.
.IP \fBmonitor_idx\fR 4
.IX Item "monitor_idx"
شاخص مبتنی بر صفر از مانیتور جهت ضبط.
.Sp
همچنین می‌تواند روی \f(CW\*(C`window\*(C'\fR تنظیم شود تا مانیتوری را ضبط کند که پنجره انتخاب‌شده در زمان راه‌اندازی اولیه فیلتر روی آن نمایش داده می‌شود.
.IP \fBhwnd\fR 4
.IX Item "hwnd"
دستگیره بومی صریح پنجره (HWND).
.IP \fBhmonitor\fR 4
.IX Item "hmonitor"
دستگیره بومی صریح مانیتور (HMONITOR).
.IP \fBcapture_cursor\fR 4
.IX Item "capture_cursor"
ضبط مکان‌نمای ماوس. به طور پیش‌فرض فعال است.
.IP \fBcapture_border\fR 4
.IX Item "capture_border"
ضبط کل ناحیه پنجره، شامل تزیینات/کادر حاشیه پنجره.
به طور پیش‌فرض غیرفعال است.
.IP \fBdisplay_border\fR 4
.IX Item "display_border"
رسم یک کادر حاشیه برجسته زرد در اطراف پنجره ضبط‌شده. به طور پیش‌فرض غیرفعال است.
.IP \fBmax_framerate\fR 4
.IX Item "max_framerate"
حداکثر نرخ فریم ضبط. یک نرخ ویدیو را می‌پذیرد (مانند \f(CW30\fR، \f(CW\*(C`60/1\*(C'\fR،
\&\f(CW\*(C`24000/1001\*(C'\fR). مقدار پیش‌فرض \f(CW60\fR فریم در ثانیه است.
نرخ واقعی نرخی است که ترکیب‌کننده پنجره/مانیتور را رندر می‌کند، و با این گزینه محدود می‌شود.
.IP \fBwidth\fR 4
.IX Item "width"
اجبار عرض بوم خروجی. اگر صفر باشد (پیش‌فرض)، عرض سورس ضبط‌شده اولیه استفاده می‌شود. اگر یک عدد منفی ارائه شود، عرض به مضرب بعدی آن عدد گرد می‌شود.
.Sp
به \fBresize_mode\fR مراجعه کنید.
.IP \fBheight\fR 4
.IX Item "height"
اجبار ارتفاع بوم خروجی. اگر صفر باشد (پیش‌فرض)، ارتفاع سورس ضبط‌شده اولیه استفاده می‌شود. اگر یک عدد منفی ارائه شود، ارتفاع به مضرب بعدی آن عدد گرد می‌شود.
.Sp
به \fBresize_mode\fR مراجعه کنید.
.IP \fBcrop_left\fR 4
.IX Item "crop_left"
برش این تعداد پیکسل از سمت چپ فریم‌های ضبط‌شده.
.IP \fBcrop_top\fR 4
.IX Item "crop_top"
برش این تعداد پیکسل از سمت بالای فریم‌های ضبط‌شده.
.IP \fBcrop_right\fR 4
.IX Item "crop_right"
برش این تعداد پیکسل از سمت راست فریم‌های ضبط‌شده.
.IP \fBcrop_bottom\fR 4
.IX Item "crop_bottom"
برش این تعداد پیکسل از سمت پایین فریم‌های ضبط‌شده.
.IP \fBpremultiplied\fR 4
.IX Item "premultiplied"
اگر روی 1 تنظیم شود، فریم‌ها را با آلفای پیش‌ضرب‌شده (premultiplied alpha) بازمی‌گرداند. پیش‌فرض 0 است (آلفای مستقیم/straight alpha).
.IP \fBresize_mode\fR 4
.IX Item "resize_mode"
نحوه برازش محتوای ضبط‌شده در اندازه بوم خروجی را تعریف می‌کند.
مقادیر ممکن:
.RS 4
.IP \fBcrop\fR 4
.IX Item "crop"
برش (یا حاشیه‌بندی با رنگ سیاه) به اندازه بوم (پیش‌فرض).
.IP \fBscale\fR 4
.IX Item "scale"
مقیاس‌بندی مبدأ برای پر کردن بوم، با احتمال تغییر نسبت تصویر.
.IP \fBscale_aspect\fR 4
.IX Item "scale_aspect"
مقیاس‌بندی مبدأ برای قرار گرفتن درون بوم ضمن حفظ نسبت تصویر.
ناحیه باقیمانده با رنگ سیاه پر می‌شود.
.RE
.RS 4
.RE
.IP \fBscale_mode\fR 4
.IX Item "scale_mode"
الگوریتم مقیاس‌بندی مورد استفاده در هنگام نیاز به تغییر اندازه.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBpoint\fR 4
.IX Item "point"
مقیاس‌بندی نزدیک‌ترین همسایه (پیکسلی‌شده).
.IP \fBbilinear\fR 4
.IX Item "bilinear"
فیلتر کردن دوخطی (bilinear) (پیش‌فرض).
.IP \fBbicubic\fR 4
.IX Item "bicubic"
فیلتر کردن دوبعدی مکعبی (bicubic). بالقوه تارتر، اما بسته به محتوا دارای مصنوعات مقیاس‌بندی کمتر.
.RE
.RS 4
.RE
.IP \fBoutput_fmt\fR 4
.IX Item "output_fmt"
قالب پیکسلی خروجی مورد نظر درون فریم‌های سخت‌افزاری D3D11.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBbgra\fR 4
.IX Item "bgra"
.PD 0
.IP \fB8bit\fR 4
.IX Item "8bit"
.PD
خروجی ۸ بیتی BGRA (پیش‌فرض)
.IP \fBx2bgr10\fR 4
.IX Item "x2bgr10"
.PD 0
.IP \fB10bit\fR 4
.IX Item "10bit"
.PD
خروجی ۱۰ بیتی BGR
.IP \fBrgbaf16\fR 4
.IX Item "rgbaf16"
.PD 0
.IP \fB16bit\fR 4
.IX Item "16bit"
.PD
خروجی RGBA اعشاری ۱۶ بیتی
.RE
.RS 4
.RE
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP "*<Capture a window by title (case\-insensitive) at a maximum of 60 fps:>" 4
.IX Item "*<Capture a window by title (case-insensitive) at a maximum of 60 fps:>"
.Vb 1
\&        ffmpeg \-filter_complex gfxcapture=window_title=\*(Aq(?i)My Application\*(Aq:max_framerate=60,hwdownload,format=bgra,format=yuv420p \-c:v libx264 \-crf 15 capture.mp4
.Ve
.IP "*<Capture monitor 1 at native refresh, 10bit color depth, scale to 1920x1080 preserving aspect:>" 4
.IX Item "*<Capture monitor 1 at native refresh, 10bit color depth, scale to 1920x1080 preserving aspect:>"
.Vb 1
\&        ffmpeg \-filter_complex gfxcapture=monitor_idx=1:width=1920:height=1080:resize_mode=scale_aspect:output_fmt=10bit \-c:v hevc_nvenc \-cq 15 capture.mp4
.Ve
.IP "*<Capture a window by executable name, draw border, force point scaling, fixed 60 fps:>" 4
.IX Item "*<Capture a window by executable name, draw border, force point scaling, fixed 60 fps:>"
.Vb 1
\&        ffmpeg \-filter_complex gfxcapture=window_exe=\*(Aq^firefox.exe$\*(Aq:display_border=1:scale_mode=point,fps=60 \-rc qvbr \-qvbr_quality_level 15 \-c:v h264_amf capture.mp4
.Ve
.SS gradients
.IX Subsection "gradients"
تولید چندین گرادیان رنگی.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه فریم. برای ساختار نحوی این گزینه، بخش \fB"Video
size" در راهنمای ffmpeg\-utils\fR را بررسی کنید. مقدار پیش‌فرض "640x480" است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بیان‌شده به صورت تعداد فریم‌ها در هر ثانیه. مقدار پیش‌فرض
"25" است.
.IP "\fBc0, c1, c2, c3, c4, c5, c6, c7\fR" 4
.IX Item "c0, c1, c2, c3, c4, c5, c6, c7"
تنظیم ۸ رنگ. مقادیر پیش‌فرض برای رنگ‌ها انتخاب رنگ تصادفی است.
.IP "\fBx0, y0, y0, y1\fR" 4
.IX Item "x0, y0, y0, y1"
تنظیم نقاط مبدأ و مقصد خط گرادیان. اگر منفی یا خارج از محدوده باشند، مقادیر تصادفی
انتخاب می‌شوند.
.IP "\fBnb_colors, n\fR" 4
.IX Item "nb_colors, n"
تنظیم تعداد رنگ‌های مورد استفاده در یک زمان. محدوده مجاز از 2 تا 8 است. مقدار پیش‌فرض 2 است.
.IP \fBseed\fR 4
.IX Item "seed"
تنظیم بذر تصادفی (seed) برای انتخاب نقاط خط گرادیان.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان ویدیوی تولیدشده.
بخش \fBمدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR را
برای ساختار نحوی پذیرفته‌شده مشاهده کنید.
.Sp
اگر تعیین نشود، یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود که ویدیو
برای همیشه تولید خواهد شد.
.IP \fBspeed\fR 4
.IX Item "speed"
تنظیم سرعت چرخش گرادیان‌ها.
.IP "\fBtype, t\fR" 4
.IX Item "type, t"
تنظیم نوع گرادیان‌ها.
مقادیر موجود عبارتند از:
.RS 4
.IP \fBlinear\fR 4
.IX Item "linear"
.PD 0
.IP \fBradial\fR 4
.IX Item "radial"
.IP \fBcircular\fR 4
.IX Item "circular"
.IP \fBspiral\fR 4
.IX Item "spiral"
.IP \fBsquare\fR 4
.IX Item "square"
.PD
.RE
.RS 4
.Sp
نوع پیش‌فرض \fIlinear\fR است.
.RE
.PP
\fICommands\fR
.IX Subsection "Commands"
.PP
این سورس از برخی از گزینه‌های بالا به عنوان \fBدستورات\fR (commands) پشتیبانی می‌کند.
.SS mandelbrot
.IX Subsection "mandelbrot"
تولید یک فراکتال مجموعه مندلبرو (Mandelbrot set) و بزرگ‌نمایی تدریجی به سمت
نقطه مشخص‌شده با \fIstart_x\fR و \fIstart_y\fR.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP \fBend_pts\fR 4
.IX Item "end_pts"
تنظیم مقدار پایانی pts. مقدار پیش‌فرض 400 است.
.IP \fBend_scale\fR 4
.IX Item "end_scale"
تنظیم مقدار مقیاس پایانی.
باید یک مقدار ممیز شناور باشد. مقدار پیش‌فرض 0.3 است.
.IP \fBinner\fR 4
.IX Item "inner"
تنظیم حالت رنگ‌آمیزی درونی، یعنی الگوریتم مورد استفاده برای رسم
ناحیه درونی فراکتال مندلبرو.
.Sp
باید یکی از مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBblack\fR 4
.IX Item "black"
حالت سیاه.
.IP \fBconvergence\fR 4
.IX Item "convergence"
نمایش زمان تا رسیدن به همگرایی.
.IP \fBmincol\fR 4
.IX Item "mincol"
تنظیم رنگ بر اساس نزدیک‌ترین نقطه به مبدأ تکرارها.
.IP \fBperiod\fR 4
.IX Item "period"
حالت تناوب (period).
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fImincol\fR است.
.RE
.IP \fBbailout\fR 4
.IX Item "bailout"
تنظیم مقدار خروج (bailout). مقدار پیش‌فرض 10.0 است.
.IP \fBmaxiter\fR 4
.IX Item "maxiter"
تنظیم حداکثر تعداد تکرارهای انجام‌شده توسط الگوریتم
رندر. مقدار پیش‌فرض 7189 است.
.IP \fBouter\fR 4
.IX Item "outer"
تنظیم حالت رنگ‌آمیزی بیرونی.
باید یکی از مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBiteration_count\fR 4
.IX Item "iteration_count"
حالت شمارش تکرار.
.IP \fBnormalized_iteration_count\fR 4
.IX Item "normalized_iteration_count"
حالت شمارش تکرار نرمال‌شده.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fInormalized_iteration_count\fR است.
.RE
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بیان‌شده به صورت تعداد فریم‌ها در هر ثانیه. مقدار پیش‌فرض
"25" است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه فریم. برای ساختار نحوی این گزینه، بخش \fB"Video
size" در راهنمای ffmpeg\-utils\fR را بررسی کنید. مقدار پیش‌فرض "640x480" است.
.IP \fBstart_scale\fR 4
.IX Item "start_scale"
تنظیم مقدار مقیاس اولیه. مقدار پیش‌فرض 3.0 است.
.IP \fBstart_x\fR 4
.IX Item "start_x"
تنظیم موقعیت اولیه x. باید یک مقدار ممیز شناور بین
\&\-100 و 100 باشد. مقدار پیش‌فرض \-0.743643887037158704752191506114774 است.
.IP \fBstart_y\fR 4
.IX Item "start_y"
تنظیم موقعیت اولیه y. باید یک مقدار ممیز شناور بین
\&\-100 و 100 باشد. مقدار پیش‌فرض \-0.131825904205311970493132056385139 است.
.SS mptestsrc
.IX Subsection "mptestsrc"
تولید الگوهای آزمایشی مختلف، همان‌طور که توسط فیلتر آزمایشی MPlayer تولید می‌شوند.
.PP
اندازه ویدیوی تولیدشده ثابت و برابر با 512x512 است.
این سورس به ویژه برای آزمایش ویژگی‌های اینکودینگ مفید است.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تعیین نرخ فریم ویدیوی تولیدشده، به صورت تعداد فریم‌های
تولیدشده در ثانیه. باید رشته‌ای در قالب
\&\fIframe_rate_num\fR/\fIframe_rate_den\fR، یک عدد صحیح، یک عدد اعشاری
یا یک اختصار معتبر نرخ فریم ویدیو باشد. مقدار پیش‌فرض
"25" است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان ویدیوی تولیدشده.
بخش \fBمدت‌زمان (Time duration) در راهنمای ffmpeg\-utils\|(1)\fR را
برای ساختار نحوی پذیرفته‌شده مشاهده کنید.
.Sp
اگر تعیین نشود، یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود که ویدیو
برای همیشه تولید خواهد شد.
.IP "\fBtest, t\fR" 4
.IX Item "test, t"
تنظیم شماره یا نام آزمایشی که باید انجام شود. آزمایش‌های پشتیبانی‌شده عبارتند از:
.RS 4
.IP \fBdc_luma\fR 4
.IX Item "dc_luma"
.PD 0
.IP \fBdc_chroma\fR 4
.IX Item "dc_chroma"
.IP \fBfreq_luma\fR 4
.IX Item "freq_luma"
.IP \fBfreq_chroma\fR 4
.IX Item "freq_chroma"
.IP \fBamp_luma\fR 4
.IX Item "amp_luma"
.IP \fBamp_chroma\fR 4
.IX Item "amp_chroma"
.IP \fBcbp\fR 4
.IX Item "cbp"
.IP \fBmv\fR 4
.IX Item "mv"
.IP \fBring1\fR 4
.IX Item "ring1"
.IP \fBring2\fR 4
.IX Item "ring2"
.IP \fBall\fR 4
.IX Item "all"
.IP "\fBmax_frames, m\fR" 4
.IX Item "max_frames, m"
.PD
تنظیم حداکثر تعداد فریم‌های تولیدشده برای هر آزمایش؛ مقدار پیش‌فرض 30 است.
.RE
.RS 4
.Sp
مقدار پیش‌فرض "all" است، که در میان فهرست تمام آزمایش‌ها چرخش خواهد کرد.
.RE
.PP
چندین نمونه:
.PP
.Vb 1
\&        mptestsrc=t=dc_luma
.Ve
.PP
یک الگوی آزمایشی "dc_luma" تولید خواهد کرد.
.SS frei0r_src
.IX Subsection "frei0r_src"
ارائه یک سورس frei0r.
.PP
برای فعال‌سازی کامپایل این فیلتر باید هدر frei0r را نصب کرده
و FFmpeg را با شناسه \f(CW\*(C`\-\-enable\-frei0r\*(C'\fR پیکربندی کنید.
.PP
این سورس پارامترهای زیر را می‌پذیرد:
.IP \fBsize\fR 4
.IX Item "size"
اندازه ویدیوی تولیدی. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP \fBframerate\fR 4
.IX Item "framerate"
نرخ فریم ویدیوی تولیدشده. ممکن است رشته‌ای به شکل
\&\fInum\fR/\fIden\fR یا اختصار نرخ فریم باشد.
.IP \fBfilter_name\fR 4
.IX Item "filter_name"
نام سورس frei0r جهت بارگذاری. برای اطلاعات بیشتر در مورد frei0r و
نحوه تنظیم پارامترها، بخش \fBfrei0r\fR را در مستندات فیلترهای ویدیو
مطالعه فرمایید.
.IP \fBfilter_params\fR 4
.IX Item "filter_params"
فهرستی از پارامترهای جداشده با \*(Aq|\*(Aq جهت ارسال به سورس frei0r.
.PP
برای مثال، جهت تولید یک سورس partik0l از نوع frei0r با اندازه 200x200
و نرخ فریم 10 که روی ورودی اصلی فیلتر overlay هم‌پوشانی می‌شود:
.PP
.Vb 1
\&        frei0r_src=size=200x200:framerate=10:filter_name=partik0l:filter_params=1234 [overlay]; [in][overlay] overlay
.Ve
.SS life
.IX Subsection "life"
تولید الگوی زندگی (life pattern).
.PP
این سورس بر پایه تعمیمی از بازی زندگی جان کانوی (John Conway) است.
.PP
ورودی سورس نشان‌دهنده یک شبکه زندگی است؛ هر پیکسل نشان‌دهنده یک سلول
است که می‌تواند در یکی از دو وضعیت ممکن، زنده یا مرده باشد. هر سلول
با هشت همسایه خود که سلول‌های مجاور افقی، عمودی یا مورب هستند،
تعامل دارد.
.PP
در هر تعامل، شبکه با توجه به قاعده اتخاذشده تکامل می‌یابد،
که تعداد سلول‌های زنده همسایه‌ای را که باعث زنده ماندن
یا متولد شدن یک سلول می‌شوند، مشخص می‌کند. گزینه \fBrule\fR امکان می‌دهد
قاعده مورد نظر را مشخص کنید.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBfilename, f\fR" 4
.IX Item "filename, f"
تعیین پرونده‌ای که وضعیت اولیه شبکه از آن خوانده می‌شود. در پرونده،
هر نویسه غیر از فاصله خالی به عنوان یک سلول زنده در نظر گرفته می‌شود، و خط جدید
برای تعیین انتهای هر سطر استفاده می‌شود.
.Sp
اگر این گزینه مشخص نشود، شبکه اولیه به صورت تصادفی
تولید می‌شود.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ ویدیو، یعنی تعداد فریم‌های تولیدشده در هر ثانیه.
پیش‌فرض 25 است.
.IP "\fBrandom_fill_ratio, ratio\fR" 4
.IX Item "random_fill_ratio, ratio"
تنظیم نسبت پر کردن تصادفی برای شبکه تصادفی اولیه. این یک
مقدار عددی اعشاری در محدوده 0 تا 1 است و پیش‌فرض آن 1/PHI می‌باشد.
هنگامی که پرونده‌ای مشخص شود، این گزینه نادیده گرفته می‌شود.
.IP "\fBrandom_seed, seed\fR" 4
.IX Item "random_seed, seed"
تنظیم بذر تصادفی برای پر کردن شبکه تصادفی اولیه؛ باید یک عدد صحیح
بین 0 و UINT32_MAX باشد. در صورت عدم تعیین، یا در صورت تنظیم صریح
روی \-1، فیلتر سعی خواهد کرد بر پایه بهترین تلاش از یک بذر تصادفی مناسب استفاده کند.
.IP \fBrule\fR 4
.IX Item "rule"
تنظیم قاعده زندگی (life rule).
.Sp
یک قاعده را می‌توان با کدی از نوع "S\fINS\fR/B\fINB\fR" مشخص کرد،
که در آن \fINS\fR و \fINB\fR دنباله‌هایی از اعداد در محدوده 0\-8 هستند،
\&\fINS\fR تعداد سلول‌های زنده همسایه را مشخص می‌کند که باعث زنده ماندن
یک سلول زنده می‌شوند، و \fINB\fR تعداد سلول‌های زنده همسایه را که باعث
زنده شدن یک سلول مرده می‌شوند (یعنی «متولد شدن»).
می‌توان از "s" و "b" به جای "S" و "B" استفاده کرد.
.Sp
به عنوان روشی دیگر، یک قاعده را می‌توان با یک عدد صحیح ۱۸ بیتی مشخص کرد. ۹
بیت مرتبه بالا برای رمزگذاری وضعیت سلول بعدی در صورت زنده بودن
به ازای هر تعداد سلول زنده همسایه استفاده می‌شود، و بیت‌های مرتبه پایین قاعده
«متولد شدن» سلول‌های جدید را مشخص می‌کنند. بیت‌های مرتبه بالاتر تعداد
بیشتری از سلول‌های همسایه را رمزگذاری می‌کنند.
برای مثال عدد 6153 = \f(CW\*(C`(12<<9)+9\*(C'\fR یک قاعده زنده ماندن
12 و یک قاعده تولد 9 را تعیین می‌کند، که متناظر با "S23/B03" است.
.Sp
مقدار پیش‌فرض "S23/B3" است، که همان قاعده اصلی بازی زندگی کانوی
است، و اگر سلول دارای ۲ یا ۳ سلول زنده همسایه باشد آن را زنده نگه
می‌دارد، و در صورتی که سه سلول زنده در اطراف یک سلول مرده وجود داشته باشد
یک سلول جدید متولد خواهد کرد.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیوی خروجی. برای ساختار نحوی این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.Sp
اگر \fBfilename\fR مشخص شود، اندازه به طور پیش‌فرض روی همان
اندازه پرونده ورودی تنظیم می‌شود. اگر \fBsize\fR تنظیم شود، باید شامل
اندازه مشخص‌شده در پرونده ورودی باشد، و شبکه اولیه تعریف‌شده در
آن پرونده در مرکز ناحیه حاصل بزرگ‌تر قرار خواهد گرفت.
.Sp
اگر نام پرونده مشخص نشود، مقدار اندازه به طور پیش‌فرض "320x240" خواهد بود
(که برای یک شبکه اولیه تصادفی تولیدشده استفاده می‌شود).
.IP \fBstitch\fR 4
.IX Item "stitch"
اگر روی 1 تنظیم شود، لبه‌های چپ و راست شبکه را به یکدیگر وصل می‌کند، و لبه‌های
بالا و پایین را نیز همین‌طور. پیش‌فرض 1 است.
.IP \fBmold\fR 4
.IX Item "mold"
تنظیم سرعت کپک زدن سلول. در صورت تنظیم، یک سلول مرده با گام \fBmold\fR از رنگ \fBdeath_color\fR به
\&\fBmold_color\fR تغییر وضعیت می‌دهد. \fBmold\fR می‌تواند
مقداری از 0 تا 255 داشته باشد.
.IP \fBlife_color\fR 4
.IX Item "life_color"
تنظیم رنگ سلول‌های زنده (یا تازه متولدشده).
.IP \fBdeath_color\fR 4
.IX Item "death_color"
تنظیم رنگ سلول‌های مرده. اگر \fBmold\fR تنظیم شده باشد، این نخستین رنگی است
که برای بازنمایی یک سلول مرده استفاده می‌شود.
.IP \fBmold_color\fR 4
.IX Item "mold_color"
تنظیم رنگ کپک، برای سلول‌های قطعاً مرده و کپک‌زده.
.Sp
برای ساختار نحوی این ۳ گزینه رنگ، بخش \fB"Color" در
راهنمای ffmpeg\-utils\fR را بررسی کنید.
.PP
\fIExamples\fR
.IX Subsection "Examples"
.IP \(bu 4
خواندن یک شبکه از \fIpattern\fR، و قرار دادن آن در مرکز یک شبکه با اندازه
300x300 پیکسل:
.Sp
.Vb 1
\&        life=f=pattern:s=300x300
.Ve
.IP \(bu 4
تولید یک شبکه تصادفی با اندازه 200x200، با نسبت پر کردن ۲/۳:
.Sp
.Vb 1
\&        life=ratio=2/3:s=200x200
.Ve
.IP \(bu 4
تعیین یک قاعده سفارشی برای تکامل یک شبکه تصادفی تولیدشده:
.Sp
.Vb 1
\&        life=rule=S14/B34
.Ve
.IP \(bu 4
مثال کامل با جلوه مرگ تدریجی (کپک) با استفاده از \fBffplay\fR:
.Sp
.Vb 1
\&        ffplay \-f lavfi life=s=300x200:mold=10:r=60:ratio=0.1:death_color=#C83232:life_color=#00ff00,scale=1200:800:flags=16
.Ve
.SS perlin
.IX Subsection "perlin"
تولید نویز پرلین (Perlin noise).
.PP
نویز پرلین نوعی نویز با پیوستگی محلی در فضا است. از این نویز می‌توان برای ایجاد الگوهایی با پیوستگی در فضا و زمان استفاده کرد، به عنوان مثال برای شبیه‌سازی دود، سیالات یا عوارض زمین (terrain).
.PP
در صورتی که از طریق گزینه \fBoctaves\fR بیش از یک اکتاو تعیین شود، نویز پرلین به عنوان مجموعی از مؤلفه‌ها تولید می‌شود که فرکانس هر یک دو برابر مؤلفه قبلی است. در این حالت، گزینه \fBpersistence\fR نسبت دامنه را نسبت به مؤلفه قبلی مشخص می‌کند. مؤلفه‌های اکتاو بیشتر امکان تعیین جزئیات فرکانس بالای بیشتری را در نویز تولیدشده فراهم می‌سازند (به عنوان مثال تغییرات کوچک ناشی از تخته‌سنگ‌ها در یک عارضه زمین تولیدشده).
.PP
\fIگزینه‌ها\fR
.IX Subsection "Options"
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
اندازه (عرض و ارتفاع) فریم‌های ویدیویی بافرشده را مشخص می‌کند. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`320x240\*(C'\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
نرخ فریم مورد انتظار برای استریم ویدیو را بر حسب تعداد فریم در ثانیه مشخص می‌کند. مقدار پیش‌فرض \f(CW25\fR است.
.IP \fBoctaves\fR 4
.IX Item "octaves"
تعداد کل مؤلفه‌های تشکیل‌دهنده نویز را مشخص می‌کند که فرکانس هر یک دو برابر مؤلفه قبلی است. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBpersistence\fR 4
.IX Item "persistence"
نسبت مورد استفاده برای محاسبه دامنه مؤلفه اکتاو بعدی نسبت به دامنه مؤلفه قبلی را تنظیم می‌کند. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBxscale\fR 4
.IX Item "xscale"
.PD 0
.IP \fByscale\fR 4
.IX Item "yscale"
.PD
یک ضریب مقیاس‌بندی مورد استفاده برای ضرب در مختصات x و y را تعریف می‌کند. این می‌تواند برای تعریف اثری با الگوی کشیده‌شده در امتداد محور x یا y مفید باشد. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBtscale\fR 4
.IX Item "tscale"
یک ضریب مقیاس‌بندی مورد استفاده برای ضرب در مختصات زمان را تعریف می‌کند. این می‌تواند برای تغییر سرعت تغییرات زمانی مفید باشد. مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBrandom_mode\fR 4
.IX Item "random_mode"
حالت تصادفی مورد استفاده برای محاسبه الگوی اولیه را تنظیم می‌کند.
.Sp
مقادیر پشتیبانی‌شده عبارتند از:
.RS 4
.IP \fBrandom\fR 4
.IX Item "random"
محاسبه و استفاده از سید (seed) تصادفی.
.IP \fBken\fR 4
.IX Item "ken"
استفاده از الگوی اولیه پیش‌تعریف‌شده توسط کن پرلین در مقاله اصلی؛ می‌تواند برای مقایسه خروجی با سایر سورس‌ها مفید باشد.
.IP \fBseed\fR 4
.IX Item "seed"
استفاده از مقدار مشخص‌شده توسط گزینه \fBrandom_seed\fR.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`random\*(C'\fR است.
.RE
.IP "\fBrandom_seed, seed\fR" 4
.IX Item "random_seed, seed"
هنگامی که \fBrandom_mode\fR روی \fIrandom_seed\fR تنظیم شده باشد، از این مقدار برای محاسبه الگوی اولیه استفاده می‌کند. مقدار پیش‌فرض \f(CW0\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک مؤلفه منفرد:
.Sp
.Vb 1
\&        perlin
.Ve
.IP \(bu 4
استفاده از نویز پرلین با 7 مؤلفه، که هر یک سهم نصف‌شده‌ای در دامنه کل دارند:
.Sp
.Vb 1
\&        perlin=octaves=7:persistence=0.5
.Ve
.IP \(bu 4
زنجیر کردن نویز پرلین با \fBlutyuv\fR برای تولید اثر سیاه‌وسفید:
.Sp
.Vb 1
\&        perlin=octaves=3:tscale=0.3,lutyuv=y=\*(Aqif(lt(val\e,128)\e,255\e,0)\*(Aq
.Ve
.IP \(bu 4
کشیدن نویز در امتداد محور y و تبدیل سطح خاکستری به سیگنال فقط قرمز:
.Sp
.Vb 1
\&        perlin=octaves=7:tscale=0.4:yscale=0.3,lutrgb=r=val:b=0:g=0
.Ve
.SS qrencodesrc
.IX Subsection "qrencodesrc"
تولید یک کد QR با استفاده از کتابخانه libqrencode (به
<\fBhttps://fukuchi.org/works/qrencode\fR> مراجعه کنید).
.PP
برای فعال‌سازی کامپایل این سورس، باید FFmpeg را با
\&\f(CW\*(C`\-\-enable\-libqrencode\*(C'\fR پیکربندی کنید.
.PP
کد QR از متن یا الگوی متنی ارائه‌شده تولید می‌شود. کد QR متناظر بر اساس گزینه‌های اندازه خروجی مشخص‌شده، مقیاس‌بندی شده و در خروجی ویدیو قرار می‌گیرد.
.PP
در صورتی که هیچ متنی مشخص نشود، کد QR تولید نمی‌شود، بلکه یک خروجی رنگی خالی برگردانده می‌شود.
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBqrcode_width, q\fR" 4
.IX Item "qrcode_width, q"
.PD 0
.IP "\fBpadded_qrcode_width, Q\fR" 4
.IX Item "padded_qrcode_width, Q"
.PD
یک عبارت برای عرض کد QR رندرشده، با و بدون پدینگ (فاصله‌گذاری) مشخص می‌کند. عبارت \fIqrcode_width\fR می‌تواند به مقدار تنظیم‌شده توسط عبارت
\&\fIpadded_qrcode_width\fR ارجاع دهد و برعکس.
به طور پیش‌فرض \fIpadded_qrcode_width\fR روی \fIqrcode_width\fR تنظیم شده است، به این معنی که هیچ پدینگی وجود ندارد.
.Sp
این عبارات فقط یک بار، هنگام مقداردهی اولیه سورس ارزیابی می‌شوند.
برای جزئیات به بخش \fBعبارات qrencode\fR مراجعه کنید.
.Sp
توجه داشته باشید که برخی از ثوابت برای این سورس وجود ندارند (برای مثال
\&\fIx\fR یا \fIt\fR یا \fIn\fR)، زیرا آنها فقط هنگام ارزیابی عبارت برای هر فریم معنا دارند نه در زمان مقداردهی اولیه.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
نرخ فریم ویدیوی سورس را به صورت تعداد فریم‌های تولیدشده در ثانیه مشخص می‌کند. این مقدار باید یک رشته در قالب
\&\fIframe_rate_num\fR/\fIframe_rate_den\fR، یک عدد صحیح، یک عدد ممیز شناور یا یک اختصار معتبر نرخ فریم ویدیو باشد. مقدار پیش‌فرض
"25" است.
.IP "\fBcase_sensitive, cs\fR" 4
.IX Item "case_sensitive, cs"
به libqrencode دستور می‌دهد تا از کدگذاری حساس به حروف بزرگ و کوچک استفاده کند. این گزینه به طور پیش‌فرض فعال است. برای کاهش اندازه کدگذاری QR می‌توان آن را غیرفعال کرد.
.IP "\fBlevel, l\fR" 4
.IX Item "level, l"
سطح تصحیح خطای کدگذاری QR را مشخص می‌کند. با سطح تصحیح بالاتر، اندازه کدگذاری افزایش می‌یابد اما کد در برابر خرابی مقاوم‌تر خواهد بود.
سطح پایین‌تر \fIL\fR است.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBL\fR 4
.IX Item "L"
.PD 0
.IP \fBM\fR 4
.IX Item "M"
.IP \fBQ\fR 4
.IX Item "Q"
.IP \fBH\fR 4
.IX Item "H"
.PD
.RE
.RS 4
.RE
.IP \fBexpansion\fR 4
.IX Item "expansion"
نحوه بسط دادن متن ورودی را انتخاب می‌کند. می‌تواند \f(CW\*(C`none\*(C'\fR یا
\&\f(CW\*(C`normal\*(C'\fR (پیش‌فرض) باشد. برای جزئیات به بخش \fBبسط متن qrencode\fR مراجعه کنید.
.IP \fBtext\fR 4
.IX Item "text"
.PD 0
.IP \fBtextfile\fR 4
.IX Item "textfile"
.PD
متنی را که باید رندر شود تعریف می‌کند. در صورتی که هیچ‌یک مشخص نشود، هیچ کدی انکود نمی‌شود (صرفاً یک فریم رنگی خالی).
.Sp
در صورتی که بسط فعال باشد، با متن مانند یک الگوی متنی با استفاده از سازوکار بسط qrencode رفتار می‌شود. برای جزئیات به بخش \fBبسط متن qrencode\fR مراجعه کنید.
.IP "\fBbackground_color, bc\fR" 4
.IX Item "background_color, bc"
.PD 0
.IP "\fBforeground_color, fc\fR" 4
.IX Item "foreground_color, fc"
.PD
رنگ کد QR و رنگ پس‌زمینه را تنظیم می‌کند. مقدار پیش‌فرض
\&\fIforeground_color\fR برابر با "black" و مقدار پیش‌فرض \fIbackground_color\fR
برابر با "white" است.
.Sp
برای سینتکس گزینه‌های رنگ، بخش \fB"رنگ" (Color) در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک کد QR که متن مشخص‌شده را با اندازه پیش‌فرض کدگذاری می‌کند:
.Sp
.Vb 1
\&        qrencodesrc=text=www.ffmpeg.org
.Ve
.IP \(bu 4
همانند مورد قبل، اما با انتخاب رنگ آبی روی صورتی:
.Sp
.Vb 1
\&        qrencodesrc=text=www.ffmpeg.org:bc=pink:fc=blue
.Ve
.IP \(bu 4
تولید یک کد QR با عرض 200 پیکسل و پدینگ، به طوری که عرض پدینگ‌شده 4/3 عرض کد QR باشد:
.Sp
.Vb 1
\&        qrencodesrc=text=www.ffmpeg.org:q=200:Q=4/3*q
.Ve
.IP \(bu 4
تولید یک کد QR با عرض پدینگ‌شده 200 پیکسل و پدینگ، به طوری که عرض کد QR برابر 3/4 عرض پدینگ‌شده باشد:
.Sp
.Vb 1
\&        qrencodesrc=text=www.ffmpeg.org:Q=200:q=3/4*Q
.Ve
.IP \(bu 4
تولید یک کد QR که شماره فریم را کدگذاری می‌کند:
.Sp
.Vb 1
\&        qrencodesrc=text=%{n}
.Ve
.IP \(bu 4
تولید یک کد QR که برچسب زمانی GMT را کدگذاری می‌کند:
.Sp
.Vb 1
\&        qrencodesrc=text=%{gmtime}
.Ve
.IP \(bu 4
تولید یک کد QR که برچسب زمانی را به صورت عدد ممیز شناور کدگذاری می‌کند:
.Sp
.Vb 1
\&        qrencodesrc=text=%{pts}
.Ve
.SS "allrgb, allyuv, color, colorchart, colorspectrum, haldclutsrc, nullsrc, pal75bars, pal100bars, rgbtestsrc, smptebars, smptehdbars, testsrc, testsrc2, yuvtestsrc"
.IX Subsection "allrgb, allyuv, color, colorchart, colorspectrum, haldclutsrc, nullsrc, pal75bars, pal100bars, rgbtestsrc, smptebars, smptehdbars, testsrc, testsrc2, yuvtestsrc"
سورس \f(CW\*(C`allrgb\*(C'\fR فریم‌هایی به اندازه 4096x4096 از تمام رنگ‌های rgb را برمی‌گرداند.
.PP
سورس \f(CW\*(C`allyuv\*(C'\fR فریم‌هایی به اندازه 4096x4096 از تمام رنگ‌های yuv را برمی‌گرداند.
.PP
سورس \f(CW\*(C`color\*(C'\fR یک ورودی با رنگ یکنواخت ارائه می‌دهد.
.PP
سورس \f(CW\*(C`colorchart\*(C'\fR یک جدول تست رنگ (color checker chart) ارائه می‌دهد.
.PP
سورس \f(CW\*(C`colorspectrum\*(C'\fR یک ورودی طیف رنگی ارائه می‌دهد.
.PP
سورس \f(CW\*(C`haldclutsrc\*(C'\fR یک جدول تطبیق رنگ همانی Hald CLUT ارائه می‌دهد. همچنین فیلتر
\&\fBhaldclut\fR را ببینید.
.PP
سورس \f(CW\*(C`nullsrc\*(C'\fR فریم‌های ویدیویی پردازش‌نشده را برمی‌گرداند. این سورس عمدتاً برای استفاده در ابزارهای تحلیل / خطایابی، یا به عنوان سورسی برای فیلترهایی که داده‌های ورودی را نادیده می‌گیرند، مفید است.
.PP
سورس \f(CW\*(C`pal75bars\*(C'\fR یک الگوی میله‌های رنگی را بر اساس توصیه‌های EBU PAL با سطوح رنگی 75% تولید می‌کند.
.PP
سورس \f(CW\*(C`pal100bars\*(C'\fR یک الگوی میله‌های رنگی را بر اساس توصیه‌های EBU PAL با سطوح رنگی 100% تولید می‌کند.
.PP
سورس \f(CW\*(C`rgbtestsrc\*(C'\fR یک الگوی آزمایشی RGB تولید می‌کند که برای تشخیص مشکلات RGB در برابر BGR مفید است. شما باید یک نوار قرمز، سبز و آبی را از بالا به پایین مشاهده کنید.
.PP
سورس \f(CW\*(C`smptebars\*(C'\fR یک الگوی میله‌های رنگی را بر اساس راهنمای مهندسی SMPTE EG 1\-1990 تولید می‌کند.
.PP
سورس \f(CW\*(C`smptehdbars\*(C'\fR یک الگوی میله‌های رنگی را بر اساس SMPTE RP 219\-2002 تولید می‌کند.
.PP
سورس \f(CW\*(C`testsrc\*(C'\fR یک الگوی ویدیویی آزمایشی تولید می‌کند که یک الگوی رنگی، یک گرادیان متحرک و یک برچسب زمانی را نشان می‌دهد. این سورس عمدتاً برای اهداف آزمایشی در نظر گرفته شده است.
.PP
سورس \f(CW\*(C`testsrc2\*(C'\fR شبیه به testsrc است، اما به جای فقط \f(CW\*(C`rgb24\*(C'\fR از فرمت‌های پیکسلی بیشتری پشتیبانی می‌کند. این ویژگی امکان استفاده از آن را به عنوان ورودی برای سایر آزمایش‌ها بدون نیاز به تبدیل فرمت فراهم می‌سازد.
.PP
سورس \f(CW\*(C`yuvtestsrc\*(C'\fR یک الگوی آزمایشی YUV تولید می‌کند. شما باید یک نوار y، cb و cr را از بالا به پایین مشاهده کنید.
.PP
این سورس‌ها پارامترهای زیر را می‌پذیرند:
.IP \fBlevel\fR 4
.IX Item "level"
سطح Hald CLUT را مشخص می‌کند، تنها در سورس \f(CW\*(C`haldclutsrc\*(C'\fR در دسترس است. سطح \f(CW\*(C`N\*(C'\fR تصویری به ابعاد \f(CW\*(C`N*N*N\*(C'\fR در \f(CW\*(C`N*N*N\*(C'\fR پیکسل تولید می‌کند تا به عنوان ماتریس همانی برای جدول‌های جستجوی سه‌بعدی (3D lookup tables) استفاده شود. هر مؤلفه در مقیاس \f(CW\*(C`1/(N*N)\*(C'\fR کدگذاری می‌شود.
.IP "\fBcolor, c\fR" 4
.IX Item "color, c"
رنگ سورس را مشخص می‌کند، تنها در سورس \f(CW\*(C`color\*(C'\fR در دسترس است. برای سینتکس این گزینه، بخش
\&\fB"Color" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
اندازه ویدیوی سورس را مشخص می‌کند. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`320x240\*(C'\fR است.
.Sp
این گزینه در فیلترهای \f(CW\*(C`allrgb\*(C'\fR، \f(CW\*(C`allyuv\*(C'\fR و
\&\f(CW\*(C`haldclutsrc\*(C'\fR در دسترس نیست.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
نرخ فریم ویدیوی سورس را به عنوان تعداد فریم‌های تولیدشده در ثانیه مشخص می‌کند. این مقدار باید رشته‌ای در قالب
\&\fIframe_rate_num\fR/\fIframe_rate_den\fR، یک عدد صحیح، یک عدد ممیز شناور یا یک اختصار معتبر نرخ فریم ویدیو باشد. مقدار پیش‌فرض
"25" است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
مدت‌زمان ویدیوی سورس را تنظیم می‌کند. برای سینتکس پذیرفته‌شده به
\&\fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.Sp
اگر مشخص نشود یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود که ویدیو برای همیشه تولید خواهد شد.
.Sp
از آنجا که نرخ فریم به عنوان پایه زمانی (time base) استفاده می‌شود، تمام فریم‌ها از جمله آخرین فریم دارای مدت‌زمان کامل خود خواهند بود. اگر مدت‌زمان مشخص‌شده مضربی از مدت‌زمان فریم نباشد، به بالا گرد خواهد شد.
.IP \fBsar\fR 4
.IX Item "sar"
نسبت ابعاد نمونه (sample aspect ratio) ویدیوی سورس را تنظیم می‌کند.
.IP \fBalpha\fR 4
.IX Item "alpha"
آلفا (کدر بودن) پس‌زمینه را مشخص می‌کند، تنها در سورس
\&\f(CW\*(C`testsrc2\*(C'\fR در دسترس است. مقدار باید بین 0 (کاملاً شفاف) و
255 (کاملاً کدر، حالت پیش‌فرض) باشد.
.IP "\fBdecimals, n\fR" 4
.IX Item "decimals, n"
تعداد ارقام اعشار برای نمایش در برچسب زمانی را تنظیم می‌کند، تنها در سورس
\&\f(CW\*(C`testsrc\*(C'\fR در دسترس است.
.Sp
مقدار برچسب زمانی نمایش‌داده‌شده متناظر با مقدار برچسب زمانی اصلی
ضرب در توان ۱۰ مقدار مشخص‌شده خواهد بود. مقدار پیش‌فرض 0 است.
.IP \fBtype\fR 4
.IX Item "type"
نوع طیف رنگی را مشخص می‌کند، تنها در سورس
\&\f(CW\*(C`colorspectrum\*(C'\fR در دسترس است. می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBblack\fR 4
.IX Item "black"
.PD 0
.IP \fBwhite\fR 4
.IX Item "white"
.IP \fBall\fR 4
.IX Item "all"
.PD
.RE
.RS 4
.RE
.IP \fBpatch_size\fR 4
.IX Item "patch_size"
اندازه وصله رنگی (color patch) منفرد را تنظیم می‌کند، تنها در سورس
\&\f(CW\*(C`colorchart\*(C'\fR در دسترس است. مقدار پیش‌فرض \f(CW\*(C`64x64\*(C'\fR است.
.IP \fBpreset\fR 4
.IX Item "preset"
پیش‌تنظیم رنگ‌های جدول تست رنگ را تنظیم می‌کند، تنها در سورس
\&\f(CW\*(C`colorchart\*(C'\fR در دسترس است.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBreference\fR 4
.IX Item "reference"
.PD 0
.IP \fBskintones\fR 4
.IX Item "skintones"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`reference\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید یک ویدیو با مدت‌زمان 5.3 ثانیه، با اندازه
176x144 و نرخ فریم 10 فریم در ثانیه:
.Sp
.Vb 1
\&        testsrc=duration=5.3:size=qcif:rate=10
.Ve
.IP \(bu 4
توصیف گراف زیر یک سورس قرمز با میزان کدر بودن 0.2، با اندازه "qcif" و نرخ فریم 10
فریم در ثانیه تولید می‌کند:
.Sp
.Vb 1
\&        color=c=red@0.2:s=qcif:r=10
.Ve
.IP \(bu 4
اگر قرار است محتوای ورودی نادیده گرفته شود، می‌توان از \f(CW\*(C`nullsrc\*(C'\fR استفاده کرد. دستور زیر با به‌کارگیری فیلتر \f(CW\*(C`geq\*(C'\fR در صفحه لوما نویز تولید می‌کند:
.Sp
.Vb 1
\&        nullsrc=s=256x256, geq=random(1)*255:128:128
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
سورس \f(CW\*(C`color\*(C'\fR از دستورات زیر پشتیبانی می‌کند:
.IP "\fBc, color\fR" 4
.IX Item "c, color"
تنظیم رنگ تصویر ایجادشده. از همان سینتکس گزینه \fBcolor\fR متناظر پیروی می‌کند.
.SS openclsrc
.IX Subsection "openclsrc"
تولید ویدیو با استفاده از یک برنامه OpenCL.
.IP \fBsource\fR 4
.IX Item "source"
پرونده سورس برنامه OpenCL.
.IP \fBkernel\fR 4
.IX Item "kernel"
نام کرنل در برنامه.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
اندازه فریم‌های تولیدی. این مقدار باید تنظیم شود.
.IP \fBformat\fR 4
.IX Item "format"
فرمت پیکسلی مورد استفاده برای فریم‌های تولیدی. این مقدار باید تنظیم شود.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تعداد فریم‌های تولیدشده در هر ثانیه. مقدار پیش‌فرض \*(Aq25\*(Aq است.
.PP
برای جزئیات نحوه بارگذاری برنامه، فیلتر \fBprogram_opencl\fR را ببینید.
.PP
برنامه‌های نمونه:
.IP \(bu 4
تولید شیب رنگی با تنظیم مقادیر پیکسل بر اساس موقعیت پیکسل در تصویر خروجی. (توجه داشته باشید که این با تمام فرمت‌های پیکسلی کار خواهد کرد، اما خروجی تولیدشده یکسان نخواهد بود.)
.Sp
.Vb 4
\&        __kernel void ramp(__write_only image2d_t dst,
\&                           unsigned int index)
\&        {
\&            int2 loc = (int2)(get_global_id(0), get_global_id(1));
\&        
\&            float4 val;
\&            val.xy = val.zw = convert_float2(loc) / convert_float2(get_image_dim(dst));
\&        
\&            write_imagef(dst, loc, val);
\&        }
.Ve
.IP \(bu 4
تولید الگوی فرش سرپینسکی، با پیمایش (pan) به اندازه یک پیکسل در هر فریم.
.Sp
.Vb 4
\&        __kernel void sierpinski_carpet(__write_only image2d_t dst,
\&                                        unsigned int index)
\&        {
\&            int2 loc = (int2)(get_global_id(0), get_global_id(1));
\&        
\&            float4 value = 0.0f;
\&            int x = loc.x + index;
\&            int y = loc.y + index;
\&            while (x > 0 || y > 0) {
\&                if (x % 3 == 1 && y % 3 == 1) {
\&                    value = 1.0f;
\&                    break;
\&                }
\&                x /= 3;
\&                y /= 3;
\&            }
\&        
\&            write_imagef(dst, loc, value);
\&        }
.Ve
.SS sierpinski
.IX Subsection "sierpinski"
تولید فراکتال فرش/مثلث سرپینسکی، و حرکت تصادفی به اطراف (pan).
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه فریم. برای سینتکس این گزینه، بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید. مقدار پیش‌فرض "640x480" است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بر حسب تعداد فریم در ثانیه. مقدار پیش‌فرض "25" است.
.IP \fBseed\fR 4
.IX Item "seed"
تنظیم سید (seed) که برای حرکت تصادفی استفاده می‌شود.
.IP \fBjump\fR 4
.IX Item "jump"
تنظیم حداکثر جهش برای یک مقصد منفرد در پیمایش. محدوده مجاز از 1 تا 10000 است.
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع فراکتال، می‌تواند مقدار پیش‌فرض \f(CW\*(C`carpet\*(C'\fR یا \f(CW\*(C`triangle\*(C'\fR باشد.
.SS zoneplate
.IX Subsection "zoneplate"
تولید یک الگوی ویدیویی آزمایشی صفحه ناحیه‌ای (zoneplate).
.PP
این سورس گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه فریم. برای سینتکس این گزینه، بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید. مقدار پیش‌فرض "320x240" است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بر حسب تعداد فریم در ثانیه. مقدار پیش‌فرض "25" است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان ویدیوی سورس. برای سینتکس پذیرفته‌شده به
\&\fBبخش Time duration در راهنمای ffmpeg\-utils\|(1)\fR
مراجعه کنید.
.Sp
اگر مشخص نشود یا مدت‌زمان بیان‌شده منفی باشد، فرض می‌شود که ویدیو برای همیشه تولید خواهد شد.
.IP \fBsar\fR 4
.IX Item "sar"
تنظیم نسبت ابعاد نمونه (sample aspect ratio) ویدیوی سورس.
.IP \fBprecision\fR 4
.IX Item "precision"
تنظیم دقت بر حسب بیت برای جدول جستجوی محاسبات سینوسی. مقدار پیش‌فرض 10 است. محدوده مجاز از 4 تا 16 است.
.IP \fBxo\fR 4
.IX Item "xo"
تنظیم آفست محور افقی برای سیگنال خروجی. مقدار پیش‌فرض 0 است.
.IP \fByo\fR 4
.IX Item "yo"
تنظیم آفست محور عمودی برای سیگنال خروجی. مقدار پیش‌فرض 0 است.
.IP \fBto\fR 4
.IX Item "to"
تنظیم آفست محور زمان برای سیگنال خروجی. مقدار پیش‌فرض 0 است.
.IP \fBk0\fR 4
.IX Item "k0"
تنظیم مرتبه 0، مقدار ثابت اضافه‌شده به فاز سیگنال. مقدار پیش‌فرض 0 است.
.IP \fBkx\fR 4
.IX Item "kx"
تنظیم مرتبه 1، ضریب فاز برای محور افقی. مقدار پیش‌فرض 0 است.
.IP \fBky\fR 4
.IX Item "ky"
تنظیم مرتبه 1، ضریب فاز برای محور عمودی. مقدار پیش‌فرض 0 است.
.IP \fBkt\fR 4
.IX Item "kt"
تنظیم مرتبه 1، ضریب فاز برای محور زمان. مقدار پیش‌فرض 0 است.
.IP "\fBkxt, kyt, kxy\fR" 4
.IX Item "kxt, kyt, kxy"
تنظیم ضریب‌های فاز برای ترکیب محورهای مکانی و زمانی. مقدار پیش‌فرض 0 است.
.IP \fBkx2\fR 4
.IX Item "kx2"
تنظیم مرتبه 2، ضریب فاز برای محور افقی. مقدار پیش‌فرض 0 است.
.IP \fBky2\fR 4
.IX Item "ky2"
تنظیم مرتبه 2، ضریب فاز برای محور عمودی. مقدار پیش‌فرض 0 است.
.IP \fBkt2\fR 4
.IX Item "kt2"
تنظیم مرتبه 2، ضریب فاز برای محور زمان. مقدار پیش‌فرض 0 است.
.IP \fBku\fR 4
.IX Item "ku"
تنظیم مقدار ثابت اضافه‌شده به فاز نهایی برای تولید مؤلفه کروما-آبی (chroma-blue) سیگنال. مقدار پیش‌فرض 0 است.
.IP \fBkv\fR 4
.IX Item "kv"
تنظیم مقدار ثابت اضافه‌شده به فاز نهایی برای تولید مؤلفه کروما-قرمز (chroma-red) سیگنال. مقدار پیش‌فرض 0 است.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این سورس از برخی گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تولید روبش سینوسی رنگی افقی:
.Sp
.Vb 1
\&        zoneplate=ku=512:kv=0:kt2=0:kx2=256:s=wvga:xo=\-426:kt=11
.Ve
.IP \(bu 4
تولید روبش سینوسی رنگی عمودی:
.Sp
.Vb 1
\&        zoneplate=ku=512:kv=0:kt2=0:ky2=156:s=wvga:yo=\-240:kt=11
.Ve
.IP \(bu 4
تولید صفحه ناحیه‌ای دایره‌ای:
.Sp
.Vb 1
\&        zoneplate=ku=512:kv=100:kt2=0:ky2=256:kx2=556:s=wvga:yo=0:kt=11
.Ve
.SH "سینک‌های ویدیویی (VIDEO SINKS)"
.IX Header "VIDEO SINKS"
در ادامه توصیف سینک‌های ویدیویی در دسترس ارائه شده است.
.SS buffersink
.IX Subsection "buffersink"
فریم‌های ویدیویی را بافر می‌کند و آن‌ها را در انتهای گراف فیلتر در دسترس قرار می‌دهد.
.PP
این سینک عمدتاً برای استفاده برنامه‌نویسی در نظر گرفته شده است، به‌ویژه از طریق رابط کاربری تعریف‌شده در \fIlibavfilter/buffersink.h\fR یا سیستم گزینه‌ها.
.PP
این فیلتر یک اشاره‌گر به ساختار AVBufferSinkContext را می‌پذیرد که فرمت‌های بافرهای ورودی را تعریف می‌کند، تا به عنوان پارامتر مبهم (opaque) برای مقداردهی اولیه به \f(CW\*(C`avfilter_init_filter\*(C'\fR ارسال شود.
.SS nullsink
.IX Subsection "nullsink"
سینک ویدیویی تهی: مطلقاً هیچ کاری با ویدیوی ورودی انجام نمی‌دهد. این سینک عمدتاً به عنوان یک الگو و برای استفاده در ابزارهای تحلیل / خطایابی مفید است.
.SH "فیلترهای چندرسانه‌ای (MULTIMEDIA FILTERS)"
.IX Header "MULTIMEDIA FILTERS"
در ادامه توصیف فیلترهای چندرسانه‌ای در دسترس ارائه شده است.
.SS a3dscope
.IX Subsection "a3dscope"
تبدیل صدای ورودی به خروجی ویدیویی اسکوپ سه‌بعدی (3d scope).
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بر حسب تعداد فریم در ثانیه. مقدار پیش‌فرض
"25" است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`hd720\*(C'\fR است.
.IP \fBfov\fR 4
.IX Item "fov"
تنظیم میدان دید (field of view) دوربین. پیش‌فرض 90 درجه است.
محدوده مجاز از 40 تا 150 است.
.IP \fBroll\fR 4
.IX Item "roll"
تنظیم زاویه رول (roll) دوربین.
.IP \fBpitch\fR 4
.IX Item "pitch"
تنظیم زاویه پیچ (pitch) دوربین.
.IP \fByaw\fR 4
.IX Item "yaw"
تنظیم زاویه یاو (yaw) دوربین.
.IP \fBxzoom\fR 4
.IX Item "xzoom"
تنظیم بزرگ‌نمایی دوربین در محور X.
.IP \fByzoom\fR 4
.IX Item "yzoom"
تنظیم بزرگ‌نمایی دوربین در محور Y.
.IP \fBzzoom\fR 4
.IX Item "zzoom"
تنظیم بزرگ‌نمایی دوربین در محور Z.
.IP \fBxpos\fR 4
.IX Item "xpos"
تنظیم موقعیت دوربین در محور X.
.IP \fBypos\fR 4
.IX Item "ypos"
تنظیم موقعیت دوربین در محور Y.
.IP \fBzpos\fR 4
.IX Item "zpos"
تنظیم موقعیت دوربین در محور Z.
.IP \fBlength\fR 4
.IX Item "length"
تنظیم طول امواج صوتی نمایش‌داده‌شده بر حسب تعداد فریم.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از برخی گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کند.
.SS abitscope
.IX Subsection "abitscope"
تبدیل صدای ورودی به یک خروجی ویدیو، که بیت‌اسکوپ (audio bit scope) صدا را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بر حسب تعداد فریم در ثانیه. مقدار پیش‌فرض
"25" است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`1024x256\*(C'\fR است.
.IP \fBcolors\fR 4
.IX Item "colors"
تعیین فهرستی از رنگ‌ها جداشده با فاصله یا با \*(Aq|\*(Aq که برای
رسم کانال‌ها استفاده خواهند شد. رنگ‌های ناشناخته یا ناموجود با
رنگ سفید جایگزین خواهند شد.
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت خروجی. می‌تواند \f(CW\*(C`bars\*(C'\fR یا \f(CW\*(C`trace\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`bars\*(C'\fR است.
.SS adrawgraph
.IX Subsection "adrawgraph"
ترسیم یک نمودار با استفاده از متاداده‌های صدای ورودی.
.PP
فیلتر \fBdrawgraph\fR را ببینید.
.SS agraphmonitor
.IX Subsection "agraphmonitor"
فیلتر \fBgraphmonitor\fR را ببینید.
.SS ahistogram
.IX Subsection "ahistogram"
تبدیل صدای ورودی به یک خروجی ویدیو، که هیستوگرام بلندی صدا را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBdmode\fR 4
.IX Item "dmode"
تعیین نحوه محاسبه هیستوگرام.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBsingle\fR 4
.IX Item "single"
استفاده از یک هیستوگرام تکی برای تمام کانال‌ها.
.IP \fBseparate\fR 4
.IX Item "separate"
استفاده از هیستوگرام جداگانه برای هر کانال.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`single\*(C'\fR است.
.RE
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم، بر حسب تعداد فریم در ثانیه. مقدار پیش‌فرض
"25" است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`hd720\*(C'\fR است.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس نمایش.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم (جذر)
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم (کعبی)
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.IP \fBrlog\fR 4
.IX Item "rlog"
معکوس لگاریتمی
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`log\*(C'\fR است.
.RE
.IP \fBascale\fR 4
.IX Item "ascale"
تنظیم مقیاس دامنه.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`log\*(C'\fR است.
.RE
.IP \fBacount\fR 4
.IX Item "acount"
تنظیم تعداد فریم‌هایی که باید در هیستوگرام انباشته شوند.
پیش‌فرض 1 است. تنظیم این مقدار روی \-1 تمام فریم‌ها را انباشته می‌کند.
.IP \fBrheight\fR 4
.IX Item "rheight"
تنظیم نسبت ارتفاع هیستوگرام به ارتفاع پنجره.
.IP \fBslide\fR 4
.IX Item "slide"
تنظیم حالت لغزش سونوگرام.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBreplace\fR 4
.IX Item "replace"
جایگزینی سطر‌های قدیمی با سطر‌های جدید.
.IP \fBscroll\fR 4
.IX Item "scroll"
پیمایش از بالا به پایین.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`replace\*(C'\fR است.
.RE
.IP \fBhmode\fR 4
.IX Item "hmode"
تنظیم حالت هیستوگرام.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBabs\fR 4
.IX Item "abs"
استفاده از مقادیر قدر مطلق نمونه‌ها.
.IP \fBsign\fR 4
.IX Item "sign"
استفاده از مقادیر دست‌نخورده نمونه‌ها.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`abs\*(C'\fR است.
.RE
.SS aphasemeter
.IX Subsection "aphasemeter"
فاز صدای ورودی را اندازه می‌گیرد، که به عنوان متاداده \f(CW\*(C`lavfi.aphasemeter.phase\*(C'\fR،
نمایانگر فاز میانگین فریم صوتی فعلی صادر (export) می‌شود. یک خروجی ویدیو نیز می‌تواند تولید شود و به صورت پیش‌فرض
فعال است. صدا به عنوان خروجی اول عبور داده می‌شود.
.PP
اگر صدا دارای چیدمان کانال متفاوتی باشد به استریو ریماتریکس خواهد شد. مقدار فاز در
محدوده \f(CW\*(C`[\-1, 1]\*(C'\fR است که در آن \f(CW\-1\fR به معنای این است که کانال‌های چپ و راست کاملاً خارج از فاز هستند
و \f(CW1\fR به معنای هم‌فاز بودن کانال‌ها است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد که همگی مربوط به خروجی ویدیوی آن هستند:
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی. مقدار پیش‌فرض \f(CW25\fR است.
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیو برای خروجی. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`800x400\*(C'\fR است.
.IP \fBrc\fR 4
.IX Item "rc"
.PD 0
.IP \fBgc\fR 4
.IX Item "gc"
.IP \fBbc\fR 4
.IX Item "bc"
.PD
تعیین کنتراست قرمز، سبز و آبی. مقادیر پیش‌فرض \f(CW2\fR،
\&\f(CW7\fR و \f(CW1\fR هستند.
محدوده مجاز \f(CW\*(C`[0, 255]\*(C'\fR است.
.IP \fBmpc\fR 4
.IX Item "mpc"
تنظیم رنگی که برای رسم فاز میانه استفاده می‌شود. اگر رنگ
\&\f(CW\*(C`none\*(C'\fR باشد که حالت پیش‌فرض است، هیچ مقدار فاز میانه‌ای رسم نخواهد شد.
.IP \fBvideo\fR 4
.IX Item "video"
فعال‌سازی خروجی ویدیو. پیش‌فرض فعال است.
.PP
\fIتشخیص فاز (phasing detection)\fR
.IX Subsection "phasing detection"
.PP
این فیلتر همچنین توالی‌های مونو و خارج از فاز را در استریم‌های استریو تشخیص می‌دهد.
هرگاه توالی به اندازه حداقل تنظیم‌شده یا طولانی‌تر ادامه یابد، شروع، پایان و مدت‌زمان توالی را لاگ می‌کند.
.PP
این فیلتر گزینه‌های زیر را برای این تشخیص می‌پذیرد:
.IP \fBphasing\fR 4
.IX Item "phasing"
فعال‌سازی تشخیص مونو و خارج از فاز بودن. پیش‌فرض غیرفعال است.
.IP "\fBtolerance, t\fR" 4
.IX Item "tolerance, t"
تنظیم تلورانس فاز برای تشخیص مونو، بر حسب نسبت دامنه. پیش‌فرض \f(CW0\fR است.
محدوده مجاز \f(CW\*(C`[0, 1]\*(C'\fR است.
.IP "\fBangle, a\fR" 4
.IX Item "angle, a"
تنظیم آستانه زاویه برای تشخیص خارج از فاز بودن، بر حسب درجه. پیش‌فرض \f(CW170\fR است.
محدوده مجاز \f(CW\*(C`[90, 180]\*(C'\fR است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان مونو یا خارج از فاز بودن تا زمان اعلان، بر حسب ثانیه. پیش‌فرض \f(CW2\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مثال کامل با \fBffmpeg\fR برای تشخیص 1 ثانیه مونو با تلورانس فاز 0.001:
.Sp
.Vb 1
\&        ffmpeg \-i stereo.wav \-af aphasemeter=video=0:phasing=1:duration=1:tolerance=0.001 \-f null \-
.Ve
.SS avectorscope
.IX Subsection "avectorscope"
تبدیل صدای ورودی به یک خروجی ویدیو، که نمایانگر وکتوراسکوپ
صدا است.
.PP
این فیلتر برای سنجش اختلاف میان کانال‌های استریم صوتی استریو
استفاده می‌شود. یک سیگنال مونورال (مونو)، متشکل از سیگنال‌های چپ و راست
یکسان، منجر به یک خط عمودی مستقیم می‌شود. هرگونه تفکیک استریو
به صورت انحراف از این خط قابل مشاهده است که یک شکل لیساژو ایجاد می‌کند.
اگر خط مستقیم (یا انحراف از آن) اما به صورت افقی ظاهر شود،
نشان می‌دهد که کانال‌های چپ و راست خارج از فاز هستند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBmode, m\fR" 4
.IX Item "mode, m"
تنظیم حالت وکتوراسکوپ.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBlissajous\fR 4
.IX Item "lissajous"
لیساژو دوران‌یافته به اندازه 45 درجه.
.IP \fBlissajous_xy\fR 4
.IX Item "lissajous_xy"
همانند بالا اما بدون دوران.
.IP \fBpolar\fR 4
.IX Item "polar"
شکلی شبیه به نیم‌دایره.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBlissajous\fR است.
.RE
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیو برای خروجی. برای سینتکس این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`400x400\*(C'\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی. مقدار پیش‌فرض \f(CW25\fR است.
.IP \fBrc\fR 4
.IX Item "rc"
.PD 0
.IP \fBgc\fR 4
.IX Item "gc"
.IP \fBbc\fR 4
.IX Item "bc"
.IP \fBac\fR 4
.IX Item "ac"
.PD
تعیین کنتراست قرمز، سبز، آبی و آلفا. مقادیر پیش‌فرض \f(CW40\fR،
\&\f(CW160\fR، \f(CW80\fR و \f(CW255\fR هستند.
محدوده مجاز \f(CW\*(C`[0, 255]\*(C'\fR است.
.IP \fBrf\fR 4
.IX Item "rf"
.PD 0
.IP \fBgf\fR 4
.IX Item "gf"
.IP \fBbf\fR 4
.IX Item "bf"
.IP \fBaf\fR 4
.IX Item "af"
.PD
تعیین محوشدگی قرمز، سبز، آبی و آلفا. مقادیر پیش‌فرض \f(CW15\fR،
\&\f(CW10\fR، \f(CW5\fR و \f(CW5\fR هستند.
محدوده مجاز \f(CW\*(C`[0, 255]\*(C'\fR است.
.IP \fBzoom\fR 4
.IX Item "zoom"
تنظیم ضریب بزرگ‌نمایی. مقدار پیش‌فرض \f(CW1\fR است. محدوده مجاز \f(CW\*(C`[0, 10]\*(C'\fR است.
مقادیر کمتر از \fI1\fR ضریب بزرگ‌نمایی را به طور خودکار به حداکثر مقدار ممکن تنظیم می‌کنند.
.IP \fBdraw\fR 4
.IX Item "draw"
تنظیم حالت ترسیم وکتوراسکوپ.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBdot\fR 4
.IX Item "dot"
رسم نقطه برای هر نمونه.
.IP \fBline\fR 4
.IX Item "line"
رسم خط بین نمونه قبلی و فعلی.
.IP \fBaaline\fR 4
.IX Item "aaline"
رسم خط صاف‌شده (anti\-aliased) بین نمونه قبلی و فعلی.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBdot\fR است.
.RE
.IP \fBscale\fR 4
.IX Item "scale"
تعیین مقیاس دامنه نمونه‌های صوتی.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم (جذر).
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم (کعبی).
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی.
.RE
.RS 4
.RE
.IP \fBswap\fR 4
.IX Item "swap"
تعویض محور کانال چپ با محور کانال راست.
.IP \fBmirror\fR 4
.IX Item "mirror"
قرینه‌سازی محور.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
بدون قرینه‌سازی.
.IP \fBx\fR 4
.IX Item "x"
قرینه‌سازی فقط محور x.
.IP \fBy\fR 4
.IX Item "y"
قرینه‌سازی فقط محور y.
.IP \fBxy\fR 4
.IX Item "xy"
قرینه‌سازی هر دو محور.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
مثال کامل با استفاده از \fBffplay\fR:
.Sp
.Vb 2
\&        ffplay \-f lavfi \*(Aqamovie=input.mp3, asplit [a][out1];
\&                     [a] avectorscope=zoom=1.3:rc=2:gc=200:bc=10:rf=1:gf=8:bf=7 [out0]\*(Aq
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از تمام گزینه‌های بالا به عنوان دستور پشتیبانی می‌کند، به جز گزینه‌های \f(CW\*(C`size\*(C'\fR و \f(CW\*(C`rate\*(C'\fR.
.SS "bench, abench"
.IX Subsection "bench, abench"
سنجش عملکرد (بنچمارک) بخشی از یک گراف فیلتر.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBaction\fR 4
.IX Item "action"
شروع یا توقف یک تایمر.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBstart\fR 4
.IX Item "start"
دریافت زمان فعلی، تنظیم آن به عنوان متاداده فریم (با استفاده از کلید
\&\f(CW\*(C`lavfi.bench.start_time\*(C'\fR)، و هدایت فریم به فیلتر بعدی.
.IP \fBstop\fR 4
.IX Item "stop"
دریافت زمان فعلی و واکشی متاداده \f(CW\*(C`lavfi.bench.start_time\*(C'\fR از
متاداده فریم ورودی برای به دست آوردن اختلاف زمانی. سپس اختلاف زمانی، میانگین،
حداکثر و حداقل زمان (به ترتیب \f(CW\*(C`t\*(C'\fR، \f(CW\*(C`avg\*(C'\fR، \f(CW\*(C`max\*(C'\fR و
\&\f(CW\*(C`min\*(C'\fR) چاپ می‌شوند. برچسب‌های زمانی بر حسب ثانیه بیان می‌شوند.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
سنجش عملکرد فیلتر \fBselectivecolor\fR:
.Sp
.Vb 1
\&        bench=start,selectivecolor=reds=\-.2 .12 \-.49,bench=stop
.Ve
.SS concat
.IX Subsection "concat"
الحاق استریم‌های صوتی و ویدیویی به یکدیگر، متصل کردن آن‌ها یکی پس از
دیگری.
.PP
این فیلتر بر روی بخش‌هایی (segments) از استریم‌های همگام‌شده ویدیو و صدا کار می‌کند. تمام
بخش‌ها باید تعداد یکسانی از استریم‌ها از هر نوع داشته باشند، و این تعداد همچنین
تعداد استریم‌ها در خروجی خواهد بود.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBn\fR 4
.IX Item "n"
تنظیم تعداد بخش‌ها. پیش‌فرض 2 است.
.IP \fBv\fR 4
.IX Item "v"
تنظیم تعداد استریم‌های ویدیویی خروجی، که همان تعداد استریم‌های ویدیویی
در هر بخش نیز هست. پیش‌فرض 1 است.
.IP \fBa\fR 4
.IX Item "a"
تنظیم تعداد استریم‌های صوتی خروجی، که همان تعداد استریم‌های صوتی
در هر بخش نیز هست. پیش‌فرض 0 است.
.IP \fBunsafe\fR 4
.IX Item "unsafe"
فعال کردن حالت ناامن: در صورتی که بخش‌ها دارای فرمت متفاوتی باشند عملیات با شکست مواجه نشود.
.PP
فیلتر دارای \fIv\fR+\fIa\fR خروجی است: ابتدا \fIv\fR خروجی ویدیو، سپس
\&\fIa\fR خروجی صدا.
.PP
تعداد ورودی‌ها برابر با \fIn\fRx(\fIv\fR+\fIa\fR) است: ابتدا ورودی‌های مربوط به بخش اول،
با همان ترتیب خروجی‌ها، سپس ورودی‌های مربوط به بخش دوم و غیره.
.PP
استریم‌های مرتبط به دلایل مختلفی از جمله اندازه فریم کدک یا تألیف نادرست، همواره
دقیقاً دارای مدت‌زمان یکسانی نیستند. به همین دلیل، استریم‌های همگام‌شده مرتبط
(مانند یک ویدیو و تراک صوتی آن) باید به صورت همزمان الحاق شوند. فیلتر concat از مدت‌زمان طولانی‌ترین
استریم در هر بخش (به جز آخرین بخش) استفاده خواهد کرد و در صورت لزوم استریم‌های
صوتی کوتاه‌تر را با سکوت پر می‌کند (pad).
.PP
برای اینکه این فیلتر به درستی کار کند، تمام بخش‌ها باید در برچسب زمانی 0 شروع شوند.
.PP
تمام استریم‌های متناظر باید در تمام بخش‌ها دارای پارامترهای یکسانی باشند؛ سیستم
فیلترگذاری به طور خودکار یک فرمت پیکسلی مشترک را برای استریم‌های ویدیو، و یک فرمت نمونه،
نرخ نمونه‌برداری و چیدمان کانال مشترک را برای استریم‌های صوتی انتخاب می‌کند، اما سایر تنظیمات،
مانند وضوح تصویر، باید صراحتاً توسط کاربر تبدیل شوند.
.PP
نرخ‌های فریم متفاوت قابل قبول هستند اما منجر به نرخ فریم متغیر
در خروجی خواهند شد؛ اطمینان حاصل کنید که پرونده خروجی را برای مدیریت آن پیکربندی کرده‌اید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
الحاق یک تیتراژ آغازین، یک قسمت و یک تیتراژ پایانی، همگی در نسخه دوزبانه
(ویدیو در استریم 0، صدا در استریم‌های 1 و 2):
.Sp
.Vb 4
\&        ffmpeg \-i opening.mkv \-i episode.mkv \-i ending.mkv \-filter_complex \e
\&          \*(Aq[0:0] [0:1] [0:2] [1:0] [1:1] [1:2] [2:0] [2:1] [2:2]
\&           concat=n=3:v=1:a=2 [v] [a1] [a2]\*(Aq \e
\&          \-map \*(Aq[v]\*(Aq \-map \*(Aq[a1]\*(Aq \-map \*(Aq[a2]\*(Aq output.mkv
.Ve
.IP \(bu 4
الحاق دو بخش، مدیریت جداگانه صدا و ویدیو با استفاده از سورس‌های
(a)movie، و تنظیم وضوح تصویر:
.Sp
.Vb 3
\&        movie=part1.mp4, scale=512:288 [v1] ; amovie=part1.mp4 [a1] ;
\&        movie=part2.mp4, scale=512:288 [v2] ; amovie=part2.mp4 [a2] ;
\&        [v1] [v2] concat [outv] ; [a1] [a2] concat=v=0:a=1 [outa]
.Ve
.Sp
توجه داشته باشید که اگر استریم‌های صوتی و ویدیویی در پرونده اول دقیقاً دارای
مدت‌زمان یکسانی نباشند، در محل اتصال (stitch) ناهمگامی رخ خواهد داد.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
این فیلتر از دستورات زیر پشتیبانی می‌کند:
.IP \fBnext\fR 4
.IX Item "next"
بستن بخش فعلی و گام برداشتن به بخش بعدی
.SS ebur128
.IX Subsection "ebur128"
فیلتر پویشگر EBU R128. این فیلتر یک استریم صوتی را دریافت کرده و سطح بلندی صدای
آن را تحلیل می‌کند. به طور پیش‌فرض، پیامی را با فرکانس 10 هرتز با
بلندی صدای لحظه‌ای (مشخص‌شده با \f(CW\*(C`M\*(C'\fR)، بلندی صدای کوتاه‌مدت (\f(CW\*(C`S\*(C'\fR)،
بلندی صدای یکپارچه (\f(CW\*(C`I\*(C'\fR) و محدوده بلندی صدا (\f(CW\*(C`LRA\*(C'\fR) لاگ می‌کند.
.PP
این فیلتر فقط می‌تواند استریم‌هایی را تحلیل کند که فرمت نمونه
آن‌ها ممیز شناور با دقت مضاعف (double\-precision) باشد. در صورت لزوم، استریم ورودی به
این مشخصات تبدیل خواهد شد. ممکن است کاربران نیاز داشته باشند فیلترهای aformat و/یا aresample
را پس از این فیلتر درج کنند تا پارامترهای اصلی بازیابی شوند.
.PP
این فیلتر همچنین دارای یک خروجی ویدیو است (گزینه \fIvideo\fR را ببینید) همراه با یک نمودار
بلادرنگ برای مشاهده روند تغییر بلندی صدا. نمودار شامل پیام لاگ‌شده
ذکرشده در بالا است، بنابراین هنگامی که این گزینه تنظیم شده باشد، دیگر چاپ نمی‌شود،
مگر اینکه گزارش‌گیری با جزئیات (verbose) تنظیم شده باشد. ناحیه اصلی نمودار شامل
بلندی صدای کوتاه‌مدت (3 ثانیه تحلیل) است، و درجه (gauge) در سمت راست برای
بلندی صدای لحظه‌ای (400 میلی‌ثانیه) است، اما می‌تواند به صورت اختیاری به گونه‌ای پیکربندی
شود که به جای آن بلندی صدای کوتاه‌مدت را نمایش دهد (به \fIgauge\fR مراجعه کنید).
.PP
ناحیه سبز یک محدوده هدف 1LU+/ را در اطراف بلندی صدای هدف
(به طور پیش‌فرض 23LUFS\-، مگر اینکه از طریق \fItarget\fR تغییر یابد) مشخص می‌کند.
.PP
اطلاعات بیشتر درباره توصیه‌نامه بلندی صدای EBU R128 در
<\fBhttp://tech.ebu.ch/loudness\fR>.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBvideo\fR 4
.IX Item "video"
فعال‌سازی خروجی ویدیو. استریم صوتی بدون تغییر عبور داده می‌شود، چه این
گزینه تنظیم شده باشد یا خیر. استریم ویدیو در صورت فعال بودن، اولین استریم خروجی
خواهد بود. پیش‌فرض \f(CW0\fR است.
.IP \fBsize\fR 4
.IX Item "size"
تنظیم اندازه ویدیو. این گزینه فقط برای ویدیو است. برای سینتکس این
گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
وضوح پیش‌فرض و حداقل \f(CW\*(C`640x480\*(C'\fR است.
.IP \fBmeter\fR 4
.IX Item "meter"
تنظیم مقیاس‌سنج EBU. پیش‌فرض \f(CW9\fR است. مقادیر متداول \f(CW9\fR و
\&\f(CW18\fR هستند، به ترتیب برای مقیاس‌سنج +9 EBU و مقیاس‌سنج +18 EBU. هر
مقدار صحیح دیگری بین این محدوده مجاز است.
.IP \fBmetadata\fR 4
.IX Item "metadata"
تنظیم تزریق متاداده. اگر روی \f(CW1\fR تنظیم شود، ورودی صوتی به فریم‌های
خروجی 100 میلی‌ثانیه‌ای بخش‌بندی می‌شود که هر یک از آن‌ها حاوی اطلاعات مختلف بلندی صدا
در متاداده هستند. تمام کلیدهای متاداده دارای پیشوند \f(CW\*(C`lavfi.r128.\*(C'\fR هستند.
.Sp
پیش‌فرض \f(CW0\fR است.
.IP \fBframelog\fR 4
.IX Item "framelog"
اجبار سطح ثبت گزارش فریم.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBquiet\fR 4
.IX Item "quiet"
لاگ‌گیری غیرفعال
.IP \fBinfo\fR 4
.IX Item "info"
سطح لاگ‌گیری اطلاعات
.IP \fBverbose\fR 4
.IX Item "verbose"
سطح لاگ‌گیری با جزئیات (verbose)
.RE
.RS 4
.Sp
به طور پیش‌فرض، سطح لاگ‌گیری روی \fIinfo\fR تنظیم شده است. اگر گزینه‌های \fBvideo\fR یا
\fBmetadata\fR تنظیم شوند، به \fIverbose\fR تغییر وضعیت می‌دهد.
.RE
.IP \fBpeak\fR 4
.IX Item "peak"
تنظیم حالت(های) اوج (peak).
.Sp
حالت‌های موجود را می‌توان با هم ترکیب کرد (این گزینه از نوع \f(CW\*(C`flag\*(C'\fR است). مقادیر
ممکن عبارتند از:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال کردن هرگونه حالت اوج (پیش‌فرض).
.IP \fBsample\fR 4
.IX Item "sample"
فعال‌سازی حالت sample\-peak.
.Sp
حالت اوج ساده که به دنبال بالاترین مقدار نمونه می‌گردد. پیامی را برای
sample\-peak (مشخص‌شده با \f(CW\*(C`SPK\*(C'\fR) ثبت می‌کند.
.IP \fBtrue\fR 4
.IX Item "true"
فعال‌سازی حالت true\-peak.
.Sp
در صورت فعال بودن، جستجوی مقدار اوج بر روی نسخه‌ای از استریم ورودی با
بیش‌نمونه‌برداری (over\-sampled) برای دقت بهتر در تعیین اوج انجام می‌شود. پیامی را برای true\-peak
(مشخص‌شده با \f(CW\*(C`TPK\*(C'\fR) و true\-peak به ازای هر فریم (مشخص‌شده با \f(CW\*(C`FTPK\*(C'\fR) ثبت می‌کند.
این حالت نیازمند ساخت برنامه‌ای است که شامل \f(CW\*(C`libswresample\*(C'\fR باشد.
.RE
.RS 4
.RE
.IP \fBdualmono\fR 4
.IX Item "dualmono"
رفتار با پرونده‌های ورودی مونو به عنوان "dual mono". اگر یک پرونده مونو برای پخش
بر روی یک سیستم استریو در نظر گرفته شده باشد، اندازه‌گیری EBU R128 آن از نظر ادراکی نادرست خواهد بود.
در صورت تنظیم روی \f(CW\*(C`true\*(C'\fR، این گزینه این اثر را جبران خواهد کرد.
پرونده‌های ورودی چندکاناله تحت تأثیر این گزینه قرار نمی‌گیرند.
.IP \fBpanlaw\fR 4
.IX Item "panlaw"
تنظیم یک قانون حرکت متوازن (pan law) خاص برای استفاده در اندازه‌گیری پرونده‌های dual mono.
این پارامتر اختیاری است و دارای مقدار پیش‌فرض \-3.01dB است.
.IP \fBtarget\fR 4
.IX Item "target"
تنظیم یک سطح هدف خاص (بر حسب LUFS) مورد استفاده به عنوان صفر نسبی در مصورسازی.
این پارامتر اختیاری است و دارای مقدار پیش‌فرض \-23LUFS است همان‌طور که توسط
EBU R128 مشخص شده است. با این حال، محتوای منتشرشده آنلاین ممکن است سطح \-16LUFS را ترجیح دهد
(به عنوان مثال برای استفاده در پادکست‌ها یا پلتفرم‌های ویدیویی).
.IP \fBgauge\fR 4
.IX Item "gauge"
تنظیم مقداری که توسط درجه نمایش داده می‌شود. مقادیر معتبر عبارتند از \f(CW\*(C`momentary\*(C'\fR و
\&\f(CW\*(C`shortterm\*(C'\fR. به طور پیش‌فرض مقدار لحظه‌ای استفاده خواهد شد، اما در برخی
سناریوها ممکن است مشاهده مقدار کوتاه‌مدت مفیدتر باشد (به عنوان مثال
میکس زنده).
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس نمایش برای بلندی صدا. پارامترهای معتبر عبارتند از \f(CW\*(C`absolute\*(C'\fR
(بر حسب LUFS) یا \f(CW\*(C`relative\*(C'\fR (LU) به صورت نسبی نسبت به هدف. این گزینه فقط بر
خروجی ویدیو تأثیر می‌گذارد، نه بر خلاصه یا خروجی لاگ پیوسته.
.IP \fBintegrated\fR 4
.IX Item "integrated"
مقدار صادرشده فقط‌خواندنی برای بلندی صدای یکپارچه اندازه‌گیری‌شده، بر حسب LUFS.
.IP \fBrange\fR 4
.IX Item "range"
مقدار صادرشده فقط‌خواندنی برای محدوده بلندی صدای اندازه‌گیری‌شده، بر حسب LU.
.IP \fBlra_low\fR 4
.IX Item "lra_low"
مقدار صادرشده فقط‌خواندنی برای حد پایین LRA اندازه‌گیری‌شده، بر حسب LUFS.
.IP \fBlra_high\fR 4
.IX Item "lra_high"
مقدار صادرشده فقط‌خواندنی برای حد بالای LRA اندازه‌گیری‌شده، بر حسب LUFS.
.IP \fBsample_peak\fR 4
.IX Item "sample_peak"
مقدار صادرشده فقط‌خواندنی برای اوج نمونه اندازه‌گیری‌شده، بر حسب dBFS.
.IP \fBtrue_peak\fR 4
.IX Item "true_peak"
مقدار صادرشده فقط‌خواندنی برای اوج واقعی اندازه‌گیری‌شده، بر حسب dBFS.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
نمودار بلادرنگ با استفاده از \fBffplay\fR، با یک مقیاس‌سنج +18 EBU:
.Sp
.Vb 1
\&        ffplay \-f lavfi \-i "amovie=input.mp3,ebur128=video=1:meter=18 [out0][out1]"
.Ve
.IP \(bu 4
اجرای یک تحلیل با \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-nostats \-i input.mp3 \-filter_complex ebur128 \-f null \-
.Ve
.SS "interleave, ainterleave"
.IX Subsection "interleave, ainterleave"
درهم‌آمیزی زمانی فریم‌ها از چندین ورودی.
.PP
\&\f(CW\*(C`interleave\*(C'\fR با ورودی‌های ویدیو کار می‌کند، و \f(CW\*(C`ainterleave\*(C'\fR با ورودی‌های صدا.
.PP
این فیلترها فریم‌ها را از چندین ورودی می‌خوانند و قدیمی‌ترین
فریم صف‌بندی‌شده را به خروجی ارسال می‌کنند.
.PP
استریم‌های ورودی باید مقادیر برچسب زمانی فریم کاملاً تعریف‌شده و
به صورت یکنواخت صعودی داشته باشند.
.PP
به منظور ارسال یک فریم به خروجی، این فیلترها باید حداقل
یک فریم را برای هر ورودی صف‌بندی کنند، بنابراین در صورتی که یکی از
ورودی‌ها هنوز خاتمه نیافته باشد و فریم‌های ورودی دریافت نکند، نمی‌توانند کار کنند.
.PP
به عنوان مثال حالتی را در نظر بگیرید که در آن یک ورودی یک فیلتر \f(CW\*(C`select\*(C'\fR باشد
که همیشه فریم‌های ورودی را دور می‌اندازد. فیلتر \f(CW\*(C`interleave\*(C'\fR به
خواندن از آن ورودی ادامه خواهد داد، اما تا زمانی که ورودی یک سیگنال پایان استریم ارسال نکند
هرگز قادر به ارسال فریم‌های جدید به خروجی نخواهد بود.
.PP
همچنین، بسته به همگام‌سازی ورودی‌ها، در صورتی که یک ورودی فریم‌های بیشتری نسبت به بقیه
دریافت کند و صف از قبل پر شده باشد، فیلترها فریم‌ها را دور می‌اندازند.
.PP
این فیلترها گزینه‌های زیر را می‌پذیرند:
.IP "\fBnb_inputs, n\fR" 4
.IX Item "nb_inputs, n"
تنظیم تعداد ورودی‌های مختلف، به طور پیش‌فرض 2 است.
.IP \fBduration\fR 4
.IX Item "duration"
نحوه تعیین پایان استریم.
.RS 4
.IP \fBlongest\fR 4
.IX Item "longest"
مدت‌زمان طولانی‌ترین ورودی. (پیش‌فرض)
.IP \fBshortest\fR 4
.IX Item "shortest"
مدت‌زمان کوتاه‌ترین ورودی.
.IP \fBfirst\fR 4
.IX Item "first"
مدت‌زمان اولین ورودی.
.RE
.RS 4
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
درهم‌آمیزی فریم‌های متعلق به استریم‌های مختلف با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i bambi.avi \-i pr0n.mkv \-filter_complex "[0:v][1:v] interleave" out.avi
.Ve
.IP \(bu 4
افزودن جلوه محوشدگی سوسوزننده:
.Sp
.Vb 1
\&        select=\*(Aqif(gt(random(0), 0.2), 1, 2)\*(Aq:n=2 [tmp], boxblur=2:2, [tmp] interleave
.Ve
.SS "latency, alatency"
.IX Subsection "latency, alatency"
سنجش تأخیر فیلترگذاری.
.PP
گزارش تأخیر فیلترگذاری فیلتر قبلی، تأخیر بر حسب تعداد نمونه‌های صوتی برای فیلترهای صوتی
یا تعداد فریم‌های ویدیو برای فیلترهای ویدیو.
.PP
در پایان استریم ورودی، فیلتر حداقل و حداکثر تأخیر اندازه‌گیری‌شده را برای فیلتر در حال اجرای قبلی
در گراف فیلتر گزارش می‌دهد.
.SS "metadata, ametadata"
.IX Subsection "metadata, ametadata"
دست‌کاری متاداده فریم.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد فیلتر.
.Sp
می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBselect\fR 4
.IX Item "select"
اگر هر دو گزینه \f(CW\*(C`value\*(C'\fR و \f(CW\*(C`key\*(C'\fR تنظیم شده باشند، فریم‌هایی
که دارای چنین متاداده‌ای هستند انتخاب می‌شوند. اگر فقط \f(CW\*(C`key\*(C'\fR تنظیم شده باشد،
هر فریمی که چنین کلیدی در متاداده دارد انتخاب می‌شود.
.IP \fBadd\fR 4
.IX Item "add"
افزودن \f(CW\*(C`key\*(C'\fR و \f(CW\*(C`value\*(C'\fR جدید به متاداده. اگر کلید از قبل موجود باشد
هیچ کاری انجام ندهد.
.IP \fBmodify\fR 4
.IX Item "modify"
اصلاح مقدار کلیدی که از قبل موجود است.
.IP \fBdelete\fR 4
.IX Item "delete"
اگر \f(CW\*(C`value\*(C'\fR تنظیم شده باشد، فقط کلیدهایی که چنین مقداری دارند حذف می‌شوند.
در غیر این صورت، کلید حذف می‌شود. اگر \f(CW\*(C`key\*(C'\fR تنظیم نشده باشد، تمام مقادیر متاداده
در فریم حذف می‌شوند.
.IP \fBprint\fR 4
.IX Item "print"
چاپ کلید و مقدار آن در صورتی که متاداده یافت شود. اگر \f(CW\*(C`key\*(C'\fR تنظیم نشده باشد تمام
مقادیر متاداده موجود در فریم چاپ می‌شوند.
.RE
.RS 4
.RE
.IP \fBkey\fR 4
.IX Item "key"
تنظیم کلید مورد استفاده در تمام حالت‌ها. باید برای تمام حالت‌ها به جز \f(CW\*(C`print\*(C'\fR و \f(CW\*(C`delete\*(C'\fR تنظیم شود.
.IP \fBvalue\fR 4
.IX Item "value"
تنظیم مقدار متاداده که مورد استفاده قرار می‌گیرد. این گزینه برای حالت‌های
\&\f(CW\*(C`modify\*(C'\fR و \f(CW\*(C`add\*(C'\fR الزامی است.
.IP \fBfunction\fR 4
.IX Item "function"
کدام تابع هنگام مقایسه مقدار متاداده و \f(CW\*(C`value\*(C'\fR استفاده شود.
.Sp
می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBsame_str\fR 4
.IX Item "same_str"
مقادیر به صورت رشته تفسیر می‌شوند، اگر مقدار متاداده با \f(CW\*(C`value\*(C'\fR یکسان باشد مقدار درستی برمی‌گرداند.
.IP \fBstarts_with\fR 4
.IX Item "starts_with"
مقادیر به صورت رشته تفسیر می‌شوند، اگر مقدار متاداده با رشته
گزینه \f(CW\*(C`value\*(C'\fR شروع شود مقدار درستی برمی‌گرداند.
.IP \fBless\fR 4
.IX Item "less"
مقادیر به صورت ممیز شناور تفسیر می‌شوند، اگر مقدار متاداده کمتر از \f(CW\*(C`value\*(C'\fR باشد مقدار درستی برمی‌گرداند.
.IP \fBequal\fR 4
.IX Item "equal"
مقادیر به صورت ممیز شناور تفسیر می‌شوند، اگر \f(CW\*(C`value\*(C'\fR با مقدار متاداده برابر باشد مقدار درستی برمی‌گرداند.
.IP \fBgreater\fR 4
.IX Item "greater"
مقادیر به صورت ممیز شناور تفسیر می‌شوند، اگر مقدار متاداده بزرگ‌تر از \f(CW\*(C`value\*(C'\fR باشد مقدار درستی برمی‌گرداند.
.IP \fBexpr\fR 4
.IX Item "expr"
مقادیر به صورت ممیز شناور تفسیر می‌شوند، اگر عبارت گزینه \f(CW\*(C`expr\*(C'\fR به
درستی ارزیابی شود مقدار درستی برمی‌گرداند.
.IP \fBends_with\fR 4
.IX Item "ends_with"
مقادیر به صورت رشته تفسیر می‌شوند، اگر مقدار متاداده با رشته
گزینه \f(CW\*(C`value\*(C'\fR پایان یابد مقدار درستی برمی‌گرداند.
.RE
.RS 4
.RE
.IP \fBexpr\fR 4
.IX Item "expr"
تنظیم عبارتی که در زمان تنظیم \f(CW\*(C`function\*(C'\fR روی \f(CW\*(C`expr\*(C'\fR استفاده می‌شود.
این عبارت از طریق eval API ارزیابی می‌شود و می‌تواند شامل ثوابت
زیر باشد:
.RS 4
.IP "\fBVALUE1, FRAMEVAL\fR" 4
.IX Item "VALUE1, FRAMEVAL"
نمایش ممیز شناور \f(CW\*(C`value\*(C'\fR از کلید متاداده.
.IP "\fBVALUE2, USERVAL\fR" 4
.IX Item "VALUE2, USERVAL"
نمایش ممیز شناور \f(CW\*(C`value\*(C'\fR همان‌طور که توسط کاربر در گزینه \f(CW\*(C`value\*(C'\fR ارائه شده است.
.RE
.RS 4
.RE
.IP \fBfile\fR 4
.IX Item "file"
اگر در حالت \f(CW\*(C`print\*(C'\fR مشخص شود، خروجی در پرونده نام‌برده نوشته می‌شود. به جای
نام پرونده ساده می‌توان هر آدرس url قابل نوشتن را مشخص کرد. نام پرونده \`\`\-\*(Aq\*(Aq نمادی
برای خروجی استاندارد است. اگر گزینه \f(CW\*(C`file\*(C'\fR تنظیم نشود، خروجی با سطح لاگ
AV_LOG_INFO در گزارش ثبت می‌شود.
.IP \fBdirect\fR 4
.IX Item "direct"
کاهش بافرسازی در حالت print زمانی که خروجی در یک URL تنظیم‌شده با استفاده از \fIfile\fR نوشته می‌شود.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
چاپ تمام مقادیر متاداده برای فریم‌هایی با کلید \f(CW\*(C`lavfi.signalstats.YDIF\*(C'\fR با مقادیر
بین 0 و 1.
.Sp
.Vb 1
\&        signalstats,metadata=print:key=lavfi.signalstats.YDIF:value=0:function=expr:expr=\*(Aqbetween(VALUE1,0,1)\*(Aq
.Ve
.IP \(bu 4
چاپ خروجی silencedetect در پرونده \fImetadata.txt\fR.
.Sp
.Vb 1
\&        silencedetect,ametadata=mode=print:file=metadata.txt
.Ve
.IP \(bu 4
هدایت مستقیم تمام متاداده به یک پایپ با توصیف‌گر پرونده 4.
.Sp
.Vb 1
\&        metadata=mode=print:file=\*(Aqpipe\e:4\*(Aq
.Ve
.SS "perms, aperms"
.IX Subsection "perms, aperms"
تنظیم مجوزهای خواندن/نوشتن برای فریم‌های خروجی.
.PP
این فیلترها عمدتاً برای توسعه‌دهندگان به منظور آزمایش مسیر مستقیم (direct path) در فیلتر
بعدی در گراف فیلتر در نظر گرفته شده‌اند.
.PP
این فیلترها گزینه‌های زیر را می‌پذیرند:
.IP \fBmode\fR 4
.IX Item "mode"
انتخاب حالت مجوزها.
.Sp
مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
هیچ کاری انجام ندهد. این حالت پیش‌فرض است.
.IP \fBro\fR 4
.IX Item "ro"
تمام فریم‌های خروجی را فقط‌خواندنی (read\-only) تنظیم کند.
.IP \fBrw\fR 4
.IX Item "rw"
تمام فریم‌های خروجی را مستقیماً قابل نوشتن تنظیم کند.
.IP \fBtoggle\fR 4
.IX Item "toggle"
فریم را در صورت قابل نوشتن بودن فقط‌خواندنی کند، و در صورت فقط‌خواندنی بودن قابل نوشتن کند.
.IP \fBrandom\fR 4
.IX Item "random"
هر فریم خروجی را به صورت تصادفی فقط‌خواندنی یا قابل نوشتن کند.
.RE
.RS 4
.RE
.IP \fBseed\fR 4
.IX Item "seed"
تنظیم سید برای حالت \fIrandom\fR، باید یک عدد صحیح بین
\&\f(CW0\fR و \f(CW\*(C`UINT32_MAX\*(C'\fR باشد. اگر مشخص نشود، یا اگر صراحتاً روی
\&\f(CW\-1\fR تنظیم شود، فیلتر تلاش می‌کند تا بر پایه بیشترین تلاش از یک سید تصادفی مناسب
استفاده کند.
.PP
توجه: در صورت درج خودکار فیلتر بین فیلتر مجوزها و فیلتر بعدی،
ممکن است مجوز طبق انتظار در فیلتر بعدی دریافت نشود. درج یک فیلتر
\fBformat\fR یا \fBaformat\fR پیش از فیلتر perms/aperms می‌تواند از این مشکل جلوگیری کند.
.SS "realtime, arealtime"
.IX Subsection "realtime, arealtime"
کاهش سرعت فیلترگذاری برای انطباق تقریبی با زمان واقعی (real time).
.PP
این فیلترها فرآیند فیلترگذاری را برای مدت‌زمانی متغیر متوقف می‌کنند تا
نرخ خروجی با برچسب‌های زمانی ورودی مطابقت پیدا کند.
آن‌ها مشابه گزینه \fBre\fR در \f(CW\*(C`ffmpeg\*(C'\fR هستند.
.PP
آن‌ها گزینه‌های زیر را می‌پذیرند:
.IP \fBlimit\fR 4
.IX Item "limit"
محدودیت زمانی برای مکث‌ها. هر مکثی طولانی‌تر از آن به عنوان یک ناپیوستگی در برچسب زمانی
در نظر گرفته شده و تایمر را بازنشانی می‌کند. پیش‌فرض 2 ثانیه است.
.IP \fBspeed\fR 4
.IX Item "speed"
ضریب سرعت برای پردازش. مقدار باید یک عدد ممیز شناور بزرگ‌تر از صفر باشد.
مقادیر بزرگ‌تر از 1.0 منجر به پردازش سریع‌تر از زمان واقعی می‌شوند، و
مقادیر کوچک‌تر پردازش را کند می‌کنند. گزینه \fIlimit\fR به طور خودکار بر این اساس
تطبیق داده می‌شود. پیش‌فرض 1.0 است.
.Sp
سرعت پردازشی سریع‌تر از آنچه بدون این فیلترها ممکن است، قابل دستیابی
نیست.
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
هر دو فیلتر از تمام گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کنند.
.SS "segment, asegment"
.IX Subsection "segment, asegment"
تقسیم یک استریم ورودی منفرد به چندین استریم.
.PP
این فیلتر عکس فیلترهای concat عمل می‌کند.
.PP
\&\f(CW\*(C`segment\*(C'\fR بر روی فریم‌های ویدیو، و \f(CW\*(C`asegment\*(C'\fR بر روی نمونه‌های صوتی کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBtimestamps\fR 4
.IX Item "timestamps"
برچسب‌های زمانی بخش‌های خروجی جداشده با \*(Aq|\*(Aq. اولین بخش از ابتدای
استریم ورودی آغاز خواهد شد. آخرین بخش تا پایان استریم
ورودی ادامه می‌یابد.
.IP "\fBframes, samples\fR" 4
.IX Item "frames, samples"
تعداد دقیق فریم‌ها/نمونه‌ها برای تقسیم بخش‌ها.
.PP
در تمام موارد، اضافه کردن پیشوند \*(Aq+\*(Aq به هر بخش، آن را نسبت به
بخش قبلی نسبی می‌کند.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تقسیم استریم صوتی ورودی به سه استریم صوتی خروجی، شروع از ابتدای استریم صوتی ورودی
و ذخیره آن در اولین استریم صوتی خروجی، سپس ادامه در ثانیه 60 و ذخیره آن در دومین
استریم صوتی خروجی، و در نهایت پس از ثانیه 150 استریم صوتی ورودی و ذخیره در سومین استریم صوتی خروجی:
.Sp
.Vb 1
\&        asegment=timestamps="60|150"
.Ve
.SS "select, aselect"
.IX Subsection "select, aselect"
انتخاب فریم‌ها برای ارسال به خروجی.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBexpr, e\fR" 4
.IX Item "expr, e"
تنظیم عبارتی که برای هر فریم ورودی ارزیابی می‌شود.
.Sp
اگر عبارت به صفر ارزیابی شود، فریم دور انداخته می‌شود.
.Sp
اگر نتیجه ارزیابی منفی یا NaN باشد، فریم به خروجی اول
فرستاده می‌شود؛ در غیر این صورت به خروجی با اندیس
\&\f(CW\*(C`ceil(val)\-1\*(C'\fR فرستاده می‌شود، با این فرض که اندیس ورودی از 0 شروع می‌شود.
.Sp
برای مثال مقدار \f(CW1.2\fR متناظر با خروجی با اندیس
\&\f(CW\*(C`ceil(1.2)\-1 = 2\-1 = 1\*(C'\fR است، یعنی دومین خروجی.
.IP "\fBoutputs, n\fR" 4
.IX Item "outputs, n"
تنظیم تعداد خروجی‌ها. خروجی‌ای که فریم انتخاب‌شده باید به آن فرستاده شود
بر اساس نتیجه ارزیابی تعیین می‌شود. مقدار پیش‌فرض 1 است.
.PP
عبارت می‌تواند شامل ثوابت زیر باشد:
.IP \fBn\fR 4
.IX Item "n"
شماره (ترتیبی) فریم فیلترشده، شروع از 0.
.IP \fBselected_n\fR 4
.IX Item "selected_n"
شماره (ترتیبی) فریم انتخاب‌شده، شروع از 0.
.IP \fBprev_selected_n\fR 4
.IX Item "prev_selected_n"
شماره ترتیبی آخرین فریم انتخاب‌شده. در صورت تعریف نشدن NAN است.
.IP \fBTB\fR 4
.IX Item "TB"
پایه زمانی برچسب‌های زمانی ورودی.
.IP \fBpts\fR 4
.IX Item "pts"
مقدار PTS (برچسب زمانی ارائه) فریم فیلترشده،
بیان‌شده در واحدهای \fITB\fR. در صورت تعریف نشدن NAN است.
.IP \fBt\fR 4
.IX Item "t"
مقدار PTS فریم فیلترشده،
بیان‌شده بر حسب ثانیه. در صورت تعریف نشدن NAN است.
.IP \fBprev_pts\fR 4
.IX Item "prev_pts"
مقدار PTS فریم فیلترشده قبلی. در صورت تعریف نشدن NAN است.
.IP \fBprev_selected_pts\fR 4
.IX Item "prev_selected_pts"
مقدار PTS آخرین فریم فیلترشده قبلی. در صورت تعریف نشدن NAN است.
.IP \fBprev_selected_t\fR 4
.IX Item "prev_selected_t"
مقدار PTS آخرین فریم انتخاب‌شده قبلی، بیان‌شده بر حسب ثانیه. در صورت تعریف نشدن NAN است.
.IP \fBstart_pts\fR 4
.IX Item "start_pts"
اولین PTS در استریم که NAN نیست. در صورت یافت نشدن NAN باقی می‌ماند.
.IP \fBstart_t\fR 4
.IX Item "start_t"
اولین PTS، بر حسب ثانیه، در استریم که NAN نیست. در صورت یافت نشدن NAN باقی می‌ماند.
.IP "\fBpict_type\fR \fI(فقط ویدیو)\fR" 4
.IX Item "pict_type (video only)"
نوع فریم فیلترشده. می‌تواند یکی از مقادیر زیر را به خود
بگیرد:
.RS 4
.IP \fBI\fR 4
.IX Item "I"
.PD 0
.IP \fBP\fR 4
.IX Item "P"
.IP \fBB\fR 4
.IX Item "B"
.IP \fBS\fR 4
.IX Item "S"
.IP \fBSI\fR 4
.IX Item "SI"
.IP \fBSP\fR 4
.IX Item "SP"
.IP \fBBI\fR 4
.IX Item "BI"
.PD
.RE
.RS 4
.RE
.IP "\fBinterlace_type\fR \fI(فقط ویدیو)\fR" 4
.IX Item "interlace_type (video only)"
نوع اینترلیس فریم. می‌تواند یکی از مقادیر زیر را به خود بگیرد:
.RS 4
.IP \fBPROGRESSIVE\fR 4
.IX Item "PROGRESSIVE"
فریم پیش‌رونده (غیر اینترلیس) است.
.IP \fBTOPFIRST\fR 4
.IX Item "TOPFIRST"
فریم فیلد بالایی اول است.
.IP \fBBOTTOMFIRST\fR 4
.IX Item "BOTTOMFIRST"
فریم فیلد پایینی اول است.
.RE
.RS 4
.RE
.IP "\fBconsumed_sample_n\fR \fI(فقط صدا)\fR" 4
.IX Item "consumed_sample_n (audio only)"
تعداد نمونه‌های انتخاب‌شده پیش از فریم فعلی
.IP "\fBsamples_n\fR \fI(فقط صدا)\fR" 4
.IX Item "samples_n (audio only)"
تعداد نمونه‌ها در فریم فعلی
.IP "\fBsample_rate\fR \fI(فقط صدا)\fR" 4
.IX Item "sample_rate (audio only)"
نرخ نمونه‌برداری ورودی
.IP \fBkey\fR 4
.IX Item "key"
اگر فریم فیلترشده فریم کلیدی (key\-frame) باشد 1 است، در غیر این صورت 0.
.IP \fBpos\fR 4
.IX Item "pos"
موقعیت فریم فیلترشده در پرونده، اگر اطلاعات در دسترس نباشد
\-1 است (مثلاً برای ویدیوی ساختگی)؛ منسوخ شده است، استفاده نکنید
.IP "\fBscene\fR \fI(فقط ویدیو)\fR" 4
.IX Item "scene (video only)"
مقداری بین 0 و 1 برای نشان دادن یک صحنه جدید؛ مقدار کم نشان‌دهنده احتمال پایین
برای فریم فعلی در معرفی صحنه جدید است، در حالی که مقدار بالاتر
به معنای احتمال بیشتر است (مثال زیر را ببینید)
.IP \fBconcatdec_select\fR 4
.IX Item "concatdec_select"
دیمکسر concat می‌تواند با تنظیم یک نقطه ورودی (inpoint) و یک نقطه خروجی (outpoint)
تنها بخشی از یک پرونده ورودی concat را انتخاب کند، اما بسته‌های خروجی ممکن است کاملاً
در بازه انتخاب‌شده قرار نگیرند. با استفاده از این متغیر، می‌توان فریم‌های تولیدشده
توسط دیمکسر concat را که دقیقاً در بازه انتخاب‌شده قرار ندارند، نادیده گرفت.
.Sp
این عملکرد با مقایسه pts فریم با مقادیر متاداده بسته \fIlavf.concat.start_time\fR
و \fIlavf.concat.duration\fR که در فریم‌های دیکودشده نیز وجود دارند،
کار می‌کند.
.Sp
متغیر \fIconcatdec_select\fR برابر \-1 است اگر pts فریم حداقل برابر با
start_time باشد و متاداده duration موجود نباشد یا pts فریم کمتر از
start_time + duration باشد، در غیر این صورت 0 است، و اگر متاداده start_time وجود
نداشته باشد NaN است.
.Sp
این اساساً بدان معناست که یک فریم ورودی در صورتی انتخاب می‌شود که pts آن در بازه
تعیین‌شده توسط دیمکسر concat قرار داشته باشد.
.IP "\fBiw\fR \fI(فقط ویدیو)\fR" 4
.IX Item "iw (video only)"
نمایانگر عرض فریم ویدیوی ورودی.
.IP "\fBih\fR \fI(فقط ویدیو)\fR" 4
.IX Item "ih (video only)"
نمایانگر ارتفاع فریم ویدیوی ورودی.
.IP "\fBview\fR \fI(فقط ویدیو)\fR" 4
.IX Item "view (video only)"
شناسه دید (View ID) برای ویدیوی چنددیدی (multi\-view).
.PP
مقدار پیش‌فرض عبارت select برابر "1" است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
انتخاب تمام فریم‌ها در ورودی:
.Sp
.Vb 1
\&        select
.Ve
.Sp
مثال بالا همانند زیر است:
.Sp
.Vb 1
\&        select=1
.Ve
.IP \(bu 4
نادیده گرفتن تمام فریم‌ها:
.Sp
.Vb 1
\&        select=0
.Ve
.IP \(bu 4
انتخاب فقط فریم‌های I:
.Sp
.Vb 1
\&        select=\*(Aqeq(pict_type\e,I)\*(Aq
.Ve
.IP \(bu 4
انتخاب یک فریم از هر ۱۰۰ فریم:
.Sp
.Vb 1
\&        select=\*(Aqnot(mod(n\e,100))\*(Aq
.Ve
.IP \(bu 4
انتخاب فقط فریم‌های قرارگرفته در بازه زمانی 10\-20:
.Sp
.Vb 1
\&        select=between(t\e,10\e,20)
.Ve
.IP \(bu 4
انتخاب فقط فریم‌های I قرارگرفته در بازه زمانی 10\-20:
.Sp
.Vb 1
\&        select=between(t\e,10\e,20)*eq(pict_type\e,I)
.Ve
.IP \(bu 4
انتخاب فریم‌ها با حداقل فاصله 10 ثانیه:
.Sp
.Vb 1
\&        select=\*(Aqisnan(prev_selected_t)+gte(t\-prev_selected_t\e,10)\*(Aq
.Ve
.IP \(bu 4
استفاده از aselect برای انتخاب فقط فریم‌های صوتی با تعداد نمونه‌های > 100:
.Sp
.Vb 1
\&        aselect=\*(Aqgt(samples_n\e,100)\*(Aq
.Ve
.IP \(bu 4
ایجاد یک موزاییک از نخستین صحنه‌ها:
.Sp
.Vb 1
\&        ffmpeg \-i video.avi \-vf select=\*(Aqgt(scene\e,0.4)\*(Aq,scale=160:120,tile \-frames:v 1 preview.png
.Ve
.Sp
مقایسه \fIscene\fR با مقداری بین 0.3 و 0.5 معمولاً یک انتخاب
منطقی است.
.IP \(bu 4
ارسال فریم‌های زوج و فرد به خروجی‌های جداگانه و ترکیب آن‌ها:
.Sp
.Vb 1
\&        select=n=2:e=\*(Aqmod(n, 2)+1\*(Aq [odd][even]; [odd] pad=h=2*ih [tmp]; [tmp][even] overlay=y=h
.Ve
.IP \(bu 4
انتخاب فریم‌های مفید از یک پرونده ffconcat که از inpointها و outpointها استفاده می‌کند
اما در آن پرونده‌های سورس فقط intra frame نیستند.
.Sp
.Vb 1
\&        ffmpeg \-copyts \-segment_time_metadata 1 \-i input.ffconcat \-fps_mode passthrough \-vf select=concatdec_select \-af aselect=concatdec_select output.avi
.Ve
.SS "sendcmd, asendcmd"
.IX Subsection "sendcmd, asendcmd"
ارسال دستورات به فیلترها در گراف فیلتر.
.PP
این فیلترها دستوراتی را می‌خوانند تا به سایر فیلترها در
گراف فیلتر ارسال شوند.
.PP
\&\f(CW\*(C`sendcmd\*(C'\fR باید بین دو فیلتر ویدیو درج شود،
و \f(CW\*(C`asendcmd\*(C'\fR باید بین دو فیلتر صدا درج شود، اما صرف‌نظر
از این به همان روش عمل می‌کنند.
.PP
تعیین مشخصات دستورات را می‌توان در آرگومان‌های فیلتر
با گزینه \fIcommands\fR یا در پرونده‌ای مشخص‌شده با گزینه
\&\fIfilename\fR ارائه داد.
.PP
این فیلترها گزینه‌های زیر را می‌پذیرند:
.IP "\fBcommands, c\fR" 4
.IX Item "commands, c"
تنظیم دستوراتی که باید خوانده شده و به سایر فیلترها ارسال شوند.
.IP "\fBfilename, f\fR" 4
.IX Item "filename, f"
تنظیم نام پرونده حاوی دستوراتی که باید خوانده شده و به سایر
فیلترها ارسال شوند.
.PP
\fIسینتکس دستورات\fR
.IX Subsection "Commands syntax"
.PP
یک توصیف دستورات شامل توالی‌ای از مشخصات بازه است،
شامل فهرستی از دستورات که هنگام رخ دادن رویدادی خاص مرتبط
با آن بازه اجرا می‌شوند. رویداد رخ‌داده معمولاً زمان فریم فعلی
هنگام ورود به یک بازه زمانی معین یا خروج از آن است.
.PP
یک بازه با سینتکس زیر مشخص می‌شود:
.PP
.Vb 1
\&        <START>[\-<END>] <COMMANDS>;
.Ve
.PP
بازه زمانی با زمان‌های \fISTART\fR و \fIEND\fR مشخص می‌شود.
\&\fIEND\fR اختیاری است و پیش‌فرض آن حداکثر زمان است.
.PP
زمان فریم فعلی در صورتی داخل بازه مشخص‌شده در نظر گرفته می‌شود
که در بازه [\fISTART\fR, \fIEND\fR) قرار داشته باشد، یعنی زمانی که
زمان بزرگ‌تر یا مساوی با \fISTART\fR و کمتر از
\&\fIEND\fR باشد.
.PP
بخش \fICOMMANDS\fR شامل توالی‌ای از یک یا چند مشخصه دستور،
جداشده با ","، مربوط به آن بازه است. سینتکس یک مشخصه دستور
به صورت زیر است:
.PP
.Vb 1
\&        [<FLAGS>] <TARGET> <COMMAND> <ARG>
.Ve
.PP
بخش \fIFLAGS\fR اختیاری است و نوع رویدادهای مرتبط با بازه زمانی را
مشخص می‌کند که ارسال دستور مشخص‌شده را فعال می‌سازند، و باید
دنباله‌ای غیرخالی از فلگ‌های شناسه باشد که با "+" یا "|" جدا شده
و بین "[" و "]" قرار گرفته‌اند.
.PP
فلگ‌های زیر شناخته‌شده هستند:
.IP \fBenter\fR 4
.IX Item "enter"
دستور زمانی ارسال می‌شود که برچسب زمانی فریم فعلی وارد بازه
مشخص‌شده شود. به عبارت دیگر، دستور زمانی ارسال می‌شود که برچسب زمانی فریم قبلی
در بازه داده‌شده نبوده و فریم فعلی در آن قرار دارد.
.IP \fBleave\fR 4
.IX Item "leave"
دستور زمانی ارسال می‌شود که برچسب زمانی فریم فعلی از بازه
مشخص‌شده خارج شود. به عبارت دیگر، دستور زمانی ارسال می‌شود که برچسب زمانی فریم قبلی
در بازه داده‌شده بوده و فریم فعلی در آن قرار ندارد.
.IP \fBexpr\fR 4
.IX Item "expr"
شناسه \fIARG\fR دستور به عنوان یک عبارت تفسیر می‌شود و نتیجه
عبارت به عنوان \fIARG\fR ارسال می‌گردد.
.Sp
این عبارت از طریق eval API ارزیابی می‌شود و می‌تواند شامل ثوابت
زیر باشد:
.RS 4
.IP \fBPOS\fR 4
.IX Item "POS"
موقعیت اصلی فریم در پرونده، یا در صورت تعریف نشدن برای فریم فعلی
تعریف‌نشده. منسوخ شده است، استفاده نکنید.
.IP \fBPTS\fR 4
.IX Item "PTS"
برچسب زمانی ارائه در ورودی.
.IP \fBN\fR 4
.IX Item "N"
شمارش فریم ورودی برای ویدیو یا صدا، شروع از 0.
.IP \fBT\fR 4
.IX Item "T"
زمان بر حسب ثانیه برای فریم فعلی.
.IP \fBTS\fR 4
.IX Item "TS"
زمان شروع بر حسب ثانیه برای بازه دستور فعلی.
.IP \fBTE\fR 4
.IX Item "TE"
زمان پایان بر حسب ثانیه برای بازه دستور فعلی.
.IP \fBTI\fR 4
.IX Item "TI"
زمان درون‌یابی‌شده بازه دستور فعلی، TI = (T \- TS) / (TE \- TS).
.IP \fBW\fR 4
.IX Item "W"
عرض فریم ویدیو.
.IP \fBH\fR 4
.IX Item "H"
ارتفاع فریم ویدیو.
.RE
.RS 4
.RE
.PP
اگر \fIFLAGS\fR مشخص نشود، مقدار پیش‌فرض \f(CW\*(C`[enter]\*(C'\fR در نظر
گرفته می‌شود.
.PP
بخش \fITARGET\fR هدف دستور را مشخص می‌کند، معمولاً نام
کلاس فیلتر یا نام یک نمونه فیلتر خاص.
.PP
بخش \fICOMMAND\fR نام دستور برای فیلتر هدف را مشخص می‌کند.
.PP
بخش \fIARG\fR اختیاری است و فهرست اختیاری آرگومان را برای
دستور \fICOMMAND\fR داده‌شده مشخص می‌کند.
.PP
بین یک مشخصه بازه و بازه دیگر، فاصله‌های خالی، یا
توالی نویسه‌هایی که با \f(CW\*(C`#\*(C'\fR شروع شده و تا انتهای خط ادامه دارند،
نادیده گرفته می‌شوند و می‌توان از آن‌ها برای نوشتن یادداشت‌ها استفاده کرد.
.PP
توصیف ساده‌شده BNF سینتکس مشخصات دستورات در
ادامه آمده است:
.PP
.Vb 6
\&        <COMMAND_FLAG>  ::= "enter" | "leave"
\&        <COMMAND_FLAGS> ::= <COMMAND_FLAG> [(+|"|")<COMMAND_FLAG>]
\&        <COMMAND>       ::= ["[" <COMMAND_FLAGS> "]"] <TARGET> <COMMAND> [<ARG>]
\&        <COMMANDS>      ::= <COMMAND> [,<COMMANDS>]
\&        <INTERVAL>      ::= <START>[\-<END>] <COMMANDS>
\&        <INTERVALS>     ::= <INTERVAL>[;<INTERVALS>]
.Ve
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تعیین تغییر تمپوی صدا در ثانیه 4:
.Sp
.Vb 1
\&        asendcmd=c=\*(Aq4.0 atempo tempo 1.5\*(Aq,atempo
.Ve
.IP \(bu 4
هدف قرار دادن یک نمونه فیلتر خاص:
.Sp
.Vb 1
\&        asendcmd=c=\*(Aq4.0 atempo@my tempo 1.5\*(Aq,atempo@my
.Ve
.IP \(bu 4
تعیین فهرستی از دستورات drawtext و hue در یک پرونده:
.Sp
.Vb 3
\&        # show text in the interval 5\-10
\&        5.0\-10.0 [enter] drawtext reinit \*(Aqfontfile=FreeSerif.ttf:text=hello world\*(Aq,
\&                 [leave] drawtext reinit \*(Aqfontfile=FreeSerif.ttf:text=\*(Aq;
\&        
\&        # desaturate the image in the interval 15\-20
\&        15.0\-20.0 [enter] hue s 0,
\&                  [enter] drawtext reinit \*(Aqfontfile=FreeSerif.ttf:text=nocolor\*(Aq,
\&                  [leave] hue s 1,
\&                  [leave] drawtext reinit \*(Aqfontfile=FreeSerif.ttf:text=color\*(Aq;
\&        
\&        # apply an exponential saturation fade\-out effect, starting from time 25
\&        25 [enter] hue s exp(25\-t)
.Ve
.Sp
یک گراف فیلتر که امکان خواندن و پردازش فهرست دستورات بالا را که
در پرونده \fItest.cmd\fR ذخیره شده فراهم می‌کند، می‌تواند به صورت زیر مشخص شود:
.Sp
.Vb 1
\&        sendcmd=f=test.cmd,drawtext=fontfile=FreeSerif.ttf:text=\*(Aq\*(Aq,hue
.Ve
.SS "setpts, asetpts"
.IX Subsection "setpts, asetpts"
تغییر PTS (برچسب زمانی ارائه) فریم‌های ورودی.
.PP
\&\f(CW\*(C`setpts\*(C'\fR بر روی فریم‌های ویدیو، و \f(CW\*(C`asetpts\*(C'\fR بر روی فریم‌های صدا کار می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBexpr\fR 4
.IX Item "expr"
عبارتی که برای هر فریم به منظور ساخت برچسب زمانی آن ارزیابی می‌شود.
.IP "\fBstrip_fps (\fR\fIفقط ویدیو\fR\fB)\fR" 4
.IX Item "strip_fps (video only)"
گزینه بولی که تعیین می‌کند آیا متاداده نرخ فریم و مدت‌زمان فریم اصلی
حذف شود یا خیر. اگر روی true تنظیم شود، توجه داشته باشید که در صورت ارسال
خروجی به یک مکسر با نرخ فریم ثابت، باید یک نرخ فریم معقول صراحتاً
مشخص گردد. پیش‌فرض \f(CW\*(C`false\*(C'\fR است.
.PP
این عبارت از طریق eval API ارزیابی می‌شود و می‌تواند شامل ثوابت
زیر باشد:
.IP "\fBFRAME_RATE, FR\fR" 4
.IX Item "FRAME_RATE, FR"
نرخ فریم، تنها برای ویدیوی با نرخ فریم ثابت تعریف شده است
.IP \fBPTS\fR 4
.IX Item "PTS"
برچسب زمانی ارائه در ورودی
.IP \fBN\fR 4
.IX Item "N"
شمارش فریم ورودی برای ویدیو یا تعداد نمونه‌های مصرف‌شده،
بدون احتساب فریم فعلی برای صدا، شروع از 0.
.IP \fBNB_CONSUMED_SAMPLES\fR 4
.IX Item "NB_CONSUMED_SAMPLES"
تعداد نمونه‌های مصرف‌شده، بدون احتساب فریم فعلی (فقط
صدا)
.IP "\fBNB_SAMPLES, S\fR" 4
.IX Item "NB_SAMPLES, S"
تعداد نمونه‌ها در فریم فعلی (فقط صدا)
.IP "\fBSAMPLE_RATE, SR\fR" 4
.IX Item "SAMPLE_RATE, SR"
نرخ نمونه‌برداری صدا.
.IP \fBSTARTPTS\fR 4
.IX Item "STARTPTS"
مقدار PTS فریم اول.
.IP \fBSTARTT\fR 4
.IX Item "STARTT"
زمان بر حسب ثانیه برای فریم اول
.IP \fBINTERLACED\fR 4
.IX Item "INTERLACED"
بیان اینکه آیا فریم فعلی اینترلیس است یا خیر.
.IP \fBT\fR 4
.IX Item "T"
زمان بر حسب ثانیه برای فریم فعلی
.IP \fBPOS\fR 4
.IX Item "POS"
موقعیت اصلی فریم در پرونده، یا در صورت تعریف نشدن برای
فریم فعلی تعریف‌نشده؛ منسوخ شده است، استفاده نکنید
.IP \fBPREV_INPTS\fR 4
.IX Item "PREV_INPTS"
مقدار PTS ورودی قبلی.
.IP \fBPREV_INT\fR 4
.IX Item "PREV_INT"
زمان ورودی قبلی بر حسب ثانیه
.IP \fBPREV_OUTPTS\fR 4
.IX Item "PREV_OUTPTS"
مقدار PTS خروجی قبلی.
.IP \fBPREV_OUTT\fR 4
.IX Item "PREV_OUTT"
زمان خروجی قبلی بر حسب ثانیه
.IP \fBRTCTIME\fR 4
.IX Item "RTCTIME"
زمان ساعت دیواری (RTC) بر حسب میکروثانیه. این متغیر منسوخ شده است، به جای آن از \fBtime\fR\|(0)
استفاده کنید.
.IP \fBRTCSTART\fR 4
.IX Item "RTCSTART"
زمان ساعت دیواری (RTC) در شروع فیلم بر حسب میکروثانیه.
.IP \fBTB\fR 4
.IX Item "TB"
پایه زمانی برچسب‌های زمانی ورودی.
.IP \fBT_CHANGE\fR 4
.IX Item "T_CHANGE"
زمان اولین فریم پس از اعمال دستور یا زمان اولین فریم در صورت عدم وجود دستورات.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
شروع شمارش PTS از صفر:
.Sp
.Vb 1
\&        setpts=PTS\-STARTPTS
.Ve
.IP \(bu 4
اعمال اثر حرکت سریع (fast motion):
.Sp
.Vb 1
\&        setpts=0.5*PTS
.Ve
.IP \(bu 4
اعمال اثر حرکت آهسته (slow motion):
.Sp
.Vb 1
\&        setpts=2.0*PTS
.Ve
.IP \(bu 4
تنظیم نرخ ثابت 25 فریم در ثانیه:
.Sp
.Vb 1
\&        setpts=N/(25*TB)
.Ve
.IP \(bu 4
اعمال یک اثر لرزش (jitter) تصادفی به میزان +/\-100 واحد TB:
.Sp
.Vb 1
\&        setpts=PTS+randomi(0, \-100\e,100)
.Ve
.IP \(bu 4
تنظیم نرخ ثابت 25 فریم در ثانیه با مقداری لرزش:
.Sp
.Vb 1
\&        setpts=\*(Aq1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))\*(Aq
.Ve
.IP \(bu 4
اعمال یک آفست 10 ثانیه‌ای به PTS ورودی:
.Sp
.Vb 1
\&        setpts=PTS+10/TB
.Ve
.IP \(bu 4
تولید برچسب‌های زمانی از یک "سورس زنده" و بازپایه‌گذاری روی پایه زمانی فعلی:
.Sp
.Vb 1
\&        setpts=\*(Aq(RTCTIME \- RTCSTART) / (TB * 1000000)\*(Aq
.Ve
.IP \(bu 4
تولید برچسب‌های زمانی با شمارش نمونه‌ها:
.Sp
.Vb 1
\&        asetpts=N/SR/TB
.Ve
.PP
\fIدستورات\fR
.IX Subsection "Commands"
.PP
هر دو فیلتر از تمام گزینه‌های بالا به عنوان \fBدستورات\fR پشتیبانی می‌کنند.
.SS setrange
.IX Subsection "setrange"
اجبار محدوده رنگ برای فریم ویدیوی خروجی.
.PP
فیلتر \f(CW\*(C`setrange\*(C'\fR ویژگی محدوده رنگ را برای
فریم‌های خروجی علامت‌گذاری می‌کند. این فیلتر فریم ورودی را تغییر نمی‌دهد، بلکه فقط
ویژگی متناظر را تنظیم می‌کند، که بر نحوه رفتار فیلترهای بعدی با
فریم تأثیر می‌گذارد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBrange\fR 4
.IX Item "range"
مقادیر موجود عبارتند از:
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
حفظ همان ویژگی محدوده رنگ.
.IP "\fBunspecified, unknown\fR" 4
.IX Item "unspecified, unknown"
تنظیم محدوده رنگ به عنوان نامشخص.
.IP "\fBlimited, tv, mpeg\fR" 4
.IX Item "limited, tv, mpeg"
تنظیم محدوده رنگ به عنوان محدود (limited).
.IP "\fBfull, pc, jpeg\fR" 4
.IX Item "full, pc, jpeg"
تنظیم محدوده رنگ به عنوان کامل (full).
.RE
.RS 4
.RE
.SS "settb, asettb"
.IX Subsection "settb, asettb"
تنظیم پایه زمانی مورد استفاده برای برچسب‌های زمانی فریم‌های خروجی.
این فیلتر عمدتاً برای آزمایش پیکربندی پایه زمانی مفید است.
.PP
این فیلتر پارامترهای زیر را می‌پذیرد:
.IP "\fBexpr, tb\fR" 4
.IX Item "expr, tb"
عبارتی که به پایه زمانی خروجی ارزیابی می‌شود.
.PP
مقدار \fBtb\fR یک عبارت محاسباتی است که یک عدد گویا (کسری) را نشان می‌دهد.
این عبارت می‌تواند شامل ثوابت "AVTB" (پایه زمانی پیش‌فرض)،
"intb" (پایه زمانی ورودی) و "sr" (نرخ نمونه‌برداری، فقط صدا) باشد.
مقدار پیش‌فرض "intb" است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
تنظیم پایه زمانی به 1/25:
.Sp
.Vb 1
\&        settb=expr=1/25
.Ve
.IP \(bu 4
تنظیم پایه زمانی به 1/10:
.Sp
.Vb 1
\&        settb=expr=0.1
.Ve
.IP \(bu 4
تنظیم پایه زمانی به 1001/1000:
.Sp
.Vb 1
\&        settb=1+0.001
.Ve
.IP \(bu 4
تنظیم پایه زمانی به 2*intb:
.Sp
.Vb 1
\&        settb=2*intb
.Ve
.IP \(bu 4
تنظیم مقدار پیش‌فرض پایه زمانی:
.Sp
.Vb 1
\&        settb=AVTB
.Ve
.SS showcqt
.IX Subsection "showcqt"
تبدیل صدای ورودی به یک خروجی ویدیو که طیف فرکانسی را
به صورت لگاریتمی با استفاده از الگوریتم تبدیل کیو ثابت براون\-پاکت (Brown\-Puckette constant Q transform)
با محاسبه مستقیم ضرایب در حوزه فرکانس بازنمایی می‌کند (اما خود تبدیل
واقعاً Q ثابت نیست، بلکه ضریب Q در واقع متغیر/محدودشده است)،
با مقیاس تن موسیقی، از E0 تا D#10.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. باید زوج باشد. برای سینتکس این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`1920x1080\*(C'\fR است.
.IP "\fBfps, rate, r\fR" 4
.IX Item "fps, rate, r"
تنظیم نرخ فریم خروجی. مقدار پیش‌فرض \f(CW25\fR است.
.IP \fBbar_h\fR 4
.IX Item "bar_h"
تنظیم ارتفاع نمودار میله‌ای (bargraph). باید زوج باشد. مقدار پیش‌فرض \f(CW\-1\fR است که
ارتفاع نمودار میله‌ای را به طور خودکار محاسبه می‌کند.
.IP \fBaxis_h\fR 4
.IX Item "axis_h"
تنظیم ارتفاع محور. باید زوج باشد. مقدار پیش‌فرض \f(CW\-1\fR است که ارتفاع
محور را به طور خودکار محاسبه می‌کند.
.IP \fBsono_h\fR 4
.IX Item "sono_h"
تنظیم ارتفاع سونوگرام. باید زوج باشد. مقدار پیش‌فرض \f(CW\-1\fR است که
ارتفاع سونوگرام را به طور خودکار محاسبه می‌کند.
.IP \fBfullhd\fR 4
.IX Item "fullhd"
تنظیم وضوح fullhd. این گزینه منسوخ شده است، به جای آن از \fIsize\fR، \fIs\fR
استفاده کنید. مقدار پیش‌فرض \f(CW1\fR است.
.IP "\fBsono_v, volume\fR" 4
.IX Item "sono_v, volume"
تعیین عبارت بلندی صدای سونوگرام. می‌تواند شامل متغیرهای زیر باشد:
.RS 4
.IP \fBbar_v\fR 4
.IX Item "bar_v"
عبارت ارزیابی‌شده \fIbar_v\fR
.IP "\fBfrequency, freq, f\fR" 4
.IX Item "frequency, freq, f"
فرکانسی که در آن ارزیابی می‌شود
.IP "\fBtimeclamp, tc\fR" 4
.IX Item "timeclamp, tc"
مقدار گزینه \fItimeclamp\fR
.RE
.RS 4
.Sp
و توابع:
.IP \fBa_weighting(f)\fR 4
.IX Item "a_weighting(f)"
وزن‌دهی A برای بلندی صدای برابر
.IP \fBb_weighting(f)\fR 4
.IX Item "b_weighting(f)"
وزن‌دهی B برای بلندی صدای برابر
.IP \fBc_weighting(f)\fR 4
.IX Item "c_weighting(f)"
وزن‌دهی C برای بلندی صدای برابر.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW16\fR است.
.RE
.IP "\fBbar_v, volume2\fR" 4
.IX Item "bar_v, volume2"
تعیین عبارت بلندی صدای نمودار میله‌ای. می‌تواند شامل متغیرهای زیر باشد:
.RS 4
.IP \fBsono_v\fR 4
.IX Item "sono_v"
عبارت ارزیابی‌شده \fIsono_v\fR
.IP "\fBfrequency, freq, f\fR" 4
.IX Item "frequency, freq, f"
فرکانسی که در آن ارزیابی می‌شود
.IP "\fBtimeclamp, tc\fR" 4
.IX Item "timeclamp, tc"
مقدار گزینه \fItimeclamp\fR
.RE
.RS 4
.Sp
و توابع:
.IP \fBa_weighting(f)\fR 4
.IX Item "a_weighting(f)"
وزن‌دهی A برای بلندی صدای برابر
.IP \fBb_weighting(f)\fR 4
.IX Item "b_weighting(f)"
وزن‌دهی B برای بلندی صدای برابر
.IP \fBc_weighting(f)\fR 4
.IX Item "c_weighting(f)"
وزن‌دهی C برای بلندی صدای برابر.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`sono_v\*(C'\fR است.
.RE
.IP "\fBsono_g, gamma\fR" 4
.IX Item "sono_g, gamma"
تعیین گامای سونوگرام. گامای پایین‌تر کنتراست طیف را بیشتر می‌کند،
گامای بالاتر باعث می‌شود طیف محدوده بیشتری داشته باشد. مقدار پیش‌فرض \f(CW3\fR است.
محدوده قابل قبول \f(CW\*(C`[1, 7]\*(C'\fR است.
.IP "\fBbar_g, gamma2\fR" 4
.IX Item "bar_g, gamma2"
تعیین گامای نمودار میله‌ای. مقدار پیش‌فرض \f(CW1\fR است. محدوده قابل قبول
\&\f(CW\*(C`[1, 7]\*(C'\fR است.
.IP \fBbar_t\fR 4
.IX Item "bar_t"
تعیین سطح شفافیت نمودار میله‌ای. مقدار کمتر نمودار میله‌ای را واضح‌تر می‌سازد.
مقدار پیش‌فرض \f(CW1\fR است. محدوده قابل قبول \f(CW\*(C`[0, 1]\*(C'\fR است.
.IP "\fBtimeclamp, tc\fR" 4
.IX Item "timeclamp, tc"
تعیین timeclamp تبدیل. در فرکانس‌های پایین، موازنه‌ای بین
دقت در حوزه زمان و حوزه فرکانس وجود دارد. اگر timeclamp کمتر باشد،
رویداد در حوزه زمان با دقت بیشتری بازنمایی می‌شود (مانند طبل باس سریع)،
در غیر این صورت رویداد در حوزه فرکانس با دقت بیشتری بازنمایی می‌شود
(مانند گیتار باس). محدوده قابل قبول \f(CW\*(C`[0.002, 1]\*(C'\fR است. مقدار پیش‌فرض \f(CW0.17\fR است.
.IP \fBattack\fR 4
.IX Item "attack"
تنظیم زمان خیز (attack) بر حسب ثانیه. پیش‌فرض \f(CW0\fR (غیرفعال) است. در غیر این صورت،
نمونه‌های آینده را با اعمال پنجره‌بندی نامتقارن در حوزه زمان محدود می‌کند، که زمانی که
تأخیر کم مورد نیاز باشد مفید است. محدوده پذیرفته‌شده \f(CW\*(C`[0, 1]\*(C'\fR است.
.IP \fBbasefreq\fR 4
.IX Item "basefreq"
تعیین فرکانس پایه تبدیل. مقدار پیش‌فرض \f(CW20.01523126408007475\fR است،
که فرکانس ۵۰ سنت زیر E0 است. محدوده قابل قبول \f(CW\*(C`[10, 100000]\*(C'\fR است.
.IP \fBendfreq\fR 4
.IX Item "endfreq"
تعیین فرکانس پایانی تبدیل. مقدار پیش‌فرض \f(CW20495.59681441799654\fR است،
که فرکانس ۵۰ سنت بالای D#10 است. محدوده قابل قبول \f(CW\*(C`[10, 100000]\*(C'\fR است.
.IP \fBcoeffclamp\fR 4
.IX Item "coeffclamp"
این گزینه منسوخ شده و نادیده گرفته می‌شود.
.IP \fBtlength\fR 4
.IX Item "tlength"
تعیین طول تبدیل در حوزه زمان. از این گزینه برای کنترل موازنه دقت
بین حوزه زمان و حوزه فرکانس در هر نمونه فرکانسی استفاده کنید.
می‌تواند شامل متغیرهای زیر باشد:
.RS 4
.IP "\fBfrequency, freq, f\fR" 4
.IX Item "frequency, freq, f"
فرکانسی که در آن ارزیابی می‌شود
.IP "\fBtimeclamp, tc\fR" 4
.IX Item "timeclamp, tc"
مقدار گزینه \fItimeclamp\fR.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`384*tc/(384+tc*f)\*(C'\fR است.
.RE
.IP \fBcount\fR 4
.IX Item "count"
تعیین تعداد تبدیل برای هر فریم ویدیو. مقدار پیش‌فرض \f(CW6\fR است.
محدوده قابل قبول \f(CW\*(C`[1, 30]\*(C'\fR است.
.IP \fBfcount\fR 4
.IX Item "fcount"
تعیین تعداد تبدیل برای هر تک‌پیکسل. مقدار پیش‌فرض \f(CW0\fR است،
که باعث می‌شود به طور خودکار محاسبه شود. محدوده قابل قبول \f(CW\*(C`[0, 10]\*(C'\fR است.
.IP \fBfontfile\fR 4
.IX Item "fontfile"
تعیین پرونده قلم برای استفاده با freetype جهت رسم محور. اگر مشخص نشود،
از قلم تعبیه‌شده استفاده می‌شود. توجه داشته باشید که رسم با پرونده قلم یا قلم تعبیه‌شده
با مقادیر سفارشی \fIbasefreq\fR و \fIendfreq\fR پیاده‌سازی نشده است، به جای آن
از گزینه \fIaxisfile\fR استفاده کنید.
.IP \fBfont\fR 4
.IX Item "font"
تعیین الگوی fontconfig. این گزینه اولویت کمتری نسبت به \fIfontfile\fR دارد.
نویسه \f(CW\*(C`:\*(C'\fR در الگو ممکن است با \f(CW\*(C`|\*(C'\fR جایگزین شود تا از گریزهای
غیرضروری جلوگیری شود.
.IP \fBfontcolor\fR 4
.IX Item "fontcolor"
تعیین عبارت رنگ قلم. این یک عبارت محاسباتی است که باید
مقدار صحیح 0xRRGGBB را برگرداند. می‌تواند شامل متغیرهای زیر باشد:
.RS 4
.IP "\fBfrequency, freq, f\fR" 4
.IX Item "frequency, freq, f"
فرکانسی که در آن ارزیابی می‌شود
.IP "\fBtimeclamp, tc\fR" 4
.IX Item "timeclamp, tc"
مقدار گزینه \fItimeclamp\fR
.RE
.RS 4
.Sp
و توابع:
.IP \fBmidi(f)\fR 4
.IX Item "midi(f)"
شماره مدی برای فرکانس f، برخی شماره‌های مدی: E0(16), C1(24), C2(36), A4(69)
.IP "\fBr(x), g(x), b(x)\fR" 4
.IX Item "r(x), g(x), b(x)"
مقدار قرمز، سبز و آبی برای شدت x.
.RE
.RS 4
.Sp
مقدار پیش‌فرض عبارت است از:
\&\f(CW\*(C`st(0, (midi(f)\-59.5)/12);
st(1, if(between(ld(0),0,1), 0.5\-0.5*cos(2*PI*ld(0)), 0));
r(1\-ld(1)) + b(ld(1))\*(C'\fR.
.RE
.IP \fBaxisfile\fR 4
.IX Item "axisfile"
تعیین پرونده تصویر برای رسم محور. این گزینه بر گزینه‌های \fIfontfile\fR و
\&\fIfontcolor\fR اولویت دارد.
.IP "\fBaxis, text\fR" 4
.IX Item "axis, text"
فعال/غیرفعال کردن رسم متن روی محور. اگر روی \f(CW0\fR تنظیم شود، رسم روی
محور غیرفعال شده و گزینه‌های \fIfontfile\fR و \fIaxisfile\fR نادیده گرفته می‌شوند.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBcsp\fR 4
.IX Item "csp"
تنظیم فضای رنگی (colorspace). مقادیر پذیرفته‌شده عبارتند از:
.RS 4
.IP \fBunspecified\fR 4
.IX Item "unspecified"
نامشخص (پیش‌فرض)
.IP \fBbt709\fR 4
.IX Item "bt709"
BT.709
.IP \fBfcc\fR 4
.IX Item "fcc"
FCC
.IP \fBbt470bg\fR 4
.IX Item "bt470bg"
BT.470BG یا BT.601\-6 625
.IP \fBsmpte170m\fR 4
.IX Item "smpte170m"
SMPTE\-170M یا BT.601\-6 525
.IP \fBsmpte240m\fR 4
.IX Item "smpte240m"
SMPTE\-240M
.IP \fBbt2020ncl\fR 4
.IX Item "bt2020ncl"
BT.2020 با درخشندگی غیرثابت (non\-constant luminance)
.RE
.RS 4
.RE
.IP \fBcscheme\fR 4
.IX Item "cscheme"
تنظیم طرح رنگ اسپکتروگرام. این فهرستی از مقادیر ممیز شناور با فرمت
\&\f(CW\*(C`left_r|left_g|left_b|right_r|right_g|right_b\*(C'\fR است.
پیش‌فرض \f(CW\*(C`1|0.5|0|0|0.5|1\*(C'\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
پخش صدا همزمان با نمایش طیف:
.Sp
.Vb 1
\&        ffplay \-f lavfi \*(Aqamovie=a.mp3, asplit [a][out1]; [a] showcqt [out0]\*(Aq
.Ve
.IP \(bu 4
همانند بالا، اما با نرخ فریم 30 فریم در ثانیه:
.Sp
.Vb 1
\&        ffplay \-f lavfi \*(Aqamovie=a.mp3, asplit [a][out1]; [a] showcqt=fps=30:count=5 [out0]\*(Aq
.Ve
.IP \(bu 4
پخش در وضوح 1280x720:
.Sp
.Vb 1
\&        ffplay \-f lavfi \*(Aqamovie=a.mp3, asplit [a][out1]; [a] showcqt=s=1280x720:count=4 [out0]\*(Aq
.Ve
.IP \(bu 4
غیرفعال کردن نمایش سونوگرام:
.Sp
.Vb 1
\&        sono_h=0
.Ve
.IP \(bu 4
نت A1 و هارمونیک‌های آن: A1, A2, (near)E3, A3:
.Sp
.Vb 2
\&        ffplay \-f lavfi \*(Aqaevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t),
\&                         asplit[a][out1]; [a] showcqt [out0]\*(Aq
.Ve
.IP \(bu 4
همانند بالا، اما با دقت بیشتر در حوزه فرکانس:
.Sp
.Vb 2
\&        ffplay \-f lavfi \*(Aqaevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t),
\&                         asplit[a][out1]; [a] showcqt=timeclamp=0.5 [out0]\*(Aq
.Ve
.IP \(bu 4
بلندی صدای سفارشی:
.Sp
.Vb 1
\&        bar_v=10:sono_v=bar_v*a_weighting(f)
.Ve
.IP \(bu 4
گامای سفارشی، اکنون طیف نسبت به دامنه خطی است:
.Sp
.Vb 1
\&        bar_g=2:sono_g=2
.Ve
.IP \(bu 4
معادله سفارشی tlength:
.Sp
.Vb 1
\&        tc=0.33:tlength=\*(Aqst(0,0.17); 384*tc / (384 / ld(0) + tc*f /(1\-ld(0))) + 384*tc / (tc*f / ld(0) + 384 /(1\-ld(0)))\*(Aq
.Ve
.IP \(bu 4
قلم و رنگ قلم سفارشی، نت C با رنگ سبز و بقیه با رنگ آبی نمایش داده می‌شوند:
.Sp
.Vb 1
\&        fontcolor=\*(Aqif(mod(floor(midi(f)+0.5),12), 0x0000FF, g(1))\*(Aq:fontfile=myfont.ttf
.Ve
.IP \(bu 4
قلم سفارشی با استفاده از fontconfig:
.Sp
.Vb 1
\&        font=\*(AqCourier New,Monospace,mono|bold\*(Aq
.Ve
.IP \(bu 4
محدوده فرکانس سفارشی با محور سفارشی با استفاده از پرونده تصویر:
.Sp
.Vb 1
\&        axisfile=myaxis.png:basefreq=40:endfreq=10000
.Ve
.SS showcwt
.IX Subsection "showcwt"
تبدیل صدای ورودی به خروجی ویدیو که طیف فرکانسی را
با استفاده از تبدیل موجک پیوسته (Continuous Wavelet Transform) و موجک مورلت بازنمایی می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای سینتکس این گزینه،
بخش \fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`640x512\*(C'\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی. مقدار پیش‌فرض \f(CW25\fR است.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس فرکانسی مورد استفاده. مقادیر مجاز عبارتند از:
.RS 4
.IP \fBlinear\fR 4
.IX Item "linear"
.PD 0
.IP \fBlog\fR 4
.IX Item "log"
.IP \fBbark\fR 4
.IX Item "bark"
.IP \fBmel\fR 4
.IX Item "mel"
.IP \fBerbs\fR 4
.IX Item "erbs"
.IP \fBsqrt\fR 4
.IX Item "sqrt"
.IP \fBcbrt\fR 4
.IX Item "cbrt"
.IP \fBqdrt\fR 4
.IX Item "qdrt"
.IP \fBfm\fR 4
.IX Item "fm"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`linear\*(C'\fR است.
.RE
.IP \fBiscale\fR 4
.IX Item "iscale"
تنظیم مقیاس شدت مورد استفاده. مقادیر مجاز عبارتند از:
.RS 4
.IP \fBlinear\fR 4
.IX Item "linear"
.PD 0
.IP \fBlog\fR 4
.IX Item "log"
.IP \fBsqrt\fR 4
.IX Item "sqrt"
.IP \fBcbrt\fR 4
.IX Item "cbrt"
.IP \fBqdrt\fR 4
.IX Item "qdrt"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`log\*(C'\fR است.
.RE
.IP \fBmin\fR 4
.IX Item "min"
تنظیم حداقل فرکانسی که در خروجی استفاده خواهد شد.
پیش‌فرض \f(CW20\fR هرتز است.
.IP \fBmax\fR 4
.IX Item "max"
تنظیم حداکثر فرکانسی که در خروجی استفاده خواهد شد.
پیش‌فرض \f(CW20000\fR هرتز است. حد بالای فرکانس واقعی
به نرخ نمونه‌برداری صدای ورودی بستگی دارد و هنگامی که مقداری
بزرگ‌تر از فرکانس نایکویست تنظیم شود، این محدودیت روی این مقدار اعمال خواهد شد.
.IP \fBimin\fR 4
.IX Item "imin"
تنظیم حداقل شدتی که در خروجی استفاده خواهد شد.
.IP \fBimax\fR 4
.IX Item "imax"
تنظیم حداکثر شدتی که در خروجی استفاده خواهد شد.
.IP \fBlogb\fR 4
.IX Item "logb"
تنظیم مبنای لگاریتمی برای میزان روشنایی هنگام
نگاشت مقادیر بزرگی محاسبه‌شده به مقادیر پیکسل.
محدوده مجاز از \f(CW0\fR تا \f(CW1\fR است.
مقدار پیش‌فرض \f(CW0.0001\fR است.
.IP \fBdeviation\fR 4
.IX Item "deviation"
تنظیم انحراف فرکانس.
مقادیر کمتر از \f(CW1\fR بیشتر مبتنی بر فرکانس هستند،
در حالی که مقادیر بیشتر از \f(CW1\fR بیشتر مبتنی بر زمان هستند.
محدوده مجاز از \f(CW0\fR تا \f(CW10\fR است.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBpps\fR 4
.IX Item "pps"
تنظیم تعداد پیکسل‌های خروجی در هر ثانیه در یک سطر.
محدوده مجاز از \f(CW1\fR تا \f(CW1024\fR است.
مقدار پیش‌فرض \f(CW64\fR است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت بصری خروجی. مقادیر مجاز عبارتند از:
.RS 4
.IP \fBmagnitude\fR 4
.IX Item "magnitude"
نمایش بزرگی (دامنه).
.IP \fBphase\fR 4
.IX Item "phase"
نمایش فقط فاز.
.IP \fBmagphase\fR 4
.IX Item "magphase"
نمایش ترکیب بزرگی و فاز.
بزرگی به روشنایی و فاز به رنگ نگاشت می‌شود.
.IP \fBchannel\fR 4
.IX Item "channel"
نمایش رنگ منحصربه‌فرد برای بزرگی هر کانال.
.IP \fBstereo\fR 4
.IX Item "stereo"
نمایش رنگ منحصربه‌فرد برای اختلاف استریو.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`magnitude\*(C'\fR است.
.RE
.IP \fBslide\fR 4
.IX Item "slide"
تنظیم روش لغزش خروجی. مقادیر مجاز عبارتند از:
.RS 4
.IP \fBreplace\fR 4
.IX Item "replace"
.PD 0
.IP \fBscroll\fR 4
.IX Item "scroll"
.IP \fBframe\fR 4
.IX Item "frame"
.PD
.RE
.RS 4
.RE
.IP \fBdirection\fR 4
.IX Item "direction"
تنظیم روش جهت برای روش لغزش خروجی. مقادیر مجاز عبارتند از:
.RS 4
.IP \fBlr\fR 4
.IX Item "lr"
جهت از چپ به راست.
.IP \fBrl\fR 4
.IX Item "rl"
جهت از راست به چپ.
.IP \fBud\fR 4
.IX Item "ud"
جهت از بالا به پایین.
.IP \fBdu\fR 4
.IX Item "du"
جهت از پایین به بالا.
.RE
.RS 4
.RE
.IP \fBbar\fR 4
.IX Item "bar"
تنظیم نسبت نمایش نمودار میله‌ای به اندازه نمایش. پیش‌فرض 0 است.
.IP \fBrotation\fR 4
.IX Item "rotation"
تنظیم چرخش رنگ، باید در محدوده [\-1.0, 1.0] باشد.
مقدار پیش‌فرض \f(CW0\fR است.
.SS showfreqs
.IX Subsection "showfreqs"
تبدیل صدای ورودی به خروجی ویدیویی که طیف توان صوتی را نمایش می‌دهد.
دامنه صدا بر روی محور Y قرار دارد در حالی که بسامد (فرکانس) بر روی محور X است.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
پیش‌فرض \f(CW\*(C`1024x512\*(C'\fR است.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم ویدیو. پیش‌فرض \f(CW25\fR است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت نمایش.
این گزینه مشخص می‌کند که هر بخش فرکانسی (frequency bin) چگونه نمایش داده شود.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBline\fR 4
.IX Item "line"
.PD 0
.IP \fBbar\fR 4
.IX Item "bar"
.IP \fBdot\fR 4
.IX Item "dot"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`bar\*(C'\fR است.
.RE
.IP \fBascale\fR 4
.IX Item "ascale"
تنظیم مقیاس دامنه.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
مقیاس خطی.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
مقیاس ریشه دوم.
.IP \fBcbrt\fR 4
.IX Item "cbrt"
مقیاس ریشه سوم.
.IP \fBlog\fR 4
.IX Item "log"
مقیاس لگاریتمی.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`log\*(C'\fR است.
.RE
.IP \fBfscale\fR 4
.IX Item "fscale"
تنظیم مقیاس فرکانس.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
مقیاس خطی.
.IP \fBlog\fR 4
.IX Item "log"
مقیاس لگاریتمی.
.IP \fBrlog\fR 4
.IX Item "rlog"
مقیاس لگاریتمی معکوس.
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`lin\*(C'\fR است.
.RE
.IP \fBwin_size\fR 4
.IX Item "win_size"
تنظیم اندازه پنجره. محدوده مجاز از 16 تا 65536 است.
.Sp
پیش‌فرض \f(CW2048\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره‌گذاری.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP \fBhanning\fR 4
.IX Item "hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`hanning\*(C'\fR است.
.RE
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم همپوشانی پنجره. در محدوده \f(CW\*(C`[0, 1]\*(C'\fR. مقدار پیش‌فرض \f(CW1\fR است،
به این معنی که همپوشانی بهینه برای تابع پنجره انتخاب‌شده برگزیده خواهد شد.
.IP \fBaveraging\fR 4
.IX Item "averaging"
تنظیم میانگین‌گیری زمانی. تنظیم این گزینه بر روی 0 قله‌های بیشینه فعلی را نمایش می‌دهد.
پیش‌فرض \f(CW1\fR است که به معنی غیرفعال بودن میانگین‌گیری زمانی است.
.IP \fBcolors\fR 4
.IX Item "colors"
تعیین فهرست رنگ‌ها جداشده با فاصله یا با \*(Aq|\*(Aq که برای
رسم فرکانس‌های کانال استفاده خواهند شد. رنگ‌های ناشناخته یا از قلم افتاده با
رنگ سفید جایگزین خواهند شد.
.IP \fBcmode\fR 4
.IX Item "cmode"
تنظیم حالت نمایش کانال.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBcombined\fR 4
.IX Item "combined"
.PD 0
.IP \fBseparate\fR 4
.IX Item "separate"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`combined\*(C'\fR است.
.RE
.IP \fBminamp\fR 4
.IX Item "minamp"
تنظیم حداقل دامنه استفاده‌شده در مقیاس‌بخش دامنه \f(CW\*(C`log\*(C'\fR.
.IP \fBdata\fR 4
.IX Item "data"
تنظیم حالت نمایش داده.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBmagnitude\fR 4
.IX Item "magnitude"
.PD 0
.IP \fBphase\fR 4
.IX Item "phase"
.IP \fBdelay\fR 4
.IX Item "delay"
.PD
.RE
.RS 4
.Sp
پیش‌فرض \f(CW\*(C`magnitude\*(C'\fR است.
.RE
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم کانال‌های مورد استفاده هنگام پردازش صدا. به طور پیش‌فرض تمام کانال‌ها پردازش می‌شوند.
.SS showspatial
.IX Subsection "showspatial"
تبدیل صدای ورودی استریو به یک خروجی ویدیو که رابطه فضایی بین دو کانال را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`512x512\*(C'\fR است.
.IP \fBwin_size\fR 4
.IX Item "win_size"
تنظیم اندازه پنجره. محدوده مجاز از \fI1024\fR تا \fI65536\fR است. اندازه پیش‌فرض \fI4096\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP \fBhann\fR 4
.IX Item "hann"
.IP \fBhanning\fR 4
.IX Item "hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی.
.SS showspectrum
.IX Subsection "showspectrum"
تبدیل صدای ورودی به یک خروجی ویدیو که طیف فرکانسی صدا را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`640x512\*(C'\fR است.
.IP \fBslide\fR 4
.IX Item "slide"
تعیین چگونگی لغزش طیف در طول پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBreplace\fR 4
.IX Item "replace"
نمونه‌ها پس از رسیدن به سمت راست، مجدداً از سمت چپ آغاز می‌شوند
.IP \fBscroll\fR 4
.IX Item "scroll"
نمونه‌ها از راست به چپ پیمایش می‌شوند
.IP \fBfullframe\fR 4
.IX Item "fullframe"
فریم‌ها تنها زمانی تولید می‌شوند که نمونه‌ها به سمت راست برسند
.IP \fBrscroll\fR 4
.IX Item "rscroll"
نمونه‌ها از چپ به راست پیمایش می‌شوند
.IP \fBlreplace\fR 4
.IX Item "lreplace"
نمونه‌ها پس از رسیدن به سمت چپ، مجدداً از سمت راست آغاز می‌شوند
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`replace\*(C'\fR است.
.RE
.IP \fBmode\fR 4
.IX Item "mode"
تعیین حالت نمایش.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBcombined\fR 4
.IX Item "combined"
همه کانال‌ها در یک ردیف مشترک نمایش داده می‌شوند
.IP \fBseparate\fR 4
.IX Item "separate"
همه کانال‌ها در ردیف‌های جداگانه نمایش داده می‌شوند
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBcombined\fR است.
.RE
.IP \fBcolor\fR 4
.IX Item "color"
تعیین حالت رنگی نمایش.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBchannel\fR 4
.IX Item "channel"
هر کانال با رنگی مجزا نمایش داده می‌شود
.IP \fBintensity\fR 4
.IX Item "intensity"
هر کانال با طرح رنگی یکسان نمایش داده می‌شود
.IP \fBrainbow\fR 4
.IX Item "rainbow"
هر کانال با طرح رنگین‌کمانی نمایش داده می‌شود
.IP \fBmoreland\fR 4
.IX Item "moreland"
هر کانال با طرح رنگی moreland نمایش داده می‌شود
.IP \fBnebulae\fR 4
.IX Item "nebulae"
هر کانال با طرح رنگی nebulae نمایش داده می‌شود
.IP \fBfire\fR 4
.IX Item "fire"
هر کانال با طرح رنگی آتش نمایش داده می‌شود
.IP \fBfiery\fR 4
.IX Item "fiery"
هر کانال با طرح رنگی آتشی نمایش داده می‌شود
.IP \fBfruit\fR 4
.IX Item "fruit"
هر کانال با طرح رنگی میوه‌ای نمایش داده می‌شود
.IP \fBcool\fR 4
.IX Item "cool"
هر کانال با طرح رنگی خنک نمایش داده می‌شود
.IP \fBmagma\fR 4
.IX Item "magma"
هر کانال با طرح رنگی ماگما نمایش داده می‌شود
.IP \fBgreen\fR 4
.IX Item "green"
هر کانال با طرح رنگی سبز نمایش داده می‌شود
.IP \fBviridis\fR 4
.IX Item "viridis"
هر کانال با طرح رنگی viridis نمایش داده می‌شود
.IP \fBplasma\fR 4
.IX Item "plasma"
هر کانال با طرح رنگی plasma نمایش داده می‌شود
.IP \fBcividis\fR 4
.IX Item "cividis"
هر کانال با طرح رنگی cividis نمایش داده می‌شود
.IP \fBterrain\fR 4
.IX Item "terrain"
هر کانال با طرح رنگی terrain نمایش داده می‌شود
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBchannel\fR است.
.RE
.IP \fBscale\fR 4
.IX Item "scale"
تعیین مقیاس مورد استفاده برای محاسبه مقادیر رنگ شدت (intensity).
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم، پیش‌فرض
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.IP \fB4thrt\fR 4
.IX Item "4thrt"
ریشه چهارم
.IP \fB5thrt\fR 4
.IX Item "5thrt"
ریشه پنجم
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBsqrt\fR است.
.RE
.IP \fBfscale\fR 4
.IX Item "fscale"
تعیین مقیاس فرکانس.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBlin\fR است.
.RE
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم ضریب اشباع برای رنگ‌های نمایش‌داده‌شده. مقادیر منفی طرح رنگی
متفاوتی ارائه می‌دهند. \f(CW0\fR یعنی بدون هیچ اشباع رنگی.
اشباع باید در محدوده [\-10.0, 10.0] باشد.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP \fBhann\fR 4
.IX Item "hann"
.IP \fBhanning\fR 4
.IX Item "hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP \fBorientation\fR 4
.IX Item "orientation"
تنظیم جهت‌گیری محور زمان در برابر فرکانس. می‌تواند \f(CW\*(C`vertical\*(C'\fR (عمودی) یا
\&\f(CW\*(C`horizontal\*(C'\fR (افقی) باشد. پیش‌فرض \f(CW\*(C`vertical\*(C'\fR است.
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم نسبت همپوشانی پنجره. مقدار پیش‌فرض \f(CW0\fR است.
هنگامی که مقدار \f(CW1\fR باشد، همپوشانی بر روی اندازه توصیه‌شده برای تابع
پنجره خاصی که در حال حاضر استفاده می‌شود تنظیم می‌گردد.
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم بهره مقیاس برای محاسبه مقادیر رنگ شدت.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBdata\fR 4
.IX Item "data"
تنظیم این‌که کدام داده نمایش داده شود. می‌تواند \f(CW\*(C`magnitude\*(C'\fR (پیش‌فرض) یا \f(CW\*(C`phase\*(C'\fR،
یا فاز بازشده: \f(CW\*(C`uphase\*(C'\fR باشد.
.IP \fBrotation\fR 4
.IX Item "rotation"
تنظیم چرخش رنگ، باید در محدوده [\-1.0, 1.0] باشد.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstart\fR 4
.IX Item "start"
تنظیم فرکانس آغازین که طیف‌نگار از آن نمایش داده می‌شود. پیش‌فرض \f(CW0\fR است.
.IP \fBstop\fR 4
.IX Item "stop"
تنظیم فرکانس پایانی که طیف‌نگار تا آن نمایش داده می‌شود. پیش‌فرض \f(CW0\fR است.
.IP \fBfps\fR 4
.IX Item "fps"
تنظیم حد بالای نرخ فریم. پیش‌فرض \f(CW\*(C`auto\*(C'\fR، نامحدود است.
.IP \fBlegend\fR 4
.IX Item "legend"
رسم محورها و راهنمای زمان و فرکانس. پیش‌فرض غیرفعال است.
.IP \fBdrange\fR 4
.IX Item "drange"
تنظیم محدوده دینامیکی مورد استفاده برای محاسبه مقادیر رنگ شدت. پیش‌فرض 120 dBFS است.
محدوده مجاز از 10 تا 200 است.
.IP \fBlimit\fR 4
.IX Item "limit"
تنظیم حد بالای حجم صدای نمونه‌های صوتی ورودی بر حسب dBFS. پیش‌فرض 0 dBFS است.
محدوده مجاز از \-100 تا 100 است.
.IP \fBopacity\fR 4
.IX Item "opacity"
تنظیم میزان ماتی (opacity) هنگام استفاده از خروجی قالب پیکسلی دارای مؤلفه آلفا.
.PP
کاربرد آن بسیار شبیه به فیلتر showwaves است؛ مثال‌های آن
بخش را ببینید.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
پنجره بزرگ با مقیاس‌بندی رنگی لگاریتمی:
.Sp
.Vb 1
\&        showspectrum=s=1280x480:scale=log
.Ve
.IP \(bu 4
مثال کامل برای یک طیف رنگی و لغزان به ازای هر کانال با استفاده از \fBffplay\fR:
.Sp
.Vb 2
\&        ffplay \-f lavfi \*(Aqamovie=input.mp3, asplit [a][out1];
\&                     [a] showspectrum=mode=separate:color=intensity:slide=1:scale=cbrt [out0]\*(Aq
.Ve
.SS showspectrumpic
.IX Subsection "showspectrumpic"
تبدیل صدای ورودی به یک تک‌فریم ویدیو که طیف فرکانسی صدا را نمایش می‌دهد.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`4096x2048\*(C'\fR است.
.IP \fBmode\fR 4
.IX Item "mode"
تعیین حالت نمایش.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBcombined\fR 4
.IX Item "combined"
همه کانال‌ها در یک ردیف مشترک نمایش داده می‌شوند
.IP \fBseparate\fR 4
.IX Item "separate"
همه کانال‌ها در ردیف‌های جداگانه نمایش داده می‌شوند
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBcombined\fR است.
.RE
.IP \fBcolor\fR 4
.IX Item "color"
تعیین حالت رنگی نمایش.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBchannel\fR 4
.IX Item "channel"
هر کانال با رنگی مجزا نمایش داده می‌شود
.IP \fBintensity\fR 4
.IX Item "intensity"
هر کانال با طرح رنگی یکسان نمایش داده می‌شود
.IP \fBrainbow\fR 4
.IX Item "rainbow"
هر کانال با طرح رنگین‌کمانی نمایش داده می‌شود
.IP \fBmoreland\fR 4
.IX Item "moreland"
هر کانال با طرح رنگی moreland نمایش داده می‌شود
.IP \fBnebulae\fR 4
.IX Item "nebulae"
هر کانال با طرح رنگی nebulae نمایش داده می‌شود
.IP \fBfire\fR 4
.IX Item "fire"
هر کانال با طرح رنگی آتش نمایش داده می‌شود
.IP \fBfiery\fR 4
.IX Item "fiery"
هر کانال با طرح رنگی آتشی نمایش داده می‌شود
.IP \fBfruit\fR 4
.IX Item "fruit"
هر کانال با طرح رنگی میوه‌ای نمایش داده می‌شود
.IP \fBcool\fR 4
.IX Item "cool"
هر کانال با طرح رنگی خنک نمایش داده می‌شود
.IP \fBmagma\fR 4
.IX Item "magma"
هر کانال با طرح رنگی ماگما نمایش داده می‌شود
.IP \fBgreen\fR 4
.IX Item "green"
هر کانال با طرح رنگی سبز نمایش داده می‌شود
.IP \fBviridis\fR 4
.IX Item "viridis"
هر کانال با طرح رنگی viridis نمایش داده می‌شود
.IP \fBplasma\fR 4
.IX Item "plasma"
هر کانال با طرح رنگی plasma نمایش داده می‌شود
.IP \fBcividis\fR 4
.IX Item "cividis"
هر کانال با طرح رنگی cividis نمایش داده می‌شود
.IP \fBterrain\fR 4
.IX Item "terrain"
هر کانال با طرح رنگی terrain نمایش داده می‌شود
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBintensity\fR است.
.RE
.IP \fBscale\fR 4
.IX Item "scale"
تعیین مقیاس مورد استفاده برای محاسبه مقادیر رنگ شدت.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم، پیش‌فرض
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.IP \fB4thrt\fR 4
.IX Item "4thrt"
ریشه چهارم
.IP \fB5thrt\fR 4
.IX Item "5thrt"
ریشه پنجم
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBlog\fR است.
.RE
.IP \fBfscale\fR 4
.IX Item "fscale"
تعیین مقیاس فرکانس.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی
.RE
.RS 4
.Sp
مقدار پیش‌فرض \fBlin\fR است.
.RE
.IP \fBsaturation\fR 4
.IX Item "saturation"
تنظیم ضریب اشباع برای رنگ‌های نمایش‌داده‌شده. مقادیر منفی طرح رنگی
متفاوتی ارائه می‌دهند. \f(CW0\fR یعنی بدون هیچ اشباع رنگی.
اشباع باید در محدوده [\-10.0, 10.0] باشد.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره.
.Sp
این گزینه مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBrect\fR 4
.IX Item "rect"
.PD 0
.IP \fBbartlett\fR 4
.IX Item "bartlett"
.IP \fBhann\fR 4
.IX Item "hann"
.IP \fBhanning\fR 4
.IX Item "hanning"
.IP \fBhamming\fR 4
.IX Item "hamming"
.IP \fBblackman\fR 4
.IX Item "blackman"
.IP \fBwelch\fR 4
.IX Item "welch"
.IP \fBflattop\fR 4
.IX Item "flattop"
.IP \fBbharris\fR 4
.IX Item "bharris"
.IP \fBbnuttall\fR 4
.IX Item "bnuttall"
.IP \fBbhann\fR 4
.IX Item "bhann"
.IP \fBsine\fR 4
.IX Item "sine"
.IP \fBnuttall\fR 4
.IX Item "nuttall"
.IP \fBlanczos\fR 4
.IX Item "lanczos"
.IP \fBgauss\fR 4
.IX Item "gauss"
.IP \fBtukey\fR 4
.IX Item "tukey"
.IP \fBdolph\fR 4
.IX Item "dolph"
.IP \fBcauchy\fR 4
.IX Item "cauchy"
.IP \fBparzen\fR 4
.IX Item "parzen"
.IP \fBpoisson\fR 4
.IX Item "poisson"
.IP \fBbohman\fR 4
.IX Item "bohman"
.IP \fBkaiser\fR 4
.IX Item "kaiser"
.PD
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`hann\*(C'\fR است.
.RE
.IP \fBorientation\fR 4
.IX Item "orientation"
تنظیم جهت‌گیری محور زمان در برابر فرکانس. می‌تواند \f(CW\*(C`vertical\*(C'\fR (عمودی) یا
\&\f(CW\*(C`horizontal\*(C'\fR (افقی) باشد. پیش‌فرض \f(CW\*(C`vertical\*(C'\fR است.
.IP \fBgain\fR 4
.IX Item "gain"
تنظیم بهره مقیاس برای محاسبه مقادیر رنگ شدت.
مقدار پیش‌فرض \f(CW1\fR است.
.IP \fBlegend\fR 4
.IX Item "legend"
رسم محورها و راهنمای زمان و فرکانس. پیش‌فرض فعال است.
.IP \fBrotation\fR 4
.IX Item "rotation"
تنظیم چرخش رنگ، باید در محدوده [\-1.0, 1.0] باشد.
مقدار پیش‌فرض \f(CW0\fR است.
.IP \fBstart\fR 4
.IX Item "start"
تنظیم فرکانس آغازین که طیف‌نگار از آن نمایش داده می‌شود. پیش‌فرض \f(CW0\fR است.
.IP \fBstop\fR 4
.IX Item "stop"
تنظیم فرکانس پایانی که طیف‌نگار تا آن نمایش داده می‌شود. پیش‌فرض \f(CW0\fR است.
.IP \fBdrange\fR 4
.IX Item "drange"
تنظیم محدوده دینامیکی مورد استفاده برای محاسبه مقادیر رنگ شدت. پیش‌فرض 120 dBFS است.
محدوده مجاز از 10 تا 200 است.
.IP \fBlimit\fR 4
.IX Item "limit"
تنظیم حد بالای حجم صدای نمونه‌های صوتی ورودی بر حسب dBFS. پیش‌فرض 0 dBFS است.
محدوده مجاز از \-100 تا 100 است.
.IP \fBopacity\fR 4
.IX Item "opacity"
تنظیم میزان ماتی (opacity) هنگام استفاده از خروجی قالب پیکسلی دارای مؤلفه آلفا.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استخراج یک طیف‌نگار صوتی از کل یک قطعه صوتی
در یک تصویر 1024x1024 با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i audio.flac \-lavfi showspectrumpic=s=1024x1024 spectrogram.png
.Ve
.SS showvolume
.IX Subsection "showvolume"
تبدیل حجم صدای ورودی به یک خروجی ویدیو.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم ویدیو.
.IP \fBb\fR 4
.IX Item "b"
تنظیم پهنای کادر، محدوده مجاز [0, 5] است. پیش‌فرض 1 است.
.IP \fBw\fR 4
.IX Item "w"
تنظیم پهنای کانال، محدوده مجاز [80, 8192] است. پیش‌فرض 400 است.
.IP \fBh\fR 4
.IX Item "h"
تنظیم ارتفاع کانال، محدوده مجاز [1, 900] است. پیش‌فرض 20 است.
.IP \fBf\fR 4
.IX Item "f"
تنظیم محوشدگی (fade)، محدوده مجاز [0, 1] است. پیش‌فرض 0.95 است.
.IP \fBc\fR 4
.IX Item "c"
تنظیم عبارت رنگ حجم صدا.
.Sp
این عبارت می‌تواند از متغیرهای زیر استفاده کند:
.RS 4
.IP \fBVOLUME\fR 4
.IX Item "VOLUME"
بیشینه حجم صدای فعلی کانال بر حسب dB.
.IP \fBPEAK\fR 4
.IX Item "PEAK"
قله (پیک) فعلی.
.IP \fBCHANNEL\fR 4
.IX Item "CHANNEL"
شماره کانال فعلی، با شروع از 0.
.RE
.RS 4
.RE
.IP \fBt\fR 4
.IX Item "t"
در صورت تنظیم، نام کانال‌ها را نمایش می‌دهد. پیش‌فرض فعال است.
.IP \fBv\fR 4
.IX Item "v"
در صورت تنظیم، مقادیر حجم صدا را نمایش می‌دهد. پیش‌فرض فعال است.
.IP \fBo\fR 4
.IX Item "o"
تنظیم جهت‌گیری، می‌تواند افقی: \f(CW\*(C`h\*(C'\fR یا عمودی: \f(CW\*(C`v\*(C'\fR باشد،
پیش‌فرض \f(CW\*(C`h\*(C'\fR است.
.IP \fBs\fR 4
.IX Item "s"
تنظیم اندازه گام، محدوده مجاز [0, 5] است. پیش‌فرض 0 است، به این معنی که
گام غیرفعال است.
.IP \fBp\fR 4
.IX Item "p"
تنظیم ماتی پس‌زمینه، محدوده مجاز [0, 1] است. پیش‌فرض 0 است.
.IP \fBm\fR 4
.IX Item "m"
تنظیم حالت سنجش، می‌تواند اوج (peak): \f(CW\*(C`p\*(C'\fR یا rms: \f(CW\*(C`r\*(C'\fR باشد،
پیش‌فرض \f(CW\*(C`p\*(C'\fR است.
.IP \fBds\fR 4
.IX Item "ds"
تنظیم مقیاس نمایش، می‌تواند خطی: \f(CW\*(C`lin\*(C'\fR یا لگاریتمی: \f(CW\*(C`log\*(C'\fR باشد،
پیش‌فرض \f(CW\*(C`lin\*(C'\fR است.
.IP \fBdm\fR 4
.IX Item "dm"
بر حسب ثانیه.
در صورت تنظیم روی > 0.، خطی را برای سطح بیشینه
در ثانیه‌های پیشین نمایش می‌دهد.
پیش‌فرض غیرفعال است: \f(CW0.\fR
.IP \fBdmc\fR 4
.IX Item "dmc"
رنگ خط بیشینه. هنگامی که گزینه \f(CW\*(C`dm\*(C'\fR روی > 0 تنظیم شده باشد استفاده می‌شود.
پیش‌فرض: \f(CW\*(C`orange\*(C'\fR است.
.SS showwaves
.IX Subsection "showwaves"
تبدیل صدای ورودی به یک خروجی ویدیو، به عنوان نمایش امواج نمونه‌ها.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`600x240\*(C'\fR است.
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت نمایش.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBpoint\fR 4
.IX Item "point"
رسم یک نقطه برای هر نمونه.
.IP \fBline\fR 4
.IX Item "line"
رسم یک خط عمودی برای هر نمونه.
.IP \fBp2p\fR 4
.IX Item "p2p"
رسم یک نقطه برای هر نمونه و یک خط میان آن‌ها.
.IP \fBcline\fR 4
.IX Item "cline"
رسم یک خط عمودی متمرکز برای هر نمونه.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`point\*(C'\fR است.
.RE
.IP \fBn\fR 4
.IX Item "n"
تنظیم تعداد نمونه‌هایی که در یک ستون رسم می‌شوند. مقدار
بزرگ‌تر نرخ فریم را کاهش می‌دهد. باید یک عدد صحیح
مثبت باشد. این گزینه تنها زمانی قابل تنظیم است که مقدار \fIrate\fR
به صراحت مشخص نشده باشد.
.IP "\fBrate, r\fR" 4
.IX Item "rate, r"
تنظیم نرخ فریم خروجی (تقریبی). این کار با تنظیم
گزینه \fIn\fR انجام می‌گیرد. مقدار پیش‌فرض "25" است.
.IP \fBsplit_channels\fR 4
.IX Item "split_channels"
تنظیم این‌که آیا کانال‌ها باید جداگانه رسم شوند یا همپوشانی داشته باشند. مقدار پیش‌فرض 0 است.
.IP \fBcolors\fR 4
.IX Item "colors"
تنظیم رنگ‌های جداشده با \*(Aq|\*(Aq که برای رسم هر کانال استفاده خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس دامنه.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی.
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم.
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم.
.RE
.RS 4
.Sp
پیش‌فرض خطی است.
.RE
.IP \fBdraw\fR 4
.IX Item "draw"
تنظیم حالت رسم. این گزینه بیشتر برای مقادیر بالای \fIn\fR کاربرد دارد.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBscale\fR 4
.IX Item "scale"
مقیاس‌بندی مقادیر پیکسلی برای هر نمونه رسم‌شده.
.IP \fBfull\fR 4
.IX Item "full"
رسم مستقیم هر نمونه.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`scale\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
خروجی دادن هم‌زمان صدای فایل ورودی و بازنمایی ویدیویی متناظر با آن:
.Sp
.Vb 1
\&        amovie=a.mp3,asplit[out0],showwaves[out1]
.Ve
.IP \(bu 4
ایجاد یک سیگنال ساختگی و نمایش آن با showwaves، با اجبار
نرخ فریم به 30 فریم بر ثانیه:
.Sp
.Vb 1
\&        aevalsrc=sin(1*2*PI*t)*sin(880*2*PI*t):cos(2*PI*200*t),asplit[out0],showwaves=r=30[out1]
.Ve
.SS showwavespic
.IX Subsection "showwavespic"
تبدیل صدای ورودی به یک تک‌فریم ویدیو، به عنوان نمایش امواج نمونه‌ها.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تعیین اندازه ویدیو برای خروجی. برای نحوه نگارش این گزینه، بخش
\&\fB"Video size" در راهنمای ffmpeg\-utils\fR را بررسی کنید.
مقدار پیش‌فرض \f(CW\*(C`600x240\*(C'\fR است.
.IP \fBsplit_channels\fR 4
.IX Item "split_channels"
تنظیم این‌که آیا کانال‌ها باید جداگانه رسم شوند یا همپوشانی داشته باشند. مقدار پیش‌فرض 0 است.
.IP \fBcolors\fR 4
.IX Item "colors"
تنظیم رنگ‌های جداشده با \*(Aq|\*(Aq که برای رسم هر کانال استفاده خواهند شد.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاس دامنه.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBlin\fR 4
.IX Item "lin"
خطی.
.IP \fBlog\fR 4
.IX Item "log"
لگاریتمی.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
ریشه دوم.
.IP \fBcbrt\fR 4
.IX Item "cbrt"
ریشه سوم.
.RE
.RS 4
.Sp
پیش‌فرض خطی است.
.RE
.IP \fBdraw\fR 4
.IX Item "draw"
تنظیم حالت رسم.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBscale\fR 4
.IX Item "scale"
مقیاس‌بندی مقادیر پیکسلی برای هر نمونه رسم‌شده.
.IP \fBfull\fR 4
.IX Item "full"
رسم مستقیم هر نمونه.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`scale\*(C'\fR است.
.RE
.IP \fBfilter\fR 4
.IX Item "filter"
تنظیم حالت فیلتر.
.Sp
مقادیر موجود عبارتند از:
.RS 4
.IP \fBaverage\fR 4
.IX Item "average"
استفاده از میانگین مقادیر نمونه‌ها برای هر نمونه رسم‌شده.
.IP \fBpeak\fR 4
.IX Item "peak"
استفاده از مقادیر اوج نمونه‌ها برای هر نمونه رسم‌شده.
.RE
.RS 4
.Sp
مقدار پیش‌فرض \f(CW\*(C`average\*(C'\fR است.
.RE
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
استخراج بازنمایی تفکیک‌شده کانال‌ها از شکل موج کل یک قطعه صوتی
در یک تصویر 1024x800 با استفاده از \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i audio.flac \-lavfi showwavespic=split_channels=1:s=1024x800 waveform.png
.Ve
.SS "sidedata, asidedata"
.IX Subsection "sidedata, asidedata"
حذف داده‌های جانبی (side data) فریم، یا انتخاب فریم‌ها بر پایه آن.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBmode\fR 4
.IX Item "mode"
تنظیم حالت عملکرد فیلتر.
.Sp
می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBselect\fR 4
.IX Item "select"
انتخاب هر فریمی که داده جانبی از نوع \f(CW\*(C`type\*(C'\fR دارد.
.IP \fBdelete\fR 4
.IX Item "delete"
حذف داده جانبی از نوع \f(CW\*(C`type\*(C'\fR. اگر \f(CW\*(C`type\*(C'\fR تنظیم نشود، تمام داده‌های جانبی
در فریم حذف می‌شوند.
.RE
.RS 4
.RE
.IP \fBtype\fR 4
.IX Item "type"
تنظیم نوع داده جانبی مورد استفاده در تمام حالت‌ها. برای حالت \f(CW\*(C`select\*(C'\fR الزامی است.
.Sp
مقادیر ممکن عبارتند از:
.RS 4
.IP \fBPANSCAN\fR 4
.IX Item "PANSCAN"
.PD 0
.IP \fBA53_CC\fR 4
.IX Item "A53_CC"
.IP \fBSTEREO3D\fR 4
.IX Item "STEREO3D"
.IP \fBMATRIXENCODING\fR 4
.IX Item "MATRIXENCODING"
.IP \fBDOWNMIX_INFO\fR 4
.IX Item "DOWNMIX_INFO"
.IP \fBREPLAYGAIN\fR 4
.IX Item "REPLAYGAIN"
.IP \fBDISPLAYMATRIX\fR 4
.IX Item "DISPLAYMATRIX"
.IP \fBAFD\fR 4
.IX Item "AFD"
.IP \fBMOTION_VECTORS\fR 4
.IX Item "MOTION_VECTORS"
.IP \fBSKIP_SAMPLES\fR 4
.IX Item "SKIP_SAMPLES"
.IP \fBAUDIO_SERVICE_TYPE\fR 4
.IX Item "AUDIO_SERVICE_TYPE"
.IP \fBMASTERING_DISPLAY_METADATA\fR 4
.IX Item "MASTERING_DISPLAY_METADATA"
.IP \fBGOP_TIMECODE\fR 4
.IX Item "GOP_TIMECODE"
.IP \fBSPHERICAL\fR 4
.IX Item "SPHERICAL"
.IP \fBCONTENT_LIGHT_LEVEL\fR 4
.IX Item "CONTENT_LIGHT_LEVEL"
.IP \fBICC_PROFILE\fR 4
.IX Item "ICC_PROFILE"
.IP \fBS12M_TIMECODE\fR 4
.IX Item "S12M_TIMECODE"
.IP \fBDYNAMIC_HDR_PLUS\fR 4
.IX Item "DYNAMIC_HDR_PLUS"
.IP \fBREGIONS_OF_INTEREST\fR 4
.IX Item "REGIONS_OF_INTEREST"
.IP \fBVIDEO_ENC_PARAMS\fR 4
.IX Item "VIDEO_ENC_PARAMS"
.IP \fBSEI_UNREGISTERED\fR 4
.IX Item "SEI_UNREGISTERED"
.IP \fBFILM_GRAIN_PARAMS\fR 4
.IX Item "FILM_GRAIN_PARAMS"
.IP \fBDETECTION_BOUNDING_BOXES\fR 4
.IX Item "DETECTION_BOUNDING_BOXES"
.IP \fBDETECTION_BBOXES\fR 4
.IX Item "DETECTION_BBOXES"
.IP \fBDOVI_RPU_BUFFER\fR 4
.IX Item "DOVI_RPU_BUFFER"
.IP \fBDOVI_METADATA\fR 4
.IX Item "DOVI_METADATA"
.IP \fBDYNAMIC_HDR_VIVID\fR 4
.IX Item "DYNAMIC_HDR_VIVID"
.IP \fBAMBIENT_VIEWING_ENVIRONMENT\fR 4
.IX Item "AMBIENT_VIEWING_ENVIRONMENT"
.IP \fBVIDEO_HINT\fR 4
.IX Item "VIDEO_HINT"
.PD
.RE
.RS 4
.RE
.SS spectrumsynth
.IX Subsection "spectrumsynth"
سنتز صدا از ۲ طیف ویدیویی ورودی، جریان ورودی اول نشان‌دهنده
دامنه در طول زمان و جریان دوم نشان‌دهنده فاز در طول زمان است.
این فیلتر از حوزه فرکانس به صورت نمایش‌یافته در ویدیوها به حوزه زمان
به عنوان خروجی صوتی تبدیل می‌کند.
.PP
این فیلتر در درجه اول برای معکوس کردن خروجی‌های پردازش‌شده فیلتر \fBshowspectrum\fR
ایجاد شده است، اما می‌تواند صدا را از سایر طیف‌نگارها نیز سنتز کند.
اما در چنین حالتی اگر داده‌های فاز در دسترس نباشند نتایج ضعیف
خواهند بود، زیرا در چنین مواردی داده‌های فاز باید بازسازی شوند، که معمولاً
تنها از نویز تصادفی بازسازی می‌شوند.
برای بهترین نتایج از خروجی فقط خاکستری (حالت رنگی \f(CW\*(C`channel\*(C'\fR در
فیلتر \fBshowspectrum\fR) و مقیاس \f(CW\*(C`log\*(C'\fR برای ویدیوی دامنه و
مقیاس \f(CW\*(C`lin\*(C'\fR برای ویدیوی فاز استفاده کنید. برای تولید فاز برای ویدیوی دوم، از گزینه
\&\f(CW\*(C`data\*(C'\fR استفاده کنید. ویدیوهای ورودی معمولاً باید از حالت لغزش \f(CW\*(C`fullframe\*(C'\fR
استفاده کنند زیرا این کار منابع مورد نیاز برای رمزگشایی ویدیو را صرفه‌جویی می‌کند.
.PP
این فیلتر گزینه‌های زیر را می‌پذیرد:
.IP \fBsample_rate\fR 4
.IX Item "sample_rate"
تعیین نرخ نمونه‌برداری صدای خروجی، نرخ نمونه‌برداری صدایی که
طیف از آن تولید شده بود ممکن است متفاوت باشد.
.IP \fBchannels\fR 4
.IX Item "channels"
تنظیم تعداد کانال‌های ارائه‌شده در طیف‌های ویدیویی ورودی.
.IP \fBscale\fR 4
.IX Item "scale"
تنظیم مقیاسی که هنگام تولید طیف ورودی دامنه استفاده شده بود.
می‌تواند \f(CW\*(C`lin\*(C'\fR یا \f(CW\*(C`log\*(C'\fR باشد. پیش‌فرض \f(CW\*(C`log\*(C'\fR است.
.IP \fBslide\fR 4
.IX Item "slide"
تنظیم لغزشی که هنگام تولید طیف‌های ورودی استفاده شده بود.
می‌تواند \f(CW\*(C`replace\*(C'\fR، \f(CW\*(C`scroll\*(C'\fR، \f(CW\*(C`fullframe\*(C'\fR یا \f(CW\*(C`rscroll\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`fullframe\*(C'\fR است.
.IP \fBwin_func\fR 4
.IX Item "win_func"
تنظیم تابع پنجره مورد استفاده برای بازسنتز.
.IP \fBoverlap\fR 4
.IX Item "overlap"
تنظیم همپوشانی پنجره. در محدوده \f(CW\*(C`[0, 1]\*(C'\fR. مقدار پیش‌فرض \f(CW1\fR است،
به این معنی که همپوشانی بهینه برای تابع پنجره انتخاب‌شده برگزیده خواهد شد.
.IP \fBorientation\fR 4
.IX Item "orientation"
تنظیم جهت‌گیری ویدیوهای ورودی. می‌تواند \f(CW\*(C`vertical\*(C'\fR یا \f(CW\*(C`horizontal\*(C'\fR باشد.
پیش‌فرض \f(CW\*(C`vertical\*(C'\fR است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
ابتدا ویدیوهای دامنه و فاز را از صدا ایجاد کنید، با فرض اینکه صدا استریو با نرخ نمونه‌برداری 44100 است،
سپس ویدیوها را با spectrumsynth مجدداً به صدا بازسنتز کنید:
.Sp
.Vb 3
\&        ffmpeg \-i input.flac \-lavfi showspectrum=mode=separate:scale=log:overlap=0.875:color=channel:slide=fullframe:data=magnitude \-an \-c:v rawvideo magnitude.nut
\&        ffmpeg \-i input.flac \-lavfi showspectrum=mode=separate:scale=lin:overlap=0.875:color=channel:slide=fullframe:data=phase \-an \-c:v rawvideo phase.nut
\&        ffmpeg \-i magnitude.nut \-i phase.nut \-lavfi spectrumsynth=channels=2:sample_rate=44100:win_func=hann:overlap=0.875:slide=fullframe output.flac
.Ve
.SS "split, asplit"
.IX Subsection "split, asplit"
تقسیم ورودی به چند خروجی یکسان.
.PP
\&\f(CW\*(C`asplit\*(C'\fR با ورودی صوتی کار می‌کند، و \f(CW\*(C`split\*(C'\fR با ویدیویی.
.PP
این فیلتر یک پارامتر منفرد می‌پذیرد که تعداد خروجی‌ها را مشخص می‌کند. در صورت
عدم تعیین، مقدار پیش‌فرض آن 2 است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
ایجاد دو خروجی مجزا از یک ورودی یکسان:
.Sp
.Vb 1
\&        [in] split [out0][out1]
.Ve
.IP \(bu 4
برای ایجاد 3 خروجی یا بیشتر، باید تعداد خروجی‌ها را مشخص
کنید، مانند:
.Sp
.Vb 1
\&        [in] asplit=3 [out0][out1][out2]
.Ve
.IP \(bu 4
ایجاد دو خروجی مجزا از یک ورودی یکسان، یکی برش‌خورده و
دیگری دارای حاشیه (pad):
.Sp
.Vb 3
\&        [in] split [splitout1][splitout2];
\&        [splitout1] crop=100:100:0:0    [cropout];
\&        [splitout2] pad=200:200:100:100 [padout];
.Ve
.IP \(bu 4
ایجاد 5 نسخه رونوشت از صدای ورودی با \fBffmpeg\fR:
.Sp
.Vb 1
\&        ffmpeg \-i INPUT \-filter_complex asplit=5 OUTPUT
.Ve
.SS "zmq, azmq"
.IX Subsection "zmq, azmq"
دریافت دستورهای ارسال‌شده از طریق یک کلاینت libzmq، و هدایت آن‌ها به
فیلترها در گراف فیلتر (filtergraph).
.PP
\&\f(CW\*(C`zmq\*(C'\fR و \f(CW\*(C`azmq\*(C'\fR به عنوان فیلترهای عبوری عمل می‌کنند. \f(CW\*(C`zmq\*(C'\fR
باید میان دو فیلتر ویدیویی درج شود، و \f(CW\*(C`azmq\*(C'\fR میان دو
فیلتر صوتی. هر دو قادرند پیام‌ها را به هر نوع فیلتری ارسال کنند.
.PP
برای فعال‌سازی این فیلترها باید کتابخانه libzmq و فایل‌های سرآیند آن را نصب کرده
و FFmpeg را با گزینه \f(CW\*(C`\-\-enable\-libzmq\*(C'\fR پیکربندی کنید.
.PP
برای اطلاعات بیشتر درباره libzmq ببینید:
<\fBhttp://www.zeromq.org\fR>
.PP
فیلترهای \f(CW\*(C`zmq\*(C'\fR و \f(CW\*(C`azmq\*(C'\fR به عنوان یک سرور libzmq کار می‌کنند، که
پیام‌های ارسال‌شده از طریق یک رابط شبکه تعریف‌شده توسط گزینه
\&\fBbind_address\fR (یا کوتاه‌نوشت "\fBb\fR") را دریافت می‌نمایند.
مقدار پیش‌فرض این گزینه \fItcp://localhost:5555\fR است. شما ممکن است
بخواهید این مقدار را بر اساس نیاز خود تغییر دهید، اما فراموش نکنید هر علامت
\&\*(Aq:\*(Aq را فرار دهید (به \fBفرار در گراف فیلتر (filtergraph escaping)\fR مراجعه کنید).
.PP
پیام دریافت‌شده باید به شکل زیر باشد:
.PP
.Vb 1
\&        <TARGET> <COMMAND> [<ARG>]
.Ve
.PP
\&\fITARGET\fR هدف دستور را مشخص می‌کند، معمولاً نام کلاس
فیلتر یا یک نام نمونه فیلتر خاص است. نام پیش‌فرض نمونه
فیلتر از الگوی \fBParsed_<filter_name>_<index>\fR استفاده می‌کند،
اما می‌توانید با استفاده از دستور زبان \fBfilter_name@id\fR
آن را لغو کنید (به \fBدستور زبان گراف فیلتر (Filtergraph syntax)\fR مراجعه کنید).
.PP
\&\fICOMMAND\fR نام دستور برای فیلتر هدف را تعیین می‌کند.
.PP
\&\fIARG\fR اختیاری است و فهرست آرگومان‌های اختیاری را برای
\&\fICOMMAND\fR داده‌شده مشخص می‌کند.
.PP
پس از دریافت، پیام پردازش شده و دستور مربوطه
به گراف فیلتر تزریق می‌شود. بسته به نتیجه، فیلتر
پاسخی را به قالب زیر برای کلاینت ارسال خواهد کرد:
.PP
.Vb 2
\&        <ERROR_CODE> <ERROR_REASON>
\&        <MESSAGE>
.Ve
.PP
\&\fIMESSAGE\fR اختیاری است.
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.PP
برای نمونه‌ای از یک کلاینت zmq که می‌تواند برای ارسال
دستورهای پردازش‌شده توسط این فیلترها استفاده شود، به \fItools/zmqsend\fR نگاه کنید.
.PP
گراف فیلتر زیر تولیدشده توسط \fBffplay\fR را در نظر بگیرید.
در این مثال آخرین فیلتر overlay دارای یک نام نمونه است. سایر
فیلترها نام‌های نمونه پیش‌فرض خواهند داشت.
.PP
.Vb 6
\&        ffplay \-dumpgraph 1 \-f lavfi "
\&        color=s=100x100:c=red  [l];
\&        color=s=100x100:c=blue [r];
\&        nullsrc=s=200x100, zmq [bg];
\&        [bg][l]   overlay     [bg+l];
\&        [bg+l][r] overlay@my=x=100 "
.Ve
.PP
برای تغییر رنگ سمت چپ ویدیو، دستور زیر را
می‌توان استفاده کرد:
.PP
.Vb 1
\&        echo Parsed_color_0 c yellow | tools/zmqsend
.Ve
.PP
برای تغییر سمت راست:
.PP
.Vb 1
\&        echo Parsed_color_1 c pink | tools/zmqsend
.Ve
.PP
برای تغییر موقعیت سمت راست:
.PP
.Vb 1
\&        echo overlay@my x 150 | tools/zmqsend
.Ve
.SH "سورس‌های چندرسانه‌ای (MULTIMEDIA SOURCES)"
.IX Header "MULTIMEDIA SOURCES"
در ادامه توصیفی از سورس‌های چندرسانه‌ای موجود فعلی ارائه شده است.
.SS amovie
.IX Subsection "amovie"
این سورس مانند \fBmovie\fR است، با این تفاوت که به طور پیش‌فرض یک استریم
صوتی را انتخاب می‌کند.
.SS avsynctest
.IX Subsection "avsynctest"
تولید یک آزمون هماهنگی صدا و تصویر (Audio/Video Sync Test).
.PP
استریم تولیدشده به صورت دوره‌ای فریم ویدیویی چشمک‌زن (flash) را نشان داده و صدای بوق (beep) در صوت پخش می‌کند.
برای بررسی مشکلات هماهنگی صدا و تصویر (A/V sync) مفید است.
.PP
این گزینه مقادیر زیر را می‌پذیرد:
.IP "\fBsize, s\fR" 4
.IX Item "size, s"
تنظیم اندازه ویدیوی خروجی. مقدار پیش‌فرض \f(CW\*(C`hd720\*(C'\fR است.
.IP "\fBframerate, fr\fR" 4
.IX Item "framerate, fr"
تنظیم نرخ فریم ویدیوی خروجی. مقدار پیش‌فرض \f(CW30\fR است.
.IP "\fBsamplerate, sr\fR" 4
.IX Item "samplerate, sr"
تنظیم نرخ نمونه‌برداری صدای خروجی. مقدار پیش‌فرض \f(CW44100\fR است.
.IP "\fBamplitude, a\fR" 4
.IX Item "amplitude, a"
تنظیم دامنه بوق صوتی خروجی. مقدار پیش‌فرض \f(CW0.7\fR است.
.IP "\fBperiod, p\fR" 4
.IX Item "period, p"
تنظیم دوره تناوب بوق صوتی خروجی بر حسب ثانیه. مقدار پیش‌فرض \f(CW3\fR است.
.IP "\fBdelay, dl\fR" 4
.IX Item "delay, dl"
تنظیم تأخیر فلاش ویدیوی خروجی بر حسب تعداد فریم. مقدار پیش‌فرض \f(CW0\fR است.
.IP "\fBcycle, c\fR" 4
.IX Item "cycle, c"
فعال‌سازی چرخه تأخیرهای ویدیو، به طور پیش‌فرض غیرفعال است.
.IP "\fBduration, d\fR" 4
.IX Item "duration, d"
تنظیم مدت‌زمان خروجی استریم. به طور پیش‌فرض مدت‌زمان نامحدود است.
.IP "\fBfg, bg, ag\fR" 4
.IX Item "fg, bg, ag"
تنظیم رنگ پیش‌زمینه/پس‌زمینه/اضافی.
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
این سورس از برخی گزینه‌های فوق به عنوان \fBدستور\fR پشتیبانی می‌کند.
.SS movie
.IX Subsection "movie"
خواندن استریم(های) صوتی و/یا ویدیویی از یک کانتینر فیلم.
.PP
این سورس پارامترهای زیر را می‌پذیرد:
.IP \fBfilename\fR 4
.IX Item "filename"
نام منبعی که باید خوانده شود (لزوماً یک فایل نیست؛ می‌تواند یک
دستگاه یا یک استریم باشد که از طریق یک پروتکل در دسترس است).
.IP "\fBformat_name, f\fR" 4
.IX Item "format_name, f"
قالب فرضی فیلم برای خواندن را مشخص می‌کند، و می‌تواند نام
یک کانتینر یا یک دستگاه ورودی باشد. اگر مشخص نشود،
قالب از \fImovie_name\fR یا با بررسی خودکار (probing) حدس زده می‌شود.
.IP "\fBseek_point, sp\fR" 4
.IX Item "seek_point, sp"
نقطه پرش (seek) را بر حسب ثانیه مشخص می‌کند. فریم‌ها از این
نقطه پرش به بعد در خروجی ارائه خواهند شد. این پارامتر با
\&\f(CW\*(C`av_strtod\*(C'\fR ارزیابی می‌شود، بنابراین مقدار عددی ممکن است دارای پسوند
IS باشد. مقدار پیش‌فرض "0" است.
.IP "\fBstreams, s\fR" 4
.IX Item "streams, s"
استریم‌ها را برای خواندن مشخص می‌کند. چند استریم را می‌توان
با "+" جدا کرد. سپس سورس به همان تعداد خروجی با همان
ترتیب خواهد داشت. دستور زبان در بخش \fB"مشخص‌کننده‌های استریم"
در راهنمای ffmpeg\fR توضیح داده شده است. دو نام ویژه، "dv" و "da" به
ترتیب استریم‌های ویدیویی و صوتی پیش‌فرض (مناسب‌ترین) را مشخص می‌کنند. مقدار پیش‌فرض
"dv" است، یا "da" در صورتی که فیلتر با نام "amovie" فراخوانی شود.
.IP "\fBstream_index, si\fR" 4
.IX Item "stream_index, si"
اندیس استریم ویدیویی برای خواندن را مشخص می‌کند. اگر مقدار \-1 باشد،
مناسب‌ترین استریم ویدیو به طور خودکار انتخاب خواهد شد. مقدار پیش‌فرض
"\-1" است. منسوخ شده است. اگر فیلتر با نام "amovie" فراخوانی شود، به جای
ویدیو، صدا را انتخاب خواهد کرد.
.IP \fBloop\fR 4
.IX Item "loop"
مشخص می‌کند که استریم چند بار متوالی خوانده شود.
اگر مقدار 0 باشد، استریم به طور نامحدود تکرار (loop) خواهد شد.
مقدار پیش‌فرض "1" است.
.Sp
توجه داشته باشید که با تکرار فیلم، برچسب‌های زمانی منبع تغییر
نمی‌کنند، بنابراین برچسب‌های زمانی صعودی یکنواخت تولید نخواهد کرد.
.IP \fBdiscontinuity\fR 4
.IX Item "discontinuity"
اختلاف زمانی بین فریم‌ها را مشخص می‌کند که بالاتر از آن، یک ناپیوستگی در برچسب زمانی
تلقی شده و با تنظیم برچسب‌های زمانی بعدی تصحیح می‌گردد.
.IP \fBdec_threads\fR 4
.IX Item "dec_threads"
تعداد نخ‌ها (threads) را برای رمزگشایی مشخص می‌کند.
.IP \fBformat_opts\fR 4
.IX Item "format_opts"
گزینه‌های قالب را برای فایل بازشده تعیین می‌کند. گزینه‌های قالب را می‌توان
به صورت فهرستی از جفت‌های \fIkey\fR=\fIvalue\fR جداشده با \*(Aq:\*(Aq تعیین کرد. مثال زیر
نحوه افزودن گزینه‌های protocol_whitelist و protocol_blacklist را نشان می‌دهد:
.Sp
.Vb 2
\&        ffplay \-f lavfi
\&        "movie=filename=\*(Aq1.sdp\*(Aq:format_opts=\*(Aqprotocol_whitelist=file,rtp,udp\e:protocol_blacklist=http\*(Aq"
.Ve
.PP
این سورس اجازه می‌دهد یک ویدیوی دوم را روی ورودی اصلی
یک گراف فیلتر قرار دهید، همان‌طور که در این گراف نشان داده شده است:
.PP
.Vb 4
\&        input \-\-\-\-\-\-\-\-\-\-\-> deltapts0 \-\-> overlay \-\-> output
\&                                            ^
\&                                            |
\&        movie \-\-> scale\-\-> deltapts1 \-\-\-\-\-\-\-+
.Ve
.PP
\fIمثال‌ها\fR
.IX Subsection "Examples"
.IP \(bu 4
رد کردن 3.2 ثانیه از ابتدای فایل AVI بنام in.avi، و قرار دادن آن
روی ورودی دارای برچسب "in":
.Sp
.Vb 3
\&        movie=in.avi:seek_point=3.2, scale=180:\-1, setpts=PTS\-STARTPTS [over];
\&        [in] setpts=PTS\-STARTPTS [main];
\&        [main][over] overlay=16:16 [out]
.Ve
.IP \(bu 4
خواندن از یک دستگاه video4linux2، و قرار دادن آن روی ورودی دارای
برچسب "in":
.Sp
.Vb 3
\&        movie=/dev/video0:f=video4linux2, scale=180:\-1, setpts=PTS\-STARTPTS [over];
\&        [in] setpts=PTS\-STARTPTS [main];
\&        [main][over] overlay=16:16 [out]
.Ve
.IP \(bu 4
خواندن اولین استریم ویدیو و استریم صوتی با شناسه 0x81 از
dvd.vob؛ ویدیو به پد با نام "video" و صدا به
پد با نام "audio" متصل می‌شود:
.Sp
.Vb 1
\&        movie=dvd.vob:s=v:0+#0x81 [video] [audio]
.Ve
.PP
\fIدستورها\fR
.IX Subsection "Commands"
.PP
هر دو movie و amovie از دستورهای زیر پشتیبانی می‌کنند:
.IP \fBseek\fR 4
.IX Item "seek"
انجام پرش با استفاده از "av_seek_frame".
دستور زبان به این صورت است: seek \fIstream_index\fR|\fItimestamp\fR|\fIflags\fR
.RS 4
.IP \(bu 4
\&\fIstream_index\fR: اگر stream_index مقدار \-1 باشد، استریم پیش‌فرض
انتخاب شده و \fItimestamp\fR به طور خودکار از واحدهای AV_TIME_BASE به time_base ویژه
استریم تبدیل می‌شود.
.IP \(bu 4
\&\fItimestamp\fR: برچسب زمانی در واحدهای AVStream.time_base
یا اگر استریمی مشخص نشده باشد، در واحدهای AV_TIME_BASE.
.IP \(bu 4
\&\fIflags\fR: پرچم‌هایی که جهت و حالت پرش را تعیین می‌کنند.
.RE
.RS 4
.RE
.IP \fBget_duration\fR 4
.IX Item "get_duration"
دریافت مدت‌زمان فیلم در واحدهای AV_TIME_BASE.
.SH "کتابخانه‌های خارجی (EXTERNAL LIBRARIES)"
.IX Header "EXTERNAL LIBRARIES"
ابزار FFmpeg می‌تواند به منظور افزودن پشتیبانی از قالب‌های بیشتر، به تعدادی
از کتابخانه‌های خارجی متصل شود. هیچ‌یک از آن‌ها به طور پیش‌فرض استفاده
نمی‌شوند، و استفاده از آن‌ها باید صراحتاً با ارسال پرچم‌های مناسب به
\&\fB./configure\fR درخواست شود.
.SS "Alliance for Open Media (AOM)"
.IX Subsection "Alliance for Open Media (AOM)"
ابزار FFmpeg می‌تواند از کتابخانه AOM برای رمزگشایی و کدگذاری AV1 استفاده کند.
.PP
به <\fBhttp://aomedia.org\fR> مراجعه کرده و دستورالعمل‌های نصب
کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libaom\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.SS "AMD AMF/VCE"
.IX Subsection "AMD AMF/VCE"
ابزار FFmpeg می‌تواند از کتابخانه AMD Advanced Media Framework برای
کدگذاری شتاب‌یافته H.264 و HEVC (تنها در ویندوز) بر روی سخت‌افزارهای مجهز به موتور کدگذاری ویدیو (VCE) استفاده کند.
.PP
برای فعال‌سازی پشتیبانی باید فایل‌های سرآیند فریم‌ورک AMF (نسخه 1.4.9 یا بالاتر) را از
<\fBhttps://github.com/GPUOpen\-LibrariesAndSDKs/AMF.git\fR> دریافت کنید.
.PP
یک پوشه به نام \f(CW\*(C`AMF/\*(C'\fR در مسیر include سیستم ایجاد کنید.
محتویات \f(CW\*(C`AMF/amf/public/include/\*(C'\fR را درون آن پوشه کپی نمایید.
سپس FFmpeg را با گزینه \f(CW\*(C`\-\-enable\-amf\*(C'\fR پیکربندی کنید.
.PP
مقداردهی اولیه کدگذار amf به این ترتیب صورت می‌گیرد:
1) تلاش برای مقداردهی از طریق dx11 (تنها در ویندوز)
2) تلاش برای مقداردهی از طریق dx9 (تنها در ویندوز)
3) تلاش برای مقداردهی از طریق vulkan
.PP
برای استفاده از کدگذار h.264 (AMD VCE) در لینوکس، نسخه 19.20 یا بالاتر amdgpu\-pro و بسته
amf\-amdgpu\-pro (در amdgpu\-pro موجود است اما به طور خودکار نصب نمی‌شود) مورد نیاز است.
.PP
این درایور را می‌توان با استفاده از اسکریپت amdgpu\-pro\-install در آرشیو رسمی درایور amd نصب کرد.
.SS AviSynth
.IX Subsection "AviSynth"
ابزار FFmpeg می‌تواند اسکریپت‌های AviSynth را به عنوان ورودی بخواند. برای فعال‌سازی پشتیبانی، پس از
نصب هدرهای ارائه‌شده توسط <\fBhttps://github.com/AviSynth/AviSynthPlus\fR>،
گزینه \f(CW\*(C`\-\-enable\-avisynth\*(C'\fR را به configure ارسال کنید.
AviSynth+ را می‌توان طوری پیکربندی کرد که فقط هدرها را یا با
ارسال \f(CW\*(C`\-DHEADERS_ONLY:bool=on\*(C'\fR به سیستم ساخت مبتنی بر CMake، یا با استفاده از \f(CW\*(C`GNUmakefile\*(C'\fR ارائه‌شده نصب نماید.
.PP
برای ویندوز، نسخه‌های پشتیبانی‌شده AviSynth عبارتند از
<\fBhttp://avisynth.nl\fR> برای ساخت‌های 32 بیتی و
<\fBhttp://avisynth.nl/index.php/AviSynth+\fR> برای ساخت‌های 32 بیتی و 64 بیتی.
.PP
برای لینوکس، macOS و BSD، تنها نسخه پشتیبانی‌شده AviSynth،
<\fBhttps://github.com/AviSynth/AviSynthPlus\fR> است که از نسخه 3.5 آغاز می‌شود.
.Sp
.RS 4
در سال 2016، AviSynth+ پشتیبانی از ساخت با GCC را اضافه کرد. با این حال، به دلیل
ویژگی‌های خاص قراردادهای فراخوانی ویندوز، ساخت‌های 32 بیتی GCC از
AviSynth+ با ساخت‌های معمولی 32 بیتی FFmpeg سازگار نیستند.
.Sp
به طور پیش‌فرض، FFmpeg سازگاری با ساخت‌های 32 بیتی MSVC از
AviSynth+ را فرض می‌کند زیرا این پیکربندی پرکاربردترین و تثبیت‌شده‌ترین
پیکربندی ساخت است. کاربران می‌توانند با ارسال \f(CW\*(C`\-DAVSC_WIN32_GCC32\*(C'\fR به
\&\f(CW\*(C`\-\-extra\-cflags\*(C'\fR در هنگام پیکربندی FFmpeg، این رفتار را بازنویسی کرده و پشتیبانی از ساخت‌های 32 بیتی
GCC از AviSynth+ را فعال کنند.
.Sp
ساخت‌های 64 بیتی FFmpeg تحت تأثیر قرار نمی‌گیرند و می‌توانند از ساخت‌های MSVC یا
GCC از AviSynth+ بدون هیچ پرچم خاصی استفاده کنند.
.RE
.Sp
.RS 4
کتابخانه AviSynth(+) به صورت پویا بارگذاری می‌شود. توزیع‌کنندگان می‌توانند FFmpeg را با
گزینه \f(CW\*(C`\-\-enable\-avisynth\*(C'\fR بسازند، و فایل‌های اجرایی بدون توجه به اینکه آیا
کاربر نهایی AviSynth را نصب کرده است یا خیر کار خواهند کرد. هر گاه کاربر نهایی
بخواهد از اسکریپت‌های AviSynth استفاده کند، می‌تواند AviSynth(+) را نصب نماید
و FFmpeg قادر خواهد بود آن را برای باز کردن اسکریپت‌ها پیدا کرده و به کار گیرد.
.RE
.SS Chromaprint
.IX Subsection "Chromaprint"
ابزار FFmpeg می‌تواند از کتابخانه Chromaprint برای تولید اثر انگشت صوتی استفاده کند.
برای فعال‌سازی آن گزینه \f(CW\*(C`\-\-enable\-chromaprint\*(C'\fR را به configure ارسال
کنید. <\fBhttps://acoustid.org/chromaprint\fR> را ببینید.
.SS codec2
.IX Subsection "codec2"
ابزار FFmpeg می‌تواند از کتابخانه codec2 برای رمزگشایی و کدگذاری codec2 استفاده کند.
در حال حاضر هیچ رمزگشای بومی وجود ندارد، بنابراین libcodec2 باید برای رمزگشایی استفاده شود.
.PP
به <\fBhttp://freedv.org\fR> بروید و "Codec 2 source archive" را دانلود کنید.
با استفاده از CMake بسازید و نصب کنید. کاربران دبیان می‌توانند به جای آن بسته libcodec2\-dev را نصب کنند.
پس از نصب libcodec2 می‌توانید \f(CW\*(C`\-\-enable\-libcodec2\*(C'\fR را به configure بفرستید تا فعال شود.
.PP
ساده‌ترین راه برای استفاده از codec2 با پرونده‌های .c2 است، زیرا آن‌ها حاوی اطلاعات حالت مورد نیاز برای رمزگشایی هستند.
برای کدگذاری چنین پرونده‌ای، از پسوند پرونده .c2 استفاده کرده و گزینه ‎\-mode‎ را به کدگذار libcodec2 بدهید:
\&\f(CW\*(C`ffmpeg \-i input.wav \-mode 700C output.c2\*(C'\fR.
پخش آن به سادگی اجرای \f(CW\*(C`ffplay output.c2\*(C'\fR است.
برای مشاهده فهرستی از حالت‌های پشتیبانی‌شده، دستور \f(CW\*(C`ffmpeg \-h encoder=libcodec2\*(C'\fR را اجرا کنید.
پرونده‌های خام codec2 نیز پشتیبانی می‌شوند.
برای قابل فهم شدن آن‌ها، حالت مورد استفاده باید به عنوان یک گزینه قالب تعیین شود:
\&\f(CW\*(C`ffmpeg \-f codec2raw \-mode 1300 \-i input.raw output.wav\*(C'\fR.
.SS dav1d
.IX Subsection "dav1d"
ابزار FFmpeg می‌تواند از کتابخانه dav1d برای رمزگشایی ویدیوی AV1 استفاده کند.
.PP
به <\fBhttps://code.videolan.org/videolan/dav1d\fR> بروید و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libdav1d\*(C'\fR را به configure ارسال نمایید تا فعال شود.
.SS davs2
.IX Subsection "davs2"
ابزار FFmpeg می‌تواند از کتابخانه davs2 برای رمزگشایی ویدیوی AVS2\-P2/IEEE1857.4 استفاده کند.
.PP
به <\fBhttps://github.com/pkuvcl/davs2\fR> بروید و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libdavs2\*(C'\fR را به configure بفرستید تا
فعال شود.
.Sp
.RS 4
کتابخانه libdavs2 تحت مجوز عمومی گنو (GNU Public License) نسخه 2 یا بالاتر است
(برای جزئیات به <\fBhttp://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html\fR> مراجعه کنید)،
برای استفاده از آن باید مجوز FFmpeg را به GPL ارتقا دهید.
.RE
.SS uavs3d
.IX Subsection "uavs3d"
ابزار FFmpeg می‌تواند از کتابخانه uavs3d برای رمزگشایی ویدیوی AVS3\-P2/IEEE1857.10 استفاده کند.
.PP
به <\fBhttps://github.com/uavs3/uavs3d\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libuavs3d\*(C'\fR را به configure ارسال نمایید تا
فعال شود.
.SS "Game Music Emu"
.IX Subsection "Game Music Emu"
ابزار FFmpeg می‌تواند از کتابخانه Game Music Emu برای خواندن صدا از قالب‌های پرونده موسیقی
بازی‌های ویدیویی پشتیبانی‌شده استفاده کند. برای فعال‌سازی آن گزینه \f(CW\*(C`\-\-enable\-libgme\*(C'\fR را به configure
ارسال کنید. <\fBhttps://bitbucket.org/mpyne/game\-music\-emu/overview\fR> را ببینید.
.SS "Intel QuickSync Video"
.IX Subsection "Intel QuickSync Video"
ابزار FFmpeg می‌تواند از Intel QuickSync Video (QSV) برای شتاب‌بخشی به رمزگشایی و کدگذاری
چندین کدک استفاده کند. برای استفاده از QSV، ابزار FFmpeg باید به توزیع‌کننده (dispatcher) \f(CW\*(C`libmfx\*(C'\fR
پیوند داده شود، که کتابخانه‌های رمزگشایی واقعی را بارگذاری می‌کند.
.PP
این توزیع‌کننده متن‌باز است و می‌توان آن را از
<\fBhttps://github.com/lu\-zero/mfx_dispatch.git\fR> دانلود کرد. ابزار FFmpeg باید با گزینه
\&\f(CW\*(C`\-\-enable\-libmfx\*(C'\fR پیکربندی شود و ابزار \f(CW\*(C`pkg\-config\*(C'\fR باید بتواند
پرونده‌های \f(CW\*(C`.pc\*(C'\fR توزیع‌کننده را بیابد.
.SS Kvazaar
.IX Subsection "Kvazaar"
ابزار FFmpeg می‌تواند از کتابخانه Kvazaar برای کدگذاری HEVC استفاده کند.
.PP
به <\fBhttps://github.com/ultravideo/kvazaar\fR> بروید و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس گزینه
\&\f(CW\*(C`\-\-enable\-libkvazaar\*(C'\fR را به configure ارسال کنید تا فعال شود.
.SS LAME
.IX Subsection "LAME"
ابزار FFmpeg می‌تواند از کتابخانه LAME برای کدگذاری MP3 استفاده کند.
.PP
به <\fBhttp://lame.sourceforge.net\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال کنید.
سپس \f(CW\*(C`\-\-enable\-libmp3lame\*(C'\fR را به configure بفرستید تا فعال شود.
.SS LCEVCdec
.IX Subsection "LCEVCdec"
ابزار FFmpeg می‌تواند از کتابخانه liblcevc_dec برای رمزگشایی لایه ارتقادهنده LCEVC
در بیت‌استریم‌های پشتیبانی‌شده استفاده کند.
.PP
به <\fBhttps://github.com/v\-novaltd/LCEVCdec\fR> بروید و دستورالعمل‌های
نصب کتابخانه را دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-liblcevc\-dec\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.Sp
.RS 4
کتابخانه LCEVCdec تحت مجوز BSD\-3\-Clause\-Clear است.
.RE
.SS libilbc
.IX Subsection "libilbc"
کدک iLBC یک کدک صوتی گفتاری باند باریک است که توسط گوگل به عنوان بخشی از پروژه
WebRTC به طور رایگان عرضه شده است. کتابخانه libilbc نسخه‌ای مناسب برای بسته‌بندی
از کدک iLBC است. ابزار FFmpeg می‌تواند از کتابخانه libilbc برای
رمزگشایی و کدگذاری iLBC استفاده کند.
.PP
به <\fBhttps://github.com/TimothyGu/libilbc\fR> مراجعه کرده و دستورالعمل‌های نصب
کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libilbc\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.SS libjxl
.IX Subsection "libjxl"
قالب JPEG XL یک قالب تصویری است که هدف آن جایگزینی کامل JPEG سنتی برای یک
بازه زمانی طولانی است. برای اطلاعات بیشتر <\fBhttps://jpegxl.info\fR> و برای سورس
کتابخانه <\fBhttps://github.com/libjxl/libjxl\fR> را ببینید. می‌توانید
\&\f(CW\*(C`\-\-enable\-libjxl\*(C'\fR را به configure بفرستید تا لفاف libjxl فعال شود.
.SS libvpx
.IX Subsection "libvpx"
ابزار FFmpeg می‌تواند از کتابخانه libvpx برای رمزگشایی و کدگذاری VP8/VP9 استفاده کند.
.PP
به <\fBhttp://www.webmproject.org\fR> بروید و دستورالعمل‌های نصب
کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libvpx\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.SS ModPlug
.IX Subsection "ModPlug"
ابزار FFmpeg می‌تواند از این کتابخانه، با منشأ در Modplug\-XMMS، برای خواندن از پرونده‌های موسیقی شبه\-MOD استفاده کند.
<\fBhttps://github.com/Konstanty/libmodplug\fR> را ببینید. گزینه \f(CW\*(C`\-\-enable\-libmodplug\*(C'\fR را به configure بفرستید تا
فعال گردد.
.SS "ONNX Runtime"
.IX Subsection "ONNX Runtime"
ابزار FFmpeg می‌تواند از کتابخانه ONNX Runtime به عنوان یک بک‌اند برای فیلترهای مبتنی بر DNN استفاده کند.
.PP
به <\fBhttps://onnxruntime.ai\fR> مراجعه کرده و دستورالعمل‌های نصب
کتابخانه را دنبال نمایید. بسته‌های از پیش ساخته‌شده برای پلتفرم‌های مختلف در دسترس هستند.
.PP
پیکربندی FFmpeg با پشتیبانی از ONNX Runtime:
.PP
.Vb 4
\&        ./configure \e
\&            \-\-enable\-libonnxruntime \e
\&            \-\-extra\-cflags="\-I/path/to/onnxruntime/include" \e
\&            \-\-extra\-ldflags="\-L/path/to/onnxruntime/lib"
.Ve
.PP
در سیستم‌های مبتنی بر ELF (لینوکس، BSD) ممکن است بخواهید مسیر جستجوی
کتابخانه را تعبیه کنید تا فایل اجرایی \fIffmpeg\fR نصب‌شده بتواند کتابخانه اشتراکی
را در زمان اجرا بدون تنظیم \fBLD_LIBRARY_PATH\fR پیدا کند:
.PP
.Vb 4
\&        ./configure \e
\&            \-\-enable\-libonnxruntime \e
\&            \-\-extra\-cflags="\-I/path/to/onnxruntime/include" \e
\&            \-\-extra\-ldflags="\-L/path/to/onnxruntime/lib \-Wl,\-rpath,/path/to/onnxruntime/lib"
.Ve
.PP
پرچم \f(CW\*(C`\-Wl,\-rpath\*(C'\fR ویژه سیستم‌های ELF است و باید در
سایر پلتفرم‌ها (ویندوز، macOS) حذف شود.
.PP
برای ساخت‌های MinGW GCC، پرچم \f(CW\*(C`\-D_stdcall=_\|_stdcall\*(C'\fR را برای سازگاری
با هدرهای ONNX Runtime اضافه کنید.
.SS "OpenCORE, VisualOn, and Fraunhofer libraries"
.IX Subsection "OpenCORE, VisualOn, and Fraunhofer libraries"
کتابخانه‌های OpenCore، VisualOn و Fraunhofer که از سورس‌های اندروید گوگل منشعب شده‌اند،
کدگذارهایی را برای تعدادی از کدک‌های صوتی ارائه می‌دهند.
.Sp
.RS 4
کتابخانه‌های OpenCORE و VisualOn تحت مجوز Apache License 2.0 هستند
(برای جزئیات به <\fBhttp://www.apache.org/licenses/LICENSE\-2.0\fR> مراجعه کنید)، که با
LGPL نسخه 2.1 و GPL نسخه 2 ناسازگار است. برای استفاده از آن باید
مجوز FFmpeg را با ارسال \f(CW\*(C`\-\-enable\-version3\*(C'\fR به configure به LGPL نسخه 3 (یا در صورتی که
مؤلفه‌های GPL را فعال کرده‌اید، به GPL نسخه 3) ارتقا دهید.
.Sp
مجوز کتابخانه Fraunhofer AAC با مجوز GPL ناسازگار است.
بنابراین، برای ساخت‌های GPL، باید گزینه \f(CW\*(C`\-\-enable\-nonfree\*(C'\fR را به
configure بفرستید تا بتوانید از آن استفاده کنید. تا آنجا که ما می‌دانیم، این مجوز
با LGPL سازگار است.
.RE
.PP
\fIOpenCORE AMR\fR
.IX Subsection "OpenCORE AMR"
.PP
ابزار FFmpeg می‌تواند از کتابخانه‌های OpenCORE برای کدگذاری/رمزگشایی AMR\-NB
و رمزگشایی AMR\-WB استفاده کند.
.PP
به <\fBhttp://sourceforge.net/projects/opencore\-amr\fR> مراجعه کرده و
دستورالعمل‌های نصب کتابخانه‌ها را دنبال نمایید.
سپس \f(CW\*(C`\-\-enable\-libopencore\-amrnb\*(C'\fR و/یا
\&\f(CW\*(C`\-\-enable\-libopencore\-amrwb\*(C'\fR را به configure بفرستید تا فعال شوند.
.PP
\fIVisualOn AMR\-WB encoder library\fR
.IX Subsection "VisualOn AMR-WB encoder library"
.PP
ابزار FFmpeg می‌تواند از کتابخانه VisualOn AMR\-WBenc برای کدگذاری AMR\-WB استفاده کند.
.PP
به <\fBhttp://sourceforge.net/projects/opencore\-amr\fR> بروید و
دستورالعمل‌های نصب کتابخانه را دنبال نمایید.
سپس \f(CW\*(C`\-\-enable\-libvo\-amrwbenc\*(C'\fR را به configure ارسال نمایید تا فعال شود.
.PP
\fIFraunhofer AAC library\fR
.IX Subsection "Fraunhofer AAC library"
.PP
ابزار FFmpeg می‌تواند از کتابخانه Fraunhofer AAC برای رمزگشایی و کدگذاری AAC استفاده کند.
.PP
به <\fBhttp://sourceforge.net/projects/opencore\-amr\fR> بروید و
دستورالعمل‌های نصب کتابخانه را دنبال کنید.
سپس \f(CW\*(C`\-\-enable\-libfdk\-aac\*(C'\fR را به configure بفرستید تا فعال شود.
.PP
\fIFraunhofer MPEG\-H 3D Audio decoder library\fR
.IX Subsection "Fraunhofer MPEG-H 3D Audio decoder library"
.PP
ابزار FFmpeg می‌تواند از کتابخانه رمزگشای Fraunhofer MPEG\-H برای رمزگشایی MPEG\-H 3DA استفاده کند.
.PP
به <\fBhttps://github.com/Fraunhofer\-IIS/mpeghdec\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال نمایید.
سپس \f(CW\*(C`\-\-enable\-libmpeghdec \-\-enable\-nonfree\*(C'\fR را به configure ارسال کنید تا فعال شود.
.PP
\fILC3 library\fR
.IX Subsection "LC3 library"
.PP
ابزار FFmpeg می‌تواند از کتابخانه Google LC3 برای رمزگشایی و کدگذاری LC3 استفاده کند.
.PP
به <\fBhttps://github.com/google/liblc3\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال کنید.
سپس \f(CW\*(C`\-\-enable\-liblc3\*(C'\fR را به configure بفرستید تا فعال شود.
.SS OpenH264
.IX Subsection "OpenH264"
ابزار FFmpeg می‌تواند از کتابخانه OpenH264 برای رمزگشایی و کدگذاری H.264 استفاده کند.
.PP
به <\fBhttp://www.openh264.org\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libopenh264\*(C'\fR را به configure بفرستید تا
فعال شود.
.PP
برای رمزگشایی، این کتابخانه بسیار محدودتر از دیکودر داخلی در
libavcodec است؛ در حال حاضر این کتابخانه فاقد پشتیبانی از رمزگشایی فریم‌های B
و برخی ویژگی‌های دیگر پروفایل main/high است. (در حال حاضر تنها از
constrained baseline profile و CABAC پشتیبانی می‌کند.) استفاده از آن بیشتر برای
آزمایش و بهره‌مندی از مجوز پرتفوی حق اختراع سیسکو
(<\fBhttp://www.openh264.org/BINARY_LICENSE.txt\fR>) مفید است.
.SS OpenJPEG
.IX Subsection "OpenJPEG"
ابزار FFmpeg می‌تواند از کتابخانه‌های OpenJPEG برای رمزگشایی/کدگذاری ویدیوهای J2K استفاده کند. به
<\fBhttp://www.openjpeg.org\fR> مراجعه کرده تا کتابخانه‌ها را دریافت کنید و دستورالعمل‌های نصب را دنبال نمایید.
برای فعال‌سازی استفاده از OpenJPEG در FFmpeg، گزینه \f(CW\*(C`\-\-enable\-libopenjpeg\*(C'\fR را به
\&\fI./configure\fR ارسال کنید.
.SS rav1e
.IX Subsection "rav1e"
ابزار FFmpeg می‌تواند از rav1e (کدگذار AV1 با Rust) از طریق اتصالات C آن برای کدگذاری ویدیوها استفاده کند.
به <\fBhttps://github.com/xiph/rav1e\fR> بروید و دستورالعمل‌ها را برای ساخت
کتابخانه C دنبال کنید. برای فعال‌سازی استفاده از rav1e در FFmpeg، گزینه \f(CW\*(C`\-\-enable\-librav1e\*(C'\fR
را به \fI./configure\fR ارسال کنید.
.SS SVT\-AV1
.IX Subsection "SVT-AV1"
ابزار FFmpeg می‌تواند از کتابخانه Scalable Video Technology for AV1 برای کدگذاری AV1 استفاده کند.
.PP
به <\fBhttps://gitlab.com/AOMediaCodec/SVT\-AV1\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libsvtav1\*(C'\fR را به configure ارسال نمایید تا
فعال شود.
.SS SVT\-JPEG\-XS
.IX Subsection "SVT-JPEG-XS"
ابزار FFmpeg می‌تواند از کتابخانه Scalable Video Technology for JPEG\-XS برای
رمزگشایی و کدگذاری JPEG\-XS استفاده کند.
.PP
به <\fBhttps://github.com/OpenVisualCloud/SVT\-JPEG\-XS\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libsvtjpegxs\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.SS TwoLAME
.IX Subsection "TwoLAME"
ابزار FFmpeg می‌تواند از کتابخانه TwoLAME برای کدگذاری MP2 استفاده کند.
.PP
به <\fBhttp://www.twolame.org\fR> مراجعه کرده و
دستورالعمل‌های نصب کتابخانه را دنبال کنید.
سپس \f(CW\*(C`\-\-enable\-libtwolame\*(C'\fR را به configure ارسال کنید تا فعال شود.
.SS VapourSynth
.IX Subsection "VapourSynth"
ابزار FFmpeg می‌تواند اسکریپت‌های VapourSynth را به عنوان ورودی بخواند. برای فعال‌سازی پشتیبانی،
گزینه \f(CW\*(C`\-\-enable\-vapoursynth\*(C'\fR را به configure ارسال کنید. Vapoursynth از طریق
\&\f(CW\*(C`pkg\-config\*(C'\fR شناسایی می‌شود. نسخه‌های 42 یا بالاتر پشتیبانی می‌شوند.
<\fBhttp://www.vapoursynth.com\fR> را ببینید.
.PP
به دلایل امنیتی، اسکریپت‌های Vapoursynth به طور خودکار شناسایی
نخواهند شد، بنابراین قالب ورودی باید اجبار شود. برای ابزارهای خط فرمان *ff،
عبارت \f(CW\*(C`\-f vapoursynth\*(C'\fR را قبل از ورودی \f(CW\*(C`\-i yourscript.vpy\*(C'\fR اضافه کنید.
.SS x264
.IX Subsection "x264"
ابزار FFmpeg می‌تواند از کتابخانه x264 برای کدگذاری H.264 استفاده کند.
.PP
به <\fBhttp://www.videolan.org/developers/x264.html\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه را دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libx264\*(C'\fR را به
configure ارسال کنید تا فعال شود.
.Sp
.RS 4
کتابخانه x264 تحت مجوز عمومی گنو (GNU Public License) نسخه 2 یا بالاتر است
(برای جزئیات به <\fBhttp://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html\fR> مراجعه
کنید)، برای استفاده از آن باید مجوز FFmpeg را به GPL ارتقا دهید.
.RE
.SS x265
.IX Subsection "x265"
ابزار FFmpeg می‌تواند از کتابخانه x265 برای کدگذاری HEVC استفاده کند.
.PP
به <\fBhttp://x265.org/developers.html\fR> بروید و دستورالعمل‌ها را
برای نصب کتابخانه دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libx265\*(C'\fR را به configure ارسال کنید
تا فعال شود.
.Sp
.RS 4
کتابخانه x265 تحت مجوز عمومی گنو (GNU Public License) نسخه 2 یا بالاتر است
(برای جزئیات به <\fBhttp://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html\fR> مراجعه
کنید)، برای استفاده از آن باید مجوز FFmpeg را به GPL ارتقا دهید.
.RE
.SS xavs
.IX Subsection "xavs"
ابزار FFmpeg می‌تواند از کتابخانه xavs برای کدگذاری AVS استفاده کند.
.PP
به <\fBhttp://xavs.sf.net\fR> مراجعه کرده و دستورالعمل‌ها را برای
نصب کتابخانه دنبال کنید. سپس \f(CW\*(C`\-\-enable\-libxavs\*(C'\fR را به configure ارسال نمایید تا
فعال شود.
.SS xavs2
.IX Subsection "xavs2"
ابزار FFmpeg می‌تواند از کتابخانه xavs2 برای کدگذاری ویدیوی AVS2\-P2/IEEE1857.4 استفاده کند.
.PP
به <\fBhttps://github.com/pkuvcl/xavs2\fR> بروید و دستورالعمل‌ها را برای
نصب کتابخانه دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libxavs2\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.Sp
.RS 4
کتابخانه libxavs2 تحت مجوز عمومی گنو نسخه 2 یا بالاتر است
(برای جزئیات به <\fBhttp://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html\fR> مراجعه
کنید)، برای استفاده از آن باید مجوز FFmpeg را به GPL ارتقا دهید.
.RE
.SS "eXtra\-fast Essential Video Encoder (XEVE)"
.IX Subsection "eXtra-fast Essential Video Encoder (XEVE)"
ابزار FFmpeg می‌تواند از کتابخانه XEVE برای کدگذاری ویدیوی EVC استفاده کند.
.PP
به <\fBhttps://github.com/mpeg5/xeve\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه XEVE را دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libxeve\*(C'\fR را به configure ارسال کنید تا
فعال گردد.
.SS "eXtra\-fast Essential Video Decoder (XEVD)"
.IX Subsection "eXtra-fast Essential Video Decoder (XEVD)"
ابزار FFmpeg می‌تواند از کتابخانه XEVD برای رمزگشایی ویدیوی EVC استفاده کند.
.PP
به <\fBhttps://github.com/mpeg5/xevd\fR> مراجعه کرده و دستورالعمل‌های
نصب کتابخانه XEVD را دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libxevd\*(C'\fR را به configure بفرستید تا
فعال شود.
.SS ZVBI
.IX Subsection "ZVBI"
کتابخانه ZVBI یک کتابخانه رمزگشایی VBI است که می‌تواند توسط FFmpeg برای رمزگشایی صفحات
تله‌تکست DVB و زیرنویس‌های تله‌تکست DVB استفاده شود.
.PP
به <\fBhttp://sourceforge.net/projects/zapping\fR> بروید و دستورالعمل‌ها را برای
نصب کتابخانه دنبال نمایید. سپس \f(CW\*(C`\-\-enable\-libzvbi\*(C'\fR را به configure ارسال کنید تا
فعال شود.
.SH "قالب‌های پرونده پشتیبانی‌شده (SUPPORTED FILE FORMATS)"
.IX Header "SUPPORTED FILE FORMATS"
می‌توانید از گزینه‌های \f(CW\*(C`\-formats\*(C'\fR و \f(CW\*(C`\-codecs\*(C'\fR برای دریافت یک فهرست کامل استفاده کنید.
.SS "قالب‌های پرونده (File Formats)"
.IX Subsection "File Formats"
ابزار FFmpeg از قالب‌های پرونده زیر از طریق کتابخانه \f(CW\*(C`libavformat\*(C'\fR
پشتیبانی می‌کند:
.ie n .IP "\fBName  :  Encoding \fR\fB@tab\fR\fB Decoding \fR\fB@tab\fR\fB Comments\fR" 4
.el .IP "\fBName  :  Encoding \fR\f(CB@tab\fR\fB Decoding \fR\f(CB@tab\fR\fB Comments\fR" 4
.IX Item "Name : Encoding @tab Decoding @tab Comments"
.PD 0
.ie n .IP "\fB3dostr                     :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB3dostr                     :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "3dostr : @tab X"
.ie n .IP "\fB4xm                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB4xm                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "4xm : @tab X"
.PD
.Vb 1
\&    @tab قالب 4X Technologies، استفاده‌شده در برخی بازی‌ها.
.Ve
.ie n .IP "\fB8088flex TMV               :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB8088flex TMV               :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "8088flex TMV : @tab X"
.PD 0
.ie n .IP "\fBAAX                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAAX                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AAX : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی پیشرفته Audible، استفاده‌شده در کتاب‌های صوتی.
.Ve
.ie n .IP "\fBAA                         :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAA                         :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AA : @tab X"
.Vb 1
\&    @tab قالب‌های Audible نسخه 2، 3 و 4، استفاده‌شده در کتاب‌های صوتی.
.Ve
.ie n .IP "\fBACT Voice                  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBACT Voice                  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ACT Voice : @tab X"
.Vb 1
\&    @tab شامل صدای G.729
.Ve
.ie n .IP "\fBAdobe Filmstrip            :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAdobe Filmstrip            :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Adobe Filmstrip : X @tab X"
.PD 0
.ie n .IP "\fBAudio IFF (AIFF)           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAudio IFF (AIFF)           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Audio IFF (AIFF) : X @tab X"
.ie n .IP "\fBAmerican Laser Games MM    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAmerican Laser Games MM    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "American Laser Games MM : @tab X"
.PD
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی‌هایی مانند Mad Dog McCree.
.Ve
.ie n .IP "\fB3GPP AMR                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB3GPP AMR                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "3GPP AMR : X @tab X"
.PD 0
.ie n .IP "\fBAmazing Studio Packed Animation File   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAmazing Studio Packed Animation File   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Amazing Studio Packed Animation File : @tab X"
.PD
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی Heart Of Darkness.
.Ve
.ie n .IP "\fBApple HTTP Live Streaming  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBApple HTTP Live Streaming  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Apple HTTP Live Streaming : @tab X"
.PD 0
.ie n .IP "\fBArtworx Data Format        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBArtworx Data Format        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Artworx Data Format : @tab X"
.ie n .IP "\fBInterplay ACM              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBInterplay ACM              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Interplay ACM : @tab X"
.PD
.Vb 1
\&    @tab قالب صرفاً صوتی استفاده‌شده در برخی بازی‌های Interplay.
.Ve
.ie n .IP "\fBADP                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBADP                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ADP : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Nintendo Gamecube.
.Ve
.ie n .IP "\fBAFC                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAFC                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AFC : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Nintendo Gamecube.
.Ve
.ie n .IP "\fBADS/SS2                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBADS/SS2                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ADS/SS2 : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در PS2.
.Ve
.ie n .IP "\fBAPNG                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAPNG                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "APNG : X @tab X"
.PD 0
.ie n .IP "\fBASF                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBASF                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ASF : X @tab X"
.PD
.Vb 1
\&    @tab قالب استریم پیشرفته / فعال (ASF).
.Ve
.ie n .IP "\fBAST                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAST                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AST : X @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Nintendo Wii.
.Ve
.ie n .IP "\fBAVI                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAVI                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AVI : X @tab X"
.PD 0
.ie n .IP "\fBAviSynth                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAviSynth                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AviSynth : @tab X"
.ie n .IP "\fBAVR                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAVR                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AVR : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در مک (Mac).
.Ve
.ie n .IP "\fBAVS                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAVS                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AVS : @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی Creature Shock.
.Ve
.ie n .IP "\fBBeam Software SIFF         :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBeam Software SIFF         :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Beam Software SIFF : @tab X"
.Vb 1
\&    @tab قالب صوتی و تصویری استفاده‌شده در برخی بازی‌های Beam Software.
.Ve
.ie n .IP "\fBBethesda Softworks VID     :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBethesda Softworks VID     :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Bethesda Softworks VID : @tab X"
.Vb 1
\&    @tab استفاده‌شده در برخی بازی‌های Bethesda Softworks.
.Ve
.ie n .IP "\fBBinary text                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBinary text                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Binary text : @tab X"
.PD 0
.ie n .IP "\fBBink                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBink                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Bink : @tab X"
.PD
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده توسط بسیاری از بازی‌ها.
.Ve
.ie n .IP "\fBBink Audio                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBink Audio                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Bink Audio : @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای صرفاً صوتی استفاده‌شده در برخی بازی‌ها.
.Ve
.ie n .IP "\fBBitmap Brothers JV         :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBitmap Brothers JV         :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Bitmap Brothers JV : @tab X"
.Vb 1
\&    @tab استفاده‌شده در بازی‌های Z و Z95.
.Ve
.ie n .IP "\fBBRP                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBRP                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BRP : @tab X"
.Vb 1
\&    @tab قالب بازی‌های Argonaut.
.Ve
.ie n .IP "\fBBrute Force & Ignorance    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBrute Force & Ignorance    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Brute Force & Ignorance : @tab X"
.Vb 1
\&    @tab استفاده‌شده در بازی Flash Traffic: City of Angels.
.Ve
.ie n .IP "\fBBFSTM                      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBFSTM                      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BFSTM : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Nintendo WiiU (بر پایه BRSTM).
.Ve
.ie n .IP "\fBBRSTM                      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBRSTM                      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BRSTM : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Nintendo Wii.
.Ve
.ie n .IP "\fBBW64                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBW64                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BW64 : @tab X"
.Vb 1
\&    @tab قالب Broadcast Wave 64bit.
.Ve
.ie n .IP "\fBBWF                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBWF                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BWF : X @tab X"
.PD 0
.ie n .IP "\fBcodec2 (raw)               :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBcodec2 (raw)               :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "codec2 (raw) : X @tab X"
.PD
.Vb 1
\&    @tab برای رمزگشایی صحیح باید گزینه قالب \-mode به آن داده شود.
.Ve
.ie n .IP "\fBcodec2 (.c2 files)         :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBcodec2 (.c2 files)         :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "codec2 (.c2 files) : X @tab X"
.Vb 1
\&    @tab شامل سرآیند با اطلاعات نسخه و حالت، که پخش را ساده‌تر می‌کند.
.Ve
.ie n .IP "\fBCRI ADX                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRI ADX                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRI ADX : X @tab X"
.Vb 1
\&    @tab قالب صرفاً صوتی استفاده‌شده در بازی‌های ویدیویی کنسول.
.Ve
.ie n .IP "\fBCRI AIX                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRI AIX                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRI AIX : @tab X"
.PD 0
.ie n .IP "\fBCRI HCA                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRI HCA                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRI HCA : @tab X"
.PD
.Vb 1
\&    @tab قالب صرفاً صوتی استفاده‌شده در بازی‌های ویدیویی کنسول.
.Ve
.ie n .IP "\fBDiscworld II BMV           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDiscworld II BMV           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Discworld II BMV : @tab X"
.PD 0
.ie n .IP "\fBInterplay C93              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBInterplay C93              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Interplay C93 : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده در بازی Cyberia از شرکت Interplay.
.Ve
.ie n .IP "\fBDelphine Software International CIN  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDelphine Software International CIN  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Delphine Software International CIN : @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی‌های Delphine Software.
.Ve
.ie n .IP "\fBDigital Speech Standard (DSS)  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDigital Speech Standard (DSS)  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Digital Speech Standard (DSS) : @tab X"
.PD 0
.ie n .IP "\fBCD+G                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCD+G                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CD+G : @tab X"
.PD
.Vb 1
\&    @tab قالب ویدیویی استفاده‌شده در دیسک‌های کارائوکه +CD
.Ve
.ie n .IP "\fBPhantom Cine               :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPhantom Cine               :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Phantom Cine : @tab X"
.PD 0
.ie n .IP "\fBCommodore CDXL             :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCommodore CDXL             :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Commodore CDXL : @tab X"
.PD
.Vb 1
\&    @tab قالب ویدیویی Amiga CD
.Ve
.ie n .IP "\fBCore Audio Format          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCore Audio Format          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Core Audio Format : X @tab X"
.Vb 1
\&    @tab قالب صوتی Apple Core Audio
.Ve
.ie n .IP "\fBCRC testing format         :  X \fR\fB@tab\fR" 4
.el .IP "\fBCRC testing format         :  X \fR\f(CB@tab\fR" 4
.IX Item "CRC testing format : X @tab"
.PD 0
.ie n .IP "\fBCreative Voice             :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCreative Voice             :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Creative Voice : X @tab X"
.PD
.Vb 1
\&    @tab ساخته‌شده برای Sound Blaster Pro.
.Ve
.ie n .IP "\fBCRYO APC                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRYO APC                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRYO APC : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در برخی بازی‌های CRYO Interactive Entertainment.
.Ve
.ie n .IP "\fBD\-Cinema audio             :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBD\-Cinema audio             :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "D-Cinema audio : X @tab X"
.PD 0
.ie n .IP "\fBDeluxe Paint Animation     :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDeluxe Paint Animation     :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Deluxe Paint Animation : @tab X"
.ie n .IP "\fBDCSTR                      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDCSTR                      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DCSTR : @tab X"
.ie n .IP "\fBDFA                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDFA                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DFA : @tab X"
.PD
.Vb 1
\&    @tab این قالب در بازی Chronomaster استفاده شده است
.Ve
.ie n .IP "\fBDirectDraw Surface         :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDirectDraw Surface         :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DirectDraw Surface : @tab X"
.PD 0
.ie n .IP "\fBDSD Stream File (DSF)      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDSD Stream File (DSF)      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DSD Stream File (DSF) : @tab X"
.ie n .IP "\fBDV video                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDV video                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DV video : X @tab X"
.ie n .IP "\fBDXA                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDXA                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DXA : @tab X"
.PD
.Vb 2
\&    @tab این قالب در نسخه غیر ویندوزی بازی Feeble Files استفاده شده است
\&         game and different game cutscenes repacked for use with ScummVM.
.Ve
.ie n .IP "\fBElectronic Arts cdata   :     \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBElectronic Arts cdata   :     \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Electronic Arts cdata : @tab X"
.PD 0
.ie n .IP "\fBElectronic Arts Multimedia   :     \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBElectronic Arts Multimedia   :     \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Electronic Arts Multimedia : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده در بازی‌های مختلف EA؛ پرونده‌ها پسوندهایی مانند WVE و UV2 دارند.
.Ve
.ie n .IP "\fBEnsoniq Paris Audio File   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBEnsoniq Paris Audio File   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Ensoniq Paris Audio File : @tab X"
.PD 0
.ie n .IP "\fBFFM (FFserver live feed)   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFFM (FFserver live feed)   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "FFM (FFserver live feed) : X @tab X"
.ie n .IP "\fBFlash (SWF)                :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFlash (SWF)                :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Flash (SWF) : X @tab X"
.ie n .IP "\fBFlash 9 (AVM2)             :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFlash 9 (AVM2)             :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Flash 9 (AVM2) : X @tab X"
.PD
.Vb 1
\&    @tab تنها صدای جاسازی‌شده رمزگشایی می‌شود.
.Ve
.ie n .IP "\fBFLI/FLC/FLX animation      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFLI/FLC/FLX animation      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "FLI/FLC/FLX animation : @tab X"
.Vb 1
\&    @tab پرونده‌های .fli/.flc
.Ve
.ie n .IP "\fBFlash Video (FLV)          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFlash Video (FLV)          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Flash Video (FLV) : X @tab X"
.Vb 1
\&    @tab پرونده‌های ویدیویی Macromedia Flash
.Ve
.ie n .IP "\fBframecrc testing format    :  X \fR\fB@tab\fR" 4
.el .IP "\fBframecrc testing format    :  X \fR\f(CB@tab\fR" 4
.IX Item "framecrc testing format : X @tab"
.PD 0
.ie n .IP "\fBFunCom ISS                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFunCom ISS                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "FunCom ISS : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در بازی‌های گوناگون FunCom مانند The Longest Journey.
.Ve
.ie n .IP "\fBG.723.1                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBG.723.1                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "G.723.1 : X @tab X"
.PD 0
.ie n .IP "\fBG.726                      :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB Both left\- and right\-justified.\fR" 4
.el .IP "\fBG.726                      :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB Both left\- and right\-justified.\fR" 4
.IX Item "G.726 : @tab X @tab Both left- and right-justified."
.ie n .IP "\fBG.729 BIT                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBG.729 BIT                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "G.729 BIT : X @tab X"
.ie n .IP "\fBG.729 raw                  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBG.729 raw                  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "G.729 raw : @tab X"
.ie n .IP "\fBGENH                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBGENH                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "GENH : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی برای بازی‌های گوناگون.
.Ve
.ie n .IP "\fBGIF Animation              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBGIF Animation              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "GIF Animation : X @tab X"
.PD 0
.ie n .IP "\fBGXF                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBGXF                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "GXF : X @tab X"
.PD
.Vb 2
\&    @tab قالب General eXchange Format SMPTE 360M، استفاده‌شده توسط Thomson Grass Valley
\&         playout servers.
.Ve
.ie n .IP "\fBHNM  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBHNM  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "HNM : @tab X"
.Vb 1
\&    @tab تنها نسخه 4 پشتیبانی می‌شود، استفاده‌شده در برخی بازی‌های Cryo Interactive
.Ve
.ie n .IP "\fBiCEDraw File               :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBiCEDraw File               :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "iCEDraw File : @tab X"
.PD 0
.ie n .IP "\fBICO                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBICO                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ICO : X @tab X"
.PD
.Vb 1
\&    @tab قالب آیکون مایکروسافت ویندوز (ICO)
.Ve
.ie n .IP "\fBid Quake II CIN video      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBid Quake II CIN video      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "id Quake II CIN video : @tab X"
.PD 0
.ie n .IP "\fBid RoQ                     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBid RoQ                     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "id RoQ : X @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده در Quake III، Jedi Knight 2 و سایر بازی‌های رایانه‌ای.
.Ve
.ie n .IP "\fBIEC61937 encapsulation  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIEC61937 encapsulation  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IEC61937 encapsulation : X @tab X"
.PD 0
.ie n .IP "\fBIFF                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIFF                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IFF : @tab X"
.PD
.Vb 1
\&    @tab قالب پرونده مبادله‌ای (IFF)
.Ve
.ie n .IP "\fBIFV                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIFV                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IFV : @tab X"
.Vb 1
\&    @tab قالبی مورد استفاده در برخی دستگاه‌های DVR قدیمی دوربین مداربسته.
.Ve
.ie n .IP "\fBiLBC                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBiLBC                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "iLBC : X @tab X"
.PD 0
.ie n .IP "\fBInterplay MVE              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBInterplay MVE              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Interplay MVE : @tab X"
.PD
.Vb 1
\&    @tab قالب استفاده‌شده در بازی‌های رایانه‌ای گوناگون Interplay.
.Ve
.ie n .IP "\fBIterated Systems ClearVideo  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIterated Systems ClearVideo  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Iterated Systems ClearVideo : @tab X"
.Vb 1
\&    @tab تنها فریم‌های I
.Ve
.ie n .IP "\fBIV8                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIV8                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IV8 : @tab X"
.Vb 1
\&    @tab قالبی تولیدشده توسط سرور ویدیویی IndigoVision 8000.
.Ve
.ie n .IP "\fBIVF (On2)                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIVF (On2)                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IVF (On2) : X @tab X"
.Vb 1
\&    @tab قالبی مورد استفاده توسط libvpx
.Ve
.ie n .IP "\fBInternet Video Recording   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBInternet Video Recording   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Internet Video Recording : @tab X"
.PD 0
.ie n .IP "\fBIRCAM                      :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIRCAM                      :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IRCAM : X @tab X"
.ie n .IP "\fBLAF                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLAF                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LAF : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی Limitless Audio Format
.Ve
.ie n .IP "\fBLATM                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLATM                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LATM : X @tab X"
.PD 0
.ie n .IP "\fBLMLM4                      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLMLM4                      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LMLM4 : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده توسط بردهای MPEG\-4 PCI شرکت Linux Media Labs
.Ve
.ie n .IP "\fBLOAS                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLOAS                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LOAS : @tab X"
.Vb 1
\&    @tab شامل صدای AAC مالتی‌پلکس‌شده با LATM
.Ve
.ie n .IP "\fBLRC                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLRC                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LRC : X @tab X"
.PD 0
.ie n .IP "\fBLVF                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLVF                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LVF : @tab X"
.ie n .IP "\fBLXF                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLXF                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "LXF : @tab X"
.PD
.Vb 1
\&    @tab قالب استریم بومی VR، استفاده‌شده توسط سرورهای ویدیویی Leitch/Harris.
.Ve
.ie n .IP "\fBMagic Lantern Video (MLV)  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMagic Lantern Video (MLV)  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Magic Lantern Video (MLV) : @tab X"
.PD 0
.ie n .IP "\fBMatroska                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMatroska                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Matroska : X @tab X"
.ie n .IP "\fBMatroska audio             :  X \fR\fB@tab\fR" 4
.el .IP "\fBMatroska audio             :  X \fR\f(CB@tab\fR" 4
.IX Item "Matroska audio : X @tab"
.ie n .IP "\fBFFmpeg metadata            :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFFmpeg metadata            :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "FFmpeg metadata : X @tab X"
.PD
.Vb 1
\&    @tab فراداده به قالب متنی.
.Ve
.ie n .IP "\fBMAXIS XA                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMAXIS XA                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MAXIS XA : @tab X"
.Vb 1
\&    @tab استفاده‌شده در Sim City 3000؛ پسوند پرونده .xa.
.Ve
.ie n .IP "\fBMCA                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMCA                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MCA : @tab X"
.Vb 1
\&    @tab استفاده‌شده در برخی بازی‌های Capcom؛ پسوند پرونده .mca.
.Ve
.ie n .IP "\fBMD Studio                  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMD Studio                  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MD Studio : @tab X"
.PD 0
.ie n .IP "\fBMetal Gear Solid: The Twin Snakes  :  \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMetal Gear Solid: The Twin Snakes  :  \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Metal Gear Solid: The Twin Snakes : @tab X"
.ie n .IP "\fBMegalux Frame              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMegalux Frame              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Megalux Frame : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده توسط Megalux Ultimate Paint
.Ve
.ie n .IP "\fBMobiClip MODS              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMobiClip MODS              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MobiClip MODS : @tab X"
.PD 0
.ie n .IP "\fBMobiClip MOFLEX            :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMobiClip MOFLEX            :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MobiClip MOFLEX : @tab X"
.ie n .IP "\fBMobotix .mxg               :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMobotix .mxg               :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Mobotix .mxg : @tab X"
.ie n .IP "\fBMonkey\*(Aqs Audio             :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMonkey\*(Aqs Audio             :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Monkey's Audio : @tab X"
.ie n .IP "\fBMotion Pixels MVI          :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMotion Pixels MVI          :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Motion Pixels MVI : @tab X"
.ie n .IP "\fBMOV/QuickTime/MP4          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMOV/QuickTime/MP4          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MOV/QuickTime/MP4 : X @tab X"
.PD
.Vb 1
\&    @tab گونه‌های 3GP، 3GP2، PSP و iPod پشتیبانی می‌شوند
.Ve
.ie n .IP "\fBMP2                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMP2                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MP2 : X @tab X"
.PD 0
.ie n .IP "\fBMP3                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMP3                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MP3 : X @tab X"
.ie n .IP "\fBMPEG\-1 System              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPEG\-1 System              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPEG-1 System : X @tab X"
.PD
.Vb 1
\&    @tab صدا و تصویر میکس‌شده، قالب VCD پشتیبانی می‌شود
.Ve
.ie n .IP "\fBMPEG\-PS (program stream)   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPEG\-PS (program stream)   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPEG-PS (program stream) : X @tab X"
.Vb 1
\&    @tab همچنین به عنوان پرونده C<VOB> شناخته می‌شود، قالب‌های SVCD و DVD پشتیبانی می‌شوند
.Ve
.ie n .IP "\fBMPEG\-TS (transport stream)  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPEG\-TS (transport stream)  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPEG-TS (transport stream) : X @tab X"
.Vb 1
\&    @tab همچنین به عنوان DVB Transport Stream شناخته می‌شود
.Ve
.ie n .IP "\fBMPEG\-4                     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPEG\-4                     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPEG-4 : X @tab X"
.Vb 1
\&    @tab قالب MPEG\-4 گونه‌ای از QuickTime است.
.Ve
.ie n .IP "\fBMSF                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMSF                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MSF : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در PS3.
.Ve
.ie n .IP "\fBMirillis FIC video         :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMirillis FIC video         :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Mirillis FIC video : @tab X"
.Vb 1
\&    @tab بدون رندر نشانگر مکان‌نما.
.Ve
.ie n .IP "\fBMIDI Sample Dump Standard  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMIDI Sample Dump Standard  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MIDI Sample Dump Standard : @tab X"
.PD 0
.ie n .IP "\fBMIME multipart JPEG        :  X \fR\fB@tab\fR" 4
.el .IP "\fBMIME multipart JPEG        :  X \fR\f(CB@tab\fR" 4
.IX Item "MIME multipart JPEG : X @tab"
.ie n .IP "\fBMSN TCP webcam             :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMSN TCP webcam             :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MSN TCP webcam : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده توسط استریم‌های وب‌کم MSN Messenger.
.Ve
.ie n .IP "\fBMTV                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMTV                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MTV : @tab X"
.PD 0
.ie n .IP "\fBMusepack                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMusepack                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Musepack : @tab X"
.ie n .IP "\fBMusepack SV8               :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMusepack SV8               :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Musepack SV8 : @tab X"
.ie n .IP "\fBMaterial eXchange Format (MXF)  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMaterial eXchange Format (MXF)  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Material eXchange Format (MXF) : X @tab X"
.PD
.Vb 1
\&    @tab استاندارد SMPTE 377M، مورد استفاده در سینمای دیجیتال (D\-Cinema) و صنعت پخش.
.Ve
.ie n .IP "\fBMaterial eXchange Format (MXF), D\-10 Mapping  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMaterial eXchange Format (MXF), D\-10 Mapping  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Material eXchange Format (MXF), D-10 Mapping : X @tab X"
.Vb 1
\&    @tab استاندارد SMPTE 386M، نگاشت D\-10/IMX.
.Ve
.ie n .IP "\fBNC camera feed             :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNC camera feed             :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "NC camera feed : @tab X"
.Vb 1
\&    @tab استریم‌های دوربین NC (AVIP NC4600)
.Ve
.ie n .IP "\fBNIST SPeech HEader REsources  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNIST SPeech HEader REsources  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "NIST SPeech HEader REsources : @tab X"
.PD 0
.ie n .IP "\fBComputerized Speech Lab NSP  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBComputerized Speech Lab NSP  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Computerized Speech Lab NSP : @tab X"
.ie n .IP "\fBNTT TwinVQ (VQF)           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNTT TwinVQ (VQF)           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "NTT TwinVQ (VQF) : @tab X"
.PD
.Vb 1
\&    @tab قالب TwinVQ شرکت تلگراف و تلفن نیپون (NTT).
.Ve
.ie n .IP "\fBNullsoft Streaming Video   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNullsoft Streaming Video   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Nullsoft Streaming Video : @tab X"
.PD 0
.ie n .IP "\fBNuppelVideo                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNuppelVideo                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "NuppelVideo : @tab X"
.ie n .IP "\fBNUT                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBNUT                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "NUT : X @tab X"
.PD
.Vb 1
\&    @tab قالب کانتینر باز NUT
.Ve
.ie n .IP "\fBOgg                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBOgg                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Ogg : X @tab X"
.PD 0
.ie n .IP "\fBPlaystation Portable PMP   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPlaystation Portable PMP   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Playstation Portable PMP : @tab X"
.ie n .IP "\fBPortable Voice Format      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPortable Voice Format      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Portable Voice Format : @tab X"
.ie n .IP "\fBRK Audio (RKA)             :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRK Audio (RKA)             :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RK Audio (RKA) : @tab X"
.ie n .IP "\fBTechnoTrend PVA            :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTechnoTrend PVA            :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "TechnoTrend PVA : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده توسط بردهای TechnoTrend DVB PCI.
.Ve
.ie n .IP "\fBQCP                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBQCP                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "QCP : @tab X"
.PD 0
.ie n .IP "\fBraw ADTS (AAC)             :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw ADTS (AAC)             :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw ADTS (AAC) : X @tab X"
.ie n .IP "\fBraw AC\-3                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw AC\-3                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw AC-3 : X @tab X"
.ie n .IP "\fBraw AMR\-NB                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw AMR\-NB                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw AMR-NB : @tab X"
.ie n .IP "\fBraw AMR\-WB                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw AMR\-WB                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw AMR-WB : @tab X"
.ie n .IP "\fBraw APAC                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw APAC                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw APAC : @tab X"
.ie n .IP "\fBraw APV                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw APV                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw APV : X @tab X"
.ie n .IP "\fBraw aptX                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw aptX                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw aptX : X @tab X"
.ie n .IP "\fBraw aptX HD                :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw aptX HD                :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw aptX HD : X @tab X"
.ie n .IP "\fBraw Bonk                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw Bonk                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw Bonk : @tab X"
.ie n .IP "\fBraw Chinese AVS video      :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw Chinese AVS video      :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw Chinese AVS video : X @tab X"
.ie n .IP "\fBraw DFPWM                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw DFPWM                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw DFPWM : X @tab X"
.ie n .IP "\fBraw Dirac                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw Dirac                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw Dirac : X @tab X"
.ie n .IP "\fBraw DNxHD                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw DNxHD                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw DNxHD : X @tab X"
.ie n .IP "\fBraw DTS                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw DTS                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw DTS : X @tab X"
.ie n .IP "\fBraw DTS\-HD                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw DTS\-HD                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw DTS-HD : @tab X"
.ie n .IP "\fBraw E\-AC\-3                 :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw E\-AC\-3                 :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw E-AC-3 : X @tab X"
.ie n .IP "\fBraw EVC                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw EVC                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw EVC : X @tab X"
.ie n .IP "\fBraw FLAC                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw FLAC                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw FLAC : X @tab X"
.ie n .IP "\fBraw G.728                  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw G.728                  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw G.728 : @tab X"
.ie n .IP "\fBraw GSM                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw GSM                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw GSM : @tab X"
.ie n .IP "\fBraw H.261                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw H.261                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw H.261 : X @tab X"
.ie n .IP "\fBraw H.263                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw H.263                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw H.263 : X @tab X"
.ie n .IP "\fBraw H.264                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw H.264                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw H.264 : X @tab X"
.ie n .IP "\fBraw HEVC                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw HEVC                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw HEVC : X @tab X"
.ie n .IP "\fBraw Ingenient MJPEG        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw Ingenient MJPEG        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw Ingenient MJPEG : @tab X"
.ie n .IP "\fBraw MJPEG                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MJPEG                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MJPEG : X @tab X"
.ie n .IP "\fBraw MLP                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MLP                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MLP : @tab X"
.ie n .IP "\fBraw MPEG                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MPEG                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MPEG : @tab X"
.ie n .IP "\fBraw MPEG\-1                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MPEG\-1                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MPEG-1 : @tab X"
.ie n .IP "\fBraw MPEG\-2                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MPEG\-2                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MPEG-2 : @tab X"
.ie n .IP "\fBraw MPEG\-4                 :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw MPEG\-4                 :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw MPEG-4 : X @tab X"
.ie n .IP "\fBraw NULL                   :  X \fR\fB@tab\fR" 4
.el .IP "\fBraw NULL                   :  X \fR\f(CB@tab\fR" 4
.IX Item "raw NULL : X @tab"
.ie n .IP "\fBraw video                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw video                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw video : X @tab X"
.ie n .IP "\fBraw id RoQ                 :  X \fR\fB@tab\fR" 4
.el .IP "\fBraw id RoQ                 :  X \fR\f(CB@tab\fR" 4
.IX Item "raw id RoQ : X @tab"
.ie n .IP "\fBraw OBU                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw OBU                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw OBU : X @tab X"
.ie n .IP "\fBraw OSQ                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw OSQ                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw OSQ : @tab X"
.ie n .IP "\fBraw SBC                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw SBC                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw SBC : X @tab X"
.ie n .IP "\fBraw Shorten                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw Shorten                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw Shorten : @tab X"
.ie n .IP "\fBraw TAK                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw TAK                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw TAK : @tab X"
.ie n .IP "\fBraw TrueHD                 :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw TrueHD                 :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw TrueHD : X @tab X"
.ie n .IP "\fBraw VC\-1                   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw VC\-1                   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw VC-1 : X @tab X"
.ie n .IP "\fBraw PCM A\-law              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM A\-law              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM A-law : X @tab X"
.ie n .IP "\fBraw PCM mu\-law             :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM mu\-law             :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM mu-law : X @tab X"
.ie n .IP "\fBraw PCM Archimedes VIDC    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM Archimedes VIDC    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM Archimedes VIDC : X @tab X"
.ie n .IP "\fBraw PCM signed 8 bit       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 8 bit       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 8 bit : X @tab X"
.ie n .IP "\fBraw PCM signed 16 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 16 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 16 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 16 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 16 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 16 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 24 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 24 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 24 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 24 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 24 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 24 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 32 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 32 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 32 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 32 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 32 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 32 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 64 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 64 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 64 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM signed 64 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM signed 64 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM signed 64 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 8 bit     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 8 bit     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 8 bit : X @tab X"
.ie n .IP "\fBraw PCM unsigned 16 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 16 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 16 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 16 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 16 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 16 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 24 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 24 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 24 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 24 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 24 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 24 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 32 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 32 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 32 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM unsigned 32 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM unsigned 32 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM unsigned 32 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM 16.8 floating point little\-endian  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM 16.8 floating point little\-endian  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM 16.8 floating point little-endian : @tab X"
.ie n .IP "\fBraw PCM 24.0 floating point little\-endian  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM 24.0 floating point little\-endian  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM 24.0 floating point little-endian : @tab X"
.ie n .IP "\fBraw PCM floating\-point 32 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM floating\-point 32 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM floating-point 32 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM floating\-point 32 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM floating\-point 32 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM floating-point 32 bit little-endian : X @tab X"
.ie n .IP "\fBraw PCM floating\-point 64 bit big\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM floating\-point 64 bit big\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM floating-point 64 bit big-endian : X @tab X"
.ie n .IP "\fBraw PCM floating\-point 64 bit little\-endian   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBraw PCM floating\-point 64 bit little\-endian   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "raw PCM floating-point 64 bit little-endian : X @tab X"
.ie n .IP "\fBRDT                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRDT                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RDT : @tab X"
.ie n .IP "\fBREDCODE R3D                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBREDCODE R3D                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "REDCODE R3D : @tab X"
.PD
.Vb 1
\&    @tab قالب پرونده مورد استفاده توسط دوربین‌های دیجیتال RED، شامل فریم‌های JPEG 2000 و صدای PCM.
.Ve
.ie n .IP "\fBRealMedia                  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRealMedia                  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RealMedia : X @tab X"
.PD 0
.ie n .IP "\fBRedirector                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRedirector                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Redirector : @tab X"
.ie n .IP "\fBRedSpark                   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRedSpark                   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RedSpark : @tab X"
.ie n .IP "\fBRenderware TeXture Dictionary  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRenderware TeXture Dictionary  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Renderware TeXture Dictionary : @tab X"
.ie n .IP "\fBResolume DXV               :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBResolume DXV               :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Resolume DXV : X @tab X"
.PD
.Vb 1
\&    @tab کدگذاری تنها برای قالب بافت DXT1 (کیفیت عادی، بدون آلفا) پشتیبانی می‌شود.
.Ve
.ie n .IP "\fBRF64                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRF64                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RF64 : @tab X"
.PD 0
.ie n .IP "\fBRL2                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRL2                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RL2 : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی و تصویری استفاده‌شده در برخی بازی‌های Entertainment Software Partners.
.Ve
.ie n .IP "\fBRPL/ARMovie                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRPL/ARMovie                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RPL/ARMovie : @tab X"
.PD 0
.ie n .IP "\fBLego Mindstorms RSO        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLego Mindstorms RSO        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Lego Mindstorms RSO : X @tab X"
.ie n .IP "\fBRSD                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRSD                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RSD : @tab X"
.ie n .IP "\fBRTMP                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRTMP                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RTMP : X @tab X"
.PD
.Vb 1
\&    @tab خروجی از طریق انتشار استریم به سرور RTMP انجام می‌شود
.Ve
.ie n .IP "\fBRTP                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRTP                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RTP : X @tab X"
.PD 0
.ie n .IP "\fBRTSP                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRTSP                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RTSP : X @tab X"
.ie n .IP "\fBSample Dump eXchange       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSample Dump eXchange       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sample Dump eXchange : @tab X"
.ie n .IP "\fBSAP                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSAP                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SAP : X @tab X"
.ie n .IP "\fBSBG                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSBG                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SBG : @tab X"
.ie n .IP "\fBSDNS                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSDNS                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SDNS : @tab X"
.ie n .IP "\fBSDP                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSDP                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SDP : @tab X"
.ie n .IP "\fBSER                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSER                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SER : @tab X"
.ie n .IP "\fBDigital Pictures SGA       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDigital Pictures SGA       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Digital Pictures SGA : @tab X"
.ie n .IP "\fBSega FILM/CPK              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSega FILM/CPK              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sega FILM/CPK : X @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده در بسیاری از بازی‌های کنسول Sega Saturn.
.Ve
.ie n .IP "\fBSilicon Graphics Movie     :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSilicon Graphics Movie     :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Silicon Graphics Movie : @tab X"
.PD 0
.ie n .IP "\fBSierra SOL                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSierra SOL                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sierra SOL : @tab X"
.PD
.Vb 1
\&    @tab پرونده‌های .sol استفاده‌شده در بازی‌های Sierra Online.
.Ve
.ie n .IP "\fBSierra VMD                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSierra VMD                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sierra VMD : @tab X"
.Vb 1
\&    @tab استفاده‌شده در بازی‌های Sierra CD\-ROM.
.Ve
.ie n .IP "\fBSmacker                    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSmacker                    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Smacker : @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده توسط بسیاری از بازی‌ها.
.Ve
.ie n .IP "\fBSMJPEG                     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSMJPEG                     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SMJPEG : X @tab X"
.Vb 1
\&    @tab استفاده‌شده در پورت‌های بازی‌های خاص Loki.
.Ve
.ie n .IP "\fBSMPTE 337M encapsulation   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSMPTE 337M encapsulation   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SMPTE 337M encapsulation : @tab X"
.PD 0
.ie n .IP "\fBSmush                      :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSmush                      :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Smush : @tab X"
.PD
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در برخی بازی‌های LucasArts.
.Ve
.ie n .IP "\fBSony OpenMG (OMA)          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSony OpenMG (OMA)          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sony OpenMG (OMA) : X @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در Sony Sonic Stage و Sony Vegas.
.Ve
.ie n .IP "\fBSony PlayStation STR       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSony PlayStation STR       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sony PlayStation STR : @tab X"
.PD 0
.ie n .IP "\fBSony Wave64 (W64)          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSony Wave64 (W64)          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sony Wave64 (W64) : X @tab X"
.ie n .IP "\fBSoX native format          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSoX native format          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SoX native format : X @tab X"
.ie n .IP "\fBSUN AU format              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSUN AU format              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SUN AU format : X @tab X"
.ie n .IP "\fBSUP raw PGS subtitles      :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSUP raw PGS subtitles      :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SUP raw PGS subtitles : X @tab X"
.ie n .IP "\fBSVAG                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSVAG                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SVAG : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در بازی‌های Konami PS2.
.Ve
.ie n .IP "\fBTDSC                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTDSC                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "TDSC : @tab X"
.PD 0
.ie n .IP "\fBText files                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBText files                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Text files : @tab X"
.ie n .IP "\fBTHP                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTHP                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "THP : @tab X"
.PD
.Vb 1
\&    @tab استفاده‌شده در Nintendo GameCube.
.Ve
.ie n .IP "\fBTiertex Limited SEQ        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTiertex Limited SEQ        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Tiertex Limited SEQ : @tab X"
.Vb 1
\&    @tab پرونده‌های Tiertex .seq استفاده‌شده در نسخه داس CD\-ROM بازی Flashback.
.Ve
.ie n .IP "\fBTrue Audio                 :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTrue Audio                 :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "True Audio : X @tab X"
.PD 0
.ie n .IP "\fBVAG                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVAG                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VAG : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در بسیاری از بازی‌های سونی PS2.
.Ve
.ie n .IP "\fBVC\-1 test bitstream        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVC\-1 test bitstream        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VC-1 test bitstream : X @tab X"
.PD 0
.ie n .IP "\fBVidvox Hap                 :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVidvox Hap                 :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Vidvox Hap : X @tab X"
.ie n .IP "\fBVivo                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVivo                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Vivo : @tab X"
.ie n .IP "\fBVPK                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVPK                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VPK : @tab X"
.PD
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در بازی‌های سونی PS.
.Ve
.ie n .IP "\fBMarble WADY                :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMarble WADY                :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Marble WADY : @tab X"
.PD 0
.ie n .IP "\fBWAV                        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWAV                        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WAV : X @tab X"
.ie n .IP "\fBWaveform Archiver          :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWaveform Archiver          :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Waveform Archiver : @tab X"
.ie n .IP "\fBWavPack                    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWavPack                    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WavPack : X @tab X"
.ie n .IP "\fBWebM                       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWebM                       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WebM : X @tab X"
.ie n .IP "\fBWindows Televison (WTV)    :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWindows Televison (WTV)    :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Windows Televison (WTV) : X @tab X"
.ie n .IP "\fBWing Commander III movie   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWing Commander III movie   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Wing Commander III movie : @tab X"
.PD
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی رایانه‌ای Wing Commander III از شرکت Origin.
.Ve
.ie n .IP "\fBWestwood Studios audio     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWestwood Studios audio     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Westwood Studios audio : X @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی‌های Westwood Studios.
.Ve
.ie n .IP "\fBWestwood Studios VQA       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWestwood Studios VQA       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Westwood Studios VQA : @tab X"
.Vb 1
\&    @tab قالب چندرسانه‌ای استفاده‌شده در بازی‌های Westwood Studios.
.Ve
.ie n .IP "\fBWideband Single\-bit Data (WSD)  :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWideband Single\-bit Data (WSD)  :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Wideband Single-bit Data (WSD) : @tab X"
.PD 0
.ie n .IP "\fBWVE                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWVE                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WVE : @tab X"
.ie n .IP "\fBKonami XMD                 :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBKonami XMD                 :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Konami XMD : @tab X"
.ie n .IP "\fBXMV                        :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXMV                        :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XMV : @tab X"
.PD
.Vb 1
\&    @tab کانتینر ویدیویی مایکروسافت استفاده‌شده در بازی‌های Xbox.
.Ve
.ie n .IP "\fBXVAG                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXVAG                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XVAG : @tab X"
.Vb 1
\&    @tab قالب صوتی استفاده‌شده در PS3.
.Ve
.ie n .IP "\fBxWMA                       :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBxWMA                       :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "xWMA : @tab X"
.Vb 1
\&    @tab کانتینر صوتی مایکروسافت استفاده‌شده توسط XAudio 2.
.Ve
.ie n .IP "\fBeXtended BINary text (XBIN)  :  \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBeXtended BINary text (XBIN)  :  \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "eXtended BINary text (XBIN) : @tab X"
.PD 0
.ie n .IP "\fBYUV4MPEG pipe              :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBYUV4MPEG pipe              :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "YUV4MPEG pipe : X @tab X"
.ie n .IP "\fBPsygnosis YOP              :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPsygnosis YOP              :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Psygnosis YOP : @tab X"
.PD
.PP
\&\f(CW\*(C`X\*(C'\fR به این معنی است که قابلیت آن ستون (کدگذاری / رمزگشایی) پشتیبانی می‌شود.
.SS "قالب‌های تصویر (Image Formats)"
.IX Subsection "Image Formats"
ابزار FFmpeg می‌تواند تصاویر را برای هر فریم از یک توالی ویدیویی بخواند و بنویسد.
قالب‌های تصویر زیر پشتیبانی می‌شوند:
.ie n .IP "\fBName  :  Encoding \fR\fB@tab\fR\fB Decoding \fR\fB@tab\fR\fB Comments\fR" 4
.el .IP "\fBName  :  Encoding \fR\f(CB@tab\fR\fB Decoding \fR\f(CB@tab\fR\fB Comments\fR" 4
.IX Item "Name : Encoding @tab Decoding @tab Comments"
.PD 0
.ie n .IP "\fB.Y.U.V        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB.Y.U.V        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item ".Y.U.V : X @tab X"
.PD
.Vb 1
\&    @tab یک پرونده خام به ازای هر مولفه
.Ve
.ie n .IP "\fBAlias PIX     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAlias PIX     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Alias PIX : X @tab X"
.Vb 1
\&    @tab قالب تصویر Alias/Wavefront PIX
.Ve
.ie n .IP "\fBanimated GIF  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBanimated GIF  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "animated GIF : X @tab X"
.PD 0
.ie n .IP "\fBAPNG          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAPNG          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "APNG : X @tab X"
.PD
.Vb 1
\&    @tab قالب تصاویر متحرک شبکه (APNG)
.Ve
.ie n .IP "\fBBMP           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBMP           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BMP : X @tab X"
.Vb 1
\&    @tab تصویر بیت‌مپ مایکروسافت (BMP)
.Ve
.ie n .IP "\fBBRender PIX   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBRender PIX   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "BRender PIX : @tab X"
.Vb 1
\&    @tab قالب تصویر موتور سه‌بعدی Argonaut BRender.
.Ve
.ie n .IP "\fBCRI           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRI           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRI : @tab X"
.Vb 1
\&    @tab قالب Cintel RAW
.Ve
.ie n .IP "\fBDPX           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDPX           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DPX : X @tab X"
.Vb 1
\&    @tab تبادل تصاویر دیجیتال (DPX)
.Ve
.ie n .IP "\fBEXR           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBEXR           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "EXR : @tab X"
.Vb 1
\&    @tab قالب OpenEXR
.Ve
.ie n .IP "\fBFITS          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBFITS          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "FITS : X @tab X"
.Vb 1
\&    @tab سامانه منعطف انتقال تصویر (FITS)
.Ve
.ie n .IP "\fBHDR           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBHDR           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "HDR : X @tab X"
.Vb 1
\&    @tab قالب تصویر Radiance HDR RGBE
.Ve
.ie n .IP "\fBIMG           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBIMG           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "IMG : @tab X"
.Vb 1
\&    @tab تصویر شطرنجی (رستر) GEM
.Ve
.ie n .IP "\fBJPEG          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBJPEG          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "JPEG : X @tab X"
.Vb 1
\&    @tab قالب Progressive JPEG پشتیبانی نمی‌شود.
.Ve
.ie n .IP "\fBJPEG 2000     :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBJPEG 2000     :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "JPEG 2000 : X @tab X"
.PD 0
.ie n .IP "\fBJPEG\-LS       :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBJPEG\-LS       :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "JPEG-LS : X @tab X"
.ie n .IP "\fBJPEG\-XS       :  E \fR\fB@tab\fR\fB E\fR" 4
.el .IP "\fBJPEG\-XS       :  E \fR\f(CB@tab\fR\fB E\fR" 4
.IX Item "JPEG-XS : E @tab E"
.PD
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه خارجی libsvtjpegxs
.Ve
.ie n .IP "\fBLJPEG         :  X \fR\fB@tab\fR" 4
.el .IP "\fBLJPEG         :  X \fR\f(CB@tab\fR" 4
.IX Item "LJPEG : X @tab"
.Vb 1
\&    @tab قالب JPEG بدون افت (Lossless)
.Ve
.ie n .IP "\fBMedia 100     :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMedia 100     :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Media 100 : @tab X"
.PD 0
.ie n .IP "\fBMSP           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMSP           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MSP : @tab X"
.PD
.Vb 1
\&    @tab تصویر مایکروسافت پینت (MSP)
.Ve
.ie n .IP "\fBPAM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPAM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PAM : X @tab X"
.Vb 1
\&    @tab قالب PAM یک پسوند PNM با پشتیبانی از کانال آلفا است.
.Ve
.ie n .IP "\fBPBM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPBM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PBM : X @tab X"
.Vb 1
\&    @tab قالب تصویر بیت‌مپ قابل‌حمل (PBM)
.Ve
.ie n .IP "\fBPCD           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPCD           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PCD : @tab X"
.Vb 1
\&    @tab قالب PhotoCD
.Ve
.ie n .IP "\fBPCX           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPCX           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PCX : X @tab X"
.Vb 1
\&    @tab قالب تصویر PC Paintbrush
.Ve
.ie n .IP "\fBPFM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPFM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PFM : X @tab X"
.Vb 1
\&    @tab قالب تصویر FloatMap قابل‌حمل (PFM)
.Ve
.ie n .IP "\fBPGM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPGM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PGM : X @tab X"
.Vb 1
\&    @tab قالب تصویر GrayMap قابل‌حمل (PGM)
.Ve
.ie n .IP "\fBPGMYUV        :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPGMYUV        :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PGMYUV : X @tab X"
.Vb 1
\&    @tab قالب PGM به همراه مولفه‌های U و V در YUV 4:2:0
.Ve
.ie n .IP "\fBPGX           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPGX           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PGX : @tab X"
.Vb 1
\&    @tab دیکودر پرونده‌های PGX
.Ve
.ie n .IP "\fBPHM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPHM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PHM : X @tab X"
.Vb 1
\&    @tab قالب تصویر HalfFloatMap قابل‌حمل (PHM)
.Ve
.ie n .IP "\fBPIC           :  \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPIC           :  \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PIC : @tab X"
.Vb 1
\&    @tab قالب Pictor/PC Paint
.Ve
.ie n .IP "\fBPNG           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPNG           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PNG : X @tab X"
.Vb 1
\&    @tab قالب تصویر گرافیک شبکه‌ای قابل‌حمل (PNG)
.Ve
.ie n .IP "\fBPPM           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPPM           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PPM : X @tab X"
.Vb 1
\&    @tab قالب تصویر PixelMap قابل‌حمل (PPM)
.Ve
.ie n .IP "\fBPSD           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPSD           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PSD : @tab X"
.Vb 1
\&    @tab قالب ادوبی فتوشاپ (PSD)
.Ve
.ie n .IP "\fBPTX           :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPTX           :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PTX : @tab X"
.Vb 1
\&    @tab قالب V.Flash PTX
.Ve
.ie n .IP "\fBQOI           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBQOI           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "QOI : X @tab X"
.Vb 1
\&    @tab قالب تصویر Quite OK Image (QOI)
.Ve
.ie n .IP "\fBSGI           :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSGI           :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SGI : X @tab X"
.Vb 1
\&    @tab قالب تصویر RGB متعلق به SGI
.Ve
.ie n .IP "\fBSun Rasterfile   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSun Rasterfile   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Sun Rasterfile : X @tab X"
.Vb 1
\&    @tab قالب تصویر Sun RAS
.Ve
.ie n .IP "\fBTIFF          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTIFF          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "TIFF : X @tab X"
.Vb 1
\&    @tab قالب‌های YUV، JPEG و برخی پسوندها هنوز پشتیبانی نمی‌شوند.
.Ve
.ie n .IP "\fBTruevision Targa   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTruevision Targa   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Truevision Targa : X @tab X"
.Vb 1
\&    @tab قالب تصویر Targa (.TGA)
.Ve
.ie n .IP "\fBVBN   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVBN   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VBN : X @tab X"
.Vb 1
\&    @tab قالب تصویر باینری Vizrt
.Ve
.ie n .IP "\fBWBMP          :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWBMP          :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WBMP : X @tab X"
.Vb 1
\&    @tab قالب تصویر بیت‌مپ پروتکل برنامه‌های بی‌سیم (WBMP)
.Ve
.ie n .IP "\fBWebP          :  E \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWebP          :  E \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WebP : E @tab X"
.Vb 1
\&    @tab قالب تصویر WebP، کدگذاری از طریق کتابخانه خارجی libwebp پشتیبانی می‌شود
.Ve
.ie n .IP "\fBXBM   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXBM   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XBM : X @tab X"
.Vb 1
\&    @tab قالب تصویر X BitMap (XBM)
.Ve
.ie n .IP "\fBXFace  :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXFace  :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XFace : X @tab X"
.Vb 1
\&    @tab قالب تصویر X\-Face
.Ve
.ie n .IP "\fBXPM   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXPM   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XPM : @tab X"
.Vb 1
\&    @tab قالب تصویر X PixMap (XPM)
.Ve
.ie n .IP "\fBXWD   :  X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXWD   :  X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XWD : X @tab X"
.Vb 1
\&    @tab قالب تصویر X Window Dump (XWD)
.Ve
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که قابلیت موجود در آن ستون (کدگذاری / رمزگشایی) پشتیبانی می‌شود.
.PP
علامت \&\f(CW\*(C`E\*(C'\fR به این معنی است که پشتیبانی از طریق یک کتابخانه خارجی فراهم می‌شود.
.SS "کدک‌های ویدیو (Video Codecs)"
.IX Subsection "Video Codecs"
.ie n .IP "\fBName  :  Encoding \fR\fB@tab\fR\fB Decoding \fR\fB@tab\fR\fB Comments\fR" 4
.el .IP "\fBName  :  Encoding \fR\f(CB@tab\fR\fB Decoding \fR\f(CB@tab\fR\fB Comments\fR" 4
.IX Item "Name : Encoding @tab Decoding @tab Comments"
.PD 0
.ie n .IP "\fB4X Movie                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fB4X Movie                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "4X Movie : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های رایانه‌ای.
.Ve
.ie n .IP "\fB8088flex TMV            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fB8088flex TMV            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "8088flex TMV : @tab X"
.PD 0
.ie n .IP "\fBA64 multicolor          :   X  \fR\fB@tab\fR" 4
.el .IP "\fBA64 multicolor          :   X  \fR\f(CB@tab\fR" 4
.IX Item "A64 multicolor : X @tab"
.PD
.Vb 1
\&    @tab ویدیوی مناسب برای پخش روی کمودور ۶۴ (حالت چندرنگ) ایجاد می‌کند.
.Ve
.ie n .IP "\fBAmazing Studio PAF Video  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAmazing Studio PAF Video  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Amazing Studio PAF Video : @tab X"
.PD 0
.ie n .IP "\fBAmerican Laser Games MM   :     \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAmerican Laser Games MM   :     \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "American Laser Games MM : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌هایی مانند Mad Dog McCree.
.Ve
.ie n .IP "\fBAmuse Graphics Movie    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAmuse Graphics Movie    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Amuse Graphics Movie : @tab X"
.PD 0
.ie n .IP "\fBAMV Video               :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAMV Video               :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AMV Video : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پخش‌کننده‌های MP3 چینی.
.Ve
.ie n .IP "\fBANSI/ASCII art          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBANSI/ASCII art          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ANSI/ASCII art : @tab X"
.PD 0
.ie n .IP "\fBApple Intermediate Codec  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple Intermediate Codec  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple Intermediate Codec : @tab X"
.ie n .IP "\fBApple MJPEG\-B           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple MJPEG\-B           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple MJPEG-B : @tab X"
.ie n .IP "\fBApple Pixlet            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple Pixlet            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple Pixlet : @tab X"
.ie n .IP "\fBApple ProRes            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple ProRes            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple ProRes : X @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: apch,apcn,apcs,apco,ap4h,ap4x
.Ve
.ie n .IP "\fBApple QuickDraw         :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple QuickDraw         :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple QuickDraw : @tab X"
.Vb 1
\&    @tab شناسه fourcc: qdrw
.Ve
.ie n .IP "\fBAPV                     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAPV                     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "APV : @tab X"
.PD 0
.ie n .IP "\fBArgonaut Video          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBArgonaut Video          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Argonaut Video : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های شرکت Argonaut.
.Ve
.ie n .IP "\fBAsus v1                 :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAsus v1                 :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Asus v1 : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: ASV1
.Ve
.ie n .IP "\fBAsus v2                 :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAsus v2                 :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Asus v2 : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: ASV2
.Ve
.ie n .IP "\fBATI VCR1                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATI VCR1                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATI VCR1 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VCR1
.Ve
.ie n .IP "\fBATI VCR2                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATI VCR2                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATI VCR2 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VCR2
.Ve
.ie n .IP "\fBAuravision Aura         :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAuravision Aura         :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Auravision Aura : @tab X"
.PD 0
.ie n .IP "\fBAuravision Aura 2       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAuravision Aura 2       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Auravision Aura 2 : @tab X"
.ie n .IP "\fBAutodesk Animator Flic video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAutodesk Animator Flic video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Autodesk Animator Flic video : @tab X"
.ie n .IP "\fBAutodesk RLE            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAutodesk RLE            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Autodesk RLE : @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: AASC
.Ve
.ie n .IP "\fBAV1                     :   E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBAV1                     :   E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "AV1 : E @tab E"
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه‌های خارجی libaom، libdav1d، librav1e و libsvtav1
.Ve
.ie n .IP "\fBAvid 1:1 10\-bit RGB Packer   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAvid 1:1 10\-bit RGB Packer   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Avid 1:1 10-bit RGB Packer : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: AVrp
.Ve
.ie n .IP "\fBAVS (Audio Video Standard) video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAVS (Audio Video Standard) video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AVS (Audio Video Standard) video : @tab X"
.Vb 1
\&    @tab کدگذاری ویدیویی مورد استفاده در بازی Creature Shock.
.Ve
.ie n .IP "\fBAVS2\-P2/IEEE1857.4      :   E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBAVS2\-P2/IEEE1857.4      :   E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "AVS2-P2/IEEE1857.4 : E @tab E"
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه‌های خارجی libxavs2 و libdavs2
.Ve
.ie n .IP "\fBAVS3\-P2/IEEE1857.10     :      \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBAVS3\-P2/IEEE1857.10     :      \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "AVS3-P2/IEEE1857.10 : @tab E"
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه خارجی libuavs3d
.Ve
.ie n .IP "\fBAYUV                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAYUV                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AYUV : X @tab X"
.Vb 1
\&    @tab قالب فشرده‌نشده بسته‌بندی‌شده 4:4:4:4 مایکروسافت
.Ve
.ie n .IP "\fBBeam Software VB        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBeam Software VB        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Beam Software VB : @tab X"
.PD 0
.ie n .IP "\fBBethesda VID video      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBethesda VID video      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Bethesda VID video : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های استودیو Bethesda Softworks.
.Ve
.ie n .IP "\fBBink Video              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBink Video              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Bink Video : @tab X"
.PD 0
.ie n .IP "\fBBitJazz SheerVideo      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBitJazz SheerVideo      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "BitJazz SheerVideo : @tab X"
.ie n .IP "\fBBitmap Brothers JV video   :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBitmap Brothers JV video   :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Bitmap Brothers JV video : @tab X"
.ie n .IP "\fBy41p Brooktree uncompressed 4:1:1 12\-bit      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBy41p Brooktree uncompressed 4:1:1 12\-bit      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "y41p Brooktree uncompressed 4:1:1 12-bit : X @tab X"
.ie n .IP "\fBBrooktree ProSumer Video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBrooktree ProSumer Video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Brooktree ProSumer Video : @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: BT20
.Ve
.ie n .IP "\fBBrute Force & Ignorance    :    \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBBrute Force & Ignorance    :    \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Brute Force & Ignorance : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی Flash Traffic: City of Angels.
.Ve
.ie n .IP "\fBC93 video               :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBC93 video               :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "C93 video : @tab X"
.Vb 1
\&    @tab کدک مورد استفاده در بازی Cyberia.
.Ve
.ie n .IP "\fBCamStudio               :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCamStudio               :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CamStudio : @tab X"
.Vb 1
\&    @tab شناسه fourcc: CSCD
.Ve
.ie n .IP "\fBCD+G                    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCD+G                    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CD+G : @tab X"
.Vb 1
\&    @tab کدک ویدیو برای دیسک‌های کارائوکه CD+G
.Ve
.ie n .IP "\fBCDXL                    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCDXL                    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CDXL : @tab X"
.Vb 1
\&    @tab کدک ویدیویی Amiga CD
.Ve
.ie n .IP "\fBChinese AVS video       :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBChinese AVS video       :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Chinese AVS video : E @tab X"
.Vb 1
\&    @tab استاندارد AVS1\-P2، نمایه JiZhun، کدگذاری از طریق کتابخانه خارجی libxavs
.Ve
.ie n .IP "\fBDelphine Software International CIN video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDelphine Software International CIN video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Delphine Software International CIN video : @tab X"
.Vb 1
\&    @tab کدک مورد استفاده در بازی‌های شرکت Delphine Software International.
.Ve
.ie n .IP "\fBDiscworld II BMV Video  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDiscworld II BMV Video  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Discworld II BMV Video : @tab X"
.PD 0
.ie n .IP "\fBCineForm HD             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCineForm HD             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CineForm HD : X @tab X"
.ie n .IP "\fBCanopus HQ              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCanopus HQ              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Canopus HQ : @tab X"
.ie n .IP "\fBCanopus HQA             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCanopus HQA             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Canopus HQA : @tab X"
.ie n .IP "\fBCanopus HQX             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCanopus HQX             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Canopus HQX : @tab X"
.ie n .IP "\fBCanopus Lossless Codec  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCanopus Lossless Codec  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Canopus Lossless Codec : @tab X"
.ie n .IP "\fBCDToons                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCDToons                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CDToons : @tab X"
.PD
.Vb 1
\&    @tab کدک مورد استفاده در بازی‌های مختلف شرکت Broderbund.
.Ve
.ie n .IP "\fBCinepak                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCinepak                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Cinepak : @tab X"
.PD 0
.ie n .IP "\fBCirrus Logic AccuPak    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCirrus Logic AccuPak    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Cirrus Logic AccuPak : X @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: CLJR
.Ve
.ie n .IP "\fBCPiA Video Format       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCPiA Video Format       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "CPiA Video Format : @tab X"
.PD 0
.ie n .IP "\fBCreative YUV (CYUV)     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCreative YUV (CYUV)     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Creative YUV (CYUV) : @tab X"
.ie n .IP "\fBDFA                     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDFA                     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DFA : @tab X"
.PD
.Vb 1
\&    @tab کدک مورد استفاده در بازی Chronomaster.
.Ve
.ie n .IP "\fBDirac                   :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDirac                   :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Dirac : E @tab X"
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کدگذار توکار vc2 (Dirac Pro)
.Ve
.ie n .IP "\fBDeluxe Paint Animation  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDeluxe Paint Animation  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Deluxe Paint Animation : @tab X"
.PD 0
.ie n .IP "\fBDNxHD                   :    X \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDNxHD                   :    X \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DNxHD : X @tab X"
.PD
.Vb 1
\&    @tab همچنین شناخته‌شده با عنوان SMPTE VC3
.Ve
.ie n .IP "\fBDuck TrueMotion 1.0    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDuck TrueMotion 1.0    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Duck TrueMotion 1.0 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: DUCK
.Ve
.ie n .IP "\fBDuck TrueMotion 2.0     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDuck TrueMotion 2.0     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Duck TrueMotion 2.0 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: TM20
.Ve
.ie n .IP "\fBDuck TrueMotion 2.0 RT  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDuck TrueMotion 2.0 RT  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Duck TrueMotion 2.0 RT : @tab X"
.Vb 1
\&    @tab شناسه fourcc: TR20
.Ve
.ie n .IP "\fBDV (Digital Video)      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDV (Digital Video)      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DV (Digital Video) : X @tab X"
.PD 0
.ie n .IP "\fBDxtory capture format   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDxtory capture format   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Dxtory capture format : @tab X"
.ie n .IP "\fBFeeble Files/ScummVM DXA   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFeeble Files/ScummVM DXA   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Feeble Files/ScummVM DXA : @tab X"
.PD
.Vb 1
\&    @tab کدک مورد استفاده اولیه در بازی Feeble Files.
.Ve
.ie n .IP "\fBElectronic Arts CMV video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBElectronic Arts CMV video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Electronic Arts CMV video : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی NHL 95.
.Ve
.ie n .IP "\fBElectronic Arts Madcow video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBElectronic Arts Madcow video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Electronic Arts Madcow video : @tab X"
.PD 0
.ie n .IP "\fBElectronic Arts TGV video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBElectronic Arts TGV video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Electronic Arts TGV video : @tab X"
.ie n .IP "\fBElectronic Arts TGQ video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBElectronic Arts TGQ video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Electronic Arts TGQ video : @tab X"
.ie n .IP "\fBElectronic Arts TQI video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBElectronic Arts TQI video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Electronic Arts TQI video : @tab X"
.ie n .IP "\fBEscape 124              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBEscape 124              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Escape 124 : @tab X"
.ie n .IP "\fBEscape 130              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBEscape 130              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Escape 130 : @tab X"
.ie n .IP "\fBEVC / MPEG\-5 Part 1     :   E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBEVC / MPEG\-5 Part 1     :   E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "EVC / MPEG-5 Part 1 : E @tab E"
.PD
.Vb 1
\&    @tab کدگذاری و رمزگشایی از طریق کتابخانه‌های خارجی libxeve و libxevd پشتیبانی می‌شود
.Ve
.ie n .IP "\fBFFmpeg video codec #1   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFFmpeg video codec #1   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "FFmpeg video codec #1 : X @tab X"
.Vb 1
\&    @tab کدک بدون افت (شناسه fourcc: FFV1)
.Ve
.ie n .IP "\fBFlash Screen Video v1   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFlash Screen Video v1   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Flash Screen Video v1 : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: FSV1
.Ve
.ie n .IP "\fBFlash Screen Video v2   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFlash Screen Video v2   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Flash Screen Video v2 : X @tab X"
.PD 0
.ie n .IP "\fBFlash Video (FLV)       :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFlash Video (FLV)       :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Flash Video (FLV) : X @tab X"
.PD
.Vb 1
\&    @tab کدک Sorenson H.263 مورد استفاده در Flash
.Ve
.ie n .IP "\fBFM Screen Capture Codec   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFM Screen Capture Codec   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "FM Screen Capture Codec : @tab X"
.PD 0
.ie n .IP "\fBForward Uncompressed    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBForward Uncompressed    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Forward Uncompressed : @tab X"
.ie n .IP "\fBFraps                   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFraps                   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Fraps : @tab X"
.ie n .IP "\fBGo2Meeting              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBGo2Meeting              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Go2Meeting : @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: G2M2, G2M3
.Ve
.ie n .IP "\fBGo2Webinar              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBGo2Webinar              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Go2Webinar : @tab X"
.Vb 1
\&    @tab شناسه fourcc: G2M4
.Ve
.ie n .IP "\fBGremlin Digital Video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBGremlin Digital Video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Gremlin Digital Video : @tab X"
.PD 0
.ie n .IP "\fBH.261                   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBH.261                   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "H.261 : X @tab X"
.ie n .IP "\fBH.263 / H.263\-1996      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBH.263 / H.263\-1996      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "H.263 / H.263-1996 : X @tab X"
.ie n .IP "\fBH.263+ / H.263\-1998 / H.263 version 2   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBH.263+ / H.263\-1998 / H.263 version 2   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "H.263+ / H.263-1998 / H.263 version 2 : X @tab X"
.ie n .IP "\fBH.264 / AVC / MPEG\-4 AVC / MPEG\-4 part 10   :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBH.264 / AVC / MPEG\-4 AVC / MPEG\-4 part 10   :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 : E @tab X"
.PD
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه‌های خارجی libx264 و OpenH264 پشتیبانی می‌شود
.Ve
.ie n .IP "\fBHEVC                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBHEVC                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "HEVC : X @tab X"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه‌های خارجی libx265 و libkvazaar پشتیبانی می‌شود
.Ve
.ie n .IP "\fBHNM version 4           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBHNM version 4           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "HNM version 4 : @tab X"
.PD 0
.ie n .IP "\fBHuffYUV                 :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBHuffYUV                 :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "HuffYUV : X @tab X"
.ie n .IP "\fBHuffYUV FFmpeg variant  :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBHuffYUV FFmpeg variant  :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "HuffYUV FFmpeg variant : X @tab X"
.ie n .IP "\fBIBM Ultimotion          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIBM Ultimotion          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "IBM Ultimotion : @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: ULTI
.Ve
.ie n .IP "\fBid Cinematic video      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBid Cinematic video      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "id Cinematic video : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی Quake II.
.Ve
.ie n .IP "\fBid RoQ video            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBid RoQ video            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "id RoQ video : X @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی‌های Quake III، Jedi Knight 2 و سایر بازی‌های رایانه‌ای.
.Ve
.ie n .IP "\fBIFF ILBM                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIFF ILBM                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "IFF ILBM : @tab X"
.Vb 1
\&    @tab بیت‌مپ درهم‌تنیده IFF
.Ve
.ie n .IP "\fBIFF ByteRun1            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIFF ByteRun1            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "IFF ByteRun1 : @tab X"
.Vb 1
\&    @tab بیت‌مپ کدگذاری‌شده با طول اجرا (RLE) در IFF
.Ve
.ie n .IP "\fBInfinity IMM4           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBInfinity IMM4           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Infinity IMM4 : @tab X"
.PD 0
.ie n .IP "\fBIntel H.263             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIntel H.263             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Intel H.263 : @tab X"
.ie n .IP "\fBIntel Indeo 2           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIntel Indeo 2           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Intel Indeo 2 : @tab X"
.ie n .IP "\fBIntel Indeo 3           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIntel Indeo 3           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Intel Indeo 3 : @tab X"
.ie n .IP "\fBIntel Indeo 4           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIntel Indeo 4           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Intel Indeo 4 : @tab X"
.ie n .IP "\fBIntel Indeo 5           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIntel Indeo 5           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Intel Indeo 5 : @tab X"
.ie n .IP "\fBInterplay C93           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBInterplay C93           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Interplay C93 : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی Cyberia از شرکت Interplay.
.Ve
.ie n .IP "\fBInterplay MVE video     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBInterplay MVE video     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Interplay MVE video : @tab X"
.Vb 1
\&    @tab مورد استفاده در پرونده‌های .MVE شرکت Interplay.
.Ve
.ie n .IP "\fBJ2K  :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBJ2K  :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "J2K : X @tab X"
.PD 0
.ie n .IP "\fBKarl Morton\*(Aqs video codec   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBKarl Morton\*(Aqs video codec   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Karl Morton's video codec : @tab X"
.PD
.Vb 1
\&    @tab کدک مورد استفاده در مجموعه بازی‌های Worms.
.Ve
.ie n .IP "\fBKega Game Video (KGV1)  :       \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBKega Game Video (KGV1)  :       \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Kega Game Video (KGV1) : @tab X"
.Vb 1
\&    @tab کدک ضبط تصویر صفحه برای شبیه‌ساز Kega.
.Ve
.ie n .IP "\fBLagarith                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBLagarith                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Lagarith : @tab X"
.PD 0
.ie n .IP "\fBLCEVC / MPEG\-5 LCEVC / MPEG\-5 Part 2  :      \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBLCEVC / MPEG\-5 LCEVC / MPEG\-5 Part 2  :      \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "LCEVC / MPEG-5 LCEVC / MPEG-5 Part 2 : @tab E"
.PD
.Vb 1
\&    @tab رمزگشایی از طریق کتابخانه خارجی liblcevc\-dec پشتیبانی می‌شود
.Ve
.ie n .IP "\fBLCL (LossLess Codec Library) MSZH   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBLCL (LossLess Codec Library) MSZH   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "LCL (LossLess Codec Library) MSZH : @tab X"
.PD 0
.ie n .IP "\fBLCL (LossLess Codec Library) ZLIB   :   E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBLCL (LossLess Codec Library) ZLIB   :   E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "LCL (LossLess Codec Library) ZLIB : E @tab E"
.ie n .IP "\fBLEAD MCMP               :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBLEAD MCMP               :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "LEAD MCMP : @tab X"
.ie n .IP "\fBLOCO                    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBLOCO                    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "LOCO : @tab X"
.ie n .IP "\fBLucasArts SANM/Smush    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBLucasArts SANM/Smush    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "LucasArts SANM/Smush : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های LucasArts و انیمیشن‌های SMUSH.
.Ve
.ie n .IP "\fBlossless MJPEG          :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBlossless MJPEG          :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "lossless MJPEG : X @tab X"
.PD 0
.ie n .IP "\fBMagicYUV Video          :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMagicYUV Video          :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MagicYUV Video : X @tab X"
.ie n .IP "\fBMandsoft Screen Capture Codec   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMandsoft Screen Capture Codec   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Mandsoft Screen Capture Codec : @tab X"
.ie n .IP "\fBMicrosoft ATC Screen    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft ATC Screen    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft ATC Screen : @tab X"
.PD
.Vb 1
\&    @tab همچنین با عنوان Microsoft Screen 3 شناخته می‌شود.
.Ve
.ie n .IP "\fBMicrosoft Expression Encoder Screen   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft Expression Encoder Screen   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft Expression Encoder Screen : @tab X"
.Vb 1
\&    @tab همچنین با عنوان Microsoft Titanium Screen 2 شناخته می‌شود.
.Ve
.ie n .IP "\fBMicrosoft RLE           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft RLE           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft RLE : X @tab X"
.PD 0
.ie n .IP "\fBMicrosoft Screen 1      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft Screen 1      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft Screen 1 : @tab X"
.PD
.Vb 1
\&    @tab همچنین با عنوان Windows Media Video V7 Screen شناخته می‌شود.
.Ve
.ie n .IP "\fBMicrosoft Screen 2      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft Screen 2      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft Screen 2 : @tab X"
.Vb 1
\&    @tab همچنین با عنوان Windows Media Video V9 Screen شناخته می‌شود.
.Ve
.ie n .IP "\fBMicrosoft Video 1       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMicrosoft Video 1       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Microsoft Video 1 : @tab X"
.PD 0
.ie n .IP "\fBMimic                   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMimic                   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Mimic : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در استریم‌های وب‌کم MSN Messenger.
.Ve
.ie n .IP "\fBMiro VideoXL            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMiro VideoXL            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Miro VideoXL : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VIXL
.Ve
.ie n .IP "\fBMJPEG (Motion JPEG)     :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMJPEG (Motion JPEG)     :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MJPEG (Motion JPEG) : X @tab X"
.PD 0
.ie n .IP "\fBMobotix MxPEG video     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMobotix MxPEG video     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Mobotix MxPEG video : @tab X"
.ie n .IP "\fBMotion Pixels video     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMotion Pixels video     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Motion Pixels video : @tab X"
.ie n .IP "\fBMPEG\-1 video            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-1 video            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-1 video : X @tab X"
.ie n .IP "\fBMPEG\-2 video            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-2 video            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-2 video : X @tab X"
.ie n .IP "\fBMPEG\-4 part 2           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-4 part 2           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-4 part 2 : X @tab X"
.PD
.Vb 1
\&    @tab برای کدگذاری می‌توان به عنوان جایگزین از libxvidcore استفاده کرد.
.Ve
.ie n .IP "\fBMPEG\-4 part 2 Microsoft variant version 1   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-4 part 2 Microsoft variant version 1   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-4 part 2 Microsoft variant version 1 : @tab X"
.PD 0
.ie n .IP "\fBMPEG\-4 part 2 Microsoft variant version 2   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-4 part 2 Microsoft variant version 2   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-4 part 2 Microsoft variant version 2 : X @tab X"
.ie n .IP "\fBMPEG\-4 part 2 Microsoft variant version 3   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-4 part 2 Microsoft variant version 3   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-4 part 2 Microsoft variant version 3 : X @tab X"
.ie n .IP "\fBNewtek SpeedHQ                :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBNewtek SpeedHQ                :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Newtek SpeedHQ : X @tab X"
.ie n .IP "\fBNintendo Gamecube THP video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBNintendo Gamecube THP video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Nintendo Gamecube THP video : @tab X"
.ie n .IP "\fBNotchLC                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBNotchLC                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "NotchLC : @tab X"
.ie n .IP "\fBNuppelVideo/RTjpeg      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBNuppelVideo/RTjpeg      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "NuppelVideo/RTjpeg : @tab X"
.PD
.Vb 1
\&    @tab کدگذاری ویدیویی مورد استفاده در پرونده‌های NuppelVideo.
.Ve
.ie n .IP "\fBOn2 VP3                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 VP3                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 VP3 : @tab X"
.Vb 1
\&    @tab هنوز آزمایشی است
.Ve
.ie n .IP "\fBOn2 VP4                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 VP4                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 VP4 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VP40
.Ve
.ie n .IP "\fBOn2 VP5                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 VP5                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 VP5 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VP50
.Ve
.ie n .IP "\fBOn2 VP6                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 VP6                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 VP6 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VP60,VP61,VP62
.Ve
.ie n .IP "\fBOn2 VP7                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 VP7                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 VP7 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: VP70,VP71
.Ve
.ie n .IP "\fBVP8                     :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVP8                     :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "VP8 : E @tab X"
.Vb 1
\&    @tab شناسه fourcc: VP80، کدگذاری از طریق کتابخانه خارجی libvpx پشتیبانی می‌شود
.Ve
.ie n .IP "\fBVP9                     :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVP9                     :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "VP9 : E @tab X"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libvpx پشتیبانی می‌شود
.Ve
.ie n .IP "\fBPinnacle TARGA CineWave YUV16  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPinnacle TARGA CineWave YUV16  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Pinnacle TARGA CineWave YUV16 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: Y216
.Ve
.ie n .IP "\fBQ\-team QPEG             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQ\-team QPEG             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Q-team QPEG : @tab X"
.Vb 1
\&    @tab شناسه‌های fourcc: QPEG, Q1.0, Q1.1
.Ve
.ie n .IP "\fBQuickTime 8BPS video    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQuickTime 8BPS video    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QuickTime 8BPS video : @tab X"
.PD 0
.ie n .IP "\fBQuickTime Animation (RLE) video   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQuickTime Animation (RLE) video   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QuickTime Animation (RLE) video : X @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: \*(Aqrle \*(Aq
.Ve
.ie n .IP "\fBQuickTime Graphics (SMC)   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQuickTime Graphics (SMC)   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QuickTime Graphics (SMC) : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: \*(Aqsmc \*(Aq
.Ve
.ie n .IP "\fBQuickTime video (RPZA)  :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQuickTime video (RPZA)  :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QuickTime video (RPZA) : X @tab X"
.Vb 1
\&    @tab شناسه fourcc: rpza
.Ve
.ie n .IP "\fBR10K AJA Kona 10\-bit RGB Codec      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBR10K AJA Kona 10\-bit RGB Codec      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "R10K AJA Kona 10-bit RGB Codec : X @tab X"
.PD 0
.ie n .IP "\fBR210 Quicktime Uncompressed RGB 10\-bit      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBR210 Quicktime Uncompressed RGB 10\-bit      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "R210 Quicktime Uncompressed RGB 10-bit : X @tab X"
.ie n .IP "\fBRaw Video               :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRaw Video               :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Raw Video : X @tab X"
.ie n .IP "\fBRealVideo 1.0           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealVideo 1.0           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealVideo 1.0 : X @tab X"
.ie n .IP "\fBRealVideo 2.0           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealVideo 2.0           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealVideo 2.0 : X @tab X"
.ie n .IP "\fBRealVideo 3.0           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealVideo 3.0           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealVideo 3.0 : @tab X"
.PD
.Vb 1
\&    @tab هنوز تا وضعیت مطلوب فاصله زیادی دارد
.Ve
.ie n .IP "\fBRealVideo 4.0           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealVideo 4.0           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealVideo 4.0 : @tab X"
.PD 0
.ie n .IP "\fBRealVideo 6.0           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealVideo 6.0           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealVideo 6.0 : @tab X"
.ie n .IP "\fBRenderware TXD (TeXture Dictionary)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRenderware TXD (TeXture Dictionary)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Renderware TXD (TeXture Dictionary) : @tab X"
.PD
.Vb 1
\&    @tab فرهنگ‌های بافت مورد استفاده در موتور Renderware.
.Ve
.ie n .IP "\fBRivaTuner Video         :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRivaTuner Video         :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RivaTuner Video : @tab X"
.Vb 1
\&    @tab شناسه fourcc: \*(AqRTV1\*(Aq
.Ve
.ie n .IP "\fBRL2 video               :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRL2 video               :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RL2 video : @tab X"
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های شرکت Entertainment Software Partners
.Ve
.ie n .IP "\fBScreenPressor           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBScreenPressor           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ScreenPressor : @tab X"
.PD 0
.ie n .IP "\fBScreenpresso            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBScreenpresso            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Screenpresso : @tab X"
.ie n .IP "\fBScreen Recorder Gold Codec   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBScreen Recorder Gold Codec   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Screen Recorder Gold Codec : @tab X"
.ie n .IP "\fBSierra VMD video        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSierra VMD video        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sierra VMD video : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پرونده‌های VMD شرکت Sierra.
.Ve
.ie n .IP "\fBSilicon Graphics Motion Video Compressor 1 (MVC1)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSilicon Graphics Motion Video Compressor 1 (MVC1)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Silicon Graphics Motion Video Compressor 1 (MVC1) : @tab X"
.PD 0
.ie n .IP "\fBSilicon Graphics Motion Video Compressor 2 (MVC2)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSilicon Graphics Motion Video Compressor 2 (MVC2)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Silicon Graphics Motion Video Compressor 2 (MVC2) : @tab X"
.ie n .IP "\fBSilicon Graphics RLE 8\-bit video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSilicon Graphics RLE 8\-bit video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Silicon Graphics RLE 8-bit video : @tab X"
.ie n .IP "\fBSmacker video           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSmacker video           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Smacker video : @tab X"
.PD
.Vb 1
\&    @tab کدگذاری ویدیویی مورد استفاده در Smacker.
.Ve
.ie n .IP "\fBSMPTE VC\-1              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSMPTE VC\-1              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "SMPTE VC-1 : @tab X"
.PD 0
.ie n .IP "\fBSnow                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSnow                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Snow : X @tab X"
.PD
.Vb 1
\&    @tab کدک موجک آزمایشی (شناسه fourcc: SNOW)
.Ve
.ie n .IP "\fBSony PlayStation MDEC (Motion DECoder)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSony PlayStation MDEC (Motion DECoder)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sony PlayStation MDEC (Motion DECoder) : @tab X"
.PD 0
.ie n .IP "\fBSorenson Vector Quantizer 1   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSorenson Vector Quantizer 1   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sorenson Vector Quantizer 1 : X @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: SVQ1
.Ve
.ie n .IP "\fBSorenson Vector Quantizer 3   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSorenson Vector Quantizer 3   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sorenson Vector Quantizer 3 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: SVQ3
.Ve
.ie n .IP "\fBSunplus JPEG (SP5X)     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSunplus JPEG (SP5X)     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sunplus JPEG (SP5X) : @tab X"
.Vb 1
\&    @tab شناسه fourcc: SP5X
.Ve
.ie n .IP "\fBTechSmith Screen Capture Codec   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTechSmith Screen Capture Codec   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "TechSmith Screen Capture Codec : @tab X"
.Vb 1
\&    @tab شناسه fourcc: TSCC
.Ve
.ie n .IP "\fBTechSmith Screen Capture Codec 2   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTechSmith Screen Capture Codec 2   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "TechSmith Screen Capture Codec 2 : @tab X"
.Vb 1
\&    @tab شناسه fourcc: TSC2
.Ve
.ie n .IP "\fBTheora                  :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTheora                  :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Theora : E @tab X"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libtheora پشتیبانی می‌شود
.Ve
.ie n .IP "\fBTiertex Limited SEQ video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTiertex Limited SEQ video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Tiertex Limited SEQ video : @tab X"
.Vb 1
\&    @tab کدک مورد استفاده در نسخه DOS CD\-ROM بازی FlashBack.
.Ve
.ie n .IP "\fBUt Video                :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBUt Video                :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Ut Video : X @tab X"
.PD 0
.ie n .IP "\fBv210 QuickTime uncompressed 4:2:2 10\-bit      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBv210 QuickTime uncompressed 4:2:2 10\-bit      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "v210 QuickTime uncompressed 4:2:2 10-bit : X @tab X"
.ie n .IP "\fBv308 QuickTime uncompressed 4:4:4             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBv308 QuickTime uncompressed 4:4:4             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "v308 QuickTime uncompressed 4:4:4 : X @tab X"
.ie n .IP "\fBv408 QuickTime uncompressed 4:4:4:4           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBv408 QuickTime uncompressed 4:4:4:4           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "v408 QuickTime uncompressed 4:4:4:4 : X @tab X"
.ie n .IP "\fBv410 QuickTime uncompressed 4:4:4 10\-bit      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBv410 QuickTime uncompressed 4:4:4 10\-bit      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "v410 QuickTime uncompressed 4:4:4 10-bit : X @tab X"
.ie n .IP "\fBVBLE Lossless Codec     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVBLE Lossless Codec     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "VBLE Lossless Codec : @tab X"
.ie n .IP "\fBvMix Video              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBvMix Video              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "vMix Video : @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc: \*(AqVMX1\*(Aq
.Ve
.ie n .IP "\fBVMware Screen Codec / VMware Video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVMware Screen Codec / VMware Video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "VMware Screen Codec / VMware Video : @tab X"
.Vb 1
\&    @tab کدک مورد استفاده در ویدیوهای ضبط‌شده توسط VMware.
.Ve
.ie n .IP "\fBWestwood Studios VQA (Vector Quantized Animation) video   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWestwood Studios VQA (Vector Quantized Animation) video   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Westwood Studios VQA (Vector Quantized Animation) video : @tab X"
.PD 0
.ie n .IP "\fBWindows Media Image     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Image     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Image : @tab X"
.ie n .IP "\fBWindows Media Video 7   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Video 7   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Video 7 : X @tab X"
.ie n .IP "\fBWindows Media Video 8   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Video 8   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Video 8 : X @tab X"
.ie n .IP "\fBWindows Media Video 9   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Video 9   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Video 9 : @tab X"
.PD
.Vb 1
\&    @tab عملکرد آن هنوز کامل نیست
.Ve
.ie n .IP "\fBWing Commander III / Xan   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWing Commander III / Xan   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Wing Commander III / Xan : @tab X"
.Vb 1
\&    @tab مورد استفاده در پرونده‌های .MVE بازی Wing Commander III.
.Ve
.ie n .IP "\fBWing Commander IV / Xan   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWing Commander IV / Xan   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Wing Commander IV / Xan : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی Wing Commander IV.
.Ve
.ie n .IP "\fBWinnov WNV1             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWinnov WNV1             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Winnov WNV1 : @tab X"
.PD 0
.ie n .IP "\fBWMV7                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWMV7                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "WMV7 : X @tab X"
.ie n .IP "\fBYAMAHA SMAF             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBYAMAHA SMAF             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "YAMAHA SMAF : X @tab X"
.ie n .IP "\fBPsygnosis YOP Video     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPsygnosis YOP Video     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Psygnosis YOP Video : @tab X"
.ie n .IP "\fByuv4                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fByuv4                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "yuv4 : X @tab X"
.PD
.Vb 1
\&    @tab قالب غیرفشرده بسته‌بندی‌شده 4:2:0 در libquicktime
.Ve
.ie n .IP "\fBZeroCodec Lossless Video  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBZeroCodec Lossless Video  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ZeroCodec Lossless Video : @tab X"
.PD 0
.ie n .IP "\fBZLIB                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBZLIB                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ZLIB : X @tab X"
.PD
.Vb 1
\&    @tab بخشی از LCL، کدگذار آزمایشی است
.Ve
.ie n .IP "\fBZip Motion Blocks Video   :    X \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBZip Motion Blocks Video   :    X \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Zip Motion Blocks Video : X @tab X"
.Vb 1
\&    @tab کدگذار فقط در حالت PAL8 کار می‌کند.
.Ve
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که قابلیت موجود در آن ستون (کدگذاری / رمزگشایی) پشتیبانی می‌شود.
.PP
علامت \&\f(CW\*(C`E\*(C'\fR به این معنی است که پشتیبانی از طریق یک کتابخانه خارجی فراهم می‌شود.
.SS "کدک‌های صوتی (Audio Codecs)"
.IX Subsection "Audio Codecs"
.ie n .IP "\fBName  :  Encoding \fR\fB@tab\fR\fB Decoding \fR\fB@tab\fR\fB Comments\fR" 4
.el .IP "\fBName  :  Encoding \fR\f(CB@tab\fR\fB Decoding \fR\f(CB@tab\fR\fB Comments\fR" 4
.IX Item "Name : Encoding @tab Decoding @tab Comments"
.PD 0
.ie n .IP "\fB8SVX exponential        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fB8SVX exponential        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "8SVX exponential : @tab X"
.ie n .IP "\fB8SVX fibonacci          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fB8SVX fibonacci          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "8SVX fibonacci : @tab X"
.ie n .IP "\fBAAC                     :  EX  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAAC                     :  EX  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AAC : EX @tab X"
.PD
.Vb 1
\&    @tab کدگذاری از طریق کدگذار داخلی و کتابخانه خارجی libfdk\-aac پشتیبانی می‌شود
.Ve
.ie n .IP "\fBAAC+                    :   E  \fR\fB@tab\fR\fB  IX\fR" 4
.el .IP "\fBAAC+                    :   E  \fR\f(CB@tab\fR\fB  IX\fR" 4
.IX Item "AAC+ : E @tab IX"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libfdk\-aac پشتیبانی می‌شود
.Ve
.ie n .IP "\fBAC\-3                    :  IX  \fR\fB@tab\fR\fB  IX\fR" 4
.el .IP "\fBAC\-3                    :  IX  \fR\f(CB@tab\fR\fB  IX\fR" 4
.IX Item "AC-3 : IX @tab IX"
.PD 0
.ie n .IP "\fBACELP.KELVIN            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBACELP.KELVIN            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ACELP.KELVIN : @tab X"
.ie n .IP "\fBADPCM 4X Movie          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM 4X Movie          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM 4X Movie : @tab X"
.ie n .IP "\fBADPCM Yamaha AICA       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Yamaha AICA       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Yamaha AICA : @tab X"
.ie n .IP "\fBADPCM AmuseGraphics Movie  :     \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM AmuseGraphics Movie  :     \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM AmuseGraphics Movie : @tab X"
.ie n .IP "\fBADPCM Argonaut Games    :  X   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Argonaut Games    :  X   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Argonaut Games : X @tab X"
.ie n .IP "\fBADPCM CDROM XA          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM CDROM XA          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM CDROM XA : @tab X"
.ie n .IP "\fBADPCM Creative Technology  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Creative Technology  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Creative Technology : @tab X"
.PD
.Vb 1
\&    @tab 16 \-E<gt> 4, 8 \-E<gt> 4, 8 \-E<gt> 3, 8 \-E<gt> 2
.Ve
.ie n .IP "\fBADPCM Electronic Arts   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts : @tab X"
.Vb 1
\&    @tab مورد استفاده در عناوین مختلف شرکت EA.
.Ve
.ie n .IP "\fBADPCM Electronic Arts Maxis CDROM XS   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts Maxis CDROM XS   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts Maxis CDROM XS : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی Sim City 3000.
.Ve
.ie n .IP "\fBADPCM Electronic Arts R1   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts R1   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts R1 : @tab X"
.PD 0
.ie n .IP "\fBADPCM Electronic Arts R2   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts R2   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts R2 : @tab X"
.ie n .IP "\fBADPCM Electronic Arts R3   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts R3   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts R3 : @tab X"
.ie n .IP "\fBADPCM Electronic Arts XAS  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Electronic Arts XAS  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Electronic Arts XAS : @tab X"
.ie n .IP "\fBADPCM G.722             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM G.722             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM G.722 : X @tab X"
.ie n .IP "\fBADPCM G.726             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM G.726             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM G.726 : X @tab X"
.ie n .IP "\fBADPCM IMA Acorn Replay  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Acorn Replay  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Acorn Replay : @tab X"
.ie n .IP "\fBADPCM IMA AMV           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA AMV           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA AMV : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پرونده‌های AMV
.Ve
.ie n .IP "\fBADPCM IMA Cunning Developments   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Cunning Developments   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Cunning Developments : @tab X"
.PD 0
.ie n .IP "\fBADPCM IMA Electronic Arts EACS   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Electronic Arts EACS   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Electronic Arts EACS : @tab X"
.ie n .IP "\fBADPCM IMA Electronic Arts SEAD   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Electronic Arts SEAD   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Electronic Arts SEAD : @tab X"
.ie n .IP "\fBADPCM IMA Funcom        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Funcom        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Funcom : @tab X"
.ie n .IP "\fBADPCM IMA High Voltage Software ALP       :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA High Voltage Software ALP       :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA High Voltage Software ALP : X @tab X"
.ie n .IP "\fBADPCM IMA Mobiclip MOFLEX   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Mobiclip MOFLEX   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Mobiclip MOFLEX : @tab X"
.ie n .IP "\fBADPCM IMA QuickTime     :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA QuickTime     :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA QuickTime : X @tab X"
.ie n .IP "\fBADPCM IMA Simon & Schuster Interactive    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Simon & Schuster Interactive    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Simon & Schuster Interactive : X @tab X"
.ie n .IP "\fBADPCM IMA Ubisoft APM   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Ubisoft APM   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Ubisoft APM : X @tab X"
.ie n .IP "\fBADPCM IMA Loki SDL MJPEG   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Loki SDL MJPEG   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Loki SDL MJPEG : @tab X"
.ie n .IP "\fBADPCM IMA WAV           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA WAV           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA WAV : X @tab X"
.ie n .IP "\fBADPCM IMA Westwood      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Westwood      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Westwood : @tab X"
.ie n .IP "\fBADPCM ISS IMA           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM ISS IMA           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM ISS IMA : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های شرکت FunCom.
.Ve
.ie n .IP "\fBADPCM IMA Dialogic      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Dialogic      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Dialogic : @tab X"
.PD 0
.ie n .IP "\fBADPCM IMA Duck DK3      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Duck DK3      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Duck DK3 : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های کنسول Sega Saturn.
.Ve
.ie n .IP "\fBADPCM IMA Duck DK4      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Duck DK4      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Duck DK4 : @tab X"
.Vb 1
\&    @tab مورد استفاده در برخی بازی‌های کنسول Sega Saturn.
.Ve
.ie n .IP "\fBADPCM IMA Radical       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Radical       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Radical : @tab X"
.PD 0
.ie n .IP "\fBADPCM IMA Xbox          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM IMA Xbox          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM IMA Xbox : @tab X"
.ie n .IP "\fBADPCM Microsoft         :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Microsoft         :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Microsoft : X @tab X"
.ie n .IP "\fBADPCM MS IMA            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM MS IMA            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM MS IMA : X @tab X"
.ie n .IP "\fBADPCM Nintendo Gamecube AFC   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Nintendo Gamecube AFC   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Nintendo Gamecube AFC : @tab X"
.ie n .IP "\fBADPCM Nintendo Gamecube DTK   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Nintendo Gamecube DTK   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Nintendo Gamecube DTK : @tab X"
.ie n .IP "\fBADPCM Nintendo THP   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Nintendo THP   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Nintendo THP : @tab X"
.ie n .IP "\fBADPCM Playstation       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Playstation       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Playstation : @tab X"
.ie n .IP "\fBADPCM QT IMA            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM QT IMA            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM QT IMA : X @tab X"
.ie n .IP "\fBADPCM Sanyo             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Sanyo             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Sanyo : @tab X"
.ie n .IP "\fBADPCM SEGA CRI ADX      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM SEGA CRI ADX      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM SEGA CRI ADX : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های کنسول Sega Dreamcast.
.Ve
.ie n .IP "\fBADPCM Shockwave Flash   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Shockwave Flash   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Shockwave Flash : X @tab X"
.PD 0
.ie n .IP "\fBADPCM Sound Blaster Pro 2\-bit   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Sound Blaster Pro 2\-bit   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Sound Blaster Pro 2-bit : @tab X"
.ie n .IP "\fBADPCM Sound Blaster Pro 2.6\-bit   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Sound Blaster Pro 2.6\-bit   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Sound Blaster Pro 2.6-bit : @tab X"
.ie n .IP "\fBADPCM Sound Blaster Pro 4\-bit   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Sound Blaster Pro 4\-bit   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Sound Blaster Pro 4-bit : @tab X"
.ie n .IP "\fBADPCM VIMA              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM VIMA              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM VIMA : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در انیمیشن‌های SMUSH شرکت LucasArts.
.Ve
.ie n .IP "\fBADPCM Konami XMD        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Konami XMD        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Konami XMD : @tab X"
.PD 0
.ie n .IP "\fBADPCM Westwood Studios IMA       :   X \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Westwood Studios IMA       :   X \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Westwood Studios IMA : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های شرکت Westwood Studios مانند Command and Conquer.
.Ve
.ie n .IP "\fBADPCM Yamaha            :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Yamaha            :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Yamaha : X @tab X"
.PD 0
.ie n .IP "\fBADPCM Zork              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBADPCM Zork              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ADPCM Zork : @tab X"
.ie n .IP "\fBAMR\-NB                  :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAMR\-NB                  :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AMR-NB : E @tab X"
.PD
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libopencore\-amrnb پشتیبانی می‌شود
.Ve
.ie n .IP "\fBAMR\-WB                  :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAMR\-WB                  :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "AMR-WB : E @tab X"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libvo\-amrwbenc پشتیبانی می‌شود
.Ve
.ie n .IP "\fBAmazing Studio PAF Audio  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBAmazing Studio PAF Audio  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Amazing Studio PAF Audio : @tab X"
.PD 0
.ie n .IP "\fBApple lossless audio    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBApple lossless audio    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Apple lossless audio : X @tab X"
.PD
.Vb 1
\&    @tab شناسه fourcc در کوئیک‌تایم: \*(Aqalac\*(Aq
.Ve
.ie n .IP "\fBaptX                    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBaptX                    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "aptX : X @tab X"
.Vb 1
\&    @tab مورد استفاده در نمایه بلوتوث A2DP
.Ve
.ie n .IP "\fBaptX HD                 :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBaptX HD                 :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "aptX HD : X @tab X"
.Vb 1
\&    @tab مورد استفاده در نمایه بلوتوث A2DP
.Ve
.ie n .IP "\fBATRAC1                  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATRAC1                  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATRAC1 : @tab X"
.PD 0
.ie n .IP "\fBATRAC3                  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATRAC3                  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATRAC3 : @tab X"
.ie n .IP "\fBATRAC3+                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATRAC3+                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATRAC3+ : @tab X"
.ie n .IP "\fBATRAC9                  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBATRAC9                  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ATRAC9 : @tab X"
.ie n .IP "\fBBink Audio              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBink Audio              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Bink Audio : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پرونده‌های Bink و Smacker در بازی‌های بسیار.
.Ve
.ie n .IP "\fBBonk audio              :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBBonk audio              :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Bonk audio : @tab X"
.PD 0
.ie n .IP "\fBcodec2                  :   E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBcodec2                  :   E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "codec2 : E @tab E"
.PD
.Vb 1
\&    @tab کدگذاری/رمزگشایی از طریق کتابخانه خارجی libcodec2 پشتیبانی می‌شود
.Ve
.ie n .IP "\fBCRI HCA                 :      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBCRI HCA                 :      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "CRI HCA : @tab X"
.PD 0
.ie n .IP "\fBDelphine Software International CIN audio   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDelphine Software International CIN audio   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Delphine Software International CIN audio : @tab X"
.PD
.Vb 1
\&    @tab کدک مورد استفاده در بازی‌های شرکت Delphine Software International.
.Ve
.ie n .IP "\fBDFPWM                   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDFPWM                   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DFPWM : X @tab X"
.PD 0
.ie n .IP "\fBDigital Speech Standard \- Standard Play mode (DSS SP)  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDigital Speech Standard \- Standard Play mode (DSS SP)  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Digital Speech Standard - Standard Play mode (DSS SP) : @tab X"
.ie n .IP "\fBDiscworld II BMV Audio  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDiscworld II BMV Audio  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Discworld II BMV Audio : @tab X"
.ie n .IP "\fBCOOK                    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBCOOK                    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "COOK : @tab X"
.PD
.Vb 1
\&    @tab تمام نسخه‌ها به جز 5.1 پشتیبانی می‌شوند.
.Ve
.ie n .IP "\fBDCA (DTS Coherent Acoustics)   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDCA (DTS Coherent Acoustics)   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DCA (DTS Coherent Acoustics) : X @tab X"
.Vb 1
\&    @tab پسوندهای پشتیبانی‌شده: XCh, XXCH, X96, XBR, XLL, LBR (به صورت جزئی)
.Ve
.ie n .IP "\fBDolby E   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDolby E   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Dolby E : @tab X"
.PD 0
.ie n .IP "\fBDPCM Cuberoot\-Delta\-Exact  :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Cuberoot\-Delta\-Exact  :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Cuberoot-Delta-Exact : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در شمار اندکی از بازی‌ها.
.Ve
.ie n .IP "\fBDPCM Gremlin            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Gremlin            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Gremlin : @tab X"
.PD 0
.ie n .IP "\fBDPCM id RoQ             :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM id RoQ             :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM id RoQ : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های Quake III، Jedi Knight 2 و سایر بازی‌های رایانه‌ای.
.Ve
.ie n .IP "\fBDPCM Marble WADY        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Marble WADY        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Marble WADY : @tab X"
.PD 0
.ie n .IP "\fBDPCM Interplay          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Interplay          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Interplay : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در بازی‌های رایانه‌ای مختلف شرکت Interplay.
.Ve
.ie n .IP "\fBDPCM Squareroot\-Delta\-Exact   :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Squareroot\-Delta\-Exact   :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Squareroot-Delta-Exact : @tab X"
.Vb 1
\&    @tab مورد استفاده در بازی‌های گوناگون.
.Ve
.ie n .IP "\fBDPCM Sierra Online      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Sierra Online      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Sierra Online : @tab X"
.Vb 1
\&    @tab مورد استفاده در پرونده‌های صوتی بازی‌های شرکت Sierra Online.
.Ve
.ie n .IP "\fBDPCM Sol                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Sol                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Sol : @tab X"
.PD 0
.ie n .IP "\fBDPCM Xan                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Xan                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Xan : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پرونده‌های AVI بازی Wing Commander IV از استودیو Origin.
.Ve
.ie n .IP "\fBDPCM Xilam DERF         :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDPCM Xilam DERF         :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DPCM Xilam DERF : @tab X"
.PD 0
.ie n .IP "\fBDSD (Direct Stream Digital), least significant bit first   :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDSD (Direct Stream Digital), least significant bit first   :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DSD (Direct Stream Digital), least significant bit first : @tab X"
.ie n .IP "\fBDSD (Direct Stream Digital), most significant bit first    :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDSD (Direct Stream Digital), most significant bit first    :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DSD (Direct Stream Digital), most significant bit first : @tab X"
.ie n .IP "\fBDSD (Direct Stream Digital), least significant bit first, planar   :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDSD (Direct Stream Digital), least significant bit first, planar   :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DSD (Direct Stream Digital), least significant bit first, planar : @tab X"
.ie n .IP "\fBDSD (Direct Stream Digital), most significant bit first, planar    :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDSD (Direct Stream Digital), most significant bit first, planar    :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DSD (Direct Stream Digital), most significant bit first, planar : @tab X"
.ie n .IP "\fBDSP Group TrueSpeech    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDSP Group TrueSpeech    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DSP Group TrueSpeech : @tab X"
.ie n .IP "\fBDST (Direct Stream Transfer)  :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDST (Direct Stream Transfer)  :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DST (Direct Stream Transfer) : @tab X"
.ie n .IP "\fBDV audio                :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBDV audio                :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "DV audio : @tab X"
.ie n .IP "\fBEnhanced AC\-3           :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBEnhanced AC\-3           :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Enhanced AC-3 : X @tab X"
.ie n .IP "\fBEVRC (Enhanced Variable Rate Codec)  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBEVRC (Enhanced Variable Rate Codec)  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "EVRC (Enhanced Variable Rate Codec) : @tab X"
.ie n .IP "\fBFLAC (Free Lossless Audio Codec)   :   X  \fR\fB@tab\fR\fB  IX\fR" 4
.el .IP "\fBFLAC (Free Lossless Audio Codec)   :   X  \fR\f(CB@tab\fR\fB  IX\fR" 4
.IX Item "FLAC (Free Lossless Audio Codec) : X @tab IX"
.ie n .IP "\fBFTR Voice               :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBFTR Voice               :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "FTR Voice : @tab X"
.ie n .IP "\fBG.723.1                 :  X   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBG.723.1                 :  X   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "G.723.1 : X @tab X"
.ie n .IP "\fBG.728                   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBG.728                   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "G.728 : @tab X"
.ie n .IP "\fBG.729                   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBG.729                   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "G.729 : @tab X"
.ie n .IP "\fBGSM                     :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBGSM                     :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "GSM : E @tab X"
.PD
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libgsm پشتیبانی می‌شود
.Ve
.ie n .IP "\fBGSM Microsoft variant   :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBGSM Microsoft variant   :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "GSM Microsoft variant : E @tab X"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libgsm پشتیبانی می‌شود
.Ve
.ie n .IP "\fBIAC (Indeo Audio Coder)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIAC (Indeo Audio Coder)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "IAC (Indeo Audio Coder) : @tab X"
.PD 0
.ie n .IP "\fBiLBC (Internet Low Bitrate Codec)  :   E  \fR\fB@tab\fR\fB  EX\fR" 4
.el .IP "\fBiLBC (Internet Low Bitrate Codec)  :   E  \fR\f(CB@tab\fR\fB  EX\fR" 4
.IX Item "iLBC (Internet Low Bitrate Codec) : E @tab EX"
.PD
.Vb 1
\&    @tab کدگذاری و رمزگشایی از طریق کتابخانه خارجی libilbc پشتیبانی می‌شود
.Ve
.ie n .IP "\fBIMC (Intel Music Coder)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBIMC (Intel Music Coder)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "IMC (Intel Music Coder) : @tab X"
.PD 0
.ie n .IP "\fBInterplay ACM             :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBInterplay ACM             :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Interplay ACM : @tab X"
.ie n .IP "\fBLC3                     :  E  \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBLC3                     :  E  \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "LC3 : E @tab E"
.PD
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه خارجی liblc3
.Ve
.ie n .IP "\fBMACE (Macintosh Audio Compression/Expansion) 6:1   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMACE (Macintosh Audio Compression/Expansion) 6:1   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MACE (Macintosh Audio Compression/Expansion) 6:1 : @tab X"
.PD 0
.ie n .IP "\fBMarian\*(Aqs A\-pac audio      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMarian\*(Aqs A\-pac audio      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Marian's A-pac audio : @tab X"
.ie n .IP "\fBMI\-SC4 (Micronas SC\-4 Audio)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMI\-SC4 (Micronas SC\-4 Audio)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MI-SC4 (Micronas SC-4 Audio) : @tab X"
.ie n .IP "\fBMLP (Meridian Lossless Packing)   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMLP (Meridian Lossless Packing)   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MLP (Meridian Lossless Packing) : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در دیسک‌های DVD\-Audio.
.Ve
.ie n .IP "\fBMonkey\*(Aqs Audio          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMonkey\*(Aqs Audio          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Monkey's Audio : @tab X"
.PD 0
.ie n .IP "\fBMP1 (MPEG audio layer 1)   :      \fR\fB@tab\fR\fB IX\fR" 4
.el .IP "\fBMP1 (MPEG audio layer 1)   :      \fR\f(CB@tab\fR\fB IX\fR" 4
.IX Item "MP1 (MPEG audio layer 1) : @tab IX"
.ie n .IP "\fBMP2 (MPEG audio layer 2)   :  IX  \fR\fB@tab\fR\fB IX\fR" 4
.el .IP "\fBMP2 (MPEG audio layer 2)   :  IX  \fR\f(CB@tab\fR\fB IX\fR" 4
.IX Item "MP2 (MPEG audio layer 2) : IX @tab IX"
.PD
.Vb 1
\&    @tab کدگذاری همچنین از طریق کتابخانه خارجی TwoLAME پشتیبانی می‌شود
.Ve
.ie n .IP "\fBMP3 (MPEG audio layer 3)   :   E  \fR\fB@tab\fR\fB IX\fR" 4
.el .IP "\fBMP3 (MPEG audio layer 3)   :   E  \fR\f(CB@tab\fR\fB IX\fR" 4
.IX Item "MP3 (MPEG audio layer 3) : E @tab IX"
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی LAME پشتیبانی می‌شود، حالت‌های ADU MP3 و MP3onMP4 نیز پشتیبانی می‌شوند
.Ve
.ie n .IP "\fBMPEG\-4 Audio Lossless Coding (ALS)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMPEG\-4 Audio Lossless Coding (ALS)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MPEG-4 Audio Lossless Coding (ALS) : @tab X"
.PD 0
.ie n .IP "\fBMPEG\-H 3D Audio         :      \fR\fB@tab\fR\fB  E\fR" 4
.el .IP "\fBMPEG\-H 3D Audio         :      \fR\f(CB@tab\fR\fB  E\fR" 4
.IX Item "MPEG-H 3D Audio : @tab E"
.PD
.Vb 1
\&    @tab رمزگشایی از طریق کتابخانه خارجی libmpeghdec پشتیبانی می‌شود
.Ve
.ie n .IP "\fBMobiClip FastAudio      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMobiClip FastAudio      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "MobiClip FastAudio : @tab X"
.PD 0
.ie n .IP "\fBMusepack SV7            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMusepack SV7            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Musepack SV7 : @tab X"
.ie n .IP "\fBMusepack SV8            :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBMusepack SV8            :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Musepack SV8 : @tab X"
.ie n .IP "\fBNellymoser Asao         :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBNellymoser Asao         :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Nellymoser Asao : X @tab X"
.ie n .IP "\fBOn2 AVC (Audio for Video Codec)  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOn2 AVC (Audio for Video Codec)  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "On2 AVC (Audio for Video Codec) : @tab X"
.ie n .IP "\fBOpus                    :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOpus                    :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Opus : E @tab X"
.PD
.Vb 1
\&    @tab کدگذاری از طریق کتابخانه خارجی libopus پشتیبانی می‌شود
.Ve
.ie n .IP "\fBOSQ (Original Sound Quality)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBOSQ (Original Sound Quality)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "OSQ (Original Sound Quality) : @tab X"
.PD 0
.ie n .IP "\fBPCM A\-law               :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM A\-law               :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM A-law : X @tab X"
.ie n .IP "\fBPCM mu\-law              :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM mu\-law              :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM mu-law : X @tab X"
.ie n .IP "\fBPCM Archimedes VIDC     :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM Archimedes VIDC     :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM Archimedes VIDC : X @tab X"
.ie n .IP "\fBPCM signed 8\-bit planar   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 8\-bit planar   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 8-bit planar : X @tab X"
.ie n .IP "\fBPCM signed 16\-bit big\-endian planar   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 16\-bit big\-endian planar   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 16-bit big-endian planar : X @tab X"
.ie n .IP "\fBPCM signed 16\-bit little\-endian planar   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 16\-bit little\-endian planar   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 16-bit little-endian planar : X @tab X"
.ie n .IP "\fBPCM signed 24\-bit little\-endian planar   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 24\-bit little\-endian planar   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 24-bit little-endian planar : X @tab X"
.ie n .IP "\fBPCM signed 32\-bit little\-endian planar   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 32\-bit little\-endian planar   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 32-bit little-endian planar : X @tab X"
.ie n .IP "\fBPCM 32\-bit floating point big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM 32\-bit floating point big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM 32-bit floating point big-endian : X @tab X"
.ie n .IP "\fBPCM 32\-bit floating point little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM 32\-bit floating point little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM 32-bit floating point little-endian : X @tab X"
.ie n .IP "\fBPCM 64\-bit floating point big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM 64\-bit floating point big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM 64-bit floating point big-endian : X @tab X"
.ie n .IP "\fBPCM 64\-bit floating point little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM 64\-bit floating point little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM 64-bit floating point little-endian : X @tab X"
.ie n .IP "\fBPCM D\-Cinema audio signed 24\-bit    :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM D\-Cinema audio signed 24\-bit    :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM D-Cinema audio signed 24-bit : X @tab X"
.ie n .IP "\fBPCM signed 8\-bit        :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 8\-bit        :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 8-bit : X @tab X"
.ie n .IP "\fBPCM signed 16\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 16\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 16-bit big-endian : X @tab X"
.ie n .IP "\fBPCM signed 16\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 16\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 16-bit little-endian : X @tab X"
.ie n .IP "\fBPCM signed 24\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 24\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 24-bit big-endian : X @tab X"
.ie n .IP "\fBPCM signed 24\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 24\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 24-bit little-endian : X @tab X"
.ie n .IP "\fBPCM signed 32\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 32\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 32-bit big-endian : X @tab X"
.ie n .IP "\fBPCM signed 32\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 32\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 32-bit little-endian : X @tab X"
.ie n .IP "\fBPCM signed 16/20/24\-bit big\-endian in MPEG\-TS   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM signed 16/20/24\-bit big\-endian in MPEG\-TS   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM signed 16/20/24-bit big-endian in MPEG-TS : @tab X"
.ie n .IP "\fBPCM unsigned 8\-bit      :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 8\-bit      :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 8-bit : X @tab X"
.ie n .IP "\fBPCM unsigned 16\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 16\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 16-bit big-endian : X @tab X"
.ie n .IP "\fBPCM unsigned 16\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 16\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 16-bit little-endian : X @tab X"
.ie n .IP "\fBPCM unsigned 24\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 24\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 24-bit big-endian : X @tab X"
.ie n .IP "\fBPCM unsigned 24\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 24\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 24-bit little-endian : X @tab X"
.ie n .IP "\fBPCM unsigned 32\-bit big\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 32\-bit big\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 32-bit big-endian : X @tab X"
.ie n .IP "\fBPCM unsigned 32\-bit little\-endian   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM unsigned 32\-bit little\-endian   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM unsigned 32-bit little-endian : X @tab X"
.ie n .IP "\fBPCM SGA                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBPCM SGA                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "PCM SGA : @tab X"
.ie n .IP "\fBQCELP / PureVoice       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQCELP / PureVoice       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QCELP / PureVoice : @tab X"
.ie n .IP "\fBQDesign Music Codec 1   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQDesign Music Codec 1   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QDesign Music Codec 1 : @tab X"
.ie n .IP "\fBQDesign Music Codec 2   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBQDesign Music Codec 2   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "QDesign Music Codec 2 : @tab X"
.PD
.Vb 1
\&    @tab هنوز مقداری اعوجاج صوتی وجود دارد.
.Ve
.ie n .IP "\fBRealAudio 1.0 (14.4K)   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealAudio 1.0 (14.4K)   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealAudio 1.0 (14.4K) : X @tab X"
.Vb 1
\&    @tab کدک Real با نرخ ۱۴۴۰۰ بیت بر ثانیه
.Ve
.ie n .IP "\fBRealAudio 2.0 (28.8K)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealAudio 2.0 (28.8K)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealAudio 2.0 (28.8K) : @tab X"
.Vb 1
\&    @tab کدک Real با نرخ ۲۸۸۰۰ بیت بر ثانیه
.Ve
.ie n .IP "\fBRealAudio 3.0 (dnet)    :  IX  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealAudio 3.0 (dnet)    :  IX  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealAudio 3.0 (dnet) : IX @tab X"
.Vb 1
\&    @tab کدک صوتی AC\-3 با نرخ بیت پایین Real
.Ve
.ie n .IP "\fBRealAudio Lossless      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealAudio Lossless      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealAudio Lossless : @tab X"
.PD 0
.ie n .IP "\fBRealAudio SIPR / ACELP.NET  :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRealAudio SIPR / ACELP.NET  :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RealAudio SIPR / ACELP.NET : @tab X"
.ie n .IP "\fBRK Audio (RKA)          :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBRK Audio (RKA)          :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "RK Audio (RKA) : @tab X"
.ie n .IP "\fBSBC (low\-complexity subband codec)  :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSBC (low\-complexity subband codec)  :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "SBC (low-complexity subband codec) : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در نمایه بلوتوث A2DP
.Ve
.ie n .IP "\fBShorten                 :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBShorten                 :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Shorten : @tab X"
.PD 0
.ie n .IP "\fBSierra VMD audio        :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSierra VMD audio        :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sierra VMD audio : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در پرونده‌های VMD شرکت Sierra.
.Ve
.ie n .IP "\fBSmacker audio           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSmacker audio           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Smacker audio : @tab X"
.PD 0
.ie n .IP "\fBSMPTE 302M AES3 audio   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSMPTE 302M AES3 audio   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "SMPTE 302M AES3 audio : X @tab X"
.ie n .IP "\fBSonic                   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSonic                   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sonic : X @tab X"
.PD
.Vb 1
\&    @tab کدک آزمایشی
.Ve
.ie n .IP "\fBSonic lossless          :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBSonic lossless          :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Sonic lossless : X @tab X"
.Vb 1
\&    @tab کدک آزمایشی
.Ve
.ie n .IP "\fBSpeex                   :   E  \fR\fB@tab\fR\fB  EX\fR" 4
.el .IP "\fBSpeex                   :   E  \fR\f(CB@tab\fR\fB  EX\fR" 4
.IX Item "Speex : E @tab EX"
.Vb 1
\&    @tab پشتیبانی‌شده از طریق کتابخانه خارجی libspeex
.Ve
.ie n .IP "\fBTAK (Tom\*(Aqs lossless Audio Kompressor)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTAK (Tom\*(Aqs lossless Audio Kompressor)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "TAK (Tom's lossless Audio Kompressor) : @tab X"
.PD 0
.ie n .IP "\fBTrue Audio (TTA)        :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTrue Audio (TTA)        :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "True Audio (TTA) : X @tab X"
.ie n .IP "\fBTrueHD                  :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTrueHD                  :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "TrueHD : X @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در دیسک‌های HD\-DVD و Blu\-Ray.
.Ve
.ie n .IP "\fBTwinVQ (VQF flavor)     :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBTwinVQ (VQF flavor)     :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "TwinVQ (VQF flavor) : @tab X"
.PD 0
.ie n .IP "\fBVIMA                    :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVIMA                    :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "VIMA : @tab X"
.PD
.Vb 1
\&    @tab مورد استفاده در انیمیشن‌های SMUSH شرکت LucasArts.
.Ve
.ie n .IP "\fBViewQuest VQC           :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBViewQuest VQC           :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "ViewQuest VQC : @tab X"
.PD 0
.ie n .IP "\fBVorbis                  :   E  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVorbis                  :   E  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Vorbis : E @tab X"
.PD
.Vb 1
\&    @tab یک کدگذار توکار اما بسیار ابتدایی موجود است.
.Ve
.ie n .IP "\fBVoxware MetaSound       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBVoxware MetaSound       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Voxware MetaSound : @tab X"
.PD 0
.ie n .IP "\fBWaveform Archiver       :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWaveform Archiver       :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Waveform Archiver : @tab X"
.ie n .IP "\fBWavPack                 :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWavPack                 :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "WavPack : X @tab X"
.ie n .IP "\fBWestwood Audio (SND1)   :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWestwood Audio (SND1)   :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Westwood Audio (SND1) : @tab X"
.ie n .IP "\fBWindows Media Audio 1   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Audio 1   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Audio 1 : X @tab X"
.ie n .IP "\fBWindows Media Audio 2   :   X  \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Audio 2   :   X  \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Audio 2 : X @tab X"
.ie n .IP "\fBWindows Media Audio Lossless  :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Audio Lossless  :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Audio Lossless : @tab X"
.ie n .IP "\fBWindows Media Audio Pro  :     \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Audio Pro  :     \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Audio Pro : @tab X"
.ie n .IP "\fBWindows Media Audio Voice  :   \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBWindows Media Audio Voice  :   \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Windows Media Audio Voice : @tab X"
.ie n .IP "\fBXbox Media Audio 1      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBXbox Media Audio 1      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Xbox Media Audio 1 : @tab X"
.ie n .IP "\fBXbox Media Audio 2      :      \fR\fB@tab\fR\fB  X\fR" 4
.el .IP "\fBXbox Media Audio 2      :      \fR\f(CB@tab\fR\fB  X\fR" 4
.IX Item "Xbox Media Audio 2 : @tab X"
.PD
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که قابلیت موجود در آن ستون (کدگذاری / رمزگشایی) پشتیبانی می‌شود.
.PP
علامت \&\f(CW\*(C`E\*(C'\fR به این معنی است که پشتیبانی از طریق یک کتابخانه خارجی فراهم می‌شود.
.PP
علامت \&\f(CW\*(C`I\*(C'\fR به این معنی است که نسخه صرفاً عدد صحیح (integer\-only) نیز در دسترس است (عملکرد بالا
را در سیستم‌های فاقد پشتیبانی سخت‌افزاری ممیز شناور تضمین می‌کند).
.SS "قالب‌های زیرنویس (Subtitle Formats)"
.IX Subsection "Subtitle Formats"
.ie n .IP "\fBName  :  Muxing \fR\fB@tab\fR\fB Demuxing \fR\fB@tab\fR\fB Encoding \fR\fB@tab\fR\fB Decoding\fR" 4
.el .IP "\fBName  :  Muxing \fR\f(CB@tab\fR\fB Demuxing \fR\f(CB@tab\fR\fB Encoding \fR\f(CB@tab\fR\fB Decoding\fR" 4
.IX Item "Name : Muxing @tab Demuxing @tab Encoding @tab Decoding"
.PD 0
.ie n .IP "\fB3GPP Timed Text   :    \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fB3GPP Timed Text   :    \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "3GPP Timed Text : @tab @tab X @tab X"
.ie n .IP "\fBAQTitle           :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAQTitle           :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AQTitle : @tab X @tab @tab X"
.ie n .IP "\fBDVB               :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDVB               :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DVB : X @tab X @tab X @tab X"
.ie n .IP "\fBDVB teletext      :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB E\fR" 4
.el .IP "\fBDVB teletext      :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB E\fR" 4
.IX Item "DVB teletext : @tab X @tab @tab E"
.ie n .IP "\fBDVD               :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDVD               :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DVD : X @tab X @tab X @tab X"
.ie n .IP "\fBJACOsub           :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBJACOsub           :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "JACOsub : X @tab X @tab @tab X"
.ie n .IP "\fBMicroDVD          :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMicroDVD          :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MicroDVD : X @tab X @tab @tab X"
.ie n .IP "\fBMPL2              :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPL2              :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPL2 : @tab X @tab @tab X"
.ie n .IP "\fBMPsub (MPlayer)   :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPsub (MPlayer)   :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPsub (MPlayer) : @tab X @tab @tab X"
.ie n .IP "\fBPGS               :    \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPGS               :    \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PGS : @tab @tab @tab X"
.ie n .IP "\fBPJS (Phoenix)     :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPJS (Phoenix)     :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PJS (Phoenix) : @tab X @tab @tab X"
.ie n .IP "\fBRealText          :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBRealText          :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "RealText : @tab X @tab @tab X"
.ie n .IP "\fBSAMI              :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSAMI              :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SAMI : @tab X @tab @tab X"
.ie n .IP "\fBSpruce format (STL)  :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSpruce format (STL)  :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Spruce format (STL) : @tab X @tab @tab X"
.ie n .IP "\fBSSA/ASS           :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSSA/ASS           :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SSA/ASS : X @tab X @tab X @tab X"
.ie n .IP "\fBSubRip (SRT)      :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSubRip (SRT)      :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SubRip (SRT) : X @tab X @tab X @tab X"
.ie n .IP "\fBSubViewer v1      :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSubViewer v1      :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SubViewer v1 : @tab X @tab @tab X"
.ie n .IP "\fBSubViewer         :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSubViewer         :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SubViewer : @tab X @tab @tab X"
.ie n .IP "\fBTED Talks captions  :  \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBTED Talks captions  :  \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "TED Talks captions : @tab X @tab @tab X"
.ie n .IP "\fBTTML              :  X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X \fR\fB@tab\fR" 4
.el .IP "\fBTTML              :  X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR" 4
.IX Item "TTML : X @tab @tab X @tab"
.ie n .IP "\fBVobSub (IDX+SUB)  :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVobSub (IDX+SUB)  :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VobSub (IDX+SUB) : @tab X @tab @tab X"
.ie n .IP "\fBVPlayer           :    \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVPlayer           :    \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "VPlayer : @tab X @tab @tab X"
.ie n .IP "\fBWebVTT            :  X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBWebVTT            :  X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "WebVTT : X @tab X @tab X @tab X"
.ie n .IP "\fBXSUB              :    \fR\fB@tab\fR\fB   \fR\fB@tab\fR\fB X \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBXSUB              :    \fR\f(CB@tab\fR\fB   \fR\f(CB@tab\fR\fB X \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "XSUB : @tab @tab X @tab X"
.PD
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که این قابلیت پشتیبانی می‌شود.
.PP
علامت \&\f(CW\*(C`E\*(C'\fR به این معنی است که پشتیبانی از طریق یک کتابخانه خارجی فراهم می‌شود.
.SS "پروتکل‌های شبکه (Network Protocols)"
.IX Subsection "Network Protocols"
.IP "\fBName          :  Support\fR" 4
.IX Item "Name : Support"
.PD 0
.IP "\fBAMQP          :  E\fR" 4
.IX Item "AMQP : E"
.IP "\fBfile          :  X\fR" 4
.IX Item "file : X"
.IP "\fBFTP           :  X\fR" 4
.IX Item "FTP : X"
.IP "\fBGopher        :  X\fR" 4
.IX Item "Gopher : X"
.IP "\fBGophers       :  X\fR" 4
.IX Item "Gophers : X"
.IP "\fBHLS           :  X\fR" 4
.IX Item "HLS : X"
.IP "\fBHTTP          :  X\fR" 4
.IX Item "HTTP : X"
.IP "\fBHTTPS         :  X\fR" 4
.IX Item "HTTPS : X"
.IP "\fBIcecast       :  X\fR" 4
.IX Item "Icecast : X"
.IP "\fBMMSH          :  X\fR" 4
.IX Item "MMSH : X"
.IP "\fBMMST          :  X\fR" 4
.IX Item "MMST : X"
.IP "\fBpipe          :  X\fR" 4
.IX Item "pipe : X"
.IP "\fBPro\-MPEG FEC  :  X\fR" 4
.IX Item "Pro-MPEG FEC : X"
.IP "\fBRTMP          :  X\fR" 4
.IX Item "RTMP : X"
.IP "\fBRTMPE         :  X\fR" 4
.IX Item "RTMPE : X"
.IP "\fBRTMPS         :  X\fR" 4
.IX Item "RTMPS : X"
.IP "\fBRTMPT         :  X\fR" 4
.IX Item "RTMPT : X"
.IP "\fBRTMPTE        :  X\fR" 4
.IX Item "RTMPTE : X"
.IP "\fBRTMPTS        :  X\fR" 4
.IX Item "RTMPTS : X"
.IP "\fBRTP           :  X\fR" 4
.IX Item "RTP : X"
.IP "\fBSAMBA         :  E\fR" 4
.IX Item "SAMBA : E"
.IP "\fBSCTP          :  X\fR" 4
.IX Item "SCTP : X"
.IP "\fBSFTP          :  E\fR" 4
.IX Item "SFTP : E"
.IP "\fBTCP           :  X\fR" 4
.IX Item "TCP : X"
.IP "\fBTLS           :  X\fR" 4
.IX Item "TLS : X"
.IP "\fBUDP           :  X\fR" 4
.IX Item "UDP : X"
.IP "\fBZMQ           :  E\fR" 4
.IX Item "ZMQ : E"
.PD
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که پروتکل پشتیبانی می‌شود.
.PP
علامت \&\f(CW\*(C`E\*(C'\fR به این معنی است که پشتیبانی از طریق یک کتابخانه خارجی فراهم می‌شود.
.SS "دستگاه‌های ورودی/خروجی (Input/Output Devices)"
.IX Subsection "Input/Output Devices"
.ie n .IP "\fBName               :  Input  \fR\fB@tab\fR\fB Output\fR" 4
.el .IP "\fBName               :  Input  \fR\f(CB@tab\fR\fB Output\fR" 4
.IX Item "Name : Input @tab Output"
.PD 0
.ie n .IP "\fBALSA               :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBALSA               :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "ALSA : X @tab X"
.ie n .IP "\fBBKTR               :  X      \fR\fB@tab\fR" 4
.el .IP "\fBBKTR               :  X      \fR\f(CB@tab\fR" 4
.IX Item "BKTR : X @tab"
.ie n .IP "\fBcaca               :         \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBcaca               :         \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "caca : @tab X"
.ie n .IP "\fBDV1394             :  X      \fR\fB@tab\fR" 4
.el .IP "\fBDV1394             :  X      \fR\f(CB@tab\fR" 4
.IX Item "DV1394 : X @tab"
.ie n .IP "\fBLavfi virtual device  :  X   \fR\fB@tab\fR" 4
.el .IP "\fBLavfi virtual device  :  X   \fR\f(CB@tab\fR" 4
.IX Item "Lavfi virtual device : X @tab"
.ie n .IP "\fBLinux framebuffer  :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBLinux framebuffer  :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Linux framebuffer : X @tab X"
.ie n .IP "\fBJACK               :  X      \fR\fB@tab\fR" 4
.el .IP "\fBJACK               :  X      \fR\f(CB@tab\fR" 4
.IX Item "JACK : X @tab"
.IP "\fBLIBCDIO            :  X\fR" 4
.IX Item "LIBCDIO : X"
.ie n .IP "\fBLIBDC1394          :  X      \fR\fB@tab\fR" 4
.el .IP "\fBLIBDC1394          :  X      \fR\f(CB@tab\fR" 4
.IX Item "LIBDC1394 : X @tab"
.IP "\fBOpenAL             :  X\fR" 4
.IX Item "OpenAL : X"
.ie n .IP "\fBOpenGL             :         \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBOpenGL             :         \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "OpenGL : @tab X"
.ie n .IP "\fBOSS                :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBOSS                :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "OSS : X @tab X"
.ie n .IP "\fBPulseAudio         :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBPulseAudio         :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "PulseAudio : X @tab X"
.ie n .IP "\fBSDL                :         \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBSDL                :         \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "SDL : @tab X"
.ie n .IP "\fBVideo4Linux2       :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBVideo4Linux2       :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "Video4Linux2 : X @tab X"
.ie n .IP "\fBVfW capture        :  X      \fR\fB@tab\fR" 4
.el .IP "\fBVfW capture        :  X      \fR\f(CB@tab\fR" 4
.IX Item "VfW capture : X @tab"
.ie n .IP "\fBX11 grabbing       :  X      \fR\fB@tab\fR" 4
.el .IP "\fBX11 grabbing       :  X      \fR\f(CB@tab\fR" 4
.IX Item "X11 grabbing : X @tab"
.ie n .IP "\fBWin32 grabbing     :  X      \fR\fB@tab\fR" 4
.el .IP "\fBWin32 grabbing     :  X      \fR\f(CB@tab\fR" 4
.IX Item "Win32 grabbing : X @tab"
.PD
.PP
علامت \&\f(CW\*(C`X\*(C'\fR به این معنی است که ورودی/خروجی پشتیبانی می‌شود.
.SS "کد زمانی (Timecode)"
.IX Subsection "Timecode"
.ie n .IP "\fBCodec/format       :  Read   \fR\fB@tab\fR\fB Write\fR" 4
.el .IP "\fBCodec/format       :  Read   \fR\f(CB@tab\fR\fB Write\fR" 4
.IX Item "Codec/format : Read @tab Write"
.PD 0
.ie n .IP "\fBAVI                :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBAVI                :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "AVI : X @tab X"
.ie n .IP "\fBDV                 :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBDV                 :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "DV : X @tab X"
.ie n .IP "\fBGXF                :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBGXF                :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "GXF : X @tab X"
.ie n .IP "\fBMOV                :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMOV                :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MOV : X @tab X"
.ie n .IP "\fBMPEG1/2            :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMPEG1/2            :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MPEG1/2 : X @tab X"
.ie n .IP "\fBMXF                :  X      \fR\fB@tab\fR\fB X\fR" 4
.el .IP "\fBMXF                :  X      \fR\f(CB@tab\fR\fB X\fR" 4
.IX Item "MXF : X @tab X"
.PD
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBffplay\fR\|(1),
\&\fBffmpeg\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\-formats\fR\|(1),
\&\fBffmpeg\-devices\fR\|(1), \fBffmpeg\-protocols\fR\|(1), \fBffmpeg\-filters\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
توسعه‌دهندگان FFmpeg.
.PP
برای جزئیات درباره نویسندگی، تاریخچه گیت پروژه
(https://git.ffmpeg.org/ffmpeg) را مشاهده کنید، برای نمونه با وارد کردن دستور
\&\fBgit log\fR در دایرکتوری کد منبع FFmpeg، یا مرور مخزن آنلاین در
<\fBhttps://git.ffmpeg.org/ffmpeg\fR>.
.PP
نگه‌دارنده‌های مؤلفه‌های خاص در پرونده
\&\fIMAINTAINERS\fR در درخت کد منبع فهرست شده‌اند.