blob: a8e1687e4f1d033bf56046862cbd09f1a6b3b5a1 (
plain)
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
|
# grex_terminal_display
A (very experimental) plugin for the [Bevy](https://bevyengine.org) engine which allows for rendering to a terminal window.
WARNING: I highly recommend using the kitty terminal emulator with this, not only due to the gpu-accelerated rendering, but also the implementation of the kitty protocol which enables the advanced input detection.
Features Include:
- `TerminalDisplayBundle` automatically sets up a correctly-formatted render texture
- Post-process dithers colors to pure black and white, which are then printed as braille characters to the terminal
- Responsiveness to terminal window resizing
- `TerminalInput` resource which keeps track of pressed & released keys
- Keyboard input enhancements using kitty protocol
Future Goals:
- Find a way to integrate into a TUI library like ratatui for more interaction options.
- Move kitty enhancements to a feature maybe
## Screenshots
## Compatibility
| Crate Version | Bevy Version |
|--- |--- |
| 0.1 | 0.13 |
## Installation
### Using git URL in Cargo.toml
```toml
[dependencies.grex_terminal_display]
git = "https://github.com/exvacuum/grex_terminal_display.git"
```
## Example Usage
In `main.rs`:
```rs
use bevy::prelude::*;
use grex_terminal_display;
fn main() {
App::new()
.add_plugins((
DefaultPlugins.build().disable::<WinitPlugin>(),
ScheduleRunnerPlugin::run_loop(Duration::from_secs_f32(1.0 / 60.0)),
grex_terminal_display::TerminalDisplayPlugin,
))
.insert_resource(Msaa::Off) // For post-process
.run();
}
```
When spawning a camera:
```rs
let terminal_display_bundle = grex_terminal_display::components::TerminalDisplayBundle::new(3, &asset_server);
commands.spawn((
Camera3dBundle {
camera: Camera {
target: terminal_display_bundle.image_handle().into(),
..Default::default()
},
..Default::default()
},
terminal_display_bundle,
));
```
|
