ifengine 0.0.6

Interactive fiction library
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

use std::borrow::Cow;

use crate::core::Action;

/// Image type.
/// See [`crate::view::Object`].
#[derive(Debug, Clone)]
pub struct Image {
    pub size: [usize; 2],
    pub variant: ImageVariant,
    pub action: Option<Action>,
    pub alt: String, // caption and alt_text
}

/// Local or Remote image.
/// See [`Image`].
#[derive(Debug, Clone)]
pub enum ImageVariant {
    Url(String),
    Local(Cow<'static, str>, &'static [u8]), // unimplemented
}

impl Image {
    pub fn new_url(url: impl Into<String>) -> Self {
        Image {
            size: [0, 0],
            variant: ImageVariant::Url(url.into()),
            action: None,
            alt: String::new(),
        }
    }

    pub fn new_local(path: impl Into<Cow<'static, str>>, bytes: &'static [u8]) -> Self {
        Image {
            size: [0, 0],
            variant: ImageVariant::Local(path.into(), bytes),
            action: None,
            alt: String::new(),
        }
    }

    pub fn width(&self) -> usize {
        self.size[0]
    }

    pub fn height(&self) -> usize {
        self.size[1]
    }

    pub fn with_size(mut self, size: [usize; 2]) -> Self {
        self.size = size;
        self
    }

    pub fn with_alt(mut self, alt: String) -> Self {
        self.alt = alt;
        self
    }
}