Allow async and sync texture loading

Author: STREGA

Sources/GateEngine/Helpers/TextureAtlas.swift

@@ -148,7 +148,7 @@ public final class TextureAtlasBuilder {
 
         let importer = PNGImporter()
         try importer.synchronousPrepareToImportResourceFrom(path: unresolvedPath)
-        let rawTexture = try importer.loadTexture(options: .none)
+        let rawTexture = try importer.synchronousLoadTexture(options: .none)
 
         var textureData = TextureData(size: rawTexture.imageSize, imageData: rawTexture.imageData, coordinate: (0,0))
         var dataIndex = self.textureDatas.endIndex

Sources/GateEngine/Resources/Import & Export/Importers/ApplePlatformImageImporter.swift

@@ -52,11 +52,15 @@ public final class ApplePlatformImageImporter: TextureImporter {
             throw GateEngineError(error)
         }
     }
-
-    public func loadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
+    
+    public func synchronousLoadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
         return RawTexture(imageSize: size, imageData: data)
     }
 
+    public func loadTexture(options: TextureImporterOptions) async throws(GateEngineError) -> RawTexture {
+        return try synchronousLoadTexture(options: options)
+    }
+
     public static func canProcessFile(_ path: String) -> Bool {
         let pathExtension = URL(fileURLWithPath: path).pathExtension
         guard pathExtension.isEmpty == false else {return false}

Sources/GateEngine/Resources/Import & Export/Importers/GLTransmissionFormat.swift

@@ -1118,7 +1118,7 @@ extension GLTransmissionFormat: ObjectAnimation3DImporter {
 
 extension GLTransmissionFormat: TextureImporter {
     // TODO: Supports only PNG. Add other formats (JPEG, WebP, ...)
-    public func loadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
+    public func synchronousLoadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
         let imageData: Data
         func loadImageData(image: GLTF.Image) throws(GateEngineError) -> Data {
             if let uri = image.uri {
@@ -1153,6 +1153,10 @@ extension GLTransmissionFormat: TextureImporter {
 
         return try PNGDecoder().decode(imageData)
     }
+    
+    public func loadTexture(options: TextureImporterOptions) async throws(GateEngineError) -> RawTexture {
+        return try synchronousLoadTexture(options: options)
+    }
 }
 
 extension GLTransmissionFormat: CollisionMeshImporter {

Sources/GateEngine/Resources/Import & Export/Importers/PNGImporter.swift

@@ -22,10 +22,13 @@ public final class PNGImporter: TextureImporter {
     public func prepareToImportResourceFrom(path: String) async throws(GateEngineError) {
         self.data = try await Platform.current.loadResource(from: path)
     }
-
-    public func loadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
+    
+    public func synchronousLoadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture {
         return try PNGDecoder().decode(data)
+    }
 
+    public func loadTexture(options: TextureImporterOptions) async throws(GateEngineError) -> RawTexture {
+        return try synchronousLoadTexture(options: options)
     }
 
     public static func supportedFileExtensions() -> [String] {

Sources/GateEngine/Resources/Text/Backends/ImageFont.swift

@@ -16,7 +16,7 @@ struct ImageFont: FontBackend {
     init(regular: String) async throws {
         let importer = try await Game.unsafeShared.resourceManager.textureImporterForPath(regular)
 
-        let rawTexture = try importer.loadTexture(options: .none)
+        let rawTexture = try await importer.loadTexture(options: .none)
 
         let fontData: [Font.Style: (rawTexture: RawTexture, importer: any TextureImporter.Type)] =
             [.regular: (rawTexture, type(of: importer))]

Sources/GateEngine/Resources/Texture/Texture.swift

@@ -164,7 +164,8 @@ extension Texture: Equatable, Hashable {
 // MARK: - Resource Manager
 
 public protocol TextureImporter: ResourceImporter {
-    func loadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture
+    func synchronousLoadTexture(options: TextureImporterOptions) throws(GateEngineError) -> RawTexture
+    func loadTexture(options: TextureImporterOptions) async throws(GateEngineError) -> RawTexture
 }
 
 public struct TextureImporterOptions: Equatable, Hashable, Sendable {
@@ -366,7 +367,7 @@ extension ResourceManager {
 
                 let importer = try await Game.unsafeShared.resourceManager.textureImporterForPath(path)
 
-                let rawTexture = try importer.loadTexture(options: key.textureOptions)
+                let rawTexture = try await importer.loadTexture(options: key.textureOptions)
                 guard rawTexture.imageData.isEmpty == false else {
                     throw GateEngineError.failedToLoad(resource: path, "File is empty.")
                 }