FFmpeg 濾鏡文件

目錄

1 描述

本文檔描述 libavfilter 函式庫提供的濾鏡、來源和接收器。

2 濾鏡簡介

FFmpeg 中的濾鏡功能是透過 libavfilter 函式庫啟用的。

在 libavfilter 中，一個濾鏡可以有多個輸入和多個輸出。為了說明可能的各種情況，我們考慮以下濾鏡圖。

                [main]
input --> split ---------------------> overlay --> output
            |                             ^
            |[tmp]                  [flip]|
            +-----> crop --> vflip -------+

此濾鏡圖將輸入串流分割成兩個串流，然後將一個串流透過 crop 濾鏡和 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 分別在另一個線性鏈中。線性鏈接合的點以方括號括起來的名稱標記。在範例中，split 濾鏡產生兩個輸出，它們與標籤 [main] 和 [tmp] 相關聯。

傳送到 split 的第二個輸出（標記為 [tmp]）的串流會透過 crop 濾鏡處理，該濾鏡會裁剪掉視訊的下半部分，然後垂直翻轉。overlay 濾鏡會輸入 split 濾鏡的第一個未變更的輸出（標記為 [main]），並在其下半部分覆蓋由 crop,vflip 濾鏡鏈產生的輸出。

某些濾鏡會輸入參數列表：它們在濾鏡名稱和等號後指定，並以冒號彼此分隔。

存在所謂的 來源濾鏡，它們沒有音訊/視訊輸入，以及 接收器濾鏡，它們沒有音訊/視訊輸出。

3 graph2dot

FFmpeg tools 目錄中包含的 graph2dot 程式可用於解析濾鏡圖描述，並以 dot 語言發出相應的文字表示形式。

調用命令

graph2dot -h

以查看如何使用 graph2dot。

然後，您可以將 dot 描述傳遞給 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 濾鏡圖描述

濾鏡圖是連接濾鏡的有向圖。它可以包含循環，並且濾鏡對之間可以有多個連結。每個連結在一側都有一個輸入襯墊，將其連接到一個濾鏡，它從該濾鏡獲取其輸入，而在另一側有一個輸出襯墊，將其連接到一個濾鏡，該濾鏡接受其輸出。

濾鏡圖中的每個濾鏡都是應用程式中註冊的濾鏡類別的實例，該濾鏡類別定義了濾鏡的功能以及輸入和輸出襯墊的數量。

沒有輸入襯墊的濾鏡稱為「來源」，而沒有輸出襯墊的濾鏡稱為「接收器」。

4.1 濾鏡圖語法

濾鏡圖具有文字表示形式，可由 ffmpeg 中的 -filter/-vf/-af 和 -filter_complex 選項以及 ffplay 中的 -vf/-af 選項以及 libavfilter/avfilter.h 中定義的 avfilter_graph_parse_ptr() 函數識別。

濾鏡鏈由一系列連接的濾鏡組成，每個濾鏡都連接到序列中的前一個濾鏡。濾鏡鏈由以「,」分隔的濾鏡描述列表表示。

濾鏡圖由一系列濾鏡鏈組成。一系列濾鏡鏈由以「;」分隔的濾鏡鏈描述列表表示。

