ferroui-base 0.3.0

The base library of FerroUI: the property system, layout, input, styling, media, text, animation, data binding and the compositor
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

use crate::media::immutable::{ImmutableDashStyle, ImmutablePen, ImmutableSolidColorBrush};
use crate::media::{IBrush, IDashStyle, IImmutableBrush, IPen, PenLineCap, PenLineJoin};
use crate::rendering::composition::generated::{ServerCompositionSimplePenHooks, ServerCompositionSimplePenProps};
use crate::rendering::composition::server::{
    impl_simple_server_render_resource, IServerObject, IServerRenderResource, ServerCompositor, ServerResourceRef,
    SimpleServerRenderResource,
};
use crate::rendering::composition::transport::BatchStreamReader;
use std::any::{Any, TypeId};
use std::rc::Rc;
use std::time::Duration;

/// The server-side counterpart of a mutable pen.
pub struct ServerCompositionSimplePen {
    base: SimpleServerRenderResource,
    props: ServerCompositionSimplePenProps,
}

impl ServerCompositionSimplePen {
    pub fn new(compositor: &Rc<ServerCompositor>) -> Rc<ServerCompositionSimplePen> {
        Rc::new_cyclic(|this| {
            let this: std::rc::Weak<ServerCompositionSimplePen> = this.clone();
            ServerCompositionSimplePen {
                base: SimpleServerRenderResource::new(compositor, this),
                props: ServerCompositionSimplePenProps::new(),
            }
        })
    }

    pub fn is_disposed(&self) -> bool {
        self.base.is_disposed()
    }

    /// The properties of the pen.
    pub fn props(&self) -> &ServerCompositionSimplePenProps {
        &self.props
    }

    pub fn set_brush(&self, value: Option<ServerResourceRef<dyn IBrush>>) {
        self.props.set_brush(self, value)
    }

    pub fn set_dash_style(&self, value: Option<std::sync::Arc<ImmutableDashStyle>>) {
        self.props.set_dash_style(self, value)
    }

    pub fn set_line_cap(&self, value: PenLineCap) {
        self.props.set_line_cap(self, value)
    }

    pub fn set_line_join(&self, value: PenLineJoin) {
        self.props.set_line_join(self, value)
    }

    pub fn set_miter_limit(&self, value: f64) {
        self.props.set_miter_limit(self, value)
    }

    pub fn set_thickness(&self, value: f64) {
        self.props.set_thickness(self, value)
    }
}

impl_simple_server_render_resource!(ServerCompositionSimplePen, base);

impl ServerCompositionSimplePenHooks for ServerCompositionSimplePen {}

impl IServerObject for ServerCompositionSimplePen {
    fn deserialize_changes_core(&self, reader: &mut BatchStreamReader<'_>, committed_at: Duration) {
        self.props.deserialize_changes_core(self, reader, committed_at);
    }

    fn values_invalidated(&self) {
        self.base.core().invalidated(self);
    }

    fn dispose(&self) {
        // Remove the pen from the brush observers.
        // Without this, the pen was being retained in memory by long lived brush resources (e.g. those defined in
        // the theme or app resources), hence was causing memory leaks.
        let brush = self.props.brush();
        self.base.core().remove_observers_from_property(self, brush.as_ref().and_then(|b| b.resource.as_ref()));
        ServerCompositionSimplePenProps::id_of_brush_property().set_field(self, None);
        self.base.core().dispose();
    }

    fn as_render_resource(self: Rc<Self>) -> Option<Rc<dyn IServerRenderResource>> {
        Some(self)
    }

    fn as_pen(self: Rc<Self>) -> Option<Rc<dyn IPen>> {
        Some(self)
    }

    fn get_props(&self, type_id: TypeId) -> Option<&dyn Any> {
        self.props.find_props(type_id)
    }

    fn as_any(&self) -> &dyn Any {
        self
    }

    fn into_any_rc(self: Rc<Self>) -> Rc<dyn Any> {
        self
    }
}

impl IPen for ServerCompositionSimplePen {
    fn brush(&self) -> Option<Rc<dyn IBrush>> {
        self.props.brush().map(|brush| brush.value)
    }

    fn dash_style(&self) -> Option<Rc<dyn IDashStyle>> {
        // The contract hands out a handle of this thread to the shared value.
        self.props.dash_style().map(|style| Rc::new((*style).clone()) as Rc<dyn IDashStyle>)
    }

    fn line_cap(&self) -> PenLineCap {
        self.props.line_cap()
    }

    fn line_join(&self) -> PenLineJoin {
        self.props.line_join()
    }

    fn miter_limit(&self) -> f64 {
        self.props.miter_limit()
    }

    fn thickness(&self) -> f64 {
        self.props.thickness()
    }

    fn as_any(&self) -> &dyn Any {
        self
    }

    fn into_immutable_pen(self: Rc<Self>) -> Rc<ImmutablePen> {
        // A snapshot of the brush: an immutable brush is taken as it is, a
        // server-side solid color brush by value. Other server-side brushes
        // have no immutable form here.
        let brush: Option<Rc<dyn IImmutableBrush>> = IPen::brush(&*self).and_then(|brush| {
            if let Some(solid) = brush.as_solid_color_brush() {
                if brush.as_any().is::<ImmutableSolidColorBrush>() {
                    return brush.clone().into_immutable_brush();
                }
                let snapshot: Rc<dyn IImmutableBrush> = Rc::new(ImmutableSolidColorBrush::from_brush(solid));
                return Some(snapshot);
            }
            brush.into_immutable_brush()
        });
        Rc::new(ImmutablePen::new(
            brush,
            self.props.thickness(),
            self.props.dash_style().map(|style| Rc::new((*style).clone())),
            self.props.line_cap(),
            self.props.line_join(),
            self.props.miter_limit(),
        ))
    }
}