windows全屏截图最轻量方式是用getdc(null)获取屏幕dc,再通过bitblt拷贝至createdibsection创建的32bpp bgra位图,需字节重排为rgba后调用stbi_write_png保存为png,并严格配对释放gdi资源。

Windows平台用GDI获取全屏图像数据
全屏截图在Windows上最轻量的方式是调用GetDC(NULL)获取整个屏幕的设备上下文,再用BitBlt把像素拷贝到兼容DC的位图中。关键点在于:必须用GetSystemMetrics(SM_CXSCREEN)和GetSystemMetrics(SM_CYSCREEN)获取真实分辨率,不能硬编码;目标位图需用CreateDIBSection创建,否则无法直接访问像素内存或保存为PNG。
常见错误是直接用GetBitmapBits读取HBITMAP——它返回的是设备相关位图(DDB),格式不固定,RGB顺序、对齐、压缩方式都不可控,后续转PNG会失败或颜色错乱。
- 务必使用
BITMAPINFO结构指定BI_RGB和32bpp(即biBitCount = 32),保证每像素4字节、含Alpha通道,方便后续处理 - 源DC和目标DC尺寸必须严格一致,否则
BitBlt可能只拷贝部分区域 - 记得用
SelectObject把位图选入目标DC,并保存原始位图句柄用于恢复
用stb_image_write保存为PNG
stb_image_write.h是单头文件库,无需编译,只需定义STB_IMAGE_WRITE_IMPLEMENTATION一次后包含即可。它接受RGBA或RGB内存块,但注意:GDI获取的DIB数据默认是BGR顺序,且Windows下高位字节是Alpha(即BGRA),而stb_image_write的stbi_write_png函数期望RGB或RGBA顺序。所以必须做字节重排。
典型错误是传入未转换的原始DIB内存,导致保存出的PNG全是紫红色或色偏严重。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 若用
stbi_write_png,传入4通道时需确保是RGBA顺序,可逐像素交换rgb三字节:swap(p[i+0], p[i+2]) - 若不想改数据,可用
stbi_write_png_compressed配合自定义写回调,但更简单的是直接用stbi_write_png并做原地翻转 - 注意
stbi_write_png第四个参数stride_in_bytes应为width * 4,不是width * 3
完整流程中的资源释放与错误检查
Windows GDI对象不自动释放,漏掉DeleteObject或ReleaseDC会导致句柄泄漏,多次截图后程序可能卡死或报ERROR_INVALID_HANDLE。同时,stbi_write_png失败时只返回0,无详细错误信息,需靠返回值判断。
- 所有
HDC必须配对ReleaseDC,即使获取失败也要判空 -
HBITMAP创建成功后,必须用DeleteObject释放,不能只靠作用域结束 - 调用
stbi_write_png前确认输出路径可写,文件名含中文时需用std::filesystem::u8path或转为UTF-8宽字符 - 截图区域若跨多显示器(如扩展模式),
GetSystemMetrics(SM_CXSCREEN)只返回主屏宽度,此时应改用GetSystemMetrics(SM_XVIRTUALSCREEN)等系列API
Linux/macOS下不能直接套用这套逻辑
这段代码完全依赖Windows GDI API,在Linux上GetDC、BitBlt根本不存在;macOS也没有对应接口。如果需要跨平台,得换方案:Linux可用XShmGetImage(X11)或gbm+DRM(Wayland),macOS得走CGDisplayCreateImage。别试图用条件编译硬塞GDI代码进去——链接阶段就会报undefined reference。
哪怕只是临时Windows工具,也建议把GDI操作封装成独立函数,避免和PNG保存逻辑混在一起。这样以后替换成其他截图后端时,只要重写这个函数就行。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