濾鏡由以下形式的字串表示：[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 濾鏡採用像素格式列表），則列表中的項目通常以「|」分隔。

可以使用字元「'」（作為起始和結束標記）和字元「\」（用於跳脫引號文字中的字元）來引號引起來參數列表；否則，當遇到下一個特殊字元（屬於集合「[]=;,」）時，參數字串將被視為終止。

在 ffmpeg CLI 工具中實作的特殊語法允許從檔案載入選項值。這是透過在選項名稱前加上斜線「/」來完成的，然後將提供的値解釋為從中載入實際值的路徑。例如

ffmpeg -i <INPUT> -vf drawtext=/text=/tmp/some_text <OUTPUT>

將從 /tmp/some_text 載入要繪製的文字。希望實作類似功能的 API 使用者應將 avfilter_graph_segment_*() 函數與自訂 IO 程式碼一起使用。

濾鏡的名稱和參數可選擇在前面和後面加上連結標籤列表。前面的標籤 in_link_1 ... in_link_N 與濾鏡輸入襯墊相關聯，後面的標籤 out_link_1 ... out_link_M 與輸出襯墊相關聯。

當在濾鏡圖中找到兩個具有相同名稱的連結標籤時，將在相應的輸入和輸出襯墊之間建立連結。

如果未標記輸出襯墊，則預設情況下，它會連結到濾鏡鏈中下一個濾鏡的第一個未標記輸入襯墊。例如，在濾鏡鏈中

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

split 濾鏡實例具有兩個輸出襯墊，而 overlay 濾鏡實例具有兩個輸入襯墊。split 的第一個輸出襯墊標記為「L1」，overlay 的第一個輸入襯墊標記為「L2」，並且 split 的第二個輸出襯墊連結到 overlay 的第二個輸入襯墊，它們都是未標記的。

在濾鏡描述中，如果未指定第一個濾鏡的輸入標籤，則假定為「in」；如果未指定最後一個濾鏡的輸出標籤，則假定為「out」。

在完整的濾鏡鏈中，所有未標記的濾鏡輸入和輸出襯墊都必須連接。如果所有濾鏡鏈的所有濾鏡輸入和輸出襯墊都已連接，則濾鏡圖被視為有效。

分隔濾鏡圖規格中符記的前導和尾隨空白字元（空格、Tab 或換行符）會被忽略。這表示可以使用空行和空格來表示濾鏡圖，以提高可讀性。

例如，濾鏡圖

testsrc,split[L1],hflip[L2];[L1][L2] hstack

可以表示為

testsrc,
split [L1], hflip [L2];

[L1][L2] hstack

Libavfilter 將在需要格式轉換的地方自動插入 scale 濾鏡。可以透過在濾鏡圖描述前面加上 sws_flags=flags; 來為那些自動插入的縮放器指定 swscale 旗標。

以下是濾鏡圖語法的 BNF 描述

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 關於濾鏡圖跳脫字元的注意事項

濾鏡圖描述組合需要多個層級的跳脫字元。請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的「引號和跳脫字元」章節，以取得有關所使用跳脫字元程序的更多資訊。

第一個層級的跳脫字元會影響每個濾鏡選項值的內容，其中可能包含用於分隔值的特殊字元 : 或跳脫字元 \' 之一。

第二個層級的跳脫字元會影響整個濾鏡描述，其中可能包含跳脫字元 \' 或濾鏡圖描述使用的特殊字元 [],;。

最後，當您在 Shell 命令列上指定濾鏡圖時，您需要為其中包含的 Shell 特殊字元執行第三個層級的跳脫字元。

例如，考慮要嵌入 drawtext 濾鏡描述 text 值中的以下字串

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

此字串包含 ' 特殊跳脫字元和 : 特殊字元，因此需要以這種方式跳脫字元

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

當將濾鏡描述嵌入濾鏡圖描述中時，需要第二個層級的跳脫字元，以便跳脫所有濾鏡圖特殊字元。因此，上面的範例變為

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

（請注意，除了 \' 跳脫特殊字元外，還需要跳脫 ,）。

最後，當在 Shell 命令中編寫濾鏡圖描述時，需要額外的跳脫字元層級，這取決於所採用 Shell 的跳脫字元規則。例如，假設 \ 是特殊的，需要用另一個 \ 跳脫字元，則先前的字串最終將導致

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

為了避免在使用接受濾鏡規格作為輸入的命令行工具時出現繁瑣的跳脫字元，建議避免直接在 Shell 中包含濾鏡或選項規格。

例如，在 drawtext 濾鏡 的情況下，您可能更喜歡使用 textfile 選項而不是 text 來指定要呈現的文字。

5 時間軸編輯

某些濾鏡支援一般 enable 選項。對於支援時間軸編輯的濾鏡，此選項可以設定為在將影格傳送到濾鏡之前評估的表達式。如果評估為非零值，則將啟用濾鏡，否則，影格將保持不變地傳送到濾鏡圖中的下一個濾鏡。

表達式接受以下值

「t」

以秒為單位的時間戳記，如果輸入時間戳記未知，則為 NAN

「n」

輸入影格的循序編號，從 0 開始

「pos」

輸入影格在檔案中的位置，如果未知，則為 NAN；已棄用，請勿使用

「w」

「h」

輸入影格的寬度和高度（如果為視訊）

此外，這些濾鏡還支援 enable 命令，該命令可用於重新定義表達式。

與任何其他濾鏡選項一樣，enable 選項遵循相同的規則。

例如，若要從 10 秒到 3 分鐘啟用模糊濾鏡 (smartblur)，以及從 3 秒開始啟用 curves 濾鏡

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

請參閱 ffmpeg -filters 以檢視哪些濾鏡具有時間軸支援。

6 在執行時使用指令變更選項

某些選項可以在濾鏡操作期間使用命令進行變更。這些選項在 ffmpeg -h filter=<濾鏡名稱> 的輸出中標記為「T」。命令的名稱是選項的名稱，參數是新值。

7 具有多個輸入的濾鏡選項 (framesync)

一些具有多個輸入的濾鏡支援一組通用選項。這些選項只能按名稱設定，而不能使用簡短符號。

eof_action

在輔助輸入上遇到 EOF 時要採取的動作；它接受以下值之一

repeat

重複最後一個影格（預設值）。

endall

結束兩個串流。

pass

傳遞主要輸入。

shortest

如果設定為 1，則強制輸出在最短的輸入終止時終止。預設值為 0。

repeatlast

如果設定為 1，則強制濾鏡擴展輔助串流的最後一個影格，直到主要串流結束。值 0 會停用此行為。預設值為 1。

ts_sync_mode

如何根據輔助輸入時間戳記嚴格同步串流；它接受以下值之一

default

來自輔助輸入的影格，其時間戳記最接近且小於或等於主要輸入影格。

nearest

來自輔助輸入的影格，其時間戳記最接近主要輸入影格的絕對時間戳記。

8 音訊濾鏡

當您配置 FFmpeg 組建時，可以使用 --disable-filters 停用任何現有濾鏡。配置輸出將顯示組建中包含的音訊濾鏡。

以下是目前可用的音訊濾鏡的描述。

8.1 aap

使用第二個音訊串流將仿射投影演算法應用於第一個音訊串流。

此自適應濾鏡用於根據多個輸入音訊樣本估計未知的音訊。仿射投影演算法可以在計算複雜度和收斂速度之間進行權衡。

以下是接受選項的描述。

order

設定濾鏡階數。

projection

設定投影階數。

mu

設定濾鏡 mu。

delta

設定係數以初始化內部共變異數矩陣。

out_mode

設定濾鏡輸出樣本。它接受以下值

i

傳遞第一個輸入。

d

傳遞第二個輸入。

o

傳遞期望訊號、第二個輸入和誤差訊號估計值之間的差異。

n

傳遞輸入訊號、第一個輸入和誤差訊號估計值之間的差異。

e

傳遞誤差訊號估計樣本。

預設值為 o。

precision

設定處理樣本時要使用的精度。

auto

根據其他濾鏡自動選擇內部樣本格式。

float

始終使用單精度浮點精度樣本格式。

double

始終使用雙精度浮點精度樣本格式。

8.2 acompressor

壓縮器主要用於降低訊號的動態範圍。尤其是現代音樂，大多以高比率壓縮，以提高整體響度。這樣做是為了獲得聽眾的最大關注、「豐滿」聲音並為曲目帶來更多「力量」。如果訊號壓縮過多，則事後可能會聽起來沉悶或「死氣沉沉」，或者可能會開始「抽吸」（這可能是一種強大的效果，但也可能完全破壞曲目）。正確的壓縮是達到專業聲音的關鍵，並且是混音和母帶後期製作的高超藝術。由於其複雜的設定，可能需要很長時間才能對這種效果產生正確的感覺。

壓縮是透過偵測高於選定等級 threshold 的音量並將其除以使用 ratio 設定的因數來完成的。因此，如果您將臨界值設定為 -12dB，並且您的訊號達到 -6dB，則 2:1 的比率將導致訊號為 -9dB。由於精確地操縱訊號會導致波形失真，因此可以在時間內調整衰減。這是透過設定「Attack」和「Release」來完成的。attack 決定訊號必須在臨界值之上上升多長時間才會發生任何衰減，而 release 設定訊號必須在臨界值之下下降多長時間才能再次減少衰減。短於所選攻擊時間的訊號將保持原樣。訊號的整體衰減可以在事後使用 makeup 設定進行補償。因此，將訊號的峰值壓縮約 6dB 並將 makeup 提高到此等級會導致訊號比來源響亮兩倍。為了在壓縮中獲得更柔和的進入，knee 會在所選分貝範圍內的臨界值處展平硬邊緣。

濾鏡接受以下選項

level_in

設定輸入增益。預設值為 1。範圍介於 0.015625 和 64 之間。

mode

設定壓縮器操作模式。可以是 upward 或 downward。預設值為 downward。

threshold

如果串流的訊號上升到此等級以上，它將影響增益衰減。預設情況下為 0.125。範圍介於 0.00097563 和 1 之間。

ratio

設定訊號衰減的比率。1:2 表示如果等級上升到臨界值以上 4dB，則衰減後將僅高於 2dB。預設值為 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.2.1 指令

此濾鏡支援以上所有選項作為 commands。

8.3 acontrast

簡單的音訊動態範圍壓縮/擴展濾鏡。

濾鏡接受以下選項

contrast

設定對比度。預設值為 33。允許範圍介於 0 和 100 之間。

8.4 acopy

將輸入音訊來源不變地複製到輸出。這主要用於測試目的。

8.5 acrossfade

將淡入淡出效果從一個輸入音訊串流應用到另一個輸入音訊串流。淡入淡出效果在第一個串流的末尾附近應用指定的持續時間。

濾鏡接受以下選項

nb_samples, ns

指定淡入淡出效果必須持續的樣本數。在淡入淡出效果結束時，第一個輸入音訊將完全靜音。預設值為 44100。

duration, d

指定淡入淡出效果的持續時間。請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的「時間持續時間」章節，以取得接受的語法。預設情況下，持續時間由 nb_samples 決定。如果設定了此選項，則會使用此選項而不是 nb_samples。

overlap, o

第一個串流結束是否應與第二個串流開始重疊。預設為啟用。

curve1

設定第一個串流的淡入淡出轉換曲線。

curve2

設定第二個串流的淡入淡出轉換曲線。

如需可用曲線類型的描述，請參閱 afade 濾鏡描述。

8.5.1 範例

• 從一個輸入淡入淡出到另一個輸入

  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.6 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.6.1 範例

• 將輸入音訊串流分割成兩個頻段（低頻和高頻），分割頻率為 1500 Hz，每個頻段將在單獨的串流中

  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.7 acrusher

降低音訊位元解析度。

此濾鏡是具有增強功能的位元粉碎器。位元粉碎器用於以聽覺方式減少音訊訊號採樣的位元數。這根本不會改變位元深度，它只是產生效果。位元深度降低的素材聽起來更刺耳和「數位化」。此濾鏡甚至能夠捨入到連續值而不是離散位元深度。此外，它還具有 D/C 偏移，這會導致訊號的下半部分和上半部分以不同的方式粉碎。抗鋸齒設定能夠產生「更柔和」的粉碎聲音。

此濾鏡的另一個功能是對數模式。此設定從位元之間的線性距離切換到對數距離。結果是一個更「自然」的粉碎器，例如，它不會閘控低訊號。人耳具有對數感知，因此這種粉碎方式更令人愉悅。對數粉碎也能夠抗鋸齒。

濾鏡接受以下選項

level_in

設定輸入等級。

level_out

設定輸出等級。

bits

設定位元衰減。

mix

mix

mode

設定混合量。

mode

可以是線性：lin 或對數：log。

dc

設定 DC。

aa

設定抗鋸齒。

samples

設定樣本衰減。

lfo

啟用 LFO。預設為停用。

lforange

設定 LFO 範圍。

8.7.1 指令

此濾鏡支援以上所有選項作為 commands。

8.8 acue

lforate

8.9 adeclick

設定 LFO 速率。

延遲音訊濾鏡處理，直到給定的掛鐘時間戳記。請參閱 cue 濾鏡。

從輸入音訊中移除脈衝雜訊。

偵測為脈衝雜訊的樣本將被使用自迴歸建模的內插樣本取代。

overlap, o

window, w

設定視窗大小，以毫秒為單位。允許範圍為從 10 到 100。預設值為 55 毫秒。這會設定將一次處理的視窗大小。

overlap, v

設定視窗重疊，以視窗大小的百分比表示。允許範圍為從 50 到 95。預設值為 75%。將此設定為非常高的值會增加脈衝雜訊移除，但會使整個過程慢得多。

arorder, a

設定自迴歸階數，以視窗大小的百分比表示。允許範圍為從 0 到 25。預設值為 2%。此選項還使用相鄰的良好樣本來控制內插樣本的品質。

threshold, t

設定臨界值。允許範圍為從 1 到 100。預設值為 2。這會控制將要移除的脈衝雜訊的強度。值越低，偵測為脈衝雜訊的樣本就越多。

burst, b

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

method, m

設定重疊方法。

它接受以下值

add, a

選取重疊相加方法。即使是未內插的樣本，使用此方法也會略有改變。

8.10 adeclip

save, s

選取重疊儲存方法。未內插的樣本保持不變。

從輸入音訊中移除脈衝雜訊。

偵測為脈衝雜訊的樣本將被使用自迴歸建模的內插樣本取代。

overlap, o

預設值為 a。

設定視窗大小，以毫秒為單位。允許範圍為從 10 到 100。預設值為 55 毫秒。這會設定將一次處理的視窗大小。

從輸入音訊中移除削波樣本。

設定視窗重疊，以視窗大小的百分比表示。允許範圍為從 50 到 95。預設值為 75%。將此設定為非常高的值會增加脈衝雜訊移除，但會使整個過程慢得多。

偵測為削波的樣本將被使用自迴歸建模的內插樣本取代。

overlap, v

設定視窗重疊，以視窗大小的百分比表示。允許範圍為從 50 到 95。預設值為 75%。

設定臨界值。允許範圍為從 1 到 100。預設值為 2。這會控制將要移除的脈衝雜訊的強度。值越低，偵測為脈衝雜訊的樣本就越多。

burst, b

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

method, m

設定重疊方法。

它接受以下值

add, a

選取重疊相加方法。即使是未內插的樣本，使用此方法也會略有改變。

8.11 adecorrelate

arorder, a

濾鏡接受以下選項

設定自迴歸階數，以視窗大小的百分比表示。允許範圍為從 0 到 25。預設值為 8%。此選項還使用相鄰的良好樣本來控制內插樣本的品質。

threshold, t

設定臨界值。允許範圍為從 1 到 100。預設值為 10。值越高，削波偵測的侵略性就越低。

hsize, n

8.12 adelay

設定用於偵測削波的直方圖大小。允許範圍為從 100 到 9999。預設值為 1000。值越高，削波偵測的侵略性就越低。

將去相關性應用於輸入音訊串流。

stages

設定濾鏡處理的去相關性階段。允許範圍為從 1 到 16。預設值為 6。

seed

設定用於設定跨聲道樣本延遲的隨機種子。

延遲一個或多個音訊聲道。

8.12.1 範例

• 延遲聲道中的樣本會以靜音填充。

  adelay=1500|0|500
  

• 濾鏡接受以下選項

  adelay=0|500S|700S
  

• delays

  adelay=delays=64S:all=1
  

8.13 adenorm

設定每個聲道的延遲列表，以「|」分隔，單位為毫秒。未使用的延遲將被靜默忽略。如果給定的延遲數小於聲道數，則所有剩餘的聲道將不會被延遲。如果您想要延遲精確的樣本數，請在數字後附加「S」。如果您想要改為以秒為單位延遲，請在數字後附加「s」。

all

將最後設定的延遲用於所有剩餘聲道。預設為停用。如果啟用此選項，則會變更選項 delays 的解讀方式。

level

將第一個聲道延遲 1.5 秒，將第三個聲道延遲 0.5 秒，並保持第二個聲道（和可能存在的任何其他聲道）不變。

將第二個聲道延遲 500 個樣本，將第三個聲道延遲 700 個樣本，並保持第一個聲道（和可能存在的任何其他聲道）不變。

將所有聲道延遲相同的樣本數

mode

透過新增極低等級的雜訊來補救音訊中的次常態數。

此濾鏡應放置在任何可能產生次常態數的濾鏡之前。

以下是接受參數的描述。

level

以 dB 為單位設定新增雜訊的等級。預設值為 -351。允許範圍為從 -451 到 -90。

type

設定新增雜訊的類型。

dc

8.13.1 指令

此濾鏡支援以上所有選項作為 commands。

8.14 aderivative, aintegral

新增 DC 訊號。

ac

8.15 adrc

新增 AC 訊號。

以下是接受選項的描述。

square

新增方波訊號。

pulse

新增脈衝訊號。

預設值為 dc。

計算音訊串流的導數/積分。

依序套用兩個濾鏡會產生原始音訊。

將頻譜動態範圍控制器濾鏡套用於輸入音訊串流。

transfer

設定傳輸表達式。

表達式可以包含以下常數

ch

目前聲道號碼

sn

目前樣本號碼

nb_channels

聲道數

t

attack

以秒為單位表示的時間戳記

release

sr

取樣率

p

8.15.1 指令

此濾鏡支援以上所有選項作為 commands。

8.15.2 範例

• 目前頻率功率值（以 dB 為單位）

  adrc=transfer='if(gt(p,-50),-50+(p-(-50))/6,p)':attack=50:release=100
  

• f

  adrc=transfer='if(gt(p,-50),-50+(p-(-50))/2,p)':attack=50:release=100:channels=FC
  

• 目前頻率（以 Hz 為單位）

  adrc=transfer='if(lte(p,-85),p-800,p)':attack=1:release=5
  

• 預設值為 p。

  adrc=transfer='if(lt(p,-10),-10+(p-(-10))*2,p)':attack=50:release=100
  

• attack

  adrc=transfer='min(p,-60)':attack=2:release=10
  

8.16 adynamicequalizer

以毫秒為單位設定攻擊時間。預設值為 50 毫秒。允許範圍為從 1 到 1000 毫秒。

以下是接受選項的描述。

threshold

release

以毫秒為單位設定釋放時間。預設值為 100 毫秒。允許範圍為從 5 到 2000 毫秒。

channels

設定要濾鏡處理的聲道，預設情況下會濾鏡處理音訊串流中的 all 聲道。

將頻譜壓縮套用於所有頻率，臨界值為 -50 dB，比率為 1:6

與上述類似，但比率為 1:2，且僅濾鏡處理前置中央聲道

將頻譜雜訊閘套用於所有頻率，臨界值為 -85 dB，且具有短攻擊時間和短釋放時間

將頻譜擴展套用於所有頻率，臨界值為 -10 dB，比率為 1:2

將限制器套用於最大 -60 dB 的所有頻率，攻擊時間為 2 毫秒，釋放時間為 10 毫秒

attack

將動態等化套用於輸入音訊串流。

release

threshold

ratio

設定用於觸發等化的偵測臨界值。臨界值偵測使用偵測濾鏡。預設值為 0。允許範圍為從 0 到 100。

makeup

dfrequency

設定用於偵測濾鏡的偵測頻率（以 Hz 為單位），該偵測濾鏡用於觸發等化。預設值為 1000 Hz。允許範圍介於 2 和 1000000 Hz 之間。

dqfactor

mode

設定用於偵測濾鏡的偵測共振因數，該偵測濾鏡用於觸發等化。預設值為 1。允許範圍為從 0.001 到 1000。

tfrequency

設定等化濾鏡的目標頻率。預設值為 1000 Hz。允許範圍介於 2 和 1000000 Hz 之間。

tqfactor

設定目標等化濾鏡的目標共振因數。預設值為 1。允許範圍為從 0.001 到 1000。

attack

設定來自偵測的訊號必須在偵測臨界值之上上升多少毫秒，等化才會開始。預設值為 20。允許範圍介於 1 和 2000 之間。

release

設定來自偵測的訊號必須在偵測臨界值之下下降多少毫秒，等化才會結束。預設值為 200。允許範圍介於 1 和 2000 之間。

ratio

設定等化增益提升的比率。預設值為 1。允許範圍介於 0 和 30 之間。

makeup

設定等化增益提升的補償偏移。預設值為 0。允許範圍介於 0 和 100 之間。

range

設定允許的最大削減/提升量。預設值為 50。允許範圍為從 1 到 200。

mode

設定濾鏡操作模式，可以是以下之一

「listen」

僅輸出隔離的偵測訊號。

「cutbelow」

削減低於偵測臨界值的頻率。

「cutabove」

削減高於偵測臨界值的頻率。

「boostbelow」

提升低於偵測臨界值的頻率。

auto

「boostabove」

提升高於偵測臨界值的頻率。

預設模式為「cutbelow」。

dftype

設定偵測濾鏡的類型，可以是以下之一

「bandpass」

「lowpass」

「highpass」

「peak」

預設類型為「bandpass」。

precision

設定處理樣本時要使用的精度。

auto

根據其他濾鏡自動選擇內部樣本格式。

float

始終使用單精度浮點精度樣本格式。

double

始終使用雙精度浮點精度樣本格式。

8.16.1 指令

此濾鏡支援以上所有選項作為 commands。

8.17 adynamicsmooth

tftype

以下是接受選項的描述。

設定目標濾鏡的類型，可以是以下之一

「bell」

「lowshelf」

「highshelf」

8.17.1 指令

此濾鏡支援以上所有選項作為 commands。

8.18 aecho

預設類型為「bell」。

gather

將最後設定的延遲用於所有剩餘聲道。預設為停用。如果啟用此選項，則會變更選項 delays 的解讀方式。

自動從偵測濾鏡收集臨界值。預設為「disabled」。此選項可用於偵測輸入音訊串流特定時間範圍內的臨界值，在這種情況下，選項值會在執行時變更。

可用值為

「disabled」

停用使用自動收集的臨界值。

設定濾鏡處理的去相關性階段。允許範圍為從 1 到 16。預設值為 6。

「off」

停止選取臨界值。

「on」

8.18.1 範例

• 開始選取臨界值。

  aecho=0.8:0.88:60:0.4
  

• 「adaptive」

  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.19 aemphasis

sensitivity

濾鏡接受以下選項

level_in

設定對頻率波動的靈敏度量。預設值為 2。允許範圍為從 0 到 1e+06。

level_out

basefreq

mode

設定平滑化的基準頻率。預設值為 22050。允許範圍為從 2 到 1e+06。

將第二個聲道延遲 500 個樣本，將第三個聲道延遲 700 個樣本，並保持第一個聲道（和可能存在的任何其他聲道）不變。

將回音套用於輸入音訊。

回音是反射的聲音，自然會發生在山脈（有時是大型建築物）之間，當說話或喊叫時；數位回音效果模擬了此行為，並且經常被用於幫助填補單一樂器或人聲的聲音。原始訊號與反射訊號之間的時間差是 delay，反射訊號的響度是 decay。多個回音可以具有不同的延遲和衰減。

in_gain

設定反射訊號的輸入增益。預設值為 0.6。

out_gain

設定反射訊號的輸出增益。預設值為 0.3。

delays

設定原始訊號和反射之間的時間間隔列表，以「|」分隔，單位為毫秒。每個 delay 的允許範圍為 (0 - 90000.0]。預設值為 1000。

decays

設定反射訊號的響度列表，以「|」分隔。每個 decay 的允許範圍為 (0 - 1.0]。預設值為 0.5。

使其聽起來像是實際演奏的樂器數量是兩倍

如果延遲非常短，則聽起來像是機器人（金屬感）在演奏音樂

更長的延遲聽起來像是山區的露天音樂會

與上述相同，但多了一座山

音訊加重濾鏡會建立或還原直接取自 LP 或具有不同濾鏡曲線的加重 CD 的素材。例如，為了將音樂儲存在黑膠唱片上，必須先使用濾鏡改變訊號，以消除此錄音媒體的缺點。一旦播放素材，就必須套用反向濾鏡以還原頻率響應的失真。

in_gain

設定輸入增益。

out_gain

設定輸出增益。

8.19.1 指令

此濾鏡支援以上所有選項作為 commands。

8.20 aeval

mode

此濾波器接受一個或多個表達式（每個聲道一個），這些表達式會被評估並用於修改對應的音訊訊號。

它接受以下參數

exprs

為每個獨立聲道設定以 ’|’ 分隔的表達式列表。如果輸入聲道數量大於表達式數量，則最後指定的表達式將用於剩餘的輸出聲道。

channel_layout, c

設定輸出聲道佈局。如果未指定，聲道佈局將由表達式的數量指定。如果設定為 ‘same’，預設將使用相同的輸入聲道佈局。

exprs 中的每個表達式都可以包含以下常數和函數

新增脈衝訊號。

目前表達式的聲道號碼

n

已評估樣本的編號，從 0 開始

s

目前聲道號碼

設定傳輸表達式。

以秒為單位的已評估樣本時間

nb_in_channels

nb_out_channels

輸入和輸出聲道數量

val(CH)

聲道號碼為 CH 的輸入聲道值

注意：此濾波器速度較慢。為了更快的處理速度，您應該使用專用濾波器。

8.20.1 範例

• 音量減半

  aeval=val(ch)/2:c=same
  

• 反轉第二聲道的相位

  aeval=val(0)|-val(1)
  

8.21 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

設定產生諧波的最低頻率限制，單位為 Hz。允許範圍為 2000 到 12000 Hz。預設值為 7500 Hz。

ceil

設定產生諧波的最高頻率限制。允許範圍為 9999 到 20000 Hz。如果值低於 10000 Hz，則不應用限制。

listen

靜音原始訊號，僅輸出添加的諧波。預設為停用。

8.21.1 指令

此濾鏡支援以上所有選項作為 commands。

8.22 afade

對輸入音訊應用淡入/淡出效果。

將最後設定的延遲用於所有剩餘聲道。預設為停用。如果啟用此選項，則會變更選項 delays 的解讀方式。

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

設定淡化轉換的曲線。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

tri

選擇三角形、線性斜率（預設）

qsin

選擇四分之一正弦波

hsin

選擇半個正弦波

esin

選擇指數正弦波

log

選擇對數

ipar

選擇倒拋物線

qua

選擇二次方

cub

選擇立方

squ

選擇平方根

cbr

選擇立方根

par

選擇拋物線

exp

選擇指數

iqsin

選擇倒四分之一正弦波

ihsin

選擇倒半個正弦波

dese

選擇雙指數座椅

desi

選擇雙指數 S 型曲線

losi

選擇邏輯 S 型曲線

sinc

選擇正弦基數函數

isinc

選擇倒正弦基數函數

quat

選擇四次方

quatr

選擇四次方根

qsin2

選擇平方四分之一正弦波

hsin2

選擇平方半個正弦波

nofade

不應用淡化

silence

設定淡入的初始增益或淡出的最終增益。預設值為 0.0。

unity

設定淡出的初始增益或淡入的最終增益。預設值為 1.0。

8.22.1 指令

此濾鏡支援以上所有選項作為 commands。

8.22.2 範例

• 音訊前 15 秒淡入

  afade=t=in:ss=0:d=15
  

• 在 900 秒音訊的最後 25 秒淡出

  afade=t=out:st=875:d=25
  

8.23 afftdn

使用 FFT 對音訊樣本進行降噪。

將最後設定的延遲用於所有剩餘聲道。預設為停用。如果啟用此選項，則會變更選項 delays 的解讀方式。

noise_reduction, nr

設定降噪量，單位為 dB，允許範圍為 0.01 到 97。預設值為 12 dB。

noise_floor, nf

設定底噪，單位為 dB，允許範圍為 -80 到 -20。預設值為 -50 dB。

noise_type, nt

設定雜訊類型。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

white, w

選擇白雜訊。

vinyl, v

選擇黑膠唱片雜訊。

shellac, s

選擇蟲膠唱片雜訊。

custom, c

選擇自訂雜訊，在 bn 選項中定義。

預設值為白雜訊。

band_noise, bn

為 15 個頻段中的每一個設定自訂頻段雜訊輪廓。頻段以 ’ ’ 或 ’|’ 分隔。

residual_floor, rf

設定殘餘底噪，單位為 dB，允許範圍為 -80 到 -20。預設值為 -38 dB。

track_noise, tn

啟用底噪追蹤。預設為停用。啟用後，底噪會自動調整。

track_residual, tr

啟用殘餘追蹤。預設為停用。

output_mode, om

設定輸出模式。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

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

設定用於多聲道音訊的雜訊連結。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

none

使用未更改聲道的底噪。

min

使用所有聲道測量的最小底噪。

max

使用所有聲道測量的最大底噪。

average

使用所有聲道測量的平均底噪。

預設值為 min。

band_multiplier, bm

設定頻段乘數因子，用於控制頻段在頻率箱中擴散的程度。允許範圍為 0.2 到 5。預設值為 1.25。

sample_noise, sn

切換從輸入音訊捕獲和測量雜訊輪廓。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

start, begin

開始樣本雜訊捕獲。

stop, end

停止樣本雜訊捕獲並測量新的雜訊頻段輪廓。

預設值為 none。

gain_smooth, gs

設定增益平滑空間半徑，用於平滑應用於每個頻率箱的增益。有助於減少隨機音樂雜訊偽影。值越高，增益平滑度越高。允許範圍為 0 到 50。預設值為 0。

8.23.1 指令

此濾波器支援一些上述選項作為 指令。

8.23.2 範例

• 將白雜訊降低 10dB，並使用先前測量的 -40dB 底噪

  afftdn=nr=10:nf=-40
  

• 將白雜訊降低 10dB，同時將初始底噪設定為 -80dB，並啟用底噪自動追蹤，以便底噪在處理過程中逐漸變化

  afftdn=nr=10:nf=-80:tn=1
  

• 將雜訊降低 20dB，使用 -40dB 的底噪，並使用指令擷取輸入音訊前 0.4 秒的雜訊輪廓

  asendcmd=0.0 afftdn sn start,asendcmd=0.4 afftdn sn stop,afftdn=nr=20:nf=-40
  

8.24 afftfilt

對頻域中的樣本應用任意表達式。

real

為每個獨立聲道設定以 ’|’ 分隔的頻域實數表達式。預設值為 "re"。如果輸入聲道數量大於表達式數量，則最後指定的表達式將用於剩餘的輸出聲道。

imag

為每個獨立聲道設定以 ’|’ 分隔的頻域虛數表達式。預設值為 "im"。

real 和 imag 中的每個表達式都可以包含以下常數和函數

ch

目前聲道號碼

b

目前的頻率箱編號

nb

可用箱的數量

新增脈衝訊號。

目前表達式的聲道號碼

chs

transfer

pts

目前幀 PTS

re

目前聲道頻率箱的實部

im

目前聲道頻率箱的虛部

real(b, ch)

傳回位置 (bin,channel) 處頻率箱實部的值

imag(b, ch)

傳回位置 (bin,channel) 處頻率箱虛部的值

win_size

設定視窗大小。允許範圍為 16 到 131072。預設值為 4096

win_func

設定視窗函數。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

‘rect’

‘bartlett’

‘hann, hanning’

‘hamming’

‘blackman’

‘welch’

‘flattop’

‘bharris’

‘bnuttall’

‘bhann’

‘sine’

‘nuttall’

‘lanczos’

‘gauss’

‘tukey’

‘dolph’

‘cauchy’

‘parzen’

‘poisson’

‘bohman’

‘kaiser’

預設值為 hann。

overlap

設定視窗重疊。如果設定為 1，將選取所選視窗函數的建議重疊。預設值為 0.75。

8.24.1 範例

• 幾乎只留下音訊中的低頻

  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"
  

• 應用相位偏移

  afftfilt="real=re*cos(1)-im*sin(1):imag=re*sin(1)+im*cos(1)"
  

8.25 afir

應用任意有限脈衝響應濾波器。

此濾波器專為應用長 FIR 濾波器而設計，最長可達 60 秒。

它可用作數位分頻濾波器、房間等化、串音消除、波場合成、聽覺化、環境聲學和空間化的組件。

此濾波器使用第一個串流以外的串流作為 FIR 係數。如果非第一個串流包含單聲道，它將用於第一個串流中的所有輸入聲道，否則非第一個串流中的聲道數量必須與第一個串流中的聲道數量相同。

它接受以下參數

dry

設定乾聲增益。這會設定輸入增益。

wet

設定濕聲增益。這會設定最終輸出增益。

length

設定脈衝響應濾波器長度。預設值為 1，表示處理整個 IR。

gtype

此選項已棄用，且無作用。

irnorm

設定在濾波前應用於 IR 係數的範數。允許範圍為 -1 到 2。IR 係數會使用此選項設定的計算向量範數進行正規化。對於負值，不會計算範數，且 IR 係數完全不會被修改。預設值為 1。

irlink

對於多聲道 IR，如果此選項設定為 true，則所有 IR 聲道將使用所有 IR 聲道係數的最大測量增益進行正規化，如 irnorm 選項所設定。停用時，每個 IR 聲道中的所有 IR 係數將獨立正規化。預設值為 true。

irgain

設定在濾波前應用於 IR 係數的增益。允許範圍為 0 到 1。此增益在應用任何使用 irnorm 選項應用的增益之後應用。

irfmt

設定 IR 串流的格式。可以是 mono 或 input。預設值為 input。

maxir

設定允許的最大脈衝響應濾波器持續時間，單位為秒。預設值為 30 秒。允許範圍為 0.1 到 60 秒。

response

此選項已棄用，且無作用。

channel

此選項已棄用，且無作用。

size

此選項已棄用，且無作用。

rate

此選項已棄用，且無作用。

minp

設定用於卷積的最小分割區大小。預設值為 8192。允許範圍為 1 到 65536。較低的值會降低延遲，但會增加 CPU 使用率。

maxp

設定用於卷積的最大分割區大小。預設值為 8192。允許範圍為 8 到 65536。較低的值可能會增加 CPU 使用率。

nbirs

設定在執行階段可切換的輸入脈衝響應串流數量。允許範圍為 1 到 32。預設值為 1。

ir

設定將用於卷積的 IR 串流，從 0 開始，應始終低於 nbirs 選項提供的數值。預設值為 0。此選項可以在執行階段通過 指令 更改。

precision

設定處理樣本時要使用的精度。

auto

根據其他濾鏡自動選擇內部樣本格式。

float

始終使用單精度浮點精度樣本格式。

double

始終使用雙精度浮點精度樣本格式。

預設值為 auto。

irload

設定何時載入 IR 串流。可以是 init 或 access。第一個在初始化時載入並準備所有 IR，第二個在首次存取特定 IR 時載入並準備。預設值為 init。

8.25.1 範例

• 使用單聲道 IR 檔案作為第二個輸入，將殘響應用於串流，使用 ffmpeg 完成指令

  ffmpeg -i input.wav -i middle_tunnel_1way_mono.wav -lavfi afir output.wav
  

• 對於給定的輸入立體聲串流，以及左右聲道的兩個立體聲脈衝響應，應用真正的立體聲處理，脈衝響應檔案是名為 l_ir.wav 和 r_ir.wav 的檔案，並設定 irnorm 選項值

  "pan=4C|c0=FL|c1=FL|c2=FR|c3=FR[a];amovie=l_ir.wav[LIR];amovie=r_ir.wav[RIR];[LIR][RIR]amerge[ir];[a][ir]afir=irfmt=input:irnorm=1.2,pan=stereo|FL<c0+c2|FR<c1+c3"
  

• 與上述範例類似，但明確設定 irgain 為估計值，並停用 irnorm

  "pan=4C|c0=FL|c1=FL|c2=FR|c3=FR[a];amovie=l_ir.wav[LIR];amovie=r_ir.wav[RIR];[LIR][RIR]amerge[ir];[a][ir]afir=irfmt=input:irgain=-5dB:irnom=-1,pan=stereo|FL<c0+c2|FR<c1+c3"
  

8.26 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.27 afreqshift

對輸入音訊樣本應用頻率偏移。

濾鏡接受以下選項

shift

指定頻率偏移。允許範圍為 -INT_MAX 到 INT_MAX。預設值為 0.0。

level

設定應用於最終輸出的輸出增益。允許範圍為 0.0 到 1.0。預設值為 1.0。

order

設定用於濾波的濾波器階數。允許範圍為 1 到 16。預設值為 8。

8.27.1 指令

此濾鏡支援以上所有選項作為 commands。

8.28 afwtdn

使用小波減少輸入樣本中的寬頻雜訊。

以下是接受選項的描述。

sigma

設定雜訊西格瑪值，允許範圍為 0 到 1。預設值為 0。此選項控制應用於輸入樣本的降噪強度。設定此選項最有效的方法是通過分貝，例如 -45dB。

levels

設定小波分解的層級數。允許範圍為 1 到 12。預設值為 10。設定過低會使降噪效能非常差。

wavet

設定輸入幀分解的小波類型。它們按係數數量排序，從最低到最高。係數越多，濾波速度越慢，但整體品質越好。可用的 wavelet 為

‘sym2’

‘sym4’

‘rbior68’

‘deb10’

‘sym10’

‘coif5’

‘bl3’

percent

設定完全降噪的百分比。允許範圍為 0 到 100%。預設值為 85%，即部分降噪。

profile

如果啟用，則第一個輸入幀將用作雜訊輪廓。如果第一個幀樣本包含非雜訊，效能將非常差。

adaptive

如果啟用，則會分析輸入幀是否存在雜訊。如果偵測到高機率雜訊，則輸入幀輪廓將用於處理後續幀，直到偵測到新的雜訊幀。

aa

設定單個幀的大小，以樣本數量為單位。允許範圍為 512 到 65536。預設幀大小為 8192 個樣本。

softness

設定在閾值函數內部應用的柔度。允許範圍為 0 到 10。預設柔度為 1。

8.28.1 指令

此濾鏡支援以上所有選項作為 commands。

8.29 agate

閘門主要用於減少訊號的較低部分。這種訊號處理減少了有用訊號之間的干擾雜訊。

閘控是通過偵測低於選定水平 threshold 的音量，並將其除以 ratio 設定的因子來完成的。底噪的下限通過 range 設定。由於對訊號的精確操作會導致波形失真，因此可以在一段時間內調整減少量。這是通過設定 attack 和 release 來完成的。

attack 決定訊號必須低於閾值多久才會發生任何減少，而 release 設定訊號必須高於閾值多久才能再次減少減少量。短於選定啟動時間的訊號將保持不變。

level_in

設定濾波前的輸入音量。預設值為 1。允許範圍為 0.015625 到 64。

mode

設定操作模式。可以是 upward 或 downward。預設值為 downward。如果設定為 upward 模式，則訊號的較高部分將被放大，向上擴展動態範圍。否則，在 downward 模式下，訊號的較低部分將被減少。

設定用於偵測濾鏡的偵測頻率（以 Hz 為單位），該偵測濾鏡用於觸發等化。預設值為 1000 Hz。允許範圍介於 2 和 1000000 Hz 之間。

設定訊號低於閾值時的增益減少量。預設值為 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.29.1 指令

此濾鏡支援以上所有選項作為 commands。

8.30 aiir

應用任意無限脈衝響應濾波器。

它接受以下參數

zeros, z

設定 B/分子/零點/反射係數。

poles, p

設定 A/分母/極點/梯形係數。

gains, k

設定聲道增益。

dry_gain

設定對頻率波動的靈敏度量。預設值為 2。允許範圍為從 0 到 1e+06。

wet_gain

basefreq

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

正規化濾波器係數，預設為啟用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

mix

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

response

在額外的視訊串流中顯示 IR 頻率響應、幅度（洋紅色）、相位（綠色）和群組延遲（黃色）。預設為停用。

channel

設定要顯示頻率響應的 IR 聲道。預設為顯示第一個聲道。此選項僅在啟用 response 時使用。

size

設定視訊串流大小。此選項僅在啟用 response 時使用。

tf 和 sf 格式的係數以空格分隔，並按升序排列。

zp 格式的係數以空格分隔，係數順序無關緊要。zp 格式的係數是具有 i 虛數單位的複數。

可以為每個聲道提供不同的係數和增益，在這種情況下，請使用 ’|’ 分隔係數或增益。最後提供的係數將用於所有剩餘聲道。

8.30.1 範例

• 在 48000 Hz 取樣率下，對大約 5000Hz 的位置應用 2 極橢圓陷波

  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.31 alimiter

限制器可防止輸入訊號上升超過所需的閾值。此限制器使用前瞻技術來防止訊號失真。這表示在處理訊號後會有一個小的延遲。請記住，它產生的延遲是您設定的啟動時間。

濾鏡接受以下選項

level_in

設定輸入增益。預設值為 1。

level_out

設定輸出增益。預設值為 1。

limit

不要讓高於此水平的訊號通過限制器。預設值為 1。

attack

限制器將在此毫秒數內達到其衰減水平。預設值為 5 毫秒。

release

在此毫秒數內從限制恢復到 1.0 衰減。預設值為 50 毫秒。

asc

當始終需要增益減少時，ASC 會負責釋放到平均減少水平，而不是在釋放時間內達到 0 的減少量。

asc_level

選擇釋放時間受 ASC 影響的程度，0 表示釋放時間幾乎沒有變化，而 1 則產生較長的釋放時間。

level

自動調整輸出訊號的音量。預設為啟用。如果啟用此選項，則會將音訊正規化回 0dB。

latency

補償使用啟動參數設定的前瞻緩衝區引入的延遲。當串流達到 EOF 時，也會刷新前瞻緩衝區中的有效音訊資料。

根據選擇的設定，建議在使用此濾波器之前使用 aresample 將輸入升採樣 2 倍或 4 倍。

8.32 allpass

應用一個二階全通濾波器，其中心頻率（單位為 Hz）為 frequency，濾波器寬度為 width。全通濾波器會更改音訊的頻率與相位關係，而不會更改其頻率與幅度關係。

濾鏡接受以下選項

frequency, f

設定頻率，單位為 Hz。

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

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

始終使用浮點 64 位元。

8.32.1 指令

此濾波器支援以下指令

frequency, f

變更全通頻率。指令的語法為：「frequency」

width_type, t

變更全通 width_type。指令的語法為：「width_type」

width, w

變更全通寬度。指令的語法為：「width」

mix, m

變更全通混合。指令的語法為：「mix」

8.33 aloop

循環音訊樣本。

濾鏡接受以下選項

loop

設定循環次數。將此值設定為 -1 將導致無限循環。預設值為 0。

size

設定最大樣本數。預設值為 0。

start

設定循環的第一個樣本。預設值為 0。

time

以秒為單位設定循環開始時間。僅在名為 start 的選項設定為 -1 時使用。

8.34 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.34.1 範例

• 將兩個單聲道檔案合併為立體聲串流

  amovie=left.wav [l] ; amovie=right.mp3 [r] ; [l] [r] amerge
  

• 假設 input.mkv 中有 1 個視訊串流和 6 個音訊串流的多個合併

  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.35 amix

將多個音訊輸入混合到單個輸出中。

請注意，此濾波器僅支援浮點樣本（amerge 和 pan 音訊濾波器支援多種格式）。如果 amix 輸入具有整數樣本，則會自動插入 aresample 以執行到浮點樣本的轉換。

它接受以下參數

inputs

輸入的數量。如果未指定，則預設為 2。

duration

如何確定串流結束。

longest

最長輸入的持續時間。（預設）

shortest

shortest

最短輸入的持續時間。

first

第一個輸入的持續時間。

dropout_transition

當輸入串流結束時，用於音量重新正規化的過渡時間，單位為秒。預設值為 2 秒。

weights

將每個輸入音訊串流的權重指定為以空格分隔的數字序列。如果指定的權重少於輸入數量，則最後一個權重將分配給剩餘的輸入。每個輸入的預設權重為 1。

normalize

8.35.1 範例

• 始終縮放輸入，而不是僅對樣本求和。如果此選項停用，且輸入在通過此濾波器濾波之前或之後未正規化，請注意嚴重的削波。預設為啟用。

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

• 這會將 3 個輸入音訊串流混合到單個輸出，其持續時間與第一個輸入相同，且丟失過渡時間為 3 秒

  ffmpeg -i VOCALS -i MUSIC -filter_complex amix=inputs=2:duration=longest:dropout_transition=0:weights="1 0.25":normalize=0 OUTPUT
  

8.35.2 指令

此濾波器支援以下指令

當輸入串流結束時，用於音量重新正規化的過渡時間，單位為秒。預設值為 2 秒。

將每個輸入音訊串流的權重指定為以空格分隔的數字序列。如果指定的權重少於輸入數量，則最後一個權重將分配給剩餘的輸入。每個輸入的預設權重為 1。

這會將一個人聲輸入和一個音樂輸入音訊串流混合到單個輸出，其持續時間與最長輸入相同。音樂的權重將為人聲的四分之一，並且輸入未正規化

8.36 amultiply

語法與同名選項相同。

將第一個音訊串流與第二個音訊串流相乘，並將結果儲存在輸出音訊串流中。乘法是通過將第一個串流中的每個樣本與第二個串流中相同位置的樣本相乘來完成的。

8.37 anequalizer

通過此元素級乘法，可以創建幅度淡化和幅度調變。

它接受以下參數

用於每個聲道的高階參數多頻段等化器。

params

此選項字串的格式為：「cchn f=cf w=w g=g t=f | ...」。每個等化器頻段都以 ’|’ 分隔。

chn

nb_channels

設定將應用等化的聲道號碼。如果輸入沒有該聲道，則忽略該條目。

f

設定頻段的中心頻率。如果輸入沒有該頻率，則忽略該條目。

w

以赫茲為單位設定頻寬。

設定傳輸表達式。

g

以 dB 為單位設定頻段增益。

t

設定頻段的濾波器類型，可選，可以是

‘0’

巴特沃斯，這是預設值。

‘1’

切比雪夫類型 1。

‘2’

size

切比雪夫類型 2。

curves

啟用此選項後，將在視訊串流中顯示等化器的頻率響應。

size

設定視訊串流大小。僅在啟用 curves 選項時有用。

mgain

設定將顯示的最大增益。僅在啟用 curves 選項時有用。將其設定為合理的值可以顯示從彼此太近的相鄰頻段導出的增益，因此在兩個頻段都啟用時會產生更高的增益。

8.37.1 範例

• fscale

  anequalizer=c0 f=200 w=100 g=-10 t=1|c1 f=200 w=100 g=-10 t=1
  

8.37.2 指令

此濾波器支援以下指令

設定用於在視訊輸出中繪製頻率響應的頻率刻度。可以是線性或對數。預設值為對數。

colors

設定將在視訊串流中顯示的每個聲道曲線的顏色。這是以空格或 ’|’ 分隔的顏色名稱列表。無法識別或遺失的顏色將替換為白色。

使用切比雪夫類型 1 濾波器，將前 2 個聲道的中心頻率 200Hz 和寬度 100 Hz 的增益降低 10

8.38 anlmdn

change

變更現有的濾波器參數。指令的語法為：「fN|f=freq|w=width|g=gain」

濾鏡接受以下選項

fN 是現有的濾波器編號，從 0 開始，如果沒有此類濾波器可用，則會傳回錯誤。freq 設定新的頻率參數。width 以赫茲為單位設定新的寬度參數。gain 以 dB 為單位設定新的增益參數。

使用 asendcmd 的完整濾波器調用可能如下所示：asendcmd=c=’4.0 anequalizer change 0|f=200|w=50|g=1’,anequalizer=...

使用非局部均值演算法減少音訊樣本中的寬頻雜訊。

每個樣本都會通過尋找具有相似上下文的其他樣本來進行調整。此上下文相似性是通過比較大小為 p 的周圍色塊來定義的。色塊在樣本周圍 r 的區域中搜尋。

strength, s

設定降噪強度。允許範圍為 0.00001 到 10000。預設值為 0.00001。

output, o

設定輸出模式。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

i

傳遞未更改的輸入。

o

傳遞濾除的雜訊。

n

僅傳遞雜訊。

預設值為 o。

patch, p

設定色塊半徑持續時間。允許範圍為 1 到 100 毫秒。預設值為 2 毫秒。

8.38.1 指令

此濾鏡支援以上所有選項作為 commands。

8.39 anlmf, anlms

research, r

設定搜尋半徑持續時間。允許範圍為 2 到 300 毫秒。預設值為 6 毫秒。

以下是接受選項的描述。

order

smooth, m

mu

設定平滑因子。預設值為 11。允許範圍為 1 到 1000。

將正規化最小均方（NLMS）或正規化最小均四方（NLMS4）演算法應用於第一個音訊串流，並使用第二個音訊串流。

此自適應濾波器用於模擬所需的濾波器，方法是尋找與產生誤差訊號（所需訊號，第二個輸入音訊串流與實際訊號，第一個輸入音訊串流之間的差異）的最小均方值相關的濾波器係數。

order

設定濾波器階數。

out_mode

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

i

傳遞第一個輸入。

d

傳遞第二個輸入。

o

傳遞期望訊號、第二個輸入和誤差訊號估計值之間的差異。

n

傳遞輸入訊號、第一個輸入和誤差訊號估計值之間的差異。

e

傳遞誤差訊號估計樣本。

預設值為 o。

precision

設定處理樣本時要使用的精度。

auto

根據其他濾鏡自動選擇內部樣本格式。

float

始終使用單精度浮點精度樣本格式。

double

始終使用雙精度浮點精度樣本格式。

8.39.1 範例

• mu

  asplit[a][b],[a]adelay=32S|32S[a],[b][a]anlms=order=128:leakage=0.0005:mu=.5:out_mode=o
  

8.39.2 指令

設定濾波器 mu。

8.40 anull

eps

8.41 apad

設定濾波器 eps。

leakage

以下是接受選項的描述。

設定濾波器洩漏。

此濾波器的許多用途之一是降噪，輸入音訊使用延遲固定量的相同樣本進行濾波，立體聲音訊的一個範例如下

此濾波器支援與選項相同的指令，但不包括選項 order。

將音訊來源未經更改地傳遞到輸出。

在音訊串流的末尾填充靜音。

這可以與 ffmpeg -shortest 一起使用，以將音訊串流擴展到與視訊串流相同的長度。

packet_size

設定靜音封包大小。預設值為 4096。

pad_len

設定要添加到末尾的靜音樣本數。達到該值後，串流將終止。此選項與 whole_len 互斥。

whole_len

設定輸出音訊串流中的最小樣本總數。如果該值大於輸入音訊長度，則會在末尾添加靜音，直到達到該值。此選項與 pad_len 互斥。

8.41.1 範例

• pad_dur

  apad=pad_len=1024
  

• 指定要添加的靜音樣本的持續時間。請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的時間長度章節 以了解接受的語法。僅在設定為非負值時使用。

  apad=whole_len=10000
  

• whole_dur

  ffmpeg -i VIDEO -i AUDIO -filter_complex "[1:0]apad" -shortest OUTPUT
  

8.42 aphaser

指定輸出音訊串流中的最小總持續時間。請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的時間長度章節 以了解接受的語法。僅在設定為非負值時使用。如果該值大於輸入音訊長度，則會在末尾添加靜音，直到達到該值。此選項與 pad_dur 互斥

如果未設定 pad_len、whole_len、pad_dur 或 whole_dur 選項，則濾波器將無限期地在輸入串流的末尾添加靜音。

將最後設定的延遲用於所有剩餘聲道。預設為停用。如果啟用此選項，則會變更選項 delays 的解讀方式。

自動從偵測濾鏡收集臨界值。預設為「disabled」。此選項可用於偵測輸入音訊串流特定時間範圍內的臨界值，在這種情況下，選項值會在執行時變更。

請注意，對於 ffmpeg 4.4 及更早版本，零 pad_dur 或 whole_dur 也會導致濾波器無限期地添加靜音。

「disabled」

在輸入末尾添加 1024 個靜音樣本

確保音訊輸出將至少包含 10000 個樣本，如果需要，則在輸入中填充靜音

使用 ffmpeg 在音訊輸入中填充靜音，以便在使用 shortest 選項時，視訊串流始終是最短的，並且將轉換到輸出檔案的末尾

向輸入音訊添加相位效果。

相位器濾波器在頻譜中創建一系列峰值和波谷。峰值和波谷的位置會被調變，使其隨時間變化，從而產生掃描效果。

設定輸入增益。預設值為 0.4。

設定輸出增益。預設值為 0.74

將第二個聲道延遲 500 個樣本，將第三個聲道延遲 700 個樣本，並保持第一個聲道（和可能存在的任何其他聲道）不變。

delay

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

設定延遲，單位為毫秒。預設值為 3.0。

decay

8.43 aphaseshift

設定衰減。預設值為 0.4。

濾鏡接受以下選項

shift

speed

level

設定應用於最終輸出的輸出增益。允許範圍為 0.0 到 1.0。預設值為 1.0。

order

設定用於濾波的濾波器階數。允許範圍為 1 到 16。預設值為 8。

8.43.1 指令

此濾鏡支援以上所有選項作為 commands。

8.44 apsnr

設定調變速度，單位為 Hz。預設值為 0.5。

depth

8.45 apsyclip

設定調變類型。預設值為三角形。

濾鏡接受以下選項

level_in

‘triangular, t’

level_out

‘sinusoidal, s’

對輸入音訊樣本應用相位偏移。

phase

指定相位偏移。允許範圍為 -1.0 到 1.0。預設值為 0.0。

測量音訊峰值訊號雜訊比。

adaptive

此濾波器接受兩個音訊串流作為輸入，並輸出第一個音訊串流。結果以 dB 為單位，每個聲道在任一輸入結束時輸出。

將心理聲學削波器應用於輸入音訊串流。

設定輸入增益。預設值為 1。範圍為 [0.015625 - 64]。

level

設定輸出增益。預設值為 1。範圍為 [0.015625 - 64]。

8.45.1 指令

此濾鏡支援以上所有選項作為 commands。

8.46 apulsator

clip

濾鏡接受以下選項

level_in

‘triangular, t’

level_out

‘sinusoidal, s’

mode

設定削波開始值。預設值為 0dBFS 或 1。

amount

diff

僅輸出差分樣本，有助於聽到引入的失真。預設為停用。

distort

設定應用的自適應失真強度。預設值為 0.5。允許範圍為 0 到 1。

iterations

設定心理聲學削波器的迭代次數。允許範圍為 1 到 20。預設值為 10。

normalize

自動調整輸出訊號的音量。預設為停用。如果啟用此選項，則會將音訊正規化回 0dBFS。

音訊脈動器介於自動聲像器和顫音之間。但它也可以產生有趣的立體聲效果。脈動器根據具有不同波形和相位偏移的 LFO（低頻振盪器）來改變左右聲道的音量。此濾波器能夠定義左右聲道之間的偏移。偏移量為 0 表示兩個 LFO 形狀相互匹配。左右聲道會均勻地改變 - 傳統的顫音。偏移量為 50% 表示右聲道的形狀在相位上完全偏移（或向後移動約頻率的一半）- 脈動器充當自動聲像器。在 1 時，兩個曲線再次匹配。介於兩者之間的每個設定都會將相位偏移無間隙地移動到所有階段之間，並產生一些具有正弦波和三角波波形的「旁通」聲音。您將偏移設定得越接近 1（從 0.5 開始），訊號從左揚聲器傳遞到右揚聲器的速度就越快。

shape

設定 LFO 將使用的波形形狀。可以是以下之一：sine、triangle、square、sawup 或 sawdown。預設值為 sine。

modulation

設定調變。定義原始訊號受 LFO 影響的程度。

offset_l

設定左聲道偏移。預設值為 0。允許範圍為 [0 - 1]。

8.47 aresample

offset_r

設定右聲道偏移。預設值為 0.5。允許範圍為 [0 - 1]。

width

8.47.1 範例

• 設定脈衝寬度。預設值為 1。允許範圍為 [0 - 2]。

  aresample=44100
  

• timing

  aresample=async=1000
  

8.48 areverse

設定可能的定時模式。可以是以下之一：bpm、ms 或 hz。預設值為 hz。

bpm

8.48.1 範例

• 設定 bpm。預設值為 120。允許範圍為 [30 - 300]。僅在 timing 設定為 bpm 時使用。

  atrim=end=5,areverse
  

8.49 arls

ms

設定 ms。預設值為 500。允許範圍為 [10 - 2000]。僅在 timing 設定為 ms 時使用。

以下是接受選項的描述。

order

設定濾鏡階數。

hz

以 Hz 為單位設定頻率。預設值為 2。允許範圍為 [0.01 - 100]。僅在 timing 設定為 hz 時使用。

delta

設定係數以初始化內部共變異數矩陣。

out_mode

設定濾鏡輸出樣本。它接受以下值

i

傳遞第一個輸入。

d

傳遞第二個輸入。

o

傳遞期望訊號、第二個輸入和誤差訊號估計值之間的差異。

n

傳遞輸入訊號、第一個輸入和誤差訊號估計值之間的差異。

e

傳遞誤差訊號估計樣本。

預設值為 o。

precision

設定處理樣本時要使用的精度。

auto

根據其他濾鏡自動選擇內部樣本格式。

float

始終使用單精度浮點精度樣本格式。

double

始終使用雙精度浮點精度樣本格式。

8.50 arnndn

使用 libswresample 庫將輸入音訊重新取樣為指定的參數。如果未指定任何參數，則濾波器將自動在其輸入和輸出之間進行轉換。

此濾波器還能夠拉伸/壓縮音訊資料以使其與時間戳記匹配，或注入靜音/剪切音訊以使其與時間戳記匹配，執行兩者的組合或兩者都不執行。

濾波器接受語法 [sample_rate:]resampler_options，其中 sample_rate 表示取樣率，resampler_options 是以 ":" 分隔的 key=value 對列表。請參閱 (ffmpeg-resampler)ffmpeg-resampler(1) 手冊中的「重採樣器選項」章節 以獲取支援選項的完整列表。

將輸入音訊重新取樣為 44100Hz

mix

拉伸/壓縮樣本以符合給定的時間戳記，每秒最多補償 1000 個樣本

8.50.1 指令

此濾鏡支援以上所有選項作為 commands。

8.51 asdr

反轉音訊剪輯。

depth

8.52 asetnsamples

警告：此濾波器需要記憶體來緩衝整個剪輯，因此建議修剪。

擷取剪輯的前 5 秒，然後將其反轉。

濾鏡接受以下選項

將遞歸最小平方演算法應用於第一個音訊串流，並使用第二個音訊串流。

此自適應濾波器用於模擬所需的濾波器，方法是遞歸尋找與產生誤差訊號（所需訊號，第二個輸入音訊串流與實際訊號，第一個輸入音訊串流之間的差異）的最小加權線性最小平方成本函數相關的濾波器係數。

lambda

設定遺忘因子。

使用遞歸神經網路減少語音中的雜訊。

asetnsamples=n=1234:p=0

8.53 asetrate

此濾波器接受以下選項

濾鏡接受以下選項

model, m

設定要載入的訓練模型檔案。此選項始終是必需的。

8.54 ashowinfo

mix

設定將濾波後的樣本混合到最終輸出中的程度。允許範圍為 -1 到 1。預設值為 1。負值是特殊的，它們設定在最終濾波器輸出中保留多少濾波後的雜訊。將此選項設定為 -1 以聽到從輸入訊號中移除的實際雜訊。

測量音訊訊號失真比。

n

設定每個輸出音訊幀的樣本數。

pts

最後一個輸出封包可能包含不同數量的樣本，因為濾波器將在輸入音訊指示其結束時刷新所有剩餘樣本。

nb_out_samples, n

設定每個輸出音訊幀的幀數。該數量旨在作為每個聲道的樣本數。預設值為 1024。

pad, p

如果設定為 1，則濾波器將用零填充最後一個音訊幀，以便最後一個幀將包含與先前幀相同數量的樣本。預設值為 1。

例如，要將每幀樣本數設定為 1234 並停用最後一幀的填充，請使用

設定取樣率而不改變 PCM 資料。這將導致速度和音調的變化。

rate

sample_rate, r

設定輸出取樣率。預設值為 44100 Hz。

顯示包含每個輸入音訊幀的各種資訊的行。輸入音訊未被修改。

顯示的行包含 key:value 形式的鍵/值對序列。

以下值顯示在輸出中

幀

輸入幀的（順序）編號，從 0 開始。

8.55 asisdr

pts

depth

8.56 asoftclip

輸入幀的呈現時間戳記，以時間基底單位表示；時間基底取決於濾波器輸入填充，通常為 1/sample_rate。

pts_time

此濾波器還能夠拉伸/壓縮音訊資料以使其與時間戳記匹配，或注入靜音/剪切音訊以使其與時間戳記匹配，執行兩者的組合或兩者都不執行。

將第二個聲道延遲 500 個樣本，將第三個聲道延遲 700 個樣本，並保持第一個聲道（和可能存在的任何其他聲道）不變。

輸入幀的呈現時間戳記，單位為秒。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

fmt

樣本格式。

chlayout

聲道佈局。

exp

rate

音訊幀的取樣率。

nb_samples

幀中的樣本數（每個聲道）。

threshold

checksum

音訊資料的 Adler-32 檢查碼（以十六進制列印）。對於平面音訊，資料被視為所有平面都已連接。

plane_checksums

每個資料平面的 Adler-32 檢查碼列表。

測量音訊縮放不變訊號失真比。

應用音訊柔削波。

柔削波是一種失真效果類型，其中訊號的幅度沿著平滑曲線飽和，而不是硬削波的突兀形狀。

8.56.1 指令

此濾鏡支援以上所有選項作為 commands。

8.57 aspectralstats

type

設定柔削波的類型。

win_size

hard

win_func

設定視窗函數。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

‘rect’

‘bartlett’

‘hann, hanning’

‘hamming’

‘blackman’

‘welch’

‘flattop’

‘bharris’

‘bnuttall’

‘bhann’

‘sine’

‘nuttall’

‘lanczos’

‘gauss’

‘tukey’

‘dolph’

‘cauchy’

‘parzen’

‘poisson’

‘bohman’

‘kaiser’

預設值為 hann。

overlap

tanh

atan

cubic

alg

quintic

sin

erf

threshold

設定從何處開始削波的閾值。預設值為 0dB 或 1。

output

設定應用於輸出的增益。預設值為 0dB 或 1。

param

設定控制 S 型函數的其他參數。

oversample

斜率

設定過採樣因子。

顯示有關音訊聲道的頻域統計資訊。統計資訊會計算並儲存為每個音訊聲道和每個音訊幀的中繼資料。

8.58 asr

它接受以下選項

window_size

設定視窗長度，以樣本為單位。預設值為 2048。允許範圍為 32 到 65536。

rate

overlap

設定視窗重疊。允許範圍為 0 到 1。預設值為 0.5。

measure

選擇要測量的參數。中繼資料鍵可以用作標誌，預設值為 all，表示測量所有內容。none 停用所有測量。

以下是每個中繼資料鍵的列表

mean

variance

centroid

spread

skewness

kurtosis

entropy

flatness

crest

8.59 astats

flux

設定柔削波的類型。

length

decrease

rolloff

自動語音辨識

此濾波器使用 PocketSphinx 進行語音辨識。要啟用此濾波器的編譯，您需要使用 --enable-pocketsphinx 配置 FFmpeg。

它接受以下選項

samplerate

設定輸入音訊的取樣率。預設值為 16000。這需要與語音模型匹配，否則會得到較差的結果。

hmm

設定包含聲學模型檔案的字典。

dict

設定發音字典。

lm

設定語言模型檔案。

lmctl

none

設定語言模型集。

設定用於設定跨聲道樣本延遲的隨機種子。

lmname

設定要使用的語言模型。

logfn

設定日誌訊息的輸出。

濾波器將辨識的語音匯出為幀中繼資料 lavfi.asr.text。

顯示有關音訊聲道的時域統計資訊。統計資訊會針對每個音訊聲道計算和顯示，並且在適用的情況下，還會給出總體數字。

win_length

短視窗長度，單位為秒，用於峰值和波谷 RMS 測量。預設值為 0.05（50 毫秒）。允許範圍為 [0 - 10]。

metadata

設定中繼資料注入。所有中繼資料鍵都以 lavfi.astats.X 為前綴，其中 X 是從 1 開始的聲道號碼或字串 Overall。預設為停用。

每個聲道的可用鍵為：Bit_depth Crest_factor DC_offset Dynamic_range Entropy Flat_factor Max_difference Max_level Mean_difference Min_difference Min_level Noise_floor Noise_floor_count Number_of_Infs Number_of_NaNs Number_of_denormals Peak_count Abs_Peak_count Peak_level RMS_difference RMS_peak RMS_trough

以及 Overall 的鍵：Bit_depth DC_offset Entropy Flat_factor Max_difference Max_level Mean_difference Min_difference Min_level Noise_floor Noise_floor_count Number_of_Infs Number_of_NaNs Number_of_denormals Number_of_samples Peak_count Abs_Peak_count Peak_level RMS_difference RMS_level RMS_peak RMS_trough

例如，完整的鍵看起來像 lavfi.astats.1.DC_offset 或 lavfi.astats.Overall.Peak_count。

請閱讀以下內容以了解鍵的描述。

reset

設定在重設之前計算累計統計資訊的幀數。預設為停用。

measure_perchannel

選擇每個聲道測量的參數。中繼資料鍵可以用作標誌，預設值為 all，表示測量所有內容。none 停用所有每個聲道測量。

measure_overall

選擇總體測量的參數。中繼資料鍵可以用作標誌，預設值為 all，表示測量所有內容。none 停用所有總體測量。

以下是測量鍵的描述

none

無測量

all

所有測量

Bit_depth

音訊的整體位元深度，即每個樣本使用的位元數

Crest_factor

峰值與 RMS 水平的標準比率（注意：不是以 dB 為單位）

DC_offset

與零的平均幅度位移

Dynamic_range

以 dB 為單位測量的音訊動態範圍

Entropy

在整個音訊中測量的熵，接近 1.0 的熵值通常針對白雜訊測量

Flat_factor

訊號在其峰值水平（即 Min_level 或 Max_level）處的平坦度（即具有相同值的連續樣本）

Max_difference

兩個連續樣本之間的最大差異

Max_level

最大樣本水平

Mean_difference

兩個連續樣本之間的平均差異，即兩個連續樣本之間每個差異的平均值

Min_difference

兩個連續樣本之間的最小差異

Min_level

最小樣本水平

Noise_floor

在短視窗內測量的最小局部峰值，單位為 dBFS

Noise_floor_count

訊號達到 Noise floor 的次數（不是樣本數）

Number_of_Infs

8.60 asubboost

具有無限值的樣本數

濾鏡接受以下選項

dry

Number_of_NaNs

wet

具有 NaN（非數字）值的樣本數

Number_of_denormals

具有次正規化值的樣本數

向輸入音訊添加相位效果。

Number_of_samples

樣本數

Peak_count

訊號達到 Min_level 或 Max_level 的次數（不是樣本數）

Abs_Peak_count

斜率

從訊號中取得的絕對樣本達到 Min_level 和 Max_level 最大絕對值的次數

確保音訊輸出將至少包含 10000 個樣本，如果需要，則在輸入中填充靜音

Peak_level

取樣率

以 dBFS 為單位測量的標準峰值水平

8.60.1 指令

此濾鏡支援以上所有選項作為 commands。

8.61 asubcut

RMS_difference

兩個連續樣本之間的均方根差異

濾鏡接受以下選項

訊號達到 Min_level 或 Max_level 的次數（不是樣本數）

RMS_level

order

以 dBFS 為單位測量的標準 RMS 水平

level

設定輸入增益等級。允許範圍為 0 到 1。預設值為 1。

8.61.1 指令

此濾鏡支援以上所有選項作為 commands。

8.62 asupercut

RMS_peak

濾鏡接受以下選項

訊號達到 Min_level 或 Max_level 的次數（不是樣本數）

RMS_trough

order

以 dBFS 為單位測量的標準 RMS 水平

level

設定輸入增益等級。允許範圍為 0 到 1。預設值為 1。

8.62.1 指令

此濾鏡支援以上所有選項作為 commands。

8.63 asuperpass

在短視窗內測量的 RMS 水平的峰值和波谷值，單位為 dBFS。

濾鏡接受以下選項

Zero crossings

波形穿過零水平軸的點數

order

Zero crossings rate

零交叉率和音訊樣本數

增強超低音頻率。

level

dry

8.63.1 指令

此濾鏡支援以上所有選項作為 commands。

8.64 asuperstop

設定乾聲增益，保留多少原始訊號。允許範圍為 0 到 1。預設值為 1.0。

濾鏡接受以下選項

Zero crossings

波形穿過零水平軸的點數

order

Zero crossings rate

零交叉率和音訊樣本數

增強超低音頻率。

level

dry

8.64.1 指令

此濾鏡支援以上所有選項作為 commands。

8.65 atempo

wet

設定濕聲增益，保留多少濾波訊號。允許範圍為 0 到 1。預設值為 1.0。

boost

8.65.1 範例

• 設定最大增強因子。允許範圍為 1 到 12。預設值為 2。

  atempo=0.8
  

• decay

  atempo=3
  

• 設定延遲線衰減增益值。允許範圍為 0 到 1。預設值為 0.0。

  atempo=sqrt(3),atempo=sqrt(3)
  

8.65.2 指令

此濾波器支援以下指令

feedback

設定延遲線回饋增益值。允許範圍為 0 到 1。預設值為 0.9。

8.66 atilt

cutoff

設定截止頻率，單位為赫茲。允許範圍為 50 到 900。預設值為 100。

濾鏡接受以下選項

freq

slope

斜率

設定截止頻率的斜率量。允許範圍為 0.0001 到 1。預設值為 0.5。

設定心理聲學削波器的迭代次數。允許範圍為 1 到 20。預設值為 10。

delay

order

設定延遲。允許範圍為 1 到 100。預設值為 20。

level

channels

8.66.1 指令

此濾鏡支援以上所有選項作為 commands。

8.67 atrim

設定要處理的聲道。預設值為所有可用聲道。

它接受以下參數

start

削減超低音頻率。

此濾波器允許設定自訂、比高通濾波器更陡峭的滾降，因此能夠更多地衰減阻帶中的頻率內容。

cutoff

設定截止頻率，單位為赫茲。允許範圍為 2 到 200。預設值為 20。

order

設定濾波器階數。可用值為 3 到 20。預設值為 10。

削減超高頻率。

duration

cutoff

設定截止頻率，單位為赫茲。允許範圍為 20000 到 192000。預設值為 20000。

應用高階巴特沃斯帶通濾波器。

centerf

設定中心頻率，單位為赫茲。允許範圍為 2 到 999999。預設值為 1000。

order

設定濾波器階數。可用值為 4 到 20。預設值為 4。

qfactor

設定 Q 因子。允許範圍為 0.01 到 100。預設值為 1。

gain

• 設定輸入增益水平。允許範圍為 0 到 2。預設值為 1。

  ffmpeg -i INPUT -af atrim=60:120
  

• 應用高階巴特沃斯帶阻濾波器。

  ffmpeg -i INPUT -af atrim=end_sample=1000
  

8.68 axcorrelate

調整音訊節奏。

此濾波器正好接受一個參數，即音訊節奏。如果未指定，則濾波器將假定標稱節奏為 1.0。節奏必須在 [0.5, 100.0] 範圍內。

濾鏡接受以下選項

size

請注意，大於 2 的節奏將跳過一些樣本，而不是將它們混合在一起。如果出於任何原因擔心這一點，始終可以菊鏈多個 atempo 實例以達到所需的產品節奏。

將音訊減速到 80% 節奏

將音訊加速到 300% 節奏

8.68.1 範例

• 通過菊鏈兩個 atempo 實例將音訊加速到 300% 節奏

  ffmpeg -i stereo.wav -af channelsplit,axcorrelate=size=1024:algo=fast correlation.wav
  

8.69 bandpass

tempo

濾鏡接受以下選項

frequency, f

變更濾波器節奏縮放因子。指令的語法為：「tempo」

將頻譜傾斜濾波器應用於音訊串流。

此濾波器在任何指定的頻段上應用任何頻譜滾降斜率。

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.69.1 指令

此濾波器支援以下指令

frequency, f

設定傾斜的斜率方向。預設值為 0。允許範圍為 -1 到 1。

width_type, t

width

width, w

設定傾斜的寬度。預設值為 1000。允許範圍為 100 到 10000。

mix, m

order

8.70 bandreject

設定傾斜濾波器的階數。

濾鏡接受以下選項

frequency, f

變更濾波器節奏縮放因子。指令的語法為：「tempo」

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.70.1 指令

此濾波器支援以下指令

frequency, f

volume

width_type, t

設定輸入音量水平。允許範圍為 0 到 4。預設值為 1。

width, w

修剪輸入，使輸出包含輸入的一個連續子部分。

mix, m

start

8.71 bass, lowshelf

要保留的區段的開始時間戳記（以秒為單位）。即，時間戳記為 start 的音訊樣本將是輸出中的第一個樣本。

濾鏡接受以下選項

end

指定將丟棄的第一個音訊樣本的時間，即時間戳記為 end 的音訊樣本之前的音訊樣本將是輸出中的最後一個樣本。

frequency, f

start_pts

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

與 start 相同，不同之處在於此選項以樣本而不是秒為單位設定開始時間戳記。

poles, p

end_pts

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.71.1 指令

此濾波器支援以下指令

frequency, f

與 end 相同，不同之處在於此選項以樣本而不是秒為單位設定結束時間戳記。

width_type, t

duration

width, w

輸出的最大持續時間，單位為秒。

end

start_sample

mix, m

應輸出的第一個樣本的編號。

8.72 biquad

end_sample

8.72.1 指令

此濾波器支援以下指令

應丟棄的第一個樣本的編號。

start、end 和 duration 以時間長度規格表示；請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的時間長度章節。

請注意，前兩組開始/結束選項和 duration 選項會查看幀時間戳記，而 _sample 選項僅計算通過濾波器的樣本。因此，當時間戳記錯誤、不精確或未從零開始時，start/end_pts 和 start/end_sample 將給出不同的結果。另請注意，此濾波器不會修改時間戳記。如果您希望輸出時間戳記從零開始，請在 atrim 濾波器之後插入 asetpts 濾波器。

如果設定了多個開始或結束選項，此濾波器會盡力貪婪地保留至少符合一個指定約束的所有樣本。要僅保留同時符合所有約束的部分，請鏈接多個 atrim 濾波器。

預設值是保留所有輸入。因此，可以設定例如僅結束值以保留指定時間之前的所有內容。

範例

丟棄除輸入的第二分鐘之外的所有內容

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.73 bs2b

僅保留前 1000 個樣本

計算兩個輸入音訊串流之間正規化視窗互相關。

它接受以下參數

profile

結果樣本始終介於 -1 和 1 之間（包含端點）。如果結果為 1，則表示兩個輸入樣本在選定區段中高度相關。結果 0 表示它們根本不相關。如果結果為 -1，則表示兩個輸入樣本異相，這表示它們相互抵消。

default

size

設定計算互相關的區段大小。預設值為 256。允許範圍為 2 到 131072。

algo

設定互相關的演算法。可以是 slow 或 fast 或 best。預設值為 best。快速演算法假定任何給定區段的平均值始終為零，因此需要更少的計算。這通常不是真的，但對於典型的音訊串流是有效的。

計算立體聲音訊串流中聲道之間的相關性

應用一個二極巴特沃斯帶通濾波器，其中心頻率為 frequency，（3dB 點）頻寬寬度。如果設定 csg 選項，則會選擇恆定裙邊增益（峰值增益 = Q），而不是預設值：恆定 0dB 峰值增益。濾波器以每八度音程 6dB（每十年 20dB）的速度滾降。

frequency, f

設定濾波器的中心頻率。預設值為 3000。

csg

8.74 channelmap

如果設定為 1，則為恆定裙邊增益。預設值為 0。

它接受以下參數

block_size, b

設定用於反向 IIR 處理的區塊大小。如果此值設定得足夠高（高於脈衝響應長度在接近零值時截斷的長度），則濾波將變為線性相位，否則如果不夠大，則只會產生令人討厭的偽影。

請注意，當設定為非零值時，濾波器延遲將正好是這麼多樣本。

變更帶通頻率。指令的語法為：「frequency」

變更帶通 width_type。指令的語法為：「width_type」

8.74.1 範例

• 變更帶通寬度。指令的語法為：「width」

  ffmpeg -i in.mov -filter 'channelmap=map=DL-FL|DR-FR' out.wav
  

  變更帶通混合。指令的語法為：「mix」

• 應用一個二極巴特沃斯帶阻濾波器，其中心頻率為 frequency，（3dB 點）頻寬為 width。濾波器以每八度音程 6dB（每十年 20dB）的速度滾降。

  ffmpeg -i in.wav -filter 'channelmap=1|2|0|5|3|4:5.1' out.wav
  

8.75 channelsplit

變更帶阻頻率。指令的語法為：「frequency」

它接受以下參數

請注意，當設定為非零值時，濾波器延遲將正好是這麼多樣本。

變更帶阻 width_type。指令的語法為：「width_type」

取樣率

變更帶阻寬度。指令的語法為：「width」

變更帶阻混合。指令的語法為：「mix」

8.75.1 範例

• 使用二極擱架式濾波器（其響應類似於標準高保真音響的音調控制）增強或削減音訊的低音（較低）頻率。這也稱為擱架式等化 (EQ)。

  ffmpeg -i in.mp3 -filter_complex channelsplit out.mkv
  

  gain, g

• 給出 0 Hz 的增益。其有用範圍約為 -20（用於大幅度削減）到 +20（用於大幅度增強）。使用正增益時請注意削波。

  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
  

• frequency

  ffmpeg -i in.wav -filter_complex 'channelsplit=channel_layout=5.1:channels=LFE[LFE]'
  -map '[LFE]' lfe.wav
  

8.76 chorus

設定濾波器的中心頻率，因此可用於擴展或縮減要增強或削減的頻率範圍。預設值為 100 Hz。

width_type

確定濾波器的擱架式過渡有多陡峭。

它接受以下參數

自動從偵測濾鏡收集臨界值。預設為「disabled」。此選項可用於偵測輸入音訊串流特定時間範圍內的臨界值，在這種情況下，選項值會在執行時變更。

請注意，對於 ffmpeg 4.4 及更早版本，零 pad_dur 或 whole_dur 也會導致濾波器無限期地添加靜音。

「disabled」

設定輸出增益。預設值為 0.4。

設定濾鏡處理的去相關性階段。允許範圍為從 1 到 16。預設值為 6。

設定延遲。一般的延遲時間約為 40 毫秒到 60 毫秒。

停止選取臨界值。

設定衰減。

速度

設定速度。

深度

設定深度。

8.76.1 範例

• 單一延遲

  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.77 compand

壓縮或擴展音訊的動態範圍。

它接受以下參數

起音 (attacks)

停止選取臨界值。

每個聲道的時間列表（以秒為單位），輸入訊號的瞬時音量在此時間內被平均，以確定其音量。attacks 指的是音量增加，而 decays 指的是音量減少。在大多數情況下，起音時間（對音訊變大的反應）應短於衰減時間（對音訊變小的反應），因為人耳對突然變大的音訊比對突然變小的音訊更敏感。典型的起音值為 0.3 秒，典型的衰減值為 0.8 秒。如果指定的起音和衰減數量少於聲道數，則最後設定的起音/衰減將用於所有剩餘聲道。

點 (points)

傳輸函數的點列表，以相對於最大可能訊號幅度的 dB 為單位指定。每個關鍵點列表都必須使用以下語法定義：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)

