FFmpeg應用實踐之命令查詢

coffee_tea_or_me發表於2021-05-19

0. 前言

FFmpeg 中常用的工具有三個,分別是多媒體編解碼工具ffmpeg、多媒體內容分析工具ffprobe和多媒體播放器ffplay。本文介紹的指令都是與編解碼工具 ffmpeg 相關的。

學會查詢內建文件能夠解決我們遇到的很多引數設定問題,也可以避免因為網上各種版本不同、質量參差不齊的答案而困惑。

1. ffmpeg 幫助資訊

ffmpeg 命令列指令語法格式如下

ffmpeg [global_options] {[input_file_options] -i input_url} ... {[output_file_options] output_url} ...

ffmpeg 命令列應用中,最基礎的操作就是查詢一些諸如版本、支援的編碼方式/編解碼器/濾鏡等資訊。

首先我們要學會使用的是最最基本的一個命令 -help,有了它我們就可以更愉快地學習與之相關的各種功能了。

執行 ffmpeg -h 後,在終端會列印出與當前使用版本相關的幫助資訊。通常在 Linux 系統下使用時可以用如下所示的命令列指令,利用管道加上 less 後可以使用 /match_template 來快速匹配定位到自己關心的部分。

~$ ffmpeg -h full | less
ffmpeg version 3.4.8-0ubuntu0.2 Copyright (c) 2000-2020 the FFmpeg developers
  built with gcc 7 (Ubuntu 7.5.0-3ubuntu1~18.04)
  configuration: --prefix=/usr --extra-version=0ubuntu0.2 --toolchain=hardened --libdir=/usr/lib/x86_64-linux-gnu
--incdir=/usr/include/x86_64-linux-gnu --enable-gpl --disable-stripping --enable-avresample --enable-avisynth
--enable-gnutls --enable-ladspa --enable-libass --enable-libbluray --enable-libbs2b --enable-libcaca
--enable-libcdio --enable-libflite --enable-libfontconfig --enable-libfreetype --enable-libfribidi --enable-libgme
--enable-libgsm --enable-libmp3lame --enable-libmysofa --enable-libopenjpeg --enable-libopenmpt --enable-libopus
--enable-libpulse --enable-librubberband --enable-librsvg --enable-libshine --enable-libsnappy --enable-libsoxr
--enable-libspeex --enable-libssh --enable-libtheora --enable-libtwolame --enable-libvorbis --enable-libvpx
--enable-libwavpack --enable-libwebp --enable-libx265 --enable-libxml2 --enable-libxvid --enable-libzmq
--enable-libzvbi --enable-omx --enable-openal --enable-opengl --enable-sdl2 --enable-libdc1394 --enable-libdrm
--enable-libiec61883 --enable-chromaprint --enable-frei0r --enable-libopencv --enable-libx264 --enable-shared
  libavutil      55. 78.100 / 55. 78.100
  libavcodec     57.107.100 / 57.107.100
  libavformat    57. 83.100 / 57. 83.100
  libavdevice    57. 10.100 / 57. 10.100
  libavfilter     6.107.100 /  6.107.100
  libavresample   3.  7.  0 /  3.  7.  0
  libswscale      4.  8.100 /  4.  8.100
  libswresample   2.  9.100 /  2.  9.100
  libpostproc    54.  7.100 / 54.  7.100
...

除了上述最基本的使用方法外,使用 -h type=name 引數可以用來檢視指定名稱的編/解碼器、複用/解複用器、濾鏡等的詳細資訊,非常實用。比如下面的示例中檢視 H.264(AVC) 編碼器的配置引數。

~$ ffmpeg -h encoder=h264 | less
...
Encoder libx264 [libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10]:
    General capabilities: delay threads
    Threading capabilities: auto
    Supported pixel formats: yuv420p yuvj420p yuv422p yuvj422p yuv444p yuvj444p nv12 nv16 nv21
libx264 AVOptions:
...

