Instance Method

textureWithCGImage:options:queue:completionHandler:

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

Declaration

- (void)textureWithCGImage:(CGImageRef)cgImage options:(NSDictionary<NSString *,NSNumber *> *)options queue:(dispatch_queue_t)queue completionHandler:(GLKTextureLoaderCallback)block;

Parameters

cgImage

The Quartz image to be turned into a texture.

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 textureWithCGImage: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

Creating Textures from CGImages

+ textureWithCGImage:options:error:

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

Deprecated