Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elringus/sprite-glow
Sprite glow effect for Unity via HDR outline and bloom post-processing
https://github.com/elringus/sprite-glow
2d shader shaders sprite unity unity3d unity3d-plugin unitypackage vfx
Last synced: about 1 month ago
JSON representation
Sprite glow effect for Unity via HDR outline and bloom post-processing
- Host: GitHub
- URL: https://github.com/elringus/sprite-glow
- Owner: elringus
- License: mit
- Created: 2016-09-08T20:48:21.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-01-19T17:07:04.000Z (10 months ago)
- Last Synced: 2024-10-11T12:03:02.999Z (about 1 month ago)
- Topics: 2d, shader, shaders, sprite, unity, unity3d, unity3d-plugin, unitypackage, vfx
- Language: ShaderLab
- Homepage:
- Size: 34.8 MB
- Stars: 2,258
- Watchers: 74
- Forks: 202
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-unity3d - SpriteGlow - A sprite glow effect for Unity game engine (Open Source Repositories / Effect and Shaders)
README
## Installation
Use [UPM](https://docs.unity3d.com/Manual/upm-ui.html) to install the package via the following git URL: `https://github.com/elringus/sprite-glow.git#package` or download and import [SpriteGlow.unitypackage](https://github.com/elringus/sprite-glow/raw/master/SpriteGlow.unitypackage) manually.
## Description
The glow effect is achieved using sprite outline in HDR colors (applied via shader) and bloom post-processing.
For the bloom effect [Unity Post Processing Stack (PPS)](https://github.com/Unity-Technologies/PostProcessing) is used. You can replace it with similar 3rd-party solutions.
The effect is compatible with the [Universal Render Pipeline (URP, aka LWRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest). Bloom should be configured via [URP's own post-processing solution](https://docs.unity3d.com/Packages/[email protected]/manual/integration-with-post-processing.html); don't forget to enable HDR in the pipeline asset settings.
Character sprite by [Mikhail Pigichka](https://www.facebook.com/hundewache).
## FAQ
### Can I use the effect with components other than SpriteRenderer (UI Image, Tilemap, etc)?
Not directly (after all, this is **Sprite**Glow), 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](https://docs.unity3d.com/Manual/PostProcessing-Bloom.html)). Be aware, that **universal render pipeline (URP/LWRP) only supports [built-in post-processing](https://docs.unity3d.com/Packages/[email protected]/manual/integration-with-post-processing.html)**, 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](https://github.com/elringus/sprite-glow/releases).
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](https://github.com/elringus/sprite-glow/issues) or open a new one. Don't forget to include the full [error log](https://docs.unity3d.com/Manual/LogFiles.html), detailed information about your system, Unity version, package version and steps required to reproduce the issue.