設定所有接合點的曲線半徑，單位為 dB。預設值為 0.01。

增益 (gain)

設定要應用於傳輸函數上所有點的額外增益，單位為 dB。這允許輕鬆調整整體增益。預設值為 0。

音量 (volume)

設定每個聲道在濾波開始時假定的初始音量，單位為 dB。這允許使用者提供一個初始的標稱音量，例如，在壓縮開始運作之前，不會對初始訊號音量應用非常大的增益。對於最初很安靜的音訊，典型值為 -90 dB。預設值為 0。

確保音訊輸出將至少包含 10000 個樣本，如果需要，則在輸入中填充靜音

設定延遲，單位為秒。輸入音訊會立即被分析，但音訊在饋送到音量調整器之前會被延遲。指定一個約等於起音/衰減時間的延遲，可以使濾波器有效地以預測模式而不是反應模式運作。預設值為 0。

8.77.1 範例

• 使音樂的安靜和響亮段落都適合在嘈雜環境中聆聽

  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
  

• 從 -6dB 開始的 2:1 壓縮

  compand=points=-80/-80|-6/-6|0/-3.8|20/3.5
  

• 從 -9dB 開始的 2:1 壓縮

  compand=points=-80/-80|-9/-9|0/-5.3|20/2.9
  

• 從 -12dB 開始的 2:1 壓縮

  compand=points=-80/-80|-12/-12|0/-6.8|20/1.9
  

