bevy_retrograde 0.2.0

Pixel-Perfect, 2D Renderer and plugins for Bevy that Seamlessly Targets Desktop and Web
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

# Bevy Retrograde Examples

## Running Examples

We use the [just] for automating our development tasks and the project `justfile` includes tasks for
running the examples for web or native:

```bash
# Run native example
just run-example audio # or any other example name

# Run web example
just run-example-web collisions

# If you are running a native example you can also just use cargo
# ( this will not work for web examples )
cargo run --example ui
```

When running the web examples it will try to use [`basic-http-server`] to host the example on port
<http://localhost:4000>. You can install [`basic-http-server`] or you can modify the justfile to use
whatever your favorite development http server is.

[just]: https://github.com/casey/just
[`basic-http-server`]: https://github.com/brson/basic-http-server

## Full List

### [hello_world]

A good intro into Bevy Retrograde that also shows how to use the hierarchy system.

![hello_world](./screenshots/hello_world.gif)

[hello_world]: ./hello_world.rs

### [spritesheet]

An example of how to use animated sprite sheets.

![spritesheet](./screenshots/spritesheet.gif)

[spritesheet]: ./spritesheet.rs

### [physics_character]

An example demonstrating how to use the physics system to create collision boxes from sprites and
how to do simple character movement.

![physics_character](./screenshots/physics_character.gif)

[physics_character]: ./physics_character.rs

### [physics_map]

An example demonstrating how to create collision shapes for an LDtk map.

![physics_map](./screenshots/physics_map.gif)

[physics_map]: ./physics_map.rs

### [text]

An example showing how to render text using BDF font files.

> **Note:** This example shows how to render text, _without_ using the UI system, by creating text
> entities. This doesn't allow you to do any sort of layout other than positioning the text in the
> scene like you would any sprite. See the UI example below to see how to use the UI system to
> render text.

![text](./screenshots/text.png)

[text]: ./text.rs

### [ldtk_map]

An example showing you how to load and display an LDtk map file.

![ldtk map](./screenshots/ldtk_map.png)

[ldtk_map]: ./ldtk_map.rs

### [ui]

An example demonstrating the [RAUI] UI integration. It shows how to create UI elements that can
resize with the screen and how to create theme-able buttons and interact with the ECS world from the
UI.

[raui]: https://raui-labs.github.io/raui/

![ui](./screenshots/ui.gif)

[ui]: ./ui.rs

### [audio]

An example demonstrating how to play sounds and play music on loop.

[audio]: ./audio.rs

### [post_processing]

An example demonstrating how to add post-processing, using either the built-in CRT or your own
custom shaders.

![post_processing](./screenshots/post_processing.png)

[post_processing]: ./post_processing.rs

### [epaint]

An example demonstrating how to use the [`epaint`](https://docs.rs/epaint) integration to draw
simple shapes for debug rendering.

![epaint](./screenshots/epaint.png)

[epaint]: ./epaint.rs

### [custom_rendering]

An advanced example that shows how to do fully custom rendering of your own objects. This utilizes
raw calls to the [Luminance] graphics API allowing you to render _any_ kind of object, even 3D if
you wanted to.

![custom_rendering](./screenshots/custom_rendering.gif)

[luminance]: https://github.com/phaazon/luminance-rs
[custom_rendering]: ./custom_rendering.rs

### [radishmark]

A bunnymark style benchmark that also demonstrates how to use the UI system to render
frames-per-second diagnostics.

![radishmark](./screenshots/radishmark.gif)

[radishmark]: ./radishmark.rs