ffplay 文件

目錄

1 概要

ffplay [options] [input_url]

2 描述

FFplay 是一個非常簡單且可攜式的媒體播放器，使用 FFmpeg 函式庫和 SDL 函式庫。它主要用作各種 FFmpeg API 的測試平台。

3 選項

所有數值選項，除非另有說明，否則接受表示數字的字串作為輸入，後面可以跟隨 SI 單位字首，例如：「K」、「M」或「G」。

如果 SI 單位字首後附加「i」，則完整字首將被解釋為二進制倍數的單位字首，其基於 1024 的冪而不是 1000 的冪。在 SI 單位字首後附加「B」會將值乘以 8。這允許使用，例如：「KB」、「MiB」、「G」和「B」作為數字後綴。

不帶參數的選項是布林選項，並將對應的值設定為 true。它們可以透過在選項名稱前加上「no」來設定為 false。例如，使用「-nofoo」會將名稱為「foo」的布林選項設定為 false。

帶參數的選項支援特殊語法，其中命令列上給定的參數被解釋為從中載入實際參數值的文件路徑。要使用此功能，請在選項名稱前立即添加斜線「/」（在開頭的破折號之後）。例如：

ffmpeg -i INPUT -/filter:v filter.script OUTPUT

將從名為 filter.script 的檔案載入濾鏡圖描述。

3.1 串流指定器

某些選項是針對每個串流應用的，例如位元率或編碼解碼器。串流指定符用於精確指定給定選項屬於哪個或哪些串流。

串流指定符是一個字串，通常附加到選項名稱並用冒號與之分隔。例如，-codec:a:1 ac3 包含 a:1 串流指定符，它匹配第二個音訊串流。因此，它將為第二個音訊串流選擇 ac3 編碼解碼器。

一個串流指定符可以匹配多個串流，以便將選項應用於所有這些串流。例如，-b:a 128k 中的串流指定符匹配所有音訊串流。

空的串流指定符匹配所有串流。例如，-codec copy 或 -codec: copy 將複製所有串流而不重新編碼。

串流指定符的可能形式為

stream_index

匹配具有此索引的串流。例如，-threads:1 4 會將第二個串流的執行緒計數設定為 4。如果 stream_index 用作額外的串流指定符（見下文），則它從匹配的串流中選擇串流編號 stream_index。串流編號基於 libavformat 偵測到的串流順序，除非也指定了串流群組指定符或程式 ID。在這種情況下，它基於群組或程式中串流的順序。

stream_type[:additional_stream_specifier]

stream_type 是以下其中之一：「v」或「V」代表視訊，「a」代表音訊，「s」代表字幕，「d」代表資料，「t」代表附件。「v」匹配所有視訊串流，「V」僅匹配非附加圖片、視訊縮圖或封面藝術的視訊串流。如果使用 additional_stream_specifier，則它匹配既具有此類型又匹配 additional_stream_specifier 的串流。否則，它匹配指定類型的所有串流。

g:group_specifier[:additional_stream_specifier]

匹配屬於具有指定符 group_specifier 的群組的串流。如果使用 additional_stream_specifier，則它匹配既是群組的一部分又匹配 additional_stream_specifier 的串流。group_specifier 可以是以下之一

group_index

匹配具有此群組索引的串流。

#group_id 或 i:group_id

匹配具有此群組 ID 的串流。

p:program_id[:additional_stream_specifier]

匹配屬於具有 ID program_id 的程式的串流。如果使用 additional_stream_specifier，則它匹配既是程式的一部分又匹配 additional_stream_specifier 的串流。

#stream_id 或 i:stream_id

依串流 ID 匹配串流（例如，MPEG-TS 容器中的 PID）。

m:key[:value]

匹配具有中繼資料標籤 key 且具有指定值的串流。如果未給定 value，則匹配包含具有任何值的給定標籤的串流。key 或 value 中的冒號字元「:」需要使用反斜線跳脫字元。

disp:dispositions[:additional_stream_specifier]

匹配具有給定配置 (disposition) 的串流。dispositions 是使用「+」連接的一個或多個配置（由 -dispositions 選項列印）的列表。

u

匹配具有可用配置的串流，編碼解碼器必須已定義，並且必須存在基本資訊，例如視訊尺寸或音訊取樣率。

請注意，在 ffmpeg 中，依中繼資料匹配僅適用於輸入檔案。

3.2 通用選項

這些選項在 ff* 工具之間共用。

-L

顯示許可證。

-h, -?, -help, --help [arg]

顯示說明。可以指定一個可選參數來列印有關特定項目的說明。如果未指定參數，則僅顯示基本（非進階）工具選項。

arg 的可能值為

long

除了基本工具選項外，還列印進階工具選項。

full

列印完整的選項列表，包括編碼器、解碼器、解多工器、多工器、濾鏡等共用和私有選項。

decoder=decoder_name

列印有關名為 decoder_name 的解碼器的詳細資訊。使用 -decoders 選項取得所有解碼器的列表。

encoder=encoder_name

列印有關名為 encoder_name 的編碼器的詳細資訊。使用 -encoders 選項取得所有編碼器的列表。

demuxer=demuxer_name

列印有關名為 demuxer_name 的解多工器的詳細資訊。使用 -formats 選項取得所有解多工器和多工器的列表。

muxer=muxer_name

列印有關名為 muxer_name 的多工器的詳細資訊。使用 -formats 選項取得所有多工器和解多工器的列表。

filter=filter_name

列印有關名為 filter_name 的濾鏡的詳細資訊。使用 -filters 選項取得所有濾鏡的列表。

bsf=bitstream_filter_name

列印有關名為 bitstream_filter_name 的位元串流濾鏡的詳細資訊。使用 -bsfs 選項取得所有位元串流濾鏡的列表。

protocol=protocol_name

列印有關名為 protocol_name 的協定的詳細資訊。使用 -protocols 選項取得所有協定的列表。

-version

顯示版本。

-buildconf

顯示建置組態，每行一個選項。

-formats

顯示可用的格式（包括裝置）。

-demuxers

顯示可用的解多工器。

-muxers

顯示可用的多工器。

-devices

顯示可用的裝置。

-codecs

顯示 libavcodec 已知的所有編碼解碼器。

請注意，在整個文件中，「編碼解碼器」一詞用作更正確的媒體位元串流格式的簡稱。

-decoders

顯示可用的解碼器。

-encoders

顯示所有可用的編碼器。

-bsfs

顯示可用的位元串流濾鏡。

-protocols

顯示可用的協定。

-filters

顯示可用的 libavfilter 濾鏡。

-pix_fmts

顯示可用的像素格式。

-sample_fmts

顯示可用的取樣格式。

-layouts

顯示聲道名稱和標準聲道配置。

-dispositions

顯示串流配置。

-colors

顯示已識別的顏色名稱。

-sources device[,opt1=val1[,opt2=val2]...]

顯示輸入裝置的自動偵測來源。某些裝置可能會提供無法自動偵測的系統相關來源名稱。傳回的列表不能假定始終完整。

ffmpeg -sources pulse,server=192.168.0.4

-sinks device[,opt1=val1[,opt2=val2]...]

顯示輸出裝置的自動偵測接收器。某些裝置可能會提供無法自動偵測的系統相關接收器名稱。傳回的列表不能假定始終完整。

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [flags+]loglevel | -v [flags+]loglevel

設定日誌記錄級別和函式庫使用的旗標。

可選的 flags 字首可以包含以下值

‘repeat’

指示重複的日誌輸出不應壓縮到第一行，並且將省略「最後一條訊息重複 n 次」行。

‘level’

指示日誌輸出應在每條訊息行中添加 [level] 字首。這可以用作日誌著色的替代方案，例如，在將日誌轉儲到檔案時。

旗標也可以單獨使用，方法是添加「+」/「-」字首來設定/重設單個旗標，而不會影響其他 flags 或更改 loglevel。當同時設定 flags 和 loglevel 時，預期在最後一個 flags 值和 loglevel 之前使用「+」分隔符。

loglevel 是一個字串或數字，包含以下值之一

‘quiet, -8’

完全不顯示任何內容；保持靜音。

‘panic, 0’

僅顯示可能導致進程崩潰的致命錯誤，例如斷言失敗。目前未用於任何用途。

‘fatal, 8’

僅顯示致命錯誤。這些是進程絕對無法繼續的錯誤之後的錯誤。

‘error, 16’

顯示所有錯誤，包括可以從中恢復的錯誤。

‘warning, 24’

顯示所有警告和錯誤。將顯示與可能不正確或意外事件相關的任何訊息。

‘info, 32’

在處理期間顯示資訊性訊息。這是警告和錯誤之外的訊息。這是預設值。

‘verbose, 40’

與 info 相同，但更詳細。

‘debug, 48’

顯示所有內容，包括除錯資訊。

‘trace, 56’

例如，要啟用重複的日誌輸出，添加 level 字首，並將 loglevel 設定為 verbose

ffmpeg -loglevel repeat+level+verbose -i input output

另一個範例，啟用重複的日誌輸出，而不會影響 level 字首旗標或 loglevel 的目前狀態

ffmpeg [...] -loglevel +repeat

預設情況下，程式會記錄到 stderr。如果終端機支援著色，則顏色用於標記錯誤和警告。可以透過設定環境變數 AV_LOG_FORCE_NOCOLOR 來停用日誌著色，或者可以透過設定環境變數 AV_LOG_FORCE_COLOR 來強制啟用日誌著色。

-report

將完整命令列和日誌輸出轉儲到目前目錄中名為 program-YYYYMMDD-HHMMSS.log 的檔案中。此檔案對於錯誤報告很有用。它也隱含 -loglevel debug。

將環境變數 FFREPORT 設定為任何值都具有相同的效果。如果該值是以「:」分隔的 key=value 序列，則這些選項將影響報告；如果選項值包含特殊字元或選項分隔符「:」，則必須對選項值進行跳脫字元處理（請參閱 ffmpeg-utils 手冊中的「引號和跳脫字元」部分）。

以下選項被識別

file

設定用於報告的檔案名稱；%p 展開為程式的名稱，%t 展開為時間戳記，%% 展開為純 %

level

使用數值設定日誌詳細程度級別（請參閱 -loglevel）。

例如，要使用日誌級別 32（日誌級別 info 的別名）將報告輸出到名為 ffreport.log 的檔案

FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

剖析環境變數中的錯誤不是致命的，並且不會出現在報告中。

-hide_banner

抑制列印橫幅。

所有 FFmpeg 工具通常都會顯示版權聲明、建置選項和函式庫版本。此選項可用於抑制列印此資訊。

-cpuflags flags (global)

允許設定和清除 CPU 旗標。此選項旨在用於測試。除非您知道自己在做什麼，否則請勿使用它。

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

此選項的可能旗標為

‘x86’

‘mmx’

‘mmxext’

‘sse’

‘sse2’

‘sse2slow’

‘sse3’

‘sse3slow’

‘ssse3’

‘atom’

‘sse4.1’

‘sse4.2’

‘avx’

‘avx2’

‘xop’

‘fma3’

‘fma4’

‘3dnow’

‘3dnowext’

‘bmi1’

‘bmi2’

‘cmov’

‘ARM’

‘armv5te’

‘armv6’

‘armv6t2’

‘vfp’

‘vfpv3’

‘neon’

‘setend’

‘AArch64’

‘armv8’

‘vfp’

‘neon’

‘PowerPC’

‘altivec’

‘Specific Processors’

‘pentium2’

‘pentium3’

‘pentium4’

‘k6’

‘k62’

‘athlon’

‘athlonxp’

‘k8’

-cpucount count (global)

覆寫 CPU 計數的偵測。此選項旨在用於測試。除非您知道自己在做什麼，否則請勿使用它。

ffmpeg -cpucount 2

-max_alloc bytes

設定 ffmpeg 系列 malloc 函式在堆積上分配區塊的最大大小限制。使用此選項時請極其謹慎。如果您不了解這樣做的全部後果，請勿使用。預設值為 INT_MAX。

3.3 AVOptions

這些選項由 libavformat、libavdevice 和 libavcodec 函式庫直接提供。要查看可用 AVOption 的列表，請使用 -help 選項。它們分為兩類

