Version: 2023.2
Language : English
Sort sprites
Sprite Creator

Sprite Renderer

Switch to Scripting

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
Renderer
component renders the Sprite 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.

When you create a sprite (GameObject > 2D Object > Sprite), Unity automatically creates a GameObject with the Sprite Renderer component attached. You can also add the component to an existing GameObject via the Components menu (Component > Rendering > Sprite Renderer).

Properties

Sprite Renderer Inspector
Sprite Renderer Inspector
Property Function
Sprite Define which sprite texture the component should render. Click the circle icon to the right to open the object picker window, and select from the list of available sprite assets.
Open Sprite Editor Click this button to open the Sprite Editor window to edit the currently selected sprite. Note: If the 2D Sprite package isn’t installed, a button to install the 2D Sprite package will be available instead.
Color Define the vertex color of the sprite, which tints or recolors the Sprite’s image. Use the color picker to set the vertex color of the rendered sprite texture. See the Color section below this table for examples.
Flip Flips the sprite texture along the checked axis. This doesn’t flip the Transform position of the GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary
.
Material Define the Material used to render the sprite texture.
Draw Mode Define how the sprite scales when its dimensions change. Select one of the following options from the drop-down box.
Simple The entire image scales when its dimensions change. This is the default option.
Sliced Select this mode if the sprite is 9-sliced.
Size Enter the sprite’s new Width and Height to scale the 9-sliced sprite. You can also use the Rect Transform Tool to scale the sprite while applying 9-slicing properties.
Tiled By default, this mode causes the middle of the 9-Sliced sprite to tile instead of scale when its dimensions change. Use Tile Mode to control the tiling behavior of the sprite.
Continuous This is the default Tile Mode. In Continuous mode, the midsection tiles evenly when the sprite dimensions change.
Adaptive In Adaptive mode, the sprite texture stretches when its dimensions change, similar to Simple mode. When the scale of the changed dimensions meets the Stretch Value, the midsection begins to tile.
Stretch Value (available when Adaptive is selected) Use the slider to set the value between 0 and 1. The max value is 1, which represents double the original Sprite’s scale.
Mask Interaction Set how the Sprite Renderer behaves when interacting 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 Renderer doesn’t interact with any Sprite Masks in the Scene. This is the default option.
Visible Inside Mask The sprite is visible where the Sprite Mask overlays it, but not outside of it.
Visible Outside Mask The sprite is visible outside of the Sprite Mask, but not inside it. The Sprite Mask hides the sections of the sprite it overlays.
Sprite Sort Point Choose between the Sprite’s Center or its Pivot Point when calculating the distance between the sprite and the cameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
See in Glossary
. See the section on Sprite Sort Point for further details.
Center Select this to have Unity measure the distance between the camera’s Transform position and the Center of the sprite to determine its render order.
Pivot Select the Pivot option. Edit the sprite’s Pivot position in the Sprite Editor.
Material Select the material for newly created sprites. The default material is Sprites - Default. Click the circle icon to open the object picker window and select other materials. Tip: Lighting doesn’t affect this default sprite material. To have the sprite react to lighting, use the object picker window and select the Default - Diffuse material instead.
Additional settings
Sorting Layer Set the Sorting Layer of the sprite, which controls its priority during rendering. Select an existing Sorting Layer from the drop-down box, or create a new Sorting Layer.
Default The default layer the sprite is on.
Add Sorting Layer ⋮ Select this to create a new sorting layer for the selected sprite.
Order In Layer Set the render priority of the sprite within its Sorting Layer. Lower numbered Sprites are rendered first, with higher numbered Sprites overlapping those below.

Installing the 2D Sprite package

If the 2D Sprite package isn’t installed, the following option will be available in the Sprite Renderer InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
window.

Click on Install 2D Sprite Package to install the 2D Sprite package. Upon installing the package, the “Open Sprite Editor” button becomes available.

Click on Open Sprite Editor to open the Sprite Editor window. The sprite assigned to the selected Sprite Renderer is automatically selected and opened in the Sprite Editor window for you to edit.

Color

The image below demonstrates the effect of changing the RGB values on the Sprite Renderer’s Color setting. To change a Sprite’s opacity, change the value of its Color property’s Alpha (A) channel.

Left: The original Sprite. Right: The Sprite with its RGB colors set to red.
Left: The original Sprite. Right: The Sprite with its RGB colors set to red.

Mask Interaction

Mask Interaction controls how the Sprite Renderer interacts with Sprite Masks. Select either Visible Inside Mask or Visible Outside Mask from the drop-down menu. The examples below demonstrate the effect of each option with a square Sprite and a circle Mask:

To interact with a Sprite Mask, select Visible Inside Mask or Visible Outside Mask from the drop-down menu.

With Visible Inside Mask With Visible Outside Mask

Sprite Sort Point

This property is only available when the Sprite Renderer’s Draw Mode is set to Simple.

In a 2D project, the Main Camera is set to Orthographic Projection mode by default. In this mode, Unity renders Sprites in the order of their distance to the camera, along the direction of the Camera’s view.

Orthographic Camera: Side view (top) and Game view (bottom)
Orthographic Camera: Side view (top) and Game view (bottom)

By default, a Sprite’s Sort Point is set to its Center, and Unity measures the distance between the camera’s Transform position and the Center of the Sprite to determine their render order.

To set to a different Sort Point from the Center, select the Pivot option. Edit the Sprite’s Pivot position in the Sprite Editor.


  • 2018–10–05 Added definition for new functionality.
  • Ability to sort Sprite-based renderers using the pivot position added in 2017.3 New in 2017.3

SpriteRenderer

Sort sprites
Sprite Creator