Sprite Masks are used to either hide or reveal parts of a Sprite or group of Sprites. The Sprite Mask only affects objects using the Sprite Renderer Component.
Creating a Sprite Mask
To create a Sprite Mask select from the main menu GameObject > 2D Object > Sprite Mask.
Properties
Property
Function
Sprite
The sprite to be used as a mask.
Alpha Cutoff
If the alpha contains a blend between transparent and opaque areas, you can manually determine the cutoff point for which areas will be shown. You change this cutoff by adjusting the Alpha Cutoff slider.
Range Start
The Range Start is the Sorting Layer which the mask starts masking from.
Sorting Layer
The Sorting Layer for the mask.
Order in Layer
The order within the Sorting Layer.
Range End
Mask All
By default the mask will affect all sorting layers behind it (lower sorting order).
Custom
The range end can be set to a custom Sorting Layer and Order in Layer.
Using Sprite Masks
The Sprite Mask GameObject itself will not be visible in scene, only the resulting interactions with Sprites. To view Sprite Masks in the scene, select the Sprite Mask option in the Scene Menu.
Sprite Masks are always in effect. Sprites to be affected by a Sprite Mask need to have their Mask Interaction set in the Sprite Renderer.
By default a Sprite Mask will affect any sprite in the scene that has their Mask Interaction set to Visible or Not Visible Under Mask. Quite often we want the mask to only affect a particular sprite or a group of sprites.
One method of ensuring the mask is interacting with particular sprites is to use a Sorting Group Component.
An alternative method of controlling the effect of the mask is to use the Custom Range Settings of a Sprite Mask.
The Range Start and Range End provides the ability to selectively mask sprites based on their Sorting Layer or Order in Layer.
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
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.
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:
Thanks for helping to make the Unity documentation better!