nappgui 0.2.0

Rust bindings to NAppGUI
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

use crate::{draw_2d::ImageTrait, gui::impl_layout, types::Scale, util::macros::callback};

use nappgui_sys::{
    imageview_OnClick, imageview_OnOverDraw, imageview_create, imageview_image, imageview_scale,
    imageview_size,
};

/// The image view trait.
pub trait ImageViewTrait {
    /// Returns a raw pointer to the image view object.
    fn as_ptr(&self) -> *mut nappgui_sys::ImageView;

    /// Set the default control size.
    fn size(&self, width: f32, height: f32) {
        let size = nappgui_sys::S2Df { width, height };
        unsafe {
            imageview_size(self.as_ptr(), size);
        }
    }

    /// Set the scaling to apply to the image.
    fn scale(&self, scale: Scale) {
        unsafe {
            imageview_scale(self.as_ptr(), scale as _);
        }
    }

    /// Set the image to be displayed in the control.
    fn image<T>(&self, image: &T)
    where
        T: ImageTrait,
    {
        unsafe {
            imageview_image(self.as_ptr(), image.as_ptr());
        }
    }

    callback! {
        /// Set a handle for the event click on the image.
         on_click() => imageview_OnClick;

        /// Allows you to draw an overlay on the image when the mouse is over it.
         on_over_draw() => imageview_OnOverDraw;
    }
}

/// ImageView are specialized views in visualizing images and GIF animations.
///
/// # Remark
/// This type is managed by nappgui itself. Rust does not have its ownership. When the window object is dropped, all
/// components assciated with it will be automatically released.
#[repr(transparent)]
#[derive(Clone, Copy, Debug)]
pub struct ImageView {
    pub(crate) inner: *mut nappgui_sys::ImageView,
}

impl ImageViewTrait for ImageView {
    fn as_ptr(&self) -> *mut nappgui_sys::ImageView {
        self.inner
    }
}

impl ImageView {
    /// Create a image view.
    pub fn new(width: f32, height: f32) -> Self {
        let imageview = unsafe { imageview_create() };
        let imageview = Self { inner: imageview };
        imageview.size(width, height);
        imageview
    }
}

impl_layout!(ImageView, ImageViewTrait, layout_imageview);