cacao 0.3.2

Rust bindings for AppKit (macOS/Airyx/GNUStep, beta) and UIKit (iOS/tvOS, alpha).
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

use std::path::Path;

use core_graphics::base::CGFloat;
use objc::runtime::Object;
use objc::{class, msg_send, sel, sel_impl};
use objc_id::ShareId;

use crate::foundation::{id, NSString, NSUInteger, YES};
use crate::utils::CGSize;

/// Describes the quality of the thumbnail you expect back from the
/// generator service.
#[derive(Debug)]
pub enum ThumbnailQuality {
    /// Appropriate for a file icon.
    Icon,

    /// Low-ish quality, but fast.
    Low,

    /// Higher quality, but potentially slower.
    High,

    /// Ask for them all, and pick which one you
    /// use via your provided callback.
    All,

    /// Provided in case this is ever expanded by the OS, and the system
    /// returns a thumbnail quality type that can't be matched here. Users
    /// could then handle the edge case themselves.
    Unknown(NSUInteger)
}

impl From<&ThumbnailQuality> for NSUInteger {
    fn from(quality: &ThumbnailQuality) -> Self {
        match quality {
            ThumbnailQuality::Icon => 1 << 0,
            ThumbnailQuality::Low => 1 << 1,
            ThumbnailQuality::High => 1 << 2,
            ThumbnailQuality::All => NSUInteger::MAX,
            ThumbnailQuality::Unknown(x) => *x
        }
    }
}

impl From<ThumbnailQuality> for NSUInteger {
    fn from(quality: ThumbnailQuality) -> Self {
        match quality {
            ThumbnailQuality::Icon => 1 << 0,
            ThumbnailQuality::Low => 1 << 1,
            ThumbnailQuality::High => 1 << 2,
            ThumbnailQuality::All => NSUInteger::MAX,
            ThumbnailQuality::Unknown(x) => x
        }
    }
}

impl From<NSUInteger> for ThumbnailQuality {
    fn from(i: NSUInteger) -> Self {
        match i {
            0 => ThumbnailQuality::Icon,
            2 => ThumbnailQuality::Low,
            4 => ThumbnailQuality::High,
            NSUInteger::MAX => ThumbnailQuality::All,
            i => ThumbnailQuality::Unknown(i)
        }
    }
}

#[derive(Clone, Debug)]
pub struct ThumbnailConfig {
    pub size: (CGFloat, CGFloat),
    pub scale: CGFloat,
    pub minimum_dimension: CGFloat,
    pub icon_mode: bool,
    pub types: &'static [ThumbnailQuality]
}

impl Default for ThumbnailConfig {
    fn default() -> Self {
        ThumbnailConfig {
            size: (44., 44.),

            // #TODO: Should query the current screen size maybe? 2x is fairly safe
            // for most moderns Macs right now.
            scale: 1.,

            minimum_dimension: 0.,

            icon_mode: false,

            types: &[ThumbnailQuality::All]
        }
    }
}

impl ThumbnailConfig {
    /// Consumes the request and returns a native representation
    /// (`QLThumbnailGenerationRequest`).
    pub fn to_request(self, path: &Path) -> id {
        let file = NSString::new(path.to_str().unwrap());

        let mut types: NSUInteger = 0;
        for mask in self.types {
            let i: NSUInteger = mask.into();
            types = types | i;
        }

        unsafe {
            let size = CGSize::new(self.size.0, self.size.1);
            // @TODO: Check nil here, or other bad conversion
            let from_url: id = msg_send![class!(NSURL), fileURLWithPath:&*file];

            let request: id = msg_send![class!(QLThumbnailGenerationRequest), alloc];
            let request: id = msg_send![request, initWithFileAtURL:from_url
                size:size
                scale:self.scale
                representationTypes:types];

            if self.icon_mode {
                let _: () = msg_send![request, setIconMode: YES];
            }

            if self.minimum_dimension != 0. {
                let _: () = msg_send![request, setMinimumDimension:self.minimum_dimension];
            }

            request
        }
    }
}