Generating sprites dynamically from PNG or JPEG files in C#

Hey everyone!

I was searching the forums here (and some external sources) to find a way to load an external PNG file into a Unity-Sprite and display it on a UI.image element. It took me about a day to figure out how to do this! :-o

But i finally managed to do it and thought its about time to give back something to the forum and share this little class with you.

Hope this helps in any way in case you are looking for the same info as I did!

Code (csharp):

1. using UnityEngine;
2. using System.Collections;
3. using System.IO;
4.  
5. public class IMG2Sprite : MonoBehaviour {
6.  
7.    // This script loads a PNG or JPEG image from disk and returns it as a Sprite
8.    // Drop it on any GameObject/Camera in your scene (singleton implementation)
9.    //
10.    // Usage from any other script:
11.    // MySprite = IMG2Sprite.instance.LoadNewSprite(FilePath, [PixelsPerUnit (optional)])
12.  
13.    private static IMG2Sprite _instance;
14.  
15.    public static IMG2Sprite instance
16.    {
17.      get    
18.      {
19.        //If _instance hasn't been set yet, we grab it from the scene!
20.        //This will only happen the first time this reference is used.
21.  
22.        if(_instance == null)
23.          _instance = GameObject.FindObjectOfType<IMG2Sprite>();
24.        return _instance;
25.      }
26.    }
27.  
28.    public Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f) {
29.    
30.      // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
31.      
32.      Sprite NewSprite = new Sprite();
33.      Texture2D SpriteTexture = LoadTexture(FilePath);
34.      NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height),new Vector2(0,0), PixelsPerUnit);
35.  
36.      return NewSprite;
37.    }
38.  
39.    public Texture2D LoadTexture(string FilePath) {
40.  
41.      // Load a PNG or JPG file from disk to a Texture2D
42.      // Returns null if load fails
43.  
44.      Texture2D Tex2D;
45.      byte[] FileData;
46.  
47.      if (File.Exists(FilePath)){
48.        FileData = File.ReadAllBytes(FilePath);
49.        Tex2D = new Texture2D(2, 2);           // Create new "empty" texture
50.        if (Tex2D.LoadImage(FileData))           // Load the imagedata into the texture (size is set automatically)
51.          return Tex2D;                 // If data = readable -> return texture
52.      }  
53.      return null;                     // Return null if load failed
54.    }
55. }

Happy Coding!

 

Many, many, many thanks!

 

just fyi, LoadImage has a big "thunk" to it to decode either PNG or JPG for textures... you should really look into using native formats for the images like DDS or PVR and use LoadRawTextureData (with their respective headers removed from the bits).

 

Thanks it helped a lot!

 

I found it much more efficient (for my use at least) to drop it into a static tools class and be able to reference it anywhere without having to drop it in the scene constantly. I also added SpriteMeshType so that you can choose (optional) whether to use Tight or FullRect. Unity likes to load FullRect faster than Tight so it might be use to some people for testing or real world use purposes. Just drop this into any script file and it will work outright

Edit 2/9/2018: I added a simple conversion method to the IMG2Sprite class since I needed to convert Texture2D's that are already loaded.

Edit 4/11/2019: Updated the sprite creation method to avoid the new Sprite() error.

Code (CSharp):

