C++ FFmpeg如何把RGB图像序列编码为H.264裸流-C++-PHP中文网

ffmpeg_encode_video_frame要求AVFrame为YUV420P，因libx264仅支持该格式；RGB输入须经sws_scale转换，且宽高需为偶数；编码器需禁用GLOBAL_HEADER以输出Annex B裸流；avcodec_receive_packet需循环调用并flush。

c++ ffmpeg如何把rgb图像序列编码为h.264裸流

ffmpeg_encode_video_frame 函数里为什么传入的 `AVFrame` 必须是 YUV420P？

因为 libx264 编码器只接受 AV_PIX_FMT_YUV420P（或少数几个 YUV 变体），直接送 AV_PIX_FMT_RGB24 会触发 avcodec_send_frame() 返回 -22（EINVAL）。你不能跳过颜色空间转换——哪怕只是单帧，也得用 sws_scale() 把 RGB 转成 YUV420P。

常见错误现象：avcodec_receive_packet() 一直返回 0，但没输出任何数据包，其实是编码器根本没收到合法帧；或者直接崩溃在 sws_getContext() 初始化失败，因为源/目标格式、宽高没对齐（YUV420P 要求宽高均为偶数）。

确保输入 RGB 图像宽高都是偶数，否则 sws_scale() 可能静默截断或出错
调用 sws_getContext() 时，源格式设为 AV_PIX_FMT_RGB24，目标格式必须是 AV_PIX_FMT_YUV420P
重采样上下文只需创建一次，反复复用；不要每帧都重建

如何正确初始化 H.264 编码器并禁用容器封装？

裸流（annexb 格式）意味着不写 MP4/AVI 容器头，只输出原始 NAL 单元。这要求设置编码器参数：关闭 AV_CODEC_FLAG_GLOBAL_HEADER，并手动调用 av_bitstream_filter_init("h264_mp4toannexb")（仅当需要把 MP4 风格的 NAL 转成 Annex B 时才用；若直接用 x264 编码且未启用 global header，通常已输出 Annex B）。

关键配置项：

设置 codec_ctx->pix_fmt = AV_PIX_FMT_YUV420P
设置 codec_ctx->width / codec_ctx->height（必须与 sws 上下文一致）
设置 codec_ctx->time_base = {1, fps}，并同步设 codec_ctx->framerate = {fps, 1}
显式关闭全局头：codec_ctx->flags &= ~AV_CODEC_FLAG_GLOBAL_HEADER

漏掉 time_base 或设错会导致 PTS 计算混乱，后续帧无法解码；设了 GLOBAL_HEADER 则首帧会带 SPS/PPS 在 packet data 前，但裸流解析器可能不识别这种非标准前缀。

编码循环中怎么处理 `avcodec_receive_packet()` 的返回值？

它不是“一帧一包”严格对应。x264 内部有帧队列和延迟机制，尤其首帧调用时大概率返回 AVERROR(EAGAIN)（需更多输入），而 flush 阶段（传 nullptr）才会吐出剩余编码帧，包括可能的延迟 B 帧或尾部 filler。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

典型流程：

循环送入 RGB 帧 → 转 YUV → avcodec_send_frame()
每次送完后，用 while 循环反复调用 avcodec_receive_packet()，直到返回 EAGAIN 或 EOF
所有成功接收的 AVPacket 直接写入文件（裸流无头部，append 即可）
全部图像送完后，再传一次 nullptr 触发 flush，收走剩余 packet

容易忽略的是 flush 步骤：不 flush 就关文件，最后几帧就丢了；而 flush 后仍要检查返回值——它可能返回 0（有包）、AVERROR_EOF（结束）或 AVERROR(EAGAIN)（无更多输出）。

RGB 数据怎么填进 `AVFrame`？别用 `av_image_fill_arrays()` 硬拷贝

如果你的 RGB 图像是连续内存（如 uint8_t* rgb_data，宽×高×3 字节），最高效方式是直接赋值 frame->data[0] = rgb_data，并设置 frame->linesize[0] = width * 3。不要用 av_image_fill_arrays() 默认按 plane 对齐填充——它会尝试分配新 buffer 并 memcpy，纯属浪费。

注意点：

frame->format 必须设为 AV_PIX_FMT_RGB24（用于 sws 转换），哪怕你最终编码的是 YUV
frame->width/frame->height 必须与实际图像一致，且为偶数
如果 RGB 数据是 BGR 排列（OpenCV 默认），记得用 AV_PIX_FMT_BGR24 替换 AV_PIX_FMT_RGB24，否则颜色错乱

真正复杂的地方不在 API 调用顺序，而在于每个结构体字段的语义是否被准确理解——比如 AVRational time_base 是时间单位，不是帧率倒数；sws_context 的 src/dst 参数一旦建好就不能改；AVPacket 的 data 指针在 avcodec_receive_packet() 后才有效，且生命周期只到下次调用该函数前。