• 從 -18dB 開始的 2:1 壓縮

  compand=points=-80/-80|-18/-18|0/-9.8|20/0.7
  

• 從 -15dB 開始的 3:1 壓縮

  compand=points=-80/-80|-15/-15|0/-10.8|20/-5.2
  

• 壓縮器/閘 (Compressor/Gate)

  compand=points=-80/-105|-62/-80|-15.4/-15.4|0/-12|20/-7.6
  

• 擴展器 (Expander)

  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
  

• 在 -6dB 的硬式限制器 (Hard limiter)

  compand=attacks=0:points=-80/-80|-6/-6|20/-6
  

• 在 -12dB 的硬式限制器 (Hard limiter)

  compand=attacks=0:points=-80/-80|-12/-12|20/-12
  

• 在 -35 dB 的硬式雜訊閘 (Hard noise gate)

  compand=attacks=0:points=-80/-115|-35.1/-80|-35/-35|20/20
  

• 柔式限制器 (Soft limiter)

  compand=attacks=0:points=-80/-80|-12.4/-12.4|-6/-8|0/-6.8|20/-2.8
  

8.78 compensationdelay

補償延遲線 (Compensation Delay Line) 是一種基於公制的延遲，用於補償麥克風或喇叭的不同位置。

例如，您使用放置在不同位置的兩個麥克風錄製了吉他。由於聲波前進在正常條件下具有固定的速度，因此麥克風的相位可能會有所不同，並且取決於它們的位置和相互位置。當這些麥克風同相位（同步）時，可以獲得最佳的聲音混音。請注意，麥克風之間約 30 公分的距離會使一個麥克風捕捉到的訊號與另一個麥克風的訊號反相。這會使最終混音聽起來沉悶。此濾波器通過為每個麥克風軌道添加不同的延遲並使其同步來幫助解決相位問題。

