.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "FFMPEG-FILTERS 1" .TH FFMPEG-FILTERS 1 " " " " " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" ffmpeg\-filters \- مستندات و راهنمای فیلترهای صوتی و تصویری FFmpeg .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این سند فیلترها، سورس‌ها (منابع) و سینک‌ها (مقاصد) ارائه‌شده توسط کتابخانه libavfilter را شرح می‌دهد. .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 | \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 SYNTAX)" .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 \-vf drawtext=/text=/tmp/some_text .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 \& ::= sequence of alphanumeric characters and \*(Aq_\*(Aq \& ::= ["@"] \& ::= "[" "]" \& ::= [] \& ::= sequence of chars (possibly quoted) \& ::= [] ["=" ] [] \& ::= [,] \& ::= [sws_flags=;] [;] .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|FL0 و <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 "*" .PD 0 .IP "*<فقط یک ورودی به‌ازای هر کانال خروجی باشد،>" 4 .IX Item "*" .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" تنظیم موقعیت‌های سفارشی بلندگوهای مجازی. ساختار نحوی برای این گزینه عبارت است از: [| |...]. هر بلندگوی مجازی با نام کوتاه کانال و به دنبال آن آزیموت و فراز بر حسب درجه توصیف می‌شود. توضیحات هر بلندگوی مجازی با \*(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 \& = * .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 نیاز دارد (). پس از نصب کتابخانه می‌توان آن را با دستور زیر فعال کرد: \&\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. در صورت تنظیم، فیلتر یک ماژول تشخیص فعالیت صوتی اضافی () را بارگذاری می‌کند که برای قطعه‌بندی صف صوتی به کار می‌رود؛ با تنظیم یک مسیر معتبر دریافت شده از مخزن 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 \& / .Ve .Sp که به ازای آن تصویر سیاه در نظر گرفته می‌شود. مقدار پیش‌فرض 0.98 است. .IP "\fBpixel_black_th, pix_th\fR" 4 .IX Item "pixel_black_th, pix_th" تنظیم آستانه برای "سیاه" در نظر گرفتن یک پیکسل. .Sp این آستانه حداکثر مقدار لومای یک پیکسل را که برای آن پیکسل "سیاه" تلقی می‌شود مشخص می‌کند. مقدار ارائه‌شده طبق معادله زیر مقیاس‌بندی می‌شود: .Sp .Vb 1 \& = + * .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 \& =* + * + * + * .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=@