FFmpeg 常用API
一、通用API
1.1 av_register_all()
初始化 libavformat 和注册所有的复用器、解复用器和协议处理器。如果不调用这个函数，可以调用下面的三个函数来选择支持的格式。
- 注册复用器的函数是
av_register_output_format()。 - 注册解复用器的函数是
av_register_input_format()。 - 注册协议处理器的函数是
ffurl_register_protocol()。
注：FFmpeg4.0 以上的版本，这个函数已经被废弃。
1.2 内存的分配和释放（av_malloc()、av_free()等）
av_malloc() 和 av_free() 都是简单的封装了系统函数 malloc() 和free()，并做了一些错误检查工作。同理的还有 av_realloc()。
1.3 avcodec_find_encoder() 和 avcodec_find_decoder()
avcodec_find_encoder() 用于查找 FFmpeg 的编码器，avcodec_find_decoder() 用于查找 FFmpeg 的解码器，声明都位于 libavcodec\avcodec.h。其原型如下：
// 函数的参数是一个编码器的ID，返回查找到的编码器（没有找到就返回NULL）。
AVCodec *avcodec_find_encoder(enum AVCodecID id);
// 函数的参数是一个解码器的ID，返回查找到的解码器（没有找到就返回NULL）。
AVCodec *avcodec_find_decoder(enum AVCodecID id);
1.4 avcodec_open2()
用于初始化一个视音频编解码器的 AVCodecContext，声明位于 libavcodec\utils.c。其原型如下：
int avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
- avctx：需要初始化的 AVCodecContext。
- codec：输入的AVCodec。
- options：一些选项。例如使用libx264编码的时候，“preset”，“tune”等都可以通过该参数设置。
1.5 avcodec_close()
用于关闭编码器，声明位于 libavcodec\utils.c。其原型如下：
int avcodec_close(AVCodecContext *avctx)
该函数只有一个参数，就是需要关闭的编码器的 AVCodecContext。
二、解码API
下面介绍解码需要用到的几个函数，声明都位于 libavformat\avformat.h。
2.1 avformat_open_input()
打开输出的流和读取头信息。其原型如下：
int avformat_open_input(AVFormatContext **ps, const char *url, AVInputFormat *fmt, AVDictionary **options)
- ps：函数调用成功之后处理过的 AVFormatContext 结构体。
- url：打开的视音频流的 URL。
- fmt：强制指定 AVFormatContext 中 AVInputFormat 的。这个参数一般情况下可以设置为 NULL，这样 FFmpeg 可以自动检测 AVInputFormat。
- options：附加的一些选项，一般情况下可以设置为 NULL。
函数执行成功的话，其返回值大于等于 0。
2.2 avformat_find_stream_info()
读取音视频数据来获取一些相关的信息。其原型如下：
int avformat_find_stream_info(AVFormatContext *ic, AVDictionary **options)
2.3 av_read_frame
读取码流中的音频若干帧或者视频一帧。例如，解码视频的时候，每解码一个视频帧，需要先调用 av_read_frame() 获得一帧视频的压缩数据，然后才能对该数据进行解码。其原型如下：
int av_read_frame(AVFormatContext *s, AVPacket *pkt)
2.4 avformat_close_input()
关闭打开的流。其原型如下：
void avformat_close_input(AVFormatContext **s)
三、编码API
在基于 FFmpeg 的音视频编码器程序中，avformat_alloc_output_context2() 函数通常是第一个调用的函数（除了组件注册函数 av_register_all()）。另外介绍 FFmpeg 的写文件用到的 3 个函数，声明都位于 libavformat\avformat.h：
- av_write_frame() 用于写视频数据；
- avformat_write_header() 用于写视频文件头；
- av_write_trailer() -用于写视频文件尾。
3.1 avformat_alloc_output_context2()
初始化一个用于输出的 AVFormatContext 结构体。其原型如下：
int avformat_alloc_output_context2(AVFormatContext **ctx, AVOutputFormat * oformat, const char * format_name, const char * filename)
3.2 avformat_write_header()
分配一个 stream 的私有数据而且写 stream 的 header 到一个输出的媒体文件。其原型如下：
int avformat_write_header(AVFormatContext *s, AVDictionary ** options)
3.3 av_write_frame()
用于输出一帧视音频数据。其原型如下：
int av_write_frame(AVFormatContext *s, AVPacket *pkt)
参数 s 为用于输出的 AVFormatContext，参数 pkt 为等待输出的 AVPacket。
3.4 av_write_trailer()
用于输出文件尾。其原型如下：
int av_write_trailer(AVFormatContext *s)
它只需要指定一个参数，即用于输出的 AVFormatContext，函数正常执行后返回值等于 0。
四、图像处理API
libswscale 是一个主要用于处理图片像素数据的类库。可以完成图片像素格式的转换，图片的拉伸等工作。libswscale 常用的函数数量很少，一般情况下就3个，声明都位于 libswscale\swscale.h：
sws_getContext()：分配和返回一个SwsContext。
sws_scale()：处理图像数据。
sws_freeContext()：释放一个SwsContext。
其中 sws_getContext() 也可以用 sws_getCachedContext() 取代。
4.1 sws_getContext()
分配和返回一个 SwsContext。其原型如下：
struct SwsContext* sws_getContext ( int srcW,
int srcH,
enum AVPixelFormat srcFormat,
int dstW,
int dstH,
enum AVPixelFormat dstFormat,
int flags,
SwsFilter * srcFilter,
SwsFilter * dstFilter,
const double * param
)
4.2 sws_scale()
处理图像数据。其原型如下：
int sws_scale(struct SwsContext *c,
const uint8_t * const srcSlice[],
const int srcStride[], int srcSliceY,
int srcSliceH, uint8_t *const dst[],
const int dstStride[]) )
4.3 sws_freeContext()
释放一个 SwsContext。其原型如下：
void sws_freeContext(struct SwsContext *swsContext)
五、其它API
5.1 日志输出系统（av_log()等）
av_log() 是 FFmpeg 中输出日志的函数。一般情况下 FFmpeg 类库的源代码中是不允许使用 printf() 这种的函数的，所有的输出一律使用 av_log()。av_log() 的声明位于 libavutil\log.h，其原型如下：
void av_log(void* avcl, int level, const char *fmt, ...)
函数最后一个参数是 “…”。
在 C 语言中，在函数参数数量不确定的情况下使用 “…” 来代表参数。例如 printf() 的原型定义为：int printf (const char*, ...)。
参考：
雷霄骅大神的FFmpeg的库函数源代码分析文章列表：
【通用】
FFmpeg 源代码简单分析：av_register_all()
FFmpeg 源代码简单分析：avcodec_register_all()
FFmpeg 源代码简单分析：内存的分配和释放（av_malloc()、av_free()等）
FFmpeg 源代码简单分析：常见结构体的初始化和销毁（AVFormatContext，AVFrame等）
FFmpeg 源代码简单分析：av_find_decoder()和av_find_encoder()
FFmpeg 源代码简单分析：avcodec_open2()
FFmpeg 源代码简单分析：avcodec_close()
【解码】
图解FFMPEG打开媒体的函数avformat_open_input
FFmpeg 源代码简单分析：avformat_open_input()
FFmpeg 源代码简单分析：avformat_find_stream_info()
FFmpeg 源代码简单分析：av_read_frame()
FFmpeg 源代码简单分析：avcodec_decode_video2()
FFmpeg 源代码简单分析：avformat_close_input()
【编码】
FFmpeg 源代码简单分析：avformat_alloc_output_context2()
FFmpeg 源代码简单分析：avformat_write_header()
FFmpeg 源代码简单分析：avcodec_encode_video()
FFmpeg 源代码简单分析：av_write_frame()
FFmpeg 源代码简单分析：av_write_trailer()
【其它】
FFmpeg源代码简单分析：日志输出系统（av_log()等）
FFmpeg源代码简单分析：结构体成员管理系统-AVClass
FFmpeg源代码简单分析：结构体成员管理系统-AVOption
FFmpeg源代码简单分析：libswscale的sws_getContext()
FFmpeg源代码简单分析：libswscale的sws_scale()
FFmpeg源代码简单分析：libavdevice的avdevice_register_all()
FFmpeg源代码简单分析：libavdevice的gdigrab
