preload(_:withCompletionHandler:)

Load the data of multiple textures into memory.

Declaration

class func preload(_ textures: [SKTexture], withCompletionHandler completionHandler: @escaping  @Sendable () -> Void)

class func preload(_ textures: [SKTexture]) async

Parameters

textures:
An array of Sktexture objects.
completionHandler:
A block called after all of the textures are loaded.

Mentioned in

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:

class func preload(_ textures: [SKTexture]) async

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

SpriteKit creates a background task that loads the texture data for all of the textures in the array, then returns control to your game. Your completion handler is called after all of the textures are loaded.