FFmpeg关键函数介绍
目录
1. av_register_all()——弃用
2. avformat_alloc_context()
3.avformat_open_input()
4.avformat_find_stream_info()
5.av_read_frame()
6.avcodec_send_packet
7.avcodec_receive_frame()
8.avcodec_open2
9. sws_getContext()
10.sws_scale()
1. av_register_all()——弃用
初始化 libavformat 和注册所有的复用器、解复用器和协议处理器。如果不调用这个函数，可以调用下面的三个函数来选择支持的格式。
• 注册复用器的函数是av_register_output_format()。
• 注册解复用器的函数是av_register_input_format()。
• 注册协议处理器的函数是ffurl_register_protocol()。
注：FFmpeg4.0 以上的版本，这个函数已经被废弃。
2. avformat_alloc_context()
当使用AVFormatContext时， avformat_alloc_context()函数用来对AVFormatContext分配空间，
AVFormatContext *avFormatContext = avformat_alloc_context();//获取上下文3.avformat_open_input()
avformat_open_input的主要功能是打开一个文件，读取header，不会涉及打开编码器。
与之对应的是通过avformat_close_input函数关闭文件。
示例代码：
int error;
//打开视频地址并获取里面的内容(解封装)
error = avformat_open_input(&avFormatContext, inputPath, NULL, NULL);
if (error < 0) {
LOGE("打开视频失败")
return;
}4.avformat_find_stream_info()
读取音视频数据来获取一些相关的信息。
示例代码：
if (avformat_find_stream_info(avFormatContext, NULL) < 0) {
LOGE("获取内容失败")
return;
}5.av_read_frame()
在FFmpeg中av_read_frame函数的作用是读取码流中的若干音频帧或者1帧数据。在解码视频时，每解码一个视频帧，需要先调用av_read_frame获取1帧视频的压缩数据，然后才能对该数据进行解码。
示例代码：
while(1) {
int ret = av_read_frame(avFormatContext, packet);
if (ret != 0) {
av_strerror(ret, buf, sizeof(buf));
LOGE("--%s--\n", buf);
av_packet_unref(packet);
break;
}
if (ret >= 0 && packet->stream_index != mVideoStreamIdx) {
av_packet_unref(packet);
continue;
}
//省略...
}6.avcodec_send_packet
发送数据到ffmepg，放到解码队列中
// 发送待解码包
int result = avcodec_send_packet(mAvContext, packet);7.avcodec_receive_frame()
将成功的解码队列中取出1个frame
示例代码：
while (result >= 0) {
result = avcodec_receive_frame(mAvContext, frame);
if (result == AVERROR_EOF)
break;
else if (result == AVERROR(EAGAIN)) {
result = 0;
break;
} else if (result < 0) {
av_log(NULL, AV_LOG_ERROR, "Error decoding frame\n");
av_frame_unref(frame);
break;
}
// 省略...
}8.avcodec_open2
打开解码器
示例代码：
// 打开解码器
if (avcodec_open2(mAvContext, mVcodec, NULL) != 0){
LOGE("打开失败")
return;
}9. 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);
- srcW：输入图像的宽度
- srcH： 输入图像的宽度
- srcFormat： 输入图像的像素格式
- dstW：输出图像的宽度
- dstH： 输出图像的高度
- dstFormat：输出图像的像素格式
- flags 选择缩放算法(只有当输入输出图像大小不同时有效),一般选择SWS_FAST_BILINEAR
- srcFilter： 输入图像的滤波器信息, 若不需要传NULL
- dstFilter：输出图像的滤波器信息, 若不需要传NULL
- param ： 特定缩放算法需要的参数(?)，默认为NULL
- 成功后返回SwsContext 类型的结构体。
示例代码：
SwsContext* swsContext = sws_getContext(mAvContext->width,mAvContext->height,mAvContext->pix_fmt,
mAvContext->width,mAvContext->height,AV_PIX_FMT_RGBA,
SWS_BICUBIC,NULL,NULL,NULL);
10.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[]);
参数：
SwsContext *c： 转换格式的上下文。
srcSlice[],：输入图像的每个颜色通道的数据指针。
srcStride[]：输入图像的每个颜色通道的跨度。.
srcSliceY：起始位置。
srcSliceH：处理多少行。
dst[]：输出图像的每个颜色通道数据指针。
dstStride[]：输出图像的每个颜色通道行字节数。
示例代码：
//转换为rgb格式
sws_scale(swsContext, (const uint8_t *const *) frame->data, frame->linesize, 0,
frame->height, rgb_frame->data,
rgb_frame->linesize);