mirui 0.45.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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use mirui::prelude::Dimension;
use mirui::render::texture::Texture;
use mirui::render::{DrawRequest, RenderError, RenderFeature, RenderRoute, 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 route(&self, _: &DrawRequest<'_, '_>) -> Result<RenderRoute, RenderError> {
        Ok(RenderRoute::Native)
    }
    fn submit(&mut self, request: &DrawRequest<'_, '_>) -> Result<(), RenderError> {
        self.route(request)?;
        self.draws += 1;
        Ok(())
    }
    fn flush(&mut self) {}
    fn sample_target_region(&self, _src: &Rect) -> Result<Option<Texture<'static>>, RenderError> {
        Ok(None)
    }
    fn modify_target_region(
        &mut self,
        _src: &Rect,
        _f: &mut dyn FnMut(&mut Texture) -> Result<(), RenderError>,
    ) -> Result<bool, RenderError> {
        Ok(false)
    }
}

#[test]
fn background_blur_skips_empty_readback() {
    let mut app = mirui::app::App::headless(64, 64);
    app.with_default_widgets();
    let mut world = app.world;
    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).unwrap();
    let _ = renderer.draws;
}

#[test]
fn background_blur_reports_unsupported_readback() {
    struct NoReadback;

    impl Renderer for NoReadback {
        fn submit(&mut self, _: &DrawRequest<'_, '_>) -> Result<(), RenderError> {
            Ok(())
        }

        fn flush(&mut self) {}
    }

    let mut app = mirui::app::App::headless(64, 64);
    app.with_default_widgets();
    let mut world = app.world;
    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 viewport = Viewport::new(64, 64, Fixed::ONE);
    assert_eq!(
        render_system::render(&world, widget, &viewport, &mut NoReadback),
        Err(RenderError::Unsupported(RenderFeature::Readback))
    );
}

#[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_eq!(result, Ok(false));
}

#[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!(matches!(renderer.sample_target_region(&rect), Ok(None)));
}