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
132
133
134
135
136
137
138
139
140
//! *The PICO-8 font to use with [`embedded-graphics`](https://crates.io/crates/embedded-graphics).*
//!
//! [](https://travis-ci.org/althonos/embedded-picofont/branches)
//! [](https://codecov.io/gh/althonos/embedded-picofont)
//! [](https://choosealicense.com/licenses/mit/)
//! [](https://github.com/althonos/embedded-picofont)
//! [](https://crates.io/crates/embedded-picofont)
//! [](https://docs.rs/embedded-picofont)
//! [](https://github.com/althonos/embedded-picofont/blob/master/CHANGELOG.md)
//! [](https://github.com/althonos/embedded-picofont/issues)
//!
//! # Overview
//!
//! This crate provides the super tiny 4x6 font of the PICO-8 fantasy console as an [`embedded_graphics::fonts::Font`](https://docs.rs/embedded-graphics/0.6.2/embedded_graphics/fonts/trait.Font.html)::
//!
//! <img src="https://www.lexaloffle.com/gfx/pico8_font.png" style="width:100%;image-rendering:-moz-crisp-edges;image-rendering:-o-crisp-edges;image-rendering:-webkit-optimize-contrast;image-rendering: crisp-edges;-ms-interpolation-mode: nearest-neighbor;">
//!
//! Please note the PICO-8 itself only use the uppercase characters, as the lowercase
//! chars can get *really* hard to read if the display is not upscaled. As such, it
//! is advised to only use this font to display uppercase characters.
//!
//! # Usage
//!
//! Use [`TextStyle`](https://docs.rs/embedded-graphics/0.6.2/embedded_graphics/style/struct.TextStyle.html)
//! to attach the PICO-8 font to a text:
//! ```rust
//! use embedded_graphics::prelude::*;
//! use embedded_graphics::fonts::Text;
//! use embedded_graphics::pixelcolor::Gray8;
//! use embedded_graphics::style::TextStyle;
//! use embedded_picofont::FontPico;
//!
//! let text = Text::new("Hello world!", Point::new(0, 0))
//! .into_styled(TextStyle::new(FontPico, Gray8::WHITE));
//! ```
//! 
//!
//! The PICO-8 also has wide characters: these can be displayed using two smaller
//! characters in the `128..255` char range:
//! ```rust
//! # use embedded_graphics::prelude::*;
//! # use embedded_graphics::fonts::Text;
//! # use embedded_graphics::pixelcolor::Gray8;
//! # use embedded_graphics::style::TextStyle;
//! # use embedded_picofont::FontPico;
//!
//! let text = Text::new("PRESS \u{96}\u{97} TO GO BACK", Point::new(0, 0))
//! .into_styled(TextStyle::new(FontPico, Gray8::WHITE));
//! ```
//! 
//!
//! See the [`embedded-graphics` documentation](https://docs.rs/embedded-graphics/)
//! for more information on how to use this crate.
//!
//! # License
//!
//! * The [original PICO-8 font](https://www.lexaloffle.com/pico-8.php?page=faq)
//! is available under the [CC-0 license](https://creativecommons.org/share-your-work/public-domain/cc0/).
//! * This crate is released under the [MIT License](https://opensource.org/licenses/mit-license.php).
//!
use Font;
use Size;
/// The 4x6 pixel monospace font used by the PICO-fantasy 8 console.
///
/// # Examples
///
/// ## Write some text to the screen at the default `(0, 0)` position
///
/// ```rust
/// # use embedded_graphics::prelude::*;
/// # use embedded_graphics::fonts::Text;
/// # use embedded_graphics::pixelcolor::Gray8;
/// # use embedded_graphics::style::TextStyle;
/// # use embedded_picofont::FontPico;
/// # use embedded_graphics::mock_display::MockDisplay;
/// # let mut display = MockDisplay::default();
/// Text::new("Hello Rust!", Point::new(0, 0))
/// .into_styled(TextStyle::new(FontPico, Gray8::WHITE))
/// .draw(&mut display);
/// ```
///
/// ## Translate text by (20px, 30px)
///
/// ```rust
/// # use embedded_graphics::prelude::*;
/// # use embedded_graphics::fonts::Text;
/// # use embedded_graphics::pixelcolor::Gray8;
/// # use embedded_graphics::style::TextStyle;
/// # use embedded_picofont::FontPico;
/// # use embedded_graphics::mock_display::MockDisplay;
/// # let mut display = MockDisplay::default();
/// Text::new("Hello Rust!", Point::new(20, 30))
/// .into_styled(TextStyle::new(FontPico, Gray8::WHITE))
/// .draw(&mut display);
/// ```
///
/// ## Add some styling to the text
///
/// Use the [`TextStyleBuilder`](https://docs.rs/embedded-graphics/0.6.1/embedded_graphics/style/struct.TextStyleBuilder.html)
/// trait to edit the colors of the rendered text:
///
/// ```rust
/// # use embedded_graphics::prelude::*;
/// # use embedded_graphics::fonts::Text;
/// # use embedded_graphics::pixelcolor::Rgb888;
/// # use embedded_graphics::style::TextStyleBuilder;
/// # use embedded_picofont::FontPico;
/// # use embedded_graphics::mock_display::MockDisplay;
/// # let mut display = MockDisplay::default();
/// let style = TextStyleBuilder::new(FontPico)
/// .text_color(Rgb888::MAGENTA)
/// .background_color(Rgb888::BLACK)
/// .build();
///
/// Text::new("Hello Rust!", Point::new(0, 0))
/// .into_styled(style)
/// .draw(&mut display);
/// ```
;