bevy_fast_light 0.8.0

Simple 2D lighting for Bevy focused on performance over features.
Documentation 
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# Bevy Fast Light

[![License](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](https://github.com/leomeinel/bevy_fast_light)
[![Crates.io](https://img.shields.io/crates/v/bevy_fast_light.svg)](https://crates.io/crates/bevy_fast_light)
[![Downloads](https://img.shields.io/crates/d/bevy_fast_light.svg)](https://crates.io/crates/bevy_fast_light)
[![Docs](https://docs.rs/bevy_fast_light/badge.svg)](https://docs.rs/bevy_fast_light/latest/bevy_fast_light/)

Simple 2D lighting for Bevy focused on performance over features.

:warning: | This is still in development and not at all feature complete.

## Features

### Lights

| Purpose       | Component        | Config                                                           |
| ------------- | ---------------- | ---------------------------------------------------------------- |
| Ambient light | `AmbientLight2d` | `color` and `intensity`                                          |
| Mesh light    | `MeshLight2d`    | `color`, `intensity` and attached `Mesh2d` that determines shape |

### Occluders

| Purpose       | Component        | Config                                  |
| ------------- | ---------------- | --------------------------------------- |
| Mesh occluder | `MeshOccluder2d` | Attached `Mesh2d` that determines shape |

`Sprites` are rendered above occluders if they are on the same or a higher z-level. Also see [Showcase](#showcase).

## Limitations

- There is currently no shadow casting for light occluders.

## Usage

Take a look at [`/examples`](https://github.com/leomeinel/bevy_fast_light/tree/main/examples) to find out how to use this crate.

### Showcase

I am using most features in my learning project [Slimy Mist](https://github.com/leomeinel/slimy_mist) and have also successfully implemented a day/night cycle.

This also visualizes how `Sprites` are rendered above occluders if they are on the same or a higher z-level.

<img src="https://github.com/leomeinel/bevy_fast_light/blob/main/static/slimy_mist.webp?raw=true" width="400" alt="slimy mist example">

### Examples

#### `ambient_light.rs`

Scene with a light sky colored `AmbientLight2d` with a lower `intensity`, a green `Rectangle` as background and an amber `MeshLight2d`.

<img src="https://github.com/leomeinel/bevy_fast_light/blob/main/static/ambient_light.webp?raw=true" width="400" alt="ambient light example">

#### `mesh_light.rs`

Scene with a green `Rectangle` as background and an amber `MeshLight2d`.

<img src="https://github.com/leomeinel/bevy_fast_light/blob/main/static/mesh_light.webp?raw=true" width="400" alt="mesh light example">
    
#### `mesh_occluder.rs`

Scene with a light sky colored `AmbientLight2d` with a lower `intensity`, a green `Rectangle` as background, an amber `MeshLight2d` and a `MeshOccluder2d`.

<img src="https://github.com/leomeinel/bevy_fast_light/blob/main/static/mesh_occluder.webp?raw=true" width="400" alt="mesh occluder example">

#### `texture_scale.rs`

Scene with a green `Rectangle` as background and an amber `MeshLight2d` using a lower `texture_scale`.

<img src="https://github.com/leomeinel/bevy_fast_light/blob/main/static/texture_scale.webp?raw=true" width="400" alt="texture scale example">

## Alternatives

- [bevy_firefly](https://crates.io/crates/bevy_firefly)
- [bevy_2d_screen_space_lightmaps](https://crates.io/crates/bevy_2d_screen_space_lightmaps)
- [bevy_light_2d](https://crates.io/crates/bevy_light_2d)
- [bevy_lit](https://crates.io/crates/bevy_lit)

## Resources

### Code

- [Bevy Example - Custom Post Processing](https://bevy.org/examples/shaders/custom-post-processing/)
- [Bevy Example - Custom Render Phase](https://bevy.org/examples/shaders/custom-render-phase/)

### Articles

- [hackmd.io - Bevy's Rendering Crates](https://hackmd.io/@bevy/rendering_summary)
- [hackmd.io - The Abyss](https://hackmd.io/@bevy/the_abyss)
- [slembcke.net - 2D Lighting Techniques](https://www.slembcke.net/blog/2DLightingTechniques/)
- [slembcke.net - 2D Lighting with Hard Shadows](https://www.slembcke.net/blog/SuperFastHardShadows/)
- [WebGPU Shading Language](https://www.w3.org/TR/WGSL/)