Crates.io | gerg_ui |
lib.rs | gerg_ui |
version | 0.1.10 |
source | src |
created_at | 2021-10-12 05:56:14.832101 |
updated_at | 2021-10-29 03:14:07.437596 |
description | A little wrapper I've written for creating UI screens from files for the BevyEngine. |
homepage | |
repository | https://github.com/gmoller/gerg-ui |
max_upload_size | |
id | 463848 |
size | 723,749 |
This is a little thing I put together for creating simple UI screens using the BevyEngine. The idea is to define the screens in a sort of poor-man's markup and this crate will then provide some functions to create the UI 'widgets'.
For example, the following in a file will create a screen looking like:
with the code:
// startup_system
fn setup(
mut commands: Commands,
asset_server: Res<AssetServer>,
materials: ResMut<Assets<ColorMaterial>>
) {
commands.spawn_bundle(OrthographicCameraBundle::new_2d());
commands.spawn_bundle(UiCameraBundle::default());
let controls = gerg_ui::instantiate_controls_from_file("screen1.ui");
let _entities = gerg_ui::spawn_controls(&mut commands, asset_server, materials, controls, Vec2::new(1920.0, 1080.0), String::from("screen1.ui"));
}
// button_click_system
fn close_button_click_system(
mut commands: Commands,
button_clicked_query: Query<(Entity, &GergButton, &GergControl), With<ButtonClicked>>,
all_controls_query: Query<(Entity, &GergControl)>
) {
for (entity, button, control) in button_clicked_query.iter() {
println!("Hey, a button was clicked! - {} - {}", button.name, control.group_name);
commands.entity(entity).remove::<ButtonClicked>();
if button.name == "close_button" {
for (entity, control) in all_controls_query.iter() {
if control.group_name == "screen1.ui" {
commands.entity(entity).insert(DestroyControl);
}
}
}
}
}
// text_change_system
fn change_text_system(
diagnostics: Res<Diagnostics>,
mut query: Query<(&mut Text, &GergLabel), With<TextChanges>>
) {
for (mut text, label) in query.iter_mut() {
if label.name == "label1" {
let mut fps = 0.0;
if let Some(fps_diagnostic) = diagnostics.get(FrameTimeDiagnosticsPlugin::FPS) {
if let Some(fps_avg) = fps_diagnostic.average() {
fps = fps_avg;
}
}
text.sections[0].value = format!("FPS: {:.1}", fps);
}
}
}
--global_settings--
font_name: CrimsonText-Regular.ttf // mandatory
font_size: 30 // defaults to 20 if missing
color: 255;255;255 // defaults to WHITE if missing
--end--
--picture_box--
name: frame1
texture_name: big_frame.png // mandatory
size: 1200;782 // mandatory
//center_position: 0;0 // middle of screen is 0;0, defaults to 0;0 if missing, but dock_with will override
draw_order: 0 // optional, defaults to 0 if missing
dock_with: screen.top_left<->this.top_left
offset: 10;-80
--end--
--picture_box--
name: heading
texture_name: big_heading.png
size: 1200;76
draw_order: 0.1
dock_with: frame1.top_middle<->this.bottom_middle
offset: 0;-1
--end--
--button--
name: close_button
texture_name_normal: close_button_n.png // mandatory
texture_name_hover: close_button_h.png // optional, will use texture_name_normal if missing
texture_name_active: close_button_a.png // optional, will use texture_name_normal if missing
texture_name_disabled: close_button_n.png // optional, will use texture_name_normal if missing
on_click_sound: audio/mouse_click_1.mp3 // optional, will play no sound on click if missing
size: 43;44 // mandatory
bounding_box: 0;0;43;44 // optional, will use size of texture if missing
bounding_circle: 0;0;20 // optional, will use bounding_box if missing
draw_order: 0.2 // defaults to 0 if missing
dock_with: heading.top_right<->this.top_right
offset: -7;-7
--end--
--picture_box--
name: panel_inner
texture_name: inner_frame.png
size: 556;740
draw_order: 0.3
dock_with: frame1.center_left<->this.center_left
offset: 20;0
color: BLUE
--end--
--label--
name: label1
size: 200;50 // mandatory
text_string: FPS: // mandatory
font_name: CrimsonText-Regular.ttf // optional, will use global_settings if missing
font_size: 50 // optional, will use global_settings if missing
color: CYAN // optional, will use global_settings if missing
static_text: false // optional, defaults to false if missing
dock_with: panel_inner.top_left<->this.top_left
offset: 15;-15
--end--