stbi_load()读取图片是否存在像素数量限制？大尺寸图片加载失败咨询

你遇到的加载失败问题大概率是图片像素总量过大导致的，具体原因和排查方案如下：

• 先做基础内存核算：43K * 21K 分辨率的图片解码后原始像素数据大小约为 43000 * 21000 * 3（RGB三通道）≈ 2.7GB，如果你当前编译的是32位程序，进程可用的用户态地址空间最大只有2GB左右，完全不足以承载这么大的内存块，内存分配失败后stbi_load会直接返回空指针，和你遇到的表现完全一致。而之前21K*10K的图片解码后仅约630MB，在32位程序的内存上限范围内，所以可以正常加载。
• 部分旧版本的stb_image内置了默认的分辨率上限宏定义STBI_MAX_IMAGE_WIDTH、STBI_MAX_IMAGE_HEIGHT，如果你的版本未手动修改这两个宏的阈值，也可能触发分辨率校验直接返回加载失败。
• 你可以先通过stb_image提供的错误查询接口明确具体原因，修改你的错误分支代码即可：

else 
{
    cout << "load image failed, reason: " << stbi_failure_reason() << endl;
}

• 确认是内存/分辨率限制导致的问题后，可根据你的使用场景选择解决方案：
  • 仅需要验证加载可行性的话，将项目切换为64位编译，只要设备物理内存+虚拟内存总和大于3GB就可以正常加载
  • 如果是用于渲染纹理，建议将超大分辨率图片切分为多张小瓦片，按需加载对应区域的瓦片即可，不需要全量加载整图
  • 必须加载整图的场景可以换用支持分块解码的jpeg处理库，避免全量像素数据同时驻留内存

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