1.  
2. using UnityEngine;
3. using System.Collections;
4. using System.IO;
5.  
6. public static class IMG2Sprite
7. {
8.  
9.     //Static class instead of _instance
10.     // Usage from any other script:
11.     // MySprite = IMG2Sprite.LoadNewSprite(FilePath, [PixelsPerUnit (optional)], [spriteType(optional)])
12.  
13.     public static Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
14.     {
15.  
16.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
17.  
18.         Texture2D SpriteTexture = LoadTexture(FilePath);
19.         Sprite  NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height), new Vector2(0, 0), PixelsPerUnit, 0 , spriteType);
20.  
21.         return NewSprite;
22.     }
23.  
24.     public static Sprite ConvertTextureToSprite(Texture2D texture, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
25.     {
26.         // Converts a Texture2D to a sprite, assign this texture to a new sprite and return its reference
27.  
28.         Sprite NewSprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), new Vector2(0, 0), PixelsPerUnit, 0, spriteType);
29.  
30.         return NewSprite;
31.     }
32.  
33.     public static Texture2D LoadTexture(string FilePath)
34.     {
35.  
36.         // Load a PNG or JPG file from disk to a Texture2D
37.         // Returns null if load fails
38.  
39.         Texture2D Tex2D;
40.         byte[] FileData;
41.  
42.         if (File.Exists(FilePath))
43.         {
44.             FileData = File.ReadAllBytes(FilePath);
45.             Tex2D = new Texture2D(2, 2);           // Create new "empty" texture
46.             if (Tex2D.LoadImage(FileData))           // Load the imagedata into the texture (size is set automatically)
47.                 return Tex2D;                 // If data = readable -> return texture
48.         }
49.         return null;                     // Return null if load failed
50.     }
51. }
52.  

 

You can also use Resources.Load to create a sprite, if you have the image file in your Resources folder:

string path = "filename"; // filename.png should be stored in your Assets/Resources folder

Sprite sprite = Resources.Load<Sprite>(path);

This is handy if you have a collection of images, and want to be able to choose one dynamically by filename at runtime.

 

can you show me how to use the script ?

 

Hey, Great script. Only problem I'm having is that my image is off centered (up and to the right) and I cannot get it so the center of image is in the middle of the sprite render. Any thought


---Solved---
Added a .5f, .5f pivot

 

There was an error message in VS2017 editor of the script
Sprite NewSprite = new Sprite();
Sprite doesnt contain a constructor that takes 0 arguments

 

Change:

Code (CSharp):

1.  
2. public static Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
3.     {
4.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
5.         Sprite NewSprite = new Sprite();
6.         Texture2D SpriteTexture = LoadTexture(FilePath);
7.         NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height), new Vector2(0, 0), PixelsPerUnit, 0 , spriteType);
8.         return NewSprite;
9.     }

to

Code (CSharp):

1.  
2. public static Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
3.     {
4.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
5.         Texture2D SpriteTexture = LoadTexture(FilePath);
6.         Sprite NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height), new Vector2(0, 0), PixelsPerUnit, 0 , spriteType);
7.  
8.         return NewSprite;
9.     }
10.  

 

it does not work...

 

After upgrading Unity to 2018 I got the error:

Sprite does not contain a constructor

This is the updated code that works:

Code (CSharp):

1. using UnityEngine;
2. using System.Collections;
3. using System.IO;
4.  
5.  
6. public class IMG2Sprite : MonoBehaviour
7. {
8.  
9.  
10.     // This script loads a PNG or JPEG image from disk and returns it as a Sprite
11.     // Drop it on any GameObject/Camera in your scene (singleton implementation)
12.     //
13.     // Usage from any other script:
14.     // MySprite = IMG2Sprite.instance.LoadNewSprite(FilePath, [PixelsPerUnit (optional)])
15.  
16.     private static IMG2Sprite _instance;
17.  
18.     public static IMG2Sprite instance
19.     {
20.         get
21.         {
22.             //If _instance hasn't been set yet, we grab it from the scene!
23.             //This will only happen the first time this reference is used.
24.  
25.             if (_instance == null)
26.                 _instance = GameObject.FindObjectOfType<IMG2Sprite>();
27.             return _instance;
28.         }
29.     }
30.  
31.     public Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
32.     {      
33.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
34.         Texture2D SpriteTexture = LoadTexture(FilePath);
35.         Sprite NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height), new Vector2(0, 0), PixelsPerUnit, 0, spriteType);
36.  
37.         return NewSprite;
38.     }
39.  
40.     public Texture2D LoadTexture(string FilePath)
41.     {
42.  
43.         // Load a PNG or JPG file from disk to a Texture2D
44.         // Returns null if load fails
45.  
46.         Texture2D Tex2D;
47.         byte[] FileData;
48.  
49.         if (File.Exists(FilePath))
50.         {
51.             FileData = File.ReadAllBytes(FilePath);
52.             Tex2D = new Texture2D(2, 2);           // Create new "empty" texture
53.             if (Tex2D.LoadImage(FileData))           // Load the imagedata into the texture (size is set automatically)
54.                 return Tex2D;                 // If data = readable -> return texture
55.         }
56.         return null;                     // Return null if load failed
57.     }
58. }
59.  
60.  

 

