cascada 0.3.0

A general purpose UI layout engine
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
65
66
67
68
69


# Cascada
<div>
    <a href="https://crates.io/crates/cascada">
        <img alt="Crates.io Version" src="https://img.shields.io/crates/v/cascada">
    </a>
    <a href="https://docs.rs/cascada/latest/cascada/">
        <img src="https://img.shields.io/docsrs/cascada"/>
    </a>
    <img src="https://img.shields.io/github/actions/workflow/status/snubwoody/agape-rs/rust.yml"/>
    <a href="https://codecov.io/gh/snubwoody/cascada" > 
        <img src="https://codecov.io/gh/snubwoody/cascada/graph/badge.svg?token=PLYL0VUB5Y"/> 
    </a>
</div>

Cascada is a lightweight, high-performance UI layout engine.

[API Docs](https://docs.rs/cascada/latest/cascada) |
[Architecture](./ARCHITECTURE.md) 


## Features
- Microsecond layout performance
- Declarative syntax
- Predictable layouts
- Descriptive error handling

## Usage
Add this to your `Cargo.toml`.

```toml
[dependencies]
cascada = "0.2.0"
```

## Example

```rust
use cascada::{solve_layout,HorizontalLayout,EmptyLayout,Size};

let child = EmptyLayout::new()
    .intrinsic_size(IntrinsicSize::fill());

// Add three equally sized child nodes.
let mut layout = HorizontalLayout::new()
    .intrinsic_size(IntrinsicSize::fill())
    .add_child(child.clone())
    .add_child(child.clone())
    .add_child(child);

solve_layout(&mut layout, Size::unit(3000.0));

let children = layout.children();

assert_eq!(children[0].size().width,1000.0);
assert_eq!(children[1].size().width,1000.0);
assert_eq!(children[2].size().width,1000.0);
```


## License

Licensed under either of:

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT License ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.