當您將一個軌道作為基準並將其他軌道逐一與其同步時，可以達到最佳效果。請記住，同步/延遲容限也取決於取樣率。較高的取樣率將提供更大的容限。

此濾波器接受以下參數

mm

設定毫米距離。這是用於微調的補償距離。預設值為 0。

cm

設定公分距離。這是用於收緊距離設定的補償距離。預設值為 0。

m

設定公尺距離。這是用於硬性距離設定的補償距離。預設值為 0。

dry

設定乾訊號量。未處理（乾）訊號的量。預設值為 0。

wet

設定濕訊號量。已處理（濕）訊號的量。預設值為 1。

temp

設定攝氏溫度。這是環境溫度。預設值為 20。

8.78.1 指令

此濾鏡支援以上所有選項作為 commands。

8.79 crossfeed

套用耳機聲場 (headphone crossfeed) 濾波器。

聲場 (Crossfeed) 是混合立體聲音訊錄音的左右聲道的過程。它主要用於減少低頻的極端立體聲分離。

目的是為聽者產生更像喇叭的聲音。

濾鏡接受以下選項

強度 (strength)

設定聲場 (crossfeed) 的強度。預設值為 0.2。允許範圍為 0 到 1。這設定立體聲影像側邊部分的低頻擱架濾波器的增益。預設值為 -6dB。當強度設定為 1 時，最大允許值為 -30db。

