雖然經過聲明[x][y]avfilter=a=x:b=y;avfilter=xxx
的方式能夠建立一個可用的Filter
調用鏈,而且在絕大多數場合下這種方式都是靠譜和實用的。 但若是想精細化
的管理AVFilter
調用鏈,例如根據某些條件來動態生成AVFilter Graph
。這種聲明方式就不太靈活(也能夠經過if判斷來動態組裝字符串,若是你很是喜歡這種字符串聲明方式,到此爲止不在建議你往下閱讀了)。git
首先快速溫習一下,如何建立一個AVFilter Graph
。github
+-------+ +---------------------+ +---------------+ |buffer | |Filter ..... Filter N| | buffersink | ----------> | |output|------>|input| |output|---> |input| |--------> +-------+ +---------------------+ +---------------+
建立三部曲:web
buffer
和buffersink
。其中buffer
和buffersink
分別表明Graph
的起始和結束。shell
而後快速封裝args
也就是movie=t.png[wm];[in][wm]overlay=10:20[out]
這樣的filter-complex命令。 並且經過avfilter_graph_parse_ptr
完成中間filter的初始化,restful
最後指定各個filter的input和output,一個graph就算搞定了。函數
好,下面來看如何經過API精細化
生成AVFilter Graph
。 生成下面的Graph:rest
+-------+ +---------------------+ +---------------+ |buffer | | Filter | | buffersink | ----------> | |output|------>|input| Fade |output|---> |input| |--------> +-------+ +---------------------+ +---------------+
首先初始化各個AVFilter。全部的AVFilter的初始化均可以簡化爲兩步操做:code
avfilter_get_by_name
查找指定的AVFilteravfilter_graph_create_filter
初始化AVFilterContext同AVcodec
和AVCodecContext
的關係同樣, 全部的AVFilter的執行都依靠對應的AVFilterContext(在ffmpeg開發中,每一個組件都會對應一個上下文管理器,由這個上下文管理器封裝各類參數而後調用組件執行)。server
經過avfilter_get_by_name
生成AVFilter實例以後,緊跟着就須要調用avfilter_graph_create_filter
初始化上下文管理器。開發
按照下面的流程,依次初始化三個AVFilter:
buffer_src = avfilter_get_by_name("buffer"); ret = avfilter_graph_create_filter(&buffersrc_ctx, buffer_src, "in", args, NULL, filter_graph);
這裏重點聊一下avfilter_graph_create_filter
。 下面是函數原型:
int avfilter_graph_create_filter(AVFilterContext **filt_ctx, const AVFilter *filt, const char *name, const char *args, void *opaque, AVFilterGraph *graph_ctx);
filt_ctx表示這個AVFilter的上下文管理器。
name代表的是AVFilter在Graph中的名稱,這個名稱叫啥不重要但必須惟一。 例如Fade AVFilter
就能夠叫作fade1
,fade2
或者ifade
等等。
args則是這個AVFilter的參數, 注意僅僅是這個AVFilter的參數,不是整個graph的參數。再拿Fade
舉例,args就能夠是t=in:st=3:d=3
。
opaque通常給NULL就能夠了。
初始完這三個AVFilter以後,就進入到本次文檔的重點: avfilter_link
.
int avfilter_link( AVFilterContext * src, unsigned srcpad, AVFilterContext * dst, unsigned dstpad )
avfilter_link
分別用來連接兩個AVFilter(傳說中的一手託兩家)。 src
和dst
分別表示源Filter和目標Filter。 srcpad
表示src
第N個輸出端, dstpad
表示dst
第N個輸入端。 若是很差理解,直接看下面的圖:
+-------------+ +-------------+ | src srcpad 1 -----> dstpad 3 dst | | srcpad 2 -----> dstpad 2 | | srcpad 3 -----> dstpad 1 | +-------------+ +-------------+
上圖假設src
和dst
分別有三個輸出端和三個輸入端(不是全部avfilter都有這麼多的輸入輸出端,像fade只有一個,但overlay就有多個)。
而srcpad
和dstpad
表示的就是輸出/輸入端的序號。假如將buffer
第一個輸出端對應fade
第一個輸入端。 那麼就應該這麼寫:
avfilter_link(buffersrc_ctx, 0, ifade_ctx, 0);
而後將fade
的第一個輸出端對應buffersink
的輸入端,就這麼寫:
avfilter_link(ifade_ctx, 0, buffersink_ctx, 0);
而所謂的精細化
就是在這裏體現的,經過代碼的邏輯判斷,能夠動態的組合不一樣的AVFilter
生成不一樣的Filter Graph
。而且還能夠組合不一樣的輸入/輸出端。
本次代碼示例能夠參考ifilter
。同時也能夠參考 ffmpeg-go-server(一個嘗試爲ffmpeg提供restful API的web server)。