Зміст

1 Description

У цьому документі описано фільтри, джерела та приймачі, надані бібліотекою libavfilter.

2 Filtering Introduction

Фільтрування у FFmpeg увімкнено через бібліотеку libavfilter.

У libavfilter фільтр може мати кілька входів і кілька виходів. Щоб проілюструвати можливі речі, ми розглянемо наступний фільтр-граф.

                [головний]
вхід --> розділити ---------------------> накладення --> вихід
            | ^
            |[tmp] [фліп]|
            +-----> кадрування --> vflip -------+

Цей filtergraph розділяє вхідний потік на два потоки, потім надсилає один потік через фільтр кадрування та фільтр 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 каталог можна використовувати для аналізу опису filtergraph і видачі відповідного текстового представлення мовою точок.

Виклик команди:

graph2dot -h

щоб побачити, як використовуватиgraph2dot.

Потім ви можете передати опис точки доdotпрограму (з набору програм graphviz) і отримати графічне представлення filtergraph.

Наприклад, послідовність команд:

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

Фільтрограф — це орієнтований граф зв’язаних фільтрів. Він може містити цикли, і між парою фільтрів може бути кілька зв’язків. Кожна ланка має одну вхідну площадку з одного боку, що з’єднує її з одним фільтром, від якого вона отримує вхідний сигнал, і одну вихідну площадку з іншого боку, що з’єднує її з одним фільтром, який приймає його вихід.

Кожен фільтр у filtergraph є екземпляром класу фільтра, зареєстрованого в програмі, який визначає функції та кількість вхідних і вихідних майданчиків фільтра.

Фільтр без вхідних майданчиків називається «джерелом», а фільтр без вихідних майданчиків називається «приймачем».

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", а друга вихідна площадка розділення пов'язана з другою вхідною площадкою накладення, які обидві не позначені.

В описі фільтра, якщо вхідна мітка першого фільтра не вказана, передбачається «in»; якщо вихідна мітка останнього фільтра не вказана, передбачається "out".

У повному ланцюжку фільтрів усі немарковані вхідні та вихідні колодки фільтра мають бути підключені. Фільтрограф вважається дійсним, якщо всі вхідні та вихідні майданчики фільтрів усіх ланцюжків фільтрів з’єднані.

Libavfilter автоматично вставлятиме масштабні фільтри там, де потрібне перетворення формату. Можна вказати прапорці swscale для автоматично вставлених масштабувальників, додавши їх до опису filtergraph. 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) для отримання додаткової інформації про використану процедуру екранування.

Екранування першого рівня впливає на вміст кожного значення опції фільтра, яке може містити спеціальний символ, що :використовується для розділення значень, або один із екранованих символів \'.

Екранування другого рівня впливає на весь опис фільтра, який може містити екрановані символи \'або спеціальні символи [],;, що використовуються в описі filtergraph.

Нарешті, коли ви вказуєте filtergraph у командному рядку оболонки, вам потрібно виконати третій рівень екранування для спеціальних символів оболонки, які містяться в ньому.

Наприклад, розглянемо наступний рядок, який буде вбудовано в опис фільтра 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

(зауважте, що окрім \'спеціальних символів, що екрануються, ,потрібно також екранувати).

Нарешті, під час написання опису filtergraph у команді оболонки потрібен додатковий рівень екранування, який залежить від правил екранування прийнятої оболонки. Наприклад, якщо припустити, що \це спеціальний рядок, який потрібно екранувати за допомогою іншого \, попередній рядок нарешті призведе до:

-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. Вихід configure покаже аудіофільтри, включені у вашу збірку.

Нижче наведено опис доступних на даний момент аудіофільтрів.

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здебільшого плавніше.

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

Змініть загальну суміш. Синтаксис команди: " 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
  

• Переконайтеся, що аудіовихід міститиме принаймні 10 000 семплів, за потреби доповніть вхід тишею:

  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, якщо ввімкнено.