generic

可以為任何容器、編碼解碼器或裝置設定這些選項。通用選項列在容器/裝置的 AVFormatContext 選項下，以及編碼解碼器的 AVCodecContext 選項下。

private

這些選項是針對給定的容器、裝置或編解碼器而設。私有選項列在它們各自對應的容器/裝置/編解碼器之下。

例如，若要將 ID3v2.3 標頭寫入 MP3 檔案，而不是預設的 ID3v2.4，請使用 MP3 多工器 (muxer) 的私有選項 id3v2_version

ffmpeg -i input.flac -id3v2_version 3 out.mp3

所有編解碼器 AVOptions 都是針對每個串流，因此應將串流指定符附加到它們

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

在以上範例中，多聲道音訊串流被對應輸出兩次。第一個實例使用 ac3 編解碼器和 640k 位元率進行編碼。第二個實例被降混為 2 個聲道，並使用 aac 編解碼器進行編碼。使用輸出串流的絕對索引為其指定了 128k 的位元率。

注意：-nooption 語法不能用於布林值 AVOptions，請使用 -option 0/-option 1。

注意：過去未公開的文件中，通過在選項名稱前加上 v/a/s 來指定每個串流 AVOptions 的舊方法現已過時，並將很快移除。

3.4 主要選項

-x width

強制顯示寬度。

-y height

強制顯示高度。

-fs

以全螢幕模式啟動。

-an

停用音訊。

-vn

停用視訊。

-sn

停用字幕。

-ss pos

搜尋到 pos。請注意，在大多數格式中，無法精確搜尋，因此 ffplay 將搜尋到最接近 pos 的搜尋點。

pos 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

-t duration

播放 duration 秒的音訊/視訊。

duration 必須是時間長度規格，請參閱 (ffmpeg-utils) ffmpeg-utils(1) 手冊中的時間長度章節。

-bytes

以位元組搜尋。

-seek_interval

設定自訂間隔（秒），用於使用左右鍵搜尋。預設為 10 秒。

-nodisp

停用圖形顯示。

-noborder

無邊框視窗。

-alwaysontop

視窗永遠在最上層。適用於：使用 SDL >= 2.0.5 的 X11，Windows SDL >= 2.0.6。

-volume

設定啟動音量。0 代表靜音，100 代表無音量降低或放大。負值視為 0，高於 100 的值視為 100。

-f fmt

強制格式。

-window_title title

設定視窗標題（預設為輸入檔名）。

-left title

設定視窗左側的 x 位置（預設為置中視窗）。

-top title

設定視窗頂部的 y 位置（預設為置中視窗）。

-loop number

循環播放影片 <number> 次。0 代表永遠循環。

-showmode mode

設定要使用的顯示模式。mode 的可用值為

‘0, video’

顯示視訊

‘1, waves’

顯示音訊波形

‘2, rdft’

使用 RDFT ((反向) 實數離散傅立葉轉換) 顯示音訊頻帶

預設值為 "video"，如果沒有視訊或無法播放視訊，則自動選擇 "rdft"。

您可以按下鍵來互動式循環切換可用的顯示模式w.

-vf filtergraph

建立由 filtergraph 指定的濾鏡圖，並使用它來過濾視訊串流。

filtergraph 是要套用至串流的濾鏡圖描述，且必須具有單個視訊輸入和單個視訊輸出。在濾鏡圖中，輸入與標籤 in 關聯，輸出與標籤 out 關聯。有關濾鏡圖語法的更多資訊，請參閱 ffmpeg-filters 手冊。

您可以多次指定此參數，並按下按鍵，在指定的濾鏡圖和顯示模式之間循環切換w.

-af filtergraph

filtergraph 是要套用至輸入音訊的濾鏡圖描述。使用選項 "-filters" 來顯示所有可用的濾鏡 (包括來源和接收器)。

-i input_url

讀取 input_url。

3.5 進階選項

-stats

印出多個播放統計資訊，特別是顯示串流持續時間、編解碼器參數、串流中的目前位置以及音訊/視訊同步偏移。預設情況下會顯示，除非記錄層級低於 info。可以通過手動指定此選項來強制顯示。若要停用它，您需要指定 -nostats。

-fast

不符合規範的最佳化。

-genpts

產生 pts。

-sync type

將主時鐘設定為音訊 (type=audio)、視訊 (type=video) 或外部 (type=ext)。預設為音訊。主時鐘用於控制音訊-視訊同步。大多數媒體播放器使用音訊作為主時鐘，但在某些情況下 (串流或高品質廣播)，有必要更改它。此選項主要用於除錯目的。

-ast audio_stream_specifier

使用給定的串流指定符選擇所需的音訊串流。串流指定符在 串流指定符 章節中描述。如果未指定此選項，則在已選定視訊串流的節目中選擇「最佳」音訊串流。

-vst video_stream_specifier

使用給定的串流指定符選擇所需的視訊串流。串流指定符在 串流指定符 章節中描述。如果未指定此選項，則選擇「最佳」視訊串流。

-sst subtitle_stream_specifier

使用給定的串流指定符選擇所需的字幕串流。串流指定符在 串流指定符 章節中描述。如果未指定此選項，則在已選定視訊或音訊串流的節目中選擇「最佳」字幕串流。

-autoexit

影片播放完成時退出。

-exitonkeydown

按下任何按鍵時退出。

-exitonmousedown

按下任何滑鼠按鈕時退出。

-codec:media_specifier codec_name

針對由 media_specifier 識別的串流強制使用特定的解碼器實作，media_specifier 可以採用值 a (音訊)、v (視訊) 和 s 字幕。

-acodec codec_name

強制使用特定的音訊解碼器。

-vcodec codec_name

強制使用特定的視訊解碼器。

-scodec codec_name

強制使用特定的字幕解碼器。

-autorotate

根據檔案元資料自動旋轉視訊。預設啟用，使用 -noautorotate 停用它。

-framedrop

如果視訊不同步，則丟棄視訊影格。如果主時鐘未設定為視訊，則預設啟用。使用此選項為所有主時鐘來源啟用影格丟棄，使用 -noframedrop 停用它。

-infbuf

不限制輸入緩衝區大小，盡可能快地從輸入讀取盡可能多的資料。對於即時串流預設啟用，如果未及時讀取資料，可能會丟失資料。使用此選項為所有輸入啟用無限緩衝區，使用 -noinfbuf 停用它。

-filter_threads nb_threads

定義用於處理濾鏡管線的執行緒數量。每個管線將產生一個執行緒池，其中包含這麼多執行緒可用於並行處理。預設值為 0，表示執行緒計數將由可用的 CPU 數量決定。

-enable_vulkan

使用 vulkan 渲染器而不是 SDL 內建渲染器。取決於 libplacebo。

-vulkan_params

使用以 ":" 分隔的 key=value 鍵值對列表進行 Vulkan 配置。

-hwaccel

使用硬體加速解碼。啟用此選項將自動啟用 vulkan 渲染器。

3.6 播放中

q, ESC

退出。

f

切換全螢幕。

p, SPC

暫停。

m

切換靜音。

9, 0

/, *

分別降低和增加音量。

a

在目前節目中循環切換音訊聲道。

v

循環切換視訊聲道。

t

在目前節目中循環切換字幕聲道。

c

循環切換節目。

w

循環切換視訊濾鏡或顯示模式。

s

步進到下一個影格。

如果串流尚未暫停，則暫停，步進到下一個視訊影格，然後暫停。

left/right

向後/向前搜尋 10 秒。

down/up

向後/向前搜尋 1 分鐘。

page down/page up

搜尋到上一個/下一個章節。或者，如果沒有章節，則向後/向前搜尋 10 分鐘。

滑鼠右鍵點擊

搜尋到檔案中對應於寬度比例的百分比位置。

滑鼠左鍵雙擊

切換全螢幕。

4 語法

本節記錄 FFmpeg 函式庫和工具使用的語法和格式。

4.1 引號和跳脫字元

除非另有明確規定，否則 FFmpeg 採用以下引號和跳脫字元機制。應用以下規則

• ‘'’ 和 ‘\’ 是特殊字元 (分別用於引號和跳脫字元)。除了它們之外，根據採用跳脫字元和引號的特定語法，可能還有其他特殊字元。
• 特殊字元通過在其前面加上 ‘\’ 來跳脫。
• 所有用 ‘''’ 括起來的字元都按字面包含在已剖析的字串中。引號字元 ‘'’ 本身無法被引號，因此您可能需要關閉引號並跳脫它。
• 除非跳脫或引號，否則已剖析字串中開頭和結尾的空白字元將被移除。

請注意，當使用命令列或腳本時，您可能需要新增第二層跳脫字元，這取決於採用的 shell 語言的語法。

libavutil/avstring.h 中定義的函式 av_get_token 可用於根據上述規則剖析引號或跳脫的符記。

FFmpeg 原始碼樹中的工具 tools/ffescape 可用於在腳本中自動引號或跳脫字串。

4.1.1 範例

• 跳脫包含 ‘'’ 特殊字元的字串 Crime d'Amour

  Crime d\'Amour
  

• 上面的字串包含引號，因此在引號時需要跳脫 ‘'’

  'Crime d'\''Amour'
  

• 使用引號包含開頭或結尾的空白字元

  '  this string starts and ends with whitespaces  '
  

• 跳脫字元和引號可以混合使用

  ' The string '\'string\'' is a string '
  

• 若要包含字面上的 ‘\’，您可以使用跳脫字元或引號

  'c:\foo' can be written as c:\\foo
  

4.2 日期

接受的語法是

