A 2D Project uses SpritesA 2D graphic objects. If you are used to working in 3D, Sprites are essentially just standard textures but there are special techniques for combining and managing sprite textures for efficiency and convenience during development. More info
See in Glossary and other graphics to create the visuals of its ScenesA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary. This means a single Project might contain many Texture files. Unity normally issues a draw call for each Texture in the Scene; however, in a Project with many Textures, multiple draw calls become resource-intensive and can negatively impact the performance of your Project.
A Sprite Atlas is an AssetAny media or data that can be used in your game or Project. An asset may come from a file created outside of Unity, such as a 3D model, an audio file or an image. You can also create some asset types in Unity, such as an Animator Controller, an Audio Mixer or a Render Texture. More info
See in Glossary that consolidates several Textures into a single combined Texture. Unity can call this single Texture to issue a single draw call instead of multiple draw calls to access the packed Textures all at once at a smaller performance overhead. In addition, the Sprite Atlas API provides you with control over how to load the Sprite Atlases at your Project’s run time.
To create a Sprite Atlas, go to menu: Asset > Create > Sprite Atlas. Unity creates the Sprite Atlas in the Asset folder, with the file extension *.spriteatlas.
Property | Description |
---|---|
Type | Set the Sprite Atlas’ Type to either ‘Master’ or ‘Variant’. ‘Master’ is the default Type setting. When you set this property to Variant, Unity reveals additional property settings. Refer to documentation about Master and Variant Sprite Atlases for more information about the two types. |
Include in Build | Check this box to include the Sprite Atlas Asset in the current build. This option is enabled by default. |
Allow Rotation | Check this box to allow the Sprites to rotate when Unity packs them into the Sprite Atlas. This maximizes the density of Sprites in the combined Texture, and is enabled by default. Disable this option if the Sprite Atlas contains Canvas UI element Textures, as when Unity rotates the Textures in the Sprite Atlas during packing, it rotates their orientation in the Scene as well. |
Tight Packing | Check this box to pack Sprites based on their Sprite outlines instead of the default rectangle outline. This maximizes the density of Sprites in the combined Texture, and is enabled by default. |
Padding | Defines how many pixelsThe smallest unit in a computer image. Pixel size depends on your screen resolution. Pixel lighting is calculated at every screen pixel. More info See in Glossary are between the individual Sprite Textures in the Sprite Atlas. This is a buffer to prevent pixel overlap between Sprites that are next to each other in the Sprite Atlas. The default value is 4 pixels. |
Read/Write Enabled | Check this box to enable access to the Texture data from script functions (such as Texture2D.SetPixels, and other Texture2D functions). If you enable this property, Unity creates a copy of the Texture data. This doubles the amount of memory required for Texture Assets, and can negatively affect performance. This property is disabled by default. This property is only valid for uncompressed or DXT compressed Textures as Unity cannot read other types of compressed Textures. |
Generate Mip Maps | Check this box to enable mipmap generation. Refer to documentation on Texture types for more information. |
sRGB | Check this box to store Textures in gamma space. Refer to documentation on Importing Textures for more information. |
Filter Mode | Select how Unity filters packed Textures when they stretch during transformations. This setting overrides the Filter Mode setting of any packed Sprite in the Atlas. Refer to documentation on Texture types for more information. |
Default (Texture importer settings panel) | Sets the Texture Importer setting of the Sprite Atlas. This overrides the importer settings of the individual Textures that the Sprite Atlas contains. Refer to documentation on Texture Importer Override for more information. |
Objects For Packing | Unity packs all items in this list into the currently selected Sprite Atlas. Refer to documentation about Selecting items for the Objects for Packing list for more information. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thanks for helping to make the Unity documentation better!
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.