Enhance image loading methods by renaming parameters for clarity; add support for loading Texture2D and updating README with new features

Author: IvanMurzak

Assets/_PackageRoot/Runtime/Future/Future.ThenSet.cs

@@ -50,39 +50,57 @@ public static IFuture<Sprite> ThenSet(this IFuture<Sprite> future, params Image[
         /// <summary>
         /// Set image into array of RawImages
         /// </summary>
-        /// <param name="images">Array of RawImages</param>
+        /// <param name="rawImages">Array of RawImages</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Sprite> ThenSet(this IFuture<Sprite> future, params RawImage[] rawImages)
             => future.ThenSet((consumer, sprite) => consumer.texture = sprite?.texture, rawImages);
 
         /// <summary>
         /// Set image into array of RawImages
         /// </summary>
-        /// <param name="images">Array of RawImages</param>
+        /// <param name="rawImages">Array of RawImages</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Texture2D> ThenSet(this IFuture<Texture2D> future, params RawImage[] rawImages)
             => future.ThenSet((consumer, texture) => consumer.texture = texture, rawImages);
 
         /// <summary>
         /// Set image into array of SpriteRenderers
         /// </summary>
-        /// <param name="images">Array of SpriteRenderers</param>
+        /// <param name="spriteRenderers">Array of SpriteRenderers</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Sprite> ThenSet(this IFuture<Sprite> future, params SpriteRenderer[] spriteRenderers)
             => future.ThenSet((consumer, sprite) => consumer.sprite = sprite, spriteRenderers);
 
         /// <summary>
         /// Set image into array of Materials
         /// </summary>
-        /// <param name="images">Array of Materials</param>
+        /// <param name="materials">Array of Materials</param>
+        /// <returns>Returns async Future</returns>
+        public static IFuture<Sprite> ThenSet(this IFuture<Sprite> future, params Material[] materials)
+            => future.ThenSet("_MainTex", materials);
+
+        /// <summary>
+        /// Set image into array of Materials
+        /// </summary>
+        /// <param name="propertyName">Property name to set the texture</param>
+        /// <param name="materials">Array of Materials</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Sprite> ThenSet(this IFuture<Sprite> future, string propertyName = "_MainTex", params Material[] materials)
             => future.ThenSet((consumer, sprite) => consumer.SetTexture(propertyName, sprite?.texture), materials);
 
         /// <summary>
         /// Set image into array of Materials
         /// </summary>
-        /// <param name="images">Array of Materials</param>
+        /// <param name="materials">Array of Materials</param>
+        /// <returns>Returns async Future</returns>
+        public static IFuture<Texture2D> ThenSet(this IFuture<Texture2D> future, params Material[] materials)
+            => future.ThenSet("_MainTex", materials);
+
+        /// <summary>
+        /// Set image into array of Materials
+        /// </summary>
+        /// <param name="propertyName">Property name to set the texture</param>
+        /// <param name="materials">Array of Materials</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Texture2D> ThenSet(this IFuture<Texture2D> future, string propertyName = "_MainTex", params Material[] materials)
             => future.ThenSet((consumer, texture) => consumer.SetTexture(propertyName, texture), materials);

Assets/_PackageRoot/Runtime/Future/Future.ThenSetRef.cs

@@ -59,39 +59,57 @@ public static IFuture<Reference<Sprite>> ThenSet(this IFuture<Reference<Sprite>>
         /// <summary>
         /// Set image into array of RawImages
         /// </summary>
-        /// <param name="images">Array of RawImages</param>
+        /// <param name="rawImages">Array of RawImages</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Reference<Sprite>> ThenSet(this IFuture<Reference<Sprite>> future, params RawImage[] rawImages)
             => future.ThenSet((consumer, reference) => consumer.texture = reference?.Value?.texture, rawImages);
 
         /// <summary>
         /// Set image into array of RawImages
         /// </summary>
-        /// <param name="images">Array of RawImages</param>
+        /// <param name="rawImages">Array of RawImages</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Reference<Texture2D>> ThenSet(this IFuture<Reference<Texture2D>> future, params RawImage[] rawImages)
             => future.ThenSet((consumer, reference) => consumer.texture = reference?.Value, rawImages);
 
         /// <summary>
         /// Set image into array of SpriteRenderers
         /// </summary>
-        /// <param name="images">Array of SpriteRenderers</param>
+        /// <param name="spriteRenderers">Array of SpriteRenderers</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Reference<Sprite>> ThenSet(this IFuture<Reference<Sprite>> future, params SpriteRenderer[] spriteRenderers)
             => future.ThenSet((consumer, reference) => consumer.sprite = reference?.Value, spriteRenderers);
 
         /// <summary>
         /// Set image into array of Materials
         /// </summary>
-        /// <param name="images">Array of Materials</param>
+        /// <param name="materials">Array of Materials</param>
+        /// <returns>Returns async Future</returns>
+        public static IFuture<Reference<Sprite>> ThenSet(this IFuture<Reference<Sprite>> future, params Material[] materials)
+            => future.ThenSet("_MainTex", materials);
+
+        /// <summary>
+        /// Set image into array of Materials
+        /// </summary>
+        /// <param name="propertyName">Property name to set the texture</param>
+        /// <param name="materials">Array of Materials</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Reference<Sprite>> ThenSet(this IFuture<Reference<Sprite>> future, string propertyName = "_MainTex", params Material[] materials)
             => future.ThenSet((consumer, reference) => consumer.SetTexture(propertyName, reference?.Value?.texture), materials);
 
         /// <summary>
         /// Set image into array of Materials
         /// </summary>
-        /// <param name="images">Array of Materials</param>
+        /// <param name="materials">Array of Materials</param>
+        /// <returns>Returns async Future</returns>
+        public static IFuture<Reference<Texture2D>> ThenSet(this IFuture<Reference<Texture2D>> future, params Material[] materials)
+            => future.ThenSet("_MainTex", materials);
+
+        /// <summary>
+        /// Set image into array of Materials
+        /// </summary>
+        /// <param name="propertyName">Property name to set the texture</param>
+        /// <param name="materials">Array of Materials</param>
         /// <returns>Returns async Future</returns>
         public static IFuture<Reference<Texture2D>> ThenSet(this IFuture<Reference<Texture2D>> future, string propertyName = "_MainTex", params Material[] materials)
             => future.ThenSet((consumer, reference) => consumer.SetTexture(propertyName, reference?.Value), materials);

Assets/_PackageRoot/Samples/SampleImageLoading.cs

@@ -6,13 +6,20 @@ public class SampleImageLoading : MonoBehaviour
 {
     [SerializeField] string imageURL;
     [SerializeField] Image image;
+    [SerializeField] Material material;
 
     async void Start()
     {
-        // Loading sprite from web, cached for quick load next time
+        // Loading Sprite from web, cached for quick load next time
         image.sprite = await ImageLoader.LoadSprite(imageURL);
 
-        // Same loading with auto set to image
+        // Same loading with self inject into image
         await ImageLoader.LoadSprite(imageURL).ThenSet(image);
+
+        // Loading Texture2D from web, cached for quick load next time
+        material.mainTexture = await ImageLoader.LoadTexture(imageURL);
+
+        // Same loading with self inject into material
+        await ImageLoader.LoadTexture(imageURL).ThenSet(material);
     }
 }

README.md

@@ -8,6 +8,7 @@ Async image loader with two caching layers for Unity. It supports loading images
 ## Features
 
 - ✔️ Async loading from **Web** or **Local** `ImageLoader.LoadSprite(imageURL);`
+- ✔️ Load `Texture2D` and `Sprite`
 - ✔️ **Memory** and **Disk** caching - tries to load from memory first, then from disk
 - ✔️ Dedicated thread for disk operations
 - ✔️ Avoids loading same image multiple times simultaneously, task waits for completion the first and just returns loaded image if at least one cache layer activated
@@ -45,14 +46,21 @@ public class SampleImageLoading : MonoBehaviour
 {
     [SerializeField] string imageURL;
     [SerializeField] Image image;
+    [SerializeField] Material material;
 
     async void Start()
     {
-        // Loading sprite from web, cached for quick load next time
+        // Loading Sprite from web, cached for quick load next time
         image.sprite = await ImageLoader.LoadSprite(imageURL);
 
-        // Same loading with auto set to image
+        // Same loading with self inject into image
         await ImageLoader.LoadSprite(imageURL).ThenSet(image);
+
+        // Loading Texture2D from web, cached for quick load next time
+        material.mainTexture = await ImageLoader.LoadTexture(imageURL);
+
+        // Same loading with self inject into material
+        await ImageLoader.LoadTexture(imageURL).ThenSet(material);
     }
 }
 ```