immi 1.0.4

Immediate mode user interface toolkit.
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

// Copyright 2016 immi Developers
//
// Licensed under the Apache License, Version 2.0, <LICENSE-APACHE or
// http://apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or
// http://opensource.org/licenses/MIT>, at your option. This file may not be
// copied, modified, or distributed except according to those terms.

//! A 9-parts image is an image that can be stretched while still looking good.
//!
//! The image is split into 9 parts: the four corners, the four borders, and the middle. The
//! dimensions are given by the `top_percent`, `right_percent`, `bottom_percent` and
//! `left_percent` parameters.
//!
//! The whole context's area' is then filled with this image. The corners will always keep their
//! aspect ratio, the top and bottom borders will be stretched horizontally, the left and
//! right borders will be stretched vertically, and the middle will be stretched.
//!
//! The `left_border_percent` parameter is used to determine the percentage of the area that
//! should be occupied by the left border of the image. The order borders are automatically
//! calculated by maintaining the correct aspect ratio.

use Alignment;
use Draw;
use DrawContext;

/// Draws a 9-parts image.
///
/// # Panic
///
/// - Panics if `top_percent + bottom_percent > 1.0` or `left_percent + right_percent > 1.0`.
///
pub fn draw<D: ?Sized + Draw>(draw: &DrawContext<D>, left_border_percent: f32,
                              image_name: &D::ImageResource, top_percent: f32, right_percent: f32,
                              bottom_percent: f32, left_percent: f32)
{
    assert!(top_percent + bottom_percent <= 1.0);
    assert!(left_percent + right_percent <= 1.0);

    let image_width_per_height = draw.draw().get_image_width_per_height(image_name);

    let top_border_percent = left_border_percent * top_percent / left_percent * draw.width_per_height() / image_width_per_height;
    let right_border_percent = top_border_percent * right_percent / top_percent / draw.width_per_height() * image_width_per_height;
    let bottom_border_percent = right_border_percent * bottom_percent / right_percent * draw.width_per_height() / image_width_per_height;

    // top left
    {
        let ctxt = draw.rescale(left_border_percent, top_border_percent, &Alignment::top_left());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [0.0, 1.0], [left_percent, 1.0],
                                  [left_percent, 1.0 - top_percent], [0.0, 1.0 - top_percent]);
    }

    // top right
    {
        let ctxt = draw.rescale(right_border_percent, top_border_percent, &Alignment::top_right());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [1.0 - right_percent, 1.0], [1.0, 1.0],
                                  [1.0, 1.0 - top_percent], [1.0 - right_percent, 1.0 - top_percent]);
    }

    // bottom right
    {
        let ctxt = draw.rescale(right_border_percent, bottom_border_percent, &Alignment::bottom_right());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [1.0 - right_percent, bottom_percent],
                                  [1.0, bottom_percent], [1.0, 0.0], [1.0 - right_percent, 0.0]);
    }

    // bottom left
    {
        let ctxt = draw.rescale(left_border_percent, bottom_border_percent, &Alignment::bottom_left());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [0.0, bottom_percent],
                                  [left_percent, bottom_percent], [left_percent, 0.0], [0.0, 0.0]);
    }

    // top
    {
        let ctxt = draw.rescale(1.0 - left_border_percent - right_border_percent, top_border_percent, &Alignment::top());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [left_percent, 1.0], [1.0 - right_percent, 1.0],
                                  [1.0 - right_percent, 1.0 - top_percent], [left_percent, 1.0 - top_percent]);
    }

    // left
    {
        let ctxt = draw.rescale(left_border_percent, 1.0 - top_border_percent - bottom_border_percent, &Alignment::left());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [0.0, 1.0 - top_percent], [left_percent, 1.0 - top_percent],
                                  [left_percent, bottom_percent], [0.0, bottom_percent]);
    }

    // bottom
    {
        let ctxt = draw.rescale(1.0 - left_border_percent - right_border_percent, bottom_border_percent, &Alignment::bottom());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [left_percent, bottom_percent], [1.0 - right_percent, bottom_percent],
                                  [1.0 - right_percent, 0.0], [left_percent, 0.0]);
    }

    // right
    {
        let ctxt = draw.rescale(right_border_percent, 1.0 - top_border_percent - bottom_border_percent, &Alignment::right());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [1.0 - right_percent, 1.0 - top_percent],
                                  [1.0, 1.0 - top_percent], [1.0, bottom_percent], [1.0 - right_percent, bottom_percent]);
    }

    // middle
    {
        let ctxt = draw.rescale(1.0 - left_border_percent - right_border_percent,
                                 1.0 - top_border_percent - bottom_border_percent,
                                 &Alignment::center());
        draw.draw().draw_image_uv(image_name, &ctxt.matrix(), [left_percent, 1.0 - top_percent],
                                  [1.0 - right_percent, 1.0 - top_percent], [1.0 - right_percent, bottom_percent],
                                  [left_percent, bottom_percent]);
    }
    
    if !draw.cursor_hovered_widget() {
        if draw.is_cursor_hovering() {
            draw.set_cursor_hovered_widget();
        }
    }
}