bevy_2d_screen_space_lightmaps 0.19.0

Lighting plugin for 2D games made in the Bevy engine. This plugin uses the screen space lightmaps technique
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


## 2D Screen Space Lightmaps for Bevy ##


Screen space light maps are one of the simplest lighting techniques for 2D.
Despite being simple, it can work really well for certain types of 2D games.

This library provides an implementation of this technique for the Bevy engine.
The library is made as a Bevy plugin.

You can find more details about the technique here: https://slembcke.github.io/2D-Lighting-Overview

_Screenshot from the example code:_

![sample_screenshot](/screenshot/screen_space_lightmaps_sample.png)

### Technical Details ###


The plugin uses three cameras: 
1. One for rendering normal sprites.
2. One for rendering the light map.
3. One for the final image.

The first two cameras render to a texture. 
These two textures are then multiply-blended and used as the material 
for a rectangle that fits the screen space. 
This rectangle is rendered to the screen by the third camera. 

To use the plugin, you just need to:
1. Attach all your normal sprites to the CAMERA_LAYER_SPRITE render layer.
2. Attach your light sprites to the CAMERA_LAYER_LIGHT render layer.

Note that the clear color set on the light camera determines the level 
of ambient light in your scene.
The plugin provides a resource `LightmapPluginSettings` with which you can 
change the ambient light setting, the clear color on the sprite camera 
as well as the bloom intensity.

See the example code in `examples/moving_truck.rs` for details.  
Note that in the example you can zoom in-out using the mouse wheel.  
To run the example use: `cargo run --example moving_truck`

### Bevy Compatibility ###


| Bevy   | bevy_2d_screen_space_lightmaps |
|--------|--------------------------------|
| 0.19.x | 0.19.0                         |
| 0.18.x | 0.18.0                         |
| 0.17.x | 0.17.1                         |
| 0.17.x | 0.17.0                         |
| 0.16.x | 0.16.0                         |
| 0.15.x | 0.15.0                         |
| 0.14.x | 0.14.0                         |
| 0.13.x | 0.13.1                         |
| 0.13.0 | 0.13.0                         |

#### Credits ####

Some of the code was borrowed from https://github.com/zaycev/bevy-magic-light-2d

The sample uses some assets made by beeler, Gif and Icons8.