imgui-ext 0.1.2

Define imgui UIs using a derive macro.
Documentation 
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

# imgui-ext

[![Build Status](https://img.shields.io/travis/germangb/imgui-ext/master.svg?style=flat-square)](https://travis-ci.org/germangb/imgui-ext)
[![Cargo package](https://img.shields.io/crates/v/imgui-ext.svg?style=flat-square)](https://crates.io/crates/imgui-ext)
[![docs.rs docs](https://docs.rs/imgui-ext/badge.svg?style=flat-square)](https://docs.rs/imgui-ext)
[![Master docs](https://img.shields.io/badge/docs-master-blue.svg?style=flat-square)](https://germangb.github.io/imgui-ext/)


A crate to quickly build [imgui] UIs using annotations and a custom Derive.

[imgui]: https://github.com/Gekkio/imgui-rs

## Features

* Encode UI directly on the types.
* Static code generation: [example].
* Nested UIs (see the [`imgui(nested(...))`][nested] annotation).
* Descriptive compiler errors.

[nested]: https://germangb.github.io/imgui-ext/imgui_ext/nested/index.html

[example]: ./imgui_derive/CODEGEN.md

## Example

```rust
use imgui_ext::ImGuiExt;

#[derive(ImGuiExt)]
struct Example {
    #[imgui(slider(min = 0.0, max = 4.0))]
    x: f32,
    #[imgui(input(step = 2))]
    y: i32,
    #[imgui(drag(label = "Drag 2D"))]
    drag_2d: [f32; 2],
    #[imgui(
        checkbox(label = "Turbo mode"),
        display(label = "Is turbo enabled?"),
    )]
    turbo: bool,
}
```

#### Result:

![](assets/demo.png)

[**See full example**](example/src/main.rs)

```bash
cargo run --package example
```

[result]: assets/demo.png

## Limitations

* `#[derive(ImGuiExt)]` is only supported for `struct`s with named fields, at the moment.
* Limited layout support.

## License

[MIT](LICENSE.md)