ffmpeg -h 輸出資訊中可以看到,ffmpeg 常見命令大概分為六類,分別是

  • ffmpeg 資訊查詢部分
  • 全域性配置引數部分
  • 檔案主要配置引數部分
  • 視訊配置引數部分
  • 音訊配置引數部分
  • 字幕配置引數部分

2. ffmpeg 資訊查詢指令

可以通過本小節的引數來查詢 ffmpeg 支援的封裝或者編解碼格式等。

-L                  顯示ffmpeg目前所支援的License協議
-version            顯示版本資訊
-buildconf          顯示編譯配置
-formats            顯示可用的格式
-muxers             顯示可用的複用器
-demuxers           顯示可用的解複用器
-devices            顯示可用的裝置
-codecs             顯示可用的編解碼器,包括編碼器和解碼器
-decoders           顯示可用的解碼器
-encoders           顯示可用的編碼器
-bsfs               顯示可用的位元流濾鏡
-protocols          顯示可用的協議
-filters            顯示可用的濾鏡
-pix_fmts           顯示可用的畫素格式
-layouts            顯示標準聲道名稱
-sample_fmts        顯示可用的音訊取樣格式
-colors             顯示可用的顏色名稱
-sources device     列出輸入裝置的來源
-sinks device       列出輸出裝置的接收器
-hwaccels           顯示可用的HW加速方法

比如使用 -version 引數可以檢視 ffmepg 的版本,包括子模組如libavutil、libavcodec、libavformat、libavdevice、libavfilter、libavresample、libswscale、libswresample、libpostproc等的詳細版本資訊。

使用 -formats 引數可以檢視當前使用的 ffmpeg 是否支援對應檔案的視訊格式。這樣當我們使用 ffmpeg 轉碼時如果遇到報錯提示不支援生成對應的視訊檔案,就可以進行相應的調整。

如下示例是使用 -devices 引數列出可用裝置的輸出結果。

~$ ffmpeg -devices
...
Devices:
 D. = Demuxing supported
 .E = Muxing supported
 --
 DE alsa            ALSA audio output
  E caca            caca (color ASCII art) output device
 DE fbdev           Linux framebuffer
 D  iec61883        libiec61883 (new DV1394) A/V input device
 D  jack            JACK Audio Connection Kit
 D  lavfi           Libavfilter virtual input device
 D  libcdio          
 D  libdc1394       dc1394 v.2 A/V grab
 D  openal          OpenAL audio capture device
  E opengl          OpenGL output
 DE oss             OSS (Open Sound System) playback
 DE pulse           Pulse audio output
  E sdl,sdl2        SDL2 output device
 DE sndio           sndio audio playback
  E v4l2            Video4Linux2 output device
 D  video4linux2,v4l2 Video4Linux2 device grab
 D  x11grab         X11 screen capture, using XCB
  E xv              XV (XVideo) output device

3. 全域性相關的配置選項

