Skip to content

elringus/sprite-glow

Repository files navigation

Installation

Use UPM to install the package via the following git URL: https://github.com/elringus/sprite-glow.git#package or download and import SpriteGlow.unitypackage manually.

Description

The glow effect is achieved using sprite outline in HDR colors (applied via shader) and bloom post-processing.

Glow Intensity Glow Color

For the bloom effect Unity Post Processing Stack (PPS) is used. You can replace it with similar 3rd-party solutions.

The effect is compatible with the Universal Render Pipeline (URP, aka LWRP). Bloom should be configured via URP's own post-processing solution; don't forget to enable HDR in the pipeline asset settings.

Character sprite by Mikhail Pigichka.

FAQ

Can I use the effect with components other than SpriteRenderer (UI Image, Tilemap, etc)?

Not directly (after all, this is SpriteGlow), but it's possible if the component is using a shader similar to sprites (e.g UI objects, tilemaps and other "2D" stuff). For this you will have to create a material based on the Sprites/Outline shader and manually apply it to the component. You can then control all the glow parameters using the material editor. In the project you can find scenes with the examples for applying the effect to UI Button and a tilemap.

Why doesn't the glow appear?

Make sure:

  • A bloom post-processing effect is enabled (you can use any, eg the one from Unity's PPS). Be aware, that universal render pipeline (URP/LWRP) only supports built-in post-processing, third-party solutions (including PPS) won't work with it.

  • HDR is enabled for target platform and tier (Edit > Project Settings > Graphics):

  • Camera 'Allow HDR' is enabled:

  • You've set 'Glow Brightness' high enough:

Why does the glow appear on the whole image?

Make sure 'Threshold' value of the bloom image effect is set high enough. It's usually 1 to 1.5, depending on the bloom solution.

Why do I get a NullReferenceException in build?

Most likely the outline shader is not included to the build (it happens when none of the included assets reference SpriteGlow component directly). You can force-include the shader by assigning it to the "Always Included Shaders" in Edit -> Project Settings -> Graphics.

It's still not working!

Make sure you're using a compatible Unity version; supported versions per release are available on the releases page.

Download (clone) this repository and examine the example scenes, comparing them with your setup. Chances are, you've misconfigured something.

In case nothing of the above helps, check the active issues or open a new one. Don't forget to include the full error log, detailed information about your system, Unity version, package version and steps required to reproduce the issue.