Linux下截图转JPEG并Base64编码异常及TooJpeg使用求助

一、libJPEG生成Base64异常修正 #

常见问题根源及修复 #

• 核心原因：Base64编码时未读取完整的JPEG二进制流，或编码过程中引入了额外换行/空格，导致解码工具无法识别。
• 修正代码示例：
  确保读取完整JPEG数据后再执行Base64编码：

  #include <fstream>
  #include <vector>
  #include <string>
  #include "base64.h" // 使用成熟的Base64实现，比如单头文件开源库
  
  // 读取JPEG文件到二进制缓冲区
  std::vector<uint8_t> read_jpeg_file(const std::string& path) {
      std::ifstream file(path, std::ios::binary | std::ios::ate);
      if (!file) throw std::runtime_error("无法打开JPEG文件");
      
      std::streamsize size = file.tellg();
      file.seekg(0, std::ios::beg);
      std::vector<uint8_t> buffer(size);
      if (!file.read(reinterpret_cast<char*>(buffer.data()), size)) {
          throw std::runtime_error("读取JPEG文件失败");
      }
      return buffer;
  }
  
  // 二进制数据转Base64字符串
  std::string jpeg_to_base64(const std::vector<uint8_t>& jpeg_data) {
      return base64_encode(jpeg_data.data(), jpeg_data.size());
  }
  

• 关键注意点：
  • 禁止在Base64字符串中插入换行符（除非业务明确要求分块），多数在线解码工具要求连续无中断的字符串。
  • 确认Base64库的字符映射正确，避免混淆标准Base64（+//）和URL安全Base64（-/_）的格式。

二、TooJpeg正确使用指南 #

问题排查 #

你遇到的图片无法打开、显示灰色条纹问题，大多是因为像素格式不匹配（TooJpeg默认要求RGB24格式），或输出流未正确接收压缩数据。

正确用法示例 #

#include <vector>
#include <fstream>
#include "TooJpeg.h"

// 获取截图的RGB24格式像素数据（替换为你的实际截图逻辑）
std::vector<uint8_t> get_screenshot_rgb24(int width, int height) {
    std::vector<uint8_t> pixels(width * height * 3);
    // 按行优先填充RGB数据，每个像素顺序为R、G、B
    for (int y = 0; y < height; ++y) {
        for (int x = 0; x < width; ++x) {
            int idx = (y * width + x) * 3;
            pixels[idx] = (x * 255) / width;     // R通道
            pixels[idx + 1] = (y * 255) / height; // G通道
            pixels[idx + 2] = 128;               // B通道
        }
    }
    return pixels;
}

// 使用TooJpeg压缩并保存为JPEG文件
void save_with_toojpeg(int width, int height, const std::vector<uint8_t>& rgb_data, const std::string& output_path) {
    std::ofstream output_file(output_path, std::ios::binary);
    if (!output_file) throw std::runtime_error("无法创建输出文件");

    // 回调函数：将压缩数据写入文件
    auto write_func = [&output_file](const void* data, size_t size) {
        output_file.write(reinterpret_cast<const char*>(data), size);
        return true; // 返回true表示继续压缩
    };

    // 压缩参数：宽度、高度、像素数据、回调、质量(0-100)、是否灰度、是否优化哈夫曼表
    bool success = TooJpeg::writeJpeg(write_func, width, height, rgb_data.data(), 80, false, true);
    if (!success) throw std::runtime_error("TooJpeg压缩失败");
}

// 压缩后直接转Base64（无需写入文件）
std::string screenshot_to_base64_with_toojpeg(int width, int height, const std::vector<uint8_t>& rgb_data) {
    std::vector<uint8_t> compressed_data;
    auto write_func = [&compressed_data](const void* data, size_t size) {
        const uint8_t* bytes = reinterpret_cast<const uint8_t*>(data);
        compressed_data.insert(compressed_data.end(), bytes, bytes + size);
        return true;
    };

    bool success = TooJpeg::writeJpeg(write_func, width, height, rgb_data.data(), 80, false, true);
    if (!success) throw std::runtime_error("TooJpeg压缩失败");

    return base64_encode(compressed_data.data(), compressed_data.size());
}

关键注意事项 #

• 像素格式要求：必须传入RGB24格式的像素数据（每个像素3字节，顺序R-G-B），如果截图是BGR/RGBA格式，需先转换为RGB24。
• 数据连续性：无需额外的行对齐填充，TooJpeg直接处理连续的行数据。
• 回调可靠性：确保回调函数完整接收所有压缩数据，文件流需保持打开状态直到压缩完成。

三、CMake配置补充 #

使用TooJpeg时，需在CMake中添加头文件路径：

# 引入TooJpeg头文件目录
include_directories(${PROJECT_SOURCE_DIR}/external/toojpeg)

内容的提问来源于stack exchange，提问作者urivskay