14 breaking releases

0.15.0 Dec 18, 2024
0.14.0 Sep 26, 2024
0.13.0 Jul 16, 2024
0.12.0 Mar 27, 2024
0.4.0 Oct 31, 2022

#461 in Encoding

Download history 12/week @ 2024-10-02 22/week @ 2024-10-09 4/week @ 2024-10-16 6/week @ 2024-10-30 6/week @ 2024-11-06 1/week @ 2024-11-13 1/week @ 2024-11-20 4/week @ 2024-12-04 3/week @ 2024-12-11 199/week @ 2024-12-18 8/week @ 2024-12-25 177/week @ 2025-01-01 15/week @ 2025-01-08 217/week @ 2025-01-15

417 downloads per month

MIT license

47KB
465 lines

egui-bind

Library for showing key and pointer binds

Installation

[dependencies]
egui-bind = "0.14"

# Or if you wish for your binds to be serializable
# [dependencies]
# egui-bind = { version = "0.14", features = ["serde"] }

Example

// Foreword: You can find this example in `examples/bind.rs`
#[derive(Default)]
struct ExampleApp {
    // This can also be serialized with `serde`. You just
    // need to enable `serde` feature.
    bind: Option<(KeyOrPointer, Modifiers)>,
    count: usize,
}

impl App for ExampleApp {
    fn update(&mut self, ctx: &Context, _: &mut Frame) {
        Window::new("Example")
            .show(ctx, |ui| {
                // Order matters, If you were to put this if case
                // after the bind was shown, then it would trigger `self.cout += 1`
                // on the same frame user assigned a new bind, which may not be the
                // desired behavior. But you can mitigate this by using the return
                // value of a `Bind::show` as shown below with `println!`.
                if self.bind.pressed(ui.input()) {
                    self.count += 1;
                }

                // `Bind::new` accepts a reference to a type that implements `BindTarget`
                // Most common of those are:
                // `Key`, `PointerButton`, `KeyOrPointer`, `(BindTarget, Modifiers)`
                // `Option<BindTarget>`
                let assigned = Bind::new("_test", &mut self.bind).show(ui);

                // Here it checks if the bind was pressed but not assigned on the same frame.
                if !assigned && self.bind.pressed(ui.input()) {
                    println!("I was pressed");
                }

                ui.label(format!("Counter: {}", self.count));
            });
    }
}

Dependencies

~4–10MB
~87K SLoC