Linux FFmpeg深度解析之avcodec_align_dimensions调用流程与实战(二十九)

Android系统攻城狮2026-11-06 23:19

简介： CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀

Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中...... 】🚀

Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中...... 】🚀

专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀

专题三：Android14 Binder之HIDL与AIDL通信实战课 🚀

专题四：Android15快速自定义与集成音效实战课 🚀

专题五：Android15音频策略实战课 🚀

专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例) 🚀

人生格言： 人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.
更多原创,欢迎关注：Android系统攻城狮

点击获取二维码

🍉🍉🍉文章目录🍉🍉🍉

🌻1.前言

本篇目的：理解avcodec_align_dimensions()如何根据解码器和像素格式调整图像缓冲区宽高，并通过最小程序观察对齐前后的尺寸变化。

解码器输出图像的显示宽高，不一定适合直接作为底层图像缓冲区的分配尺寸。像素格式的色度采样方式、编解码器的边界访问要求和行跨度对齐，都可能要求缓冲区比图像可见区域更大。

avcodec_align_dimensions()根据已打开的Codec上下文调整传入的宽高。它只计算对齐尺寸，不分配图像内存，也不修改图像的显示尺寸。
#mermaid-svg-vzAPsBgBiQFtk7nz{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-vzAPsBgBiQFtk7nz .error-icon{fill:#552222;}#mermaid-svg-vzAPsBgBiQFtk7nz .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-vzAPsBgBiQFtk7nz .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-vzAPsBgBiQFtk7nz .marker{fill:#333333;stroke:#333333;}#mermaid-svg-vzAPsBgBiQFtk7nz .marker.cross{stroke:#333333;}#mermaid-svg-vzAPsBgBiQFtk7nz svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-vzAPsBgBiQFtk7nz p{margin:0;}#mermaid-svg-vzAPsBgBiQFtk7nz .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster-label text{fill:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster-label span{color:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster-label span p{background-color:transparent;}#mermaid-svg-vzAPsBgBiQFtk7nz .label text,#mermaid-svg-vzAPsBgBiQFtk7nz span{fill:#333;color:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz .node rect,#mermaid-svg-vzAPsBgBiQFtk7nz .node circle,#mermaid-svg-vzAPsBgBiQFtk7nz .node ellipse,#mermaid-svg-vzAPsBgBiQFtk7nz .node polygon,#mermaid-svg-vzAPsBgBiQFtk7nz .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-vzAPsBgBiQFtk7nz .rough-node .label text,#mermaid-svg-vzAPsBgBiQFtk7nz .node .label text,#mermaid-svg-vzAPsBgBiQFtk7nz .image-shape .label,#mermaid-svg-vzAPsBgBiQFtk7nz .icon-shape .label{text-anchor:middle;}#mermaid-svg-vzAPsBgBiQFtk7nz .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-vzAPsBgBiQFtk7nz .rough-node .label,#mermaid-svg-vzAPsBgBiQFtk7nz .node .label,#mermaid-svg-vzAPsBgBiQFtk7nz .image-shape .label,#mermaid-svg-vzAPsBgBiQFtk7nz .icon-shape .label{text-align:center;}#mermaid-svg-vzAPsBgBiQFtk7nz .node.clickable{cursor:pointer;}#mermaid-svg-vzAPsBgBiQFtk7nz .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-vzAPsBgBiQFtk7nz .arrowheadPath{fill:#333333;}#mermaid-svg-vzAPsBgBiQFtk7nz .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-vzAPsBgBiQFtk7nz .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-vzAPsBgBiQFtk7nz .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vzAPsBgBiQFtk7nz .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-vzAPsBgBiQFtk7nz .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vzAPsBgBiQFtk7nz .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster text{fill:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz .cluster span{color:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-vzAPsBgBiQFtk7nz .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-vzAPsBgBiQFtk7nz rect.text{fill:none;stroke-width:0;}#mermaid-svg-vzAPsBgBiQFtk7nz .icon-shape,#mermaid-svg-vzAPsBgBiQFtk7nz .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vzAPsBgBiQFtk7nz .icon-shape p,#mermaid-svg-vzAPsBgBiQFtk7nz .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-vzAPsBgBiQFtk7nz .icon-shape .label rect,#mermaid-svg-vzAPsBgBiQFtk7nz .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vzAPsBgBiQFtk7nz .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-vzAPsBgBiQFtk7nz .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-vzAPsBgBiQFtk7nz :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 已打开的Codec上下文
avcodec_align_dimensions
原始图像宽高
计算对齐后的缓冲区尺寸
供解码缓冲区规划使用

