mirui 0.38.0

A lightweight, no_std ECS-driven UI framework for embedded, desktop, and WebAssembly
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
70
71
72
73
74
75
76
77
78
79
80

use mirui::ecs::World;
use mirui::prelude::Dimension;
use mirui::render::texture::Texture;
use mirui::render::{DrawCommand, Renderer};
use mirui::types::{Fixed, Rect, Viewport};
use mirui::ui::builder::WidgetBuilder;
use mirui::ui::layout::LayoutStyle;
use mirui::ui::render_system;
use mirui::ui::widgets::BackgroundBlur;

struct GracefulSkipRenderer {
    draws: usize,
}

impl Renderer for GracefulSkipRenderer {
    fn draw(&mut self, _cmd: &DrawCommand, _clip: &Rect) {
        self.draws += 1;
    }
    fn flush(&mut self) {}
    fn sample_target_region(&self, _src: &Rect) -> Option<Texture<'static>> {
        None
    }
    fn modify_target_region(&mut self, _src: &Rect, _f: &mut dyn FnMut(&mut Texture)) -> bool {
        false
    }
}

#[test]
fn background_blur_silently_skips_when_backend_returns_none() {
    let mut world = World::new();
    let widget = WidgetBuilder::new(&mut world)
        .layout(LayoutStyle {
            width: Dimension::px(64),
            height: Dimension::px(64),
            ..Default::default()
        })
        .id();
    world.insert(widget, BackgroundBlur::new(Fixed::from_int(4)));

    let root = WidgetBuilder::new(&mut world)
        .layout(LayoutStyle {
            width: Dimension::px(64),
            height: Dimension::px(64),
            ..Default::default()
        })
        .child(widget)
        .id();

    let mut renderer = GracefulSkipRenderer { draws: 0 };
    let viewport = Viewport::new(64, 64, Fixed::ONE);
    render_system::render(&world, root, &viewport, &mut renderer);
    let _ = renderer.draws;
}

#[test]
fn background_blur_modify_path_returns_false_without_panic() {
    let mut renderer = GracefulSkipRenderer { draws: 0 };
    let rect = Rect {
        x: Fixed::ZERO,
        y: Fixed::ZERO,
        w: Fixed::from_int(16),
        h: Fixed::from_int(16),
    };
    let result = renderer.modify_target_region(&rect, &mut |_tex| {
        panic!("closure must not run when backend returns false");
    });
    assert!(!result);
}

#[test]
fn background_blur_sample_path_returns_none_without_panic() {
    let renderer = GracefulSkipRenderer { draws: 0 };
    let rect = Rect {
        x: Fixed::ZERO,
        y: Fixed::ZERO,
        w: Fixed::from_int(16),
        h: Fixed::from_int(16),
    };
    assert!(renderer.sample_target_region(&rect).is_none());
}