spritebox 0.4.0

Zero-dependency, safe Rust pixel art as text: sprites, UI panels, text, themes, screens, animations, tilemaps and pixel fonts, rendered to PNG and atlases
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

//! Named widget states and fixed-size icon collections.
use crate::Document;

/// A control's states, each referring to an ordinary named sprite.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct StateSet {
    pub(crate) name: String,
    pub(crate) states: Vec<(String, String)>,
}
impl StateSet {
    pub fn name(&self) -> &str {
        &self.name
    }
    pub fn states(&self) -> &[(String, String)] {
        &self.states
    }
    pub fn state(&self, name: &str) -> Option<&str> {
        self.states
            .iter()
            .find(|(s, _)| s == name)
            .map(|(_, s)| s.as_str())
    }
}

/// Icons with a shared size, in authored order.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct IconSet {
    pub(crate) name: String,
    pub(crate) members: Vec<String>,
}
impl IconSet {
    pub fn name(&self) -> &str {
        &self.name
    }
    pub fn members(&self) -> &[String] {
        &self.members
    }
}

impl Document {
    pub fn states(&self) -> &[StateSet] {
        &self.states
    }
    pub fn state_set(&self, name: &str) -> Option<&StateSet> {
        self.states.iter().find(|s| s.name == name)
    }
    pub fn icon_sets(&self) -> &[IconSet] {
        &self.icon_sets
    }
    pub fn icon_set(&self, name: &str) -> Option<&IconSet> {
        self.icon_sets.iter().find(|s| s.name == name)
    }
}