Дакументацыя па фільтрах FFmpeg

Змест

1 Description

У гэтым дакуменце апісваюцца фільтры, крыніцы і прыёмнікі, прадстаўленыя бібліятэкай libavfilter.

2 Filtering Introduction

Фільтраванне ў FFmpeg уключана праз бібліятэку libavfilter.

У libavfilter фільтр можа мець некалькі ўваходаў і некалькі выхадаў. Каб праілюстраваць усё, што магчыма, мы разгледзім наступны фільтр.

                [галоўная]
увод --> раздзяленне ---------------------> накладанне --> вывад
            | ^
            |[tmp] [перавярнуць]|
            +-----> абрэзка --> vflip -------+

Гэты фільтраграм раздзяляе ўваходны паток на два патокі, затым адпраўляе адзін паток праз фільтр абрэзкі і фільтр vflip, перш чым аб'яднаць яго з іншым патокам, наклаўшы яго зверху. Вы можаце выкарыстоўваць наступную каманду, каб дасягнуць гэтага:

ffmpeg -i INPUT -vf "split [main][tmp]; [tmp] crop=iw:ih/2:0:0, vflip [flip]; [main][flip] overlay=0:H/2" OUTPUT

У выніку верхняя палова відэа адлюстроўваецца ў ніжняй палове выхаднога відэа.

Фільтры ў адной лінейнай ланцужку падзяляюцца коскамі, а розныя лінейныя ланцужкі фільтраў - кропкай з коскай. У нашым прыкладзе crop,vflipзнаходзяцца ў адной лінейнай ланцугу, splitа overlayпаасобку ў другой. Пункты злучэння лінейных ланцужкоў пазначаны назвамі ў квадратных дужках. У прыкладзе раздзяляльны фільтр стварае два выхады, звязаныя з цэтлікамі [main]і [tmp].

Паток, які адпраўляецца на другі выхад split, пазначаны як [tmp], апрацоўваецца праз cropфільтр, які абразае ніжнюю палову відэа, а затым вертыкальна перагортваецца. Фільтр overlayпрымае на ўваход першы нязменны выхад раздзяленага фільтра (які быў пазначаны як [main]), і накладвае на яго ніжнюю палову выхад, створаны crop,vflipланцугом фільтраў.

Некаторыя фільтры прымаюць на ўваходзе спіс параметраў: яны ўказваюцца пасля назвы фільтра і знака роўнасці і аддзяляюцца адзін ад аднаго двукроп'ем.

Існуюць так званыя source filters, якія не маюць аўдыё/відэа ўваходу і sink filtersне маюць аўдыё/відэа выхаду.

3 graph2dot

Thegraph2dotПраграма, якая ўваходзіць у FFmpegtools можа быць выкарыстаны для аналізу апісання фільтра і выдачы адпаведнага тэкставага прадстаўлення на мове кропак.

Выклік каманды:

graph2dot -h

каб убачыць, як выкарыстоўвацьgraph2dot.

Затым вы можаце перадаць апісанне кропкі ўdotпраграму (з набору праграм graphviz) і атрымаць графічнае прадстаўленне фільтра.

Напрыклад, паслядоўнасць каманд:

echo GRAPH_DESCRIPTION | \
tools/graph2dot -o graph.tmp && \
dot -Tpng graph.tmp -o graph.png && \
display graph.png

можа выкарыстоўвацца для стварэння і адлюстравання выявы, якая прадстаўляе граф, апісаны GRAPH_DESCRIPTIONрадком. Звярніце ўвагу, што гэты радок павінен быць поўным самадастатковым графам з выразна вызначанымі ўваходамі і выхадамі. Напрыклад, калі ваш камандны радок мае выгляд:

ffmpeg -i infile -vf scale=640:360 outfile

ваш GRAPH_DESCRIPTIONрадок павінен мець выгляд:

nullsrc,scale=640:360,nullsink

вам таксама можа спатрэбіцца ўсталяваць nullsrcпараметры і дадаць format фільтр, каб імітаваць пэўны ўваходны файл.

4 Filtergraph description

Фільтрграф - гэта арыентаваны граф звязаных фільтраў. Ён можа ўтрымліваць цыклы, і можа быць некалькі сувязяў паміж парай фільтраў. Кожнае звяно мае адну ўваходную пляцоўку з аднаго боку, якая злучае яе з адным фільтрам, ад якога яна прымае ўваход, і адну выходную пляцоўку з другога боку, якая злучае яе з адным фільтрам, які прымае яго выхад.

Кожны фільтр у графе фільтра з'яўляецца асобнікам класа фільтра, зарэгістраванага ў дадатку, які вызначае функцыі і колькасць уваходных і выходных пляцовак фільтра.

Фільтр без уваходных пляцовак называецца "крыніцай", а фільтр без выходных пляцовак - "прыёмнікам".

4.1 Filtergraph syntax

Граф фільтра мае тэкставае прадстаўленне, якое распазнаецца -filter/-vf/-afі -filter_complexварыянты ў ffmpegі -vf/-afу ffplay, і з дапамогай avfilter_graph_parse_ptr()функцыі, вызначанай у libavfilter/avfilter.h.

Ланцужок фільтраў складаецца з паслядоўнасці злучаных фільтраў, кожны з якіх звязаны з папярэднім у паслядоўнасці. Ланцужок фільтраў прадстаўлены спісам апісанняў фільтраў, падзеленых ",".

Фільтрграф складаецца з паслядоўнасці ланцугоў фільтраў. Паслядоўнасць ланцугоў фільтраў прадстаўлена спісам апісанняў ланцугоў фільтраў, падзеленых знакам ";".

Фільтр прадстаўлены радком выгляду: [ in_link_1]...[ in_link_N] filter_name@ id= arguments[ out_link_1]...[ out_link_M]

filter_nameгэта імя класа фільтраў, экзэмплярам якога з'яўляецца апісаны фільтр, і павінна быць імем аднаго з класаў фільтраў, зарэгістраваных у праграме, за якім, магчыма, варта "@ id". Імя класа фільтра неабавязкова суправаджаецца радком "= arguments".

argumentsгэта радок, які змяшчае параметры, якія выкарыстоўваюцца для ініцыялізацыі асобніка фільтра. Ён можа мець адну з двух формаў:

  • Спіс key=valueпар, падзелены ':'.
  • Спіс, падзелены ':' value. У гэтым выпадку мяркуецца, што ключы з'яўляюцца імёнамі опцый у парадку іх аб'яўлення. Напрыклад, fadeфільтр дэкларуе тры варыянты ў такім парадку -type,start_frameі nb_frames. Тады спіс параметраў in:0:30азначае, што inопцыі прысвоена значэннеtype, 0каб start_frameі 30даnb_frames.
  • Спіс змешаных прамых valueі доўгіх key=value пар, падзелены ':'. Прамы valueпавінен папярэднічаць key=valueпарам і прытрымлівацца таго ж парадку абмежаванняў, што і ў папярэднім пункце. Наступныя key=valueпары можна ўсталяваць у любым патрэбным парадку.

Калі само значэнне опцыі ўяўляе сабой спіс элементаў (напрыклад, formatфільтр прымае спіс фарматаў пікселяў), элементы ў спісе звычайна падзяляюцца знакам '|'.

Спіс аргументаў можа быць заключаны ў цытаты з дапамогай сімвала ''' як пачатковы і канчатковы знак, а таксама сімвал '\' для экраніравання сімвалаў у цытаваным тэксце; у адваротным выпадку радок аргументу лічыцца завершаным, калі наступны спецыяльны сімвал (належыць да набору '[]=;,') сустракаецца.

Назва і аргументы фільтра неабавязкова папярэднічаюць і суправаджаюцца спісам метак спасылак. Метка спасылкі дазваляе назваць спасылку і звязаць яе з выхадам фільтра або ўводам. Папярэднія этыкеткі in_link_1 ... in_link_N, звязаныя з уваходнымі пляцоўкамі фільтра, наступныя этыкеткі out_link_1... out_link_M, звязаныя з выходнымі пляцоўкамі.

Калі дзве цэтлікі спасылак з аднолькавым імем знойдзены ў фільтравальнай графе, ствараецца сувязь паміж адпаведнай пляцоўкай уводу і вываду.

Калі выхадная пляцоўка не пазначана, яна па змаўчанні звязана з першай непазначанай уваходнай пляцоўкай наступнага фільтра ў ланцужку фільтраў. Напрыклад, у ланцужку фільтраў

nullsrc, split[L1], [L2]overlay, nullsink

экзэмпляр раздзеленага фільтра мае дзве выходныя пляцоўкі, а асобнік накладнога фільтра - дзве ўваходныя пляцоўкі. Першая выхадная пляцоўка падзелу пазначана "L1", першая ўваходная пляцоўка накладання пазначана "L2", а другая выходная пляцоўка падзелу звязана з другой уваходнай пляцоўкай накладання, абедзве не пазначаныя.

У апісанні фільтра, калі ўваходны ярлык першага фільтра не ўказаны, мяркуецца "ў"; калі метка вываду апошняга фільтра не ўказана, мяркуецца "out".

У поўнай ланцужку фільтраў усе ўваходныя і выходныя пляцоўкі фільтра без маркіроўкі павінны быць падлучаны. Граф фільтра лічыцца сапраўдным, калі ўсе ўваходныя і выходныя пляцоўкі фільтраў усіх ланцужкоў фільтраў злучаны.

Libavfilter аўтаматычна ўставіць маштабныя фільтры там, дзе патрабуецца пераўтварэнне фармату. Можна пазначыць сцягі swscale для аўтаматычна ўстаўленых маштабавальнікаў, дадаўшы іх да апісання фільтра. sws_flags=flags;

Вось апісанне BNF сінтаксісу filtergraph:

NAME             ::= sequence of alphanumeric characters and '_'
FILTER_NAME      ::= NAME["@"NAME]
LINKLABEL        ::= "[" NAME "]"
LINKLABELS       ::= LINKLABEL [LINKLABELS]
FILTER_ARGUMENTS ::= sequence of chars (possibly quoted)
FILTER           ::= [LINKLABELS] FILTER_NAME ["=" FILTER_ARGUMENTS] [LINKLABELS]
FILTERCHAIN      ::= FILTER [,FILTERCHAIN]
FILTERGRAPH      ::= [sws_flags=flags;] FILTERCHAIN [;FILTERGRAPH]

4.2 Notes on filtergraph escaping

Кампазіцыя апісання фільтра прадугледжвае некалькі ўзроўняў экраніравання. Глядзіце (ffmpeg-utils) раздзел «Цытаванне і экранаванне» ў кіраўніцтве ffmpeg-utils(1) для атрымання дадатковай інфармацыі аб выкарыстоўванай працэдуры экраніравання.

Экранаванне першага ўзроўню ўплывае на змест кожнага значэння опцыі фільтра, якое можа ўтрымліваць спецыяльны сімвал, :які выкарыстоўваецца для падзелу значэнняў, або адзін з экраніраваных сімвалаў \'.

Экранаванне другога ўзроўню ўплывае на ўсё апісанне фільтра, якое можа ўтрымліваць экраніраваныя сімвалы \'або спецыяльныя сімвалы [],;, якія выкарыстоўваюцца ў апісанні фільтра.

Нарэшце, калі вы задаеце графік фільтра ў камандным радку абалонкі, вам трэба выканаць экраніраванне трэцяга ўзроўню для спецыяльных сімвалаў абалонкі, якія змяшчаюцца ў ім.

Напрыклад, разгледзім наступны радок, які будзе ўбудаваны ў апісанне фільтра drawtexttextзначэнне:

this is a 'string': may contain one, or more, special characters

Гэты радок змяшчае 'спецыяльны сімвал экраніравання і :спецыяльны сімвал, таму яго трэба экранаваць наступным чынам:

text=this is a \'string\'\: may contain one, or more, special characters

Другі ўзровень экраніравання патрабуецца пры ўбудаванні апісання фільтра ў апісанне filtergraph, каб экранаваць усе спецыяльныя сімвалы filtergraph. Такім чынам, прыклад вышэй становіцца:

drawtext=text=this is a \\\'string\\\'\\: may contain one\, or more\, special characters

(звярніце ўвагу, што ў дадатак да \'экраніраваных спецыяльных сімвалаў таксама ,трэба экранаваць).

Нарэшце, пры напісанні апісання фільтраграфа ў камандзе абалонкі неабходны дадатковы ўзровень экраніравання, які залежыць ад правілаў экраніравання прынятай абалонкі. Напрыклад, калі выказаць здагадку, што \з'яўляецца асаблівым і яго трэба экранаваць з дапамогай another \, папярэдні радок нарэшце прывядзе да:

-vf "drawtext=text=this is a \\\\\\'string\\\\\\'\\\\: may contain one\\, or more\\, special characters"

5 Timeline editing

Некаторыя фільтры падтрымліваюць агульныяenableварыянт. Для фільтраў, якія падтрымліваюць рэдагаванне часовай шкалы, гэты параметр можа быць усталяваны ў выраз, які вылічваецца перад адпраўкай кадра ў фільтр. Калі ацэнка не роўная нулю, фільтр будзе ўключаны, у адваротным выпадку кадр будзе адпраўлены без змен да наступнага фільтра ў графе фільтраў.

Выраз прымае наступныя значэнні:

't'

пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая

'n'

парадкавы нумар уваходнага кадра, пачынаючы з 0

'pos'

пазіцыя ў файле ўваходнага кадра, NAN, калі невядома

'w'
'h'

шырыня і вышыня ўваходнага кадра, калі відэа

Акрамя таго, гэтыя фільтры падтрымліваюць anenableкаманда, якую можна выкарыстоўваць для перавызначэння выразу.

Як і любы іншы варыянт фільтрацыі,enableварыянт прытрымліваецца тых жа правілаў.

Напрыклад, каб уключыць фільтр размыцця ( smartblur ) ад 10 секунд да 3 хвілін і фільтр крывых , пачынаючы з 3 секунд:

smartblur = enable='between(t,10,3*60)',
curves    = enable='gte(t,3)' : preset=cross_process

Глядзіце ffmpeg -filters, якія фільтры падтрымліваюць шкалу часу.

6 Changing options at runtime with a command

Некаторыя параметры можна змяніць падчас працы фільтра з дапамогай каманды. Гэтыя параметры пазначаны 'T' на выхадзе ffmpeg -h filter=<name of filter>. Імя каманды - гэта імя опцыі, а аргумент - новае значэнне.

7 Options for filters with several inputs (framesync)

Некаторыя фільтры з некалькімі ўваходамі падтрымліваюць агульны набор параметраў. Гэтыя параметры можна задаць толькі па назве, а не з дапамогай кароткага запісу.

eof_action

Дзеянне, якое неабходна выканаць, калі EOF сустракаецца на другасным уводзе; ён прымае адно з наступных значэнняў:

repeat

Паўтарыць апошні кадр (па змаўчанні).

endall

Скончыце абодва патокі.

pass

Прапусціце асноўны ўваход.

shortest

Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.

repeatlast

Калі ўстаноўлена значэнне 1, фільтр прымушае пашыраць апошні кадр другасных патокаў да канца асноўнага патоку. Значэнне 0 адключае гэтыя паводзіны. Значэнне па змаўчанні - 1.

8 Audio Filters

Калі вы наладжваеце зборку FFmpeg, вы можаце адключыць любы з існуючых фільтраў з дапамогай --disable-filters. Выхад канфігурацыі пакажа гукавыя фільтры, уключаныя ў вашу зборку.

Ніжэй прыводзіцца апісанне даступных у цяперашні час аўдыяфільтраў.

8.1 acompressor

Кампрэсар у асноўным выкарыстоўваецца для памяншэння дынамічнага дыяпазону сігналу. Асабліва сучасная музыка ў асноўным сціскаецца з высокім каэфіцыентам для паляпшэння агульнай гучнасці. Гэта робіцца для таго, каб прыцягнуць максімальную ўвагу слухача, «накарміць» гук і надаць трэку большай «моцы». Калі сігнал сціскаецца занадта моцна, пасля гэтага ён можа гучаць глуха ці «мёртвым» або можа пачаць «пампавацца» (што можа быць моцным эфектам, але можа цалкам разбурыць трэк). Правільнае сцісканне з'яўляецца ключом да дасягнення прафесійнага гуку і з'яўляецца высокім мастацтвам звядзення і мастэрынгу. З-за яго складаных налад можа спатрэбіцца шмат часу, каб атрымаць правільнае адчуванне такога эфекту.

Сцісканне ажыццяўляецца шляхам вызначэння гучнасці вышэй за абраны ўзровень thresholdі дзялення яго на каэфіцыент, зададзены з дапамогай ratio. Такім чынам, калі вы ўсталюеце парог -12 дБ і ваш сігнал дасягае -6 дБ, стаўленне 2:1 прывядзе да сігналу на -9 дБ. Паколькі дакладная маніпуляцыя сігналам прывядзе да скажэння формы сігналу, зніжэнне можа быць выраўнавана з часам. Гэта робіцца шляхам налады «Атака» і «Адпусканне». attackвызначае, як доўга сігнал павінен падымацца вышэй парогавага значэння, перш чым адбудзецца любое зніжэнне, і releaseзадае час, на працягу якога сігнал павінен апусціцца ніжэй парогавага значэння, каб зноў паменшыць зніжэнне. Больш кароткія сігналы, чым выбраны час атакі, застануцца некранутымі. Агульнае зніжэнне сігналу можна кампенсаваць пасля з дапамогай makeupўстаноўка. Такім чынам, сціскаючы пікі сігналу прыкладна на 6 дБ і падымаючы макіяж да гэтага ўзроўню, сігнал атрымліваецца ў два разы гучней, чым крыніца. Для атрымання больш мяккага запісу ў сціску kneeцвёрды край згладжваецца на парозе ў дыяпазоне абраных дэцыбел.

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.

mode

Ўсталяваць рэжым працы кампрэсара. Можа быць upwardабо downward. Па змаўчанні downward.

threshold

Калі сігнал патоку падымаецца вышэй за гэты ўзровень, гэта паўплывае на зніжэнне ўзмацнення. Па змаўчанні гэта 0,125. Дыяпазон ад 0,00097563 да 1.

ratio

Усталюйце каэфіцыент паніжэння сігналу. 1:2 азначае, што калі ўзровень падняўся на 4 дБ вышэй парога, то пасля зніжэння ён будзе вышэй толькі на 2 дБ. Па змаўчанні - 2. Дыяпазон - ад 1 да 20.

attack

Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым пачнецца зніжэнне ўзмацнення. Па змаўчанні - 20. Дыяпазон - ад 0,01 да 2000.

release

Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў паменшыцца. Па змаўчанні - 250. Дыяпазон - ад 0,01 да 9000.

makeup

Усталюйце колькасць, наколькі сігнал будзе ўзмоцнены пасля апрацоўкі. Па змаўчанні 1. Дыяпазон ад 1 да 64.

knee

Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,82843. Дыяпазон ад 1 да 8.

link

Выберыце, калі averageўзровень паміж усімі каналамі ўваходнага патоку ці больш гучны ( maximum) канал уваходнага патоку ўплывае на зніжэнне. Па змаўчанні average.

detection

Калі браць дакладны сігнал у выпадку peakабо RMS ў выпадку rms. Па змаўчанні - гэта тое rms, што больш гладка.

mix

Колькі выкарыстоўваць сціснуты сігнал у вывадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

8.1.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.2 acontrast

Просты фільтр сціску/пашырэння дынамічнага дыяпазону гуку.

Фільтр прымае наступныя параметры:

contrast

Усталюйце кантраст. Па змаўчанні - 33. Дазволены дыяпазон ад 0 да 100.

8.3 acopy

Скапіруйце крыніцу ўваходнага гуку без зменаў на выхад. Гэта ў асноўным карысна для тэставання.

8.4 acrossfade

Прымяненне крыжаванага знікнення ад аднаго ўваходнага аўдыяпатоку да іншага ўваходнага аўдыяпатоку. Перакрыжаванае знікненне прымяняецца на вызначаны час у канцы першага патоку.

Фільтр прымае наступныя параметры:

nb_samples, ns

Укажыце колькасць узораў, для якіх павінен працягвацца эфект перакрыжаванага знікнення. У канцы эфекту перакрыжаванага знікнення першы ўваходны гук будзе цалкам бясшумным. Па змаўчанні 44100.

duration, d

Укажыце працягласць эфекту перакрыжаванага знікнення. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Па змаўчанні працягласць вызначаецца nb_samples. Калі ўсталяваны, гэты параметр выкарыстоўваецца замест nb_samples.

overlap, o

Калі канец першага патоку перакрываецца з пачаткам другога патоку. Па змаўчанні ўключана.

curve1

Усталюйце крывую для пераходу з знікненнем для першага патоку.

curve2

Усталюйце крывую для пераходу з знікненнем для другога патоку.

Для апісання даступных тыпаў крывых глядзіце апісанне фільтра afade .

8.4.1 Examples

  • Перакрыжаванае знікненне ад аднаго ўваходу да іншага:
    ffmpeg -i first.flac -i second.flac -filter_complex acrossfade=d=10:c1=exp:c2=exp output.flac
    
  • Перакрыжаванае знікненне ад аднаго ўваходу да іншага, але без накладання:
    ffmpeg -i first.flac -i second.flac -filter_complex acrossfade=d=10:o=0:c1=exp:c2=exp output.flac
    

8.5 acrossover

Падзяліць аўдыяструмень на некалькі палос.

Гэты фільтр падзяляе аўдыяпаток на два ці больш дыяпазонаў частот. Сумаванне ўсіх патокаў назад дасць роўны вынік.

Фільтр прымае наступныя параметры:

split

Усталюйце раздзяляльныя частоты. Яны павінны быць пазітыўнымі і расці.

order

Усталюйце парадак фільтра для кожнага падзелу дыяпазону. Гэта кантралюе спад фільтра або крутасць функцыі перадачы фільтра. Даступныя значэнні:

'2nd'

12 дБ на актаву.

'4th'

24 дБ на актаву.

'6th'

36 дБ на актаву.

'8th'

48 дБ на актаву.

'10th'

60 дБ на актаву.

'12th'

72 дБ на актаву.

'14th'

84 дБ на актаву.

'16th'

96 дБ на актаву.

'18th'

108 дБ на актаву.

'20th'

120 дБ на актаву.

Па змаўчанні 4th.

level

Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

gains

Усталюйце ўзмацненне выхаду для кожнай паласы. Значэнне па змаўчанні - 1 для ўсіх дыяпазонаў.

precision

Усталюйце, якую дакладнасць выкарыстоўваць пры апрацоўцы ўзораў.

auto

Аўтаматычны выбар унутранага фармату выбаркі ў залежнасці ад іншых фільтраў.

float

Заўсёды выкарыстоўвайце фармат выбаркі з адной плаваючай кропкай.

double

Заўсёды выкарыстоўвайце фармат выбаркі з падвойнай плаваючай кропкай.

Значэнне па змаўчанні - auto.

8.5.1 Examples

  • Падзяліць уваходны аўдыяпаток на два дыяпазоны (нізкі і высокі) з частатой падзелу 1500 Гц, кожны дыяпазон будзе ў асобным патоку:
    ffmpeg -i in.flac -filter_complex 'acrossover=split=1500[LOW][HIGH]' -map '[LOW]' low.wav -map '[HIGH]' high.wav
    
  • Тое самае, што і вышэй, але з больш высокім парадкам фільтра:
    ffmpeg -i in.flac -filter_complex 'acrossover=split=1500:order=8th[LOW][HIGH]' -map '[LOW]' low.wav -map '[HIGH]' high.wav
    
  • Тое самае, што і вышэй, але таксама з дадатковым сярэднім дыяпазонам (частоты паміж 1500 і 8000):
    ffmpeg -i in.flac -filter_complex 'acrossover=split=1500 8000:order=8th[LOW][MID][HIGH]' -map '[LOW]' low.wav -map '[MID]' mid.wav -map '[HIGH]' high.wav
    

8.6 acrusher

Паменшыць бітнае раздзяленне гуку.

Гэты фільтр з'яўляецца драбнілкай біт з пашыранай функцыянальнасцю. Драбнільнік бітаў выкарыстоўваецца для слыхавога памяншэння колькасці біт, з дапамогай якіх адбываецца выбарка гукавога сігналу. Гэта зусім не змяняе бітавай глыбіні, а проста стварае эфект. Паменшаны ў разраднасці матэрыял гучыць больш жорстка і «лічбава». Гэты фільтр здольны нават акругляць да бесперапынных значэнняў замест дыскрэтнай глыбіні бітаў. Акрамя таго, ён мае D/C зрушэнне, якое прыводзіць да рознага драбнення ніжняй і верхняй паловы сігналу. Параметр Anti-Aliasing можа ствараць больш «мяккія» рэзкія гукі.

Яшчэ адна асаблівасць гэтага фільтра - лагарыфмічны рэжым. Гэты параметр пераключае лінейныя адлегласці паміж бітамі на лагарыфмічныя. У выніку атрымліваецца значна больш "натуральнае" гучанне драбнілкі, якая, напрыклад, не перакрывае нізкія сігналы. Чалавечае вуха валодае лагарыфмічным ўспрыманнем, таму такое драбненне нашмат прыемней. Лагарыфмічнае драбненне таксама можа атрымаць згладжванне.

Фільтр прымае наступныя параметры:

level_in

Усталюйце ўзровень.

level_out

Усталюйце ўзровень.

bits

Усталяваць памяншэнне бітаў.

mix

Усталюйце колькасць змешвання.

mode

Можа быць лінейным: linабо лагарыфмічным: log.

dc

Усталюйце DC.

aa

Усталюйце згладжванне.

samples

Усталяваць скарачэнне ўзору.

lfo

Уключыць LFO. Па змаўчанні адключана.

lforange

Усталюйце дыяпазон LFO.

lforate

Усталюйце хуткасць LFO.

8.6.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.7 acue

Затрымка фільтрацыі гуку да дадзенай меткі часу насценнага гадзінніка. Глядзіце фільтр рэплікі.

8.8 adeclick

Выдаліць імпульсіўны шум з уваходнага аўдыя.

Узоры, выяўленыя як імпульсіўны шум, замяняюцца інтэрпаляванымі ўзорамі з выкарыстаннем аўтарэгрэсіўнага мадэлявання.

window, w

Задаць памер акна ў мілісекундах. Дазволены дыяпазон ад 10да 100. Значэнне па змаўчанні - 55мілісекунды. Гэта задае памер акна, якое будзе апрацоўвацца адначасова.

overlap, o

Задаць перакрыцце вокнаў у працэнтах ад памеру акна. Дазволены дыяпазон ад 50да 95. Значэнне па змаўчанні - 75працэнт. Усталяванне вельмі высокага значэння павялічвае выдаленне імпульснага шуму, але значна запавольвае ўвесь працэс.

arorder, a

Усталюйце парадак аўтарэгрэсіі ў працэнтах ад памеру акна. Дазволены дыяпазон ад 0да 25. Значэнне па змаўчанні - 2працэнт. Гэты параметр таксама кантралюе якасць інтэрпаляваных узораў з выкарыстаннем суседніх добрых узораў.

threshold, t

Усталюйце парогавае значэнне. Дазволены дыяпазон ад 1да 100. Значэнне па змаўчанні - 2. Гэта кантралюе сілу імпульснага шуму, які будзе выдалены. Чым меншае значэнне, тым больш узораў будзе вызначана як імпульсны шум.

burst, b

Задаць пакетнае аб'яднанне ў працэнтах ад памеру акна. Дазволены дыяпазон 0да 10. Значэнне па змаўчанні - 2. Калі любыя дзве выбаркі, выяўленыя як шум, размешчаны менш, чым гэта значэнне, любая выбарка паміж гэтымі двума выбаркамі таксама будзе вызначана як шум.

method, m

Усталюйце метад перакрыцця.

Ён прымае наступныя значэнні:

add, a

Выберыце спосаб дадання перакрыцця. Нават неинтерполированные выбаркі нязначна змяняюцца з дапамогай гэтага метаду.

save, s

Выберыце метад захавання перакрыцця. Неінтэрпаляваныя выбаркі застаюцца нязменнымі.

Значэнне па змаўчанні - a.

8.9 adeclip

Выдаліць абрэзаныя ўзоры з уваходнага аўдыя.

Узоры, выяўленыя як абрэзаныя, замяняюцца інтэрпаляванымі ўзорамі з выкарыстаннем аўтарэгрэсіўнага мадэлявання.

window, w

Задаць памер акна ў мілісекундах. Дазволены дыяпазон ад 10да 100. Значэнне па змаўчанні - 55мілісекунды. Гэта задае памер акна, якое будзе апрацоўвацца адначасова.

overlap, o

Задаць перакрыцце вокнаў у працэнтах ад памеру акна. Дазволены дыяпазон ад 50 да 95. Значэнне па змаўчанні - 75працэнт.

arorder, a

Усталюйце парадак аўтарэгрэсіі ў працэнтах ад памеру акна. Дазволены дыяпазон ад 0да 25. Значэнне па змаўчанні - 8працэнт. Гэты параметр таксама кантралюе якасць інтэрпаляваных узораў з выкарыстаннем суседніх добрых узораў.

threshold, t

Усталюйце парогавае значэнне. Дазволены дыяпазон ад 1да 100. Значэнне па змаўчанні - 10. Больш высокія значэнні робяць выяўленне кліпаў менш агрэсіўным.

hsize, n

Задаць памер гістаграмы, якая выкарыстоўваецца для выяўлення кліпаў. Дазволены дыяпазон ад 100да 9999. Значэнне па змаўчанні - 1000. Больш высокія значэнні робяць выяўленне кліпаў менш агрэсіўным.

method, m

Усталюйце метад перакрыцця.

Ён прымае наступныя значэнні:

add, a

Выберыце спосаб дадання перакрыцця. Нават неинтерполированные выбаркі нязначна змяняюцца з дапамогай гэтага метаду.

save, s

Выберыце метад захавання перакрыцця. Неінтэрпаляваныя выбаркі застаюцца нязменнымі.

Значэнне па змаўчанні - a.

8.10 adecorrelate

Прымяніць дэкарэляцыю да ўваходнага аўдыяпатоку.

Фільтр прымае наступныя параметры:

stages

Задаць дэкарэляцыйныя этапы фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 6.

seed

Устанавіць выпадковае пачатковае значэнне, якое выкарыстоўваецца для ўстанаўлення затрымкі ў выбарках па каналах.

8.11 adelay

Затрымка аднаго або некалькіх аўдыяканалаў.

Сэмплы ў канале з затрымкай напоўнены цішынёй.

Фільтр прымае наступныя параметры:

delays

Усталяваць спіс затрымак у мілісекундах для кожнага канала, раздзеленых знакам '|'. Нявыкарыстаныя затрымкі будуць моўчкі ігнаравацца. Калі колькасць дадзеных затрымак меншая за колькасць каналаў, усе астатнія каналы не будуць затрымлівацца. Калі вы хочаце адкласці дакладную колькасць узораў, дадайце 'S' да ліку. Калі замест гэтага вы хочаце зрабіць затрымку ў секундах, дадайце 's' да ліку.

all

Выкарыстоўвайце апошнюю зададзеную затрымку для ўсіх астатніх каналаў. Па змаўчанні адключана. Калі гэтая опцыя ўключана, змяняецца delaysяе інтэрпрэтацыя.

8.11.1 Examples

  • Затрымайце першы канал на 1,5 секунды, трэці канал - на 0,5 секунды і пакіньце другі канал (і любыя іншыя каналы, якія могуць прысутнічаць) без зменаў.
    adelay=1500|0|500
    
  • Затрымка другога канала на 500 выбарак, трэцяга канала на 700 выбарак і пакіньце першы канал (і любыя іншыя каналы, якія могуць прысутнічаць) без зменаў.
    adelay=0|500S|700S
    
  • Затрымка ўсіх каналаў на аднолькавую колькасць выбарак:
    adelay=delays=64S:all=1
    

8.12 adenorm

Выпраўце дэнармалізацыю аўдыя, дадаўшы вельмі нізкі ўзровень шуму.

Гэты фільтр павінен быць размешчаны перад любым фільтрам, які можа выклікаць дэнармалізацыю.

Далей апісваюцца прынятыя параметры.

level

Усталюйце ўзровень дадатковага шуму ў дБ. Па змаўчанні -351. Дазволены дыяпазон ад -451 да -90.

type

Усталюйце тып дадатковага шуму.

dc

Дадайце сігнал пастаяннага току.

ac

Дадайце сігнал пераменнага току.

square

Дадайце квадратны сігнал.

pulse

Дадаць імпульсны сігнал.

Па змаўчанні dc.

8.12.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.13 aderivative, aintegral

Вылічыць вытворную/інтэграл аўдыяплыні.

Прымяненне абодвух фільтраў адзін за адным стварае арыгінальны гук.

8.14 adynamicequalizer

Прымяніць дынамічнае выраўноўванне да ўваходнага аўдыёпатоку.

Далей апісваюцца прынятыя варыянты.

threshold

Усталюйце парог выяўлення, які выкарыстоўваецца для запуску эквалайзера. Парог выяўлення з дапамогай паласавога фільтра. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад 0 да 100.

dfrequency

Усталюйце частату выяўлення ў Гц, якая выкарыстоўваецца для паласавога фільтра, які выкарыстоўваецца для запуску эквалайзера. Значэнне па змаўчанні - 1000 Гц. Дазволены дыяпазон ад 2 да 1000000 Гц.

dqfactor

Усталюйце каэфіцыент рэзанансу выяўлення для паласавога фільтра, які выкарыстоўваецца для запуску эквалайзера. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,001 да 1000.

tfrequency

Усталюйце мэтавую частату фільтра выраўноўвання. Значэнне па змаўчанні - 1000 Гц. Дазволены дыяпазон ад 2 да 1000000 Гц.

tqfactor

Усталюйце мэтавы каэфіцыент рэзанансу для мэтавага эквалайзернага фільтра. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,001 да 1000.

attack

Усталюйце колькасць мілісекунд, за якое сігнал ад выяўлення павінен падняцца вышэй парога выяўлення, перш чым пачнецца выраўноўванне. Па змаўчанні - 20. Дазволены дыяпазон ад 1 да 2000.

release

Усталюйце колькасць мілісекунд, на працягу якіх сігнал ад выяўлення павінен апусціцца ніжэй парога выяўлення, перш чым выраўноўванне скончыцца. Па змаўчанні - 200. Дазволены дыяпазон ад 1 да 2000.

knee

Выгніце вострае калена вакол парога выяўлення, каб разлічыць узмацненне эквалайзера больш мякка. Па змаўчанні 1. Дазволены дыяпазон ад 0 да 8.

ratio

Усталюйце каэфіцыент, на які павялічваецца ўзмацненне эквалайзера. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 20.

makeup

Усталюйце зрушэнне макіяжу ў дБ, на якое павялічваецца ўзмацненне эквалайзера. Па змаўчанні - 0. Дазволены дыяпазон ад 0 да 30.

range

Усталюйце максімальна дазволеную колькасць зніжэння/ўзмацнення ў дБ. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 200.

slew

Усталюйце каэфіцыент павароту. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 200.

mode

Задаць рэжым працы фільтра можна адным з наступных варыянтаў:

'listen'

Выводзіць толькі ізаляваны паласавы сігнал.

'cut'

Выразаць частоты вышэй парога выяўлення.

'boost'

Павышэнне частоты ніжэй парога выяўлення.

Рэжым па змаўчанні 'cut'.

tftype

Усталюйце тып мэтавага фільтра, можа быць адным з наступнага:

'bell'
'lowshelf'
'highshelf'

Тып па змаўчанні 'bell'.

8.14.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.15 adynamicsmooth

Прымяніць дынамічнае згладжванне да ўваходнага аўдыёпатоку.

Далей апісваюцца прынятыя варыянты.

sensitivity

Усталюйце ўзровень адчувальнасці да ваганняў частоты. Па змаўчанні 2. Дазволены дыяпазон ад 0 да 1e+06.

basefreq

Усталюйце базавую частату для згладжвання. Значэнне па змаўчанні - 22050. Дазволены дыяпазон ад 2 да 1e+06.

8.15.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.16 aecho

Прымяніць рэха да ўваходнага гуку.

Рэха - гэта адлюстраваны гук і можа ўзнікаць натуральным чынам сярод гор (а часам і вялікіх будынкаў) падчас размовы ці крыку; эфекты лічбавага рэха імітуюць такія паводзіны і часта выкарыстоўваюцца, каб дапамагчы напоўніць гук асобнага інструмента або вакалу. Розніца ў часе паміж зыходным сігналам і адлюстраваннем роўная delay, а гучнасць адлюстраванага сігналу роўная decay. Некалькі рэха можа мець розныя затрымкі і спады.

Далей апісваюцца прынятыя параметры.

in_gain

Задаць уваходнае ўзмацненне адлюстраванага сігналу. Па змаўчанні 0.6.

out_gain

Усталюйце выхадны каэфіцыент узмацнення адлюстраванага сігналу. Па змаўчанні 0.3.

delays

Задаць спіс інтэрвалаў часу ў мілісекундах паміж зыходным сігналам і адлюстраваннямі, падзеленых знакам '|'. Дазволены дыяпазон для кожнага delayз'яўляецца (0 - 90000.0]. Па змаўчанні 1000.

decays

Усталяваць спіс гучнасці адлюстраваных сігналаў, падзеленыя знакам '|'. Дазволены дыяпазон для кожнага decayз'яўляецца (0 - 1.0]. Па змаўчанні 0.5.

8.16.1 Examples

  • Зрабіце так, быццам інструментаў удвая больш, чым грае насамрэч:
    aecho=0.8:0.88:60:0.4
    
  • Калі затрымка вельмі кароткая, гэта гучыць як (металічны) робат, які грае музыку:
    aecho=0.8:0.88:6:0.4
    
  • Большая затрымка будзе гучаць як канцэрт пад адкрытым небам у гарах:
    aecho=0.8:0.9:1000:0.3
    
  • Тое самае, што і вышэй, але з яшчэ адной гарой:
    aecho=0.8:0.9:1000|1800:0.3|0.25
    

8.17 aemphasis

Фільтр акцэнтавання гуку стварае або аднаўляе матэрыял, узяты непасрэдна з пласцінак або кампакт-дыскаў з акцэнтам, з рознымі крывымі фільтра. Напрыклад, для захавання музыкі на вініле сігнал павінен быць спачатку зменены фільтрам, каб ліквідаваць недахопы гэтага носьбіта запісу. Пасля прайгравання матэрыялу неабходна ўжыць зваротны фільтр, каб аднавіць скажэнне частотнай характарыстыкі.

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне.

level_out

Усталюйце ўзмацненне выхаду.

mode

Усталюйце рэжым фільтра. Для аднаўлення матэрыялу выкарыстоўвайце reproductionрэжым, інакш выкарыстоўвайце productionрэжым. Па змаўчанні - reproductionрэжым.

type

Усталюйце тып фільтра. Выбірае сярэдні. Можа быць адно з наступнага:

col

абярыце Columbia.

emi

абярыце EMI.

bsi

абярыце BSI (78RPM).

riaa

абярыце RIAA.

cd

абярыце кампакт-дыск (CD).

50fm

выберыце 50 мкс (FM).

75fm

выберыце 75 мкс (FM).

50kf

выбраць 50 мкс (FM-KF).

75kf

выбраць 75 мкс (FM-KF).

8.17.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.18 aeval

Змяніце гукавы сігнал у адпаведнасці з указанымі выразамі.

Гэты фільтр прымае адзін або некалькі выразаў (па адным для кожнага канала), якія ацэньваюцца і выкарыстоўваюцца для змены адпаведнага гукавога сігналу.

Ён прымае наступныя параметры:

exprs

Усталяваць спіс выразаў, падзеленых '|', для кожнага асобнага канала. Калі колькасць уваходных каналаў большая за колькасць выразаў, для астатніх выходных каналаў выкарыстоўваецца апошні ўказаны выраз.

channel_layout, c

Усталюйце схему выходнага канала. Калі не вызначана, макет канала вызначаецца колькасцю выразаў. Калі ўстаноўлена "same', ён будзе выкарыстоўваць па змаўчанні тую ж схему ўваходнага канала.

Кожны выраз у exprsможа ўтрымліваць наступныя канстанты і функцыі:

ch

нумар канала бягучага выразу

n

нумар ацэненай пробы, пачынаючы з 0

s

частата выбаркі

t

час ацэненага ўзору, выражаны ў секундах

nb_in_channels
nb_out_channels

колькасць уваходных і выходных каналаў

val(CH)

значэнне ўваходнага канала з нумарамCH

Заўвага: гэты фільтр павольны. Для больш хуткай апрацоўкі вы павінны выкарыстоўваць спецыяльны фільтр.

8.18.1 Examples

  • Палова аб'ёму:
    aeval=val(ch)/2:c=same
    
  • Інверсія фазы другога канала:
    aeval=val(0)|-val(1)
    

8.19 aexciter

Узбуджальнік выкарыстоўваецца для атрымання высокага гуку, якога няма ў зыходным сігнале. Гэта робіцца шляхам стварэння гарманічных скажэнняў сігналу, якія абмежаваныя ў дыяпазоне і дадаюцца да зыходнага сігналу. Узбуджальнік павышае верхнюю частку гукавога сігналу без простага павышэння высокіх частот, як гэта зрабіў бы эквалайзер, каб стварыць больш «чысты» або «бліскучы» гук.

Фільтр прымае наступныя параметры:

level_in

Устанавіць уваходны ўзровень перад апрацоўкай сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.

level_out

Устанавіць выхадны ўзровень пасля апрацоўкі сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.

amount

Усталюйце колькасць гармонік, дададзеных да зыходнага сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.

drive

Усталюйце колькасць зноў створаных гармонік. Дазволены дыяпазон ад 0,1 да 10. Значэнне па змаўчанні - 8,5.

blend

Усталюйце актаву зноў створаных гармонік. Дазволены дыяпазон ад -10 да 10. Значэнне па змаўчанні - 0.

freq

Усталюйце ніжнюю мяжу частаты выпрацоўкі гармонік у Гц. Дазволены дыяпазон ад 2000 да 12000 Гц. Па змаўчанні - 7500 Гц.

ceil

Усталюйце верхнюю мяжу частаты выпрацоўкі гармонік. Дазволены дыяпазон ад 9999 да 20000 Гц. Калі значэнне ніжэй за 10000 Гц, абмежаванне не прымяняецца.

listen

Прыглушыць зыходны сігнал і выводзіць толькі дададзеныя гармонікі. Па змаўчанні адключана.

8.19.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.20 afade

Прымяненне эфекту знікнення/зніжэння да ўваходнага гуку.

Далей апісваюцца прынятыя параметры.

type, t

Укажыце тып эфекту, можа быць альбо inдля эфекту знікнення, альбо outдля эфекту знікнення. Па змаўчанні in.

start_sample, ss

Укажыце нумар пачатковага ўзору для пачатку прымянення эфекту знікнення. Па змаўчанні 0.

nb_samples, ns

Укажыце колькасць узораў, для якіх павінен працягвацца эфект знікнення. У канцы эфекту знікнення гучнасць выхаднога гуку будзе такой жа гучнасці, як і уваходнага аўдыё, у канцы пераходу знікнення гук будзе маўчаць. Па змаўчанні 44100.

start_time, st

Укажыце час пачатку эфекту знікнення. Па змаўчанні 0. Значэнне павінна быць указана як працягласць часу; гл. (ffmpeg-utils) раздзел Працягласць часу ў кіраўніцтве ffmpeg-utils(1) , каб даведацца пра прыняты сінтаксіс. Калі ўсталяваны, гэты параметр выкарыстоўваецца замест start_sample.

duration, d

Укажыце працягласць эфекту знікнення. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . У канцы эфекту знікнення гучнасць выхаднога гуку будзе такой жа гучнасці, як і уваходнага аўдыё, у канцы пераходу знікнення гук будзе маўчаць. Па змаўчанні працягласць вызначаецца nb_samples. Калі ўсталяваны, гэты параметр выкарыстоўваецца замест nb_samples.

curve

Усталюйце крывую для знікнення.

Ён прымае наступныя значэнні:

tri

выбраць трохкутны, лінейны нахіл (па змаўчанні)

qsin

выбраць чвэрць сінусоіды

hsin

выбраць палову сінусоіды

esin

выбраць экспанентную сінусоіду

log

выбраць лагарыфмічны

ipar

выбраць перавернутую парабалу

qua

выбраць квадратычны

cub

выбраць куб

squ

выбраць квадратны корань

cbr

выбраць кубічны корань

par

выбраць парабалу

exp

выбраць экспанентны

iqsin

выбраць перавернутую чвэрць сінусоіды

ihsin

выбраць інвертаваную палову сінусоіды

dese

выберыце двухэкспанентнае месца

desi

выбраць двухэкспанентны сігмаід

losi

выбраць лагістычную сігмаід

sinc

выбраць кардынальную сінусную функцыю

isinc

выбраць функцыю перавернутага сінуса

nofade

знікненне не прымяняецца

8.20.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.20.2 Examples

  • Затуханне ў першыя 15 секунд аўдыя:
    afade=t=in:ss=0:d=15
    
  • Згасанне апошніх 25 секунд з 900 секунд аўдыя:
    afade=t=out:st=875:d=25
    

8.21 afftdn

Знішчэнне гуку ўзораў з БПФ.

Далей апісваюцца прынятыя параметры.

noise_reduction, nr

Усталюйце зніжэнне шуму ў дБ, дазволены дыяпазон ад 0,01 да 97. Значэнне па змаўчанні - 12 дБ.

noise_floor, nf

Усталюйце ўзровень шуму ў дБ, дазволены дыяпазон ад -80 да -20. Значэнне па змаўчанні -50 дБ.

noise_type, nt

Усталюйце тып шуму.

Ён прымае наступныя значэнні:

white, w

Выберыце белы шум.

vinyl, v

Выберыце вінілавы шум.

shellac, s

Выберыце шум шеллака.

custom, c

Выберыце карыстальніцкі шум, вызначаны ў bnопцыі.

Значэнне па змаўчанні - белы шум.

band_noise, bn

Усталюйце карыстальніцкі шумавы профіль дыяпазону для кожнага з 15 дыяпазонаў. Паласы падзяляюцца знакамі « » або «|».

residual_floor, rf

Усталюйце рэшткавы падлогу ў дБ, дазволены дыяпазон ад -80 да -20. Значэнне па змаўчанні -38 дБ.

track_noise, tn

Уключыць адсочванне ўзроўню шуму. Па змаўчанні адключана. Калі гэта ўключана, мінімальны ўзровень шуму рэгулюецца аўтаматычна.

track_residual, tr

Уключыць рэшткавае адсочванне. Па змаўчанні адключана.

output_mode, om

Усталюйце рэжым вываду.

Ён прымае наступныя значэнні:

input, i

Увод пропуску без зменаў.

output, o

Прахадны шум адфільтраваны.

noise, n

Прапускаюць толькі шум.

Значэнне па змаўчанні - output.

adaptivity, ad

Усталюйце каэфіцыент адаптацыі, які выкарыстоўваецца для адаптацыі карэкціровак узмацнення для кожнага дыяпазону частот. Значэнне 0забяспечвае імгненную адаптацыю, у той час як больш высокія значэнні рэагуюць значна павольней. Дазволены дыяпазон ад 0да 1. Значэнне па змаўчанні - 0.5.

floor_offset, fo

Усталюйце каэфіцыент зрушэння ўзроўню шуму. Гэты параметр выкарыстоўваецца для рэгулявання зрушэння, прымененага да вымеранага ўзроўню шуму. Ён эфектыўны, толькі калі ўключана адсочванне ўзроўню шуму. Дазволены дыяпазон ад -2.0да 2.0. Значэнне па змаўчанні - 1.0.

noise_link, nl

Усталюйце шумавую сувязь, якая выкарыстоўваецца для шматканальнага гуку.

Ён прымае наступныя значэнні:

none

Выкарыстоўвайце нязменны ўзровень шуму канала.

min

Выкарыстоўвайце вымераны мінімальны ўзровень шуму ўсіх каналаў.

max

Выкарыстоўвайце вымераны максімальны ўзровень шуму ўсіх каналаў.

average

Выкарыстоўвайце вымераны сярэдні ўзровень шуму ўсіх каналаў.

Значэнне па змаўчанні - min.

band_multiplier, bm

Устанавіць каэфіцыент множання дыяпазону, які выкарыстоўваецца для размеркавання дыяпазонаў па дыяпазонах частот. Дазволены дыяпазон ад 0.2да 5. Значэнне па змаўчанні - 1.25.

sample_noise, sn

Пераключыць захоп і вымярэнне профілю шуму ад уваходнага аўдыя.

Ён прымае наступныя значэнні:

start, begin

Пачаць захоп узору шуму.

stop, end

Спыніць захоп узору шуму і вымераць новы профіль паласы шуму.

Значэнне па змаўчанні - none.

gain_smooth, gs

Задаць плыўны прасторавы радыус каэфіцыента ўзмацнення, які выкарыстоўваецца для згладжвання каэфіцыента ўзмацнення, прымененага да кожнага дыяпазону частот. Карысна для памяншэння выпадковых музычных шумавых артэфактаў. Больш высокія значэнні павялічваюць згладжванне прыбытку. Дазволены дыяпазон ад 0да 50. Значэнне па змаўчанні - 0.

8.21.1 Commands

Гэты фільтр падтрымлівае некаторыя вышэйзгаданыя параметры ў якасці каманд .

8.21.2 Examples

  • Паменшыце белы шум на 10 дБ і выкарыстоўвайце раней вымераны ўзровень шуму -40 дБ:
    afftdn=nr=10:nf=-40
    
  • Паменшыце ўзровень белага шуму на 10 дБ, таксама ўсталюйце пачатковы ўзровень шуму на -80 дБ і ўключыце аўтаматычнае адсочванне ўзроўню шуму, так што ўзровень шуму будзе паступова змяняцца падчас апрацоўкі:
    afftdn=nr=10:nf=-80:tn=1
    
  • Паменшыце ўзровень шуму на 20 дБ, выкарыстоўваючы ўзровень шуму -40 дБ і выкарыстоўваючы каманды для атрымання шумавога профілю першых 0,4 секунды ўваходнага гуку:
    asendcmd=0.0 afftdn sn start,asendcmd=0.4 afftdn sn stop,afftdn=nr=20:nf=-40
    

8.22 afftfilt

Прымяненне адвольных выразаў да ўзораў у частотнай вобласці.

real

Усталюйце рэальны выраз у частотнай вобласці для кожнага асобнага канала, падзелены знакам '|'. Па змаўчанні - "re". Калі колькасць уваходных каналаў большая за колькасць выразаў, для астатніх выходных каналаў выкарыстоўваецца апошні ўказаны выраз.

imag

Усталюйце ўяўны выраз у частотнай вобласці для кожнага асобнага канала, падзелены знакам '|'. Па змаўчанні "im".

Кожны выраз у realі imagможа ўтрымліваць наступныя канстанты і функцыі:

sr

частата выбаркі

b

нумар бягучай частаты

nb

колькасць даступных бункераў

ch

нумар канала бягучага выразу

chs

колькасць каналаў

pts

бягучы кадр ач

re

бягучая сапраўдная частка частаты бягучага канала

im

бягучая ўяўная частка дыяпазону частот бягучага канала

real(b, ch)

Вяртае значэнне рэальнай часткі дыяпазону частот у месцы ( bin, channel)

imag(b, ch)

Вярнуць значэнне ўяўнай часткі дыяпазону частот у месцы ( bin, channel)

win_size

Усталюйце памер акна. Дазволены дыяпазон ад 16 да 131072. Значэнне па змаўчанні4096

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann, hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Па змаўчанні hann.

overlap

Усталюйце перакрыцце вокнаў. Калі ўстаноўлена значэнне 1, будзе выбрана рэкамендаванае перакрыцце для выбранай функцыі акна. Па змаўчанні 0.75.

8.22.1 Examples

  • Пакіньце ў гуку амаль толькі нізкія частоты:
    afftfilt="'real=re * (1-clip((b/nb)*b,0,1))':imag='im * (1-clip((b/nb)*b,0,1))'"
    
  • Прымяніць эфект рабатызацыі:
    afftfilt="real='hypot(re,im)*sin(0)':imag='hypot(re,im)*cos(0)':win_size=512:overlap=0.75"
    
  • Прымяніць эфект шэпту:
    afftfilt="real='hypot(re,im)*cos((random(0)*2-1)*2*3.14)':imag='hypot(re,im)*sin((random(1)*2-1)*2*3.14)':win_size=128:overlap=0.8"
    

8.23 afir

Прымяніць адвольны фільтр канчатковай імпульснай характарыстыкі.

Гэты фільтр прызначаны для прымянення доўгіх FIR-фільтраў, працягласцю да 60 секунд.

Ён можа быць выкарыстаны ў якасці кампанента для лічбавых кросоверных фільтраў, эквалайзера пакоя, адмены перакрыжаваных перамоў, сінтэзу хвалевага поля, аўралізацыі, амбіяфонікі, амбіафонікі і прасторавасці.

Гэты фільтр выкарыстоўвае патокі, вышэйшыя за першы, у якасці каэфіцыентаў FIR. Калі не першы паток змяшчае адзін канал, ён будзе выкарыстоўвацца для ўсіх уваходных каналаў у першым патоку, інакш колькасць каналаў у не першым патоку павінна быць такой жа, як колькасць каналаў у першым патоку.

Ён прымае наступныя параметры:

dry

Усталюйце сухое ўзмацненне. Гэта задае ўзмацненне ўваходнага сігналу.

wet

Усталюйце мокры ўзмацненне. Гэта задае канчатковае ўзмацненне выхаду.

length

Усталюйце даўжыню фільтра імпульснай характарыстыкі. Па змаўчанні 1, што азначае, што апрацоўваецца ўвесь ВК.

gtype

Уключыць прымяненне ўзмацнення, вымеранага ад магутнасці ВК.

Вызначце, які падыход выкарыстоўваць для аўтаматычнага вымярэння ўзмацнення.

none

Не ўжывайце ніякага ўзмацнення.

peak

выбраць пікавы ўзмацненне, вельмі кансерватыўны падыход. Гэта значэнне па змаўчанні.

dc

выбраць узмацненне пастаяннага току, абмежаванае прымяненне.

gn

абярыце падыход узмацнення да шуму, гэта самы папулярны.

irgain

Усталюйце ўзмацненне, якое будзе прымяняцца да ВК-каэфіцыентаў перад фільтраваннем. Дазволены дыяпазон ад 0 да 1. Гэты ўзмацненне прымяняецца пасля любога ўзмацнення, прымененага з gtypeопцыяй.

irfmt

Задаць фармат ВК-струменю. Можа быць monoабо input. Па змаўчанні input.

maxir

Усталюйце максімальна дазволеную працягласць фільтра імпульснай характарыстыкі ў секундах. Па змаўчанні 30 секунд. Дазволены дыяпазон ад 0,1 да 60 секунд.

response

Паказваць ІЧ-частотную характарыстыку, велічыню (пурпурны), фазу (зялёны) і групавую затрымку (жоўты) у дадатковым відэапатоку. Па змаўчанні ён адключаны.

channel

Усталюйце, для якога ІЧ-канала адлюстроўваць АЧХ. Па змаўчанні адлюстроўваецца першы канал. Гэты параметр выкарыстоўваецца, толькі калі responseён уключаны.

size

Усталюйце памер відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі responseён уключаны.

rate

Задаць частату кадраў відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі responseён уключаны.

minp

Усталюйце мінімальны памер падзелу для згортвання. Па змаўчанні 8192. Дазволены дыяпазон ад 1да 32768. Больш нізкія значэнні памяншаюць затрымку за кошт большага выкарыстання працэсара.

maxp

Устанавіць максімальны памер падзелу для згортвання. Па змаўчанні 8192. Дазволены дыяпазон ад 8да 32768. Больш нізкія значэнні могуць павялічыць загрузку працэсара.

nbirs

Задайце колькасць патокаў уваходных імпульсных адказаў, якія можна будзе пераключаць падчас выканання. Дазволены дыяпазон ад 1да 32. Па змаўчанні 1.

ir

Усталяваны ВК-паток, які будзе выкарыстоўвацца для згортвання, пачынаючы з 0, заўсёды павінен быць ніжэйшым за пастаўленае значэнне па nbirsопцыі. Па змаўчанні 0. Гэты параметр можна змяніць падчас выканання з дапамогай каманд .

precision

Усталюйце, якую дакладнасць выкарыстоўваць пры апрацоўцы ўзораў.

auto

Аўтаматычны выбар унутранага фармату выбаркі ў залежнасці ад іншых фільтраў.

float

Заўсёды выкарыстоўвайце фармат выбаркі з адной плаваючай кропкай.

double

Заўсёды выкарыстоўвайце фармат выбаркі з падвойнай плаваючай кропкай.

Значэнне па змаўчанні - аўтаматычна.

8.23.1 Examples

  • Прымяніць рэверберацыю да патоку з выкарыстаннем мона-ВК-файла ў якасці другога ўводу, завяршыць каманду з дапамогай ffmpeg:
    ffmpeg -i input.wav -i middle_tunnel_1way_mono.wav -lavfi afir output.wav
    

8.24 aformat

Усталюйце абмежаванні фармату вываду для ўваходнага гуку. Структура будзе ўзгадняць найбольш прыдатны фармат для мінімізацыі пераўтварэнняў.

Ён прымае наступныя параметры:

sample_fmts, f

Спіс запытаных узораў фарматаў, падзелены '|'.

sample_rates, r

Спіс запытаных частот дыскрэтызацыі, падзелены '|'.

channel_layouts, cl

Спіс запытаных макетаў каналаў, падзелены '|'.

Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .

Калі параметр апушчаны, дазволены ўсе значэнні.

Прымусіць на вывадзе або беззнакавы 8-бітны, або са знакам 16-бітны стэрэа

aformat=sample_fmts=u8|s16:channel_layouts=stereo

8.25 afreqshift

Прымяніць частотны зрух да ўваходных аўдыясэмплаў.

Фільтр прымае наступныя параметры:

shift

Укажыце зрух частоты. Дазволены дыяпазон ад -INT_MAX да INT_MAX. Значэнне па змаўчанні 0,0.

level

Задаць узмацненне выхаду, прымененае да канчатковага выхаду. Дазволены дыяпазон ад 0,0 да 1,0. Значэнне па змаўчанні 1,0.

order

Устанавіць парадак фільтрацыі, які выкарыстоўваецца для фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 8.

8.25.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.26 afwtdn

Паменшыце шырокапалосны шум ад уваходных выбарак з дапамогай Wavelets.

Далей апісваюцца прынятыя варыянты.

sigma

Усталюйце сігму шуму, дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні роўна 0. Гэты параметр кантралюе інтэнсіўнасць шумашумлення, прымененага да ўваходных выбарак. Самы карысны спосаб усталяваць гэтую опцыю праз дэцыбелы, напрыклад. -45 дБ.

levels

Усталюйце колькасць вейвлет-узроўняў разлажэння. Дазволены дыяпазон ад 1 да 12. Значэнне па змаўчанні - 10. Усталяванне занадта нізкага значэння робіць прадукцыйнасць шумашумлення вельмі нізкай.

wavet

Усталюйце тып вейвлета для дэкампазіцыі ўваходнага кадра. Яны адсартаваны па колькасці каэфіцыентаў, ад самага нізкага да высокага. Больш каэфіцыентаў азначае горшую хуткасць фільтрацыі, але ў цэлым лепшую якасць. Даступныя вэйвлеты:

'sym2'
'sym4'
'rbior68'
'deb10'
'sym10'
'coif5'
'bl3'
percent

Усталюйце працэнт поўнага выдалення шумоў. Дазволены дыяпазон ад 0 да 100 працэнтаў. Значэнне па змаўчанні - 85 працэнтаў або частковае выдаленне шуму.

profile

Калі ўключана, першы ўваходны кадр будзе выкарыстоўвацца як профіль шуму. Калі першыя ўзоры кадраў утрымліваюць бясшумныя паказчыкі, прадукцыйнасць будзе вельмі нізкай.

adaptive

Калі ўключана, уваходныя кадры аналізуюцца на наяўнасць шуму. Калі шум выяўлены з высокай верагоднасцю, то профіль уваходнага кадра будзе выкарыстоўвацца для апрацоўкі наступных кадраў, пакуль не будзе выяўлены новы шумавы кадр.

samples

Задайце памер аднаго кадра ў колькасці выбарак. Дазволены дыяпазон ад 512 да 65536. Памер кадра па змаўчанні - 8192 выбаркі.

softness

Усталяваць мяккасць унутры функцыі парогаў. Дазволены дыяпазон ад 0 да 10. Мяккасць па змаўчанні - 1.

8.26.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.27 agate

Гейт у асноўным выкарыстоўваецца для памяншэння ніжніх частак сігналу. Такая апрацоўка сігналу памяншае трывожны шум паміж карыснымі сігналамі.

Стробаванне ажыццяўляецца шляхам выяўлення гучнасці ніжэй за абраны ўзровень threshold і дзялення яго на каэфіцыент, зададзены з дапамогай ratio. Ніжняя частка ўзроўню шуму задаецца праз range. Паколькі дакладная маніпуляцыя сігналам прывядзе да скажэння формы сігналу, памяншэнне можа быць выраўнавана з часам. Гэта робіцца шляхам усталявання attackі release.

attackвызначае, як доўга сігнал павінен апусціцца ніжэй парогавага значэння, перш чым адбудзецца якое-небудзь зніжэнне, і releaseзадае час, на працягу якога сігнал павінен падняцца вышэй парогавага значэння, каб зноў паменшыць зніжэнне. Больш кароткія сігналы, чым выбраны час атакі, застануцца некранутымі.

level_in

Усталюйце ўваходны ўзровень перад фільтрацыяй. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.

mode

Усталюйце рэжым працы. Можа быць upwardабо downward. Па змаўчанні downward. Калі ўсталяваны upwardрэжым, больш высокія часткі сігналу будуць узмацняцца, пашыраючы дынамічны дыяпазон уверх. У адваротным выпадку ў выпадку downwardніжніх частак сігнал будзе зніжаны.

range

Усталюйце ўзровень зніжэння ўзмацнення, калі сігнал ніжэйшы за парог. Па змаўчанні 0,06125. Дазволены дыяпазон ад 0 да 1. Усталёўка гэтага значэння ў 0 адключае скарачэнне, а затым фільтр паводзіць сябе як пашыральнік.

threshold

Калі сігнал падымаецца вышэй за гэты ўзровень, зніжэнне ўзмацнення адключаецца. Па змаўчанні 0,125. Дазволены дыяпазон ад 0 да 1.

ratio

Усталюйце каэфіцыент паніжэння сігналу. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 9000.

attack

Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым зніжэнне ўзмацнення спыніцца. Па змаўчанні 20 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.

release

Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў павялічыцца. Па змаўчанні 250 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.

makeup

Задаць велічыню ўзмацнення сігналу пасля апрацоўкі. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64.

knee

Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,828427125. Дазволены дыяпазон ад 1 да 8.

detection

Выберыце, ці трэба браць для выяўлення дакладны сігнал ці падобны да RMS. Па змаўчанні rms. Можа быць peakабо rms.

link

Выберыце, калі сярэдні ўзровень паміж усімі каналамі ці больш гучны канал уплывае на зніжэнне. Па змаўчанні average. Можа быць averageабо maximum.

8.27.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.28 aiir

Прымяніць адвольны фільтр бясконцай імпульснай характарыстыкі.

Ён прымае наступныя параметры:

zeros, z

Усталюйце B/лічнік/нулі/каэфіцыенты адлюстравання.

poles, p

Усталюйце каэфіцыенты A/назоўнік/полюсы/лесвіцы.

gains, k

Усталюйце ўзмацненне каналаў.

dry_gain

Задаць уваходнае ўзмацненне.

wet_gain

Усталюйце ўзмацненне выхаду.

format, f

Задаць фармат каэфіцыентаў.

'll'

рашотка-лесвічная функцыя

'sf'

аналагавая перадаткавая функцыя

'tf'

функцыя лічбавай перадачы

'zp'

Нулі/полюсы Z-плоскасці, дэкартавы (па змаўчанні)

'pr'

Нулі/полюсы плоскасці Z, палярныя радыяны

'pd'

Нулі/полюсы Z-плоскасці, палярныя градусы

'sp'

Нулі/полюсы S-плоскасці

process, r

Задаць тып апрацоўкі.

'd'

прамая апрацоўка

's'

серыйная апрацоўка

'p'

паралельная апрацоўка

precision, e

Усталюйце дакладнасць фільтрацыі.

'dbl'

з плаваючай кропкай падвойнай дакладнасці (па змаўчанні)

'flt'

з плаваючай кропкай адзінарнай дакладнасці

'i32'

32-бітныя цэлыя лікі

'i16'

16-бітныя цэлыя лікі

normalize, n

Нармалізацыя каэфіцыентаў фільтра, па змаўчанні ўключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

mix

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

response

Паказваць ІЧ-частотную характарыстыку, велічыню (пурпурны), фазу (зялёны) і групавую затрымку (жоўты) у дадатковым відэапатоку. Па змаўчанні ён адключаны.

channel

Усталюйце, для якога ІЧ-канала адлюстроўваць АЧХ. Па змаўчанні адлюстроўваецца першы канал. Гэты параметр выкарыстоўваецца, толькі калі responseён уключаны.

size

Усталюйце памер відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі responseён уключаны.

Каэфіцыенты ў tfі sfфармат падзеленыя прабеламі і размешчаны ў парадку ўзрастання.

Каэфіцыенты ў zpфармаце падзяляюцца прабеламі, і парадак каэфіцыентаў не мае значэння. Каэфіцыенты ў zpфармаце ўяўляюць сабой камплексныя лікі з i уяўнай адзінкай.

Для кожнага канала можна задаць розныя каэфіцыенты і ўзмацненні, у такім выпадку выкарыстоўвайце '|' каб падзяліць каэфіцыенты або выгады. Апошнія прадстаўленыя каэфіцыенты будуць выкарыстоўвацца для ўсіх астатніх каналаў.

8.28.1 Examples

  • Прымяніце 2-полюсную эліптычную выемку каля 5000 Гц для частаты дыскрэтызацыі 48000 Гц:
    aiir=k=1:z=7.957584807809675810E-1 -2.575128568908332300 3.674839853930788710 -2.57512875289799137 7.957586296317130880E-1:p=1 -2.86950072432325953 3.63022088054647218 -2.28075678147272232 6.361362326477423500E-1:f=tf:r=d
    
  • Тое самае, што і вышэй, але ў zpфармаце:
    aiir=k=0.79575848078096756:z=0.80918701+0.58773007i 0.80918701-0.58773007i 0.80884700+0.58784055i 0.80884700-0.58784055i:p=0.63892345+0.59951235i 0.63892345-0.59951235i 0.79582691+0.44198673i 0.79582691-0.44198673i:f=zp:r=s
    
  • Прымяніць аналагавы нармалізаваны фільтр нізкіх частот Батэрворта 3-га парадку з выкарыстаннем аналагавага фармату функцыі перадачы:
    aiir=z=1.3057 0 0 0:p=1.3057 2.3892 2.1860 1:f=sf:r=d
    

8.29 alimiter

Абмежавальнік прадухіляе перавышэнне патрэбнага парога ўваходнага сігналу. Гэты абмежавальнік выкарыстоўвае тэхналогію прагляду наперад, каб прадухіліць скажэнне вашага сігналу. Гэта азначае, што ёсць невялікая затрымка пасля апрацоўкі сігналу. Майце на ўвазе, што затрымка, якую ён стварае, - гэта ўсталяваны вамі час атакі.

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні 1.

level_out

Усталюйце ўзмацненне выхаду. Па змаўчанні 1.

limit

Не дазваляйце сігналам вышэй за гэты ўзровень праходзіць праз абмежавальнік. Па змаўчанні 1.

attack

Абмежавальнік дасягне свайго ўзроўню згасання за гэты прамежак часу ў мілісекундах. Па змаўчанні 5 мілісекунд.

release

Вярніцеся ад абмежавання да аслаблення 1,0 за гэтую колькасць мілісекунд. Па змаўчанні 50 мілісекунд.

asc

Калі памяншэнне ўзмацнення заўсёды неабходна, ASC клапоціцца аб выпуску да сярэдняга ўзроўню зніжэння, а не аб дасягненні памяншэння 0 падчас вызвалення.

asc_level

Выберыце, наколькі на час выпуску ўплывае ASC, 0 азначае амаль адсутнасць змен у часе выпуску, а 1 забяспечвае большы час выпуску.

level

Аўтаматычны ўзровень выхаднога сігналу. Па змаўчанні ўключана. Гэта нармалізуе гук да 0 дБ, калі ўключана.

latency

Кампенсуйце ўнесеную затрымку з дапамогай буфера прагляду, набору з параметрам атакі. Таксама ачысціце сапраўдныя аўдыядадзеныя ў буферы прагляду, калі паток трапляе ў EOF.

У залежнасці ад выбранай налады, перад прымяненнем гэтага фільтра рэкамендуецца павялічваць уваход у 2 ці 4 разы з дапамогай aresample .

8.30 allpass

Прымяненне двухполюснага ўсепраходнага фільтра з цэнтральнай частатой (у Гц) frequencyі шырынёй фільтра width. Усепраходны фільтр змяняе суадносіны частоты і фазы гуку, не змяняючы суадносін частоты і амплітуды.

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце частату ў Гц.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

order, o

Усталюйце парадак фільтраў, можа быць 1 або 2. Па змаўчанні 2.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

8.30.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць частату ўсіх пасоў. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць allpass width_type. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню ўсіх праходаў. Сінтаксіс каманды: " width"

mix, m

Змяніць мікс allpass. Сінтаксіс каманды: " mix"

8.31 aloop

Зацыкленыя аўдыё ўзоры.

Фільтр прымае наступныя параметры:

loop

Усталюйце колькасць завес. Усталяванне гэтага значэння ў -1 прывядзе да бясконцых цыклаў. Па змаўчанні 0.

size

Усталюйце максімальную колькасць узораў. Па змаўчанні 0.

start

Усталюйце першы ўзор цыкла. Па змаўчанні 0.

8.32 amerge

Аб'яднайце два ці больш аўдыяпатокаў у адзін шматканальны паток.

Фільтр прымае наступныя параметры:

inputs

Усталюйце колькасць уваходаў. Па змаўчанні 2.

Калі размяшчэнне каналаў уваходаў не перасякаецца і, такім чынам, сумяшчальна, размяшчэнне каналаў выхаду будзе ўстаноўлена адпаведным чынам, і парадак каналаў будзе зменены па меры неабходнасці. Калі размяшчэнне каналаў уваходаў не перасякаецца, на выхадзе будуць усе каналы першага ўваходу, затым усе каналы другога ўваходу ў такім парадку, а размяшчэнне каналаў на выхадзе будзе значэннем па змаўчанні, якое адпавядае агульная колькасць каналаў.

Напрыклад, калі першы ўваход знаходзіцца ў 2.1 (FL+FR+LF), а другі ўваход FC+BL+BR, то выхад будзе ў 5.1 з каналамі ў наступным парадку: a1, a2, b1, a3, b2, b3 (a1 - першы канал першага ўваходу, b1 - першы канал другога ўваходу).

З іншага боку, калі абодва ўваходныя сігналы знаходзяцца ў стэрэа, выходныя каналы будуць у парадку па змаўчанні: a1, a2, b1, b2, а размяшчэнне каналаў будзе адвольна ўстаноўлена на 4.0, што можа быць ці не быць чаканым значэннем .

Усе ўваходныя дадзеныя павінны мець аднолькавую частату дыскрэтызацыі і фармат.

Калі ўваходы не маюць аднолькавай працягласці, выхад спыніцца на самым кароткім.

8.32.1 Examples

  • Аб'яднаць два монафайла ў стэрэаструмень:
    amovie=left.wav [l] ; amovie=right.mp3 [r] ; [l] [r] amerge
    
  • Некалькі аб'яднанняў пры ўмове ўваходжання 1 відэапатоку і 6 аўдыяпатокаўinput.mkv:
    ffmpeg -i input.mkv -filter_complex "[0:1][0:2][0:3][0:4][0:5][0:6] amerge=inputs=6" -c:a pcm_s16le output.mkv
    

8.33 amix

Змешвае некалькі аўдыяўваходаў у адзін выхад.

Звярніце ўвагу, што гэты фільтр падтрымлівае толькі плаваючыя сэмплы ( фільтры amerge і panаўдыяфільтры падтрымліваюць шмат фарматаў). Калі amix ўвод змяшчае цэлыя выбаркі, aresample будзе аўтаматычна ўстаўлены для выканання пераўтварэння ў выбаркі з плаваючай колькасцю.

Напрыклад

ffmpeg -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex amix=inputs=3:duration=first:dropout_transition=3 OUTPUT

будзе змешваць 3 ўваходныя аўдыёпатокі ў адзін выхад з той жа працягласцю, што і першы ўваход, і час пераходу адключэння 3 секунды.

Ён прымае наступныя параметры:

inputs

Колькасць уваходаў. Калі не пазначана, па змаўчанні 2.

duration

Як вызначыць канец патоку.

longest

Працягласць самага доўгага ўводу. (па змаўчанні)

shortest

Працягласць самага кароткага ўводу.

first

Працягласць першага ўваходу.

dropout_transition

Час пераходу ў секундах для перанармалізацыі гучнасці, калі заканчваецца ўваходны паток. Значэнне па змаўчанні - 2 секунды.

weights

Укажыце вагу кожнага ўваходнага аўдыёпатоку як паслядоўнасць. Кожная вага аддзяляецца прабелам. Па змаўчанні ўсе ўваходы маюць аднолькавую вагу.

normalize

Заўсёды маштабуйце ўваходныя дадзеныя, а не толькі падсумоўвайце выбаркі. Сцеражыцеся моцнага адсячэння, калі ўваходныя дадзеныя не нармалізуюцца да або пасля фільтрацыі гэтым фільтрам, калі гэты параметр адключаны. Па змаўчанні ўключана.

8.33.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

weights
normalize

Сінтаксіс той жа, што і варыянт з такой жа назвай.

8.34 amultiply

Памножце першы аўдыяпаток на другі і захавайце вынік у выхадным аўдыяпатоку. Памнажэнне ажыццяўляецца шляхам памнажэння кожнага ўзору з першага патоку на ўзор у той жа пазіцыі з другога патоку.

З дапамогай гэтага паэлементнага множання можна ствараць замірання амплітуды і мадуляцыі амплітуды.

8.35 anequalizer

Параметрычны шматпалосны эквалайзер высокага парадку для кожнага канала.

Ён прымае наступныя параметры:

params

Гэты радок параметраў мае фармат: "c chnf= cfw= wg= gt= f| ..." Кожная паласа эквалайзера аддзяляецца знакам '|'.

chn

Усталюйце нумар канала, да якога будзе прымяняцца эквалайзер. Калі ўваход не мае гэтага канала, запіс ігнаруецца.

f

Усталюйце цэнтральную частату для дыяпазону. Калі ўвод не мае такой частаты, запіс ігнаруецца.

w

Задаць шырыню дыяпазону ў герцах.

g

Усталюйце ўзмацненне дыяпазону ў дБ.

t

Задаць тып фільтра для дыяпазону, неабавязкова, можа быць:

'0'

Батэрворт, гэта стандартна.

'1'

Чэбышава тып 1.

'2'

Чэбышава тып 2.

curves

Пры гэтай опцыі актываваная АЧХ анэквалайзера адлюстроўваецца ў відэаструмені.

size

Усталюйце памер відэаструменю. Карысна толькі ў тым выпадку, калі ўключана опцыя крывых.

mgain

Усталюйце максімальнае ўзмацненне, якое будзе адлюстроўвацца. Карысна толькі ў тым выпадку, калі ўключана опцыя крывых. Усталяванне разумнага значэння дазваляе адлюстраваць узмацненне, якое атрымліваецца ад суседніх дыяпазонаў, якія знаходзяцца занадта блізка адзін да аднаго, і, такім чынам, стварае большы ўзмацненне, калі абодва актываваны.

fscale

Задаць частотную шкалу, якая выкарыстоўваецца для малявання частотнай характарыстыкі ў відэавывадзе. Можа быць лінейным або лагарыфмічным. Па змаўчанні - лагарыфмічны.

colors

Усталюйце колер для кожнай крывой канала, якая будзе адлюстроўвацца ў відэаструмені. Гэта спіс назваў колераў, падзеленых прабелам або знакам '|'. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.

8.35.1 Examples

  • Знізіце ўзмацненне на 10 цэнтральнай частаты 200 Гц і шырыні 100 Гц для першых 2 каналаў з выкарыстаннем фільтра Чэбышава тыпу 1:
    anequalizer=c0 f=200 w=100 g=-10 t=1|c1 f=200 w=100 g=-10 t=1
    

8.35.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

change

Змяніць існуючыя параметры фільтра. Сінтаксіс для каманд: " fN|f= freq|w= width|g= gain"

fNнумар існуючага фільтра, пачынаючы з 0, калі такі фільтр недаступны, вяртаецца памылка. freqўсталяваць новы параметр частоты. widthўсталяваць новы параметр шырыні ў Герцах. gainўсталяваць новы параметр узмацнення ў дБ.

Поўны выклік фільтра з asendcmd можа выглядаць так: asendcmd=c='4.0 anequalizer change 0|f=200|w=50|g=1',anequalizer=...

8.36 anlmdn

Паменшыце шырокапалосны шум у аўдыясэмплах з дапамогай алгарытму нелакальных сродкаў.

Кожны ўзор карэктуецца шляхам пошуку іншых узораў з аналагічным кантэкстам. Гэта падабенства кантэксту вызначаецца шляхам параўнання навакольных іх участкаў памеру p. Латы шукаюць у раёне вrвакол ўзору.

Фільтр прымае наступныя параметры:

strength, s

Усталюйце сілу шумашумлення. Дазволены дыяпазон ад 0,00001 да 10000. Значэнне па змаўчанні - 0,00001.

patch, p

Задаць працягласць радыусу патча. Дазволены дыяпазон ад 1 да 100 мілісекунд. Значэнне па змаўчанні - 2 мілісекунды.

research, r

Задаць працягласць радыусу даследавання. Дазволены дыяпазон ад 2 да 300 мілісекунд. Значэнне па змаўчанні - 6 мілісекунд.

output, o

Усталюйце рэжым вываду.

Ён прымае наступныя значэнні:

i

Увод пропуску без зменаў.

o

Прахадны шум адфільтраваны.

n

Прапускаюць толькі шум.

Значэнне па змаўчанні - o.

smooth, m

Усталюйце каэфіцыент згладжвання. Значэнне па змаўчанні - 11. Дазволены дыяпазон ад 1да 1000.

8.36.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.37 anlmf, anlms

Прымяніць алгарытм нармалізаванага найменшага сярэдняга-(квадраты|чацвёрты) да першага аўдыяпатоку з выкарыстаннем другога аўдыяпатоку.

Гэты адаптыўны фільтр выкарыстоўваецца для імітацыі жаданага фільтра шляхам вызначэння каэфіцыентаў фільтра, якія адносяцца да атрымання найменшага сярэдняга квадрата сігналу памылкі (розніца паміж жаданым, 2-м уваходным аўдыяпатокам, і фактычным сігналам, 1-м уваходным аўдыяпатокам).

Далей апісваюцца прынятыя варыянты.

order

Усталяваць парадак фільтраў.

mu

Усталюйце фільтр mu.

eps

Ўсталяваць фільтр eps.

leakage

Усталюйце ўцечку фільтра.

out_mode

Ён прымае наступныя значэнні:

i

Прайсці 1-ы ўваход.

d

Прайдзіце 2-і ўваход.

o

Перадайце адфільтраваныя ўзоры.

n

Розніца ў перадачы жаданых і адфільтраваных узораў.

Значэнне па змаўчанні - o.

8.37.1 Examples

  • Адным з многіх варыянтаў выкарыстання гэтага фільтра з'яўляецца памяншэнне шуму, уваходны аўдыё фільтруецца з аднолькавымі выбаркамі, якія затрымліваюцца на фіксаваную велічыню, адзін з такіх прыкладаў для стэрэааўдыя:
    asplit[a][b],[a]adelay=32S|32S[a],[b][a]anlms=order=128:leakage=0.0005:mu=.5:out_mode=o
    

8.37.2 Commands

Гэты фільтр падтрымлівае тыя ж каманды, што і параметры, за выключэннем параметра order.

8.38 anull

Перадайце крыніцу гуку без змен на выхад.

8.39 apad

Запоўніце канец аўдыяплыні цішынёй.

Гэта можна выкарыстоўваць разам зffmpeg -shortestкаб пашырыць аўдыяпатокі да той жа даўжыні, што і відэапаток.

Далей апісваюцца прынятыя варыянты.

packet_size

Задаць памер пакета цішыні. Значэнне па змаўчанні - 4096.

pad_len

Усталюйце колькасць узораў маўчання, якія трэба дадаць у канец. Пасля дасягнення значэння паток спыняецца. Гэты варыянт ўзаемавыключальны зwhole_len.

whole_len

Усталюйце мінімальную агульную колькасць сэмплоў у выходным аўдыяструмені. Калі значэнне перавышае працягласць уваходнага гуку, у канцы дадаецца цішыня, пакуль не будзе дасягнута значэнне. Гэты варыянт ўзаемавыключальны зpad_len.

pad_dur

Укажыце працягласць узораў маўчання, якія трэба дадаць. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Выкарыстоўваецца, толькі калі зададзена неадмоўнае значэнне.

whole_dur

Укажыце мінімальную агульную працягласць выхаднога гукавога патоку. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Выкарыстоўваецца, толькі калі зададзена неадмоўнае значэнне. Калі значэнне перавышае працягласць уваходнага гуку, у канцы дадаецца цішыня, пакуль не будзе дасягнута значэнне. Гэты варыянт ўзаемавыключальны зpad_dur

Калі ніpad_lenніwhole_lenніpad_dur ніwhole_durусталяваны параметр, фільтр дадасць цішыню ў канцы ўваходнага патоку на нявызначаны час.

Звярніце ўвагу, што для ffmpeg 4.4 і раней нульpad_durабо whole_durтаксама прымусіў фільтр дадаць цішыню на нявызначаны час.

8.39.1 Examples

  • Дадайце 1024 сэмплы цішыні ў канец уводу:
    apad=pad_len=1024
    
  • Пераканайцеся, што аўдыявыхад будзе ўтрымліваць не менш за 10000 сэмплоў, пры неабходнасці запоўніце ўваход цішынёй:
    apad=whole_len=10000
    
  • Выкарыстоўвайцеffmpeg для запаўнення гукавога ўваходу цішынёй, каб відэаплынь заўсёды была самай кароткай і пераўтваралася да канца ў выходны файл пры выкарыстанніshortest варыянт:
    ffmpeg -i VIDEO -i AUDIO -filter_complex "[1:0]apad" -shortest OUTPUT
    

8.40 aphaser

Дадайце эфект фазіроўкі да ўваходнага гуку.

Фазерны фільтр стварае серыі пікаў і спадаў у частотным спектры. Палажэнне пікаў і спадаў мадулюецца такім чынам, што яны змяняюцца з цягам часу, ствараючы размашысты эфект.

Далей апісваюцца прынятыя параметры.

in_gain

Задаць уваходнае ўзмацненне. Па змаўчанні 0,4.

out_gain

Усталюйце ўзмацненне выхаду. Па змаўчанні 0,74

delay

Усталюйце затрымку ў мілісекундах. Па змаўчанні 3.0.

decay

Набор распаду. Па змаўчанні 0,4.

speed

Усталюйце хуткасць мадуляцыі ў Гц. Па змаўчанні 0,5.

type

Усталюйце тып мадуляцыі. Па змаўчанні трохкутны.

Ён прымае наступныя значэнні:

'triangular, t'
'sinusoidal, s'

8.41 aphaseshift

Прымяненне фазавага зруху да ўваходных аўдыясэмплаў.

Фільтр прымае наступныя параметры:

shift

Укажыце фазавы зрух. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0,0.

level

Задаць узмацненне выхаду, прымененае да канчатковага выхаду. Дазволены дыяпазон ад 0,0 да 1,0. Значэнне па змаўчанні 1,0.

order

Устанавіць парадак фільтрацыі, які выкарыстоўваецца для фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 8.

8.41.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.42 apsyclip

Ужывайце псіхаакустычны кліпер для ўваходнага аўдыёпатоку.

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].

level_out

Усталюйце ўзмацненне выхаду. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].

clip

Усталюйце значэнне пачатку абразання. Значэнне па змаўчанні - 0dBFS або 1.

diff

Выводзіць толькі адрозныя сэмплы, карысныя для праслухоўвання ўнесеных скажэнняў. Па змаўчанні адключана.

adaptive

Зададзеная сіла прымененага адаптыўнага скажэння. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.

iterations

Задайце колькасць ітэрацый псіхаакустычнага кліпера. Дазволены дыяпазон ад 1 да 20. Значэнне па змаўчанні - 10.

level

Аўтаматычны ўзровень выхаднога сігналу. Па змаўчанні адключана. Гэта нармалізуе гук назад да 0dBFS, калі ўключана.

8.42.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.43 apulsator

Аудио пульсатор - гэта нешта сярэдняе паміж автопаннером і трэмала. Але ён таксама можа ствараць пацешныя стэрээфекты. Pulsator змяняе гучнасць левага і правага каналаў на аснове LFO (нізкачашчыннага генератара) з рознымі формамі сігналаў і зрухам фаз. Гэты фільтр мае магчымасць вызначыць зрушэнне паміж левым і правым каналам. Зрушэнне 0 азначае, што абедзве формы LFO супадаюць адна з адной. Левы і правы канал зменены аднолькава - звычайнае трэмала. Зрушэнне ў 50% азначае, што форма правага канала дакладна зрушана па фазе (або ссунутая назад прыкладна на палову частаты) - пульсатар дзейнічае як аўтапаннер. Пры 1 абедзве крывыя зноў супадаюць. Кожная налада паміж імі перамяшчае фазавы зрух без зазору паміж усімі этапамі і стварае некаторыя "абыходныя" гукі з сінусоіднай і трохкутнай формамі хваль.

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].

level_out

Усталюйце ўзмацненне выхаду. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].

mode

Усталюйце форму хвалі, якую будзе выкарыстоўваць LFO. Можа быць адным з: сінус, трохвугольнік, квадрат, распілоўка або распілоўка. Па змаўчанні - сінус.

amount

Усталюйце мадуляцыю. Вызначце, на якую частку зыходнага сігналу ўплывае LFO.

offset_l

Усталюйце зрушэнне левага канала. Па змаўчанні 0. Дазволены дыяпазон [0 - 1].

offset_r

Усталюйце зрушэнне правага канала. Па змаўчанні 0,5. Дазволены дыяпазон [0 - 1].

width

Усталюйце шырыню імпульсу. Па змаўчанні 1. Дазволены дыяпазон [0 - 2].

timing

Усталюйце магчымы рэжым часу. Можа быць адным з: bpm, ms або Hz. Па змаўчанні - hz.

bpm

Задаць удары ў хвіліну. Па змаўчанні 120. Дазволены дыяпазон [30 - 300]. Выкарыстоўваецца, толькі калі час усталяваны на уд/хв.

ms

Усталяваць мс. Па змаўчанні 500. Дазволены дыяпазон [10 - 2000]. Выкарыстоўваецца, толькі калі час усталяваны ў мс.

hz

Усталюйце частату ў Гц. Па змаўчанні 2. Дазволены дыяпазон [0,01 - 100]. Выкарыстоўваецца, толькі калі час усталяваны ў Гц.

8.44 aresample

Паўтарыце выбарку ўваходнага аўдыя да зададзеных параметраў з дапамогай бібліятэкі libswresample. Калі ні адзін з іх не пазначаны, то фільтр будзе аўтаматычна пераўтварацца паміж уваходам і выхадам.

Гэты фільтр таксама здольны расцягваць/сціскаць аўдыядадзеныя, каб яны адпавядалі пазнакам часу, або ўводзіць цішыню/выключаць аўдыя, каб яны адпавядалі пазнакам часу, камбінаваць абодва або не рабіць ні тое, ні другое.

Фільтр прымае сінтаксіс [ sample_rate:] resampler_options, дзе sample_rate выражае частату выбаркі і resampler_optionsўяўляе сабой спіс пар key= value, падзеленых знакам ":". Поўны спіс падтрымоўваных параметраў глядзіце ў раздзеле (ffmpeg-resampler) «Параметры Resampler» у кіраўніцтве ffmpeg-resampler(1) .

8.44.1 Examples

  • Паўтарыце выбарку ўваходнага гуку да 44100 Гц:
    aresample=44100
    
  • Расцягнуць/сціснуць выбаркі да зададзеных часовых пазнак з кампенсацыяй максімум 1000 выбарак у секунду:
    aresample=async=1000
    

8.45 areverse

Перавярнуць аўдыёкліп.

Папярэджанне: гэтаму фільтру патрабуецца памяць для буферызацыі ўсяго кліпа, таму рэкамендуецца абрэзаць.

8.45.1 Examples

  • Вазьміце першыя 5 секунд кліпа і перавярніце яго назад.
    atrim=end=5,areverse
    

8.46 arnndn

Паменшыце шум ад прамовы з дапамогай перыядычных нейронавых сетак.

Гэты фільтр прымае наступныя параметры:

model, m

Задаць файл мадэлі цягніка для загрузкі. Гэтая опцыя заўсёды патрабуецца.

mix

Устанавіць, колькі змешваць адфільтраваныя ўзоры ў канчатковы вынік. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 1. Адмоўныя значэнні з'яўляюцца асаблівымі, яны ўсталёўваюць, колькі ўтрымліваць адфільтраваны шум у канчатковым вывадзе фільтра. Усталюйце гэты параметр на -1, каб пачуць фактычны шум, выдалены з уваходнага сігналу.

8.46.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.47 asdr

Вымерайце стаўленне гукавога сігналу да скажэнняў.

Гэты фільтр прымае два аўдыяпатокі для ўваходу і выводзіць першы аўдыяпаток. Вынікі ў дБ на канал у канцы любога ўваходу.

8.48 asetnsamples

Усталюйце колькасць выбарак на кожны выхадны гукавы кадр.

Апошні выходны пакет можа змяшчаць іншую колькасць выбарак, паколькі фільтр ачысціць усе астатнія выбаркі, калі ўваходны аўдыё сігналізуе аб яго заканчэнні.

Фільтр прымае наступныя параметры:

nb_out_samples, n

Усталюйце колькасць кадраў на кожны выхадны гукавы кадр. Колькасць прызначана як колькасць выбарак на кожны канал . Значэнне па змаўчанні - 1024.

pad, p

Калі ўстаноўлена ў 1, фільтр будзе дапаўняць апошні аўдыёкадр нулямі, так што апошні кадр будзе ўтрымліваць такую ​​ж колькасць выбарак, як і папярэднія. Значэнне па змаўчанні - 1.

Напрыклад, каб усталяваць колькасць узораў на кадр 1234 і адключыць запаўненне для апошняга кадра, выкарыстоўвайце:

asetnsamples=n=1234:p=0

8.49 asetrate

Усталюйце частату дыскрэтызацыі без змены даных PCM. Гэта прывядзе да змены хуткасці і вышыні.

Фільтр прымае наступныя параметры:

sample_rate, r

Усталюйце частату выбаркі вываду. Па змаўчанні 44100 Гц.

8.50 ashowinfo

Паказаць радок, які змяшчае розную інфармацыю для кожнага ўваходнага аўдыякадра. Уваходны аўдыё не зменены.

Паказаны радок змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key: value.

У вывадзе паказаны наступныя значэнні:

n

(Парадкавы) нумар уваходнага кадра, пачынаючы з 0.

pts

Пазнака часу прадстаўлення ўваходнага кадра ў адзінках асноўнага часу; развага часу залежыць ад уваходнай пляцоўкі фільтра і звычайна складае 1/ sample_rate.

pts_time

Метка часу прэзентацыі ўваходнага кадра ў секундах.

pos

пазіцыя кадра ва ўваходным патоку, -1, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага аўдыя)

fmt

Фармат ўзору.

chlayout

Макет канала.

rate

Частата дыскрэтызацыі для аўдыякадра.

nb_samples

Колькасць выбарак (на канал) у кадры.

checksum

Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) аўдыядадзеных. Для планарнага аўдыя даныя апрацоўваюцца так, як калі б усе плоскасці былі злучаныя.

plane_checksums

Спіс кантрольных сум Adler-32 для кожнай плоскасці дадзеных.

8.51 asoftclip

Прымяненне мяккай выразкі гуку.

Мяккае адсячэнне - гэта тып эфекту скажэння, пры якім амплітуда сігналу насычаецца ўздоўж гладкай крывой, а не рэзкай формы жорсткага адсячэння.

Гэты фільтр прымае наступныя параметры:

type

Усталюйце тып мяккага кліпінгу.

Ён прымае наступныя значэнні:

hard
tanh
atan
cubic
exp
alg
quintic
sin
erf
threshold

Усталюйце парог, з якога трэба пачынаць абразанне. Значэнне па змаўчанні - 0 дБ або 1.

output

Задаць узмацненне, якое прымяняецца да выхаду. Значэнне па змаўчанні - 0 дБ або 1.

param

Усталюйце дадатковы параметр, які кіруе сігмападобнай функцыяй.

oversample

Задаць каэфіцыент перадвыбаркі.

8.51.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.52 aspectralstats

Адлюстраванне статыстычнай інфармацыі аб аўдыёканалах у частотнай вобласці. Статыстыка разлічваецца і захоўваецца ў выглядзе метададзеных для кожнага аўдыяканала і для кожнага аўдыякадра.

Ён прымае наступны варыянт:

win_size

Задайце даўжыню акна ва ўзорах. Значэнне па змаўчанні - 2048. Дазволены дыяпазон ад 32 да 65536.

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann, hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Па змаўчанні hann.

overlap

Усталюйце перакрыцце вокнаў. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.5.

Спіс кожнага ключа метаданых ніжэй:

mean
variance
centroid
spread
skewness
kurtosis
entropy
flatness
crest
flux
slope
decrease
rolloff

8.53 asr

Аўтаматычнае распазнаванне гаворкі

Гэты фільтр выкарыстоўвае PocketSphinx для распазнання маўлення. Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-pocketsphinx.

Ён прымае наступныя варыянты:

rate

Задаць частату дыскрэтызацыі ўваходнага гуку. Па змаўчанні гэта 16000. Гэта павінна адпавядаць маўленчым мадэлям, інакш вы атрымаеце дрэнныя вынікі.

hmm

Усталяваць слоўнік, які змяшчае файлы акустычнай мадэлі.

dict

Усталяваць слоўнік вымаўлення.

lm

Усталяваць файл моўнай мадэлі.

lmctl

Набор моўных мадэляў.

lmname

Усталюйце, якую моўную мадэль выкарыстоўваць.

logfn

Задаць вывад для паведамленняў журнала.

Фільтр экспартуе распазнанае маўленне як метаданыя фрэйма lavfi.asr.text.

8.54 astats

Адлюстраванне статыстычнай інфармацыі пра аўдыяканалы ў часовай вобласці. Статыстычныя дадзеныя разлічваюцца і адлюстроўваюцца для кожнага аўдыяканала, і, дзе гэта дастасавальна, таксама даецца агульная лічба.

Ён прымае наступны варыянт:

length

Кароткая даўжыня акна ў секундах, якая выкарыстоўваецца для вымярэння піка і мінімуму RMS. Па змаўчанні 0.05(50 мілісекунд). Дазволены дыяпазон [0 - 10].

metadata

Усталяваць увядзенне метададзеных. Усе ключы метададзеных маюць прэфікс lavfi.astats.X, дзе Xнумар канала, пачынаючы з 1, або радок Overall. Па змаўчанні адключана.

Даступныя ключы для кожнага канала: DC_offset Min_level Max_level Min_difference Max_difference Mean_difference RMS_difference Peak_level RMS_peak RMS_trough Crest_factor Flat_factor Peak_count Noise_floor Noise_floor_count Entropy Bit_depth Dynamic_range Zero_crossings Zero_crossings_rate Number_of_Nafnormals Number_of_

і для Overall: DC_offset Min_level Max_level Min_difference Max_difference Mean_difference RMS_difference Peak_level RMS_level RMS_peak RMS_trough Flat_factor Peak_count Noise_floor Noise_floor_count Entropy Bit_depth Number_of_samples Number_of_naNs Number_of_Infs Number_of_denormals

Напрыклад, поўны ключ выглядае так lavfi.astats.1.DC_offsetці так lavfi.astats.Overall.Peak_count.

Для апісання значэнняў кожнай клавішы чытайце ніжэй.

reset

Усталюйце колькасць кадраў, для якіх разлічваецца сукупная статыстыка перад скідам. Па змаўчанні адключана.

measure_perchannel

Выберыце параметры, якія вымяраюцца для кожнага канала. Ключы метададзеных могуць выкарыстоўвацца як сцягі, па змаўчанніallякі вымярае ўсё. noneадключае вымярэнне ўсіх каналаў.

measure_overall

Выберыце параметры, якія вымяраюцца ў цэлым. Ключы метададзеных могуць выкарыстоўвацца як сцягі, па змаўчанніallякі вымярае ўсё. noneадключае ўсе агульныя вымярэнні.

Далей апісваецца кожны паказаны параметр:

DC offset

Зрушэнне сярэдняй амплітуды ад нуля.

Min level

Мінімальны ўзровень выбаркі.

Max level

Максімальны ўзровень выбаркі.

Min difference

Мінімальная розніца паміж двума паслядоўнымі ўзорамі.

Max difference

Максімальная розніца паміж двума паслядоўнымі выбаркамі.

Mean difference

Сярэдняя розніца паміж двума паслядоўнымі ўзорамі. Сярэдняе значэнне кожнай розніцы паміж двума паслядоўнымі выбаркамі.

RMS difference

Сярэднеквадратычная розніца паміж двума паслядоўнымі выбаркамі.

Peak level dB
RMS level dB

Стандартны пікавы і сярэднеквадратычны ўзровень, вымераны ў dBFS.

RMS peak dB
RMS trough dB

Пікавыя і мінімальныя значэнні для ўзроўню RMS, вымераныя на працягу кароткага акна.

Crest factor

Стандартнае стаўленне піка да сярэднеквадратычнага ўзроўню (заўвага: не ў дБ).

Flat factor

Раўнамернасць (г.зн. паслядоўныя выбаркі з аднолькавым значэннем) сігналу на яго пікавых узроўнях (г.зн. альбо Min levelабо Max level).

Peak count

Колькасць выпадкаў (а не колькасць выбарак), калі сігнал дасягаў альбо Min levelабо Max level.

Noise floor dB

Мінімальны лакальны пік, вымераны ў dBFS за кароткае акно.

Noise floor count

Колькасць выпадкаў (а не колькасць выбарак), калі сігнал быў дасягнуты Noise floor.

Entropy

Энтрапія, вымераная ва ўсім аўдыя. Энтрапія са значэннем каля 1,0 звычайна вымяраецца для белага шуму.

Bit depth

Агульная разраднасць гуку. Колькасць бітаў, якія выкарыстоўваюцца для кожнай выбаркі.

Dynamic range

Вымераны дынамічны дыяпазон гуку ў дБ.

Zero crossings

Колькасць кропак, дзе сігнал перасякае вось нулявога ўзроўню.

Zero crossings rate

Хуткасць перасячэнняў нуля і колькасць аўдыясэмплоў.

8.55 asubboost

Павялічце частоты сабвуфера.

Фільтр прымае наступныя параметры:

dry

Усталюйце сухое ўзмацненне, колькі зыходнага сігналу захоўваецца. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1,0.

wet

Усталюйце вільготнае ўзмацненне, колькасць адфільтраванага сігналу захоўваецца. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1,0.

boost

Усталюйце максімальны каэфіцыент павышэння. Дазволены дыяпазон ад 1 да 12. Значэнне па змаўчанні - 2.

decay

Усталюйце значэнне ўзмацнення затухання лініі затрымкі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,0.

feedback

Задайце значэнне зваротнай сувязі лініі затрымкі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,9.

cutoff

Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 50 да 900. Значэнне па змаўчанні - 100.

slope

Усталюйце велічыню нахілу для частаты зрэзу. Дазволены дыяпазон ад 0,0001 да 1. Значэнне па змаўчанні - 0,5.

delay

Усталюйце затрымку. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 20.

channels

Усталюйце каналы для апрацоўкі. Значэнне па змаўчанні даступна для ўсіх.

8.55.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.56 asubcut

Абрэзаць частоты сабвуфера.

Гэты фільтр дазваляе ўсталёўваць карыстацкі, больш круты спад, чым фільтр высокіх частот, і, такім чынам, здольны больш аслабляць частотны змест у паласе спынення.

Фільтр прымае наступныя параметры:

cutoff

Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 2 да 200. Значэнне па змаўчанні - 20.

order

Усталяваць парадак фільтраў. Даступныя значэнні ад 3 да 20. Значэнне па змаўчанні - 10.

level

Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

8.56.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.57 asupercut

Выразаць суперчастоты.

Фільтр прымае наступныя параметры:

cutoff

Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 20000 да 192000. Значэнне па змаўчанні - 20000.

order

Усталяваць парадак фільтраў. Даступныя значэнні ад 3 да 20. Значэнне па змаўчанні - 10.

level

Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

8.57.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.58 asuperpass

Прымяніць паласавы фільтр Батэрворта высокага парадку.

Фільтр прымае наступныя параметры:

centerf

Усталюйце цэнтральную частату ў герцах. Дазволены дыяпазон ад 2 да 999999. Значэнне па змаўчанні - 1000.

order

Усталяваць парадак фільтраў. Даступныя значэнні ад 4 да 20. Значэнне па змаўчанні - 4.

qfactor

Усталюйце Q-каэфіцыент. Дазволены дыяпазон ад 0,01 да 100. Значэнне па змаўчанні - 1.

level

Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 2. Значэнне па змаўчанні - 1.

8.58.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.59 asuperstop

Прымяніце палосны фільтр Батэрворта высокага парадку.

Фільтр прымае наступныя параметры:

centerf

Усталюйце цэнтральную частату ў герцах. Дазволены дыяпазон ад 2 да 999999. Значэнне па змаўчанні - 1000.

order

Усталяваць парадак фільтраў. Даступныя значэнні ад 4 да 20. Значэнне па змаўчанні - 4.

qfactor

Усталюйце Q-каэфіцыент. Дазволены дыяпазон ад 0,01 да 100. Значэнне па змаўчанні - 1.

level

Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 2. Значэнне па змаўчанні - 1.

8.59.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.60 atempo

Адрэгулюйце тэмп гуку.

Фільтр прымае толькі адзін параметр, тэмп гуку. Калі не пазначана, фільтр будзе прымаць намінальны тэмп 1,0. Тэмп павінен быць у дыяпазоне [0,5, 100,0].

Звярніце ўвагу, што тэмп, большы за 2, будзе прапускаць некаторыя сэмплы, а не змешваць іх. Калі па якой-небудзь прычыне гэта выклікае занепакоенасць, заўсёды можна злучыць некалькі асобнікаў тэмпу для дасягнення жаданага тэмпу прадукту.

8.60.1 Examples

  • Запавольце гук да 80% тэмпу:
    atempo=0.8
    
  • Каб паскорыць гук да 300% тэмпу:
    atempo=3
    
  • Каб паскорыць аўдыё да 300% тэмпу шляхам паслядоўнага злучэння двух асобнікаў тэмпу:
    atempo=sqrt(3),atempo=sqrt(3)
    

8.60.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

tempo

Змяніць каэфіцыент маштабу тэмпу фільтра. Сінтаксіс каманды: " tempo"

8.61 atilt

Прымяніць спектральны фільтр нахілу да аўдыёпатоку.

Гэты фільтр прымяняе любы нахіл спаду спектру ў любой вызначанай паласе частот.

Фільтр прымае наступныя параметры:

freq

Усталюйце цэнтральную частату нахілу ў Гц. Па змаўчанні 10000 Гц.

slope

Усталюйце кірунак нахілу схілу. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

width

Задайце шырыню нахілу. Па змаўчанні 1000. Дазволены дыяпазон ад 100 да 10000.

order

Усталюйце парадак нахільнага фільтра.

level

Усталюйце ўзровень гучнасці ўводу. Дазволены дыяпазон ад 0 да 4. Значэнне па змаўчанні - 1.

8.61.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.62 atrim

Абрэжце ўваход так, каб выхад утрымліваў адну суцэльную падчастку ўваходу.

Ён прымае наступныя параметры:

start

Метка часу (у секундах) пачатку раздзела, які трэба захаваць. Гэта значыць, узор аўдыё з пазнакай часу startбудзе першым у вывадзе.

end

Укажыце час першага ўзору аўдыя, які будзе выдалены, г.зн. узор аўдыё, які непасрэдна папярэднічае таму з пазнакай часу end, будзе апошнім у вывадзе.

start_pts

Тое самае, што і start, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу пачатку ў выбарках, а не ў секундах.

end_pts

Тое самае, што і end, за выключэннем таго, што гэты параметр усталёўвае канечную метку часу ў выбарках, а не ў секундах.

duration

Максімальная працягласць вываду ў секундах.

start_sample

Нумар першага ўзору, які трэба вывесці.

end_sample

Нумар першай пробы, якую трэба адкінуць.

start,end, іdurationвыражаюцца як характарыстыкі працягласці часу; глядзіце (ffmpeg-utils) раздзел «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1). .

Звярніце ўвагу, што першыя два наборы параметраў пачатку/канца іduration параметр глядзіць на пазнаку часу кадра, а параметры _sample проста падлічваюць выбаркі, якія праходзяць праз фільтр. Такім чынам, start/end_pts і start/end_sample дадуць розныя вынікі, калі пазнакі часу няправільныя, недакладныя або не пачынаюцца з нуля. Таксама звярніце ўвагу, што гэты фільтр не змяняе часовыя пазнакі. Калі вы хочаце, каб пазнакі часу вываду пачыналіся з нуля, устаўце фільтр asetpts пасля фільтра atrim.

Калі ўстаноўлена некалькі параметраў пачатку або канца, гэты фільтр спрабуе быць прагным і захаваць усе выбаркі, якія адпавядаюць хаця б аднаму з указаных абмежаванняў. Каб захаваць толькі тую частку, якая адначасова адпавядае ўсім абмежаванням, звяжыце некалькі фільтраў атрымлівання.

Значэнні па змаўчанні такія, што ўвесь увод захоўваецца. Такім чынам, можна ўсталяваць, напрыклад, толькі канчатковыя значэнні, каб захаваць усё да вызначанага часу.

Прыклады:

  • Адкіньце ўсё, акрамя другой хвіліны ўводу:
    ffmpeg -i INPUT -af atrim=60:120
    
  • Захаваць толькі першыя 1000 узораў:
    ffmpeg -i INPUT -af atrim=end_sample=1000
    

8.63 axcorrelate

Разлік нармалізаванай узаемнай карэляцыі паміж двума ўваходнымі аўдыёпатокамі.

Выніковыя выбаркі заўсёды знаходзяцца ў межах ад -1 да 1 уключна. Калі вынік 1, гэта азначае, што дзве ўваходныя выбаркі моцна карэлююць у выбраным сегменце. Вынік 0 азначае, што яны зусім не карэлююць. Калі вынік роўны -1, гэта азначае, што дзве ўваходныя выбаркі не па фазе, што азначае, што яны адмяняюць адна адну.

Фільтр прымае наступныя параметры:

size

Задайце памер сегмента, для якога разлічваецца ўзаемакарэляцыя. Па змаўчанні - 256. Дазволены дыяпазон ад 2 да 131072.

algo

Задаць алгарытм узаемнай карэляцыі. Можа быць slowабо fast. Па змаўчанні slow. Хуткі алгарытм мяркуе, што сярэднія значэнні для любога зададзенага сегмента заўсёды роўныя нулю, і, такім чынам, патрабуецца значна менш вылічэнняў. Як правіла, гэта не так, але справядліва для тыповых аўдыяпатокаў.

8.63.1 Examples

  • Вылічыць карэляцыю паміж каналамі ў стэрэааўдыяпатоку:
    ffmpeg -i stereo.wav -af channelsplit,axcorrelate=size=1024:algo=fast correlation.wav
    

8.64 bandpass

Прымяненне двухполюснага паласавога фільтра Батэрворта з цэнтральнай частатой frequencyі (3 дБ) шырынёй паласы. Thecsg выбірае пастаяннае ўзмацненне спадніцы (пікавае ўзмацненне = Q) замест стандартнага: пастаяннае пікавае ўзмацненне 0 дБ. Фільтр зніжаецца на 6 дБ на актаву (20 дБ на дэкаду).

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце цэнтральную частату фільтра. Па змаўчанні 3000.

csg

Пастаяннае ўзмацненне спадніцы, калі ўстаноўлена 1. Па змаўчанні 0.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.64.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць паласавую частату. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні паласы пропуску. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню паласы пропуску. Сінтаксіс каманды: " width"

mix, m

Змяніць палосны мікс. Сінтаксіс каманды: " mix"

8.65 bandreject

Прымяніце двухполюсны палосны фільтр frequencyБатэрворта з цэнтральнай частатой і шырынёй паласы (3 дБ).width . Фільтр зніжаецца на 6 дБ на актаву (20 дБ на дэкаду).

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце цэнтральную частату фільтра. Па змаўчанні 3000.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.65.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць частату адхілення дыяпазону. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць bandreject width_type. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню адхілення паласы. Сінтаксіс каманды: " width"

mix, m

Змяніць мікс bandreject. Сінтаксіс каманды: " mix"

8.66 bass, lowshelf

Узмацняйце або зніжайце нізкія (ніжнія) частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятара тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).

Фільтр прымае наступныя параметры:

gain, g

Дайце ўзмацненне на 0 Гц. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.

frequency, f

Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні - 100Гц.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Вызначце, наколькі круты пераход паліцы фільтра.

poles, p

Усталюйце колькасць палюсоў. Па змаўчанні 2.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.66.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць басовую частату. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні баса. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню баса. Сінтаксіс каманды: " width"

gain, g

Змяніць узмацненне басу. Сінтаксіс каманды: " gain"

mix, m

Змяніць мікс басоў. Сінтаксіс каманды: " mix"

8.67 biquad

Прымяніце біквадратны БІХ-фільтр з дадзенымі каэфіцыентамі. Дзе b0, b1, b2і a0, a1, a2 - каэфіцыенты лічніка і назоўніка адпаведна. і channels, cпакажыце, якія каналы фільтраваць, па змаўчанні ўсе даступныя фільтруюцца.

8.67.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

a0
a1
a2
b0
b1
b2

Змяніць параметр biquad. Сінтаксіс каманды: " value"

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.68 bs2b

Пераўтварэнне стэрэа ў бінаўральнае Bauer, якое паляпшае праслухоўванне стэрэааўдыязапісаў у навушніках.

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-libbs2b.

Ён прымае наступныя параметры:

profile

Папярэдне зададзены ўзровень перакрыжаванай падачы.

default

Узровень па змаўчанні (fcut=700, feed=50).

cmoy

Схема Chu Moy (fcut=700, feed=60).

jmeier

Схема Яна Майера (fcut=650, feed=95).

fcut

Частата зрэзу (у Гц).

feed

Узровень падачы (у Гц).

8.69 channelmap

Пераназначце ўваходныя каналы на новыя месцы.

Ён прымае наступныя параметры:

map

Карта каналаў ад уваходу да выхаду. Аргумент уяўляе сабой падзелены '|' спіс супастаўленняў, кожнае ў форме або . можа быць альбо назвай уваходнага канала (напрыклад, FL для пярэдніх левых), альбо яго індэксам у макеце уваходнага канала. гэта назва выхаднога канала або яго індэкс у макеце выхаднога канала. Калі не зададзены, то гэта няяўна індэкс, які пачынаецца з нуля і павялічваецца на адзінку для кожнага адлюстравання. in_channel-out_channelin_channelin_channelout_channelout_channel

channel_layout

Схема канала выхаднога патоку.

Калі супастаўлення няма, фільтр няяўна супастаўляе ўваходныя каналы з выходнымі, захоўваючы індэксы.

8.69.1 Examples

  • Напрыклад, калі выказаць здагадку, што ўваходны файл MOV 5.1+зведзены ўніз,
    ffmpeg -i in.mov -filter 'channelmap=map=DL-FL|DR-FR' out.wav
    

    створыць выхадны файл WAV, пазначаны як стэрэа, з каналаў паніжальнага мікшавання ўваходу.

  • Каб выправіць 5.1 WAV, няправільна закадаваны ў уласным парадку каналаў AAC
    ffmpeg -i in.wav -filter 'channelmap=1|2|0|5|3|4:5.1' out.wav
    

8.70 channelsplit

Разбіце кожны канал з уваходнага аўдыёпатоку ў асобны выходны паток.

Ён прымае наступныя параметры:

channel_layout

Схема канала ўваходнага патоку. Па змаўчанні - "стэрэа".

channels

Макет канала, які апісвае каналы, якія будуць здабывацца як асобныя выхадныя патокі, або "ўсе", каб выдзяляць кожны ўваходны канал як асобны паток. Па змаўчанні - "усе".

Выбар каналаў, якіх няма ў макеце каналаў ва ўваходных дадзеных, прывядзе да памылкі.

8.70.1 Examples

  • Напрыклад, калі выказаць здагадку, што ўваходны стэрэафайл MP3,
    ffmpeg -i in.mp3 -filter_complex channelsplit out.mkv
    

    створыць выхадны файл Matroska з двума аўдыяпатокамі, адзін з якіх змяшчае толькі левы канал, а другі - правы канал.

  • Разбіць файл 5.1 WAV на файлы для кожнага канала:
    ffmpeg -i in.wav -filter_complex
    'channelsplit=channel_layout=5.1[FL][FR][FC][LFE][SL][SR]'
    -map '[FL]' front_left.wav -map '[FR]' front_right.wav -map '[FC]'
    front_center.wav -map '[LFE]' lfe.wav -map '[SL]' side_left.wav -map '[SR]'
    side_right.wav
    
  • Выняць толькі LFE з файла 5.1 WAV:
    ffmpeg -i in.wav -filter_complex 'channelsplit=channel_layout=5.1:channels=LFE[LFE]'
    -map '[LFE]' lfe.wav
    

8.71 chorus

Дадайце эфект хору да аўдыя.

Можа выдаваць адзіны вакальны гук, як хор, але таксама можа прымяняцца да інструментаў.

Хор нагадвае эфект рэха з кароткай затрымкай, але ў той час як у рэха затрымка пастаянная, у хору яна вар'іруецца з дапамогай сінусоіднай або трохкутнай мадуляцыі. Глыбіня мадуляцыі вызначае дыяпазон прайгравання мадуляванай затрымкі да або пасля затрымкі. Такім чынам, адкладзены гук будзе гучаць павольней або хутчэй, гэта значыць адкладзены гук, настроены вакол арыгінальнага, напрыклад, у прыпеве, дзе некаторыя вакалы крыху зрушаныя.

Ён прымае наступныя параметры:

in_gain

Задаць уваходнае ўзмацненне. Па змаўчанні 0,4.

out_gain

Усталюйце ўзмацненне выхаду. Па змаўчанні 0,4.

delays

Усталюйце затрымкі. Звычайная затрымка складае ад 40 да 60 мс.

decays

Набор распадаецца.

speeds

Усталюйце хуткасці.

depths

Усталюйце глыбіню.

8.71.1 Examples

  • Адзіная затрымка:
    chorus=0.7:0.9:55:0.4:0.25:2
    
  • Дзве затрымкі:
    chorus=0.6:0.9:50|60:0.4|0.32:0.25|0.4:2|1.3
    
  • Больш поўны гук хору з трыма затрымкамі:
    chorus=0.5:0.9:50|60|40:0.4|0.32|0.3:0.25|0.4|0.3:2|2.3|1.3
    

8.72 compand

Сцісніце або пашырыце дынамічны дыяпазон аўдыя.

Ён прымае наступныя параметры:

attacks
decays

Спіс часу ў секундах для кожнага канала, па якім усярэдніваецца імгненны ўзровень уваходнага сігналу для вызначэння яго гучнасці. attacksадносіцца да павелічэння гучнасці і decaysда памяншэння гучнасці. У большасці сітуацый час атакі (адказ на гук, які становіцца гучней) павінен быць карацей, чым час затухання, таму што чалавечае вуха больш адчувальна да раптоўнага гучнага гуку, чым да раптоўнага ціхага. Тыповае значэнне атакі складае 0,3 секунды, а тыповае значэнне распаду - 0,8 секунды. Калі зададзеная колькасць атак і спадаў меншая за колькасць каналаў, для ўсіх астатніх каналаў будзе выкарыстоўвацца апошняя ўстаноўленая атака/распад.

points

Спіс кропак для перадаткавай функцыі, указаных у дБ адносна максімальна магчымай амплітуды сігналу. Кожны спіс ключавых пунктаў павінен быць вызначаны з дапамогай наступнага сінтаксісу: x0/y0|x1/y1|x2/y2|....або x0/y0 x1/y1 x2/y2 ....

Уваходныя значэнні павінны быць у парадку строга ўзрастання, але перадаткавая функцыя не павінна манатонна ўзрастаць. Кропка 0/0мяркуецца, але можа быць перавызначана (па 0/out-dBn). Тыповыя значэнні перадаткавай функцыі: -70/-70|-60/-20|1/0.

soft-knee

Усталюйце радыус крывой у дБ для ўсіх стыкаў. Па змаўчанні 0,01.

gain

Усталюйце дадатковае ўзмацненне ў дБ, якое будзе прымяняцца ва ўсіх кропках перадаткавай функцыі. Гэта дазваляе лёгка рэгуляваць агульнае ўзмацненне. Па змаўчанні гэта 0.

volume

Усталюйце пачатковую гучнасць у дБ, якая будзе прымацца для кожнага канала пры пачатку фільтрацыі. Гэта дазваляе карыстальніку першапачаткова задаць намінальны ўзровень, каб, напрыклад, вельмі вялікае ўзмацненне не прымянялася да пачатковых узроўняў сігналу да таго, як пачне дзейнічаць кампандаванне. Тыповае значэнне для гуку, які першапачаткова ціхі, складае -90 дБ. Па змаўчанні гэта 0.

delay

Усталюйце затрымку ў секундах. Уваходны аўдыё аналізуецца неадкладна, але аўдыё затрымліваецца перад тым, як паступіць на рэгулятар гучнасці. Вызначэнне затрымкі, прыблізна роўнай часу атакі/спаду, дазваляе фільтру эфектыўна працаваць у рэжыме прагназавання, а не ў рэактыўным рэжыме. Па змаўчанні гэта 0.

8.72.1 Examples

  • Стварыце музыку як з ціхімі, так і з гучнымі фрагментамі, прыдатнай для праслухоўвання ў шумнай абстаноўцы:
    compand=.3|.3:1|1:-90/-60|-60/-40|-40/-30|-20/-20:6:0:-90:0.2
    

    Іншы прыклад аўдыя з часткамі шэпту і выбуху:

    compand=0|0:1|1:-90/-900|-70/-70|-30/-9|0/-3:6:0:0:0
    
  • Шумавы гейт, калі ўзровень шуму ніжэйшы за ўзровень сігналу:
    compand=.1|.1:.2|.2:-900/-900|-50.1/-900|-50/-50:.01:0:-90:.1
    
  • Вось яшчэ адзін шумавы гейт, на гэты раз для тых выпадкаў, калі ўзровень шуму перавышае ўзровень сігналу (шмат у чымсьці падобны на шумоподавитель):
    compand=.1|.1:.1|.1:-45.1/-45.1|-45/-900|0/-900:.01:45:-90:.1
    
  • Сціск 2:1, пачынаючы з -6 дБ:
    compand=points=-80/-80|-6/-6|0/-3.8|20/3.5
    
  • Сціск 2:1, пачынаючы з -9 дБ:
    compand=points=-80/-80|-9/-9|0/-5.3|20/2.9
    
  • Сціск 2:1, пачынаючы з -12 дБ:
    compand=points=-80/-80|-12/-12|0/-6.8|20/1.9
    
  • Сціск 2:1, пачынаючы з -18 дБ:
    compand=points=-80/-80|-18/-18|0/-9.8|20/0.7
    
  • Сціск 3:1, пачынаючы з -15 дБ:
    compand=points=-80/-80|-15/-15|0/-10.8|20/-5.2
    
  • Кампрэсар/Гейт:
    compand=points=-80/-105|-62/-80|-15.4/-15.4|0/-12|20/-7.6
    
  • пашыральнік:
    compand=attacks=0:points=-80/-169|-54/-80|-49.5/-64.6|-41.1/-41.1|-25.8/-15|-10.8/-4.5|0/0|20/8.3
    
  • Жорсткі абмежавальнік на -6 дБ:
    compand=attacks=0:points=-80/-80|-6/-6|20/-6
    
  • Жорсткі абмежавальнік пры -12 дБ:
    compand=attacks=0:points=-80/-80|-12/-12|20/-12
    
  • Жорсткі шумавы гейт пры -35 дБ:
    compand=attacks=0:points=-80/-115|-35.1/-80|-35/-35|20/20
    
  • Мяккі абмежавальнік:
    compand=attacks=0:points=-80/-80|-12.4/-12.4|-6/-8|0/-6.8|20/-2.8
    

8.73 compensationdelay

Лінія затрымкі кампенсацыі - гэта заснаваная на метрыцы затрымка для кампенсацыі рознага становішча мікрафонаў або дынамікаў.

Напрыклад, вы запісалі гітару з дапамогай двух мікрафонаў, размешчаных у розных месцах. Паколькі ў нармальных умовах фронт гукавой хвалі мае фіксаваную хуткасць, фаза мікрафонаў можа адрознівацца і залежыць ад іх месцазнаходжання і ўзаемаразмяшчэння. Найлепшы гукавы мікс можа быць дасягнуты, калі гэтыя мікрафоны знаходзяцца ў фазе (сінхранізаваны). Звярніце ўвагу, што адлегласць ~30 см паміж мікрафонамі прымушае адзін мікрафон захопліваць сігнал у супрацьфазе з іншым мікрафонам. Гэта робіць канчатковы мікс капрызным. Гэты фільтр дапамагае вырашыць праблемы фазіроўкі, дадаючы розныя затрымкі да кожнай дарожкі мікрафона і робячы іх сінхранізаванымі.

Найлепшага выніку можна дасягнуць, калі ўзяць за аснову адзін трэк і сінхранізаваць з ім па чарзе іншыя трэкі. Памятайце, што допуск сінхранізацыі/затрымкі таксама залежыць ад частаты дыскрэтызацыі. Больш высокая частата выбаркі дасць большую талерантнасць.

Фільтр прымае наступныя параметры:

mm

Задайце адлегласць у міліметрах. Гэта адлегласць кампенсацыі для тонкай налады. Па змаўчанні 0.

cm

Усталюйце адлегласць у см. Гэта кампенсацыйная адлегласць для ўстаноўкі адлегласці зацягвання. Па змаўчанні 0.

m

Усталюйце метры адлегласці. Гэта адлегласць кампенсацыі для жорсткай налады адлегласці. Па змаўчанні 0.

dry

Усталюйце сухое колькасць. Колькасць неапрацаванага (сухога) сігналу. Па змаўчанні 0.

wet

Усталюйце вільготнае колькасць. Колькасць апрацаванага (мокрага) сігналу. Па змаўчанні 1.

temp

Усталюйце тэмпературу ў градусах Цэльсія. Гэта тэмпература навакольнага асяроддзя. Па змаўчанні 20.

8.73.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.74 crossfeed

Прымяніць фільтр для навушнікаў.

Crossfeed - гэта працэс змешвання левага і правага каналаў запісу стэрэааўдыё. Ён у асноўным выкарыстоўваецца для памяншэння экстрэмальнага стэрэападзелу нізкіх частот.

Мэта складаецца ў тым, каб стварыць для слухача гук, больш падобны да дынаміка.

Фільтр прымае наступныя параметры:

strength

Усталюйце сілу папярочнай падачы. Па змаўчанні 0,2. Дазволены дыяпазон ад 0 да 1. Гэта ўстанаўлівае ўзмацненне фільтра нізкай паліцы для бакавой часткі стэрэа выявы. Па змаўчанні - -6 дБ. Максімальна дазволена -30 дБ, калі сіла ўстаноўлена на 1.

range

Задаць шырыню гукавой сцэны. Па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1. Гэта задае частату зрэзу фільтра нізкай паліцы. Па змаўчанні адсечана каля 1550 Гц. З дыяпазонам, усталяваным на 1, частата зрэзу ўстаноўлена на 2100 Гц.

slope

Задаць нахіл крывой фільтра нізкай паліцы. Па змаўчанні 0,5. Дапушчальны дыяпазон ад 0,01 да 1.

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні 0,9.

level_out

Усталюйце ўзмацненне выхаду. Па змаўчанні 1.

block_size

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.74.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.75 crystalizer

Просты алгарытм для павышэння рэзкасці гуку.

Гэты фільтр лінейна павялічвае адрозненні паміж кожным узорам аўдыя.

Фільтр прымае наступныя параметры:

i

Задае інтэнсіўнасць эфекту (па змаўчанні: 2.0). Павінна быць у дыяпазоне ад -10,0 да 0 (нязменны гук) да 10,0 (максімальны эфект). Для зваротнай фільтрацыі выкарыстоўвайце адмоўнае значэнне.

c

Уключыць выразку. Па змаўчанні ўключана.

8.75.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.76 dcshift

Прымяніць зрух пастаяннага току да аўдыя.

Гэта можа быць карысна для выдалення зрушэння пастаяннага току (выкліканага, магчыма, апаратнай праблемай у ланцужку запісу) з аўдыя. Эфект зрушэння пастаяннага току - гэта памяншэнне запасу і, такім чынам, аб'ёму. Фільтр astats можна выкарыстоўваць, каб вызначыць, ці мае сігнал зрушэнне пастаяннага току.

shift

Усталюйце зрух пастаяннага току, дазволены дыяпазон [-1, 1]. Ён паказвае колькасць зруху гуку.

limitergain

Дадаткова. Ён павінен мець значэнне значна меншае за 1 (напрыклад, 0,05 або 0,02) і выкарыстоўваецца для прадухілення абразання.

8.77 deesser

Прымяніце дээсінг да аўдыёўзораў.

i

Усталюйце інтэнсіўнасць для запуску дээсэсу. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0.

m

Усталюйце колькасць прыглушэння на высокіх частотах гуку. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0,5.

f

Колькі змесціва арыгінальнай частоты захаваць пры дээсінгу. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0,5.

s

Усталюйце рэжым вываду.

Ён прымае наступныя значэнні:

i

Увод пропуску без зменаў.

o

Pass ess адфільтраваны.

e

Перадайце толькі эс.

Значэнне па змаўчанні - o.

8.78 dialoguenhance

Паляпшэнне дыялогу ў стэрэааўдыё.

Гэты фільтр прымае ўваход стэрэа і стварае выходныя каналы аб'ёмнага гуку (3.0). Нядаўна выраблены пярэдні цэнтральны канал мае пашыраны маўленчы дыялог, першапачаткова даступны ў абодвух стэрэаканалах. Гэты фільтр выдае пярэдні левы і пярэдні правы каналы, такія ж, як і ў стэрэа ўваходзе.

Фільтр прымае наступныя параметры:

original

Усталюйце зыходны цэнтральны каэфіцыент, каб захаваць выхад на пярэдні цэнтральны канал. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

enhance

Усталюйце каэфіцыент узмацнення дыялогу для вываду пярэдняга цэнтральнага канала. Дазволены дыяпазон ад 0 да 3. Значэнне па змаўчанні - 1.

voice

Усталюйце каэфіцыент выяўлення голасу. Дазволены дыяпазон ад 2 да 32. Значэнне па змаўчанні - 2.

8.78.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.79 drmeter

Вымерайце дынамічны дыяпазон гуку.

Значэнні DR 14 і вышэй сустракаюцца ў вельмі дынамічным матэрыяле. DR ад 8 да 13 знаходзіцца ў пераходным матэрыяле. І ўсё, што менш за 8, мае вельмі дрэнную дынаміку і моцна сціскаецца.

Фільтр прымае наступныя параметры:

length

Задаць працягласць акна ў секундах, якое выкарыстоўваецца для падзелу аўдыя на сегменты аднолькавай даўжыні. Па змаўчанні 3 секунды.

8.80 dynaudnorm

Дынамічны нармалізатар гуку.

Гэты фільтр прымяняе пэўную колькасць узмацнення да ўваходнага гуку, каб давесці яго пікавую велічыню да мэтавага ўзроўню (напрыклад, 0 dBFS). Аднак, у адрозненне ад больш "простых" алгарытмаў нармалізацыі, Dynamic Audio Normalizer *дынамічна* рэгулюе каэфіцыент узмацнення для ўваходнага гуку. Гэта дазваляе прымяніць дадатковае ўзмацненне да "ціхіх" участкаў аўдыя, пазбягаючы пры гэтым скажэнняў або абразання "гучных" участкаў. Іншымі словамі: Dynamic Audio Normalizer будзе "выраўноўваць" гучнасць ціхіх і гучных секцый, у тым сэнсе, што гучнасць кожнай секцыі будзе даведзена да аднаго мэтавага ўзроўню. Звярніце ўвагу, аднак, што Dynamic Audio Normalizer дасягае гэтай мэты *без* прымянення «сціску дынамічнага дыяпазону». Ён захавае 100% дынамічнага дыяпазону *ўнутры* кожнага раздзела аўдыяфайла.

framelen, f

Усталюйце працягласць кадра ў мілісекундах. У дыяпазоне ад 10 да 8000 мілісекунд. Па змаўчанні 500 мілісекунд. Dynamic Audio Normalizer апрацоўвае ўваходны аўдыё невялікімі кавалкамі, якія называюцца кадрамі. Гэта неабходна, таму што пікавая велічыня не мае значэння толькі для аднаго значэння выбаркі. Замест гэтага нам трэба вызначыць пікавую велічыню для бесперапыннай паслядоўнасці выбарачных значэнняў. У той час як "стандартны" нармалізатар будзе проста выкарыстоўваць пікавую велічыню поўнага файла, Dynamic Audio Normalizer вызначае пікавую велічыню індывідуальна для кожнага кадра. Даўжыня кадра задаецца ў мілісекундах. Па змаўчанні Dynamic Audio Normalizer выкарыстоўвае даўжыню кадра 500 мілісекунд, што дае добрыя вынікі для большасці файлаў. Звярніце ўвагу, што дакладная даўжыня кадра ў колькасці выбарак будзе вызначацца аўтаматычна,

gausssize, g

Усталюйце памер акна фільтра Гаўса. У дыяпазоне ад 3 да 301 нумар павінен быць няцотным. Па змаўчанні - 31. Напэўна, самым важным параметрам Dynamic Audio Normalizer з'яўляецца window sizeфільтра згладжвання Гаўса. Памер акна фільтра вызначаецца ў фрэймах з цэнтрам вакол бягучага фрэйма. Дзеля прастаты гэта павінна быць няцотная лічба. Такім чынам, значэнне па змаўчанні 31 улічвае бягучы кадр, а таксама 15 папярэдніх кадраў і 15 наступных кадраў. Выкарыстанне большага акна прыводзіць да больш моцнага эфекту згладжвання і, такім чынам, да меншай варыяцыі ўзмацнення, г.зн. больш павольнай адаптацыі ўзмацнення. І наадварот, выкарыстанне меншага акна прыводзіць да слабейшага эфекту згладжвання і, такім чынам, да большай варыяцыі ўзмацнення, г.зн. да больш хуткай адаптацыі ўзмацнення. Іншымі словамі, чым больш вы павялічваеце гэта значэнне, тым больш Dynamic Audio Normalizer будзе паводзіць сябе як «традыцыйны» фільтр нармалізацыі. Наадварот, чым больш вы памяншаеце гэта значэнне, тым больш Dynamic Audio Normalizer будзе паводзіць сябе як кампрэсар дынамічнага дыяпазону.

peak, p

Усталюйце мэтавае пікавае значэнне. Гэта вызначае самы высокі дапушчальны ўзровень велічыні для нармалізаванага ўваходнага гуку. Гэты фільтр будзе спрабаваць наблізіцца да мэтавай пікавай велічыні як мага бліжэй, але ў той жа час ён таксама гарантуе, што нармалізаваны сігнал ніколі не будзе перавышаць пікавую велічыню. Максімальны лакальны каэфіцыент узмацнення кадра залежыць непасрэдна ад зададзенай пікавай велічыні. Значэнне па змаўчанні складае 0,95 і, такім чынам, пакідае запас у 5%*. Вышэй гэтага значэння не рэкамендуецца.

maxgain, m

Усталюйце максімальны каэфіцыент узмацнення. У дыяпазоне ад 1,0 да 100,0. Па змаўчанні 10.0. Dynamic Audio Normalizer вызначае максімальна магчымы (лакальны) каэфіцыент узмацнення для кожнага ўваходнага кадра, г.зн. максімальны каэфіцыент узмацнення, які не прыводзіць да адсячэння або скажэння. Максімальны каэфіцыент узмацнення вызначаецца выбаркай найбольшай велічыні кадра. Аднак Dynamic Audio Normalizer дадаткова абмяжоўвае максімальны каэфіцыент узмацнення кадра загадзя вызначаным (глабальным) максімальным каэфіцыентам узмацнення. Гэта робіцца для таго, каб пазбегнуць празмерных каэфіцыентаў узмацнення ў «ціхіх» або амаль бясшумных кадрах. Па змаўчанні максімальны каэфіцыент узмацнення складае 10,0. Для большасці уваходаў значэння па змаўчанні павінна быць дастаткова, і звычайна не рэкамендуецца павялічваць гэта значэнне. Аднак для ўводу з вельмі нізкім агульным узроўнем гучнасці можа спатрэбіцца дазволіць нават больш высокія каэфіцыенты ўзмацнення. Нататка, аднак, што Dynamic Audio Normalizer не проста прымяняе "жорсткі" парог (г.зн. адсякае значэнні вышэй парога). Замест гэтага будзе прымяняцца "сігмападобная" парогавая функцыя. Такім чынам, каэфіцыенты ўзмацнення плаўна набліжаюцца да парогавага значэння, але ніколі не перавышаюць яго.

targetrms, r

Усталюйце мэтавую RMS. У дыяпазоне ад 0,0 да 1,0. Па змаўчанні 0.0 - адключана. Па змаўчанні Dynamic Audio Normalizer выконвае «пікавую» нармалізацыю. Гэта азначае, што максімальны лакальны каэфіцыент узмацнення для кожнага кадра вызначаецца (толькі) выбаркай найбольшай велічыні кадра. Такім чынам, выбаркі могуць быць узмоцнены, наколькі гэта магчыма, без перавышэння максімальнага ўзроўню сігналу, гэта значыць без адсячэння. Аднак па жаданні Dynamic Audio Normalizer можа таксама ўлічваць сярэдняквадратычнае значэнне кадра, скарочана RMS. У электратэхніцы RMS звычайна выкарыстоўваецца для вызначэння магутнасці сігналу, які змяняецца ў часе. Таму лічыцца, што RMS з'яўляецца лепшым набліжэннем "успрыманай гучнасці", чым проста гледзячы на ​​​​пікавую велічыню сігналу. Такім чынам, наладжваючы ўсе кадры на пастаяннае сярэдняквадратычнае значэнне, аднастайны "

coupling, n

Уключыць спалучэнне каналаў. Па змаўчанні ўключана. Па змаўчанні Dynamic Audio Normalizer будзе ўзмацняць усе каналы на аднолькавую колькасць. Гэта азначае, што аднолькавы каэфіцыент узмацнення будзе прымяняцца да ўсіх каналаў, г.зн. максімальна магчымы каэфіцыент узмацнення вызначаецца самым "гучным" каналам. Аднак у некаторых запісах можа здарыцца так, што гучнасць розных каналаў нераўнамерная, напрыклад, адзін канал можа быць "цішэйшым", чым другі(-ыя). У гэтым выпадку гэтую опцыю можна выкарыстоўваць для адключэння сувязі канала. Такім чынам, каэфіцыент узмацнення будзе вызначацца незалежна для кожнага канала, у залежнасці толькі ад выбаркі найбольшай велічыні асобнага канала. Гэта дазваляе гарманізаваць гучнасць розных каналаў.

correctdc, c

Уключыць карэкцыю зрушэння пастаяннага току. Па змаўчанні адключана. Гукавы сігнал (у часовай вобласці) - гэта паслядоўнасць значэнняў выбаркі. У дынамічным нармалізатары гуку гэтыя выбарачныя значэнні прадстаўлены ў дыяпазоне ад -1,0 да 1,0, незалежна ад зыходнага фармату ўводу. Звычайна гукавы сігнал, або "форма хвалі", павінен быць сканцэнтраваны вакол нулявой кропкі. Гэта азначае, што калі мы вылічым сярэдняе значэнне ўсіх выбарак у файле або ў адным кадры, то вынік павінен быць 0,0 або, па меншай меры, вельмі блізкі да гэтага значэння. Калі, аднак, існуе значнае адхіленне сярэдняга значэння ад 0,0 у станоўчым або адмоўным кірунку, гэта называецца зрушэннем пастаяннага току або зрушэннем пастаяннага току. Паколькі зрушэнне пастаяннага току відавочна непажадана, Dynamic Audio Normalizer забяспечвае дадатковую карэкцыю зрушэння пастаяннага току. З уключанай карэкцыяй зрушэння пастаяннага току, дынамічны нармалізатар гуку вызначыць сярэдняе значэнне або зрушэнне "карэкцыі пастаяннага току" кожнага ўваходнага кадра і адніме гэта значэнне з усіх значэнняў выбаркі кадра, што гарантуе, што гэтыя выбаркі зноў будуць сканцэнтраваны вакол 0,0. Акрамя таго, каб пазбегнуць "разрываў" на межах кадра, значэнні зрушэння карэкцыі пастаяннага току будуць плаўна інтэрпалявацца паміж суседнімі кадрамі.

altboundary, b

Уключыць альтэрнатыўны рэжым межаў. Па змаўчанні адключана. Dynamic Audio Normalizer ўлічвае пэўнае суседства вакол кожнага кадра. Гэта ўключае ў сябе папярэднія кадры, а таксама наступныя кадры. Аднак для «памежных» кадраў, размешчаных у самым пачатку і ў самым канцы аўдыёфайла, даступныя не ўсе суседнія кадры. У прыватнасці, для першых некалькіх кадраў у аўдыяфайле папярэднія кадры невядомыя. І, гэтак жа, для некалькіх апошніх кадраў у аўдыяфайле наступныя кадры невядомыя. Такім чынам, узнікае пытанне, якія каэфіцыенты ўзмацнення варта лічыць для адсутных кадраў у "памежнай" вобласці. Dynamic Audio Normalizer рэалізуе два рэжымы для вырашэння гэтай сітуацыі. Гранічны рэжым па змаўчанні прадугледжвае каэфіцыент узмацнення роўна 1,0 для адсутных кадраў,

compress, s

Усталюйце каэфіцыент сціску. У дыяпазоне ад 0,0 да 30,0. Па змаўчанні 0,0. Па змаўчанні Dynamic Audio Normalizer не прымяняе «традыцыйнае» сціск. Гэта азначае, што пікі сігналу не будуць абрэзаны і, такім чынам, поўны дынамічны дыяпазон будзе захаваны ў кожным лакальным раёне. Аднак у некаторых выпадках можа быць пажадана аб'яднаць алгарытм нармалізацыі Dynamic Audio Normalizer з больш "традыцыйным" сцісканнем. Для гэтай мэты Dynamic Audio Normalizer забяспечвае дадатковую функцыю сціску (парог). Калі (і толькі калі) функцыя сціску ўключана, усе ўваходныя кадры будуць апрацаваны функцыяй мяккага парогавага значэння перад фактычным працэсам нармалізацыі. Прасцей кажучы, функцыя парогавага значэння збіраецца абрэзаць усе выбаркі, велічыня якіх перавышае пэўнае парогавае значэнне. аднак, Dynamic Audio Normalizer не проста прымяняе фіксаванае парогавае значэнне. Замест гэтага парогавае значэнне будзе карэкціравацца для кожнага асобнага кадра. Як правіла, меншыя параметры прыводзяць да больш моцнага сціску, і наадварот. Значэнні ніжэй за 3,0 не рэкамендуюцца, таму што могуць з'явіцца гукавыя скажэнні.

threshold, t

Усталюйце мэтавае парогавае значэнне. Гэта вызначае найменшую дапушчальную велічыню для ўваходнага гуку, які будзе нармалізаваны. Калі аб'ём уваходнага кадра перавышае гэты фрэйм ​​значэння, ён будзе нармалізаваны. У адваротным выпадку кадр можа наогул не нармалізавацца. Па змаўчанні ўстаноўлена значэнне 0, што азначае, што ўсе ўваходныя кадры будуць нармалізаваны. Гэтая опцыя ў асноўным карысная, калі лічбавы шум не хочацца ўзмацняць.

channels, h

Укажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя каналы.

overlap, o

Укажыце перакрыцце для кадраў. Калі ўстаноўлена 0 (па змаўчанні), перакрыцце кадраў не адбываецца. Выкарыстанне значэнняў >0 і <1 прывядзе да менш кансерватыўных карэкціровак узмацнення, напрыклад, калі параметр Framelen усталяваны на меншае значэнне, калі значэнне параметра Framelen кампенсуецца за ненулявое перакрыцце, тады карэкціроўкі ўзмацнення будуць больш плыўнымі з цягам часу ў параўнанні з нулявым перакрыццем.

8.80.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.81 earwax

Зрабіце аўдыё лягчэй слухаць у навушніках.

Гэты фільтр дадае «падказкі» да стэрэа 44,1 кГц (г.зн. у фармаце аўдыё CD) аўдыя, так што пры праслухоўванні ў навушніках стэрэамалюнак перамяшчаецца з галавы (стандарт для навушнікаў) звонку і перад слухачом (стандарт для дынамікаў ).

Партаваны з SoX.

8.82 equalizer

Прымяніць двухполюсны пікавы эквалайзерны фільтр (EQ). З дапамогай гэтага фільтра ўзровень сігналу на абранай частаце і вакол яе можа быць павялічаны або паменшаны, у той час як (у адрозненне ад паласавых фільтраў і фільтраў палоснага адхілення) ён на ўсіх іншых частотах не змяняецца.

Каб атрымаць складаныя крывыя выраўноўвання, гэты фільтр можна выкарыстоўваць некалькі разоў, кожны з рознай цэнтральнай частатой.

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце цэнтральную частату фільтра ў Гц.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type.

gain, g

Усталюйце неабходнае ўзмацненне або паслабленне ў дБ. Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.82.1 Examples

  • Аслабіць 10 дБ пры 1000 Гц з паласой прапускання 200 Гц:
    equalizer=f=1000:t=h:width=200:g=-10
    
  • Прымяніць узмацненне 2 дБ на 1000 Гц з Q 1 і аслабіць 5 дБ на 100 Гц з Q 2:
    equalizer=f=1000:t=q:w=1:g=2,equalizer=f=100:t=q:w=2:g=-5
    

8.82.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць частату эквалайзера. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні эквалайзера. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню эквалайзера. Сінтаксіс каманды: " width"

gain, g

Змяніць узмацненне эквалайзера. Сінтаксіс каманды: " gain"

mix, m

Змяніць мікс эквалайзера. Сінтаксіс каманды: " mix"

8.83 extrastereo

Лінейна павялічвае розніцу паміж левым і правым каналамі, што дадае нейкі "жывы" эфект прайграванню.

Фільтр прымае наступныя параметры:

m

Задае каэфіцыент розніцы (па змаўчанні: 2,5). 0,0 азначае монагук (сярэдняе для абодвух каналаў), пры 1,0 гук не зменіцца, пры -1,0 левы і правы каналы будуць памяняцца месцамі.

c

Уключыць выразку. Па змаўчанні ўключана.

8.83.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.84 firequalizer

Прымяніць выраўноўванне FIR з выкарыстаннем адвольнай частотнай характарыстыкі.

Фільтр прымае наступныя параметры:

gain

Задайце ўраўненне крывой узмацнення (у дБ). Выраз можа ўтрымліваць зменныя:

f

ацэненая частата

sr

частата выбаркі

ch

нумар канала, усталяваны ў 0, калі шматканальная ацэнка адключана

chid

ідэнтыфікатар канала, гл. libavutil/channel_layout.h, усталяваны ў ідэнтыфікатар першага канала, калі шматканальная ацэнка адключана

chs

колькасць каналаў

chlayout

channel_layout, гл. libavutil/channel_layout.h

і функцыі:

gain_interpolate(f)

інтэрпаляваць узмацненне на частаце f на аснове ўводу_ўзмацнення

cubic_interpolate(f)

тое ж самае, што і інтэрпаляцыя_ўзмацнення, але больш гладкая

Гэтая опцыя таксама даступная як каманда. Па змаўчанні gain_interpolate(f).

gain_entry

Задаць запіс узмацнення для функцыі gain_interpolate. Выраз можа ўтрымліваць функцыі:

entry(f, g)

запіс узмацнення захоўвання на частаце f са значэннем g

Гэтая опцыя таксама даступная як каманда.

delay

Усталюйце затрымку фільтра ў секундах. Больш высокае значэнне азначае больш дакладныя. Па змаўчанні 0.01.

accuracy

Усталюйце дакладнасць фільтра ў Гц. Меншае значэнне азначае больш дакладнае. Па змаўчанні 5.

wfunc

Усталяваць функцыю акна. Дапушчальныя значэнні:

rectangular

прамавугольнае акно, карысна, калі крывая ўзмацнення ўжо гладкая

hann

акно Hann (па змаўчанні)

hamming

забіванне акна

blackman

акно Блэкмана

nuttall3

3-тэрміновае бесперапыннае акно першай вытворнай

mnuttall3

мінімальна 3-тэрміновае разрывістае акно

nuttall

4-тэрміновае бесперапыннае акно першай вытворнай

bnuttall

мінімальна 4 члены разрывістае акно nuttall (Blackman-nuttall).

bharris

акно Блэкмэна-Харыса

tukey

акно цюкі

fixed

Калі ўключана, выкарыстоўваць фіксаваную колькасць узораў аўдыя. Гэта павышае хуткасць пры фільтрацыі з вялікай затрымкай. Па змаўчанні адключана.

multi

Уключыць шматканальную ацэнку ўзмацнення. Па змаўчанні адключана.

zero_phase

Уключыце рэжым нулявой фазы, адняўшы метку часу, каб кампенсаваць затрымку. Па змаўчанні адключана.

scale

Задаць маштаб, які выкарыстоўваецца ўзмацненнем. Дапушчальныя значэнні:

linlin

лінейная частата, лінейнае ўзмацненне

linlog

лінейная частата, лагарыфмічны (у дБ) узмацненне (па змаўчанні)

loglin

лагарыфмічная (у актавай шкале, дзе 20 Гц роўна 0) частата, лінейнае ўзмацненне

loglog

лагарыфмічная частата, лагарыфмічнае ўзмацненне

dumpfile

Усталяваць файл для дампа, прыдатны для gnuplot.

dumpscale

Задаць маштаб для файла дампа. Дапушчальныя значэнні супадаюць з варыянтам маштабу. Па змаўчанні - linlog.

fft2

Уключыць 2-канальную згортку з выкарыстаннем комплекснага БПФ. Гэта значна павышае хуткасць. Па змаўчанні адключана.

min_phase

Уключыць мінімальную фазавую імпульсную характарыстыку. Па змаўчанні адключана.

8.84.1 Examples

  • НЧ на 1000 Гц:
    firequalizer=gain='if(lt(f,1000), 0, -INF)'
    
  • нізкія частоты на 1000 Гц з узмацненнем:
    firequalizer=gain_entry='entry(1000,0); entry(1001, -INF)'
    
  • карыстацкі эквалайзер:
    firequalizer=gain_entry='entry(100,0); entry(400, -4); entry(1000, -6); entry(2000, 0)'
    
  • больш высокая затрымка з нулявой фазай для кампенсацыі затрымкі:
    firequalizer=delay=0.1:fixed=on:zero_phase=on
    
  • НЧ на левым канале, ВЧ на правым канале:
    firequalizer=gain='if(eq(chid,1), gain_interpolate(f), if(eq(chid,2), gain_interpolate(1e6+f), 0))'
    :gain_entry='entry(1000, 0); entry(1001,-INF); entry(1e6+1000,0)':multi=on
    

8.85 flanger

Прымяніць эфект флэнджэр да аўдыя.

Фільтр прымае наступныя параметры:

delay

Задаць базавую затрымку ў мілісекундах. Дыяпазон ад 0 да 30. Значэнне па змаўчанні - 0.

depth

Усталюйце дадатковую затрымку разгорткі ў мілісекундах. Дыяпазон ад 0 да 10. Значэнне па змаўчанні - 2.

regen

Усталюйце працэнт рэгенерацыі (зваротная сувязь з затрымкай сігналу). Дыяпазон ад -95 да 95. Значэнне па змаўчанні - 0.

width

Усталюйце працэнт затрымкі сігналу, змешанага з арыгінальным. Дыяпазон ад 0 да 100. Значэнне па змаўчанні - 71.

speed

Усталюйце разгорткі ў секунду (Гц). Дыяпазон ад 0,1 да 10. Значэнне па змаўчанні 0,5.

shape

Усталюйце форму хвалі, можа быць triangularабо sinusoidal. Значэнне па змаўчанні - sinusoidal.

phase

Усталюйце працэнтны зрух хвалі для некалькіх каналаў. Дыяпазон ад 0 да 100. Значэнне па змаўчанні - 25.

interp

Усталюйце інтэрпаляцыю лініі затрымкі, linearабо quadratic. Па змаўчанні linear.

8.86 haas

Прымяніць эфект Хааса да аўдыя.

Звярніце ўвагу, што гэта найбольш разумна прымяняць да монасігналаў. З дапамогай гэтага фільтра, прымененага да монасігналаў, ён дае некаторую накіраванасць і расцягвае стэрэамалюнак.

Фільтр прымае наступныя параметры:

level_in

Задаць узровень уваходнага сігналу. Па змаўчанні гэта 1, або 0 дБ

level_out

Усталюйце ўзровень выхаду. Па змаўчанні гэта 1, або 0 дБ.

side_gain

Задаць узмацненне, якое прымяняецца да бакавой часткі сігналу. Па змаўчанні гэта 1.

middle_source

Усталюйце выгляд сярэдняй крыніцы. Можа быць адно з наступнага:

'left'

Выберыце левы канал.

'right'

Выберыце правільны канал.

'mid'

Абярыце сярэднюю частку сігналу стэрэа выявы.

'side'

Выберыце бакавую частку сігналу стэрэа выявы.

middle_phase

Змена сярэдняй фазы. Па змаўчанні адключана.

left_delay

Усталюйце затрымку левага канала. Па змаўчанні гэта 2.05мілісекунды.

left_balance

Усталюйце баланс левага канала. Па змаўчанні гэта -1.

left_gain

Усталюйце ўзмацненне левага канала. Па змаўчанні гэта 1.

left_phase

Змена левай фазы. Па змаўчанні адключана.

right_delay

Усталюйце затрымку правага канала. Па змаўчанні гэта 2.12мілісекунды.

right_balance

Усталюйце правільны баланс канала. Па змаўчанні гэта 1.

right_gain

Усталюйце правае ўзмацненне канала. Па змаўчанні гэта 1.

right_phase

Змяніць правую фазу. Па змаўчанні ўключана.

8.87 hdcd

Дэкадуе дадзеныя, сумяшчальныя з высокай выразнасцю (HDCD). 16-бітны струмень PCM з убудаванымі кодамі HDCD пашыраецца ў 20-бітны струмень PCM.

Фільтр падтрымлівае функцыі Peak Extend і Low-level Gain Adjustment для HDCD і вызначае сцяжок Transient Filter.

ffmpeg -i HDCD16.flac -af hdcd OUT24.flac

Пры выкарыстанні фільтра з wav звярніце ўвагу, што кадоўка па змаўчанні для wav - 16-бітная, таму атрыманы 20-бітны паток будзе абрэзаны назад да 16-бітнай. Выкарыстоўвайце нешта накшталт -acodec pcm_s24leпасля фільтра, каб атрымаць 24-бітны выхад PCM.

ffmpeg -i HDCD16.wav -af hdcd OUT16.wav
ffmpeg -i HDCD16.wav -af hdcd -c:a pcm_s24le OUT24.wav

Фільтр прымае наступныя параметры:

disable_autoconvert

Адключыце аўтаматычнае пераўтварэнне фармату або паўторную выбарку ў графіцы фільтра.

process_stereo

Апрацуйце стэрэаканалы разам. Калі target_gain не супадае паміж каналамі, лічыце яго несапраўдным і выкарыстоўвайце апошні сапраўдны target_gain.

cdt_ms

Усталюйце перыяд таймера выяўлення кода ў мс.

force_pe

Заўсёды пашырайце пікі вышэй -3dBFS, нават калі сігнал PE не падаецца.

analyze_mode

Заменіце гук суцэльным тонам і адрэгулюйце амплітуду, каб сігналізаваць аб пэўным аспекте працэсу дэкадавання. Выхадны файл можа быць загружаны ў аўдыярэдактар ​​разам з арыгіналам, каб дапамагчы аналізу.

analyze_mode=pe:force_pe=trueможна выкарыстоўваць для прагляду ўсіх узораў вышэй за ўзровень PE.

Рэжымы:

'0, off'

Інваліды

'1, lle'

Узровень рэгулявання ўзмацнення для кожнага ўзору

'2, pe'

Узоры, дзе адбываецца пашырэнне піку

'3, cdt'

Прыклады, у якіх актыўны таймер выяўлення кода

'4, tgm'

Узоры, дзе мэтавае ўзмацненне не супадае паміж каналамі

8.88 headphone

Ужывайце функцыі перадачы, звязаныя з галавой (HRTF), каб стварыць вакол карыстальніка віртуальныя гучнагаварыцелі для бінауральнага праслухоўвання праз навушнікі. HRIR забяспечваюцца праз дадатковыя патокі, для кожнага канала неабходны адзін ўваходны паток стэрэа.

Фільтр прымае наступныя параметры:

map

Задаць адлюстраванне ўваходных патокаў для згорткі. Аргумент уяўляе сабой раздзелены '|' спіс назваў каналаў у парадку, калі яны даюцца ў якасці дадатковых уваходных патокаў для фільтра. Гэта таксама вызначае колькасць уваходных патокаў. Колькасць уваходных патокаў павінна быць не менш за колькасць каналаў у першым патоку плюс адзін.

gain

Задаць узмацненне, прымененае да аўдыя. Значэнне ў дБ. Па змаўчанні 0.

type

Усталюйце тып апрацоўкі. Можа быць timeабо freq. timeпавольна апрацоўвае гук у часовай вобласці. freqхутка апрацоўвае гук у частотнай вобласці. Па змаўчанні freq.

lfe

Усталюйце карыстацкае ўзмацненне для каналаў LFE. Значэнне ў дБ. Па змаўчанні 0.

size

Задайце памер кадра ў колькасці выбарак, якія будуць апрацоўвацца адначасова. Значэнне па змаўчанні - 1024. Дазволены дыяпазон ад 1024 да 96000.

hrir

Ўсталяваць фармат патоку hrir. Значэнне па змаўчанні - stereo. Альтэрнатыўнае значэнне - multich. Калі значэнне ўстаноўлена ў stereo, колькасць дадатковых патокаў павінна быць большай або роўнай колькасці ўваходных каналаў у першым уваходным патоку. Таксама кожны дадатковы паток павінен мець стэрэа колькасць каналаў. Калі значэнне ўстаноўлена ў multich, колькасць дадатковых патокаў павінна быць дакладна адной. Таксама колькасць уваходных каналаў дадатковага патоку павінна быць роўным або перавышаць у два разы колькасць каналаў першага ўваходнага патоку.

8.88.1 Examples

  • Поўны прыклад выкарыстання файлаў wav у якасці каэфіцыентаў з фільтрамі amovie для паніжальнага мікшавання 7.1, кожны фільтр amovie выкарыстоўвае стэрэафайл з каэфіцыентамі IR у якасці ўваходных дадзеных. У файлах прыведзены каэфіцыенты для кожнай пазіцыі віртуальнага дынаміка:
    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
    
  • Поўны прыклад выкарыстання файлаў wav у якасці каэфіцыентаў з фільтрамі amovie для паніжальнага мікшавання 7.1, але цяпер у фармаце. multich hrir
    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
    

8.89 highpass

Прымяніце фільтр высокіх частот з кропкавай частатой 3 дБ. Фільтр можа быць як аднаполюсным, так і двухполюсным (па змаўчанні). Фільтр зніжаецца на 6 дБ на полюс на актаву (20 дБ на полюс за дзесяцігоддзе).

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце частату ў Гц. Па змаўчанні 3000.

poles, p

Усталюйце колькасць палюсоў. Па змаўчанні 2.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type. Ужываецца толькі для двухполюсных фільтраў. Значэнне па змаўчанні роўна 0,707q і дае адказ Батэрворта.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.89.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць частату высокіх частот. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні высокіх частот. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню высокіх частот. Сінтаксіс каманды: " width"

mix, m

Змяніць мікс высокіх частот. Сінтаксіс каманды: " mix"

8.90 join

Аб'яднайце некалькі ўваходных патокаў у адзін шматканальны паток.

Ён прымае наступныя параметры:

inputs

Колькасць уваходных патокаў. Па змаўчанні гэта 2.

channel_layout

Пажаданая схема выхаднога канала. Па змаўчанні стэрэа.

map

Карта каналаў ад уваходаў да выхаду. Аргумент уяўляе сабой падзелены '|' спіс супастаўленняў, кожнае ў форме. з'яўляецца індэксам ўваходнага патоку ад нуля. можа быць альбо назвай уваходнага канала (напрыклад, FL для пярэдніх левых), альбо яго індэксам у паказаным уваходным патоку. гэта назва выхаднога канала. input_idx.in_channel-out_channelinput_idxin_channelout_channel

Фільтр паспрабуе адгадаць супастаўленні, калі яны не пазначаны яўна. Ён робіць гэта, спачатку спрабуючы знайсці нявыкарыстаны адпаведны ўваходны канал, і калі гэта не атрымліваецца, выбірае першы нявыкарыстаны ўваходны канал.

Аб'яднанне 3 уваходаў (з правільна наладжанымі раскладкамі каналаў):

ffmpeg -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex join=inputs=3 OUTPUT

Стварыце выхад 5.1 з 6 аднаканальных патокаў:

ffmpeg -i fl -i fr -i fc -i sl -i sr -i lfe -filter_complex
'join=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'
out

8.91 ladspa

Загрузіце плагін LADSPA (Linux Audio Developer's Simple Plugin API).

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-ladspa.

file, f

Вызначае назву бібліятэкі плагінаў LADSPA для загрузкі. Калі LADSPA_PATHвызначана зменная асяроддзя, убудова LADSPA шукаецца ў кожным з каталогаў, вызначаных спісам, падзеленым двукроп'ем у LADSPA_PATH, у адваротным выпадку ў стандартных шляхах LADSPA, якія знаходзяцца ў наступным парадку:HOME/.ladspa/lib/,/usr/local/lib/ladspa/, /usr/lib/ladspa/.

plugin, p

Вызначае плагін у бібліятэцы. Некаторыя бібліятэкі ўтрымліваюць толькі адзін убудова, але іншыя ўтрымліваюць іх шмат. Калі гэта не ўстаноўлена, у фільтры будуць пералічаны ўсе даступныя плагіны ў названай бібліятэцы.

controls, c

Усталюйце '|' асобны спіс элементаў кіравання, якія ўяўляюць сабой нуль або больш значэнняў з плаваючай кропкай, якія вызначаюць паводзіны загружанага плагіна (напрыклад, затрымка, парог або ўзмацненне). Элементы кіравання неабходна вызначыць з дапамогай наступнага сінтаксісу: c0= value0|c1= value1|c2= value2|..., дзе valueiзначэнне, зададзенае для i-га элемента кіравання. У якасці альтэрнатывы яны таксама могуць быць вызначаны з дапамогай наступнага сінтаксісу: value0| value1| value2|..., дзе valueiзначэнне, устаноўленае для i-га элемента кіравання. Каліcontrolsусталявана ў значэнне help, друкуюцца ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны.

sample_rate, s

Укажыце частату дыскрэтызацыі, па змаўчанні 44100. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.

nb_samples, n

Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.

duration, d

Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра. Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна. Выкарыстоўваецца, толькі калі плагін не мае нулявых уводаў.

latency, l

Уключыць кампенсацыю затрымкі, па змаўчанні адключана. Выкарыстоўваецца, толькі калі плагін мае ўваходы.

8.91.1 Examples

  • Пералічыце ўсе даступныя ўбудовы ў бібліятэцы amp (прыклад убудовы LADSPA):
    ladspa=file=amp
    
  • Пералічыце ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны для vcf_notch плагіна з VCFбібліятэкі:
    ladspa=f=vcf:p=vcf_notch:c=help
    
  • Імітацыя аўдыяабсталявання нізкай якасці з дапамогай Computer Music Toolkitбібліятэкі плагінаў (CMT):
    ladspa=file=cmt:plugin=lofi:controls=c0=22|c1=12|c2=12
    
  • Дадайце рэверберацыю да аўдыя з дапамогай TAP-убудоў (убудовы Tom's Audio Processing):
    ladspa=file=tap_reverb:tap_reverb
    
  • Генераваць белы шум з амплітудай 0,2:
    ladspa=file=cmt:noise_source_white:c=c0=.2
    
  • Стварыце 20 удараў у хвіліну з дапамогай плагіна C* Click - Metronomeз C* Audio Plugin Suiteбібліятэкі (CAPS):
    ladspa=file=caps:Click:c=c1=20'
    
  • Ужыць C* Eq10X2 - Stereo 10-band equaliserэфект:
    ladspa=caps:Eq10X2:c=c0=-48|c9=-24|c3=12|c4=2
    
  • SWH PluginsПавялічце гучнасць на 20 дБ з дапамогай абмежавальніка хуткага прагляду з калекцыі Стыва Харыса :
    ladspa=fast_lookahead_limiter_1913:fastLookaheadLimiter:20|0|2
    
  • Знізьце нізкія частоты з дапамогай шматпалоснага эквалайзера з SWH Pluginsкалекцыі Стыва Харыса:
    ladspa=mbeq_1197:mbeq:-24|-24|-24|0|0|0|0|0|0|0|0|0|0|0|0
    
  • Паменшыць стэрэамалюнак з дапамогай Narrowerбібліятэкі C* Audio Plugin Suite (CAPS):
    ladspa=caps:Narrower
    
  • Яшчэ адзін белы шум, цяпер выкарыстоўваецца C* Audio Plugin Suiteбібліятэка (CAPS):
    ladspa=caps:White:.2
    
  • Трохі фрактальнага шуму з выкарыстаннем C* Audio Plugin Suiteбібліятэкі (CAPS):
    ladspa=caps:Fractal:c=c1=1
    
  • Дынамічная нармалізацыя гучнасці з дапамогай VLevelплагіна:
    ladspa=vlevel-ladspa:vlevel_mono
    

8.91.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

cN

Змяніць N-е кантрольнае значэнне.

Калі ўказанае значэнне несапраўднае, яно ігнаруецца і захоўваецца папярэдняе.

8.92 loudnorm

Нармалізацыя гучнасці EBU R128. Уключае як дынамічны, так і лінейны рэжымы нармалізацыі. Падтрымка рэжымаў аднаразовага праходу (жывыя трансляцыі, файлы) і двайнога праходу (файлы). Гэты алгарытм можа арыентавацца на IL, LRA і максімальны сапраўдны пік. У дынамічным рэжыме для дакладнага вызначэння сапраўдных пікаў гукавы паток будзе павялічвацца да 192 кГц. Скарыстайцеся -arопцыяй або aresampleфільтрам, каб відавочна задаць частату выбаркі вываду.

Фільтр прымае наступныя параметры:

I, i

Усталюйце інтэграваную мэтавую гучнасць. Дыяпазон -70,0 - -5,0. Значэнне па змаўчанні -24,0.

LRA, lra

Усталюйце мэтавы дыяпазон гучнасці. Дыяпазон 1,0 - 50,0. Значэнне па змаўчанні 7,0.

TP, tp

Усталюйце максімальны сапраўдны пік. Дыяпазон -9,0 - +0,0. Значэнне па змаўчанні -2,0.

measured_I, measured_i

Вымераны IL ўваходнага файла. Дыяпазон -99,0 - +0,0.

measured_LRA, measured_lra

Вымераная LRA ўваходнага файла. Дыяпазон 0,0 - 99,0.

measured_TP, measured_tp

Вымераны сапраўдны пік уваходнага файла. Дыяпазон -99,0 - +99,0.

measured_thresh

Вымераны парог уваходнага файла. Дыяпазон -99,0 - +0,0.

offset

Задаць узмацненне зрушэння. Узмацненне прымяняецца перад абмежавальнікам сапраўднага піку. Дыяпазон -99,0 - +99,0. Па змаўчанні +0,0.

linear

Нармалізацыя шляхам лінейнага маштабавання зыходнага гуку. measured_I, measured_LRA, measured_TP, і measured_threshўсе павінны быць указаны. Мэтавая LRA не павінна быць ніжэйшай за LRA крыніцы, а змяненне інтэграванай гучнасці не павінна прыводзіць да сапраўднага піка, які перавышае мэтавую TP. Калі якое-небудзь з гэтых умоў не выканана, рэжым нармалізацыі вернецца да dynamic. Варыянты trueабо false. Па змаўчанні true.

dual_mono

Разглядайце ўваходныя файлы мона як "двайны мона". Калі монафайл прызначаны для прайгравання на стэрэасістэме, яго вымярэнне EBU R128 будзе няправільным для ўспрымання. Калі ўсталявана true, гэты параметр будзе кампенсаваць гэты эфект. Гэтая опцыя не ўплывае на шматканальныя ўваходныя файлы. Варыянты ісціна і ілжыва. Па змаўчанні - false.

print_format

Задаць фармат друку для статыстыкі. Варыянты: зводка, json або ніводнага. Значэнне па змаўчанні - няма.

8.93 lowpass

Прымяненне фільтра нізкіх частот з кропкавай частатой 3 дБ. Фільтр можа быць як аднаполюсным, так і двухполюсным (па змаўчанні). Фільтр зніжаецца на 6 дБ на полюс на актаву (20 дБ на полюс за дзесяцігоддзе).

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце частату ў Гц. Па змаўчанні 500.

poles, p

Усталюйце колькасць палюсоў. Па змаўчанні 2.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Укажыце прапускную здольнасць фільтра ў адзінках width_type. Ужываецца толькі для двухполюсных фільтраў. Значэнне па змаўчанні роўна 0,707q і дае адказ Батэрворта.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.93.1 Examples

  • Нізкачастотны толькі канал LFE, яго LFE няма, ён нічога не робіць:
    lowpass=c=LFE
    

8.93.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змяніць частату нізкіх частот. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні нізкіх частот. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню нізкіх частот. Сінтаксіс каманды: " width"

mix, m

Змяніць мікс нізкіх частот. Сінтаксіс каманды: " mix"

8.94 lv2

Загрузіце плагін LV2 (LADSPA версія 2).

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-lv2.

plugin, p

Вызначае URI плагіна. Магчыма, вам спатрэбіцца экранаваць ':'.

controls, c

Усталюйце '|' асобны спіс элементаў кіравання, якія ўяўляюць сабой нуль або больш значэнняў з плаваючай кропкай, якія вызначаюць паводзіны загружанага плагіна (напрыклад, затрымка, парог або ўзмацненне). Каліcontrolsусталявана ў значэнне help, друкуюцца ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны.

sample_rate, s

Укажыце частату дыскрэтызацыі, па змаўчанні 44100. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.

nb_samples, n

Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.

duration, d

Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра. Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна. Выкарыстоўваецца, толькі калі плагін не мае нулявых уводаў.

8.94.1 Examples

  • Прымяніць плагін для ўзмацнення басу ад Calf:
    lv2=p=http\\\\://calf.sourceforge.net/plugins/BassEnhancer:c=amount=2
    
  • Прымяніць вінілавы плагін ад Calf:
    lv2=p=http\\\\://calf.sourceforge.net/plugins/Vinyl:c=drone=0.2|aging=0.5
    
  • Прымяніць убудова драбнілку біт ад ArtyFX:
    lv2=p=http\\\\://www.openavproductions.com/artyfx#bitta:c=crush=0.3
    

8.94.2 Commands

Гэты фільтр падтрымлівае ўсе параметры, якія экспартуюцца ўбудовай у выглядзе каманд.

8.95 mcompand

Шматпалосны Сціск або пашырэнне дынамічнага дыяпазону гуку.

Уваходны гук падзелены на дыяпазоны з дапамогай IIR Лінквіца-Райлі 4-га парадку. Гэта падобна на кросовер гучнагаварыцеля і прыводзіць да роўнай частотнай характарыстыкі пры адсутнасці дзеяння кампанера.

Ён прымае наступныя параметры:

args

Сінтаксіс гэтага параметра: атака, заняпад, [атака, заняпад..] кропкі мяккага калена перакрыжаваная_частата [затрымка [пачатковы_аб'ём [узмацненне]]] | атака, распад ... Для тлумачэнняў кожнага элемента звярніцеся да кампазіцыйнай дакументацыі па фільтрах.

8.96 pan

Змешвайце каналы з пэўнымі ўзроўнямі ўзмацнення. Фільтр прымае макет выхаднога канала, за якім ідзе набор азначэнняў каналаў.

Гэты фільтр таксама прызначаны для эфектыўнага пераназначэння каналаў аўдыёпатоку.

Фільтр прымае параметры выгляду: " l| outdef| outdef|..."

l

размяшчэнне выхаднога канала або колькасць каналаў

outdef

спецыфікацыя выхаднога канала ў выглядзе: " out_name=[ gain*] in_name[(+-)[ gain*] in_name...]"

out_name

выхадны канал для вызначэння альбо назвы канала (FL, FR і г.д.), альбо нумара канала (c0, c1 і г.д.)

gain

мультыплікатыўны каэфіцыент для канала, 1 пакідаючы аб'ём нязменным

in_name

уваходны канал для выкарыстання, падрабязнасці гл. out_name; немагчыма змяшаць названыя і пранумараваныя ўваходныя каналы

Калі '=' у спецыфікацыі канала замяняецца на '<', то каэфіцыент узмацнення для гэтай спецыфікацыі будзе перанармалізаваны так, каб агульная сума была роўная 1, што дазваляе пазбегнуць шуму адсячэння.

8.96.1 Mixing examples

Напрыклад, калі вы хочаце панізіць мікшаванне са стэрэа ў мона, але з большым каэфіцыентам для левага канала:

pan=1c|c0=0.9*c0+0.1*c1

Індывідуальнае звядзенне да стэрэа, якое працуе аўтаматычна для 3-, 4-, 5- і 7-канальнага аб'ёмнага гуку:

pan=stereo| FL < FL + 0.5*FC + 0.6*BL + 0.6*SL | FR < FR + 0.5*FC + 0.6*BR + 0.6*SR

Звярніце ўвагу, што ffmpegінтэгруецца стандартная сістэма паніжаючага (і павышаючага) мікшавання, якой варта аддаць перавагу (гл. опцыю "-ac"), калі толькі ў вас няма асаблівых патрэб.

8.96.2 Remapping examples

Пераназначэнне канала будзе эфектыўным тады і толькі тады, калі:

  • каэфіцыенты ўзмацнення - нулі або адзінкі,
  • толькі адзін уваход на кожны выхад канала,

Калі ўсе гэтыя ўмовы выкананы, фільтр паведаміць карыстальніку ("Выяўлена чыстае адлюстраванне канала") і выкарыстае аптымізаваны метад без страт для выканання перапрызначэння.

Напрыклад, калі ў вас ёсць крыніца 5.1 і вы хочаце атрымаць стэрэааўдыяструмень, адмяніўшы дадатковыя каналы:

pan="stereo| c0=FL | c1=FR"

Улічваючы адну і тую ж крыніцу, вы таксама можаце пераключыць пярэдні левы і пярэдні правы каналы і захаваць размяшчэнне ўваходных каналаў:

pan="5.1| c0=c1 | c1=c0 | c2=c2 | c3=c3 | c4=c4 | c5=c5"

Калі ўваходны сігнал з'яўляецца стэрэааўдыяпатокам, вы можаце адключыць гук пярэдняга левага канала (і пры гэтым захаваць макет стэрэаканалаў) з дапамогай:

pan="stereo|c1=c1"

Тым не менш з уваходам стэрэааўдыёпатоку, вы можаце скапіяваць правы канал як у пярэдні левы, так і ў правы бок:

pan="stereo| c0=FR | c1=FR"

8.97 replaygain

Фільтр сканэра ReplayGain. Гэты фільтр прымае аўдыёпаток у якасці ўваходных дадзеных і выводзіць яго без зменаў. У канцы фільтрацыі адлюстроўваецца track_gainі track_peak.

8.98 resample

Пераўтварэнне фармату выбаркі аўдыя, частаты дыскрэтызацыі і макета канала. Ён не прызначаны для непасрэднага выкарыстання.

8.99 rubberband

Ужывайце расцяжку часу і вышыню тону з дапамогай librubberband.

Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-librubberband.

Фільтр прымае наступныя параметры:

tempo

Задаць маштабны каэфіцыент тэмпу.

pitch

Задаць маштабны каэфіцыент кроку.

transients

Усталяваць дэтэктар пераходных працэсаў. Магчымыя значэнні:

crisp
mixed
smooth
detector

Усталяваць дэтэктар. Магчымыя значэнні:

compound
percussive
soft
phase

Задаць фазу. Магчымыя значэнні:

laminar
independent
window

Задаць памер акна апрацоўкі. Магчымыя значэнні:

standard
short
long
smoothing

Ўсталяваць згладжванне. Магчымыя значэнні:

off
on
formant

Уключыць захаванне фарманты пры зруху. Магчымыя значэнні:

shifted
preserved
pitchq

Задаць якасць тону. Магчымыя значэнні:

quality
speed
consistency
channels

Наладзіць каналы. Магчымыя значэнні:

apart
together

8.99.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

tempo

Змяніць каэфіцыент маштабу тэмпу фільтра. Сінтаксіс каманды: " tempo"

pitch

Змяніць маштабны каэфіцыент кроку фільтра. Сінтаксіс каманды: " pitch"

8.100 sidechaincompress

Гэты фільтр дзейнічае як звычайны кампрэсар, але мае магчымасць сціскаць выяўлены сігнал з дапамогай другога ўваходнага сігналу. Ён мае патрэбу ў двух уваходных патоках і вяртае адзін выходны паток. Першы ўваходны паток будзе апрацоўвацца ў залежнасці ад сігналу другога патоку. Затым адфільтраваны сігнал можа быць адфільтраваны іншымі фільтрамі на наступных этапах апрацоўкі. Глядзіце фільтр для патэльні і амерыджа .

Фільтр прымае наступныя параметры:

level_in

Задаць уваходнае ўзмацненне. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.

mode

Ўсталяваць рэжым працы кампрэсара. Можа быць upwardабо downward. Па змаўчанні downward.

threshold

Калі сігнал другога патоку падымаецца вышэй за гэты ўзровень, гэта паўплывае на зніжэнне ўзмацнення першага патоку. Па змаўчанні 0,125. Дыяпазон ад 0,00097563 да 1.

ratio

Усталюйце каэфіцыент, пры якім паніжаецца сігнал. 1:2 азначае, што калі ўзровень падняўся на 4 дБ вышэй парога, то пасля зніжэння ён будзе вышэй толькі на 2 дБ. Па змаўчанні - 2. Дыяпазон - ад 1 да 20.

attack

Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым пачнецца зніжэнне ўзмацнення. Па змаўчанні - 20. Дыяпазон - ад 0,01 да 2000.

release

Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў паменшыцца. Па змаўчанні - 250. Дыяпазон - ад 0,01 да 9000.

makeup

Усталюйце колькасць, наколькі сігнал будзе ўзмоцнены пасля апрацоўкі. Па змаўчанні 1. Дыяпазон ад 1 да 64.

knee

Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,82843. Дыяпазон ад 1 да 8.

link

Выберыце, калі averageўзровень паміж усімі каналамі патоку бакавога ланцуга ці больш гучны ( maximum) канал патоку бакавога ланцуга ўплывае на зніжэнне. Па змаўчанні average.

detection

Калі браць дакладны сігнал у выпадку peakабо RMS ў выпадку rms. Па змаўчанні - гэта тое, rmsшто ў асноўным больш гладкае.

level_sc

Усталюйце ўзмацненне сайдчэйна. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.

mix

Колькі выкарыстоўваць сціснуты сігнал у вывадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

8.100.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.100.2 Examples

  • Поўны прыклад ffmpeg з 2 аўдыяўваходамі, 1-ы ўваход сціскаецца ў залежнасці ад сігналу 2-га ўваходу, а пазней сціснуты сігнал аб'ядноўваецца з 2-м уваходам:
    ffmpeg -i main.flac -i sidechain.flac -filter_complex "[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress[compr];[compr][mix]amerge"
    

8.101 sidechaingate

Гейт бакавой ланцуга дзейнічае як звычайны (шырокапалосны) гейт, але мае магчымасць фільтраваць выяўлены сігнал перад адпраўкай яго на этап памяншэння ўзмацнення. Звычайна гейт выкарыстоўвае сігнал поўнага дыяпазону, каб выявіць узровень вышэй парога. Напрыклад: калі вы выразаеце ўсе нізкія частоты са свайго сайдчэйн-сігналу, гейт зменшыць гучнасць вашага трэка толькі ў тым выпадку, калі з'явіцца недастаткова высокіх частот. З дапамогай гэтай тэхнікі вы можаце паменшыць рэзананс натуральнага барабана або прыбраць "грукатанне" прыглушаных удараў моцна скажонай гітары. Ён мае патрэбу ў двух уваходных патоках і вяртае адзін выходны паток. Першы ўваходны паток будзе апрацоўвацца ў залежнасці ад сігналу другога патоку.

Фільтр прымае наступныя параметры:

level_in

Усталюйце ўваходны ўзровень перад фільтрацыяй. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.

mode

Усталюйце рэжым працы. Можа быць upwardабо downward. Па змаўчанні downward. Калі ўсталяваны upwardрэжым, больш высокія часткі сігналу будуць узмацняцца, пашыраючы дынамічны дыяпазон уверх. У адваротным выпадку ў выпадку downwardніжніх частак сігнал будзе зніжаны.

range

Усталюйце ўзровень зніжэння ўзмацнення, калі сігнал ніжэйшы за парог. Па змаўчанні 0,06125. Дазволены дыяпазон ад 0 да 1. Усталёўка гэтага значэння ў 0 адключае скарачэнне, а затым фільтр паводзіць сябе як пашыральнік.

threshold

Калі сігнал падымаецца вышэй за гэты ўзровень, зніжэнне ўзмацнення адключаецца. Па змаўчанні 0,125. Дазволены дыяпазон ад 0 да 1.

ratio

Усталюйце каэфіцыент, пры якім паніжаецца сігнал. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 9000.

attack

Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым зніжэнне ўзмацнення спыніцца. Па змаўчанні 20 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.

release

Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў павялічыцца. Па змаўчанні 250 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.

makeup

Задаць велічыню ўзмацнення сігналу пасля апрацоўкі. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64.

knee

Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,828427125. Дазволены дыяпазон ад 1 да 8.

detection

Выберыце, ці трэба браць для выяўлення дакладны сігнал або падобны да RMS. Па змаўчанні - сярэдняя квадратура. Можа быць пікавым або сярэднеквадратычным.

link

Выберыце, калі сярэдні ўзровень паміж усімі каналамі ці больш гучны канал уплывае на зніжэнне. Па змаўчанні сярэдні. Можа быць сярэднім або максімальным.

level_sc

Усталюйце ўзмацненне сайдчэйна. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.

8.101.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.102 silencedetect

Выяўленне цішыні ў аўдыяплыні.

Гэты фільтр рэгіструе паведамленне, калі выяўляе, што гучнасць уваходнага гуку меншая або роўная значэнню дапушчальнага шуму на працягу часу, большага або роўнага мінімальнай выяўленай працягласці шуму.

Надрукаваны час і працягласць выражаны ў секундах. Ключ метаданых lavfi.silence_startor lavfi.silence_start.Xусталёўваецца на першым кадры, часовая пазнака якога роўная або перавышае працягласць выяўлення, і змяшчае пазнаку часу першага кадра маўчання.

lavfi.silence_durationКлючы метададзеных або і lavfi.silence_duration.X або ўсталёўваюцца на першым кадры пасля маўчання lavfi.silence_end. lavfi.silence_end.XКаліmonoуключана, і кожны канал ацэньваецца асобна, выкарыстоўваюцца .X ключы з суфіксам і Xадпавядае нумару канала.

Фільтр прымае наступныя параметры:

noise, n

Усталюйце шумацярпімасць. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Па змаўчанні - -60 дБ, або 0,001.

duration, d

Усталюйце працягласць цішыні да паведамлення (па змаўчанні 2 секунды). Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

mono, m

Апрацоўвайце кожны канал асобна, а не аб'ядноўвайце. Па змаўчанні адключана.

8.102.1 Examples

  • Вызначце 5 секунд цішыні з устойлівасцю да шуму -50 дБ:
    silencedetect=n=-50dB:d=5
    
  • Поўны прыклад з ffmpegвыяўленнем цішыні з 0,0001 шумацярпімасціsilence.mp3:
    ffmpeg -i silence.mp3 -af silencedetect=noise=0.0001 -f null -
    

8.103 silenceremove

Выдаліць цішыню ў пачатку, сярэдзіне або канцы аўдыя.

Фільтр прымае наступныя параметры:

start_periods

Гэта значэнне выкарыстоўваецца, каб паказаць, ці трэба абрэзаць аўдыя ў пачатку аўдыя. Нулявое значэнне азначае, што маўчанне не павінна быць абрэзана з самага пачатку. Пры ўказанні адрознага ад нуля значэння гук абразаецца, пакуль не будзе выяўлена адсутнасць цішыні. Звычайна пры абрэзцы цішыні ад пачатку аўдыя start_periodsбудзе, 1але яе можна павялічыць да больш высокіх значэнняў, каб скараціць усе аўдыя да пэўнай колькасці перыядаў без цішыні. Значэнне па змаўчанні - 0.

start_duration

Укажыце прамежак часу, на працягу якога павінна быць выяўлена адсутнасць цішыні, перш чым яно спыніць абразанне гуку. Павялічваючы працягласць, серыі шумоў можна разглядаць як цішыню і адключаць. Значэнне па змаўчанні - 0.

start_threshold

Гэта паказвае, якое значэнне выбаркі трэба разглядаць як маўчанне. Для лічбавага аўдыя значэнне 0можа падысці, але для аўдыя, запісанага з аналагавага, вы можаце павялічыць значэнне для ўліку фонавага шуму. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Значэнне па змаўчанні - 0.

start_silence

Укажыце максімальную працягласць цішыні ў пачатку, якая будзе захоўвацца пасля абрэзкі. Па змаўчанні значэнне 0, што роўна абразанню ўсіх узораў, выяўленых як цішыня.

start_mode

Укажыце рэжым вызначэння канца цішыні ў пачатку шматканальнага гуку. Можа быць anyабо all. Па змаўчанні any. З anyлюбым узорам, які выяўлены як нецішыня, будзе спынена абразанне цішыні. З all, толькі калі ўсе каналы выяўлены як нецішыня, гэта прывядзе да спынення абрэзкі цішыні.

stop_periods

Усталюйце лік для абрэзкі цішыні з канца аўдыя. Каб выдаліць маўчанне з сярэдзіны файла, укажыце stop_periods адмоўны. Затым гэтае значэнне разглядаецца як станоўчае і выкарыстоўваецца для ўказання, што эфект павінен перазапусціць апрацоўку, як вызначана start_periods, што робіць яго прыдатным для выдалення перыядаў цішыні ў сярэдзіне аўдыя. Значэнне па змаўчанні - 0.

stop_duration

Укажыце працягласць цішыні, якая павінна існаваць, перш чым аўдыя больш не будзе капіравацца. Пры ўказанні большай працягласці ў аўдыя можна пакінуць жаданую цішыню. Значэнне па змаўчанні - 0.

stop_threshold

Гэта тое самае, штоstart_thresholdале для абрэзкі цішыні ў канцы аўдыё. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Значэнне па змаўчанні - 0.

stop_silence

Укажыце максімальную працягласць цішыні ў канцы, якая будзе захоўвацца пасля абрэзкі. Па змаўчанні значэнне 0, што роўна абразанню ўсіх узораў, выяўленых як цішыня.

stop_mode

Укажыце рэжым вызначэння пачатку цішыні ў канцы шматканальнага гуку. Можа быць anyабо all. Па змаўчанні any. З anyлюбым узорам, які выяўлены як нецішыня, будзе спынена абразанне цішыні. З all, толькі калі ўсе каналы выяўлены як нецішыня, гэта прывядзе да спынення абрэзкі цішыні.

detection

Усталюйце спосаб выяўлення цішыні. Можа быць rmsабо peak. Другі хутчэй і лепш працуе з лічбавай цішынёй, роўнай 0. Значэнне па змаўчанні роўна rms.

window

Задаць працягласць у колькасці секунд, якая выкарыстоўваецца для разліку памеру акна ў колькасці выбарак для выяўлення цішыні. Значэнне па змаўчанні - 0.02. Дазволены дыяпазон ад 0да 10.

8.103.1 Examples

  • Наступны прыклад паказвае, як можна выкарыстоўваць гэты фільтр для пачатку запісу, які не ўтрымлівае затрымкі ў пачатку, якая звычайна ўзнікае паміж націскам кнопкі запісу і пачаткам выканання:
    silenceremove=start_periods=1:start_duration=5:start_threshold=0.02
    
  • Абрэжце ўсю цішыню ад пачатку да канца, дзе маўчанне больш за 1 секунду ў аўдыя:
    silenceremove=stop_periods=-1:stop_duration=1:stop_threshold=-90dB
    
  • Абрэжце ўсе лічбавыя выбаркі цішыні, выкарыстоўваючы выяўленне пікаў, ад пачатку да канца, калі ёсць больш за 0 выбарак лічбавай цішыні ў аўдыя і лічбавая цішыня выяўляецца ва ўсіх каналах у аднолькавых месцах у патоку:
    silenceremove=window=0:detection=peak:stop_mode=all:start_mode=all:stop_periods=-1:stop_threshold=0
    

8.104 sofalizer

SOFAlizer выкарыстоўвае функцыі перадачы, звязаныя з галавой (HRTF), каб стварыць вакол карыстальніка віртуальныя гучнагаварыцелі для бінауральнага праслухоўвання праз навушнікі (падтрымліваюцца аўдыяфарматы да 9 каналаў). HRTF захоўваюцца ў файлах SOFA (гл . базу дадзеных http://www.sofacoustics.org/ ). SOFAlizer распрацаваны Інстытутам даследаванняў акустыкі (ARI) Аўстрыйскай акадэміі навук.

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-libmysofa.

Фільтр прымае наступныя параметры:

sofa

Усталюйце файл SOFA, які выкарыстоўваецца для візуалізацыі.

gain

Задаць узмацненне, прымененае да аўдыя. Значэнне ў дБ. Па змаўчанні 0.

rotation

Задаць паварот віртуальных дынамікаў у градусах. Па змаўчанні 0.

elevation

Задаць вышыню віртуальных дынамікаў у градусах. Па змаўчанні 0.

radius

Усталюйце адлегласць у метрах паміж дынамікамі і слухачом з HRTF блізкага поля. Па змаўчанні 1.

type

Усталюйце тып апрацоўкі. Можа быць timeабо freq. timeпавольна апрацоўвае гук у часовай вобласці. freqхутка апрацоўвае гук у частотнай вобласці. Па змаўчанні freq.

speakers

Усталюйце ўласныя пазіцыі віртуальных дынамікаў. Сінтаксіс гэтай опцыі: <CH> <AZIM> <ELEV>[|<CH> <AZIM> <ELEV>|...]. Кожны віртуальны гучнагаварыцель апісваецца кароткай назвай канала з указаннем азімута і кута ў градусах. Кожнае апісанне віртуальнага гучнагаварыцеля аддзяляецца знакам '|'. Напрыклад, каб перавызначыць пазіцыі пярэдняга левага і пярэдняга правага каналаў, выкарыстоўвайце: «дынамікі=FL 45 15|FR 345 15». Апісанні з нераспазнанымі назвамі каналаў ігнаруюцца.

lfegain

Усталюйце карыстацкае ўзмацненне для каналаў LFE. Значэнне ў дБ. Па змаўчанні 0.

framesize

Усталюйце нестандартны памер кадра ў колькасці ўзораў. Па змаўчанні 1024. Дазволены дыяпазон ад 1024 да 96000. Выкарыстоўваецца, толькі калі параметр 'type' усталяваны ў freq.

normalize

Ці варта нармалізаваць усе IR пасля імпарту файла SOFA. Па змаўчанні ўключана.

interpolate

Ці варта інтэрпаляваць бліжэйшыя IR з суседнімі IR, калі дакладная пазіцыя не супадае. Па змаўчанні адключана.

minphase

Мінфаза ўсіх IR пры загрузцы файла SOFA. Па змаўчанні адключана.

anglestep

Усталюйце крок суседняга вугла пошуку. Выкарыстоўваецца, толькі калі опцыя interpolateўключана.

radstep

Задаць крок радыуса пошуку суседзяў. Выкарыстоўваецца, толькі калі опцыя interpolateўключана.

8.104.1 Examples

  • Выкарыстанне файла канапы ClubFritz6:
    sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=1
    
  • Выкарыстанне файла для канапы ClubFritz12 і большага радыусу з невялікім паваротам:
    sofalizer=sofa=/path/to/ClubFritz12.sofa:type=freq:radius=2:rotation=5
    
  • Падобна вышэйзгаданаму, але з нестандартным размяшчэннем дынамікаў для пярэдняга левага, пярэдняга правага, задняга левага і задняга правага, а таксама з нестандартным узмацненнем:
    "sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=2:speakers=FL 45|FR 315|BL 135|BR 225:gain=28"
    

8.105 speechnorm

Нармалізатар прамовы.

Гэты фільтр пашырае або сціскае кожны паўцыкл аўдыясэмплоў (лакальны набор сэмплоў, усе вышэй або ніжэй за нуль і паміж двума бліжэйшымі перасячэннямі нуля) у залежнасці ад парогавага значэння, так што гук дасягае мэтавага пікавага значэння ва ўмовах, якія кантралююцца прыведзенымі ніжэй параметрамі.

Фільтр прымае наступныя параметры:

peak, p

Усталюйце мэтавае пікавае значэнне пашырэння. Гэта вызначае самы высокі дазволены абсалютны ўзровень амплітуды для нармалізаванага ўваходнага гуку. Значэнне па змаўчанні 0,95. Дазволены дыяпазон ад 0,0 да 1,0.

expansion, e

Усталюйце максімальны каэфіцыент пашырэння. Дапушчальны дыяпазон ад 1,0 да 50,0. Значэнне па змаўчанні 2.0. Гэты параметр кантралюе максімальны лакальны паўцыкл пашырэння выбарак. Максімальнае пашырэнне будзе такім, каб лакальнае пікавае значэнне дасягала мэтавага пікавага значэння, але ніколі не перавышала яго, і каб суадносіны паміж новым і папярэднім пікавым значэннем не перавышалі гэтае значэнне опцыі.

compression, c

Усталюйце максімальны каэфіцыент сціску. Дапушчальны дыяпазон ад 1,0 да 50,0. Значэнне па змаўчанні 2.0. Гэты параметр кантралюе максімальны лакальны паўцыкл сціску ўзораў. Гэты параметр выкарыстоўваецца толькі ў тым выпадку, каліthresholdпараметр усталяваны на значэнне большае за 0,0, тады ў такіх выпадках, калі лакальны пік ніжэйшы або такі ж, як значэнне, зададзенаеthresholdусе ўзоры, якія адносяцца да паўцыкла гэтага піка, будуць сціснуты бягучым каэфіцыентам сціску.

threshold, t

Усталюйце парогавае значэнне. Значэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0. Гэты параметр вызначае, якія паўцыклы ўзораў будуць сціснуты, а якія разгорнуты. Любыя ўзоры паўцыкла з лакальным пікавым значэннем ніжэй або такім жа, як значэнне гэтага параметра, будуць сціснуты бягучым каэфіцыентам сціску, у адваротным выпадку, калі больш парогавага значэння, яны будуць пашыраны каэфіцыентам пашырэння, каб ён мог дасягнуць пікавага мэтавага значэння, але ніколі не перавышаць гэта.

raise, r

Усталюйце колькасць павышэння пашырэння на кожны паўцыкл узораў. Значэнне па змаўчанні 0,001. Дазволены дыяпазон ад 0,0 да 1,0. Гэта кантралюе хуткасць павышэння каэфіцыента пашырэння за кожны новы паўцыкл, пакуль ён не дасягнеexpansionзначэнне. Занадта высокія параметры могуць прывесці да скажэнняў.

fall, f

Усталюйце ступень павышэння сціску на кожны паўцыкл выбарак. Значэнне па змаўчанні 0,001. Дазволены дыяпазон ад 0,0 да 1,0. Гэта кантралюе хуткасць павышэння каэфіцыента сціску за кожны новы паўцыкл, пакуль ён не дасягнеcompressionзначэнне.

channels, h

Укажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя каналы.

invert, i

Уключыць інвертаваную фільтрацыю, па змаўчанні адключана. Гэта пераварочвае інтэрпрэтацыюthreshold варыянт. Калі ўключаны любы паўцыкл узораў з лакальным пікавым значэннем ніжэйшым або такім жа, як thresholdопцыя будзе пашырана, інакш яна будзе сціснута.

link, l

Звязваць каналы пры разліку ўзмацнення, якое прымяняецца да кожнай адфільтраванай выбаркі канала, па змаўчанні адключана. Калі гэты параметр адключаны, разлік узмацнення кожнага адфільтраванага канала незалежны, у адваротным выпадку, калі гэты параметр уключаны, выкарыстоўваецца мінімум з усіх магчымых узмацненняў для кожнага адфільтраванага канала.

8.105.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.106 stereotools

Гэты фільтр мае некаторыя зручныя ўтыліты для кіравання стэрэасігналамі, для пераўтварэння стэрэазапісаў M/S у сігнал L/R, адначасова маючы кантроль над параметрамі або распаўсюджванне стэрэа выявы майстар-трэка.

Фільтр прымае наступныя параметры:

level_in

Усталюйце ўваходны ўзровень перад фільтрацыяй для абодвух каналаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,015625 да 64.

level_out

Усталюйце выхадны ўзровень пасля фільтрацыі для абодвух каналаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,015625 да 64.

balance_in

Усталюйце ўваходны баланс паміж абодвума каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

balance_out

Усталюйце выхадны баланс паміж абодвума каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

softclip

Уключыць softclipping. Вынікі аналагавых скажэнняў замест рэзкага лічбавага адсячэння 0 дБ. Па змаўчанні адключана.

mutel

Адключыць левы канал. Па змаўчанні адключана.

muter

Адключыць правы канал. Па змаўчанні адключана.

phasel

Змяніць фазу левага канала. Па змаўчанні адключана.

phaser

Змяніць фазу правага канала. Па змаўчанні адключана.

mode

Усталюйце стэрэарэжым. Даступныя значэнні:

'lr>lr'

Злева/справа налева/направа, гэта па змаўчанні.

'lr>ms'

Злева/справа ў сярэдзіну/збоку.

'ms>lr'

Пасярэдзіне/збоку налева/направа.

'lr>ll'

Злева/справа налева/налева.

'lr>rr'

Злева/справа направа/направа.

'lr>l+r'

Злева/справа налева + направа.

'lr>rl'

Злева/справа направа/налева.

'ms>ll'

З сярэдзіны/збоку налева/налева.

'ms>rr'

Пасярэдзіне/збоку направа/направа.

'ms>rl'

Пасярэдзіне/збоку направа/налева.

'lr>l-r'

Злева/справа налева - направа.

slev

Усталюйце ўзровень бакавога сігналу. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.

sbal

Усталюйце баланс бакавога сігналу. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

mlev

Усталюйце ўзровень сярэдняга сігналу. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.

mpan

Усталюйце сярэднюю сігнальную панараму. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

base

Усталюйце базу стэрэа паміж мона і інверснымі каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

delay

Усталюйце затрымку ў мілісекундах, колькі затрымкі злева ад правага канала і наадварот. Па змаўчанні 0. Дазволены дыяпазон ад -20 да 20.

sclevel

Усталюйце ўзровень S/C. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 100.

phase

Усталюйце фазу стэрэа ў градусах. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 360.

bmode_in, bmode_out

Усталюйце рэжым балансу для параметра balance_in/balance_out.

Можа быць адно з наступнага:

'balance'

Класічны рэжым балансу. Аслабляйце па адным канале. Выйгрыш павялічваецца да 1.

'amplitude'

Падобны да класічнага рэжыму вышэй, але ўзмацненне павышана да 2.

'power'

Раўнамернае размеркаванне магутнасці, дыяпазон ад -6 дБ да +6 дБ.

8.106.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

8.106.2 Examples

  • Прымяніць эфект караоке:
    stereotools=mlev=0.015625
    
  • Пераўтварэнне сігналу M/S у L/R:
    "stereotools=mode=ms>lr"
    

8.107 stereowiden

Гэты фільтр узмацняе стэрэаэфект, падаўляючы сігнал, агульны для абодвух каналаў, і затрымліваючы сігнал з левага на правы і наадварот, тым самым пашыраючы стэрээфект.

Фільтр прымае наступныя параметры:

delay

Час у мілісекундах затрымкі левага сігналу ў правы і наадварот. Па змаўчанні 20 мілісекунд.

feedback

Велічыня ўзмацнення затрыманага сігналу ў правы і наадварот. Дае эфект затрымкі левага сігналу ў правым выхадзе і наадварот, што дае эфект пашырэння. Па змаўчанні 0,3.

crossfeed

Перакрыжаваная падача злева направа з перавернутай фазай. Гэта дапамагае ў падаўленні мона. Калі значэнне роўна 1, гэта адменіць увесь сігнал, агульны для абодвух каналаў. Па змаўчанні 0,3.

drymix

Усталюйце ўзровень уваходнага сігналу зыходнага канала. Па змаўчанні 0,8.

8.107.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры, за delayвыключэннем каманд .

8.108 superequalizer

Прымяніць 18-палосны эквалайзер.

Фільтр прымае наступныя параметры:

1b

Усталюйце ўзмацненне дыяпазону 65 Гц.

2b

Усталюйце ўзмацненне дыяпазону 92 Гц.

3b

Усталюйце ўзмацненне дыяпазону 131 Гц.

4b

Усталюйце ўзмацненне дыяпазону 185 Гц.

5b

Усталюйце ўзмацненне дыяпазону 262 Гц.

6b

Усталюйце ўзмацненне дыяпазону 370 Гц.

7b

Усталюйце ўзмацненне дыяпазону 523 Гц.

8b

Усталюйце ўзмацненне дыяпазону 740 Гц.

9b

Усталюйце ўзмацненне дыяпазону 1047 Гц.

10b

Усталюйце ўзмацненне дыяпазону 1480 Гц.

11b

Усталюйце ўзмацненне дыяпазону 2093 Гц.

12b

Усталюйце ўзмацненне дыяпазону 2960 Гц.

13b

Усталюйце ўзмацненне дыяпазону 4186 Гц.

14b

Усталюйце ўзмацненне дыяпазону 5920 Гц.

15b

Усталюйце ўзмацненне дыяпазону 8372 Гц.

16b

Усталюйце ўзмацненне дыяпазону 11840 Гц.

17b

Усталюйце ўзмацненне дыяпазону 16744 Гц.

18b

Усталюйце ўзмацненне дыяпазону 20000 Гц.

8.109 surround

Прымяніць фільтр павышаючага мікшавання аб'ёмнага гуку.

Гэты фільтр дазваляе вырабляць шматканальны вывад з аўдыяструменю.

Фільтр прымае наступныя параметры:

chl_out

Усталюйце схему выходнага канала. Па змаўчанні гэта 5.1.

Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .

chl_in

Задаць схему ўваходнага канала. Па змаўчанні гэта stereo.

Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .

level_in

Усталюйце ўзровень гучнасці ўводу. Па змаўчанні гэта 1.

level_out

Усталюйце ўзровень гучнасці выхаду. Па змаўчанні гэта 1.

lfe

Уключыць выхад канала LFE, калі ён ёсць у кампаноўцы выхаднога канала. Па змаўчанні гэта ўключана.

lfe_low

Усталюйце нізкую частату зрэзу LFE. Па змаўчанні гэта 128Гц.

lfe_high

Усталюйце высокую частату зрэзу LFE. Па змаўчанні гэта 256Гц.

lfe_mode

Усталюйце рэжым LFE, можна addці sub. Па змаўчанні add. У addрэжыме LFE канал ствараецца з уваходнага гуку і дадаецца да выхаду. У subрэжыме канал LFE ствараецца з уваходнага аўдыя і дадаецца да выхаду, але таксама ўсе выходныя каналы без LFE адымаюцца з выхаднога канала LFE.

angle

Задайце вугал стэрэааб'ёмнага пераўтварэння, дазволены дыяпазон ад 0да 360. Па змаўчанні 90.

fc_in

Усталюйце гучнасць уводу ў цэнтры спераду. Па змаўчанні гэта 1.

fc_out

Усталюйце гучнасць пярэдняга цэнтральнага выхаду. Па змаўчанні гэта 1.

fl_in

Усталюйце гучнасць пярэдняга левага ўваходу. Па змаўчанні гэта 1.

fl_out

Усталюйце гучнасць пярэдняга левага выхаду. Па змаўчанні гэта 1.

fr_in

Усталюйце гучнасць уводу спераду справа. Па змаўчанні гэта 1.

fr_out

Усталюйце гучнасць пярэдняга правага выхаду. Па змаўчанні гэта 1.

sl_in

Усталюйце гучнасць уводу з левага боку. Па змаўчанні гэта 1.

sl_out

Усталюйце гучнасць бакавога левага выхаду. Па змаўчанні гэта 1.

sr_in

Усталюйце гучнасць уводу справа. Па змаўчанні гэта 1.

sr_out

Усталюйце гук бакавога правага выхаду. Па змаўчанні гэта 1.

bl_in

Вярніце гучнасць левага ўваходу. Па змаўчанні гэта 1.

bl_out

Усталюйце гучнасць левага выхаду. Па змаўчанні гэта 1.

br_in

Усталюйце гучнасць правага ўваходу. Па змаўчанні гэта 1.

br_out

Вярніце гучнасць правага выхаду. Па змаўчанні гэта 1.

bc_in

Вярнуць цэнтральную гучнасць уводу. Па змаўчанні гэта 1.

bc_out

Усталюйце цэнтральную гучнасць выхаду. Па змаўчанні гэта 1.

lfe_in

Устанавіць уваходную гучнасць LFE. Па змаўчанні гэта 1.

lfe_out

Усталюйце гучнасць выхаду LFE. Па змаўчанні гэта 1.

allx

Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі X для ўсіх каналаў. Дазволены дыяпазон ад -1да 15. Па змаўчанні гэта значэнне адмоўнае -1і, такім чынам, не выкарыстоўваецца.

ally

Усталюйце размеркаванае выкарыстанне стэрэамалюнка па восі Y для ўсіх каналаў. Дазволены дыяпазон ад -1да 15. Па змаўчанні гэта значэнне адмоўнае -1і, такім чынам, не выкарыстоўваецца.

fcx, flx, frx, blx, brx, slx, srx, bcx

Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі X для кожнага канала. Дазволены дыяпазон ад 0.06да 15. Па змаўчанні гэта значэнне роўна 0.5.

fcy, fly, fry, bly, bry, sly, sry, bcy

Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі Y для кожнага канала. Дазволены дыяпазон ад 0.06да 15. Па змаўчанні гэта значэнне роўна 0.5.

win_size

Усталюйце памер акна. Дазволены дыяпазон ад 1024да 65536. Памер па змаўчанні 4096.

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann, hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Па змаўчанні hann.

overlap

Усталюйце перакрыцце вокнаў. Калі ўстаноўлена значэнне 1, будзе выбрана рэкамендаванае перакрыцце для выбранай функцыі акна. Па змаўчанні 0.5.

8.110 tiltshelf

Узмацняйце або зніжайце нізкія частоты і зніжайце або павышайце высокія частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятара тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).

Фільтр прымае наступныя параметры:

gain, g

Дайце ўзмацненне на 0 Гц. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.

frequency, f

Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні - 3000Гц.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Вызначце, наколькі круты пераход паліцы фільтра.

poles, p

Усталюйце колькасць палюсоў. Па змаўчанні 2.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.110.1 Commands

Гэты фільтр падтрымлівае некаторыя параметры ў якасці каманд .

8.111 treble, highshelf

Павялічвайце або зніжайце высокія (верхнія) частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятараў тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).

Фільтр прымае наступныя параметры:

gain, g

Укажыце каэфіцыент узмацнення пры меншым з ~22 кГц і частаце Найквіста. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.

frequency, f

Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні - 3000Гц.

width_type, t

Усталяваць метад для ўказання прапускной здольнасці фільтра.

h

Гц

q

Q-фактар

o

актава

s

схіл

k

кГц

width, w

Вызначце, наколькі круты пераход паліцы фільтра.

poles, p

Усталюйце колькасць палюсоў. Па змаўчанні 2.

mix, m

Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.

channels, c

Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.

normalize, n

Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.

transform, a

Усталюйце тып пераўтварэння фільтра IIR.

di
dii
tdi
tdii
latt
svf
zdf
precision, r

Усталюйце дакладнасць фільтрацыі.

auto

Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.

s16

Заўсёды выкарыстоўвайце 16-біт са знакам.

s32

Заўсёды выкарыстоўвайце 32-бітны знак.

f32

Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.

f64

Заўсёды выкарыстоўвайце float 64-bit.

block_size, b

Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.

Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.

8.111.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

frequency, f

Змена высокіх частот. Сінтаксіс каманды: " frequency"

width_type, t

Змяніць тып шырыні высокіх частот. Сінтаксіс каманды: " width_type"

width, w

Змяніць шырыню высокіх частот. Сінтаксіс каманды: " width"

gain, g

Змяніць узмацненне высокіх частот. Сінтаксіс каманды: " gain"

mix, m

Змяніць мікс высокіх частот. Сінтаксіс каманды: " mix"

8.112 tremolo

Сінусоідная амплітудная мадуляцыя.

Фільтр прымае наступныя параметры:

f

Частата мадуляцыі ў герцах. Частоты мадуляцыі ў субгарманічных дыяпазоне (20 Гц або ніжэй) прывядуць да эфекту трэмала. Гэты фільтр можа таксама выкарыстоўвацца ў якасці кальцавога мадулятара, задаўшы частату мадуляцыі вышэй за 20 Гц. Дыяпазон 0,1 - 20000,0. Значэнне па змаўчанні - 5,0 Гц.

d

Глыбіня мадуляцыі ў працэнтах. Дыяпазон 0,0 - 1,0. Значэнне па змаўчанні 0,5.

8.113 vibrato

Сінусоідная фазавая мадуляцыя.

Фільтр прымае наступныя параметры:

f

Частата мадуляцыі ў герцах. Дыяпазон 0,1 - 20000,0. Значэнне па змаўчанні - 5,0 Гц.

d

Глыбіня мадуляцыі ў працэнтах. Дыяпазон 0,0 - 1,0. Значэнне па змаўчанні 0,5.

8.114 virtualbass

Прымяніць аўдыяфільтр Virtual Bass.

Гэты фільтр прымае стэрэа ўваход і стварае стэрэа з выхаднымі каналамі LFE (2.1). Нядаўна выраблены канал LFE мае палепшаныя віртуальныя басы, першапачаткова атрыманыя з абодвух стэрэаканалаў. Гэты фільтр выводзіць пярэдні левы і пярэдні правы каналы без зменаў, даступныя ў стэрэа ўваходзе.

Фільтр прымае наступныя параметры:

cutoff

Усталюйце віртуальную частату зрэзу нізкіх частот. Значэнне па змаўчанні - 250 Гц. Дазволены дыяпазон ад 100 да 500 Гц.

strength

Усталюйце сілу віртуальнага басу. Дазволены дыяпазон ад 0,5 да 3. Значэнне па змаўчанні - 3.

8.115 volume

Адрэгулюйце гучнасць уваходнага гуку.

Ён прымае наступныя параметры:

volume

Задаць выраз гучнасці гуку.

Выхадныя значэнні абразаюцца да максімальнага значэння.

Гучнасць выхаднога гуку вызначаецца суадносінамі:

output_volume = volume * input_volume

Значэнне па змаўчанні volume- "1.0".

precision

Гэты параметр уяўляе сабой матэматычную дакладнасць.

Ён вызначае, якія фарматы ўваходных выбарак будуць дазволеныя, што ўплывае на дакладнасць маштабавання гучнасці.

fixed

8-бітны з фіксаванай кропкай; гэта абмяжоўвае ўваходны фармат выбаркі да U8, S16 і S32.

float

32-разрадны з плаваючай кропкай; гэта абмяжоўвае фармат уводу выбаркі FLT. (па змаўчанні)

double

64-разрадная з плаваючай кропкай; гэта абмяжоўвае ўваходны фармат выбаркі DBL.

replaygain

Выберыце паводзіны пры выяўленні пабочных даных ReplayGain ва ўваходных кадрах.

drop

Выдаліць пабочныя дадзеныя ReplayGain, ігнаруючы іх змесціва (па змаўчанні).

ignore

Ігнараваць бакавыя даныя ReplayGain, але пакінуць іх у кадры.

track

Аддаць перавагу ўзмацненню трэка, калі яно ёсць.

album

Аддайце перавагу ўзмацненню альбома, калі яно ёсць.

replaygain_preamp

Узмацненне папярэдняга ўзмацнення ў дБ для прымянення да абранага ўзмацнення прайгравання.

Значэнне па змаўчанні роўна replaygain_preamp0,0.

replaygain_noclip

Прадухіліце адсячэнне, абмежаваўшы ўзмацненне.

Значэнне па змаўчанні роўна replaygain_noclip1.

eval

Устанавіце, калі вылічваецца выраз аб'ёму.

Ён прымае наступныя значэнні:

'once'

вылічваць выраз толькі адзін раз падчас ініцыялізацыі фільтра або калі 'volume' каманда адпраўлена

'frame'

ацэньваць выраз для кожнага ўваходнага кадра

Значэнне па змаўчанні 'once'.

Выраз аб'ёму можа ўтрымліваць наступныя параметры.

n

нумар кадра (пачынаючы з нуля)

nb_channels

колькасць каналаў

nb_consumed_samples

колькасць узораў, спажываных фільтрам

nb_samples

колькасць узораў у бягучым кадры

pos

зыходная пазіцыя кадра ў файле

pts

каркас ПТС

sample_rate

частата выбаркі

startpts

PTS у пачатку трансляцыі

startt

час у пачатку трансляцыі

t

час кадра

tb

пазнака часу базы

volume

апошняе зададзенае значэнне гучнасці

Звярніце ўвагу, каліevalусталяваны ў 'once' даступныя толькі зменныя і , усе астатнія зменныя будуць ацэньвацца як NAN sample_rate.tb

8.115.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

volume

Змяніце выраз гучнасці. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

8.115.2 Examples

  • Паменшыць гучнасць уваходнага гуку ўдвая:
    volume=volume=0.5
    volume=volume=1/2
    volume=volume=-6.0206dB
    

    Ва ўсіх прыведзеных вышэй прыкладах названы ключ дляvolumeможа быць апушчаны, напрыклад, як у:

    volume=0.5
    
  • Павялічце магутнасць уваходнага гуку на 6 дэцыбел з дапамогай дакладнасці з фіксаванай кропкай:
    volume=volume=6dB:precision=fixed
    
  • Аб'ём згасання пасля часу 10 з перыядам анігіляцыі 5 секунд:
    volume='if(lt(t,10),1,max(1-(t-10)/5,0))':eval=frame
    

8.116 volumedetect

Вызначыць гучнасць уваходнага відэа.

У фільтра няма параметраў. Ён падтрымлівае толькі 16-бітныя знакавыя цэлыя ўзоры, таму ўвод будзе пераўтвораны пры неабходнасці. Статыстыка аб'ёму будзе надрукавана ў журнале, калі будзе дасягнуты канец уваходнага патоку.

У прыватнасці, ён будзе паказваць сярэдні аб'ём (сярэднеквадратычны), максімальны аб'ём (на аснове кожнага ўзору) і пачатак гістаграмы зарэгістраваных значэнняў аб'ёму (ад максімальнага значэння да сукупнай 1/1000 узораў). ).

Усе аб'ёмы ў дэцыбелах адносна максімальнага значэння PCM.

8.116.1 Examples

Вось урывак з выхаду:

[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

Гэта азначае, што:

  • Сярэдняя квадратычная энергія складае прыблізна -27 дБ, або 10^-2,7.
  • Самая вялікая выбарка знаходзіцца пры -4 дБ, а дакладней, паміж -4 дБ і -5 дБ.
  • Ёсць 6 выбарак пры -4 дБ, 62 пры -5 дБ, 286 пры -6 дБ і г.д.

Іншымі словамі, павышэнне гучнасці на +4 дБ не выклікае адсячэння, павелічэнне на +5 дБ выклікае адсячэнне для 6 узораў і г.д.

9 Audio Sources

Ніжэй прыводзіцца апісанне даступных на дадзены момант крыніц гуку.

9.1 abuffer

Буферызаваць аўдыякадры і зрабіць іх даступнымі для ланцужка фільтраў.

Гэтая крыніца ў асноўным прызначана для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersrc.h.

Ён прымае наступныя параметры:

time_base

База часу, якая будзе выкарыстоўвацца для метак часу прадстаўленых кадраў. Ён павінен быць альбо лікам з плаваючай коскай, альбо ў форме numerator/ denominator.

sample_rate

Частата дыскрэтызацыі ўваходных гукавых буфераў.

sample_fmt

Прыклад фармату ўваходных аўдыябуфераў. Альбо ўзор імя фармату, альбо яго адпаведнае цэлае прадстаўленне з пераліку AVSampleFormat уlibavutil/samplefmt.h

channel_layout

Схема канала ўваходных аўдыябуфераў. Альбо імя макета канала з channel_layout_map in libavutil/channel_layout.cабо яго адпаведнае цэлае прадстаўленне з макрасаў AV_CH_LAYOUT_* уlibavutil/channel_layout.h

channels

Колькасць каналаў буфераў уваходнага гуку. Калі абодва channelsпазначаны channel_layout, то яны павінны быць узгодненымі.

9.1.1 Examples

abuffer=sample_rate=44100:sample_fmt=s16p:channel_layout=stereo

будзе інструктаваць крыніцу прымаць планарнае 16-бітнае стэрэа са знакам на 44100 Гц. Паколькі ўзорны фармат з імем "s16p" адпавядае лічбе 6, а разметка "стэрэа" канала адпавядае значэнню 0x3, гэта эквівалентна:

abuffer=sample_rate=44100:sample_fmt=6:channel_layout=0x3

9.2 aevalsrc

Сфармаваць гукавы сігнал, вызначаны выразам.

Гэтая крыніца прымае на ўваход адзін або некалькі выразаў (па адным для кожнага канала), якія вылічваюцца і выкарыстоўваюцца для генерацыі адпаведнага гукавога сігналу.

Гэтая крыніца прымае наступныя параметры:

exprs

Усталяваць спіс выразаў, падзеленых '|', для кожнага асобнага канала. У выпадку, калі channel_layoutпараметр не пазначаны, выбраны макет канала залежыць ад колькасці прадстаўленых выразаў. У адваротным выпадку апошні ўказаны выраз прымяняецца да астатніх выходных каналаў.

channel_layout, c

Усталюйце раскладку канала. Колькасць каналаў у зададзеным макеце павінна быць роўная колькасці зададзеных выразаў.

duration, d

Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра.

Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна.

nb_samples, n

Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024.

sample_rate, s

Укажыце частату выбаркі, па змаўчанні 44100.

Кожны выраз у exprsможа ўтрымліваць наступныя канстанты:

n

нумар ацэненай пробы, пачынаючы з 0

t

час ацэненага ўзору, выражаны ў секундах, пачынаючы з 0

s

частата выбаркі

9.2.1 Examples

  • Стварыць цішыню:
    aevalsrc=0
    
  • Сфармуйце сігнал sin з частатой 440 Гц, усталюйце частату дыскрэтызацыі 8000 Гц:
    aevalsrc="sin(440*2*PI*t):s=8000"
    
  • Сфармуйце двухканальны сігнал, відавочна ўкажыце размяшчэнне каналаў (пярэдні цэнтр + задні цэнтр):
    aevalsrc="sin(420*2*PI*t)|cos(430*2*PI*t):c=FC|BC"
    
  • Стварыць белы шум:
    aevalsrc="-2+random(0)"
    
  • Сфармуйце амплітудна-мадуляваны сігнал:
    aevalsrc="sin(10*2*PI*t)*sin(880*2*PI*t)"
    
  • Стварайце бінауральныя рытмы 2,5 Гц на носьбіце 360 Гц:
    aevalsrc="0.1*sin(2*PI*(360-2.5/2)*t) | 0.1*sin(2*PI*(360+2.5/2)*t)"
    

9.3 afirsrc

Стварыце каэфіцыенты FIR з дапамогай метаду выбаркі частоты.

Атрыманы паток можна выкарыстоўваць з afir фільтрам для фільтрацыі гукавога сігналу.

Фільтр прымае наступныя параметры:

taps, t

Усталюйце колькасць каэфіцыентаў фільтра ў выходным аўдыяструмені. Значэнне па змаўчанні - 1025.

frequency, f

Усталюйце кропкі частаты, адкуль задаюцца велічыня і фаза. Гэта павінна быць у парадку не змяншэння, і першы элемент павінен быць 0, а апошні элемент павінен быць 1. Элементы падзяляюцца прабеламі.

magnitude, m

Усталюйце значэнне велічыні для кожнай частаты, зададзенайfrequency. Колькасць значэнняў павінна супадаць з колькасцю кропак частаты. Значэнні аддзяляюцца прабеламі.

phase, p

Усталюйце значэнне фазы для кожнай частаты, зададзенайfrequency. Колькасць значэнняў павінна супадаць з колькасцю кропак частаты. Значэнні аддзяляюцца прабеламі.

sample_rate, r

Задаць частату выбаркі, па змаўчанні 44100.

nb_samples, n

Усталюйце колькасць выбарак на кожны кадр. Па змаўчанні 1024.

win_func, w

Усталяваць функцыю акна. Па змаўчанні - blackman.

9.4 anullsrc

Нулявая крыніца аўдыя, вяртае неапрацаваныя аўдыякадры. Ён галоўным чынам карысны ў якасці шаблону і для выкарыстання ў інструментах аналізу/адладкі або ў якасці крыніцы для фільтраў, якія ігнаруюць ўваходныя даныя (напрыклад, фільтр sox synth).

Гэтая крыніца прымае наступныя параметры:

channel_layout, cl

Вызначае макет канала і можа быць як цэлым лікам, так і радком, які прадстаўляе макет канала. Значэнне па змаўчанні channel_layout - "стэрэа".

Праверце вызначэнне channel_layout_map у libavutil/channel_layout.cдля супастаўлення паміж радкамі і значэннямі макета канала.

sample_rate, r

Вызначае частату выбаркі і па змаўчанні 44100.

nb_samples, n

Усталюйце колькасць выбарак на запытаныя кадры.

duration, d

Усталюйце працягласць аўдыя з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна.

9.4.1 Examples

  • Усталюйце частату дыскрэтызацыі на 48000 Гц і кампаноўку канала на AV_CH_LAYOUT_MONO.
    anullsrc=r=48000:cl=4
    
  • Выканайце тую ж аперацыю з больш відавочным сінтаксісам:
    anullsrc=r=48000:cl=mono
    

Усе параметры павінны быць дакладна вызначаны.

9.5 flite

Сінтэзуйце галасавое выказванне з дапамогай бібліятэкі libflite.

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-libflite.

Звярніце ўвагу, што версіі бібліятэкі flite да 2.0 не з'яўляюцца паточна-бяспечнымі.

Фільтр прымае наступныя параметры:

list_voices

Калі ўстаноўлена значэнне 1, пералічыць назвы даступных галасоў і неадкладна выйсці. Значэнне па змаўчанні 0.

nb_samples, n

Усталюйце максімальную колькасць выбарак на кадр. Значэнне па змаўчанні - 512.

textfile

Усталюйце імя файла, які змяшчае тэкст для прагаворвання.

text

Усталюйце тэкст для прамаўлення.

voice, v

Усталюйце голас для сінтэзу маўлення. Значэнне па змаўчанні - kal. Глядзіце таксама list_voicesварыянт.

9.5.1 Examples

  • Чытаць з файлаspeech.txt, і сінтэзаваць тэкст з дапамогай стандартнага голасу flite:
    flite=textfile=speech.txt
    
  • Прачытайце ўказаны тэкст, выбіраючы sltголас:
    flite=text='So fare thee well, poor devil of a Sub-Sub, whose commentator I am':voice=slt
    
  • Увядзіце тэкст у ffmpeg:
    ffmpeg -f lavfi -i flite=text='So fare thee well, poor devil of a Sub-Sub, whose commentator I am':voice=slt
    
  • зрабіцьffplayпрамаўляйце ўказаны тэкст, выкарыстоўваючы fliteі lavfiпрыладу:
    ffplay -f lavfi flite=text='No more be grieved for which that thou hast done.'
    

Для атрымання дадатковай інфармацыі пра libflite праверце: http://www.festvox.org/flite/

9.6 anoisesrc

Стварыце шумавы гукавы сігнал.

Фільтр прымае наступныя параметры:

sample_rate, r

Укажыце частату выбаркі. Значэнне па змаўчанні - 48000 Гц.

amplitude, a

Задайце амплітуду (0,0 - 1,0) згенераванага аўдыяструменю. Значэнне па змаўчанні 1,0.

duration, d

Пакажыце працягласць згенераванага аўдыёпатоку. Невызначэнне гэтага параметра прыводзіць да шуму бясконцай даўжыні.

color, colour, c

Укажыце колер шуму. Даступныя колеры шуму - белы, ружовы, карычневы, сіні, фіялетавы і аксамітны. Колер па змаўчанні - белы.

seed, s

Укажыце значэнне, якое выкарыстоўваецца для запаўнення PRNG.

nb_samples, n

Усталюйце колькасць выбарак на кожны выходны кадр, па змаўчанні 1024.

9.6.1 Examples

  • Згенеруйце 60 секунд ружовага шуму з частатой дыскрэтызацыі 44,1 кГц і амплітудай 0,5:
    anoisesrc=d=60:c=pink:r=44100:a=0.5
    

9.7 hilbert

Стварэнне няцотных каэфіцыентаў пераўтварэння Гільберта.

Атрыманы паток можа быць выкарыстаны з фільтрам afir для фазавага зруху сігналу на 90 градусаў.

Гэта выкарыстоўваецца ў многіх схемах матрычнага кадавання і для генерацыі аналітычнага сігналу. Працэс часта запісваюць як множанне на i (або j), уяўную адзінку.

Фільтр прымае наступныя параметры:

sample_rate, s

Задаць частату выбаркі, па змаўчанні 44100.

taps, t

Задаць даўжыню FIR-фільтра, па змаўчанні 22051.

nb_samples, n

Усталюйце колькасць выбарак на кожны кадр.

win_func, w

Задаць функцыю акна, якая будзе выкарыстоўвацца пры генерацыі каэфіцыентаў FIR.

9.8 sinc

Стварэнне каэфіцыентаў КІХ нізкіх частот, высокіх частот, паласы прапускання або паласы адхілення кіхтавых каэфіцыентаў sinc kaiser-window.

Атрыманы паток можна выкарыстоўваць з afir фільтрам для фільтрацыі гукавога сігналу.

Фільтр прымае наступныя параметры:

sample_rate, r

Задаць частату выбаркі, па змаўчанні 44100.

nb_samples, n

Усталюйце колькасць выбарак на кожны кадр. Па змаўчанні 1024.

hp

Усталюйце частату высокіх частот. Па змаўчанні 0.

lp

Усталюйце частату нізкіх частот. Па змаўчанні 0. Калі частата высокіх частот ніжэйшая за частату нізкіх частот, а частата нізкіх частот вышэй за 0, тады фільтр створыць каэфіцыенты паласавога фільтра, у адваротным выпадку каэфіцыенты паласавога фільтра.

phase

Усталюйце фазавую характарыстыку фільтра. Па змаўчанні - 50. Дазволены дыяпазон ад 0 да 100.

beta

Усталяваць бэта-версію акна Kaiser.

att

Усталюйце згасанне ў дыяпазоне прыпынку. Па змаўчанні 120 дБ, дазволены дыяпазон ад 40 да 180 дБ.

round

Уключыць акругленне, па змаўчанні адключана.

hptaps

Усталюйце колькасць кранаў для фільтра высокіх частот.

lptaps

Усталюйце колькасць кранаў для фільтра нізкіх частот.

9.9 sine

Сфармуйце гукавы сігнал з сінусоіды з амплітудай 1/8.

Гукавы сігнал з'яўляецца бітавым.

Фільтр прымае наступныя параметры:

frequency, f

Усталюйце нясучую частату. Стандартная частата - 440 Гц.

beep_factor, b

Уключыце перыядычны гукавы сігнал кожную секунду з частатой beep_factor, памножанай на нясучую. Па змаўчанні значэнне 0, што азначае, што гукавы сігнал адключаны.

sample_rate, r

Укажыце частату выбаркі, па змаўчанні 44100.

duration, d

Пакажыце працягласць згенераванага аўдыёпатоку.

samples_per_frame

Усталюйце колькасць выбарак на выхадны кадр.

Выраз можа ўтрымліваць наступныя канстанты:

n

(Парадкавы) нумар выхаднога аўдыякадра, пачынаючы з 0.

pts

PTS (TimeStamp прэзентацыі) выхаднога аўдыякадра, выражаны ў TBадзінках.

t

PTS выхаднога аўдыякадра, выражаны ў секундах.

TB

Часовая база выхадных аўдыякадраў.

Па змаўчанні 1024.

9.9.1 Examples

  • Згенераваць простую сінусоіду 440 Гц:
    sine
    
  • Стварыце сінусоід 220 Гц з гукавым сігналам 880 Гц кожную секунду на працягу 5 секунд:
    sine=220:4:d=5
    sine=f=220:b=4:d=5
    sine=frequency=220:beep_factor=4:duration=5
    
  • Стварыце сінусоіду 1 кГц па 1602,1601,1602,1601,1602схеме NTSC:
    sine=1000:samples_per_frame='st(0,mod(n,5)); 1602-not(not(eq(ld(0),1)+eq(ld(0),3)))'
    

10 Audio Sinks

Ніжэй прыводзіцца апісанне даступных у цяперашні час аўдыёпрыёмнікаў.

10.1 abuffersink

Буферызаваць аўдыякадры і зрабіць іх даступнымі для канца ланцужка фільтраў.

Гэты прыёмнік у асноўным прызначаны для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersink.h або сістэма опцый.

Ён прымае паказальнік на структуру AVABufferSinkContext, якая вызначае фарматы ўваходных буфераў, які будзе перададзены ў якасці непразрыстага параметра avfilter_init_filterдля ініцыялізацыі.

10.2 anullsink

Null аўдыё ракавіна; не рабіць абсалютна нічога з уваходным гукам. Ён галоўным чынам карысны як шаблон і для выкарыстання ў інструментах аналізу/адладкі.

11 Video Filters

Калі вы наладжваеце зборку FFmpeg, вы можаце адключыць любы з існуючых фільтраў з дапамогай --disable-filters. Выхад канфігурацыі пакажа відэафільтры, уключаныя ў вашу зборку.

Ніжэй прыводзіцца апісанне даступных на дадзены момант відэафільтраў.

11.1 addroi

Адзначце вобласць цікавасці ў кадры відэа.

Даныя кадра перадаюцца ў нязменным выглядзе, але метаданыя далучаюцца да кадра з указаннем цікавых рэгіёнаў, якія могуць паўплываць на паводзіны наступнага кадавання. Некалькі рэгіёнаў можна пазначыць, ужываючы фільтр некалькі разоў.

x

Адлегласць вобласці ў пікселях ад левага краю кадра.

y

Адлегласць вобласці ў пікселях ад верхняга краю кадра.

w

Шырыня вобласці ў пікселях.

h

Вышыня вобласці ў пікселях.

Параметры x, y, wі hз'яўляюцца выразамі і могуць утрымліваць наступныя зменныя:

iw

Шырыня ўваходнага кадра.

ih

Вышыня ўваходнага кадра.

qoffset

Зрушэнне квантавання для прымянення ў рэгіёне.

Гэта павінна быць рэальнае значэнне ў дыяпазоне ад -1 да +1. Нулявое значэнне азначае адсутнасць змены якасці. Адмоўнае значэнне патрабуе лепшай якасці (меншае квантаванне), а станоўчае значэнне патрабуе горшай якасці (большае квантаванне).

Дыяпазон адкалібраваны такім чынам, што крайнія значэнні паказваюць максімальна магчымае зрушэнне - калі астатняя частка кадра закадзіравана з найгоршай магчымай якасцю, зрушэнне -1 паказвае, што гэтая вобласць у любым выпадку павінна быць закадзіравана з найлепшай магчымай якасцю. Затым прамежкавыя значэнні інтэрпалююцца нейкім залежным ад кодэка спосабам.

Напрыклад, у 10-бітным H.264 параметр квантавання вар'іруецца ад -12 да 51. Такім чынам, тыповае значэнне qoffset, роўнае -1/10, паказвае, што гэтая вобласць павінна быць закадзіравана з QP прыкладна на адну дзесятую поўнага дыяпазону лепш, чым астатняя частка кадра. Такім чынам, калі большая частка кадра павінна быць закадзіравана з QP каля 30, гэты рэгіён атрымае QP каля 24 (зрушэнне прыблізна -1/10 * (51 - -12) = -6,3). Крайняе значэнне -1 будзе азначаць, што гэтая вобласць павінна быць закадзіравана з найлепшай магчымай якасцю, незалежна ад апрацоўкі астатняй часткі кадра - гэта значыць павінна быць закадзіравана з QP -12.

clear

Калі зададзена значэнне "true", выдаліце ​​ўсе існуючыя рэгіёны цікавасці, пазначаныя на фрэйме, перш чым дадаваць новы.

11.1.1 Examples

  • Адзначце цэнтральную чвэрць кадра як цікавую.
    addroi=iw/4:ih/4:iw/2:ih/2:-1/10
    
  • Пазначце вобласць шырынёй 100 пікселяў на левым краі кадра як вельмі нецікавую (якая павінна быць закадавана значна ніжэй, чым астатняя частка кадра).
    addroi=0:0:100:ih:+1/5
    

11.2 alphaextract

Выняць альфа-кампанент з уводу як відэа ў адценнях шэрага. Гэта асабліва карысна з alphamergeфільтрам.

11.3 alphamerge

Дадайце або заменіце альфа-кампанент першаснага ўваходу на значэнне адценняў шэрага другога ўваходу. Гэта прызначана для выкарыстання з alphaextractтым, каб дазволіць перадачу або захоўванне паслядоўнасцей кадраў, якія маюць альфа-версію ў фармаце, які не падтрымлівае альфа-канал.

Напрыклад, каб аднавіць поўныя кадры з звычайнага відэа, закадзіраванага YUV, і асобнага відэа, створанага з дапамогай alphaextract, вы можаце выкарыстоўваць:

movie=in_alpha.mkv [alpha]; [in][alpha] alphamerge [out]

11.4 amplify

Узмацніць адрозненні паміж бягучым пікселем і пікселямі суседніх кадраў у тым самым месцы пікселя.

Гэты фільтр прымае наступныя параметры:

radius

Усталюйце радыус рамкі. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 63. Напрыклад, радыус 3 загадае фільтру вылічыць сярэдняе значэнне з 7 кадраў.

factor

Усталюйце каэфіцыент для ўзмацнення розніцы. Па змаўчанні - 2. Дазволены дыяпазон ад 0 да 65535.

threshold

Усталюйце парог для ўзмацнення розніцы. Любая розніца, большая або роўная гэтаму значэнню, не зменіць зыходны піксель. Па змаўчанні 10. Дазволены дыяпазон ад 0 да 65535.

tolerance

Усталюйце допуск для ўзмацнення розніцы. Любая розніца ніжэй гэтага значэння не зменіць зыходны піксель. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 65535.

low

Усталюйце ніжнюю мяжу для змены зыходнага пікселя. Па змаўчанні - 65535. Дазволены дыяпазон ад 0 да 65535. Гэты параметр кантралюе максімальна магчымае значэнне, якое паменшыць значэнне зыходнага пікселя.

high

Усталюйце верхнюю мяжу для змены зыходнага пікселя. Па змаўчанні - 65535. Дазволены дыяпазон ад 0 да 65535. Гэты параметр кантралюе максімальна магчымае значэнне, якое павялічыць значэнне зыходнага пікселя.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.

11.4.1 Commands

Гэты фільтр падтрымлівае наступныя каманды , якія адпавядаюць аднаіменнай опцыі:

factor
threshold
tolerance
low
high
planes

11.5 ass

Тое самае, што і фільтр субтытраў , за выключэннем таго, што для яго працы не патрабуецца libavcodec і libavformat. З іншага боку, ён абмежаваны файламі субтытраў ASS (Advanced Substation Alpha).

Гэты фільтр прымае наступныя параметры ў дадатак да агульных параметраў з фільтра субтытраў :

shaping

Усталюйце механізм фармавання

Даступныя значэнні:

'auto'

Механізм фармавання libass па змаўчанні, які з'яўляецца лепшым даступным.

'simple'

Хуткая праграма для фарміравання шрыфтоў, якая можа рабіць толькі замены

'complex'

Больш павольны фармавальнік з выкарыстаннем OpenType для замен і пазіцыянавання

Па змаўчанні - auto.

11.6 atadenoise

Прымяніць адаптыўнае часовае асерадненне шуму да відэаўваходу.

Фільтр прымае наступныя параметры:

0a

Усталюйце парог A для 1-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.

0b

Усталюйце парог B для 1-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.

1a

Усталюйце парог A для 2-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.

1b

Усталюйце парог B для 2-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.

2a

Усталюйце парог A для 3-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.

2b

Усталюйце парог B для 3-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.

Парог A прызначаны для рэагавання на рэзкія змены ўваходнага сігналу, а парог B прызначаны для рэагавання на бесперапынныя змены ўваходнага сігналу.

s

Зададзеная колькасць кадраў, якія фільтр будзе выкарыстоўваць для асераднення. Па змаўчанні 9. Павінен быць няцотны лік у дыяпазоне [5, 129].

p

Усталюйце, якія плоскасці кадравага фільтра будуць выкарыстоўвацца для асераднення. Па змаўчанні ўсё.

a

Усталюйце, які варыянт алгарытму фільтра будзе выкарыстоўваць для асераднення. Па змаўчанні - pпаралельна. Альтэрнатыўна можа быць усталяваны sпаслядоўны.

Паралельны можа быць хутчэй, чым паслядоўны, у той час як наадварот ніколі не бывае. Паралельны перарываецца рана, калі першае змяненне будзе большым за парогавыя значэнні, у той час як паслядоўны працягне апрацоўваць іншы бок кадраў, калі яны роўныя або ніжэйшыя за парогавыя значэнні.

0s
1s
2s

Усталюйце сігму для 1-й плоскасці, 2-й плоскасці або 3-й плоскасці. Па змаўчанні 32767. Дапушчальны дыяпазон ад 0 да 32767. Гэты параметр кантралюе вагу для кожнага пікселя ў радыусе, вызначаным памерам. Значэнне па змаўчанні азначае, што кожны піксель мае аднолькавую вагу. Вызначэнне гэтай опцыі на 0 эфектыўна адключае фільтрацыю.

11.6.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры, акрамя параметра s. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

11.7 avgblur

Прымяніць фільтр сярэдняй размытасці.

Фільтр прымае наступныя параметры:

sizeX

Усталюйце памер гарызантальнага радыусу.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.

sizeY

Усталюйце памер вертыкальнага радыуса, калі роўны нулю, ён будзе такім жа, як sizeX. Па змаўчанні 0.

11.7.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.8 bbox

Вылічыце абмежавальную рамку для нячорных пікселяў у плоскасці яркасці ўваходнага кадра.

Гэты фільтр вылічвае абмежавальную рамку, якая змяшчае ўсе пікселі са значэннем яркасці большым за мінімальна дазволенае значэнне. Параметры, якія апісваюць абмежавальную рамку, друкуюцца ў журнале фільтра.

Фільтр прымае наступныя параметры:

min_val

Усталюйце мінімальнае значэнне яркасці. Па змаўчанні 16.

11.8.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.9 bilateral

Прымяніць двухбаковы фільтр, прасторавае згладжванне з захаваннем краёў.

Фільтр прымае наступныя параметры:

sigmaS

Усталюйце сігму функцыі Гаўса для разліку прасторавай вагі. Дазволены дыяпазон ад 0 да 512. Па змаўчанні 0,1.

sigmaR

Усталюйце сігму функцыі Гаўса для разліку вагі дыяпазону. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,1.

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.

11.9.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.10 bitplanenoise

Паказваць і вымяраць шум разраднай плоскасці.

Фільтр прымае наступныя параметры:

bitplane

Усталюйце, якую плоскасць аналізаваць. Па змаўчанні 1.

filter

Адфільтраваць шумныя пікселі з bitplaneнабору вышэй. Па змаўчанні адключана.

11.11 blackdetect

Выяўленне інтэрвалаў відэа, якія (амаль) цалкам чорныя. Можа быць карысным для выяўлення пераходаў раздзелаў, рэкламных ролікаў або несапраўдных запісаў.

Фільтр выводзіць свой аналіз выяўлення як у журнал, так і ў метаданыя кадра. Калі знойдзены чорны сегмент прынамсі зададзенай мінімальнай працягласці, радок з пазнакамі часу пачатку і канца, а таксама працягласцю друкуецца ў журнале з узроўнем info. Акрамя таго, для кожнага кадра друкуецца радок часопіса з узроўнем debug, які паказвае колькасць чорнага, выяўленага для гэтага кадра.

Фільтр таксама далучае метададзеныя да першага кадра чорнага сегмента з ключом lavfi.black_startі да першага кадра пасля таго, як чорны сегмент заканчваецца ключом lavfi.black_end. Значэннем з'яўляецца метка часу кадра. Гэтыя метаданыя дадаюцца незалежна ад указанай мінімальнай працягласці.

Фільтр прымае наступныя параметры:

black_min_duration, d

Усталюйце мінімальную працягласць выяўленага чорнага, выражаную ў секундах. Гэта павінен быць неадмоўны лік з плаваючай коскай.

Значэнне па змаўчанні 2.0.

picture_black_ratio_th, pic_th

Усталюйце парог для таго, каб лічыць карціну «чорнай». Выразіце мінімальнае значэнне адносіны:

nb_black_pixels / nb_pixels

для якіх малюнак лічыцца чорным. Значэнне па змаўчанні 0,98.

pixel_black_th, pix_th

Усталюйце парог для таго, каб піксель лічыўся "чорным".

Парог выражае максімальнае значэнне яркасці пікселя, для якога піксель лічыцца "чорным". Дадзенае значэнне маштабуецца ў адпаведнасці з наступным ураўненнем:

absolute_threshold = luminance_minimum_value + pixel_black_th * luminance_range_size

luminance_range_sizeі luminance_minimum_valueзалежыць ад уваходнага фармату відэа, дыяпазон [0-255] для фарматаў поўнага дыяпазону YUV і [16-235] для фарматаў не поўнага дыяпазону YUV.

Значэнне па змаўчанні 0,10.

У наступным прыкладзе задаецца мінімальнае значэнне для максімальнага пікселя і выяўляюцца толькі чорныя інтэрвалы даўжынёй 2 і больш секунд:

blackdetect=d=2:pix_th=0.00

11.12 blackframe

Выяўляць кадры, якія (амаль) цалкам чорныя. Можа быць карысным для выяўлення пераходаў раздзелаў або рэкламных ролікаў. Выхадныя радкі складаюцца з нумара выяўленага кадра, працэнта чорнасці, пазіцыі ў файле, калі вядома, або -1, і меткі часу ў секундах.

Для таго, каб адлюстраваць выходныя радкі, вам трэба ўсталяваць узровень часопіса як мінімум да значэння AV_LOG_INFO.

Гэты фільтр экспартуе метаданыя фрэйма lavfi.blackframe.pblack. Значэнне ўяўляе працэнт пікселяў на малюнку, якія ніжэйшыя за парогавае значэнне.

Ён прымае наступныя параметры:

amount

Працэнт пікселяў, якія павінны быць ніжэй за парог; па змаўчанні 98.

threshold, thresh

Парог, ніжэй за які значэнне пікселя лічыцца чорным; па змаўчанні 32.

11.13 blend

Змяшайце два відэакадра адзін у аднаго.

Фільтр blendпрымае два ўваходныя патокі і выводзіць адзін паток, першы ўваход - гэта "верхні" ўзровень, а другі - "ніжні". Па змаўчанні вывад завяршаецца, калі завяршаецца самы доўгі ўвод.

Фільтр tblend(змешванне часу) бярэ два паслядоўныя кадры з аднаго патоку і выдае вынік, атрыманы шляхам змешвання новага кадра паверх старога кадра.

Далей апісваюцца прынятыя варыянты.

c0_mode
c1_mode
c2_mode
c3_mode
all_mode

Усталюйце рэжым змешвання для пэўнага піксельнага кампанента або для ўсіх піксельных кампанентаў у выпадку all_mode. Значэнне па змаўчанні - normal.

Даступныя значэнні для рэжымаў кампанентаў:

'addition'
'and'
'average'
'bleach'
'burn'
'darken'
'difference'
'divide'
'dodge'
'exclusion'
'extremity'
'freeze'
'geometric'
'glow'
'grainextract'
'grainmerge'
'hardlight'
'hardmix'
'hardoverlay'
'harmonic'
'heat'
'interpolate'
'lighten'
'linearlight'
'multiply'
'multiply128'
'negation'
'normal'
'or'
'overlay'
'phoenix'
'pinlight'
'reflect'
'screen'
'softdifference'
'softlight'
'stain'
'subtract'
'vividlight'
'xor'
c0_opacity
c1_opacity
c2_opacity
c3_opacity
all_opacity

Устанавіць непразрыстасць сумесі для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку all_opacity. Выкарыстоўваецца толькі ў спалучэнні з рэжымамі змешвання піксельных кампанентаў.

c0_expr
c1_expr
c2_expr
c3_expr
all_expr

Устанавіць выраз змешвання для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку all_expr. Звярніце ўвагу, што звязаныя параметры рэжыму будуць ігнаравацца, калі яны ўстаноўлены.

Выразы могуць выкарыстоўваць наступныя зменныя:

N

Парадкавы нумар адфільтраванага кадра, пачынаючы з 0.

X
Y

каардынаты бягучага ўзору

W
H

шырыня і вышыня бягучай фільтраванай плоскасці

SW
SH

Шкала шырыні і вышыні для плоскасці, якая фільтруецца. Гэта стаўленне паміж памерамі бягучай плоскасці і плоскасці яркасці, напрыклад, для yuv420pкадра значэнні адносяцца 1,1да плоскасці яркасці і плоскасцей 0.5,0.5каляровасці.

T

Час бягучага кадра, выражаны ў секундах.

TOP, A

Значэнне піксельнага кампанента ў бягучым месцы для першага відэакадра (верхні ўзровень).

BOTTOM, B

Значэнне піксельнага кампанента ў бягучым месцы для другога кадра відэа (ніжні ўзровень).

Фільтр blendтаксама падтрымлівае параметры framesync .

11.13.1 Examples

  • Прымяніць пераход ад ніжняга пласта да верхняга ў першыя 10 секунд:
    blend=all_expr='A*(if(gte(T,10),1,T/10))+B*(1-(if(gte(T,10),1,T/10)))'
    
  • Прымяніце лінейны гарызантальны пераход ад верхняга пласта да ніжняга:
    blend=all_expr='A*(X/W)+B*(1-X/W)'
    
  • Прымяніць эфект шахматнай дошкі 1x1:
    blend=all_expr='if(eq(mod(X,2),mod(Y,2)),A,B)'
    
  • Прымяніць левы эфект раскрыцця:
    blend=all_expr='if(gte(N*SW+X,W),A,B)'
    
  • Прымяніць эфект раскрыцця пуху:
    blend=all_expr='if(gte(Y-N*SH,0),A,B)'
    
  • Прымяніць эфект раскрыцця ўверх і ўлева:
    blend=all_expr='if(gte(T*SH*40+Y,H)*gte((T*40*SW+X)*W/H,W),A,B)'
    
  • Падзяліць відэа па дыяганалі і паказаць верхні і ніжні пласт з кожнага боку:
    blend=all_expr='if(gt(X,Y*(W/H)),A,B)'
    
  • Адлюстраванне адрозненняў паміж бягучым і папярэднім кадрам:
    tblend=all_mode=grainextract
    

11.13.2 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.14 blockdetect

Вызначае блокавасць кадраў без змены ўваходных кадраў.

На аснове Рэмка Муіджа і Ігара Кірэнкі: «Мера артэфактаў блакіроўкі без спасылак для адаптыўнай апрацоўкі відэа». 2005 13-я Еўрапейская канферэнцыя па апрацоўцы сігналаў.

Фільтр прымае наступныя параметры:

period_min
period_max

Усталюйце мінімальныя і максімальныя значэнні для вызначэння піксельных сетак (перыядаў). Значэнні па змаўчанні: [3,24].

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.

11.14.1 Examples

  • Вызначце блокавасць для першай плоскасці і знайдзіце перыяды ў [8,32]:
    blockdetect=period_min=8:period_max=32:planes=1
    

11.15 blurdetect

Вызначае размытасць кадраў без змены ўваходных кадраў.

На аснове Marziliano, Pina і інш. «Метрыка перцэпцыйнага размыцця без спасылак». Дазваляе абрэвіятуру на аснове блокаў.

Фільтр прымае наступныя параметры:

low
high

Усталюйце нізкія і высокія парогавыя значэнні, якія выкарыстоўваюцца парогавым алгарытмам Canny.

Высокі парог выбірае "моцныя" краявыя пікселі, якія затым злучаюцца праз 8-сувязь са "слабымі" краявымі пікселямі, выбранымі нізкім парогам.

lowі highпарогавыя значэнні павінны быць выбраны ў дыяпазоне [0,1] і lowпавінны быць меншымі або роўнымі high.

Значэнне па змаўчанні для low, 20/255а значэнне па змаўчанні high для 50/255.

radius

Вызначце радыус для пошуку лакальных максімумаў вакол краёвага пікселя.

block_pct

Вызначце размытасць толькі для найбольш значных блокаў, у працэнтах.

block_width

Вызначце размытасць для блокаў шырынёй block_width. Калі ўсталявана любое значэнне меншае за 1, блокі не выкарыстоўваюцца, і ўвесь відарыс апрацоўваецца як адно, незалежна ад block_height.

block_height

Вызначце размытасць для блокаў вышыні block_height. Калі ўсталявана любое значэнне меншае за 1, блокі не выкарыстоўваюцца, і ўвесь відарыс апрацоўваецца як адно, незалежна ад block_width.

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.

11.15.1 Examples

  • Вызначце размытасць для 80% найбольш значных блокаў 32x32:
    blurdetect=block_width=32:block_height=32:block_pct=80
    

11.16 bm3d

Знішчэнне шуму ў кадрах з дапамогай 3D-алгарытму Block-Matching.

Фільтр прымае наступныя параметры.

sigma

Усталюйце сілу шумашумлення. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0 да 999,9. Алгарытм знішчэння шуму вельмі адчувальны да сігма, таму наладзьце яго ў адпаведнасці з крыніцай.

block

Усталюйце лакальны памер патча. Гэта задае памеры ў 2D.

bstep

Задаць крок слізгацення для апрацоўкі блокаў. Значэнне па змаўчанні - 4. Дазволены дыяпазон ад 1 да 64. Меншыя значэнні дазваляюць апрацоўваць больш блокаў спасылак і павольней.

group

Усталюйце максімальную колькасць падобных блокаў для 3-га вымярэння. Значэнне па змаўчанні - 1. Калі ўсталявана 1, супастаўленне блокаў не праводзіцца. Большыя значэнні дазваляюць больш блокаў у адной групе. Дазволены дыяпазон ад 1 да 256.

range

Усталюйце радыус для супастаўлення пошукавых блокаў. Па змаўчанні 9. Дазволены дыяпазон ад 1 да INT32_MAX.

mstep

Усталюйце крок паміж двума месцамі пошуку для супастаўлення блокаў. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64. Меншы - павольней.

thmse

Устанавіць парог сярэднеквадратычнай памылкі для супастаўлення блокаў. Дапушчальны дыяпазон ад 0 да INT32_MAX.

hdthr

Усталюйце парогавы параметр для жорсткага парогавага значэння ў 3D-пераўтвораным дамене. Большыя значэнні прыводзяць да больш жорсткай парогавай фільтрацыі ў частотнай вобласці.

estim

Усталюйце рэжым ацэнкі фільтрацыі. Можа быць basicабо final. Па змаўчанні basic.

ref

Калі ўключаны, фільтр будзе выкарыстоўваць 2-і паток для супастаўлення блокаў. Па змаўчанні адключана для basicзначэння estimпараметра і заўсёды ўключана, калі значэнне estimроўна final.

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні даступныя ўсе, акрамя альфа-версіі.

11.16.1 Examples

  • Базавая фільтрацыя з bm3d:
    bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic
    
  • Тое самае, што і вышэй, але фільтруецца толькі яркасць:
    bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic:planes=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
    
  • Тое самае, што і вышэй, але замест папярэдняга фільтра выкарыстоўваецца фільтр nlmeans :
    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
    

11.17 boxblur

Прымяніць алгарытм размыцця скрынкі да ўваходнага відэа.

Ён прымае наступныя параметры:

luma_radius, lr
luma_power, lp
chroma_radius, cr
chroma_power, cp
alpha_radius, ar
alpha_power, ap

Далей апісваюцца прынятыя варыянты.

luma_radius, lr
chroma_radius, cr
alpha_radius, ar

Усталюйце выраз для радыуса поля ў пікселях, які выкарыстоўваецца для размыцця адпаведнай плоскасці ўводу.

Значэнне радыуса павінна быць неадмоўным лікам і не павінна перавышаць значэнне выразу min(w,h)/2для плоскасцей яркасці і альфа, а таксама min(cw,ch)/2для плоскасцей каляровасці.

Значэнне па змаўчанні дляluma_radiusроўна "2". Калі не ўказана, chroma_radiusіalpha_radiusпа змаўчанні адпаведнае значэнне, усталяванае дляluma_radius.

Выразы могуць утрымліваць наступныя канстанты:

w
h

Шырыня і вышыня ўводу ў пікселях.

cw
ch

Шырыня і вышыня уваходнага каляровага малюнка ў пікселях.

hsub
vsub

Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

luma_power, lp
chroma_power, cp
alpha_power, ap

Укажыце, колькі разоў фільтр boxblur прымяняецца да адпаведнай плоскасці.

Значэнне па змаўчанні дляluma_powerроўна 2. Калі не пазначана, chroma_powerіalpha_powerпа змаўчанні адпаведнае значэнне, усталяванае дляluma_power.

Значэнне 0 адключыць эфект.

11.17.1 Examples

  • Прымяніце фільтр BoxBlur з радыусамі яркасці, каляровасці і альфа-канала, усталяванымі на 2:
    boxblur=luma_radius=2:luma_power=1
    boxblur=2:1
    
  • Усталюйце радыус яркасці на 2, а радыус альфа- і каляровасці на 0:
    boxblur=2:1:cr=0:ar=0
    
  • Усталюйце радыусы яркасці і каляровасці на частку памеру відэа:
    boxblur=luma_radius=min(h\,w)/10:luma_power=1:chroma_radius=min(cw\,ch)/10:chroma_power=1
    

11.18 bwdif

Дэінтэрлейсаванне ўваходнага відэа ("bwdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу Боба Уівера").

Адаптыўны дэінтэрлейсінг да руху на аснове yadif з выкарыстаннем алгарытмаў w3fdif і кубічнай інтэрпаляцыі. Ён прымае наступныя параметры:

mode

Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:

0, send_frame

Вывесці па адным кадры для кожнага кадра.

1, send_field

Вывесці па адным кадры для кожнага поля.

Значэнне па змаўчанні - send_field.

parity

Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:

0, tff

Выкажам здагадку, што верхняе поле - першае.

1, bff

Выкажам здагадку, што ніжняе поле з'яўляецца першым.

-1, auto

Уключыць аўтаматычнае вызначэнне парытэту поля.

Значэнне па змаўчанні - auto. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.

deint

Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:

0, all

Дэінтэрлейс усіх кадраў.

1, interlaced

Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.

Значэнне па змаўчанні - all.

11.19 cas

Ужыць фільтр Adaptive Sharpen Contrast да відэаструменю.

Фільтр прымае наступныя параметры:

strength

Усталюйце сілу завострывання. Значэнне па змаўчанні 0.

planes

Усталюйце плоскасці для фільтрацыі. Значэнне па змаўчанні - фільтраваць усе плоскасці, акрамя альфа-плоскасці.

11.19.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.20 chromahold

Выдаліць усю інфармацыю аб колерах для ўсіх колераў, акрамя пэўнага.

Фільтр прымае наступныя параметры:

color

Колер, які не будзе заменены нейтральнай каляровасцю.

similarity

Працэнт падабенства з вышэйзгаданым колерам. 0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.

blend

Працэнт сумесі. 0.0 робіць пікселі альбо цалкам шэрымі, альбо зусім не шэрымі. Больш высокія значэнні забяспечваюць больш захаваны колер.

yuv

Сігналізуе, што пройдзены колер ужо ў YUV замест RGB.

Літаральныя колеры, такія як "зялёны" ці "чырвоны", больш не маюць сэнсу, калі гэта ўключана. Гэта можна выкарыстоўваць для перадачы дакладных значэнняў YUV у выглядзе шаснаццатковых лікаў.

11.20.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.21 chromakey

Каляровая прастора YUV.

Фільтр прымае наступныя параметры:

color

Колер, які будзе заменены на празрыстасць.

similarity

Працэнт падабенства з колерам ключа.

0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.

blend

Працэнт сумесі.

0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.

Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.

yuv

Сігналізуе, што пройдзены колер ужо ў YUV замест RGB.

Літаральныя колеры, такія як "зялёны" ці "чырвоны", больш не маюць сэнсу, калі гэта ўключана. Гэта можна выкарыстоўваць для перадачы дакладных значэнняў YUV у выглядзе шаснаццатковых лікаў.

11.21.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.21.2 Examples

  • Зрабіце кожны зялёны піксель на ўваходным малюнку празрыстым:
    ffmpeg -i input.png -vf chromakey=green out.png
    
  • Накласці зялёнае відэа на статычны чорны фон.
    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
    

11.22 chromakey_cuda

CUDA паскорыла каляровую/каляровую маніпуляцыю каляровай прасторы YUV.

Гэты фільтр працуе як звычайны каляровы фільтр, але працуе з кадрамі CUDA. для больш падрабязнай інфармацыі і параметраў глядзіце chromakey .

11.22.1 Examples

  • Зрабіце ўсе зялёныя пікселі ва ўваходным відэа празрыстымі і выкарыстоўвайце іх у якасці накладання для іншага відэа:
    ./ffmpeg \
        -hwaccel cuda -hwaccel_output_format cuda -i input_green.mp4  \
        -hwaccel cuda -hwaccel_output_format cuda -i base_video.mp4 \
        -init_hw_device cuda \
        -filter_complex \
        " \
            [0:v]chromakey_cuda=0x25302D:0.1:0.12:1[overlay_video]; \
            [1:v]scale_cuda=format=yuv420p[base]; \
            [base][overlay_video]overlay_cuda" \
        -an -sn -c:v h264_nvenc -cq 20 output.mp4
    
  • Апрацуйце дзве крыніцы праграмнага забеспячэння, відавочна загрузіўшы кадры:
    ./ffmpeg -init_hw_device cuda=cuda -filter_hw_device cuda \
        -f lavfi -i color=size=800x600:color=white,format=yuv420p \
        -f lavfi -i yuvtestsrc=size=200x200,format=yuv420p \
        -filter_complex \
        " \
            [0]hwupload[under]; \
            [1]hwupload,chromakey_cuda=green:0.1:0.12[over]; \
            [under][over]overlay_cuda" \
        -c:v hevc_nvenc -cq 18 -preset slow output.mp4
    

11.23 chromanr

Паменшыць каляровы шум.

Фільтр прымае наступныя параметры:

thres

Усталюйце парог для асераднення значэнняў каляровасці. Сума абсалютнай рознасці піксельных кампанентаў Y, U і V бягучага пікселя і суседніх пікселяў, ніжэйшых за гэты парог, будзе выкарыстоўвацца пры вылічэнні сярэдняга значэння. Кампанент Luma застаецца без зменаў і капіюецца на выхад. Значэнне па змаўчанні - 30. Дазволены дыяпазон - ад 1 да 200.

sizew

Задайце гарызантальны радыус прамавугольніка, які выкарыстоўваецца для асераднення. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 5.

sizeh

Задайце вертыкальны радыус прамавугольніка, які выкарыстоўваецца для асераднення. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 5.

stepw

Усталюйце гарызантальны крок пры асерадненні. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 50. У асноўным карысна для паскарэння фільтрацыі.

steph

Усталюйце крок па вертыкалі пры асерадненні. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 50. У асноўным карысна для паскарэння фільтрацыі.

threy

Усталюйце парог Y для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі Y бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.

threu

Усталюйце парог U для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі U бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.

threv

Усталюйце парог V для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі V бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.

distance

Усталюйце тып адлегласці, які выкарыстоўваецца ў разліках.

'manhattan'

Абсалютная розніца.

'euclidean'

Розніца ў квадраце.

Тып адлегласці па змаўчанні - Manhattan.

11.23.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

11.24 chromashift

Зрух пікселяў каляровасці па гарызанталі і/або вертыкалі.

Фільтр прымае наступныя параметры:

cbh

Усталюйце велічыню зрушэння сіняга колеру па гарызанталі.

cbv

Усталюйце велічыню зрушэння сіняга колеру па вертыкалі.

crh

Усталюйце велічыню зрушэння колерна-чырвонага па гарызанталі.

crv

Усталюйце велічыню зруху колерна-чырвонага па вертыкалі.

edge

Усталяваць рэжым краю, можа быць smear, стандартны або warp.

11.24.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.25 ciescope

Адлюстраванне каляровай дыяграмы CIE з накладзенымі на яе пікселямі.

Фільтр прымае наступныя параметры:

system

Усталяваць каляровую сістэму.

'ntsc, 470m'
'ebu, 470bg'
'smpte'
'240m'
'apple'
'widergb'
'cie1931'
'rec709, hdtv'
'uhdtv, rec2020'
'dcip3'
cie

Усталяваць сістэму CIE.

'xyy'
'ucs'
'luv'
gamuts

Усталюйце, якія гамы маляваць.

Глядзіце systemварыянт для даступных значэнняў.

size, s

Усталюйце памер ciescope, па змаўчанні 512.

intensity, i

Задайце інтэнсіўнасць, якая выкарыстоўваецца для адлюстравання значэнняў уваходных пікселяў у дыяграме CIE.

contrast

Задаць кантраст, які выкарыстоўваецца для малявання колераў мовы, якія выходзяць за межы актыўнай каляровай гамы.

corrgamma

Правільная гама адлюстроўваецца на прыцэле, па змаўчанні ўключана.

showwhite

Паказаць белую кропку на дыяграме CIE, па змаўчанні адключана.

gamma

Задаць гаму ўводу. Выкарыстоўваецца толькі з уваходнай каляровай прасторай XYZ.

fill

Запоўніце колерамі CIE. Па змаўчанні ўключана.

11.26 codecview

Візуалізуйце інфармацыю, экспартаваную некаторымі кодэкамі.

Некаторыя кодэкі могуць экспартаваць інфармацыю праз кадры з выкарыстаннем пабочных дадзеных або іншымі сродкамі. Напрыклад, некаторыя кодэкі на аснове MPEG экспартуюць вектары руху праз export_mvsсцяг у кодэкуflags2варыянт.

Фільтр прымае наступныя параметры:

block

Адлюстраванне блочнай структуры раздзелаў з дапамогай плоскасці яркасці.

mv

Задайце вектары руху для візуалізацыі.

Даступныя сцягі для mv:

'pf'

наперад прагназаваныя MV P-кадраў

'bf'

наперад прагназаваныя MV B-кадраў

'bb'

назад прагназаваныя MV B-кадраў

qp

Адлюстраванне параметраў квантавання з дапамогай плоскасцей каляровасці.

mv_type, mvt

Усталюйце тып вектараў руху для візуалізацыі. Уключае MV з усіх кадраў, калі не вызначана frame_typeпараметрам.

Даступныя сцягі для mv_type:

'fp'

наперад прагназаваныя МВ

'bp'

назад прагназаваныя МВ

frame_type, ft

Усталюйце тып кадра для візуалізацыі вектараў руху.

Даступныя сцягі для frame_type:

'if'

унутрыкадаваныя кадры (I-кадры)

'pf'

прагназаваныя кадры (P-кадры)

'bf'

кадры з двунакіраваным прагназаваннем (B-кадры)

11.26.1 Examples

  • Візуалізуйце прагназаваныя MV усіх кадраў з дапамогай ffplay:
    ffplay -flags2 +export_mvs input.mp4 -vf codecview=mv_type=fp
    
  • Візуалізуйце шматнакіраваныя MV P і B-кадраў з дапамогай ffplay:
    ffplay -flags2 +export_mvs input.mp4 -vf codecview=mv=pf+bf+bb
    

11.27 colorbalance

Змяніць інтэнсіўнасць асноўных колераў (чырвонага, зялёнага і сіняга) уваходных кадраў.

Фільтр дазваляе наладжваць уваходны кадр у ценявых, паўтонавых або светлых абласцях для балансу чырвона-блакітнага, зялёна-пурпурнога або сіне-жоўтага.

Станоўчае значэнне рэгулявання ссоўвае баланс у бок асноўнага колеру, адмоўнае значэнне - у бок дадатковага колеру.

Фільтр прымае наступныя параметры:

rs
gs
bs

Адрэгулюйце чырвоныя, зялёныя і сінія цені (самыя цёмныя пікселі).

rm
gm
bm

Адрэгулюйце чырвоны, зялёны і сіні паўтоны (сярэднія пікселі).

rh
gh
bh

Адрэгулюйце чырвоныя, зялёныя і сінія блікі (самыя яркія пікселі).

Дазволеныя дыяпазоны для параметраў: [-1.0, 1.0]. Па змаўчанні 0.

pl

Захоўвайце лёгкасць пры змене каляровага балансу. Па змаўчанні адключана.

11.27.1 Examples

  • Дадайце ценям чырвоны колер:
    colorbalance=rs=.3
    

11.27.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.28 colorcontrast

Адрэгулюйце каляровы кантраст паміж кампанентамі RGB.

Фільтр прымае наступныя параметры:

rc

Усталюйце чырвона-блакітны кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.

gm

Усталюйце зялёна-пурпурны кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.

by

Усталюйце сіне-жоўты кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.

rcw
gmw
byw

Усталюйце вагу кожнага значэння опцыі rc, gm, . byЗначэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0. Калі ўсе вагі роўныя 0,0, фільтраванне адключана.

pl

Усталюйце колькасць захавання лёгкасці. Значэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0.

11.28.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.29 colorcorrect

Адрэгулюйце каляровы баланс белага выбарачна для чорнага і белага. Гэты фільтр працуе ў каляровай прасторы YUV.

Фільтр прымае наступныя параметры:

rl

Усталюйце чырвоную ценявую пляму. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.

bl

Усталюйце сінюю ценявую пляму. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.

rh

Усталюйце чырвонае вылучэнне. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.

bh

Усталюйце чырвонае вылучэнне. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.

saturation

Усталюйце велічыню насычэння. Дазволены дыяпазон ад -3,0 да 3,0. Значэнне па змаўчанні - 1.

analyze

Калі ўсталявана што-небудзь іншае, manualяно будзе аналізаваць кожны кадр і выкарыстоўваць вытворныя параметры для фільтрацыі выходнага кадра.

Магчымыя значэнні:

'manual'
'average'
'minmax'
'median'

Значэнне па змаўчанні - manual.

11.29.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.30 colorchannelmixer

Адрэгулюйце ўваходныя кадры відэа шляхам паўторнага змешвання каляровых каналаў.

Гэты фільтр змяняе каляровы канал, дадаючы значэнні, звязаныя з іншымі каналамі тых жа пікселяў. Напрыклад, калі значэнне, якое трэба змяніць, чырвонае, выхадное значэнне будзе:

red=red*rr + blue*rb + green*rg + alpha*ra

Фільтр прымае наступныя параметры:

rr
rg
rb
ra

Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога чырвонага канала. Па змаўчанні 1для rr, і 0для rg, rbі ra.

gr
gg
gb
ga

Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выходнага зялёнага канала. Па змаўчанні 1для gg, і 0для gr, gbі ga.

br
bg
bb
ba

Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога сіняга канала. Па змаўчанні 1для bb, і 0для br, bgі ba.

ar
ag
ab
aa

Наладзьце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога альфа-канала. Па змаўчанні 1для aa, і 0для ar, agі ab.

Дазволеныя дыяпазоны для параметраў: [-2.0, 2.0].

pc

Усталяваць рэжым захавання колеру. Дапушчальныя значэнні:

'none'

Адключыць захаванне колеру, гэта па змаўчанні.

'lum'

Захаваць яркасць.

'max'

Захаваць максімальнае значэнне трыплета RGB.

'avg'

Захаваць сярэдняе значэнне трыплета RGB.

'sum'

Захаваць сумарнае значэнне трыплета RGB.

'nrm'

Захаваць нармалізаванае значэнне трыплета RGB.

'pwr'

Захаваць значэнне магутнасці трыплета RGB.

pa

Усталюйце колькасць захавання колеру пры змене колеру. Дазволены дыяпазон ад [0.0, 1.0]. Па змаўчанні 0.0, таму адключана.

11.30.1 Examples

  • Пераўтварыць крыніцу ў адценні шэрага:
    colorchannelmixer=.3:.4:.3:0:.3:.4:.3:0:.3:.4:.3
    
  • Імітацыя тонаў сэпіі:
    colorchannelmixer=.393:.769:.189:0:.349:.686:.168:0:.272:.534:.131
    

11.30.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.31 colorize

Накласці суцэльны колер на відэаструмень.

Фільтр прымае наступныя параметры:

hue

Усталюйце адценне колеру. Дазволены дыяпазон ад 0 да 360. Значэнне па змаўчанні - 0.

saturation

Усталюйце насычанасць колеру. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,5.

lightness

Усталюйце светлату колеру. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,5.

mix

Усталюйце спалучэнне крыніцы лёгкасці. Па змаўчанні ўстаноўлена 1.0. Дазволены дыяпазон ад 0,0 да 1,0.

11.31.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.32 colorkey

Каляровая маніпуляцыя каляровай прасторы RGB. Гэты фільтр працуе з кадрамі 8-бітнага фармату RGB, усталёўваючы альфа-кампанент кожнага пікселя, які трапляе ў радыус падабенства ключавога колеру, на 0. Значэнне альфа для пікселяў па-за радыусам падабенства залежыць ад значэння опцыі змешвання.

Фільтр прымае наступныя параметры:

color

Усталюйце колер, для якога альфа будзе ўсталяваны ў 0 (поўная празрыстасць). Глядзіце (ffmpeg-utils) раздзел «Колер» у кіраўніцтве ffmpeg-utils . Па змаўчанні black.

similarity

Усталюйце радыус ад ключавога колеру, у межах якога іншыя колеры таксама маюць поўную празрыстасць. Вылічаная адлегласць звязана з доляй адзінкі адлегласці ў 3D-прасторы паміж значэннямі RGB ключавога колеру і колерам пікселя. Дыяпазон ад 0,01 да 1,0. 0,01 адпавядае ў вельмі малым радыусе вакол дакладнага колеру ключа, а 1,0 адпавядае ўсім. Па змаўчанні 0.01.

blend

Устанавіце, як вылічваецца альфа-значэнне для пікселяў, якія знаходзяцца за межамі радыусу падабенства. 0.0 робіць пікселі альбо цалкам празрыстымі, альбо цалкам непразрыстымі. Больш высокія значэнні атрымліваюць напаўпразрыстыя пікселі, пры большай празрыстасці колер пікселя больш падобны да ключавога колеру. Дыяпазон ад 0,0 да 1,0. Па змаўчанні 0.0.

11.32.1 Examples

  • Зрабіце кожны зялёны піксель на ўваходным малюнку празрыстым:
    ffmpeg -i input.png -vf colorkey=green out.png
    
  • Накласці зялёнае відэа на статычны фонавы малюнак.
    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
    

11.32.2 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.33 colorhold

Выдаліць усю інфармацыю аб колерах для ўсіх колераў RGB, акрамя пэўнага.

Фільтр прымае наступныя параметры:

color

Колер, які нельга замяніць на нейтральны шэры.

similarity

Працэнт падабенства з вышэйзгаданым колерам. 0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.

blend

Працэнт сумесі. 0.0 робіць пікселі цалкам шэрымі. Больш высокія значэнні забяспечваюць больш захаваны колер.

11.33.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.34 colorlevels

Адрэгулюйце ўваходныя відэакадры з дапамогай узроўняў.

Фільтр прымае наступныя параметры:

rimin
gimin
bimin
aimin

Адрэгулюйце чырвоную, зялёную, сінюю і альфа-чорную кропку ўводу. Дазволеныя дыяпазоны для параметраў: [-1.0, 1.0]. Па змаўчанні 0.

rimax
gimax
bimax
aimax

Адрэгулюйце чырвоную, зялёную, сінюю і альфа-кропку ўваходнага белага. Дазволеныя дыяпазоны для параметраў: [-1.0, 1.0]. Па змаўчанні 1.

Ўзроўні ўваходу выкарыстоўваюцца для асвятлення блікаў (яркія тоны), пацямнення ценяў (цёмныя тоны), змены балансу яркіх і цёмных тонаў.

romin
gomin
bomin
aomin

Адрэгулюйце чырвоную, зялёную, сінюю і альфа-кропку чорнага выхаду. Дазволеныя дыяпазоны для параметраў: [0, 1.0]. Па змаўчанні 0.

romax
gomax
bomax
aomax

Наладзьце чырвоную, зялёную, сінюю і альфа-кропку белага. Дазволеныя дыяпазоны для параметраў: [0, 1.0]. Па змаўчанні 1.

Выхадныя ўзроўні дазваляюць уручную выбраць абмежаваны дыяпазон выхаднога ўзроўню.

preserve

Усталяваць рэжым захавання колеру. Дапушчальныя значэнні:

'none'

Адключыць захаванне колеру, гэта па змаўчанні.

'lum'

Захаваць яркасць.

'max'

Захаваць максімальнае значэнне трыплета RGB.

'avg'

Захаваць сярэдняе значэнне трыплета RGB.

'sum'

Захаваць сумарнае значэнне трыплета RGB.

'nrm'

Захаваць нармалізаванае значэнне трыплета RGB.

'pwr'

Захаваць значэнне магутнасці трыплета RGB.

11.34.1 Examples

  • Зрабіць выхад відэа цямней:
    colorlevels=rimin=0.058:gimin=0.058:bimin=0.058
    
  • Павялічыць кантраснасць:
    colorlevels=rimin=0.039:gimin=0.039:bimin=0.039:rimax=0.96:gimax=0.96:bimax=0.96
    
  • Зрабіць выхад відэа больш светлым:
    colorlevels=rimax=0.902:gimax=0.902:bimax=0.902
    
  • Павялічыць яркасць:
    colorlevels=romin=0.5:gomin=0.5:bomin=0.5
    

11.34.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.35 colormap

Прымяніць карыстальніцкія каляровыя карты да відэаструменю.

Гэтаму фільтру патрэбны тры ўваходныя відэапатокі. Першы паток - гэта відэапаток, які будзе адфільтраваны. Другі і трэці відэапаток вызначаюць каляровыя плямы для зыходнага колеру і мэтавага адлюстравання колераў.

Фільтр прымае наступныя параметры:

patch_size

Усталюйце памер патча крыніцы і мэтавага відэапатоку ў пікселях.

nb_patches

Усталюйце максімальную колькасць выкарыстоўваных патчаў з зыходнага і мэтавага відэаструменю. Значэнне па змаўчанні - колькасць патчаў, даступных у дадатковых відэапатоках. Максімальна дазволеная колькасць патчаў складае 64.

type

Усталюйце налады, якія выкарыстоўваюцца для мэтавых колераў. Можа быць relativeабо absolute. Па змаўчанні гэта absolute.

kernel

Усталюйце ядро, якое выкарыстоўваецца для вымярэння каляровых адрозненняў паміж адлюстраванымі колерамі.

Дапушчальныя значэнні:

'euclidean'
'weuclidean'

Па змаўчанні euclidean.

11.36 colormatrix

Пераўтварэнне каляровай матрыцы.

Фільтр прымае наступныя параметры:

src
dst

Укажыце зыходную і мэтавую каляровую матрыцу. Абодва значэння павінны быць указаны.

Дапушчальныя значэнні:

'bt709'

BT.709

'fcc'

FCC

'bt601'

BT.601

'bt470'

BT.470

'bt470bg'

BT.470BG

'smpte170m'

СМПТЭ-170М

'smpte240m'

СМПТЭ-240М

'bt2020'

БТ.2020

Напрыклад, каб пераўтварыць з BT.601 у SMPTE-240M, выкарыстоўвайце каманду:

colormatrix=bt601:smpte240m

11.37 colorspace

Пераўтварэнне каляровай прасторы, характарыстык перадачы або асноўных колераў. Уваходнае відэа павінна мець роўны памер.

Фільтр прымае наступныя параметры:

all

Укажыце адразу ўсе ўласцівасці колеру.

Дапушчальныя значэнні:

'bt470m'

BT.470M

'bt470bg'

BT.470BG

'bt601-6-525'

БТ.601-6 525

'bt601-6-625'

БТ.601-6 625

'bt709'

BT.709

'smpte170m'

СМПТЭ-170М

'smpte240m'

СМПТЭ-240М

'bt2020'

БТ.2020

space

Укажыце каляровую прастору выхаду.

Дапушчальныя значэнні:

'bt709'

BT.709

'fcc'

FCC

'bt470bg'

BT.470BG або BT.601-6 625

'smpte170m'

SMPTE-170M або BT.601-6 525

'smpte240m'

СМПТЭ-240М

'ycgco'

YCgCo

'bt2020ncl'

BT.2020 з непастаяннай яркасцю

trc

Укажыце характарыстыкі перадачы выхаду.

Дапушчальныя значэнні:

'bt709'

BT.709

'bt470m'

BT.470M

'bt470bg'

BT.470BG

'gamma22'

Пастаянная гама 2,2

'gamma28'

Сталая гама 2,8

'smpte170m'

SMPTE-170M, BT.601-6 625 або BT.601-6 525

'smpte240m'

СМПТЭ-240М

'srgb'

СРГБ

'iec61966-2-1'

iec61966-2-1

'iec61966-2-4'

iec61966-2-4

'xvycc'

xvycc

'bt2020-10'

BT.2020 для 10-бітнага кантэнту

'bt2020-12'

BT.2020 для 12-бітнага кантэнту

primaries

Укажыце асноўныя колеры вываду.

Дапушчальныя значэнні:

'bt709'

BT.709

'bt470m'

BT.470M

'bt470bg'

BT.470BG або BT.601-6 625

'smpte170m'

SMPTE-170M або BT.601-6 525

'smpte240m'

СМПТЭ-240М

'film'

фільм

'smpte431'

SMPTE-431

'smpte432'

СМПТЭ-432

'bt2020'

БТ.2020

'jedec-p22'

Люмінафор JEDEC P22

range

Укажыце дыяпазон колераў вываду.

Дапушчальныя значэнні:

'tv'

ТБ (абмежаваны) дыяпазон

'mpeg'

MPEG (абмежаваны) дыяпазон

'pc'

ПК (поўны) дыяпазон

'jpeg'

JPEG (поўны) дыяпазон

format

Укажыце фармат выхаднога колеру.

Дапушчальныя значэнні:

'yuv420p'

YUV 4:2:0 плоскі 8-біт

'yuv420p10'

YUV 4:2:0 плоскі 10 біт

'yuv420p12'

YUV 4:2:0 плоскі 12-біт

'yuv422p'

YUV 4:2:2 плоскі 8-біт

'yuv422p10'

YUV 4:2:2 плоскі 10-біт

'yuv422p12'

YUV 4:2:2 плоскі 12-біт

'yuv444p'

YUV 4:4:4 плоскі 8-біт

'yuv444p10'

YUV 4:4:4 плоскі 10-біт

'yuv444p12'

YUV 4:4:4 плоскі 12-біт

fast

Выканайце хуткае пераўтварэнне, якое прапускае гама/асноўную карэкцыю. Гэта зойме значна менш працэсара, але будзе матэматычна няправільным. Каб атрымаць вывад, сумяшчальны з вынікам фільтра colormatrix, выкарыстоўвайце fast=1.

dither

Укажыце рэжым дызерінга.

Дапушчальныя значэнні:

'none'

Ніякага вагання

'fsb'

Дызерінг Флойда-Стэйнберга

wpadapt

Рэжым адаптацыі Whitepoint.

Дапушчальныя значэнні:

'bradford'

Брэдфардская адаптацыя белай кропкі

'vonkries'

адаптацыя фон Крыса

'identity'

адаптацыя белай кропкі ідэнтычнасці (г.зн. без адаптацыі белай кропкі)

iall

Перавызначыць усе ўласцівасці ўводу адначасова. Тыя ж прынятыя значэнні, што і ўсе .

ispace

Перавызначыць каляровую прастору ўводу. Такія ж прынятыя значэнні, што і прабел .

iprimaries

Перавызначэнне асноўных колераў уводу. Тыя ж прынятыя значэнні, што і праймерыз .

itrc

Перавызначэнне ўваходных характарыстык перадачы. Такія ж прынятыя значэнні, што і trc .

irange

Перавызначыць дыяпазон колераў уводу. Такія ж прынятыя значэнні, што і дыяпазон .

Фільтр пераўтворыць характарыстыкі перадачы, каляровую прастору і асноўныя колеры ў зададзеныя карыстальніцкімі значэннямі. Выходнае значэнне, калі яно не вызначана, усталёўваецца ў значэнне па змаўчанні на аснове ўласцівасці "ўсе". Калі гэта ўласцівасць таксама не вызначана, фільтр запісвае памылку. Дыяпазон і фармат выхадных колераў па змаўчанні маюць тое ж значэнне, што і дыяпазон і фармат уваходных колераў. Уваходныя характарыстыкі перадачы, каляровая прастора, асноўныя колеры і дыяпазон колераў павінны быць устаноўлены на ўваходных дадзеных. Калі што-небудзь з гэтага адсутнічае, фільтр запісвае памылку і пераўтварэнне не адбудзецца.

Напрыклад, каб пераўтварыць уваход у SMPTE-240M, выкарыстоўвайце каманду:

colorspace=smpte240m

11.38 colortemperature

Адрэгулюйце каляровую тэмпературу ў відэа, каб імітаваць змены каляровай тэмпературы навакольнага асяроддзя.

Фільтр прымае наступныя параметры:

temperature

Усталюйце тэмпературу ў Кельвінах. Дазволены дыяпазон ад 1000 да 40000. Значэнне па змаўчанні - 6500 К.

mix

Усталюйце змешванне з адфільтраваным выхадам. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

pl

Усталюйце колькасць захавання лёгкасці. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.

11.38.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.39 convolution

Ужывайце згортванне 3x3, 5x5, 7x7 або гарызантальнае/вертыкальнае да 49 элементаў.

Фільтр прымае наступныя параметры:

0m
1m
2m
3m

Усталюйце матрыцу для кожнай плоскасці. Матрыца - гэта паслядоўнасць з 9, 25 або 49 цэлых лікаў са знакам у squareрэжыме і ад 1 да 49 няцотных лікаў са знакам у rowрэжыме.

0rdiv
1rdiv
2rdiv
3rdiv

Усталюйце множнік для разліковага значэння для кожнай плоскасці. Калі не ўстаноўлена або 0, гэта будзе сума ўсіх элементаў матрыцы.

0bias
1bias
2bias
3bias

Усталюйце ўхіл для кожнай плоскасці. Гэта значэнне дадаецца да выніку множання. Карысна, каб зрабіць агульны малюнак ярчэй або цямней. Па змаўчанні 0,0.

0mode
1mode
2mode
3mode

Усталюйце рэжым матрыцы для кожнай плоскасці. Можа быць square, rowабо column. Па змаўчанні square.

11.39.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.39.2 Examples

  • Ужыць рэзкасць:
    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"
    
  • Прымяніць размыццё:
    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"
    
  • Прымяніць паляпшэнне краёў:
    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"
    
  • Прымяніць вызначэнне краю:
    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"
    
  • Ужывайце дэтэктар краёў Лапласа, які ўключае дыяганалі:
    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"
    
  • Нанесці рэльеф:
    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"
    

11.40 convolve

Прымяніць двухмерную згортку відэаструменю ў частотнай вобласці з выкарыстаннем другога патоку ў якасці імпульсу.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці апрацоўваць.

impulse

Усталяваць, якія імпульсныя відэакадры будуць апрацоўвацца, можна first або all. Па змаўчанні all.

Фільтр convolveтаксама падтрымлівае параметры framesync .

11.41 copy

Скапіруйце крыніцу ўваходнага відэа без змен на выхад. Гэта ў асноўным карысна для тэставання.

11.42 coreimage

Фільтраванне відэа на графічным працэсары з выкарыстаннем Apple CoreImage API на OSX.

Апаратнае паскарэнне заснавана на кантэксце OpenGL. Звычайна гэта азначае, што яно апрацоўваецца відэаабсталяваннем. Тым не менш, існуюць праграмныя рэалізацыі OpenGL, што азначае, што няма гарантыі для апаратнай апрацоўкі. Гэта залежыць ад адпаведнай OSX.

Ёсць шмат фільтраў і генератараў малюнкаў ад Apple, якія пастаўляюцца з вялікім выбарам опцый. Спасылка на фільтр павінна быць названа разам з параметрамі.

Фільтр coreimage прымае наступныя параметры:

list_filters

Пералічыце ўсе даступныя фільтры і генератары разам з усімі іх адпаведнымі параметрамі, а таксама магчымыя мінімальныя і максімальныя значэнні разам са значэннямі па змаўчанні.

list_filters=true
filter

Укажыце ўсе фільтры па іх адпаведных назвах і параметрах. Выкарыстоўвайце list_filtersдля вызначэння ўсіх сапраўдных назваў фільтраў і параметраў. Лікавыя параметры задаюцца значэннем з плаваючай часткай і аўтаматычна прывязваюцца да адпаведнага дыяпазону значэнняў. Варыянты вектара і колеру павінны быць вызначаны спісам значэнняў з плаваючай часткай, падзеленых прабеламі. Уцёкі персанажа павінны быць зроблены. defaultДля выкарыстання параметраў па змаўчанні для фільтра даступна спецыяльная назва опцыі .

Неабходна ўказаць defaultадзін з варыянтаў фільтра або хаця б адзін. Усе прапушчаныя параметры выкарыстоўваюцца са значэннямі па змаўчанні. Сінтаксіс радка фільтра наступны:

filter=<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...][#<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...]][#...]
output_rect

Укажыце прастакутнік, у якім вывад ланцужка фільтра капіюецца ва ўваходны малюнак. Яно задаецца спісам значэнняў float, падзеленых прабеламі:

output_rect=x\ y\ width\ height

Калі не зададзены, то выхадны прамавугольнік роўны памерам уваходнага малюнка. Выхадны прамавугольнік аўтаматычна абразаецца па межах уваходнага малюнка. Адмоўныя значэнні сапраўдныя для кожнага кампанента.

output_rect=25\ 25\ 100\ 100

Некалькі фільтраў можна злучыць для паслядоўнай апрацоўкі без перадачы GPU-HOST, што дазваляе хутка апрацоўваць складаныя ланцужкі фільтраў. У цяперашні час падтрымліваюцца толькі фільтры з нулявым (генератары) або дакладна адным (фільтры) уваходным відарысам і адным выходным відарысам. Акрамя таго, пераходныя фільтры пакуль непрыдатныя для выкарыстання па прызначэнні.

Некаторыя фільтры генеруюць выходныя выявы з дадатковым запаўненнем у залежнасці ад адпаведнага ядра фільтра. Пракладка аўтаматычна выдаляецца, каб гарантаваць, што вынік фільтра мае той жа памер, што і ўваходны малюнак.

Для генератараў малюнкаў памер выходнага відарыса вызначаецца адпаведна папярэднім выходным відарысам ланцужка фільтраў або ўваходным відарысам усяго ланцужка фільтраў. Генератары не выкарыстоўваюць інфармацыю аб пікселях гэтага відарыса для стварэння сваіх выходных дадзеных. Тым не менш, згенераваны вынік змешваецца з гэтым відарысам, што прыводзіць да частковага або поўнага пакрыцця выходнага відарыса.

Крыніца відэа coreimagesrc можа быць выкарыстана для генерацыі ўваходных відарысаў, якія непасрэдна падаюцца ў ланцуг фільтра. Пры яго выкарыстанні не патрабуецца прадастаўленне ўваходных малюнкаў з іншай крыніцы відэа ці ўваходнага відэа.

11.42.1 Examples

  • Спіс усіх даступных фільтраў:
    coreimage=list_filters=true
    
  • Выкарыстоўвайце фільтр CIBoxBlur з параметрамі па змаўчанні, каб размыць малюнак:
    coreimage=filter=CIBoxBlur@default
    
  • Выкарыстоўвайце ланцужок фільтраў са значэннямі па змаўчанні CISepiaTone і CIVignetteEffect з цэнтрам 100x100 і радыусам 50 пікселяў:
    coreimage=filter=CIBoxBlur@default#CIVignetteEffect@inputCenter=100\ 100@inputRadius=50
    
  • Выкарыстоўвайце nullsrc і CIQRCodeGenerator, каб стварыць QR-код для галоўнай старонкі FFmpeg, зададзены ў выглядзе поўнага і экранаванага каманднага радка для стандартнай абалонкі bash ад Apple:
    ffmpeg -f lavfi -i nullsrc=s=100x100,coreimage=filter=CIQRCodeGenerator@inputMessage=https\\\\\://FFmpeg.org/@inputCorrectionLevel=H -frames:v 1 QRCode.png
    

11.43 cover_rect

Накрыйце прамавугольны прадмет

Ён прымае наступныя варыянты:

cover

Шлях да файла неабавязковай выявы вокладкі павінен быць у yuv420.

mode

Усталюйце рэжым пакрыцця.

Ён прымае наступныя значэнні:

'cover'

накрыйце яго пастаўленым малюнкам

'blur'

пакрыць яго шляхам інтэрпаляцыі навакольных пікселяў

Значэнне па змаўчанні - blur.

11.43.1 Examples

  • Накрыйце прамавугольны аб'ект прадастаўленай выявай дадзенага відэа, выкарыстоўваючы ffmpeg:
    ffmpeg -i file.ts -vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
    

11.44 crop

Абрэзаць уваходнае відэа да зададзеных памераў.

Ён прымае наступныя параметры:

w, out_w

Шырыня выхаднога відэа. Па змаўчанні гэта iw. Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі фільтра або калі 'w'ці'out_w' каманда адпраўлена.

h, out_h

Вышыня выхаднога відэа. Па змаўчанні гэта ih. Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі фільтра або калі 'h'ці'out_h' каманда адпраўлена.

x

Гарызантальнае становішча левага краю выхаднога відэа ва ўваходным відэа. Па змаўчанні гэта (in_w-out_w)/2. Гэты выраз вылічваецца пакадрава.

y

Вертыкальнае становішча верхняга краю выхаднога відэа ва ўваходным відэа. Па змаўчанні гэта (in_h-out_h)/2. Гэты выраз вылічваецца пакадрава.

keep_aspect

Калі ўстаноўлена значэнне 1, фармат выходнага дысплея будзе такім жа, як і ўваходны, шляхам змены суадносін бакоў выхаднога ўзору. Па змаўчанні гэта 0.

exact

Уключыць дакладнае кадраванне. Калі ўключана, відэа з субвыбаркай будуць абрэзаны па дакладнай шырыні/вышыні/x/y, як паказана, і не будуць акругляцца да бліжэйшага меншага значэння. Па змаўчанні гэта 0.

Параметры out_w, out_h, x, y- гэта выразы, якія змяшчаюць наступныя канстанты:

x
y

Вылічаныя значэнні для xі y. Яны ацэньваюцца для кожнага новага кадра.

in_w
in_h

Шырыня і вышыня ўводу.

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Выхадныя (абрэзаныя) шырыня і вышыня.

ow
oh

Гэта тое самае, што out_wі out_h.

a

тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

суадносіны бакоў уваходнага дысплея, яно такое ж, як ( iw/ ih) *sar

hsub
vsub

гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

n

Нумар уваходнага кадра, пачынаючы з 0.

pos

пазіцыя ў файле ўваходнага кадра, NAN, калі невядома

t

Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.

Выраз для out_wможа залежаць ад значэння out_h, а выраз для out_hможа залежаць ад out_w, але яны не могуць залежаць ад xі y, паколькі xі yвылічваюцца пасля out_wі out_h.

Параметры xі yзадаюць выразы для пазіцыі левага верхняга кута вывадной (неабрэзанай) вобласці. Яны ацэньваюцца для кожнага кадра. Калі ацэненае значэнне несапраўднае, яно набліжаецца да бліжэйшага сапраўднага значэння.

Выраз для xможа залежаць ад y, а выраз для yможа залежаць ад x.

11.44.1 Examples

  • Плошча абрэзкі памерам 100x100 у пазіцыі (12,34).
    crop=100:100:12:34
    

    Выкарыстоўваючы названыя параметры, прыклад вышэй становіцца:

    crop=w=100:h=100:x=12:y=34
    
  • Абрэжце цэнтральную вобласць уводу памерам 100x100:
    crop=100:100
    
  • Абрэжце цэнтральную вобласць уводу памерам 2/3 уваходнага відэа:
    crop=2/3*in_w:2/3*in_h
    
  • Абрэжце цэнтральны квадрат ўваходнага відэа:
    crop=out_w=in_h
    crop=in_h
    
  • Аддзяліце прастакутнік левым верхнім вуглом у становішчы 100:100 і правым ніжнім вуглом, які адпавядае праваму ніжняму вуглу ўваходнага відарыса.
    crop=in_w-100:in_h-100:100:100
    
  • Абрэжце 10 пікселяў ад левай і правай межаў і 20 пікселяў ад верхняй і ніжняй межаў
    crop=in_w-2*10:in_h-2*20
    
  • Захоўвайце толькі ніжнюю правую чвэрць уваходнага малюнка:
    crop=in_w/2:in_h/2:in_w/2:in_h/2
    
  • Вышыня абрэзкі для атрымання грэцкай гармоніі:
    crop=in_w:1/PHI*in_w
    
  • Прымяніць эфект дрыгацення:
    crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(n/10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(n/7)
    
  • Прымяніць эфект няўстойлівай камеры ў залежнасці ад пазнакі часу:
    crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(t*10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(t*13)"
    
  • Усталюйце x у залежнасці ад значэння y:
    crop=in_w/2:in_h/2:y:10+10*sin(n/10)
    

11.44.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

w, out_w
h, out_h
x
y

Усталюйце шырыню/вышыню выхаднога відэа і гарызантальнае/вертыкальнае становішча ва ўваходным відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.45 cropdetect

Аўтаматычнае вызначэнне памеру кадравання.

Ён разлічвае неабходныя параметры абрэзкі і друкуе рэкамендаваныя параметры праз сістэму рэгістрацыі. Выяўленыя памеры адпавядаюць нечорнай вобласці ўваходнага відэа.

Ён прымае наступныя параметры:

limit

Усталюйце больш высокі парог значэння чорнага, які можна па жаданні задаць ад нічога (0) да ўсяго (255 для 8-бітных фарматаў). Значэнне інтэнсіўнасці, якое перавышае зададзенае значэнне, лічыцца не чорным. Па змаўчанні значэнне складае 24. Вы таксама можаце задаць значэнне ад 0,0 да 1,0, якое будзе маштабавацца ў залежнасці ад бітавай глыбіні піксельнага фармату.

round

Значэнне, на якое павінна дзяліцца шырыня/вышыня. Па змаўчанні гэта 16. Зрушэнне аўтаматычна рэгулюецца для цэнтравання відэа. Выкарыстоўвайце 2, каб атрымаць толькі цотныя памеры (неабходна для відэа 4:2:2). 16 лепш за ўсё падыходзіць для кадавання ў большасці відэакодэкаў.

skip

Усталюйце колькасць пачатковых кадраў, для якіх ацэнка прапускаецца. Па змаўчанні 2. Дыяпазон ад 0 да INT_MAX.

reset_count, reset

Усталюйце лічыльнік, які вызначае, праз колькі кадраў cropdetect скіне раней выяўленую вялікую вобласць відэа і пачне спачатку, каб вызначыць бягучую аптымальную вобласць абрэзкі. Значэнне па змаўчанні 0.

Гэта можа быць карысна, калі лагатыпы каналаў скажаюць вобласць відэа. 0 азначае "ніколі не скідаць" і вяртае найбольшую плошчу, сустрэтую падчас прайгравання.

11.46 cue

Затрымка фільтрацыі відэа да дадзенай меткі часу насценнага гадзінніка. Фільтр спачатку праходзіць далейprerollколькасць кадраў, то буферызуецца максімум bufferколькасць кадраў і чакае рэплікі. Пасля дасягнення рэплікі ён перасылае буферызаваныя кадры, а таксама любыя наступныя кадры, якія паступаюць на яго ўваход.

Фільтр можна выкарыстоўваць для сінхранізацыі вываду некалькіх працэсаў ffmpeg для прылад вываду ў рэальным часе, такіх як decklink. Дзякуючы затрымцы ў ланцужку фільтрацыі і папярэдняй буферызацыі кадраў працэс можа перадаваць даныя на выхад амаль адразу пасля дасягнення мэтавай меткі часу насценнага гадзінніка.

Ідэальную дакладнасць кадра нельга гарантаваць, але вынік дастаткова добры для некаторых выпадкаў выкарыстання.

cue

Пазнака часу, выражаная ў пазнацы часу UNIX у мікрасекундах. Па змаўчанні 0.

preroll

Працягласць змесціва для перадачы ў якасці прэролу, выражаная ў секундах. Па змаўчанні 0.

buffer

Максімальная працягласць змесціва для буферызацыі перад чаканнем сігналу, выражаная ў секундах. Па змаўчанні 0.

11.47 curves

Прымяніць карэкціроўкі колеру з дапамогай крывых.

Гэты фільтр падобны на інструменты крывых Adobe Photoshop і GIMP. Кожны кампанент (чырвоны, зялёны і сіні) мае свае значэнні, вызначаныя Nключавымі кропкамі, звязанымі адна з адной з дапамогай плаўнай крывой. Па восі х адкладзены значэнні пікселяў з уваходнага кадра, а па восі ординат — новыя значэнні пікселяў, якія будуць устаноўлены для выхаднога кадра.

Па змаўчанні крывая кампанента вызначаецца дзвюма кропкамі (0;0)і (1;1). Гэта стварае прамую лінію, на якой кожнае першапачатковае значэнне пікселя "прыстасоўваецца" да ўласнага значэння, што азначае адсутнасць змяненняў у малюнку.

Фільтр дазваляе перавызначыць гэтыя два моманты і дадаць яшчэ. Будзе вызначана новая крывая (з выкарыстаннем натуральнай кубічнай сплайн-інтэрпаляцыі), якая плаўна праходзіць праз усе гэтыя новыя каардынаты. Новыя вызначаныя кропкі павінны быць строга ўзрастаючымі па восі х, а іх xзначэнні yпавінны знаходзіцца ў [0;1]інтэрвале. Калі вылічаныя крывыя апынуліся за межамі вектарных прастораў, значэнні будуць абрэзаны адпаведна.

Фільтр прымае наступныя параметры:

preset

Выберыце адзін з даступных налад колеру. Гэтую опцыю можна выкарыстоўваць у дадатак даr,g,bпараметры; у гэтым выпадку больш познія параметры маюць прыярытэт перад зададзенымі значэннямі. Даступныя перадусталёўкі:

'none'
'color_negative'
'cross_process'
'darker'
'increase_contrast'
'lighter'
'linear_contrast'
'medium_contrast'
'negative'
'strong_contrast'
'vintage'

Па змаўчанні none.

master, m

Усталюйце асноўныя ключавыя кропкі. Гэтыя кропкі будуць вызначаць адлюстраванне другога праходу. Часам яго называюць адлюстраваннем "яркасці" або "значэння". Яго можна выкарыстоўваць з r,g,bабоallтак як ён дзейнічае як LUT пасля апрацоўкі.

red, r

Усталюйце ключавыя кропкі для чырвонага кампанента.

green, g

Усталюйце ключавыя моманты для зялёнага кампанента.

blue, b

Усталюйце ключавыя кропкі для сіняга кампанента.

all

Усталюйце ключавыя кропкі для ўсіх кампанентаў (за выключэннем галоўнага). Можа выкарыстоўвацца ў дадатак да іншых варыянтаў кампанентаў ключавых кропак. У гэтым выпадку неўсталяваны кампанент(ы) будзе выкарыстоўваць гэта allўстаноўка.

psfile

Укажыце файл крывых Photoshop ( .acv), з якога трэба імпартаваць налады.

plot

Захаваць скрыпт Gnuplot крывых у паказаны файл.

Каб пазбегнуць канфліктаў сінтаксісу графіка фільтраў, кожны спіс ключавых пунктаў павінен быць вызначаны з дапамогай наступнага сінтаксісу: x0/y0 x1/y1 x2/y2 ....

11.47.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.47.2 Examples

  • Злёгку павялічце сярэдні ўзровень сіняга:
    curves=blue='0/0 0.5/0.58 1/1'
    
  • Вінтажны эфект:
    curves=r='0/0.11 .42/.51 1/0.95':g='0/0 0.50/0.48 1/1':b='0/0.22 .49/.44 1/0.8'
    

    Тут мы атрымліваем наступныя каардынаты для кожнага кампанента:

    red

    (0;0.11) (0.42;0.51) (1;0.95)

    green

    (0;0) (0.50;0.48) (1;1)

    blue

    (0;0.22) (0.49;0.44) (1;0.80)

  • Папярэдні прыклад таксама можа быць дасягнуты з дапамогай адпаведнай убудаванай перадусталёўкі:
    curves=preset=vintage
    
  • Ці проста:
    curves=vintage
    
  • Выкарыстоўвайце перадустаноўку Photoshop і перавызначце кропкі зялёнага кампанента:
    curves=psfile='MyCurvesPresets/purple.acv':green='0/0 0.45/0.53 1/1'
    
  • Праверце крывыя cross_processпрофілю з дапамогай ffmpeg і gnuplot:
    ffmpeg -f lavfi -i color -vf curves=cross_process:plot=/tmp/curves.plt -frames:v 1 -f null -
    gnuplot -p /tmp/curves.plt
    

11.48 datascope

Фільтр аналізу відэа дадзеных.

Гэты фільтр паказвае шаснаццатковае значэнне пікселяў часткі відэа.

Фільтр прымае наступныя параметры:

size, s

Задаць памер выхаднога відэа.

x

Усталюйце зрушэнне па х ад месца выбару пікселяў.

y

Усталюйце зрушэнне y ад месца выбару пікселяў.

mode

Усталяваць рэжым прыцэла можа быць адзін з наступнага:

'mono'

Намалюйце шаснаццатковыя значэнні пікселяў белым колерам на чорным фоне.

'color'

Намалюйце шаснаццатковыя значэнні пікселяў колерам пікселяў уваходнага відэа на чорным фоне.

'color2'

Намалюйце шаснаццатковыя значэнні пікселяў на каляровым фоне, абраным з уваходнага відэа, колер тэксту выбіраецца такім чынам, што ён заўсёды бачны.

axis

Намалюйце нумары ў радках і слупках злева і ўверсе відэа.

opacity

Задаць непразрыстасць фону.

format

Устанавіць фармат нумара для адлюстравання. Можа быць hex, або dec. Па змаўчанні hex.

components

Задаць піксельныя кампаненты для адлюстравання. Па змаўчанні адлюстроўваюцца ўсе піксельныя кампаненты.

11.48.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі без sizeопцыі.

11.49 dblur

Ужыць фільтр накіраванага размыцця.

Фільтр прымае наступныя параметры:

angle

Задаць вугал накіраванага размыцця. Па змаўчанні 45.

radius

Задаць радыус накіраванага размыцця. Па змаўчанні 5.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.

11.49.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.50 dctdnoiz

Знішчэнне шуму кадраў з дапамогай 2D DCT (фільтрацыя ў частотнай вобласці).

Гэты фільтр не прызначаны для рэальнага часу.

Фільтр прымае наступныя параметры:

sigma, s

Усталюйце сігма-канстанту шуму.

Гэта sigmaвызначае жорсткі парог 3 * sigma; кожны каэфіцыент DCT (абсалютная велічыня) ніжэй за гэты парог будзе адменены.

Калі вам патрэбна больш пашыраная фільтрацыя, глexpr.

Па змаўчанні 0.

overlap

Усталюйце колькасць пікселяў, якія перакрываюцца, для кожнага блока. Паколькі фільтр можа працаваць павольна, вы можаце паменшыць гэта значэнне за кошт менш эфектыўнага фільтра і рызыкі розных артэфактаў.

Калі значэнне, якое перакрываецца, не дазваляе апрацаваць усю шырыню або вышыню ўводу, будзе адлюстравана папярэджанне, і адпаведныя межы не будуць прыглушаны.

Значэнне па змаўчанні blocksize-1, што з'яўляецца найлепшым магчымым параметрам.

expr, e

Усталюйце каэфіцыент выразу множніка.

Для кожнага каэфіцыента блока DCT гэты выраз будзе ацэнены як значэнне множніка для каэфіцыента.

Калі гэты параметр усталяваны, тоsigmaварыянт будзе праігнараваны.

Абсалютнае значэнне каэфіцыента можна атрымаць праз c зменную.

n

Усталюйце blocksizeвыкарыстоўваючы колькасць бітаў. вызначае , які з'яўляецца шырынёй і вышынёй апрацаваных блокаў. 1<<nblocksize

Значэнне па змаўчанні 3(8x8) і можа быць павялічана да 416x16 blocksize. Майце на ўвазе, што змяненне гэтага параметра моцна ўплывае на хуткасць апрацоўкі. Акрамя таго, большы памер блока не абавязкова азначае лепшае паніжэнне шуму.

11.50.1 Examples

Прымяніць шум з дапамогай asigmaз 4.5:

dctdnoiz=4.5

Тая ж аперацыя можа быць выканана з дапамогай сістэмы выразаў:

dctdnoiz=e='gte(c, 4.5*3)'

Гвалтоўнае выдаленне шуму з выкарыстаннем блока памерам 16x16:

dctdnoiz=15:n=4

11.51 deband

Выдаліць артэфакты палос з уваходнага відэа. Ён працуе шляхам замены палосных пікселяў сярэднім значэннем спасылачных пікселяў.

Фільтр прымае наступныя параметры:

1thr
2thr
3thr
4thr

Усталюйце парог выяўлення палос для кожнай плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0,00003 да 0,5. Калі розніца паміж бягучым пікселем і эталонным пікселем меншая за парогавае значэнне, яна будзе разглядацца як палосная.

range, r

Дыяпазон выяўлення палос у пікселях. Значэнне па змаўчанні - 16. Калі станоўчае, для задання значэння будзе выкарыстоўвацца выпадковы лік у дыяпазоне 0. Калі адмоўнае, будзе выкарыстоўвацца дакладнае абсалютнае значэнне. Дыяпазон вызначае квадрат з чатырох пікселяў вакол бягучага пікселя.

direction, d

Усталюйце кірунак у радыянах, з якога будуць параўноўвацца чатыры пікселі. Калі станоўчы, будзе абраны выпадковы кірунак ад 0 да зададзенага кірунку. Калі адмоўны, будзе выбрана дакладнае абсалютнае значэнне. Напрыклад, кірунак 0, -PI або -2*PI у радыянах будзе выбіраць толькі пікселі ў адным радку, а -PI/2 - толькі пікселі ў тым жа слупку.

blur, b

Калі ўключана, бягучы піксель параўноўваецца з сярэднім значэннем усіх чатырох навакольных пікселяў. Па змаўчанні ўключана. Калі адключана, бягучы піксель параўноўваецца з усімі чатырма навакольнымі пікселямі. Піксель лічыцца палосным, калі толькі ўсе чатыры адрозненні з навакольнымі пікселямі менш парогавага значэння.

coupling, c

Калі ўключана, бягучы піксель змяняецца тады і толькі тады, калі ўсе кампаненты пікселя маюць паласы, напрыклад, парог выяўлення палос спрацоўвае для ўсіх кампанентаў колеру. Па змаўчанні адключана.

11.51.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.52 deblock

Выдаліць блакіруючыя артэфакты з уваходнага відэа.

Фільтр прымае наступныя параметры:

filter

Усталюйце тып фільтра, можа быць weakабо strong. Па змаўчанні strong. Гэта кантралюе, які тып дэблакіроўкі прымяняецца.

block

Усталюйце памер блока, дазволены дыяпазон ад 4 да 512. Па змаўчанні - 8.

alpha
beta
gamma
delta

Усталюйце парогі выяўлення блакіроўкі. Дазволены дыяпазон ад 0 да 1. Значэнні па змаўчанні: 0.098для alphaі 0.05для астатніх. Выкарыстанне больш высокага парога дае большую сілу дэблакіроўкі. Налада alphaкіруе выяўленнем парога на дакладным краі блока. Астатнія параметры кантралююць выяўленне парога каля краю. Кожны з іх унізе/уверсе або злева/справа. Вызначэнне любога з іх на 0адключае дэблакіроўку.

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні фільтруюць усе даступныя самалёты.

11.52.1 Examples

  • Дэблакіроўка з дапамогай слабога фільтра і памеру блока 4 пікселя.
    deblock=filter=weak:block=4
    
  • Дэблакіраванне з дапамогай моцнага фільтра, памеру блока 4 пікселя і карыстальніцкіх парогаў для дэблакіравання большай колькасці краёў.
    deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05
    
  • Падобна вышэйзгаданаму, але адфільтраваць толькі першую плоскасць.
    deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=1
    
  • Падобна вышэйзгаданаму, але адфільтраваць толькі другі і трэці план.
    deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=6
    

11.52.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.53 decimate

Адкідвайце дубляваныя кадры праз рэгулярныя прамежкі часу.

Фільтр прымае наступныя параметры:

cycle

Усталюйце колькасць кадраў, з якіх адзін будзе выдалены. Усталяванне гэтага Nзначэння азначае, што адзін кадр з кожнай партыі Nкадраў будзе выдалены. Па змаўчанні 5.

dupthresh

Усталюйце парог для выяўлення дублікатаў. Калі метрыка розніцы для кадра меншая або роўная гэтаму значэнню, яна аб'яўляецца дублікатам. Па змаўчанні1.1

scthresh

Усталюйце парог змены сцэны. Па змаўчанні 15.

blockx
blocky

Усталюйце памер блокаў па восі X і Y, якія выкарыстоўваюцца падчас метрычных разлікаў. Вялікія блокі забяспечваюць лепшае падаўленне шуму, але таксама горш выяўляюць невялікія рухі. Павінна быць ступень двойкі. Па змаўчанні 32.

ppsrc

Пазначыць асноўны ўвод як папярэдне апрацаваны ўвод і актываваць чысты ўваходны паток крыніцы. Гэта дазваляе папярэдне апрацаваць увод з дапамогай розных фільтраў, каб дапамагчы ў разліку паказчыкаў, захоўваючы выбар кадра без страт. Калі ўстаноўлена 1, першы паток прызначаны для папярэдне апрацаванага ўваходу, а другі паток з'яўляецца чыстай крыніцай, з якой выбіраюцца захаваныя кадры. Па змаўчанні 0.

chroma

Устанавіце, ці ўлічваецца каляровасць у метрычных разліках. Па змаўчанні 1.

11.54 deconvolve

Прымяніць двухмерную дэканвалюцыю відэаструменю ў частотнай вобласці з выкарыстаннем другога патоку ў якасці імпульсу.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці апрацоўваць.

impulse

Усталяваць, якія імпульсныя відэакадры будуць апрацоўвацца, можна first або all. Па змаўчанні all.

noise

Усталюйце шум пры выкананні дзяленняў. Па змаўчанні 0.0000001. Карысна, калі шырыня і вышыня не аднолькавыя і не ў ступені 2, або калі паток да згортвання меў шум.

Фільтр deconvolveтаксама падтрымлівае параметры framesync .

11.55 dedot

Паменшыце перакрыжаваную яркасць (поўзанне кропак) і перакрыжаваныя колеры (вясёлкі) з відэа.

Ён прымае наступныя варыянты:

m

Задаць рэжым працы. Можа быць камбінацыяй dotcrawlдля памяншэння перакрыжаванай яркасці і/або rainbowsпамяншэння перакрыжаванай каляровасці.

lt

Усталюйце прасторавы парог яркасці. Больш нізкія значэнні павялічваюць памяншэнне перакрыжаванай яркасці.

tl

Усталюйце допуск для скроневай яркасці. Больш высокія значэнні павялічваюць памяншэнне перакрыжаванай яркасці.

tc

Усталюйце допуск для часовай змены каляровасці. Больш высокія значэнні павялічваюць памяншэнне перакрыжаванага колеру.

ct

Усталюйце часовы парог каляровасці. Больш нізкія значэнні павялічваюць памяншэнне перакрыжаванага колеру.

11.56 deflate

Прымяненне эфекту здуцця да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) сярэднім, прымаючы пад увагу толькі значэнні, ніжэйшыя за піксель.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

11.56.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.57 deflicker

Выдаліць змены яркасці часовай рамкі.

Ён прымае наступныя варыянты:

size, s

Задаць памер фільтра слізгальнага сярэдняга ў кадрах. Па змаўчанні 5. Дазволены дыяпазон 2 - 129.

mode, m

Усталюйце рэжым асераднення для згладжвання часавых змяненняў яркасці.

Даступныя значэнні:

'am'

Сярэдняе арыфметычнае

'gm'

Сярэдняе геаметрычнае

'hm'

Гарманічнае сярэдні

'qm'

Сярэдняе квадратычнае

'cm'

Кубічнае сярэдняе

'pm'

Улада значыць

'median'

Медыяна

bypass

Фактычна не змяняйце кадр. Карысна, калі патрэбныя толькі метададзеныя.

11.58 dejudder

Выдаліць дрыгаценне, выкліканае часткова празрадковым тэлекіназмесцівам.

Дрыгаценне можа быць уведзена, напрыклад, з дапамогай падцягвальнага фільтра. Калі зыходная крыніца была часткова тэлекіназмесцівам, то вывад pullup,dejudder будзе мець зменную частату кадраў. Можа змяняць частату кадраў кантэйнера. Акрамя гэтай змены, гэты фільтр не паўплывае на відэа з пастаяннай частатой кадраў.

Параметр, даступны ў гэтым фільтры:

cycle

Укажыце даўжыню акна, у якім паўтараецца дрыгаценне.

Прымае любое цэлае лік, большае за 1. Карысныя значэнні:

'4'

Калі арыгінал быў тэлекіно з 24 да 30 кадраў у секунду (фільм у NTSC).

'5'

Калі арыгінал быў тэлекіно з 25 да 30 кадраў у секунду (PAL да NTSC).

'20'

Калі сумесь двух.

Па змаўчанні "4'.

11.59 delogo

Здушыць лагатып тэлевізійнай станцыі простай інтэрпаляцыяй навакольных пікселяў. Проста ўсталюйце прастакутнік, які закрывае лагатып, і назірайце, як ён знікае (і часам з'яўляецца нешта яшчэ больш пачварнае - ваш прабег можа адрознівацца).

Ён прымае наступныя параметры:

x
y

Укажыце каардынаты верхняга левага вугла лагатыпа. Іх трэба ўдакладніць.

w
h

Укажыце шырыню і вышыню лагатыпа, які трэба ачысціць. Іх трэба ўдакладніць.

show

Пры значэнні 1 на экране малюецца зялёны прамавугольнік, каб спрасціць пошук патрэбных параметраў x, y, wі h. Значэнне па змаўчанні - 0.

Прастакутнік намаляваны на крайніх пікселях, якія будуць (часткова) заменены інтэрпаляванымі значэннямі. Значэнні наступных пікселяў непасрэдна за межамі гэтага прамавугольніка ў кожным кірунку будуць выкарыстоўвацца для вылічэння інтэрпаляваных значэнняў пікселяў унутры прамавугольніка.

11.59.1 Examples

  • Усталюйце прамавугольнік, які ахоплівае вобласць з каардынатамі верхняга левага кута 0,0 і памерам 100x77:
    delogo=x=0:y=0:w=100:h=77
    

11.60 derain

Выдаліце ​​​​дождж з уваходнага відарыса/відэа, прымяніўшы метады зняцця кадраў на аснове згортачных нейронавых сетак. Падтрымліваюцца мадэлі:

Навучанне, а таксама сцэнарыі стварэння мадэляў прадстаўлены ў сховішчы па адрасе https://github.com/XueweiMeng/derain_filter.git .

Файлы ўласнай мадэлі (.model) могуць быць створаны з файлаў мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py

Фільтр прымае наступныя параметры:

filter_type

Укажыце, які фільтр выкарыстоўваць. Гэты параметр прымае наступныя значэнні:

'derain'

Асушальны фільтр. Каб правесці дрэнажны фільтр, вам трэба выкарыстоўваць дрэнажную мадэль.

'dehaze'

Ачышчальны фільтр. Каб правесці дэтальны фільтр, неабходна выкарыстоўваць дэтальную мадэль.

Значэнне па змаўчанні 'derain'.

dnn_backend

Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:

'native'

Уласная рэалізацыя загрузкі і выканання DNN.

'tensorflow'

Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з --enable-libtensorflow

Значэнне па змаўчанні 'native'.

model

Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. TensorFlow і ўласны бэкэнд могуць загружаць файлы толькі для свайго фармату.

Каб атрымаць поўную функцыянальнасць (напрыклад, асінхроннае выкананне), выкарыстоўвайце фільтр dnn_processing .

11.61 deshake

Паспрабуйце выправіць невялікія змены гарызантальнага і/або вертыкальнага зруху. Гэты фільтр дапамагае ліквідаваць дрыгаценне камеры ад трымання камеры ў руках, сутыкнення са штатывам, перамяшчэння на аўтамабілі і г.д.

Фільтр прымае наступныя параметры:

x
y
w
h

Укажыце прастакутную вобласць, дзе трэба абмежаваць пошук вектараў руху. Пры жаданні пошук вектараў руху можа быць абмежаваны прамавугольнай вобласцю кадра, вызначанай левым верхнім вуглом, шырынёй і вышынёй. Гэтыя параметры маюць тое ж значэнне, што і фільтр Drawbox, які можна выкарыстоўваць для візуалізацыі становішча абмежавальнай рамкі.

Гэта карысна, калі пошук вектара руху можа пераблытаць адначасовы рух аб'ектаў у кадры з рухам камеры.

Калі для любога або для ўсіх з x, y, wі hўстаноўлена -1, выкарыстоўваецца поўны кадр. Гэта дазваляе ўсталёўваць пазнейшыя параметры без указання абмежавальнай рамкі для пошуку вектара руху.

Па змаўчанні - пошук па ўсім кадры.

rx
ry

Укажыце максімальную ступень перамяшчэння ў напрамках x і y у дыяпазоне 0-64 пікселяў. Па змаўчанні 16.

edge

Укажыце, як ствараць пікселі для запаўнення прабелаў па краях кадра. Даступныя значэнні:

'blank, 0'

Запоўніце пустыя месцы нулямі

'original, 1'

Арыгінальная выява ў пустых месцах

'clamp, 2'

Значэнне экструдаванага краю ў пустых месцах

'mirror, 3'

Люстраны край у пустых месцах

Значэнне па змаўчанні 'mirror'.

blocksize

Укажыце памер блока для пошуку па руху. Дыяпазон 4-128 пікселяў, па змаўчанні 8.

contrast

Укажыце парог кантраснасці для блокаў. Будуць разглядацца толькі блокі з кантраснасцю, якая перавышае зададзены (розніца паміж самымі цёмнымі і самымі светлымі пікселямі). Дыяпазон 1-255, па змаўчанні 125.

search

Укажыце стратэгію пошуку. Даступныя значэнні:

'exhaustive, 0'

Усталюйце вычарпальны пошук

'less, 1'

Усталюйце менш поўны пошук.

Значэнне па змаўчанні 'exhaustive'.

filename

Калі ўстаноўлена, то падрабязны журнал пошуку руху запісваецца ў паказаны файл.

11.62 despill

Выдаліце ​​непажаданае забруджванне колераў пярэдняга плана, выкліканае адлюстраваннем колеру зялёнага або сіняга экрана.

Гэты фільтр прымае наступныя параметры:

type

Усталюйце тып сцёку для выкарыстання.

mix

Усталюйце, як будзе стварацца карта разліву.

expand

Усталюйце, колькі трэба пазбавіцца ад рэшткаў разліву.

red

Кантралюе колькасць чырвонага ў вобласці разліву.

green

Кантралюе колькасць зеляніны ў зоне разліву. Павінен быць -1 для зялёнага экрана.

blue

Кантралюе колькасць сіняга ў вобласці разліву. Павінен быць -1 для сіняга экрана.

brightness

Кантралюе яркасць вобласці разліву, захоўваючы колеры.

alpha

Змяніць альфа-версію са згенераванай карты разліву.

11.62.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.63 detelecine

Прымяніце аперацыю, адваротную тэлекіно. Для гэтага патрабуецца загадзя вызначаны шаблон, вызначаны з дапамогай параметра шаблона, які павінен быць такім жа, як той, які перадаецца ў фільтр тэлекіно.

Гэты фільтр прымае наступныя параметры:

first_field
'top, t'

спачатку верхняе поле

'bottom, b'

ніжняе поле спачатку Значэнне па змаўчанні - top.

pattern

Лічбавы радок, які прадстаўляе шаблон выпадальнага меню, які вы хочаце прымяніць. Значэнне па змаўчанні - 23.

start_frame

Лік, які ўяўляе становішча першага кадра адносна тэлекіно. Гэта трэба выкарыстоўваць, калі ручай перарэзаны. Значэнне па змаўчанні - 0.

11.64 dilation

Прымяніць эфект пашырэння да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) максімумам.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

coordinates

Сцяг, які вызначае піксель, на які трэба спасылацца. Па змаўчанні 255, гэта значыць выкарыстоўваюцца ўсе восем пікселяў.

Сцягі на мясцовых картах з каардынатамі 3x3, як гэта:

1 2 3 4 5 6 7 8

11.64.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.65 displace

Зрушыць пікселі, як паказвае другі і трэці ўваходны паток.

Ён прымае тры ўваходныя патокі і выводзіць адзін паток, першы ўваход з'яўляецца крыніцай, а другі і трэці ўваход з'яўляюцца картамі зрушэння.

Другі ўваход вызначае, наколькі зрушыць пікселі ўздоўж восі х, у той час як трэці ўвод вызначае, наколькі зрушыць пікселі ўздоўж восі у. Калі адзін з патокаў карты зрушэння завяршаецца, будзе выкарыстоўвацца апошні кадр з гэтай карты зрушэння.

Звярніце ўвагу, што пасля стварэння карты зрушэнняў можна выкарыстоўваць зноў і зноў.

Далей апісваюцца прынятыя варыянты.

edge

Усталюйце паводзіны зрушэння для пікселяў, якія знаходзяцца па-за дыяпазонам.

Даступныя значэнні:

'blank'

Адсутныя пікселі замяняюцца чорнымі пікселямі.

'smear'

Суседнія пікселі будуць разыходзіцца, каб замяніць адсутныя пікселі.

'wrap'

Пікселі па-за дыяпазонам абгортваюцца, каб яны паказвалі на пікселі з іншага боку.

'mirror'

Пікселі па-за дыяпазонам будуць заменены на люстраныя пікселі.

Па змаўчанні 'smear'.

11.65.1 Examples

  • Дадайце эфект рабізны да ўваходу rgb памеру відэа hd720:
    ffmpeg -i INPUT -f lavfi -i nullsrc=s=hd720,lutrgb=128:128:128 -f lavfi -i nullsrc=s=hd720,geq='r=128+30*sin(2*PI*X/400+T):g=128+30*sin(2*PI*X/400+T):b=128+30*sin(2*PI*X/400+T)' -lavfi '[0][1][2]displace' OUTPUT
    
  • Дадайце эфект хвалі да ўводу rgb відэа памеру hd720:
    ffmpeg -i INPUT -f lavfi -i nullsrc=hd720,geq='r=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T)):g=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T)):b=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T))' -lavfi '[1]split[x][y],[0][x][y]displace' OUTPUT
    

11.66 dnn_classify

Выканайце класіфікацыю з дапамогай глыбокіх нейронных сетак на аснове абмежавальных рамак.

Фільтр прымае наступныя параметры:

dnn_backend

Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Цяпер гэтая опцыя прымае толькі openvino, будуць дададзены бэкэнды tensorflow.

model

Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў.

input

Усталюйце імя ўваходу сеткі dnn.

output

Усталюйце імя вываду сеткі dnn.

confidence

Усталюйце парог даверу (па змаўчанні: 0,5).

labels

Усталюйце шлях да файла цэтліка з указаннем супастаўлення паміж ідэнтыфікатарам цэтліка і імем. Імя кожнай этыкеткі пішацца ў адзін радок, прабелы і пустыя радкі прапускаюцца. Першы радок - гэта назва этыкеткі з ідэнтыфікатарам 0, а другі радок - назва этыкеткі з ідэнтыфікатарам 1 і г. д. Ідэнтыфікатар этыкеткі лічыцца імем, калі файл этыкеткі не пазначаны.

backend_configs

Усталюйце канфігурацыі для перадачы ў бэкэнд

Для бэкэнда tensorflow вы можаце ўсталяваць яго канфігурацыі з дапамогайsess_configпараметры, калі ласка, выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі для вашай сістэмы.

11.67 dnn_detect

Рабіце выяўленне аб'ектаў з дапамогай глыбокіх нейронных сетак.

Фільтр прымае наступныя параметры:

dnn_backend

Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Цяпер гэтая опцыя прымае толькі openvino, будуць дададзены бэкэнды tensorflow.

model

Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў.

input

Усталюйце імя ўваходу сеткі dnn.

output

Усталюйце імя вываду сеткі dnn.

confidence

Усталюйце парог даверу (па змаўчанні: 0,5).

labels

Усталюйце шлях да файла цэтліка з указаннем супастаўлення паміж ідэнтыфікатарам цэтліка і імем. Імя кожнай этыкеткі пішацца ў адзін радок, прабелы і пустыя радкі прапускаюцца. Першы радок - гэта назва этыкеткі з ідэнтыфікатарам 0 (звычайна гэта "фон"), а другі радок - назва этыкеткі з ідэнтыфікатарам 1 і г. д. Ідэнтыфікатар этыкеткі лічыцца імем, калі файл этыкеткі не пазначаны.

backend_configs

Усталюйце канфігурацыі для перадачы ў бэкэнд. Каб выкарыстоўваць асінхроннае выкананне, усталюйце async (па змаўчанні: усталявана). Адкат да выканання сінхранізацыі, калі бэкэнд не падтрымлівае асінхранізацыю.

11.68 dnn_processing

Апрацоўвайце выявы з дапамогай глыбокіх нейронных сетак. Ён працуе разам з іншым фільтрам, які пераўтворыць піксельны фармат Frame у тое, што патрабуецца сетцы dnn.

Фільтр прымае наступныя параметры:

dnn_backend

Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:

'native'

Уласная рэалізацыя загрузкі і выканання DNN.

'tensorflow'

Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з --enable-libtensorflow

'openvino'

Бэкэнд OpenVINO. Каб уключыць гэты бэкэнд, вам трэба стварыць і ўсталяваць бібліятэку OpenVINO для C (гл. https://github.com/openvinotoolkit/openvino/blob/master/build-instruction.md ) і наладзіць FFmpeg з --enable-libopenvino(–extra-cflags=- I... –extra-ldflags=-L... можа спатрэбіцца, калі файлы загалоўкаў і бібліятэкі не ўсталяваны ў сістэмны шлях)

Значэнне па змаўчанні 'native'.

model

Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. TensorFlow, OpenVINO і ўласны бэкэнд могуць загружаць файлы толькі для свайго фармату.

Файл уласнай мадэлі (.model) можа быць створаны з файла мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py

input

Усталюйце імя ўваходу сеткі dnn.

output

Усталюйце імя вываду сеткі dnn.

backend_configs

Усталюйце канфігурацыі для перадачы ў бэкэнд. Каб выкарыстоўваць асінхроннае выкананне, усталюйце async (па змаўчанні: усталявана). Адкат да выканання сінхранізацыі, калі бэкэнд не падтрымлівае асінхранізацыю.

Для бэкэнда tensorflow вы можаце ўсталяваць яго канфігурацыі з дапамогайsess_configпараметры, калі ласка, выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі бэкэнда TensorFlow для вашай сістэмы.

11.68.1 Examples

  • Выдаліць дождж у фрэйме rgb24 з дапамогай can.pb (гл . фільтр выдалення дрэнажу ):
    ./ffmpeg -i rain.jpg -vf format=rgb24,dnn_processing=dnn_backend=tensorflow:model=can.pb:input=x:output=y derain.jpg
    
  • Паменшыце ўдвая піксельнае значэнне кадра з фарматам gray32f:
    ffmpeg -i input.jpg -vf format=grayf32,dnn_processing=model=halve_gray_float.model:input=dnn_in:output=dnn_out:dnn_backend=native -y out.native.png
    
  • Апрацоўвайце канал Y з дапамогай srcnn.pb (гл. фільтр sr ) для кадра з yuv420p (падтрымліваюцца планарныя фарматы YUV):
    ./ffmpeg -i 480p.jpg -vf format=yuv420p,scale=w=iw*2:h=ih*2,dnn_processing=dnn_backend=tensorflow:model=srcnn.pb:input=x:output=y -y srcnn.jpg
    
  • Апрацоўвайце канал Y з дапамогай espcn.pb (гл. фільтр sr ), які змяняе памер кадра, для фармату yuv420p (падтрымліваюцца планарныя фарматы YUV), выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі бэкэнда TensorFlow для вашай сістэмы.
    ./ffmpeg -i 480p.jpg -vf format=yuv420p,dnn_processing=dnn_backend=tensorflow:model=espcn.pb:input=x:output=y:backend_configs=sess_config=0x10022805320e09cdccccccccccec3f20012a01303801 -y tmp.espcn.jpg
    

11.69 drawbox

Намалюйце каляровае поле на ўваходным малюнку.

Ён прымае наступныя параметры:

x
y

Выразы, якія задаюць каардынаты верхняга левага вугла скрынкі. Па змаўчанні гэта 0.

width, w
height, h

Выразы, якія вызначаюць шырыню і вышыню скрынкі; калі 0, яны інтэрпрэтуюцца як шырыня і вышыня ўводу. Па змаўчанні гэта 0.

color, c

Укажыце колер поля для запісу. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выкарыстоўваецца спецыяльнае значэнне invert, колер краю поля будзе такім жа, як у відэа з перавернутай яркасцю.

thickness, t

Выраз, які задае таўшчыню краю поля. Значэнне fillстворыць запоўненае поле. Значэнне па змаўчанні - 3.

Спіс прымальных канстант глядзіце ніжэй.

replace

Дастасавальна, калі ўвод мае альфа. Пры значэнні 1пікселі афарбаванага поля перазапішуць колер і альфа-пікселі відэа. Па змаўчанні гэта 0, якое аб'ядноўвае поле на ўваход, пакідаючы альфа-версію відэа некранутай.

Параметры для x, y, wі hз'яўляюцца tвыразамі, якія змяшчаюць наступныя канстанты:

dar

Суадносіны бакоў уваходнага дысплея такія ж, як ( w/ h) * sar.

hsub
vsub

гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

in_h, ih
in_w, iw

Шырыня і вышыня ўводу.

sar

Суадносіны бакоў уводнага ўзору.

x
y

Каардынаты зрушэння x і y у месцы, дзе намалявана рамка.

w
h

Шырыня і вышыня намаляванай скрынкі.

box_source

Крыніца скрыні можа быць зададзена як side_data_detection_bboxes, калі вы хочаце выкарыстоўваць даныя скрыні ў скрынках выяўлення пабочных дадзеных.

Калі box_sourceўстаноўлена, x, y, widthі heightбудуць ігнаравацца і па-ранейшаму будуць выкарыстоўвацца даныя скрыні ў скрынках выяўлення пабочных даных. Таму, калі ласка, не выкарыстоўвайце гэты параметр, калі вы не ўпэўнены ў крыніцы скрыні.

t

Таўшчыня намаляванай скрынкі.

Гэтыя канстанты дазваляюць выразам x, y, w, hі tспасылацца адзін на аднаго, так што вы можаце, напрыклад, пазначыць y=x/darабо h=w/dar.

11.69.1 Examples

  • Намалюйце чорную рамку вакол краю ўваходнага малюнка:
    drawbox
    
  • Намалюйце поле чырвоным колерам і непразрыстасцю 50%:
    drawbox=10:20:200:60:red@0.5
    

    Папярэдні прыклад можна задаць так:

    drawbox=x=10:y=20:w=200:h=60:color=red@0.5
    
  • Запоўніце поле ружовым колерам:
    drawbox=x=10:y=10:w=100:h=100:color=pink@0.5:t=fill
    
  • Намалюйце 2-піксельную чырвоную маску 2,40:1:
    drawbox=x=-t:y=0.5*(ih-iw/2.4)-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red
    

11.69.2 Commands

Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.70 drawgraph

Намалюйце графік, выкарыстоўваючы ўваходныя метаданыя відэа.

Ён прымае наступныя параметры:

m1

Усталюйце ключ метаданых 1-га кадра, значэнні метададзеных якога будуць выкарыстоўвацца для малявання графіка.

fg1

Усталюйце 1-ы выраз колеру пярэдняга плана.

m2

Усталюйце ключ метададзеных 2-га кадра, значэнні метададзеных якіх будуць выкарыстоўвацца для малявання графіка.

fg2

Устанавіць 2-е выраз колеру пярэдняга плана.

m3

Усталюйце ключ метаданых 3-га кадра, значэнні метаданых якога будуць выкарыстоўвацца для малявання графіка.

fg3

Усталюйце выраз 3-га колеру пярэдняга плана.

m4

Усталюйце ключ метададзеных 4-га кадра, значэнні метададзеных якіх будуць выкарыстоўвацца для малявання графіка.

fg4

Усталюйце 4-ы колер пярэдняга плана.

min

Усталюйце мінімальнае значэнне значэння метададзеных.

max

Усталюйце максімальнае значэнне значэння метададзеных.

bg

Задаць колер фону графіка. Па змаўчанні белы.

mode

Усталяваць рэжым графіка.

Даступныя значэнні для рэжыму:

'bar'
'dot'
'line'

Па змаўчанні line.

slide

Усталяваць рэжым слайдаў.

Даступныя значэнні для слайда:

'frame'

Намалюйце новую рамку, калі будзе дасягнута правая мяжа.

'replace'

Замяніць старыя слупкі на новыя.

'scroll'

Пракрутка справа налева.

'rscroll'

Пракруціць злева направа.

'picture'

Намалюйце адну карцінку.

Па змаўчанні frame.

size

Задаць памер графічнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 900x256.

rate, r

Усталюйце выходную частату кадраў. Значэнне па змаўчанні - 25.

Выразы колеру пярэдняга плана могуць выкарыстоўваць наступныя зменныя:

MIN

Мінімальнае значэнне значэння метададзеных.

MAX

Максімальнае значэнне значэння метададзеных.

VAL

Бягучае значэнне ключа метаданых.

Колер вызначаецца як 0xAABBGGRR.

Прыклад выкарыстання метаданых з фільтра signalstats :

signalstats,drawgraph=lavfi.signalstats.YAVG:min=0:max=255

Прыклад выкарыстання метададзеных з фільтра ebur128 :

ebur128=metadata=1,adrawgraph=lavfi.r128.M:min=-120:max=5

11.71 drawgrid

Намалюйце сетку на ўваходным малюнку.

Ён прымае наступныя параметры:

x
y

Выразы, якія задаюць каардынаты некаторай кропкі перасячэння сеткі (прызначаныя для наладжвання зрушэння). Абодва па змаўчанні 0.

width, w
height, h

Выразы, якія вызначаюць шырыню і вышыню ячэйкі сеткі, калі 0, яны інтэрпрэтуюцца як шырыня і вышыня ўваходных дадзеных, адпаведна, мінус thickness, таму выява атрымлівае рамку. Па змаўчанні 0.

color, c

Пакажыце колер сеткі. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выкарыстоўваецца спецыяльнае значэнне invert, колер сеткі такі ж, як у відэа з перавернутай яркасцю.

thickness, t

Выраз, які задае таўшчыню лініі сеткі. Значэнне па змаўчанні - 1.

Спіс прымальных канстант глядзіце ніжэй.

replace

Дастасавальна, калі ўвод мае альфа. Пікселі 1афарбаванай сеткі перазапішуць каляровыя і альфа-пікселі відэа. Па змаўчанні гэта 0, якое аб'ядноўвае сетку ва ўваход, пакідаючы альфа-версію відэа некранутай.

Параметры для x, y, wі hз'яўляюцца tвыразамі, якія змяшчаюць наступныя канстанты:

dar

Суадносіны бакоў уваходнага дысплея такія ж, як ( w/ h) * sar.

hsub
vsub

гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

in_h, ih
in_w, iw

Шырыня і вышыня ячэйкі ўваходнай сеткі.

sar

Суадносіны бакоў уводнага ўзору.

x
y

Каардынаты x і y некаторай кропкі перасячэння сеткі (прызначаныя для канфігурацыі зрушэння).

w
h

Шырыня і вышыня намаляванай клеткі.

t

Таўшчыня намаляванай клеткі.

Гэтыя канстанты дазваляюць выразам x, y, w, hі tспасылацца адзін на аднаго, так што вы можаце, напрыклад, пазначыць y=x/darабо h=w/dar.

11.71.1 Examples

  • Намалюйце сетку з ячэйкай 100x100 пікселяў, таўшчынёй 2 пікселя, чырвоным колерам і непразрыстасцю 50%:
    drawgrid=width=100:height=100:thickness=2:color=red@0.5
    
  • Намалюйце белую сетку 3x3 з непразрыстасцю 50%:
    drawgrid=w=iw/3:h=ih/3:t=2:c=white@0.5
    

11.71.2 Commands

Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.72 drawtext

Намалюйце тэкставы радок або тэкст з вызначанага файла паверх відэа, выкарыстоўваючы бібліятэку libfreetype.

Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-libfreetype. Каб уключыць рэзервовы шрыфт па змаўчанні і fontопцыю, неабходна наладзіць FFmpeg з дапамогай --enable-libfontconfig. Каб уключыць гэтую text_shapingопцыю, неабходна наладзіць FFmpeg з дапамогай --enable-libfribidi.

11.72.1 Syntax

Ён прымае наступныя параметры:

box

Выкарыстоўваецца для малявання рамкі вакол тэксту з выкарыстаннем колеру фону. Значэнне павінна быць альбо 1 (уключыць), альбо 0 (выключыць). Значэнне па змаўчанні роўна box0.

boxborderw

Усталюйце шырыню рамкі, якую трэба правесці вакол поля, выкарыстоўваючы boxcolor. Значэнне па змаўчанні роўна boxborderw0.

boxcolor

Колер, які будзе выкарыстоўвацца для малявання поля вакол тэксту. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні boxcolor- "белы".

line_spacing

Усталюйце міжрадковы інтэрвал у пікселях мяжы, якая будзе намалявана вакол поля, выкарыстоўваючы box. Значэнне па змаўчанні роўна line_spacing0.

borderw

Усталюйце шырыню рамкі вакол тэксту з дапамогай bordercolor. Значэнне па змаўчанні роўна borderw0.

bordercolor

Усталюйце колер, які будзе выкарыстоўвацца для малявання рамкі вакол тэксту. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні bordercolor- "чорны".

expansion

Выберыце спосаб textразгортвання. Можа быць none, strftime(састарэла) або normal(па змаўчанні). Падрабязнасці глядзіце ў раздзеле пашырэння тэксту ніжэй.

basetime

Усталюйце час пачатку падліку. Значэнне ў мікрасекундах. Прымяняецца толькі ў састарэлым рэжыме пашырэння strftime. Для эмуляцыі ў звычайным рэжыме разгортвання выкарыстоўвайце ptsфункцыю, указваючы час пачатку (у секундах) у якасці другога аргумента.

fix_bounds

Калі ісціна, праверце і выпраўце тэкставыя каардынаты, каб пазбегнуць выразання.

fontcolor

Колер, які будзе выкарыстоўвацца для малявання шрыфтоў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні fontcolor- "чорны".

fontcolor_expr

Радок, які пашыраецца гэтак жа, як textдля атрымання дынамічнага fontcolorзначэння. Па змаўчанні гэты параметр мае пустое значэнне і не апрацоўваецца. Калі гэты параметр усталяваны, ён перавызначае fontcolorпараметр.

font

Сямейства шрыфтоў для малявання тэксту. Па змаўчанні Sans.

fontfile

Файл шрыфта, які будзе выкарыстоўвацца для малявання тэксту. Шлях павінен быць уключаны. Гэты параметр абавязковы, калі падтрымка fontconfig адключана.

alpha

Намалюйце тэкст, ужываючы альфа-змешванне. Значэнне можа быць лікам ад 0,0 да 1,0. Выраз таксама прымае тыя ж зменныя x, y. Значэнне па змаўчанні - 1. Калі ласка, гл fontcolor_expr.

fontsize

Памер шрыфта, які будзе выкарыстоўвацца для малявання тэксту. Значэнне па змаўчанні роўна fontsize16.

text_shaping

Калі ўстаноўлена значэнне 1, паспрабуйце сфармаваць тэкст (напрыклад, змяніць парадак тэксту справа налева і злучыць арабскія сімвалы), перш чым маляваць яго. У адваротным выпадку проста намалюйце тэкст дакладна так, як пададзена. Па змаўчанні 1 (калі падтрымліваецца).

ft_load_flags

Сцяжкі, якія будуць выкарыстоўвацца для загрузкі шрыфтоў.

Сцягі адлюстроўваюць адпаведныя сцягі, якія падтрымліваюцца libfreetype, і з'яўляюцца камбінацыяй наступных значэнняў:

default
no_scale
no_hinting
render
no_bitmap
vertical_layout
force_autohint
crop_bitmap
pedantic
ignore_global_advance_width
no_recurse
ignore_transform
monochrome
linear_design
no_autohint

Значэнне па змаўчанні - "default".

Для атрымання дадатковай інфармацыі звярніцеся да дакументацыі для сцягоў FT_LOAD_* libfreetype.

shadowcolor

Колер, які будзе выкарыстоўвацца для малявання цені за намаляваным тэкстам. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні shadowcolor- "чорны".

shadowx
shadowy

Зрухі X і Y для пазіцыі цені тэксту адносна пазіцыі тэксту. Яны могуць быць як станоўчымі, так і адмоўнымі значэннямі. Значэнне па змаўчанні для абодвух - "0".

start_number

Пачатковы нумар кадра для зменнай n/frame_num. Значэнне па змаўчанні - "0".

tabsize

Памер у колькасці прабелаў для візуалізацыі ўкладкі. Значэнне па змаўчанні - 4.

timecode

Усталюйце пачатковае прадстаўленне часовага кода ў фармаце "чч:хм:сс[:;.]фф". Яго можна выкарыстоўваць з тэкставым параметрам або без яго. timecode_rate опцыя павінна быць указана.

timecode_rate, rate, r

Усталюйце частату кадраў таймкода (толькі таймкод). Значэнне будзе акруглена да бліжэйшага цэлага ліку. Мінімальнае значэнне - "1". Часовы код з адключаным кадрам падтрымліваецца для частаты кадраў 30 і 60.

tc24hmax

Калі ўсталявана значэнне 1, вывад параметра тайм-кода будзе пераходзіць на 24 гадзіны. Па змаўчанні 0 (адключана).

text

Тэкставы радок, які трэба намаляваць. Тэкст павінен быць паслядоўнасцю знакаў у кадзіроўцы UTF-8. Гэты параметр абавязковы, калі з параметрам не вызначаны файл textfile.

textfile

Тэкставы файл, які змяшчае тэкст для малявання. Тэкст павінен быць паслядоўнасцю знакаў у кадзіроўцы UTF-8.

Гэты параметр з'яўляецца абавязковым, калі з параметрам не зададзены тэкставы радок text.

Калі ўказаны абодва textі textfile, выдаецца памылка.

text_source

Крыніца тэксту павінна быць зададзена як side_data_detection_bboxes, калі вы хочаце выкарыстоўваць тэкставыя даныя ў bboxes выяўлення пабочных даных.

Калі ўсталявана крыніца тэксту, textён textfileбудзе ігнаравацца і па-ранейшаму выкарыстоўваць тэкставыя даныя ў палях выяўлення пабочных даных. Таму, калі ласка, не выкарыстоўвайце гэты параметр, калі вы не ўпэўненыя ў крыніцы тэксту.

reload

Будзе textfileперазагружацца праз зададзены інтэрвал кадраў. Не забудзьцеся абнавіць textfileатамарна, інакш яно можа быць прачытана часткова або нават не атрымаецца. Дыяпазон ад 0 да INT_MAX. Па змаўчанні 0.

x
y

Выразы, якія вызначаюць зрухі, дзе тэкст будзе намаляваны ў відэакадры. Яны адносна верхняй/левай мяжы выходнага малюнка.

Значэнне па змаўчанні xі yроўна "0".

Глядзіце ніжэй спіс прынятых канстант і функцый.

Параметры для xі y- гэта выразы, якія змяшчаюць наступныя канстанты і функцыі:

dar

суадносіны бакоў уваходнага дысплея, яно такое ж, як ( w/ h) *sar

hsub
vsub

гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

line_h, lh

вышыня кожнага радка тэксту

main_h, h, H

вышыня ўваходу

main_w, w, W

шырыня ўваходу

max_glyph_a, ascent

максімальная адлегласць ад базавай лініі да самай высокай/верхняй каардынаты сеткі, якая выкарыстоўваецца для размяшчэння кропкі контуру гліфа, для ўсіх візуалізаваных гліфаў. Гэта станоўчае значэнне з-за арыентацыі сеткі воссю Y уверх.

max_glyph_d, descent

максімальная адлегласць ад базавай лініі да самай нізкай каардынаты сеткі, якая выкарыстоўваецца для размяшчэння кропкі контуру гліфа, для ўсіх адлюстраваных гліфаў. Гэта адмоўнае значэнне з-за арыентацыі сеткі з воссю Y уверх.

max_glyph_h

максімальная вышыня гліфа, гэта значыць максімальная вышыня для ўсіх гліфаў, якія змяшчаюцца ў адлюстраваным тэксце, яна эквівалентная ascent- descent.

max_glyph_w

максімальная шырыня гліфа, гэта значыць максімальная шырыня ўсіх гліфаў, якія змяшчаюцца ў адлюстраваным тэксце

n

нумар уваходнага кадра, пачынаючы з 0

rand(min, max)

вяртае выпадковы лік паміж minіmax

sar

Суадносіны бакоў уводнага ўзору.

t

пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая

text_h, th

вышыня адлюстраванага тэксту

text_w, tw

шырыня адлюстраванага тэксту

x
y

каардынаты зрушэння x і y, дзе намаляваны тэкст.

Гэтыя параметры дазваляюць выразам xі yспасылацца адзін на аднаго, так што вы можаце, напрыклад, паказаць y=x/dar.

pict_type

Аднасiмвольнае апiсанне бягучага тыпу фрэйма.

pkt_pos

Бягучая пазіцыя пакета ва ўваходным файле або патоку (у байтах, ад пачатку ўводу). Значэнне -1 азначае, што гэтая інфармацыя недаступная.

pkt_duration

Працягласць бягучага пакета ў секундах.

pkt_size

Бягучы памер пакета (у байтах).

11.72.2 Text expansion

Каліexpansionусталявана ў strftime, фільтр распазнае паслядоўнасці strftime() у прадстаўленым тэксце і пашырае іх адпаведна. Праверце дакументацыю па strftime(). Гэта функцыя састарэла.

Каліexpansionусталявана none, тэкст друкуецца даслоўна.

Каліexpansionусталявана normal(па змаўчанні), выкарыстоўваецца наступны механізм пашырэння.

Сімвал зваротнай касой рысы '\', за якім ідзе любы сімвал, заўсёды пашыраецца да другога сімвала.

Паслядоўнасці формы %{...}пашыраны. Тэкст у фігурных дужках - гэта імя функцыі, за якім, магчыма, ідуць аргументы, падзеленыя знакам ":". Калі аргументы ўтрымліваюць спецыяльныя сімвалы або падзельнікі (':' або '}'), іх трэба экранаваць.

Звярніце ўвагу, што яны, верагодна, таксама павінны быць экранаваныя як значэнне для textопцыя ў радку аргумента фільтра і ў якасці аргумента фільтра ў апісанні фільтраграфа, і, магчыма, таксама для абалонкі, якая стварае да чатырох узроўняў экраніравання; выкарыстанне тэкставага файла дазваляе пазбегнуць гэтых праблем.

Даступныя наступныя функцыі:

expr, e

Вынік ацэнкі выразу.

Ён павінен прымаць адзін аргумент, які вызначае выраз для вылічэння, які прымае тыя ж канстанты і функцыі, што xі yзначэнні і. Звярніце ўвагу, што не ўсе канстанты павінны выкарыстоўвацца, напрыклад, памер тэксту невядомы пры ацэнцы выразу, таму канстанты text_wі text_hбудуць мець нявызначанае значэнне.

expr_int_format, eif

Ацаніць значэнне выразу і вывесці яго як адфарматаванае цэлае.

Першы аргумент - гэта выраз, які трэба вылічыць, як і для exprфункцыі. Другі аргумент вызначае фармат вываду. Дазволеныя значэнні 'x','X','d'і'u'. Яны разглядаюцца сапраўды гэтак жа, як і ў printfфункцыі. Трэці параметр неабавязковы і задае колькасць пазіцый, якія займае вывад. Яго можна выкарыстоўваць, каб дадаць запаўненне нулямі злева.

gmtime

Час, у які працуе фільтр, выражаны ў UTC. Ён можа прымаць аргумент: радок фармату strftime(). Радок фармату пашыраны для падтрымкі зменнай %[1-6]N , якая друкуе долі секунды з дадаткова зададзенай колькасцю лічбаў.

localtime

Час, у які працуе фільтр, выражаны ў мясцовым гадзінным поясе. Ён можа прымаць аргумент: радок фармату strftime(). Радок фармату пашыраны для падтрымкі зменнай %[1-6]N , якая друкуе долі секунды з дадаткова зададзенай колькасцю лічбаў.

metadata

Метададзеныя фрэйма. Прымае адзін-два аргументы.

Першы аргумент з'яўляецца абавязковым і вызначае ключ метададзеных.

Другі аргумент неабавязковы і вызначае значэнне па змаўчанні, якое выкарыстоўваецца, калі ключ метададзеных не знойдзены або пусты.

Даступныя метададзеныя можна вызначыць шляхам праверкі запісаў, якія пачынаюцца з тэга, уключанага ў кожны раздзел кадра, надрукаваны пры запуску ffprobe -show_frames.

Таксама даступныя метаданыя радка, створаныя ў фільтрах, якія вядуць да фільтра малюнку.

n, frame_num

Нумар кадра, пачынаючы з 0.

pict_type

Аднасiмвольнае апiсанне бягучага тыпу выявы.

pts

Метка часу бягучага кадра. Гэта можа заняць да трох аргументаў.

Першы аргумент - гэта фармат пазнакі часу; па змаўчанні flt для секунд у якасці дзесятковага ліку з дакладнасцю да мікрасекунды; hmsазначае адфарматаваную [-]HH:MM:SS.mmmметку часу з дакладнасцю да мілісекунд. gmtimeазначае пазнаку часу кадра ў фармаце UTC; localtimeазначае пазнаку часу кадра ў фармаце мясцовага гадзіннага пояса.

Другі аргумент - гэта зрушэнне, дададзенае да пазнакі часу.

Калі фармат усталяваны ў hms, трэці аргумент 24HHможа быць пастаўлены для прадстаўлення гадзіннай часткі адфарматаванай меткі часу ў 24-гадзінным фармаце (00-23).

Калі фармат усталяваны ў localtimeабо gmtime, можа быць перададзены трэці аргумент: радок фармату strftime(). Па змаўчанні YYYY-MM-DD HH:MM:SSбудзе выкарыстоўвацца фармат.

11.72.3 Commands

Гэты фільтр падтрымлівае змяненне параметраў з дапамогай каманд:

reinit

Змяніць існуючыя параметры фільтра.

Сінтаксіс для аргумента такі ж, як і для выкліку фільтра, напрыклад

fontsize=56:fontcolor=green:text='Hello World'

Поўны выклік фільтра з дапамогай sendcmd будзе выглядаць так:

sendcmd=c='56.0 drawtext reinit fontsize=56\:fontcolor=green\:text=Hello\\ World'

Калі ўвесь аргумент не можа быць прааналізаваны або прыменены ў якасці сапраўдных значэнняў, то фільтр будзе працягваць працу з існуючымі параметрамі.

11.72.4 Examples

  • Намалюйце «Тэставы тэкст» шрыфтам FreeSerif, выкарыстоўваючы значэнні па змаўчанні для дадатковых параметраў.
    drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text'"
    
  • Намалюйце «Тэставы тэкст» шрыфтам FreeSerif памерам 24 у пазіцыі x=100 і y=50 (лічачы ад верхняга левага кута экрана), тэкст жоўты з чырвонай рамкай вакол. І тэкст, і поле маюць непразрыстасць 20%.
    drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text':\
              x=100: y=50: fontsize=24: fontcolor=yellow@0.2: box=1: boxcolor=red@0.2"
    

    Звярніце ўвагу, што двукоссі не патрэбныя, калі ў спісе параметраў не выкарыстоўваюцца прабелы.

  • Паказаць тэкст у цэнтры відэакадра:
    drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=(w-text_w)/2:y=(h-text_h)/2"
    
  • Паказаць тэкст у выпадковым месцы, пераключаючыся на новае месца кожныя 30 секунд:
    drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=if(eq(mod(t\,30)\,0)\,rand(0\,(w-text_w))\,x):y=if(eq(mod(t\,30)\,0)\,rand(0\,(h-text_h))\,y)"
    
  • Паказаць тэкставы радок, які слізгае справа налева ў апошнім радку відэакадра. ФайлLONG_LINEМяркуецца, што змяшчае адзін радок без новых радкоў.
    drawtext="fontsize=15:fontfile=FreeSerif.ttf:text=LONG_LINE:y=h-line_h:x=-50*t"
    
  • Паказаць змест файлаCREDITSад ніжняй часткі кадра і пракруціць ўверх.
    drawtext="fontsize=20:fontfile=FreeSerif.ttf:textfile=CREDITS:y=h-20*t"
    
  • Намалюйце адну зялёную літару "g" у цэнтры ўваходнага відэа. Базавая лінія гліфа размешчана на палове вышыні экрана.
    drawtext="fontsize=60:fontfile=FreeSerif.ttf:fontcolor=green:text=g:x=(w-max_glyph_w)/2:y=h/2-ascent"
    
  • Паказваць тэкст на працягу 1 секунды кожныя 3 секунды:
    drawtext="fontfile=FreeSerif.ttf:fontcolor=white:x=100:y=x/dar:enable=lt(mod(t\,3)\,1):text='blink'"
    
  • Выкарыстоўвайце fontconfig, каб усталяваць шрыфт. Звярніце ўвагу, што двукроп'е трэба экранаваць.
    drawtext='fontfile=Linux Libertine O-40\:style=Semibold:text=FFmpeg'
    
  • Намалюйце «Тэставы тэкст» памерам шрыфта ў залежнасці ад вышыні відэа.
    drawtext="text='Test Text': fontsize=h/30: x=(w-text_w)/2: y=(h-text_h*2)"
    
  • Надрукуйце дату кадавання ў рэальным часе (гл. strftime(3)):
    drawtext='fontfile=FreeSans.ttf:text=%{localtime\:%a %b %d %Y}'
    
  • Паказаць знікненне і знікненне тэксту (з'яўленне/знікненне):
    #!/bin/sh
    DS=1.0 # display start
    DE=10.0 # display end
    FID=1.5 # fade in duration
    FOD=5 # fade out duration
    ffplay -f lavfi "color,drawtext=text=TEST:fontsize=50:fontfile=FreeSerif.ttf:fontcolor_expr=ff0000%{eif\\\\: clip(255*(1*between(t\\, $DS + $FID\\, $DE - $FOD) + ((t - $DS)/$FID)*between(t\\, $DS\\, $DS + $FID) + (-(t - $DE)/$FOD)*between(t\\, $DE - $FOD\\, $DE) )\\, 0\\, 255) \\\\: x\\\\: 2 }"
    
  • Выраўнаваць некалькі асобных тэкстаў па гарызанталі. Звярніце ўвагу, штоmax_glyph_a іfontsizeзначэнне ўключаны ў стyзрушэнне.
    drawtext=fontfile=FreeSans.ttf:text=DOG:fontsize=24:x=10:y=20+24-max_glyph_a,
    drawtext=fontfile=FreeSans.ttf:text=cow:fontsize=24:x=80:y=20+24-max_glyph_a
    
  • Нанесці спецыяльныя lavf.image2dec.source_basenameметаданыя на кожны кадр, калі такія метаданыя існуюць. У адваротным выпадку нанясіце радок "NA". Звярніце ўвагу, што дэмультыфікатар image2 павінен мець опцыю-export_path_metadata 1каб спецыяльныя палі метададзеных былі даступныя для фільтраў.
    drawtext="fontsize=20:fontcolor=white:fontfile=FreeSans.ttf:text='%{metadata\:lavf.image2dec.source_basename\:NA}':x=10:y=10"
    

Для атрымання дадатковай інфармацыі пра libfreetype праверце: http://www.freetype.org/ .

Для атрымання дадатковай інфармацыі пра fontconfig праверце: http://freedesktop.org/software/fontconfig/fontconfig-user.html .

Для атрымання дадатковай інфармацыі аб libfribidi праверце: http://fribidi.org/ .

11.73 edgedetect

Выяўляць і маляваць краю. Фільтр выкарыстоўвае алгарытм Canny Edge Detection.

Фільтр прымае наступныя параметры:

low
high

Усталюйце нізкія і высокія парогавыя значэнні, якія выкарыстоўваюцца парогавым алгарытмам Canny.

Высокі парог выбірае "моцныя" краявыя пікселі, якія затым злучаюцца праз 8-сувязь са "слабымі" краявымі пікселямі, выбранымі нізкім парогам.

lowі highпарогавыя значэнні павінны быць выбраны ў дыяпазоне [0,1] і lowпавінны быць меншымі або роўнымі high.

Значэнне па змаўчанні для low, 20/255а значэнне па змаўчанні high для 50/255.

mode

Вызначце рэжым малявання.

'wires'

Намалюйце белы/шэры драты на чорным фоне.

'colormix'

Змяшайце колеры, каб стварыць эфект фарбы/мультфільма.

'canny'

Прымяніце дэтэктар краёў Canny на ўсіх выбраных плоскасцях.

Значэнне па змаўчанні - wires.

planes

Выберыце плоскасці для фільтрацыі. Па змаўчанні ўсе даступныя самалёты адфільтраваны.

11.73.1 Examples

  • Стандартнае вызначэнне краёў з карыстальніцкімі значэннямі для парогавага значэння гістэрэзісу:
    edgedetect=low=0.1:high=0.4
    
  • Эфект афарбоўкі без парогаў:
    edgedetect=mode=colormix:high=0
    

11.74 elbg

Прымяніць эфект постэрызацыі з дапамогай алгарытму ELBG (палепшаны LBG).

Для кожнага ўваходнага відарыса фільтр вылічыць аптымальнае адлюстраванне ўваходу і вываду з улікам даўжыні кодавай кнігі, гэта значыць колькасці розных выходных колераў.

Гэты фільтр прымае наступныя параметры.

codebook_length, l

Задаць даўжыню кодавай кнігі. Значэнне павінна быць цэлым дадатным лікам і ўяўляць колькасць розных выходных колераў. Значэнне па змаўчанні - 256.

nb_steps, n

Усталюйце максімальную колькасць ітэрацый для вылічэння аптымальнага адлюстравання. Чым вышэй значэнне, тым лепшы вынік і большы час вылічэння. Значэнне па змаўчанні - 1.

seed, s

Усталюйце выпадковае пачатковае значэнне, яно павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.

pal8

Задаць фармат выхаднога пікселя pal8. Гэты параметр не працуе з даўжынёй кнігі кодаў больш за 256. Па змаўчанні выключана.

use_alpha

Уключыце альфа-значэнні ў разлік квантавання. Дазваляе ствараць палетзіраваныя выходныя выявы (напрыклад, PNG8) са шматразовым альфа-плаўным змешваннем.

11.75 entropy

Вымерайце энтрапію ўзроўню шэрага ў гістаграме каляровых каналаў відэакадраў.

Ён прымае наступныя параметры:

mode

Можа быць або normalабо diff. Па змаўчанні normal.

diffрэжым вымярае энтрапію дэльта-значэнняў гістаграмы, абсалютныя адрозненні паміж суседнімі значэннямі гістаграмы.

11.76 epx

Прымяніце фільтр павелічэння EPX, прызначаны для піксельнага мастацтва.

Ён прымае наступны варыянт:

n

Задаць памернасць маштабавання: 2для 2xEPX, 3для 3xEPX. Па змаўчанні 3.

11.77 eq

Усталюйце яркасць, кантраснасць, насычанасць і прыблізную рэгуляванне гамы.

Фільтр прымае наступныя параметры:

contrast

Усталюйце выраз кантрасту. Значэнне павінна быць значэннем з плаваючай часткай у дыяпазоне -1000.0да 1000.0. Значэнне па змаўчанні - "1".

brightness

Усталюйце выраз яркасці. Значэнне павінна быць значэннем з плаваючай часткай у дыяпазоне -1.0да 1.0. Значэнне па змаўчанні - "0".

saturation

Задайце выраз насычанасці. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.0да 3.0. Значэнне па змаўчанні - "1".

gamma

Усталюйце гама-выраз. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.1да 10.0. Значэнне па змаўчанні - "1".

gamma_r

Усталюйце гама-выраз для чырвонага. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.1да 10.0. Значэнне па змаўчанні - "1".

gamma_g

Усталюйце гама-выраз для зялёнага. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.1да 10.0. Значэнне па змаўчанні - "1".

gamma_b

Усталюйце гама-выраз для сіняга. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.1да 10.0. Значэнне па змаўчанні - "1".

gamma_weight

Усталюйце гама-вагавы выраз. Яго можна выкарыстоўваць, каб паменшыць уплыў высокага значэння гама на яркія ўчасткі выявы, напрыклад, прадухіліць іх празмернае ўзмацненне і проста белы колер. Значэнне павінна быць з плаваючай часткай у дыяпазоне 0.0да 1.0. Значэнне 0.0цалкам зніжае гама-карэкцыю, пакідаючы 1.0яе на поўную сілу. Па змаўчанні - "1".

eval

Устанавіце, калі вылічваюцца выразы яркасці, кантраснасці, насычанасці і гама.

Ён прымае наступныя значэнні:

'init'

вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды

'frame'

ацэньваць выразы для кожнага ўваходнага кадра

Значэнне па змаўчанні 'init'.

Выразы прымаюць наступныя параметры:

n

колькасць кадраў уваходнага кадра, пачынаючы з 0

pos

байтавая пазіцыя адпаведнага пакета ва ўваходным файле, NAN, калі не вызначана

r

частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая

t

пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая

11.77.1 Commands

Фільтр падтрымлівае наступныя каманды:

contrast

Усталюйце выраз кантрасту.

brightness

Усталюйце выраз яркасці.

saturation

Задайце выраз насычанасці.

gamma

Усталюйце гама-выраз.

gamma_r

Усталюйце выраз gamma_r.

gamma_g

Задаць выраз gamma_g.

gamma_b

Задаць выраз gamma_b.

gamma_weight

Задаць выраз gamma_weight.

Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.78 erosion

Прымяніць эфект эрозіі да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) мінімумам.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

coordinates

Сцяг, які вызначае піксель, на які трэба спасылацца. Па змаўчанні 255, гэта значыць выкарыстоўваюцца ўсе восем пікселяў.

Сцягі на мясцовых картах з каардынатамі 3x3, як гэта:

1 2 3 4 5 6 7 8

11.78.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.79 estdif

Дэінтэрлейсаванне ўваходнага відэа ("estdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу трасіроўкі краёў").

Толькі прасторавы фільтр, які выкарыстоўвае алгарытм адсочвання нахілу краю для інтэрпаляцыі адсутных ліній. Ён прымае наступныя параметры:

mode

Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:

frame

Вывесці па адным кадры для кожнага кадра.

field

Вывесці па адным кадры для кожнага поля.

Значэнне па змаўчанні - field.

parity

Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:

tff

Выкажам здагадку, што верхняе поле - першае.

bff

Выкажам здагадку, што ніжняе поле з'яўляецца першым.

auto

Уключыць аўтаматычнае вызначэнне парытэту поля.

Значэнне па змаўчанні - auto. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.

deint

Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:

all

Дэінтэрлейс усіх кадраў.

interlaced

Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.

Значэнне па змаўчанні - all.

rslope

Укажыце радыус пошуку для трасіроўкі кантавых схілаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 15.

redge

Укажыце радыус пошуку для лепшага супадзення краёў. Значэнне па змаўчанні - 2. Дазволены дыяпазон - ад 0 да 15.

ecost

Укажыце кошт краю для супадзення краю. Значэнне па змаўчанні 1,0. Дазволены дыяпазон ад 0 да 9.

mcost

Укажыце сярэдні кошт для супадзення краёў. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.

dcost

Укажыце кошт адлегласці для супадзення краёў. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.

interp

Укажыце выкарыстоўваную інтэрпаляцыю. Па змаўчанні ўстаноўлена 4-кропкавая інтэрпаляцыя. Ён прымае адно з наступных значэнняў:

2p

Двухкропкавая інтэрпаляцыя.

4p

Чатырохкропкавая інтэрпаляцыя.

6p

Шасцікропкавая інтэрпаляцыя.

11.79.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.80 exposure

Адрэгулюйце экспазіцыю відэаструменю.

Фільтр прымае наступныя параметры:

exposure

Усталюйце карэкцыю экспазіцыі ў EV. Дазволены дыяпазон ад -3,0 да 3,0 EV Значэнне па змаўчанні - 0 EV.

black

Усталюйце карэкцыю ўзроўню чорнага. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.

11.80.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.81 extractplanes

Вылучыце кампаненты каляровага канала з уваходнага відэапатоку ў асобныя відэапатокі адценняў шэрага.

Фільтр прымае наступныя параметры:

planes

Усталюйце плоскасць(-і) для здабывання.

Даступныя значэнні для самалётаў:

'y'
'u'
'v'
'a'
'r'
'g'
'b'

Выбар самалётаў, недаступных ва ўваходных дадзеных, прывядзе да памылкі. Гэта азначае, што вы не можаце адначасова выбраць r, g, bплоскасці з y, u, плоскасцямі.v

11.81.1 Examples

  • Вылучыце кампаненты каляровага канала яркасці, u і v з уваходнага відэакадра ў 3 выхады ў адценнях шэрага:
    ffmpeg -i video.avi -filter_complex 'extractplanes=y+u+v[y][u][v]' -map '[y]' y.avi -map '[u]' u.avi -map '[v]' v.avi
    

11.82 fade

Прымяніць эфект знікнення да ўваходнага відэа.

Ён прымае наступныя параметры:

type, t

Тып эфекту можа быць альбо "ўваходзіць" для знікнення, альбо "выхад" для знікнення. Па змаўчанні in.

start_frame, s

Укажыце нумар кадра, з якога трэба пачаць прымяненне эфекту знікнення. Па змаўчанні 0.

nb_frames, n

Колькасць кадраў, на працягу якіх доўжыцца эфект знікнення. У канцы эфекту знікнення выхадное відэа будзе мець такую ​​ж інтэнсіўнасць, што і ўваходнае відэа. У канцы пераходу з знікненнем выходнае відэа будзе запоўнена выбранымcolor. Па змаўчанні 25.

alpha

Калі ўстаноўлена значэнне 1, знікае толькі альфа-канал, калі ён ёсць на ўваходзе. Значэнне па змаўчанні 0.

start_time, st

Укажыце метку часу (у секундах) кадра, каб пачаць прымяняць эфект знікнення. Калі зададзены як start_frame, так і start_time, заміранне пачнецца з таго, што наступіць апошнім. Па змаўчанні 0.

duration, d

Колькасць секунд, на працягу якіх павінен працягвацца эфект знікнення. У канцы эфекту знікнення выхадное відэа будзе мець такую ​​ж інтэнсіўнасць, што і ўваходнае відэа, у канцы знікнення выхадное відэа будзе запоўнена выбранымcolor. Калі ўказаны і працягласць, і nb_frames, выкарыстоўваецца працягласць. Па змаўчанні 0 (па змаўчанні выкарыстоўваецца nb_frames).

color, c

Укажыце колер выцвітання. Па змаўчанні - "чорны".

11.82.1 Examples

  • Змяншэнне ў першых 30 кадрах відэа:
    fade=in:0:30
    

    Каманда вышэй эквівалентная:

    fade=t=in:s=0:n=30
    
  • Змяншэнне апошніх 45 кадраў 200-кадравага відэа:
    fade=out:155:45
    fade=type=out:start_frame=155:nb_frames=45
    
  • Памяншэнне першых 25 кадраў і знікненне апошніх 25 кадраў 1000-кадравага відэа:
    fade=in:0:25, fade=out:975:25
    
  • Зрабіце першыя 5 кадраў жоўтымі, затым знікніце з кадраў 5-24:
    fade=in:5:20:color=yellow
    
  • Змяншэнне ў альфа-версіі па першых 25 кадрах відэа:
    fade=in:0:25:alpha=1
    
  • Зрабіце першыя 5,5 секунды чорнымі, затым знікніце на 0,5 секунды:
    fade=t=in:st=5.5:d=0.5
    

11.83 feedback

Прымяніць відэафільтр зваротнай сувязі.

Гэты фільтр перадае абрэзаныя ўваходныя кадры на другі выхад. Адтуль яго можна фільтраваць іншымі відэафільтрамі. Пасля таго, як фільтр атрымае кадр з 2-га ўваходу, гэты кадр аб'ядноўваецца паверх зыходнага кадра з 1-га ўваходу і перадаецца на 1-ы выхад.

Тыповае выкарыстанне - фільтраваць толькі частку кадра.

Фільтр прымае наступныя параметры:

x
y

Усталюйце верхняе левае становішча кадравання.

w
h

Усталюйце памер кадравання.

11.83.1 Examples

  • Размыць толькі верхнюю левую прастакутную частку відэакадра памерам 100x100 з дапамогай фільтра gblur.
    [in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]gblur=8[blurin]
    
  • Намалюйце чорную скрынку ў верхняй левай частцы відэакадра памерам 100x100 з фільтрам Drawbox.
    [in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]drawbox=x=0:y=0:w=100:h=100:t=100[blurin]
    

11.84 fftdnoiz

Шумаць кадры з дапамогай 3D БПФ (фільтрацыя ў частотнай вобласці).

Фільтр прымае наступныя параметры:

sigma

Усталюйце сігма-канстанту шуму. Гэта задае сілу шумашумлення. Значэнне па змаўчанні - 1. Дазволены дыяпазон - ад 0 да 30. Выкарыстанне вельмі высокай сігмы з нізкім перакрыццем можа выклікаць артэфакты блакіроўкі.

amount

Усталюйце колькасць шумашумлення. Па змаўчанні ўсе выяўленыя шумы памяншаюцца. Значэнне па змаўчанні - 1. Дазволены дыяпазон - ад 0 да 1.

block

Усталюйце памер блока ў пікселях, па змаўчанні 32, можа быць ад 8 да 256.

overlap

Усталюйце перакрыцце блокаў. Па змаўчанні 0,5. Дапушчальны дыяпазон ад 0,2 да 0,8.

method

Усталюйце метад шумашумлення. Па змаўчанні wiener, таксама можа быць hard.

prev

Усталюйце колькасць папярэдніх кадраў для выкарыстання для выдалення шуму. Па змаўчанні ўстаноўлена 0.

next

Усталюйце колькасць наступных кадраў, якія будуць выкарыстоўвацца для выдалення шуму. Па змаўчанні ўстаноўлена 0.

planes

Усталюйце плоскасці, якія будуць адфільтраваныя, па змаўчанні ўсе даступныя адфільтраваныя, акрамя альфа.

11.85 fftfilt

Прымяненне адвольных выразаў да ўзораў у частотнай вобласці

dc_Y

Адрэгулюйце значэнне пастаяннага току (узмацненне) плоскасці яркасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне 0да 1000. Па змаўчанні ўстаноўлена значэнне 0.

dc_U

Адрэгулюйце значэнне пастаяннага току (узмацненне) 1-й плоскасці каляровасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне 0да 1000. Па змаўчанні ўстаноўлена значэнне 0.

dc_V

Адрэгулюйце значэнне пастаяннага току (узмацненне) 2-й плоскасці каляровасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне 0да 1000. Па змаўчанні ўстаноўлена значэнне 0.

weight_Y

Задайце вагавы выраз частотнай вобласці для плоскасці яркасці.

weight_U

Усталюйце вагавы выраз частотнай вобласці для 1-й каляровай плоскасці.

weight_V

Усталюйце вагавы выраз частотнай вобласці для 2-й каляровай плоскасці.

eval

Устанавіце, калі вылічваюцца выразы.

Ён прымае наступныя значэнні:

'init'

Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра.

'frame'

Ацаніце выразы для кожнага ўваходнага кадра.

Значэнне па змаўчанні 'init'.

Фільтр прымае наступныя зменныя:

X
Y

Каардынаты бягучай выбаркі.

W
H

Шырыня і вышыня выявы.

N

Нумар уваходнага кадра, пачынаючы з 0.

WS
HS

Памер масіва FFT для гарызантальнай і вертыкальнай апрацоўкі.

11.85.1 Examples

  • Высокія частоты:
    fftfilt=dc_Y=128:weight_Y='squish(1-(Y+X)/100)'
    
  • Нізкія частоты:
    fftfilt=dc_Y=0:weight_Y='squish((Y+X)/100-1)'
    
  • Рэзкасць:
    fftfilt=dc_Y=0:weight_Y='1+squish(1-(Y+X)/100)'
    
  • Размыццё:
    fftfilt=dc_Y=0:weight_Y='exp(-4 * ((Y+X)/(W+H)))'
    

11.86 field

Вылучыце адно поле з празрадковай выявы, выкарыстоўваючы крокавую арыфметыку, каб не марнаваць працэсарны час. Выхадныя кадры пазначаны як непразрадковыя.

Фільтр прымае наступныя параметры:

type

Укажыце, ці варта выняць верхняе (калі значэнне 0або top) або ніжняе поле (калі значэнне 1або bottom).

11.87 fieldhint

Стварыце новыя кадры, скапіраваўшы верхняе і ніжняе палі з навакольных кадраў, прадстаўленых у выглядзе лічбаў у файле падказкі.

hint

Усталяваць файл, які змяшчае падказкі: абсалютныя/адносныя нумары кадраў.

Для кожнага кадра ў кліпе павінен быць адзін радок. Кожны радок павінен змяшчаць дзве лічбы, падзеленыя коскай, за якімі варта -або +. Лічбы, прыведзеныя ў кожным радку файла, не могуць быць за межамі [N-1,N+1], дзе N - нумар бягучага кадра для absoluteрэжыму, або за межамі дыяпазону [-1, 1] для relativeрэжыму. Першая лічба паказвае, з якога кадра трэба выбраць верхняе поле, а другая лічба паказвае, з якога кадра выбраць ніжняе поле.

Калі неабавязкова ідзе +выхадны кадр, ён будзе пазначаны як празрадковы, у адваротным выпадку, калі за ім ідзе -выхадны кадр, будзе пазначаны як прагрэсіўны, у адваротным выпадку ён будзе пазначаны як уваходны кадр. Калі пасля гэтага неабавязкова ідзе tрамка вываду, будзе выкарыстоўвацца толькі верхняе поле, або ў выпадку bгэтага будзе выкарыстоўвацца толькі ніжняе поле. Калі радок пачынаецца з #або ;гэты радок прапускаецца.

mode

Можа быць item absoluteor relativeor pattern. Па змаўчанні absolute. Рэжым patternтакі ж, як і relativeрэжым, за выключэннем моманту апошняга ўводу файла, калі трэба апрацаваць больш кадраў, чым hintфайл шукае назад, каб пачаць.

Прыклад першых некалькіх радкоў hintфайла для relativeрэжыму:

0,0 - # first frame
1,0 - # second frame, use third's frame top field and second's frame bottom field
1,0 - # third frame, use fourth's frame top field and third's frame bottom field
1,0 -
0,0 -
0,0 -
1,0 -
1,0 -
1,0 -
0,0 -
0,0 -
1,0 -
1,0 -
1,0 -
0,0 -

11.88 fieldmatch

Фільтр супадзення палёў для зваротнага тэлекіно. Ён прызначаны для рэканструкцыі прагрэсіўных кадраў з тэлекінопатоку. Фільтр не выдаляе дубляваныя кадры, таму для дасягнення поўнага зваротнага тэлекіно fieldmatchпавінен суправаджацца фільтр прарэжвання, напрыклад прарэжванне ў фільтраграфе .

Раздзяленне супастаўлення палёў і дэцымацыі асабліва матывавана магчымасцю ўстаўкі паміж імі рэзервовага фільтра дэпляменнай разгорткі. Калі ў крыніцы ёсць змешаны тэлекіно і рэальны празрадковы кантэнт, fieldmatchне атрымаецца супаставіць палі для частак празрадковай разгорткі. Але гэтыя астатнія камбінаваныя кадры будуць пазначаны як празрадковыя, і, такім чынам, перад дэцымацыямі іх можна будзе пазбавіць ад празрадковай разгорткі наступным фільтрам, такім як yadif .

У дадатак да розных опцый канфігурацыі, fieldmatchможна прыняць дадатковы другі паток, актываваны празppsrcварыянт. Калі ўключана, рэканструкцыя кадраў будзе грунтавацца на палях і кадрах з гэтага другога патоку. Гэта дазваляе папярэдне апрацаваць першы ўвод, каб дапамагчы розным алгарытмам фільтра, захоўваючы пры гэтым выхад без страт (пры ўмове, што палі супадаюць правільна). Як правіла, можа дапамагчы дэшуйзер з улікам поля або рэгуляванне яркасці/кантрастнасці.

Звярніце ўвагу, што гэты фільтр выкарыстоўвае тыя ж алгарытмы, што і TIVTC/TFM (праект AviSynth) і VIVTC/VFM (праект VapourSynth). Апошні з'яўляецца лёгкім клонам TFM fieldmatch, на аснове якога. Нягледзячы на ​​тое, што семантыка і выкарыстанне вельмі блізкія, некаторыя паводзіны і назвы параметраў могуць адрознівацца.

У цяперашні час дэцымацыйны фільтр працуе толькі для пастаяннай частаты кадраў. Калі ваш увод змяшчае змешаны тэлекінаграфічны (30 кадраў у секунду) і прагрэсіўны кантэнт з меншай частатой кадраў, напрыклад 24 кадры ў секунду, выкарыстоўвайце наступны ланцужок фільтраў для стварэння неабходнага патоку cfr: dejudder,fps=30000/1001,fieldmatch,decimate.

Фільтр прымае наступныя параметры:

order

Укажыце меркаваны парадак палёў уваходнага патоку. Даступныя значэнні:

'auto'

Аўтаматычнае вызначэнне цотнасці (выкарыстоўвайце ўнутранае значэнне цотнасці FFmpeg).

'bff'

Выкажам здагадку, спачатку ніжняе поле.

'tff'

Выкажам здагадку, спачатку верхняе поле.

Звярніце ўвагу, што часам рэкамендуецца не давяраць парытэту, абвешчанаму патокам.

Значэнне па змаўчанні - auto.

mode

Усталюйце рэжым супадзення або стратэгію для выкарыстання.pcрэжым з'яўляецца самым бяспечным у тым сэнсе, што ён не рызыкуе стварыць рэзкасць з-за дублікатаў кадраў, калі гэта магчыма, але калі ёсць дрэнныя праўкі або змешаныя палі, ён у канчатковым выніку выводзіць кадры з грэбнем, калі сапраўды можа існаваць добрае супадзенне. З другога боку,pcn_ubрэжым з'яўляецца найбольш рызыкоўным з пункту гледжання стварэння рыўкоў, але амаль заўсёды можна знайсці добры кадр, калі ён ёсць. Астатнія каштоўнасці знаходзяцца дзесьці пасярэдзінеpcіpcn_ubз пункту гледжання рызыкі рыўкоў і стварэння дублікатаў кадраў у параўнанні з пошукам добрых супадзенняў у раздзелах з дрэннымі рэдагаваннямі, асірацелымі палямі, змешанымі палямі і г.д.

Больш падрабязную інфармацыю аб p/c/n/u/b можна знайсці ў раздзеле значэнняў p/c/n/u/b .

Даступныя значэнні:

'pc'

2-баковае адпаведнасць (p/c)

'pc_n'

2-баковае супадзенне і спроба 3-га супадзення, калі ўсё яшчэ расчэсаны (p/c + n)

'pc_u'

2-баковае супадзенне і спроба 3-га супадзення (той жа парадак), калі ўсё яшчэ расчэсваецца (p/c + u)

'pc_n_ub'

2-баковае супадзенне, спроба 3-га супадзення, калі ўсё яшчэ расчэсваецца, і спроба 4-га/5-га супадзення, калі ўсё яшчэ расчэсваецца (p/c + n + u/b)

'pcn'

3-баковае адпаведнасць (п/к/н)

'pcn_ub'

3-баковае супадзенне і спроба 4-га/5-га супадзенняў, калі ўсе 3 арыгінальныя супадзенні вызначаюцца як счэсаныя (p/c/n + u/b)

Дужкі ў канцы паказваюць супадзенні, якія будуць выкарыстоўвацца для гэтага рэжымуorder= tfffieldна autoабо top).

З пункту гледжання хуткасціpcрэжым, безумоўна, самы хуткі іpcn_ubз'яўляецца самым павольным.

Значэнне па змаўчанні - pc_n.

ppsrc

Адзначце асноўны ўваходны паток як папярэдне апрацаваны ўваход і ўключыце другасны ўваходны паток як чыстую крыніцу для выбару палёў. Для атрымання дадатковай інфармацыі глядзіце ўвядзенне ў фільтр. Гэта падобна наclip2функцыя ад VFM/TFM.

Значэнне па змаўчанні 0(адключана).

field

Усталюйце поле для супадзення. Рэкамендуецца ўсталяваць такое ж значэнне, што і orderкалі вы не сутыкнецеся з няўдачамі пры супадзенні з гэтай наладай. У пэўных абставінах змяненне поля, якое выкарыстоўваецца для супастаўлення, можа моцна паўплываць на прадукцыйнасць супастаўлення. Даступныя значэнні:

'auto'

Аўтаматычна (тое ж значэнне, што іorder).

'bottom'

Матч з ніжняга поля.

'top'

Матч з верхняга поля.

Значэнне па змаўчанні - auto.

mchroma

Устанавіце, ці будзе каляровасць уключана падчас параўнання матчаў. У большасці выпадкаў рэкамендуецца пакінуць гэта ўключаным. Варта ўсталяваць гэтае значэнне 0 толькі ў тым выпадку, калі ваш кліп мае дрэнныя праблемы каляровасці, такія як моцная вясёлка або іншыя артэфакты. Усталяванне гэтага 0значэння таксама можа быць выкарыстана для паскарэння працы за кошт пэўнай дакладнасці.

Значэнне па змаўчанні - 1.

y0
y1

Яны вызначаюць паласу выключэння, якая выключае лініі паміж іміy0і y1ад уключэння ў рашэнне аб адпаведнасці палёў. Паласа выключэння можа выкарыстоўвацца для ігнаравання субтытраў, лагатыпа або іншых рэчаў, якія могуць перашкаджаць супастаўленню.y0задае пачатковы радок сканавання і y1задае канчатковую лінію; усе лініі паміж іміy0і y1(у тым лікуy0іy1) будзе праігнараваны. Абстаноўка y0іy1да таго ж значэння адключыць функцыю. y0іy1па змаўчанні 0.

scthresh

Усталюйце парог выяўлення змены сцэны ў працэнтах ад максімальнай змены на плоскасці яркасці. Добрыя значэння знаходзяцца ў [8.0, 14.0]дыяпазоне. Выяўленне змены сцэны актуальна толькі ў выпадкуcombmatch= sc. Асартымент для scthreshёсць [0.0, 100.0].

Значэнне па змаўчанні - 12.0.

combmatch

Каліcombatchне з'яўляецца , пры прыняцці рашэння аб тым, які матч выкарыстоўваць у якасці фінальнага матча none, fieldmatchбудуць улічвацца ацэнкі балаў матчаў. Даступныя значэнні:

'none'

Няма канчатковага супастаўлення на аснове ацэнак.

'sc'

Камбінаваныя балы выкарыстоўваюцца толькі пры выяўленні змены сцэны.

'full'

Увесь час выкарыстоўвайце прычэсаныя балы.

Па змаўчанні sc.

combdbg

Прымусіць fieldmatchвылічыць апрацаваныя метрыкі для пэўных супадзенняў і раздрукаваць іх. Гэты параметр вядомы якmicoutу TFM/VFM лексіцы. Даступныя значэнні:

'none'

Без прымусовага разліку.

'pcn'

Сілавыя п/к/н разлікі.

'pcnub'

Прымусовыя разлікі p/c/n/u/b.

Значэнне па змаўчанні - none.

cthresh

Гэта парог абчэсвання вобласці, які выкарыстоўваецца для выяўлення абчэсаных кадраў. Гэта, па сутнасці, кантралюе, наколькі «моцным» або «бачным» павінна быць расчэсванне, каб яно было выяўлена. Большыя значэнні азначаюць, што расчэсванне павінна быць больш прыкметным, а меншыя значэнні азначаюць, што расчэсванне можа быць менш прыкметным або моцным і ўсё роўна быць выяўленым. Дапушчальныя налады ад -1(кожны піксель будзе вызначацца як расчасаны) да 255(ні адзін піксель не будзе вызначацца як расчасаны). У асноўным гэта значэнне розніцы ў пікселях. Добры дыяпазон - гэта [8, 12].

Значэнне па змаўчанні - 9.

chroma

Усталёўвае, ці ўлічваецца каляровасць у вырашэнні камбінаванага кадра. Адключайце гэта толькі ў тым выпадку, калі ў вашай крыніцы ёсць праблемы з каляровасцю (вясёлка і г.д.), якія выклікаюць праблемы з выяўленнем грэбнёвага кадра з уключанай каляровасцю. Уласна, выкарыстоўваючыchroma= 0звычайна больш надзейны, за выключэннем выпадку, калі ў крыніцы ёсць толькі расчэсванне каляровасці.

Значэнне па змаўчанні - 0.

blockx
blocky

Адпаведна ўсталюйце памеры па восі X і Y для акна, якое выкарыстоўваецца падчас выяўлення камбінаванай рамкі. Гэта звязана з памерам тэрыторыі, у якой combpelпікселі павінны быць выяўленыя як расчэсаныя, каб кадр быў аб'яўлены расчэсаным. Глядзіцеcombpelапісанне параметраў для атрымання дадатковай інфармацыі. Магчымыя значэнні - любы лік, які з'яўляецца ступенню 2, пачынаючы з 4 і заканчваючы 512.

Значэнне па змаўчанні - 16.

combpel

Колькасць абчасаных пікселяў у любым зblockyпа blockxблокі памеру на раме, каб рама была выяўлена як ачэсаная. Пакульcthreshкантралюе, наколькі "бачным" павінна быць расчэсванне, гэты параметр кантралюе, "колькі" расчэсваннем павінна быць у любой лакалізаванай вобласці (акно, вызначанаеblockxіblockyналады) на раме. Мінімальнае значэнне роўна, 0а максімальнае роўна blocky x blockx(у гэты момант кадры ніколі не будуць вызначацца як абчэсаныя). Гэты параметр вядомы якMIу TFM/VFM лексіцы.

Значэнне па змаўчанні - 80.

11.88.1 p/c/n/u/b meaning

11.88.1.1 p/c/n

Мы мяркуем, што наступны тэлекіно паток:

Top fields:     1 2 2 3 4
Bottom fields:  1 2 3 4 4

Лічбы адпавядаюць прагрэсіўнай рамцы, да якой адносяцца палі. Тут першыя дзве рамкі - прагрэсіўныя, 3-я і 4-я - начесанные і г.д.

Калі fieldmatchнастроена на запуск супастаўлення знізу (field= bottom) вось як трансфармуецца гэты ўваходны паток:

Input stream:
                T     1 2 2 3 4
                B     1 2 3 4 4   <-- matching reference

Matches:              c c n n c

Output stream:
                T     1 2 3 4 4
                B     1 2 3 4 4

У выніку супастаўлення палёў мы бачым, што некаторыя кадры дублююцца. Каб выканаць поўнае зваротнае тэлекіно, вам трэба спадзявацца на дэцымацыйны фільтр пасля гэтай аперацыі. Глядзіце, напрыклад, фільтр дэцымацыі .

Тая ж аперацыя цяпер супадае з верхніх палёў (field= top) выглядае так:

Input stream:
                T     1 2 2 3 4   <-- matching reference
                B     1 2 3 4 4

Matches:              c c p p c

Output stream:
                T     1 2 2 3 4
                B     1 2 2 3 4

У гэтых прыкладах мы бачым, што p, cі nазначае; у асноўным яны адносяцца да кадра і поля супрацьлеглага парытэту:

  • pсупадае з полем процілеглай цотнасці ў папярэднім кадры
  • cсупадае з полем процілеглай цотнасці ў бягучым кадры
  • nсупадае з полем процілеглай цотнасці ў наступным кадры

11.88.1.2 u/b

Супастаўленне і крыху асаблівае ў тым сэнсе, што яны супадаюць з супрацьлеглым сцягам цотнасці u. bУ наступных прыкладах мы мяркуем, што зараз супадаем з 2-м кадрам (зверху:2, знізу:2). У адпаведнасці з супадзеннем над і пад кожным супастаўленым полем ставіцца знак «х».

З ніжнім супадзеннем (field= bottom):

Match:           c         p           n          b          u

                 x       x               x        x          x
  Top          1 2 2     1 2 2       1 2 2      1 2 2      1 2 2
  Bottom       1 2 3     1 2 3       1 2 3      1 2 3      1 2 3
                 x         x           x        x              x

Output frames:
                 2          1          2          2          2
                 2          2          2          1          3

З лепшым супадзеннем (field= top):

Match:           c         p           n          b          u

                 x         x           x        x              x
  Top          1 2 2     1 2 2       1 2 2      1 2 2      1 2 2
  Bottom       1 2 3     1 2 3       1 2 3      1 2 3      1 2 3
                 x       x               x        x          x

Output frames:
                 2          2          2          1          2
                 2          1          3          2          2

11.88.2 Examples

Просты IVTC першага тэлекінапатоку верхняга поля:

fieldmatch=order=tff:combmatch=none, decimate

Пашыраны IVTC, з запасным варыянтам yadif для нерухомых кадраў:

fieldmatch=order=tff:combmatch=full, yadif=deint=interlaced, decimate

11.89 fieldorder

Пераўтварэнне парадку палёў уваходнага відэа.

Ён прымае наступныя параметры:

order

Парадак палёў вываду. Дапушчальныя значэнні tffдля верхняга поля спачатку або bff для ніжняга поля спачатку.

Значэнне па змаўчанні 'tff'.

Пераўтварэнне ажыццяўляецца шляхам зрушэння змесціва малюнка ўверх ці ўніз на адзін радок і запаўнення пакінутага радка адпаведным зместам малюнка. Гэты метад сумяшчальны з большасцю пераўтваральнікаў парадку палёў трансляцыі.

Калі ўваходнае відэа не пазначана як празрадковае, або яно ўжо пазначана як адпаведнае парадку палёў вываду, гэты фільтр не змяняе ўваходнае відэа.

Гэта вельмі карысна пры пераўтварэнні ў або з матэрыялу PAL DV, які знаходзіцца ў ніжнім полі першым.

Напрыклад:

ffmpeg -i in.vob -vf "fieldorder=bff" out.dv

11.90 fifo, afifo

Буферызаваць ўваходныя выявы і адпраўляць іх, калі яны запытваюцца.

Гэта ў асноўным карысна, калі аўтаматычна ўстаўляецца рамкай libavfilter.

Ён не прымае параметры.

11.91 fillborders

Запаўненне межаў уваходнага відэа без змены памераў відэаструменю. Часам відэа можа мець смецце па чатырох краях, і вы можаце не захацець абрэзаць уваходнае відэа, каб захаваць памер, кратны некатораму ліку.

Гэты фільтр прымае наступныя параметры:

left

Колькасць пікселяў для запаўнення ад левай мяжы.

right

Колькасць пікселяў для запаўнення ад правай мяжы.

top

Колькасць пікселяў для запаўнення ад верхняй мяжы.

bottom

Колькасць пікселяў для запаўнення ад ніжняй мяжы.

mode

Усталюйце рэжым запаўнення.

Ён прымае наступныя значэнні:

'smear'

запоўніць пікселі, выкарыстоўваючы крайнія пікселі

'mirror'

запаўненне пікселяў з выкарыстаннем люстранога адлюстравання (сіметрычная палова выбаркі)

'fixed'

запоўніць пікселі пастаянным значэннем

'reflect'

запоўніць пікселі з дапамогай адлюстравання (увесь узор сіметрычны)

'wrap'

запоўніць пікселі з дапамогай абцякання

'fade'

знікненне пікселяў да пастаяннага значэння

'margins'

запоўніць пікселі ўверсе і ўнізе пікселямі ўзважанага сярэдняга значэння каля межаў

Па змаўчанні smear.

color

Усталюйце колер для пікселяў у фіксаваным рэжыме або рэжыме знікнення. Па змаўчанні black.

11.91.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.92 find_rect

Знайдзіце прамавугольны прадмет

Ён прымае наступныя варыянты:

object

Шлях да файла відарыса аб'екта павінен быць шэрым8.

threshold

Парог выяўлення, па змаўчанні 0,5.

mipmaps

Колькасць mipmap, па змаўчанні 3.

xmin, ymin, xmax, ymax

Вызначае прамавугольнік, у якім шукаць.

discard

Адхіляць кадры, дзе аб'ект не выяўлены. Па змаўчанні адключана.

11.92.1 Examples

  • Накрыйце прамавугольны аб'ект прадастаўленай выявай дадзенага відэа, выкарыстоўваючы ffmpeg:
    ffmpeg -i file.ts -vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
    

11.93 floodfill

Зона затаплення са значэннямі аднолькавых піксельных кампанентаў іншымі значэннямі.

Ён прымае наступныя варыянты:

x

Усталюйце каардынату піксель х.

y

Задаць каардынату пікселя y.

s0

Задаць значэнне кампанента крыніцы №0.

s1

Задайце значэнне кампанента крыніцы №1.

s2

Задайце значэнне кампанента крыніцы №2.

s3

Задайце значэнне кампанента крыніцы №3.

d0

Задаць значэнне кампанента прызначэння №0.

d1

Задайце значэнне кампанента прызначэння №1.

d2

Задайце значэнне кампанента прызначэння №2.

d3

Задайце значэнне кампанента прызначэння №3.

11.94 format

Пераўтварыце ўваходнае відэа ў адзін з зададзеных піксельных фарматаў. Libavfilter паспрабуе выбраць той, які падыходзіць у якасці ўваходных дадзеных для наступнага фільтра.

Ён прымае наступныя параметры:

pix_fmts

Спіс назваў фарматаў пікселяў, падзелены '|', напрыклад "pix_fmts=yuv420p|monow|rgb24".

11.94.1 Examples

  • Пераўтварыце ўваходнае відэа ў yuv420pфармат
    format=pix_fmts=yuv420p
    

    Пераўтварыце ўваходнае відэа ў любы з фарматаў са спісу

    format=pix_fmts=yuv420p|yuv444p|yuv410p
    

11.95 fps

Пераўтварыце відэа ў зададзеную пастаянную частату кадраў шляхам дубліравання або выключэння кадраў па меры неабходнасці.

Ён прымае наступныя параметры:

fps

Жаданая частата кадраў на выхадзе. Ён прымае выразы, якія змяшчаюць наступныя канстанты:

'source_fps'

Частата кадраў уводу

'ntsc'

Частата кадраў ntsc30000/1001

'pal'

Частата кадраў PAL25.0

'film'

Частата кадраў фільма24.0

'ntsc_film'

Частата кадраў фільма ntsc24000/1001

Па змаўчанні - 25.

start_time

Выкажам здагадку, што першы PTS павінен быць зададзеным значэннем у секундах. Гэта дазваляе запоўніць/абрэзаць у пачатку патоку. Па змаўчанні не робяцца здагадкі аб чаканым PTS для першага кадра, таму запаўненне або абрэзка не выконваюцца. Напрыклад, гэта можа быць усталявана ў 0, каб запоўніць пачатак дублікатамі першага кадра, калі відэаплынь пачынаецца пасля аўдыёплыні, або абрэзаць любыя кадры з адмоўным PTS.

round

Метад акруглення часовай меткі (PTS).

Магчымыя значэнні:

zero

акругліць у бок 0

inf

акругліць ад 0

down

круглы ў бок -бясконцасці

up

акругленне да +бясконцасці

near

акругліць да бліжэйшага

Па змаўчанні - near.

eof_action

Дзеянне, якое выконваецца пры чытанні апошняга кадра.

Магчымыя значэнні:

round

Выкарыстоўвайце той жа метад акруглення меткі часу, што і для іншых кадраў.

pass

Пераход праз апошні кадр, калі працягласць уводу яшчэ не дасягнута.

Па змаўчанні - round.

У якасці альтэрнатывы параметры можна задаць як просты радок: fps[: start_time[: round]].

Глядзіце таксама фільтр setpts .

11.95.1 Examples

  • Звычайнае выкарыстанне, каб усталяваць 25 кадраў у секунду:
    fps=fps=25
    
  • Усталёўвае кадры ў секунду на 24, выкарыстоўваючы абрэвіятуру і метад акруглення для акруглення да бліжэйшага:
    fps=fps=film:round=near
    

11.96 framepack

Спакуйце два розныя відэапатокі ў стэрэаскапічнае відэа, усталяваўшы правільныя метададзеныя ў падтрымоўваных кодэках. Два віды павінны мець аднолькавы памер і частату кадраў, і апрацоўка спыняецца, калі карацейшае відэа скончыцца. Звярніце ўвагу, што вы можаце зручна наладзіць уласцівасці выгляду з дапамогай фільтраў маштабу і кадраў у секунду.

Ён прымае наступныя параметры:

format

Пажаданы фармат упакоўкі. Падтрымліваюцца наступныя значэнні:

sbs

Віды размешчаны побач адзін з адным (па змаўчанні).

tab

Выгляды адзін на аднаго.

lines

Прагляды спакаваныя па радках.

columns

Прагляды спакаваныя па слупках.

frameseq

Погляды часова перамяжоўваюцца.

Некаторыя прыклады:

# Convert left and right views into a frame-sequential video
ffmpeg -i LEFT -i RIGHT -filter_complex framepack=frameseq OUTPUT

# Convert views into a side-by-side video with the same output resolution as the input
ffmpeg -i LEFT -i RIGHT -filter_complex [0:v]scale=w=iw/2[left],[1:v]scale=w=iw/2[right],[left][right]framepack=sbs OUTPUT

11.97 framerate

Зменіце частату кадраў шляхам інтэрпаляцыі новых кадраў выхаду відэа з зыходных кадраў.

Гэты фільтр не прызначаны для правільнай працы з празрадковай разгорткай. Калі вы жадаеце змяніць частату кадраў у празрадковай разгортцы, вам трэба зрабіць дэінтэрлейс перад гэтым фільтрам і паўторна празрадок пасля гэтага фільтра.

Далей апісваюцца прынятыя варыянты.

fps

Укажыце колькасць кадраў у секунду. Гэтую опцыю таксама можна ўказаць як значэнне. Па змаўчанні - 50.

interp_start

Укажыце пачатак дыяпазону, дзе будзе створаны выхадны кадр у выглядзе лінейнай інтэрпаляцыі двух кадраў. Дыяпазон [ 0- 255], па змаўчанні 15.

interp_end

Укажыце канец дыяпазону, дзе будзе створаны выхадны кадр у выглядзе лінейнай інтэрпаляцыі двух кадраў. Дыяпазон [ 0- 255], па змаўчанні 240.

scene

Укажыце ўзровень, на якім выяўляецца змена сцэны, як значэнне ад 0 да 100, каб паказаць новую сцэну; нізкае значэнне адлюстроўвае нізкую верагоднасць для бягучага кадра ўвесці новую сцэну, у той час як больш высокае значэнне азначае, што бягучы кадр, хутчэй за ўсё, будзе адзін. Па змаўчанні - 8.2.

flags

Укажыце сцягі, якія ўплываюць на працэс фільтрацыі.

Даступнае значэнне для flags:

scene_change_detect, scd

Уключыць выяўленне змены сцэны, выкарыстоўваючы значэнне параметра scene. Гэты сцяг уключаны па змаўчанні.

11.98 framestep

Выбірайце адзін кадр кожны N-ы кадр.

Гэты фільтр прымае наступныя параметры:

step

Выбірайце кадр пасля кожнага stepкадра. Дазволеныя значэнні - натуральныя лікі, большыя за 0. Значэнне па змаўчанні - 1.

11.99 freezedetect

Выявіць замарожанае відэа.

Гэты фільтр рэгіструе паведамленне і ўсталёўвае метаданыя кадра, калі выяўляе, што ўваходнае відэа не мае істотных змяненняў у змесце на працягу вызначанага перыяду. Выяўленне завісання відэа вылічае сярэднюю абсалютную розніцу ўсіх кампанентаў відэакадраў і параўноўвае яе з мінімальным шумам.

Надрукаваны час і працягласць выражаны ў секундах. Ключ lavfi.freezedetect.freeze_startметаданых усталёўваецца на першым кадры, часовая пазнака якога роўная або перавышае працягласць выяўлення, і змяшчае пазнаку часу першага кадра прыпынку. Ключы метададзеных і задаюцца на першым кадры пасля прыпынку lavfi.freezedetect.freeze_duration. lavfi.freezedetect.freeze_end

Фільтр прымае наступныя параметры:

noise, n

Усталюйце шумацярпімасць. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў якасці каэфіцыента рознасці паміж 0 і 1. Значэнне па змаўчанні - -60 дБ або 0,001.

duration, d

Усталюйце працягласць прыпынку да паведамлення (па змаўчанні 2 секунды).

11.100 freezeframes

Стоп-кадры відэа.

Гэты фільтр замарожвае відэакадры, выкарыстоўваючы кадр з 2-га ўваходу.

Фільтр прымае наступныя параметры:

first

Усталюйце нумар першага кадра, з якога пачнецца прыпынак.

last

Усталюйце нумар апошняга кадра, з якога заканчваецца прыпынак.

replace

Усталюйце колькасць кадраў з 2-га ўваходу, якія будуць выкарыстоўвацца замест замененых кадраў.

11.101 frei0r

Прымяніць эфект frei0r да ўваходнага відэа.

Каб уключыць кампіляцыю гэтага фільтра, вам трэба ўсталяваць загаловак frei0r і наладзіць FFmpeg з дапамогай --enable-frei0r.

Ён прымае наступныя параметры:

filter_name

Назва эфекту frei0r для загрузкі. Калі зменная асяроддзя FREI0R_PATHвызначана, эфект frei0r шукаецца ў кожным з каталогаў, вызначаных спісам, падзеленым двукроп'ем у FREI0R_PATH. У адваротным выпадку шукаюцца стандартныя шляхі frei0r у наступным парадку: HOME/.frei0r-1/lib/,/usr/local/lib/frei0r-1/, /usr/lib/frei0r-1/.

filter_params

Спіс параметраў, падзеленых '|' для перадачы ў эфект frei0r.

Параметр эфекту frei0r можа быць лагічным (яго значэнне роўна "y" або "n"), падвойным, колерам (вызначаным як R/ G/ B, дзе R, Gі Bз'яўляюцца лікамі з плаваючай коскай ад 0,0 да 1,0 уключна) або апісанне колеру, як паказана ў раздзеле (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils , пазіцыя (зададзеная як X/ Y, дзе Xі Y- лікі з плаваючай коскай) і/або радок.

Колькасць і тыпы параметраў залежаць ад загружанага эфекту. Калі параметр эфекту не ўказаны, усталёўваецца значэнне па змаўчанні.

11.101.1 Examples

  • Ужыеце эфект distort0r, усталяваўшы першыя два двайных параметру:
    frei0r=filter_name=distort0r:filter_params=0.5|0.01
    
  • Прымяніце эфект каляровай адлегласці, прымаючы колер у якасці першага параметра:
    frei0r=colordistance:0.2/0.3/0.4
    frei0r=colordistance:violet
    frei0r=colordistance:0x112233
    
  • Прымяніце эфект перспектывы, указаўшы верхняе левае і верхняе правае становішча выявы:
    frei0r=perspective:0.2/0.2|0.8/0.2
    

Для атрымання дадатковай інфармацыі глядзіце http://frei0r.dyne.org

11.101.2 Commands

Гэты фільтр падтрымліваеfilter_paramsварыянт як каманды .

11.102 fspp

Ужывайце хуткую і простую постапрацоўку. Гэта больш хуткая версія spp .

Ён падзяляе (I)DCT на гарызантальныя/вертыкальныя праходы. У адрозненне ад простага фільтра пост-апрацоўкі, адзін з іх выконваецца адзін раз на блок, а не на піксель. Гэта дазваляе значна больш высокую хуткасць.

Фільтр прымае наступныя параметры:

quality

Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 4-5. Значэнне па змаўчанні - 4.

qp

Прымусова ўсталяваць пастаянны параметр квантавання. Ён прымае цэлы лік у дыяпазоне 0-63. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).

strength

Усталюйце трываласць фільтра. Ён прымае цэлы лік у дыяпазоне ад -15 да 32. Больш нізкія значэнні азначаюць больш дэталяў, але таксама больш артэфактаў, у той час як больш высокія значэнні робяць выяву больш гладкай, але таксама размытай. Значэнне па змаўчанні 0- аптымальны PSNR.

use_bframe_qp

Уключыць выкарыстанне QP з B-Frames, калі ўстаноўлена 1. Выкарыстанне гэтай опцыі можа выклікаць мігценне, паколькі B-рамкі часта маюць большы QP. Па змаўчанні 0(не ўключана).

11.103 gblur

Прымяніць фільтр размыцця Гаўса.

Фільтр прымае наступныя параметры:

sigma

Усталюйце гарызантальную сігму, стандартнае адхіленне размыцця па Гаўсу. Па змаўчанні 0.5.

steps

Задайце колькасць крокаў для набліжэння Гаўса. Па змаўчанні 1.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.

sigmaV

Усталюйце вертыкальную сігму, калі адмоўная, яна будзе такой жа, як sigma. Па змаўчанні -1.

11.103.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.104 geq

Прымяніць агульнае ўраўненне да кожнага пікселя.

Фільтр прымае наступныя параметры:

lum_expr, lum

Усталюйце выраз яркасці.

cb_expr, cb

Усталюйце выраз колернасці сіняга.

cr_expr, cr

Усталюйце каляровасць чырвонага колеру.

alpha_expr, a

Усталюйце альфа-выраз.

red_expr, r

Усталюйце чырвоны выраз.

green_expr, g

Усталюйце зялёны выраз.

blue_expr, b

Усталюйце сіні выраз.

Каляровая прастора падбіраецца ў адпаведнасці з зададзенымі параметрамі. Калі адзін зlum_expr,cb_expr, абоcr_expr параметры вызначаны, фільтр аўтаматычна выбярэ каляровую прастору YCbCr. Калі адзін зred_expr,green_expr, або blue_exprуказваюцца параметры, будзе абраная каляровая прастора RGB.

Калі адзін з выразаў каляровасці не вызначаны, ён вяртаецца да іншага. Калі альфа-выраз не ўказаны, ён будзе мець непразрыстае значэнне. Калі ні адзін з выразаў каляровасці не ўказаны, яны будуць ацэньвацца як выраз яркасці.

Выразы могуць выкарыстоўваць наступныя зменныя і функцыі:

N

Парадкавы нумар адфільтраванага кадра, пачынаючы з 0.

X
Y

Каардынаты бягучай выбаркі.

W
H

Шырыня і вышыня выявы.

SW
SH

Шкала шырыні і вышыні ў залежнасці ад адфільтраванай плоскасці. Гэта стаўленне паміж адпаведнай колькасцю пікселяў плоскасці яркасці і колькасцю пікселяў у бягучай плоскасці. Напрыклад, для YUV4:2:0 значэнні адносяцца 1,1да плоскасці яркасці і 0.5,0.5для плоскасцей каляровасці.

T

Час бягучага кадра, выражаны ў секундах.

p(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) бягучай плоскасці.

lum(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) плоскасці яркасці.

cb(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) плоскасці каляровасці рознасці сіняга. Вярнуць 0, калі такой плоскасці няма.

cr(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) плоскасці каляровасці чырвонай розніцы. Вярнуць 0, калі такой плоскасці няма.

r(x, y)
g(x, y)
b(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) чырвонага/зялёнага/сіняга кампанента. Вярнуць 0, калі такога кампанента няма.

alpha(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) альфа-плоскасці. Вярнуць 0, калі такой плоскасці няма.

psum(x,y), lumsum(x, y), cbsum(x,y), crsum(x,y), rsum(x,y), gsum(x,y), bsum(x,y), alphasum(x,y)

Сума значэнняў выбаркі ў прамавугольніку ад (0,0) да (x,y), гэта дазваляе атрымаць сумы выбарак у прамавугольніку. Глядзіце функцыі без постфікса сумы.

interpolation

Усталюйце адзін з метадаў інтэрпаляцыі:

nearest, n
bilinear, b

Па змаўчанні білінейны.

Для функцый, калі xі yзнаходзяцца па-за зонай, значэнне будзе аўтаматычна абрэзана да бліжэйшага краю.

Звярніце ўвагу, што гэты фільтр можа выкарыстоўваць некалькі патокаў, і ў гэтым выпадку кожны зрэз будзе мець свой уласны стан выразу. Калі вы хочаце выкарыстоўваць толькі адзін стан выразу, таму што вашы выразы залежаць ад папярэдняга стану, вам варта абмежаваць колькасць патокаў фільтра да 1.

11.104.1 Examples

  • Перавярнуць малюнак па гарызанталі:
    geq=p(W-X\,Y)
    
  • Сфармуйце двухмерную сінусоіду з вуглом PI/3і даўжынёй хвалі 100 пікселяў:
    geq=128 + 100*sin(2*(PI/100)*(cos(PI/3)*(X-50*T) + sin(PI/3)*Y)):128:128
    
  • Стварыце мудрагелістае загадкавае рухомае святло:
    nullsrc=s=256x256,geq=random(1)/hypot(X-cos(N*0.07)*W/2-W/2\,Y-sin(N*0.09)*H/2-H/2)^2*1000000*sin(N*0.02):128:128
    
  • Стварыце хуткі эфект ціснення:
    format=gray,geq=lum_expr='(p(X,Y)+(256-p(X-4,Y-4)))/2'
    
  • Змяніць кампаненты RGB у залежнасці ад пазіцыі пікселя:
    geq=r='X/W*r(X,Y)':g='(1-X/W)*g(X,Y)':b='(H-Y)/H*b(X,Y)'
    
  • Стварыце радыяльны градыент таго ж памеру, што і ўваход (гл. таксама фільтр віньеткі ):
    geq=lum=255*gauss((X/W-0.5)*3)*gauss((Y/H-0.5)*3)/gauss(0)/gauss(0),format=gray
    

11.105 gradfun

Выпраўце артэфакты палос, якія часам уводзяцца ў амаль плоскія вобласці шляхам абразання да 8-бітнай глыбіні колеру. Інтэрпалюйце градыенты, якія павінны ісці там, дзе знаходзяцца паласы, і згладзьце іх.

Ён прызначаны толькі для прайгравання. Не выкарыстоўвайце яго перад сцісканнем са стратамі, таму што пры сціску губляецца дрыганне і вяртаюцца паласы.

Ён прымае наступныя параметры:

strength

Максімальная колькасць, на якую фільтр зменіць любы піксель. Гэта таксама парог для выяўлення амаль плоскіх абласцей. Дапушчальныя значэнні ад 0,51 да 64; значэнне па змаўчанні - 1,2. Значэнні за межамі дыяпазону будуць абрэзаны да сапраўднага дыяпазону.

radius

Раён, да якога трэба падагнаць градыент. Большы радыус забяспечвае больш плыўныя градыенты, але таксама не дазваляе фільтру змяняць пікселі каля дэталёвых абласцей. Дапушчальныя значэння 8-32; значэнне па змаўчанні - 16. Значэнні, якія выходзяць за межы дыяпазону, будуць абрэзаны да сапраўднага дыяпазону.

У якасці альтэрнатывы параметры могуць быць вызначаны ў выглядзе плоскага радка: strength[: radius]

11.105.1 Examples

  • Ужывайце фільтр з 3.5трываласцю і радыусам 8:
    gradfun=3.5:8
    
  • Укажыце радыус, апускаючы трываласць (якая вернецца да значэння па змаўчанні):
    gradfun=radius=8
    

11.106 graphmonitor

Паказаць розныя статыстычныя дадзеныя фільтра.

З дапамогай гэтага фільтра можна адладжваць поўны графік фільтра. Асабліва праблемы з запаўненнем спасылак фрэймамі ў чарзе.

Фільтр прымае наступныя параметры:

size, s

Усталюйце памер вываду відэа. Па змаўчанні hd720.

opacity, o

Задаць непразрыстасць відэа. Па змаўчанні 0.9. Дазволены дыяпазон ад 0да 1.

mode, m

Усталюйце рэжым вываду, можа быць fulllабо compact. У compactрэжыме толькі фільтры з некаторымі кадрамі ў чарзе паказваюць статыстыку.

flags, f

Усталюйце сцягі, якія дазваляюць паказваць статыстыку ў відэа.

Даступныя значэнні для сцягоў:

'queue'

Адлюстраванне колькасці кадраў у чарзе ў кожнай спасылцы.

'frame_count_in'

Адлюстраванне колькасці кадраў, узятых з фільтра.

'frame_count_out'

Адлюстраванне колькасці кадраў, выдадзеных з фільтра.

'frame_count_delta'

Адлюстраванне дэльта-колькасці кадраў паміж двума вышэйзгаданымі значэннямі.

'pts'

Адлюстраванне бягучых адфільтраваных кадраў.

'pts_delta'

Адлюстраванне дэльты пунктаў паміж бягучым і папярэднім кадрам.

'time'

Адлюстраванне бягучага адфільтраванага часу кадра.

'time_delta'

Адлюстраванне дэльты часу паміж бягучым і папярэднім кадрам.

'timebase'

Адлюстраванне часовай базы для спасылкі на фільтр.

'format'

Адлюстраванне выкарыстанага фармату для спасылкі на фільтр.

'size'

Адлюстраванне памеру відэа або колькасці аўдыяканалаў у выпадку, калі аўдыё выкарыстоўваецца па спасылцы фільтра.

'rate'

Адлюстроўваць частату кадраў відэа або частату дыскрэтызацыі ў выпадку, калі аўдыё выкарыстоўваецца па спасылцы фільтра.

'eof'

Адлюстраванне стану выхаду спасылкі.

'sample_count_in'

Адлюстраванне колькасці проб, узятых з фільтра.

'sample_count_out'

Адлюстраванне колькасці ўзораў, выдадзеных з фільтра.

'sample_count_delta'

Паказаць дэльта-колькасць узораў паміж двума вышэйзгаданымі значэннямі.

rate, r

Усталюйце верхнюю мяжу для хуткасці выхаднога відэа, значэнне па змаўчанні 25. Гэта гарантыя таго, што частата кадраў выхаднога відэа не будзе вышэй за гэта значэнне.

11.107 grayworld

Фільтр пастаяннасці колеру, які прымяняе колеракарэкцыю на аснове дапушчэння шэрага свету

Глядзіце: https://www.researchgate.net/publication/275213614_A_New_Color_Correction_Method_for_Underwater_Imaging

Алгарытм выкарыстоўвае лінейнае святло, таму ўваходныя даныя павінны быць папярэдне лінеарызаваны (і, магчыма, правільна пазначаны).

ffmpeg -i INPUT -vf zscale=transfer=linear,grayworld,zscale=transfer=bt709,format=yuv420p OUTPUT

11.108 greyedge

Фільтр варыяцый сталасці колеру, які ацэньвае асветленасць сцэны з дапамогай алгарытму шэрага краю і адпаведна карэктуе колеры сцэны.

Глядзіце: https://staff.science.uva.nl/th.gevers/pub/GeversTIP07.pdf

Фільтр прымае наступныя параметры:

difford

Парадак дыферэнцыяцыі, які будзе прымяняцца на месцы здарэння. Павінен быць выбраны ў дыяпазоне [0,2] і значэнне па змаўчанні роўна 1.

minknorm

Параметр Мінкоўскага, які будзе выкарыстоўвацца для разліку адлегласці Мінкоўскага. Павінна быць выбрана ў дыяпазоне [0,20], а значэнне па змаўчанні роўна 1. Усталюйце 0 для атрымання максімальнага значэння замест вылічэння адлегласці Мінкоўскага.

sigma

Стандартнае адхіленне размыцця па Гаўсу, якое будзе прымяняцца да сцэны. Павінен быць выбраны ў дыяпазоне [0,1024.0] і значэнне па змаўчанні = 1. floor( sigma* break_off_sigma(3) ) не можа быць роўным 0, калі diffordбольш за 0.

11.108.1 Examples

  • Шэры край:
    greyedge=difford=1:minknorm=5:sigma=2
    
  • Максімальны край:
    greyedge=difford=1:minknorm=0:sigma=2
    

11.109 guided

Прымяненне кіраванага фільтра для згладжвання з захаваннем краёў, ачышчэння ад замутненняў і гэтак далей.

Фільтр прымае наступныя параметры:

radius

Усталюйце радыус поля ў пікселях. Дазволены дыяпазон ад 1 да 20. Па змаўчанні 3.

eps

Усталюйце параметр рэгулярызацыі (з квадратам). Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.

mode

Усталюйце рэжым фільтра. Можа быць basicабо fast. Па змаўчанні basic.

sub

Усталюйце каэфіцыент падвыбаркі для fastрэжыму. Дыяпазон ад 2 да 64. Па змаўчанні 4. У basicрэжыме субвыбарка не адбываецца.

guidance

Усталюйце рэжым навядзення. Можа быць offабо on. Па змаўчанні off. Калі off, патрабуецца адзін увод. Калі on, патрабуюцца два ўводы з аднолькавым дазволам і фарматам пікселяў. Другі ўваход служыць кіраўніцтвам.

planes

Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.

11.109.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.109.2 Examples

  • Згладжванне з захаваннем краёў з кіраваным фільтрам:
    ffmpeg -i in.png -vf guided out.png
    
  • Выдаленне дымлення, фільтраванне перадачы структуры, паляпшэнне дэталізацыі з дапамогай кіраванага фільтра. Каб стварыць кіруючую выяву, звярніцеся да артыкула "Кіраваная фільтрацыя выявы". Глядзіце: http://kaiminghe.com/publications/pami12guidedfilter.pdf .
    ffmpeg -i in.png -i guidance.png -filter_complex guided=guidance=on out.png
    

11.110 haldclut

Прымяніць Hald CLUT да відэапатоку.

Першы ўваход - гэта відэаструмень для апрацоўкі, а другі - Hald CLUT. Уваход Hald CLUT можа быць простым малюнкам або поўным відэапатокам.

Фільтр прымае наступныя параметры:

clut

Усталяваць, якія відэакадры CLUT будуць апрацоўвацца з другога ўваходнага патоку, можа быць firstабо all. Па змаўчанні all.

shortest

Прымусовае спыненне, калі заканчваецца самы кароткі ўвод. Па змаўчанні 0.

repeatlast

Працягнуць прымяненне апошняга CLUT пасля заканчэння патоку. Значэнне 0адключэння фільтра пасля дасягнення апошняга кадра CLUT. Па змаўчанні 1.

haldclutтаксама мае тыя ж параметры інтэрпаляцыі, што і lut3d (абодва фільтры маюць аднолькавыя ўнутраныя функцыі).

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

Дадатковую інфармацыю аб Hald CLUT можна знайсці на вэб-сайце Эскіла Стынберга (аўтара Hald CLUT) па адрасе http://www.quelsolaar.com/technology/clut.html .

11.110.1 Commands

Гэты фільтр падтрымлівае interpпараметр як каманды .

11.110.2 Workflow examples

11.110.2.1 Hald CLUT video stream

Стварыце ідэнтычнасць Hald CLUT паток зменены з рознымі эфектамі:

ffmpeg -f lavfi -i haldclutsrc=8 -vf "hue=H=2*PI*t:s=sin(2*PI*t)+1, curves=cross_process" -t 10 -c:v ffv1 clut.nut

Заўвага: пераканайцеся, што вы выкарыстоўваеце кодэк без страт.

Затым выкарыстоўвайце яго, haldclutкаб прымяніць да нейкага выпадковага патоку:

ffmpeg -f lavfi -i mandelbrot -i clut.nut -filter_complex '[0][1] haldclut' -t 20 mandelclut.mkv

Hald CLUT будзе прымяняцца да 10 першых секунд (працягласць clut.nut), то апошняе малюнак гэтага патоку CLUT будзе прымяняцца да астатніх кадраў mandelbrotпатоку.

11.110.2.2 Hald CLUT with preview

Мяркуецца, што Hald CLUT - гэта выява ў квадраце памерам Level*Level*Levelпікселяў Level*Level*Level. Для дадзенага Hald CLUT FFmpeg выбярэ максімальна магчымы квадрат, пачынаючы з левага верхняга кута малюнка. Астатнія пікселі запаўнення (унізе або справа) будуць ігнаравацца. Гэтую вобласць можна выкарыстоўваць, каб дадаць папярэдні прагляд Hald CLUT.

Як правіла, наступны згенераваны Hald CLUT будзе падтрымлівацца haldclutфільтрам:

ffmpeg -f lavfi -i haldclutsrc=8 -vf "
   pad=iw+320 [padded_clut];
   smptebars=s=320x256, split [a][b];
   [padded_clut][a] overlay=W-320:h, curves=color_negative [main];
   [main][b] overlay=W-320" -frames:v 1 clut.png

Ён утрымлівае арыгінал і папярэдні прагляд эфекту CLUT: каляровыя паласы SMPTE адлюстроўваюцца справа ўверсе і ўнізе тыя ж каляровыя палоскі, апрацаваныя змяненнем колеру.

Затым эфект гэтага Hald CLUT можна візуалізаваць з дапамогай:

ffplay input.mkv -vf "movie=clut.png, [in] haldclut"

11.111 hflip

Перавярніце ўваходнае відэа па гарызанталі.

Напрыклад, каб перавярнуць уваходнае відэа па гарызанталі з дапамогай ffmpeg:

ffmpeg -i in.avi -vf "hflip" out.avi

11.112 histeq

Гэты фільтр прымяняе глабальнае выраўноўванне каляровай гістаграмы для кожнага кадра.

Яго можна выкарыстоўваць для карэкцыі відэа, якое мае сціснуты дыяпазон інтэнсіўнасці пікселяў. Фільтр пераразмяркоўвае інтэнсіўнасць пікселяў, каб выраўнаваць іх размеркаванне ў дыяпазоне інтэнсіўнасці. Яго можна разглядаць як "кантрастны фільтр, які аўтаматычна рэгулюе". Гэты фільтр карысны толькі для карэкціроўкі пагоршанага або дрэнна зафіксаванага зыходнага відэа.

Фільтр прымае наступныя параметры:

strength

Вызначце колькасць выраўноўвання, якое трэба прымяніць. Па меры зніжэння трываласці размеркаванне інтэнсіўнасці пікселяў усё больш набліжаецца да размеркавання інтэнсіўнасці ўваходнага кадра. Значэнне павінна быць лікам з плаваючай часткай у дыяпазоне [0,1] і па змаўчанні роўна 0,200.

intensity

Усталюйце максімальную інтэнсіўнасць, якая можа генеравацца, і адпаведным чынам маштабуйце выхадныя значэнні. Сіла павінна быць зададзена па жаданні, а затым інтэнсіўнасць можа быць абмежавана, калі неабходна, каб пазбегнуць вымывання. Значэнне павінна быць лікам з плаваючай часткай у дыяпазоне [0,1] і па змаўчанні роўна 0,210.

antibanding

Усталюйце ўзровень антыбандынгу. Калі ўключаны, фільтр будзе выпадковым чынам змяняць яркасць выходных пікселяў на невялікую колькасць, каб пазбегнуць палос на гістаграме. Магчымыя значэнні none, weakабо strong. Па змаўчанні гэта none.

11.113 histogram

Вылічыце і намалюйце гістаграму размеркавання колеру для ўваходнага відэа.

Вылічаная гістаграма - гэта адлюстраванне размеркавання кампанентаў колеру на малюнку.

Стандартная гістаграма адлюстроўвае размеркаванне кампанентаў колеру на малюнку. Адлюстроўвае каляровы графік для кожнага кампанента колеру. Паказвае размеркаванне кампанентаў Y, U, V, A або R, G, B, у залежнасці ад фармату ўводу, у бягучым кадры. Пад кожным графікам паказаны метр шкалы кампанентаў колеру.

Фільтр прымае наступныя параметры:

level_height

Задайце вышыню ўзроўню. Значэнне па змаўчанні - 200. Дазволены дыяпазон [50, 2048].

scale_height

Задаць вышыню каляровай шкалы. Значэнне па змаўчанні - 12. Дазволены дыяпазон [0, 40].

display_mode

Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:

'stack'

Графікі кампанентаў колеру размешчаны адзін пад адным.

'parade'

Графікі кампанентаў колеру размешчаны побач.

'overlay'

Прадстаўляе інфармацыю, ідэнтычную той, што ў parade, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.

Па змаўчанні stack.

levels_mode

Усталяваць рэжым. Можа быць або linear, або logarithmic. Па змаўчанні linear.

components

Усталюйце кампаненты колеру для адлюстравання. Па змаўчанні 7.

fgopacity

Задаць непразрыстасць пярэдняга плана. Па змаўчанні 0.7.

bgopacity

Задаць непразрыстасць фону. Па змаўчанні 0.5.

colors_mode

Усталяваць каляровы рэжым. Ён прымае наступныя значэнні:

'whiteonblack'
'blackonwhite'
'whiteongray'
'blackongray'
'coloronblack'
'coloronwhite'
'colorongray'
'blackoncolor'
'whiteoncolor'
'grayoncolor'

Па змаўчанні whiteonblack.

11.113.1 Examples

  • Разлічыць і намаляваць гістаграму:
    ffplay -i input -vf histogram
    

11.114 hqdn3d

Гэта высокадакладны/якасны 3d-фільтр шумашумлення. Яна накіравана на памяншэнне шуму выявы, атрымліваючы плыўныя выявы і робячы нерухомыя выявы сапраўды нерухомымі. Гэта павінна павысіць сціскальнасць.

Ён прымае наступныя дадатковыя параметры:

luma_spatial

Неадмоўны лік з плаваючай коскай, які вызначае прасторавую інтэнсіўнасць яркасці. Па змаўчанні 4.0.

chroma_spatial

Неадмоўны лік з плаваючай коскай, які вызначае прасторавую каляровасць. Па змаўчанні 3.0* luma_spatial/4.0.

luma_tmp

Лік з плаваючай кропкай, які вызначае часовую сілу яркасці. Па змаўчанні 6.0* luma_spatial/4.0.

chroma_tmp

Лік з плаваючай коскай, які вызначае часовую інтэнсіўнасць каляровасці. Па змаўчанні гэта luma_tmp* chroma_spatial/ luma_spatial.

11.114.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.115 hwdownload

Спампаваць апаратныя кадры ў сістэмную памяць.

Уваход павінен быць у апаратных фрэймах, а выхад - у неапаратным фармаце. Не ўсе фарматы будуць падтрымлівацца на выхадзе - магчыма, спатрэбіцца ўставіць дадатковыformatфільтраваць адразу пасля графіцы, каб атрымаць вывад у падтрымліваемым фармаце.

11.116 hwmap

Адлюстраванне апаратных кадраў у сістэмнай памяці або іншай прыладзе.

Гэты фільтр мае некалькі розных рэжымаў працы; які з іх выкарыстоўваецца, залежыць ад фарматаў уводу і вываду:

  • Апаратны ўвод кадра, звычайны выхад кадра

    Адлюструйце ўваходныя кадры ў сістэмную памяць і перадайце іх выхадным. Калі пазней спатрэбіцца арыгінальная апаратная рамка (напрыклад, пасля накладання чагосьці іншага на яе частку), тоhwmapфільтр можа быць выкарыстаны зноў у наступным рэжыме, каб атрымаць яго.

  • Звычайны ўвод кадра, апаратны выхад кадра

    Калі ўвод насамрэч з'яўляецца праграмна-адлюстраваным апаратным фрэймам, то адмяніце яго адлюстраванне, гэта значыць вярніце зыходны апаратны фрэйм.

    У адваротным выпадку неабходна прадаставіць прыладу. Стварыце новыя апаратныя паверхні на гэтай прыладзе для вываду, затым адлюструйце іх у фармат праграмнага забеспячэння на ўваходзе і аддайце гэтыя кадры папярэдняму фільтру. Затым гэта будзе дзейнічаць як hwuploadфільтр, але можа пазбегнуць дадатковай копіі, калі ўвод ужо знаходзіцца ў сумяшчальным фармаце.

  • Апаратны ўвод і вывад кадраў

    Прылада павінна быць пастаўлена для вываду, альбо непасрэдна, альбо з derive_deviceварыянт. Прылады ўводу і вываду павінны быць розных тыпаў і сумяшчальныя - дакладнае значэнне гэтага залежыць ад сістэмы, але звычайна гэта азначае, што яны павінны спасылацца на адзін і той жа базавы апаратны кантэкст (напрыклад, спасылацца на адну і тую ж відэакарту).

    Калі ўваходныя кадры былі першапачаткова створаны на прыладзе вываду, адмяніце адлюстраванне, каб атрымаць зыходныя кадры.

    У адваротным выпадку адлюстравайце кадры на прыладзе вываду - стварыце новыя апаратныя кадры на выхадзе, якія адпавядаюць кадрам на ўваходзе.

Прымаюцца наступныя дадатковыя параметры:

mode

Усталюйце рэжым адлюстравання кадраў. Некаторыя спалучэнні:

read

Адлюстраваны кадр павінен быць чытэльным.

write

Адлюстраваны кадр павінен быць даступным для запісу.

overwrite

Адлюстраванне заўсёды будзе перазапісваць увесь кадр.

У некаторых выпадках гэта можа павысіць прадукцыйнасць, бо не трэба загружаць зыходнае змесціва кадра.

direct

Адлюстраванне не павінна прадугледжваць капіраванне.

Ускосныя супастаўленні з копіямі кадраў ствараюцца ў некаторых выпадках, калі альбо прамое адлюстраванне немагчыма, альбо яно будзе мець нечаканыя ўласцівасці. Усталяванне гэтага сцяга гарантуе, што адлюстраванне будзе прамым і будзе няўдалым, калі гэта немагчыма.

Па змаўчанні, read+writeкалі не пазначана.

derive_device type

Замест таго, каб выкарыстоўваць прыладу, пастаўленую пры ініцыялізацыі, вывядзіце новую прыладу тыпу typeз прылады, на якой існуюць ўваходныя кадры.

reverse

Пры супастаўленні апаратнага забеспячэння, адлюстраванне ў зваротным парадку - стварэнне кадраў у прыёмніку і адлюстраванне іх назад у крыніцу. Гэта можа спатрэбіцца ў некаторых выпадках, калі патрабуецца адлюстраванне ў адным кірунку, але прылады, якія выкарыстоўваюцца, падтрымліваюць толькі супрацьлеглы кірунак.

Гэты параметр небяспечны - ён можа парушыць папярэдні фільтр нявызначанымі спосабамі, калі ёсць якія-небудзь дадатковыя абмежаванні на выхад гэтага фільтра. Не выкарыстоўвайце яго без поўнага разумення наступстваў яго выкарыстання.

11.117 hwupload

Загружаць кадры сістэмнай памяці на апаратныя паверхні.

Прылада для загрузкі павінна быць прадастаўлена пры ініцыялізацыі фільтра. Пры выкарыстанні ffmpeg выберыце адпаведную прыладу з дапамогай-filter_hw_device варыянт або зderive_deviceварыянт. Прылады ўводу і вываду павінны быць розных тыпаў і сумяшчальныя - дакладнае значэнне гэтага залежыць ад сістэмы, але звычайна гэта азначае, што яны павінны спасылацца на адзін і той жа базавы апаратны кантэкст (напрыклад, спасылацца на адну і тую ж відэакарту).

Прымаюцца наступныя дадатковыя параметры:

derive_device type

Замест таго, каб выкарыстоўваць прыладу, пастаўленую пры ініцыялізацыі, вывядзіце новую прыладу тыпу typeз прылады, на якой існуюць ўваходныя кадры.

11.118 hwupload_cuda

Загрузіце кадры сістэмнай памяці на прыладу CUDA.

Ён прымае наступныя дадатковыя параметры:

device

Нумар прылады CUDA для выкарыстання

11.119 hqx

Прымяніце высакаякасны фільтр павелічэння, прызначаны для піксельнага мастацтва. Гэты фільтр быў першапачаткова створаны Максімам Сцёпіным.

Ён прымае наступны варыянт:

n

Усталюйце памер маштабавання: 2для hq2x, 3для hq3xі 4для hq4x. Па змаўчанні 3.

11.120 hstack

Складайце ўваходныя відэа гарызантальна.

Усе патокі павінны мець аднолькавы піксельны фармат і аднолькавую вышыню.

Звярніце ўвагу, што гэты фільтр працуе хутчэй, чым выкарыстанне накладання і фільтра падкладкі для стварэння таго ж выхаду.

Фільтр прымае наступныя параметры:

inputs

Задаць колькасць уваходных патокаў. Па змаўчанні 2.

shortest

Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.

11.121 hsvhold

Ператварае пэўны дыяпазон HSV у шэрыя значэнні.

Гэты фільтр вымярае каляровую розніцу паміж зададзеным колерам HSV у параметрах і колерам, вымераным у відэаструмені. У залежнасці ад опцый, колеры вываду можна змяніць на шэрыя ці не.

Фільтр прымае наступныя параметры:

hue

Усталюйце значэнне адцення, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -360 да 360. Значэнне па змаўчанні - 0.

sat

Усталюйце значэнне насычанасці, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

val

Усталюйце значэнне, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

similarity

Задайце працэнт падабенства з колерам ключа. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.

0,00001 адпавядае толькі дакладнаму колеру ключа, у той час як 1,0 адпавядае ўсім.

blend

Працэнт сумесі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.

0.0 робіць пікселі альбо цалкам шэрымі, альбо зусім не шэрымі.

Больш высокія значэнні прыводзяць да большай колькасці шэрых пікселяў, чым больш шэры піксель, тым больш падобны колер пікселяў да ключавога колеру.

11.122 hsvkey

Ператварае пэўны дыяпазон HSV у празрысты.

Гэты фільтр вымярае каляровую розніцу паміж зададзеным колерам HSV у параметрах і колерам, вымераным у відэаструмені. У залежнасці ад опцый, выхадныя колеры можна змяніць на празрыстыя, дадаўшы альфа-канал.

Фільтр прымае наступныя параметры:

hue

Усталюйце значэнне адцення, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -360 да 360. Значэнне па змаўчанні - 0.

sat

Усталюйце значэнне насычанасці, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

val

Усталюйце значэнне, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

similarity

Задайце працэнт падабенства з колерам ключа. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.

0,00001 адпавядае толькі дакладнаму колеру ключа, у той час як 1,0 адпавядае ўсім.

blend

Працэнт сумесі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.

0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.

Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.

11.123 hue

Змяніце адценне і/або насычанасць уводу.

Ён прымае наступныя параметры:

h

Укажыце кут адцення ў градусах. Ён прымае выраз і па змаўчанні мае "0".

s

Укажыце насычанасць у дыяпазоне [-10,10]. Ён прымае выраз і па змаўчанні мае "1".

H

Укажыце вугал адцення ў колькасці радыян. Ён прымае выраз і па змаўчанні мае "0".

b

Укажыце яркасць у дыяпазоне [-10,10]. Ён прымае выраз і па змаўчанні мае "0".

hіHз'яўляюцца ўзаемавыключальнымі і не могуць быць вызначаны адначасова.

Theb,h,Hіsзначэнні параметраў - гэта выразы, якія змяшчаюць наступныя канстанты:

n

колькасць кадраў уваходнага кадра, пачынаючы з 0

pts

пазнака часу прадстаўлення ўваходнага кадра, выражаная ў адзінках асновы часу

r

частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая

t

пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая

tb

часовая база ўваходнага відэа

11.123.1 Examples

  • Усталюйце адценне 90 градусаў і насычанасць 1,0:
    hue=h=90:s=1
    
  • Тая ж каманда, але з выражэннем адцення ў радыянах:
    hue=H=PI/2:s=1
    
  • Павярніце адценне і змяніце насычанасць паміж 0 і 2 на працягу 1 секунды:
    hue="H=2*PI*t: s=sin(2*PI*t)+1"
    
  • Прымяніць 3-секундны эфект плыні насычэння, пачынаючы з 0:
    hue="s=min(t/3\,1)"
    

    Агульны выраз з знікненнем можна запісаць так:

    hue="s=min(0\, max((t-START)/DURATION\, 1))"
    
  • Прымяніць эфект згасання насычанасці на 3 секунды, пачынаючы з 5 секунд:
    hue="s=max(0\, min(1\, (8-t)/3))"
    

    Агульны выраз знікнення можна запісаць так:

    hue="s=max(0\, min(1\, (START+DURATION-t)/DURATION))"
    

11.123.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

b
s
h
H

Змяніце адценне і/або насычанасць і/або яркасць уваходнага відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.124 huesaturation

Прымяніць карэкціроўкі адцення, насычанасці і інтэнсіўнасці да ўваходнага відэапатоку.

Гэты фільтр працуе ў каляровай прасторы RGB.

Гэты фільтр прымае наступныя параметры:

hue

Усталюйце зрух адцення ў градусах для прымянення. Па змаўчанні 0. Дазволены дыяпазон ад -180 да 180.

saturation

Усталюйце зрух насычанасці. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

intensity

Усталюйце зрух інтэнсіўнасці. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.

colors

Усталюйце, якія асноўныя і дадатковыя колеры будуць скарэкціраваны. Гэты параметр усталёўваецца шляхам прадастаўлення аднаго або некалькіх значэнняў. Гэта можа выбраць некалькі колераў адначасова. Па змаўчанні выбраны ўсе колеры.

'r'

Адрэгулюйце чырвоныя.

'y'

Адрэгулюйце жоўты колер.

'g'

Адрэгулюйце зеляніна.

'c'

Адрэгулюйце цыяны.

'b'

Наладзіць блюз.

'm'

Адрэгулюйце пурпурныя колеры.

'a'

Адрэгулюйце ўсе колеры.

strength

Усталюйце сілу фільтрацыі. Дазволены дыяпазон ад 0 да 100. Значэнне па змаўчанні - 1.

rw, gw, bw

Усталюйце вагу для кожнага кампанента RGB. Дазволены дыяпазон ад 0 да 1. Па змаўчанні ўстаноўлена 0,333, 0,334, 0,333. Гэтыя варыянты выкарыстоўваюцца ў апрацоўцы насычэння і асвятлення.

lightness

Задаць захаванне лёгкасці, па змаўчанні адключана. Рэгуляванне адценняў можа змяніць яркасць у параўнанні з арыгінальным трыплетам RGB, калі гэты параметр уключаны, яркасць захоўваецца на ранейшым узроўні.

11.125 hysteresis

Перарасці першы паток у другі паток шляхам злучэння кампанентаў. Гэта дазваляе ствараць больш трывалыя краёвыя маскі.

Гэты фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

threshold

Усталюйце парог, які выкарыстоўваецца пры фільтрацыі. Калі значэнне піксельнага кампанента вышэй за гэта значэнне, уключаецца алгарытм фільтра для злучэння кампанентаў. Па змаўчанні значэнне роўна 0.

Фільтр hysteresisтаксама падтрымлівае параметры framesync .

11.126 iccdetect

Вызначце каляровую прастору з убудаванага профілю ICC (калі ён ёсць) і адпаведна абнавіце тэгі кадра.

Гэты фільтр прымае наступныя параметры:

force

Калі ісціна, існуючыя тэгі каляровай прасторы фрэйма заўсёды будуць перавызначацца значэннямі, выяўленымі з профілю ICC. У адваротным выпадку яны будуць прызначаны, толькі калі ўтрымліваюць unknown. Уключана па змаўчанні.

11.127 iccgen

Стварыць профілі ICC і прымацаваць іх да рам.

Гэты фільтр прымае наступныя параметры:

color_primaries
color_trc

Наладзьце каляровую прастору, для якой будзе створаны профіль ICC. Значэнне па змаўчанні autoвыводзіць значэнне з метаданых уваходнага кадра, па змаўчанні - BT.709/sRGB у залежнасці ад выпадку.

Спіс магчымых значэнняў глядзіце ў фільтры setparamsunknown , але звярніце ўвагу, што значэнні для гэтага фільтра недапушчальныя.

force

Калі ісціна, профіль ICC будзе створаны, нават калі ён перазапіша ўжо існуючы профіль ICC. Па змаўчанні адключана.

11.128 identity

Атрымаць адзнаку ідэнтычнасці паміж двума ўваходнымі відэа.

Гэты фільтр прымае два ўваходныя відэа.

Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.

Атрыманы па кампаненту, сярэдні, мінімальны і максімальны бал ідэнтычнасці друкуецца праз сістэму рэгістрацыі.

Фільтр захоўвае разлічаныя балы ідэнтычнасці кожнага кадра ў метададзеных кадра.

У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpgапрацоўваецца параўноўваецца з эталонным файламref.mpg.

ffmpeg -i main.mpg -i ref.mpg -lavfi identity -f null -

11.129 idet

Вызначыць тып перапляцення відэа.

Гэты фільтр спрабуе вызначыць, калі ўваходныя кадры з'яўляюцца празрадковай, прагрэсіўнай, верхнім або ніжнім полем першым. Ён таксама паспрабуе выявіць палі, якія паўтараюцца паміж суседнімі кадрамі (прыкмета тэлекіно).

Пры класіфікацыі кожнага кадра пры выяўленні аднаго кадра ўлічваюцца толькі непасрэдна суседнія кадры. Выяўленне некалькіх кадраў уключае ў сябе гісторыю класіфікацыі папярэдніх кадраў.

Фільтр будзе запісваць гэтыя значэнні метададзеных:

single.current_frame

Выяўлены тып бягучага кадра з дапамогай выяўлення аднаго кадра. Адзін з: «tff» (спачатку верхняе поле), «bff» (спачатку ніжняе поле), «прагрэсіўны» або «нявызначаны»

single.tff

Сукупная колькасць кадраў, выяўленых у верхнім полі першым з дапамогай выяўлення аднаго кадра.

multiple.tff

Сукупная колькасць кадраў, выяўленых у верхнім полі першым з дапамогай выяўлення некалькіх кадраў.

single.bff

Сукупная колькасць кадраў, выяўленых у ніжнім полі першым з дапамогай выяўлення аднаго кадра.

multiple.current_frame

Выяўлены тып бягучага кадра з дапамогай выяўлення некалькіх кадраў. Адзін з: «tff» (спачатку верхняе поле), «bff» (спачатку ніжняе поле), «прагрэсіўны» або «нявызначаны»

multiple.bff

Сукупная колькасць кадраў, выяўленых у ніжнім полі першым з дапамогай выяўлення некалькіх кадраў.

single.progressive

Сукупная колькасць кадраў, выяўленых як прагрэсіўныя з дапамогай выяўлення аднаго кадра.

multiple.progressive

Сукупная колькасць кадраў, выяўленых як прагрэсіўныя з дапамогай выяўлення некалькіх кадраў.

single.undetermined

Сукупная колькасць кадраў, якія не ўдалося класіфікаваць з дапамогай выяўлення аднаго кадра.

multiple.undetermined

Сукупная колькасць кадраў, якія не ўдалося класіфікаваць з дапамогай выяўлення некалькіх кадраў.

repeated.current_frame

Якое поле ў бягучым кадры паўтараецца з апошняга. Адзін з "ні", "зверху" ці "знізу".

repeated.neither

Сукупная колькасць кадраў без паўтаральнага поля.

repeated.top

Сукупная колькасць кадраў з верхнім полем, якое паўтараецца з верхняга поля папярэдняга кадра.

repeated.bottom

Сукупная колькасць кадраў з ніжнім полем, якое паўтараецца з ніжняга поля папярэдняга кадра.

Фільтр прымае наступныя параметры:

intl_thres

Усталюйце парог перапляцення.

prog_thres

Усталюйце прагрэсіўны парог.

rep_thres

Парог для паўторнага выяўлення поля.

half_life

Колькасць кадраў, пасля якіх уклад дадзенага кадра ў статыстыку памяншаецца ўдвая (г.зн. ён уносіць толькі 0,5 у сваю класіфікацыю). Значэнне па змаўчанні 0 азначае, што ўсім бачным кадрам назаўжды надаецца поўная вага 1,0.

analyze_interlaced_flag

Калі гэта не роўна 0, idet будзе выкарыстоўваць зададзеную колькасць кадраў, каб вызначыць, ці дакладны сцяг празрадковай разгорткі, ён не будзе лічыць нявызначаныя кадры. Калі сцяг прызнаны дакладным, ён будзе выкарыстоўвацца без якіх-небудзь дадатковых вылічэнняў, калі ён будзе прызнаны недакладным, ён будзе выдалены без якіх-небудзь дадатковых вылічэнняў. Гэта дазваляе ўставіць фільтр idet як метад з нізкім узроўнем вылічэнняў, каб ачысціць празрадковы сцяг

11.130 il

Перамежаванне або перамежаванне палёў.

Гэты фільтр дазваляе апрацоўваць палі з празрадковай разгорткай без дэінтэрлейсу. Дэперамежаванне разбівае ўваходны кадр на 2 палі (так званыя паўмалюнкі). Няцотныя радкі перамяшчаюцца ў верхнюю палову выходнага малюнка, цотныя радкі - у ніжнюю. Вы можаце апрацоўваць (фільтраваць) іх незалежна, а потым перамяжоўваць.

Фільтр прымае наступныя параметры:

luma_mode, l
chroma_mode, c
alpha_mode, a

Даступныя значэнні для luma_modeі chroma_mode: alpha_mode

'none'

Нічога не рабіць.

'deinterleave, d'

Размясціце палі, размясціўшы адно над адным.

'interleave, i'

Чаргаванне палёў. Зваротны эфект дэперамежавання.

Значэнне па змаўчанні - none.

luma_swap, ls
chroma_swap, cs
alpha_swap, as

Памяняйце палі яркасці/каляровасці/альфа. Абмен цотнымі і няцотнымі лініямі. Значэнне па змаўчанні - 0.

11.130.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.131 inflate

Прымяніць эфект раздзімання да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) сярэднім, прымаючы пад увагу толькі значэнні, вышэйшыя за піксель.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

11.131.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.132 interlace

Просты празрадковы фільтр з прагрэсіўнага кантэнту. Гэта перамяжоўвае верхнія (або ніжнія) радкі з няцотных кадраў з ніжнімі (або верхнімі) радкамі з цотных кадраў, памяншаючы ўдвая частату кадраў і захоўваючы вышыню выявы.

   Original        Original             New Frame
   Frame 'j'      Frame 'j+1'             (tff)
  ==========      ===========       ==================
    Line 0  -------------------->    Frame 'j' Line 0
    Line 1          Line 1  ---->   Frame 'j+1' Line 1
    Line 2 --------------------->    Frame 'j' Line 2
    Line 3          Line 3  ---->   Frame 'j+1' Line 3
     ...             ...                   ...
New Frame + 1 will be generated by Frame 'j+2' and Frame 'j+3' and so on

Ён прымае наступныя дадатковыя параметры:

scan

Гэта вызначае, бярэцца празрадковы кадр з цотных (tff - па змаўчанні) або няцотных (bff) радкоў прагрэсіўнага кадра.

lowpass

Вертыкальны фільтр нізкіх частот, каб пазбегнуць перапляцення твітэра і паменшыць муар.

'0, off'

Адключыць вертыкальны фільтр нізкіх частот

'1, linear'

Уключыць лінейны фільтр (па змаўчанні)

'2, complex'

Уключыць комплексны фільтр. Гэта крыху менш зменшыць шчэбет і муар, але лепш захавае дэталізацыю і суб'ектыўную выразнасць.

11.133 kerndeint

Дэінтэрлінг ўваходнага відэа з дапамогай адаптыўнага ядра Donald Graft. Працуйце з празрадковай разгорткай у відэа для атрымання прагрэсіўных кадраў.

Ніжэй прыводзіцца апісанне прынятых параметраў.

thresh

Усталюйце парог, які ўплывае на допуск фільтра пры вызначэнні неабходнасці апрацоўкі піксельнай лініі. Яно павінна быць цэлым лікам у дыяпазоне [0,255] і па змаўчанні роўна 10. Значэнне 0 прывядзе да прымянення працэсу да кожнага пікселя.

map

Зафарбоўваць пікселі, якія перавышаюць парогавае значэнне, у белы колер, калі ўстаноўлена значэнне 1. Значэнне па змаўчанні - 0.

order

Усталюйце парадак палёў. Памяняйце палі месцамі, калі ўстаноўлена 1, пакіньце палі ў спакоі, калі 0. Па змаўчанні 0.

sharp

Уключыць дадатковую рэзкасць, калі ўстаноўлена 1. Па змаўчанні 0.

twoway

Уключыць двухбаковую рэзкасць, калі ўстаноўлена 1. Па змаўчанні 0.

11.133.1 Examples

  • Прымяніць значэнні па змаўчанні:
    kerndeint=thresh=10:map=0:order=0:sharp=0:twoway=0
    
  • Уключыць дадатковую рэзкасць:
    kerndeint=sharp=1
    
  • Пафарбаваць апрацаваныя пікселі ў белы колер:
    kerndeint=map=1
    

11.134 kirsch

Ужыць аператар Кірша для ўваходнага відэаструменю.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.

11.134.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.135 lagfun

Павольна абнаўляйце больш цёмныя пікселі.

Гэты фільтр робіць кароткія ўспышкі святла больш доўгімі. Гэты фільтр прымае наступныя параметры:

decay

Устанавіць каэфіцыент распаду. Па змаўчанні 0,95. Дазволены дыяпазон ад 0 да 1.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.

11.135.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.136 lenscorrection

Выпраўце радыяльнае скажэнне лінзы

Гэты фільтр можа быць выкарыстаны для карэкцыі радыяльных скажэнняў, якія могуць узнікнуць у выніку выкарыстання шырокавугольных лінзаў, і такім чынам паўторна выправіць выяву. Каб знайсці правільныя параметры, можна выкарыстоўваць інструменты, даступныя, напрыклад, як частка opencv або проста метадам спроб і памылак. Каб выкарыстоўваць opencv, выкарыстоўвайце ўзор каліброўкі (у раздзеле samples/cpp) з крыніц opencv і вылучыце каэфіцыенты k1 і k2 з атрыманай матрыцы.

Звярніце ўвагу, што фактычна той самы фільтр даступны ў інструментах з адкрытым зыходным кодам Krita і Digikam з праекта KDE.

У адрозненне ад фільтра віньеткі , які таксама можа быць выкарыстаны для кампенсацыі памылак аб'ектыва, гэты фільтр выпраўляе скажэнне выявы, у той час як віньетка карэктуе размеркаванне яркасці, так што вы можаце выкарыстоўваць абодва фільтры разам у пэўных выпадках, хоць вам спатрэбіцца паклапаціцца пра ўпарадкаванне, г.зн. аб тым, ці варта наносіць віньеткаванне да або пасля карэкцыі лінзаў.

11.136.1 Options

Фільтр прымае наступныя параметры:

cx

Адносная каардыната х фокуснай кропкі выявы і, такім чынам, цэнтра скажэння. Гэта значэнне мае дыяпазон [0,1] і выражаецца ў долях шырыні выявы. Па змаўчанні 0,5.

cy

Адносная каардыната y фокуснай кропкі відарыса і, такім чынам, цэнтра скажэння. Гэта значэнне мае дыяпазон [0,1] і выражаецца ў долях вышыні выявы. Па змаўчанні 0,5.

k1

Каэфіцыент квадратычнага папраўчага члена. Гэта значэнне мае дыяпазон [-1,1]. 0 азначае адсутнасць выпраўлення. Па змаўчанні 0.

k2

Каэфіцыент двайнога квадратнага папраўчага члена. Гэта значэнне мае дыяпазон [-1,1]. 0 азначае адсутнасць выпраўлення. Па змаўчанні 0.

i

Усталюйце тып інтэрпаляцыі. Можа быць nearestабо bilinear. Па змаўчанні nearest.

fc

Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні black@0.

Формула, якая стварае карэкцыю:

r_src= r_tgt* (1 + k1* ( r_tgt/ r_0)^2 + k2* ( r_tgt/ r_0)^4)

дзе r_0- палова дыяганалі выявы, а r_srcі r_tgt- адлегласці ад фокуснай кропкі на зыходным і мэтавым малюнках адпаведна.

11.136.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.137 lensfun

Прымяніць карэкцыю аб'ектыва праз бібліятэку lensfun ( http://lensfun.sourceforge.net/ ).

Фільтр lensfunпатрабуе маркі камеры, мадэлі камеры і мадэлі аб'ектыва для прымянення карэкцыі аб'ектыва. Фільтр загрузіць базу дадзеных lensfun і запытае яе, каб знайсці адпаведныя запісы камеры і аб'ектыва ў базе дадзеных. Пакуль гэтыя запісы можна знайсці з зададзенымі опцыямі, фільтр можа выконваць выпраўленні кадраў. Звярніце ўвагу, што няпоўныя радкі прывядуць да таго, што фільтр выбярэ найбольшае супадзенне з зададзенымі опцыямі, і фільтр вывядзе выбраныя мадэлі камеры і аб'ектываў (рэгіструецца з узроўнем "інфармацыя"). Вы павінны ўказаць марку, мадэль камеры і мадэль аб'ектыва, калі яны неабходныя.

Каб атрымаць спіс даступных марак і мадэляў, прапусціце адзін або абодва варыянты makeі . modelФільтр адправіць поўны спіс у журнал з узроўнем INFO. Першы слупок - марка, а другі - мадэль. Каб атрымаць спіс даступных аб'ектываў, задайце любыя значэнні маркі і мадэлі і прапусціце lens_modelопцыю. Фільтр адправіць поўны спіс лінзаў у журнал з узроўнем INFO. Інструмент ffmpeg закрыецца пасля таго, як спіс будзе надрукаваны.

Фільтр прымае наступныя параметры:

make

Марка фотаапарата (напрыклад, «Canon»). Гэтая опцыя абавязковая.

model

Мадэль фотаапарата (напрыклад, «Canon EOS 100D»). Гэтая опцыя абавязковая.

lens_model

Мадэль аб'ектыва (напрыклад, "Canon EF-S 18-55mm f/3.5-5.6 IS STM"). Гэтая опцыя абавязковая.

db_path

Поўны шлях да папкі базы дадзеных аб'ектыва. Калі не ўстаноўлена, фільтр будзе спрабаваць загрузіць базу дадзеных са шляху ўстаноўкі, калі бібліятэка была створана. Па змаўчанні не ўстаноўлена.

mode

Тып карэкцыі для прымянення. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:

'vignetting'

Дазваляе фіксаваць віньеткаванне аб'ектыва.

'geometry'

Дазваляе фіксаваць геаметрыю лінзы. Гэта па змаўчанні.

'subpixel'

Дазваляе выправіць храматычныя аберацыі.

'vig_geo'

Дазваляе фіксаваць віньеткаванне і геаметрыю аб'ектыва.

'vig_subpixel'

Дазваляе фіксаваць віньеткаванне аб'ектыва і храматычныя аберацыі.

'distortion'

Дазваляе фіксаваць як геаметрыю лінзы, так і храматычныя аберацыі.

'all'

Уключае ўсе магчымыя выпраўленні.

focal_length

Фокусная адлегласць выявы/відэа (маштаб; чаканая канстанта для відэа). Напрыклад, аб'ектыў 18–55 мм мае дыяпазон фокусных адлегласцей [18–55], таму пры выкарыстанні гэтага аб'ектыва трэба выбіраць значэнне ў гэтым дыяпазоне. Па змаўчанні 18.

aperture

Дыяфрагма выявы/відэа (чаканая канстанта для відэа). Звярніце ўвагу, што дыяфрагма выкарыстоўваецца толькі для карэкцыі віньеткавання. Па змаўчанні 3.5.

focus_distance

Дыстанцыя фокусу відарыса/відэа (чаканая канстанта для відэа). Звярніце ўвагу, што фокусная адлегласць выкарыстоўваецца толькі для віньеткавання і толькі нязначна ўплывае на працэс карэкцыі віньеткавання. Калі невядома, пакіньце значэнне па змаўчанні (1000).

scale

Каэфіцыент маштабу, які прымяняецца пасля пераўтварэння. Пасля выпраўлення відэа больш не абавязкова будзе прамавугольным. Гэты параметр кантралюе, наколькі бачная частка атрыманага малюнка. Значэнне 0 азначае, што значэнне будзе выбірацца аўтаматычна, так што на выходным малюнку будзе мала або зусім няма неадлюстраванай вобласці. 1.0 азначае, што дадатковае маштабаванне не праводзіцца. Ніжэйшыя значэнні могуць прывесці да таго, што будзе бачная большая частка выпраўленага відарыса, у той час як больш высокія значэнні могуць пазбегнуць неадлюстраваных абласцей у вывадзе.

target_geometry

Мэтавая геаметрыя выхаднога відарыса/відэа. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:

'rectilinear (default)'
'fisheye'
'panoramic'
'equirectangular'
'fisheye_orthographic'
'fisheye_stereographic'
'fisheye_equisolid'
'fisheye_thoby'
reverse

Прымяніце зваротную карэкцыю выявы (замест карэкцыі скажэнняў прымяніце яе).

interpolation

Тып інтэрпаляцыі, які выкарыстоўваецца пры выпраўленні скажэнняў. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:

'nearest'
'linear (default)'
'lanczos'

11.137.1 Examples

  • Ужывайце карэкцыю аб'ектыва маркі "Canon", мадэлі камеры "Canon EOS 100D" і мадэлі аб'ектыва "Canon EF-S 18-55mm f/3.5-5.6 IS STM" з фокуснай адлегласцю "18" і дыяфрагмай "8.0".
    ffmpeg -i input.mov -vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF-S 18-55mm f/3.5-5.6 IS STM":focal_length=18:aperture=8 -c:v h264 -b:v 8000k output.mov
    
  • Ужывайце тое ж самае, што і раней, але толькі на першыя 5 секунд відэа.
    ffmpeg -i input.mov -vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF-S 18-55mm f/3.5-5.6 IS STM":focal_length=18:aperture=8:enable='lte(t\,5)' -c:v h264 -b:v 8000k output.mov
    

11.138 libplacebo

Гнуткі фільтр апрацоўкі з паскораным GPU на аснове libplacebo ( https://code.videolan.org/videolan/libplacebo ). Звярніце ўвагу, што гэты фільтр зараз прымае толькі ўваходныя кадры Vulkan.

11.138.1 Options

Параметры гэтага фільтра падзелены на наступныя раздзелы:

11.138.1.1 Output mode

Гэтыя параметры кантралююць агульны рэжым вываду. Па змаўчанні libplacebo паспрабуе як мага лепш захаваць каларыметрыю і памер крыніцы, але пры гэтым будзе прымяняцца любая ўбудаваная зярністасць плёнкі, метаданыя Dolby Vision або анаморфны SAR, прысутныя ў зыходных кадрах.

w
h

Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.

Дазваляе тыя ж выразы, што і маштабны фільтр.

format

Усталюйце перавызначэнне фармату вываду. Калі не ўстаноўлена (па змаўчанні), кадры будуць выводзіцца ў тым жа фармаце, што і адпаведныя ўваходныя кадры. У адваротным выпадку будзе выканана пераўтварэнне фармату.

force_original_aspect_ratio
force_divisible_by

Працуюць гэтак жа, як і ідэнтычныя варыянты маштабнага фільтра.

normalize_sar

Калі ўключана (па змаўчанні), выхадныя кадры заўсёды будуць мець суадносіны бакоў пікселяў 1:1. Калі адключана, любыя неадпаведнасці прапорцый, у тым ліку з анаморфных відэакрыніц, перадаюцца ў выхадныя суадносіны бакоў пікселяў.

pad_crop_ratio

Задае суадносіны (паміж 0.0і 1.0) паміж запаўненнем і кадраваннем, калі суадносіны бакоў уводу не супадаюць з суадносінамі бакоў вываду і normalize_sarдзейнічае. Значэнне па змаўчанні 0.0заўсёды запаўняе змесціва чорнымі рамкамі, а значэнне 1.0заўсёды абразае часткі змесціва. Магчымыя прамежкавыя значэнні, якія прыводзяць да спалучэння двух падыходаў.

colorspace
color_primaries
color_trc
range

Наладзьце каляровую прастору, у якой будуць дастаўляцца выходныя кадры. Значэнне па змаўчанні autoвыводзіць кадры ў тым жа фармаце, што і ўваходныя кадры, што не прыводзіць да зменаў. Для любога іншага значэння будзе выканана пераўтварэнне.

Спіс магчымых значэнняў глядзіце ў фільтры setparams .

apply_filmgrain

Прымяніце зярністасць плёнкі (напрыклад, AV1 або H.274), калі яна ёсць у зыходных кадрах, і выдаліце ​​яе з выхаду. Уключана па змаўчанні.

apply_dolbyvision

Прымяніць метаданыя Dolby Vision RPU, калі яны ёсць у зыходных кадрах, і выдаліць іх з вываду. Уключана па змаўчанні. Звярніце ўвагу, што Dolby Vision заўсёды будзе выдаваць BT.2020+PQ, адмяняючы звычайныя метаданыя ўваходнага кадра. Яны таксама будуць выбраны ў якасці значэнняў autoдля адпаведных параметраў вываду кадраў.

11.138.1.2 Scaling

Параметры ў гэтым раздзеле кантралююць, як libplacebo выконвае павелічэнне і (пры неабходнасці) памяншэнне маштабу. Звярніце ўвагу, што libplacebo заўсёды будзе ўнутрана працаваць са змесцівам 4:4:4, таму любыя фарматы каляровасці yuv420pз субвыбаркай, такія як, абавязкова будуць павышацца і зніжацца як частка працэсу рэндэрынгу. Гэта азначае, што маштабаванне можа дзейнічаць, нават калі дазвол крыніцы і прызначэння аднолькавы.

upscaler
downscaler

Наладзьце ядро ​​фільтра, якое выкарыстоўваецца для павелічэння і памяншэння маштабу. Адпаведныя значэнні па змаўчанні spline36і mitchell. Каб атрымаць поўны спіс магчымых значэнняў, перайдзіце helpда гэтых параметраў. Найбольш важныя каштоўнасці:

'none'

Прымушае выкарыстоўваць убудаваную выбарку тэкстур GPU (звычайна білінейную). Надзвычай хутка, але нізкай якасці, асабліва пры памяншэнні маштабу.

'bilinear'

Білінейная інтэрпаляцыя. Як правіла, гэта можа быць зроблена бясплатна на графічных працэсарах, за выключэннем выпадкаў, калі гэта прывядзе да псеўданімаў. Хутка і нізкаякасная.

'nearest'

Інтэрпаляцыя бліжэйшага суседа. Рэзкае, але вельмі згладжанае.

'oversample'

Алгарытм, які візуальна падобны на інтэрпаляцыю бліжэйшага суседа, але спрабуе захаваць суадносіны бакоў пікселяў. Добра падыходзіць для піксельнага мастацтва, бо яно прыводзіць да мінімальнага скажэння мастацкага выгляду.

'lanczos'

Стандартнае ядро ​​інтэрпаляцыі sinc-sinc.

'spline36'

Кубічны сплайн-апраксімацыя Ланцоса. Няма розніцы ў прадукцыйнасці, але звон крыху меншы.

'ewa_lanczos'

Эліптычна ўзважаная сярэдняя версія lanczos, заснаваная на ядры jinc-sinc. Гэта таксама ў народзе называюць проста "маштабаванне Jinc". Павольна, але вельмі якасна.

'gaussian'

Ядро Гаўса. Мае пэўныя ідэальныя матэматычныя ўласцівасці, але суб'ектыўна вельмі размытыя.

'mitchell'

Кубічны сплайн BC з параметрамі, рэкамендаванымі Мітчэлам і Нетравалі. Вельмі мала звоніць.

lut_entries

Канфігуруе памер LUT маштабавальніка ў дыяпазоне ад 1да 256. Значэнне па змаўчанні 0выбірае ўнутранае значэнне па змаўчанні libplacebo, звычайна 64.

antiringing

Уключае антызванок (для фільтраў, якія не ўваходзяць у EWA). Значэнне (паміж 0.0і 1.0) канфігуруе сілу алгарытму прадухілення выкліку. Можа павялічыць псеўданім, калі зададзена занадта высока. Па змаўчанні адключана.

sigmoid

Уключыць сігмаідальнае сціск падчас маштабавання. Трохі памяншае звон. Уключана па змаўчанні.

11.138.1.3 Debanding

Libplacebo пастаўляецца з убудаваным фільтрам дэбандавання, які добра супрацьстаіць шматлікім распаўсюджаным крыніцам палос і блакіровак. Настойліва рэкамендуецца ўключаць гэта, калі патрэбна якасць.

deband

Уключыць (хуткі) алгарытм дэбандыравання. Па змаўчанні адключана.

deband_iterations

Колькасць ітэрацый дэбандавання алгарытму дэбандавання. Кожная ітэрацыя выконваецца з паступовым павелічэннем радыусу (і паніжаным парогам). Рэкамендуемыя значэнні знаходзяцца ў дыяпазоне 1да 4. Па змаўчанні 1.

deband_threshold

Зніжэнне трываласці фільтра. Больш высокія лічбы прыводзяць да больш агрэсіўнага дэбандавання. Па змаўчанні 4.0.

deband_radius

Радыус дэбандызацыйнага фільтра. Большы радыус лепш для павольных градыентаў, у той час як меншы радыус лепш для крутых градыентаў. Па змаўчанні 16.0.

deband_grain

Колькасць дадатковага выходнага збожжа, якое трэба дадаць. Дапамагае схаваць недахопы. Па змаўчанні 6.0.

11.138.1.4 Color adjustment

Калекцыя суб'ектыўных элементаў кіравання колерам. Не вельмі строгі, таму дакладны эфект будзе некалькі адрознівацца ў залежнасці ад праймерыз уводу і каляровай прасторы.

brightness

Павышэнне яркасці паміж -1.0і 1.0. Па змаўчанні 0.0.

contrast

Узмацненне кантрасту паміж 0.0і 16.0. Па змаўчанні 1.0.

saturation

Узмацненне насычанасці, паміж 0.0і 16.0. Па змаўчанні 1.0.

hue

Зрух адцення ў радыянах паміж -3.14і 3.14. Па змаўчанні 0.0. Гэта паверне УФ-субвектар з каэфіцыентамі па змаўчанні BT.709 для ўваходных сігналаў RGB.

gamma

Гама-рэгуляванне паміж 0.0і 16.0. Па змаўчанні 1.0.

cones

Мадэль конусу для мадэлявання дальтанізму. Прымае любую камбінацыю l, mі s. Вось некалькі прыкладаў:

'm'

Дэйтэранамалія / дэйтэранапія (закранае 3%-4% насельніцтва)

'l'

Пратанамалія / пратанапія (закранае 1%-2% насельніцтва)

'l+m'

Манахраматыя (вельмі рэдка)

'l+m+s'

Ахраматапсія (поўная страта дзённага гледжання, вельмі рэдка)

cone-strength

Каэфіцыент узмацнення для конусаў cones, вызначаных паміж 0.0і 10.0. Значэнне не 1.0прыводзіць да змены каляровага зроку. Значэнне 0.0(па змаўчанні) імітуе поўную страту гэтых конусаў. Прыведзеныя вышэй значэнні 1.0прыводзяць да перабольшвання адрозненняў паміж колбачкамі, што можа дапамагчы кампенсаваць пагаршэнне каляровага зроку.

11.138.1.5 Peak detection

Каб дапамагчы мець справу з крыніцамі, якія маюць толькі статычныя метаданыя HDR10 (ці наогул не маюць тэгаў), libplacebo выкарыстоўвае ўласны ўнутраны вылічальны шэйдар аналізу кадраў для аналізу зыходных кадраў і адаптацыі функцыі адлюстравання тонаў у рэальным часе. Калі гэта адбываецца занадта павольна, або калі неабходны дакладна ўзнаўляемы ідэальны вынік кадра, рэкамендуецца адключыць гэту функцыю.

peak_detect

Уключыць выяўленне піка HDR. Ігнаруе статычныя значэнні MaxCLL/MaxFALL на карысць дынамічнага выяўлення з уводу. Звярніце ўвагу, што выяўленыя значэнні не запісваюцца ў выходныя кадры, яны проста кіруюць працэсам унутранага тонавага адлюстравання. Уключана па змаўчанні.

smoothing_period

Перыяд згладжвання выяўлення піка, паміж 0.0і 1000.0. Больш высокія значэнні прыводзяць да таго, што выяўленне пікаў становіцца менш рэагуючым на змены ўваходных дадзеных. Па змаўчанні 100.0.

minimum_peak

Ніжняя мяжа выяўленага піка (адносна SDR белага), паміж 0.0 і 100.0. Па змаўчанні 1.0.

scene_threshold_low
scene_threshold_high

Ніжні і верхні парогі для выяўлення змены сцэны. Выражаецца ў лагарыфмічнай шкале паміж 0.0і 100.0. Па змаўчанні 5.5 і 10.0адпаведна. Адмоўнае значэнне адключае гэтую функцыю.

overshoot

Маржа перавышэння пікавага згладжвання паміж 0.0і 1.0. Забяспечвае запас трываласці для прадухілення абразання ў выніку згладжвання пікаў. Па змаўчанні - 0.05, што адпавядае маржы 5%.

11.138.1.6 Tone mapping

Параметры ў гэтым раздзеле кантралююць, як libplacebo выконвае танальнае адлюстраванне і адлюстраванне гамы пры працы з неадпаведнасцю паміж змесцівам з шырокай гамай і HDR. Увогуле, libplacebo абапіраецца на дакладнае пазначэнне крыніцы і засваенне інфармацыі аб гаме дысплея для атрымання найлепшых вынікаў.

intent

Намер візуалізацыі для выкарыстання пры адаптацыі паміж рознымі асноўнымі каляровымі гамамі (пасля танальнага адлюстравання).

'perceptual'

Адлюстраванне перцэпцыйнай гамы. У цяперашні час эквівалентна адноснай каларыметрыі.

'relative'

Адносная каларыметрыя. Гэта па змаўчанні.

'absolute'

Абсалютная каларыметрыя.

'saturation'

Адлюстраванне насычанасці. Прымусова расцягвае зыходную гаму да мэтавай.

gamut_mode

Як апрацоўваць колеры па-за гамай, якія могуць узнікнуць у выніку каларыметрычнага адлюстравання гамы.

'clip'

Нічога не рабіце, проста абразайце колеры, якія не ўваходзяць у дыяпазон, у аб'ём RGB. Гэта па змаўчанні.

'warn'

Вылучыце пікселі, якія не ўваходзяць у гаму (афарбаваўшы іх у ружовы колер).

'darken'

Лінейна зніжае яркасць змесціва да захавання насычаных дэталяў з наступным выразаннем астатніх колераў, якія не ўваходзяць у гаму. Як вынікае з назвы, гэта робіць усё цямней, але забяспечвае добры баланс паміж захаваннем дэталяў і колераў.

'desaturate'

Жорстка абясцэньвае колеры па-за гамай да белага, захоўваючы пры гэтым яркасць. Мае схільнасць да змены колеру.

tonemapping

Алгарытм танальнага адлюстравання для выкарыстання. Даступныя значэнні:

'auto'

Аўтаматычны выбар на аснове ўнутранай эўрыстыкі. Гэта па змаўчанні.

'clip'

Не выконвае танальнага адлюстравання, проста выразае колеры па-за дыяпазонам. Захоўвае ідэальную дакладнасць колеру для колераў у дыяпазоне, але цалкам знішчае інфармацыю па-за дыяпазонам. Адаптацыя чорнай кропкі не выконваецца. Не наладжваецца.

'bt.2390'

EETF са справаздачы ITU-R BT.2390, сплайн-згортка Эрміта з лінейным сегментам. Зрушэнне кропкі калена наладжваецца. Звярніце ўвагу, што гэты параметр па змаўчанні 1.0, а не значэнне 0.5са спецыфікацыі ITU-R.

'bt.2446a'

EETF са справаздачы ITU-R BT.2446, метад A. Прызначаны для добра асвоеных крыніц HDR. Можа выкарыстоўвацца як для прамога, так і для зваротнага адлюстравання тонаў. Не наладжваецца.

'spline'

Просты сплайн, які складаецца з двух шматчленаў, злучаных адной кропкай павароту. Параметр дае кропку павароту (у прасторы PQ), па змаўчанні 0.30. Можа выкарыстоўвацца як для прамога, так і для зваротнага адлюстравання тонаў.

'reinhard'

Просты нелінейны глабальны алгарытм адлюстравання тонаў. Параметр вызначае лакальны каэфіцыент кантраснасці на піку дысплея. Па сутнасці, параметр 0.5азначае, што эталонны белы колер будзе прыкладна ўдвая менш яркім, чым пры абразанні. Па змаўчанні 0.5, што прыводзіць да самай простай фармулёўкі гэтай функцыі.

'mobius'

Абагульненне алгарытму адлюстравання тонаў Рэйнхарда для падтрымкі дадатковага лінейнага нахілу каля чорнага. Параметр танальнага адлюстравання паказвае кампраміс паміж лінейным і нелінейным участкамі. Па сутнасці, для дадзенага параметра xкожнае значэнне колеру ніжэй xбудзе адлюстроўвацца лінейна, у той час як больш высокія значэнні будуць адлюстроўвацца нелінейна. Значэнні каля 1.0прымушаюць гэтую крывую паводзіць сябе як clip, а значэнні каля 0.0прымушаюць гэтую крывую паводзіць сябе як reinhard. Значэнне па змаўчанні роўна 0.3, што забяспечвае добры баланс паміж каларыметрычнай дакладнасцю і захаваннем дэталяў па-за гамай.

'hable'

Алгарытм адлюстравання тонаў у плёнцы, распрацаваны Джонам Хэйблам для выкарыстання ў Uncharted 2, натхнёны падобным алгарытмам адлюстравання тонаў, які выкарыстоўваецца Kodak. Папулярызаваны дзякуючы выкарыстанню ў відэагульнях з HDR-рэндэрынгам. Вельмі добра захоўвае як цёмныя, так і яркія дэталі, але мае недахоп даволі значнага змены сярэдняй яркасці. Гэта падобна на reinhardпараметр with 0.24.

'gamma'

Адпавядае гама-функцыі (магутнасці) для перадачы паміж зыходнай і мэтавай каляровымі прасторамі, што фактычна прыводзіць да перцэпцыйнага цвёрдага калена, якое злучае дзве прыблізна лінейныя секцыі. Гэта захоўвае дэталі ва ўсіх маштабах даволі дакладна, але можа прывесці да выявы з прыглушаным або сумным выглядам. Параметр выкарыстоўваецца як кропка адсячэння, па змаўчанні - 0.5.

'linear'

Лінейна расцягвае ўваходны дыяпазон да выхаднога ў прасторы PQ. Гэта дакладна захавае ўсе дэталі, але прывядзе да значна іншай сярэдняй яркасці. Можа выкарыстоўвацца для адваротнага танальнага адлюстравання ў дадатак да звычайнага танальнага адлюстравання. Параметр можа выкарыстоўвацца як дадатковы лінейны каэфіцыент узмацнення (па змаўчанні 1.0).

tonemapping_param

Для наладжвальных функцый танальнага адлюстравання гэты параметр можна выкарыстоўваць для тонкай налады паводзін крывой. Звярніцеся да дакументацыі tonemapping. Значэнне па змаўчанні 0.0замяняецца пераважнай наладай крывой па змаўчанні.

tonemapping_mode

Гэты параметр вызначае, як функцыя танальнага адлюстравання, зададзеная tonemappingпараметрам, прымяняецца да колераў у сцэне. Магчымыя значэнні:

'auto'

Аўтаматычны выбар на аснове ўнутранай эўрыстыкі. Гэта па змаўчанні.

'rgb'

Прымяніць функцыю для кожнага канала ў каляровай прасторы RGB. Паканальнае адлюстраванне тонаў у RGB. Гарантуе адсутнасць абразання і моцна абясцэньвае выхад, але даволі значна скажае колеры. Вельмі падобны на «галівудскі» выгляд і адчуванне.

'max'

Тональнае адлюстраванне выконваецца на самым яркім кампаненце сігналу. Добра захоўвае дэталі ў бліках, але мае тэндэнцыю здушваць чорныя.

'hybrid'

Карта тонаў на канал для блікаў і лінейна (на аснове яркасці) для паўтонаў/ценяў на аснове фіксаванай 2.4крывой каэфіцыента гама.

'luma'

Лінейна складайце танальную карту па кампаненту яркасці (CIE Y) і адрэгулюйце (паменшыце насычанасць) каляровасць для кампенсацыі з дапамогай простага пастаяннага каэфіцыента. Па сутнасці, гэта рэжым, які выкарыстоўваецца ў метадзе A ITU-R BT.2446.

inverse_tonemapping

Калі гэты фільтр уключаны, ён таксама будзе спрабаваць расцягнуць сігналы SDR, каб запоўніць аб'ёмы выхаднога колеру HDR. Па змаўчанні адключана.

tonemapping_crosstalk

Дадатковы каэфіцыент перакрыжаваных перашкод, паміж 0.0і 0.3. Гэта можа дапамагчы паменшыць праблемы тонавай карты некаторых яркіх спектральных колераў. Па змаўчанні 0.04.

tonemapping_lut_size

Памер LUT танальнага адлюстравання паміж 2і 1024. Па змаўчанні 256. Звярніце ўвагу, што гэты паказчык узведзены ў квадрат у спалучэнні з peak_detect.

11.138.1.7 Dithering

Па змаўчанні, libplacebo будзе вагацца кожны раз, калі гэта неабходна, што ўключае рэндэрынг у любы цэлы фармат з дакладнасцю ніжэй за 16 біт. Рэкамендуецца заўсёды пакідаць гэта ўключаным, таму што ў адваротным выпадку на вывадзе могуць з'явіцца бачныя палосы, нават калі debandingфільтр уключаны. Калі патрабуецца максімальная прадукцыйнасць, выкарыстоўвайце ordered_fixedзамест адключэння мітусня.

dithering

Выкарыстоўваць метад дызерінга. Прымае наступныя значэнні:

'none'

Цалкам адключае згладжванне. Можа прывесці да бачных палос.

'blue'

Дызер з псеўда-сінім шумам. Гэта па змаўчанні.

'ordered'

Наладжвальны ўпарадкаваны шаблон дрыгання.

'ordered_fixed'

Больш хуткае ўпарадкаванае дрыжанне з фіксаваным памерам 6. Без тэкстур.

'white'

Дызер з белым шумам. Без тэкстур.

dither_lut_size

Памер LUT Dither, як log base2 паміж 1і 8. Па змаўчанні 6, што адпавядае памеру LUT 64x64.

dither_temporal

Уключае часовае змятанне. Па змаўчанні адключана.

11.138.1.8 Custom shaders

libplacebo падтрымлівае шэраг карыстальніцкіх шэйдараў, заснаваных на сінтаксісе mpv .hook GLSL. Калекцыю такіх шэйдараў можна знайсці тут: https://github.com/mpv-player/mpv/wiki/User-Scripts#user-shaders

Поўнае апісанне фармату шэйдара mpv выходзіць за рамкі гэтага раздзела, але зводку можна знайсці тут: https://mpv.io/manual/master/#options-glsl-shader

custom_shader_path

Вызначае шлях да карыстацкага файла шэйдара для загрузкі падчас выканання.

custom_shader_bin

Вызначае поўны карыстальніцкі шэйдар у выглядзе неапрацаванага радка.

11.138.1.9 Debugging / performance

Усе параметры ў гэтым раздзеле па змаўчанні выключаны. Яны могуць быць карыснымі пры спробе выціснуць максімальную прадукцыйнасць за кошт якасці.

skip_aa

Адключыць згладжванне пры памяншэнні маштабу.

polar_cutoff

Усечаныя палярныя (EWA) ядра скалера ніжэй гэтай абсалютнай велічыні, паміж 0.0і 1.0.

disable_linear

Адключыць лінейнае маштабаванне святла.

disable_builtin

Адключыць убудаваную выбарку GPU (прымусіць LUT).

force_icc_lut

Прымусовае выкарыстанне поўнага ICC 3DLUT для адлюстравання гамы.

disable_fbos

Прымусовае адключэнне FBO, што прывядзе да страты амаль усіх функцый, але прапануе максімальна магчымую хуткасць.

11.138.2 Commands

Гэты фільтр падтрымлівае практычна ўсе вышэйпералічаныя параметры ў якасці каманд .

11.138.3 Examples

  • Поўны прыклад таго, як ініцыялізаваць прыладу Vulkan, загрузіць кадры ў графічны працэсар, выканаць пераўтварэнне фільтра ў yuv420p і загрузіць кадры назад у працэсар для вываду. Звярніце ўвагу, што ў пэўных выпадках вы можаце абыйсці неабходнасць выканання пераўтварэння фармату, указаўшы правільны formatпараметр фільтра, які адпавядае ўваходным кадрам.
    ffmpeg -i $INPUT -init_hw_device vulkan -vf hwupload,libplacebo=format=yuv420p,hwdownload,format=yuv420p $OUTPUT
    
  • Уваход танальнай карты на выхад стандартнай гамы BT.709:
    libplacebo=colorspace=bt709:color_primaries=bt709:color_trc=bt709:range=tv
    
  • Змяніце маштаб уводу, каб ён адпавядаў стандарту 1080p, з высокай якасцю маштабавання:
    libplacebo=w=1920:h=1080:force_original_aspect_ratio=decrease:normalize_sar=true:upscaler=ewa_lanczos:downscaler=ewa_lanczos
    
  • Пераўтварэнне ўводу ў стандартны sRGB JPEG:
    libplacebo=format=yuv420p:colorspace=bt470bg:color_primaries=bt709:color_trc=iec61966-2-1:range=pc
    
  • Выкарыстоўвайце налады адмены больш высокай якасці:
    libplacebo=deband=true:deband_iterations=3:deband_radius=8:deband_threshold=6
    
  • Запусціце гэты фільтр на працэсары ў сістэмах з усталяванай Mesa (і з адключанымі самымі дарагімі опцыямі):
    ffmpeg ... -init_hw_device vulkan:llvmpipe ... -vf libplacebo=upscaler=none:downscaler=none:peak_detect=false
    
  • Адмоўцеся ад прымянення зерністасці фільма AV1/H.274 на базе працэсара ў дэкодэры, замест таго, каб рабіць гэта з дапамогай гэтага фільтра. Звярніце ўвагу, што гэта выгада толькі ў тым выпадку, калі кадры ўжо знаходзяцца на графічным працэсары, або калі вы выкарыстоўваеце libplacebo для іншых мэтаў, бо ў адваротным выпадку вяртанне VRAM будзе з лішкам кампенсаваць чаканае паскарэнне.
    ffmpeg -export_side_data +film_grain ... -vf libplacebo=apply_filmgrain=true
    

11.139 libvmaf

Вылічыце ацэнку VMAF (Video Multi-Method Assessment Fusion) для эталоннай/скажонай пары ўваходных відэа.

Першы ўваход - гэта скажонае відэа, а другі - эталоннае відэа.

Атрыманая адзнака VMAF раздрукоўваецца з дапамогай сістэмы рэгістрацыі.

У якасці папярэдняй умовы патрабуецца бібліятэка Netflix vmaf (libvmaf). Пасля ўстаноўкі бібліятэкі яе можна ўключыць з дапамогай: ./configure --enable-libvmaf.

Фільтр мае наступныя параметры:

model

'|' абмежаваны спіс мадэляў vmaf. Кожную мадэль можна наладзіць па шэрагу параметраў. Значэнне па змаўчанні:"version=vmaf_v0.6.1"

model_path

Састарэла, выкарыстоўвайце model='path=...'.

enable_transform

Састарэла, выкарыстоўвайце model='enable_transform=true'.

phone_model

Састарэла, выкарыстоўвайце model='enable_transform=true'.

enable_conf_interval

Састарэла, выкарыстоўвайце model='enable_conf_interval=true'.

feature

'|' абмежаваны спіс функцый. Кожную функцыю можна наладзіць з дапамогай шэрагу параметраў.

psnr

Састарэла, выкарыстоўвайце feature='name=psnr'.

ssim

Састарэла, выкарыстоўвайце feature='name=ssim'.

ms_ssim

Састарэла, выкарыстоўвайце feature='name=ms_ssim'.

log_path

Усталюйце шлях да файла, які будзе выкарыстоўвацца для захоўвання файлаў часопісаў.

log_fmt

Усталюйце фармат файла часопіса (xml, json, csv або sub).

n_threads

Задаць колькасць патокаў, якія будуць выкарыстоўвацца пры ініцыялізацыі libvmaf. Значэнне па змаўчанні: 0, без патокаў.

n_subsample

Усталюйце інтэрвал падвыбаркі кадраў, які будзе выкарыстоўвацца.

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

11.139.1 Examples

  • У прыведзеных ніжэй прыкладах скажонае відэаdistorted.mpgпараўноўваецца з эталонным файламreference.mpg.
  • Асноўнае выкарыстанне:
    ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf=log_path=output.xml -f null -
    
  • Прыклад з некалькімі мадэлямі:
    ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf='model=version=vmaf_v0.6.1\\:name=vmaf|version=vmaf_v0.6.1neg\\:name=vmaf_neg' -f null -
    
  • Прыклад з некалькімі дадатковымі функцыямі:
    ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf='feature=name=psnr|name=ciede' -f null -
    
  • Прыклад з опцыямі і рознымі кантэйнерамі:
    ffmpeg -i distorted.mpg -i reference.mkv -lavfi "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]libvmaf=log_fmt=json:log_path=output.json" -f null -
    

11.140 limitdiff

Прымяніць фільтр з абмежаванай розніцай, выкарыстоўваючы другі і, магчыма, трэці відэаструмень.

Фільтр прымае наступныя параметры:

threshold

Усталюйце парог, які будзе выкарыстоўвацца пры дазволе пэўных адрозненняў паміж відэапатокамі. Любое значэнне абсалютнай розніцы, ніжэйшае або дакладнае за гэты парог, будзе выбіраць піксельныя кампаненты з першага відэапатоку.

elasticity

Усталюйце эластычнасць мяккага парога пры апрацоўцы відэапатокаў. Гэта значэнне, памножанае на першае, усталёўвае другі парог. Любое значэнне абсалютнай розніцы, большае або дакладнае за другі парог, будзе выбіраць піксельныя кампаненты з другога відэапатоку. Для значэнняў паміж гэтымі двума парогавымі значэннямі будзе выкарыстоўвацца лінейная інтэрпаляцыя паміж першым і другім відэапатокам.

reference

Уключыць апрацоўку эталоннага (трэцяга) відэаструменю. Па змаўчанні адключана. Калі ўсталявана, гэтая відэаплынь будзе выкарыстоўвацца для вылічэння абсалютнай розніцы з першай відэаплынню.

planes

Укажыце, якія плоскасці будуць апрацоўвацца. Па змаўчанні ўсе даступныя.

11.140.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя опцыі 'reference'.

11.141 limiter

Абмяжоўвае значэнні кампанентаў пікселя ўказаным дыяпазонам [мін., макс.].

Фільтр прымае наступныя параметры:

min

Ніжняя мяжа. Па змаўчанні ўстаноўлена самае нізкае дазволенае значэнне для ўводу.

max

Верхняя мяжа. Па змаўчанні ўстаноўлена максімальнае дазволенае значэнне для ўводу.

planes

Укажыце, якія плоскасці будуць апрацоўвацца. Па змаўчанні ўсе даступныя.

11.141.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.142 loop

Колькасць відэа кадраў.

Фільтр прымае наступныя параметры:

loop

Усталюйце колькасць завес. Усталяванне гэтага значэння ў -1 прывядзе да бясконцых цыклаў. Па змаўчанні 0.

size

Усталюйце максімальны памер у колькасці кадраў. Па змаўчанні 0.

start

Усталюйце першы кадр цыкла. Па змаўчанні 0.

11.142.1 Examples

  • Бясконцы цыкл аднаго першага кадра:
    loop=loop=-1:size=1:start=0
    
  • Паўтор адзінага першага кадра 10 разоў:
    loop=loop=10:size=1:start=0
    
  • Пракруціце 10 першых кадраў 5 разоў:
    loop=loop=5:size=10:start=0
    

11.143 lut1d

Прымяніць 1D LUT да ўваходнага відэа.

Фільтр прымае наступныя параметры:

file

Усталюйце назву файла 1D LUT.

У цяперашні час падтрымліваюцца фарматы:

'cube'

Ірыды

'csp'

кінапрастора

interp

Выберыце рэжым інтэрпаляцыі.

Даступныя значэнні:

'nearest'

Выкарыстоўвайце значэнні з бліжэйшай вызначанай кропкі.

'linear'

Інтэрпаляваць значэнні з дапамогай лінейнай інтэрпаляцыі.

'cosine'

Інтэрпаляваць значэнні з дапамогай косінуснай інтэрпаляцыі.

'cubic'

Інтэрпаляваць значэнні з дапамогай кубічнай інтэрпаляцыі.

'spline'

Інтэрпаляваць значэнні з дапамогай сплайн-інтэрпаляцыі.

11.143.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.144 lut3d

Прымяніць 3D LUT да ўваходнага відэа.

Фільтр прымае наступныя параметры:

file

Усталюйце назву файла 3D LUT.

У цяперашні час падтрымліваюцца фарматы:

'3dl'

AfterEffects

'cube'

Ірыды

'dat'

ДаВінчы

'm3d'

Пандора

'csp'

кінапрастора

interp

Выберыце рэжым інтэрпаляцыі.

Даступныя значэнні:

'nearest'

Выкарыстоўвайце значэнні з бліжэйшай вызначанай кропкі.

'trilinear'

Інтэрпалюйце значэнні, выкарыстоўваючы 8 кропак, якія вызначаюць куб.

'tetrahedral'

Інтэрпаляваць значэнні з дапамогай тэтраэдра.

'pyramid'

Інтэрпаляваць значэнні з дапамогай піраміды.

'prism'

Інтэрпаляваць значэнні з дапамогай прызмы.

11.144.1 Commands

Гэты фільтр падтрымлівае interpпараметр як каманды .

11.145 lumakey

Ператварыце пэўныя значэнні яркасці ў празрыстыя.

Фільтр прымае наступныя параметры:

threshold

Усталюйце яркасць, якая будзе выкарыстоўвацца ў якасці асновы для празрыстасці. Значэнне па змаўчанні - 0.

tolerance

Усталюйце дыяпазон значэнняў яркасці, якія трэба выключыць. Значэнне па змаўчанні - 0.01.

softness

Усталюйце дыяпазон мяккасці. Значэнне па змаўчанні - 0. Выкарыстоўвайце гэта, каб кіраваць паступовым пераходам ад нуля да поўнай празрыстасці.

11.145.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.146 lut, lutrgb, lutyuv

Вылічыце пошукавую табліцу для прывязкі ўваходнага значэння кожнага кампанента пікселя да выхаднога значэння і прымяніце яе да ўваходнага відэа.

lutyuvпрымяняе табліцу пошуку да ўваходнага відэа YUV, lutrgb да ўваходнага відэа RGB.

Гэтыя фільтры прымаюць наступныя параметры:

c0

усталяваць выраз першага кампанента пікселя

c1

усталяваць выраз кампанента другога пікселя

c2

ўсталяваць выраз кампанента трэцяга пікселя

c3

усталяваць выраз чацвёртага піксельнага кампанента, які адпавядае альфа-кампаненту

r

усталяваць выраз чырвонага кампанента

g

усталяваць выраз зялёнага кампанента

b

усталяваць выраз сіняга кампанента

a

альфа-кампанентны выраз

y

усталяваць Y/выраз кампанента яркасці

u

усталяваць выраз кампанента U/Cb

v

усталяваць складнік V/Cr

Кожны з іх вызначае выраз, які выкарыстоўваецца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.

Дакладны кампанент, звязаны з кожным з параметраў c*, залежыць ад фармату ўводу.

Фільтр lutпатрабуе піксельных фарматаў YUV або RGB на ўваходзе, lutrgbпіксельных фарматаў RGB на ўваходзе і lutyuvYUV.

Выразы могуць утрымліваць наступныя канстанты і функцыі:

w
h

Шырыня і вышыня ўводу.

val

Уваходнае значэнне для піксельнага кампанента.

clipval

Уваходнае значэнне, абрэзанае ў дыяпазоне minval- maxval.

maxval

Максімальнае значэнне піксельнага кампанента.

minval

Мінімальнае значэнне піксельнага кампанента.

negval

Адмоўленае значэнне піксельнага кампанента, абрэзанае ў дыяпазоне minval- maxval; гэта адпавядае выразу "maxval-clipval+minval".

clip(val)

Вылічанае значэнне ў val, абрэзанае ў дыяпазоне minval- maxval.

gammaval(gamma)

Вылічанае значэнне гама-карэкцыі значэння кампанента пікселя, абрэзанае ў дыяпазоне minval- maxval. Гэта адпавядае выразу "pow((clipval-minval)/(maxval-minval)\, gamma)*(maxval-minval)+minval"

Усе выразы па змаўчанні маюць "clipval".

11.146.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.146.2 Examples

  • Адхіліць уваходнае відэа:
    lutrgb="r=maxval+minval-val:g=maxval+minval-val:b=maxval+minval-val"
    lutyuv="y=maxval+minval-val:u=maxval+minval-val:v=maxval+minval-val"
    

    Вышэй тое самае, што:

    lutrgb="r=negval:g=negval:b=negval"
    lutyuv="y=negval:u=negval:v=negval"
    
  • Адмоўная яркасць:
    lutyuv=y=negval
    
  • Выдаліце ​​кампаненты каляровасці, ператварыўшы відэа ў шэры малюнак:
    lutyuv="u=128:v=128"
    
  • Прымяніць эфект гарэння люма:
    lutyuv="y=2*val"
    
  • Выдаліце ​​зялёны і сіні кампаненты:
    lutrgb="g=0:b=0"
    
  • Усталюйце пастаяннае значэнне альфа-канала на ўваходзе:
    format=rgba,lutrgb=a="maxval-minval/2"
    
  • Правільная гама яркасці з каэфіцыентам 0,5:
    lutyuv=y=gammaval(0.5)
    
  • Адкіньце малодшыя біты яркасці:
    lutyuv=y='bitand(val, 128+64+32)'
    
  • Тэхнічны каляровы эфект:
    lutyuv=u='(val-maxval/2)*2+maxval/2':v='(val-maxval/2)*2+maxval/2'
    

11.147 lut2, tlut2

Фільтр lut2прымае два ўваходныя патокі і выводзіць адзін паток.

Фільтр tlut2(час lut2) прымае два паслядоўныя кадры з аднаго патоку.

Гэты фільтр прымае наступныя параметры:

c0

усталяваць выраз першага кампанента пікселя

c1

усталяваць выраз кампанента другога пікселя

c2

ўсталяваць выраз кампанента трэцяга пікселя

c3

усталяваць выраз чацвёртага піксельнага кампанента, які адпавядае альфа-кампаненту

d

задаць глыбіню вываду ў бітах, даступна толькі для lut2фільтра. Па змаўчанні значэнне 0, што азначае, што глыбіня ў бітах аўтаматычна выбіраецца з першага ўваходнага фармату.

Фільтр lut2таксама падтрымлівае параметры framesync .

Кожны з іх вызначае выраз, які выкарыстоўваецца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.

Дакладны кампанент, звязаны з кожным з c*варыянтаў, залежыць ад фармату ўваходных дадзеных.

Выразы могуць утрымліваць наступныя канстанты:

w
h

Шырыня і вышыня ўводу.

x

Першае ўваходнае значэнне для піксельнага кампанента.

y

Другое ўваходнае значэнне для піксельнага кампанента.

bdx

Бітавая глыбіня першага ўваходнага відэа.

bdy

Разраднасць відэа другога ўваходу.

Усе выразы па змаўчанні маюць "х".

11.147.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя параметра d.

11.147.2 Examples

  • Вылучыце адрозненні паміж двума відэапатокамі RGB:
    lut2='ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,0,pow(2,bdx)-1)'
    
  • Вылучыце адрозненні паміж двума відэапатокамі YUV:
    lut2='ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,pow(2,bdx-1),pow(2,bdx)-1):ifnot(x-y,pow(2,bdx-1),pow(2,bdx)-1)'
    
  • Паказаць максімальную розніцу паміж двума відэаплынямі:
    lut2='if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1)))'
    

11.148 maskedclamp

Зацісніце першы ўваходны паток другім уваходным і трэцім уваходным патокам.

Вяртае значэнне першага патоку паміж другім уваходным патокам - undershootі трэцім уваходным патокам + overshoot.

Гэты фільтр прымае наступныя параметры:

undershoot

Значэнне па змаўчанні - 0.

overshoot

Значэнне па змаўчанні - 0.

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

11.148.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.149 maskedmax

Аб'яднайце другі і трэці ўваходны паток у выхадны паток, выкарыстоўваючы абсалютныя адрозненні паміж другім уваходным патокам і першым уваходным патокам і абсалютную розніцу паміж трэцім уваходным патокам і першым уваходным патокам. Выбранае значэнне будзе з другога ўваходнага патоку, калі другая абсалютная розніца большая за першую, або з трэцяга ўваходнага патоку ў адваротным выпадку.

Гэты фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

11.149.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.150 maskedmerge

Аб'яднайце першы ўваходны паток з другім уваходным патокам, выкарыстоўваючы піксельныя вагі ў трэцім уваходным патоку.

Значэнне 0 у піксельным кампаненце трэцяга патоку азначае, што піксельны кампанент з першага патоку вяртаецца без зменаў, а максімальнае значэнне (напрыклад, 255 для 8-бітных відэа) азначае, што піксельны кампанент з другога патоку вяртаецца без зменаў. Прамежкавыя значэнні вызначаюць аб'ём зліцця піксельных кампанентаў абодвух уваходных патокаў.

Гэты фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

11.150.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.151 maskedmin

Аб'яднайце другі і трэці ўваходны паток у выхадны паток, выкарыстоўваючы абсалютныя адрозненні паміж другім уваходным патокам і першым уваходным патокам і абсалютную розніцу паміж трэцім уваходным патокам і першым уваходным патокам. Выбранае значэнне будзе з другога ўваходнага патоку, калі другая абсалютная розніца меншая за першую, або з трэцяга ўваходнага патоку ў адваротным выпадку.

Гэты фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

11.151.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.152 maskedthreshold

Выберыце пікселі, параўноўваючы абсалютную розніцу двух відэапатокаў з фіксаваным парогам.

Калі абсалютная розніца паміж піксельным кампанентам першага і другога відэапатоку роўная або ніжэйшая за парогавае значэнне, вызначанае карыстальнікам, выбіраецца піксельны кампанент з першага відэапатоку, у адваротным выпадку выбіраецца піксельны кампанент з другога відэапатоку.

Гэты фільтр прымае наступныя параметры:

threshold

Устанавіць парогавае значэнне, якое выкарыстоўваецца пры выбары пікселяў з абсалютнай розніцы з двух уваходных відэапатокаў.

planes

Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з другога патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

11.152.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.153 maskfun

Стварыць маску з уваходнага відэа.

Напрыклад, карысна ствараць маскі руху пасля tblendфільтра.

Гэты фільтр прымае наступныя параметры:

low

Усталюйце нізкі парог. Любы піксельны кампанент, ніжэйшы за гэтае значэнне або дакладны за яго, будзе мець значэнне 0.

high

Усталюйце высокі парог. Для любога піксельнага кампанента, вышэйшага за гэта значэнне, будзе ўстаноўлена максімальнае значэнне, дазволенае для бягучага фармату пікселяў.

planes

Усталюйце плоскасці для фільтрацыі, па змаўчанні ўсе даступныя плоскасці фільтруюцца.

fill

Запоўніце ўсе пікселі кадра гэтым значэннем.

sum

Усталюйце максімальнае сярэдняе значэнне пікселяў для кадра. Калі сума ўсіх кампанентаў пікселяў вышэй за гэта сярэдняе, выхадны кадр будзе цалкам запоўнены значэннем, устаноўленым fillопцыяй. Звычайна карысна для змены сцэны пры выкарыстанні ў спалучэнні з tblendфільтрам.

11.153.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.154 mcdeint

Прымяніць дэінтэрлейсінг з кампенсацыяй руху.

Патрабуецца адно поле на кадр у якасці ўваходных дадзеных, таму яго трэба выкарыстоўваць разам з yadif=1/3 або эквівалентным.

Гэты фільтр даступны толькі ў ffmpeg версіі 4.4 або больш ранняй.

Гэты фільтр прымае наступныя параметры:

mode

Усталюйце рэжым дэінтэрлейсінгу.

Ён прымае адно з наступных значэнняў:

'fast'
'medium'
'slow'

выкарыстоўваць ітэрацыйную ацэнку руху

'extra_slow'

як 'slow', але выкарыстоўваць некалькі апорных кадраў.

Значэнне па змаўчанні 'fast'.

parity

Усталюйце парытэт поля выявы, які мяркуецца для ўваходнага відэа. Гэта павінна быць адно з наступных значэнняў:

'0, tff'

выкажам здагадку, спачатку верхняе поле

'1, bff'

спачатку выкажам здагадку, што ніжняе поле

Значэнне па змаўчанні 'bff'.

qp

Усталюйце параметр квантавання для кожнага блока (QP), які выкарыстоўваецца ўнутраным кадавальнікам.

Больш высокія значэнні павінны прывесці да больш гладкага вектарнага поля руху, але менш аптымальных асобных вектараў. Значэнне па змаўчанні - 1.

11.155 median

Выберыце сярэдні піксель з пэўнага прамавугольніка, вызначанага радыусам.

Гэты фільтр прымае наступныя параметры:

radius

Усталюйце памер гарызантальнага радыусу. Значэнне па змаўчанні - 1. Дазволены цэлы дыяпазон ад 1 да 127.

planes

Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні - 15усе даступныя самалёты.

radiusV

Усталюйце памер вертыкальнага радыусу. Значэнне па змаўчанні - 0. Дазволены дыяпазон - цэлы лік ад 0 да 127. Калі ён роўны 0, значэнне будзе выбірацца з гарызантальнага radiusварыянту.

percentile

Задаць сярэдні працэнт. Значэнне па змаўчанні - 0.5. Значэнне па змаўчанні 0.5заўсёды будзе выбіраць сярэднія значэнні, а 0мінімальныя значэнні і 1максімальныя.

11.155.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.156 mergeplanes

Аб'яднанне кампанентаў каляровага канала з некалькіх відэапатокаў.

Фільтр прымае да 4 уваходных патокаў і аб'ядноўвае выбраныя ўваходныя плоскасці з выхадным відэа.

Гэты фільтр прымае наступныя параметры:

mapping

Задаць адлюстраванне плоскасці ўводу і вываду. Па змаўчанні 0.

Адлюстраванні задаюцца ў выглядзе растравага малюнка. Ён павінен быць указаны ў выглядзе шаснаццатковага ліку ў выглядзе 0xAa[Bb[Cc[Dd]]]. 'Aa' апісвае адлюстраванне для першай плоскасці выходнага патоку. 'A' задае нумар уваходнага патоку для выкарыстання (ад 0 да 3), а 'a' нумар плоскасці адпаведнага ўваходу для выкарыстання (ад 0 да 3). Астатнія супастаўленні падобныя: «Bb» апісвае адлюстраванне для другой плоскасці выхаднога патоку, «Cc» апісвае адлюстраванне для трэцяй плоскасці выходнага патоку, а «Dd» апісвае адлюстраванне для чацвёртай плоскасці выхаднога патоку.

format

Задаць фармат выхаднога пікселя. Па змаўчанні yuva444p.

map0s
map1s
map2s
map3s

Усталюйце адлюстраванне уваходнага і выхаднога патоку для выходнай N-й плоскасці. Па змаўчанні 0.

map0p
map1p
map2p
map3p

Усталюйце адлюстраванне плоскасці ўваходу і выхаду для N-й плоскасці выхаду. Па змаўчанні 0.

11.156.1 Examples

  • Аб'яднанне трох шэрых відэапатокаў аднолькавай шырыні і вышыні ў адзін відэапаток:
    [a0][a1][a2]mergeplanes=0x001020:yuv444p
    
  • Аб'яднаць 1-ы паток yuv444p і 2-й шэры відэапаток у відэапаток yuva444p:
    [a0][a1]mergeplanes=0x00010210:yuva444p
    
  • Памяняйце месцамі плоскасці Y і A у плыні yuva444p:
    format=yuva444p,mergeplanes=0x03010200:yuva444p
    
  • Памяняць месцамі плоскасці U і V у патоку yuv420p:
    format=yuv420p,mergeplanes=0x000201:yuv420p
    
  • Перадайце кліп rgb24 на yuv444p:
    format=rgb24,mergeplanes=0x000102:yuv444p
    

11.157 mestimate

Ацаніце і экспартуйце вектары руху з дапамогай алгарытмаў супастаўлення блокаў. Вектары руху захоўваюцца ў бакавых дадзеных кадра для выкарыстання іншымі фільтрамі.

Гэты фільтр прымае наступныя параметры:

method

Укажыце метад ацэнкі руху. Прымае адно з наступных значэнняў:

'esa'

Вычарпальны алгарытм пошуку.

'tss'

Трохкрокавы алгарытм пошуку.

'tdls'

Алгарытм двухмернага лагарыфмічнага пошуку.

'ntss'

Новы трохэтапны алгарытм пошуку.

'fss'

Чатырохкрокавы алгарытм пошуку.

'ds'

Алгарытм пошуку алмазаў.

'hexbs'

Алгарытм пошуку на аснове шасцікутніка.

'epzs'

Палепшаны алгарытм прагназуючага занальнага пошуку.

'umh'

Алгарытм пошуку няроўных некалькіх шасцікутнікаў.

Значэнне па змаўчанні 'esa'.

mb_size

Памер макраблока. Па змаўчанні 16.

search_param

Параметр пошуку. Па змаўчанні 7.

11.158 midequalizer

Прымяніць эфект выраўноўвання выявы Midway з дапамогай двух відэапатокаў.

Midway Image Equalization наладжвае пару малюнкаў, каб мець аднолькавую гістаграму, захоўваючы пры гэтым іх дынаміку, наколькі гэта магчыма. Гэта карысна, напрыклад, для супастаўлення экспазіцыі з пары стэрэакамер.

Гэты фільтр мае два ўваходы і адзін выхад, якія павінны мець аднолькавы фармат у пікселях, але могуць мець розныя памеры. Выхад фільтра - гэта першы ўваход, скарэкціраваны з сярэдняй гістаграмай абодвух уваходаў.

Гэты фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні - 15усе даступныя самалёты.

11.159 minterpolate

Пераўтварыце відэа ў зададзеную частату кадраў з дапамогай інтэрпаляцыі руху.

Гэты фільтр прымае наступныя параметры:

fps

Укажыце частату выхадных кадраў. Гэта можа быць рацыянальна, напрыклад 60000/1001. Кадры выдаляюцца, калі fpsяны ніжэйшыя за кадры ў секунду крыніцы. Па змаўчанні 60.

mi_mode

Рэжым інтэрпаляцыі руху. Прымаюцца наступныя значэнні:

'dup'

Дублюйце папярэдні або наступны кадр для інтэрпаляцыі новых.

'blend'

Змяшайце зыходныя кадры. Інтэрпаляваны кадр - гэта сярэдняе значэнне папярэдняга і наступнага кадраў.

'mci'

Інтэрпаляцыя з кампенсацыяй руху. Пры выбары гэтага рэжыму дзейнічаюць наступныя параметры:

'mc_mode'

Рэжым кампенсацыі руху. Прымаюцца наступныя значэнні:

'obmc'

Кампенсацыя руху перакрытага блока.

'aobmc'

Адаптыўная кампенсацыя руху блока з перакрыццем. Вагавыя каэфіцыенты вокнаў кантралююцца адаптыўна ў адпаведнасці з надзейнасцю суседніх вектараў руху, каб паменшыць празмернае згладжванне.

Рэжым па змаўчанні 'obmc'.

'me_mode'

Рэжым ацэнкі руху. Прымаюцца наступныя значэнні:

'bidir'

Двунакіраваная ацэнка руху. Вектары руху ацэньваюцца для кожнага зыходнага кадра ў прамым і зваротным напрамках.

'bilat'

Двухбаковая ацэнка руху. Вектары руху ацэньваюцца непасрэдна для інтэрпаляванага кадра.

Рэжым па змаўчанні 'bilat'.

'me'

Алгарытм, які будзе выкарыстоўвацца для ацэнкі руху. Прымаюцца наступныя значэнні:

'esa'

Вычарпальны алгарытм пошуку.

'tss'

Трохкрокавы алгарытм пошуку.

'tdls'

Алгарытм двухмернага лагарыфмічнага пошуку.

'ntss'

Новы трохэтапны алгарытм пошуку.

'fss'

Чатырохкрокавы алгарытм пошуку.

'ds'

Алгарытм пошуку алмазаў.

'hexbs'

Алгарытм пошуку на аснове шасцікутніка.

'epzs'

Палепшаны алгарытм прагназуючага занальнага пошуку.

'umh'

Алгарытм пошуку няроўных некалькіх шасцікутнікаў.

Алгарытм па змаўчанні 'epzs'.

'mb_size'

Памер макраблока. Па змаўчанні 16.

'search_param'

Параметр пошуку ацэнкі руху. Па змаўчанні 32.

'vsbmc'

Уключыць кампенсацыю руху блока зменнага памеру. Ацэнка руху прымяняецца з меншымі памерамі блокаў на межах аб'екта, каб зрабіць іх менш размытымі. Па змаўчанні 0(выключана).

scd

Метад выяўлення змены сцэны. Змена сцэны прыводзіць вектары руху ў выпадковым кірунку. Выяўленне змены сцэны замяняе інтэрпаляваныя кадры дублікатамі. Можа не спатрэбіцца для іншых рэжымаў. Прымаюцца наступныя значэнні:

'none'

Адключыць выяўленне змены сцэны.

'fdiff'

Розніца кадраў. Адпаведныя значэнні пікселяў параўноўваюцца і, калі яны задавальняюць scd_threshold, выяўляецца змена сцэны.

Метад па змаўчанні: 'fdiff'.

scd_threshold

Парог выяўлення змены сцэны. Па змаўчанні 10..

11.160 mix

Змяшайце некалькі ўваходных відэапатокаў у адзін відэапаток.

Далей апісваюцца прынятыя варыянты.

inputs

Колькасць уваходаў. Калі не пазначана, па змаўчанні 2.

weights

Укажыце вагу кожнага ўваходнага відэапатоку ў якасці паслядоўнасці. Кожная вага аддзяляецца прабелам. Калі колькасць вагаў меншая за колькасць framesапошняй вызначанай вагі, будзе выкарыстоўвацца для ўсіх астатніх неўсталяваных вагаў.

scale

Укажыце маштаб, калі ён усталяваны, ён будзе памножаны на суму кожнай вагі, памножанай на значэнні пікселяў, каб атрымаць канчатковае значэнне пікселя прызначэння. Па змаўчанні scaleаўтаматычна маштабуецца да сумы вагаў.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.

duration

Укажыце, як вызначаецца канец патоку.

'longest'

Працягласць самага доўгага ўводу. (па змаўчанні)

'shortest'

Працягласць самага кароткага ўводу.

'first'

Працягласць першага ўваходу.

11.160.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

weights
scale
planes

Сінтаксіс той жа, што і варыянт з такой жа назвай.

11.161 monochrome

Пераўтварыце відэа ў шэры з дапамогай карыстацкага каляровага фільтра.

Далей апісваюцца прынятыя варыянты.

cb

Усталюйце каляровую сінюю пляму. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

cr

Усталюйце каляровую чырвоную пляму. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.

size

Усталюйце памер каляровага фільтра. Дазволены дыяпазон ад 0,1 да 10. Значэнне па змаўчанні - 1.

high

Усталюйце сілу блікаў. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.

11.161.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.162 morpho

Гэты фільтр дазваляе ўжываць асноўныя марфалагічныя пераўтварэнні адценняў шэрага, размываць і пашыраць адвольныя структуры, устаноўленыя ў другім уваходным патоку.

У адрозненне ад наіўнай рэалізацыі і значна больш нізкай прадукцыйнасці ў фільтрах эрозіі і пашырэння , калі хуткасць мае вырашальнае значэнне morpho, трэба выкарыстоўваць фільтр.

Апісанне прынятых варыянтаў ніжэй,

mode

Задаць марфалагічнае пераўтварэнне для прымянення можа быць:

'erode'
'dilate'
'open'
'close'
'gradient'
'tophat'
'blackhat'

Па змаўчанні erode.

planes

Усталюйце для фільтрацыі плоскасці, па змаўчанні фільтруюцца ўсе плоскасці, акрамя альфа.

structure

Усталяваць, якая структура відэакадраў будзе апрацоўвацца з другога ўваходнага патоку, можа быць firstабо all. Па змаўчанні all.

Фільтр morphoтаксама падтрымлівае параметры framesync .

11.162.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.163 mpdecimate

Адкіньце кадры, якія не моцна адрозніваюцца ад папярэдняга, каб паменшыць частату кадраў.

Галоўнае прымяненне гэтага фільтра - для кадавання з вельмі нізкім бітрэйтам (напрыклад, струменевая перадача праз камутаваны мадэм), але тэарэтычна ён можа быць выкарыстаны для фіксацыі фільмаў, якія былі няправільна перададзены ў зваротным рэжыме.

Далей апісваюцца прынятыя варыянты.

max

Усталюйце максімальную колькасць паслядоўных кадраў, якія можна скідаць (калі станоўчы), або мінімальны інтэрвал паміж скінутымі кадрамі (калі адмоўны). Калі значэнне роўна 0, кадр скідаецца без уліку колькасці папярэдніх паслядоўна скінутых кадраў.

Значэнне па змаўчанні 0.

hi
lo
frac

Усталюйце парогавыя значэнні падзення.

Каштоўнасці дляhiіloпрызначаны для блокаў 8x8 пікселяў і ўяўляюць фактычную розніцу значэнняў пікселяў, таму парогавае значэнне ў 64 адпавядае 1 адзінцы розніцы для кожнага пікселя або таго ж рознага размеркавання па блоку.

Кадр з'яўляецца кандыдатам на выпадзенне, калі ні адзін з блокаў 8x8 не адрозніваецца больш чым на парогавае значэннеhi, а калі не больш заfracблокі (1 азначае ўвесь малюнак) адрозніваюцца больш чым на парогавае значэннеlo.

Значэнне па змаўчанні дляhi64*12, значэнне па змаўчанні дляloскладае 64*5 і значэнне па змаўчанні дляfracскладае 0,33.

11.164 msad

Атрымайце MSAD (сярэднюю суму абсалютных розніц) паміж двума ўваходнымі відэа.

Гэты фільтр прымае два ўваходныя відэа.

Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.

Атрыманае па кампаненту, сярэдняе, мінімальнае і максімальнае MSAD друкуецца праз сістэму рэгістрацыі.

Фільтр захоўвае разлічаны MSAD кожнага кадра ў метададзеных кадра.

У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpgапрацоўваецца параўноўваецца з эталонным файламref.mpg.

ffmpeg -i main.mpg -i ref.mpg -lavfi msad -f null -

11.165 multiply

Памножце значэнне пікселяў першага відэапатоку на значэнне пікселяў другога відэапатоку.

Фільтр прымае наступныя параметры:

scale

Усталюйце маштаб, прыменены да другога відэапатоку. Па змаўчанні гэта 1. Дазволены дыяпазон ад 0да 9.

offset

Усталюйце зрушэнне, прымененае да другога відэапатоку. Па змаўчанні гэта 0.5. Дазволены дыяпазон ад -1да 1.

planes

Укажыце плоскасці з уваходнага відэапатоку, якія будуць апрацоўвацца. Па змаўчанні апрацоўваюцца ўсе плоскасці.

11.165.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.166 negate

Негатаванне (інвертаванне) уваходнага відэа.

Ён прымае наступны варыянт:

components

Усталюйце кампаненты на адмаўленне.

Даступныя значэнні для кампанентаў:

'y'
'u'
'v'
'a'
'r'
'g'
'b'
negate_alpha

Са значэннем 1 ён адмаўляе альфа-кампанент, калі ён ёсць. Значэнне па змаўчанні 0.

11.166.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.167 nlmeans

Шумаць кадры з выкарыстаннем алгарытму нелакальных сродкаў.

Кожны піксель карэктуецца шляхам пошуку іншых пікселяў з аналагічным кантэкстам. Гэта падабенства кантэксту вызначаецца шляхам параўнання навакольных іх участкаў памеру pхp. Латы шукаюць у раёне вrхr вакол пікселя.

Звярніце ўвагу, што вобласць даследавання вызначае цэнтры для патчаў, што азначае, што некаторыя патчы будуць зроблены з пікселяў па-за межамі гэтай вобласці даследавання.

Фільтр прымае наступныя параметры.

s

Усталюйце сілу шумашумлення. Па змаўчанні 1.0. Павінна быць у дыяпазоне [1.0, 30.0].

p

Усталюйце памер патча. Па змаўчанні 7. Павінен быць няцотны лік у дыяпазоне [0, 99].

pc

Такі ж, якpале для плоскасцей каляровасці.

Значэнне па змаўчанні 0і азначае аўтаматычны.

r

Усталюйце памер даследавання. Па змаўчанні 15. Павінен быць няцотны лік у дыяпазоне [0, 99].

rc

Такі ж, якrале для плоскасцей каляровасці.

Значэнне па змаўчанні 0і азначае аўтаматычны.

11.168 nnedi

Дэінтэрпаляцыя відэа з выкарыстаннем накіраванай нейронавай сеткі інтэрпаляцыі.

Гэты фільтр прымае наступныя параметры:

weights

Абавязковая опцыя, без бінарнага файла фільтр не можа працаваць. У цяперашні час файл можна знайсці тут: https://github.com/dubhater/vapoursynth-nnedi3/blob/master/src/nnedi3_weights.bin

deint

Усталюйце кадры для дэінтэрлейсу, па змаўчанні гэта all. Можа быць allабо interlaced.

field

Задаць рэжым працы.

Можа быць адно з наступнага:

'af'

Выкарыстоўвайце сцягі рамкі, абодва палі.

'a'

Выкарыстоўвайце сцягі рамкі, адно поле.

't'

Выкарыстоўвайце толькі верхняе поле.

'b'

Выкарыстоўвайце толькі ніжняе поле.

'tf'

Выкарыстоўвайце абодва палі, спачатку зверху.

'bf'

Выкарыстоўвайце абодва палі, спачатку ніжняе.

planes

Усталюйце, якія плоскасці апрацоўваць, па змаўчанні фільтр апрацоўвае ўсе кадры.

nsize

Задайце памер лакальнага наваколля вакол кожнага пікселя, які выкарыстоўваецца нейронавай сеткай прагназатара.

Можа быць адно з наступнага:

's8x6'
's16x6'
's32x6'
's48x6'
's8x4'
's16x4'
's32x4'
nns

Усталюйце колькасць нейронаў у нейронавай сетцы прадказальніка. Можа быць адно з наступнага:

'n16'
'n32'
'n64'
'n128'
'n256'
qual

Кантралюе колькасць розных прагнозаў нейронавай сеткі, якія аб'ядноўваюцца для вылічэння канчатковага выхаднога значэння. Можа быць fast, default або slow.

etype

Усталюйце, які набор вагаў выкарыстоўваць у прадказальніку. Можа быць адно з наступнага:

'a, abs'

вагі навучаны, каб мінімізаваць абсалютную памылку

's, mse'

вагі навучаны, каб мінімізаваць памылку ў квадраце

pscrn

Кантралюе, ці будзе нейронавая сетка папярэдняга адбору выкарыстоўвацца для вызначэння таго, якія пікселі павінны быць апрацаваны нейронавай сеткай прадказальніка, а якія можна апрацоўваць простай кубічнай інтэрпаляцыяй. Асоба папярэдняга адбору навучана ведаць, ці будзе кубічнай інтэрпаляцыі дастаткова для пікселя, ці яна павінна прадказвацца прадказальнікам nn. Вылічальная складанасць прэдыктара nn значна меншая, чым прадказальніка nn. Паколькі большасць пікселяў можна апрацоўваць з дапамогай кубічнай інтэрпаляцыі, выкарыстанне папярэдняга прагляду звычайна прыводзіць да значна больш хуткай апрацоўкі. Праграма папярэдняга адбору даволі дакладная, таму розніца паміж яе выкарыстаннем і невыкарыстаннем амаль заўсёды незаўважная.

Можа быць адно з наступнага:

'none'
'original'
'new'
'new2'
'new3'

Па змаўчанні new.

11.168.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі, за выключэннем weightsопцыі.

11.169 noformat

Прымусіць libavfilter не выкарыстоўваць любы з указаных фарматаў пікселяў для ўводу ў наступны фільтр.

Ён прымае наступныя параметры:

pix_fmts

Спіс назваў фарматаў пікселяў, падзелены '|', напрыклад pix_fmts=yuv420p|monow|rgb24".

11.169.1 Examples

  • Прымусіць libavfilter выкарыстоўваць фармат, які адрозніваецца ад фармату yuv420pўводу ў фільтр vflip:
    noformat=pix_fmts=yuv420p,vflip
    
  • Пераўтварыце ўваходнае відэа ў любы з фарматаў, якіх няма ў спісе:
    noformat=yuv420p|yuv444p|yuv410p
    

11.170 noise

Дадаць шум на кадры ўваходнага відэа.

Фільтр прымае наступныя параметры:

all_seed
c0_seed
c1_seed
c2_seed
c3_seed

Усталюйце пачатковае значэнне шуму для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку all_seed. Значэнне па змаўчанні - 123457.

all_strength, alls
c0_strength, c0s
c1_strength, c1s
c2_strength, c2s
c3_strength, c3s

Усталюйце ўзровень шуму для пэўнага кампанента пікселя або ўсіх кампанентаў пікселя ў выпадку all_strength. Значэнне па змаўчанні - 0. Дазволены дыяпазон [0, 100].

all_flags, allf
c0_flags, c0f
c1_flags, c1f
c2_flags, c2f
c3_flags, c3f

Усталюйце сцягі піксельных кампанентаў або ўсталюйце сцягі для ўсіх кампанентаў, калі all_flags. Даступныя значэнні для сцягоў кампанентаў:

'a'

асераднёны скроневы шум (больш гладкі)

'p'

змешваць выпадковы шум з (паў)рэгулярным малюнкам

't'

часовы шум (змена шумавога малюнка паміж кадрамі)

'u'

раўнамерны шум (у іншым выпадку па Гаўсу)

11.170.1 Examples

Дадайце часовы і аднастайны шум да ўваходнага відэа:

noise=alls=20:allf=t+u

11.171 normalize

Нармалізацыя відэа RGB (ён жа расцягванне гістаграмы, расцягванне кантрасту). Глядзіце: https://en.wikipedia.org/wiki/Normalization_(image_processing)

Для кожнага канала кожнага кадра фільтр вылічае ўваходны дыяпазон і лінейна супастаўляе яго з вызначаным карыстальнікам выхадным дыяпазонам. Выхадны дыяпазон па змаўчанні - поўны дынамічны дыяпазон ад чыста чорнага да чыста белага.

Часовае згладжванне можна выкарыстоўваць на ўваходным дыяпазоне, каб паменшыць мігаценне (хуткія змены яркасці), якое ўзнікае, калі невялікія цёмныя або яркія аб'екты ўваходзяць у сцэну або пакідаюць яе. Гэта падобна на аўтаматычную экспазіцыю (аўтаматычны кантроль узмацнення) на відэакамеры, і, як і відэакамера, можа выклікаць перыяд празмернай або недастатковай экспазіцыі відэа.

Каналы R,G,B можна нармалізаваць незалежна адзін ад аднаго, што можа выклікаць некаторую змену колеру, або аб'яднаць іх у адзін канал, што прадухіляе зрух колеру. Звязаная нармалізацыя захоўвае адценне. Незалежнай нармалізацыі няма, таму яе можна выкарыстоўваць для выдалення некаторых каляровых адценняў. Незалежную і звязаную нармалізацыю можна камбінаваць у любых суадносінах.

Фільтр нармалізацыі прымае наступныя параметры:

blackpt
whitept

Колеры, якія вызначаюць выхадны дыяпазон. Мінімальнае ўваходнае значэнне адлюстроўваецца на blackpt. Максімальнае ўваходнае значэнне адлюстроўваецца на whitept. Па змаўчанні чорны і белы адпаведна. Указанне белага для blackptі чорнага для whiteptдасць інвертаваны колер, нармалізаванае відэа. Для памяншэння дынамічнага дыяпазону (кантрастнасці) можна выкарыстоўваць адценні шэрага. Указанне тут насычаных колераў можа стварыць некаторыя цікавыя эфекты.

smoothing

Колькасць папярэдніх кадраў для часовага згладжвання. Уваходны дыяпазон кожнага канала згладжваецца з дапамогай слізгальнага сярэдняга па бягучым і smoothingпапярэдніх кадрах. Па змаўчанні 0 (без часовага згладжвання).

independence

Кантралюе суадносіны незалежнай (з зрухам колеру) нармалізацыі канала да звязанай (з захаваннем колеру) нармалізацыі. 0.0 цалкам звязаны, 1.0 цалкам незалежны. Па змаўчанні 1.0 (цалкам незалежна).

strength

Агульная трываласць фільтра. 1.0 - поўная сіла. 0.0 з'яўляецца даволі дарагім без аперацыі. Па змаўчанні 1.0 (поўная моц).

11.171.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі, за выключэннем smoothingопцыі. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.171.2 Examples

Расцягнуць кантраснасць відэа для выкарыстання поўнага дынамічнага дыяпазону без часовага згладжвання; можа міргаць у залежнасці ад зыходнага кантэнту:

normalize=blackpt=black:whitept=white:smoothing=0

Як і вышэй, але з 50 кадрамі часовага згладжвання; мігаценне павінна быць зменшана ў залежнасці ад зыходнага кантэнту:

normalize=blackpt=black:whitept=white:smoothing=50

Як і вышэй, але з нармалізацыяй звязанага канала з захаваннем адцення:

normalize=blackpt=black:whitept=white:smoothing=50:independence=0

Як вышэй, але з паловай сілы:

normalize=blackpt=black:whitept=white:smoothing=50:independence=0:strength=0.5

Адлюструйце самы цёмны колер уводу да чырвонага, самы яркі колер уводу да блакітнага:

normalize=blackpt=red:whitept=cyan

11.172 null

Перадайце крыніцу відэа без змен на выхад.

11.173 ocr

Аптычнае распазнаванне сімвалаў

Гэты фільтр выкарыстоўвае Tesseract для аптычнага распазнавання сімвалаў. Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-libtesseract.

Ён прымае наступныя варыянты:

datapath

Усталюйце шлях да дадзеных для даных тэсеракта. Па змаўчанні выкарыстоўваецца тое, што было ўстаноўлена пры ўсталёўцы.

language

Усталюйце мову, па змаўчанні "англ".

whitelist

Усталяваць белы спіс сімвалаў.

blacklist

Усталяваць чорны спіс персанажаў.

Фільтр экспартуе распазнаны тэкст як метаданыя фрэйма lavfi.ocr.text. Фільтр экспартуе ўпэўненасць распазнаных слоў у якасці метаданых фрэйма lavfi.ocr.confidence.

11.174 ocv

Прымяніць трансфармацыю відэа з дапамогай libopencv.

Каб уключыць гэты фільтр, усталюйце бібліятэку libopencv і загалоўкі і наладзьце FFmpeg з дапамогай --enable-libopencv.

Ён прымае наступныя параметры:

filter_name

Назва фільтра libopencv, які трэба прымяніць.

filter_params

Параметры для перадачы ў фільтр libopencv. Калі не пазначана, прымаюцца значэнні па змаўчанні.

Для атрымання больш дакладнай інфармацыі звярніцеся да афіцыйнай дакументацыі libopencv: http://docs.opencv.org/master/modules/imgproc/doc/filtering.html

Падтрымліваюцца некалькі фільтраў libopencv; гл. наступныя падраздзелы.

11.174.1 dilate

Пашырце малюнак, выкарыстоўваючы пэўны структурны элемент. Гэта адпавядае функцыі libopencv cvDilate.

Ён прымае параметры: struct_el| nb_iterations.

struct_elуяўляе сабой структурны элемент і мае сінтаксіс: colsx rows+ anchor_xx anchor_y/shape

colsі rowsўяўляюць колькасць слупкоў і радкоў структурнага элемента, кропку прывязкі і anchor_xформу структурнага элемента. павінен быць "прамы", "крыж", "эліпс" або "карыстальніцкі". anchor_yshapeshape

Калі значэнне для shape"карыстальніцкі", пасля яго павінен ісці радок у выглядзе "= filename". Мяркуецца, што файл з назвай filenameпрадстаўляе двайковы малюнак, у якім кожны друкаваны сімвал адпавядае яркаму пікселю. Калі карыстальніцкі shapeвыкарыстоўваецца colsі rowsігнаруецца, замест яго прымаецца колькасць або слупкі і радкі прачытанага файла.

Значэнне па змаўчанні struct_el- "3x3+0x0/rect".

nb_iterationsвызначае колькасць разоў прымянення пераўтварэнняў да выявы і па змаўчанні 1.

Некаторыя прыклады:

# Use the default values
ocv=dilate

# Dilate using a structuring element with a 5x5 cross, iterating two times
ocv=filter_name=dilate:filter_params=5x5+2x2/cross|2

# Read the shape from the file diamond.shape, iterating two times.
# The file diamond.shape may contain a pattern of characters like this
#   *
#  ***
# *****
#  ***
#   *
# The specified columns and rows are ignored
# but the anchor point coordinates are not
ocv=dilate:0x0+2x2/custom=diamond.shape|2

11.174.2 erode

Размяць вобраз, выкарыстоўваючы пэўны структурны элемент. Гэта адпавядае функцыі libopencv cvErode.

Ён прымае параметры: struct_el: nb_iterationsз тым жа сінтаксісам і семантыкай, што і фільтр пашырэння .

11.174.3 smooth

Згладжванне ўваходнага відэа.

Фільтр прымае наступныя параметры: type| param1| param2| param3| param4.

typeтып гладкага фільтра, які трэба прымяніць, і павінен мець адно з наступных значэнняў: "blur", "blur_no_scale", "median", "gaussian" або "bilateral". Значэнне па змаўчанні - "Гаўса".

Значэнне param1, param2, param3, і param4 залежыць ад гладкага тыпу. param1і param2прымаць цэлыя дадатныя значэнні або 0. param3і param4прымаць значэнні з плаваючай кропкай.

Значэнне па змаўчанні для param1- 3. Значэнне па змаўчанні для астатніх параметраў - 0.

Гэтыя параметры адпавядаюць параметрам, прызначаным функцыі libopencv cvSmooth.

11.175 oscilloscope

2D відэаасцылограф.

Карысна для вымярэння прасторавага імпульсу, крокавых рэакцый, затрымкі каляровасці і г.д.

Ён прымае наступныя параметры:

x

Усталюйце цэнтр прыцэла па X.

y

Усталюйце прыцэл у цэнтр y.

s

Усталюйце памер прыцэла адносна дыяганалі кадра.

t

Усталюйце нахіл/паварот прыцэла.

o

Задаць непразрыстасць трасіроўкі.

tx

Усталюйце цэнтр трасіроўкі па X.

ty

Устанавіць цэнтр трасіроўкі ў становішчы.

tw

Усталюйце шырыню трасіроўкі адносна шырыні рамкі.

th

Усталюйце вышыню трасіроўкі адносна вышыні кадра.

c

Усталюйце, якія кампаненты адсочваць. Па змаўчанні ён адсочвае першыя тры кампаненты.

g

Намалюйце сетку трасіроўкі. Па змаўчанні ўключана.

st

Намалюйце статыстыку. Па змаўчанні ўключана.

sc

Намалюйце аб'ём. Па змаўчанні ўключана.

11.175.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.175.2 Examples

  • Праверце поўны першы рад відэакадра.
    oscilloscope=x=0.5:y=0:s=1
    
  • Праверце ўвесь апошні рад відэакадра.
    oscilloscope=x=0.5:y=1:s=1
    
  • Агледзіце поўны 5-ы радок відэакадра вышынёй 1080.
    oscilloscope=x=0.5:y=5/1080:s=1
    
  • Праверце ўвесь апошні слупок відэакадра.
    oscilloscope=x=1:y=0.5:s=1:t=1
    

11.176 overlay

Накласці адно відэа на другое.

Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход.

Ён прымае наступныя параметры:

Далей апісваюцца прынятыя варыянты.

x
y

Усталюйце выраз для каардынат x і y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні "0" для абодвух выразаў. У выпадку, калі выраз несапраўдны, ён усталёўваецца ў вялікае значэнне (гэта азначае, што накладанне не будзе адлюстроўвацца ў бачнай вобласці вываду).

eof_action

Глядзіце framesync .

eval

Усталюйце, калі выразы дляx, іyацэньваюцца.

Ён прымае наступныя значэнні:

'init'

вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды

'frame'

ацэньваць выразы для кожнага ўваходнага кадра

Значэнне па змаўчанні 'frame'.

shortest

Глядзіце framesync .

format

Усталюйце фармат выхаднога відэа.

Ён прымае наступныя значэнні:

'yuv420'

сілавы выхад YUV420

'yuv420p10'

сілавы выхад YUV420p10

'yuv422'

сілавы выхад YUV422

'yuv422p10'

сілавы выхад YUV422p10

'yuv444'

сілавы выхад YUV444

'rgb'

прымусова ўпакаваны выхад RGB

'gbrp'

прымусовы плоскі выхад RGB

'auto'

аўтаматычна выбраць фармат

Значэнне па змаўчанні 'yuv420'.

repeatlast

Глядзіце framesync .

alpha

Задайце фармат альфа-версіі накладзенага відэа, гэта можа быць straightабо premultiplied. Па змаўчанні straight.

Thex, іyвыразы могуць утрымліваць наступныя параметры.

main_w, W
main_h, H

Асноўны ўваход шырыня і вышыня.

overlay_w, w
overlay_h, h

Шырыня і вышыня ўводу накладання.

x
y

Вылічаныя значэнні для xі y. Яны ацэньваюцца для кожнага новага кадра.

hsub
vsub

гарызантальныя і вертыкальныя значэнні падвыбаркі каляровасці выхаднога фармату. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

n

нумар уваходнага кадра, пачынаючы з 0

pos

пазіцыя ў файле ўваходнага кадра, NAN, калі невядома

t

Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

Звярніце ўвагу, што nзменныя pos, t, даступныя толькі тады, калі ацэнка выконваецца для кадра , і будуць ацэненыя ў NAN, каліevalусталяваны ў 'init'.

Майце на ўвазе, што кадры бяруцца з кожнага ўваходнага відэа ў парадку пазнакі часу, таму, калі іх першапачатковыя пазнакі часу адрозніваюцца, добрая ідэя прапусціць два ўваходныя сігналы праз setpts=PTS-STARTPTSфільтр, каб яны пачыналіся з адной і той жа нулявой пазнакі часу, як у прыкладзе для movieфільтр робіць.

Вы можаце аб'яднаць больш накладак, але вы павінны праверыць эфектыўнасць такога падыходу.

11.176.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

x
y

Змяніце x і y накладзенага ўводу. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.176.2 Examples

  • Намалюйце накладанне ў 10 пікселяў ад ніжняга правага кута асноўнага відэа:
    overlay=main_w-overlay_w-10:main_h-overlay_h-10
    

    Выкарыстанне найменных параметраў у прыкладзе вышэй становіцца:

    overlay=x=main_w-overlay_w-10:y=main_h-overlay_h-10
    
  • Устаўце празрысты лагатып PNG у левы ніжні кут уводу, выкарыстоўваючы ffmpegінструмент з -filter_complexопцыяй:
    ffmpeg -i input -i logo -filter_complex 'overlay=10:main_h-overlay_h-10' output
    
  • Устаўце 2 розныя празрыстыя лагатыпы PNG (другі лагатып у правым ніжнім куце) з дапамогай ffmpegінструмента:
    ffmpeg -i input -i logo1 -i logo2 -filter_complex 'overlay=x=10:y=H-h-10,overlay=x=W-w-10:y=H-h-10' output
    
  • Дадайце празрысты каляровы пласт паверх асноўнага відэа; WxH неабходна вызначыць памер асноўнага ўваходу ў фільтр накладання:
    color=color=red@.3:size=WxH [over]; [in][over] overlay [out]
    
  • Прайграйце арыгінальнае відэа і адфільтраваную версію (тут з фільтрам паслаблення) побач з дапамогай ffplayінструмента:
    ffplay input.avi -vf 'split[a][b]; [a]pad=iw*2:ih[src]; [b]deshake[filt]; [src][filt]overlay=w'
    

    Прыведзеная вышэй каманда такая ж, як:

    ffplay input.avi -vf 'split[b], pad=iw*2[src], [b]deshake, [src]overlay=w'
    
  • Зрабіце слізгальнае накладанне, якое з'яўляецца злева направа ў верхняй частцы экрана, пачынаючы з моманту 2:
    overlay=x='if(gte(t,2), -w+(t-2)*20, NAN)':y=0
    
  • Складзіце выхад, размясціўшы два ўваходныя відэа побач:
    ffmpeg -i left.avi -i right.avi -filter_complex "
    nullsrc=size=200x100 [background];
    [0:v] setpts=PTS-STARTPTS, scale=100x100 [left];
    [1:v] setpts=PTS-STARTPTS, scale=100x100 [right];
    [background][left]       overlay=shortest=1       [background+left];
    [background+left][right] overlay=shortest=1:x=100 [left+right]
    "
    
  • Маскіруйце 10-20 секунд відэа, ужыўшы фільтр delogo да раздзела
    ffmpeg -i test.avi -codec:v:0 wmv2 -ar 11025 -b:v 9000k
    -vf '[in]split[split_main][split_delogo];[split_delogo]trim=start=360:end=371,delogo=0:0:640:480[delogoed];[split_main][delogoed]overlay=eof_action=pass[out]'
    masked.avi
    
  • Злучыце некалькі накладак каскадам:
    nullsrc=s=200x200 [bg];
    testsrc=s=100x100, split=4 [in0][in1][in2][in3];
    [in0] lutrgb=r=0, [bg]   overlay=0:0     [mid0];
    [in1] lutrgb=g=0, [mid0] overlay=100:0   [mid1];
    [in2] lutrgb=b=0, [mid1] overlay=0:100   [mid2];
    [in3] null,       [mid2] overlay=100:100 [out0]
    

11.177 overlay_cuda

Накласці адно відэа на другое.

Гэта варыянт CUDA фільтра накладання . Ён прымае толькі кадры CUDA. Асноўныя фарматы ўваходных пікселяў павінны супадаць.

Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход.

Ён прымае наступныя параметры:

x
y

Усталюйце выразы для каардынат x і y накладзенага відэа на асноўнае відэа.

Яны могуць утрымліваць наступныя параметры:

main_w, W
main_h, H

Асноўны ўваход шырыня і вышыня.

overlay_w, w
overlay_h, h

Шырыня і вышыня ўводу накладання.

x
y

Вылічаныя значэнні для xі y. Яны ацэньваюцца для кожнага новага кадра.

n

Парадкавы індэкс асноўнага ўваходнага кадра, пачынаючы з 0.

pos

Пазіцыя зрушэння байтаў у файле асноўнага ўваходнага кадра, NAN, калі невядома.

t

Метка часу асноўнага ўваходнага кадра, выражаная ў секундах, NAN, калі невядома.

Значэнне па змаўчанні "0" для абодвух выразаў.

eval

Усталюйце, калі выразы дляxіyацэньваюцца.

Ён прымае наступныя значэнні:

init

Вылічвайце выразы адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.

frame

Ацаніце выразы для кожнага ўваходнага кадра

Значэнне па змаўчанніframe.

eof_action

Глядзіце framesync .

shortest

Глядзіце framesync .

repeatlast

Глядзіце framesync .

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

11.178 owdenoise

Прымяніць сродак для ліквідацыі шуму Overcomplete Wavelet.

Фільтр прымае наступныя параметры:

depth

Задаць глыбіню.

Большыя значэнні глыбіні прывядуць да больш нізкачастотных кампанентаў, але запаволіць фільтрацыю.

Павінен быць int у дыяпазоне 8-16, па змаўчанні 8.

luma_strength, ls

Усталюйце сілу яркасці.

Павінна быць падвойнае значэнне ў дыяпазоне 0-1000, па змаўчанні 1.0.

chroma_strength, cs

Усталюйце інтэнсіўнасць каляровасці.

Павінна быць падвойнае значэнне ў дыяпазоне 0-1000, па змаўчанні 1.0.

11.179 pad

Дадайце пракладкі да ўваходнага відарысу і размесціце зыходны ўвод у прадастаўленых xкаардынатах y.

Ён прымае наступныя параметры:

width, w
height, h

Укажыце выраз для памеру выхаднога відарыса з дададзенымі пракладкамі. Калі значэнне widthабо heightроўна 0, для вываду выкарыстоўваецца адпаведны ўваходны памер.

Выраз widthможа спасылацца на значэнне, зададзенае heightвыразам, і наадварот.

Значэнне па змаўчанні widthі heightроўна 0.

x
y

Укажыце зрушэнні для размяшчэння ўваходнага відарыса ў падшытай вобласці адносна верхняй/левай мяжы выходнага відарыса.

Выраз xможа спасылацца на значэнне, зададзенае y выразам, і наадварот.

Значэнне па змаўчанні xі yроўна 0.

Калі ацэнка xor yдае адмоўны лік, яны будуць зменены так, што ўваходны відарыс будзе адцэнтраваны на падстаўленай вобласці.

color

Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні color- "чорны".

eval

Укажыце, калі вылічваць width, height, xі yвыраз.

Ён прымае наступныя значэнні:

'init'

Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.

'frame'

Ацаніце выразы для кожнага ўваходнага кадра.

Значэнне па змаўчанні 'init'.

aspect

Увядзіце ў фармат замест дазволу.

Значэнні параметраў width, height, x, і y з'яўляюцца выразамі, якія змяшчаюць наступныя канстанты:

in_w
in_h

Шырыня і вышыня ўваходнага відэа.

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Шырыня і вышыня вываду (памер запаўненай вобласці), зададзеныя выразамі widthі .height

ow
oh

Гэта тое самае, што out_wі out_h.

x
y

Зрушэнні x і y, як вызначана выразамі xі y , або NAN, калі яшчэ не пазначаны.

a

тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

суадносіны бакоў уваходнага дысплея, яно такое ж, як ( iw/ ih) *sar

hsub
vsub

Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

11.179.1 Examples

  • Дадайце пракладкі колеру "фіялетавы" да ўваходнага відэа. Памер выхаднога відэа складае 640x480, а верхні левы кут уваходнага відэа змяшчаецца ў слупку 0, радку 40
    pad=640:480:0:40:violet
    

    Прыклад вышэй эквівалентны наступнай камандзе:

    pad=width=640:height=480:x=0:y=40:color=violet
    
  • Запоўніце ўваход, каб атрымаць выхад з памерамі, павялічанымі на 3/2, і размесціце ўваходнае відэа ў цэнтры забітай вобласці:
    pad="3/2*iw:3/2*ih:(ow-iw)/2:(oh-ih)/2"
    
  • Запоўніце ўваход, каб атрымаць выхад у квадраце з памерам, роўным максімальнаму значэнню паміж шырынёй і вышынёй уваходнага сігналу, і пастаўце ўваходнае відэа ў цэнтр забітай вобласці:
    pad="max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2"
    
  • Запоўніце ўвод, каб атрымаць канчатковае суадносіны w/h 16:9:
    pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2"
    
  • У выпадку анаморфнага відэа, каб правільна задаць фармат выходнага адлюстравання, неабходна выкарыстоўваць sarу выразе, у адпаведнасці з адносінамі:
    (ih * X / ih) * sar = output_dar
    X = output_dar / sar
    

    Такім чынам, папярэдні прыклад павінен быць зменены, каб:

    pad="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2"
    
  • Удвая павялічце выхадны памер і змесціце ўваходнае відэа ў правым ніжнім куце вывадной вобласці:
    pad="2*iw:2*ih:ow-iw:oh-ih"
    

11.180 palettegen

Стварыць адну палітру для цэлага відэаструменю.

Ён прымае наступныя варыянты:

max_colors

Усталюйце максімальную колькасць колераў для квантавання ў палітры. Заўвага: палітра па-ранейшаму будзе ўтрымліваць 256 колераў; нявыкарыстаныя элементы палітры будуць чорнымі.

reserve_transparent

Стварыце палітру з максімум 255 колераў і захавайце апошні для празрыстасці. Рэзерваванне колеру празрыстасці карысна для аптымізацыі GIF. Калі не ўстаноўлена, максімальная колькасць колераў у палітры будзе 256. Верагодна, вы хочаце адключыць гэту опцыю для асобнага відарыса. Усталёўваецца па змаўчанні.

transparency_color

Усталюйце колер, які будзе выкарыстоўвацца ў якасці фону для празрыстасці.

stats_mode

Ўсталяваць рэжым статыстыкі.

Ён прымае наступныя значэнні:

'full'

Вылічыць поўнакадравыя гістаграмы.

'diff'

Вылічвайце гістаграмы толькі для той часткі, якая адрозніваецца ад папярэдняга кадра. Гэта можа быць дарэчы, каб надаць большае значэнне рухомай частцы вашага ўводу, калі фон статычны.

'single'

Вылічыце новую гістаграму для кожнага кадра.

Значэнне па змаўчанні - full.

use_alpha

Стварыце палітру колераў з альфа-кампанентамі. Усталяванне гэтага параметра аўтаматычна адключае 'reserve_transparent'.

Фільтр таксама экспартуе метаданыя кадра lavfi.color_quant_ratio ( nb_color_in / nb_color_out), якія вы можаце выкарыстоўваць для ацэнкі ступені квантавання колеру палітры. Гэтая інфармацыя таксама бачная на infoўзроўні рэгістрацыі.

11.180.1 Examples

  • Стварыце рэпрэзентатыўную палітру дадзенага відэа з дапамогай ffmpeg:
    ffmpeg -i input.mkv -vf palettegen palette.png
    

11.181 paletteuse

Выкарыстоўвайце палітру для памяншэння дыскрэтызацыі ўваходнага відэапатоку.

Фільтр прымае два ўваходу: адзін відэаструмень і палітру. Палітра павінна быць выявай памерам 256 пікселяў.

Ён прымае наступныя варыянты:

dither

Выберыце рэжым згладжвання. Даступныя алгарытмы:

'bayer'

Замоўленае згладжванне Баера 8x8 (дэтэрмінаванае)

'heckbert'

Дызерынг паводле вызначэння Пола Хекберта ў 1982 г. (простая дыфузія памылак). Заўвага: гэта згладжванне часам лічыцца "няправільным" і ўключана ў якасці эталона.

'floyd_steinberg'

Дызерынг Флойда і Стынгберга (дыфузія памылак)

'sierra2'

Frankie Sierra dithering v2 (дыфузія памылак)

'sierra2_4a'

Frankie Sierra dithering v2 "Lite" (дыфузія памылак)

Па змаўчанні sierra2_4a.

bayer_scale

Калі bayerвыбрана згладжванне, гэты параметр вызначае маштаб узору (наколькі бачны ўзор штрыхоўкі). Нізкае значэнне азначае больш бачны ўзор з меншай колькасцю палос, а большае значэнне азначае менш бачны ўзор за кошт большай колькасці палос.

Параметр павінен быць цэлым лікам у дыяпазоне [0,5]. Па змаўчанні 2.

diff_mode

Калі ўстаноўлена, вызначце зону для апрацоўкі

'rectangle'

Будзе паўторна апрацаваны толькі зменлівы прамавугольнік. Гэта падобна на механізм сціску абрэзкі/зрушэння GIF. Гэты параметр можа быць карысным для хуткасці, калі змяняецца толькі частка відарыса і мае такія выпадкі выкарыстання, як абмежаванне аб'ёму распаўсюджвання памылакditherда прастакутніка, які абмяжоўвае рухомую сцэну (гэта прыводзіць да больш дэтэрмінаванага вываду, калі сцэна не змяняецца моцна, і, як вынік, менш рухальнага шуму і лепшае сцісканне GIF).

Па змаўчанні none.

new

Вазьміце новую палітру для кожнага выхаднога кадра.

alpha_threshold

Устанаўлівае альфа-парог для празрыстасці. Значэнні альфа вышэй гэтага парога будуць разглядацца як цалкам непразрыстыя, а значэнні ніжэй гэтага парога будуць разглядацца як цалкам празрыстыя.

Параметр павінен быць цэлым лікам у дыяпазоне [0,255]. Па змаўчанні 128.

use_alpha

Ужывайце палітру з улікам альфа-значэнняў. Карысна толькі з палітрамі, якія змяшчаюць некалькі колераў з альфа-кампанентамі. Вызначэнне гэтага параметра аўтаматычна адключае «alpha_treshold».

11.181.1 Examples

  • Выкарыстоўвайце палітру (створаную, напрыклад, з дапамогай palettegen ), каб закадзіраваць GIF з дапамогай ffmpeg:
    ffmpeg -i input.mkv -i palette.png -lavfi paletteuse output.gif
    

11.182 perspective

Правільны ракурс відэа не запісваецца перпендыкулярна экрану.

Далей апісваюцца прынятыя параметры.

x0
y0
x1
y1
x2
y2
x3
y3

Усталюйце выраз каардынат для верхняга левага, верхняга правага, ніжняга левага і ніжняга правага кутоў. Значэнні па змаўчанні - гэта тое, 0:0:W:0:0:H:W:Hпры якім ракурс застанецца нязменным. Калі для senseопцыі ўстаноўлена source, то ўказаныя пункты будуць адпраўлены ў куты пункта прызначэння. Калі senseпараметр усталяваны ў destination, то вуглы крыніцы будуць адпраўлены па ўказаных каардынатах.

Выразы могуць выкарыстоўваць наступныя зменныя:

W
H

шырыня і вышыня кадра відэа.

in

Колькасць уваходных кадраў.

on

Колькасць выхадных кадраў.

interpolation

Усталюйце інтэрпаляцыю для карэкцыі перспектывы.

Ён прымае наступныя значэнні:

'linear'
'cubic'

Значэнне па змаўчанні 'linear'.

sense

Задаць інтэрпрэтацыю варыянтаў каардынат.

Ён прымае наступныя значэнні:

'0, source'

Адправіць кропку ў крыніцы, вызначанай зададзенымі каардынатамі, у куты пункта прызначэння.

'1, destination'

Адпраўце вуглы крыніцы ў кропку пункта прызначэння, вызначаную зададзенымі каардынатамі.

Значэнне па змаўчанні 'source'.

eval

Усталюйце, калі выразы для каардынатx0,y0,...x3,y3ацэньваюцца.

Ён прымае наступныя значэнні:

'init'

вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды

'frame'

ацэньваць выразы для кожнага ўваходнага кадра

Значэнне па змаўчанні 'init'.

11.183 phase

Затрымка празрадковага відэа на адзін час поля, каб змяніць парадак палёў.

Меркаванае выкарыстанне - выправіць фільмы PAL, якія былі зняты з парадкам палёў, процілеглым перадачы з фільма на відэа.

Далей апісваюцца прынятыя параметры.

mode

Усталюйце фазавы рэжым.

Ён прымае наступныя значэнні:

't'

Парадак палёў захопу - зверху, перадача - знізу. Фільтр затрымае ніжняе поле.

'b'

Парадак палёў захопу - унізе, перадача - уверсе. Фільтр затрымае верхняе поле.

'p'

Захоп і перадача з такім жа парадкам палёў. Гэты рэжым існуе толькі для дакументацыі іншых параметраў, на якія можна спасылацца, але калі вы сапраўды выберыце яго, фільтр дакладна нічога не будзе рабіць.

'a'

Парадак палёў захопу вызначаецца аўтаматычна сцяжкамі палёў, перадача насупраць. Фільтр выбірае сярод "t'і'b' рэжымы на кадравай аснове з выкарыстаннем сцягоў палёў. Калі інфармацыя аб полі недаступная, гэта працуе гэтак жа, як 'u'.

'u'

Захоп невядомых або вар'іруючых, перадача насупраць. Фільтр выбірае сярод "t'і'b' на кадравай аснове, аналізуючы выявы і выбіраючы альтэрнатыву, якая дае лепшае супадзенне паміж палямі.

'T'

Захоп зверху, перадача невядомая або розная. Фільтр выбірае сярод "t'і'pз дапамогай аналізу выявы.

'B'

Захоп знізу, перадача невядомая або розная. Фільтр выбірае сярод "b'і'pз дапамогай аналізу выявы.

'A'

Захоп вызначаецца сцяжкамі палёў, перадача невядомая або змяняецца. Фільтр выбірае сярод "t','b'і'p' з дапамогай сцяжкоў палёў і аналізу малюнкаў. Калі інфармацыя аб полі недаступная, гэта працуе гэтак жа, як 'U'. Гэта рэжым па змаўчанні.

'U'

І захоп, і перадача невядомыя або розныя. Фільтр выбірае сярод "t','b'і'pтолькі з выкарыстаннем аналізу выявы.

11.183.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.184 photosensitivity

Паменшыце розныя ўспышкі ў відэа, каб дапамагчы карыстальнікам з эпілепсіяй.

Ён прымае наступныя варыянты:

frames, f

Усталюйце, колькі кадраў выкарыстоўваць пры фільтрацыі. Па змаўчанні 30.

threshold, t

Усталюйце парогавы каэфіцыент выяўлення. Па змаўчанні 1. Меншы - больш строгі.

skip

Усталюйце, колькі пікселяў прапускаць пры выбарцы кадраў. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 1024.

bypass

Рамкі пакінуць без зменаў. Па змаўчанні адключана.

11.185 pixdesctest

Тэставы фільтр дэскрыптара фармату пікселя, у асноўным карысны для ўнутранага тэсціравання. Выходнае відэа павінна быць роўным уваходнаму.

Напрыклад:

format=monow, pixdesctest

можа выкарыстоўвацца для праверкі вызначэння дэскрыптара фармату манабелага пікселя.

11.186 pixelize

Прымяніць пікселізацыю да відэаструменю.

Фільтр прымае наступныя параметры:

width, w
height, h

Усталюйце памеры блокаў, якія будуць выкарыстоўвацца для пікселізацыі. Значэнне па змаўчанні - 16.

mode, m

Усталюйце выкарыстоўваны рэжым пікселізацыі.

Магчымыя значэнні:

'avg'
'min'
'max'

Значэнне па змаўчанні - avg.

planes, p

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні фільтруюць усе плоскасці.

11.186.1 Commands

Гэты фільтр падтрымлівае ўсе параметры ў выглядзе каманд .

11.187 pixscope

Адлюстраванне прыкладных значэнняў каляровых каналаў. У асноўным карысна для праверкі колеру і ўзроўняў. Мінімальны падтрымліваемы дазвол - 640x480.

Фільтры прымаюць наступныя параметры:

x

Усталюйце становішча X, адноснае зрушэнне па восі X.

y

Усталюйце пазіцыю прыцэла па Y, адноснае зрушэнне па восі Y.

w

Задаць шырыню прыцэла.

h

Задаць вышыню прыцэла.

o

Задаць непразрыстасць акна. Гэта акно таксама змяшчае статыстыку аб плошчы пікселяў.

wx

Усталюйце пазіцыю акна X, адноснае зрушэнне па восі X.

wy

Усталюйце становішча акна па Y, адноснае зрушэнне па восі Y.

11.187.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.188 pp

Уключыце ўказаны ланцужок падфільтраў постапрацоўкі з дапамогай libpostproc. Гэтая бібліятэка павінна быць аўтаматычна выбрана з дапамогай зборкі GPL ( --enable-gpl). Падфільтры павінны быць падзеленыя знакам '/' і могуць быць адключаны, паставіўшы перад '-'. Кожны падфільтр і некаторыя параметры маюць кароткую і доўгую назву, якія можна выкарыстоўваць узаемазаменна, г. зн. dr/dering аднолькавыя.

Фільтры прымаюць наступныя параметры:

subfilters

Задаць радок падфільтраў постапрацоўкі.

Усе субфільтры маюць агульныя параметры для вызначэння іх вобласці:

a/autoq

Выконвайце патрабаванні якасці гэтага падфільтра.

c/chrom

Выканайце таксама фільтрацыю каляровасці (па змаўчанні).

y/nochrom

Выконвайце толькі фільтрацыю яркасці (без каляровасці).

n/noluma

Выконвайце толькі фільтрацыю каляровасці (без яркасці).

Гэтыя параметры могуць быць дададзены пасля назвы падфільтра, падзеленыя знакам '|'.

Даступныя падфільтры:

hb/hdeblock[|difference[|flatness]]

Гарызантальны фільтр дэблакіроўкі

difference

Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 32).

flatness

Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 39).

vb/vdeblock[|difference[|flatness]]

Вертыкальны дэблакавальны фільтр

difference

Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 32).

flatness

Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 39).

ha/hadeblock[|difference[|flatness]]

Дакладны гарызантальны фільтр для дэблакіроўкі

difference

Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 32).

flatness

Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 39).

va/vadeblock[|difference[|flatness]]

Дакладны фільтр для вертыкальнай дэблакіроўкі

difference

Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 32).

flatness

Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні: 39).

Гарызантальныя і вертыкальныя фільтры дэблакіроўкі маюць агульныя значэнні розніцы і роўнасці, таму вы не можаце ўсталяваць розныя гарызантальныя і вертыкальныя парогі.

h1/x1hdeblock

Эксперыментальны гарызантальны дэблакавальны фільтр

v1/x1vdeblock

Эксперыментальны фільтр для вертыкальнай дэблакіроўкі

dr/dering

Ачышчальны фільтр

tn/tmpnoise[|threshold1[|threshold2[|threshold3]]], temporal noise reducer
threshold1

большы -> мацнейшая фільтрацыя

threshold2

большы -> мацнейшая фільтрацыя

threshold3

большы -> мацнейшая фільтрацыя

al/autolevels[:f/fullyrange], automatic brightness / contrast correction
f/fullyrange

Расцягнуць яркасць да 0-255.

lb/linblenddeint

Лінейны фільтр дэінтэрлейсінгу, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі ўсіх радкоў з дапамогай (1 2 1)фільтра.

li/linipoldeint

Фільтр дэінтэрпаляцыі з лінейнай інтэрпаляцыяй, які дэінтэрпалюе дадзены блок шляхам лінейнай інтэрпаляцыі кожнага другога радка.

ci/cubicipoldeint

Кубічны інтэрпаляцыйны фільтр дэінтэрпаляцыі дэінтэрпалюе дадзены блок шляхам кубічнай інтэрпаляцыі кожнага другога радка.

md/mediandeint

Сярэдні фільтр дэінтэрлейсінгу, які дэінтэрлейсіруе дадзены блок шляхам прымянення медыяннага фільтра да кожнага другога радка.

fd/ffmpegdeint

Фільтр дэінтэрлейсінгу FFmpeg, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі кожнага другога радка з дапамогай (-1 4 2 4 -1)фільтра.

l5/lowpass5

Вертыкальна ўжыты FIR-фільтр дэінтэрлейсінгу нізкіх частот, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі ўсіх радкоў з дапамогай (-1 2 6 2 -1)фільтра.

fq/forceQuant[|quantizer]

Перавызначае табліцу квантавальніка з уваходу на ўказаны вамі пастаянны квантавальнік.

quantizer

Квантавальнік для выкарыстання

de/default

Стандартная камбінацыя фільтраў pp ( hb|a,vb|a,dr|a)

fa/fast

Хуткая камбінацыя фільтраў pp ( h1|a,v1|a,dr|a)

ac

Высакаякасная камбінацыя фільтраў pp ( ha|a|128|7,va|a,dr|a)

11.188.1 Examples

  • Прымяненне гарызантальнай і вертыкальнай дэблакіроўкі, дэрынгацыі і аўтаматычнай яркасці/кантрастнасці:
    pp=hb/vb/dr/al
    
  • Прымяніць стандартныя фільтры без карэкцыі яркасці/кантраснасці:
    pp=de/-al
    
  • Ужыць фільтры па змаўчанні і часовае прыглушэнне шуму:
    pp=default/tmpnoise|1|2|3
    
  • Ужывайце дэблакіроўку толькі для яркасці і аўтаматычна ўключайце або выключайце вертыкальную дэблакіроўку ў залежнасці ад даступнага часу ЦП:
    pp=hb|y/vb|a
    

11.189 pp7

Прымяніць фільтр постапрацоўкі 7. Гэта варыянт фільтра spp , падобны да spp = 6 з 7-кропкавым DCT, дзе пасля IDCT выкарыстоўваецца толькі цэнтральная выбарка.

Фільтр прымае наступныя параметры:

qp

Прымусова ўсталяваць пастаянны параметр квантавання. Ён прымае цэлы лік у дыяпазоне ад 0 да 63. Калі не ўсталяваны, фільтр будзе выкарыстоўваць QP з відэаплыні (пры наяўнасці).

mode

Усталюйце парогавы рэжым. Даступныя рэжымы:

'hard'

Усталюйце жорсткі парог.

'soft'

Усталюйце мяккі парог (лепшы эфект выдалення званка, але, верагодна, больш размыты).

'medium'

Усталюйце сярэдні парог (добрыя вынікі, па змаўчанні).

11.190 premultiply

Прымяніць эфект папярэдняга множання альфа-канала да ўваходнага відэапатоку з выкарыстаннем першай плоскасці другога патоку ў якасці альфа-канала.

Абодва патокі павінны мець аднолькавыя памеры і аднолькавы фармат пікселяў.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

inplace

Не патрабуецца другі ўвод для апрацоўкі, замест гэтага выкарыстоўвайце альфа-плоскасць з уваходнага патоку.

11.191 prewitt

Ужыць аператар prewitt для ўваходнага відэапатоку.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.

11.191.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.192 pseudocolor

Змяняйце колеры рамкі ў відэа з дапамогай псеўдаколераў.

Гэты фільтр прымае наступныя параметры:

c0

ўсталяваць выраз першага кампанента пікселя

c1

ўсталяваць выраз другога кампанента пікселя

c2

усталяваць выраз трэцяга кампанента пікселя

c3

усталяваць выраз чацвёртага кампанента пікселя, які адпавядае альфа-кампаненту

index, i

ўсталяваць кампанент для выкарыстання ў якасці асновы для змены колераў

preset, p

Выберыце адзін з убудаваных LUT. Па змаўчанні не ўстаноўлена.

Даступныя LUT:

'magma'
'inferno'
'plasma'
'viridis'
'turbo'
'cividis'
'range1'
'range2'
'shadows'
'highlights'
'solar'
'nominal'
'preferred'
'total'
opacity

Задаць непразрыстасць выходных колераў. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.

Кожны з варыянтаў выразаў вызначае выраз, які будзе выкарыстоўвацца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.

Выразы могуць утрымліваць наступныя канстанты і функцыі:

w
h

Шырыня і вышыня ўводу.

val

Уваходнае значэнне для піксельнага кампанента.

ymin, umin, vmin, amin

Мінімальна дазволенае значэнне кампанента.

ymax, umax, vmax, amax

Максімальна дазволенае значэнне кампанента.

Усе выразы па змаўчанні маюць "val".

11.192.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.192.2 Examples

  • Змяніць занадта высокія значэнні яркасці на градыент:
    pseudocolor="'if(between(val,ymax,amax),lerp(ymin,ymax,(val-ymax)/(amax-ymax)),-1):if(between(val,ymax,amax),lerp(umax,umin,(val-ymax)/(amax-ymax)),-1):if(between(val,ymax,amax),lerp(vmin,vmax,(val-ymax)/(amax-ymax)),-1):-1'"
    

11.193 psnr

Атрымайце сярэдняе, максімальнае і мінімальнае PSNR (пікавае стаўленне сігнал/шум) паміж двума ўваходнымі відэа.

Гэты фільтр прымае на ўваход два ўваходныя відэа, першы ўваход лічыцца "асноўнай" крыніцай і без змен перадаецца на выхад. Другі ўваход выкарыстоўваецца ў якасці "эталоннага" відэа для вылічэння PSNR.

Абодва відэаўваходы павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.

Атрыманае сярэдняе PSNR раздрукоўваецца праз сістэму каротажу.

Фільтр захоўвае назапашаную MSE (сярэднеквадратычную памылку) кожнага кадра, і ў канцы апрацоўкі яна ўсярэдніваецца па ўсіх кадрах аднолькава, і для атрымання PSNR прымяняецца наступная формула:

PSNR = 10*log10(MAX^2/MSE)

Дзе MAX - сярэдняе з максімальных значэнняў кожнага кампанента выявы.

Ніжэй прыводзіцца апісанне прынятых параметраў.

stats_file, f

Калі пазначаны, фільтр будзе выкарыстоўваць названы файл для захавання PSNR кожнага асобнага кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.

stats_version

Вызначае, якую версію фармату файла статыстыкі выкарыстоўваць. Падрабязнасці кожнага фармату апісаны ніжэй. Значэнне па змаўчанні - 1.

stats_add_max

Вызначае, ці выводзіцца максімальнае значэнне ў журнал статыстыкі. Значэнне па змаўчанні 0. Патрабуецца stats_version >= 2. Калі гэта ўстаноўлена і stats_version < 2, фільтр верне памылку.

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

Файл, які друкуецца stats_file, калі абраны, змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key: valueдля кожнай пары кадраў, якія параўноўваюцца.

Калі stats_versionўказана значэнне большае за 1, радок загалоўка папярэднічае спісу статыстыкі па пары кадраў з парамі ключоў і значэнняў пасля фармату кадра з наступнымі параметрамі:

psnr_log_version

Версія фармату файла журнала. Будзе адпавядаць stats_version.

fields

Спіс параметраў для кожнай пары кадраў, падзелены коскамі, уключаны ў журнал.

Ніжэй прыводзіцца апісанне кожнага паказанага параметра для кожнай пары кадраў:

n

парадкавы нумар уваходнага кадра, пачынаючы з 1

mse_avg

Сярэдняя квадратычная памылка сярэдняя піксельная сярэдняя розніца параўноўваных кадраў, асераднёная па ўсіх кампанентах выявы.

mse_y, mse_u, mse_v, mse_r, mse_g, mse_b, mse_a

Сярэдняя квадратычная памылка папіксельная сярэдняя розніца параўноўваных кадраў для кампанента, вызначанага суфіксам.

psnr_y, psnr_u, psnr_v, psnr_r, psnr_g, psnr_b, psnr_a

Пікавае стаўленне сігнал/шум параўноўваных кадраў для кампанента, вызначанага суфіксам.

max_avg, max_y, max_u, max_v

Максімальна дазволенае значэнне для кожнага канала і сярэдняе па ўсіх каналах.

11.193.1 Examples

  • Напрыклад:
    movie=ref_movie.mpg, setpts=PTS-STARTPTS [main];
    [main][ref] psnr="stats_file=stats.log" [out]
    

    У гэтым прыкладзе ўваходны файл, які апрацоўваецца, параўноўваецца з эталонным файламref_movie.mpg. PSNR кожнага асобнага кадра захоўваецца ўstats.log.

  • Яшчэ адзін прыклад з рознымі кантэйнерамі:
    ffmpeg -i main.mpg -i ref.mkv -lavfi  "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]psnr" -f null -
    

11.194 pullup

Рэверсіўны (зваротны тэлекіно) фільтр, здольны апрацоўваць змешаны жорсткі тэлекіно, прагрэсіўны кантэнт 24000/1001 кадраў/с і прагрэсіўны кантэнт 30000/1001 кадраў/с.

Фільтр падцягвання распрацаваны, каб выкарыстоўваць будучы кантэкст пры прыняцці рашэнняў. Гэты фільтр не мае стану ў тым сэнсе, што ён не замыкаецца на шаблоне, якому трэба прытрымлівацца, але замест гэтага ён чакае наступных палёў, каб ідэнтыфікаваць супадзенні і аднавіць прагрэсіўныя кадры.

Каб ствараць змесціва з аднолькавай частатой кадраў, устаўце фільтр кадраў у секунду пасля падцягвання, выкарыстоўвайце яго, fps=24000/1001калі ўваходная частата кадраў складае 29,97 кадраў у секунду, fps=24для 30 кадраў у секунду і (рэдкі) тэлекіно 25 кадраў у секунду.

Фільтр прымае наступныя параметры:

jl
jr
jt
jb

Гэтыя параметры вызначаюць колькасць «смецця», якое трэба ігнараваць, адпаведна злева, справа, уверсе і ўнізе выявы. Злева і справа - па 8 пікселяў, а зверху і знізу - па 2 радкі. Па змаўчанні 8 пікселяў з кожнага боку.

sb

Усталюйце строгія перапынкі. Усталяванне гэтага параметра ў 1 знізіць імавернасць таго, што фільтр час ад часу генеруе неадпаведныя кадры, але гэта таксама можа прывесці да выключэння празмернай колькасці кадраў падчас паслядоўнасцей з высокім рухам. І наадварот, усталяваўшы для яго значэнне -1, палягчаецца супадзенне палёў фільтраў. Гэта можа дапамагчы апрацоўцы відэа, дзе ёсць невялікая размытасць паміж палямі, але таксама можа прывесці да празрадковай разгорткі кадраў у вывадзе. Значэнне па змаўчанні - 0.

mp

Усталюйце метрычную плоскасць для выкарыстання. Ён прымае наступныя значэнні:

'l'

Выкарыстоўвайце плоскасць luma.

'u'

Выкарыстоўвайце каляровую сінюю плоскасць.

'v'

Выкарыстоўвайце каляровую чырвоную плоскасць.

Гэты параметр можа быць настроены на выкарыстанне плоскасці каляровасці замест стандартнай плоскасці яркасці для выканання вылічэнняў фільтра. Гэта можа павысіць дакладнасць вельмі чыстага зыходнага матэрыялу, але, хутчэй за ўсё, знізіць дакладнасць, асабліва калі ёсць каляровы шум (эфект вясёлкі) або любое відэа ў адценнях шэрага. Асноўная мэта ўстаноўкіmpда каляровай плоскасці - гэта паменшыць нагрузку на працэсар і зрабіць падцягванне выкарыстоўваным у рэальным часе на павольных машынах.

Для дасягнення найлепшых вынікаў (без дубляваных кадраў у выходным файле) неабходна змяніць выходную частату кадраў. Напрыклад, для зваротнага ўводу тэлекіно NTSC:

ffmpeg -i input -vf pullup -r 24000/1001 ...

11.195 qp

Змена параметраў квантавання відэа (QP).

Фільтр прымае наступныя параметры:

qp

Задаць выраз для параметра квантавання.

Выраз ацэньваецца праз eval API і можа ўтрымліваць, сярод іншага, наступныя канстанты:

known

1, калі індэкс не роўны 129, 0 у адваротным выпадку.

qp

Паслядоўны індэкс ад -129 да 128.

11.195.1 Examples

  • Нейкае ўраўненне накшталт:
    qp=2+2*sin(PI*qp)
    

11.196 random

Ачысціць відэакадры з унутранага кэша кадраў у выпадковым парадку. Ні адзін кадр не адкідаецца. Натхнёны нервовым фільтрам frei0r .

frames

Задайце памер у колькасці кадраў унутранага кэша ў дыяпазоне ад 2да 512. Па змаўчанні 30.

seed

Задаць пачатковы лік для генератара выпадковых лікаў, павінен быць цэлы лік паміж 0і UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена менш за 0, фільтр будзе спрабаваць выкарыстаць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.

11.197 readeia608

Чытайце інфармацыю субцітраў (EIA-608) з верхніх радкоў відэакадра.

Гэты фільтр дадае метаданыя кадра для lavfi.readeia608.X.ccі lavfi.readeia608.X.line, дзе Xнумар ідэнтыфікаванага радка з дадзенымі EIA-608 (пачынаючы з 0). Ніжэй прыводзіцца апісанне кожнага значэння метададзеных:

lavfi.readeia608.X.cc

Два байты, якія захоўваюцца ў выглядзе даных EIA-608 (друкуюцца ў шаснаццатковым выглядзе).

lavfi.readeia608.X.line

Нумар радка, у якім былі ідэнтыфікаваныя і счытаныя даныя EIA-608.

Гэты фільтр прымае наступныя параметры:

scan_min

Усталюйце радок для пачатку сканіравання даных EIA-608. Па змаўчанні 0.

scan_max

Усталюйце радок для завяршэння сканавання даных EIA-608. Па змаўчанні 29.

spw

Усталюйце суадносіны шырыні, зарэзерваванай для выяўлення кода сінхранізацыі. Па змаўчанні 0.27. Дазволены дыяпазон [0.1 - 0.7].

chp

Уключыць праверку біта цотнасці. У выпадку памылкі цотнасці фільтр будзе выводзіць 0x00для гэтага сімвала. Па змаўчанні - false.

lp

Лініі нізкіх частот перад далейшай апрацоўкай. Па змаўчанні ўключана.

11.197.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.197.2 Examples

  • Вывесці файл csv з часам прэзентацыі і першымі двума радкамі ідэнтыфікаваных даных цітраў EIA-608.
    ffprobe -f lavfi -i movie=captioned_video.mov,readeia608 -show_entries frame=pts_time:frame_tags=lavfi.readeia608.0.cc,lavfi.readeia608.1.cc -of csv
    

11.198 readvitc

Счытвайце інфармацыю пра таймкод вертыкальнага інтэрвалу (VITC) з верхніх радкоў відэакадра.

Фільтр дадае ключ метаданых кадра lavfi.readvitc.tc_strса значэннем тайм-кода, калі быў выяўлены сапраўдны тайм-код. Дадатковы ключ метаданых lavfi.readvitc.foundусталяваны ў 0/1 у залежнасці ад таго, былі знойдзены даныя часовага кода ці не.

Гэты фільтр прымае наступныя параметры:

scan_max

Усталюйце максімальную колькасць радкоў для сканавання даных VITC. Калі ўсталявана значэнне, -1скануецца поўны відэакадр. Па змаўчанні 45.

thr_b

Усталюйце парог яркасці для чорнага. Прымае лікі з плаваючай часткай у дыяпазоне [0.0,1.0], значэнне па змаўчанні 0.2. Значэнне павінна быць роўным або меншым за thr_w.

thr_w

Усталюйце парог яркасці для белага. Прымае лікі з плаваючай часткай у дыяпазоне [0.0,1.0], значэнне па змаўчанні 0.6. Значэнне павінна быць роўным або большым за thr_b.

11.198.1 Examples

  • Выяўляць і маляваць даныя VITC на відэакадры; калі сапраўдны VITC не выяўлены, намаляваць --:--:--:--у якасці запаўняльніка:
    ffmpeg -i input.avi -filter:v 'readvitc,drawtext=fontfile=FreeMono.ttf:text=%{metadata\\:lavfi.readvitc.tc_str\\:--\\\\\\:--\\\\\\:--\\\\\\:--}:x=(w-tw)/2:y=400-ascent'
    

11.199 remap

Пераназначце пікселі з дапамогай уваходнага відэаструменя 2nd: Xmap і 3rd: Ymap.

Піксель прызначэння ў пазіцыі (X, Y) будзе абраны з пазіцыі крыніцы (x, y), дзе x = Xmap(X, Y) і y = Ymap(X, Y). Калі значэнні адлюстравання выходзяць за межы дыяпазону, для пікселя прызначэння будзе выкарыстоўвацца нулявое значэнне для пікселя.

Уваходныя відэапатокі Xmap і Ymap павінны мець аднолькавы памер. Выхадны відэаструмень будзе мець памеры відэаструменю Xmap/Ymap. Уваходныя відэапатокі Xmap і Ymap маюць глыбіню 16 біт, аднаканальныя.

format

Укажыце піксельны фармат вываду з гэтага фільтра. Можа быць colorабо gray. Па змаўчанні color.

fill

Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні black.

11.200 removegrain

Фільтр removegrain - гэта прасторавае прымяненне шуму для прагрэсіўнага відэа.

m0

Усталюйце рэжым для першага самалёта.

m1

Усталюйце рэжым для другога самалёта.

m2

Усталюйце рэжым для трэцяга самалёта.

m3

Усталюйце рэжым для чацвёртага самалёта.

Дыяпазон рэжымаў ад 0 да 24. Апісанне кожнага рэжыму:

0

Пакіньце ўваходную плоскасць без зменаў. Па змаўчанні.

1

Выразае піксель з мінімальным і максімальным з 8 суседніх пікселяў.

2

Выразае піксель другім мінімумам і максімумам з 8 суседніх пікселяў.

3

Адразае піксель з трэцім мінімумам і максімумам з 8 суседніх пікселяў.

4

Адразае піксель з чацвёртым мінімумам і максімумам з 8 суседніх пікселяў. Гэта эквівалентна сярэдняму фільтру.

5

Абразанне з улікам ліній забяспечвае мінімальныя змены.

6

Выразанне з улікам лініі, прамежкавае.

7

Выразанне з улікам лініі, прамежкавае.

8

Выразанне з улікам лініі, прамежкавае.

9

Адразанне з улікам лініі на лініі, дзе бліжэйшыя пікселі знаходзяцца бліжэй за ўсё.

10

Замяняе мэтавы піксель бліжэйшым суседам.

11

[1 2 1] гарызантальнае і вертыкальнае размыццё ядра.

12

Тое самае, што і рэжым 11.

13

Рэжым Боба інтэрпалюе верхняе поле ад радка, дзе бліжэйшыя суседнія пікселі.

14

Рэжым Боба інтэрпалюе ніжняе поле ад лініі, дзе бліжэйшыя суседнія пікселі.

15

Рэжым Боб, інтэрпалюе верхняе поле. Тое самае, што і 13, але з больш складанай формулай інтэрпаляцыі.

16

Рэжым Боб, інтэрпалюе ніжняе поле. Тое самае, што і 14, але з больш складанай формулай інтэрпаляцыі.

17

Адсякае піксель з мінімумам і максімумам, адпаведна, максімумам і мінімумам кожнай пары супрацьлеглых суседніх пікселяў.

18

Адсячэнне з улікам лініі з выкарыстаннем супрацьлеглых суседзяў, найбольшая адлегласць якіх ад бягучага пікселя мінімальная.

19

Замяняе піксель сярэднім з 8 яго суседзяў.

20

У сярэднім 9 пікселяў ([1 1 1] гарызантальнае і вертыкальнае размыццё).

21

Выразае пікселі з выкарыстаннем сярэдніх значэнняў супрацьлеглага суседа.

22

Такі ж, як і рэжым 21, але больш просты і хуткі.

23

Невялікі край і выдаленне гало, але лічыцца бескарысным.

24

Падобна на 23.

11.201 removelogo

Схаваць лагатып тэлевізійнай станцыі, выкарыстоўваючы файл выявы, каб вызначыць, якія пікселі складаюць лагатып. Ён працуе шляхам запаўнення пікселяў, якія складаюць лагатып, суседнімі пікселямі.

Фільтр прымае наступныя параметры:

filename, f

Усталюйце растравы файл фільтра, які можа быць любога фармату выявы, які падтрымліваецца libavformat. Шырыня і вышыня файла выявы павінны адпавядаць шырыні і вышыні відэаструменю, які апрацоўваецца.

Пікселі ў прадстаўленым растравым малюнку з нулявым значэннем не лічацца часткай лагатыпа, а ненулявыя пікселі лічацца часткай лагатыпа. Калі вы выкарыстоўваеце белы (255) для лагатыпа і чорны (0) для астатніх, вы будзеце ў бяспецы. Каб стварыць растравы малюнак фільтра, рэкамендуецца зрабіць здымак экрана чорнай рамкі з бачным лагатыпам, а затым выкарыстаць парогавы фільтр, а затым адзін ці два разы фільтр размывання.

Пры неабходнасці невялікія плямы можна выправіць ўручную. Памятайце, што калі пікселі лагатыпа не пакрытыя, якасць фільтра будзе значна зніжана. Пазначэнне занадта вялікай колькасці пікселяў як часткі лагатыпа не так моцна шкодзіць, але гэта павялічыць колькасць размыцця, неабходнага для пакрыцця выявы, і знішчыць больш інфармацыі, чым неабходна, а дадатковыя пікселі запаволіць працу на вялікім лагатыпе.

11.202 repeatfields

Гэты фільтр выкарыстоўвае сцяжок repeat_field з загалоўкаў Video ES і палі жорсткіх паўтораў на аснове яго значэння.

11.203 reverse

Перавярнуць відэакліп.

Папярэджанне: гэтаму фільтру патрабуецца памяць для буферызацыі ўсяго кліпа, таму рэкамендуецца абрэзаць.

11.203.1 Examples

  • Вазьміце першыя 5 секунд кліпа і перавярніце яго назад.
    trim=end=5,reverse
    

11.204 rgbashift

Зрух R/G/B/A пікселяў па гарызанталі і/або вертыкалі.

Фільтр прымае наступныя параметры:

rh

Усталюйце велічыню зрушэння чырвонага па гарызанталі.

rv

Усталюйце колькасць зруху чырвонага па вертыкалі.

gh

Усталюйце колькасць зрушэння зялёнага колеру па гарызанталі.

gv

Усталюйце колькасць зрушэння зялёнага колеру па вертыкалі.

bh

Усталюйце колькасць для зрушэння сіняга колеру па гарызанталі.

bv

Усталюйце колькасць зрушэння сіняга колеру па вертыкалі.

ah

Усталюйце велічыню зрушэння альфа-канала па гарызанталі.

av

Усталюйце колькасць зруху альфа-версіі па вертыкалі.

edge

Усталяваць рэжым краю, можа быць smear, стандартны або warp.

11.204.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.205 roberts

Прымяненне крыжаванага аператара Робертса для ўваходнага відэапатоку.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.

11.205.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.206 rotate

Павярнуць відэа на адвольны кут, выражаны ў радыянах.

Фільтр прымае наступныя параметры:

Ніжэй прыводзіцца апісанне дадатковых параметраў.

angle, a

Усталюйце выраз для вугла, на які трэба павярнуць уваходнае відэа па гадзіннікавай стрэлцы, выражанага ў колькасці радыян. Адмоўнае значэнне прывядзе да павароту супраць гадзіннікавай стрэлкі. Па змаўчанні ён усталяваны ў "0".

Гэты выраз вылічваецца для кожнага кадра.

out_w, ow

Задайце выраз шырыні вываду, значэнне па змаўчанні - "iw". Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі.

out_h, oh

Усталюйце выраз вышыні вываду, значэнне па змаўчанні - "ih". Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі.

bilinear

Уключыць білінейную інтэрпаляцыю, калі зададзена значэнне 1, значэнне 0 адключае яе. Значэнне па змаўчанні - 1.

fillcolor, c

Усталюйце колер, які выкарыстоўваецца для запаўнення вобласці вываду, не пакрытай павернутым відарысам. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выбрана спецыяльнае значэнне «няма», фон не друкуецца (карысна, напрыклад, калі фон ніколі не паказваецца).

Значэнне па змаўчанні - "чорны".

Выразы для вугла і выхаднога памеру могуць утрымліваць наступныя канстанты і функцыі:

n

парадкавы нумар уваходнага кадра, пачынаючы з 0. Заўсёды NAN перад фільтраваннем першага кадра.

t

час у секундах уваходнага кадра, ён усталяваны ў 0, калі фільтр настроены. Заўсёды NAN перад фільтраваннем першага кадра.

hsub
vsub

гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

in_w, iw
in_h, ih

шырыня і вышыня ўваходнага відэа

out_w, ow
out_h, oh

шырыня і вышыня вываду, гэта значыць памер запаўненай вобласці, вызначаны выразамі widthіheight

rotw(a)
roth(a)

мінімальная шырыня/вышыня, неабходная для поўнага ўтрымання ўваходнага відэа, павернутага ў aрадыянах.

Яны даступныя толькі пры вылічэнніout_wі out_hвыразы.

11.206.1 Examples

  • Павярнуць увод на PI/6 радыян па гадзіннікавай стрэлцы:
    rotate=PI/6
    
  • Павярнуць увод на PI/6 радыян супраць гадзіннікавай стрэлкі:
    rotate=-PI/6
    
  • Павярнуць увод на 45 градусаў па гадзіннікавай стрэлцы:
    rotate=45*PI/180
    
  • Прымяніць пастаяннае кручэнне з перыядам T, пачынаючы з вугла PI/3:
    rotate=PI/3+2*PI*t/T
    
  • Зрабіце паварот уваходнага відэа вагальным з перыядам Т секунд і амплітудай А радыян:
    rotate=A*sin(2*PI/T*t)
    
  • Паварот відэа, памер вываду выбіраецца такім чынам, каб усё паваротнае ўваходнае відэа заўсёды цалкам утрымлівалася ў вывадзе:
    rotate='2*PI*t:ow=hypot(iw,ih):oh=ow'
    
  • Павярніце відэа, паменшыце памер вываду, каб фон ніколі не паказваўся:
    rotate=2*PI*t:ow='min(iw,ih)/sqrt(2)':oh=ow:c=none
    

11.206.2 Commands

Фільтр падтрымлівае наступныя каманды:

a, angle

Задайце выраз вугла. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.207 sab

Прымяніць адаптыўнае размыццё формы.

Фільтр прымае наступныя параметры:

luma_radius, lr

Задаць інтэнсіўнасць фільтра размыцця яркасці, павінна быць значэнне ў дыяпазоне 0,1-4,0, значэнне па змаўчанні роўна 1,0. Большае значэнне прывядзе да больш размытай выявы і больш павольнай апрацоўкі.

luma_pre_filter_radius, lpfr

Задаць радыус папярэдняга фільтра яркасці, павінна быць значэнне ў дыяпазоне 0,1-2,0, значэнне па змаўчанні роўна 1,0.

luma_strength, ls

Устанавіць максімальную розніцу ў яркасці паміж пікселямі, якая будзе ўлічвацца, павінна быць значэнне ў дыяпазоне 0,1-100,0, значэнне па змаўчанні роўна 1,0.

chroma_radius, cr

Усталюйце сілу фільтра каляровага размыцця, значэнне павінна быць у дыяпазоне -0,9-4,0. Большае значэнне прывядзе да больш размытай выявы і больш павольнай апрацоўкі.

chroma_pre_filter_radius, cpfr

Задайце радыус папярэдняга фільтра каляровасці, павінна быць значэнне ў дыяпазоне -0,9-2,0.

chroma_strength, cs

Устанавіць максімальную розніцу каляровасці паміж пікселямі, якая будзе ўлічвацца, павінна быць значэнне ў дыяпазоне -0,9-100,0.

Кожнае значэнне параметра каляровасці, калі яно не вызначана відавочна, усталёўваецца ў адпаведнае значэнне параметра яркасці.

11.208 scale

Маштабуйце (змяняйце памер) уваходнага відэа з дапамогай бібліятэкі libswscale.

Фільтр маштабу прымушае суадносіны бакоў выхаднога дысплея быць такімі ж, як і ўваходныя, шляхам змены суадносін бакоў выхаднога ўзору.

Калі фармат уваходнага відарыса адрозніваецца ад фармату, запытанага наступным фільтрам, фільтр маштабу пераўтворыць уваход у запытаны фармат.

11.208.1 Options

Фільтр прымае наступныя параметры або любыя з варыянтаў, якія падтрымліваюцца праграмай маштабавання libswscale.

Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для поўнага спісу параметраў маштабавання.

width, w
height, h

Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.

Калі значэнне widthor wроўна 0, шырыня ўводу выкарыстоўваецца для вываду. Калі значэнне heightor hроўна 0, вышыня ўводу выкарыстоўваецца для вываду.

Калі адно і толькі адно са значэнняў роўна -n з n >= 1, фільтр маштабу будзе выкарыстоўваць значэнне, якое падтрымлівае суадносіны бакоў уваходнага відарыса, разлічаныя з іншага зададзенага памеру. Аднак пасля гэтага ён пераканаецца, што вылічаны памер дзеліцца на n, і пры неабходнасці скарэктуе значэнне.

Калі абодва значэнні маюць -n з n >= 1, паводзіны будуць аднолькавымі да таго, што для абодвух значэнняў будзе прысвоена 0, як было апісана раней.

Глядзіце ніжэй спіс прынятых канстант для выкарыстання ў выразе памернасці.

eval

Укажыце, калі ацэньваць widthі heightвыраз. Ён прымае наступныя значэнні:

'init'

Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.

'frame'

Ацаніце выразы для кожнага ўваходнага кадра.

Значэнне па змаўчанні 'init'.

interl

Усталюйце рэжым перапляцення. Ён прымае наступныя значэнні:

'1'

Прымусовае празрадковае ўсвядомленае маштабаванне.

'0'

Не ўжывайце празрадковае маштабаванне.

'-1'

Выберыце празрадковае ўсвядомленае маштабаванне ў залежнасці ад таго, пазначаны зыходныя кадры як празрадковыя ці не.

Значэнне па змаўчанні '0'.

flags

Усталюйце сцягі маштабавання libswscale. Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для атрымання поўнага спісу значэнняў. Калі гэта не вызначана відавочна, фільтр прымяняе сцягі па змаўчанні.

param0, param1

Усталюйце ўваходныя параметры libswscale для алгарытмаў маштабавання, якім яны патрэбныя. Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для атрымання поўнай дакументацыі. Калі гэта не пазначана відавочна, фільтр прымяняе пустыя параметры.

size, s

Усталюйце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

in_color_matrix
out_color_matrix

Задаць тып каляровай прасторы ўваходу/вываду YCbCr.

Гэта дазваляе перавызначыць аўтаматычна вызначанае значэнне, а таксама дазваляе прымусова ўводзіць пэўнае значэнне, якое выкарыстоўваецца для вываду і кадавальніка.

Калі не пазначана, тып каляровай прасторы залежыць ад фармату пікселяў.

Магчымыя значэнні:

'auto'

Выбіраць аўтаматычна.

'bt709'

Фармат адпавядае рэкамендацыі Міжнароднага саюза электрасувязі (МСЭ) BT.709.

'fcc'

Усталюйце каляровую прастору ў адпаведнасці з кодэксам федэральных правілаў (CFR) Федэральнай камісіі ЗША па сувязі (FCC), раздзел 47 (2003) 73.682 (a).

'bt601'
'bt470'
'smpte170m'

Усталюйце каляровую прастору ў адпаведнасці з:

  • Рэкамендацыя Сектара радыёсувязі МСЭ (МСЭ-R) BT.601
  • Рэк. МСЭ-R BT.470-6 (1998) Сістэмы B, B1 і G
  • Таварыства інжынераў па кіно і тэлебачанні (SMPTE) ST 170:2004
'smpte240m'

Усталюйце каляровую прастору ў адпаведнасці са SMPTE ST 240:1999.

'bt2020'

Усталюйце каляровую прастору ў адпаведнасці з сістэмай непастаяннай яркасці ITU-R BT.2020.

in_range
out_range

Усталяваць уваходны/выхадны дыяпазон выбаркі YCbCr.

Гэта дазваляе перавызначыць аўтаматычна вызначанае значэнне, а таксама дазваляе прымусова ўводзіць пэўнае значэнне, якое выкарыстоўваецца для вываду і кадавальніка. Калі не пазначана, дыяпазон залежыць ад фармату пікселяў. Магчымыя значэнні:

'auto/unknown'

Выбіраць аўтаматычна.

'jpeg/full/pc'

Усталюйце поўны дыяпазон (0-255 у выпадку 8-бітнай яркасці).

'mpeg/limited/tv'

Усталюйце дыяпазон «MPEG» (16-235 у выпадку 8-бітнай яркасці).

force_original_aspect_ratio

Пры неабходнасці ўключыце памяншэнне або павелічэнне шырыні або вышыні выходнага відэа, каб захаваць зыходныя суадносіны бакоў. Магчымыя значэнні:

'disable'

Павялічце відэа ў адпаведнасці з указаннямі і адключыце гэту функцыю.

'decrease'

Памеры выхаднога відэа будуць аўтаматычна памяншацца пры неабходнасці.

'increase'

Памеры выхаднога відэа будуць аўтаматычна павялічаны пры неабходнасці.

Адным з карысных прыкладаў гэтай опцыі з'яўляецца тое, што, калі вы ведаеце максімальна дазволеную раздзяляльнасць пэўнай прылады, вы можаце выкарыстоўваць яе, каб абмежаваць выхад відэа гэтым, захоўваючы суадносіны бакоў. Напрыклад, прылада A дазваляе прайграваць 1280x720, а ваша відэа мае 1920x800. Выкарыстанне гэтай опцыі (усталюйце для яе памяншэнне) і ўказанне 1280x720 у камандным радку робіць выхад 1280x533.

Звярніце ўвагу, што гэта адрозніваецца ад указання -1 дляw абоh, вам усё роўна трэба ўказаць разрозненне вываду, каб гэты параметр працаваў.

force_divisible_by

Гарантуе, што абодва выходныя памеры, шырыня і вышыня, дзеляцца на зададзены цэлы лік пры выкарыстанні разам зforce_original_aspect_ratio. Гэта працуе падобна на выкарыстанне -nўwіhопцыі.

Гэты параметр улічвае значэнне, зададзенае дляforce_original_aspect_ratio, адпаведна павялічваючы або памяншаючы дазвол. Суадносіны бакоў відэа могуць быць крыху зменены.

Гэтая опцыя можа быць зручнай, калі вам трэба, каб відэа змясцілася ў межах вызначанага дазволу або перавышала ягоforce_original_aspect_ratioале таксама ёсць абмежаванні кадавальніка па шырыні і вышыні.

Каштоўнасці стwіhпараметры - гэта выразы, якія змяшчаюць наступныя канстанты:

in_w
in_h

Шырыня і вышыня ўводу

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Шырыня і вышыня вываду (у маштабе).

ow
oh

Гэта тое самае, што out_wіout_h

a

Тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

Суадносіны бакоў уваходнага дысплея. Разлічваецца з (iw / ih) * sar.

hsub
vsub

гарызантальныя і вертыкальныя ўваходныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

ohsub
ovsub

гарызантальныя і вертыкальныя вывадныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

n

(Парадкавы) нумар уваходнага кадра, пачынаючы з 0. Даступна толькі з eval=frame.

t

Метка часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з eval=frame.

pos

Палажэнне (байтавае зрушэнне) кадра ва ўваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з eval=frame.

11.208.2 Examples

  • Павялічце ўваходнае відэа да памеру 200x100
    scale=w=200:h=100
    

    Гэта эквівалентна:

    scale=200:100
    

    або:

    scale=200x100
    
  • Укажыце абрэвіятуру памеру для выхаднога памеру:
    scale=qcif
    

    што таксама можа быць запісана як:

    scale=size=qcif
    
  • Павялічце ўвод у 2 разы:
    scale=w=2*iw:h=2*ih
    
  • Вышэй тое самае, што:
    scale=2*in_w:2*in_h
    
  • Павялічце ўвод да 2x з прымусовым празрадковым маштабаваннем:
    scale=2*iw:2*ih:interl=1
    
  • Паменшыць увод да паловы памеру:
    scale=w=iw/2:h=ih/2
    
  • Павялічце шырыню і ўсталюйце той жа памер для вышыні:
    scale=3/2*iw:ow
    
  • Шукайце грэчаскую гармонію:
    scale=iw:1/PHI*iw
    scale=ih*PHI:ih
    
  • Павялічце вышыню і ўсталюйце шырыню на 3/2 вышыні:
    scale=w=3/2*oh:h=3/5*ih
    
  • Павялічце памер, зрабіўшы памер кратным значэнням падвыбаркі каляровасці:
    scale="trunc(3/2*iw/hsub)*hsub:trunc(3/2*ih/vsub)*vsub"
    
  • Павялічце шырыню максімум да 500 пікселяў, захаваўшы тыя ж суадносіны бакоў, што і ўвод:
    scale=w='min(500\, iw*3/2):h=-1'
    
  • Зрабіце пікселі квадратнымі, камбінуючы маштаб і набор:
    scale='trunc(ih*dar):ih',setsar=1/1
    
  • Зрабіце пікселі квадратнымі, аб'яднаўшы scale і setsar, пераканаўшыся, што выніковае раздзяленне роўнае (патрабуецца некаторымі кодэкамі):
    scale='trunc(ih*dar/2)*2:trunc(ih/2)*2',setsar=1/1
    

11.208.3 Commands

Гэты фільтр падтрымлівае наступныя каманды:

width, w
height, h

Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.209 scale_cuda

Маштабуйце (змяняйце памер) і пераўтварайце (піксельны фармат) уваходнае відэа з дапамогай паскораных ядраў CUDA. Налада выхадных шырыні і вышыні працуе гэтак жа, як і для маштабнага фільтра.

Фільтр прымае наступныя параметры:

w
h

Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.

Дазваляе тыя ж выразы, што і маштабны фільтр.

interp_algo

Задае алгарытм, які выкарыстоўваецца для маштабавання:

nearest

Бліжэйшы сусед

Выкарыстоўваецца па змаўчанні, калі ўваходныя параметры супадаюць з жаданым выхадам.

bilinear

Білінейны

bicubic

Бікубічны

Гэта па змаўчанні.

lanczos

Ланцош

format

Кіруе фарматам выхаднога пікселя. Па змаўчанні або, калі не пазначана, выкарыстоўваецца ўваходны фармат пікселяў.

Фільтр не падтрымлівае пераўтварэнне паміж фарматамі пікселяў YUV і RGB.

passthrough

Калі ўстаноўлена значэнне 0, апрацоўваецца кожны кадр, нават калі пераўтварэнне не патрабуецца. Гэты рэжым можа быць карысны для выкарыстання фільтра ў якасці буфера для спажыўца фрэйма ніжэй па плыні, які вычэрпвае абмежаваны пул кадраў дэкодэра.

Калі ўстаноўлена ў 1, кадры перадаюцца як ёсць, калі яны адпавядаюць жаданым выходным параметрам. Гэта паводзіны па змаўчанні.

param

Спецыфічны для алгарытму параметр.

Уплывае на крывыя бікубічнага алгарытму.

force_original_aspect_ratio
force_divisible_by

Працуюць гэтак жа, як і ідэнтычныя варыянты маштабнага фільтра.

11.209.1 Examples

  • Маштабуйце ўваход да 720p, захоўваючы суадносіны бакоў і забяспечваючы выхад yuv420p.
    scale_cuda=-2:720:format=yuv420p
    
  • Павялічыць да 4K з выкарыстаннем алгарытму бліжэйшага суседа.
    scale_cuda=4096:2160:interp_algo=nearest
    
  • Не рабіце ніякіх пераўтварэнняў або маштабавання, але скапіруйце ўсе ўваходныя кадры ў новыя выдзеленыя. Гэта можа быць карысна для працы з ланцужком фільтра і кадавання, які ў іншым выпадку вычэрпвае пул кадраў дэкодэра.
    scale_cuda=passthrough=0
    

11.210 scale_npp

Выкарыстоўвайце NVIDIA Performance Primitives (libnpp) для выканання маштабавання і/або пераўтварэння фармату пікселяў на відэакадрах CUDA. Наладжванне шырыні і вышыні вываду працуе гэтак жа, як і для scaleфільтра.

Прымаюцца наступныя дадатковыя варыянты:

format

Піксельны фармат выходных кадраў CUDA. Калі ўсталяваны радок "same" (па змаўчанні), фармат уводу будзе захаваны. Звярніце ўвагу, што аўтаматычнае ўзгадненне фармату і пераўтварэнне пакуль не падтрымліваюцца для апаратных кадраў

interp_algo

Алгарытм інтэрпаляцыі, які выкарыстоўваецца для змены памеру. Адзін з наступнага:

nn

Бліжэйшы сусед.

linear
cubic
cubic2p_bspline

Кубік з 2 параметрамі (B=1, C=0)

cubic2p_catmullrom

Кубік з 2 параметрамі (B=0, C=1/2)

cubic2p_b05c03

Кубік з 2 параметрамі (B=1/2, C=3/10)

super

Суперсэмплінг

lanczos
force_original_aspect_ratio

Пры неабходнасці ўключыце памяншэнне або павелічэнне шырыні або вышыні выходнага відэа, каб захаваць зыходныя суадносіны бакоў. Магчымыя значэнні:

'disable'

Павялічце відэа ў адпаведнасці з указаннямі і адключыце гэту функцыю.

'decrease'

Памеры выхаднога відэа будуць аўтаматычна памяншацца пры неабходнасці.

'increase'

Памеры выхаднога відэа будуць аўтаматычна павялічаны пры неабходнасці.

Адным з карысных прыкладаў гэтай опцыі з'яўляецца тое, што, калі вы ведаеце максімальна дазволеную раздзяляльнасць пэўнай прылады, вы можаце выкарыстоўваць яе, каб абмежаваць выхад відэа гэтым, захоўваючы суадносіны бакоў. Напрыклад, прылада A дазваляе прайграваць 1280x720, а ваша відэа мае 1920x800. Выкарыстанне гэтай опцыі (усталюйце для яе памяншэнне) і ўказанне 1280x720 у камандным радку робіць выхад 1280x533.

Звярніце ўвагу, што гэта адрозніваецца ад указання -1 дляw абоh, вам усё роўна трэба ўказаць разрозненне вываду, каб гэты параметр працаваў.

force_divisible_by

Гарантуе, што абодва выходныя памеры, шырыня і вышыня, дзеляцца на зададзены цэлы лік пры выкарыстанні разам зforce_original_aspect_ratio. Гэта працуе падобна на выкарыстанне -nўwіhопцыі.

Гэты параметр улічвае значэнне, зададзенае дляforce_original_aspect_ratio, адпаведна павялічваючы або памяншаючы дазвол. Суадносіны бакоў відэа могуць быць крыху зменены.

Гэтая опцыя можа быць зручнай, калі вам трэба, каб відэа змясцілася ў межах вызначанага дазволу або перавышала ягоforce_original_aspect_ratioале таксама ёсць абмежаванні кадавальніка па шырыні і вышыні.

eval

Укажыце, калі ацэньваць widthі heightвыраз. Ён прымае наступныя значэнні:

'init'

Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.

'frame'

Ацаніце выразы для кожнага ўваходнага кадра.

Каштоўнасці стwіhпараметры - гэта выразы, якія змяшчаюць наступныя канстанты:

in_w
in_h

Шырыня і вышыня ўводу

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Шырыня і вышыня вываду (у маштабе).

ow
oh

Гэта тое самае, што out_wіout_h

a

Тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

Суадносіны бакоў уваходнага дысплея. Разлічваецца з (iw / ih) * sar.

n

(Парадкавы) нумар уваходнага кадра, пачынаючы з 0. Даступна толькі з eval=frame.

t

Метка часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з eval=frame.

pos

Палажэнне (байтавае зрушэнне) кадра ва ўваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з eval=frame.

11.211 scale2ref

Маштабаванне (змена памеру) уваходнага відэа на аснове эталоннага відэа.

Глядзіце фільтр маштабу, каб даведацца пра даступныя параметры, scale2ref падтрымлівае тое ж самае, але выкарыстоўвае эталоннае відэа замест асноўнага ўводу ў якасці асновы. scale2ref таксама падтрымлівае наступныя дадатковыя канстанты дляwі hварыянты:

main_w
main_h

Шырыня і вышыня асноўнага ўваходнага відэа

main_a

Тое самае, што main_w/main_h

main_sar

Узор суадносін бакоў асноўнага ўваходнага відэа

main_dar, mdar

Суадносіны бакоў адлюстравання асноўнага ўваходнага відэа. Разлічваецца з (main_w / main_h) * main_sar.

main_hsub
main_vsub

Значэнні падвыбаркі каляровасці асноўнага ўваходнага відэа па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsub роўна 1.

main_n

(Парадкавы) нумар асноўнага кадра ўводу, пачынаючы з 0. Даступна толькі з eval=frame.

main_t

Метка часу прэзентацыі асноўнага ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з eval=frame.

main_pos

Палажэнне (байтавае зрушэнне) кадра ў асноўным уваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з eval=frame.

11.211.1 Examples

  • Перад накладаннем змяніце паток субтытраў (b), каб ён адпавядаў памеру асноўнага відэа (a).
    'scale2ref[b][a];[a][b]overlay'
    
  • Павялічце лагатып да 1/10 вышыні відэа, захаваўшы суадносіны бакоў экрана.
    [logo-in][video-in]scale2ref=w=oh*mdar:h=ih/10[logo-out][video-out]
    

11.211.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

width, w
height, h

Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

11.212 scale2ref_npp

Выкарыстоўвайце NVIDIA Performance Primitives (libnpp), каб маштабаваць (змяняць памер) уваходнага відэа на аснове эталоннага відэа.

Глядзіце фільтр scale_npp , каб даведацца пра даступныя параметры, scale2ref_npp падтрымлівае тое ж самае, але выкарыстоўвае эталоннае відэа замест асноўнага ўводу ў якасці асновы. scale2ref_npp таксама падтрымлівае наступныя дадатковыя канстанты дляwі hварыянты:

main_w
main_h

Шырыня і вышыня асноўнага ўваходнага відэа

main_a

Тое самае, што main_w/main_h

main_sar

Узор суадносін бакоў асноўнага ўваходнага відэа

main_dar, mdar

Суадносіны бакоў адлюстравання асноўнага ўваходнага відэа. Разлічваецца з (main_w / main_h) * main_sar.

main_n

(Парадкавы) нумар асноўнага кадра ўводу, пачынаючы з 0. Даступна толькі з eval=frame.

main_t

Метка часу прэзентацыі асноўнага ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з eval=frame.

main_pos

Палажэнне (байтавае зрушэнне) кадра ў асноўным уваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з eval=frame.

11.212.1 Examples

  • Перад накладаннем змяніце паток субтытраў (b), каб ён адпавядаў памеру асноўнага відэа (a).
    'scale2ref_npp[b][a];[a][b]overlay_cuda'
    
  • Павялічце лагатып да 1/10 вышыні відэа, захаваўшы суадносіны бакоў экрана.
    [logo-in][video-in]scale2ref_npp=w=oh*mdar:h=ih/10[logo-out][video-out]
    

11.213 scharr

Прымяніць аператар scharr да ўваходнага відэаструменю.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.

11.213.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.214 scroll

Пракрутка ўваходнага відэа па гарызанталі і/ці па вертыкалі з пастаяннай хуткасцю.

Фільтр прымае наступныя параметры:

horizontal, h

Усталюйце хуткасць гарызантальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1. Адмоўныя значэнні змяняюць кірунак пракруткі.

vertical, v

Усталюйце хуткасць вертыкальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1. Адмоўныя значэнні змяняюць кірунак пракруткі.

hpos

Усталюйце пачатковае становішча гарызантальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 1.

vpos

Усталюйце пачатковае становішча вертыкальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 1.

11.214.1 Commands

Гэты фільтр падтрымлівае наступныя каманды :

horizontal, h

Усталюйце хуткасць гарызантальнай пракруткі.

vertical, v

Усталюйце хуткасць вертыкальнай пракруткі.

11.215 scdet

Выяўленне змены сцэны відэа.

Гэты фільтр усталёўвае метаданыя кадра з mafd паміж кадрам, ацэнкай сцэны і перанакіроўвае кадр да наступнага фільтра, каб яны маглі выкарыстоўваць гэтыя метаданыя для выяўлення змены сцэны ці іншых.

Акрамя таго, гэты фільтр рэгіструе паведамленне і ўсталёўвае метаданыя кадра пры выяўленні змены сцэныthreshold.

lavfi.scd.mafdключы метададзеных усталёўваюцца з дапамогай mafd для кожнага кадра.

lavfi.scd.scoreключы метададзеных усталёўваюцца з ацэнкай змены сцэны для кожнага кадра для выяўлення змены сцэны.

lavfi.scd.timeключы метададзеных усталёўваюцца з бягучым адфільтраваным часам кадра, які вызначае змену сцэныthreshold.

Фільтр прымае наступныя параметры:

threshold, t

Усталюйце парог выяўлення змены сцэны ў працэнтах ад максімальнай змены. Добрыя значэння знаходзяцца ў [8.0, 14.0]дыяпазоне. Асартымент дляthresholdёсць [0., 100.].

Значэнне па змаўчанні - 10..

sc_pass, s

Усталюйце сцяг для перадачы кадраў змены сцэны ў наступны фільтр. Значэнне па змаўчанні - 0 Вы можаце ўключыць яго, калі хочаце атрымаць здымак толькі кадраў змены сцэны.

11.216 selectivecolor

Адрэгулюйце блакітны, пурпурны, жоўты і чорны (CMYK) для пэўных дыяпазонаў колераў (напрыклад, «чырвоныя», «жоўтыя», «зялёныя», «блакітныя», ...). Дыяпазон рэгулявання вызначаецца «чысцінёй» колеру (гэта значыць, наколькі ён ужо насычаны).

Гэты фільтр падобны да інструмента Adobe Photoshop Selective Color.

Фільтр прымае наступныя параметры:

correction_method

Выберыце метад карэкцыі колеру.

Даступныя значэнні:

'absolute'

Указаныя карэкціроўкі прымяняюцца "як ёсць" (дадаюцца/адымаюцца да зыходнага значэння піксельнага кампанента).

'relative'

Указаныя карэкціроўкі адносяцца да зыходнага значэння кампанента.

Па змаўчанні absolute.

reds

Карэкціроўкі для чырвоных пікселяў (пікселяў, дзе чырвоны кампанент максімальны)

yellows

Карэкціроўкі жоўтых пікселяў (пікселяў, дзе сіні кампанент мінімальны)

greens

Карэкціроўкі для зялёных пікселяў (пікселяў, у якіх зялёны кампанент максімальны)

cyans

Карэкціроўкі блакітных пікселяў (пікселяў, у якіх чырвоны кампанент мінімальны)

blues

Карэкціроўкі для сініх пікселяў (пікселяў, дзе сіні кампанент максімальны)

magentas

Карэкціроўкі для пурпурных пікселяў (пікселяў, у якіх зялёны кампанент мінімальны)

whites

Карэкціроўкі для белых пікселяў (пікселяў, у якіх усе кампаненты больш за 128)

neutrals

Карэкціроўкі для ўсіх пікселяў, акрамя чыста чорнага і чыста белага

blacks

Карэкціроўкі для чорных пікселяў (пікселяў, у якіх усе кампаненты менш за 128)

psfile

Укажыце файл селектыўнага колеру Photoshop ( .asv), з якога трэба імпартаваць налады.

Усе параметры рэгулявання (reds,yellows, ...) прымаюць да 4 значэнняў рэгулявання з плаваючай коскай, падзеленых прабелам, у дыяпазоне [-1,1] адпаведна, каб наладзіць колькасць блакітнага, пурпурнога, жоўтага і чорнага для пікселяў у сваім дыяпазоне.

11.216.1 Examples

  • Павялічце блакітны на 50% і паменшыце жоўты на 33% у кожнай зялёнай вобласці і павялічце пурпурны на 27% у сініх абласцях:
    selectivecolor=greens=.5 0 -.33 0:blues=0 .27
    
  • Скарыстайцеся перадусталёўкай выбарачнага колеру Photoshop:
    selectivecolor=psfile=MySelectiveColorPresets/Misty.asv
    

11.217 separatefields

Ён separatefieldsпрымае відэаўваход на аснове кадраў і разбівае кожны кадр на палі кампанентаў, ствараючы новы кліп на палову вышыні з удвая большай частатой і ўдвая большай колькасцю кадраў.

Гэты фільтр выкарыстоўвае інфармацыю аб дамінаванні палёў у кадры, каб вырашыць, якое з кожнай пары палёў размясціць першым у вывадзе. Калі гэта памыляецца, выкарыстоўвайце фільтр setfield перад separatefieldsфільтрам.

11.218 setdar, setsar

Фільтр setdarусталёўвае суадносіны бакоў дысплея для выхаднога відэа фільтра.

Гэта робіцца шляхам змены вызначанага суадносін бакоў выбаркі (ён жа піксель) у адпаведнасці з наступным ураўненнем:

DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR

Майце на ўвазе, што setdarфільтр не змяняе памеры відэакадра ў пікселях. Акрамя таго, суадносіны бакоў дысплея, устаноўленыя гэтым фільтрам, могуць быць зменены пазнейшымі фільтрамі ў ланцужку фільтраў, напрыклад, у выпадку маштабавання або прымянення іншага фільтра "setdar" або "setsar".

Фільтр setsarзадае выбарку (ён жа піксель) суадносін бакоў для выхаднога відэа фільтра.

Звярніце ўвагу, што ў выніку прымянення гэтага фільтра суадносіны бакоў выхаднога дысплея зменяцца ў адпаведнасці з прыведзеным вышэй ураўненнем.

Майце на ўвазе, што суадносіны бакоў узору, устаноўленыя setsar фільтрам, могуць быць зменены пазнейшымі фільтрамі ў ланцужку фільтраў, напрыклад, калі ўжыты іншы фільтр "setsar" або "setdar".

Ён прымае наступныя параметры:

r, ratio, dar (setdar only), sar (setsar only)

Усталюйце суадносіны бакоў, якія выкарыстоўваюцца фільтрам.

Параметрам можа быць лічбавы радок з плаваючай коскай, выраз або радок выгляду num: den, дзе numі denз'яўляюцца лічнікам і назоўнікам суадносін бакоў. Калі параметр не ўказаны, прымаецца значэнне «0». У выпадку выкарыстання формы " num: den" :сімвал павінен быць экранаваны.

max

Усталюйце максімальнае цэлае значэнне для выражэння лічніка і назоўніка пры памяншэнні выражанага суадносін бакоў да рацыянальнага. Значэнне па змаўчанні - 100.

Параметр sar- гэта выраз, які змяшчае наступныя канстанты:

E, PI, PHI

Гэта прыблізныя значэнні матэматычных канстант e (лік Эйлера), pi (грэцкае pi) і phi (залатое сячэнне).

w, h

Шырыня і вышыня ўводу.

a

Гэта тое самае, што w/ h.

sar

Суадносіны бакоў уводнага ўзору.

dar

Суадносіны бакоў уваходнага дысплея. Гэта тое самае, што ( w/ h) * sar.

hsub, vsub

Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

11.218.1 Examples

  • Каб змяніць суадносіны бакоў дысплея на 16:9, задайце адно з наступнага:
    setdar=dar=1.77777
    setdar=dar=16/9
    
  • Каб змяніць узор суадносін бакоў на 10:11, укажыце:
    setsar=sar=10/11
    
  • Каб усталяваць суадносіны бакоў дысплея 16:9 і ўказаць максімальнае цэлае значэнне 1000 у памяншэнні суадносін бакоў, выкарыстоўвайце каманду:
    setdar=ratio=16/9:max=1000
    

11.219 setfield

Сілавое поле для выхаднога відэакадра.

Фільтр setfieldпазначае поле тыпу празрадковай разгорткі для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра наступнымі фільтрамі (напрыклад, fieldorderабо yadif).

Фільтр прымае наступныя параметры:

mode

Даступныя значэнні:

'auto'

Захаваць аднолькавае ўласцівасць поля.

'bff'

Пазначце кадр як ніжняе поле спачатку.

'tff'

Пазначце кадр як верхняе поле спачатку.

'prog'

Пазначце кадр як прагрэсіўны.

11.220 setparams

Параметр Force frame для выхаднога відэакадра.

Фільтр setparamsадзначае празрадковую разгортку і дыяпазон колераў для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра фільтрамі/кадавальнікамі.

field_mode

Даступныя значэнні:

'auto'

Захаваць аднолькавае ўласцівасць поля (па змаўчанні).

'bff'

Пазначце кадр як ніжняе поле спачатку.

'tff'

Пазначце кадр як верхняе поле спачатку.

'prog'

Пазначце кадр як прагрэсіўны.

range

Даступныя значэнні:

'auto'

Захаваць тую ж уласцівасць каляровага дыяпазону (па змаўчанні).

'unspecified, unknown'

Пазначыць рамку як нявызначаную каляровую гаму.

'limited, tv, mpeg'

Адзначце кадр як абмежаваны дыяпазон.

'full, pc, jpeg'

Адзначце кадр як поўны дыяпазон.

color_primaries

Усталюйце асноўны колер. Даступныя значэнні:

'auto'

Захаваць уласцівасць асноўных колераў (па змаўчанні).

'bt709'
'unknown'
'bt470m'
'bt470bg'
'smpte170m'
'smpte240m'
'film'
'bt2020'
'smpte428'
'smpte431'
'smpte432'
'jedec-p22'
color_trc

Усталюйце перадачу колеру. Даступныя значэнні:

'auto'

Захаваць уласцівасць trc колеру той жа (па змаўчанні).

'bt709'
'unknown'
'bt470m'
'bt470bg'
'smpte170m'
'smpte240m'
'linear'
'log100'
'log316'
'iec61966-2-4'
'bt1361e'
'iec61966-2-1'
'bt2020-10'
'bt2020-12'
'smpte2084'
'smpte428'
'arib-std-b67'
colorspace

Усталюйце каляровую прастору. Даступныя значэнні:

'auto'

Захаваць тую ж уласцівасць каляровай прасторы (па змаўчанні).

'gbr'
'bt709'
'unknown'
'fcc'
'bt470bg'
'smpte170m'
'smpte240m'
'ycgco'
'bt2020nc'
'bt2020c'
'smpte2085'
'chroma-derived-nc'
'chroma-derived-c'
'ictcp'

11.221 sharpen_npp

Выкарыстоўвайце NVIDIA Performance Primitives (libnpp) для павышэння рэзкасці выявы з кантролем межаў.

Прымаюцца наступныя дадатковыя варыянты:

border_type

Тып выбаркі, якая будзе выкарыстоўвацца, межы рамкі аб'явы. Адзін з наступнага:

replicate

Паўтарыць значэнні пікселяў.

11.222 shear

Прымяніць пераўтварэнне зруху да ўваходнага відэа.

Гэты фільтр падтрымлівае наступныя параметры:

shx

Каэфіцыент зруху ў напрамку X. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад -2 да 2.

shy

Каэфіцыент зруху ў напрамку Y. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад -2 да 2.

fillcolor, c

Усталюйце колер, які выкарыстоўваецца для запаўнення вобласці вываду, не пакрытай трансфармаваным відэа. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выбрана спецыяльнае значэнне «няма», фон не друкуецца (карысна, напрыклад, калі фон ніколі не паказваецца).

Значэнне па змаўчанні - "чорны".

interp

Усталюйце тып інтэрпаляцыі. Можа быць bilinearабо nearest. Па змаўчанні bilinear.

11.222.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.223 showinfo

Паказаць радок, які змяшчае розную інфармацыю для кожнага кадра ўваходнага відэа. Уваходнае відэа не зменена.

Гэты фільтр падтрымлівае наступныя параметры:

checksum

Вылічыце кантрольныя сумы кожнай плоскасці. Па змаўчанні ўключана.

Паказаны радок змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key: value.

У вывадзе паказаны наступныя значэнні:

n

(Парадкавы) нумар уваходнага кадра, пачынаючы з 0.

pts

Пазнака часу прэзентацыі ўваходнага кадра, выражаная ў колькасці адзінак асноўнага часу. Адзінка асновы часу залежыць ад пляцоўкі ўводу фільтра.

pts_time

Пазнака часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд.

pos

Становішча кадра ва ўваходным патоку або -1, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа).

fmt

Назва фармату пікселяў.

sar

Прыклад суадносін бакоў уваходнага кадра, выражаны ў форме num/ den.

s

Памер уваходнага кадра. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

i

Тып празрадковага рэжыму ("P" для "прагрэсіўнага", "T" для верхняга поля, "B" для ніжняга поля).

iskey

Гэта 1, калі кадр з'яўляецца ключавым, 0 у адваротным выпадку.

type

Тып выявы ўваходнага кадра ("I" для I-кадра, "P" для P-кадра, "B" для B-кадра або "?" для невядомага тыпу). Таксама звярніцеся да дакументацыі AVPictureTypeпералічэння і av_get_picture_type_charфункцыі, вызначанай у libavutil/avutil.h.

checksum

Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) усіх плоскасцей уваходнага кадра.

plane_checksum

Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) кожнай плоскасці ўваходнага кадра, выражаная ў выглядзе "[ ]". c0 c1 c2 c3

mean

Сярэдняе значэнне пікселяў у кожнай плоскасці ўваходнага кадра, выражанае ў выглядзе "[ ]". mean0 mean1 mean2 mean3

stdev

Стандартнае адхіленне значэнняў пікселяў у кожнай плоскасці ўваходнага кадра, выражанае ў выглядзе "[ ]". stdev0 stdev1 stdev2 stdev3

11.224 showpalette

Адлюстроўвае палітру з 256 колераў кожнага кадра. Гэты фільтр актуальны толькі для pal8кадраў піксельнага фармату.

Ён прымае наступны варыянт:

s

Усталюйце памер поля, якое выкарыстоўваецца для прадстаўлення аднаго запісу колеру палітры. Па змаўчанні 30(для 30x30скрынкі пікселяў).

11.225 shuffleframes

Змяніце парадак і/або дублюйце і/або выдаліце ​​відэакадры.

Ён прымае наступныя параметры:

mapping

Усталюйце індэксы прызначэння ўваходных кадраў. Гэта прабел або '|' асобны спіс індэксаў, які адлюстроўвае ўваходныя кадры ў выходныя кадры. Колькасць індэксаў таксама задае максімальнае значэнне, якое можа мець кожны індэкс. «-1» індэкс мае асаблівае значэнне, і гэта падзенне кадра.

Першы кадр мае індэкс 0. Па змаўчанні ўвод застаецца нязменным.

11.225.1 Examples

  • Памяняйце месцамі другі і трэці кадр з кожных трох кадраў уводу:
    ffmpeg -i INPUT -vf "shuffleframes=0 2 1" OUTPUT
    
  • Памяняць месцамі 10-ы і 1-ы кадры кожных дзесяці кадраў уводу:
    ffmpeg -i INPUT -vf "shuffleframes=9 1 2 3 4 5 6 7 8 0" OUTPUT
    

11.226 shufflepixels

Змяніць парадак пікселяў у кадрах відэа.

Гэты фільтр прымае наступныя параметры:

direction, d

Усталюйце кірунак ператасавання. Можа быць прамым або зваротным напрамкам. Напрамак па змаўчанні - наперад.

mode, m

Усталюйце рэжым ператасоўкі. Можа быць гарызантальны, вертыкальны або блокавы рэжым.

width, w
height, h

Усталюйце ператасаваць block_size. У выпадку гарызантальнага рэжыму перамешвання выкарыстоўваецца толькі частка памеру шырыні, а ў выпадку рэжыму вертыкальнай ператасоўкі выкарыстоўваецца толькі частка памеру вышыні.

seed, s

Усталюйце выпадковае пачатковае значэнне з ператасоўкай пікселяў. Галоўным чынам карысна ўсталяваць, каб мець магчымасць адмяніць працэс фільтрацыі, каб атрымаць зыходны ўвод. Напрыклад, каб ператасаваць уперад назад, трэба выкарыстоўваць аднолькавыя параметры і сапраўды такі ж пачатковы момант, а таксама задаць кірунак у зваротным парадку.

11.227 shuffleplanes

Змяніце парадак і/або дублюйце плоскасці відэа.

Ён прымае наступныя параметры:

map0

Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці першай плоскасці вываду.

map1

Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці другой плоскасці вываду.

map2

Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці трэцяй плоскасці вываду.

map3

Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці чацвёртай плоскасці вываду.

Першая плоскасць мае індэкс 0. Па змаўчанні ўвод застаецца нязменным.

11.227.1 Examples

  • Памяняйце месцамі другую і трэцюю плоскасці ўводу:
    ffmpeg -i INPUT -vf shuffleplanes=0:2:1:3 OUTPUT
    

11.228 signalstats

Ацэнка розных візуальных паказчыкаў, якія дапамагаюць у вызначэнні праблем, звязаных з алічбоўкай аналагавых відэа носьбітаў.

Па змаўчанні фільтр будзе запісваць гэтыя значэнні метададзеных:

YMIN

Адлюстраванне мінімальнага значэння Y, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

YLOW

Адлюстраванне значэння Y на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

YAVG

Адлюстраванне сярэдняга значэння Y ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

YHIGH

Адлюстраванне значэння Y на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

YMAX

Адлюстраванне максімальнага значэння Y, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

UMIN

Адлюстраванне мінімальнага значэння U, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

ULOW

Адлюстраванне значэння U на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

UAVG

Адлюстраванне сярэдняга значэння U ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

UHIGH

Адлюстраванне значэння U на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

UMAX

Адлюстраванне максімальнага значэння U, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

VMIN

Адлюстраванне мінімальнага значэння V, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].

VLOW

Адлюстраванне значэння V на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

VAVG

Адлюстраванне сярэдняга значэння V ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].

VHIGH

Адлюстраванне значэння V на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].

VMAX

Адлюстраванне максімальнага значэння V, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].

SATMIN

Адлюстраванне мінімальнага значэння насычанасці, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].

SATLOW

Адлюстраванне значэння насычанасці на ўзроўні 10% працэнтыля ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].

SATAVG

Адлюстраванне сярэдняга значэння насычанасці ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].

SATHIGH

Адлюстраванне значэння насычанасці на ўзроўні 90% працэнтыля ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].

SATMAX

Адлюстраванне максімальнага значэння насычанасці, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].

HUEMED

Адлюстраванне сярэдняга значэння адцення ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-360].

HUEAVG

Адлюстраванне сярэдняга значэння адцення ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-360].

YDIF

Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці Y у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].

UDIF

Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці U у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].

VDIF

Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці V у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].

YBITDEPTH

Адлюстраванне бітавай глыбіні плоскасці Y у бягучым кадры. Выражаецца ў дыяпазоне [0-16].

UBITDEPTH

Адлюстраванне бітавай глыбіні плоскасці U ў бягучым кадры. Выражаецца ў дыяпазоне [0-16].

VBITDEPTH

Адлюстраванне бітавай глыбіні плоскасці V у бягучым кадры. Выражаецца ў дыяпазоне [0-16].

Фільтр прымае наступныя параметры:

stat
out

statуказаць дадатковую форму аналізу выявы. outвыводзіць відэа з вылучаным пікселем зададзенага тыпу.

Абодва варыянты прымаюць наступныя значэнні:

'tout'

Вызначыць temporal outliersпікселі. A temporal outlier- гэта піксель у адрозненне ад суседніх пікселяў таго ж поля. Прыклады часовых выкідаў ўключаюць вынікі адключэння відэа, закаркаванне галавы або праблемы са стужкай.

'vrep'

Ідэнтыфікаваць vertical line repetition. Паўтарэнне вертыкальнай лініі ўключае аднолькавыя шэрагі пікселяў у кадры. У народжаным лічбавым відэа паўтор вертыкальных радкоў з'яўляецца звычайнай з'явай, але гэты шаблон рэдка сустракаецца ў відэа, алічбаваным з аналагавай крыніцы. Калі гэта адбываецца ў відэа, якое з'яўляецца вынікам алічбоўкі аналагавай крыніцы, гэта можа паказваць на ўтойванне ад кампенсатара выпадзення.

'brng'

Вызначце пікселі, якія выходзяць за межы дазволенага дыяпазону вяшчання.

color, c

Усталюйце колер вылучэння дляoutварыянт. Колер па змаўчанні жоўты.

11.228.1 Examples

  • Выхадныя даныя розных відэаметрык:
    ffprobe -f lavfi movie=example.mov,signalstats="stat=tout+vrep+brng" -show_frames
    
  • Вывядзіце канкрэтныя даныя аб мінімальных і максімальных значэннях плоскасці Y на кадр:
    ffprobe -f lavfi movie=example.mov,signalstats -show_entries frame_tags=lavfi.signalstats.YMAX,lavfi.signalstats.YMIN
    
  • Прайгравайце відэа, вылучаючы пікселі, якія знаходзяцца за межамі дыяпазону трансляцыі, чырвоным колерам.
    ffplay example.mov -vf signalstats="out=brng:color=red"
    
  • Прайграванне відэа з метададзенымі сігналаў, намаляванымі па-над кадрам.
    ffplay example.mov -vf signalstats=stat=brng+vrep+tout,drawtext=fontfile=FreeSerif.ttf:textfile=signalstat_drawtext.txt
    

    Змесціва signalstat_drawtext.txt, якое выкарыстоўваецца ў камандзе:

    time %{pts:hms}
    Y (%{metadata:lavfi.signalstats.YMIN}-%{metadata:lavfi.signalstats.YMAX})
    U (%{metadata:lavfi.signalstats.UMIN}-%{metadata:lavfi.signalstats.UMAX})
    V (%{metadata:lavfi.signalstats.VMIN}-%{metadata:lavfi.signalstats.VMAX})
    saturation maximum: %{metadata:lavfi.signalstats.SATMAX}
    
    

11.229 signature

Разлічвае відэаподпіс MPEG-7. Фільтр можа апрацоўваць больш чым адзін увод. У гэтым выпадку адпаведнасць паміж уваходамі можа быць вылічана дадаткова. Фільтр заўсёды праходзіць праз першы ўваход. Подпіс кожнага патоку можа быць запісаны ў файл.

Ён прымае наступныя варыянты:

detectmode

Уключыць або выключыць працэс супастаўлення.

Даступныя значэнні:

'off'

Адключыць разлік адпаведнасці (па змаўчанні).

'full'

Вылічыць адпаведнасць для ўсяго відэа і вывесці, ці супадае ўсё відэа ці толькі яго часткі.

'fast'

Вылічвайце толькі да таго часу, пакуль не будзе знойдзена адпаведнасць або пакуль не скончыцца відэа. У некаторых выпадках павінна быць хутчэй.

nb_inputs

Усталюйце колькасць уваходаў. Значэнне параметра павінна быць неадмоўным цэлым лікам. Значэнне па змаўчанні - 1.

filename

Усталюйце шлях, у які запісваецца вывад. Калі ёсць больш чым адзін увод, шлях павінен быць прататыпам, г.зн. павінен утрымліваць %d або %0nd (дзе n - дадатнае цэлае), якія будуць заменены нумарам уводу. Калі імя файла не пазначана, вывад не будзе запісаны. Гэта па змаўчанні.

format

Выберыце фармат вываду.

Даступныя значэнні:

'binary'

Выкарыстоўваць указанае двайковае прадстаўленне (па змаўчанні).

'xml'

Выкарыстоўвайце азначанае прадстаўленне ў фармаце xml.

th_d

Усталюйце парог для выяўлення аднаго слова як падобнага. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 9000.

th_dc

Усталюйце парог, каб усе словы былі падобныя. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 60000.

th_xh

Усталюйце парог для выяўлення кадраў як падобных. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 116.

th_di

Усталюйце мінімальную даўжыню паслядоўнасці ў кадрах, каб распазнаць яе як адпаведную паслядоўнасць. Значэнне параметра павінна быць неадмоўным цэлым лікам. Значэнне па змаўчанні - 0.

th_it

Усталюйце мінімальнае стаўленне, якое павінны мець адпаведныя кадры да ўсіх кадраў. Значэнне параметра павінна быць падвойным значэннем ад 0 да 1. Значэнне па змаўчанні роўна 0,5.

11.229.1 Examples

  • Каб вылічыць подпіс уваходнага відэа і захаваць яго ў signature.bin:
    ffmpeg -i input.mkv -vf signature=filename=signature.bin -map 0:v -f null -
    
  • Каб вызначыць, ці супадаюць два відэа, і захаваць подпісы ў фармаце XML у signature0.xml і signature1.xml:
    ffmpeg -i input1.mkv -i input2.mkv -filter_complex "[0:v][1:v] signature=nb_inputs=2:detectmode=full:format=xml:filename=signature%d.xml" -map :v -f null -
    

11.230 siti

Разлік балаў прасторавай інфармацыі (SI) і часовай інфармацыі (TI) для відэа, як гэта вызначана ў ITU-T P.910: Суб'ектыўныя метады ацэнкі якасці відэа для мультымедыйных прыкладанняў. Даступны ў фармаце PDF на https://www.itu.int/rec/T-REC-P.910-199909-S/en .

Ён прымае наступны варыянт:

print_summary

Калі ўсталявана 1, зводная статыстыка будзе друкавацца на кансолі. Па змаўчанні 0.

11.230.1 Examples

  • Каб разлічыць паказчыкі SI/TI і надрукаваць зводку:
    ffmpeg -i input.mp4 -vf siti=print_summary=1 -f null -
    

11.231 smartblur

Размыць уваходнае відэа, не закранаючы контуры.

Ён прымае наступныя варыянты:

luma_radius, lr

Усталюйце радыус яркасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [0.1,5.0], які вызначае дысперсію фільтра Гаўса, які выкарыстоўваецца для размыцця выявы (павольней, калі больш). Значэнне па змаўчанні 1,0.

luma_strength, ls

Усталюйце інтэнсіўнасць яркасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [-1.0,1.0], які канфігуруе размыццё. Значэнне, уключанае ў [0.0,1.0], прывядзе да размыцця выявы, а значэнне, уключанае ў [-1.0,0.0], павысіць рэзкасць выявы. Значэнне па змаўчанні 1,0.

luma_threshold, lt

Усталюйце парог яркасці, які выкарыстоўваецца ў якасці каэфіцыента, каб вызначыць, ці павінен піксель быць размытым ці не. Значэнне параметра павінна быць цэлым лікам у дыяпазоне [-30,30]. Значэнне 0 будзе фільтраваць увесь відарыс, значэнне, уключанае ў [0,30], будзе фільтраваць плоскія вобласці, а значэнне, уключанае ў [-30,0], будзе фільтраваць краю. Значэнне па змаўчанні 0.

chroma_radius, cr

Усталюйце радыус каляровасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [0.1,5.0], які вызначае дысперсію фільтра Гаўса, які выкарыстоўваецца для размыцця выявы (павольней, калі больш). Значэнне па змаўчанніluma_radius.

chroma_strength, cs

Усталюйце інтэнсіўнасць каляровасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [-1.0,1.0], які канфігуруе размыццё. Значэнне, уключанае ў [0.0,1.0], прывядзе да размыцця выявы, а значэнне, уключанае ў [-1.0,0.0], павысіць рэзкасць выявы. Значэнне па змаўчанніluma_strength.

chroma_threshold, ct

Усталюйце парог каляровасці, які выкарыстоўваецца ў якасці каэфіцыента, каб вызначыць, ці павінен піксель быць размытым ці не. Значэнне параметра павінна быць цэлым лікам у дыяпазоне [-30,30]. Значэнне 0 будзе фільтраваць увесь відарыс, значэнне, уключанае ў [0,30], будзе фільтраваць плоскія вобласці, а значэнне, уключанае ў [-30,0], будзе фільтраваць краю. Значэнне па змаўчанніluma_threshold.

Калі параметр каляровасці не зададзены яўна, усталёўваецца адпаведнае значэнне яркасці.

11.232 sobel

Ужыць аператар sobel для ўваходнага відэаструменю.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.

11.232.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.233 spp

Прымяніць просты фільтр постапрацоўкі, які сціскае і распакоўвае малюнак на некалькі (ці - у выпадкуqualityузровень 6- усе) змены і асерадненне вынікаў.

Фільтр прымае наступныя параметры:

quality

Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 0-6. Калі ўстаноўлена 0, фільтр не будзе мець ніякага эфекту. Значэнне 6азначае больш высокую якасць. Для кожнага павелічэння гэтага значэння хуткасць падае прыблізна ў 2 разы. Значэнне па змаўчанні - 3.

qp

Прымусова ўсталяваць пастаянны параметр квантавання. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).

mode

Усталюйце парогавы рэжым. Даступныя рэжымы:

'hard'

Устанавіць цвёрдае парогавае значэнне (па змаўчанні).

'soft'

Усталюйце мяккі парог (лепшы эфект выдалення званка, але, верагодна, больш размыты).

use_bframe_qp

Уключыць выкарыстанне QP з B-Frames, калі ўстаноўлена 1. Выкарыстанне гэтай опцыі можа выклікаць мігценне, паколькі B-рамкі часта маюць большы QP. Па змаўчанні 0(не ўключана).

11.233.1 Commands

Гэты фільтр падтрымлівае наступныя каманды:

quality, level

Усталюйце ўзровень якасці. Значэнне maxможа быць выкарыстана для ўстаноўкі максімальнага ўзроўню, у цяперашні час 6.

11.234 sr

Павялічце ўваходныя дадзеныя, ужыўшы адзін з метадаў звышраздзялення на аснове згортачных нейронавых сетак. Падтрымліваюцца мадэлі:

  • Мадэль сверточной нейроннай сеткі звышраздзялення (SRCNN). Глядзіце https://arxiv.org/abs/1501.00092 .
  • Эфектыўная мадэль сверточной нейроннай сеткі субпікселяў (ESPCN). Глядзіце https://arxiv.org/abs/1609.05158 .

Навучальныя скрыпты, а таксама скрыпты для захавання файла мадэлі (.pb) можна знайсці на https://github.com/XueweiMeng/sr/tree/sr_dnn_native . Арыгінальны рэпазітар знаходзіцца на https://github.com/HighVoltageRocknRoll/sr.git .

Файлы ўласнай мадэлі (.model) могуць быць створаны з файлаў мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py

Фільтр прымае наступныя параметры:

dnn_backend

Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:

'native'

Уласная рэалізацыя загрузкі і выканання DNN.

'tensorflow'

Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з --enable-libtensorflow

Значэнне па змаўчанні 'native'.

model

Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. Бэкэнд TensorFlow можа загружаць файлы для абодвух фарматаў, у той час як уласны бэкэнд можа загружаць файлы толькі для свайго фармату.

scale_factor

Задаць маштабны каэфіцыент для мадэлі SRCNN. Дазволеныя значэнні 2, 3і 4. Значэнне па змаўчанні - 2. Маштабны каэфіцыент неабходны для мадэлі SRCNN, таму што яна прымае ўваходныя дадзеныя, пашыраныя з выкарыстаннем бікубічнага маштабавання з належным маштабным каэфіцыентам.

Каб атрымаць поўную функцыянальнасць (напрыклад, асінхроннае выкананне), выкарыстоўвайце фільтр dnn_processing .

11.235 ssim

Атрымайце SSIM (метрыка структурнага падабенства) паміж двума ўваходнымі відэа.

Гэты фільтр прымае на ўваход два ўваходныя відэа, першы ўваход лічыцца "асноўнай" крыніцай і без змен перадаецца на выхад. Другі ўваход выкарыстоўваецца ў якасці "эталоннага" відэа для вылічэння SSIM.

Абодва відэаўваходы павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.

Фільтр захоўвае разлічаны SSIM кожнага кадра.

Ніжэй прыводзіцца апісанне прынятых параметраў.

stats_file, f

Калі пазначаны, фільтр будзе выкарыстоўваць названы файл для захавання SSIM кожнага асобнага кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.

Файл, які друкуецца stats_file, калі абраны, змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key: valueдля кожнай пары кадраў, якія параўноўваюцца.

Далей апісваецца кожны паказаны параметр:

n

парадкавы нумар уваходнага кадра, пачынаючы з 1

Y, U, V, R, G, B

SSIM параўноўваных кадраў для кампанента, вызначанага суфіксам.

All

SSIM параўноўваных кадраў для ўсяго кадра.

dB

Тое самае, што і вышэй, але ў дБ.

Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .

11.235.1 Examples

  • Напрыклад:
    movie=ref_movie.mpg, setpts=PTS-STARTPTS [main];
    [main][ref] ssim="stats_file=stats.log" [out]
    

    У гэтым прыкладзе ўваходны файл, які апрацоўваецца, параўноўваецца з эталонным файламref_movie.mpg. SSIM кожнага асобнага кадра захоўваецца ўstats.log.

  • Іншы прыклад адначасова з psnr і ssim:
    ffmpeg -i main.mpg -i ref.mpg -lavfi  "ssim;[0:v][1:v]psnr" -f null -
    
  • Яшчэ адзін прыклад з рознымі кантэйнерамі:
    ffmpeg -i main.mpg -i ref.mkv -lavfi  "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]ssim" -f null -
    

11.236 stereo3d

Пераўтварэнне паміж рознымі фарматамі стэрэаскапічных малюнкаў.

Фільтры прымаюць наступныя параметры:

in

Задаць фармат стэрэаскапічнага відарыса для ўводу.

Даступныя значэнні для ўваходных фарматаў выявы:

'sbsl'

побач паралельна (левае вока злева, правае вока справа)

'sbsr'

бок аб бок крыжавокі (правае вока злева, левае вока справа)

'sbs2l'

побач паралельна з дазволам на палову шырыні (левае вока злева, правае вока справа)

'sbs2r'

бок аб бок крыж з раздзяленнем у палову шырыні (правае вока злева, левае вока справа)

'abl'
'tbl'

зверху-знізу (левае вока ўверсе, правае вока ўнізе)

'abr'
'tbr'

уверсе-ўнізе (правае вока ўверсе, левае вока ўнізе)

'ab2l'
'tb2l'

уверсе-ўнізе з дазволам на палову вышыні (левае вока ўверсе, правае вока ўнізе)

'ab2r'
'tb2r'

уверсе-ўнізе з дазволам на палову вышыні (правае вока ўверсе, левае вока ўнізе)

'al'

чаргаванне кадраў (спачатку левае вока, другое вока правае)

'ar'

чаргаванне кадраў (правае вока першым, левае вока другім)

'irl'

перамежаваныя радкі (для левага вока верхні радок, для правага вока пачынаецца наступны радок)

'irr'

перамежаваныя радкі (правае вока мае верхні радок, левае вока пачынаецца з наступнага радка)

'icl'

перамежаваныя слупкі, левым вокам наперад

'icr'

перамежаваныя слупкі, правае вока спачатку

Значэнне па змаўчанні 'sbsl'.

out

Задаць фармат вываду стэрэаскапічнага відарыса.

'sbsl'

побач паралельна (левае вока злева, правае вока справа)

'sbsr'

бок аб бок крыжавокі (правае вока злева, левае вока справа)

'sbs2l'

побач паралельна з дазволам на палову шырыні (левае вока злева, правае вока справа)

'sbs2r'

бок аб бок крыж з раздзяленнем у палову шырыні (правае вока злева, левае вока справа)

'abl'
'tbl'

зверху-знізу (левае вока ўверсе, правае вока ўнізе)

'abr'
'tbr'

уверсе-ўнізе (правае вока ўверсе, левае вока ўнізе)

'ab2l'
'tb2l'

уверсе-ўнізе з дазволам на палову вышыні (левае вока ўверсе, правае вока ўнізе)

'ab2r'
'tb2r'

уверсе-ўнізе з дазволам на палову вышыні (правае вока ўверсе, левае вока ўнізе)

'al'

чаргаванне кадраў (спачатку левае вока, другое вока правае)

'ar'

чаргаванне кадраў (правае вока першым, левае вока другім)

'irl'

перамежаваныя радкі (для левага вока верхні радок, для правага вока пачынаецца наступны радок)

'irr'

перамежаваныя радкі (правае вока мае верхні радок, левае вока пачынаецца з наступнага радка)

'arbg'

анагліф чырвоны/сіне-шэры (чырвоны фільтр на левым воку, сіні фільтр на правым воку)

'argg'

анагліф чырвоны/зялёны шэры (чырвоны фільтр на левым воку, зялёны фільтр на правым воку)

'arcg'

анагліф чырвоны/блакітна-шэры (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)

'arch'

анагліф чырвоны/блакітны напаўкаляровы (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)

'arcc'

анагліф чырвонага/блакітнага колеру (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)

'arcd'

анагліф чырвоны/блакітны колер аптымізаваны з дапамогай найменшых квадратаў праекцыі Дюбуа (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)

'agmg'

анагліф зялёны/пурпурны шэры (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)

'agmh'

анагліф зялёны/пурпурны напалову (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)

'agmc'

анагліф зялёнага/пурпурнога колеру (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)

'agmd'

колер анагліфа зялёны/пурпурны, аптымізаваны з дапамогай праекцыі Дзюбуа паводле метаду найменшых квадратаў (зялёны фільтр на левае вока, пурпурны фільтр на правае вока)

'aybg'

анагліф жоўты/блакітна-шэры (жоўты фільтр на левым воку, сіні фільтр на правым воку)

'aybh'

анагліф жоўты/сіні напаўкаляровы (жоўты фільтр на левым воку, сіні фільтр на правым воку)

'aybc'

анагліф жоўта-сіняга колеру (жоўты фільтр на левым воку, сіні фільтр на правым воку)

'aybd'

анагліф жоўты / сіні колер, аптымізаваны з дапамогай найменшых квадратаў праекцыі Дюбуа (жоўты фільтр на левым воку, сіні фільтр на правым воку)

'ml'

монавыхад (толькі левае вока)

'mr'

монавыхад (толькі правае вока)

'chl'

шашка, левым вокам наперад

'chr'

шахматная дошка, правае вока наперад

'icl'

перамежаваныя слупкі, левым вокам наперад

'icr'

перамежаваныя слупкі, правае вока спачатку

'hdmi'

Пакет кадраў HDMI

Значэнне па змаўчанні 'arcd'.

11.236.1 Examples

  • Пераўтварыце ўваходнае відэа з паралельнага анагліфа ў жоўты/блакітны Дюбуа:
    stereo3d=sbsl:aybd
    
  • Пераўтварыце ўваходнае відэа зверху ўніз (левае вока ўверсе, правае вока ўнізе) у бок аб бок папярочна.
    stereo3d=abl:sbsr
    

11.237 streamselect, astreamselect

Выберыце відэа ці аўдыяплыні.

Фільтр прымае наступныя параметры:

inputs

Усталюйце колькасць уваходаў. Па змаўчанні 2.

map

Усталюйце ўваходныя індэксы для пераназначэння на выхады.

11.237.1 Commands

Фільтр streamselectі astreamselectпадтрымлівае наступныя каманды:

map

Усталюйце ўваходныя індэксы для пераназначэння на выхады.

11.237.2 Examples

  • Выберыце першыя 5 секунд 1-га патоку і астатні час 2-га патоку:
    sendcmd='5.0 streamselect map 1',streamselect=inputs=2:map=0
    
  • Тое самае, што і вышэй, але для аўдыя:
    asendcmd='5.0 astreamselect map 1',astreamselect=inputs=2:map=0
    

11.238 subtitles

Намалюйце субтытры паверх уваходнага відэа з дапамогай бібліятэкі libass.

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-libass. Гэты фільтр таксама патрабуе зборкі з libavcodec і libavformat для пераўтварэння перададзенага файла субтытраў у фармат субтытраў ASS (Advanced Substation Alpha).

Фільтр прымае наступныя параметры:

filename, f

Усталюйце імя файла субтытраў для чытання. Яго трэба ўдакладніць.

original_size

Пакажыце памер зыходнага відэа, відэа, для якога быў складзены файл ASS. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . З-за няправільнай распрацоўкі арыфметыкі суадносін бакоў ASS гэта неабходна для правільнага маштабавання шрыфтоў, калі суадносіны бакоў былі зменены.

fontsdir

Усталюйце шлях да каталога, які змяшчае шрыфты, якія могуць выкарыстоўвацца фільтрам. Гэтыя шрыфты будуць выкарыстоўвацца ў дадатак да таго, што выкарыстоўвае пастаўшчык шрыфтоў.

alpha

Апрацаваць альфа-канал, па змаўчанні альфа-канал не закрануты.

charenc

Усталюйце кадоўку сімвалаў уводу субтытраў. subtitlesтолькі фільтр. Карысна, толькі калі не UTF-8.

stream_index, si

Усталяваць індэкс патоку субтытраў. subtitlesтолькі фільтр.

force_style

Перавызначыць параметры субтытраў па змаўчанні ў стылі ці сцэнары. Ён прымае радок, які змяшчае KEY=VALUEпары фарматаў у стылі ASS, падзеленыя знакамі ",".

Калі першы ключ не ўказаны, мяркуецца, што першае значэнне вызначаеfilename.

Напрыклад, для адлюстравання файлаsub.srtпаверх уваходнага відэа выкарыстоўвайце каманду:

subtitles=sub.srt

што эквівалентна:

subtitles=filename=sub.srt

Для адлюстравання патоку субтытраў па змаўчанні з файлаvideo.mkv, выкарыстоўваць:

subtitles=video.mkv

Каб зрабіць другі паток субтытраў з гэтага файла, выкарыстоўвайце:

subtitles=video.mkv:si=1

Каб трансляваць субтытрыsub.srtвыглядаць у 80% празрыста-блакітным колеры DejaVu Serif, выкарыстоўвайце:

subtitles=sub.srt:force_style='Fontname=DejaVu Serif,PrimaryColour=&HCCFF0000'

11.239 super2xsai

Павялічце ўвод у 2 разы і згладзьце з дапамогай алгарытму маштабавання піксельнага мастацтва Super2xSaI (Scale and Interpolate).

Карысна для павелічэння піксельных малюнкаў без памяншэння рэзкасці.

11.240 swaprect

Памяняйце месцамі два прамавугольныя аб'екты ў відэа.

Гэты фільтр прымае наступныя параметры:

w

Задаць шырыню аб'екта.

h

Задайце вышыню аб'екта.

x1

Усталюйце 1-ю каардынату прамастая х.

y1

Задайце 1-ю каардынату прамавуха.

x2

Усталюйце 2-ю каардынату прамастая х.

y2

Задайце 2-ю каардынату прамавуха.

Усе выразы вылічваюцца адзін раз для кожнага кадра.

Усе параметры - гэта выразы, якія змяшчаюць наступныя канстанты:

w
h

Шырыня і вышыня ўводу.

a

тое самае, што w/h

sar

суадносіны бакоў узору ўводу

dar

суадносіны бакоў уваходнага дысплея, яно такое ж, як ( w/ h) *sar

n

Нумар уваходнага кадра, пачынаючы з 0.

t

Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.

pos

пазіцыя ў файле ўваходнага кадра, NAN, калі невядома

11.240.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.241 swapuv

Памяняйце месцамі самалёты U і V.

11.242 tblend

Змяшайце паслядоўныя відэакадры.

Глядзі сумесь

11.243 telecine

Прымяніць працэс тэлекіно да відэа.

Гэты фільтр прымае наступныя параметры:

first_field
'top, t'

спачатку верхняе поле

'bottom, b'

ніжняе поле спачатку Значэнне па змаўчанні - top.

pattern

Лічбавы радок, які прадстаўляе шаблон выпадальнага меню, які вы хочаце прымяніць. Значэнне па змаўчанні - 23.

Some typical patterns:

NTSC output (30i):
27.5p: 32222
24p: 23 (classic)
24p: 2332 (preferred)
20p: 33
18p: 334
16p: 3444

PAL output (25i):
27.5p: 12222
24p: 222222222223 ("Euro pulldown")
16.67p: 33
16p: 33333334

11.244 thistogram

Вылічыце і намалюйце гістаграму размеркавання колеру для ўваходнага відэа ў часе.

У адрозненне ад відэафільтра гістаграмы , які паказвае гістаграму толькі аднаго ўваходнага кадра ў пэўны час, гэты фільтр паказвае таксама мінулыя гістаграмы колькасці кадраў, вызначаных widthопцыяй.

Вылічаная гістаграма - гэта адлюстраванне размеркавання кампанентаў колеру на малюнку.

Фільтр прымае наступныя параметры:

width, w

Задаць шырыню вываду аднакаляровага кампанента. Значэнне па змаўчанні - 0. Значэнне 0сярэдняй шырыні будзе выбірацца з уваходнага відэа. Гэта таксама задае колькасць пройдзеных гістаграм, якія трэба захаваць. Дазволены дыяпазон [0, 8192].

display_mode, d

Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:

'stack'

Графікі кампанентаў колеру размешчаны адзін пад адным.

'parade'

Графікі кампанентаў колеру размешчаны побач.

'overlay'

Прадстаўляе інфармацыю, ідэнтычную той, што ў parade, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.

Па змаўчанні stack.

levels_mode, m

Усталяваць рэжым. Можа быць або linear, або logarithmic. Па змаўчанні linear.

components, c

Усталюйце кампаненты колеру для адлюстравання. Па змаўчанні 7.

bgopacity, b

Задаць непразрыстасць фону. Па змаўчанні 0.9.

envelope, e

Паказаць канверт. Па змаўчанні адключана.

ecolor, ec

Задаць колер канверта. Па змаўчанні gold.

slide

Усталяваць рэжым слайдаў.

Даступныя значэнні для слайда:

'frame'

Намалюйце новую рамку, калі будзе дасягнута правая мяжа.

'replace'

Замяніць старыя слупкі на новыя.

'scroll'

Пракрутка справа налева.

'rscroll'

Пракруціць злева направа.

'picture'

Намалюйце адну карцінку.

Па змаўчанні replace.

11.245 threshold

Прымяніць парогавы эфект да відэаструменю.

Для выканання парогавага значэння гэтаму фільтру патрэбны чатыры відэапатокі. Першы паток - гэта паток, які мы фільтруем. Другі паток утрымлівае парогавыя значэнні, трэці паток утрымлівае мінімальныя значэнні, а апошні, чацвёрты паток утрымлівае максімальныя значэнні.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

Напрыклад, калі значэнне кампанента пікселя першага патоку меншае за парогавае значэнне кампанента пікселя з 2-га парогавага патоку, будзе выбрана значэнне трэцяга патоку, у адваротным выпадку будзе выбрана значэнне кампанента пікселя чацвёртага патоку.

Выкарыстоўваючы фільтр крыніцы колеру, можна выконваць розныя тыпы парогаў:

11.245.1 Commands

Гэты фільтр падтрымлівае ўсе параметры ў якасці каманд .

11.245.2 Examples

  • Двайковы парог з выкарыстаннем шэрага колеру ў якасці парога:
    ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=black -f lavfi -i color=white -lavfi threshold output.avi
    
  • Перавернуты двайковы парог з выкарыстаннем шэрага колеру ў якасці парога:
    ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=white -f lavfi -i color=black -lavfi threshold output.avi
    
  • Скароціце двайковы парог, выкарыстоўваючы шэры колер у якасці парога:
    ffmpeg -i 320x240.avi -f lavfi -i color=gray -i 320x240.avi -f lavfi -i color=gray -lavfi threshold output.avi
    
  • Парог да нуля, з выкарыстаннем шэрага колеру ў якасці парога:
    ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=white -i 320x240.avi -lavfi threshold output.avi
    
  • Інвертаваны парог да нуля, выкарыстанне шэрага колеру ў якасці парога:
    ffmpeg -i 320x240.avi -f lavfi -i color=gray -i 320x240.avi -f lavfi -i color=white -lavfi threshold output.avi
    

11.246 thumbnail

Выберыце найбольш рэпрэзентатыўны кадр у дадзенай паслядоўнасці паслядоўных кадраў.

Фільтр прымае наступныя параметры:

n

Усталюйце памер пакета кадраў для аналізу; у наборы nкадраў фільтр выбярэ адзін з іх, а затым апрацуе наступную партыю nкадраў да канца. Па змаўчанні 100.

Паколькі фільтр адсочвае ўсю паслядоўнасць кадраў, большае n значэнне прывядзе да большага выкарыстання памяці, таму высокае значэнне не рэкамендуецца.

11.246.1 Examples

  • Вылучыце адну фатаграфію на кожныя 50 кадраў:
    thumbnail=50
    
  • Поўны прыклад стварэння эскіза з дапамогай ffmpeg:
    ffmpeg -i in.avi -vf thumbnail,scale=300:200 -frames:v 1 out.png
    

11.247 tile

Злучыце некалькі паслядоўных кадраў.

Фільтр untle можа зрабіць адваротнае.

Фільтр прымае наступныя параметры:

layout

Усталюйце памер сеткі ў форме COLUMNSxROWS. Дыяпазон да UINT_MAX ячэек. Па змаўчанні 6x5.

nb_frames

Усталюйце максімальную колькасць кадраў для адлюстравання ў дадзенай вобласці. Яно павінна быць меншым або роўным wx h. Значэнне па змаўчанні - гэта 0азначае, што будзе выкарыстоўвацца ўся вобласць.

margin

Усталюйце вонкавае поле мяжы ў пікселях. Дыяпазон ад 0 да 1024. Па змаўчанні - 0.

padding

Усталюйце таўшчыню ўнутранай мяжы (г.зн. колькасць пікселяў паміж кадрамі). Каб атрымаць больш пашыраныя параметры запаўнення (напрыклад, розныя значэнні для краёў), звярніцеся да відэафільтра пракладкі. Дыяпазон ад 0 да 1024. Па змаўчанні - 0.

color

Пакажыце колер невыкарыстоўваемай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні color- "чорны".

overlap

Усталюйце колькасць кадраў, якія будуць перакрывацца пры аб'яднанні некалькіх паслядоўных кадраў. Значэнне павінна быць паміж 0і nb_frames - 1. Па змаўчанні 0.

init_padding

Усталюйце пустую колькасць кадраў перад адлюстраваннем першага выходнага кадра. Гэта кантралюе, як хутка атрымаецца першы выходны кадр. Значэнне павінна быць паміж 0і nb_frames - 1. Па змаўчанні 0.

11.247.1 Examples

  • Стварайце пліткі PNG для ўсіх ключавых кадраў 8x8 (-skip_frame nokey) у фільме:
    ffmpeg -skip_frame nokey -i file.avi -vf 'scale=128:72,tile=8x8' -an -vsync 0 keyframes%03d.png
    

    The-vsync 0неабходна прадухіліцьffmpeg дубліравання кожнага выхаднога кадра для размяшчэння першапачаткова выяўленай частаты кадраў.

  • Паказваць 5малюнкі ў вобласці 3x2кадраў з 7пікселямі паміж імі і 2пікселямі пачатковага поля, выкарыстоўваючы змешаныя плоскія і названыя параметры:
    tile=3x2:nb_frames=5:padding=7:margin=2
    

11.248 tinterlace

Выканайце розныя віды перапляцення скроневых палёў.

Кадры лічацца, пачынаючы з 1, таму першы ўваходны кадр лічыцца няцотным.

Фільтр прымае наступныя параметры:

mode

Укажыце рэжым перапляцення. Гэтую опцыю таксама можна ўказаць як значэнне. Спіс значэнняў для гэтай опцыі глядзіце ніжэй.

Даступныя значэнні:

'merge, 0'

Перамясціць няцотныя кадры ў верхняе поле, цотныя ў ніжняе поле, ствараючы кадр падвойнай вышыні з паловай частатой кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444

Output:
11111                           33333
22222                           44444
11111                           33333
22222                           44444
11111                           33333
22222                           44444
11111                           33333
22222                           44444
'drop_even, 1'

Выводзяць толькі няцотныя кадры, цотныя кадры выдаляюцца, ствараючы кадр з нязменнай вышынёй з паловай частаты кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444

Output:
11111                           33333
11111                           33333
11111                           33333
11111                           33333
'drop_odd, 2'

Выводзяць толькі цотныя кадры, няцотныя кадры выдаляюцца, ствараючы кадр з нязменнай вышынёй з паловай частаты кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444

Output:
                22222                           44444
                22222                           44444
                22222                           44444
                22222                           44444
'pad, 3'

Разгарніце кожны кадр на поўную вышыню, але чаргайце лініі чорным колерам, ствараючы кадр з падвойнай вышынёй пры той жа частаце ўваходных кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444

Output:
11111           .....           33333           .....
.....           22222           .....           44444
11111           .....           33333           .....
.....           22222           .....           44444
11111           .....           33333           .....
.....           22222           .....           44444
11111           .....           33333           .....
.....           22222           .....           44444
'interleave_top, 4'

Перамяжоўвайце верхняе поле з няцотных кадраў з ніжнім полем з цотных кадраў, ствараючы кадр з нязменнай вышынёй з палавінай частаты кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111<-         22222           33333<-         44444
11111           22222<-         33333           44444<-
11111<-         22222           33333<-         44444
11111           22222<-         33333           44444<-

Output:
11111                           33333
22222                           44444
11111                           33333
22222                           44444
'interleave_bottom, 5'

Перамяжоўвайце ніжняе поле з няцотных кадраў з верхнім полем з цотных кадраў, ствараючы кадр з нязменнай вышынёй з палавінай частаты кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222<-         33333           44444<-
11111<-         22222           33333<-         44444
11111           22222<-         33333           44444<-
11111<-         22222           33333<-         44444

Output:
22222                           44444
11111                           33333
22222                           44444
11111                           33333
'interlacex2, 6'

Падвоеная частата кадраў пры нязменнай вышыні. Устаўляюцца кадры, кожны з якіх змяшчае другое часовае поле з папярэдняга ўваходнага кадра і першае часовае поле з наступнага ўваходнага кадра. Гэты рэжым абапіраецца на сцяг top_field_first. Карысна для дысплеяў празрадковай разгорткі без сінхранізацыі палёў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
 11111           22222           33333           44444
11111           22222           33333           44444
 11111           22222           33333           44444

Output:
11111   22222   22222   33333   33333   44444   44444
 11111   11111   22222   22222   33333   33333   44444
11111   22222   22222   33333   33333   44444   44444
 11111   11111   22222   22222   33333   33333   44444
'mergex2, 7'

Перамясціць няцотныя кадры ў верхняе поле, цотныя ў ніжняе поле, ствараючы кадр падвойнай вышыні з той жа частатой кадраў.

 ------> time
Input:
Frame 1         Frame 2         Frame 3         Frame 4

11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444
11111           22222           33333           44444

Output:
11111           33333           33333           55555
22222           22222           44444           44444
11111           33333           33333           55555
22222           22222           44444           44444
11111           33333           33333           55555
22222           22222           44444           44444
11111           33333           33333           55555
22222           22222           44444           44444

Лікавыя значэнні састарэлі, але прымаюцца з меркаванняў зваротнай сумяшчальнасці.

Рэжым па змаўчанні - merge.

flags

Укажыце сцягі, якія ўплываюць на працэс фільтрацыі.

Даступнае значэнне для flags:

low_pass_filter, vlpf

Уключыце ў фільтры лінейную вертыкальную фільтрацыю нізкіх частот. Вертыкальная фільтрацыя нізкіх частот патрабуецца пры стварэнні празрадковага пункта прызначэння з прагрэсіўнай крыніцы, якая змяшчае высокачашчынныя вертыкальныя дэталі. Фільтрацыя зменшыць празрадковы "шчабятанне" і муар.

complex_filter, cvlpf

Уключыце складаную вертыкальную фільтрацыю нізкіх частот. Гэта крыху менш зменшыць празрадковы "шчабятанне" і муар, але лепш захавае дэталі і суб'ектыўную выразнасць.

bypass_il

Абыходзьце ўжо празрадковыя кадры, адрэгулюйце толькі частату кадраў.

Вертыкальную фільтрацыю нізкіх частот і абыход ужо празрадковай разгорткі можна ўключыць толькі дляmode interleave_topі interleave_bottom.

11.249 tmedian

Выберыце сярэднія пікселі з некалькіх паслядоўных уваходных відэакадраў.

Фільтр прымае наступныя параметры:

radius

Задаць радыус сярэдняга фільтра. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 127.

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 15, паводле якога апрацоўваюцца ўсе плоскасці.

percentile

Задаць сярэдні працэнт. Значэнне па змаўчанні - 0.5. Значэнне па змаўчанні 0.5заўсёды будзе выбіраць сярэднія значэнні, а 0мінімальныя значэнні і 1максімальныя.

11.249.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд , за выключэннем опцыі radius.

11.250 tmidequalizer

Прымяненне эфекту Temporal Midway Video Equalization.

Midway Video Equalization наладжвае паслядоўнасць відэакадраў, каб мець аднолькавыя гістаграмы, захоўваючы пры гэтым іх дынаміку, наколькі гэта магчыма. Гэта карысна, напрыклад, для супастаўлення экспазіцыі з паслядоўнасці відэакадраў.

Гэты фільтр прымае наступныя параметры:

radius

Усталюйце радыус фільтрацыі. Па змаўчанні 5. Дазволены дыяпазон ад 1 да 127.

sigma

Усталюйце сігму фільтрацыі. Па змаўчанні 0.5. Гэта кантралюе сілу фільтрацыі. Усталяванне гэтага параметра ў 0 фактычна нічога не дае.

planes

Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні - 15усе даступныя самалёты.

11.251 tmix

Змяшайце паслядоўныя відэакадры.

Далей апісваюцца прынятыя варыянты.

frames

Колькасць паслядоўных кадраў для змешвання. Калі не пазначана, па змаўчанні 3.

weights

Укажыце вагу кожнага ўваходнага відэакадра. Кожная вага аддзяляецца прабелам. Калі колькасць вагаў меншая за колькасць framesапошняй вызначанай вагі, будзе выкарыстоўвацца для ўсіх астатніх неўсталяваных вагаў.

scale

Укажыце маштаб, калі ён усталяваны, ён будзе памножаны на суму кожнай вагі, памножанай на значэнні пікселяў, каб атрымаць канчатковае значэнне пікселя прызначэння. Па змаўчанні scaleаўтаматычна маштабуецца да сумы вагаў.

planes

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.

11.251.1 Examples

  • У сярэднім 7 паслядоўных кадраў:
    tmix=frames=7:weights="1 1 1 1 1 1 1"
    
  • Прымяніць простую часовую згортку:
    tmix=frames=3:weights="-1 3 -1"
    
  • Падобна вышэй, але паказвае толькі часовыя адрозненні:
    tmix=frames=3:weights="-1 2 -1":scale=1
    

11.251.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

weights
scale
planes

Сінтаксіс той жа, што і варыянт з такой жа назвай.

11.252 tonemap

Колеры танальнай карты з розных дынамічных дыяпазонаў.

Гэты фільтр чакае даныя ў адзінарнай дакладнасці з плаваючай кропкай, таму што ён павінен працаваць са значэннямі (і можа выводзіць) па-за дыяпазонам. Іншы фільтр, напрыклад, zscale , неабходны для пераўтварэння атрыманага кадра ў фармат, прыдатны для выкарыстання.

Рэалізаваныя алгарытмы адлюстравання тонаў працуюць толькі на лінейным святле, таму ўваходныя даныя павінны быць папярэдне лінеарызаваны (і, магчыма, правільна пазначаны).

ffmpeg -i INPUT -vf zscale=transfer=linear,tonemap=clip,zscale=transfer=bt709,format=yuv420p OUTPUT

11.252.1 Options

Фільтр прымае наступныя параметры.

tonemap

Усталюйце алгарытм танальнай карты для выкарыстання.

Магчымыя значэнні:

none

Не прымяняйце карту тонаў, толькі абясцэньвайце яркія пікселі.

clip

Жорсткае адсячэнне значэнняў, якія выходзяць за межы дыяпазону. Выкарыстоўвайце яго для ідэальнай дакладнасці колеру для значэнняў у дыяпазоне, адначасова скажаючы значэнні па-за дыяпазонам.

linear

Расцягнуць усю эталонную гаму да лінейнага кратнага дысплею.

gamma

Падбярыце лагарыфмічны перанос паміж крывымі тону.

reinhard

Захавайце агульную яркасць выявы з дапамогай простай крывой, выкарыстоўваючы нелінейны кантраст, што прыводзіць да згладжвання дэталяў і пагаршэння дакладнасці колеру.

hable

Захавайце як цёмныя, так і яркія дэталі лепш, чым reinhard, за кошт таго, каб усё крыху зацямніць. Выкарыстоўвайце яго, калі захаванне дэталяў больш важна, чым дакладнасць колеру і яркасці.

mobius

Плаўна адлюстроўвайце значэнні па-за дыяпазонам, захоўваючы пры гэтым кантраснасць і колеры для матэрыялу ў дыяпазоне, наколькі гэта магчыма. Выкарыстоўвайце яго, калі дакладнасць колеру больш важная, чым захаванне дэталяў.

Па змаўчанні няма.

param

Наладзьце алгарытм танальнага адлюстравання.

Гэта ўплывае на наступныя алгарытмы:

none

Ігнаруецца.

linear

Вызначае маштабны каэфіцыент для выкарыстання падчас расцягвання. Па змаўчанні 1.0.

gamma

Задае паказчык функцыі. Па змаўчанні 1.8.

clip

Укажыце дадатковы лінейны каэфіцыент для множання сігналу перад адсячэннем. Па змаўчанні 1.0.

reinhard

Укажыце мясцовы каэфіцыент кантраснасці на піку дысплея. Па змаўчанні значэнне 0,5, што азначае, што значэнні ўнутранай гамы будуць прыкладна ўдвая менш яркімі, чым пры выразанні.

hable

Ігнаруецца.

mobius

Укажыце кропку пераходу ад лінейнага да пераўтварэння Мёбіуса. Кожнае значэнне ніжэй за гэты пункт гарантавана адлюстроўваецца 1:1. Чым вышэй значэнне, тым больш дакладным будзе вынік за кошт страты яркіх дэталяў. Па змаўчанні 0,3, які з-за крутога пачатковага нахілу па-ранейшаму даволі дакладна захоўвае колеры ў дыяпазоне.

desat

Ужывайце дэсатурацыю для блікаў, якія перавышаюць гэты ўзровень яркасці. Чым вышэй параметр, тым больш інфармацыі аб колеры будзе захавана. Гэта налада дапамагае прадухіліць ненатуральна цьмяныя колеры для суперблікаў, замест гэтага (плаўна) ператвараючыся ў белыя. Гэта робіць выявы больш натуральнымі, за кошт памяншэння інфармацыі аб колерах, якія не ўваходзяць у дыяпазон.

Значэнне па змаўчанні 2.0 з'яўляецца некалькі кансерватыўным і ў асноўным будзе прымяняцца толькі да неба або паверхняў, асветленых прамым сонцам. Параметр 0.0 адключае гэты параметр.

Гэты параметр працуе, толькі калі ўваходны фрэйм ​​мае падтрымліваемую каляровую тэгу.

peak

Перавызначыць сігнал/намінальны/эталонны пік гэтым значэннем. Карысна, калі ўбудаваная пікавая інфармацыя ў метададзеныя дысплея ненадзейная або калі танальнае адлюстраванне з ніжняга дыяпазону на больш высокі.

11.253 tpad

Часова змясціць відэакадры.

Фільтр прымае наступныя параметры:

start

Укажыце колькасць кадраў затрымкі перад уваходным відэаструменем. Па змаўчанні 0.

stop

Укажыце колькасць кадраў запаўнення пасля ўваходнага відэаструменю. Усталюйце -1, каб пракладваць бясконца. Па змаўчанні 0.

start_mode

Усталюйце тып кадраў, якія дадаюцца ў пачатак патоку. Можа быць або addабо clone. Дадаюцца addрамкі суцэльнага колеру. З cloneкадрамі - клоны першага кадра. Па змаўчанні add.

stop_mode

Усталюйце тып кадраў, якія дадаюцца ў канец патоку. Можа быць або addабо clone. Дадаюцца addрамкі суцэльнага колеру. З cloneкадрамі - клоны апошняга кадра. Па змаўчанні add.

start_duration, stop_duration

Укажыце працягласць затрымкі запуску/выключэння. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Гэтыя параметры перавызначаюць startі stop. Па змаўчанні 0.

color

Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

Значэнне па змаўчанні color- "чорны".

11.254 transpose

Транспанаваць радкі са слупкамі ва ўваходным відэа і пры жаданні перавярнуць яго.

Ён прымае наступныя параметры:

dir

Укажыце напрамак транспазіцыі.

Можа прымаць наступныя значэнні:

'0, 4, cclock_flip'

Паварот на 90 градусаў супраць гадзіннікавай стрэлкі і вертыкальны пераварот (па змаўчанні), гэта значыць:

L.R     L.l
. . ->  . .
l.r     R.r
'1, 5, clock'

Паварот на 90 градусаў па гадзіннікавай стрэлцы, гэта значыць:

L.R     l.L
. . ->  . .
l.r     r.R
'2, 6, cclock'

Паварот на 90 градусаў супраць гадзінны стрэлкі, гэта значыць:

L.R     R.r
. . ->  . .
l.r     L.l
'3, 7, clock_flip'

Паварот на 90 градусаў па гадзіннікавай стрэлцы і вертыкальны пераварот, гэта значыць:

L.R     r.R
. . ->  . .
l.r     l.L

Для значэнняў паміж 4-7 транспазіцыя выконваецца толькі ў тым выпадку, калі геаметрыя ўваходнага відэа з'яўляецца партрэтнай, а не альбомнай. Гэтыя значэнні састарэлі, passthroughзамест іх трэба выкарыстоўваць опцыю.

Лікавыя значэнні састарэлі, і ад іх трэба адмовіцца на карысць сімвалічных канстант.

passthrough

Не прымяняйце транспазіцыю, калі ўваходная геаметрыя супадае з той, якая вызначана ўказаным значэннем. Ён прымае наступныя значэнні:

'none'

Заўсёды ўжывайце транспазіцыю.

'portrait'

Захоўваць партрэтную геаметрыю (калі height>= width).

'landscape'

Захаваць ландшафтную геаметрыю (калі width>= height).

Значэнне па змаўчанні - none.

Напрыклад, каб павярнуць на 90 градусаў па гадзіннікавай стрэлцы і захаваць партрэтны макет:

transpose=dir=1:passthrough=portrait

Прыведзеная вышэй каманда таксама можа быць вызначана як:

transpose=1:portrait

11.255 transpose_npp

Транспанаваць радкі са слупкамі ва ўваходным відэа і пры жаданні перавярнуць яго. Для атрымання больш падрабязных прыкладаў глядзіце відэафільтр транспанавання , які мае ў асноўным тыя ж параметры.

Ён прымае наступныя параметры:

dir

Укажыце напрамак транспазіцыі.

Можа прымаць наступныя значэнні:

'cclock_flip'

Павярніце на 90 градусаў супраць гадзіннікавай стрэлкі і перавярніце вертыкальна. (па змаўчанні)

'clock'

Паварот на 90 градусаў па гадзіннікавай стрэлцы.

'cclock'

Павярніце на 90 градусаў супраць гадзінны стрэлкі.

'clock_flip'

Павярніце на 90 градусаў па гадзіннікавай стрэлцы і перавярніце вертыкальна.

passthrough

Не прымяняйце транспазіцыю, калі ўваходная геаметрыя супадае з той, якая вызначана ўказаным значэннем. Ён прымае наступныя значэнні:

'none'

Заўсёды ўжывайце транспазіцыю. (па змаўчанні)

'portrait'

Захоўваць партрэтную геаметрыю (калі height>= width).

'landscape'

Захаваць ландшафтную геаметрыю (калі width>= height).

11.256 trim

Абрэжце ўваход так, каб выхад утрымліваў адну суцэльную падчастку ўваходу.

Ён прымае наступныя параметры:

start

Пакажыце час пачатку захаванага раздзела, г.зн. кадр з пазнакай часу startбудзе першым кадрам у вывадзе.

end

Укажыце час першага кадра, які будзе выдалены, гэта значыць кадр, які непасрэдна папярэднічае кадру з пазнакай часу end, будзе апошнім кадрам у вывадзе.

start_pts

Гэта тое ж самае, што і start, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу пачатку ў адзінках базы часу, а не ў секундах.

end_pts

Гэта тое ж самае, што і end, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу ў часавых адзінках замест секунд.

duration

Максімальная працягласць вываду ў секундах.

start_frame

Нумар першага кадра, які трэба перадаць на выхад.

end_frame

Нумар першага кадра, які павінен быць адкінуты.

start,end, іdurationвыражаюцца як характарыстыкі працягласці часу; гл. (ffmpeg-utils) раздзел Працягласць часу ў кіраўніцтве ffmpeg-utils(1) , каб даведацца пра прыняты сінтаксіс.

Звярніце ўвагу, што першыя два наборы параметраў пачатку/канца іduration Варыянт глядзіць на пазнаку часу кадра, у той час як варыянты _frame проста падлічваюць кадры, якія праходзяць праз фільтр. Таксама звярніце ўвагу, што гэты фільтр не змяняе часовыя пазнакі. Калі вы хочаце, каб пазнакі часу вываду пачыналіся з нуля, устаўце фільтр setpts пасля фільтра абрэзкі.

Калі ўстаноўлена некалькі параметраў пачатку або канца, гэты фільтр спрабуе быць прагным і захаваць усе кадры, якія адпавядаюць хаця б аднаму з указаных абмежаванняў. Каб захаваць толькі тую частку, якая адначасова адпавядае ўсім абмежаванням, звяжыце некалькі фільтраў падрэзкі.

Значэнні па змаўчанні такія, што ўвесь увод захоўваецца. Такім чынам, можна ўсталяваць, напрыклад, толькі канчатковыя значэнні, каб захаваць усё да вызначанага часу.

Прыклады:

  • Адкіньце ўсё, акрамя другой хвіліны ўводу:
    ffmpeg -i INPUT -vf trim=60:120
    
  • Захоўвайце толькі першую секунду:
    ffmpeg -i INPUT -vf trim=duration=1
    

11.257 unpremultiply

Прымяненне эфекту альфа-непамнажэння да ўваходнага відэапатоку з выкарыстаннем першай плоскасці другога патоку ў якасці альфа-канала.

Абодва патокі павінны мець аднолькавыя памеры і аднолькавы фармат пікселяў.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.

Калі фармат мае 1 ці 2 кампаненты, то яркасць мае біт 0. Калі фармат мае 3 ці 4 кампаненты: для фарматаў RGB біт 0 зялёны, біт 1 сіні і біт 2 чырвоны; для фарматаў YUV біт 0 - яркасць, біт 1 - каляровасць-U, а біт 2 - каляровасць-V. Пры наяўнасці альфа-канал заўсёды апошні біт.

inplace

Не патрабуецца другі ўвод для апрацоўкі, замест гэтага выкарыстоўвайце альфа-плоскасць з уваходнага патоку.

11.258 unsharp

Павышэнне рэзкасці або размыццё ўваходнага відэа.

Ён прымае наступныя параметры:

luma_msize_x, lx

Усталюйце гарызантальны памер матрыцы яркасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

luma_msize_y, ly

Усталюйце вертыкальны памер матрыцы яркасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

luma_amount, la

Усталюйце сілу эфекту яркасці. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.

Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.

Значэнне па змаўчанні 1,0.

chroma_msize_x, cx

Усталюйце гарызантальны памер матрыцы каляровасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

chroma_msize_y, cy

Усталюйце вертыкальны памер каляровай матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

chroma_amount, ca

Усталюйце сілу каляровага эфекту. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.

Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.

Значэнне па змаўчанні 0,0.

alpha_msize_x, ax

Усталюйце гарызантальны памер альфа-матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

alpha_msize_y, ay

Усталюйце вертыкальны памер альфа-матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.

alpha_amount, aa

Усталюйце сілу альфа-эфекту. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.

Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.

Значэнне па змаўчанні 0,0.

Усе параметры неабавязковыя і па змаўчанні адносяцца да радка "5:5:1.0:5:5:0.0".

11.258.1 Examples

  • Ужыць моцны эфект павышэння яркасці:
    unsharp=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5
    
  • Прымяніце моцнае размыццё параметраў яркасці і каляровасці:
    unsharp=7:7:-2:7:7:-2
    

11.259 untile

Раздзяліце відэа, складзенае з пліткавых малюнкаў, на асобныя выявы.

Частата кадраў выхаднога відэа - гэта частата кадраў уваходнага відэа, памножаная на колькасць плітак.

Гэты фільтр выконвае дзеянні, адваротныя плітцы .

Фільтр прымае наступныя параметры:

layout

Усталюйце памер сеткі (г.зн. колькасць радкоў і слупкоў). Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

11.259.1 Examples

  • Стварыце 1-секунднае відэа з файла нерухомай выявы, які складаецца з 25 кадраў, размешчаных вертыкальна, як аналагавая кінастужка:
    ffmpeg -r 1 -i image.jpg -vf untile=1x25 movie.mkv
    

11.260 uspp

Ужывайце звышпавольны/просты фільтр постапрацоўкі, які сціскае і распакоўвае малюнак на некалькі (або - у выпадкуqualityузровень 8- усе) змены і асерадненне вынікаў.

Адрозненне гэтага ад паводзін spp заключаецца ў тым, што uspp фактычна кадуе і дэкадуе кожны выпадак з дапамогай libavcodec Snow, у той час як spp выкарыстоўвае спрошчаны DCT толькі 8x8, падобны на MJPEG.

Гэты фільтр даступны толькі ў ffmpeg версіі 4.4 або больш ранняй.

Фільтр прымае наступныя параметры:

quality

Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 0-8. Калі ўстаноўлена 0, фільтр не будзе мець ніякага эфекту. Значэнне 8азначае больш высокую якасць. Для кожнага павелічэння гэтага значэння хуткасць падае прыблізна ў 2 разы. Значэнне па змаўчанні - 3.

qp

Прымусова ўсталяваць пастаянны параметр квантавання. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).

11.261 v360

Пераўтварэнне 360 відэа ў розныя фарматы.

Фільтр прымае наступныя параметры:

input
output

Устанавіць фармат відэаўваходу/вываду.

Даступныя фарматы:

'e'
'equirect'

Раўнапрамавугольнае праецыраванне.

'c3x2'
'c6x1'
'c1x6'

Кубічная карта з макетам 3x2/6x1/1x6.

Спецыфічныя параметры фармату:

in_pad
out_pad

Усталюйце прапорцыю запаўнення для кубічнай карты ўводу/вываду. Значэнні ў дзесятковых знаках.

Прыклады значэнняў:

'0'

Няма абіўкі.

'0.01'

1% твару займае абіўка. Напрыклад, пры раздзяленні 1920x1280 памер грані будзе 640x640, а водступ будзе складаць 3 пікселі з кожнага боку. (640 * 0,01 = 6 пікселяў)

Значэнне па змаўчанні '0' . Максімальнае значэнне '0.1' .

fin_pad
fout_pad

Усталюйце фіксаванае запаўненне кубічнай карты ўводу/вываду. Значэнні ў пікселях.

Значэнне па змаўчанні '0' . Калі больш за нуль, гэта перавызначае іншыя параметры запаўнення.

in_forder
out_forder

Задаць парадак граняў для кубічнай карты ўводу/вываду. Выберыце адзін кірунак для кожнай пазіцыі.

Абазначэнне напрамкаў:

'r'

справа

'l'

злева

'u'

уверх

'd'

ўніз

'f'

наперад

'b'

назад

Значэнне па змаўчанні 'rludfb' .

in_frot
out_frot

Задаць паварот граняў для кубічнай карты ўводу/вываду. Выберыце адзін кут для кожнай пазіцыі.

Абазначэнне вуглоў:

'0'

0 градусаў па гадзіннікавай стрэлцы

'1'

90 градусаў па гадзіннікавай стрэлцы

'2'

180 градусаў па гадзіннікавай стрэлцы

'3'

270 градусаў па гадзіннікавай стрэлцы

Значэнне па змаўчанні '000000' .

'eac'

Раўнавугольная кубічная карта.

'flat'
'gnomonic'
'rectilinear'

Звычайнае відэа.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'dfisheye'

Двайны рыбін вачэй.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'barrel'
'fb'
'barrelsplit'

Фарматы Facebook 360.

'sg'

Стэрэаграфічны фармат.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'mercator'

Фармат Mercator.

'ball'

Шарыкавы фармат дае значнае скажэнне ў бок спіны.

'hammer'

Фармат праекцыі карты Hammer-Aitoff.

'sinusoidal'

Фармат сінусоіднай картаграфічнай праекцыі.

'fisheye'

Праекцыя рыбінага вока.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'pannini'

Праекцыя Паніні.

Спецыфічныя параметры фармату:

h_fov

Усталюйце выходны параметр Pannini.

ih_fov

Задаць уваходны параметр Pannini.

'cylindrical'

Цыліндрычная праекцыя.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'perspective'

Перспектыўная праекцыя. (толькі выхад)

Спецыфічныя параметры фармату:

v_fov

Задаць параметр перспектывы.

'tetrahedron'

Праекцыя тэтраэдра.

'tsp'

Праекцыя ўсечанай квадратнай піраміды.

'he'
'hequirect'

Палавінная раўнавугольная праекцыя.

'equisolid'

Equisolid фармат.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'og'

Арфаграфічны фармат.

Спецыфічныя параметры фармату:

h_fov
v_fov
d_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

ih_fov
iv_fov
id_fov

Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.

Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.

'octahedron'

Праекцыя актаэдра.

'cylindricalea'

Цыліндрычная роўнаплошчавая праекцыя.

interp

Задаць метад інтэрпаляцыі.
Заўвага: для выканання больш складаных метадаў інтэрпаляцыі патрабуецца значна больш памяці.

Даступныя метады:

'near'
'nearest'

Бліжэйшы сусед.

'line'
'linear'

Білінейная інтэрпаляцыя.

'lagrange9'

Інтэрпаляцыя Лагранжа9.

'cube'
'cubic'

Бікубічная інтэрпаляцыя.

'lanc'
'lanczos'

Інтэрпаляцыя Ланцоша.

'sp16'
'spline16'

Сплайн16 інтэрпаляцыя.

'gauss'
'gaussian'

Інтэрпаляцыя Гаўса.

'mitchell'

Інтэрпаляцыя Мітчэла.

Значэнне па змаўчанні 'line' .

w
h

Усталюйце дазвол выходнага відэа.

Раздзяленне па змаўчанні залежыць ад фарматаў.

in_stereo
out_stereo

Усталюйце стэрэафармат уваходу/вываду.

'2d'

2D мона

'sbs'

Побач

'tb'

Зверху знізу

Значэнне па змаўчанні '2d' для фармату ўводу і вываду.

yaw
pitch
roll

Усталюйце паварот для выхаднога відэа. Значэнні ў градусах.

rorder

Усталюйце парадак павароту для выхаднога відэа. Абярыце адзін прадмет для кожнай пазіцыі.

'y, Y'

гойсанне

'p, P'

крок

'r, R'

рулет

Значэнне па змаўчанні 'ypr' .

h_flip
v_flip
d_flip

Перавярнуць выходнае відэа гарызантальна (памяняць месцамі злева направа)/вертыкальна (памяняць месцамі ўверх-уніз)/углыб (памяняць месцамі назад-уперад). Лагічныя значэнні.

ih_flip
iv_flip

Устанавіце, калі ўваходнае відэа пераварочваецца па гарызанталі/вертыкалі. Лагічныя значэнні.

in_trans

Устанавіце, калі ўваходнае відэа транспануецца. Лагічнае значэнне, па змаўчанні адключана.

out_trans

Устанавіце, ці патрэбна транспазіцыя выхаднога відэа. Лагічнае значэнне, па змаўчанні адключана.

h_offset
v_offset

Устанавіць гарызантальнае/вертыкальнае зрушэнне па восі вываду. Па змаўчанні ўстаноўлена 0. Дазволены дыяпазон ад -1 да 1.

alpha_mask

Стварыце маску ў альфа-плоскасці для ўсіх неадлюстраваных пікселяў, пазначыўшы іх цалкам празрыстымі. Лагічнае значэнне, па змаўчанні адключана.

reset_rot

Скінуць паварот выхаднога відэа. Лагічнае значэнне, па змаўчанні адключана.

11.261.1 Examples

  • Пераўтварыце роўнапрастакутнае відэа ў кубічную карту з кампаноўкай 3x2 і 1% запаўнення з дапамогай бікубічнай інтэрпаляцыі:
    ffmpeg -i input.mkv -vf v360=e:c3x2:cubic:out_pad=0.01 output.mkv
    
  • Выняць выгляд ззаду Equi-Angular Cubemap:
    ffmpeg -i input.mkv -vf v360=eac:flat:yaw=180 output.mkv
    
  • Пераўтварыце транспазіраваную і гарызантальна перавернутую кубічную карту Equi-Angular Cubemap у стэрэафармаце бок аб бок у раўнапрамавугольны стэрэафармат зверху ўніз:
    v360=eac:equirect:in_stereo=sbs:in_trans=1:ih_flip=1:out_stereo=tb
    

11.261.2 Commands

Гэты фільтр падтрымлівае падмноства вышэйзгаданых опцый у якасці каманд .

11.262 vaguedenoiser

Прымяніце сродак для знішчэння шуму на аснове вейвлетаў.

Ён пераўтварае кожны кадр з уваходнага відэа ў дамен вейвлетаў з дапамогай Коэна-Дабешы-Фэво 9/7. Затым ён прымяняе пэўную фільтрацыю да атрыманых каэфіцыентаў. Пасля гэтага выконваецца зваротнае вейвлет-пераўтварэнне. Дзякуючы ўласцівасцям хвалі, гэта павінна даць добры згладжаны вынік і паменшаны шум без размывання функцый выявы.

Гэты фільтр прымае наступныя параметры:

threshold

Сіла фільтрацыі. Чым вышэй, тым больш адфільтраваным будзе відэа. Жорсткі парог можа выкарыстоўваць больш высокі парог, чым мяккі парог, перш чым відэа будзе выглядаць празмерна адфільтраваным. Значэнне па змаўчанні - 2.

method

Метад фільтрацыі, які будзе выкарыстоўваць фільтр.

Ён прымае наступныя значэнні:

'hard'

Усе значэнні ніжэй парогавага значэння будуць абнулены.

'soft'

Усе значэнні ніжэй парогавага значэння будуць абнулены. Усе значэнні вышэй будуць паменшаны на парог.

'garrote'

Маштабуе або абнуляе каэфіцыенты - пасярэднік паміж (больш) мяккім і (менш) жорсткім парогамі.

Па змаўчанні - гаррота.

nsteps

Колькасць разоў вейвлет раскладзе малюнак. Малюнак не можа быць разбіты за межы пэўнай кропкі (як правіла, 8 для кадра 640x480 - як 2^9 = 512 > 480). Дапушчальныя значэнні - гэта цэлыя лікі ад 1 да 32. Значэнне па змаўчанні - 6.

percent

Частковае ці поўнае знішчэнне шумоў (абмежаванае скарачэнне каэфіцыентаў), ад 0 да 100. Значэнне па змаўчанні 85.

planes

Спіс плоскасцей для апрацоўкі. Па змаўчанні апрацоўваюцца ўсе плоскасці.

type

Тып парога, які будзе выкарыстоўваць фільтр.

Ён прымае наступныя значэнні:

'universal'

Парог, які выкарыстоўваецца, аднолькавы для ўсіх разлажэнняў.

'bayes'

Парог, які выкарыстоўваецца, таксама залежыць ад кожнага каэфіцыента раскладання.

Па змаўчанні ўніверсальны.

11.263 varblur

Прымяніце зменны фільтр размыцця, выкарыстоўваючы 2-й відэаплынь, каб задаць радыус размыцця. 2-й паток павінен мець такія ж памеры.

Гэты фільтр прымае наступныя параметры:

min_r

Задаць мінімальна дазволены радыус. Дазволены дыяпазон ад 0 да 254. Па змаўчанні 0.

max_r

Усталюйце максімальна дазволены радыус. Дазволены дыяпазон ад 1 да 255. Па змаўчанні 8.

planes

Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні выкарыстоўваюцца ўсе.

Фільтр varblurтаксама падтрымлівае параметры framesync .

11.263.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйзгаданыя параметры ў якасці каманд .

11.264 vectorscope

Адлюстраванне 2 значэнняў каляровых кампанентаў у двухмерным графіцы (які называецца вектарскоп).

Гэты фільтр прымае наступныя параметры:

mode, m

Усталюйце рэжым вектороскопа.

Ён прымае наступныя значэнні:

'gray'
'tint'

Значэнні шэрага адлюстроўваюцца на графіку, большая яркасць азначае, што больш пікселяў маюць аднолькавае значэнне колеру кампанента ў месцы на графіку. Гэта рэжым па змаўчанні.

'color'

Шэрыя значэнні адлюстроўваюцца на графіцы. Значэнні навакольных пікселяў, якіх няма ў відэакадры, малююцца градыентам 2 кампанентаў колеру, якія задаюцца опцыяй xі y. 3-ці кампанент колеру статычны.

'color2'

Фактычныя значэнні кампанентаў колеру, якія прысутнічаюць у відэакадры, адлюстроўваюцца на графіцы.

'color3'

Падобны да color2, але больш высокая частата аднолькавых значэнняў xі y на графіцы павялічвае значэнне іншага кампанента колеру, якім з'яўляецца яркасць па значэннях па змаўчанні xі y.

'color4'

Фактычныя колеры, якія прысутнічаюць у відэакадры, адлюстроўваюцца на графіцы. Калі два розныя колеры супадаюць з адной і той жа пазіцыяй на графіцы, то выбіраецца колер з больш высокім значэннем кампанента, якога няма на графіцы.

'color5'

Шэрыя значэнні адлюстроўваюцца на графіцы. Падобна, colorале з 3-м кампанентам колеру, выбраным з радыяльнага градыенту.

x

Усталюйце кампанент колеру, які будзе прадстаўлены на восі X. Па змаўчанні 1.

y

Усталюйце кампанент колеру, які будзе прадстаўлены на восі Y. Па змаўчанні 2.

intensity, i

Усталюйце інтэнсіўнасць, якая выкарыстоўваецца рэжымамі: шэры, колер, колер3 і колер5 для павелічэння яркасці кампанента колеру, які прадстаўляе частату размяшчэння (X, Y) на графіцы.

envelope, e
'none'

Без канверта, гэта па змаўчанні.

'instant'

Імгненны канверт, нават самы цёмны асобны піксель будзе выразна вылучаны.

'peak'

Захоўвайце максімальныя і мінімальныя значэнні, прадстаўленыя на графіку з цягам часу. Такім чынам вы па-ранейшаму можаце заўважыць значэнні за межамі дыяпазону, не гледзячы пастаянна на вектарскоп.

'peak+instant'

Пік і імгненны канверт разам.

graticule, g

Усталюйце, якую сетку маляваць.

'none'
'green'
'color'
'invert'
opacity, o

Задаць непразрыстасць сеткі.

flags, f

Усталюйце сцягі сетак.

'white'

Намалюйце сетку для белай кропкі.

'black'

Намалюйце сетку для чорнай кропкі.

'name'

Намалюйце каляровымі кропкамі кароткія назвы.

bgopacity, b

Задаць непразрыстасць фону.

lthreshold, l

Усталюйце нізкі парог для каляровага кампанента, які не прадстаўлены на восі X або Y. Значэнні ніжэйшыя за гэта значэнне будуць ігнаравацца. Па змаўчанні 0. Звярніце ўвагу, што гэтае значэнне памнажаецца на фактычнае максімальна магчымае значэнне, якое можа мець адзін кампанент пікселя. Такім чынам, для 8-бітнага ўваходу і нізкага парогавага значэння 0,1 фактычны парог складае 0,1 * 255 = 25.

hthreshold, h

Усталюйце высокі парог для кампанента колеру, які не прадстаўлены на восі X або Y. Значэнні, большыя за гэта значэнне, будуць ігнаравацца. Па змаўчанні 1. Звярніце ўвагу, што гэтае значэнне памнажаецца на фактычнае максімальна магчымае значэнне, якое можа мець адзін кампанент пікселя. Такім чынам, для 8-бітнага ўваходу і высокага парогавага значэння 0,9 фактычны парог складае 0,9 * 255 = 230.

colorspace, c

Усталюйце, якую каляровую прастору выкарыстоўваць пры маляванні сеткі.

'auto'
'601'
'709'

Па змаўчанні ўстаноўлена аўтаматычна.

tint0, t0
tint1, t1

Усталюйце адценне колеру для рэжыму вектарскопа шэрага/адцення. Па змаўчанні абодва варыянты роўныя нулю. Гэта азначае адсутнасць адцення, і выхад застанецца шэрым.

11.265 vidstabdetect

Прааналізуйце стабілізацыю/скасаванне відэа. Выканайце праход 1 з 2, гл. vidstabtransform для праходу 2.

Гэты фільтр стварае файл з інфармацыяй аб адносным перакладзе і пераўтварэнні павароту аб наступных кадрах, які затым выкарыстоўваецца vidstabtransform .

Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-libvidstab.

Гэты фільтр прымае наступныя параметры:

result

Усталюйце шлях да файла, які выкарыстоўваецца для запісу інфармацыі пра пераўтварэнні. Значэнне па змаўчанніtransforms.trf.

shakiness

Усталюйце, наколькі хісткае відэа і хуткасць камеры. Ён прымае цэлы лік у дыяпазоне 1-10, значэнне 1 азначае невялікую хісткасць, значэнне 10 азначае моцную хісткасць. Значэнне па змаўчанні - 5.

accuracy

Усталюйце дакладнасць працэсу выяўлення. Значэнне павінна быць у дыяпазоне 1-15. Значэнне 1 азначае нізкую дакладнасць, значэнне 15 азначае высокую дакладнасць. Значэнне па змаўчанні - 15.

stepsize

Задаць памер кроку працэсу пошуку. Вобласць вакол мінімуму скануецца з дазволам 1 піксель. Значэнне па змаўчанні - 6.

mincontrast

Усталюйце мінімальны кантраст. Ніжэй гэтага значэння лакальнае поле вымярэння адкідаецца. Павінна быць значэнне з плаваючай коскай у дыяпазоне 0-1. Значэнне па змаўчанні 0,3.

tripod

Усталюйце апорны нумар кадра для рэжыму штатыва.

Калі ўключана, рух кадраў параўноўваецца з эталонным кадрам у адфільтраваным патоку, ідэнтыфікаваным зададзеным нумарам. Ідэя складаецца ў тым, каб кампенсаваць усе рухі ў больш-менш статычнай сцэне і трымаць агляд камеры абсалютна нерухомым.

Калі ўсталявана 0, ён адключаны. Кадры лічацца ад 1.

show

Паказаць палі і пераўтварэнні ў атрыманых кадрах. Ён прымае цэлы лік у дыяпазоне 0-2. Значэнне па змаўчанні - 0, якое адключае любую візуалізацыю.

11.265.1 Examples

  • Выкарыстоўвайце значэнні па змаўчанні:
    vidstabdetect
    
  • Прааналізуйце моцна хісткі фільм і змесціце вынікі ў файл mytransforms.trf:
    vidstabdetect=shakiness=10:accuracy=15:result="mytransforms.trf"
    
  • Уявіце вынік унутраных пераўтварэнняў у атрыманым відэа:
    vidstabdetect=show=1
    
  • Прааналізуйце відэа з сярэдняй дрыготкай з дапамогай ffmpeg:
    ffmpeg -i input -vf vidstabdetect=shakiness=5:show=1 dummy.avi
    

11.266 vidstabtransform

Стабілізацыя/скасаванне відэа: прайдзіце 2 з 2, гл. vidstabdetect для праходу 1.

Прачытайце файл з інфармацыяй аб трансфармацыі для кожнага кадра і прымяніце/кампенсуйце іх. Разам з фільтрам vidstabdetect гэта можа быць выкарыстана для ліквідацыі ўзрушэння відэа. Глядзіце таксама http://public.hronopik.de/vid.stab . Важна таксама выкарыстоўваць нярэзкі , гл. ніжэй.

Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай --enable-libvidstab.

11.266.1 Options

input

Задайце шлях да файла, які выкарыстоўваецца для чытання пераўтварэнняў. Значэнне па змаўчанні transforms.trf.

smoothing

Усталюйце колькасць кадраў (значэнне*2 + 1), якія выкарыстоўваюцца для нізкачастотнай фільтрацыі рухаў камеры. Значэнне па змаўчанні - 10.

Напрыклад, лік 10 азначае, што для згладжвання руху ў відэа выкарыстоўваецца 21 кадр (10 у мінулым і 10 у будучыні). Большае значэнне прыводзіць да больш плаўнага відэа, але абмяжоўвае паскарэнне камеры (панарамаванне/нахіл). 0 - асаблівы выпадак, калі імітуецца статычная камера.

optalgo

Усталюйце алгарытм аптымізацыі траекторыі камеры.

Дапушчальныя значэнні:

'gauss'

фільтр нізкіх частот ядра Гаўса па руху камеры (па змаўчанні)

'avg'

асерадненне па пераўтварэннях

maxshift

Усталюйце максімальную колькасць пікселяў для перакладу кадраў. Значэнне па змаўчанні -1, што азначае адсутнасць абмежаванняў.

maxangle

Усталюйце максімальны вугал у радыянах (градус*PI/180) для павароту кадраў. Значэнне па змаўчанні -1, што азначае адсутнасць абмежаванняў.

crop

Укажыце, як дзейнічаць з межамі, якія могуць быць бачныя з-за кампенсацыі руху.

Даступныя значэнні:

'keep'

захаваць інфармацыю аб малюнку з папярэдняга кадра (па змаўчанні)

'black'

запоўніце мяжу чорным

invert

Інвертаваць пераўтварэнні, калі ўстаноўлена значэнне 1. Значэнне па змаўчанні - 0.

relative

Разглядаць пераўтварэнні адносна папярэдняга кадра, калі ўстаноўлена значэнне 1, або абсалютнае, калі значэнне 0. Значэнне па змаўчанні роўна 0.

zoom

Усталюйце працэнт маштабавання. Станоўчае значэнне прывядзе да эфекту павелічэння, а адмоўнае - да эфекту памяншэння. Значэнне па змаўчанні 0 (без маштабавання).

optzoom

Усталюйце аптымальнае маштабаванне, каб пазбегнуць межаў.

Дапушчальныя значэнні:

'0'

адключаны

'1'

вызначаецца аптымальнае значэнне статычнага маштабавання (толькі вельмі моцныя рухі прывядуць да бачных межаў) (па змаўчанні)

'2'

вызначаецца аптымальнае значэнне адаптыўнага павелічэння (межы не будуць бачныя), глzoomspeed

Звярніце ўвагу, што значэнне, дадзенае пры маштабаванні, дадаецца да разлічанага тут.

zoomspeed

Усталюйце працэнт для максімальнага маштабавання кожнага кадра (уключана, калі optzoomусталяваны ў 2). Дыяпазон ад 0 да 5, значэнне па змаўчанні 0,25.

interpol

Укажыце тып інтэрпаляцыі.

Даступныя значэнні:

'no'

няма інтэрпаляцыі

'linear'

лінейныя толькі гарызантальныя

'bilinear'

лінейна ў абодвух напрамках (па змаўчанні)

'bicubic'

кубічны ў абодвух напрамках (павольна)

tripod

Уключыць рэжым віртуальнага штатыва, калі ўстаноўлена значэнне 1, што эквівалентна relative=0:smoothing=0 . Значэнне па змаўчанні 0.

Выкарыстоўвайце таксама tripodопцыю vidstabdetect .

debug

Павялічыць шматслоўнасць журнала, калі ўстаноўлена ў 1. Таксама выяўленыя глабальныя рухі запісваюцца ў часовы файлglobal_motions.trf. Значэнне па змаўчанні 0.

11.266.2 Examples

  • Выкарыстоўвайце ffmpegдля звычайнай стабілізацыі са значэннямі па змаўчанні:
    ffmpeg -i inp.mpeg -vf vidstabtransform,unsharp=5:5:0.8:3:3:0.4 inp_stabilized.mpeg
    

    Звярніце ўвагу на выкарыстанне недыстра , які заўсёды рэкамендуецца.

  • Павялічце яшчэ трохі і загрузіце дадзеныя пераўтварэння з дадзенага файла:
    vidstabtransform=zoom=5:input="mytransforms.trf"
    
  • Згладзьце відэа яшчэ больш:
    vidstabtransform=smoothing=30
    

11.267 vflip

Перавярнуць уваходнае відэа вертыкальна.

Напрыклад, каб вертыкальна перавярнуць відэа з дапамогай ffmpeg:

ffmpeg -i in.avi -vf "vflip" out.avi

11.268 vfrdet

Выяўленне відэа з зменнай частатой кадраў.

Гэты фільтр спрабуе вызначыць, зменная ці пастаянная частата кадраў.

У канцы ён выдасць колькасць кадраў, выяўленых як тыя, што маюць зменныя дэльта-пункты, і кадры з пастаяннымі дэльта-пунктамі. Калі былі кадры са зменнай дэльтай, то ён таксама пакажа мінімальную, максімальную і сярэднюю дэльту.

11.269 vibrance

Павялічце або зменіце насычанасць.

Фільтр прымае наступныя параметры:

intensity

Усталюйце сілу ўзмацнення, калі значэнне дадатнае, або сілу змены, калі значэнне адмоўнае. Па змаўчанні 0. Дазволены дыяпазон ад -2 да 2.

rbal

Усталюйце чырвоны баланс. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.

gbal

Усталюйце зялёны баланс. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.

bbal

Усталюйце баланс сіняга. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.

rlum

Усталюйце чырвоны каэфіцыент яркасці.

glum

Усталюйце каэфіцыент яркасці зялёнага колеру.

blum

Усталюйце сіні каэфіцыент яркасці.

alternate

Калі intensityзначэнне адмоўнае і ўстаноўлена ў 1, колеры будуць змяняцца, інакш колеры будуць менш насычанымі, больш набліжанымі да шэрага.

11.269.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .

11.270 vif

Атрымайце сярэдні VIF (дакладнасць візуальнай інфармацыі) паміж двума ўваходнымі відэа.

Гэты фільтр прымае два ўваходныя відэа.

Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.

Атрыманая сярэдняя адзнака VIF раздрукоўваецца праз сістэму рэгістрацыі.

Фільтр захоўвае разлічаны бал VIF кожнага кадра.

У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpgапрацоўваецца параўноўваецца з эталонным файламref.mpg.

ffmpeg -i main.mpg -i ref.mpg -lavfi vif -f null -

11.271 vignette

Зрабіце або адмяніце натуральны эфект віньеткавання.

Фільтр прымае наступныя параметры:

angle, a

Задаць выраз кута лінзы ў колькасці радыян.

Значэнне абразаецца ў [0,PI/2]дыяпазоне.

Значэнне па змаўчанні:"PI/5"

x0
y0

Задайце выразы каардынат цэнтра. Адпаведна "w/2"і "h/2" па змаўчанні.

mode

Усталюйце рэжым наперад/назад.

Даступныя рэжымы:

'forward'

Чым больш адлегласць ад цэнтральнай кропкі, тым цямней становіцца малюнак.

'backward'

Чым больш адлегласць ад цэнтральнай кропкі, тым ярчэй становіцца малюнак. Гэта можа быць выкарыстана для зваротнага эфекту віньеткі, хоць аўтаматычнага выяўлення для вымання лінзы нямаangleі іншыя налады (пакуль). Таксама яго можна выкарыстоўваць для стварэння эфекту пякучага.

Значэнне па змаўчанні 'forward'.

eval

Задаць рэжым ацэнкі для выразаў (angle,x0,y0).

Ён прымае наступныя значэнні:

'init'

Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра.

'frame'

Ацаніце выразы для кожнага ўваходнага кадра. Гэта значна павольней, чым "init' рэжым, паколькі ён патрабуе паўторнага вылічэння ўсіх скалераў, але ён дазваляе пашыраныя дынамічныя выразы.

Значэнне па змаўчанні 'init'.

dither

Усталюйце згладжванне, каб паменшыць эфект кругавых палос. Па змаўчанні 1 (уключана).

aspect

Задаць прапорцыі віньеткі. Гэты параметр дазваляе наладзіць форму віньеткі. Пры ўсталёўцы гэтага значэння SAR ўваходных дадзеных будзе зроблена прамавугольнае віньеткаванне, якое адпавядае памерам відэа.

Па змаўчанні 1/1.

11.271.1 Expressions

Thealpha,x0іy0выразы могуць утрымліваць наступныя параметры.

w
h

увядзіце шырыню і вышыню

n

нумар уваходнага кадра, пачынаючы з 0

pts

час PTS (Presentation TimeStamp) адфільтраванага відэакадра, выражаны ў TBадзінках, NAN, калі не вызначаны

r

частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая

t

PTS (TimeStamp прэзентацыі) адфільтраванага відэакадра, выражаны ў секундах, NAN, калі не вызначаны

tb

часовая база ўваходнага відэа

11.271.2 Examples

  • Прымяніць просты эфект моцнага віньетка:
    vignette=PI/4
    
  • Зрабіце мігатлівую віньетку:
    vignette='PI/4+random(1)*PI/50':eval=frame
    

11.272 vmafmotion

Атрымайце сярэднюю ацэнку руху VMAF для відэа. Гэта адзін з кампанентаў паказчыкаў VMAF.

Атрыманая сярэдняя адзнака руху друкуецца праз сістэму рэгістрацыі.

Фільтр прымае наступныя параметры:

stats_file

Калі пазначана, фільтр будзе выкарыстоўваць названы файл для захавання ацэнкі руху кожнага кадра адносна папярэдняга кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.

прыклад:

ffmpeg -i ref.mpg -vf vmafmotion -f null -

11.273 vstack

Складайце ўваходныя відэа вертыкальна.

Усе патокі павінны мець аднолькавы піксельны фармат і аднолькавую шырыню.

Звярніце ўвагу, што гэты фільтр працуе хутчэй, чым выкарыстанне накладання і фільтра падкладкі для стварэння таго ж выхаду.

Фільтр прымае наступныя параметры:

inputs

Задаць колькасць уваходных патокаў. Па змаўчанні 2.

shortest

Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.

11.274 w3fdif

Дэінтэрлейсаванне ўваходнага відэа ("w3fdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу палёў Weston 3").

Заснаваны на працэсе, апісаным Марцінам Уэстанам для BBC R&D, і рэалізаваным на аснове алгарытму дэінтэрлейсу, напісанага Джымам Істэрбрукам для BBC R&D, палявы дэінтэрлейсінг-фільтр Weston 3 выкарыстоўвае каэфіцыенты фільтра, разлічаныя BBC R&D.

Гэты фільтр выкарыстоўвае інфармацыю аб дамінаванні палёў у кадры, каб вырашыць, якое з кожнай пары палёў размясціць першым у вывадзе. Калі гэта памыляецца, выкарыстоўвайце фільтр setfield перад w3fdifфільтрам.

Ёсць два наборы каэфіцыентаў фільтра, так званыя "просты" і "складаны". Які набор каэфіцыентаў фільтра выкарыстоўваецца, можна задаць шляхам перадачы дадатковага параметра:

filter

Усталюйце каэфіцыенты фільтра празрадковай разгорткі. Прымае адно з наступных значэнняў:

'simple'

Просты набор каэфіцыентаў фільтра.

'complex'

Больш складаны набор каэфіцыентаў фільтра.

Значэнне па змаўчанні 'complex'.

mode

Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:

frame

Вывесці па адным кадры для кожнага кадра.

field

Вывесці па адным кадры для кожнага поля.

Значэнне па змаўчанні - field.

parity

Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:

tff

Выкажам здагадку, што верхняе поле - першае.

bff

Выкажам здагадку, што ніжняе поле з'яўляецца першым.

auto

Уключыць аўтаматычнае вызначэнне парытэту поля.

Значэнне па змаўчанні - auto. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.

deint

Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:

'all'

Дэінтэрлейс усіх кадраў,

'interlaced'

Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.

Значэнне па змаўчанні 'all'.

11.274.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.275 waveform

Манітор відэасігналу.

Манітор формы хвалі адлюстроўвае інтэнсіўнасць кампанента колеру. Па змаўчанні толькі яркасць. Кожны слупок формы сігналу адпавядае слупку пікселяў у зыходным відэа.

Ён прымае наступныя варыянты:

mode, m

Можа быць або row, або column. Па змаўчанні column. У рэжыме радка графік з левага боку ўяўляе значэнне кампанента колеру 0, а правы бок уяўляе значэнне = 255. У рэжыме слупка верхні бок уяўляе значэнне кампанента колеру = 0, а ніжні бок уяўляе значэнне = 255.

intensity, i

Усталюйце інтэнсіўнасць. Меншыя значэнні карысныя, каб даведацца, колькі значэнняў аднолькавай яркасці размеркавана па ўваходных радках/слупках. Значэнне па змаўчанні - 0.04. Дазволены дыяпазон [0, 1].

mirror, r

Усталюйце рэжым адлюстравання. 0значыць нелюстраваны, 1значыць люстраны. У люстраным рэжыме больш высокія значэнні будуць прадстаўлены злева для rowрэжыму і ўверсе для columnрэжыму. Па змаўчанні 1(люстравана).

display, d

Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:

'overlay'

Прадстаўляе інфармацыю, ідэнтычную той, што ў parade, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.

Гэты рэжым адлюстравання палягчае выяўленне адносных адрозненняў або падабенстваў у перакрываючыхся абласцях каляровых кампанентаў, якія павінны быць аднолькавымі, напрыклад, нейтральных белых, шэрых або чорных.

'stack'

Паказаць асобны графік для кампанентаў колеру побач у rowрэжыме або адзін пад адным у columnрэжыме.

'parade'

Паказаць асобны графік для кампанентаў колеру побач у columnрэжыме або адзін пад адным у rowрэжыме.

Выкарыстанне гэтага рэжыму адлюстравання дазваляе лёгка заўважыць каляровыя адценні ў бліках і ценях выявы, параўноўваючы контуры верхняга і ніжняга графікаў кожнай хвалі. Паколькі белы, шэры і чорны колеры характарызуюцца дакладна роўнай колькасцю чырвонага, зялёнага і сіняга, нейтральныя вобласці выявы павінны адлюстроўваць тры хвалі прыкладна роўнай шырыні/вышыні. Калі няма, то карэкцыю лёгка выканаць, адрэгуляваўшы ўзровень трох сігналаў.

Па змаўчанні stack.

components, c

Усталюйце кампаненты колеру для адлюстравання. Значэнне па змаўчанні - 1, што азначае толькі кампанент яркасці або чырвонага колеру, калі ўвод у каляровай прасторы RGB. Калі, напрыклад, усталявана 7, будуць адлюстраваны ўсе 3 (калі) даступныя кампаненты колеру.

envelope, e
'none'

Без канверта, гэта па змаўчанні.

'instant'

Імгненны канверт, мінімальныя і максімальныя значэнні, прадстаўленыя на графіцы, будуць лёгка бачныя нават пры невялікім stepзначэнні.

'peak'

Захоўвайце мінімальныя і максімальныя значэнні, прадстаўленыя на графіцы ў залежнасці ад часу. Такім чынам вы па-ранейшаму можаце заўважыць значэнні за межамі дыяпазону, не гледзячы ўвесь час на формы сігналу.

'peak+instant'

Пік і імгненны канверт разам.

filter, f
'lowpass'

Без фільтрацыі, гэта па змаўчанні.

'flat'

Яркасць і каляровасць спалучаюцца разам.

'aflat'

Падобна вышэйшаму, але паказвае розніцу паміж сіняй і чырвонай каляровасцю.

'xflat'

Падобна вышэйзгаданаму, але выкарыстоўвайце іншыя колеры.

'yflat'

Падобна вышэйшаму, але зноў жа іншых колераў.

'chroma'

Адлюстроўвае толькі каляровасць.

'color'

Адлюстроўвае фактычнае значэнне колеру на сігнале.

'acolor'

Падобна вышэй, але з яркасцю, якая паказвае частату значэнняў каляровасці.

graticule, g

Усталюйце, якую сетку адлюстроўваць.

'none'

Не паказваць сетку.

'green'

Паказаць зялёную сетку, якая паказвае дазволеныя дыяпазоны вяшчання.

'orange'

Паказаць аранжавую сетку, якая паказвае дазволеныя дыяпазоны вяшчання.

'invert'

Адлюстраванне інвертаванай сеткі, якая паказвае дазволеныя дыяпазоны вяшчання.

opacity, o

Задаць непразрыстасць сеткі.

flags, fl

Усталюйце сцягі сетак.

'numbers'

Намалюйце лічбы над лініямі. Па змаўчанні ўключана.

'dots'

Малюйце кропкі замест ліній.

scale, s

Усталюйце маштаб для адлюстравання сеткі.

'digital'
'millivolts'
'ire'

Па змаўчанні лічбавы.

bgopacity, b

Задаць непразрыстасць фону.

tint0, t0
tint1, t1

Задаць адценне для вываду. Выкарыстоўваецца толькі з фільтрам нізкіх частот і калі дысплей не накладзены, а фарматы ўваходных пікселяў не RGB.

fitmode, fm

Устанавіць узор суадносін бакоў выходных кадраў відэа. Можна выкарыстоўваць для канфігурацыі формы сігналу, каб ён не расцягваўся занадта моцна ў адным з напрамкаў.

'none'

Усталюйце для ўзору суадносіны бакоў 1/1.

'size'

Усталюйце ўзор суадносін бакоў у адпаведнасці з уваходным памерам відэа

Па змаўчанні 'none'.

11.276 weave, doubleweave

Ён weaveпрымае відэаўваход на аснове поля і аб'ядноўвае кожныя два паслядоўныя палі ў адзін кадр, ствараючы новы кліп з падвойнай вышынёй з удвая меншай частатой і ўдвая меншай колькасцю кадраў.

doubleweaveПрацуе гэтак жа, як і weaveбез памяншэння ўдвая частаты і колькасці кадраў.

Ён прымае наступны варыянт:

first_field

Усталяваць першае поле. Даступныя значэнні:

'top, t'

Усталюйце кадр як верхняе поле спачатку.

'bottom, b'

Усталюйце кадр як ніжняе поле спачатку.

11.276.1 Examples

11.277 xbr

Прымяніце высакаякасны фільтр павелічэння xBR, прызначаны для піксельнага мастацтва. Ён прытрымліваецца набору правілаў выяўлення краёў, гл . https://forums.libretro.com/t/xbr-algorithm-tutorial/123 .

Ён прымае наступны варыянт:

n

Усталюйце памер маштабавання: 2для 2xBR, 3для 3xBRі 4для 4xBR. Па змаўчанні 3.

11.278 xcorrelate

Прымяніць нармалізаваную карэляцыю паміж першым і другім уваходным відэапатокам.

Памеры відэапатоку другога ўваходу павінны быць меншымі за памеры відэапатоку першага ўваходу.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці апрацоўваць.

secondary

Усталяваць, якія другасныя відэакадры будуць апрацоўвацца з другога ўваходнага відэапатоку, можна firstабо all. Па змаўчанні all.

Фільтр xcorrelateтаксама падтрымлівае параметры framesync .

11.279 xfade

Прымяненне крыжаванага знікнення ад аднаго ўваходнага відэапатоку да іншага ўваходнага відэапатоку. Перакрыжаванае знікненне прымяняецца на вызначаны час.

Абодва ўваходныя дадзеныя павінны быць пастаяннай частатой кадраў і аднолькавым дазволам, фарматам пікселяў, частатой кадраў і развагай па часе.

Фільтр прымае наступныя параметры:

transition

Усталюйце адзін з даступных эфектаў пераходу:

'custom'
'fade'
'wipeleft'
'wiperight'
'wipeup'
'wipedown'
'slideleft'
'slideright'
'slideup'
'slidedown'
'circlecrop'
'rectcrop'
'distance'
'fadeblack'
'fadewhite'
'radial'
'smoothleft'
'smoothright'
'smoothup'
'smoothdown'
'circleopen'
'circleclose'
'vertopen'
'vertclose'
'horzopen'
'horzclose'
'dissolve'
'pixelize'
'diagtl'
'diagtr'
'diagbl'
'diagbr'
'hlslice'
'hrslice'
'vuslice'
'vdslice'
'hblur'
'fadegrays'
'wipetl'
'wipetr'
'wipebl'
'wipebr'
'squeezeh'
'squeezev'
'zoomin'
'fadefast'
'fadeslow'

Эфект пераходу па змаўчанні - знікненне.

duration

Усталюйце працягласць перакрыжаванага знікнення ў секундах. Дыяпазон ад 0 да 60 секунд. Працягласць па змаўчанні - 1 секунда.

offset

Усталюйце пачатак перакрыжаванага знікнення адносна першага ўваходнага патоку ў секундах. Зрушэнне па змаўчанні роўна 0.

expr

Задаць выраз для карыстацкага эфекту пераходу.

Выразы могуць выкарыстоўваць наступныя зменныя і функцыі:

X
Y

Каардынаты бягучай выбаркі.

W
H

Шырыня і вышыня выявы.

P

Прагрэс эфекту пераходу.

PLANE

У цяперашні час апрацоўваецца самалёт.

A

Вяртанае значэнне першага ўводу ў бягучым месцы і плоскасці.

B

Вяртанае значэнне другога ўводу ў бягучым месцы і плоскасці.

a0(x, y)
a1(x, y)
a2(x, y)
a3(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) першага/другога/трэцяга/чацвёртага кампанента першага ўводу.

b0(x, y)
b1(x, y)
b2(x, y)
b3(x, y)

Вяртае значэнне пікселя ў месцы ( x, y) першага/другога/трэцяга/чацвёртага кампанента другога ўводу.

11.279.1 Examples

  • Перакрыжаванае знікненне ад аднаго ўваходнага відэа да іншага ўваходнага відэа з знікненнем і працягласцю пераходу 2 секунды, пачынаючы са зрушэння 5 секунд:
    ffmpeg -i first.mp4 -i second.mp4 -filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4
    

11.280 xmedian

Выберыце сярэднія пікселі з некалькіх уваходных відэа.

Фільтр прымае наступныя параметры:

inputs

Усталюйце колькасць уваходаў. Па змаўчанні 3. Дазволены дыяпазон ад 3 да 255. Калі колькасць уводаў цотная, вынікам будзе сярэдняе значэнне паміж двума сярэднімі значэннямі.

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 15, паводле якога апрацоўваюцца ўсе плоскасці.

percentile

Задаць сярэдні працэнт. Значэнне па змаўчанні - 0.5. Значэнне па змаўчанні 0.5заўсёды будзе выбіраць сярэднія значэнні, а 0мінімальныя значэнні і 1максімальныя.

11.280.1 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд , за выключэннем опцыі inputs.

11.281 xstack

Складайце відэаўваходы ў карыстальніцкі макет.

Усе патокі павінны мець аднолькавы піксельны фармат.

Фільтр прымае наступныя параметры:

inputs

Задаць колькасць уваходных патокаў. Па змаўчанні 2.

layout

Укажыце схему ўваходаў. Гэты параметр патрабуе, каб жаданая канфігурацыя макета была відавочна ўстаноўлена карыстальнікам. Гэта задае пазіцыю кожнага відэаўваходу на выхадзе. Кожны ўвод аддзяляецца знакам '|'. Першая лічба ўяўляе слупок, а другая лічба ўяўляе радок. Лічбы пачынаюцца з 0 і падзяляюцца знакам "_". Пры жаданні можна выкарыстоўваць wX і hX, дзе X - відэаўваход, з якога бярэцца шырыня або вышыня. Можна выкарыстоўваць некалькі значэнняў, падзеленыя знакам "+". У такім выпадку значэнні сумуюцца.

Звярніце ўвагу, што калі ўваходы маюць розныя памеры, могуць з'явіцца прабелы, бо не ўвесь кадр выхаднога відэа будзе запоўнены. Падобным чынам відэа могуць накладвацца адно на адно, калі іх становішча не пакідае дастаткова месца для поўнага кадра сумежных відэа.

Для 2 уваходаў усталяваны макет па змаўчанні 0_0|w0_0(эквівалентны grid=2x1). Ва ўсіх астатніх выпадках макет або сетку павінен усталёўваць карыстальнік. Адначасова можа быць указана альбо gridабо . layoutВызначэнне абодвух прывядзе да памылкі.

grid

Укажыце сетку ўваходных дадзеных з фіксаваным памерам. Гэты параметр выкарыстоўваецца для стварэння сеткі фіксаванага памеру ўваходных патокаў. Усталюйце памер сеткі ў форме COLUMNSxROWS. Павінны быць ROWS * COLUMNS ўваходныя патокі, і яны будуць размешчаны ў выглядзе сеткі з ROWSрадкамі і COLUMNSслупкамі. Пры выкарыстанні гэтай опцыі кожны паток уводу ў радку павінен мець аднолькавую вышыню, а ўсе радкі павінны мець аднолькавую шырыню.

Калі gridўстаноўлена, то inputsпараметр ігнаруецца і няяўна задаецца як ROWS * COLUMNS.

Для 2 уваходаў усталявана сетка па змаўчанні 2x1(эквівалентная layout=0_0|w0_0). Ва ўсіх астатніх выпадках макет або сетку павінен усталёўваць карыстальнік. Адначасова можа быць указана альбо gridабо . layoutВызначэнне абодвух прывядзе да памылкі.

shortest

Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.

fill

Калі ўсталяваны правільны колер, усе нявыкарыстаныя пікселі будуць запоўнены гэтым колерам. Па змаўчанні запаўненне не ўстаноўлена, таму яно адключана.

11.281.1 Examples

  • Адлюстраванне 4 уваходаў у сетку 2x2.

    Макет:

    input1(0, 0)  | input3(w0, 0)
    input2(0, h0) | input4(w0, h0)
    
    xstack=inputs=4:layout=0_0|0_h0|w0_0|w0_h0
    

    Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.

  • Адлюстраванне 4 уваходаў у сетку 1x4.

    Макет:

    input1(0, 0)
    input2(0, h0)
    input3(0, h0+h1)
    input4(0, h0+h1+h2)
    
    xstack=inputs=4:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2
    

    Звярніце ўвагу, што калі ўваходы маюць розную шырыню, з'явіцца нявыкарыстаная прастора.

  • Адлюстраванне 9 уваходаў у сетку 3x3.

    Макет:

    input1(0, 0)       | input4(w0, 0)      | input7(w0+w3, 0)
    input2(0, h0)      | input5(w0, h0)     | input8(w0+w3, h0)
    input3(0, h0+h1)   | input6(w0, h0+h1)  | input9(w0+w3, h0+h1)
    
    xstack=inputs=9:layout=0_0|0_h0|0_h0+h1|w0_0|w0_h0|w0_h0+h1|w0+w3_0|w0+w3_h0|w0+w3_h0+h1
    

    Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.

  • Адлюстраванне 16 уваходаў у сетку 4x4.

    Макет:

    input1(0, 0)       | input5(w0, 0)       | input9 (w0+w4, 0)       | input13(w0+w4+w8, 0)
    input2(0, h0)      | input6(w0, h0)      | input10(w0+w4, h0)      | input14(w0+w4+w8, h0)
    input3(0, h0+h1)   | input7(w0, h0+h1)   | input11(w0+w4, h0+h1)   | input15(w0+w4+w8, h0+h1)
    input4(0, h0+h1+h2)| input8(w0, h0+h1+h2)| input12(w0+w4, h0+h1+h2)| input16(w0+w4+w8, h0+h1+h2)
    
    xstack=inputs=16:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2|w0_0|w0_h0|w0_h0+h1|w0_h0+h1+h2|w0+w4_0|
    w0+w4_h0|w0+w4_h0+h1|w0+w4_h0+h1+h2|w0+w4+w8_0|w0+w4+w8_h0|w0+w4+w8_h0+h1|w0+w4+w8_h0+h1+h2
    

    Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.

11.282 yadif

Дэінтэрлейсінг ўваходнага відэа ("yadif" азначае "яшчэ адзін фільтр дэінтэрлейсінгу").

Ён прымае наступныя параметры:

mode

Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:

0, send_frame

Вывесці па адным кадры для кожнага кадра.

1, send_field

Вывесці па адным кадры для кожнага поля.

2, send_frame_nospatial

Падабаецца send_frame, але прапускае праверку прасторавага перапляцення.

3, send_field_nospatial

Падабаецца send_field, але прапускае праверку прасторавага перапляцення.

Значэнне па змаўчанні - send_frame.

parity

Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:

0, tff

Выкажам здагадку, што верхняе поле - першае.

1, bff

Выкажам здагадку, што ніжняе поле з'яўляецца першым.

-1, auto

Уключыць аўтаматычнае вызначэнне парытэту поля.

Значэнне па змаўчанні - auto. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.

deint

Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:

0, all

Дэінтэрлейс усіх кадраў.

1, interlaced

Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.

Значэнне па змаўчанні - all.

11.283 yadif_cuda

Дэінтэрлейс ўваходнага відэа з выкарыстаннем алгарытму yadif , але рэалізаванага ў CUDA, каб ён мог працаваць як частка канвеера паскарэння GPU з nvdec і/або nvenc.

Ён прымае наступныя параметры:

mode

Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:

0, send_frame

Вывесці па адным кадры для кожнага кадра.

1, send_field

Вывесці па адным кадры для кожнага поля.

2, send_frame_nospatial

Падабаецца send_frame, але прапускае праверку прасторавага перапляцення.

3, send_field_nospatial

Падабаецца send_field, але прапускае праверку прасторавага перапляцення.

Значэнне па змаўчанні - send_frame.

parity

Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:

0, tff

Выкажам здагадку, што верхняе поле - першае.

1, bff

Выкажам здагадку, што ніжняе поле з'яўляецца першым.

-1, auto

Уключыць аўтаматычнае вызначэнне парытэту поля.

Значэнне па змаўчанні - auto. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.

deint

Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:

0, all

Дэінтэрлейс усіх кадраў.

1, interlaced

Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.

Значэнне па змаўчанні - all.

11.284 yaepblur

Прымяніць фільтр размыцця з захаваннем краёў («yaepblur» азначае «яшчэ адзін фільтр размыцця, які захоўвае краю»). Алгарытм апісаны ў "JS Lee, Digital Image Enhanced and Noise Filtering by use of local Statistics, IEEE Trans. Pattern Anal. Mach. Intell. PAMI-2, 1980."

Ён прымае наступныя параметры:

radius, r

Усталюйце радыус акна. Значэнне па змаўчанні - 3.

planes, p

Усталюйце, якія плоскасці фільтраваць. Па змаўчанні - толькі першая плоскасць.

sigma, s

Задаць сілу размыцця. Значэнне па змаўчанні - 128.

11.284.1 Commands

Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.

11.285 zoompan

Прымяніць эфект маштабавання і панарамавання.

Гэты фільтр прымае наступныя параметры:

zoom, z

Усталюйце выраз маштабавання. Дыяпазон 1-10. Па змаўчанні 1.

x
y

Задайце выразы x і y. Па змаўчанні 0.

d

Усталюйце выраз працягласці ў колькасці кадраў. Гэта вызначае, колькі кадраў будзе працягвацца эфект для адной уваходнай выявы. Па змаўчанні 90.

s

Усталюйце памер выходнай выявы, па змаўчанні "hd720".

fps

Усталюйце выходную частату кадраў, па змаўчанні "25".

Кожны выраз можа ўтрымліваць наступныя канстанты:

in_w, iw

Шырыня ўваходу.

in_h, ih

Вышыня ўваходу.

out_w, ow

Шырыня выхаду.

out_h, oh

Выхад вышыня.

in

Колькасць уваходных кадраў.

on

Колькасць выхадных кадраў.

in_time, it

Метка часу ўводу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.

out_time, time, ot

Метка часу вываду, выражаная ў секундах.

x
y

Апошняе разлічанае становішча "x" і "y" з выразаў "x" і "y" для бягучага ўваходнага кадра.

px
py

'x' і 'y' апошняга выходнага кадра папярэдняга ўваходнага кадра або 0, калі такога кадра яшчэ не было (першы ўваходны кадр).

zoom

Апошні разлічаны маштаб з выразу 'z' для бягучага ўваходнага кадра.

pzoom

Апошні разлічаны маштаб апошняга выходнага кадра папярэдняга ўваходнага кадра.

duration

Колькасць выходных кадраў для бягучага ўваходнага кадра. Вылічваецца з выразу "d" для кожнага ўваходнага кадра.

pduration

колькасць выходных кадраў, створаных для папярэдняга ўваходнага кадра

a

Рацыянальны лік: шырыня ўводу / вышыня ўводу

sar

узор суадносін бакоў

dar

суадносіны бакоў дысплея

11.285.1 Examples

  • Павелічэнне маштабу да 1,5x і панарамаванне ў той жа час да нейкай кропкі паблізу цэнтра выявы:
    zoompan=z='min(zoom+0.0015,1.5)':d=700:x='if(gte(zoom,1.5),x,x+1/a)':y='if(gte(zoom,1.5),y,y+1)':s=640x360
    
  • Павелічэнне да 1,5x і панарамаванне заўсёды ў цэнтры выявы:
    zoompan=z='min(zoom+0.0015,1.5)':d=700:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
    
  • Тое самае, што і вышэй, але без паўзы:
    zoompan=z='min(max(zoom,pzoom)+0.0015,1.5)':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
    
  • Павялічце ў 2 разы цэнтр выявы толькі для першай секунды ўваходнага відэа:
    zoompan=z='if(between(in_time,0,1),2,1)':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
    

11.286 zscale

Зменіце памер (зменіце памер) уваходнага відэа з дапамогай бібліятэкі z.lib: https://github.com/sekrit-twc/zimg . Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-libzimg.

Фільтр zscale прымушае суадносіны бакоў выхаднога дысплея быць такімі ж, як і ўваходныя, шляхам змены суадносін бакоў выхаднога ўзору.

Калі фармат уваходнага відарыса адрозніваецца ад фармату, запытанага наступным фільтрам, фільтр zscale пераўтворыць уваход у запытаны фармат.

11.286.1 Options

Фільтр прымае наступныя параметры.

width, w
height, h

Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.

Калі значэнне widthor wроўна 0, шырыня ўводу выкарыстоўваецца для вываду. Калі значэнне heightor hроўна 0, вышыня ўводу выкарыстоўваецца для вываду.

Калі адно і толькі адно са значэнняў роўна -n з n >= 1, фільтр zscale будзе выкарыстоўваць значэнне, якое падтрымлівае суадносіны бакоў уваходнага відарыса, разлічаныя з іншага зададзенага памеру. Аднак пасля гэтага ён пераканаецца, што вылічаны памер дзеліцца на n, і пры неабходнасці скарэктуе значэнне.

Калі абодва значэнні маюць -n з n >= 1, паводзіны будуць аднолькавымі да таго, што для абодвух значэнняў будзе прысвоена 0, як было апісана раней.

Глядзіце ніжэй спіс прынятых канстант для выкарыстання ў выразе памернасці.

size, s

Усталюйце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

dither, d

Усталюйце тып дрыгацення.

Магчымыя значэнні:

none
ordered
random
error_diffusion

Па змаўчанні няма.

filter, f

Усталюйце тып фільтра змены памеру.

Магчымыя значэнні:

point
bilinear
bicubic
spline16
spline36
lanczos

Па змаўчанні білінейны.

range, r

Усталюйце каляровую гаму.

Магчымыя значэнні:

input
limited
full

Па змаўчанні тое самае, што і ўвод.

primaries, p

Усталюйце асноўны колер.

Магчымыя значэнні:

input
709
unspecified
170m
240m
2020

Па змаўчанні тое самае, што і ўвод.

transfer, t

Задайце характарыстыкі перадачы.

Магчымыя значэнні:

input
709
unspecified
601
linear
2020_10
2020_12
smpte2084
iec61966-2-1
arib-std-b67

Па змаўчанні тое самае, што і ўвод.

matrix, m

Усталюйце матрыцу каляровай прасторы.

Магчымыя значэнні:

input
709
unspecified
470bg
170m
2020_ncl
2020_cl

Па змаўчанні тое самае, што і ўвод.

rangein, rin

Усталюйце ўваходны колеравы дыяпазон.

Магчымыя значэнні:

input
limited
full

Па змаўчанні тое самае, што і ўвод.

primariesin, pin

Усталюйце асноўныя колеры ўводу.

Магчымыя значэнні:

input
709
unspecified
170m
240m
2020

Па змаўчанні тое самае, што і ўвод.

transferin, tin

Усталюйце характарыстыкі перадачы ўваходу.

Магчымыя значэнні:

input
709
unspecified
601
linear
2020_10
2020_12

Па змаўчанні тое самае, што і ўвод.

matrixin, min

Усталюйце ўваходную матрыцу каляровай прасторы.

Магчымыя значэнні:

input
709
unspecified
470bg
170m
2020_ncl
2020_cl
chromal, c

Усталюйце месцазнаходжанне каляровасці выхаду.

Магчымыя значэнні:

input
left
center
topleft
top
bottomleft
bottom
chromalin, cin

Усталюйце размяшчэнне каляровасці ўводу.

Магчымыя значэнні:

input
left
center
topleft
top
bottomleft
bottom
npl

Усталюйце намінальную пікавую яркасць.

param_a

Параметр A для фільтраў маштабавання. Параметр «b» для bicubic і колькасць кранаў фільтра для lanczos.

param_b

Параметр B для маштабавання фільтраў. Параметр "с" для бікубічнага.

Каштоўнасці стwіhпараметры - гэта выразы, якія змяшчаюць наступныя канстанты:

in_w
in_h

Шырыня і вышыня ўводу

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Шырыня і вышыня вываду (у маштабе).

ow
oh

Гэта тое самае, што out_wіout_h

a

Тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

Суадносіны бакоў уваходнага дысплея. Разлічваецца з (iw / ih) * sar.

hsub
vsub

гарызантальныя і вертыкальныя ўваходныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

ohsub
ovsub

гарызантальныя і вертыкальныя вывадныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

11.286.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

width, w
height, h

Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.

Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.

12 OpenCL Video Filters

Ніжэй прыводзіцца апісанне даступных на дадзены момант відэафільтраў OpenCL.

Каб уключыць кампіляцыю гэтых фільтраў, трэба наладзіць FFmpeg з дапамогай --enable-opencl.

Запуск фільтраў OpenCL патрабуе ініцыялізацыі апаратнай прылады і перадачы гэтай прылады ўсім фільтрам у любым графе фільтраў.

-init_hw_device opencl[=name][:device[,key=value...]]

openclІніцыялізуйце новую апаратную прыладу тыпу name, выкарыстоўваючы зададзеныя параметры прылады.

-filter_hw_device name

Перадайце выкліканую апаратную прыладу nameўсім фільтрам у любым графе фільтраў.

Для атрымання больш падрабязнай інфармацыі гл. https://www.ffmpeg.org/ffmpeg.html#Advanced-Video-options

  • Прыклад выбару першай прылады на другой платформе і запуску на ёй фільтра avgblur_opencl з параметрамі па змаўчанні.
    -init_hw_device opencl=gpu:1.0 -filter_hw_device gpu -i INPUT -vf "hwupload, avgblur_opencl, hwdownload" OUTPUT
    

Паколькі фільтры OpenCL не могуць атрымаць доступ да дадзеных кадраў у звычайнай памяці, перад выкарыстаннем усе дадзеныя кадраў неабходна загрузіць ( hwupload ) на апаратныя паверхні, падлучаныя да адпаведнай прылады, а затым загрузіць ( hwdownload ) назад у звычайную памяць. Звярніце ўвагу, што hwupload будзе загружаць на паверхню з той жа кампаноўкай, што і фрэйм ​​праграмнага забеспячэння, таму, магчыма, спатрэбіцца дадаць фільтр фармату непасрэдна перад тым, каб перавесці ўвод у правільны фармат, і hwdownload не падтрымлівае ўсе фарматы на выхадзе - гэта можа неабходна ўставіць дадатковы фільтр фармату адразу пасля графіка, каб атрымаць вывад у фармаце, які падтрымліваецца.

12.1 avgblur_opencl

Прымяніць фільтр сярэдняй размытасці.

Фільтр прымае наступныя параметры:

sizeX

Усталюйце памер гарызантальнага радыусу. Дыяпазон [1, 1024]і значэнне па змаўчанні 1.

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 0xf, паводле якога апрацоўваюцца ўсе плоскасці.

sizeY

Усталюйце памер вертыкальнага радыусу. Дыяпазон [1, 1024]і значэнне па змаўчанні 0. Калі нуль, sizeXбудзе выкарыстоўвацца значэнне.

12.1.1 Example

  • Прымяніце фільтр сярэдняга размыцця з гарызантальным і вертыкальным памерам 3, усталяваўшы для кожнага пікселя вываду сярэдняе значэнне вобласці 7x7 з цэнтрам на ўваходзе. Для пікселяў па краях выявы вобласць не выходзіць за межы выявы, таму каардынаты па-за дыяпазонам не выкарыстоўваюцца ў разліках.
    -i INPUT -vf "hwupload, avgblur_opencl=3, hwdownload" OUTPUT
    

12.2 boxblur_opencl

Прымяніць алгарытм размыцця скрынкі да ўваходнага відэа.

Ён прымае наступныя параметры:

luma_radius, lr
luma_power, lp
chroma_radius, cr
chroma_power, cp
alpha_radius, ar
alpha_power, ap

Далей апісваюцца прынятыя варыянты.

luma_radius, lr
chroma_radius, cr
alpha_radius, ar

Усталюйце выраз для радыуса поля ў пікселях, які выкарыстоўваецца для размыцця адпаведнай плоскасці ўводу.

Значэнне радыуса павінна быць неадмоўным лікам і не павінна перавышаць значэнне выразу min(w,h)/2для плоскасцей яркасці і альфа, а таксама min(cw,ch)/2для плоскасцей каляровасці.

Значэнне па змаўчанні дляluma_radiusроўна "2". Калі не ўказана, chroma_radiusіalpha_radiusпа змаўчанні адпаведнае значэнне, усталяванае дляluma_radius.

Выразы могуць утрымліваць наступныя канстанты:

w
h

Шырыня і вышыня ўводу ў пікселях.

cw
ch

Шырыня і вышыня уваходнага каляровага малюнка ў пікселях.

hsub
vsub

Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p" hsubроўна 2 і vsubроўна 1.

luma_power, lp
chroma_power, cp
alpha_power, ap

Укажыце, колькі разоў фільтр boxblur прымяняецца да адпаведнай плоскасці.

Значэнне па змаўчанні дляluma_powerроўна 2. Калі не пазначана, chroma_powerіalpha_powerпа змаўчанні адпаведнае значэнне, усталяванае дляluma_power.

Значэнне 0 адключыць эфект.

12.2.1 Examples

Прымяніце фільтр BoxBlur, усталяваўшы для кожнага пікселя вываду сярэдняе значэнне радыусаў скрынкі luma_radius, chroma_radius, alpha_radiusдля кожнай плоскасці адпаведна. Фільтр будзе прымяняцца luma_power, chroma_power, alpha_powerраз на адпаведнай плоскасці. Для пікселяў па краях выявы радыус не выходзіць за межы выявы, таму каардынаты па-за дыяпазонам не выкарыстоўваюцца ў разліках.

  • Прымяніце фільтр BoxBlur з яркасцю, каляровасцю і альфа-радыусам, усталяваным на 2, і яркасцю, каляровасцю і альфа-магутнасцю, усталяванымі на 3. Фільтр будзе запушчаны 3 разы з усталяваным у квадрат-радыусе 2 для кожнай плоскасці выявы.
    -i INPUT -vf "hwupload, boxblur_opencl=luma_radius=2:luma_power=3, hwdownload" OUTPUT
    -i INPUT -vf "hwupload, boxblur_opencl=2:3, hwdownload" OUTPUT
    
  • Прымяніце фільтр boxblur з радыусам яркасці, усталяваным на 2, luma_power на 1, chroma_radius на 4, chroma_power на 5, alpha_radius на 3 і alpha_power на 7.

    Для плоскасці яркасці радыус скрынкі 2x2 будзе выкананы адзін раз.

    Для каляровай плоскасці радыус квадрата 4x4 будзе выкананы 5 разоў.

    Для альфа-плоскасці радыус скрынкі 3x3 будзе прабегся 7 разоў.

    -i INPUT -vf "hwupload, boxblur_opencl=2:1:4:5:3:7, hwdownload" OUTPUT
    

12.3 colorkey_opencl

Каляровая маніпуляцыя каляровай прасторы RGB.

Фільтр прымае наступныя параметры:

color

Колер, які будзе заменены на празрыстасць.

similarity

Працэнт падабенства з колерам ключа.

0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.

blend

Працэнт сумесі.

0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.

Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.

12.3.1 Examples

  • Зрабіце кожны паўзялёны піксель ва ўводзе празрыстым з лёгкім змешваннем:
    -i INPUT -vf "hwupload, colorkey_opencl=green:0.3:0.1, hwdownload" OUTPUT
    

12.4 convolution_opencl

Прымяніць згортванне матрыцы 3x3, 5x5, 7x7.

Фільтр прымае наступныя параметры:

0m
1m
2m
3m

Усталюйце матрыцу для кожнай плоскасці. Матрыца - гэта паслядоўнасць з 9, 25 або 49 лікаў са знакам. Значэнне па змаўчанні для кожнай плоскасці 0 0 0 0 1 0 0 0 0.

0rdiv
1rdiv
2rdiv
3rdiv

Усталюйце множнік для разліковага значэння для кожнай плоскасці. Калі не ўстаноўлена або 0, гэта будзе сума ўсіх элементаў матрыцы. Значэнне опцыі павінна быць лікам з плаваючай часткай, большым або роўным 0.0. Значэнне па змаўчанні - 1.0.

0bias
1bias
2bias
3bias

Усталюйце ўхіл для кожнай плоскасці. Гэта значэнне дадаецца да выніку множання. Карысна, каб зрабіць агульны малюнак ярчэй або цямней. Значэнне опцыі павінна быць лікам з плаваючай часткай, большым або роўным 0.0. Значэнне па змаўчанні - 0.0.

12.4.1 Examples

  • Ужыць рэзкасць:
    -i INPUT -vf "hwupload, convolution_opencl=0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0, hwdownload" OUTPUT
    
  • Прымяніць размыццё:
    -i INPUT -vf "hwupload, convolution_opencl=1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1/9:1/9:1/9:1/9, hwdownload" OUTPUT
    
  • Прымяніць паляпшэнне краёў:
    -i INPUT -vf "hwupload, convolution_opencl=0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:5:1:1:1:0:128:128:128, hwdownload" OUTPUT
    
  • Прымяніць вызначэнне краю:
    -i INPUT -vf "hwupload, convolution_opencl=0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:5:5:5:1:0:128:128:128, hwdownload" OUTPUT
    
  • Ужывайце дэтэктар краёў Лапласа, які ўключае дыяганалі:
    -i INPUT -vf "hwupload, convolution_opencl=1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:5:5:5:1:0:128:128:0, hwdownload" OUTPUT
    
  • Нанесці рэльеф:
    -i INPUT -vf "hwupload, convolution_opencl=-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2, hwdownload" OUTPUT
    

12.5 erosion_opencl

Прымяніць эфект эрозіі да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) мінімумам.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмяжуйце максімальную змену для кожнай плоскасці. Дыяпазон [0, 65535]і значэнне па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

coordinates

Сцяг, які вызначае піксель, на які трэба спасылацца. Дыяпазон [0, 255]і значэнне па змаўчанні 255, г.зн. выкарыстоўваюцца ўсе восем пікселяў.

Сцягі мясцовага рэгіёну каардынат 3x3 з цэнтрам x:

1 2 3

4 х 5

6 7 8

12.5.1 Example

  • Прымяніце эразійны фільтр з значэннем threshold0 30, threshold1 40, threshold2 50 і каардынатамі 231, усталяваўшы для кожнага пікселя выхаду лакальны мінімум паміж пікселямі: 1, 2, 3, 6, 7, 8 3x3 вобласці з цэнтрам на ім ва уваход. Калі розніца паміж уваходным пікселем і лакальным мінімумам перавышае парог адпаведнай плоскасці, выхадны піксель будзе ўсталяваны як уваходны піксель - парог адпаведнай плоскасці.
    -i INPUT -vf "hwupload, erosion_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
    

12.6 deshake_opencl

Фільтр стабілізацыі відэа на аснове асаблівасцей.

Фільтр прымае наступныя параметры:

tripod

Імітуе штатыў, прадухіляючы рух камеры ад зыходнага кадра. Па змаўчанні 0.

debug

Ці павінна адлюстроўвацца дадатковая адладкавая інфармацыя як у апрацаваным вывадзе, так і ў кансолі.

Звярніце ўвагу, што для таго, каб убачыць выснову адладкі кансолі, вам таксама трэба будзе перайсці -v verboseда ffmpeg.

Супадзенне кропак прагляду ў выходным відэа падтрымліваецца толькі для ўваходу RGB.

Па змаўчанні 0.

adaptive_crop

Ці трэба рабіць невялікую кадрацыю па межах, каб скараціць колькасць люстраных пікселяў.

Па змаўчанні 1.

refine_features

Ці трэба ўдакладняць кропкі функцый на субпіксельным узроўні.

Гэта можна адключыць для невялікага прыросту прадукцыйнасці за кошт дакладнасці.

Па змаўчанні 1.

smooth_strength

Моц згладжвання, прымененага да шляху камеры ад 0.0да 1.0.

1.0- гэта максімальная трываласць згладжвання, у той час як меншыя значэнні прыводзяць да меншага згладжвання.

0.0прымушае фільтр адаптыўна выбіраць сілу згладжвання для кожнага кадра.

Па змаўчанні 0.0.

smooth_window_multiplier

Кантралюе памер акна згладжвання (колькасць кадраў, буферызаваных для вызначэння інфармацыі аб руху).

Памер акна згладжвання вызначаецца шляхам множання частоты кадраў відэа на гэты лік.

Дапушчальныя значэнні ад 0.1да 10.0.

Большыя значэнні павялічваюць аб'ём даных аб руху, даступных для вызначэння таго, як згладзіць траекторыю камеры, патэнцыйна паляпшаючы плыўнасць, але таксама павялічваюць затрымку і выкарыстанне памяці.

Па змаўчанні 2.0.

12.6.1 Examples

  • Стабілізаваць відэа з фіксаванай сярэдняй сілай згладжвання:
    -i INPUT -vf "hwupload, deshake_opencl=smooth_strength=0.5, hwdownload" OUTPUT
    
  • Стабілізаваць відэа з дапамогай адладкі (як у кансолі, так і ў візуалізаваным відэа):
    -i INPUT -filter_complex "[0:v]format=rgba, hwupload, deshake_opencl=debug=1, hwdownload, format=rgba, format=yuv420p" -v verbose OUTPUT
    

12.7 dilation_opencl

Прымяніць эфект пашырэння да відэа.

Гэты фільтр замяняе піксель лакальным (3x3) максімумам.

Ён прымае наступныя варыянты:

threshold0
threshold1
threshold2
threshold3

Абмяжуйце максімальную змену для кожнай плоскасці. Дыяпазон [0, 65535]і значэнне па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.

coordinates

Сцяг, які вызначае піксель, на які трэба спасылацца. Дыяпазон [0, 255]і значэнне па змаўчанні 255, г.зн. выкарыстоўваюцца ўсе восем пікселяў.

Сцягі мясцовага рэгіёну каардынат 3x3 з цэнтрам x:

1 2 3

4 х 5

6 7 8

12.7.1 Example

  • Прымяніце фільтр пашырэння з значэннем threshold0 30, threshold1 40, threshold2 50 і каардынатамі 231, усталяваўшы кожны піксель вываду на лакальны максімум паміж пікселямі: 1, 2, 3, 6, 7, 8 3x3 вобласці з цэнтрам на ім ва уваход. Калі розніца паміж уваходным пікселем і лакальным максімумам перавышае парогавае значэнне адпаведнай плоскасці, выхадны піксель будзе ўсталяваны як уваходны піксель + парог адпаведнай плоскасці.
    -i INPUT -vf "hwupload, dilation_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
    

12.8 nlmeans_opencl

Нелакальныя сродкі фільтруюць шум праз OpenCL, гэты фільтр прымае тыя ж параметры, што і nlmeans .

12.9 overlay_opencl

Накласці адно відэа на другое.

Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход. Гэты фільтр патрабуе аднолькавага размяшчэння памяці для ўсіх уваходаў. Такім чынам, можа спатрэбіцца пераўтварэнне фармату.

Фільтр прымае наступныя параметры:

x

Усталюйце каардынату x накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - 0.

y

Усталюйце каардынату y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - 0.

12.9.1 Examples

  • Накласці выяву LOGO ў верхнім левым куце INPUT відэа. Абодва ўваходы маюць фармат yuv420p.
    -i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
    
  • Уваходы маюць аднолькавы макет памяці для каляровых каналаў, накладанне мае дадатковую альфа-плоскасць, напрыклад, INPUT - yuv420p, а LOGO - yuva420p.
    -i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
    

12.10 pad_opencl

Дадайце пракладкі да ўваходнага відарысу і размесціце зыходны ўвод у прадастаўленых xкаардынатах y.

Ён прымае наступныя варыянты:

width, w
height, h

Укажыце выраз для памеру выхаднога відарыса з дададзенымі пракладкамі. Калі значэнне widthабо heightроўна 0, для вываду выкарыстоўваецца адпаведны ўваходны памер.

Выраз widthможа спасылацца на значэнне, зададзенае heightвыразам, і наадварот.

Значэнне па змаўчанні widthі heightроўна 0.

x
y

Укажыце зрушэнні для размяшчэння ўваходнага відарыса ў падшытай вобласці адносна верхняй/левай мяжы выходнага відарыса.

Выраз xможа спасылацца на значэнне, зададзенае y выразам, і наадварот.

Значэнне па змаўчанні xі yроўна 0.

Калі ацэнка xor yдае адмоўны лік, яны будуць зменены так, што ўваходны відарыс будзе адцэнтраваны на падстаўленай вобласці.

color

Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

aspect

Перакласці на аспект замест дазволу.

Значэнні параметраў width, height, x, і y з'яўляюцца выразамі, якія змяшчаюць наступныя канстанты:

in_w
in_h

Шырыня і вышыня ўваходнага відэа.

iw
ih

Гэта тое самае, што in_wі in_h.

out_w
out_h

Шырыня і вышыня вываду (памер запаўненай вобласці), зададзеныя выразамі widthі .height

ow
oh

Гэта тое самае, што out_wі out_h.

x
y

Зрушэнні x і y, як вызначана выразамі xі y , або NAN, калі яшчэ не пазначаны.

a

тое самае, што iw/ih

sar

суадносіны бакоў узору ўводу

dar

суадносіны бакоў уваходнага дысплея, яно такое ж, як ( iw/ ih) *sar

12.11 prewitt_opencl

Прымяніце аператар Prewitt ( https://en.wikipedia.org/wiki/Prewitt_operator ) для ўводу відэаструменю.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 0xf, паводле якога апрацоўваюцца ўсе плоскасці.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон [0.0, 65535]і значэнне па змаўчанні 1.0.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон [-65535, 65535]і значэнне па змаўчанні 0.0.

12.11.1 Example

  • Прымяніце аператар Прэвітта, усталяваўшы маштаб 2 і дэльта 10.
    -i INPUT -vf "hwupload, prewitt_opencl=scale=2:delta=10, hwdownload" OUTPUT
    

12.12 program_opencl

Фільтруйце відэа з дапамогай праграмы OpenCL.

source

Зыходны файл праграмы OpenCL.

kernel

Імя ядра ў праграме.

inputs

Колькасць уваходаў у фільтр. Па змаўчанні 1.

size, s

Памер выходных кадраў. Па змаўчанні тое самае, што і першы ўвод.

Фільтр program_openclтаксама падтрымлівае параметры framesync .

Зыходны файл праграмы павінен утрымліваць функцыю ядра з дадзеным імем, якая будзе запускацца адзін раз для кожнай плоскасці вываду. Кожны запуск на плоскасці ставіцца ў чаргу як асобны 2D глабальны NDRange з адным працоўным элементам для кожнага пікселя, які будзе згенераваны. Такім чынам, глабальнае зрушэнне ідэнтыфікатара для кожнага працоўнага элемента - гэта каардынаты пікселя ў малюнку прызначэння.

Функцыя ядра павінна прымаць наступныя аргументы:

  • Выява пункта прызначэння,__write_only image2d_t ,.

    Гэта выява стане выхадам; ядро павінна запісаць усё гэта.

  • Індэкс кадра,unsigned int ,.

    Гэта лічыльнік, які пачынаецца з нуля і павялічваецца на адзінку для кожнага кадра.

  • Зыходныя выявы,__read_only image2d_t ,.

    Гэта самыя свежыя выявы для кожнага ўваходу. Ядро можа чытаць з іх для стварэння вываду, але ў іх нельга запісваць.

Прыклады праграм:

  • Скапіруйце ўвод у выхад (вывад павінен быць такога ж памеру, што і ўваход).
    __ядро пустой копіі (__write_only image2d_t прызначэння,
                       індэкс unsigned int,
                       __read_only image2d_t крыніца)
    {
        const sampler_t сэмплер = CLK_NORMALIZED_COORDS_FALSE;
    
        месцазнаходжанне int2 = (int2)(get_global_id(0), get_global_id(1));
    
        значэнне float4 = read_imagef(крыніца, сэмплер, месца);
    
        write_imagef(пункт прызначэння, размяшчэнне, значэнне);
    }
    
  • Прымяніце простае пераўтварэнне, паварочваючы ўвод на велічыню, якая павялічваецца разам са лічыльнікам індэкса. Значэнні пікселяў лінейна інтэрпалююцца сэмплерам, і выхад не павінен мець тыя ж памеры, што і ўваход.
    __kernel void rotate_image(__write_only image2d_t dst,
                               індэкс unsigned int,
                               __read_only image2d_t src)
    {
        const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
                                   CLK_FILTER_LINEAR);
    
        вугал плавання = (паплавок)індэкс / 100.0f;
    
        float2 dst_dim = convert_float2(get_image_dim(dst));
        float2 src_dim = convert_float2(get_image_dim(src));
    
        float2 dst_cen = dst_dim / 2.0f;
        float2 src_cen = src_dim / 2.0f;
    
        int2 dst_loc = (int2)(get_global_id(0), get_global_id(1));
    
        float2 dst_pos = convert_float2(dst_loc) - dst_cen;
        float2 src_pos = {
            cos(кут) * dst_pos.x - sin(кут) * dst_pos.y,
            sin(кут) * dst_pos.x + cos(кут) * dst_pos.y
        };
        src_pos = src_pos * src_dim / dst_dim;
    
        float2 src_loc = src_pos + src_cen;
    
        калі (src_loc.x < 0.0f || src_loc.y < 0.0f ||
            src_loc.x > src_dim.x || src_loc.y > src_dim.y)
            write_imagef(dst, dst_loc, 0,5f);
        яшчэ
            write_imagef(dst, dst_loc, read_imagef(src, сэмплер, src_loc));
    }
    
  • Сумяшчэнне двух уваходных дадзеных разам, прычым колькасць кожнага выкарыстоўванага ўводу вар'іруецца ў залежнасці ад лічыльніка індэкса.
    __kernel void blend_images(__write_only image2d_t dst,
                               індэкс unsigned int,
                               __read_only image2d_t src1,
                               __read_only image2d_t src2)
    {
        const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
                                   CLK_FILTER_LINEAR);
    
        float blend = (cos((float)index / 50.0f) + 1.0f) / 2.0f;
    
        int2 dst_loc = (int2)(get_global_id(0), get_global_id(1));
        int2 src1_loc = dst_loc * get_image_dim(src1) / get_image_dim(dst);
        int2 src2_loc = dst_loc * get_image_dim(src2) / get_image_dim(dst);
    
        float4 val1 = read_imagef(src1, сэмплер, src1_loc);
        float4 val2 = read_imagef(src2, сэмплер, src2_loc);
    
        write_imagef(dst, dst_loc, val1 * blend + val2 * (1.0f - blend));
    }
    

12.13 remap_opencl

Пераназначце пікселі з дапамогай уваходнага відэаструменя 2nd: Xmap і 3rd: Ymap.

Піксель прызначэння ў пазіцыі (X, Y) будзе абраны з пазіцыі крыніцы (x, y), дзе x = Xmap(X, Y) і y = Ymap(X, Y). Калі значэнні адлюстравання выходзяць за межы дыяпазону, для пікселя прызначэння будзе выкарыстоўвацца нулявое значэнне для пікселя.

Уваходныя відэапатокі Xmap і Ymap павінны мець аднолькавы памер. Выхадны відэаструмень будзе мець памеры відэаструменю Xmap/Ymap. Уваходныя відэапатокі Xmap і Ymap маюць 32-бітны фармат плаваючага пікселя, аднаканальны.

interp

Укажыце інтэрпаляцыю, якая выкарыстоўваецца для перапрызначэння пікселяў. Дазволеныя значэнні nearі linear. Значэнне па змаўчанні - linear.

fill

Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні black.

12.14 roberts_opencl

Прымяніце аператар крыжа Робертса ( https://en.wikipedia.org/wiki/Roberts_cross ) для ўводу відэапатоку.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 0xf, паводле якога апрацоўваюцца ўсе плоскасці.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон [0.0, 65535]і значэнне па змаўчанні 1.0.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон [-65535, 65535]і значэнне па змаўчанні 0.0.

12.14.1 Example

  • Прымяніце крыжаваны аператар Робертса са шкалой 2 і дэльтай 10
    -i INPUT -vf "hwupload, roberts_opencl=scale=2:delta=10, hwdownload" OUTPUT
    

12.15 sobel_opencl

Прымяніце аператар Sobel ( https://en.wikipedia.org/wiki/Sobel_operator ) для ўводу відэапатоку.

Фільтр прымае наступныя параметры:

planes

Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні 0xf, паводле якога апрацоўваюцца ўсе плоскасці.

scale

Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон [0.0, 65535]і значэнне па змаўчанні 1.0.

delta

Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон [-65535, 65535]і значэнне па змаўчанні 0.0.

12.15.1 Example

  • Прымяніце аператар sobel са шкалой 2 і дэльтай 10
    -i INPUT -vf "hwupload, sobel_opencl=scale=2:delta=10, hwdownload" OUTPUT
    

12.16 tonemap_opencl

Выканайце пераўтварэнне HDR(PQ/HLG) у SDR з танальным адлюстраваннем.

Ён прымае наступныя параметры:

tonemap

Укажыце аператар танальнага адлюстравання, які будзе выкарыстоўвацца. Тое самае, што і опцыя tonemap у tonemap .

param

Наладзьце алгарытм танальнага адлюстравання. тое самае, што параметр param у карце тонаў .

desat

Ужывайце дэсатурацыю для блікаў, якія перавышаюць гэты ўзровень яркасці. Чым вышэй параметр, тым больш інфармацыі аб колеры будзе захавана. Гэта налада дапамагае прадухіліць ненатуральна цьмяныя колеры для суперблікаў, замест гэтага (плаўна) ператвараючыся ў белыя. Гэта робіць выявы больш натуральнымі, за кошт памяншэння інфармацыі аб колерах, якія не ўваходзяць у дыяпазон.

Значэнне па змаўчанні роўна 0,5, і алгарытм тут крыху адрозніваецца ад карты тонаў працэсара ў цяперашняй версіі. Параметр 0.0 адключае гэты параметр.

threshold

Параметры алгарытму адлюстравання тонаў наладжваюцца для кожнай сцэны. І парог выкарыстоўваецца, каб вызначыць, змянілася сцэна ці не. Калі адлегласць паміж бягучай сярэдняй яркасцю кадра і бягучай сярэдняй яркасцю перавышае парогавае значэнне, мы пералічым сярэднюю і пікавую яркасць сцэны. Значэнне па змаўчанні - 0,2.

format

Укажыце фармат выхаднога пікселя.

У цяперашні час падтрымліваюцца наступныя фарматы:

p010
nv12
range, r

Усталюйце выхадны каляровы дыяпазон.

Магчымыя значэнні:

tv/mpeg
pc/jpeg

Па змаўчанні тое самае, што і ўвод.

primaries, p

Усталюйце асноўныя колеры вываду.

Магчымыя значэнні:

bt709
bt2020

Па змаўчанні тое самае, што і ўвод.

transfer, t

Усталюйце характарыстыкі выхаду перадачы.

Магчымыя значэнні:

bt709
bt2020

Па змаўчанні bt709.

matrix, m

Усталюйце выходную матрыцу каляровай прасторы.

Магчымыя значэнні:

bt709
bt2020

Па змаўчанні тое самае, што і ўвод.

12.16.1 Example

  • Пераўтварыце відэа HDR(PQ/HLG) у фармат bt2020-transfer-characteristic p010 з дапамогай лінейнага аператара.
    -i INPUT -vf "format=p010,hwupload,tonemap_opencl=t=bt2020:tonemap=linear:format=p010,hwdownload,format=p010" OUTPUT
    

12.17 unsharp_opencl

Павышэнне рэзкасці або размыццё ўваходнага відэа.

Ён прымае наступныя параметры:

luma_msize_x, lx

Усталюйце гарызантальны памер матрыцы яркасці. Дыяпазон [1, 23]і значэнне па змаўчанні 5.

luma_msize_y, ly

Усталюйце вертыкальны памер матрыцы яркасці. Дыяпазон [1, 23]і значэнне па змаўчанні 5.

luma_amount, la

Усталюйце сілу эфекту яркасці. Дыяпазон [-10, 10]і значэнне па змаўчанні 1.0.

Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.

chroma_msize_x, cx

Усталюйце гарызантальны памер матрыцы каляровасці. Дыяпазон [1, 23]і значэнне па змаўчанні 5.

chroma_msize_y, cy

Усталюйце вертыкальны памер каляровай матрыцы. Дыяпазон [1, 23]і значэнне па змаўчанні 5.

chroma_amount, ca

Усталюйце сілу каляровага эфекту. Дыяпазон [-10, 10]і значэнне па змаўчанні 0.0.

Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.

Усе параметры неабавязковыя і па змаўчанні адносяцца да радка "5:5:1.0:5:5:0.0".

12.17.1 Examples

  • Ужыць моцны эфект павышэння яркасці:
    -i INPUT -vf "hwupload, unsharp_opencl=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5, hwdownload" OUTPUT
    
  • Прымяніце моцнае размыццё параметраў яркасці і каляровасці:
    -i INPUT -vf "hwupload, unsharp_opencl=7:7:-2:7:7:-2, hwdownload" OUTPUT
    

12.18 xfade_opencl

Перакрыжаванае знікненне двух відэа з карыстацкім эфектам пераходу з дапамогай OpenCL.

Ён прымае наступныя варыянты:

transition

Усталюйце адзін з магчымых эфектаў пераходу.

custom

Выберыце карыстальніцкі эфект пераходу, фактычнае апісанне пераходу будзе выбрана з параметраў зыходнага кода і ядра.

fade
wipeleft
wiperight
wipeup
wipedown
slideleft
slideright
slideup
slidedown

Пераход па змаўчанні - знікненне.

source

Зыходны файл праграмы OpenCL для карыстацкага пераходу.

kernel

Усталюйце назву ядра для карыстальніцкага пераходу з зыходнага файла праграмы.

duration

Задаць працягласць пераходу відэа.

offset

Усталюйце час пачатку пераходу адносна першага відэа.

Зыходны файл праграмы павінен утрымліваць функцыю ядра з дадзеным імем, якая будзе запускацца адзін раз для кожнай плоскасці вываду. Кожны запуск на плоскасці ставіцца ў чаргу як асобны 2D глабальны NDRange з адным працоўным элементам для кожнага пікселя, які будзе згенераваны. Такім чынам, глабальнае зрушэнне ідэнтыфікатара для кожнага працоўнага элемента - гэта каардынаты пікселя ў малюнку прызначэння.

Функцыя ядра павінна прымаць наступныя аргументы:

  • Выява пункта прызначэння__write_only image2d_t ,.

    Гэта выява стане выхадам; ядро павінна запісаць усё гэта.

  • Першая зыходная выява __read_only image2d_t,. Другая зыходная выява __read_only image2d_t,.

    Гэта самыя свежыя выявы для кожнага ўваходу. Ядро можа чытаць з іх для стварэння вываду, але ў іх нельга запісваць.

  • Прагрэс пераходу float,. Гэта значэнне заўсёды ад 0 да 1 уключна.

Прыклады праграм:

  • Прымяніць эфект пераходу кропкавай заслоны:
    __kernel void blend_images(__write_only image2d_t dst,
                               __read_only image2d_t src1,
                               __read_only image2d_t src2,
                               паплавок прагрэс)
    {
        const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE |
                                   CLK_FILTER_LINEAR);
        int2 p = (int2)(get_global_id(0), get_global_id(1));
        float2 rp = (float2)(get_global_id(0), get_global_id(1));
        float2 dim = (float2)(get_image_dim(src1).x, get_image_dim(src1).y);
        rp = rp / цьмяны;
    
        float2 кропкі = (float2)(20.0, 20.0);
        float2 цэнтр = (float2)(0,0);
        float2 не выкарыстоўваецца;
    
        float4 val1 = read_imagef(src1, сэмплер, p);
        float4 val2 = read_imagef(src2, сэмплер, p);
        bool next = distance(fract(rp * dots, &unused), (float2)(0.5, 0.5)) < (прагрэс / адлегласць(rp, цэнтр));
    
        write_imagef(dst, p, наступны? val1 : val2);
    }
    

13 VAAPI Video Filters

Відэафільтры VAAPI звычайна выкарыстоўваюцца з дэкодэрам VAAPI і кадавальнікам VAAPI. Ніжэй прыводзіцца апісанне відэафільтраў VAAPI.

Каб уключыць кампіляцыю гэтых фільтраў, трэба наладзіць FFmpeg з дапамогай --enable-vaapi.

Каб выкарыстоўваць фільтры vaapi, неабходна правільна наладзіць прыладу vaapi. Для атрымання дадатковай інфармацыі, калі ласка, прачытайце https://trac.ffmpeg.org/wiki/Hardware/VAAPI

13.1 overlay_vaapi

Накласці адно відэа на другое.

Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход. Гэты фільтр патрабуе аднолькавага размяшчэння памяці для ўсіх уваходаў. Такім чынам, можа спатрэбіцца пераўтварэнне фармату.

Фільтр прымае наступныя параметры:

x

Усталюйце каардынату x накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - 0.

y

Усталюйце каардынату y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - 0.

w

Усталюйце шырыню накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - гэта шырыня ўваходнага накладнога відэа.

h

Усталюйце вышыню накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - гэта вышыня ўваходнага накладання відэа.

alpha

Усталюйце парогі выяўлення блакіроўкі. Дазволены дыяпазон ад 0,0 да 1,0, патрабуецца ўваходнае відэа з альфа-каналам. Значэнне па змаўчанні - 0.0.

13.1.1 Examples

  • Накласці выяву LOGO ў верхнім левым куце INPUT відэа. Абодва ўваходы для гэтага фільтра маюць фармат yuv420p.
    -i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_vaapi" OUTPUT
    
  • Накласці выяву LOGO са зрушэннем (200, 100) ад верхняга левага кута INPUT відэа. Уваходы маюць аднолькавы макет памяці для каляровых каналаў, накладанне мае дадатковую альфа-плоскасць, напрыклад, INPUT - yuv420p, а LOGO - yuva420p.
    -i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_vaapi=x=200:y=100:w=400:h=300:alpha=1.0, hwdownload, format=nv12" OUTPUT
    

13.2 tonemap_vaapi

Выканайце пераўтварэнне HDR (Шырокі дынамічны дыяпазон) у SDR (Стандартны дынамічны дыяпазон) з тонавым адлюстраваннем. Ён супастаўляе дынамічны дыяпазон кантэнту HDR10 з кантэнтам SDR. У цяперашні час ён прымае толькі HDR10 у якасці ўводу.

Ён прымае наступныя параметры:

format

Укажыце фармат выхаднога пікселя.

У цяперашні час падтрымліваюцца наступныя фарматы:

p010
nv12

Па змаўчанні - nv12.

primaries, p

Усталюйце асноўныя колеры вываду.

Па змаўчанні тое самае, што і ўвод.

transfer, t

Усталюйце характарыстыкі выхаду перадачы.

Па змаўчанні bt709.

matrix, m

Усталюйце выходную матрыцу каляровай прасторы.

Па змаўчанні тое самае, што і ўвод.

13.2.1 Example

  • Пераўтварэнне відэа HDR(HDR10) у фармат bt2020-transfer-characteristic p010
    tonemap_vaapi=format=p010:t=bt2020-10
    

14 Video Sources

Ніжэй прыводзіцца апісанне даступных на дадзены момант крыніц відэа.

14.1 buffer

Буферызаваць відэакадры і зрабіць іх даступнымі для ланцужка фільтраў.

Гэтая крыніца ў асноўным прызначана для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersrc.h.

Ён прымае наступныя параметры:

video_size

Укажыце памер (шырыню і вышыню) буферызаваных відэакадраў. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

width

Шырыня ўваходнага відэа.

height

Вышыня ўваходнага відэа.

pix_fmt

Радок, які прадстаўляе фармат пікселяў буферызаваных відэакадраў. Гэта можа быць лічба, якая адпавядае піксельнаму фармату, або назва піксельнага фармату.

time_base

Укажыце часовую базу, якую мяркуюць пазнакі часу буферызаваных кадраў.

frame_rate

Укажыце чаканую частату кадраў для відэаструменю.

pixel_aspect, sar

Суадносіны бакоў выбаркі (пікселяў) уваходнага відэа.

sws_param

Гэты параметр састарэў і ігнаруецца. Дадайце да апісання фільтра, каб вызначыць сцягі swscale для аўтаматычна ўстаўленых маштабіроўшчыкаў. Глядзіце сінтаксіс Filtergraph . sws_flags=flags;

hw_frames_ctx

Пры выкарыстанні апаратнага піксельнага фармату гэта павінна быць спасылка на AVHWFramesContext, які апісвае ўваходныя кадры.

Напрыклад:

buffer=width=320:height=240:pix_fmt=yuv410p:time_base=1/24:sar=1

будзе інструктаваць крыніцу прымаць відэакадры памерам 320x240 і фарматам "yuv410p", пры ўмове, што 1/24 у якасці метак часу разгорткі і квадратных пікселяў (суадносіны бакоў узору 1:1). Паколькі піксельны фармат з назвай "yuv410p" адпавядае лічбе 6 (праверце вызначэнне пераліку AVPixelFormat уlibavutil/pixfmt.h), гэты прыклад адпавядае:

buffer=size=320x240:pixfmt=6:time_base=1/24:pixel_aspect=1/1

У якасці альтэрнатывы параметры можна задаць як просты радок, але гэты сінтаксіс састарэў:

width: height: pix_fmt: time_base.num: time_base.den: pixel_aspect.num:pixel_aspect.den

14.2 cellauto

Стварыце шаблон, згенераваны элементарным клеткавым аўтаматам.

Пачатковы стан клетачнага аўтамата можна вызначыць праз filenameіpatternопцыі. Калі такія параметры не вызначаны, пачатковы стан ствараецца выпадковым чынам.

У кожным новым кадры новы радок у відэа запаўняецца вынікам клетачнага аўтамата наступнага пакалення. Паводзіны, калі ўвесь кадр запоўнены, вызначаеццаscrollварыянт.

Гэтая крыніца прымае наступныя параметры:

filename, f

Счытванне пачатковага стану клетачнага аўтамата, г.зн. пачатковага радка, з названага файла. У файле кожны сімвал без прабелаў лічыцца жывой ячэйкай, новы радок заканчвае радок, а далейшыя сімвалы ў файле будуць ігнаравацца.

pattern, p

Счытванне пачатковага стану клеткавага аўтамата, г.зн. пачатковага радка, з названага радка.

Кожны сімвал у радку, які не з'яўляецца прабелам, лічыцца жывой ячэйкай, новы радок завяршае радок, а далейшыя сімвалы ў радку будуць ігнаравацца.

rate, r

Усталюйце частату відэа, гэта значыць колькасць кадраў, якія ствараюцца ў секунду. Па змаўчанні 25.

random_fill_ratio, ratio

Усталюйце выпадковы каэфіцыент запаўнення для пачатковага радка клеткавага аўтамата. Гэта лік з плаваючай коскай у дыяпазоне ад 0 да 1, па змаўчанні 1/PHI.

Гэты параметр ігнаруецца, калі ўказаны файл або шаблон.

random_seed, seed

Усталюйце пачатковае значэнне для выпадковага запаўнення пачатковага радка, яно павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.

rule

Усталюйце правіла сотавага аўтамата, гэта лік у дыяпазоне ад 0 да 255. Значэнне па змаўчанні - 110.

size, s

Усталюйце памер выхаднога відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

Каліfilenameабоpatternзададзены, памер па змаўчанні ўсталёўваецца на шырыню вызначанага радка пачатковага стану, а вышыня - на width* PHI.

Каліsizeусталяваны, ён павінен змяшчаць шырыню ўказанага радка шаблону, і ўказаны шаблон будзе знаходзіцца па цэнтры ў большым радку.

Калі імя файла або радок шаблону не ўказаны, значэнне памеру па змаўчанні роўна "320x518" (выкарыстоўваецца для выпадкова згенераванага пачатковага стану).

scroll

Калі ўстаноўлена значэнне 1, пракручваць вывад уверх, калі ўсе радкі вываду ўжо запоўнены. Калі ўсталявана 0, новы згенераваны радок будзе запісаны над верхнім радком адразу пасля запаўнення ніжняга радка. Па змаўчанні 1.

start_full, full

Калі ўстаноўлена ў 1, цалкам запоўніць вывад згенераванымі радкамі перад вывадам першага кадра. Гэта паводзіны па змаўчанні, для адключэння ўсталюйце значэнне 0.

stitch

Калі ўстаноўлена значэнне 1, сшыйце левы і правы краю шэрагу. Гэта паводзіны па змаўчанні, для адключэння ўсталюйце значэнне 0.

14.2.1 Examples

  • Прачытайце пачатковы стан зpattern, і ўкажыце памер вываду 200x400.
    cellauto=f=pattern:s=200x400
    
  • Стварыце выпадковы пачатковы радок шырынёй 200 вочак з каэфіцыентам запаўнення 2/3:
    cellauto=ratio=2/3:s=200x200
    
  • Стварыце ўзор, згенераваны правілам 18, пачынаючы з адной жывой ячэйкі з цэнтрам у пачатковым радку шырынёй 100:
    cellauto=p=@:s=100x400:full=0:rule=18
    
  • Укажыце больш складаны пачатковы ўзор:
    cellauto=p='@@ @ @@':s=100x400:full=0:rule=18
    

14.3 coreimagesrc

Крыніца відэа, створаная на графічным працэсары з выкарыстаннем Apple CoreImage API на OSX.

Гэтая крыніца відэа з'яўляецца спецыялізаванай версіяй відэафільтра coreimage . Выкарыстоўвайце асноўны генератар выявы ў пачатку прымененага ланцужка фільтраў для стварэння кантэнту.

Крыніца відэа coreimagesrc прымае наступныя параметры:

list_generators

Пералічыце ўсе даступныя генератары разам з усімі іх адпаведнымі параметрамі, а таксама магчымыя мінімальныя і максімальныя значэнні разам са значэннямі па змаўчанні.

list_generators=true
size, s

Укажыце памер зыходнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 320x240.

rate, r

Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце frame_rate_num/ frame_rate_den, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".

sar

Усталюйце прыклад суадносін бакоў атрыманага відэа.

duration, d

Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.

Акрамя таго, прымаюцца ўсе параметры відэафільтра coreimage . Поўную ланцужок фільтраў можна выкарыстоўваць для далейшай апрацоўкі згенераванага ўводу без перадачы CPU-HOST. Падрабязнасці глядзіце ў дакументацыі і прыкладах coreimage .

14.3.1 Examples

  • Скарыстайцеся CIQRCodeGenerator, каб стварыць QR-код для галоўнай старонкі FFmpeg, зададзены ў выглядзе поўнага і экранаванага каманднага радка для стандартнай абалонкі bash ад Apple:
    ffmpeg -f lavfi -i coreimagesrc=s=100x100:filter=CIQRCodeGenerator@inputMessage=https\\\\\://FFmpeg.org/@inputCorrectionLevel=H -frames:v 1 QRCode.png
    

    Гэты прыклад эквівалентны прыкладу QRCode для coreimage без неабходнасці крыніцы відэа nullsrc.

14.4 gradients

Стварыце некалькі градыентаў.

size, s

Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".

rate, r

Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".

c0, c1, c2, c3, c4, c5, c6, c7

Набор 8 колераў. Значэнні па змаўчанні для колераў выбіраюцца выпадковым чынам.

x0, y0, y0, y1

Усталюйце зыходную і пункты прызначэння лініі градыенту. Калі адмоўны або па-за дыяпазонам, выбіраюцца выпадковыя.

nb_colors, n

Усталюйце колькасць колераў для адначасовага выкарыстання. Дазволены дыяпазон ад 2 да 8. Значэнне па змаўчанні - 2.

seed

Задайце пачатковы пункт для выбару кропак лініі градыенту.

duration, d

Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.

speed

Задаць хуткасць кручэння градыентаў.

type, t

Задаць тып градыентаў, можа быць linearабо radialабо circularабо spiral.

14.5 mandelbrot

Стварыце фрактал мноства Мандэльброта і паступова набліжайце да кропкі, вызначанай кнопкамі start_xі start_y.

Гэтая крыніца прымае наступныя параметры:

end_pts

Усталюйце значэнне тэрмінальных балаў. Значэнне па змаўчанні - 400.

end_scale

Усталюйце значэнне шкалы тэрмінала. Павінна быць значэнне з плаваючай коскай. Значэнне па змаўчанні 0,3.

inner

Усталюйце рэжым унутранай афарбоўкі, гэта значыць алгарытм, які выкарыстоўваецца для малявання ўнутранай вобласці фрактала Мандэльброта.

Ён прымае адно з наступных значэнняў:

black

Усталюйце чорны рэжым.

convergence

Паказаць час да збліжэння.

mincol

Усталюйце колер на аснове пункту, бліжэйшага да пачатку ітэрацый.

period

Усталяваць рэжым перыяду.

Значэнне па змаўчанні - mincol.

bailout

Усталюйце значэнне выратавання. Значэнне па змаўчанні 10.0.

maxiter

Усталюйце максімальную колькасць ітэрацый, выкананых алгарытмам візуалізацыі. Значэнне па змаўчанні - 7189.

outer

Усталюйце рэжым знешняй афарбоўкі. Ён прымае адно з наступных значэнняў:

iteration_count

Усталюйце рэжым падліку ітэрацый.

normalized_iteration_count

ўсталяваць нармалізаваны рэжым падліку ітэрацый.

Значэнне па змаўчанні - normalized_iteration_count.

rate, r

Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".

size, s

Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".

start_scale

Усталюйце пачатковае значэнне маштабу. Значэнне па змаўчанні 3.0.

start_x

Усталюйце пачатковую пазіцыю x. Павінна быць значэнне з плаваючай коскай ад -100 да 100. Значэнне па змаўчанні - -0,743643887037158704752191506114774.

start_y

Усталюйце пачатковае становішча y. Павінна быць значэнне з плаваючай коскай ад -100 да 100. Значэнне па змаўчанні - -0,131825904205311970493132056385139.

14.6 mptestsrc

Стварэнне розных тэставых шаблонаў, якія ствараюцца тэставым фільтрам MPlayer.

Памер створанага відэа фіксаваны і складае 256x256. Гэтая крыніца карысная, у прыватнасці, для тэставання функцый кадавання.

Гэтая крыніца прымае наступныя параметры:

rate, r

Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце frame_rate_num/ frame_rate_den, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".

duration, d

Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.

test, t

Усталюйце нумар або назву тэсту для выканання. Падтрымліваюцца наступныя тэсты:

dc_luma
dc_chroma
freq_luma
freq_chroma
amp_luma
amp_chroma
cbp
mv
ring1
ring2
all
max_frames, m

Усталюйце максімальную колькасць кадраў, згенераваных для кожнага тэсту, значэнне па змаўчанні роўна 30.

Значэнне па змаўчанні - "усе", якое будзе цыклічна перабіраць спіс усіх тэстаў.

Некаторыя прыклады:

mptestsrc=t=dc_luma

створыць тэставы шаблон "dc_luma".

14.7 frei0r_src

Дайце крыніцу frei0r.

Каб уключыць кампіляцыю гэтага фільтра, трэба ўсталяваць загаловак frei0r і наладзіць FFmpeg з дапамогай --enable-frei0r.

Гэтая крыніца прымае наступныя параметры:

size

Памер відэа для стварэння. Сінтаксіс гэтай опцыі праверце (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

framerate

Частата кадраў створанага відэа. Гэта можа быць радок формы num / denабо абрэвіятура частоты кадраў.

filter_name

Імя крыніцы frei0r для загрузкі. Для атрымання дадатковай інфармацыі аб frei0r і аб тым, як усталяваць параметры, прачытайце раздзел frei0r у дакументацыі відэафільтраў.

filter_params

Падзелены '|' спіс параметраў для перадачы ў крыніцу frei0r.

Напрыклад, каб стварыць крыніцу frei0r partik0l памерам 200x200 і частатой кадраў 10, якая накладваецца на асноўны ўваход фільтра накладання:

frei0r_src=size=200x200:framerate=10:filter_name=partik0l:filter_params=1234 [overlay]; [in][overlay] overlay

14.8 life

Стварыце ўзор жыцця.

Гэтая крыніца заснавана на абагульненні жыццёвай гульні Джона Конвея.

Уваход з крыніцы ўяўляе сабой сетку жыцця, кожны піксель уяўляе сабой клетку, якая можа знаходзіцца ў адным з двух магчымых станаў: жывая або мёртвая. Кожная ячэйка ўзаемадзейнічае са сваімі васьмю суседзямі, якія з'яўляюцца клеткамі, якія знаходзяцца побач па гарызанталі, вертыкалі або дыяганалі.

Пры кожным узаемадзеянні сетка развіваецца ў адпаведнасці з прынятым правілам, якое вызначае колькасць суседніх жывых клетак, якія прымусяць клетку застацца ў жывых або нарадзіцца. Theruleопцыя дазваляе вызначыць правіла, якое трэба прыняць.

Гэтая крыніца прымае наступныя параметры:

filename, f

Усталюйце файл, з якога будзе счытвацца пачатковы стан сеткі. У файле кожны сімвал без прабелаў лічыцца жывой ячэйкай, а сімвал новага радка выкарыстоўваецца для размежавання канца кожнага радка.

Калі гэты параметр не пазначаны, пачатковая сетка генеруецца выпадковым чынам.

rate, r

Усталюйце частату відэа, гэта значыць колькасць кадраў, якія ствараюцца ў секунду. Па змаўчанні 25.

random_fill_ratio, ratio

Усталюйце выпадковы каэфіцыент запаўнення для пачатковай выпадковай сеткі. Гэта лік з плаваючай коскай у дыяпазоне ад 0 да 1, па змаўчанні 1/PHI. Ён ігнаруецца, калі пазначаны файл.

random_seed, seed

Усталюйце пачатковую базу для запаўнення пачатковай выпадковай сеткі, яна павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.

rule

Усталюйце правіла жыцця.

Правіла можа быць вызначана кодам тыпу "S NS/ B NB", дзе NSі NB- паслядоўнасці лікаў у дыяпазоне 0-8, NSвызначае колькасць жывых суседніх клетак, якія прымушаюць жывую клетку заставацца жывой, іNB колькасць жывых суседнія клеткі, якія прымушаюць мёртвую клетку ажываць (г.зн. «нараджацца»). "s" і "b" могуць выкарыстоўвацца замест "S" і "B" адпаведна.

У якасці альтэрнатывы правіла можа быць вызначана 18-бітным цэлым лікам. 9 старэйшых біт выкарыстоўваюцца для кадавання наступнага стану клеткі, калі яна жывая для кожнай колькасці суседніх жывых клетак, малодшыя біты вызначаюць правіла для "нараджэння" новых клетак. Біты больш высокага парадку кадуюць большую колькасць суседніх вочак. Напрыклад, лік 6153 = (12<<9)+9вызначае правіла застацца ў жывых 12 і правіла нараджэння 9, што адпавядае "S23/B03".

Значэнне па змаўчанні - "S23/B3", якое з'яўляецца арыгінальным правілам гульні ў жыццё Конвея, якое будзе падтрымліваць клетку ў жывых, калі ў ёй ёсць 2 ці 3 жывыя клеткі, і ствараць новую клетку, калі вакол мёртвай ёсць тры жывыя клеткі. вочка.

size, s

Усталюйце памер выхаднога відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .

Каліfilenameзададзены, памер па змаўчанні задаецца такім жа памерам, як і ўваходны файл. Каліsizeусталяваны, ён павінен утрымліваць памер, указаны ва ўваходным файле, і першапачатковая сетка, вызначаная ў гэтым файле, знаходзіцца па цэнтры ў большай выніковай вобласці.

Калі імя файла не пазначана, значэнне памеру па змаўчанні роўна "320x240" (выкарыстоўваецца для выпадкова згенераванай пачатковай сеткі).

stitch

Калі ўстаноўлена значэнне 1, сшыйце разам левы і правы краю сеткі, а таксама верхні і ніжні краю. Па змаўчанні 1.

mold

Усталюйце хуткасць формы для ячэек. Калі ўстаноўлена, мёртвая клетка будзе выходзіць зdeath_colorкаб mold_colorз крокамmold.moldможа мець значэнне ад 0 да 255.

life_color

Устанавіць колер жывых (або нованароджаных) клетак.

death_color

Усталюйце колер мёртвых клетак. Каліmoldусталяваны, гэта першы колер, які выкарыстоўваецца для адлюстравання мёртвай клеткі.

mold_color

Усталюйце колер цвілі для дакладна мёртвых і заплесневелых клетак.

Каб даведацца пра сінтаксіс гэтых 3 варыянтаў колеру, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

14.8.1 Examples

  • Чытаць сетку зpattern, і адцэнтруйце яго ў сетцы памерам 300x300 пікселяў:
    life=f=pattern:s=300x300
    
  • Стварыце выпадковую сетку памерам 200x200 з каэфіцыентам запаўнення 2/3:
    life=ratio=2/3:s=200x200
    
  • Укажыце карыстальніцкае правіла для развіцця выпадкова згенераванай сеткі:
    life=rule=S14/B34
    
  • Поўны прыклад з эфектам павольнай смерці (цвіль) з выкарыстаннем ffplay:
    ffplay -f lavfi life=s=300x200:mold=10:r=60:ratio=0.1:death_color=#C83232:life_color=#00ff00,scale=1200:800:flags=16
    

14.9 allrgb, allyuv, color, colorchart, colorspectrum, haldclutsrc, nullsrc, pal75bars, pal100bars, rgbtestsrc, smptebars, smptehdbars, testsrc, testsrc2, yuvtestsrc

Крыніца allrgbвяртае кадры памерам 4096x4096 усіх колераў rgb.

Крыніца allyuvвяртае кадры памерам 4096x4096 усіх колераў yuv.

Крыніца colorзабяспечвае аднолькава афарбаваны ўвод.

Крыніца colorchartдае дыяграму праверкі колераў.

Крыніца colorspectrumзабяспечвае ўвод каляровага спектру.

Крыніца haldclutsrcзабяспечвае асобу Hald CLUT. Глядзіце таксама фільтр haldclut .

Крыніца nullsrcвяртае неапрацаваныя відэакадры. Гэта ў асноўным карысна для выкарыстання ў інструментах аналізу/адладкі або ў якасці крыніцы для фільтраў, якія ігнаруюць ўваходныя даныя.

Крыніца pal75barsстварае шаблон каляровых палос на аснове рэкамендацый EBU PAL з узроўнем колеру 75%.

Крыніца pal100barsстварае ўзор каляровых палос на аснове рэкамендацый EBU PAL са 100% узроўнем колеру.

Крыніца rgbtestsrcстварае тэставы ўзор RGB, карысны для выяўлення праблем з RGB і BGR. Вы павінны ўбачыць чырвоную, зялёную і сінюю паласы зверху ўніз.

Крыніца smptebarsстварае ўзор каляровых палос на аснове інжынерных рэкамендацый SMPTE EG 1-1990.

Крыніца smptehdbarsстварае шаблон каляровых палос на аснове SMPTE RP 219-2002.

Крыніца testsrcстварае шаблон тэставага відэа, які паказвае каляровы ўзор, градыент пракруткі і метку часу. У асноўным гэта прызначана для тэставання.

Зыходны testsrc2код падобны на testsrc, але падтрымлівае больш піксельных фарматаў, а не проста rgb24. Гэта дазваляе выкарыстоўваць яго ў якасці ўваходных дадзеных для іншых тэстаў без неабходнасці пераўтварэння фармату.

Крыніца yuvtestsrcгенеруе тэставы шаблон YUV. Вы павінны ўбачыць палосы ay, cb і cr зверху ўніз.

Крыніцы прымаюць наступныя параметры:

level

Пакажыце ўзровень Hald CLUT, даступны толькі ў haldclutsrc крыніцы. Узровень Nгенеруе выяву з N*N*Nпікселяў N*N*N для выкарыстання ў якасці ідэнтыфікацыйнай матрыцы для трохмерных табліц пошуку. Кожны кампанент кадуецца па 1/(N*N)шкале.

color, c

Пакажыце колер крыніцы, даступны толькі ў color крыніцы. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .

size, s

Укажыце памер зыходнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 320x240.

Гэтая опцыя недаступная з фільтрамі allrgb, allyuv, і .haldclutsrc

rate, r

Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце frame_rate_num/ frame_rate_den, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".

duration, d

Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .

Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.

Паколькі частата кадраў выкарыстоўваецца ў якасці часовай базы, усе кадры, уключаючы апошні, будуць мець поўную працягласць. Калі ўказаная працягласць не кратная працягласці кадра, яна будзе акруглена ў большы бок.

sar

Усталюйце прыклад суадносін бакоў атрыманага відэа.

alpha

Укажыце альфа (непразрыстасць) фону, даступны толькі ў testsrc2зыходным коды. Значэнне павінна быць ад 0 (цалкам празрысты) да 255 (цалкам непразрысты, стандартнае).

decimals, n

Усталюйце колькасць знакаў пасля коскі для паказу ў пазнацы часу, даступна толькі ў testsrcкрыніцы.

Адлюстраванае значэнне меткі часу будзе адпавядаць зыходнаму значэнню меткі часу, памножанаму на ступень 10 вызначанага значэння. Значэнне па змаўчанні 0.

type

Усталюйце тып каляровага спектру, даступны толькі ў colorspectrumкрыніцы. Можа быць адно з наступнага:

'black'
'white'
'all'
patch_size

Усталюйце памер плямы аднаго колеру, даступны толькі ў colorchartкрыніцы. Па змаўчанні 64x64.

preset

Усталюйце прадусталяваныя колеры Colorchecker, даступныя толькі ў colorchartкрыніцы.

Даступныя значэнні:

'reference'
'skintones'

Значэнне па змаўчанні - reference.

14.9.1 Examples

  • Стварыце відэа працягласцю 5,3 секунды, памерам 176x144 і частатой кадраў 10 кадраў у секунду:
    testsrc=duration=5.3:size=qcif:rate=10
    
  • У наступным апісанні графіка будзе створана чырвоная крыніца з непразрыстасцю 0,2, памерам "qcif" і частатой кадраў 10 кадраў у секунду:
    color=c=red@0.2:s=qcif:r=10
    
  • Калі змесціва ўводу трэба ігнараваць, nullsrcможна выкарыстоўваць. Наступная каманда стварае шум у плоскасці яркасці, выкарыстоўваючы geqфільтр:
    nullsrc=s=256x256, geq=random(1)*255:128:128
    

14.9.2 Commands

Крыніца colorпадтрымлівае наступныя каманды:

c, color

Задайце колер створанага малюнка. Прымае той жа сінтаксіс адпаведнагаcolorварыянт.

14.10 openclsrc

Стварэнне відэа з дапамогай праграмы OpenCL.

source

Зыходны файл праграмы OpenCL.

kernel

Імя ядра ў праграме.

size, s

Памер кадраў для стварэння. Гэта трэба ўсталяваць.

format

Піксельны фармат для стварэння кадраў. Гэта трэба ўсталяваць.

rate, r

Колькасць кадраў, якія ствараюцца кожную секунду. Значэнне па змаўчанні '25'.

Для атрымання падрабязнай інфармацыі аб тым, як працуе загрузка праграмы, глядзіце фільтр program_opencl .

Прыклады праграм:

  • Стварыце змяненне колеру, усталяваўшы значэнні пікселяў з пазіцыі пікселя на выходным малюнку. (Звярніце ўвагу, што гэта будзе працаваць з усімі фарматамі пікселяў, але згенераваны вынік не будзе аднолькавым.)
    __ядро несапраўднай рампы (__write_only image2d_t dst,
                       unsigned int index)
    {
        int2 loc = (int2)(get_global_id(0), get_global_id(1));
    
        float4 val;
        val.xy = val.zw = convert_float2(loc) / convert_float2(get_image_dim(dst));
    
        write_imagef(dst, loc, val);
    }
    
  • Стварыце ўзор дывана Серпінскага, перамяшчаючы кожны кадр на адзін піксель.
    __kernel void siepinski_carpet(__write_only image2d_t dst,
                                    unsigned int index)
    {
        int2 loc = (int2)(get_global_id(0), get_global_id(1));
    
        значэнне float4 = 0.0f;
        int x = loc.x + індэкс;
        int y = loc.y + індэкс;
        у той час як (x > 0 || y > 0) {
            if (x % 3 == 1 && y % 3 == 1) {
                значэнне = 1.0f;
                разбіваць;
            }
            х /= 3;
            у /= 3;
        }
    
        write_imagef(dst, loc, value);
    }
    

14.11 sierpinski

Стварыце фрактал дывана/трохвугольніка Серпінскага і выпадкова панаруйце.

Гэтая крыніца прымае наступныя параметры:

size, s

Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".

rate, r

Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".

seed

Усталюйце пачатковы код, які выкарыстоўваецца для выпадковага панарамавання.

jump

Усталюйце максімальны скачок для адной кропкі прызначэння. Дазволены дыяпазон ад 1 да 10000.

type

Усталюйце тып фрактала, можа быць па змаўчанні carpetабо triangle.

15 Video Sinks

Ніжэй прыводзіцца апісанне даступных на дадзены момант відэапрыёмнікаў.

15.1 buffersink

Буферызаваць відэакадры і зрабіць іх даступнымі ў канцы графіка фільтра.

Гэты прыёмнік у асноўным прызначаны для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersink.h або сістэма опцый.

Ён прымае паказальнік на структуру AVBufferSinkContext, якая вызначае фарматы ўваходных буфераў, які перадаецца ў якасці непразрыстага параметра avfilter_init_filterдля ініцыялізацыі.

15.2 nullsink

Нулявы прыём відэа: не рабіць абсалютна нічога з уваходным відэа. Ён галоўным чынам карысны як шаблон і для выкарыстання ў інструментах аналізу/адладкі.

16 Multimedia Filters

Ніжэй прыводзіцца апісанне даступных на дадзены момант мультымедыйных фільтраў.

16.1 abitscope

Пераўтварэнне ўваходнага аўдыя ў відэавыхад з адлюстраваннем разраднасці гуку.

Фільтр прымае наступныя параметры:

rate, r

Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 1024x256.

colors

Укажыце спіс колераў, падзеленых прабелам або знакам '|' які будзе выкарыстоўвацца для малявання каналаў. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.

mode, m

Задаць рэжым вываду. Можа быць barsабо trace. Па змаўчанні bars.

16.2 adrawgraph

Намалюйце графік, выкарыстоўваючы метаданыя ўваходнага гуку.

Глядзіце малюнак

16.3 agraphmonitor

Глядзіце graphmonitor .

16.4 ahistogram

Пераўтварэнне ўваходнага аўдыё ў відэавыхад з адлюстраваннем гістаграмы гучнасці.

Фільтр прымае наступныя параметры:

dmode

Укажыце, як разлічваецца гістаграма.

Ён прымае наступныя значэнні:

'single'

Выкарыстоўвайце адну гістаграму для ўсіх каналаў.

'separate'

Выкарыстоўвайце асобную гістаграму для кожнага канала.

Па змаўчанні single.

rate, r

Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - hd720.

scale

Задаць маштаб адлюстравання.

Ён прымае наступныя значэнні:

'log'

лагарыфмічны

'sqrt'

квадратны корань

'cbrt'

кубічны корань

'lin'

лінейны

'rlog'

зваротная лагарыфмічная

Па змаўчанні log.

ascale

Усталюйце шкалу амплітуды.

Ён прымае наступныя значэнні:

'log'

лагарыфмічны

'lin'

лінейны

Па змаўчанні log.

acount

Усталюйце, колькі кадраў назапашваць у гістаграме. Па змаўчанні 1. Устаноўка -1 назапашвае ўсе кадры.

rheight

Задаць суадносіны вышыні акна гістаграмы.

slide

Ўстаноўка сонограммы слізгальная.

Ён прымае наступныя значэнні:

'replace'

замяніць старыя радкі новымі.

'scroll'

пракруціць зверху ўніз.

Па змаўчанні replace.

hmode

Ўсталяваць рэжым гістаграмы.

Ён прымае наступныя значэнні:

'abs'

Выкарыстоўвайце абсалютныя значэнні выбарак.

'sign'

Выкарыстоўвайце некранутыя значэння ўзораў.

Па змаўчанні abs.

16.5 aphasemeter

Вымярае фазу ўваходнага гуку, які экспартуецца ў выглядзе метададзеных lavfi.aphasemeter.phase, якія прадстаўляюць сярэднюю фазу бягучага гукавога кадра. Відэавыхад таксама можа быць выраблены і ўключаны па змаўчанні. Гук перадаецца як першы выхад.

Аўдыя будзе ператворана ў стэрэа, калі яно мае іншую планіроўку каналаў. Значэнне фазы знаходзіцца ў дыяпазоне, [-1, 1]дзе -1азначае, што левы і правы каналы цалкам не сфазаваны, а 1каналы знаходзяцца ў фазе.

Фільтр прымае наступныя параметры, усе звязаныя з яго відэавыхадам:

rate, r

Усталюйце выходную частату кадраў. Значэнне па змаўчанні - 25.

size, s

Усталюйце памер відэа для выхаду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 800x400.

rc
gc
bc

Укажыце чырвоны, зялёны, сіні кантраст. Значэнні па змаўчанні 2: 7і 1. Дазволены дыяпазон [0, 255].

mpc

Задайце колер, які будзе выкарыстоўвацца для малявання сярэдняй фазы. Калі колер noneпа змаўчанні, сярэдняе значэнне фазы намалявана не будзе.

video

Уключыць выхад відэа. Па змаўчанні ўключана.

16.5.1 phasing detection

Фільтр таксама выяўляе не ў фазе і мона паслядоўнасці ў стэрэа патоках. Ён рэгіструе пачатак, канец і працягласць паслядоўнасці, калі яна доўжыцца даўжэй або да мінімальнага набору.

Фільтр прымае наступныя параметры для гэтага выяўлення:

phasing

Уключыце выяўленне мона і зрушэння фазы. Па змаўчанні адключана.

tolerance, t

Усталюйце фазавы допуск для выяўлення мона ў суадносінах амплітуд. Па змаўчанні 0. Дазволены дыяпазон [0, 1].

angle, a

Усталюйце парогавае значэнне вугла для выяўлення сыходу па фазе ў градусах. Па змаўчанні 170. Дазволены дыяпазон [90, 180].

duration, d

Усталюйце мона або нефазавую працягласць да паведамлення, выражаную ў секундах. Па змаўчанні 2.

16.5.2 Examples

  • Поўны прыклад з ffmpegвыяўленнем 1 секунды мона з допускам фазы 0,001:
    ffmpeg -i stereo.wav -af aphasemeter=video=0:phasing=1:duration=1:tolerance=0.001 -f null -
    

16.6 avectorscope

Пераўтварэнне ўваходнага аўдыя ў відэавыхад, які прадстаўляе вобласць аўдыявектара.

Фільтр выкарыстоўваецца для вымярэння розніцы паміж каналамі стэрэааўдыяпатоку. Манаўральны сігнал, які складаецца з аднолькавых левага і правага сігналаў, прыводзіць да прамой вертыкальнай лініі. Любы стэрэападзел бачны як адхіленне ад гэтай лініі, ствараючы фігуру Лісажу. Калі з'яўляецца прамая (або адхіленая ад яе), але гарызантальная лінія, гэта сведчыць аб тым, што левы і правы каналы не зрушаны па фазе.

Фільтр прымае наступныя параметры:

mode, m

Усталюйце рэжым вектороскопа.

Даступныя значэнні:

'lissajous'

Ліссажу павернуты на 45 градусаў.

'lissajous_xy'

Тое самае, што і вышэй, але без павароту.

'polar'

Па форме нагадвае палову круга.

Значэнне па змаўчанні 'lissajous'.

size, s

Усталюйце памер відэа для выхаду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 400x400.

rate, r

Усталюйце выходную частату кадраў. Значэнне па змаўчанні - 25.

rc
gc
bc
ac

Укажыце чырвоны, зялёны, сіні і альфа-кантраст. Значэнні па змаўчанні : 40, і . Дазволены дыяпазон . 16080255[0, 255]

rf
gf
bf
af

Укажыце чырвоны, зялёны, сіні і альфа-затуханне. Значэнні па змаўчанні : 15, і . Дазволены дыяпазон . 1055[0, 255]

zoom

Усталюйце каэфіцыент маштабавання. Значэнне па змаўчанні - 1. Дазволены дыяпазон [0, 10]. Значэнні, ніжэйшыя за 1, будуць аўтаматычна наладжваць каэфіцыент маштабавання да максімальна магчымага значэння.

draw

Усталюйце рэжым малявання вектарскопа.

Даступныя значэнні:

'dot'

Намалюйце кропку для кожнага ўзору.

'line'

Правядзіце мяжу паміж папярэднім і бягучым узорам.

Значэнне па змаўчанні 'dot'.

scale

Укажыце шкалу амплітуды аўдыёсэмплоў.

Даступныя значэнні:

'lin'

Лінейны.

'sqrt'

Квадратны корань.

'cbrt'

Кубічны корань.

'log'

Лагарыфмічны.

swap

Памяняць месцамі вось левага канала на вось правага канала.

mirror

Люстраная вось.

'none'

Без люстэрка.

'x'

Люстэрка толькі па восі х.

'y'

Люстэрка толькі па восі y.

'xy'

Люстэрка абедзвюх восяў.

16.6.1 Examples

  • Поўны прыклад з выкарыстаннем ffplay:
    ffplay -f lavfi 'amovie=input.mp3, asplit [a][out1];
                 [a] avectorscope=zoom=1.3:rc=2:gc=200:bc=10:rf=1:gf=8:bf=7 [out0]'
    

16.6.2 Commands

Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя опцый sizeі rate.

16.7 bench, abench

Параўнальная частка фільтра.

Фільтр прымае наступныя параметры:

action

Запусціць або спыніць таймер.

Даступныя значэнні:

'start'

Атрымаць бягучы час, усталяваць яго ў якасці метададзеных кадра (з дапамогай ключа lavfi.bench.start_time) і пераслаць кадр да наступнага фільтра.

'stop'

Атрымаць бягучы час і атрымаць lavfi.bench.start_timeметаданыя з метададзеных кадра ўводу, каб атрымаць розніцу ў часе. Затым друкуецца розніца ў часе, сярэдні, максімальны і мінімальны час (адпаведна t, avg, maxі ). minПазнакі часу выражаюцца ў секундах.

16.7.1 Examples

16.8 concat

Аб'ядноўвайце аўдыя- і відэапатокі, злучаючы іх адзін за адным.

Фільтр працуе на сегментах сінхранізаваных відэа- і аўдыёпатокаў. Усе сегменты павінны мець аднолькавую колькасць патокаў кожнага тыпу, і гэта таксама будзе колькасць патокаў на выхадзе.

Фільтр прымае наступныя параметры:

n

Усталюйце колькасць сегментаў. Па змаўчанні 2.

v

Усталюйце колькасць выходных відэапатокаў, гэта значыць таксама колькасць відэапатокаў у кожным сегменце. Па змаўчанні 1.

a

Усталюйце колькасць выходных аўдыяпатокаў, гэта значыць таксама колькасць аўдыяпатокаў у кожным сегменце. Па змаўчанні 0.

unsafe

Актывуйце небяспечны рэжым: не адмаўляйцеся, калі сегменты маюць іншы фармат.

Фільтр мае v+ aвыхады: спачатку vвідэавыхады, потым aаўдыёвыхады.

Ёсць nx( v+ a) уваходы: спачатку ўваходы для першага сегмента ў тым жа парадку, што і выхады, затым уваходы для другога сегмента і г.д.

Звязаныя патокі не заўсёды маюць аднолькавую працягласць па розных прычынах, уключаючы памер кадра кодэка або неакуратнае аўтарства. Па гэтай прычыне звязаныя сінхранізаваныя патокі (напрыклад, відэа і яго гукавая дарожка) павінны быць аб'яднаны адначасова. Фільтр concat будзе выкарыстоўваць працягласць самага доўгага патоку ў кожным сегменце (акрамя апошняга) і пры неабходнасці запаўняць больш кароткія аўдыяпатокі цішынёй.

Каб гэты фільтр працаваў правільна, усе сегменты павінны пачынацца з пазнакі часу 0.

Усе адпаведныя патокі павінны мець аднолькавыя параметры ва ўсіх сегментах; сістэма фільтрацыі аўтаматычна абярэ агульны фармат пікселяў для відэапатокаў, а таксама агульны фармат выбаркі, частату дыскрэтызацыі і планіроўку канала для аўдыёпатокаў, але іншыя налады, такія як раздзяленне, павінны быць пераўтвораны карыстальнікам відавочна.

Розная частата кадраў прымальная, але прывядзе да зменнай частаты кадраў на выхадзе; не забудзьцеся наладзіць выходны файл для яго апрацоўкі.

16.8.1 Examples

  • Аб'яднайце пачатак, эпізод і канцоўку, усё ў двухмоўнай версіі (відэа ў патоку 0, аўдыя ў патоках 1 і 2):
    ffmpeg -i opening.mkv -i episode.mkv -i ending.mkv -filter_complex \
      '[0:0] [0:1] [0:2] [1:0] [1:1] [1:2] [2:0] [2:1] [2:2]
       concat=n=3:v=1:a=2 [v] [a1] [a2]' \
      -map '[v]' -map '[a1]' -map '[a2]' output.mkv
    
  • Аб'яднанне дзвюх частак, асобная апрацоўка аўдыя і відэа, выкарыстанне крыніц (а)фільмаў і рэгуляванне разрознасці:
    movie=part1.mp4, scale=512:288 [v1] ; amovie=part1.mp4 [a1] ;
    movie=part2.mp4, scale=512:288 [v2] ; amovie=part2.mp4 [a2] ;
    [v1] [v2] concat [outv] ; [a1] [a2] concat=v=0:a=1 [outa]
    

    Звярніце ўвагу, што рассінхранізацыя адбудзецца ў стыку, калі аўдыя- і відэаплыні не маюць аднолькавай працягласці ў першым файле.

16.8.2 Commands

Гэты фільтр падтрымлівае наступныя каманды:

next

Закрыць бягучы сегмент і перайсці да наступнага

16.9 ebur128

Фільтр сканэра EBU R128. Гэты фільтр прымае аўдыёпаток і аналізуе ўзровень яго гучнасці. Па змаўчанні ён рэгіструе паведамленне з частатой 10 Гц з імгненнай гучнасцю (пазначаецца M), кароткачасовай гучнасцю ( S), убудаванай гучнасцю ( I) і дыяпазонам гучнасці ( LRA).

Фільтр можа аналізаваць толькі тыя патокі, якія маюць фармат выбаркі з плаваючай кропкай падвойнай дакладнасці. Пры неабходнасці ўваходны паток будзе пераўтвораны ў гэтую спецыфікацыю. Каб атрымаць зыходныя параметры, карыстальнікам можа спатрэбіцца ўставіць фільтры фармату і/або выбаркі пасля гэтага фільтра.

Фільтр таксама мае відэавыхад (гл. videoопцыю) з графікам у рэальным часе для назірання за змяненнем гучнасці. Графіка змяшчае зарэгістраванае паведамленне, згаданае вышэй, таму яно больш не друкуецца, калі ўсталяваны гэты параметр, калі не ўсталявана падрабязнае вядзенне журнала. Асноўная вобласць графіка ўтрымлівае кароткачасовую гучнасць (3 секунды аналізу), а датчык справа прызначаны для імгненнай гучнасці (400 мілісекунд), але пры жаданні яе можна наладзіць для адлюстравання кароткачасовай гучнасці (гл gauge.).

Зялёная вобласць пазначае мэтавы дыяпазон +/- 1LU вакол мэтавай гучнасці (-23LUFS па змаўчанні, калі не зменена праз target).

Дадатковая інфармацыя аб рэкамендацыі па гучнасці EBU R128 на http://tech.ebu.ch/loudness .

Фільтр прымае наступныя параметры:

video

Актывуйце відэавыхад. Аўдыяпаток перадаецца нязменным незалежна ад таго, усталяваны гэты параметр ці не. Відэаструмень будзе першым выходным патокам, калі ён актываваны. Па змаўчанні 0.

size

Усталюйце памер відэа. Гэты параметр прызначаны толькі для відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Па змаўчанні і мінімальным дазволам з'яўляецца 640x480.

meter

Усталюйце шкалу EBU. Па змаўчанні 9. Агульнымі значэннямі з'яўляюцца 9і 18, адпаведна, для метра шкалы EBU +9 і метра шкалы EBU +18. Дапускаецца любое іншае цэлае значэнне ў межах гэтага дыяпазону.

metadata

Усталяваць увядзенне метададзеных. Калі зададзена значэнне 1, уваходны аўдыя будзе сегментаваны на выходныя кадры працягласцю 100 мс, кожны з якіх змяшчае розную інфармацыю аб гучнасці ў метададзеных. Усе ключы метададзеных маюць прэфікс lavfi.r128..

Па змаўчанні 0.

framelog

Прымусовы ўзровень рэгістравання кадра.

Даступныя значэнні:

'info'

узровень рэгістрацыі інфармацыі

'verbose'

падрабязны ўзровень вядзення часопіса

Па змаўчанні ўзровень вядзення журнала ўстаноўлены на info. Каліvideoабоmetadataусталяваны параметры, ён пераключаецца на verbose.

peak

Усталяваць пікавы рэжым(ы).

Даступныя рэжымы можна назапашваць (параметр з'яўляецца flagтыпам). Магчымыя значэнні:

'none'

Адключыць любы пікавы рэжым (па змаўчанні).

'sample'

Уключыце рэжым пікавай выбаркі.

Просты пікавы рэжым шукае больш высокае значэнне выбаркі. Ён рэгіструе паведамленне для піку выбаркі (пазначаецца SPK).

'true'

Уключыць рэжым сапраўднага піку.

Калі ўключана, пошук пікаў выконваецца на версіі ўваходнага патоку з падвышанай выбаркай для лепшай дакладнасці пікаў. Ён рэгіструе паведамленне для праўдзівага піку. (пазначаецца TPK) і сапраўдны пік на кадр (пазначаецца FTPK). Гэты рэжым патрабуе зборкі з libswresample.

dualmono

Разглядайце ўваходныя файлы мона як "двайны мона". Калі монафайл прызначаны для прайгравання на стэрэасістэме, яго вымярэнне EBU R128 будзе няправільным для ўспрымання. Калі ўсталявана true, гэты параметр будзе кампенсаваць гэты эфект. Гэтая опцыя не ўплывае на шматканальныя ўваходныя файлы.

panlaw

Усталюйце пэўны закон панарамавання, які будзе выкарыстоўвацца для вымярэння падвойных монафайлаў. Гэты параметр неабавязковы і мае значэнне па змаўчанні -3,01 дБ.

target

Усталюйце пэўны мэтавы ўзровень (у LUFS), які выкарыстоўваецца ў якасці адноснага нуля ў візуалізацыі. Гэты параметр неабавязковы і мае значэнне па змаўчанні -23LUFS, як вызначана EBU R128. Тым не менш, матэрыялы, апублікаваныя ў Інтэрнэце, могуць аддаваць перавагу ўзроўню -16LUFS (напрыклад, для выкарыстання з падкастамі або відэаплатформамі).

gauge

Усталюйце значэнне, якое паказвае манометр. Дапушчальныя значэнні momentaryі s shortterm. Па змаўчанні будзе выкарыстоўвацца імгненнае значэнне, але ў пэўных сітуацыях можа быць больш карысна назіраць за кароткатэрміновым значэннем (напрыклад, жывое мікшаванне).

scale

Устанаўлівае шкалу адлюстравання для гучнасці. Дапушчальныя параметры absolute (у LUFS) або relative(LU) адносна мэты. Гэта ўплывае толькі на выхад відэа, а не на зводку або бесперапынны вывад часопіса.

16.9.1 Examples

  • Графік у рэжыме рэальнага часу з выкарыстаннем ffplay, з шкалой EBU +18:
    ffplay -f lavfi -i "amovie=input.mp3,ebur128=video=1:meter=18 [out0][out1]"
    
  • Запусціце аналіз з дапамогай ffmpeg:
    ffmpeg -nostats -i input.mp3 -filter_complex ebur128 -f null -
    

16.10 interleave, ainterleave

Часовае чаргаванне кадраў з некалькіх уваходаў.

interleaveпрацуе з відэа ўваходамі, ainterleaveз аўдыё.

Гэтыя фільтры счытваюць кадры з некалькіх уваходаў і адпраўляюць на выхад самы стары кадр у чарзе.

Уваходныя патокі павінны мець дакладна вызначаныя, манатонна ўзрастаючыя значэнні часовых метак кадра.

Каб адправіць адзін кадр на вывад, гэтыя фільтры павінны паставіць у чаргу па меншай меры адзін кадр для кожнага ўваходу, таму яны не могуць працаваць, калі адзін з уваходных дадзеных яшчэ не завершаны і не будзе атрымліваць уваходныя кадры.

Напрыклад, разгледзім выпадак, калі адзін увод з'яўляецца selectфільтрам, які заўсёды выдаляе ўваходныя кадры. Фільтр interleaveбудзе працягваць чытаць з гэтага ўваходу, але ён ніколі не зможа адпраўляць новыя кадры на выхад, пакуль уваход не адправіць сігнал канца патоку.

Акрамя таго, у залежнасці ад сінхранізацыі уваходаў, фільтры будуць адкідваць кадры ў выпадку, калі адзін уваход атрымлівае больш кадраў, чым іншыя, і чарга ўжо запоўнена.

Гэтыя фільтры прымаюць наступныя параметры:

nb_inputs, n

Усталюйце колькасць розных уваходаў, па змаўчанні 2.

duration

Як вызначыць канец патоку.

longest

Працягласць самага доўгага ўводу. (па змаўчанні)

shortest

Працягласць самага кароткага ўводу.

first

Працягласць першага ўваходу.

16.10.1 Examples

  • Перамяжоўвайце кадры, якія належаць да розных патокаў, выкарыстоўваючы ffmpeg:
    ffmpeg -i bambi.avi -i pr0n.mkv -filter_complex "[0:v][1:v] interleave" out.avi
    
  • Дадайце эфект мігатлівага размыцця:
    select='if(gt(random(0), 0.2), 1, 2)':n=2 [tmp], boxblur=2:2, [tmp] interleave
    

16.11 latency, alatency

Вымерайце затрымку фільтрацыі.

Паведаміць пра затрымку папярэдняй фільтрацыі фільтра, затрымку ў колькасці выбарак аўдыя для аўдыяфільтраў або колькасці відэакадраў для відэафільтраў.

У канцы ўваходнага патоку фільтр паведаміць мінімальную і максімальную вымераную затрымку для папярэдняга запушчанага фільтра ў графіку фільтра.

16.12 metadata, ametadata

Маніпуляваць метаданымі фрэйма.

Гэты фільтр прымае наступныя параметры:

mode

Задайце рэжым працы фільтра.

Можа быць адно з наступнага:

'select'

Калі ўсталяваны абодва valueі key, выбірайце кадры, якія маюць такія метададзеныя. Калі keyўстаноўлена толькі, выбіраць кожны кадр, які мае такі ключ у метададзеных.

'add'

Дадайце новыя метададзеныя keyі value. Калі ключ ужо даступны, нічога не рабіць.

'modify'

Змяніць значэнне ўжо існуючага ключа.

'delete'

Калі valueўстаноўлена, выдаляць толькі ключы, якія маюць такое значэнне. У адваротным выпадку выдаліце ​​ключ. Калі keyне ўстаноўлена, выдаліць усе значэнні метаданых у кадры.

'print'

Ключ друку і яго значэнне, калі метаданыя знойдзены. Калі keyне ўстаноўлена, друкаваць усе значэнні метададзеных, даступныя ў кадры.

key

Усталяваць ключ, які выкарыстоўваецца ва ўсіх рэжымах. Павінен быць усталяваны для ўсіх рэжымаў, акрамя printі delete.

value

Усталюйце значэнне метаданых, якое будзе выкарыстоўвацца. Гэтая опцыя з'яўляецца абавязковай для рэжыму modifyі .add

function

Якую функцыю выкарыстоўваць пры параўнанні значэння метададзеных іvalue .

Можа быць адно з наступнага:

'same_str'

Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых супадае з value.

'starts_with'

Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых пачынаецца з valueрадка параметра.

'less'

Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі значэнне метаданых меншае за value.

'equal'

Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі valueроўна значэнню метаданых.

'greater'

Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі значэнне метаданых большае за value.

'expr'

Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі выраз з опцыіexpr ісціна.

'ends_with'

Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых заканчваецца valueрадком опцыі.

expr

Усталяваць выраз, які выкарыстоўваецца, калі functionўстаноўлена expr. Выраз вылічваецца праз eval API і можа ўтрымліваць наступныя канстанты:

VALUE1, FRAMEVAL

Плаваючае прадстаўленне valueз ключа метададзеных.

VALUE2, USERVAL

Прадстаўленне з плаваючай часткай value, якое падаецца карыстальнікам у valueопцыі.

file

Калі паказана ў printрэжыме, вывад запісваецца ў названы файл. Замест простага імя файла можа быць указаны любы URL-адрас, які можна запісваць. Імя файла «-» з'яўляецца скарачэннем для стандартнага вываду. Калі fileпараметр не ўсталяваны, вывад запісваецца ў журнал з узроўнем часопіса AV_LOG_INFO.

direct

Памяншае буферызацыю ў рэжыме друку, калі вывад запісваецца ў URL, усталяваны з дапамогай file.

16.12.1 Examples

  • Раздрукаваць усе значэнні метаданых для фрэймаў з ключом lavfi.signalstats.YDIFса значэннямі ад 0 да 1.
    signalstats,metadata=print:key=lavfi.signalstats.YDIF:value=0:function=expr:expr='between(VALUE1,0,1)'
    
  • Раздрукаваць выхад silencedetect у файлmetadata.txt.
    silencedetect,ametadata=mode=print:file=metadata.txt
    
  • Накіруйце ўсе метададзеныя ў канал з дэскрыптарам файла 4.
    metadata=mode=print:file='pipe\:4'
    

16.13 perms, aperms

Усталюйце дазволы на чытанне/запіс для выходных кадраў.

Гэтыя фільтры ў асноўным прызначаны для распрацоўшчыкаў для праверкі прамога шляху ў наступным фільтры на графіку фільтраў.

Фільтры прымаюць наступныя параметры:

mode

Выберыце рэжым дазволаў.

Ён прымае наступныя значэнні:

'none'

Нічога не рабіць. Гэта па змаўчанні.

'ro'

Усталюйце ўсе выходныя кадры ў рэжыме толькі для чытання.

'rw'

Усталяваць усе выходныя кадры для прамога запісу.

'toggle'

Зрабіць фрэйм ​​толькі для чытання, калі ён даступны для запісу, і для запісу, калі ён даступны толькі для чытання.

'random'

Выпадковым чынам усталюйце кожны выхадны кадр толькі для чытання або запісу.

seed

Усталюйце пачатковы код для randomрэжыму, павінен быць цэлым лікам паміж 0і UINT32_MAX. Калі не пазначана або яўна ўстаноўлена значэнне -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.

Заўвага: у выпадку аўтаматычнай устаўкі фільтра паміж фільтрам дазволаў і наступным, дазвол можа быць не атрыманы, як чакалася, у наступным фільтры. Устаўка фармату або фільтра афармата перад фільтрам perms/aperms можа пазбегнуць гэтай праблемы.

16.14 realtime, arealtime

Запавольце фільтраванне, каб прыблізна адпавядаць рэжыму рэальнага часу.

Гэтыя фільтры будуць прыпыняць фільтрацыю на розны час, каб супаставіць хуткасць вываду з пазнакамі часу ўводу. Яны падобныя наreварыянт для ffmpeg.

Яны прымаюць наступныя варыянты:

limit

Абмежаванне часу на паўзы. Любая паўза больш працяглая будзе лічыцца разрывам часовай меткі і скідаць таймер. Па змаўчанні 2 секунды.

speed

Каэфіцыент хуткасці апрацоўкі. Значэнне павінна быць большым за нуль. Значэнні, большыя за 1,0, прывядуць да апрацоўкі хутчэй, чым у рэальным часе, а меншыя - запавольваюць апрацоўку. limitАўтаматычна адаптуецца адпаведна . Па змаўчанні 1.0.

Хуткасць апрацоўкі вышэй, чым магчымая без гэтых фільтраў, немагчымая.

16.14.1 Commands

Абодва фільтры падтрымліваюць усе вышэйпералічаныя параметры ў якасці каманд .

16.15 segment, asegment

Падзяленне аднаго ўваходнага патоку на некалькі патокаў.

Гэты фільтр робіць супрацьлегласць фільтрам concat.

segmentпрацуе на відэакадрах, asegmentна аўдыёсэмплах.

Гэты фільтр прымае наступныя параметры:

timestamps

Пазнакі часу выходных сегментаў, падзеленыя знакам '|'. Першы сегмент будзе запускацца з пачатку ўваходнага патоку. Апошні сегмент будзе працаваць да канца ўваходнага патоку

frames, samples

Дакладная колькасць кадраў/узораў для падзелу сегментаў.

Ва ўсіх выпадках, калі да кожнага сегмента дадаецца прэфікс "+", ён будзе адносіцца да папярэдняга сегмента.

16.15.1 Examples

  • Падзяліць уваходны аўдыяпаток на тры выходныя аўдыяпатокі, пачынаючы з пачатку ўваходнага аўдыяпатоку і захоўваючы яго ў 1-м выхадным аўдыяпатоку, затым пасля 60-й секунды і захоўваючы, чым у 2-м выхадным аўдыяпатоку, і апошнім пасля 150-й секунды ўваходнага аўдыяпатоку. у 3-м выхадным аўдыяструмені:
    asegment=timestamps="60|150"
    

16.16 select, aselect

Выберыце кадры для перадачы ў вывад.

Гэты фільтр прымае наступныя параметры:

expr, e

Задаць выраз, які вылічваецца для кожнага ўваходнага кадра.

Калі выраз дае нуль, фрэйм ​​адкідаецца.

Калі вынік ацэнкі адмоўны або NaN, кадр адпраўляецца на першы выхад; у адваротным выпадку ён адпраўляецца на выхад з індэксам ceil(val)-1, мяркуючы, што ўваходны індэкс пачынаецца з 0.

Напрыклад, значэнне 1.2адпавядае выхаду з індэксам ceil(1.2)-1 = 2-1 = 1, гэта значыць другому выхаду.

outputs, n

Усталюйце колькасць выхадаў. Выхад, куды трэба адправіць выбраны кадр, заснаваны на выніку ацэнкі. Значэнне па змаўчанні - 1.

Выраз можа ўтрымліваць наступныя канстанты:

n

(Парадкавы) нумар адфільтраванага кадра, пачынаючы з 0.

selected_n

(Парадкавы) нумар абранага кадра, пачынаючы з 0.

prev_selected_n

Парадкавы нумар апошняга выбранага кадра. Гэта NAN, калі не вызначана.

TB

Часовая база для ўведзеных часавых пазнак.

pts

PTS (TimeStamp прэзентацыі) адфільтраванага кадра, выражаны ў TBадзінках. Гэта NAN, калі не вызначана.

t

PTS адфільтраванага кадра, выражаны ў секундах. Гэта NAN, калі не вызначана.

prev_pts

PTS раней адфільтраванага кадра. Гэта NAN, калі не вызначана.

prev_selected_pts

PTS апошняга раней адфільтраванага кадра. Гэта NAN, калі не вызначана.

prev_selected_t

PTS апошняга раней выбранага кадра, выражаны ў секундах. Гэта NAN, калі не вызначана.

start_pts

Першы PTS у патоку, які не з'яўляецца NAN. Ён застаецца NAN, калі не знойдзены.

start_t

Першы PTS, у секундах, у патоку, які не з'яўляецца NAN. Ён застаецца NAN, калі не знойдзены.

pict_type (video only)

Тып кадра з фільтрам. Ён можа прымаць адно з наступных значэнняў:

I
P
B
S
SI
SP
BI
interlace_type (video only)

Тып перапляцення кадраў. Ён можа прымаць адно з наступных значэнняў:

PROGRESSIVE

Кадр прагрэсіўны (не празрадковы).

TOPFIRST

Рама верхняе поле наперад.

BOTTOMFIRST

Рамка ніжнім полем.

consumed_sample_n (audio only)

колькасць выбраных выбарак перад бягучым кадрам

samples_n (audio only)

колькасць узораў у бягучым кадры

sample_rate (audio only)

частата дыскрэтызацыі ўводу

key

Гэта 1, калі адфільтраваны кадр з'яўляецца ключавым, 0 у адваротным выпадку.

pos

пазіцыя ў файле адфільтраванага кадра, -1, калі інфармацыя недаступная (напрыклад, для сінтэтычнага відэа)

scene (video only)

значэнне ад 0 да 1 для абазначэння новай сцэны; нізкае значэнне адлюстроўвае нізкую верагоднасць для бягучага кадра ўвесці новую сцэну, у той час як больш высокае значэнне азначае, што бягучы кадр, хутчэй за ўсё, будзе адным (гл. прыклад ніжэй)

concatdec_select

Дэмультыфікатар concat можа выбраць толькі частку ўваходнага файла concat, усталяваўшы ўваходную і выходную кропку, але выходныя пакеты могуць не цалкам утрымлівацца ў абраным інтэрвале. Выкарыстоўваючы гэту зменную, можна прапускаць кадры, згенераваныя дэмультыфікатарам concat, якія дакладна не ўтрымліваюцца ў абраным інтэрвале.

Гэта працуе шляхам параўнання пунктаў кадра са lavf.concat.start_time значэннямі lavf.concat.durationметададзеных пакета, якія таксама прысутнічаюць у дэкадзіраваных кадрах.

Пераменная роўная -1 , concatdec_selectкалі кропка кадра роўна меншай за час_пачатку і альбо адсутнічаюць метаданыя працягласці, альбо кропка кадра меншая за час_пачатку + працягласць, у адваротным выпадку 0, і NaN, калі метаданыя пра час_пачатку адсутнічаюць.

У асноўным гэта азначае, што ўваходны кадр выбіраецца, калі яго кропкі знаходзяцца ў межах інтэрвалу, устаноўленага дэмультыфікатарам concat.

Значэнне выразу выбару па змаўчанні - "1".

16.16.1 Examples

  • Выберыце ўсе кадры ва ўводзе:
    select
    

    Прыклад вышэй такі ж, як:

    select=1
    
  • Прапусціць усе кадры:
    select=0
    
  • Выберыце толькі I-фреймы:
    select='eq(pict_type\,I)'
    
  • Выберыце адзін кадр на кожныя 100:
    select='not(mod(n\,100))'
    
  • Выберыце толькі кадры, якія змяшчаюцца ў інтэрвале часу 10-20:
    select=between(t\,10\,20)
    
  • Выберыце толькі I-кадры, якія змяшчаюцца ў інтэрвале часу 10-20:
    select=between(t\,10\,20)*eq(pict_type\,I)
    
  • Выберыце кадры з мінімальнай адлегласцю 10 секунд:
    select='isnan(prev_selected_t)+gte(t-prev_selected_t\,10)'
    
  • Выкарыстоўвайце aselect, каб выбраць толькі аўдыякадры з колькасцю сэмплоў > 100:
    aselect='gt(samples_n\,100)'
    
  • Стварыце мазаіку з першых сцэн:
    ffmpeg -i video.avi -vf select='gt(scene\,0.4)',scale=160:120,tile -frames:v 1 preview.png
    

    Параўнанне sceneса значэннем ад 0,3 да 0,5, як правіла, разумны выбар.

  • Адпраўляйце цотныя і няцотныя кадры на асобныя выхады і складайце іх:
    select=n=2:e='mod(n, 2)+1' [odd][even]; [odd] pad=h=2*ih [tmp]; [tmp][even] overlay=y=h
    
  • Выберыце карысныя кадры з файла ffconcat, які выкарыстоўвае кропкі ўваходу і выхаду, але дзе зыходныя файлы з'яўляюцца не толькі ўнутры кадра.
    ffmpeg -copyts -vsync 0 -segment_time_metadata 1 -i input.ffconcat -vf select=concatdec_select -af aselect=concatdec_select output.avi
    

16.17 sendcmd, asendcmd

Адпраўляйце каманды фільтрам у графе фільтраў.

Гэтыя фільтры счытваюць каманды для адпраўкі іншым фільтрам у графе фільтраў.

sendcmdпавінны быць устаўлены паміж двума відэафільтрамі, asendcmdпавінны быць устаўлены паміж двума аўдыяфільтрамі, але, акрамя гэтага, яны дзейнічаюць аднолькава.

Спецыфікацыя каманд можа быць прадстаўлена ў аргументах фільтра з commandsопцыяй або ў файле, вызначаным filenameопцыяй.

Гэтыя фільтры прымаюць наступныя параметры:

commands, c

Усталюйце каманды для чытання і адпраўкі іншым фільтрам.

filename, f

Усталюйце імя файла каманд, якія будуць счытвацца і адпраўляцца іншым фільтрам.

16.17.1 Commands syntax

Апісанне каманд складаецца з паслядоўнасці спецыфікацый інтэрвалу, якая змяшчае спіс каманд, якія павінны быць выкананы, калі адбываецца пэўная падзея, звязаная з гэтым інтэрвалам. Падзея, якая адбываецца, звычайна з'яўляецца бягучым часам кадра, які ўваходзіць або пакідае зададзены інтэрвал часу.

Інтэрвал задаецца наступным сінтаксісам:

START[-END] COMMANDS;

Прамежак часу вызначаецца STARTі ENDчасамі. ENDнеабавязковы і па змаўчанні максімальны час.

Бягучы час кадра лічыцца ў вызначаным інтэрвале, калі ён уключаны ў інтэрвал [ START, END), гэта значыць калі час большы або роўны STARTі меншы за END.

COMMANDSскладаецца з паслядоўнасці адной або некалькіх спецыфікацый каманды, падзеленых знакам ",", якія адносяцца да гэтага інтэрвалу. Сінтаксіс спецыфікацыі каманды задаецца наступным чынам:

[FLAGS] TARGET COMMAND ARG

FLAGSне з'яўляецца абавязковым і вызначае тып падзей, звязаных з інтэрвалам часу, якія дазваляюць адправіць азначаную каманду, і павінна быць ненулявой паслядоўнасцю сцягоў ідэнтыфікатараў, падзеленых знакамі "+" ці "|" і заключаны паміж "[" і "]".

Распазнаюцца наступныя сцягі:

enter

Каманда адпраўляецца, калі пазнака часу бягучага кадра ўваходзіць у вызначаны інтэрвал. Іншымі словамі, каманда адпраўляецца, калі пазнака часу папярэдняга кадра не была ў зададзеным інтэрвале, а бягучая -.

leave

Каманда адпраўляецца, калі пазнака часу бягучага кадра пакідае зададзены інтэрвал. Іншымі словамі, каманда адпраўляецца, калі пазнака часу папярэдняга кадра была ў зададзеным інтэрвале, а бягучая - не.

expr

Каманда ARGінтэрпрэтуецца як выраз, а вынік выразу перадаецца як ARG.

Выраз вылічваецца праз API eval і можа ўтрымліваць наступныя канстанты:

POS

Зыходная пазіцыя ў файле кадра або нявызначаная, калі не вызначана для бягучага кадра.

PTS

Пазнака часу прэзентацыі ва ўваходных дадзеных.

N

Колькасць уваходных кадраў для відэа ці аўдыя, пачынаючы з 0.

T

Час у секундах бягучага кадра.

TS

Час пачатку ў секундах бягучага інтэрвалу каманды.

TE

Час заканчэння ў секундах бягучага інтэрвалу каманды.

TI

Інтэрпаляваны час бягучага інтэрвалу каманды, TI = (T - TS) / (TE - TS).

W

Шырыня кадра відэа.

H

Вышыня кадра відэа.

Калі FLAGSне вызначана, [enter]прымаецца значэнне па змаўчанні.

TARGETзадае мэту каманды, звычайна імя класа фільтра або імя канкрэтнага асобніка фільтра.

COMMANDзадае назву каманды для мэтавага фільтра.

ARGне з'яўляецца абавязковым і вызначае неабавязковы спіс аргументаў для дадзенага COMMAND.

Паміж адной спецыфікацыяй інтэрвалу і другой прабелы або паслядоўнасці сімвалаў, якія пачынаюцца з і #да канца радка, ігнаруюцца і могуць выкарыстоўвацца для анатавання каментарыяў.

Спрошчанае апісанне BNF сінтаксісу спецыфікацыі каманд наступнае:

COMMAND_FLAG  ::= "enter" | "leave"
COMMAND_FLAGS ::= COMMAND_FLAG [(+|"|")COMMAND_FLAG]
COMMAND       ::= ["[" COMMAND_FLAGS "]"] TARGET COMMAND [ARG]
COMMANDS      ::= COMMAND [,COMMANDS]
INTERVAL      ::= START[-END] COMMANDS
INTERVALS     ::= INTERVAL[;INTERVALS]

16.17.2 Examples

  • Укажыце змяненне тэмпу гуку на 4-й секундзе:
    asendcmd=c='4.0 atempo tempo 1.5',atempo
    
  • Нацэліцеся на пэўны асобнік фільтра:
    asendcmd=c='4.0 atempo@my tempo 1.5',atempo@my
    
  • Укажыце спіс каманд для маляванага тэксту і адцення ў файле.
    # show text in the interval 5-10
    5.0-10.0 [enter] drawtext reinit 'fontfile=FreeSerif.ttf:text=hello world',
             [leave] drawtext reinit 'fontfile=FreeSerif.ttf:text=';
    
    # desaturate the image in the interval 15-20
    15.0-20.0 [enter] hue s 0,
              [enter] drawtext reinit 'fontfile=FreeSerif.ttf:text=nocolor',
              [leave] hue s 1,
              [leave] drawtext reinit 'fontfile=FreeSerif.ttf:text=color';
    
    # apply an exponential saturation fade-out effect, starting from time 25
    25 [enter] hue s exp(25-t)
    

    Граф фільтра, які дазваляе чытаць і апрацоўваць прыведзены вышэй спіс каманд, захаваны ў файлеtest.cmd, можа быць указана з дапамогай:

    sendcmd=f=test.cmd,drawtext=fontfile=FreeSerif.ttf:text='',hue
    

16.18 setpts, asetpts

Зменіце PTS (пазнаку часу прэзентацыі) уваходных кадраў.

setptsпрацуе на відэакадрах, asetptsна аўдыякадрах.

Гэты фільтр прымае наступныя параметры:

expr

Выраз, які вылічваецца для кожнага кадра, каб стварыць яго метку часу.

Выраз вылічваецца праз API eval і можа ўтрымліваць наступныя канстанты:

FRAME_RATE, FR

частата кадраў, вызначаная толькі для відэа з пастаяннай частатой кадраў

PTS

Пазнака часу прэзентацыі ва ўваходных дадзеных

N

Колькасць уваходнага кадра для відэа або колькасць спажытых выбарак, не уключаючы бягучы кадр для аўдыя, пачынаючы з 0.

NB_CONSUMED_SAMPLES

Колькасць спажытых сэмплоў, не уключаючы бягучы кадр (толькі аўдыя)

NB_SAMPLES, S

Колькасць узораў у бягучым кадры (толькі аўдыё)

SAMPLE_RATE, SR

Частата дыскрэтызацыі гуку.

STARTPTS

ПТС першага кадра.

STARTT

час у секундах першага кадра

INTERLACED

Укажыце, ці з'яўляецца бягучы кадр празрадковым.

T

час у секундах бягучага кадра

POS

зыходная пазіцыя ў файле кадра, або нявызначаная, калі не вызначана для бягучага кадра

PREV_INPTS

Папярэдні ўваход ПТС.

PREV_INT

час папярэдняга ўводу ў секундах

PREV_OUTPTS

Папярэдні выхад ПТС.

PREV_OUTT

папярэдні час вываду ў секундах

RTCTIME

Час насценнага гадзінніка (RTC) у мікрасекундах. Гэта састарэла, замест гэтага выкарыстоўвайце час (0).

RTCSTART

Час насценнага гадзінніка (RTC) у пачатку фільма ў мікрасекундах.

TB

Часовая база для ўведзеных часавых пазнак.

16.18.1 Examples

  • Пачніце адлік ВТС з нуля
    setpts=PTS-STARTPTS
    
  • Прымяніць эфект хуткага руху:
    setpts=0.5*PTS
    
  • Прымяніць эфект запаволенага руху:
    setpts=2.0*PTS
    
  • Усталюйце фіксаваную частату 25 кадраў у секунду:
    setpts=N/(25*TB)
    
  • Усталюйце фіксаваную хуткасць 25 кадраў у секунду з некаторым дрыгаценнем:
    setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
    
  • Прымяніць зрушэнне ў 10 секунд да PTS уводу:
    setpts=PTS+10/TB
    
  • Стварыць часовыя пазнакі з "жывой крыніцы" і перабазіраваць на бягучую часовую базу:
    setpts='(RTCTIME - RTCSTART) / (TB * 1000000)'
    
  • Стварыце пазнакі часу шляхам падліку выбарак:
    asetpts=N/SR/TB
    

16.19 setrange

Прымусовы каляровы дыяпазон для выхаднога відэакадра.

Фільтр setrangeпазначае ўласцівасць каляровага дыяпазону для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра наступнымі фільтрамі.

Фільтр прымае наступныя параметры:

range

Даступныя значэнні:

'auto'

Захоўвайце аднолькавую ўласцівасць каляровага дыяпазону.

'unspecified, unknown'

Усталюйце дыяпазон колераў як нявызначаны.

'limited, tv, mpeg'

Усталюйце абмежаваны дыяпазон колераў.

'full, pc, jpeg'

Усталюйце каляровы дыяпазон як поўны.

16.20 settb, asettb

Усталюйце часовую базу, якая будзе выкарыстоўвацца для часовых пазнак выхадных кадраў. Гэта ў асноўным карысна для тэсціравання канфігурацыі часавай базы.

Ён прымае наступныя параметры:

expr, tb

Выраз, які вылічваецца ў часавай базе вываду.

Значэнне дляtbгэта арыфметычны выраз, які прадстаўляе рацыянальнае. Выраз можа ўтрымліваць канстанты "AVTB" (па змаўчанні развага), "intb" (уваходная развага) і "sr" (частата дыскрэтызацыі, толькі гук). Значэнне па змаўчанні - "intb".

16.20.1 Examples

  • Усталюйце часовую базу на 1/25:
    settb=expr=1/25
    
  • Усталюйце часовую базу на 1/10:
    settb=expr=0.1
    
  • Усталюйце часовую базу 1001/1000:
    settb=1+0.001
    
  • Усталюйце часовую базу 2*intb:
    settb=2*intb
    
  • Усталюйце значэнне разгорткі па змаўчанні:
    settb=AVTB
    

16.21 showcqt

Пераўтварыце ўваходны аўдыё ў відэавыхад, які прадстаўляе частотны спектр лагарыфмічна з дапамогай алгарытму пераўтварэння пастаяннай Q Браўна-Пакетта з прамым вылічэннем каэфіцыента ў частотнай вобласці (але само пераўтварэнне насамрэч не з'яўляецца пастаянным Q, замест гэтага каэфіцыент Q на самай справе зменны/заціснуты), з музычным тонам шкала, ад E0 да D#10.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Яно павінна быць роўным. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 1920x1080.

fps, rate, r

Усталюйце выходную частату кадраў. Значэнне па змаўчанні - 25.

bar_h

Усталюйце вышыню гістаграмы. Яно павінна быць роўным. Значэнне па змаўчанні -1аўтаматычна вылічае вышыню гістаграмы.

axis_h

Усталюйце вышыню восі. Яно павінна быць роўным. Значэнне па змаўчанні -1аўтаматычна вылічвае вышыню восі.

sono_h

Усталюйце вышыню сонаграмы. Яно павінна быць роўным. Значэнне па змаўчанні - гэта -1аўтаматычнае вылічэнне вышыні сонаграмы.

fullhd

Усталюйце дазвол fullhd. Гэты параметр састарэў, выкарыстоўвайце sizeзамест s яго. Значэнне па змаўчанні - 1.

sono_v, volume

Укажыце выраз аб'ёму сонаграмы. Ён можа ўтрымліваць зменныя:

bar_v

ацэньваемы bar_vвыраз

frequency, freq, f

частата, дзе яна ацэньваецца

timeclamp, tc

значэнне timeclampапцыёна

і функцыі:

a_weighting(f)

А-ўзважванне роўнай гучнасці

b_weighting(f)

B-ўзважванне роўнай гучнасці

c_weighting(f)

C-узважванне роўнай гучнасці.

Значэнне па змаўчанні - 16.

bar_v, volume2

Укажыце выраз аб'ёму гістаграмы. Ён можа ўтрымліваць зменныя:

sono_v

ацэньваемы sono_vвыраз

frequency, freq, f

частата, дзе яна ацэньваецца

timeclamp, tc

значэнне timeclampапцыёна

і функцыі:

a_weighting(f)

А-ўзважванне роўнай гучнасці

b_weighting(f)

B-ўзважванне роўнай гучнасці

c_weighting(f)

C-узважванне роўнай гучнасці.

Значэнне па змаўчанні - sono_v.

sono_g, gamma

Укажыце гаму сонограммы. Больш нізкая гама робіць спектр больш кантрасным, больш высокая гама робіць спектр больш шырокім дыяпазонам. Значэнне па змаўчанні - 3. Дапушчальны дыяпазон [1, 7].

bar_g, gamma2

Укажыце гаму гістаграмы. Значэнне па змаўчанні - 1. Дапушчальны дыяпазон [1, 7].

bar_t

Укажыце ўзровень празрыстасці гістаграмы. Меншае значэнне робіць гістаграму больш рэзкай. Значэнне па змаўчанні - 1. Дапушчальны дыяпазон [0, 1].

timeclamp, tc

Укажыце фіксатар часу пераўтварэння. Пры нізкай частаце існуе кампраміс паміж дакладнасцю ў часавай і частотнай вобласці. Калі заціск меншы, падзея ў часовай вобласці адлюстроўваецца больш дакладна (напрыклад, хуткі бас-барабан), у адваротным выпадку падзея ў частотнай вобласці прадстаўляецца больш дакладна (напрыклад, бас-гітара). Дапушчальны дыяпазон [0.002, 1]. Значэнне па змаўчанні - 0.17.

attack

Усталюйце час атакі ў секундах. Па змаўчанні 0(выключана). У адваротным выпадку гэта абмяжоўвае будучыя выбаркі шляхам прымянення асіметрычнага аконнага афармлення ў часовай вобласці, што карысна, калі патрабуецца нізкая затрымка. Дапушчальны дыяпазон [0, 1].

basefreq

Укажыце базавую частату пераўтварэння. Значэнне па змаўчанні - 20.01523126408007475гэта частата на 50 цэнтаў ніжэй за E0. Дапушчальны дыяпазон [10, 100000].

endfreq

Укажыце канчатковую частату пераўтварэння. Значэнне па змаўчанні - 20495.59681441799654гэта частата на 50 цэнтаў вышэй D#10. Дапушчальны дыяпазон [10, 100000].

coeffclamp

Гэты параметр састарэў і ігнаруецца.

tlength

Укажыце даўжыню пераўтварэння ў часовай вобласці. Выкарыстоўвайце гэты параметр, каб кантраляваць кампраміс дакладнасці паміж часовай вобласцю і частотнай вобласцю на кожнай частотнай выбарцы. Ён можа ўтрымліваць зменныя:

frequency, freq, f

частата, дзе яна ацэньваецца

timeclamp, tc

значэнне timeclampапцыёна.

Значэнне па змаўчанні - 384*tc/(384+tc*f).

count

Укажыце колькасць пераўтварэнняў для кожнага відэакадра. Значэнне па змаўчанні - 6. Дапушчальны дыяпазон [1, 30].

fcount

Укажыце колькасць пераўтварэнняў для кожнага пікселя. Значэнне па змаўчанні - гэта значыць 0, што ён вылічваецца аўтаматычна. Дапушчальны дыяпазон [0, 10].

fontfile

Укажыце файл шрыфта для выкарыстання з FreeType для малявання восі. Калі не пазначана, выкарыстоўваць убудаваны шрыфт. Звярніце ўвагу, што маляванне з файлам шрыфтоў або ўбудаваным шрыфтам не рэалізавана з карыстальніцкім basefreqі endfreq, замест гэтага выкарыстоўвайце axisfile параметр.

font

Укажыце шаблон fontconfig. Гэта мае больш нізкі прыярытэт, чым fontfile. У :шаблоне можна замяніць на, |каб пазбегнуць непатрэбнага экраніравання.

fontcolor

Укажыце колер шрыфта. Гэта арыфметычны выраз, які павінен вяртаць цэлае значэнне 0xRRGGBB. Ён можа ўтрымліваць зменныя:

frequency, freq, f

частата, дзе яна ацэньваецца

timeclamp, tc

значэнне timeclampапцыёна

і функцыі:

midi(f)

нумар midi частаты f, некаторыя нумары midi: E0(16), C1(24), C2(36), A4(69)

r(x), g(x), b(x)

чырвонае, зялёнае і сіняе значэнне інтэнсіўнасці х.

Значэнне па змаўчанні - st(0, (midi(f)-59.5)/12); st(1, if(between(ld(0),0,1), 0.5-0.5*cos(2*PI*ld(0)), 0)); r(1-ld(1)) + b(ld(1)).

axisfile

Укажыце файл відарыса для малявання восі. Гэтая опцыя перавызначае fontfileі fontcolorопцыю.

axis, text

Уключыць/выключыць малюнак тэксту да восі. Калі ён усталяваны ў 0, маляванне да восі адключана, ігнаруючы опцыю fontfileі . axisfileЗначэнне па змаўчанні - 1.

csp

Задаць каляровую прастору. Дапушчальныя значэнні:

'unspecified'

Не вызначана (па змаўчанні)

'bt709'

BT.709

'fcc'

FCC

'bt470bg'

BT.470BG або BT.601-6 625

'smpte170m'

SMPTE-170M або BT.601-6 525

'smpte240m'

СМПТЭ-240М

'bt2020ncl'

BT.2020 з непастаяннай яркасцю

cscheme

Задаць каляровую схему спектраграмы. Гэта спіс значэнняў з плаваючай коскай у фармаце left_r|left_g|left_b|right_r|right_g|right_b. Па змаўчанні - 1|0.5|0|0|0.5|1.

16.21.1 Examples

  • Прайграванне аўдыё падчас паказу спектру:
    ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt [out0]'
    
  • Тое самае, што і вышэй, але з частатой кадраў 30 кадраў у секунду:
    ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt=fps=30:count=5 [out0]'
    
  • Прайграванне ў 1280x720:
    ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt=s=1280x720:count=4 [out0]'
    
  • Адключыць адлюстраванне сонаграмы:
    sono_h=0
    
  • A1 і яго гармонікі: A1, A2, (каля) E3, A3:
    ffplay -f lavfi 'aevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t),
                     asplit[a][out1]; [a] showcqt [out0]'
    
  • Тое самае, што і вышэй, але з большай дакладнасцю ў частотнай вобласці:
    ffplay -f lavfi 'aevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t),
                     asplit[a][out1]; [a] showcqt=timeclamp=0.5 [out0]'
    
  • Карыстальніцкі аб'ём:
    bar_v=10:sono_v=bar_v*a_weighting(f)
    
  • Карыстальніцкая гама, цяпер спектр лінейны па амплітудзе.
    bar_g=2:sono_g=2
    
  • Карыстальніцкае ўраўненне даўжыні:
    tc=0.33:tlength='st(0,0.17); 384*tc / (384 / ld(0) + tc*f /(1-ld(0))) + 384*tc / (tc*f / ld(0) + 384 /(1-ld(0)))'
    
  • Карыстальніцкі колер шрыфта і файл шрыфта, C-note афарбаваны ў зялёны колер, іншыя афарбаваны ў сіні:
    fontcolor='if(mod(floor(midi(f)+0.5),12), 0x0000FF, g(1))':fontfile=myfont.ttf
    
  • Карыстальніцкі шрыфт з дапамогай fontconfig:
    font='Courier New,Monospace,mono|bold'
    
  • Карыстальніцкі дыяпазон частот з карыстацкай воссю з дапамогай файла выявы:
    axisfile=myaxis.png:basefreq=40:endfreq=10000
    

16.22 showfreqs

Пераўтварэнне ўваходнага аўдыё ў відэавыход, які прадстаўляе спектр магутнасці гуку. Амплітуда гуку знаходзіцца па восі Y, а частата - па восі X.

Фільтр прымае наступныя параметры:

size, s

Пазначце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Па змаўчанні 1024x512.

rate, r

Задаць хуткасць відэа. Па змаўчанні 25.

mode

Усталюйце рэжым адлюстравання. Гэта вызначае, як будзе прадстаўлены кожны дыяпазон частот.

Ён прымае наступныя значэнні:

'line'
'bar'
'dot'

Па змаўчанні bar.

ascale

Усталюйце шкалу амплітуды.

Ён прымае наступныя значэнні:

'lin'

Лінейны маштаб.

'sqrt'

Шкала квадратнага кораня.

'cbrt'

Кубічны корань шкалы.

'log'

Лагарыфмічная шкала.

Па змаўчанні log.

fscale

Усталюйце шкалу частот.

Ён прымае наступныя значэнні:

'lin'

Лінейны маштаб.

'log'

Лагарыфмічная шкала.

'rlog'

Зваротная лагарыфмічная шкала.

Па змаўчанні lin.

win_size

Усталюйце памер акна. Дазволены дыяпазон ад 16 да 65536.

Па змаўчанні2048

win_func

Усталяваць функцыю акон.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Па змаўчанні hanning.

overlap

Усталюйце перакрыцце вокнаў. У дыяпазоне [0, 1]. Па змаўчанні ўстаноўлена 1, што азначае, што будзе выбрана аптымальнае перакрыцце для выбранай функцыі акна.

averaging

Усталюйце асерадненне часу. Усталяванне гэтага значэння ў 0 будзе адлюстроўваць бягучыя максімальныя пікі. Па змаўчанні ўстаноўлена 1, што азначае, што асерадненне часу адключана.

colors

Укажыце спіс колераў, падзеленых прабелам або знакам '|' які будзе выкарыстоўвацца для малявання частот каналаў. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.

cmode

Усталюйце рэжым адлюстравання канала.

Ён прымае наступныя значэнні:

'combined'
'separate'

Па змаўчанні combined.

minamp

Усталюйце мінімальную амплітуду, якая выкарыстоўваецца ў logшкаляры амплітуды.

data

Усталюйце рэжым адлюстравання даных.

Ён прымае наступныя значэнні:

'magnitude'
'phase'
'delay'

Па змаўчанні magnitude.

channels

Усталюйце каналы для выкарыстання пры апрацоўцы аўдыя. Па змаўчанні ўсе апрацоўваюцца.

16.23 showspatial

Пераўтварэнне уваходнага стэрэа аўдыё ў відэавыхад, прадстаўляючы прасторавыя адносіны паміж двума каналамі.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 512x512.

win_size

Усталюйце памер акна. Дазволены дыяпазон ад 1024да 65536. Памер па змаўчанні 4096.

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann'
'hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Значэнне па змаўчанні - hann.

overlap

Задайце каэфіцыент перакрыцця акна. Значэнне па змаўчанні - 0.5. Калі значэнне 1перакрываецца, усталяваны рэкамендаваны памер для пэўнай функцыі акна, якая выкарыстоўваецца ў цяперашні час.

16.24 showspectrum

Пераўтварэнне ўваходнага аўдыё ў відэавыхад, які прадстаўляе частотны спектр гуку.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 640x512.

slide

Укажыце, як спектр павінен слізгаць па акне.

Ён прымае наступныя значэнні:

'replace'

ўзоры пачынаюцца зноў злева, калі яны дасягаюць правага

'scroll'

ўзоры пракручваюцца справа налева

'fullframe'

кадры вырабляюцца толькі тады, калі ўзоры дасягаюць права

'rscroll'

ўзоры пракручваюцца злева направа

'lreplace'

ўзоры зноў пачынаюцца справа, калі яны дасягаюць левага краю

Значэнне па змаўчанні - replace.

mode

Пакажыце рэжым адлюстравання.

Ён прымае наступныя значэнні:

'combined'

усе каналы адлюстроўваюцца ў адным радку

'separate'

усе каналы адлюстроўваюцца ў асобных радках

Значэнне па змаўчанні 'combined'.

color

Укажыце каляровы рэжым адлюстравання.

Ён прымае наступныя значэнні:

'channel'

кожны канал адлюстроўваецца асобным колерам

'intensity'

кожны канал адлюстроўваецца з выкарыстаннем той жа каляровай схемы

'rainbow'

кожны канал адлюстроўваецца з дапамогай каляровай схемы вясёлкі

'moreland'

кожны канал адлюстроўваецца з дапамогай каляровай схемы moreland

'nebulae'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы туманнасцей

'fire'

кожны канал адлюстроўваецца з дапамогай каляровай схемы агню

'fiery'

кожны канал адлюстроўваецца ў вогненнай каляровай гаме

'fruit'

кожны канал адлюстроўваецца з выкарыстаннем фруктовай каляровай схемы

'cool'

кожны канал адлюстроўваецца з выкарыстаннем халоднай каляровай схемы

'magma'

кожны канал адлюстроўваецца з дапамогай каляровай схемы магмы

'green'

кожны канал адлюстроўваецца з дапамогай зялёнай каляровай схемы

'viridis'

кожны канал адлюстроўваецца з дапамогай каляровай схемы Viridis

'plasma'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы плазмы

'cividis'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы cividis

'terrain'

кожны канал адлюстроўваецца з дапамогай каляровай схемы мясцовасці

Значэнне па змаўчанні 'channel'.

scale

Укажыце шкалу, якая выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру.

Ён прымае наступныя значэнні:

'lin'

лінейны

'sqrt'

квадратны корань, па змаўчанні

'cbrt'

кубічны корань

'log'

лагарыфмічны

'4thrt'

4-ы корань

'5thrt'

5-ы корань

Значэнне па змаўчанні 'sqrt'.

fscale

Укажыце шкалу частот.

Ён прымае наступныя значэнні:

'lin'

лінейны

'log'

лагарыфмічны

Значэнне па змаўчанні 'lin'.

saturation

Усталюйце мадыфікатар насычанасці для адлюстраваных колераў. Адмоўныя значэнні забяспечваюць альтэрнатыўную каляровую схему. 0зусім не насычэнне. Насычанасць павінна быць у дыяпазоне [-10,0, 10,0]. Значэнне па змаўчанні - 1.

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann'
'hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Значэнне па змаўчанні - hann.

orientation

Усталюйце арыентацыю восі часу і частоты. Можа быць verticalабо horizontal. Па змаўчанні vertical.

overlap

Задайце каэфіцыент перакрыцця акна. Значэнне па змаўчанні - 0. Калі значэнне 1перакрываецца, усталяваны рэкамендаваны памер для пэўнай функцыі акна, якая выкарыстоўваецца ў цяперашні час.

gain

Усталюйце ўзмацненне маштабу для разліку значэнняў інтэнсіўнасці колеру. Значэнне па змаўчанні - 1.

data

Усталюйце, якія дадзеныя адлюстроўваць. Можа быць magnitude, па змаўчанні або phase, або разгорнутая фаза: uphase.

rotation

Задаць паварот колеру, павінен быць у дыяпазоне [-1,0, 1,0]. Значэнне па змаўчанні - 0.

start

Усталюйце пачатковую частату, з якой будзе паказвацца спектраграма. Па змаўчанні 0.

stop

Усталюйце частату прыпынку, да якой будзе паказвацца спектраграма. Па змаўчанні 0.

fps

Усталюйце верхнюю мяжу частаты кадраў. Па змаўчанні - autoнеабмежавана.

legend

Малюйце восі часу і частоты і легенды. Па змаўчанні адключана.

drange

Усталюйце дынамічны дыяпазон, які выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру. Па змаўчанні 120 dBFS. Дазволены дыяпазон ад 10 да 200.

limit

Усталюйце верхнюю мяжу гучнасці ўваходных аўдыёсэмплоў у dBFS. Па змаўчанні 0 dBFS. Дазволены дыяпазон ад -100 да 100.

opacity

Усталюйце ўзровень непразрыстасці пры выкарыстанні вываду ў фармаце пікселяў з альфа-кампанентам.

Выкарыстанне вельмі падобнае на фільтр showwaves; глядзіце прыклады ў гэтым раздзеле.

16.24.1 Examples

  • Вялікае акно з лагарыфмічнай каляровай шкалой:
    showspectrum=s=1280x480:scale=log
    
  • Поўны прыклад для каляровага і слізгальнага спектру на канал з выкарыстаннем ffplay:
    ffplay -f lavfi 'amovie=input.mp3, asplit [a][out1];
                 [a] showspectrum=mode=separate:color=intensity:slide=1:scale=cbrt [out0]'
    

16.25 showspectrumpic

Пераўтварэнне ўваходнага гуку ў адзін відэакадр, які прадстаўляе спектр частот гуку.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 4096x2048.

mode

Пакажыце рэжым адлюстравання.

Ён прымае наступныя значэнні:

'combined'

усе каналы адлюстроўваюцца ў адным радку

'separate'

усе каналы адлюстроўваюцца ў асобных радках

Значэнне па змаўчанні 'combined'.

color

Укажыце каляровы рэжым адлюстравання.

Ён прымае наступныя значэнні:

'channel'

кожны канал адлюстроўваецца асобным колерам

'intensity'

кожны канал адлюстроўваецца з выкарыстаннем той жа каляровай схемы

'rainbow'

кожны канал адлюстроўваецца з дапамогай каляровай схемы вясёлкі

'moreland'

кожны канал адлюстроўваецца з дапамогай каляровай схемы moreland

'nebulae'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы туманнасцей

'fire'

кожны канал адлюстроўваецца з дапамогай каляровай схемы агню

'fiery'

кожны канал адлюстроўваецца ў вогненнай каляровай гаме

'fruit'

кожны канал адлюстроўваецца з выкарыстаннем фруктовай каляровай схемы

'cool'

кожны канал адлюстроўваецца з выкарыстаннем халоднай каляровай схемы

'magma'

кожны канал адлюстроўваецца з дапамогай каляровай схемы магмы

'green'

кожны канал адлюстроўваецца з дапамогай зялёнай каляровай схемы

'viridis'

кожны канал адлюстроўваецца з дапамогай каляровай схемы Viridis

'plasma'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы плазмы

'cividis'

кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы cividis

'terrain'

кожны канал адлюстроўваецца з дапамогай каляровай схемы мясцовасці

Значэнне па змаўчанні 'intensity'.

scale

Укажыце шкалу, якая выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру.

Ён прымае наступныя значэнні:

'lin'

лінейны

'sqrt'

квадратны корань, па змаўчанні

'cbrt'

кубічны корань

'log'

лагарыфмічны

'4thrt'

4-ы корань

'5thrt'

5-ы корань

Значэнне па змаўчанні 'log'.

fscale

Укажыце шкалу частот.

Ён прымае наступныя значэнні:

'lin'

лінейны

'log'

лагарыфмічны

Значэнне па змаўчанні 'lin'.

saturation

Усталюйце мадыфікатар насычанасці для адлюстраваных колераў. Адмоўныя значэнні забяспечваюць альтэрнатыўную каляровую схему. 0зусім не насычэнне. Насычанасць павінна быць у дыяпазоне [-10,0, 10,0]. Значэнне па змаўчанні - 1.

win_func

Усталяваць функцыю акна.

Ён прымае наступныя значэнні:

'rect'
'bartlett'
'hann'
'hanning'
'hamming'
'blackman'
'welch'
'flattop'
'bharris'
'bnuttall'
'bhann'
'sine'
'nuttall'
'lanczos'
'gauss'
'tukey'
'dolph'
'cauchy'
'parzen'
'poisson'
'bohman'

Значэнне па змаўчанні - hann.

orientation

Усталюйце арыентацыю восі часу і частоты. Можа быць verticalабо horizontal. Па змаўчанні vertical.

gain

Усталюйце ўзмацненне маштабу для разліку значэнняў інтэнсіўнасці колеру. Значэнне па змаўчанні - 1.

legend

Малюйце восі часу і частоты і легенды. Па змаўчанні ўключана.

rotation

Задаць паварот колеру, павінен быць у дыяпазоне [-1,0, 1,0]. Значэнне па змаўчанні - 0.

start

Усталюйце пачатковую частату, з якой будзе паказвацца спектраграма. Па змаўчанні 0.

stop

Усталюйце частату прыпынку, да якой будзе паказвацца спектраграма. Па змаўчанні 0.

drange

Усталюйце дынамічны дыяпазон, які выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру. Па змаўчанні 120 dBFS. Дазволены дыяпазон ад 10 да 200.

limit

Усталюйце верхнюю мяжу гучнасці ўваходных аўдыёсэмплоў у dBFS. Па змаўчанні 0 dBFS. Дазволены дыяпазон ад -100 да 100.

opacity

Усталюйце ўзровень непразрыстасці пры выкарыстанні вываду ў фармаце пікселяў з альфа-кампанентам.

16.25.1 Examples

  • Вылучыце аўдыяспектраграму ўсёй аўдыядарожкі ў малюнку 1024x1024 з дапамогай ffmpeg:
    ffmpeg -i audio.flac -lavfi showspectrumpic=s=1024x1024 spectrogram.png
    

16.26 showvolume

Пераўтварыце гучнасць уваходнага аўдыя ў выхадны відэа.

Фільтр прымае наступныя параметры:

rate, r

Задаць хуткасць відэа.

b

Задаць шырыню мяжы, дазволены дыяпазон [0, 5]. Па змаўчанні 1.

w

Задаць шырыню канала, дазволены дыяпазон [80, 8192]. Па змаўчанні 400.

h

Задаць вышыню канала, дазволены дыяпазон [1, 900]. Па змаўчанні 20.

f

Задаць знікненне, дазволены дыяпазон [0, 1]. Па змаўчанні 0,95.

c

Усталюйце аб'ёмны каляровы выраз.

Выраз можа выкарыстоўваць наступныя зменныя:

VOLUME

Бягучая максімальная гучнасць канала ў дБ.

PEAK

Бягучы пік.

CHANNEL

Нумар бягучага канала, пачынаючы з 0.

t

Калі ўстаноўлена, адлюстроўвае назвы каналаў. Па змаўчанні ўключана.

v

Калі ўстаноўлена, адлюстроўвае значэнні гучнасці. Па змаўчанні ўключана.

o

Усталюйце арыентацыю, можа быць гарызантальнай: hабо вертыкальнай: v, па змаўчанні h.

s

Задаць памер кроку, дазволены дыяпазон [0, 5]. Па змаўчанні 0, што азначае крок адключаны.

p

Задаць непразрыстасць фону, дазволены дыяпазон [0, 1]. Па змаўчанні 0.

m

Усталюйце рэжым вымярэння, можа быць peak: pабо rms:, rпа змаўчанні - p.

ds

Устанавіць маштаб адлюстравання, можа быць лінейным: linабо лагарыф: log, па змаўчанні lin.

dm

У другім. Калі ўстаноўлена > 0., адлюстроўваць радок максімальнага ўзроўню за папярэднія секунды. па змаўчанні адключана:0.

dmc

Колер максімальнай лініі. Выкарыстоўваць, калі dmпараметр усталяваны ў > 0. Па змаўчанні:orange

16.27 showwaves

Пераўтварэнне ўваходнага аўдыё ў відэавыхад, які прадстаўляе ўзоры хваль.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 600x240.

mode

Усталюйце рэжым адлюстравання.

Даступныя значэнні:

'point'

Намалюйце кропку для кожнага ўзору.

'line'

Правядзіце вертыкальную лінію для кожнага ўзору.

'p2p'

Намалюйце кропку для кожнага ўзору і лінію паміж імі.

'cline'

Правядзіце па цэнтры вертыкальную лінію для кожнага ўзору.

Значэнне па змаўчанні - point.

n

Усталюйце колькасць узораў, якія друкуюцца на адным слупку. Большае значэнне знізіць частату кадраў. Павінен быць дадатным цэлым лікам. Гэты параметр можа быць усталяваны, толькі калі значэнне для rate не вызначана відавочна.

rate, r

Усталюйце (прыблізную) выходную частату кадраў. Гэта робіцца шляхам усталявання опцыі n. Значэнне па змаўчанні - "25".

split_channels

Усталюйце, калі каналы павінны малявацца асобна або перакрывацца. Значэнне па змаўчанні 0.

colors

Задайце колеры, падзеленыя знакам '|' якія збіраюцца выкарыстоўваць для малявання кожнага канала.

scale

Усталюйце шкалу амплітуды.

Даступныя значэнні:

'lin'

Лінейны.

'log'

Лагарыфмічны.

'sqrt'

Квадратны корань.

'cbrt'

Кубічны корань.

Па змаўчанні лінейны.

draw

Усталюйце рэжым малявання. Часцей за ўсё гэта карысна ўсталяваць для высокага ўзроўню n.

Даступныя значэнні:

'scale'

Маштабуйце значэнні пікселяў для кожнага намаляванага ўзору.

'full'

Намалюйце кожны ўзор непасрэдна.

Значэнне па змаўчанні - scale.

16.27.1 Examples

  • Адначасова вывядзіце аўдыё ўваходнага файла і адпаведнае відэа:
    amovie=a.mp3,asplit[out0],showwaves[out1]
    
  • Стварыце сінтэтычны сігнал і пакажыце яго з дапамогай шоў-хваляў, усталяваўшы частату кадраў 30 кадраў у секунду:
    aevalsrc=sin(1*2*PI*t)*sin(880*2*PI*t):cos(2*PI*200*t),asplit[out0],showwaves=r=30[out1]
    

16.28 showwavespic

Пераўтварэнне ўваходнага гуку ў адзін відэакадр, які прадстаўляе хвалі выбарак.

Фільтр прымае наступныя параметры:

size, s

Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - 600x240.

split_channels

Усталюйце, калі каналы павінны малявацца асобна або перакрывацца. Значэнне па змаўчанні 0.

colors

Задайце колеры, падзеленыя знакам '|' якія збіраюцца выкарыстоўваць для малявання кожнага канала.

scale

Усталюйце шкалу амплітуды.

Даступныя значэнні:

'lin'

Лінейны.

'log'

Лагарыфмічны.

'sqrt'

Квадратны корань.

'cbrt'

Кубічны корань.

Па змаўчанні лінейны.

draw

Усталюйце рэжым малявання.

Даступныя значэнні:

'scale'

Маштабуйце значэнні пікселяў для кожнага намаляванага ўзору.

'full'

Намалюйце кожны ўзор непасрэдна.

Значэнне па змаўчанні - scale.

filter

Усталюйце рэжым фільтра.

Даступныя значэнні:

'average'

Выкарыстоўвайце сярэднія значэнні ўзораў для кожнага ўзятага ўзору.

'peak'

Выкарыстоўвайце пікавыя значэнні ўзораў для кожнага ўзятага ўзору.

Значэнне па змаўчанні - average.

16.28.1 Examples

  • Вылучыце прадстаўленне падзелу канала формы хвалі цэлай гукавой дарожкі ў выяве 1024x800 з дапамогай ffmpeg:
    ffmpeg -i audio.flac -lavfi showwavespic=split_channels=1:s=1024x800 waveform.png
    

16.29 sidedata, asidedata

Выдаліце ​​бакавыя даныя кадра або выберыце кадры на іх аснове.

Гэты фільтр прымае наступныя параметры:

mode

Задайце рэжым працы фільтра.

Можа быць адно з наступнага:

'select'

Выберыце кожны кадр з бакавымі дадзенымі type.

'delete'

Выдаліць пабочныя дадзеныя type. Калі typeне ўстаноўлена, выдаліць усе бакавыя даныя ў кадры.

type

Усталюйце бакавы тып даных, які выкарыстоўваецца ва ўсіх рэжымах. Неабходна ўсталяваць selectрэжым. Для атрымання спісу тыпаў даных на баку кадра звярніцеся да AVFrameSideDataTypeпералічэння ўlibavutil/frame.h. Напрыклад, каб выбраць AV_FRAME_DATA_PANSCANпабочныя даныя, неабходна ўказаць PANSCAN.

16.30 spectrumsynth

Сінтэз аўдыя з 2 уваходных відэаспектраў, першы ўваходны паток уяўляе велічыню ў часе, а другі ўяўляе фазу ў часе. Фільтр ператворыцца з частотнай вобласці, якая адлюстроўваецца ў відэа, у часовую вобласць, якая прадстаўлена ў аўдыявыхадзе.

Гэты фільтр у першую чаргу створаны для рэверсавання апрацаваных вынікаў фільтра showspectrum , але можа сінтэзаваць гук і з іншых спектраграм. Але ў такім выпадку вынікі будуць дрэннымі, калі даныя фазы недаступныя, таму што ў такіх выпадках даныя фазы трэба аднавіць, звычайна яны проста ўзнаўляюцца з выпадковага шуму. Для дасягнення найлепшых вынікаў выкарыстоўвайце вывад толькі ў шэрым колеры ( channelкаляровы рэжым у фільтры showspectrum ) і logшкалу для магнітуднага відэа і linмаштаб для фазавага відэа. Каб стварыць фазу, для 2-га відэа выкарыстоўвайце dataпараметр. Уваходныя відэа звычайна павінны выкарыстоўваць fullframe слайд-рэжым, паколькі гэта эканоміць рэсурсы, неабходныя для дэкадавання відэа.

Фільтр прымае наступныя параметры:

sample_rate

Укажыце частату дыскрэтызацыі выхаднога гуку, частата дыскрэтызацыі гуку, з якога быў створаны спектр, можа адрознівацца.

channels

Устанавіць колькасць каналаў, прадстаўленых ва ўваходных відэаспектрах.

scale

Устанавіць маштаб, які выкарыстоўваўся пры генерацыі ўваходнага спектру велічыні. Можа быць linабо log. Па змаўчанні log.

slide

Усталюйце слайд, які выкарыстоўваўся пры генерацыі ўваходных спектраў. Можа быць replace, scroll, fullframeабо rscroll. Па змаўчанні fullframe.

win_func

Задаць функцыю акна, якая выкарыстоўваецца для паўторнага сінтэзу.

overlap

Усталюйце перакрыцце вокнаў. У дыяпазоне [0, 1]. Па змаўчанні ўстаноўлена 1, што азначае, што будзе выбрана аптымальнае перакрыцце для выбранай функцыі акна.

orientation

Задаць арыентацыю ўваходных відэа. Можа быць verticalабо horizontal. Па змаўчанні vertical.

16.30.1 Examples

  • Спачатку стварыце відэа з амплітуды і фазы з аўдыя, мяркуючы, што аўдыё стэрэа з частатой дыскрэтызацыі 44 100, а потым паўторна сінтэзуйце відэа ў аўдыя з дапамогай spectrumsynth:
    ffmpeg -i input.flac -lavfi showspectrum=mode=separate:scale=log:overlap=0.875:color=channel:slide=fullframe:data=magnitude -an -c:v rawvideo magnitude.nut
    ffmpeg -i input.flac -lavfi showspectrum=mode=separate:scale=lin:overlap=0.875:color=channel:slide=fullframe:data=phase -an -c:v rawvideo phase.nut
    ffmpeg -i magnitude.nut -i phase.nut -lavfi spectrumsynth=channels=2:sample_rate=44100:win_func=hann:overlap=0.875:slide=fullframe output.flac
    

16.31 split, asplit

Падзяліць уваход на некалькі аднолькавых выхадаў.

asplitпрацуе з аўдыё ўваходам, splitз відэа.

Фільтр прымае адзіны параметр, які вызначае колькасць выхадаў. Калі не пазначана, па змаўчанні 2.

16.31.1 Examples

  • Стварыце два асобных выхаду з аднаго ўводу:
    [in] split [out0][out1]
    
  • Каб стварыць 3 ці больш выхадаў, вам трэба пазначыць колькасць выхадаў, як у:
    [in] asplit=3 [out0][out1][out2]
    
  • Стварыце два асобных вываду з аднаго ўводу, адзін абрэзаны, а другі дапоўнены:
    [in] split [splitout1][splitout2];
    [splitout1] crop=100:100:0:0    [cropout];
    [splitout2] pad=200:200:100:100 [padout];
    
  • Стварыце 5 копій уваходнага аўдыё з дапамогай ffmpeg:
    ffmpeg -i INPUT -filter_complex asplit=5 OUTPUT
    

16.32 zmq, azmq

Атрымлівайце каманды, адпраўленыя праз кліент libzmq, і перасылайце іх у фільтры ў filtergraph.

zmqі azmqпрацуюць як прахадныя фільтры. zmq павінен быць устаўлены паміж двума відэафільтрамі, azmqпаміж двума аўдыяфільтрамі. Абодва здольныя адпраўляць паведамленні на любы тып фільтра.

Каб уключыць гэтыя фільтры, неабходна ўсталяваць бібліятэку libzmq і загалоўкі, а таксама наладзіць FFmpeg з дапамогай --enable-libzmq.

Для атрымання дадатковай інфармацыі аб libzmq глядзіце: http://www.zeromq.org/

Фільтры zmqі azmqпрацуюць як сервер libzmq, які атрымлівае паведамленні, адпраўленыя праз сеткавы інтэрфейс, вызначаны ў bind_address(або абрэвіятура "b"). Значэнне гэтага параметра па змаўчанні роўнаtcp://localhost:5555. Магчыма, вы захочаце змяніць гэтае значэнне ў адпаведнасці з вашымі патрэбамі, але не забудзьцеся экранаваць любыя знакі ':' (гл. Экранаванне фільтраграфа ).

Атрыманае паведамленне павінна быць у форме:

TARGET COMMAND [ARG]

TARGETзадае мэту каманды, звычайна імя класа фільтра або імя канкрэтнага асобніка фільтра. Імя асобніка фільтра па змаўчанні выкарыстоўвае шаблон 'Parsed_<filter_name>_<index>', але вы можаце перавызначыць гэта з дапамогай 'filter_name@id' сінтаксіс (гл . Сінтаксіс Filtergraph ).

COMMANDзадае назву каманды для мэтавага фільтра.

ARGне з'яўляецца абавязковым і вызначае неабавязковы спіс аргументаў для дадзенага COMMAND.

Пасля атрымання паведамленне апрацоўваецца і адпаведная каманда ўводзіцца ў фільтраграму. У залежнасці ад выніку фільтр адправіць кліенту адказ у фармаце:

ERROR_CODE ERROR_REASON
MESSAGE

MESSAGEне з'яўляецца абавязковым.

16.32.1 Examples

Паглядзіцеtools/zmqsendдля прыкладу кліента zmq, які можна выкарыстоўваць для адпраўкі каманд, апрацаваных гэтымі фільтрамі.

Разгледзім наступны графік фільтра, створаны ffplay. У гэтым прыкладзе апошні фільтр накладання мае імя асобніка. Усе астатнія фільтры будуць мець імёны асобнікаў па змаўчанні.

ffplay -dumpgraph 1 -f lavfi "
color=s=100x100:c=red  [l];
color=s=100x100:c=blue [r];
nullsrc=s=200x100, zmq [bg];
[bg][l]   overlay     [bg+l];
[bg+l][r] overlay@my=x=100 "

Каб змяніць колер левага боку відэа, можна выкарыстоўваць наступную каманду:

echo Parsed_color_0 c yellow | tools/zmqsend

Каб змяніць правы бок:

echo Parsed_color_1 c pink | tools/zmqsend

Каб змяніць становішча правага боку:

echo overlay@my x 150 | tools/zmqsend

17 Multimedia Sources

Ніжэй прыводзіцца апісанне даступных на дадзены момант мультымедыйных крыніц.

17.1 amovie

Гэта тое ж самае, што крыніца фільма , за выключэннем таго, што па змаўчанні выбіраецца аўдыяплынь.

17.2 avsynctest

Стварыце тэст сінхранізацыі аўдыё/відэа.

Згенераваны паток перыядычна паказвае кадр флэш-відэа і выдае гукавы сігнал у гуку. Карысна для праверкі праблем з сінхранізацыяй A/V.

Ён прымае наступныя варыянты:

size, s

Задаць памер выхаднога відэа. Значэнне па змаўчанні - hd720.

framerate, fr

Задаць частату кадраў выхаднога відэа. Значэнне па змаўчанні - 30.

samplerate, sr

Задаць частату дыскрэтызацыі выхаднога гуку. Значэнне па змаўчанні - 44100.

amplitude, a

Усталюйце амплітуду выхаднога гукавога сігналу. Значэнне па змаўчанні - 0.7.

period, p

Усталюйце перыяд выхаднога гукавога сігналу ў секундах. Значэнне па змаўчанні - 3.

delay, dl

Усталюйце затрымку ўспышкі выхаднога відэа ў колькасці кадраў. Значэнне па змаўчанні - 0.

cycle, c

Уключыць перыядычныя затрымкі відэа, па змаўчанні адключана.

duration, d

Задаць працягласць вываду патоку. Па змаўчанні працягласць неабмежаваная.

fg, bg, ag

Устанавіць колер пярэдняга/фонавага/дадатковага плана.

17.3 movie

Чытанне аўдыя- і/або відэаструменяў з кантэйнера фільмаў.

Ён прымае наступныя параметры:

filename

Імя рэсурсу для чытання (неабавязкова файла; гэта таксама можа быць прылада або паток, доступ да якога ажыццяўляецца праз нейкі пратакол).

format_name, f

Вызначае фармат, які мяркуецца для чытання фільма, і можа быць назвай кантэйнера або прылады ўводу. Калі не пазначана, фармат адгадваецца з movie_nameабо шляхам зандзіравання.

seek_point, sp

Вызначае кропку пошуку ў секундах. Кадры будуць выводзіцца, пачынаючы з гэтай кропкі пошуку. Параметр ацэньваецца з дапамогай av_strtod, так што лікавае значэнне можа быць суфіксаваны постфіксам IS. Значэнне па змаўчанні - "0".

streams, s

Вызначае патокі для чытання. Можна ўказаць некалькі патокаў, падзеленыя знакам "+". Затым крыніца будзе мець столькі ж вывадаў у тым жа парадку. Сінтаксіс тлумачыцца ў (ffmpeg) раздзеле "Спецыфікатары патоку" ў кіраўніцтве ffmpeg . Дзве спецыяльныя назвы, "dv" і "da" вызначаюць адпаведна стандартныя (найлепш прыдатныя) відэа- і аўдыяплыні. Па змаўчанні - "dv" або "da", калі фільтр называецца "amovie".

stream_index, si

Вызначае індэкс відэаплыні для чытання. Калі значэнне роўна -1, будзе аўтаматычна абраны найбольш прыдатны відэаструмень. Значэнне па змаўчанні - "-1". Састарэла. Калі фільтр называецца "amovie", ён будзе выбіраць аўдыя замест відэа.

loop

Вызначае, колькі разоў паслядоўна чытаць паток. Калі значэнне роўна 0, паток будзе бясконца зацыклены. Значэнне па змаўчанні - "1".

Звярніце ўвагу, што калі фільм зацыкліваецца, зыходныя пазнакі часу не змяняюцца, таму ён будзе ствараць неманатонна ўзрастаючыя пазнакі часу.

discontinuity

Вызначае розніцу ў часе паміж кадрамі, вышэй якой кропка лічыцца разрывам часовай меткі, якая выдаляецца шляхам карэкціроўкі пазнейшых часавых пазнак.

dec_threads

Задае колькасць патокаў для дэкадавання

format_opts

Пакажыце параметры фармату для адкрытага файла. Параметры фармату можна задаць як спіс пар key= value, падзеленых знакам ':'. У наступным прыкладзе паказана, як дадаць параметры protocol_whitelist і protocol_blacklist:

ffplay -f lavfi
"movie=filename='1.sdp':format_opts='protocol_whitelist=file,rtp,udp\:protocol_blacklist=http'"

Гэта дазваляе накласці другое відэа на асноўны ўваход фільтра, як паказана на гэтым графіку:

input -----------> deltapts0 --> overlay --> output
                                    ^
                                    |
movie --> scale--> deltapts1 -------+

17.3.1 Examples

  • Прапусціце 3,2 секунды ад пачатку файла AVI in.avi і накладзеце яго на ўвод з надпісам "in":
    movie=in.avi:seek_point=3.2, scale=180:-1, setpts=PTS-STARTPTS [over];
    [in] setpts=PTS-STARTPTS [main];
    [main][over] overlay=16:16 [out]
    
  • Прачытайце з прылады video4linux2 і накладзіце яго на ўвод, пазначаны "in":
    movie=/dev/video0:f=video4linux2, scale=180:-1, setpts=PTS-STARTPTS [over];
    [in] setpts=PTS-STARTPTS [main];
    [main][over] overlay=16:16 [out]
    
  • Прачытаць першы відэаструмень і аўдыяструмень з ідэнтыфікатарам 0x81 з dvd.vob; відэа падлучана да пляцоўкі пад назвай «відэа», а аўдыя падлучана да пляцоўкі пад назвай «аўдыё»:
    movie=dvd.vob:s=v:0+#0x81 [video] [audio]
    

17.3.2 Commands

І movie, і amovie падтрымліваюць наступныя каманды:

seek

Выканайце пошук з дапамогай «av_seek_frame». Сінтаксіс: шукаць stream_index| timestamp|flags

  • stream_index: Калі stream_index роўны -1, выбіраецца паток па змаўчанні, timestampякі аўтаматычна пераўтворыцца з адзінак AV_TIME_BASE ў спецыфічную базу часу_патоку.
  • timestamp: Метка часу ў адзінках AVStream.time_base або, калі паток не ўказаны, у адзінках AV_TIME_BASE.
  • flags: Сцяжкі, якія выбіраюць кірунак і рэжым пошуку.
get_duration

Атрымайце працягласць фільма ў адзінках AV_TIME_BASE.

18 See Also

ffmpeg , ffplay , ffprobe , libavfilter

19 Authors

Распрацоўшчыкі ffmpeg.

Для атрымання падрабязнай інфармацыі аб аўтарстве глядзіце гісторыю Git праекта (git://source.ffmpeg.org/ffmpeg), напрыклад, увёўшы каманду git logў каталогу зыходных кодаў FFmpeg або прагледзеўшы інтэрнэт-рэпазітар па адрасе http://source. ffmpeg.org .

Абслугоўвальнікі для канкрэтных кампанентаў пералічаны ў файле MAINTAINERSу дрэве зыходнага кода.

Гэты дакумент быў створаны 11 ліпеня 2022 г. з дапамогай makeinfo .

Хостынг прадастаўляецца telepoint.bg

Исходный текст