SDL2已彻底移除硬件overlay支持，YUV渲染统一通过SDL_Texture（如IYUV/NV12格式）+ SDL_RenderCopy实现，是否GPU加速取决于后端驱动，无法保证overlay模式。
SDL2硬件加速渲染YUV的现实限制
SDL2从2.0.16开始彻底移除了SDL_Overlay和所有基于SDL_YV12_OVERLAY等旧式overlay的API，官方明确声明“不再支持硬件overlay”。你现在看到的任何文档或示例里还在用SDL_CreateYUVOverlay、SDL_LockYUVOverlay，基本都失效于现代SDL2（尤其macOS/Linux Wayland/Windows最新驱动）。所谓“硬件加速YUV overlay”在SDL2里已不存在——它被统一收编进纹理+GPU渲染管线，底层靠SDL_Texture + SDL_PIXELFORMAT_IYUV或SDL_PIXELFORMAT_NV12配合SDL_RenderCopy实现，实际是否走GPU加速取决于驱动和后端（Direct3D/Vulkan/Metal/OpenGL），但**你无法控制或保证是“overlay”模式**。
用SDL_Texture替代Overlay渲染YUV的最小可行路径
核心思路：把YUV数据上传为GPU纹理，用SDL_RenderCopy绘制。这要求输入YUV格式必须是SDL2原生支持的，且需按平面布局正确填充数据。
-
SDL_PIXELFORMAT_IYUV（即I420）：Y、U、V三个平面，U/V各为Y的1/4面积，顺序为Y-U-V -
SDL_PIXELFORMAT_NV12：Y平面 + 一个交错的UV平面（UV interleaved），更常见于摄像头/编码器输出 - 创建纹理时必须指定
SDL_TEXTUREACCESS_STREAMING，否则SDL_UpdateTexture会失败 - 调用
SDL_UpdateTexture前，确保YUV数据内存布局与格式严格匹配；例如SDL_PIXELFORMAT_NV12的UV平面起始地址应为y_data + y_pitch * height，且UV行宽必须是偶数（对齐要求）
示例关键片段：
SDL_Texture* tex = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_NV12,
SDL_TEXTUREACCESS_STREAMING,
width, height);
Uint8* pixels;
int pitch;
SDL_LockTexture(tex, NULL, (void**)&pixels, &pitch);
// 假设y_data、uv_data已就绪，且uv_data是packed UV（NV12）
memcpy(pixels, y_data, pitch * height); // Y plane
memcpy(pixels + pitch * height, uv_data, pitch * height / 2); // UV plane
SDL_UnlockTexture(tex);
SDL_RenderCopy(renderer, tex, NULL, &dst_rect);
常见YUV数据源适配要点（FFmpeg / V4L2 / MediaCodec）
真实场景中YUV数据往往来自解码器或采集设备，格式和对齐极易出错：
- FFmpeg解码AVFrame →
AV_PIX_FMT_YUV420P对应SDL_PIXELFORMAT_IYUV，但注意FFmpeg的linesize[0]可能大于width（内存对齐），复制时必须用linesize[i]而非width - V4L2常输出
V4L2_PIX_FMT_NV12，可直连SDL_PIXELFORMAT_NV12，但需检查bytesperline是否满足GPU对齐（如32字节边界），不足则需memcopy并补零 - Android MediaCodec输出
MediaCodec.BUFFER_FLAG_CODEC_CONFIG后首帧常为ByteBuffer含NV12，需用GetDirectBufferAddress取指针，避免Java层拷贝 - 若输入是
AV_PIX_FMT_YUVJ420P（JPEG色彩空间），SDL2不自动做YUV→RGB转换，需手动调整Y/U/V系数或预转为标准IYUV
性能瓶颈和绕不过去的坑
很多人卡在“明明用了NV12，却比RGB还慢”，问题通常不在SDL2本身：
- 频繁
SDL_LockTexture+memcpy触发CPU→GPU同步，尤其在高帧率下。解决：用SDL_UpdateTexture替代Lock/Unlock（它内部做优化拷贝） - 纹理尺寸非2的幂（NPOT）在老旧OpenGL后端可能降级为CPU软缩放，强制设
SDL_SetHint(SDL_HINT_RENDER_SCALE_QUALITY, "0")关闭滤波 - Windows上Direct3D11后端对NV12支持较好，但若显卡驱动未启用DXVA2或D3D11 Video Processor，仍会fallback到CPU转换——此时
SDL_GetRendererInfo返回的name字段会含"direct3d"但num_texture_formats里没有SDL_PIXELFORMAT_NV12 - macOS Metal后端不支持任何YUV格式，
SDL_CreateTexture会静默失败（返回NULL），必须提前检查并fallback到I420+CPU转换
真正难的从来不是贴几行代码，而是确认你的目标平台、驱动版本、SDL2编译选项（是否启用了Vulkan/Metal/D3D11）、以及YUV数据的实际内存布局——四者缺一不可对齐。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
