如何将黑白图像加载到Metal纹理？解码失败问题求助

这个问题我之前也碰到过，核心原因是MTKTextureLoader默认的配置并不完全兼容单通道灰度图或者索引色格式的黑白图像，而彩色图一般是RGB/RGBA多通道格式，刚好在默认支持范围内，所以能正常加载。下面给你几个可行的解决思路：

1. 调整纹理加载选项，指定兼容的像素格式 #

MTKTextureLoader的默认选项可能会尝试把图像解码为SRGB格式的多通道纹理，而黑白图是单通道的，导致解码失败。你可以手动指定像素格式和相关选项来适配：

首先创建包含正确配置的options字典：

NSDictionary *textureLoaderOptions = @{
    // 关闭SRGB，灰度图不需要色彩空间转换
    MTKTextureLoaderOptionSRGB: @NO,
    // 指定单通道灰度像素格式，对应8位无符号归一化值
    MTKTextureLoaderOptionPixelFormat: @(MTLPixelFormatR8Unorm),
    // 根据你的使用场景设置纹理用途，这里是 shader 读取
    MTKTextureLoaderOptionTextureUsage: @(MTLTextureUsageShaderRead)
};

然后用这个options来加载纹理，不管是用newTextureWithName:还是newTextureWithCGImage:方法都适用：

// 方法1：通过名称加载
NSError *error = nil;
id<MTLTexture> mtltexture01 = [textureLoader newTextureWithName:@"texture02" scaleFactor:1.0 bundle:nil options:textureLoaderOptions error:&error];

// 方法2：通过CGImage加载
UIImage *img = [UIImage imageNamed:@"texture02"];
id<MTLTexture> mtltexture01 = [textureLoader newTextureWithCGImage:img.CGImage options:textureLoaderOptions error:&error];

2. 转换黑白图像为Metal兼容的格式 #

如果你的黑白图像是索引色格式（Indexed Color），即使指定像素格式也可能解码失败，这时候需要先把图像转换为单通道灰度图的CGImage，再传给MTKTextureLoader：

添加一个转换方法：

- (CGImageRef)convertToGrayscaleCGImage:(UIImage *)image {
    // 创建灰度色彩空间
    CGColorSpaceRef grayColorSpace = CGColorSpaceCreateDeviceGray();
    // 创建单通道（8位）、无alpha的位图上下文
    CGContextRef context = CGBitmapContextCreate(NULL, 
                                                 image.size.width, 
                                                 image.size.height, 
                                                 8, 
                                                 0, 
                                                 grayColorSpace, 
                                                 kCGImageAlphaNone);
    // 绘制原图像到灰度上下文
    CGContextDrawImage(context, CGRectMake(0, 0, image.size.width, image.size.height), image.CGImage);
    // 从上下文生成新的CGImage
    CGImageRef grayCGImage = CGBitmapContextCreateImage(context);
    
    // 释放资源
    CGContextRelease(context);
    CGColorSpaceRelease(grayColorSpace);
    
    return grayCGImage;
}

然后使用转换后的CGImage加载纹理：

UIImage *img = [UIImage imageNamed:@"texture02"];
CGImageRef grayCGImage = [self convertToGrayscaleCGImage:img];
id<MTLTexture> mtltexture01 = [textureLoader newTextureWithCGImage:grayCGImage options:textureLoaderOptions error:&error];
// 记得释放CGImage
CGImageRelease(grayCGImage);

3. 检查图像文件本身 #

最后可以确认下你的黑白图像文件：

• 是不是用了比较特殊的编码格式（比如某些压缩的单通道格式）
• 图像尺寸是不是符合Metal纹理的要求（部分旧设备可能要求宽高是2的幂次，不过新版本Metal已支持非幂次尺寸）

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