I did some tests with your code and found out that if you set SpriteMeshType.FullRect instead of SpriteMeshType.Tight you increase the loading speed significantly.

In case some is wondering why Sprite.Create is so slow.

 

I tried tik_tikkers' latest snippet and the sprites it generates are noticably blurrier than ones created with the Editor and loaded as Resources. I tried decreasing PixelsPerUnit as well as both types of SpriteMeshType to no effect. Has anyone encountered this?

(2019.4)

 

Try settings Tex2d.FilterMode = FilterMode.Point

Should remove the "blurriness" you're talking about.

 

Thanks for the tip Thomas! The Unity code I am trying to emulate was using FilterMode.Bilinear; setting my code to use that, as well as setting Tex2D.wrapMode = TextureWrapMode.Clamp; got things to look a lot closer to the inspector result.

 

Thanks! I was looking for the solution for this for quite some time. You are the best!

In my case I am loading map tiles, 138 jpgs with size 500px x 475px. If I drop it to Unity Editor each image is 0.7MB but if I keep it as ".bytes" in the Resources, it's only 50KBs each.

It all works since but the edge of the image was blurred. With your suggestion is now nice and clean.

This is how I load jpg from ".bytes" files, saving package size and loading it in the runtime. Seriously, Unity should have that option under sprite setup (slow load, no disk impact):

Code (CSharp):

1.  Texture2D texture = new Texture2D(500, 475, TextureFormat.RGB24, false);
2. texture.filterMode = FilterMode.Point;
3. TextAsset text = Resources.Load<TextAsset>($"MapTiles/Stage{stage}/{fileName}");
4. texture.LoadImage(text.bytes);
5.  
6. Sprite sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), new Vector2(0.5f, 0.5f), 100f, 1, SpriteMeshType.FullRect);

Before:


After with FilterMode.Point:


JPGs in the Resource:

 

How do you get this running? I have copied the script but I don't see any pngs converting to sprite? Could anyone help me understand how to use this script its very important.

Code (CSharp):

