content/projects/bevy_outline_post_process/index.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

+++
title = "bevy_outline_post_process"
[taxonomies]
categories = ["bevy plugin"]
languages = ["rust", "wgsl"]
[extra]
github = ["exvacuum/bevy_outline_post_process"]
crates = ["bevy_outline_post_process"]
+++

this plugin allows you to add outlines to a camera as a post-processing effect in the bevy engine

![0.1 threshold, 2.0 thickness](threshold_10.png)

the effect makes use of a normal prepass to determine surface normals of objects in view, and then uses the differences between those normal values to determine where outlines should occur

the effect is configurable, you can change the thickness of the outlines and the threshold (how significant the difference between normals need to be for an outline to appear)

![0.1 threshold, 1.0 thickness](threshold_10_thin.png)
![0.1 threshold, 4.0 thickness](threshold_10_thick.png)

there's also an option to enable *adaptive outlines*, so that darker areas get outlined with white and brighter areas are outlined with black

![adaptive](threshold_10_adaptive.png)

i created this effect to improve visual contrast in my [white (I)](@/projects/white_I/index.md) project, which is why i haven't added support for different colors

you're free to add it yourself though, probably wouldn't be too hard