Specify the import settings for this texture when its Texture Type is set to Sprite (2D and UI).
The Sprite (2D and UI) texture type formats the texture asset so that it’s suitable to use in 2D features as a SpriteA 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. Unity automatically locks Texture Shape to 2D for this texture type.
Property | Description | |
---|---|---|
Sprite Mode | Specifies how to extract the sprite graphic from the image. | |
Single | Use the sprite image as is. You can clip and edit the image in the Sprite Editor to refine it further, but Unity treats the Sprite generated from the texture source file as a single asset. | |
Multiple | Choose this value if the texture source file has several elements in the same image. You can then define the location of the elements in the Sprite Editor so that Unity knows how to split the image into different sub-assets. For example, you can create animation frames from a single sheet with multiple poses, create TilesA simple class that allows a sprite to be rendered on a Tilemap. More info See in Glossary from a single Tilesheet, or create the different parts of a character. |
|
Polygon | Choose this value to clip the sprite texture according to the mesh defined in the Sprite Editor’s Sprite Custom Outline. | |
Pixels Per Unit | The number of pixels of width/height in the Sprite image that correspond to one distance unit in world space. | |
Mesh Type | Specifies the mesh type for the sprite asset you want Unity to generate. This property is visible only when |
|
Full Rect | Choose this value to create a quad (four-sided polygon) to map the Sprite onto. | |
Tight | Choose this value to generate a Mesh based on pixel alpha value. The Mesh that Unity generates generally follows the shape of the Sprite. Note: Any Sprite that’s smaller than 32x32 uses Full Rect, even when Tight is specified. |
|
Extrude Edges | Controls how much area to leave around the Sprite in the generated Mesh. | |
Pivot | The location in the image where the sprite’s local coordinate system originates. Choose one of the pre-set options, or select Custom to set your own Pivot location in X and Y. This property is visible only when Sprite Mode is set to Single. |
|
Generate Physics Shape | Indicates whether to generate a default Physics Shape from the outline of the sprite if you don’t define a Custom Physics Shape. This property is only visible when you set Sprite Mode to Single or Multiple. |
|
Open Sprite Editor | Open the Sprite Editor which you can use to define how you want Unity to separate the elements on an image with multiple Sprite Mode elements (to create sub-Assets) or refine the shape, size, and pivot position of a Polygon shape. This button only appears if your project uses the 2D Sprite package. For information about how to find and install packages in the Unity Package Manager, see Finding packages and Installing from the registry. This property is visible only when is set to . |
|
Install 2D Sprite Package | Installs the 2D Sprite package. The Open Sprite Editor button becomes visible after Unity installs the required package. This button only appears if your project currently doesn’t have the 2D Sprite package installed. |
|
sRGB (Color Texture) | Indicates whether the texture is in gamma space. Enable this property for non-HDR color textures such as albedo and specular color. If the texture stores information that you need the exact value for, like smoothness or metalness values, disable this property. | |
Alpha Source | Specifies how Unity generates the alpha value for the texture asset from the texture source file. | |
None | The texture asset doesn’t have an alpha channel, whether or not the texture source file has one. | |
Input Texture Alpha | Unity applies the alpha channel from the texture source file to the texture asset, if the texture source file has an alpha channel. | |
From Gray Scale | Unity generates the alpha channel for the texture asset from the average values the texture source files RGB channels. | |
Alpha is Transparency | Indicates whether to dilate the color channels. This helps to avoid filtering artifacts on the edges of the alpha channel if the alpha channel represents transparency. | |
Remove PSD Matte | Indicates whether to apply special processing for Photoshop files that use transparency (blending color pixels with white). Note: This is only available for PSD files. |
|
Read/Write | Indicates whether to access the texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other TextureAn image used when rendering a GameObject, Sprite, or UI element. Textures are often applied to the surface of a mesh to give it visual detail. More info See in Glossary methods. Internally, Unity uses a copy of the Texture data for script access, which doubles the amount of memory required for the Texture. This property is therefore disabled by default, and you should enable it only if you require script access. For more information, see Texture.isReadable. |
|
Generate Mipmap | Indicates whether to generate a mipmap for this texture. | |
Mipmap Limit | Disable this option to use all mipmap levels, regardless of the Mipmap Limit settings in the Quality menu. This property only appears if you set Texture Shape to 2D or 2D Array. Other texture shapes always use all mipmap levels. | |
Mipmap Limit Group | Select the Mipmap Limit group this texture should be part of. The default option is None (Use Global Mipmap Limit). This property only appears if you set Texture Shape to 2D or 2D Array. Other texture shapes always use all mipmap levels. | |
Mipmap Filtering | Specifies the method Unity uses to filter mipmap levels and optimize image quality. This property is visible only when Generate Mipmap is set to true. |
|
Box | Makes mipmap levels smoother as they decrease in dimension size. | |
Kaiser | Runs a sharpening algorithm on mipmap levels as they decrease in dimension size. Use this option if your textures are too blurry when far away. The algorithm is of the Kaiser Window type. For more information, see Wikipedia. | |
Preserve Coverage | Indicates whether the alpha channel in generated mipmaps preserves coverage during the alpha text. For more information, see TextureImporterSettings.mipMapsPreserveCoverage. This property is visible only when Generate Mipmap is set to true. |
|
Alpha Cutoff | The reference value that controls the mipmap coverage during the alpha test. This property is visible only when Preserve Coverage is set to true. |
|
Replicate Border | Indicates whether to stop colors bleeding out to the edge of the lower mipmap levels. This is useful for light cookies. This property is visible only when Generate Mipmap is set to true. |
|
Fadeout to Gray | Indicates whether mipmap levels should fade to gray as the mipmap levels progress. This is useful for detail maps. The left-most scroll is the first mipmap level to begin fading out. The right-most scroll defines the mipmap level where the texture is completely grayed out. This property is visible only when Generate Mipmap is set to true. |
|
Ignore PNG Gamma | Indicates whether to ignore the gamma attribute in PNG files. This option is only visible if the texture source file is a PNG. |
|
Wrap Mode | Specifies how the texture behaves when it tiles. | |
Repeat | Repeats the texture in tiles. | |
Clamp | Stretches the texture’s edges. | |
Mirror | Mirrors the texture at every integer boundary to create a repeating pattern. | |
Mirror Once | Mirrors the texture once, then clamps it to edge pixels. Note: Some mobile devices don’t support Mirror Once. In this case, Unity uses Mirror instead. |
|
Per-axis | Provides options you can use to individually control how Unity wraps textures on the U and V axis. | |
Filter Mode | Specifies how Unity filters the texture when the texture stretches during 3D transformations. | |
Point (no filter) | The texture appears blocky up close. | |
Bilinear | The texture appears blurry up close. | |
Trilinear | Like Bilinear, but the texture also blurs between the different mipmap levels. | |
Aniso Level | Controls the texture quality when you view the texture at a steep angle. Anisotropic filtering is good for floor and ground Textures but is resource intensive. For more information, see Importing textures. |
In addition, you can use the Platform-specific overrides panel to set default options and overrides for specific platforms.
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?
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:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
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.