x264是怎样实现多种位深(bitdepth)支持的？

随着生活水平的提高，小伙伴们的眼神也越发好了。8bit 位深不够用了，现在都 10bit，12bit 了。我在编 x264 的时候，也都必须是支持 8bit 和 10bit 位深的。x264 在不同位深的支持上，颇具奇技淫巧。其实 x265 也不遑多让，但是 x265 编起来比 x264 麻烦多了，留作后话。今天先从一个宏开始，看看 x264 是如何支持多位深的，是为 “窥一斑而知全豹”。

假设有这么一个函数，它在 8bit 位深和 10bit 位深的情况下，里面的实现有所不同：

void x264_log( x264_t *h, int i_level, const char *psz_fmt, ... );

要让我实现的话，那就得搞成这样：

void x264_8_log( x264_t *h, int i_level, const char *psz_fmt, ... );
void x264_10_log( x264_t *h, int i_level, const char *psz_fmt, ... );

 具体实现也就得写2个。甚至相关的 .c 源文件，可能都得每种位深各写一个，不优雅，不高明。

下面直接看 x264 是怎么搞的。

#define x264_log x264_template(log)
void x264_log( x264_t *h, int i_level, const char *psz_fmt, ... );

x264_template 这个宏在整套工程中很常见，以上面这条打log的函数为例，上面两句话，实际上将生成的内容可能是这样的：

void x264_8_log( x264_t *h, int i_level, const char *psz_fmt, ... );

也可能是这样的：

void x264_10_log( x264_t *h, int i_level, const char *psz_fmt, ... );

也就是说，如果你去看 dll 库或者 .o 文件的话，是没有 x264_log 这个函数的，有的只是 x264_8_log 和/或 x264_10_log 函数。让我们再看看这个宏的实现：

#define x264_template(w) x264_glue3(x264, BIT_DEPTH, w)

关注其中有个 BIT_DEPTH 宏，提问：这个宏是几？

如果你当时 ./configure 中没指定 bitdepth，那默认就是 8bit+10bit 都有。那 BIT_DEPTH 具体是几呢？答案就是，工程在编译时，会同时生成一个 common-8.o 和 一个 common-10.o ，在前者里面，BIT_DEPTH 就是8，在后者里面，它就是10。同时，在前者里面，含有 x264_8_log(...) 函数符号，在后者里面，含有 x264_10_log(...) 符号。

那么，工程是怎样从一个 common.c 文件编出来 2个 .o 的呢? 玄机正在 Makefile 中：

#c文件部分
%-8.o: %.c
	$(CC) $(CFLAGS) -c $< $(CC_O) -DHIGH_BIT_DEPTH=0 -DBIT_DEPTH=8

%-10.o: %.c
	$(CC) $(CFLAGS) -c $< $(CC_O) -DHIGH_BIT_DEPTH=1 -DBIT_DEPTH=10

#汇编部分
%-8.o: %.S
	$(AS) $(ASFLAGS) -o $@ $< -DHIGH_BIT_DEPTH=0 -DBIT_DEPTH=8
	-@ $(if $(STRIP), $(STRIP) -x $@)

%-10.o: %.S
	$(AS) $(ASFLAGS) -o $@ $< -DHIGH_BIT_DEPTH=1 -DBIT_DEPTH=10
	-@ $(if $(STRIP), $(STRIP) -x $@)

在编译时，.c 文件会分别针对 8bit 和 10bit 位深各编一次，以 frame.c 文件为例：

//frame.c 文件在编译过程中会被编2次：

gcc -Wno-maybe-uninitialized -Wshadow -O1 -g -m64  -Wall -I. -I. -D_POSIX_C_SOURCE=200112L -std=gnu99 -D_GNU_SOURCE -fno-tree-vectorize -fvisibility=hidden  -DV264_API_EXPORTS -c common/frame.c -o common/frame-8.o -DHIGH_BIT_DEPTH=0 -DBIT_DEPTH=8

gcc -Wno-maybe-uninitialized -Wshadow -O1 -g -m64  -Wall -I. -I. -D_POSIX_C_SOURCE=200112L -std=gnu99 -D_GNU_SOURCE -fno-tree-vectorize -fvisibility=hidden  -DV264_API_EXPORTS -c common/frame.c -o common/frame-10.o -DHIGH_BIT_DEPTH=1 -DBIT_DEPTH=10