x264 源碼淺析：命令行工具 x264.exe 核心流程與關鍵結構體

概覽

x264.exe 為 libx264 庫的命令行封裝，負責參數解析、輸入輸出文件處理、濾鏡鏈構建，並調用核心編碼 API 將 YUV 編碼為 H.264 碼流。核心流程：

1. main() → parse() 解析命令行參數，初始化 x264_param_t、選擇輸入/輸出模組、濾鏡鏈。
2. encode() 打開編碼器，寫入 SPS/PPS/SEI，循環逐幀編碼，刷新延遲幀，關閉編碼器。

關鍵 API 流程

三大核心結構體

1. cli_output_t —— 輸出封裝

定義於 output/output.h，包含 open_file/set_param/write_headers/write_frame/close_file 五個回調。內建四種實現：

• raw_output：直接 fwrite NAL 資料（裸流 .264）
• mkv_output：Matroska 容器
• mp4_output：GPAC/L-SMASH 封裝 MP4
• flv_output：FLV Tag 封裝，含 DTS/CTS 計算

2. cli_input_t —— 輸入解複用

定義於 input/input.h，提供 open_file/picture_alloc/read_frame/release_frame/picture_clean/close_file。常用實現：

• raw_input：讀取純 YUV，需命令行指定分辨率/色域/位深；支持從文件名解析分辨率。
• y4m_input：解析 YUV4MPEG2 文件頭（W/H/C/I/F/A/X 字段），自動獲取參數。

3. cli_vid_filter_t —— 視頻濾鏡鏈

定義於 filters/video/video.h，將輸入模組統一為濾鏡接口。兩個基礎濾鏡：

• source_filter：透傳 cli_input_t，無實際處理。
• resize_filter：調用 libswscale::sws_scale() 進行拉伸/色域轉換。

編碼循環中：filter.get_frame() → encode_frame() → filter.release_frame()。

編碼主循環簡圖

while (獲取幀) {
    encode_frame() {           // 內部調用 x264_encoder_encode()
        cli_output.write_frame()  // 封裝寫入
    }
}
while (x264_encoder_delayed_frames()) {  // 刷新緩衝
    encode_frame(NULL)
}

常見定製入口

• 新增輸出格式：實現 cli_output_t 並註冊到 select_output()。
• 新增濾鏡：實現 cli_vid_filter_t 接口，掛載到濾鏡鏈。
• 調整預設參數：修改 x264_param_default() 中的賦值。