C语言手写PNG文件时IDAT块数据计算生成问题排查

核心错误原因 #

• PNG规范明确要求：所有IDAT块的数据拼接完成后，必须是一个连续完整的zlib deflate流，对应的原始未压缩数据是「所有带滤波前缀的扫描线按从上到下顺序拼接成的整块数据」。你逐行调用compress()的写法，会生成screenHeight个互相独立的zlib压缩流（每个流自带zlib头、adler32校验尾），拼接后完全不符合规范。
• 绝大多数PNG解码器遇到非法的zlib流时，不会直接报错退出，而是直接将无法解析的像素区域填充为0值，这就是你看到画面全黑、十六进制查看像素全为0的直接原因。

其他需要同步排查的易错点 #

• 确认扫描线结构正确：使用滤波类型0（None滤波）是合法的，每行的第一个字节必须是滤波类型值，之后才是按顺序排列的RGB通道字节，不要把滤波字节放错位置、或者漏算行偏移导致像素数据错位。
• 确认IDAT块结构正确：块长度字段是压缩后数据的实际字节数（大端序32位无符号整数），CRC32校验值必须覆盖IDAT四个类型字节+压缩后的全部数据，不要漏算类型字段导致校验失败。
• 确认zlib流格式正确：compress()默认生成的带zlib头、adler32尾的流刚好符合PNG要求，不要切换为raw deflate（无zlib头）或者gzip格式，否则解码器会识别失败。

正确实现步骤 #

最小可运行的IDAT生成逻辑如下：

1. 预分配原始图像数据缓冲区，总大小为 screenHeight * (1 + 3 * screenWidth) 字节
2. 逐行填充缓冲区：每行首字节填0x00（None滤波），后续依次写入该行每个像素的R、G、B三通道值
3. 对整块原始缓冲区仅调用一次compress()接口，得到完整的连续zlib压缩流
4. 按PNG块规范写入数据：先写4字节大端序的压缩数据长度，再写4字节的IDAT类型标识，接着写全部压缩数据，最后写4字节大端序的CRC32校验值
5. 如果要拆分多个IDAT块，只能对步骤3得到的连续压缩流做字节级拆分，每个IDAT块存一段压缩流字节，绝对不能拆分原始数据逐段压缩。

你可以先用1x1纯红色像素做验证：原始缓冲区共4字节，内容为0x00 0xFF 0x00 0x00，单次压缩后写入IDAT，能正常显示红点就说明逻辑正确。

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