---
title: "texture(with:options:queue:completionHandler:)"
framework: glkit
role: symbol
role_heading: Instance Method
path: "glkit/glktextureloader/texture(with:options:queue:completionhandler:)"
---

# texture(with:options:queue:completionHandler:)

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

## Declaration

```swift
func texture(with cgImage: CGImage, options: [String : NSNumber]? = nil, queue: dispatch_queue_t?, completionHandler block: @escaping @Sendable (GLKTextureInfo?, (any Error)?) -> Void)
```

```swift
func texture(with cgImage: CGImage, options: [String : NSNumber]? = nil, queue: dispatch_queue_t?) async throws -> GLKTextureInfo
```

## Parameters

- `cgImage`: The Quartz image to be turned into a texture.
- `options`: A dictionary that describes any additional steps you want the texture loader to take when loading the texture. See doc://com.apple.glkit/documentation/GLKit/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

Discussion This method is identical to texture(with:options:), 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

- [texture(with:options:)](glkit/glktextureloader/texture(with:options:).md)