🌻2.应用场景和用法

2.1为什么要调整解码缓冲区尺寸

调用者在自定义解码缓冲区分配逻辑时，需要为解码器可能访问的边界区域和像素平面预留空间。只按可见图像宽高分配，可能导致边缘读取越界或行跨度不符合解码器要求。

场景 使用接口的目的 注意事项
自定义解码缓冲区 计算解码器可接受的宽高 必须先打开支持AV_CODEC_CAP_DR1的Codec
视频帧内存池 预先规划单帧分配尺寸 分配尺寸不能替代显示尺寸
多平面像素格式 考虑色度子采样对齐 不同像素格式可能得到不同结果
自定义get_buffer2 规划平面宽高及行跨度 通常应考虑avcodec_align_dimensions2()返回的逐平面对齐要求
2.2函数原型与返回语义

函数原型如下：

c 复制代码 
void
avcodec_align_dimensions (AVCodecContext *s,
                         int *width,
                         int *height);
参数 含义
s 已打开的解码器AVCodecContext，Codec需要支持AV_CODEC_CAP_DR1
width 输入时为待分配图像宽度，返回时为对齐后的宽度
height 输入时为待分配图像高度，返回时为对齐后的高度

函数没有返回值，直接修改*width和*height。调用者应保留原始宽高，用于区分可见尺寸和缓冲区尺寸。

最小调用方式如下：

c 复制代码 
int aligned_width = visible_width;
int aligned_height = visible_height;

avcodec_align_dimensions (
    codec_context,
    &aligned_width,
    &aligned_height);

avcodec_align_dimensions2()与它相关，但提供了linesize_align[]，供调用者规划各图像平面的行跨度。使用自定义get_buffer2时，不能只对比宽高；还要按照每个平面的行跨度对齐要求分配和设置AVFrame.linesize[]。

🌻3.调用流程剖析

3.1根据像素格式和Codec要求计算尺寸

avcodec_align_dimensions()先调用avcodec_align_dimensions2()，让后者根据像素格式和Codec特性调整宽高，并返回各平面的行跨度对齐值。

随后，外层函数结合亮度平面和色度平面的行跨度对齐要求，计算统一的宽度对齐单位，并用FFALIGN()向上取整宽度。高度对齐则由avcodec_align_dimensions2()完成。