設定用於偵測濾鏡的偵測頻率（以 Hz 為單位），該偵測濾鏡用於觸發等化。預設值為 1000 Hz。允許範圍介於 2 和 1000000 Hz 之間。

設定聲場寬度 (soundstage wideness)。預設值為 0.5。允許範圍為 0 到 1。這設定低頻擱架濾波器的截止頻率。預設值為接近 1550 Hz 的截止頻率。當範圍設定為 1 時，截止頻率設定為 2100 Hz。

斜率

設定低頻擱架濾波器的曲線斜率。預設值為 0.5。允許範圍為 0.01 到 1。

level_in

設定輸入增益。預設值為 0.9。

level_out

設定輸出增益。預設值為 1。

block_size

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.79.1 指令

此濾鏡支援以上所有選項作為 commands。

8.80 crystalizer

用於音訊雜訊銳化的簡單演算法。

此濾波器線性地增加每個音訊樣本之間的差異。

濾鏡接受以下選項

i

設定效果強度（預設值：2.0）。必須在 -10.0 到 0（聲音不變）到 10.0（最大效果）的範圍內。要反轉濾波，請使用負值。

c

啟用削波 (clipping)。預設為啟用。

8.80.1 指令

此濾鏡支援以上所有選項作為 commands。

8.81 dcshift

對音訊套用直流偏移 (DC shift)。

這可用於從音訊中移除直流偏移（可能由錄音鏈中的硬體問題引起）。直流偏移的效果是降低動態餘裕 (headroom)，進而降低音量。astats 濾波器可用於確定訊號是否具有直流偏移。

shift

設定直流偏移量，允許範圍為 [-1, 1]。它表示音訊的偏移量。

limitergain

