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

use glib::translate::*;

use crate::{ffi, AttrType, Rectangle};

define_attribute_struct!(AttrShape, ffi::PangoAttrShape, &[AttrType::Shape]);

impl AttrShape {
    /// Create a new shape attribute.
    ///
    /// A shape is used to impose a particular ink and logical
    /// rectangle on the result of shaping a particular glyph.
    /// This might be used, for instance, for embedding a picture
    /// or a widget inside a [`Layout`][crate::Layout].
    /// ## `ink_rect`
    /// ink rectangle to assign to each character
    /// ## `logical_rect`
    /// logical rectangle to assign to each character
    ///
    /// # Returns
    ///
    /// the newly allocated
    ///   [`Attribute`][crate::Attribute], which should be freed with
    ///   `Pango::Attribute::destroy()`
    #[doc(alias = "pango_attr_shape_new")]
    pub fn new(ink_rect: &Rectangle, logical_rect: &Rectangle) -> Self {
        unsafe {
            from_glib_full(ffi::pango_attr_shape_new(
                ink_rect.to_glib_none().0,
                logical_rect.to_glib_none().0,
            ))
        }
    }

    pub fn ink_rect(&self) -> Rectangle {
        unsafe { from_glib_none(&self.inner.ink_rect as *const _) }
    }

    pub fn logical_rect(&self) -> Rectangle {
        unsafe { from_glib_none(&self.inner.logical_rect as *const _) }
    }
}