以FFmpeg6.1源码中的YUV420P为例，avcodec_align_dimensions2()会考虑色度子采样和宏块高度要求；外层函数再结合行跨度对齐调整宽度。因此结果不是简单地把宽高都向上取整到16的倍数。
#mermaid-svg-9SedaMXvC7SfggWz{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-9SedaMXvC7SfggWz .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-9SedaMXvC7SfggWz .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-9SedaMXvC7SfggWz .error-icon{fill:#552222;}#mermaid-svg-9SedaMXvC7SfggWz .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-9SedaMXvC7SfggWz .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-9SedaMXvC7SfggWz .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-9SedaMXvC7SfggWz .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-9SedaMXvC7SfggWz .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-9SedaMXvC7SfggWz .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-9SedaMXvC7SfggWz .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-9SedaMXvC7SfggWz .marker{fill:#333333;stroke:#333333;}#mermaid-svg-9SedaMXvC7SfggWz .marker.cross{stroke:#333333;}#mermaid-svg-9SedaMXvC7SfggWz svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-9SedaMXvC7SfggWz p{margin:0;}#mermaid-svg-9SedaMXvC7SfggWz .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-9SedaMXvC7SfggWz .cluster-label text{fill:#333;}#mermaid-svg-9SedaMXvC7SfggWz .cluster-label span{color:#333;}#mermaid-svg-9SedaMXvC7SfggWz .cluster-label span p{background-color:transparent;}#mermaid-svg-9SedaMXvC7SfggWz .label text,#mermaid-svg-9SedaMXvC7SfggWz span{fill:#333;color:#333;}#mermaid-svg-9SedaMXvC7SfggWz .node rect,#mermaid-svg-9SedaMXvC7SfggWz .node circle,#mermaid-svg-9SedaMXvC7SfggWz .node ellipse,#mermaid-svg-9SedaMXvC7SfggWz .node polygon,#mermaid-svg-9SedaMXvC7SfggWz .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-9SedaMXvC7SfggWz .rough-node .label text,#mermaid-svg-9SedaMXvC7SfggWz .node .label text,#mermaid-svg-9SedaMXvC7SfggWz .image-shape .label,#mermaid-svg-9SedaMXvC7SfggWz .icon-shape .label{text-anchor:middle;}#mermaid-svg-9SedaMXvC7SfggWz .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-9SedaMXvC7SfggWz .rough-node .label,#mermaid-svg-9SedaMXvC7SfggWz .node .label,#mermaid-svg-9SedaMXvC7SfggWz .image-shape .label,#mermaid-svg-9SedaMXvC7SfggWz .icon-shape .label{text-align:center;}#mermaid-svg-9SedaMXvC7SfggWz .node.clickable{cursor:pointer;}#mermaid-svg-9SedaMXvC7SfggWz .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-9SedaMXvC7SfggWz .arrowheadPath{fill:#333333;}#mermaid-svg-9SedaMXvC7SfggWz .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-9SedaMXvC7SfggWz .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-9SedaMXvC7SfggWz .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-9SedaMXvC7SfggWz .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-9SedaMXvC7SfggWz .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-9SedaMXvC7SfggWz .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-9SedaMXvC7SfggWz .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-9SedaMXvC7SfggWz .cluster text{fill:#333;}#mermaid-svg-9SedaMXvC7SfggWz .cluster span{color:#333;}#mermaid-svg-9SedaMXvC7SfggWz div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-9SedaMXvC7SfggWz .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-9SedaMXvC7SfggWz rect.text{fill:none;stroke-width:0;}#mermaid-svg-9SedaMXvC7SfggWz .icon-shape,#mermaid-svg-9SedaMXvC7SfggWz .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-9SedaMXvC7SfggWz .icon-shape p,#mermaid-svg-9SedaMXvC7SfggWz .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-9SedaMXvC7SfggWz .icon-shape .label rect,#mermaid-svg-9SedaMXvC7SfggWz .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-9SedaMXvC7SfggWz .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-9SedaMXvC7SfggWz .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-9SedaMXvC7SfggWz :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 输入Codec上下文与宽高
检查像素格式和Codec特性
avcodec_align_dimensions2计算基础对齐
外层计算统一行跨度对齐
写回对齐后的宽高

3.2对齐尺寸进入解码缓冲区分配

这个接口只提供尺寸计算结果。它不创建AVFrame，不调用av_frame_get_buffer()，也不负责填充图像数据。

默认解码缓冲区路径会使用avcodec_align_dimensions2()获取宽高和逐平面行跨度要求。自定义缓冲区实现也应依照对应接口的约束分配每个平面，并正确填写data[]和linesize[]。

因此，avcodec_align_dimensions()适合只需要对齐宽高的调用场景；需要控制每个平面的行跨度时，应使用avcodec_align_dimensions2()。

🌻4.实战案例

4.1准备支持DR1的视频解码器

案例创建并打开MPEG-2视频解码器，设置待处理图像尺寸为641×359，并为示例指定YUV420P像素格式。真实项目应使用解码器实际协商得到的像素格式。

4.2调用接口检查尺寸变化

保留输入宽高副本，再将另一组变量传给avcodec_align_dimensions()。检查返回后的尺寸没有小于输入尺寸，并打印两组尺寸。