1. using UnityEngine;
2. using System.Collections;
3. using System.IO;
4. public class IMG2Sprite : MonoBehaviour
5. {
6.     // This script loads a PNG or JPEG image from disk and returns it as a Sprite
7.     // Drop it on any GameObject/Camera in your scene (singleton implementation)
8.     //
9.     // Usage from any other script:
10.     // MySprite = IMG2Sprite.instance.LoadNewSprite(FilePath, [PixelsPerUnit (optional)])
11.     private static IMG2Sprite _instance;
12.     public static IMG2Sprite instance
13.     {
14.         get
15.         {
16.             //If _instance hasn't been set yet, we grab it from the scene!
17.             //This will only happen the first time this reference is used.
18.             if (_instance == null)
19.                 _instance = GameObject.FindObjectOfType<IMG2Sprite>();
20.             return _instance;
21.         }
22.     }
23.     public Sprite LoadNewSprite(string FilePath, float PixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
24.     {    
25.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
26.         Texture2D SpriteTexture = LoadTexture(FilePath);
27.         Sprite NewSprite = Sprite.Create(SpriteTexture, new Rect(0, 0, SpriteTexture.width, SpriteTexture.height), new Vector2(0, 0), PixelsPerUnit, 0, spriteType);
28.         return NewSprite;
29.     }
30.     public Texture2D LoadTexture(string FilePath)
31.     {
32.         // Load a PNG or JPG file from disk to a Texture2D
33.         // Returns null if load fails
34.         Texture2D Tex2D;
35.         byte[] FileData;
36.         if (File.Exists(FilePath))
37.         {
38.             FileData = File.ReadAllBytes(FilePath);
39.             Tex2D = new Texture2D(2, 2);           // Create new "empty" texture
40.             if (Tex2D.LoadImage(FileData))           // Load the imagedata into the texture (size is set automatically)
41.                 return Tex2D;                 // If data = readable -> return texture
42.         }
43.         return null;                     // Return null if load failed
44.     }
45. }

 

You can call the script and assign the return sprite to a sprite renderer:

Code (CSharp):

1. public class LoadSprite : MonoBehaviour
2. {
3.     [SerializeField]
4.     private SpriteRenderer spriteRenderer;
5.  
6.     private void Start()
7.     {
8.         spriteRenderer.sprite = IMG2Sprite.instance.LoadNewSprite("C:\image.png");
9.     }
10. }

I didn't test the script but you should understand how to use it.

And by convention I prefer to use PascalCase for public field and camelCase for private field, local field and method parameter. Here's the updated version of the script:

Code (CSharp):

1. using UnityEngine;
2. using System.Collections;
3. using System.IO;
4. public class IMG2Sprite : MonoBehaviour
5. {
6.     // This script loads a PNG or JPEG image from disk and returns it as a Sprite
7.     // Drop it on any GameObject/Camera in your scene (singleton implementation)
8.     //
9.     // Usage from any other script:
10.     // MySprite = IMG2Sprite.instance.LoadNewSprite(FilePath, [PixelsPerUnit (optional)])
11.     private static IMG2Sprite _instance;
12.     public static IMG2Sprite Instance
13.     {
14.         get
15.         {
16.             //If _instance hasn't been set yet, we grab it from the scene!
17.             //This will only happen the first time this reference is used.
18.             if (_instance == null)
19.                 _instance = GameObject.FindObjectOfType<IMG2Sprite>();
20.             return _instance;
21.         }
22.     }
23.     public Sprite LoadNewSprite(string filePath, float pixelsPerUnit = 100.0f, SpriteMeshType spriteType = SpriteMeshType.Tight)
24.     {
25.         // Load a PNG or JPG image from disk to a Texture2D, assign this texture to a new sprite and return its reference
26.         Texture2D spriteTexture = LoadTexture(filePath);
27.         Sprite newSprite = Sprite.Create(spriteTexture, new Rect(0, 0, spriteTexture.width, spriteTexture.height), new Vector2(0, 0), pixelsPerUnit, 0, spriteType);
28.         return newSprite;
29.     }
30.     public Texture2D LoadTexture(string filePath)
31.     {
32.         // Load a PNG or JPG file from disk to a Texture2D
33.         // Returns null if load fails
34.         Texture2D tex2D;
35.         byte[] fileData;
36.         if (File.Exists(filePath))
37.         {
38.             fileData = File.ReadAllBytes(filePath);
39.             tex2D = new Texture2D(2, 2);           // Create new "empty" texture
40.             if (tex2D.LoadImage(fileData))           // Load the imagedata into the texture (size is set automatically)
41.                 return tex2D;                 // If data = readable -> return texture
42.         }
43.         return null;                     // Return null if load failed
44.     }
45. }

 

While we're necro-ing eight year old threads to pour in code examples, I'll add my solution.

See the

Bitmap2Grid

scene in my MakeGeo project.

This is made from this texture .........



MakeGeo is presently hosted at these locations:

https://bitbucket.org/kurtdekker/makegeo

https://github.com/kurtdekker/makegeo

https://gitlab.com/kurtdekker/makegeo

https://sourceforge.net/p/makegeo