ffmpeg 的sws_scale接口函数解析

ffmpeg 的 sws_scale 函数是 libswscale 库中的一个重要函数，用于进行图像的缩放和颜色空间转换。它的主要作用是将输入图像帧转换为另一种尺寸或颜色格式的输出图像帧。下面详细解析一下 sws_scale 函数的作用、参数等。

sws_scale 函数的作用

ffmpeg 的 sws_scale 函数的主要作用包括：

1. 图像缩放（rescaling）：将图像从一种分辨率调整到另一种分辨率。
2. 颜色空间转换（color space conversion）：将图像从一种颜色格式转换为另一种颜色格式。
3. 图像格式转换（pixel format conversion）：支持多种图像格式之间的转换。

sws_scale 函数的原型

int sws_scale(struct SwsContext *context,
              const uint8_t *const srcSlice[], const int srcStride[],
              int srcSliceY, int srcSliceH,
              uint8_t *const dst[], const int dstStride[]);

参数解析

• struct SwsContext *context：缩放上下文（scaling context），包含了所有的缩放和转换参数。在使用 sws_scale 之前，必须通过 sws_getCachedContext获得上下文：

  SwsContext* context =*sws_getCachedContext(struct SwsContext *context,
                                          int srcW, int srcH, enum AVPixelFormat srcFormat,
                                          int dstW, int dstH, enum AVPixelFormat dstFormat,
                                          int flags, SwsFilter *srcFilter,
                                          SwsFilter *dstFilter, const double *param);
  

• const uint8_t *const srcSlice[]

  • 指向源图像每个平面的数据指针数组。不同的像素格式可能包含多个平面（例如，YUV420P 有三个平面：Y、U、V）。

• const int srcStride[]

  • 源图像每个平面的步幅（stride）数组。步幅指的是每行图像数据在内存中的字节数。

• int srcSliceY

  • 源图像要处理的第一个行的起始位置。通常从0开始。

• int srcSliceH

  • 源图像要处理的行数。

• uint8_t *const dst[]

  • 指向目标图像每个平面的数据指针数组。

• const int dstStride[]

  • 目标图像每个平面的步幅（stride）数组。

使用示例

下面是一个简单的使用 sws_scale 进行图像缩放和颜色空间转换的示例代码：

// 假设已经初始化了srcFrame和dstFrame，以及SwsContext *sws_ctx

// 源图像数据
const uint8_t *srcSlice[] = { srcFrame->data[0], srcFrame->data[1], srcFrame->data[2] };
const int srcStride[] = { srcFrame->linesize[0], srcFrame->linesize[1], srcFrame->linesize[2] };

// 目标图像数据
uint8_t *dst[] = { dstFrame->data[0], dstFrame->data[1], dstFrame->data[2] };
const int dstStride[] = { dstFrame->linesize[0], dstFrame->linesize[1], dstFrame->linesize[2] };

// 调用sws_scale进行图像缩放和颜色空间转换
sws_scale(sws_ctx, srcSlice, srcStride, 0, srcFrame->height, dst, dstStride);