newTexture(URL:options:completionHandler:)

Asynchronously loads image data and creates a new Metal texture from a given URL.

Declaration

func newTexture(URL: URL, options: [MTKTextureLoader.Option : Any]? = nil, completionHandler: @escaping  @Sendable ((any MTLTexture)?, (any Error)?) -> Void)

func newTexture(URL: URL, options: [MTKTextureLoader.Option : Any]? = nil) async throws -> any MTLTexture

Parameters

URL:
The URL of the file to load.
options:
A dictionary describing any additional texture loading steps. See Texture Loading Options.
completionHandler:
A block called when the texture has been loaded and fully initialized.

Discussion

important:

You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration:

func newTexture(URL: URL, options: [MTKTextureLoader.Option : Any]? = nil) async throws -> MTLTexture

For information about concurrency and asynchronous code in Swift, see Calling Objective-C APIs Asynchronously.

newTexture(URL:options:completionHandler:)

Declaration

Parameters

Discussion

See Also

Loading Textures from URLs