guion 0.4.0

flexible GUI framework
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

use super::*;

/// Size +/+= Border
#[derive(Clone,Copy)]
pub struct StdGonstraints {
    pub x: StdGonstraintAxis,
    pub y: StdGonstraintAxis,
}

/// The SizeAxis holds layouting constraints for one axis
/// Supported Operators: Add, BitAnd
#[derive(Clone,Copy)]
pub struct StdGonstraintAxis {
    pub min: u32,
    pub preferred: u32,
    pub max: Option<u32>,
    pub pressure: f32,
}

impl StdGonstraints {
    #[inline]
    pub const fn fixed_const(w: u32, h: u32) -> Self {
        Self{
            x: StdGonstraintAxis{
                min: w,
                preferred: w,
                max: Some(w),
                pressure: 1.0,
            },
            y: StdGonstraintAxis{
                min: h,
                preferred: h,
                max: Some(h),
                pressure: 1.0,
            }
        }
    }
}

impl StdGonstraintAxis {
    #[inline]
    pub const fn empty_const() -> Self {
        StdGonstraintAxis {
            min: 0,
            preferred: 0,
            max: None,
            pressure: 1.0,
        }
    }

    #[inline]
    pub const fn fixed_const(s: u32) -> Self {
        StdGonstraintAxis {
            min: s,
            preferred: s,
            max: Some(s),
            pressure: 0.0,
        }
    }
}

/// Defines constraints for one or both axis
///
/// `preferred` is the preferred/optimal size  
/// `min` is the minimum size if e.g. bounds have to be shrinked below preferred  
/// `max` is the maximum size if e.g. bounds are extended  
///
/// Syntax:
///
/// `constrant!( AXIS w [| AXIS y] )`  
/// `AXIS [[min]~]preferred[-[max]]`  
/// 
/// `[]`: optional argument    
/// `preferred`: the preferred size  
/// `~`: if given, the minimum size can be smaller than preferred (default: 0)  
/// `min`: additional to `~`, limis the minimum size to the specific min  
/// `-`: if given, the maximum size can be bigger than preferred (default: infinity)  
/// `max`: additional to `-`, limis the maximum size to the specific max  
/// 
/// Example:
/// 
/// `5`: fixed size 5  
/// `~5`: preferred 5, can be smaller (shrinked)  
/// `2~5`: preferred 5, can bes smaller, but not smaller than 2  
/// `5-`: preferred 5, can be bigger (extended)  
/// `5-8`: preferred 5, can be bigger, but not bigger than 8  
#[macro_export]
macro_rules! constraint {
    (# $min:literal ~ $pref:literal - $max:tt @ $p:literal | $($m:tt)*) => {
        $crate::layout::size::StdGonstraints{
            x: $crate::constraint!(#$min ~ $pref - $max @ $p),
            y: $crate::constraint!($($m)*),
        }
    };
    (# $min:literal ~ $pref:literal - None @ $p:literal) => {
        $crate::layout::size::StdGonstraintAxis{min:$min,preferred:$pref,max:None,pressure:$p}
    };
    (# $min:literal ~ $pref:literal - $max:literal @ $p:literal) => {
        $crate::layout::size::StdGonstraintAxis{min:$min,preferred:$pref,max:Some($max),pressure:$p}
    };
    (# $min:literal ~ $pref:literal - $max:tt $($m:tt)*) => {
        $crate::constraint!(#$min ~ $pref - $max @ 1.0 $($m)*)
    };
    ($min:literal ~ $pref:literal - $max:literal $($m:tt)*) => {
        $crate::constraint!(#$min ~ $pref - $max $($m)*)
    };
    ($min:literal ~ $pref:literal - $($m:tt)*) => {
        $crate::constraint!(#$min ~ $pref - None $($m)*)
    };
    ($min:literal ~ $pref:literal $($m:tt)*) => {
        $crate::constraint!(#$min ~ $pref - $pref $($m)*)
    };
    (~ $pref:literal $($m:tt)*) => {
        $crate::constraint!(0 ~ $pref $($m)*)
    };
    ($pref:literal $($m:tt)*) => {
        $crate::constraint!($pref ~ $pref $($m)*)
    };
}