)
简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮点击获取二维码文章目录1.前言2.应用场景和用法2.1为什么要调整解码缓冲区尺寸2.2函数原型与返回语义3.调用流程剖析3.1根据像素格式和Codec要求计算尺寸3.2对齐尺寸进入解码缓冲区分配4.实战案例4.1准备支持DR1的视频解码器4.2调用接口检查尺寸变化4.3完整代码5.总结1.前言本篇目的理解avcodec_align_dimensions()如何根据解码器和像素格式调整图像缓冲区宽高并通过最小程序观察对齐前后的尺寸变化。解码器输出图像的显示宽高不一定适合直接作为底层图像缓冲区的分配尺寸。像素格式的色度采样方式、编解码器的边界访问要求和行跨度对齐都可能要求缓冲区比图像可见区域更大。avcodec_align_dimensions()根据已打开的Codec上下文调整传入的宽高。它只计算对齐尺寸不分配图像内存也不修改图像的显示尺寸。已打开的Codec上下文avcodec_align_dimensions原始图像宽高计算对齐后的缓冲区尺寸供解码缓冲区规划使用2.应用场景和用法2.1为什么要调整解码缓冲区尺寸调用者在自定义解码缓冲区分配逻辑时需要为解码器可能访问的边界区域和像素平面预留空间。只按可见图像宽高分配可能导致边缘读取越界或行跨度不符合解码器要求。场景使用接口的目的注意事项自定义解码缓冲区计算解码器可接受的宽高必须先打开支持AV_CODEC_CAP_DR1的Codec视频帧内存池预先规划单帧分配尺寸分配尺寸不能替代显示尺寸多平面像素格式考虑色度子采样对齐不同像素格式可能得到不同结果自定义get_buffer2规划平面宽高及行跨度通常应考虑avcodec_align_dimensions2()返回的逐平面对齐要求2.2函数原型与返回语义函数原型如下voidavcodec_align_dimensions(AVCodecContext*s,int*width,int*height);参数含义s已打开的解码器AVCodecContextCodec需要支持AV_CODEC_CAP_DR1width输入时为待分配图像宽度返回时为对齐后的宽度height输入时为待分配图像高度返回时为对齐后的高度函数没有返回值直接修改*width和*height。调用者应保留原始宽高用于区分可见尺寸和缓冲区尺寸。最小调用方式如下intaligned_widthvisible_width;intaligned_heightvisible_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的倍数。输入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完整代码#includelibavcodec/avcodec.h#includelibavutil/pixfmt.h#includestdio.hintmain(void){constAVCodec*codec;AVCodecContext*codec_contextNULL;intvisible_width641;intvisible_height359;intaligned_width;intaligned_height;intret1;/* 查找支持DR1的MPEG-2视频解码器 */codecavcodec_find_decoder(AV_CODEC_ID_MPEG2VIDEO);if(codecNULL){fprintf(stderr,Decoder not found\n);gotodone;}if(!(codec-capabilitiesAV_CODEC_CAP_DR1)){fprintf(stderr,Decoder does not support DR1\n);gotodone;}codec_contextavcodec_alloc_context3(codec);if(codec_contextNULL){fprintf(stderr,Could not allocate codec context\n);gotodone;}/* 设置示例图像尺寸后打开解码器 */codec_context-widthvisible_width;codec_context-heightvisible_height;if(avcodec_open2(codec_context,codec,NULL)0){fprintf(stderr,Could not open decoder\n);gotodone;}/* 示例固定使用YUV420P实际应用应使用解码输出的像素格式 */codec_context-pix_fmtAV_PIX_FMT_YUV420P;aligned_widthvisible_width;aligned_heightvisible_height;/* 接口原地调整宽高不创建图像缓冲区 */avcodec_align_dimensions(codec_context,aligned_width,aligned_height);if(aligned_widthvisible_width||aligned_heightvisible_height){fprintf(stderr,Aligned dimensions are smaller than visible size\n);gotodone;}printf(Visible size: %dx%d\n,visible_width,visible_height);printf(Aligned size: %dx%d\n,aligned_width,aligned_height);ret0;done:avcodec_free_context(codec_context);returnret;}5.总结avcodec_align_dimensions()就是依据已打开Codec和像素格式调整解码缓冲区宽高不负责分配内存或改变图像显示尺寸。