8位单通道数据保存为JPG

dd向上2025-05-31 23:23

如何将单通道8位灰度数据（0黑~255白）直接保存为JPG文件？

这里提供两种最实用方案：轻量级STB库（推荐）和OpenCV方案（已有环境适用）

STB方案 - 推荐

cpp 复制代码

//https://github.com/nothings/stb/blob/master/stb_image_write.h
#define STB_IMAGE_WRITE_IMPLEMENTATION  // 必须定义一次，在.cpp中定义
#include "stb_image_write.h"            // 单文件库

// 原始数据：NewBuffer（单通道灰度数据）
// 保存为JPG（一行代码搞定），注意图片路径是 const char* 类型
stbi_write_jpg("output.jpg", width, height, 1, NewBuffer, 90);

width/height：图像尺寸
1：单通道标识
90：JPG质量（1-100，推荐90）
优势：无需安装库，下载stb_image_write.h扔进项目就能用

虽然你指定了单通道输入，但 stbi_write_jpg 总是输出24位JPEG文件，视觉上显示为完美灰度，与真灰度无差异，文件大小比真灰度格式大

OpenCV方案（已有环境）

cpp 复制代码

#include <opencv2/opencv.hpp>

//CV_8UC1 指定为8位无符号整型单通道（灰度图）
cv::Mat img(height, width, CV_8UC1, NewBuffer);        
//基础保存
cv::imwrite(pStr, img);

// 高级保存，自定义质量参数
std::vector<int> params{ cv::IMWRITE_JPEG_QUALITY, 90 };        
cv::imwrite(pStr, img, params);

注意事项

数据格式 ：NewBuffer必须是单通道8位灰度数据（0 黑~255 白）
内存布局 ：连续排列的width×height字节数组
通道陷阱

cpp 复制代码

// 错误！JPG需要RGB三通道
stbi_write_jpg(..., 3, pNewBuffer, ...);

// 正确做法：单通道参数设为1
stbi_write_jpg(..., 1, pNewBuffer, ...);

总结

场景	推荐方案
轻量级/无依赖项目	STB
已有OpenCV	cv::imwrite
Windows原生程序	GDI+
需要高级压缩控制	libjpeg-turbo

大部分情况用STB就够了，除非项目里已经有OpenCV

彩色图保存？先把单通道转RGB三通道再操作！