Cannot Load Texture with MTKTextureLoader

Question

Created Aug ’19

Replies 7

Boosts 0

Views 4.0k

Participants 11

Every time I attempt to load an image using MTKTextureLoader, my app crashes simply saying "Image decoding failed". Here is the relevant code:

let loader = MTKTextureLoader(device: Renderer.main.device)
do {
     texture = try loader.newTexture(name: name,
                                     scaleFactor: Renderer.main.displayLayer.contentsScale,
                                     bundle: Bundle.main,
                                     options: nil)
} catch(let error) {
     fatalError("Error when loading image \"\(name)\": " + error.localizedDescription)
}

(name = "Circle"; Circle is an image in my asset catalog)

This is not an issue of not finding the image, because if I change the "name" variable to something that is not in my asset catalog, I get an error that states the image could not be located. This also does not have to do with the "scaleFactor", because I have tried manually setting that to 1.0, 2.0, and 3.0, with no success. I have checked the .png's properties using the file command, and it gives me this:

PNG image data, 300 x 300, 8-bit/color RGBA, non-interlaced

So clearly the file is not corrupt and certainly is not unusual; it's just your average .png file. Also, this is erroring when run on my iPhone 8 (iOS 12.4; deployment target is iOS 10.3).

Is there some step I'm missing or doing wrong?

Boost

Answer 1

alkjslkjslkjds OP

May ’20

Come on Apple! Loading PNGs doesn't seem to work. Help your developers...

0

Answer 2

lducot2 OP

Jul ’20

I came to the forum because I have been having the exact same problem. My code is in Objective-C, but I have been trying to use the equivalent method on MTKTextureLoader. I went down the same path as you with . . . odd results.

In my code, I have an array of texture file names that correspond to the texture names in Xcode's image set. I loop through them passing each texture name to [textureLoader newTextureWithName:imageName:scaleFactor:1.0: bundle:nil:options:loaderOptions:error:&error];.

For some of the textures, the code works as expected. For others, I receive the "Image decoding failed" error in my log. I thought there might be an error in the texture name conventions, but I set up a test for that to ensure everything matches. I was also able to load the images that do not load with the MTKTextureLoader using a different framework.

I suspect Xcode's asset catalog is having trouble interfacing with Metal. I was hoping to find a work around, but for the time being, I am loading the textures outside of the asset catalog like so:

Code Block Objective-CNSURL* img = [[NSBundle mainBundle]URLForResource:imageName withExtension:@"png"];
id<MTLTexture> texture = [textureLoader newTextureWithContentsOfURL:img options:nil error:&error];

This approach is working fine for now, but I would love to use the asset catalog instead.

0

Answer 3

whlteXbread OP

Nov ’22

I ran into this error when trying to load a large image (many tens of megapixels). Resizing the image (in this case to 1080P) resolved the issue.

The OP's issue didn't have to do with large size, but I wanted to share my experience because the error didn't offer lots of detail.

0

Answer 4

Kramer_ OP

Nov ’22

I know this is an old post, but there are still problems it seems even with the latest XCode 14 -- wondering if others can confirm this. I got this same error on a small 16x16 PNG that was just a white antialiased dot in PNG format. The file loaded fine into preview -- there was nothing wrong with it. After much experimentation (different sizes, remaking it) I finally discovered why it would not load -- I simply added some color tinting to the image so it was no longer greyscale and it loaded fine. Thinking there is some odd bug where it cannot handle a greyscale PNG. For my purposes I did not care about the color so it is a decent workaround. If others can confirm this I will try to file a bug report.

2

Answer 5

mrnewell OP

Feb ’24

Just adding to this, you cannot diffuse a CIImage and you must CGImage.

A UIImage initiated from a CIImage won't work either.

0

Answer 6

halm OP

Apr ’24

I just hit the same problem/error, with RealityView and a Reality Composer Pro scene driven by a Shader Graph Node. This line was working sometimes, not working others:

let newTexture = try TextureResource.load(named: newValue)

It turns out it was failing on 1024x1024 PNGs that were all grayscale. Adding a tiny red line on each one cured it (done in Preview.app, color model of the PNG is still "Gray").

Xcode 15.3, reproducible on Simulator and on Vision Pro running visionOS 1.2.

Feedback FB13733823.

0

Answer 7

Starfia OP

Aug ’24

I know this is a five-year-old question, but I thought I'd point out that this method is documented as being meant to load a texture in an asset catalog, as opposed to an image in an asset catalog. (Make sure to choose "New Texture Set" when setting up the asset catalog.)

0