docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Class AsepriteImporter

    ScriptedImporter to import Aseprite files

    Inheritance
    object
    Object
    AssetImporter
    ScriptedImporter
    AsepriteImporter
    Implements
    ISpriteEditorDataProvider
    Inherited Members
    AssetImporter.SetAssetBundleNameAndVariant(string, string)
    AssetImporter.GetAtPath(string)
    AssetImporter.SaveAndReimport()
    AssetImporter.AddRemap(AssetImporter.SourceAssetIdentifier, Object)
    AssetImporter.RemoveRemap(AssetImporter.SourceAssetIdentifier)
    AssetImporter.GetExternalObjectMap()
    AssetImporter.assetPath
    AssetImporter.importSettingsMissing
    AssetImporter.assetTimeStamp
    AssetImporter.userData
    AssetImporter.assetBundleName
    AssetImporter.assetBundleVariant
    Object.GetInstanceID()
    Object.GetHashCode()
    Object.Equals(object)
    Object.Instantiate(Object, Vector3, Quaternion)
    Object.Instantiate(Object, Vector3, Quaternion, Transform)
    Object.Instantiate(Object)
    Object.Instantiate(Object, Transform)
    Object.Instantiate(Object, Transform, bool)
    Object.Instantiate<T>(T)
    Object.Instantiate<T>(T, Vector3, Quaternion)
    Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
    Object.Instantiate<T>(T, Transform)
    Object.Instantiate<T>(T, Transform, bool)
    Object.Destroy(Object, float)
    Object.Destroy(Object)
    Object.DestroyImmediate(Object, bool)
    Object.DestroyImmediate(Object)
    Object.FindObjectsOfType(Type)
    Object.FindObjectsOfType(Type, bool)
    Object.FindObjectsByType(Type, FindObjectsSortMode)
    Object.FindObjectsByType(Type, FindObjectsInactive, FindObjectsSortMode)
    Object.DontDestroyOnLoad(Object)
    Object.DestroyObject(Object, float)
    Object.DestroyObject(Object)
    Object.FindSceneObjectsOfType(Type)
    Object.FindObjectsOfTypeIncludingAssets(Type)
    Object.FindObjectsOfType<T>()
    Object.FindObjectsByType<T>(FindObjectsSortMode)
    Object.FindObjectsOfType<T>(bool)
    Object.FindObjectsByType<T>(FindObjectsInactive, FindObjectsSortMode)
    Object.FindObjectOfType<T>()
    Object.FindObjectOfType<T>(bool)
    Object.FindFirstObjectByType<T>()
    Object.FindAnyObjectByType<T>()
    Object.FindFirstObjectByType<T>(FindObjectsInactive)
    Object.FindAnyObjectByType<T>(FindObjectsInactive)
    Object.FindObjectsOfTypeAll(Type)
    Object.FindObjectOfType(Type)
    Object.FindFirstObjectByType(Type)
    Object.FindAnyObjectByType(Type)
    Object.FindObjectOfType(Type, bool)
    Object.FindFirstObjectByType(Type, FindObjectsInactive)
    Object.FindAnyObjectByType(Type, FindObjectsInactive)
    Object.ToString()
    Object.name
    Object.hideFlags
    object.Equals(object, object)
    object.GetType()
    object.MemberwiseClone()
    object.ReferenceEquals(object, object)
    Namespace: UnityEditor.U2D.Aseprite
    Assembly: Unity.2D.Aseprite.Editor.dll
    Syntax
    [ScriptedImporter(21300004, new string[] { "aseprite", "ase" }, AllowCaching = true)]
    [HelpURL("https://docs.unity3d.com/Packages/com.unity.2d.aseprite@latest")]
    public class AsepriteImporter : ScriptedImporter, ISpriteEditorDataProvider

    Properties

    OnPostAsepriteImport

    Event that is fired at the last step of the Aseprite import process.

    Declaration
    public AsepriteImporter.AsepriteImportEventHandler OnPostAsepriteImport { get; set; }
    Property Value
    Type Description
    AsepriteImporter.AsepriteImportEventHandler

    addSortingGroup

    Add a Sorting Group component to the root of the generated model prefab if it has more than one Sprite Renderer.

    Declaration
    public bool addSortingGroup { get; set; }
    Property Value
    Type Description
    bool

    aniso

    Anisotropic filtering level of the texture.

    Declaration
    public int aniso { get; set; }
    Property Value
    Type Description
    int

    asepriteFile

    A parsed representation of the Aseprite file.

    Declaration
    public AsepriteFile asepriteFile { get; }
    Property Value
    Type Description
    AsepriteFile

    canvasSize

    The canvas size of the source file.

    Declaration
    public Vector2 canvasSize { get; }
    Property Value
    Type Description
    Vector2

    customPivotPosition

    Normalized position of the custom pivot.

    Declaration
    public Vector2 customPivotPosition { get; set; }
    Property Value
    Type Description
    Vector2

    filterMode

    Filtering mode of the texture.

    Declaration
    public FilterMode filterMode { get; set; }
    Property Value
    Type Description
    FilterMode

    generateAnimationClips

    Generate Animation Clips based on the frame data of the source asset.

    Declaration
    public bool generateAnimationClips { get; set; }
    Property Value
    Type Description
    bool

    generateModelPrefab

    Generate a Model Prefab based on the layers of the source asset.

    Declaration
    public bool generateModelPrefab { get; set; }
    Property Value
    Type Description
    bool

    generatePhysicsShape

    If enabled, generates a default physics shape from the outline of the Sprite/s when a physics shape has not been set in the Sprite Editor.

    Declaration
    public bool generatePhysicsShape { get; set; }
    Property Value
    Type Description
    bool

    importMode

    How the file should be imported.

    Declaration
    public FileImportModes importMode { get; set; }
    Property Value
    Type Description
    FileImportModes

    includeHiddenLayers

    Should include hidden layers from the source file.

    Declaration
    public bool includeHiddenLayers { get; set; }
    Property Value
    Type Description
    bool

    layerImportMode

    The import mode for all layers in the file.

    Declaration
    public LayerImportModes layerImportMode { get; set; }
    Property Value
    Type Description
    LayerImportModes

    mipMapBias

    Mip map bias of the texture.

    Declaration
    public float mipMapBias { get; set; }
    Property Value
    Type Description
    float

    mipMapsPreserveCoverage

    Enables or disables coverage-preserving alpha mipmapping.

    Enable this to rescale the alpha values of computed mipmaps so coverage is preserved. This means a higher percentage of pixels passes the alpha test and lower mipmap levels do not become more transparent. This is disabled by default (set to false).

    Declaration
    public bool mipMapsPreserveCoverage { get; set; }
    Property Value
    Type Description
    bool

    mipmapEnabled

    Generate Mip Maps.

    Select this to enable mip-map generation. Mipmaps are smaller versions of the Texture that get used when the Texture is very small on screen.

    Declaration
    public bool mipmapEnabled { get; set; }
    Property Value
    Type Description
    bool

    mipmapFadeDistanceEnd

    Mip level where texture is faded out completely.

    Declaration
    public int mipmapFadeDistanceEnd { get; set; }
    Property Value
    Type Description
    int

    mipmapFadeDistanceStart

    Mip level where texture begins to fade out.

    Declaration
    public int mipmapFadeDistanceStart { get; set; }
    Property Value
    Type Description
    int

    mipmapFilter

    Mip level where texture is faded out completely.

    Declaration
    public TextureImporterMipFilter mipmapFilter { get; set; }
    Property Value
    Type Description
    TextureImporterMipFilter

    mosaicPadding

    External padding between each SpriteRect, in pixels.

    Declaration
    public uint mosaicPadding { get; set; }
    Property Value
    Type Description
    uint

    pivotAlignment

    How a Sprite's graphic rectangle is aligned with its pivot point.

    Declaration
    public SpriteAlignment pivotAlignment { get; set; }
    Property Value
    Type Description
    SpriteAlignment

    pivotSpace

    The space the Sprite pivots are being calculated.

    Declaration
    public PivotSpaces pivotSpace { get; set; }
    Property Value
    Type Description
    PivotSpaces

    spriteExtrude

    The number of blank pixels to leave between the edge of the graphic and the mesh.

    Declaration
    public uint spriteExtrude { get; set; }
    Property Value
    Type Description
    uint

    spriteImportMode

    Selects Single or Manual import mode for Sprite textures.

    Declaration
    public SpriteImportMode spriteImportMode { get; set; }
    Property Value
    Type Description
    SpriteImportMode

    Valid values are SpriteImportMode.Multiple or SpriteImportMode.Single.

    Exceptions
    Type Condition
    ArgumentException

    Exception when non valid values are set.

    spriteMeshType

    Sets the type of mesh to ge generated for each Sprites.

    Declaration
    public SpriteMeshType spriteMeshType { get; set; }
    Property Value
    Type Description
    SpriteMeshType

    spritePadding

    Internal padding within each SpriteRect, in pixels.

    Declaration
    public uint spritePadding { get; set; }
    Property Value
    Type Description
    uint

    spritePixelsPerUnit

    The number of pixels in the sprite that correspond to one unit in world space.

    Declaration
    public float spritePixelsPerUnit { get; set; }
    Property Value
    Type Description
    float

    streamingMipmaps

    Enable mipmap streaming for the texture.

    Only load larger mipmaps as needed to render the current game cameras. Requires texture streaming to be enabled in quality settings.

    Declaration
    public bool streamingMipmaps { get; set; }
    Property Value
    Type Description
    bool

    streamingMipmapsPriority

    Mipmap streaming priority when there's contention for resources. Positive numbers represent higher priority. Valid range is -128 to 127.

    Declaration
    public int streamingMipmapsPriority { get; set; }
    Property Value
    Type Description
    int

    textureType

    Which type of texture are we dealing with here.

    Declaration
    public TextureImporterType textureType { get; set; }
    Property Value
    Type Description
    TextureImporterType

    Valid values are TextureImporterType.Default or TextureImporterType.Sprite.

    Exceptions
    Type Condition
    ArgumentException

    Exception when non valid values are set.

    wrapMode

    Texture coordinate wrapping mode.

    Using wrapMode sets the same wrapping mode on all axes. Different per-axis wrap modes can be set using wrapModeU, wrapModeV, wrapModeW. Querying the value returns the U axis wrap mode (same as wrapModeU getter).

    Declaration
    public TextureWrapMode wrapMode { get; set; }
    Property Value
    Type Description
    TextureWrapMode

    wrapModeU

    Texture U coordinate wrapping mode.

    Controls wrapping mode along texture U (horizontal) axis.

    Declaration
    public TextureWrapMode wrapModeU { get; set; }
    Property Value
    Type Description
    TextureWrapMode

    wrapModeV

    Texture V coordinate wrapping mode.

    Controls wrapping mode along texture V (vertical) axis.

    Declaration
    public TextureWrapMode wrapModeV { get; set; }
    Property Value
    Type Description
    TextureWrapMode

    wrapModeW

    Texture W coordinate wrapping mode for Texture3D.

    Controls wrapping mode along texture W (depth, only relevant for Texture3D) axis.

    Declaration
    public TextureWrapMode wrapModeW { get; set; }
    Property Value
    Type Description
    TextureWrapMode

    Methods

    GetImporterPlatformSettings(BuildTarget)

    Retrieves the platform settings used by the importer for a given build target.

    Declaration
    public TextureImporterPlatformSettings GetImporterPlatformSettings(BuildTarget buildTarget)
    Parameters
    Type Name Description
    BuildTarget buildTarget

    The build target to query.

    Returns
    Type Description
    TextureImporterPlatformSettings

    TextureImporterPlatformSettings used for importing the texture for the build target.

    OnImportAsset(AssetImportContext)

    This method must by overriden by the derived class and is called by the Asset pipeline to import files.

    Declaration
    public override void OnImportAsset(AssetImportContext ctx)
    Parameters
    Type Name Description
    AssetImportContext ctx

    This argument contains all the contextual information needed to process the import event and is also used by the custom importer to store the resulting Unity Asset.

    Overrides
    ScriptedImporter.OnImportAsset(AssetImportContext)

    SetImporterPlatformSettings(TextureImporterPlatformSettings)

    Sets the platform settings used by the importer for a given build target.

    Declaration
    public void SetImporterPlatformSettings(TextureImporterPlatformSettings setting)
    Parameters
    Type Name Description
    TextureImporterPlatformSettings setting

    TextureImporterPlatformSettings to be used by the importer for the build target indicated by TextureImporterPlatformSettings.

    SupportsRemappedAssetType(Type)

    Override this method if your ScriptedImporter supports remapping specific asset types.

    Declaration
    public override bool SupportsRemappedAssetType(Type type)
    Parameters
    Type Name Description
    Type type

    The type of asset to check.

    Returns
    Type Description
    bool

    Returns true if the importer supports remapping the given type. Otherwise, returns false.

    Overrides
    ScriptedImporter.SupportsRemappedAssetType(Type)

    Implements

    UnityEditor.U2D.Sprites.ISpriteEditorDataProvider
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)