The Sprite Shape Renderer component renders the geometry that Unity generates along a Spline and controls how it visually appears in a SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary for both 2D and 3D projects. Its inputs are derived from the Sprite Shape Profile.
Property | Function |
---|---|
Color | Define the vertex color of the 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 Shape geometry, which tints or recolors the Sprite Shape. Use the color picker to set the vertex. See the Color section below this table for examples. |
Mask Interaction | Set how the Sprite RendererA component that lets you display images as Sprites for use in both 2D and 3D scenes. More info See in Glossary behaves when it interacts with a Sprite MaskA texture which defines which areas of an underlying image to reveal or hide. More info See in Glossary . See examples of the different options in the Mask Interaction section below. |
None | The Sprite Shape Renderer does not interact with any Sprite Masks in the Scene. This is the default option. |
Visible Inside Mask | The Sprite Shape is visible where the Sprite Mask overlays it, but not outside of it. |
Visible Outside Mask | The Sprite Shape is visible outside of the Sprite Mask, but not inside it. The Sprite Mask hides the sections of the Sprite Shape it overlays. |
Sorting Layer | Set the Sorting Layer of the Sprite Shape geometry, which controls its priority during renderingThe process of drawing graphics to the screen (or to a render texture). By default, the main camera in Unity renders its view to the screen. More info See in Glossary. Select an existing Sorting Layer from the drop-down box, or create a new Sorting Layer. |
Order In Layer | Set the render priority of the Sprite Shape within its Sorting Layer. Lower numbered Sprite Shapes are rendered first, with higher numbered Sprite Shapes overlapping those below. |
The examples below show what happens when you change the RGB values on the Sprite Shape Renderer’s Color setting. To change a Sprite Shape’s opacity, change the value of the Alpha (A) channel, where lower values make the Sprite appear more transparent and higher values make the Sprite appear more opaque.
Use a Material’s Material and Shader settings to control how Unity renders Fill and Edge geometries. The default Material for a new Sprite Shape is ‘Sprites - Default’. Scene lighting does not affect this default Sprite Shape. To make the Sprite react to lighting, assign the Material ‘Default - Diffuse’ instead. To do this, click the small circle next to the Material field to bring up the Object Picker window, and select the ‘Default-Diffuse’ Material. Refer to Materials, Shaders & Textures for more information on these settings.
Mask Interaction controls how the Sprite Shape Renderer interacts with Sprite Masks. Select either Visible Inside Mask or Visible Outside Mask from the Mask Interaction drop-down menu. The examples below show the effect of either option:
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?
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.
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:
Thanks for helping to make the Unity documentation better!