4 releases (2 breaking)
0.4.0 | Apr 17, 2022 |
---|---|
0.3.1 | Apr 16, 2022 |
0.3.0 | Apr 16, 2022 |
0.2.1 | Apr 15, 2022 |
#216 in Visualization
210KB
691 lines
Pronto Graphics
|| Docs.rs || Lib.rs || Crates.io ||
A library for anyone who just wants to get some graphics on the screen, without having to faff about with the technical details of proper graphics libraries. Just create a window, and start drawing to it. Minimal setup, minimal bother, minimal interference with your own code's structure.
Loosely inspired by Processing.
Examples
You want some circles on the screen?
let mut pg = Window::new(800, 600, "Circles!");
loop {
pg.circle((100., 100.), 15.);
pg.fill_color(Color::BLUE);
pg.circle((300., 450.), 24.);
pg.update();
}
Or a texture?
let mut pg = Window::new_fullscreen();
let my_texture = pg.load_texture("my_texture.png").unwrap();
loop {
pg.texture((100., 250.), my_texture, 100., 150.);
pg.update();
}
How about some text?
let mut pg = Window::new(720, 480, "Text!");
loop {
pg.font_color((0xEE, 0x44, 0x88));
pg.font_size(30);
pg.text((100., 100.), "Greetings!");
pg.update();
}
Want to press some keys and click some stuff?
let mut pg = Window::new_fullscreen();
loop {
if pg.key_just_pressed(Key::SPACE) {
println!("Action!");
}
if pg.mouse_pressed(Button::LEFT) {
pg.circle(pg.mouse_position(), 16.);
}
pg.update();
}
Install
Since Pronto Graphics uses SFML for rendering, specifically the SFML bindings for Rust for rendering, it's prerequisites are the same as the SFML Rust bindings, namely for the SFML library to be installed. This might change in future versions.
# Cargo.toml
[dependencies]
pronto-graphics = "0.4.0"
Features
- Circle, Rectangles, Squares
- Lines
- Textures
- Text
- Keyboard
- Mouse
- Doc comments
- Custom fonts
Planned
- Transforms (Rotation, Origin, text alignment)
- Triangles
- Arbitrary shapes
- Audio
- Caching/Batching of draw calls
- Draw customization (outline thickness/etc.)
Contributions
I'm no experiences open saucer either, so don't hesitate with pull requests :)
Just make sure to explain what you're adding or changing and to adequately add doc comments to anything that will be exposed to the end-user.
Notes
- Investigate whether it might be better for performance to create a new SFML object for each draw call, instead of reusing them.
- Add separate examples for different features, the
hello-world.rs
is getting quite big.
Dependencies
~2.3–10MB
~78K SLoC