Unity-SpriteAssist

ℹ️About

Unity-SpriteAssist is an Unity extension that assist Sprite's mesh creation more conveniently.

🖥️System Requirements

Unity 2021.3 LTS or later versions

📝Features

• Control Vertex Easily with a Sliderbar.
• Make a transparent, opaque, complex(transparent + opaque) mesh
• Convert Sprite to MeshRenderer Prefab

📷Screenshots

📦Installation

Unity Package Manager

You can add https://github.com/sr4dev/Unity-SpriteAssist.git?path=Assets/SpriteAssist to Package Manager.

OpenUPM

https://openupm.com/packages/com.sr4dev.unity-spriteassist/

openupm add com.sr4dev.unity-spriteassist

Manual installation

Clone or download this repository and copy Assets/SpriteAssist folder to your Unity project.

✏️How to use

• Select a Sprite asset in the Project window.
• Select a Mode and adjust parameters.

Mode

• Transparent Mesh: Default Mode. Allow alpha pixel.
• Opaque Mesh: Disallow alpha pixel. You can use the mesh for opaque shader.
• Complex: Separate area by alpha.
  • Alpha pixel is converted to Transparent Mesh area.
  • Non-alpha pixel is converted to Opaque Mesh area.
  • To Use Complex mode must be created Mesh Prefab.
  • Complex mode dose not override original Sprite mesh.

Parameter

• Detail: Density and accuracy of the mesh to the Sprite outline.
• Alpha Tolerance: Threshold for transparency considered when generating the outline.
• Detect Holes: Detect holes from outline.
• Edge Smoothing: Smoothing sharp edges.
• Non-zero Winding: Use Non-zero winding rule. Default Winding rule is even-odd.

Even-odd(left), Non-zero(right)

Wikipedia: Non-zero winding

Mesh Prefab

• Prefab: Linked Prefab with Sprite.
• Create/Remove: Create or remove a Prefab.
• Default Transparent Shader
• Default Opaque Shader

⚠️Caution!

AssetImporter.userData

This extension uses AssetImporter.userData of Texture asset. If your project already uses userData, it will be overridden.

Unity Document: AssetImporter.userData

Known Issues

• Does not support PSD file.
• Import time may be significantly longer or may not complete in Unity 6.

For other issues, please refer to the link. https://github.com/sr4dev/Unity-SpriteAssist/issues

🗺️Roadmap

• Support pre-packed Sprite.
• Support Sprite Mode: Multiple.
• Add Sprite Animation example.
• Add tutorial(pdf, movies...).
• Release to the Asset Store.

🔣License

MIT License

📚Library

• Triangulation: LibTessDotNet v1.1.13
• Polygon Clipping: Clipper v6.4.2

☕Donation