可選。它應該有一個遠小於 1 的值（例如 0.05 或 0.02），用於防止削波 (clipping)。

8.82 deesser

對音訊樣本套用齒音消除 (de-essing)。

i

設定觸發齒音消除 (de-essing) 的強度。允許範圍為 0 到 1。預設值為 0。

m

設定對聲音高音部分進行衰減 (ducking) 的程度。允許範圍為 0 到 1。預設值為 0.5。

nb_channels

齒音消除 (de-essing) 時要保留多少原始頻率內容。允許範圍為 0 到 1。預設值為 0.5。

s

設定輸出模式。

設定叢發融合，以視窗大小的百分比表示。允許範圍為 0 到 10。預設值為 2。如果偵測為雜訊的任何兩個樣本之間的間隔小於此值，則這兩個樣本之間的任何樣本也將被偵測為雜訊。

i

傳遞未更改的輸入。

o

通過濾除的齒音 (ess)。

e

僅通過齒音 (ess)。

預設值為 o。

8.83 dialoguenhance

增強立體聲音訊中的對話。

此濾波器接受立體聲輸入並產生環繞聲 (3.0) 聲道輸出。新產生的前置中央聲道具有增強的語音對話，最初在立體聲聲道中可用。此濾波器輸出的前置左聲道和前置右聲道與立體聲輸入中的聲道相同。

濾鏡接受以下選項

原始 (original)

設定在前置中央聲道輸出中保留的原始中央聲道因子。允許範圍為 0 到 1。預設值為 1。

增強 (enhance)

設定要放入前置中央聲道輸出的對話增強因子。允許範圍為 0 到 3。預設值為 1。

語音 (voice)

設定語音偵測因子。允許範圍為 2 到 32。預設值為 2。

8.83.1 指令

此濾鏡支援以上所有選項作為 commands。

8.84 drmeter

測量音訊動態範圍。

DR 值為 14 或更高時，表示非常動態的素材。DR 值為 8 到 13 時，表示過渡素材。任何小於 8 的值都具有非常差的動態，並且被高度壓縮。

濾鏡接受以下選項

length

設定用於將音訊分割成相等長度片段的視窗長度，單位為秒。預設值為 3 秒。

8.85 dynaudnorm

動態音訊正規化器 (Dynamic Audio Normalizer)。

此濾波器對輸入音訊應用一定量的增益，以使其峰值幅度達到目標水平（例如 0 dBFS）。但是，與更「簡單」的正規化演算法相比，動態音訊正規化器會*動態地*重新調整輸入音訊的增益因子。這允許對音訊的「安靜」部分應用額外增益，同時避免「響亮」部分的失真或削波 (clipping)。換句話說：動態音訊正規化器將「均勻化」安靜和響亮部分的音量，從某種意義上說，每個部分的音量都被帶到相同的目標水平。但是請注意，動態音訊正規化器在實現此目標時*沒有*應用「動態範圍壓縮」。它將保留音訊檔案每個部分*內* 100% 的動態範圍。

framelen, f

設定幀長度，單位為毫秒。範圍從 10 到 8000 毫秒。預設值為 500 毫秒。動態音訊正規化器以小塊處理輸入音訊，稱為幀。這是必需的，因為峰值幅度對於僅單個樣本值沒有意義。相反，我們需要確定連續樣本值序列的峰值幅度。雖然「標準」正規化器只會使用完整檔案的峰值幅度，但動態音訊正規化器會單獨確定每個幀的峰值幅度。幀的長度以毫秒為單位指定。預設情況下，動態音訊正規化器使用 500 毫秒的幀長度，這已被發現對於大多數檔案都能提供良好的結果。請注意，幀的確切長度（以樣本數為單位）將根據個別輸入音訊檔案的取樣率自動確定。

gausssize, g

設定高斯濾波器視窗大小。範圍從 3 到 301，必須為奇數。預設值為 31。動態音訊正規化器最重要的參數可能是高斯平滑濾波器的 視窗大小。濾波器的視窗大小以幀為單位指定，以當前幀為中心。為了簡單起見，這必須是一個奇數。因此，預設值 31 會考慮到當前幀，以及前 15 個幀和後 15 個幀。使用較大的視窗會產生更強的平滑效果，從而減少增益變化，即較慢的增益適應。相反，使用較小的視窗會產生較弱的平滑效果，從而產生更多的增益變化，即更快的增益適應。換句話說，您越增加此值，動態音訊正規化器的行為就越像「傳統」正規化濾波器。相反，您越減少此值，動態音訊正規化器的行為就越像動態範圍壓縮器。

peak, p

設定目標峰值。這指定正規化音訊輸入的最高允許幅度水平。此濾波器將嘗試盡可能接近目標峰值幅度，但同時它也確保正規化訊號永遠不會超過峰值幅度。幀的最大本地增益因子直接由目標峰值幅度施加。預設值為 0.95，因此保留了 5%* 的動態餘裕 (headroom)。不建議超過此值。

maxgain, m

設定最大增益因子。範圍從 1.0 到 100.0。預設值為 10.0。動態音訊正規化器確定每個輸入幀的最大可能（本地）增益因子，即不會導致削波 (clipping) 或失真的最大增益因子。最大增益因子由幀的最高幅度樣本確定。但是，動態音訊正規化器還將幀的最大增益因子限制在預定的（全域）最大增益因子內。這樣做的目的是為了避免在「靜音」或幾乎靜音的幀中出現過大的增益因子。預設情況下，最大增益因子為 10.0。對於大多數輸入，預設值應該足夠，通常不建議增加此值。但是，對於整體音量水平極低的輸入，可能有必要允許更高的增益因子。但是請注意，動態音訊正規化器並非簡單地應用「硬」閾值（即，切斷高於閾值的值）。相反，將應用「S 型」閾值函數。這樣，增益因子將平滑地接近閾值，但永遠不會超過該值。

targetrms, r

設定目標 RMS。範圍從 0.0 到 1.0。預設值為 0.0 - 停用。預設情況下，動態音訊正規化器執行「峰值」正規化。這表示每個幀的最大本地增益因子僅由幀的最高幅度樣本定義。這樣，樣本可以被盡可能地放大，而不會超過最大訊號水平，即不會削波 (clipping)。但是，可選地，動態音訊正規化器也可以考慮幀的均方根值 (root mean square)，縮寫為 RMS。在電機工程中，RMS 通常用於確定時變訊號的功率。因此，人們認為 RMS 比僅查看訊號的峰值幅度更能近似「感知響度」。因此，通過將所有幀調整為恆定的 RMS 值，可以建立均勻的「感知響度」。如果已指定目標 RMS 值，則幀的本地增益因子被定義為將導致該 RMS 值的因子。但是請注意，最大本地增益因子仍然受到幀的最高幅度樣本的限制，以防止削波 (clipping)。

coupling, n

啟用聲道耦合 (channels coupling)。預設為啟用。預設情況下，動態音訊正規化器將所有聲道放大相同的量。這表示相同的增益因子將應用於所有聲道，即最大可能的增益因子由「最響亮」的聲道確定。但是，在某些錄音中，不同聲道的音量可能會不均勻，例如，一個聲道可能比其他聲道「安靜」。在這種情況下，可以使用此選項停用聲道耦合。這樣，增益因子將針對每個聲道獨立確定，僅取決於個別聲道的最高幅度樣本。這允許協調不同聲道的音量。

correctdc, c

啟用直流偏移校正 (DC bias correction)。預設為停用。音訊訊號（在時域中）是樣本值序列。在動態音訊正規化器中，這些樣本值以 -1.0 到 1.0 的範圍表示，而與原始輸入格式無關。通常，音訊訊號或「波形」應以零點為中心。這表示如果我們計算檔案中或單個幀中所有樣本的平均值，則結果應為 0.0 或至少非常接近該值。但是，如果平均值與 0.0 有顯著偏差，無論是正方向還是負方向，這都稱為直流偏移或 DC 偏移。由於直流偏移顯然是不希望有的，因此動態音訊正規化器提供可選的直流偏移校正。啟用直流偏移校正後，動態音訊正規化器將確定每個輸入幀的平均值或「直流校正」偏移量，並從幀的所有樣本值中減去該值，這確保了這些樣本再次以 0.0 為中心。此外，為了避免幀邊界處出現「間隙」，直流校正偏移值將在相鄰幀之間平滑插值。

altboundary, b

啟用替代邊界模式 (alternative boundary mode)。預設為停用。動態音訊正規化器會考慮每個幀周圍的特定鄰域。這包括先前的幀以及後續的幀。但是，對於位於音訊檔案最開始和最結尾的「邊界」幀，並非所有相鄰幀都可用。特別是，對於音訊檔案中的前幾個幀，先前的幀是未知的。並且，類似地，對於音訊檔案中的最後幾個幀，後續的幀是未知的。因此，問題出現了，對於「邊界」區域中遺失的幀，應該假定哪些增益因子。動態音訊正規化器實作了兩種模式來處理這種情況。預設邊界模式假設遺失幀的增益因子正好為 1.0，從而在輸入的開始和結尾分別產生平滑的「淡入」和「淡出」。

compress, s

設定壓縮因子。範圍從 0.0 到 30.0。預設值為 0.0。預設情況下，動態音訊正規化器不應用「傳統」壓縮。這表示訊號峰值不會被修剪，因此每個本地鄰域內將保留完整的動態範圍。但是，在某些情況下，可能希望將動態音訊正規化器的正規化演算法與更「傳統」的壓縮結合使用。為此，動態音訊正規化器提供可選的壓縮（閾值）函數。如果（且僅當）啟用壓縮功能時，所有輸入幀都將在實際正規化過程之前通過柔膝閾值函數處理。簡而言之，閾值函數將修剪所有幅度超過特定閾值的樣本。但是，動態音訊正規化器並非簡單地應用固定的閾值。相反，閾值將針對每個個別幀進行調整。通常，較小的參數會導致更強的壓縮，反之亦然。不建議使用低於 3.0 的值，因為可能會出現可聽見的失真。

設定視窗重疊，以視窗大小的百分比表示。允許範圍為從 50 到 95。預設值為 75%。將此設定為非常高的值會增加脈衝雜訊移除，但會使整個過程慢得多。

設定目標閾值。這指定將被正規化的音訊輸入的最低允許幅度水平。如果輸入幀音量高於此值，則幀將被正規化。否則，幀可能根本不會被正規化。預設值設定為 0，表示所有輸入幀都將被正規化。如果不想放大數位雜訊，此選項最有用。

channels, h

指定要濾波的聲道，預設情況下會濾波所有可用的聲道。

overlap, o

指定幀的重疊。如果設定為 0（預設值），則不進行幀重疊。使用 >0 和 <1 的值將進行不太保守的增益調整，就像當 framelen 選項設定為較小值時一樣，如果 framelen 選項值針對非零重疊進行補償，則增益調整在時間上將比零重疊情況更平滑。

curve, v

指定峰值映射曲線表達式，該表達式將用於計算應用於幀的增益。最大輸出幀增益仍將受到此濾波器先前提及的其他選項的限制。

pulse

新增脈衝訊號。

預設值為 dc。

計算音訊串流的導數/積分。

依序套用兩個濾鏡會產生原始音訊。

將頻譜動態範圍控制器濾鏡套用於輸入音訊串流。

transfer

設定傳輸表達式。

表達式可以包含以下常數

ch

目前聲道號碼

sn

當前幀峰值

8.85.1 指令

此濾鏡支援以上所有選項作為 commands。

8.86 earwax

使音訊在耳機上更容易聆聽。

此濾波器向 44.1kHz 立體聲（即音訊 CD 格式）音訊添加「提示」，以便在耳機上聆聽時，立體聲影像從您的頭部內部（耳機的標準）移動到聽者外部和前方（喇叭的標準）。

從 SoX 移植。

8.87 equalizer

套用雙極峰值等化 (EQ) 濾波器。使用此濾波器，可以在選定頻率及其周圍增加或減少訊號水平，同時（與帶通和帶阻濾波器不同）所有其他頻率的訊號水平保持不變。

為了產生複雜的等化曲線，可以多次給定此濾波器，每次使用不同的中心頻率。

濾鏡接受以下選項

frequency, f

設定濾波器的中心頻率，單位為 Hz。

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。

end

設定所需的增益或衰減，單位為 dB。使用正增益時請注意削波 (clipping)。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.87.1 範例

• 在 1000 Hz 衰減 10 dB，頻寬為 200 Hz

  equalizer=f=1000:t=h:width=200:g=-10
  

• 在 1000 Hz 套用 2 dB 增益，Q 值為 1，並在 100 Hz 衰減 5 dB，Q 值為 2

  equalizer=f=1000:t=q:w=1:g=2,equalizer=f=100:t=q:w=2:g=-5
  

8.87.2 指令

此濾波器支援以下指令

frequency, f

變更等化器頻率。指令的語法為：「<var>frequency</var>」

width_type, t

變更等化器 width_type。指令的語法為：「<var>width_type</var>」

width, w

變更等化器寬度。指令的語法為：「<var>width</var>」

end

變更等化器增益。指令的語法為：「<var>gain</var>」

mix, m

變更等化器混音。指令的語法為：「<var>mix</var>」

8.88 extrastereo

線性地增加左右聲道之間的差異，這為播放添加某種「現場」效果。

濾鏡接受以下選項

m

設定差異係數（預設值：2.5）。0.0 表示單聲道聲音（兩個聲道的平均值），1.0 表示聲音不變，-1.0 表示左右聲道將被交換。

c

啟用削波 (clipping)。預設為啟用。

8.88.1 指令

此濾鏡支援以上所有選項作為 commands。

8.89 firequalizer

使用任意頻率響應套用 FIR 等化。

stages

增益 (gain)

設定增益曲線方程式（單位為 dB）。表達式可以包含變數

nb_channels

已評估的頻率

ch

目前聲道號碼

新增脈衝訊號。

聲道號碼，當停用多聲道評估時設定為 0

chid

聲道 ID，請參閱 libavutil/channel_layout.h，當停用多聲道評估時設定為第一個聲道 ID

chs

transfer

例如，要將每幀樣本數設定為 1234 並停用最後一幀的填充，請使用

channel_layout，請參閱 libavutil/channel_layout.h

和函數

gain_interpolate(f)

根據 gain_entry 在頻率 f 上插值增益

cubic_interpolate(f)

與 gain_interpolate 相同，但更平滑

此選項也可用作指令。預設值為 gain_interpolate(f)。

gain_entry

為 gain_interpolate 函數設定增益條目。表達式可以包含函數

entry(f, g)

以值 g 在頻率 f 處儲存增益條目

此選項也可用作指令。

確保音訊輸出將至少包含 10000 個樣本，如果需要，則在輸入中填充靜音

設定濾波器延遲，單位為秒。值越高表示越準確。預設值為 0.01。

accuracy

設定濾波器準確度，單位為 Hz。值越低表示越準確。預設值為 5。

wfunc

設定視窗函數。可接受的值為

rectangular

矩形視窗，當增益曲線已經平滑時很有用

hann

漢恩 (hann) 視窗（預設值）

hamming

漢明 (hamming) 視窗

blackman

