gsk4/
border_node.rs

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
// Take a look at the license at the top of the repository in the LICENSE file.

use glib::translate::*;

use crate::{ffi, BorderNode, RenderNodeType, RoundedRect};

define_render_node!(BorderNode, ffi::GskBorderNode, RenderNodeType::BorderNode);

impl BorderNode {
    /// Creates a [`RenderNode`][crate::RenderNode] that will stroke a border rectangle inside the
    /// given @outline.
    ///
    /// The 4 sides of the border can have different widths and colors.
    /// ## `outline`
    /// a [`RoundedRect`][crate::RoundedRect] describing the outline of the border
    /// ## `border_width`
    /// the stroke width of the border on
    ///     the top, right, bottom and left side respectively.
    /// ## `border_color`
    /// the color used on the top, right,
    ///     bottom and left side.
    ///
    /// # Returns
    ///
    /// A new [`RenderNode`][crate::RenderNode]
    #[doc(alias = "gsk_border_node_new")]
    pub fn new(
        outline: &RoundedRect,
        border_width: &[f32; 4],
        border_color: &[gdk::RGBA; 4],
    ) -> Self {
        unsafe {
            from_glib_full(ffi::gsk_border_node_new(
                outline.to_glib_none().0,
                border_width.as_ptr() as *const [f32; 4],
                border_color.as_ptr() as *const [gdk::ffi::GdkRGBA; 4],
            ))
        }
    }

    /// Retrieves the colors of the border.
    ///
    /// # Returns
    ///
    /// an array of 4 [`gdk::RGBA`][crate::gdk::RGBA] structs
    ///     for the top, right, bottom and left color of the border
    #[doc(alias = "gsk_border_node_get_colors")]
    #[doc(alias = "get_colors")]
    pub fn colors(&self) -> &[gdk::RGBA; 4] {
        unsafe {
            &*(ffi::gsk_border_node_get_colors(self.to_glib_none().0) as *const [gdk::RGBA; 4])
        }
    }

    /// Retrieves the stroke widths of the border.
    ///
    /// # Returns
    ///
    /// an array of 4 floats
    ///   for the top, right, bottom and left stroke width of the border,
    ///   respectively
    #[doc(alias = "gsk_border_node_get_widths")]
    #[doc(alias = "get_widths")]
    pub fn widths(&self) -> &[f32; 4] {
        unsafe { &*ffi::gsk_border_node_get_widths(self.to_glib_none().0) }
    }
}

impl std::fmt::Debug for BorderNode {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        f.debug_struct("BorderNode")
            .field("colors", &self.colors())
            .field("widths", &self.widths())
            .field("outline", &self.outline())
            .finish()
    }
}