[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
now

如果值為 "now"，則採用目前時間。

時間為當地時間，除非附加 Z，在這種情況下，它被解釋為 UTC。如果未指定年-月-日部分，則採用目前的年-月-日。

4.3 時間長度

有兩種接受的語法來表示時間長度。

[-][HH:]MM:SS[.m...]

HH 表示小時數，MM 表示最多 2 位數的分鐘數，SS 表示最多 2 位數的秒數。結尾的 m 表示 SS 的小數值。

或

[-]S+[.m...][s|ms|us]

S 表示秒數，帶有可選的小數部分 m。可選的字面後綴 ‘s’、‘ms’ 或 ‘us’ 表示將該值分別解釋為秒、毫秒或微秒。

在這兩個表達式中，可選的 ‘-’ 表示負持續時間。

4.3.1 範例

以下範例都是有效時間長度

‘55’

55 秒

‘0.2’

0.2 秒

‘200ms’

200 毫秒，即 0.2 秒

‘200000us’

200000 微秒，即 0.2 秒

‘12:03:45’

12 小時、03 分鐘和 45 秒

‘23.189’

23.189 秒

4.4 影片尺寸

指定來源視訊的大小，它可以是 widthxheight 形式的字串，或是大小縮寫的名稱。

以下縮寫被識別

‘ntsc’

720x480

‘pal’

720x576

‘qntsc’

352x240

‘qpal’

352x288

‘sntsc’

640x480

‘spal’

768x576

‘film’

352x240

‘ntsc-film’

352x240

‘sqcif’

128x96

‘qcif’

176x144

‘cif’

352x288

‘4cif’

704x576

‘16cif’

1408x1152

‘qqvga’

160x120

‘qvga’

320x240

‘vga’

640x480

‘svga’

800x600

‘xga’

1024x768

‘uxga’

1600x1200

‘qxga’

2048x1536

‘sxga’

1280x1024

‘qsxga’

2560x2048

‘hsxga’

5120x4096

‘wvga’

852x480

‘wxga’

1366x768

‘wsxga’

1600x1024

‘wuxga’

1920x1200

‘woxga’

2560x1600

‘wqsxga’

3200x2048

‘wquxga’

3840x2400

‘whsxga’

6400x4096

‘whuxga’

7680x4800

‘cga’

320x200

‘ega’

640x350

‘hd480’

852x480

‘hd720’

1280x720

‘hd1080’

1920x1080

‘2k’

2048x1080

‘2kflat’

1998x1080

‘2kscope’

2048x858

‘4k’

4096x2160

‘4kflat’

3996x2160

‘4kscope’

4096x1716

‘nhd’

640x360

‘hqvga’

240x160

‘wqvga’

400x240

‘fwqvga’

432x240

‘hvga’

480x320

‘qhd’

960x540

‘2kdci’

2048x1080

‘4kdci’

4096x2160

‘uhd2160’

3840x2160

‘uhd4320’

7680x4320

4.5 影片速率

指定視訊的影格率，表示為每秒產生的影格數。它必須是 frame_rate_num/frame_rate_den 格式的字串、整數、浮點數或有效的視訊影格率縮寫。

以下縮寫被識別

‘ntsc’

30000/1001

‘pal’

25/1

‘qntsc’

30000/1001

‘qpal’

25/1

‘sntsc’

30000/1001

‘spal’

25/1

‘film’

24/1

‘ntsc-film’

24000/1001

4.6 比例

比率可以表示為表達式，或以 numerator:denominator 的形式表示。

請注意，具有無限大 (1/0) 或負值的比率被視為有效，因此如果您想排除這些值，則應檢查傳回值。

未定義的值可以使用 "0:0" 字串表示。

4.7 色彩

它可以是如下定義的顏色名稱 (不區分大小寫比對) 或 [0x|#]RRGGBB[AA] 序列，可能後跟 @ 和表示 alpha 分量的字串。

alpha 分量可以是 "0x" 後跟十六進位數字或介於 0.0 和 1.0 之間的十進位數字組成的字串，它表示不透明度值 (‘0x00’ 或 ‘0.0’ 表示完全透明，‘0xff’ 或 ‘1.0’ 完全不透明)。如果未指定 alpha 分量，則假定為 ‘0xff’。

字串 ‘random’ 將產生隨機顏色。

以下顏色名稱被識別

‘AliceBlue’

0xF0F8FF

‘AntiqueWhite’

0xFAEBD7

‘Aqua’

0x00FFFF

‘Aquamarine’

0x7FFFD4

‘Azure’

0xF0FFFF

‘Beige’

0xF5F5DC

‘Bisque’

0xFFE4C4

‘Black’

0x000000

‘BlanchedAlmond’

0xFFEBCD

‘Blue’

0x0000FF

‘BlueViolet’

0x8A2BE2

‘Brown’

0xA52A2A

‘BurlyWood’

0xDEB887

‘CadetBlue’

0x5F9EA0

‘Chartreuse’

0x7FFF00

‘Chocolate’

0xD2691E

‘Coral’

0xFF7F50

‘CornflowerBlue’

0x6495ED

‘Cornsilk’

0xFFF8DC

‘Crimson’

0xDC143C

‘Cyan’

0x00FFFF

‘DarkBlue’

0x00008B

‘DarkCyan’

0x008B8B

‘DarkGoldenRod’

0xB8860B

‘DarkGray’

0xA9A9A9

‘DarkGreen’

0x006400

‘DarkKhaki’

0xBDB76B

‘DarkMagenta’

0x8B008B

‘DarkOliveGreen’

0x556B2F

‘Darkorange’

0xFF8C00

‘DarkOrchid’

0x9932CC

‘DarkRed’

0x8B0000

‘DarkSalmon’

0xE9967A

‘DarkSeaGreen’

0x8FBC8F

‘DarkSlateBlue’

0x483D8B

‘DarkSlateGray’

0x2F4F4F

‘DarkTurquoise’

0x00CED1

‘DarkViolet’

0x9400D3

‘DeepPink’

0xFF1493

‘DeepSkyBlue’

0x00BFFF

‘DimGray’

0x696969

‘DodgerBlue’

0x1E90FF

‘FireBrick’

0xB22222

‘FloralWhite’

0xFFFAF0

‘ForestGreen’

0x228B22

‘Fuchsia’

0xFF00FF

‘Gainsboro’

0xDCDCDC

‘GhostWhite’

0xF8F8FF

‘Gold’

0xFFD700

‘GoldenRod’

0xDAA520

‘Gray’

0x808080

‘Green’

0x008000

‘GreenYellow’

0xADFF2F

‘HoneyDew’

0xF0FFF0

‘HotPink’

0xFF69B4

‘IndianRed’

0xCD5C5C

‘Indigo’

0x4B0082

‘Ivory’

0xFFFFF0

‘Khaki’

0xF0E68C

‘Lavender’

0xE6E6FA

‘LavenderBlush’

0xFFF0F5

‘LawnGreen’

0x7CFC00

‘LemonChiffon’

0xFFFACD

‘LightBlue’

0xADD8E6

‘LightCoral’

0xF08080

‘LightCyan’

0xE0FFFF

‘LightGoldenRodYellow’

0xFAFAD2

‘LightGreen’

0x90EE90

‘LightGrey’

0xD3D3D3

‘LightPink’

0xFFB6C1

‘LightSalmon’

0xFFA07A

‘LightSeaGreen’

0x20B2AA

‘LightSkyBlue’

0x87CEFA

‘LightSlateGray’

0x778899

‘LightSteelBlue’

0xB0C4DE

‘LightYellow’

0xFFFFE0

‘Lime’

0x00FF00

‘LimeGreen’

0x32CD32

‘Linen’

0xFAF0E6

‘Magenta’

0xFF00FF

‘Maroon’

0x800000

‘MediumAquaMarine’

0x66CDAA

‘MediumBlue’

0x0000CD

‘MediumOrchid’

0xBA55D3

‘MediumPurple’

0x9370D8

‘MediumSeaGreen’

0x3CB371

‘MediumSlateBlue’

0x7B68EE

‘MediumSpringGreen’

0x00FA9A

‘MediumTurquoise’

0x48D1CC

‘MediumVioletRed’

0xC71585

‘MidnightBlue’

0x191970

‘MintCream’

0xF5FFFA

‘MistyRose’

0xFFE4E1

‘Moccasin’

0xFFE4B5

‘NavajoWhite’

0xFFDEAD

‘Navy’

0x000080

‘OldLace’

0xFDF5E6

‘Olive’

0x808000

‘OliveDrab’

0x6B8E23

‘Orange’

0xFFA500

‘OrangeRed’

0xFF4500

‘Orchid’

0xDA70D6

‘PaleGoldenRod’

0xEEE8AA

‘PaleGreen’

0x98FB98

‘PaleTurquoise’

0xAFEEEE

‘PaleVioletRed’

0xD87093

‘PapayaWhip’

0xFFEFD5

‘PeachPuff’

0xFFDAB9

‘Peru’

0xCD853F

‘Pink’

0xFFC0CB

‘Plum’

0xDDA0DD

‘PowderBlue’

0xB0E0E6

‘Purple’

0x800080

‘Red’

0xFF0000

‘RosyBrown’

0xBC8F8F

‘RoyalBlue’

0x4169E1

‘SaddleBrown’

0x8B4513

‘Salmon’

0xFA8072

‘SandyBrown’

0xF4A460

‘SeaGreen’

0x2E8B57

‘SeaShell’

0xFFF5EE

‘Sienna’

0xA0522D

‘Silver’

0xC0C0C0

‘SkyBlue’

0x87CEEB

‘SlateBlue’

0x6A5ACD

‘SlateGray’

0x708090

‘Snow’

0xFFFAFA

‘SpringGreen’

0x00FF7F

‘SteelBlue’

0x4682B4

‘Tan’

0xD2B48C

‘Teal’

0x008080

‘Thistle’

0xD8BFD8

‘Tomato’

0xFF6347

‘Turquoise’

0x40E0D0

‘Violet’

0xEE82EE

‘Wheat’

0xF5DEB3

‘White’

0xFFFFFF

‘WhiteSmoke’

0xF5F5F5

‘Yellow’

0xFFFF00

‘YellowGreen’

0x9ACD32

4.8 聲道配置

頻道佈局指定多聲道音訊串流中聲道的空間配置。為了指定頻道佈局，FFmpeg 使用特殊的語法。

各個聲道由一個 ID 識別，如下表所示

‘FL’

前置左聲道

‘FR’

前置右聲道

‘FC’

前置中央聲道

‘LFE’

低頻聲道

‘BL’

後置左聲道

‘BR’

後置右聲道

‘FLC’

前置偏左中央聲道

‘FRC’

前置偏右中央聲道

‘BC’

後置中央聲道

‘SL’

側邊左聲道

‘SR’

側邊右聲道

‘TC’

頂部中央聲道

‘TFL’

頂部前置左聲道

‘TFC’

頂部前置中央聲道

‘TFR’

頂部前置右聲道

‘TBL’

頂部後置左聲道

‘TBC’

頂部後置中央聲道

‘TBR’

頂部後置右聲道

‘DL’

降混左聲道

‘DR’

降混右聲道

‘WL’

寬度左聲道

‘WR’

寬度右聲道

‘SDL’

環繞直接左聲道

‘SDR’

環繞直接右聲道

‘LFE2’

低頻聲道 2

標準頻道佈局組合可以使用以下識別符指定

‘mono’

FC

‘stereo’

FL+FR

‘2.1’

FL+FR+LFE

‘3.0’

FL+FR+FC

‘3.0(back)’

FL+FR+BC

‘4.0’

FL+FR+FC+BC

‘quad’

FL+FR+BL+BR

‘quad(side)’

FL+FR+SL+SR

‘3.1’

FL+FR+FC+LFE

‘5.0’

FL+FR+FC+BL+BR

‘5.0(side)’

FL+FR+FC+SL+SR

‘4.1’

FL+FR+FC+LFE+BC

‘5.1’

FL+FR+FC+LFE+BL+BR

‘5.1(side)’

FL+FR+FC+LFE+SL+SR

‘6.0’

FL+FR+FC+BC+SL+SR

‘6.0(front)’

FL+FR+FLC+FRC+SL+SR

‘3.1.2’

FL+FR+FC+LFE+TFL+TFR

‘hexagonal’

FL+FR+FC+BL+BR+BC

‘6.1’

FL+FR+FC+LFE+BC+SL+SR

‘6.1’

FL+FR+FC+LFE+BL+BR+BC

‘6.1(front)’

FL+FR+LFE+FLC+FRC+SL+SR

‘7.0’

FL+FR+FC+BL+BR+SL+SR

‘7.0(front)’

FL+FR+FC+FLC+FRC+SL+SR

‘7.1’

FL+FR+FC+LFE+BL+BR+SL+SR

‘7.1(wide)’

FL+FR+FC+LFE+BL+BR+FLC+FRC

‘7.1(wide-side)’

FL+FR+FC+LFE+FLC+FRC+SL+SR

‘5.1.2’

FL+FR+FC+LFE+BL+BR+TFL+TFR

‘octagonal’

FL+FR+FC+BL+BR+BC+SL+SR

‘cube’

FL+FR+BL+BR+TFL+TFR+TBL+TBR

‘5.1.4’

FL+FR+FC+LFE+BL+BR+TFL+TFR+TBL+TBR

‘7.1.2’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR

‘7.1.4’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBL+TBR

‘7.2.3’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBC+LFE2

‘9.1.4’

FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR

‘9.1.6’

FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR+TSL+TSR

‘hexadecagonal’

FL+FR+FC+BL+BR+BC+SL+SR+WL+WR+TBL+TBR+TBC+TFC+TFL+TFR

‘binaural’

BIL+BIR

‘downmix’

DL+DR

‘22.2’

FL+FR+FC+LFE+BL+BR+FLC+FRC+BC+SL+SR+TC+TFL+TFC+TFR+TBL+TBC+TBR+LFE2+TSL+TSR+BFC+BFL+BFR

自訂頻道佈局可以指定為一連串的詞彙，以「+」分隔。每個詞彙可以是

• 單個聲道的名稱（例如 ‘FL’、‘FR’、‘FC’、‘LFE’ 等），每個聲道可以選擇在 ‘@’ 後面包含自訂名稱（例如 ‘FL@Left’、‘FR@Right’、‘FC@Center’、‘LFE@Low_Frequency’ 等）

標準頻道佈局可以透過以下方式指定

• 單個聲道的名稱（例如 ‘FL’、‘FR’、‘FC’、‘LFE’ 等）
• 標準頻道佈局的名稱（例如 ‘mono’、‘stereo’、‘4.0’、‘quad’、‘5.0’ 等）
• 聲道數量，以十進制表示，後接 ‘c’，產生該聲道數量的預設頻道佈局（請參閱 av_channel_layout_default 函數）。請注意，並非所有聲道計數都有預設佈局。
• 聲道數量，以十進制表示，後接 ‘C’，產生具有指定聲道數量的未知頻道佈局。請注意，並非所有頻道佈局規格字串都支援未知的頻道佈局。
• 頻道佈局遮罩，以「0x」開頭的十六進制表示（請參閱 libavutil/channel_layout.h 中的 AV_CH_* 巨集）。

在 libavutil 版本 53 之前，指定聲道數量的尾隨字元「c」是選用的，但現在是必要的，而頻道佈局遮罩也可以指定為十進制數字（僅當且僅當後面沒有跟著「c」或「C」時）。

另請參閱 libavutil/channel_layout.h 中定義的 av_channel_layout_from_string 函數。

5 表達式求值

在評估算術運算式時，FFmpeg 使用內部公式評估器，透過 libavutil/eval.h 介面實作。

運算式可能包含一元運算符、二元運算符、常數和函數。

兩個運算式 expr1 和 expr2 可以組合形成另一個運算式 「expr1;expr2」。expr1 和 expr2 依序評估，而新運算式評估為 expr2 的值。

以下二元運算符可用：+、-、*、/、^。

以下一元運算符可用：+、-。

一些內部變數可以用於儲存和載入中間結果。它們可以使用 ld 和 st 函數以及索引參數（範圍從 0 到 9）來存取，以指定要存取哪個內部變數。

以下函數可用

abs(x)

計算 x 的絕對值。

acos(x)

計算 x 的反餘弦值。

asin(x)

計算 x 的反正弦值。

atan(x)

計算 x 的反正切值。

atan2(y, x)

計算 y/x 的反正切主值。

between(x, min, max)

如果 x 大於或等於 min 且小於或等於 max，則傳回 1，否則傳回 0。

bitand(x, y)

bitor(x, y)

計算 x 和 y 的位元 AND/OR 運算。

在執行位元運算之前，x 和 y 的評估結果會轉換為整數。

請注意，轉換為整數和轉換回浮點數都可能損失精度。請注意大數字（通常為 2^53 及更大）的意外結果。

ceil(expr)

將運算式 expr 的值向上捨入到最接近的整數。例如，「ceil(1.5)」為「2.0」。

clip(x, min, max)

傳回 x 的值，限制在 min 和 max 之間。

cos(x)

計算 x 的餘弦值。

cosh(x)

計算 x 的雙曲餘弦值。

eq(x, y)

如果 x 和 y 相等，則傳回 1，否則傳回 0。

exp(x)

計算 x 的指數函數（以 e，即尤拉數為底）。

floor(expr)

將運算式 expr 的值向下捨入到最接近的整數。例如，「floor(-1.5)」為「-2.0」。

gauss(x)

計算 x 的高斯函數，對應於 exp(-x*x/2) / sqrt(2*PI)。

gcd(x, y)

傳回 x 和 y 的最大公因數。如果 x 和 y 都是 0，或任一或兩者都小於零，則行為未定義。

gt(x, y)

如果 x 大於 y，則傳回 1，否則傳回 0。

gte(x, y)

如果 x 大於或等於 y，則傳回 1，否則傳回 0。

hypot(x, y)

此函數與同名的 C 函數類似；它傳回 「sqrt(x*x + y*y)」，即邊長為 x 和 y 的直角三角形的斜邊長度，或是點 (x, y) 到原點的距離。

if(x, y)

評估 x，如果結果非零，則傳回 y 的評估結果，否則傳回 0。

if(x, y, z)

評估 x，如果結果非零，則傳回 y 的評估結果，否則傳回 z 的評估結果。

ifnot(x, y)

評估 x，如果結果為零，則傳回 y 的評估結果，否則傳回 0。

ifnot(x, y, z)

評估 x，如果結果為零，則傳回 y 的評估結果，否則傳回 z 的評估結果。

isinf(x)

如果 x 為 +/-INFINITY，則傳回 1.0，否則傳回 0.0。

isnan(x)

如果 x 為 NAN，則傳回 1.0，否則傳回 0.0。

ld(idx)

載入索引為 idx 的內部變數的值，該值先前使用 st(idx, expr) 儲存。此函數傳回載入的值。

lerp(x, y, z)

傳回 x 和 y 之間依據 z 量的線性插值。

log(x)

計算 x 的自然對數。

lt(x, y)

如果 x 小於 y，則傳回 1，否則傳回 0。

lte(x, y)

如果 x 小於或等於 y，則傳回 1，否則傳回 0。

max(x, y)

傳回 x 和 y 之間的較大值。

min(x, y)

傳回 x 和 y 之間的較小值。

mod(x, y)

計算 x 除以 y 的餘數。

not(expr)

如果 expr 為零，則傳回 1.0，否則傳回 0.0。

pow(x, y)

計算 x 的 y 次方，相當於 「(x)^(y)」。

print(t)

print(t, l)

印出表示式 t 的值，並使用日誌層級 l。若未指定 l，則會使用預設的日誌層級。傳回印出的表示式的值。

random(idx)

傳回介於 0.0 和 1.0 之間的偽隨機值。idx 是用於儲存種子/狀態的內部變數索引，該種子/狀態可以先前使用 st(idx) 儲存。

若要初始化種子，您需要將種子值作為 64 位元無號整數儲存在索引為 idx 的內部變數中。

例如，若要將值為 42 的種子儲存在索引為 0 的內部變數中，並印出一些隨機值

st(0,42); print(random(0)); print(random(0)); print(random(0))

randomi(idx, min, max)

傳回介於 min 和 max 之間的偽隨機值。idx 是內部變數的索引，將用於儲存種子/狀態，該種子/狀態可以先前使用 st(idx) 儲存。

若要初始化種子，您需要將種子值作為 64 位元無號整數儲存在索引為 idx 的內部變數中。

root(expr, max)

尋找一個輸入值，使以 ld(0) 作為引數且由 expr 表示的函數在區間 0..max 內的值為 0。

expr 中的表示式必須表示連續函數，否則結果將是未定義的。

ld(0) 用於表示函數輸入值，這表示給定的表示式將會使用多個不同的輸入值進行評估，而表示式可以透過 ld(0) 存取這些輸入值。當表示式評估為 0 時，將傳回對應的輸入值。

round(expr)

將表示式 expr 的值四捨五入到最接近的整數。例如，"round(1.5)" 的結果為 "2.0"。

sgn(x)

計算 x 的正負號。

sin(x)

計算 x 的正弦值。

sinh(x)

計算 x 的雙曲正弦值。

sqrt(expr)

計算 expr 的平方根。這等同於 "(expr)^.5"。

squish(x)

計算表示式 1/(1 + exp(4*x))。

st(idx, expr)

將表示式 expr 的值儲存在內部變數中。idx 指定儲存值的變數索引，其值範圍為 0 到 9。此函數會傳回儲存在內部變數中的值。

儲存的值可以使用 ld(var) 擷取。

注意：變數目前在表示式之間不共享。

tan(x)

計算 x 的正切值。

tanh(x)

計算 x 的雙曲正切值。

taylor(expr, x)

taylor(expr, x, idx)

在 x 處評估泰勒級數，給定一個表示函數在 0 處的 ld(idx) 階導數的表示式。

當級數不收斂時，結果將是未定義的。

ld(idx) 用於表示 expr 中的導數階數，這表示給定的表示式將會使用多個不同的輸入值進行評估，而表示式可以透過 ld(idx) 存取這些輸入值。若未指定 idx，則預設為 0。

注意，當您擁有在 y 而非 0 處的導數時，可以使用 taylor(expr, x-y)。

time(0)

傳回目前的（實際時間）時間，以秒為單位。

trunc(expr)

將表示式 expr 的值朝零的方向四捨五入到最接近的整數。例如，"trunc(-1.5)" 的結果為 "-1.0"。

while(cond, expr)

當表示式 cond 為非零值時，評估表示式 expr，並傳回最後一次 expr 評估的值，如果 cond 始終為 false，則傳回 NAN。

以下常數可用

PI

單位圓盤的面積，約為 3.14

E

exp(1)（歐拉數），約為 2.718

PHI

黃金比例 (1+sqrt(5))/2，約為 1.618

假設表示式在具有非零值時被視為「真」，請注意：

* 的作用類似於 AND（邏輯與）

+ 的作用類似於 OR（邏輯或）

例如，以下結構：

if (A AND B) then C

等同於：

if(A*B, C)

在您的 C 程式碼中，您可以擴展一元和二元函數的列表，並定義可辨識的常數，以便它們可用於您的表示式。

評估器也辨識國際單位制詞頭。如果在詞頭後附加 'i'，則會使用二進制詞頭，其基於 1024 的冪次而非 1000 的冪次。後綴 'B' 將值乘以 8，並且可以附加在單位詞頭之後或單獨使用。這允許使用例如 'KB'、'MiB'、'G' 和 'B' 作為數字後綴。

以下是可用的國際單位制詞頭列表，並指示了對應的 10 和 2 的冪次。

y

10^-24 / 2^-80

z

10^-21 / 2^-70

a

10^-18 / 2^-60

f

10^-15 / 2^-50

p

10^-12 / 2^-40

n

10^-9 / 2^-30

u

10^-6 / 2^-20

m

10^-3 / 2^-10

c

10^-2

d

10^-1

h

10^2

k

10^3 / 2^10

K

10^3 / 2^10

M

10^6 / 2^20

G

10^9 / 2^30

T

10^12 / 2^40

P

10^15 / 2^50

E

10^18 / 2^60

Z

10^21 / 2^70

Y

10^24 / 2^80

6 編解碼器選項

libavcodec 提供了一些通用的全域選項，這些選項可以在所有編碼器和解碼器上設定。此外，每個編碼器可能支援所謂的私有選項，這些選項是特定於給定編碼器的。

有時，全域選項可能僅影響特定類型的編碼器，並且可能對另一個編碼器毫無意義或被忽略，因此您需要了解指定選項的含義。此外，某些選項僅適用於解碼或編碼。

可以透過在 FFmpeg 工具中指定 -option value 來設定選項，或者透過在 AVCodecContext 選項中明確設定值，或使用 libavutil/opt.h API 進行程式化使用。

以下是支援的選項列表：

b integer (encoding,audio,video)

設定位元率，單位為位元/秒。預設值為 200K。

ab integer (encoding,audio)

設定音訊位元率（單位為位元/秒）。預設值為 128K。

bt integer (encoding,video)

設定視訊位元率容忍度（單位為位元/秒）。在單次編碼模式下，位元率容忍度指定了速率控制願意偏離目標平均位元率值的程度。這與最小/最大位元率無關。過度降低容忍度會對品質產生不利影響。

flags flags (decoding/encoding,audio,video,subtitles)

設定通用旗標。

可能的值：

‘mv4’

每個巨集區塊使用四個運動向量 (mpeg4)。

‘qpel’

使用 1/4 像素運動補償。

‘loop’

使用迴路濾波器。

‘qscale’

使用固定 qscale。

‘pass1’

在第一次編碼模式中使用內部 2pass 速率控制。

‘pass2’

在第二次編碼模式中使用內部 2pass 速率控制。

‘gray’

僅解碼/編碼灰階。

‘psnr’

在編碼期間設定 error[?] 變數。

‘truncated’

輸入位元串流可能被隨機截斷。

‘drop_changed’

請勿輸出參數與串流中第一個解碼幀不同的幀。當幀被丟棄時，會傳回錯誤 AVERROR_INPUT_CHANGED。

‘ildct’

使用交錯 DCT。

‘low_delay’

強制低延遲。

‘global_header’

將全域標頭放置在 extradata 中，而不是每個關鍵幀中。

‘bitexact’

僅寫入與平台、建置和時間無關的資料（除了 (I)DCT 之外）。這確保了檔案和資料校驗和在平台之間是可重現且匹配的。其主要用途是用於迴歸測試。

‘aic’

套用 H263 進階幀內編碼 / mpeg4 ac 預測。

‘ilme’

套用交錯運動估計。

‘cgop’

使用封閉式 GOP。

‘output_corrupt’

輸出即使可能已損壞的幀。

time_base rational number

設定編碼器時間基底。

它是時間的基本單位（以秒為單位），幀時間戳記以其表示。對於固定幀率內容，timebase 應為 1 / frame_rate，並且時間戳記增量應完全為 1。

g integer (encoding,video)

設定圖片群組 (GOP) 大小。預設值為 12。

ar integer (decoding/encoding,audio)

設定音訊取樣率（單位為 Hz）。

ac integer (decoding/encoding,audio)

設定音訊聲道數。

cutoff integer (encoding,audio)

設定截止頻寬。（僅受選定的編碼器支援，請參閱其各自的文件章節。）

frame_size integer (encoding,audio)

設定音訊幀大小。

除了最後一幀之外，每個提交的幀都必須包含每個聲道恰好 frame_size 個樣本。當編碼器設定了 CODEC_CAP_VARIABLE_FRAME_SIZE 時，可以為 0，在這種情況下，幀大小不受限制。某些解碼器會設定它以指示恆定的幀大小。

frame_number integer

設定幀編號。

delay integer

qcomp float (encoding,video)

設定視訊量化器比例壓縮 (VBR)。它在速率控制方程式中用作常數。預設 rc_eq 的建議範圍：0.0-1.0。

qblur float (encoding,video)

設定視訊量化器比例模糊 (VBR)。

qmin integer (encoding,video)

設定最小視訊量化器比例 (VBR)。必須包含在 -1 到 69 之間，預設值為 2。

qmax integer (encoding,video)

設定最大視訊量化器比例 (VBR)。必須包含在 -1 到 1024 之間，預設值為 31。

qdiff integer (encoding,video)

設定量化器比例 (VBR) 之間的最大差異。

bf integer (encoding,video)

設定非 B 幀之間的最大 B 幀數。

必須是介於 -1 和 16 之間的整數。0 表示 B 幀已停用。如果使用值 -1，它將根據編碼器選擇自動值。

預設值為 0。

b_qfactor float (encoding,video)

設定 P 幀和 B 幀之間的 qp 因子。

codec_tag integer

bug flags (decoding,video)

解決未自動偵測到的編碼器錯誤。

可能的值：

‘autodetect’

‘xvid_ilace’

Xvid 交錯錯誤（如果 fourcc==XVIX 則自動偵測）

‘ump4’

（如果 fourcc==UMP4 則自動偵測）

‘no_padding’

填充錯誤（自動偵測）

‘amv’

‘qpel_chroma’

‘std_qpel’

舊標準 qpel（每個 fourcc/版本自動偵測）

‘qpel_chroma2’

‘direct_blocksize’

direct-qpel-blocksize 錯誤（每個 fourcc/版本自動偵測）

‘edge’

邊緣填充錯誤（每個 fourcc/版本自動偵測）

‘hpel_chroma’

‘dc_clip’

‘ms’

解決 microsoft 損壞的解碼器中的各種錯誤。

‘trunc’

截斷的幀

strict integer (decoding/encoding,audio,video)

指定嚴格遵循標準的程度。

可能的值：

‘very’

嚴格遵守規格或參考軟體的較舊且更嚴格的版本

‘strict’

嚴格遵守規格中的所有內容，無論後果如何

‘normal’

‘unofficial’

允許非官方擴展

‘experimental’

允許非標準化的實驗性事物、實驗性（未完成/正在進行中/未充分測試）解碼器和編碼器。注意：實驗性解碼器可能構成安全風險，請勿將其用於解碼不受信任的輸入。

b_qoffset float (encoding,video)

設定 P 幀和 B 幀之間的 QP 偏移。

err_detect flags (decoding,audio,video)

設定錯誤偵測旗標。

可能的值：

‘crccheck’

驗證嵌入的 CRC

‘bitstream’

偵測位元串流規格偏差

‘buffer’

偵測不正確的位元串流長度

‘explode’

在偵測到輕微錯誤時中止解碼

‘ignore_err’

忽略解碼錯誤，並繼續解碼。如果您想要分析影片內容，並因此希望解碼所有內容（無論如何），這很有用。在發生錯誤的情況下，此選項不會產生令人賞心悅目的影片。

‘careful’

將違反規格且未在實際應用中發現的事物視為錯誤

‘compliant’

將所有不符合規格的事物視為錯誤

‘aggressive’

將健全的編碼器不應執行的事物視為錯誤

has_b_frames integer

block_align integer

rc_override_count integer

maxrate integer (encoding,audio,video)

設定最大位元率容忍度（單位為位元/秒）。需要設定 bufsize。

minrate integer (encoding,audio,video)

設定最小位元率容忍度（單位為位元/秒）。在設定 CBR 編碼時最有用。在其他情況下幾乎沒有用處。

bufsize integer (encoding,audio,video)

設定速率控制緩衝區大小（單位為位元）。

i_qfactor float (encoding,video)

設定 P 幀和 I 幀之間的 QP 因子。

i_qoffset float (encoding,video)

設定 P 幀和 I 幀之間的 QP 偏移。

dct integer (encoding,video)

設定 DCT 演算法。

可能的值：

‘auto’

自動選擇一個好的演算法（預設）

‘fastint’

快速整數

‘int’

精確整數

‘mmx’

‘altivec’

‘faan’

浮點 AAN DCT

lumi_mask float (encoding,video)

比中等區域更強烈地壓縮明亮區域。

tcplx_mask float (encoding,video)

設定時間複雜度遮罩。

scplx_mask float (encoding,video)

設定空間複雜度遮罩。

p_mask float (encoding,video)

設定幀間遮罩。

dark_mask float (encoding,video)

比中等區域更強烈地壓縮黑暗區域。

idct integer (decoding/encoding,video)

選擇 IDCT 實作方式。

可能的值：

‘auto’

‘int’

‘simple’

‘simplemmx’

‘simpleauto’

自動選擇與 simple 相容的 IDCT

‘arm’

‘altivec’

‘sh4’

‘simplearm’

‘simplearmv5te’

‘simplearmv6’

‘simpleneon’

‘xvid’

‘faani’

浮點 AAN IDCT

slice_count integer

ec flags (decoding,video)

設定錯誤隱藏策略。

可能的值：

‘guess_mvs’

迭代運動向量 (MV) 搜尋（慢速）

‘deblock’

對損壞的 MB 使用強大的去區塊濾波器

‘favor_inter’

偏好從前一幀而不是目前幀進行預測

bits_per_coded_sample integer

aspect rational number (encoding,video)

設定樣本縱橫比。

sar rational number (encoding,video)

設定樣本縱橫比。aspect 的別名。

debug flags (decoding/encoding,audio,video,subtitles)

印出特定的偵錯資訊。

可能的值：

‘pict’

圖片資訊

‘rc’

速率控制

‘bitstream’

‘mb_type’

巨集區塊 (MB) 類型

‘qp’

每區塊量化參數 (QP)

‘dct_coeff’

‘green_metadata’

顯示即將到來的幀、GoP 或給定持續時間的複雜度元數據。

‘skip’

‘startcode’

‘er’

錯誤辨識

‘mmco’

記憶體管理控制操作 (H.264)

‘bugs’

‘buffers’

圖片緩衝區分配

‘thread_ops’

執行緒操作

‘nomc’

略過運動補償

cmp integer (encoding,video)

設定全像素 ME 比較函數。

可能的值：

‘sad’

絕對差總和，快速（預設）

‘sse’

平方誤差總和

‘satd’

絕對哈達瑪轉換差總和

‘dct’

絕對 DCT 轉換差總和

‘psnr’

平方量化誤差總和（避免使用，品質低）

‘bit’

區塊所需的位元數

‘rd’

速率失真最佳化，慢速

‘zero’

0

‘vsad’

垂直絕對差總和

‘vsse’

垂直平方差總和

‘nsse’

雜訊保留平方差總和

‘w53’

5/3 小波，僅用於雪景

‘w97’

9/7 小波，僅用於雪景

‘dctmax’

‘chroma’

subcmp integer (encoding,video)

設定子像素 ME 比較函式。

可能的值：

‘sad’

絕對差總和，快速（預設）

‘sse’

平方誤差總和

‘satd’

絕對哈達瑪轉換差總和

‘dct’

絕對 DCT 轉換差總和

‘psnr’

平方量化誤差總和（避免使用，品質低）

‘bit’

區塊所需的位元數

‘rd’

速率失真最佳化，慢速

‘zero’

0

‘vsad’

垂直絕對差總和

‘vsse’

垂直平方差總和

‘nsse’

雜訊保留平方差總和

‘w53’

5/3 小波，僅用於雪景

‘w97’

9/7 小波，僅用於雪景

‘dctmax’

‘chroma’

mbcmp integer (encoding,video)

設定巨集區塊比較函式。

可能的值：

‘sad’

絕對差總和，快速（預設）

‘sse’

平方誤差總和

‘satd’

絕對哈達瑪轉換差總和

‘dct’

絕對 DCT 轉換差總和

‘psnr’

平方量化誤差總和（避免使用，品質低）

‘bit’

區塊所需的位元數

‘rd’

速率失真最佳化，慢速

‘zero’

0

‘vsad’

垂直絕對差總和

‘vsse’

垂直平方差總和

‘nsse’

雜訊保留平方差總和

‘w53’

5/3 小波，僅用於雪景

‘w97’

9/7 小波，僅用於雪景

‘dctmax’

‘chroma’

ildctcmp integer (encoding,video)

設定交錯式 DCT 比較函式。

可能的值：

‘sad’

絕對差總和，快速（預設）

‘sse’

平方誤差總和

‘satd’

絕對哈達瑪轉換差總和

‘dct’

絕對 DCT 轉換差總和

‘psnr’

平方量化誤差總和（避免使用，品質低）

‘bit’

區塊所需的位元數

‘rd’

速率失真最佳化，慢速

‘zero’

0

‘vsad’

垂直絕對差總和

‘vsse’

垂直平方差總和

‘nsse’

雜訊保留平方差總和

‘w53’

5/3 小波，僅用於雪景

‘w97’

9/7 小波，僅用於雪景

‘dctmax’

‘chroma’

dia_size integer (encoding,video)

設定運動估計的菱形類型與大小。

‘(1024, INT_MAX)’

完整運動估計（最慢）

‘(768, 1024]’

UMH 運動估計

‘(512, 768]’

HEX 運動估計

‘(256, 512]’

L2S 菱形運動估計

‘[2,256]’

VAR 菱形運動估計

‘(-1, 2)’

小型菱形運動估計

‘-1’

趣味菱形運動估計

‘(INT_MIN, -1)’

SAB 菱形運動估計

last_pred integer (encoding,video)

設定前一影格的運動預測子數量。

precmp integer (encoding,video)

設定預先運動估計比較函式。

可能的值：

‘sad’

絕對差總和，快速（預設）

‘sse’

平方誤差總和

‘satd’

絕對哈達瑪轉換差總和

‘dct’

絕對 DCT 轉換差總和

‘psnr’

平方量化誤差總和（避免使用，品質低）

‘bit’

區塊所需的位元數

‘rd’

速率失真最佳化，慢速

‘zero’

0

‘vsad’

垂直絕對差總和

‘vsse’

垂直平方差總和

‘nsse’

雜訊保留平方差總和

‘w53’

5/3 小波，僅用於雪景

‘w97’

9/7 小波，僅用於雪景

‘dctmax’

‘chroma’

pre_dia_size integer (encoding,video)

設定運動估計預先處理的菱形類型與大小。

subq integer (encoding,video)

設定子像素運動估計品質。

me_range integer (encoding,video)

設定限制運動向量範圍（DivX 播放器為 1023）。

global_quality integer (encoding,audio,video)

slice_flags integer

mbd integer (encoding,video)

設定巨集區塊決策演算法（高品質模式）。

可能的值：

‘simple’

use mbcmp (default)

‘bits’

使用最少位元

‘rd’

use best rate distortion

rc_init_occupancy integer (encoding,video)

設定解碼開始前應載入至 RC 緩衝區的位元數。

flags2 flags (decoding/encoding,audio,video,subtitles)

可能的值：

‘fast’

允許不符合規範的加速技巧。

‘noout’

略過位元流編碼。

‘ignorecrop’

忽略 SPS 中的裁切資訊。

‘local_header’

將全域檔頭放置於每個關鍵影格，而非額外資料中。

‘chunks’

影格資料可能會分割成多個區塊。

‘showall’

顯示第一個關鍵影格之前的所有影格。

‘export_mvs’

將運動向量匯出至影格邊數據（請參閱 AV_FRAME_DATA_MOTION_VECTORS），適用於支援此功能的編解碼器。另請參閱 doc/examples/export_mvs.c。

‘skip_manual’

不略過樣本並將略過資訊匯出為影格邊數據。

‘ass_ro_flush_noop’

在刷新時不重設 ASS ReadOrder 欄位。

‘icc_profiles’

從/向色彩標籤產生/解析嵌入式 ICC 描述檔。

export_side_data flags (decoding/encoding,audio,video,subtitles)

可能的值：

‘mvs’

將運動向量匯出至影格邊數據（請參閱 AV_FRAME_DATA_MOTION_VECTORS），適用於支援此功能的編解碼器。另請參閱 doc/examples/export_mvs.c。

‘prft’

將編碼器 Producer Reference Time 匯出至封包邊數據（請參閱 AV_PKT_DATA_PRFT），適用於支援此功能的編解碼器。

‘venc_params’

透過影格邊數據匯出視訊編碼參數（請參閱 AV_FRAME_DATA_VIDEO_ENC_PARAMS），適用於支援此功能的編解碼器。目前為 H.264 和 VP9。

‘film_grain’

透過影格邊數據匯出膠片顆粒參數（請參閱 AV_FRAME_DATA_FILM_GRAIN_PARAMS）。目前 AV1 解碼器支援。

‘enhancements’

透過影格邊數據匯出圖像增強元數據，例如 LCEVC（請參閱 AV_FRAME_DATA_LCEVC）。

threads integer (decoding/encoding,video)

設定要使用的執行緒數量，如果選定的編解碼器實作支援多執行緒。

可能的值：

‘auto, 0’

自動選取要設定的執行緒數量

預設值為 ‘auto’。

dc integer (encoding,video)

設定 intra_dc_precision。

nssew integer (encoding,video)

設定 NSSE 權重。

skip_top integer (decoding,video)

設定頂端要略過的巨集區塊列數。

skip_bottom integer (decoding,video)

設定底端要略過的巨集區塊列數。

profile integer (encoding,audio,video)

設定編碼器編解碼器描述檔。預設值為 ‘unknown’。編碼器特定描述檔記錄在相關的編碼器文件中。

level integer (encoding,audio,video)

設定編碼器層級。此層級取決於特定的編解碼器，並且可能對應於描述檔層級。預設設定為 ‘unknown’。

可能的值：

‘unknown’

lowres integer (decoding,audio,video)

以 1= 1/2、2=1/4、3=1/8 解析度解碼。

mblmin integer (encoding,video)

設定最小巨集區塊拉格朗日乘數（VBR）。

mblmax integer (encoding,video)

設定最大巨集區塊拉格朗日乘數（VBR）。

skip_loop_filter integer (decoding,video)

skip_idct integer (decoding,video)

skip_frame integer (decoding,video)

根據選項值選取的影格類型，使解碼器捨棄處理。

skip_loop_filter 略過影格迴路濾波，skip_idct 略過影格 IDCT/反量化，skip_frame 略過解碼。

可能的值：

‘none’

不捨棄任何影格。

‘default’

捨棄無用的影格，例如 0 位元組大小的影格。

‘noref’

捨棄所有非參考影格。

‘bidir’

捨棄所有雙向影格。

‘nokey’

捨棄除了關鍵影格以外的所有影格。

‘nointra’

捨棄除了 I 影格以外的所有影格。

‘all’

捨棄所有影格。

預設值為 ‘default’。

bidir_refine integer (encoding,video)

精緻化雙向巨集區塊中使用的兩個運動向量。

keyint_min integer (encoding,video)

設定 IDR 影格之間的最小間隔。

refs integer (encoding,video)

設定運動補償要考量的參考影格。

trellis integer (encoding,audio,video)

設定速率失真最佳化量化。

mv0_threshold integer (encoding,video)

compression_level integer (encoding,audio,video)

bits_per_raw_sample integer

channel_layout integer (decoding/encoding,audio)

請參閱 (ffmpeg-utils)ffmpeg-utils(1) 手冊中的聲道配置章節，以了解所需的語法。

rc_max_vbv_use float (encoding,video)

rc_min_vbv_use float (encoding,video)

color_primaries integer (decoding/encoding,video)

可能的值：

‘bt709’

BT.709

‘bt470m’

BT.470 M

‘bt470bg’

BT.470 BG

‘smpte170m’

SMPTE 170 M

‘smpte240m’

SMPTE 240 M

‘film’

膠片

‘bt2020’

BT.2020

‘smpte428’

‘smpte428_1’

SMPTE ST 428-1

‘smpte431’

SMPTE 431-2

‘smpte432’

SMPTE 432-1

‘jedec-p22’

JEDEC P22

color_trc integer (decoding/encoding,video)

可能的值：

‘bt709’

BT.709

‘gamma22’

BT.470 M

‘gamma28’

BT.470 BG

‘smpte170m’

SMPTE 170 M

‘smpte240m’

SMPTE 240 M

‘linear’

線性

‘log’

‘log100’

對數

‘log_sqrt’

‘log316’

對數平方根

‘iec61966_2_4’

‘iec61966-2-4’

IEC 61966-2-4

‘bt1361’

‘bt1361e’

BT.1361

‘iec61966_2_1’

‘iec61966-2-1’

IEC 61966-2-1

‘bt2020_10’

‘bt2020_10bit’

BT.2020 - 10 位元

‘bt2020_12’

‘bt2020_12bit’

BT.2020 - 12 位元

‘smpte2084’

SMPTE ST 2084

‘smpte428’

‘smpte428_1’

SMPTE ST 428-1

‘arib-std-b67’

ARIB STD-B67

colorspace integer (decoding/encoding,video)

可能的值：

‘rgb’

RGB

‘bt709’

BT.709

‘fcc’

FCC

‘bt470bg’

BT.470 BG

‘smpte170m’

SMPTE 170 M

‘smpte240m’

SMPTE 240 M

‘ycocg’

YCOCG

‘bt2020nc’

‘bt2020_ncl’

BT.2020 NCL

‘bt2020c’

‘bt2020_cl’

BT.2020 CL

‘smpte2085’

SMPTE 2085

‘chroma-derived-nc’

色度衍生 NCL

‘chroma-derived-c’

色度衍生 CL

‘ictcp’

ICtCp

color_range integer (decoding/encoding,video)

若作為輸入參數使用，則作為解碼器的提示，說明輸入具有的色彩範圍。可能的值

‘tv’

‘mpeg’

‘limited’

MPEG (219*2^(n-8))

‘pc’

‘jpeg’

‘full’

JPEG (2^n-1)

chroma_sample_location integer (decoding/encoding,video)

可能的值：

‘left’

‘center’

‘topleft’

‘top’

‘bottomleft’

‘bottom’

log_level_offset integer

設定日誌層級偏移。

slices integer (encoding,video)

切片數量，用於平行化編碼。

thread_type flags (decoding/encoding,video)

選取要使用的多執行緒方法。

使用 ‘frame’ 將使每個執行緒的解碼延遲增加一個影格，因此無法提供未來影格的用戶端不應使用它。

可能的值：

‘slice’

一次解碼單一影格的多個部分。

使用切片的多執行緒僅在視訊以切片編碼時才有效。

‘frame’

一次解碼多個影格。

預設值為 ‘slice+frame’。

audio_service_type integer (encoding,audio)

設定音訊服務類型。

可能的值：

‘ma’

主要音訊服務

‘ef’

效果

‘vi’

視覺障礙

‘hi’

聽覺障礙

‘di’

對白

‘co’

評論

‘em’

緊急狀況

‘vo’

旁白

‘ka’

卡拉 OK

request_sample_fmt sample_fmt (decoding,audio)

設定音訊解碼器應偏好的樣本格式。預設值為 none。

pkt_timebase rational number

sub_charenc encoding (decoding,subtitles)

設定輸入字幕字元編碼。

field_order field_order (video)

設定/覆寫視訊的場序。可能的值

‘progressive’

循序掃描視訊

‘tt’

交錯式視訊，頂場優先編碼和顯示

‘bb’

交錯式視訊，底場優先編碼和顯示

‘tb’

交錯式視訊，頂場優先編碼，底場優先顯示

‘bt’

交錯式視訊，底場優先編碼，頂場優先顯示

skip_alpha bool (decoding,video)

設定為 1 以停用 Alpha（透明度）處理。這與 flags 選項中的 ‘gray’ 旗標類似，後者會略過色度資訊而非 Alpha。預設值為 0。

codec_whitelist list (input)

允許的解碼器之「,」分隔清單。預設情況下，全部都允許。

dump_separator string (input)

用於分隔命令列上關於串流參數的欄位之分隔符號。例如，使用換行符號和縮排分隔欄位

ffprobe -dump_separator "
                          "  -i ~/videos/matrixbench_mpeg2.mpg

max_pixels integer (decoding/encoding,video)

每個圖像的最大像素數。此值可用於避免因大型圖像而導致記憶體不足錯誤。

apply_cropping bool (decoding,video)

如果裁切參數是左側和頂部參數所需對齊的倍數，則啟用裁切。如果未滿足對齊，裁切將部分應用以維持對齊。預設值為 1（啟用）。注意：所需的對齊取決於是否設定了 AV_CODEC_FLAG_UNALIGNED 和 CPU。AV_CODEC_FLAG_UNALIGNED 無法從命令列變更。此外，硬體解碼器不會套用左側/頂部裁切。

7 解碼器

解碼器是 FFmpeg 中已配置的元素，可解碼多媒體串流。

當您配置 FFmpeg 建置時，預設會啟用所有支援的原生解碼器。需要外部函式庫的解碼器必須透過對應的 --enable-lib 選項手動啟用。您可以使用配置選項 --list-decoders 列出所有可用的解碼器。

您可以使用配置選項 --disable-decoders 停用所有解碼器，並使用選項 --enable-decoder=DECODER / --disable-decoder=DECODER 選擇性地啟用/停用單個解碼器。

ff* 工具的選項 -decoders 將顯示已啟用解碼器的清單。

8 影片解碼器

以下是一些目前可用的視訊解碼器的描述。

8.1 av1

AOMedia Video 1 (AV1) 解碼器。

8.1.1 選項

operating_point

選取可擴展 AV1 位元流的操作點 (0 - 31)。預設值為 0。

8.2 hevc

HEVC（又名 ITU-T H.265 或 ISO/IEC 23008-2）解碼器。

解碼器支援最多兩個視圖的 MV-HEVC 多視角串流。要輸出的視圖透過提供視圖 ID 清單給解碼器（view_ids 選項）來選取。此選項可以在解碼器初始化之前靜態設定，也可以從 get_format() 回呼設定 - 對於視圖計數或 ID 在解碼期間動態變更的情況很有用。

預設情況下僅解碼基礎層。

請注意，如果您正在使用 ffmpeg CLI 工具，則應使用其手冊中記錄的視圖規範，而不是此處記錄的選項。

8.2.1 選項

view_ids (MV-HEVC)

指定應輸出的視圖 ID 清單。此選項也可以設定為單個 ‘-1’，這將導致解碼和輸出 VPS 中定義的所有視圖。

view_ids_available (MV-HEVC)

呼叫者可以讀取此選項以檢索活動 VPS 中可用的視圖 ID 陣列。對於單層視訊，陣列為空。

從 get_format() 回呼讀取時，此選項的值保證是準確的。它也可以在其他時間設定（例如，在開啟解碼器之後），但該值僅供參考，並且可能不正確（例如，當串流包含多個不同的 VPS NALU 時）。

view_pos_available (MV-HEVC)

呼叫者可以讀取此選項以檢索活動 VPS 中可用的視圖位置（左、右或未指定）陣列，如 AVStereo3DView 值。當陣列可用時，其元素適用於 view_ids_available 的對應元素，即 view_pos_available[i] 包含 ID 為 view_ids_available[i] 的視圖位置。

與 view_ids_available 相同的有效性限制適用於此選項。

8.3 rawvideo

原始視訊解碼器。

此解碼器解碼 rawvideo 串流。

8.3.1 選項

top top_field_first

指定輸入視訊的假設場類型。

-1

視訊預設為循序掃描（progressive）。

0

預設為底場優先（bottom-field-first）。

1

預設為頂場優先（top-field-first）。

8.4 libdav1d

dav1d AV1 解碼器。

libdav1d 允許 libavcodec 解碼 AOMedia Video 1 (AV1) 編碼格式。組態時需要 libdav1d 的標頭檔和函式庫。您需要明確地使用 --enable-libdav1d 組態建置。

8.4.1 選項

libdav1d wrapper 支援以下選項。

framethreads

設定解碼時使用的影格執行緒數量。預設值為 0（自動偵測）。此選項在 libdav1d >= 1.0 版本中已被棄用，未來將會移除。請改用 max_frame_delay 選項和全域選項 threads。

tilethreads

設定解碼時使用的磚塊執行緒數量。預設值為 0（自動偵測）。此選項在 libdav1d >= 1.0 版本中已被棄用，未來將會移除。請改用全域選項 threads。

max_frame_delay

設定解碼器內部可緩衝的最大影格數量。預設值為 0（自動偵測）。

filmgrain

若位元流中存在 film grain，則將其套用至解碼後的視訊。預設值為函式庫的內部預設值。此選項已被棄用，未來將會移除。請參閱全域選項 export_side_data 以匯出 Film Grain 參數，而非直接套用。

oppoint

選擇可伸縮 AV1 位元流的操作點 (0 - 31)。預設值為函式庫的內部預設值。

alllayers

輸出可伸縮 AV1 位元流的所有空間層。預設值為 false。

8.5 libdavs2

AVS2-P2/IEEE1857.4 視訊解碼器 wrapper。

此解碼器允許 libavcodec 使用 davs2 函式庫解碼 AVS2 串流。

8.6 libuavs3d

AVS3-P2/IEEE1857.10 視訊解碼器。

libuavs3d 允許 libavcodec 解碼 AVS3 串流。組態時需要 libuavs3d 的標頭檔和函式庫。您需要明確地使用 --enable-libuavs3d 組態建置。

8.6.1 選項

libuavs3d wrapper 支援以下選項。

frame_threads

設定解碼時使用的影格執行緒數量。預設值為 0（自動偵測）。

8.7 libxevd

eXtra-fast Essential Video Decoder (XEVD) MPEG-5 EVC 解碼器 wrapper。

此解碼器組態時需要 libxevd 的標頭檔和函式庫。您需要明確地使用 --enable-libxevd 組態建置。

xevd 專案網站位於 https://github.com/mpeg5/xevd。

8.7.1 選項

libxevd wrapper 支援以下選項。括號中列出 xevd 等效選項或值，以便輕鬆遷移。

若要取得更精確且詳盡的 libxevd 選項文件，請調用命令 xevd_app --help 或查閱 libxevd 文件。

threads (threads)

強制使用特定數量的執行緒

8.8 QSV 解碼器

Intel QuickSync Video 解碼器系列 (VC1、MPEG-2、H.264、HEVC、JPEG/MJPEG、VP8、VP9、AV1、VVC)。

8.8.1 通用選項

所有 qsv 解碼器都支援以下選項。

async_depth

內部平行化深度，值越高延遲越高。

gpu_copy

GPU 加速的視訊記憶體和系統記憶體之間的複製

‘default’

‘on’

‘off’

8.8.2 HEVC 選項

hevc_qsv 的額外選項。

load_plugin

要在內部會話中載入的使用者外掛程式

‘none’

‘hevc_sw’

‘hevc_hw’

load_plugins

要在內部會話中載入的十六進制外掛程式 UID 的 :-分隔列表

8.9 v210

未壓縮 4:2:2 10 位元解碼器。

8.9.1 選項

custom_stride

設定 v210 資料的行大小（以位元組為單位）。預設值為 0（自動偵測）。您可以對 BOXX 檔案中看到的無條紋 v210 使用特殊值 -1。

9 音訊解碼器

以下描述一些目前可用的音訊解碼器。

9.1 ac3

AC-3 音訊解碼器。

此解碼器實作 ATSC A/52:2010 和 ETSI TS 102 366 的一部分，以及未公開的文件 RealAudio 3 (又名 dnet)。

9.1.1 AC-3 解碼器選項

-drc_scale value

動態範圍縮放因子。要從 AC-3 串流套用至動態範圍值的因子。此因子以指數方式套用。預設值為 1。有 3 個值得注意的縮放因子範圍

drc_scale == 0

DRC 已停用。產生全範圍音訊。

0 < drc_scale <= 1

DRC 已啟用。套用串流 DRC 值的一部分。音訊重現介於全範圍和全壓縮之間。

drc_scale > 1

DRC 已啟用。不對稱地套用 drc_scale。響亮的聲音被完全壓縮。柔和的聲音被增強。

9.2 flac

FLAC 音訊解碼器。

此解碼器旨在實作 Xiph 的完整 FLAC 規範。

9.2.1 FLAC 解碼器選項

-use_buggy_lpc

lavc FLAC 編碼器過去會產生具有高 lpc 值（如預設值）的錯誤串流。此選項透過使用 lavc 的舊版錯誤 lpc 邏輯進行解碼，使正確解碼此類串流成為可能。

9.3 ffwavesynth

內部波形合成器。

此解碼器根據預定義的序列產生波形模式。其使用純粹是內部的，並且它接受的資料格式未公開記錄。

9.4 libcelt

libcelt 解碼器 wrapper。

libcelt 允許 libavcodec 解碼 Xiph CELT 超低延遲音訊編碼格式。組態時需要 libcelt 的標頭檔和函式庫。您需要明確地使用 --enable-libcelt 組態建置。

9.5 libgsm

libgsm 解碼器 wrapper。

libgsm 允許 libavcodec 解碼 GSM 全速率音訊編碼格式。組態時需要 libgsm 的標頭檔和函式庫。您需要明確地使用 --enable-libgsm 組態建置。

此解碼器同時支援普通的 GSM 和 Microsoft 變體。

9.6 libilbc

libilbc 解碼器 wrapper。

libilbc 允許 libavcodec 解碼網際網路低位元速率編碼 (iLBC) 音訊編碼格式。組態時需要 libilbc 的標頭檔和函式庫。您需要明確地使用 --enable-libilbc 組態建置。

9.6.1 選項

libilbc wrapper 支援以下選項。

enhance

設定為 1 時，啟用解碼音訊的增強功能。預設值為 0（停用）。

9.7 libopencore-amrnb

libopencore-amrnb 解碼器 wrapper。

libopencore-amrnb 允許 libavcodec 解碼自適應多速率窄頻音訊編碼格式。使用它需要 libopencore-amrnb 的標頭檔和函式庫。您需要明確地使用 --enable-libopencore-amrnb 組態建置。

FFmpeg 原生 AMR-NB 解碼器已存在，因此使用者可以在沒有此函式庫的情況下解碼 AMR-NB。

9.8 libopencore-amrwb

libopencore-amrwb 解碼器 wrapper。

libopencore-amrwb 允許 libavcodec 解碼自適應多速率寬頻音訊編碼格式。使用它需要 libopencore-amrwb 的標頭檔和函式庫。您需要明確地使用 --enable-libopencore-amrwb 組態建置。

FFmpeg 原生 AMR-WB 解碼器已存在，因此使用者可以在沒有此函式庫的情況下解碼 AMR-WB。

9.9 libopus

libopus 解碼器 wrapper。

libopus 允許 libavcodec 解碼 Opus 互動式音訊編碼格式。組態時需要 libopus 的標頭檔和函式庫。您需要明確地使用 --enable-libopus 組態建置。

FFmpeg 原生 Opus 解碼器已存在，因此使用者可以在沒有此函式庫的情況下解碼 Opus。

10 字幕解碼器

10.1 libaribb24

ARIB STD-B24 字幕解碼器。

實作 ARIB STD-B24 標準的設定檔 A 和 C。

10.1.1 libaribb24 解碼器選項

-aribb24-base-path path

設定 libaribb24 函式庫的基礎路徑。這用於讀取組態檔（用於自訂 Unicode 轉換），以及用於將非文字符號作為影像傾印到該位置下。

預設為未設定。

-aribb24-skip-ruby-text boolean

告訴解碼器 wrapper 跳過包含半高 ruby 文字的文字區塊。

預設為啟用。

10.2 libaribcaption

另一個使用外部 libaribcaption 函式庫的 ARIB STD-B24 字幕解碼器。

實作日本 ARIB STD-B24 標準、巴西 ABNT NBR 15606-1 和菲律賓 ISDB-T 版本的設定檔 A 和 C。

組態時需要 libaribcaption 的標頭檔和函式庫 (https://github.com/xqq/libaribcaption)。您需要明確地使用 --enable-libaribcaption 組態建置。如果同時啟用 libaribb24 和 libaribcaption，則 libaribcaption 解碼器優先。

10.2.1 libaribcaption 解碼器選項

-sub_type subtitle_type

指定解碼字幕的格式。

‘bitmap’

圖形影像。

‘ass’

ASS 格式化文字。

‘text’

不帶格式的簡單文字輸出。

預設值為 ass，與 libaribb24 解碼器相同。某些現有的播放器（例如，mpv）期望 ARIB 字幕為 ASS 格式。

-caption_encoding encoding_scheme

指定輸入字幕文字的編碼方案。

‘auto’

自動偵測文字編碼（預設）。

‘jis’

ARIB STD B24 中定義的 8 位元字元 JIS 編碼。此編碼在日本用於 ISDB 字幕。

‘utf8’

ARIB STD B24 中定義的 UTF-8 編碼。此編碼在菲律賓用於 ISDB-T 字幕。

‘latin’

ABNT NBR 15606-1 中定義的拉丁字元編碼。此編碼在南美用於 SBTVD / ISDB-Tb 字幕。

-font font_name[,font_name2,...]

指定要用於 bitmap 或 ass 類型字幕渲染的逗號分隔字型系列名稱列表。只有第一個字型名稱用於 ass 類型字幕。

如果未指定，則使用內部定義的預設字型系列。

-ass_single_rect boolean

ARIB STD-B24 規範指出，某些字幕可能同時顯示在不同的位置（多矩形字幕）。由於某些播放器（例如，舊版 mpv）無法處理單個 AVSubtitle 中的多個 ASS 矩形，或具有相同開始時間戳記的多個持續時間不確定的 ASS 矩形，因此此選項可以更改行為，使所有文字都顯示在單個 ASS 矩形中。

預設值為 false。

如果您的播放器無法正確處理具有多個 ASS 矩形的 AVSubtitle，請將此選項設定為 true 或定義 ASS_SINGLE_RECT=1 以在編譯時更改預設行為。

-force_outline_text boolean

指定是否始終為所有字元渲染輪廓文字，無論字元樣式是否指示。

預設值為 false。

-outline_width number (0.0 - 3.0)

指定輪廓文字的寬度，以點（相對）為單位。

預設值為 1.5。

-ignore_background boolean

指定是否忽略背景顏色渲染。

預設值為 false。

-ignore_ruby boolean

指定是否忽略 ruby 類（furigana）字元的渲染。

預設值為 false。

-replace_drcs boolean

指定是否將取代的 DRCS 字元渲染為 Unicode 字元。

預設值為 true。

-replace_msz_ascii boolean

指定是否將 MSZ（中尺寸；半寬）全形字母數字字元取代為半形字母數字字元。

預設值為 true。

-replace_msz_japanese boolean

指定是否將一些 MSZ（中尺寸；半寬）全形日文特殊字元取代為半形字元。

預設值為 true。

-replace_msz_glyph boolean

指定如果字型支援，是否將 MSZ（中尺寸；半寬）字元取代為半形字形。此選項適用於使用 Adobe-Japan1 相容字型的 FreeType 或 DirectWrite 渲染器。例如：IBM Plex Sans JP、Morisawa BIZ UDGothic、Morisawa BIZ UDMincho、Yu Gothic、Yu Mincho 和 Meiryo。

預設值為 true。

-canvas_size image_size

指定用於渲染字幕的畫布解析度；通常，這應該是輸入視訊的影格大小。這僅適用於 -subtitle_type 設定為 bitmap 時。

libaribcaption 解碼器假設位圖渲染的輸入影格大小如下

1. PROFILE_A：1440 x 1080，SAR (PAR) 4:3
2. PROFILE_C：320 x 180，SAR (PAR) 1:1

如果輸入視訊的實際影格大小與上述假設不符，則渲染的字幕可能會失真。為了使字幕不失真，請新增 -canvas_size 選項以指定實際輸入視訊大小。

請注意，對於大小不同但長寬比相同的視訊，不需要 -canvas_size 選項。在這種情況下，如果未指定 -canvas_size 選項，字幕將拉伸或縮小到實際視訊大小。如果指定了具有不同大小的 -canvas_size 選項，字幕將拉伸或縮小為指定大小以及計算出的 SAR。

10.2.2 libaribcaption 解碼器使用範例

使用 ffplay 工具顯示帶有 ARIB 字幕的 MPEG-TS 檔案

ffplay -sub_type bitmap MPEG.TS

使用 ffplay 工具顯示輸入影格大小為 1920x1080 的 MPEG-TS 檔案

ffplay -sub_type bitmap -canvas_size 1920x1080 MPEG.TS

在轉碼後的視訊中嵌入 ARIB 字幕

ffmpeg -sub_type bitmap -i src.m2t -filter_complex "[0:v][0:s]overlay" -vcodec h264 dest.mp4

10.3 dvbsub

10.3.1 選項

compute_clut

-2

如果串流中沒有相符的 CLUT，則計算 CLUT 一次。

-1

如果串流中沒有相符的 CLUT，則計算 CLUT。

0

永不計算 CLUT

1

始終計算 CLUT 並覆寫串流中提供的 CLUT。

dvb_substream

選擇 dvb 子串流，如果為 -1（預設），則選擇所有子串流。

10.4 dvdsub

此編碼器解碼 DVD 中使用的位圖字幕；相同的字幕也可以在 VobSub 檔案對和某些 Matroska 檔案中找到。

10.4.1 選項

palette

指定位圖使用的全域調色盤。當儲存在 VobSub 中時，調色盤通常在索引檔案中指定；在 Matroska 中，調色盤以與 VobSub 相同的格式儲存在編碼器額外資料中。在 DVD 中，調色盤儲存在 IFO 檔案中，因此從傾印的 VOB 檔案讀取時不可用。

此選項的格式是一個字串，其中包含 16 個以逗號分隔的 24 位元十六進制數字（不帶 0x 前綴），例如 0d00ee, ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1, 7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b。

ifo_palette

指定從中取得全域調色盤的 IFO 檔案。（實驗性）

forced_subs_only

僅解碼標記為強制的字幕條目。某些標題在同一軌道中同時具有強制和非強制字幕。將此標誌設定為 1 將僅保留強制字幕。預設值為 0。

10.5 libzvbi-teletext

Libzvbi 允許 libavcodec 解碼 DVB 圖文電視頁面和 DVB 圖文電視字幕。組態時需要 libzvbi 的標頭檔和函式庫。您需要明確地使用 --enable-libzvbi 組態建置。

10.5.1 選項

txt_page

要解碼的圖文電視頁碼列表。不符合指定列表的頁面將被丟棄。您可以使用特殊字串 * 來比對所有頁面，或使用 subtitle 來比對所有字幕頁面。預設值為 *。

txt_default_region

設定用於解碼的預設字元集，值介於 0 到 87 之間（請參閱 ETS 300 706，第 15 節，表 32）。預設值為 -1，不會覆寫 libzvbi 預設值。某些無法傳達正確字元集的舊版 1.0 傳輸需要此選項。

txt_chop_top

捨棄頂部圖文電視行。預設值為 1。

txt_format

指定解碼字幕的格式。

bitmap

預設格式，您應該將此用於圖文電視頁面，因為某些圖形和顏色無法用簡單文字甚至 ASS 表示。

text

不帶格式的簡單文字輸出。

ass

格式化的 ASS 輸出，字幕頁面和圖文電視頁面以不同的樣式傳回，字幕頁面被簡化為文字，但會盡力保留文字對齊和格式。

txt_left

產生位圖的 X 偏移量，預設值為 0。

txt_top

產生位圖的 Y 偏移量，預設值為 0。

txt_chop_spaces

移除產生文字前後的空格並刪除空白行。此選項適用於圖文電視字幕，其中行首或行尾可能存在空格，或者由於雙倍大小的圖文電視字符，字幕行之間可能存在空白行。預設值為 1。

txt_duration

設定解碼後的圖文電視頁面或字幕的顯示持續時間，單位為毫秒。預設值為 -1，表示無限期或直到下一個字幕事件出現。

txt_transparent

強制產生圖文電視點陣圖的透明背景。預設值為 0，表示不透明背景。

txt_opacity

設定圖文電視背景的不透明度 (0-255)。如果未設定 txt_transparent，則僅影響起始方塊和結束方塊之間的字符，通常為字幕。如果設定了 txt_transparent，則預設值為 0，否則為 255。

11 位元流過濾器

當您配置 FFmpeg 建置時，預設會啟用所有支援的位元流過濾器。您可以使用配置選項 --list-bsfs 列出所有可用的過濾器。

您可以使用配置選項 --disable-bsfs 停用所有位元流過濾器，並使用選項 --enable-bsf=BSF 選擇性地啟用任何位元流過濾器，或者您可以使用選項 --disable-bsf=BSF 停用特定的位元流過濾器。

ff* 工具的 -bsfs 選項將顯示您的建置中包含的所有支援位元流過濾器的列表。

ff* 工具的 -bsf 選項應用於每個流，接受以逗號分隔的過濾器列表，其參數在過濾器名稱後以 ' = ' 分隔。

ffmpeg -i INPUT -c:v copy -bsf:v filter1[=opt1=str1:opt2=str2][,filter2] OUTPUT

以下是目前可用的位元流過濾器的描述，以及它們的參數（如果有的話）。

11.1 aac_adtstoasc

將 MPEG-2/4 AAC ADTS 轉換為 MPEG-4 音訊特定配置位元流。

此過濾器從 MPEG-2/4 ADTS 標頭建立 MPEG-4 AudioSpecificConfig，並移除 ADTS 標頭。

例如，當將 AAC 流從原始 ADTS AAC 或 MPEG-TS 容器複製到 MP4A-LATM、FLV 檔案或 MOV/MP4 檔案以及相關格式（如 3GP 或 M4A）時，需要此過濾器。請注意，對於 MP4A-LATM 和 MOV/MP4 以及相關格式，它會自動插入。

11.2 av1_metadata

修改嵌入在 AV1 流中的元數據。

td

在流的所有時間單元中插入或移除時間分隔符 OBU。

‘insert’

在每個尚未具有 TD 的 TU 開頭插入一個 TD。

‘remove’

從每個具有 TD 的 TU 開頭移除 TD。

color_primaries

transfer_characteristics

matrix_coefficients

設定流中的顏色描述字段（請參閱 AV1 第 6.4.2 節）。

color_range

設定流中的顏色範圍（請參閱 AV1 第 6.4.2 節；請注意，對於使用 BT.709 原色、sRGB 傳輸特性和恆等（RGB）矩陣係數的流，無法設定此項）。

‘tv’

有限範圍。

‘pc’

完整範圍。

chroma_sample_position

設定流中的色度樣本位置（請參閱 AV1 第 6.4.2 節）。這只能針對 4:2:0 流設定。

‘vertical’

左側位置（與 MPEG-2 和 H.264 中的預設值相符）。

‘colocated’

左上位置。

tick_rate

在序列標頭的計時資訊中設定滴答率 (time_scale / num_units_in_display_tick)。

num_ticks_per_picture

設定每個圖片中的滴答數，以指示流具有固定的影格率。如果未同時設定 tick_rate，則忽略此項。

delete_padding

刪除填充 OBU。

11.3 chomp

移除封包結尾的零填充。

11.4 dca_core

從 DCA/DTS 流中提取核心，捨棄 DTS-HD 等擴展。

11.5 dovi_rpu

操作 HEVC/AV1 位元流中的杜比視界元數據，可選擇啟用元數據壓縮。

strip

如果啟用，則從流中移除所有杜比視界元數據（配置記錄 + RPU 數據塊）。

compression

要啟用的壓縮級別。

‘none’

無元數據壓縮。

‘limited’

有限的元數據壓縮方案。應與大多數裝置相容。這是預設值。

‘extended’

擴展的元數據壓縮。裝置不一定需要支援此項。請注意，此級別目前在 libavcodec 中的行為與 ‘limited’ 相同。

11.6 dump_extra

將額外數據添加到已過濾封包的開頭，除非所述封包已精確地以打算添加的額外數據開始。

freq

附加參數指定應過濾哪些封包。它接受以下值

‘k’

‘keyframe’

將額外數據添加到所有關鍵封包

‘e’

‘all’

將額外數據添加到所有封包

如果未指定，則假定為 ‘k’。

例如，以下 ffmpeg 命令強制 libx264 編碼器產生的 H.264 封包中使用全域標頭（因此停用個別封包標頭），但通過將儲存在額外數據中的標頭添加到關鍵封包來更正它們

ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts

11.7 dv_error_marker

DV 中標記為損壞的區塊將被指定顏色的區塊取代。

color

用於取代損壞區塊的顏色

sta

一個 16 位元遮罩，用於指定 16 個可能的錯誤狀態值中的哪些值將被彩色區塊取代。0xFFFE 是預設值，它會取代所有非 0 錯誤狀態值。

‘ok’

無錯誤，無隱藏

‘err’

錯誤，無隱藏

‘res’

保留

‘notok’

錯誤或隱藏

‘notres’

未保留

‘Aa, Ba, Ca, Ab, Bb, Cb, A, B, C, a, b, erri, erru’

特定的錯誤狀態代碼

請參閱 http://web.archive.org/web/20060927044735/http://www.smpte.org/smpte_store/standards/pdf/s314m.pdf 的第 44-46 頁或第 5.5 節

11.8 eac3_core

從 E-AC-3 流中提取核心，捨棄額外通道。

11.9 extract_extradata

提取帶內額外數據。

某些編解碼器允許長期標頭（例如 MPEG-2 序列標頭，或 H.264/HEVC (VPS/)SPS/PPS）以「帶內」（即作為包含編碼影格的位元流的一部分）或「帶外」（例如在容器層級）傳輸。在 FFmpeg 術語中，後者形式稱為「額外數據」。

此位元流過濾器偵測帶內標頭，並使其可用作額外數據。

remove

啟用此選項後，長期標頭將在提取後從位元流中移除。

11.10 filter_units

從流中移除類型在給定集合中或不在給定集合中的單元。

pass_types

要通過的單元類型或單元類型範圍的列表，同時移除所有其他類型。這指定為以 ' | ' 分隔的單元類型值或值範圍的列表，範圍用 ' - ' 表示。

remove_types

與 pass_types 相同，不同之處在於給定集合中的單元被移除，而所有其他單元都通過。

pass_types 和 remove_types 使用的類型對應於 H.264、HEVC 和 H.266 中的 NAL 單元類型 (nal_unit_type)（請參閱 H.264 和 HEVC 規範中的表 7-1 或 H.266 規範中的表 5），JPEG 的標記值（不帶 0xFF 前綴），以及 MPEG-2 的起始代碼（不帶起始代碼前綴，即 0x000001 後面的位元組）。對於 VP8 和 VP9，每個單元的類型都為零。

額外數據不受此轉換的影響，但請注意，如果流包含內嵌參數集，則如果移除它們，輸出可能無法使用。

例如，要從 H.264 流中移除所有非 VCL NAL 單元

ffmpeg -i INPUT -c:v copy -bsf:v 'filter_units=pass_types=1-5' OUTPUT

要從 H.265 流中移除所有 AUD、SEI 和填充