Importer features
Default Texture settings
The Aseprite Importer sets the following default settings to the generated texture:
- Texture type: Sprite
- Sprite mode: Multiple
- Pixel per unit: 100
- Mesh type: Tight
- Wrap mode: Clamp
- Filter mode: Point
- Compression: None
- Generate Mip Maps: False
Aseprite Importer Inspector properties
The Aseprite Importer is available after you import a .ase/.aseprite file into your Project.
Aseprite Importer Inspector properties
General
Property | Description | |
---|---|---|
Import Mode | How the file should be imported. This is set to Animated Sprite by default. | |
Sprite Sheet | The file is imported as a Sprite Sheet, and can be sliced up in the Sprite Editor. | |
Animated Sprite | The file is imported with animation in mind. Animation assets are generated and attached to a model prefab on import. | |
Pixels Per Unit | Sets the number of pixels that equals one Unity unit. | |
Mesh Type | Sets the Mesh type that Unity generates for the Sprite. This is set to Tight by default. | |
Full Rect | Unity maps the Sprite onto a rectangular Mesh. | |
Tight | Unity generates a Mesh based on the outline of the Sprite. If the Sprite is smaller than 32 x 32 pixels, Unity always maps it onto a Full Rect quad Mesh, even if you select Tight. | |
Generate Physics Shape | Generates a default physics shape from the outline of the Sprite/s when a physics shape has not been set in the Sprite Editor. |
Layer import
Property | Description | |
---|---|---|
Include Hidden Layers | Enable this property to include the hidden layers of the .ase/.asperite file in the import. This property is set to False by default. | |
Import Mode | Use this property to specify how the layers from the source file are imported. This property is set to Merge Frame by default. | |
Individual Layers | Every layer per frame generates a Sprite. | |
Merge Frame | This is the default option. All layers per frame are merged into one Sprite. | |
Pivot Space | Select the space pivots should be calculated in. This property is set to Canvas by default. | |
Canvas | Calculate the pivot based on where the Sprite is positioned on the source asset's canvas. This is useful if the Sprite is being swapped out in an animation. | |
Local | This is the normal pivot space used when importing a standard image in Unity. | |
Pivot Alignment | How a Sprite's graphic rectangle is aligned with its pivot point. This property is set Bottom by default. | |
Mosaic Padding | External padding between each SpriteRect. This property is set 4 pixels by default. | |
Sprite Padding | Internal padding within each SpriteRect. This property is set 0 pixels by default. |
Generate assets
Property | Description | |
---|---|---|
Model Prefab | Enable this property to generate a model prefab setup to look like the first frame in Aseprite. This property is set to True by default. | |
Sorting Group | Add a Sorting Group component to the root of the generated model prefab if it has more than one Sprite Renderer. This property is set to True by default. | |
Shadow Casters | Enable this property to add Shadow Casters to all GameObjects with a SpriteRenderer. This property is set to False by default. Note that this checkbox is only available in Unity 2023.1 and newer. | |
Animation Clips | Enable this property to generate Animation Clips based on the frame data in the file. Every tag in Aseprite generates one Animation Clip. If no tag is present, one Animation Clip is generated which covers all frames in the file. The Animation speed is based on the Constant Frame Rate defined in Aseprite. The length is based on the number of frames included in the tag/file. This property is set to True by default. | |
Export Animation Assets | The Animator Controller and the Animation Clips are generated as Read Only assets. This option can be used to export editable versions of these assets. |
Aseprite Importer Preferences
The Aseprite Importer Preferences can be found at Unity > Settings > 2D > Aseprite Importer.
Aseprite Importer Preferences
Property | Description | |
---|---|---|
Background import | Enable this property to enable asset import when the Unity Editor is in the background. This property is set to True by default. |