Instance Method

textureWithContentsOfFile:options:queue:completionHandler:

Asynchronously loads a 2D texture image from a file and creates a new texture from the data.

Declaration

- (void)textureWithContentsOfFile:(NSString *)path options:(NSDictionary<NSString *,NSNumber *> *)options queue:(dispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block;

Parameters

fileName

A path to the file to load.

textureOperations

A dictionary that describes any additional steps you want the texture loader to take when loading the texture. See Texture Loading Options.

queue

A dispatch queue that your block is called on when the task completes. If NULL is passed, the block is called on the main dispatch queue.

block

A block to be called when the task completes.

Discussion

This method is identical to textureWithContentsOfFile:options:error:, except that it loads the texture asynchronously. When this method is called, it creates a new background task to handle the request and then returns control to your app. Later, when the task is complete, GLKit calls your completion handler on the queue you provided.

See Also

Loading Textures from Files

+ textureWithContentsOfFile:options:error:

Loads a 2D texture image from a file and creates a new texture from the data.

Deprecated