iOS平台使用NBIS将JPG转WSQ格式压缩的问题排查

可能的问题原因 #

• 图像数据格式不匹配：Android与iOS的图像像素存储逻辑存在差异，比如灰度图的字节序、位深，或是RGB/BGR通道顺序。WSQForAndroid针对Android的图像格式做了适配，若iOS端直接传入未转换的图像数据，会导致编码输入错误。
• 底层库编译适配问题：WSQ编码依赖C/C++原生库（如NIST官方实现），Android与iOS的编译器、架构（arm64/x86_64）编译选项不同，若移植时未调整编译配置，可能出现未定义行为或编译错误，导致输出异常。
• 内存处理差异：两端内存管理机制不同，比如指针操作、内存分配/释放时机，移植代码时若未适配iOS的内存规则，可能引发内存越界、数据损坏。
• 编码参数不一致：即便输入图像相同，若iOS端调用编码接口时的压缩率、小波类型等参数与Android端不一致，也会导致输出结果错误。

iOS平台实现方案 #

1. 移植NIST官方WSQ实现 #

• 获取NIST的WSQ参考C代码，针对iOS平台配置编译选项，支持arm64、x86_64架构，解决跨平台编译兼容性问题。
• 预处理图像数据：将iOS的UIImage转换为WSQ要求的8位单通道灰度图，确保像素排列、字节序与Android端输入完全一致，比如将UIImage转为CGImage后提取灰度字节流。
• 封装OC/Swift接口：将C语言的编码逻辑封装为Objective-C或Swift类，对外提供简洁的调用方法，示例：

  + (NSData *)encodeGrayImageToWSQ:(UIImage *)grayImage compressionRatio:(float)ratio;
  

2. 使用第三方适配库 #

• 选择已适配iOS的开源WSQ库，优先选用经过社区验证的项目，减少自行移植的工作量。
• 集成时严格按照库的要求处理输入图像，比如确保输入为8位灰度字节数据，避免因格式不符导致编码错误。

3. 验证与调试 #

• 使用同一测试图像，分别在Android和iOS端生成WSQ数据，对比二进制文件的差异，定位输入数据或编码逻辑的问题。
• 打印编码过程中的关键参数（图像宽高、位深、压缩率），确保两端参数完全一致。
• 用WSQ解码工具分别解码两端输出，检查解码后的图像是否正常，判断是编码环节还是数据传输环节出问题。

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