avpicture_fill()的使用心得

ffmpeg4.2.2-avpicture_fill()的使用心得
1. avpicture_fill()的声明
/**
 * @deprecated use av_image_fill_arrays() instead.
 */
attribute_deprecated
int avpicture_fill(AVPicture *picture, const uint8_t *ptr,
                   enum AVPixelFormat pix_fmt, int width, int height);

FF_DISABLE_DEPRECATION_WARNINGS
int avpicture_fill(AVPicture *picture, const uint8_t *ptr,
                   enum AVPixelFormat pix_fmt, int width, int height)
{
    return av_image_fill_arrays(picture->data, picture->linesize,
                                ptr, pix_fmt, width, height, 1);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
由上可见, avpicture_fill()函数在ffmpeg4.2.2中就已经被抛弃了, 取而代之的是av_image_fill_arrays()函数. avpicture_fill()中实际调用的也是av_image_fill_arrays()函数, 所以我们拿av_image_fill_arrays()来分析.

2. av_image_fill_arrays()的形参说明
@param dst_data            要填充的数据指针
@param dst_linesize        dst_data中要被填充的线条大小(即linesize, 行宽)
@param src                包含实际图像的缓冲区(可以为空).
@param pix_fmt            图像的像素格式
@param width             图像的像素宽度
@param height            图像的像素高度
@param align             在src中用于行宽对齐的值

@return the size in bytes required for src, a negative error code in case of failure
    该函数返回src所需的大小(以字节为单位), 失败时返回一个负数(错误代码).
1
2
3
4
5
6
7
8
9
10
3. av_image_fill_arrays()的作用
  根据指定的图像参数和提供的数组设置数据指针和行宽(linesizes). avpicture_fill函数将ptr指向的数据填充到picture内，但并没有拷贝，只是将picture结构内的data指针指向了ptr的数据!

4. av_image_fill_arrays()的流程解析
// ffmpeg-4.2.2\libavutil\imgutils.c
int av_image_fill_arrays(uint8_t *dst_data[4], int dst_linesize[4],
                         const uint8_t *src, enum AVPixelFormat pix_fmt,
                         int width, int height, int align)
{
    int ret, i;

    // 检查输入的width和height是否可用.
    ret = av_image_check_size(width, height, 0, NULL);
    if (ret < 0)
        return ret;
    /**
     * 1. memset(linesizes, 0, 4*sizeof(linesizes[0])); 将dst_linesize数组的内容清零;
     * 2. 利用av_pix_fmt_desc_get函数得到输入格式的AVPixFmtDescriptor指针;
     * 3. 最后利用image_get_linesize函数设置linesizes数组中每个元素的值.
     * 
     * 可见该函数是用于填充dst_linesize数组.
     */
    ret = av_image_fill_linesizes(dst_linesize, pix_fmt, width);
    if (ret < 0)
        return ret;

    for (i = 0; i < 4; i++)
        /**
         * 由上面的第一节avpicture_fill的实现中可知align=1, 故该宏返回的值还是linesizes[i].
         */
        dst_linesize[i] = FFALIGN(dst_linesize[i], align);

    /**
     * 1. memset(data, 0, sizeof(data[0])*4);    将data数组内的指针置空
     * 2. data[i] = data[i-1] + size[i-1];        将data数组内的指针分别指向ptr内的数据
    */ 
    return av_image_fill_pointers(dst_data, pix_fmt, height, (uint8_t *)src, dst_linesize);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
5. 以前对avpicture_fill()的错误理解
uint8_t *out_buffer = (uint8_t *) av_malloc(numBytes * sizeof(uint8_t));
AVFrame *pFrameRGB = av_frame_alloc();

ret = avpicture_fill((AVPicture *) pFrameRGB, out_buffer, AV_PIX_FMT_RGB24,
                pCodecCtx->width, pCodecCtx->height);
1
2
3
4
5
错误理解:
  pFrameRGB和out_buffer都是已经申请到的一段内存, 会将pFrameRGB的数据按RGB24格式自动"关联(转换并放置)"到out_buffer。

正确理解:
  pFrameRGB和out_buffer都是已经申请到的一段内存, 但是pFrameRGB只是申请了一段结构体内存, 结构体里面的值是空的, 我们需要使用avpicture_fill()函数来使得pFrameRGB和out_buffer关联起来, pFrameRGB里面使用的是out_buffer所指向的内存空间.
from：https://blog.csdn.net/MACMACip/article/details/105463390