输出数值受Codec、像素格式和FFmpeg版本影响，不能把单一尺寸结果写死为所有解码器的规则。

4.3完整代码
c 复制代码 
#include <libavcodec/avcodec.h>
#include <libavutil/pixfmt.h>
#include <stdio.h>

int
main (void)
{
  const AVCodec *codec;
  AVCodecContext *codec_context = NULL;
  int visible_width = 641;
  int visible_height = 359;
  int aligned_width;
  int aligned_height;
  int ret = 1;

  /* 查找支持DR1的MPEG-2视频解码器 */
  codec = avcodec_find_decoder (AV_CODEC_ID_MPEG2VIDEO);
  if (codec == NULL) {
    fprintf (stderr, "Decoder not found\n");
    goto done;
  }

  if (!(codec->capabilities & AV_CODEC_CAP_DR1)) {
    fprintf (stderr, "Decoder does not support DR1\n");
    goto done;
  }

  codec_context = avcodec_alloc_context3 (codec);
  if (codec_context == NULL) {
    fprintf (stderr, "Could not allocate codec context\n");
    goto done;
  }

  /* 设置示例图像尺寸后打开解码器 */
  codec_context->width = visible_width;
  codec_context->height = visible_height;

  if (avcodec_open2 (codec_context, codec, NULL) < 0) {
    fprintf (stderr, "Could not open decoder\n");
    goto done;
  }

  /* 示例固定使用YUV420P；实际应用应使用解码输出的像素格式 */
  codec_context->pix_fmt = AV_PIX_FMT_YUV420P;

  aligned_width = visible_width;
  aligned_height = visible_height;

  /* 接口原地调整宽高，不创建图像缓冲区 */
  avcodec_align_dimensions (
      codec_context,
      &aligned_width,
      &aligned_height);

  if (aligned_width < visible_width ||
      aligned_height < visible_height) {
    fprintf (stderr, "Aligned dimensions are smaller than visible size\n");
    goto done;
  }

  printf ("Visible size: %dx%d\n",
      visible_width,
      visible_height);
  printf ("Aligned size: %dx%d\n",
      aligned_width,
      aligned_height);

  ret = 0;

done:
  avcodec_free_context (&codec_context);
  return ret;
}

🌻5.总结

avcodec_align_dimensions()就是依据已打开Codec和像素格式调整解码缓冲区宽高，不负责分配内存或改变图像显示尺寸。

相关推荐
叼烟扛炮1 小时前
Linux 学习笔记（五十六）：IO 多路复用初探——select 的“三宗罪”
linux·服务器·数据库·笔记·学习·php
Ruiery1 小时前
Linux 6.6内核内存管理深度解析（十五）：CMA 连续内存分配器
linux·运维·服务器
测试界的小码农2 小时前
【Linux 命令实战（01）：认识 Linux 终端，从零掌握第一个命令】
linux·运维·服务器
zhikouai3 小时前
把外部助手接进聊天软件的架构分层与参数配置
服务器·网络·php
荣合技术服务4 小时前
HPC 超算集群故障维修实录：找荣合科算维护后，模拟仿真计算又能跑了
运维·服务器·超算服务器·荣合科算
叼烟扛炮7 小时前
Linux 学习笔记（五十八）：IO 多路复用封神——epoll 底层原理揭秘
linux·运维·服务器·网络·笔记·学习·php
星恒随风8 小时前
Linux网络编程：彻底理解IO多路复用select！从fd_set位图、读写就绪到手写TCP多客户端字典服务器
linux·服务器·网络
Oiiouui10 小时前
linux服务器部署Logto后端与对应前端的实现
linux·服务器·前端·后端
ITKEY_11 小时前
用 Emacs Dired 实现 em：退出文件管理器后，让终端自动切换目录
linux·服务器·emacs
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02如何新建文件夹？ 电脑新建文件夹的4种方法03历年考研数学一、数学二、数学三真题试卷及答案PDF04几个好用的ip纯净度检测网站05GitHub 镜像站点06昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战07苹果iPA游戏软件资源下载网站08蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接09微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新10Dify：一站式AI应用开发平台全解析与Windows部署指南