Version: 2020.2
Sprite Masks
Master and Variant Sprite Atlases

Sprite Atlas

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 Asset 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.

Sprite Atlas Inspector window
Sprite Atlas Inspector window

Sprite Atlas properties

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. For more information, see the Generate Mip Maps Texture import option.
sRGB Check this box to store Textures in gamma space. For more information, see the sRGB (Color Texture) Texture import option.
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. For more information, see the Filter Mode Texture import option.
Default (Platform-specific overrides panel on the Texture Import Settings window) Sets the resolution, the file size with associated memory size requirements, the pixel dimensions, and the quality of your Textures for each target platform of the Sprite Atlas. This panel lets you override these settings on the individual Textures that the Sprite Atlas contains. For more information, see Platform-specific overrides.
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.

  • New in Unity 2017.1 NewIn20171
Sprite Masks
Master and Variant Sprite Atlases