TextureResource加载报错：Image decoding failure 问题求助

以下是导致MTKTextureLoaderErrorDomain Code=0错误的常见原因，结合你的场景针对性分析：

• JPG编码特性不兼容
  Insta360 X3生成的全景图可能使用了iOS Metal纹理加载器不支持的编码细节：

  • 特殊色度采样格式：比如采用4:4:4采样而非通用的4:2:0，Metal的默认解码器对这类非标准格式的支持有限
  • 自定义扩展段：相机可能在JPG中嵌入了专属的全景元数据扩展，干扰了解码器对文件结构的解析
  • 渐进式编码：部分场景下，Metal加载器对渐进式JPG的解码存在兼容性问题，而iPhone拼接的全景图多使用基线编码

• 图像尺寸超出设备纹理上限
  Insta360 X3的全景图分辨率通常高达6080×3040，部分旧款iPhone的Metal设备支持的最大纹理尺寸可能低于这个值，直接导致解码失败。可以通过MTLCreateSystemDefaultDevice()?.maxTextureSize获取设备的上限，对比图片分辨率。

• 文件格式或完整性问题
  虽然文件后缀是JPG，但可能是HEIC等格式伪装而来，或者文件在导出/打包过程中出现字节损坏。可以用系统预览或Photoshop重新导出为标准基线JPG，再测试加载。

• 默认加载参数限制
  TextureResource.load(named:)的默认配置可能不适配这类全景图，尝试手动用MTKTextureLoader自定义参数加载：

  guard let url = Bundle.main.url(forResource: "studio-mod", withExtension: "jpg") else { return nil }
  guard let device = MTLCreateSystemDefaultDevice() else { return nil }
  
  let loader = MTKTextureLoader(device: device)
  let options: [MTKTextureLoader.Option: Any] = [
      .SRGB: false, // 全景图通常不需要SRGB色彩校正
      .origin: MTKTextureLoader.Origin.bottomLeft // 匹配SceneKit/RealityKit的纹理坐标
  ]
  
  do {
      let metalTexture = try loader.newTexture(URL: url, options: options)
      let textureResource = TextureResource(metalTexture)
      myMaterial.color = .init(texture: .init(textureResource))
  } catch {
      print("Failed to load texture: \(error)")
      return nil
  }
  

快速排查步骤 #

1. 用图像工具将Insta360的JPG重新导出为基线编码、4:2:0采样的标准JPG，再尝试加载
2. 打印设备支持的最大纹理尺寸，确认图片分辨率未超出限制
3. 用上述手动加载代码测试，调整options参数看是否能成功

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