Global options (affect whole program instead of just one file:
-loglevel loglevel  set logging level
-v loglevel         set logging level
-report             generate a report
-max_alloc bytes    set maximum size of a single allocated block
-y                  overwrite output files
-n                  never overwrite output files
-ignore_unknown     Ignore unknown stream types
-filter_threads     number of non-complex filter threads
-filter_complex_threads  number of threads for -filter_complex
-stats              print progress report during encoding
-max_error_rate ratio of errors (0.0: no errors, 1.0: 100% error  maximum error rate
-bits_per_raw_sample number  set the number of bits per raw sample
-vol volume         change audio volume (256=normal)

-v loglevel 用於設定日誌輸出級別,不同的等級輸出的資訊密度和重要程度有所區別,一般設定成 info 就能獲取足夠的資訊用於除錯。

-y 用於輸出時覆蓋已有檔案。

4. 單個檔案相關的配置選項

Per-file main options:
-f fmt              force format
-c codec            codec name
-codec codec        codec name
-pre preset         preset name
-map_metadata outfile[,metadata]:infile[,metadata]  set metadata information of outfile from infile
-t duration         record or transcode "duration" seconds of audio/video
-to time_stop       record or transcode stop time
-fs limit_size      set the limit file size in bytes
-ss time_off        set the start time offset
-sseof time_off     set the start time offset relative to EOF
-seek_timestamp     enable/disable seeking by timestamp with -ss
-timestamp time     set the recording timestamp ('now' to set the current time)
-metadata string=string  add metadata
-program title=string:st=number...  add program with specified streams
-target type        specify target file type ("vcd", "svcd", "dvd", "dv" or "dv50" with optional prefixes "pal-", "ntsc-" or "film-")
-apad               audio pad
-frames number      set the number of frames to output
-filter filter_graph  set stream filtergraph
-filter_script filename  read stream filtergraph description from a file
-reinit_filter      reinit filtergraph on input parameter changes
-discard            discard
-disposition        disposition

-f fmt 用於指定輸出或輸出檔案的格式。

-frames number 用於設定輸出檔案幀的數量。

5. 多媒體視訊相關的配置選項

Video options:
-vframes number     set the number of video frames to output
-r rate             set frame rate (Hz value, fraction or abbreviation)
-s size             set frame size (WxH or abbreviation)
-aspect aspect      set aspect ratio (4:3, 16:9 or 1.3333, 1.7777)
-bits_per_raw_sample number  set the number of bits per raw sample
-vn                 disable video
-vcodec codec       force video codec ('copy' to copy stream)
-timecode hh:mm:ss[:;.]ff  set initial TimeCode value.
-pass n             select the pass number (1 to 3)
-vf filter_graph    set video filters
-ab bitrate         audio bitrate (please use -b:a)
-b bitrate          video bitrate (please use -b:v)
-dn                 disable data

-vframes number 用於設定輸出視訊幀的數量。

-r rate 用於設定輸出視訊的幀率。

-vn 常用於只保留音訊資料的場合。

-vf filter_graph 用於配置相關的濾鏡。

6. 多媒體音訊相關的配置選項

Audio options:
-aframes number     set the number of audio frames to output
-aq quality         set audio quality (codec-specific)
-ar rate            set audio sampling rate (in Hz)
-ac channels        set number of audio channels
-an                 disable audio
-acodec codec       force audio codec ('copy' to copy stream)
-vol volume         change audio volume (256=normal)
-af filter_graph    set audio filters

-ac channels 用於設定音訊通道數量,單聲道、立體聲等。

-an 常用於只保留視訊資料的場合。

7. 多媒體字幕相關的配置選項

Subtitle options:
-s size             set frame size (WxH or abbreviation)
-sn                 disable subtitle
-scodec codec       force subtitle codec ('copy' to copy stream)
-stag fourcc/tag    force subtitle tag/fourcc
-fix_sub_duration   fix subtitles duration
-canvas_size size   set canvas size (WxH or abbreviation)
-spre preset        set the subtitle options to the indicated preset

-sn 設定輸出結果中遮蔽字幕資訊,只保留音訊或視訊。


參考資料

[1] ffmpeg Documentation http://ffmpeg.org/ffmpeg-all.html

[2] FFmpeg命令列工具-實用命令 https://www.jianshu.com/p/124aee284a61

[3] ffmpeg常用命令 #32 https://github.com/gnipbao/iblog/issues/32

本文作者 :phillee
發表日期 :2021年5月19日
本文連結https://www.cnblogs.com/phillee/p/14785534.html
版權宣告 :自由轉載-非商用-非衍生-保持署名(創意共享3.0許可協議/CC BY-NC-SA 3.0)。轉載請註明出處!
限於本人水平,如果文章和程式碼有表述不當之處,還請不吝賜教。

感謝您的支援

¥ 打賞

FFmpeg應用實踐之命令查詢

微信支付

相關文章