sws_scale 到底在干嘛?—— FFmpeg libswscale 最细参数说明书
目录一、先给一句话定性二、sws_scale 函数原型三、参数逐个拆解① struct SwsContext *c是什么flags 常见值必须知道② const uint8_t *const srcSlice[]是什么合法值示例③ const int srcStride[]是什么为什么不等于 width * bpp④ int srcSliceY官方语义现实情况⑤ int srcSliceH是什么⑥ uint8_t *const dst[]是什么玩法 AAVFrame 接住玩法 B自己 malloc⑦ const int dstStride[]最常见翻车点正确示例RGB32YUV420P 输出四、使用示例五、90% 花屏 / 灰边 / 崩溃的真实原因六、colorspace / range 怎么塞进去七、一句话总结觉得有用就请您帮忙点赞转发收藏吧您的鼓励是我创作的动力多谢看官。由于能力水平有限文中的错误或不严谨的地方在所难免还请批评指正。sws_scale是 FFmpeg 多媒体框架中libswscale库的核心函数主要用于高效地执行‌图像像素格式转换‌、‌分辨率缩放‌以及‌图像滤波处理‌。它通常在视频解码后、渲染或编码前被调用将解码得到的原始帧数据如 YUV 格式转换为目标格式如 RGB 格式或调整尺寸。做播放器的人早晚都会遇到这一句sws_scale(sws_ctx, frame-data, frame-linesize, 0, frame-height, dst-data, dst-linesize);抄能用但一问为什么传 linesize为什么 srcSliceY 永远是 0dstStride 能不能乱填​今天就把它拆干净。一、先给一句话定性sws_scale 不是“画图函数”是像素搬运工负责 YUV↔RGB / resize / colorspace / range 全部打包干完。核心任务只有两件格式转换Pixel Format几何缩放Scale二、sws_scale 函数原型int sws_scale(struct SwsContext *c, const uint8_t *const srcSlice[], const int srcStride[], int srcSliceY, int srcSliceH, uint8_t *const dst[], const int dstStride[]);看着吓人其实分组很好记上下文 src 数据 / 步长 裁剪区域 dst 数据 / 步长三、参数逐个拆解①struct SwsContext *c是什么一次初始化终身干活直到分辨率/格式变由这个函数产出的struct SwsContext *sws_ctx sws_getContext( src_w, src_h, src_fmt, dst_w, dst_h, dst_fmt, SWS_BILINEAR, NULL, NULL, NULL );flags 常见值必须知道flag中文用在哪里SWS_FAST_BILINEAR快双线性播放器首选SWS_BILINEAR双线性质量稍好SWS_BICUBIC立方放大好看SWS_POINT最近邻截图 / 调试SWS_LANCZOS锐缩图强迫症SWS_AREA均值缩得很小实时播放器结论1080p↓SWS_FAST_BILINEAR放大预览BICUBIC②const uint8_t *const srcSlice[]是什么AVFrame-data 原样传srcSlice frame-data;合法值示例格式srcSlice 含义YUV420P{data[0], data[1], data[2]}NV12{data[0], data[1]}RGB24{data[0]}RGBA{data[0]}别传 AVFrame传它的 data*③const int srcStride[]是什么每一平面的“行跨度bytes per line”srcStride frame-linesize;为什么不等于 width * bppCPU 对齐32 / 64GPU / SIMD 友好例1280×720 yuv420plinesize[0] 1280 Y linesize[1] 640 U linesize[2] 640 V但 1278 宽可能变成linesize[0] 1280 ← paddingsws_scale 靠 stride 找下一行❌ 自己算 stride 花屏之源④int srcSliceY官方语义从第几行开始处理切片现实情况srcSliceY 0; // 99% 情况什么时候不是 0多线程切条处理 slice古老优化超大图分段 scale现在没人这么干 记住播放器永远传 0⑤int srcSliceH是什么要处理的行数正确写法srcSliceH frame-height;别写 dst_h / coded_height⑥uint8_t *const dst[]是什么输出缓冲区两种玩法玩法 AAVFrame 接住av_frame_get_buffer(dst_frame, 32); dst dst_frame-data;玩法 B自己 mallocuint8_t* rgb new uint8_t[w*h*4]; uint8_t* out[1] { rgb };注意对齐推荐av_malloc()⑦const int dstStride[]最常见翻车点正确示例RGB32int dst_stride dst_w * 4; uint8_t* out[1] { buf }; int stride[1] { dst_stride };YUV420P 输出int dst_linesize[3] { dst_w, dst_w / 2, dst_w / 2 };sws_scale 不帮你 alloc也不帮你猜 stride四、使用示例SwsContext* sws sws_getContext( dec_frame-width, dec_frame-height, (AVPixelFormat)dec_frame-format, dst_w, dst_h, AV_PIX_FMT_RGB24, SWS_FAST_BILINEAR, nullptr, nullptr, nullptr ); uint8_t* rgb (uint8_t*)av_malloc(dst_w * dst_h * 3); uint8_t* out[] { rgb }; int dst_stride[] { dst_w * 3 }; sws_scale(sws, dec_frame-data, dec_frame-linesize, 0, dec_frame-height, out, dst_stride);五、90% 花屏 / 灰边 / 崩溃的真实原因症状真凶右边彩色条纹dstStride ≠ width*bpp上下错位srcSliceH 传错颜色发绿pixfmt 传 AV_PIX_FMT_YUV420 → YUVJ420P缩放糊flag 用 POINT内存越界dst buffer 没算 padding六、colorspace / range 怎么塞进去sws_scale只看像素布局不认 color_range / primaries。高级玩家这样玩sws_setColorspaceDetails( sws, sws_getCoefficients(AVCOL_SPC_BT709), 1, // src_range (0full) sws_getCoefficients(AVCOL_SPC_BT709), 1, // dst_range 0, 116, 116 );不然 YUV→RGB 永远“差点味”七、一句话总结sws_scale src/data/linesize dst/data/linesize 裁剪从 0 到 height永远用 AVFrame 的 linesize别自己算flags 别瞎选。

相关新闻

校园二手交易与租赁系统开发实战

校园二手交易与租赁系统开发实战

1. 项目概述校园物品租赁与二手交易系统是当前高校场景下的刚需应用。作为一名在校园信息化领域深耕多年的开发者,我发现学生们经常面临这样的困境:想租个相机记录毕业季却找不到渠道,闲置的教材和电子产品只能低价贱卖,自行车等大…

2026/11/22 0:35:12 阅读更多 →
LearnOpenGL之Shader编程——生成设计

LearnOpenGL之Shader编程——生成设计

———————————————————— 前序 ——————————————————— AndroidLearnOpenGL是本博主自己实现的LearnOpenGL练习集合: Github地址:GitHub - wangyongyao1989/AndroidLearnOpenGL: OpenGL基础及运用 系列文章&#xff…

2026/11/22 0:35:12 阅读更多 →
校园物品租赁与二手交易系统开发实践

校园物品租赁与二手交易系统开发实践

1. 项目背景与核心价值校园物品租赁与二手交易系统是当前高校场景下的刚需应用。每到学期初和毕业季,教材、自行车、体育器材等物品的流转需求就会集中爆发。传统线下交易方式存在信息不对称、交易效率低、信任成本高等痛点。我们团队开发的这款微信小程序&#xff…

2026/11/7 15:57:16 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