布萊克曼 (blackman) 視窗

nuttall3

3 項連續一階導數納塔爾 (nuttall) 視窗

mnuttall3

最小 3 項不連續納塔爾 (nuttall) 視窗

nuttall

4 項連續一階導數納塔爾 (nuttall) 視窗

bnuttall

最小 4 項不連續納塔爾 (nuttall)（布萊克曼-納塔爾 (blackman-nuttall)）視窗

bharris

布萊克曼-哈里斯 (blackman-harris) 視窗

tukey

圖基 (tukey) 視窗

fixed

如果啟用，則使用固定數量的音訊樣本。這提高了使用大延遲進行濾波時的速度。預設為停用。

multi

在增益上啟用多聲道評估。預設為停用。

zero_phase

通過減去時間戳以補償延遲來啟用零相位模式。預設為停用。

scale

設定增益使用的比例。可接受的值為

linlin

線性頻率，線性增益

linlog

線性頻率，對數（以 dB 為單位）增益（預設值）

loglin

對數（在 20 Hz 為 0 的八度音階中）頻率，線性增益

loglog

對數頻率，對數增益

dumpfile

設定用於轉儲的檔案，適用於 gnuplot。

dumpscale

設定 dumpfile 的比例。可接受的值與 scale 選項相同。預設值為 linlog。

fft2

啟用使用複數 FFT 的 2 聲道迴旋積。這顯著提高了速度。預設為停用。

min_phase

啟用最小相位脈衝響應。預設為停用。

8.89.1 範例

• 在 1000 Hz 的低通濾波器

  firequalizer=gain='if(lt(f,1000), 0, -INF)'
  

• 在 1000 Hz 的低通濾波器，帶有 gain_entry

  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.90 flanger

對音訊套用鑲邊 (flanging) 效果。

濾鏡接受以下選項

確保音訊輸出將至少包含 10000 個樣本，如果需要，則在輸入中填充靜音

設定基礎延遲，單位為毫秒。範圍從 0 到 30。預設值為 0。

深度 (depth)

設定新增的掃頻延遲，單位為毫秒。範圍從 0 到 10。預設值為 2。

regen

設定再生百分比（延遲訊號回饋）。範圍從 -95 到 95。預設值為 0。

設定心理聲學削波器的迭代次數。允許範圍為 1 到 20。預設值為 10。

設定與原始訊號混合的延遲訊號的百分比。範圍從 0 到 100。預設值為 71。

設定輸入增益。預設值為 0.4。

設定每秒掃頻次數 (Hz)。範圍從 0.1 到 10。預設值為 0.5。

形狀 (shape)

設定掃頻波形狀，可以是 <var>triangular</var> 或 <var>sinusoidal</var>。預設值為 <var>sinusoidal</var>。

相位 (phase)

設定多聲道的掃頻波形百分比偏移。範圍從 0 到 100。預設值為 25。

interp

設定延遲線插值，<var>linear</var> 或 <var>quadratic</var>。預設值為 <var>linear</var>。

8.91 haas

對音訊套用哈斯 (Haas) 效果。

請注意，這最適合應用於單聲道訊號。將此濾波器應用於單聲道訊號，可以賦予其方向性並擴展其立體聲影像。

濾鏡接受以下選項

level_in

設定輸入音量。預設值為 <var>1</var>，或 0dB

level_out

設定輸出音量。預設值為 <var>1</var>，或 0dB。

side_gain

設定應用於訊號側邊部分的增益。預設值為 <var>1</var>。

middle_source

設定中間訊號源的種類。可以是以下之一

‘<samp>left</samp>’

選擇左聲道。

‘<samp>right</samp>’

選擇右聲道。

‘<samp>mid</samp>’

選擇立體聲影像的中間部分訊號。

‘<samp>side</samp>’

選擇立體聲影像的側邊部分訊號。

middle_phase

變更中間相位。預設為停用。

left_delay

設定左聲道延遲。預設值為 <var>2.05</var> 毫秒。

left_balance

設定左聲道平衡。預設值為 <var>-1</var>。

left_gain

設定左聲道增益。預設值為 <var>1</var>。

left_phase

變更左相位。預設為停用。

right_delay

設定右聲道延遲。預設值為 <var>2.12</var> 毫秒。

right_balance

設定右聲道平衡。預設值為 <var>1</var>。

right_gain

設定右聲道增益。預設值為 <var>1</var>。

right_phase

變更右相位。預設為啟用。

8.92 hdcd

解碼高解析度相容數位 (HDCD) 數據。具有嵌入式 HDCD 代碼的 16 位元 PCM 流被擴展為 20 位元 PCM 流。

此濾波器支援 HDCD 的峰值擴展和低音量增益調整功能，並偵測瞬態濾波器標誌。

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

即使未發出 PE 訊號，也始終擴展高於 -3dBFS 的峰值。

analyze_mode

用純音取代音訊並調整幅度以指示解碼過程的某些特定方面。輸出檔案可以與原始檔案一起載入音訊編輯器中，以協助分析。

analyze_mode=pe:force_pe=true 可用於查看 PE 水平以上的所有樣本。

模式為

‘<samp>0, off</samp>’

停用

‘<samp>1, lle</samp>’

每個樣本的增益調整水平

‘<samp>2, pe</samp>’

發生峰值擴展的樣本

‘<samp>3, cdt</samp>’

代碼偵測計時器處於活動狀態的樣本

‘<samp>4, tgm</samp>’

聲道之間的目標增益不匹配的樣本

8.93 headphone

套用頭部相關傳輸函數 (HRTF) 以在使用者周圍創建虛擬喇叭，以便通過耳機進行雙耳聆聽。HRIR 通過額外的流提供，每個聲道需要一個立體聲輸入流。

濾鏡接受以下選項

block_size, b

設定用於迴旋積的輸入流映射。參數是以「|」分隔的聲道名稱列表，順序與它們作為濾波器的額外流輸入給出的順序相同。這也指定了輸入流的數量。輸入流的數量必須不小於第一個流中的聲道數加一。

增益 (gain)

設定應用於音訊的增益。值以 dB 為單位。預設值為 0。

將第二個聲道延遲 500 個樣本，將第三個聲道延遲 700 個樣本，並保持第一個聲道（和可能存在的任何其他聲道）不變。

設定處理類型。可以是 <var>time</var> 或 <var>freq</var>。<var>time</var> 是在時域中處理音訊，速度較慢。<var>freq</var> 是在頻域中處理音訊，速度較快。預設值為 <var>freq</var>。

lfe

設定 LFE 聲道的自訂增益。值以 dB 為單位。預設值為 0。

size

設定幀大小，單位為樣本數，將一次處理。預設值為 <var>1024</var>。允許範圍為 1024 到 96000。

hrir

設定 hrir 流的格式。預設值為 <var>stereo</var>。替代值為 <var>multich</var>。如果值設定為 <var>stereo</var>，則額外流的數量應大於或等於第一個輸入流中的輸入聲道數。此外，每個額外流應具有立體聲聲道數。如果值設定為 <var>multich</var>，則額外流的數量應正好為一個。此外，額外流的輸入聲道數應等於或大於第一個輸入流的聲道數的兩倍。

8.93.1 範例

• 完整範例，使用 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 降混，但現在採用 <var>multich</var> <var>hrir</var> 格式。

  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.94 highpass

套用 3dB 點頻率的高通濾波器。濾波器可以是單極或雙極（預設值）。濾波器滾降為每極每八度音程 6dB（每極每十年 20dB）。

濾鏡接受以下選項

frequency, f

設定頻率，單位為 Hz。預設值為 3000。

poles, p

end_pts

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。僅適用於雙極濾波器。預設值為 0.707q，並提供巴特沃斯 (Butterworth) 響應。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向

8.94.1 指令

此濾波器支援以下指令

frequency, f

變更高通濾波器頻率。指令的語法為：「<var>frequency</var>」

width_type, t

變更高通濾波器 width_type。指令的語法為：「<var>width_type</var>」

width, w

變更高通濾波器寬度。指令的語法為：「<var>width</var>」

mix, m

變更高通濾波器混音。指令的語法為：「<var>mix</var>」

8.95 join

將多個輸入流合併為一個多聲道流。

它接受以下參數

inputs

輸入流的數量。預設值為 2。

請注意，當設定為非零值時，濾波器延遲將正好是這麼多樣本。

所需的輸出聲道佈局。預設值為立體聲。

block_size, b

將聲道從輸入映射到輸出。參數是以「|」分隔的映射列表，每個映射的格式為 <var>input_idx</var>.<var>in_channel</var>-<var>out_channel</var>。<var>input_idx</var> 是輸入流的從 0 開始的索引。<var>in_channel</var> 可以是輸入聲道的名稱（例如 FL 代表前置左聲道）或其在指定輸入流中的索引。<var>out_channel</var> 是輸出聲道的名稱。

當未明確指定映射時，濾波器將嘗試猜測映射。它通過首先嘗試找到未使用的匹配輸入聲道來完成此操作，如果失敗，則選擇第一個未使用的輸入聲道。

合併 3 個輸入（具有正確設定的聲道佈局）

ffmpeg -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex join=inputs=3 OUTPUT

從 6 個單聲道流建立 5.1 輸出

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.96 ladspa

載入 LADSPA（Linux 音訊開發人員簡易外掛程式 API）外掛程式。

要啟用此濾波器的編譯，您需要使用 --enable-ladspa 配置 FFmpeg。

file, f

指定要載入的 LADSPA 外掛程式庫的名稱。如果定義了環境變數 LADSPA_PATH，則 LADSPA 外掛程式將在 LADSPA_PATH 中以冒號分隔的列表指定的每個目錄中搜尋，否則在標準 LADSPA 路徑中搜尋，順序如下：<samp>HOME/.ladspa/lib/</samp>、<samp>/usr/local/lib/ladspa/</samp>、<samp>/usr/lib/ladspa/</samp>。

plugin, p

指定庫中的外掛程式。某些庫僅包含一個外掛程式，但其他庫包含許多外掛程式。如果未設定此項，濾波器將列出指定庫中的所有可用外掛程式。

controls, c

設定「|」分隔的控制項列表，這些控制項是零個或多個浮點值，用於確定載入的外掛程式的行為（例如延遲、閾值或增益）。控制項需要使用以下語法定義：c0=<var>value0</var>|c1=<var>value1</var>|c2=<var>value2</var>|...，其中 <var>valuei</var> 是在第 <var>i</var> 個控制項上設定的值。或者，它們也可以使用以下語法定義：<var>value0</var>|<var>value1</var>|<var>value2</var>|...，其中 <var>valuei</var> 是在第 <var>i</var> 個控制項上設定的值。如果 <samp>controls</samp> 設定為 help，則會印出所有可用的控制項及其有效範圍。

sample_rate, s

指定取樣率，預設值為 44100。僅在外掛程式具有零輸入時使用。

nb_samples, n

設定每個輸出幀中每個聲道的樣本數，預設值為 1024。僅在外掛程式具有零輸入時使用。

duration, d

設定來源音訊的最小持續時間。請參閱 <a href="ffmpeg-utils.html#time-duration-syntax">(ffmpeg-utils)ffmpeg-utils(1) 手冊中的時間持續時間章節</a>，了解接受的語法。請注意，結果持續時間可能大於指定的持續時間，因為產生的音訊始終在完整幀的末尾被剪切。如果未指定，或表示的持續時間為負數，則音訊應永久產生。僅在外掛程式具有零輸入時使用。

latency, l

啟用延遲補償，預設為停用。僅在外掛程式具有輸入時使用。

8.96.1 範例

• 列出 amp（LADSPA 範例外掛程式）庫中的所有可用外掛程式

  ladspa=file=amp
  

• 列出 VCF 庫中 vcf_notch 外掛程式的所有可用控制項及其有效範圍

  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-plugins（Tom’s Audio Processing plugins）向音訊添加殘響

  ladspa=file=tap_reverb:tap_reverb
  

• 產生白雜訊，振幅為 0.2

  ladspa=file=cmt:noise_source_white:c=c0=.2
  

• 使用 C* Audio Plugin Suite (CAPS) 庫中的外掛程式 C* Click - Metronome 產生 20 bpm 的滴答聲

  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
  

• 使用 Steve Harris SWH Plugins 合集中的快速前瞻限制器將音量增加 20dB

  ladspa=fast_lookahead_limiter_1913:fastLookaheadLimiter:20|0|2
  

• 使用 Steve Harris SWH Plugins 合集中的 Multiband EQ 衰減低頻

  ladspa=mbeq_1197:mbeq:-24|-24|-24|0|0|0|0|0|0|0|0|0|0|0|0
  

• 使用 C* Audio Plugin Suite (CAPS) 庫中的 Narrower 縮減立體聲影像

  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.96.2 指令

此濾波器支援以下指令

cN

修改第 <var>N</var> 個控制值。

如果指定的值無效，則會被忽略並保留先前的值。

8.97 loudnorm

EBU R128 響度正規化。包括動態和線性正規化模式。支援單次傳遞（直播、檔案）和雙次傳遞（檔案）模式。此演算法可以針對 IL、LRA 和最大真實峰值。在動態模式下，為了準確偵測真實峰值，音訊流將被升取樣至 192 kHz。使用 -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。如果未滿足任何這些條件，正規化模式將恢復為 <var>dynamic</var>。選項為 true 或 false。預設值為 true。

dual_mono

將單聲道輸入檔案視為「雙單聲道」。如果單聲道檔案旨在在立體聲系統上播放，則其 EBU R128 測量在感知上將不正確。如果設定為 true，則此選項將補償此效果。多聲道輸入檔案不受此選項的影響。選項為 true 或 false。預設值為 false。

print_format

設定統計資訊的列印格式。選項為 summary、json 或 none。預設值為 none。

8.98 lowpass

套用 3dB 點頻率的低通濾波器。濾波器可以是單極或雙極（預設值）。濾波器滾降為每極每八度音程 6dB（每極每十年 20dB）。

濾鏡接受以下選項

frequency, f

設定頻率，單位為 Hz。預設值為 500。

poles, p

end_pts

width_type, t

設定指定濾波器頻寬的方法。

h

Hz

q

Q 因子

o

octave

s

斜率

k

kHz

width, w

以 width_type 單位指定濾波器的頻寬。僅適用於雙極濾波器。預設值為 0.707q，並提供巴特沃斯 (Butterworth) 響應。

mix, m

輸出中使用濾波訊號的量。預設值為 1。範圍介於 0 和 1 之間。

channels, c

指定要濾波的聲道，預設情況下會濾波所有可用聲道。

normalize, n

正規化雙二階係數，預設為停用。啟用後，它將在 DC 將幅度響應正規化為 0dB。

transform, a

設定 IIR 濾波器的轉換類型。

di

dii

tdi

tdii

latt

svf

zdf

precision, r

設定濾波精度。

auto

根據環繞濾波器選擇自動樣本格式。

s16

始終使用有符號 16 位元。

s32

始終使用有符號 32 位元。

f32

始終使用浮點 32 位元。

f64

始終使用浮點 64 位元。

frequency

設定傾斜的中心頻率，單位為 Hz。預設值為 10000 Hz。

傾斜方向