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
//! Fonts, a bounded glyph cache, line layout and word wrapping.
//!
//! One [`TextEngine`] holds every font an application uses and one [`GlyphAtlas`]
//! that caches what has been rasterised. Measurement and drawing both go through
//! it, so a label that is measured during layout and drawn a moment later
//! rasterises its glyphs exactly once.
//!
//! ```no_run
//! # use denise::{Color, Point};
//! # use denise_render::Pen;
//! # use denise_text::{TextEngine, TextStyle};
//! # fn demo(canvas: &mut Pen<'_>) {
//! let mut text = TextEngine::new();
//! let style = TextStyle::built_in(16);
//! let extent = text.measure(style, "Kjærlighet på Øy");
//! text.draw(canvas, style, Point::new(20, 20), "Kjærlighet på Øy", Color::WHITE);
//! # let _ = extent;
//! # }
//! ```
//!
//! # Wrapping
//!
//! [`TextEngine::wrap`] breaks a string into the lines it becomes at a given
//! width, greedily, returning slices that borrow the input. Explicit `\n` always
//! breaks. A word wider than the line overflows on a line of its own rather than
//! being cut between characters — breaking mid-word means knowing where a
//! grapheme ends, and half of an `æ` is nothing.
//!
//! # Three tiers, and what each costs
//!
//! Measured as the increase in a stripped, statically linked
//! `aarch64-unknown-linux-musl` binary:
//!
//! | Tier | Feature | Cost | What it buys |
//! |---|---|---|---|
//! | Built-in bitmap | none | 0 | Latin plus `æøå`, whole-number scales |
//! | TrueType | `truetype` | +270 KB | Real fonts, proportional metrics, anti-aliasing |
//! | Baked | none; `bake` in a build script | the tables | A real face at the sizes it was baked at, no parser on the panel |
//! | Shaped | `shaping` | +3.1 MB | Ligatures, bidi, complex scripts, font fallback |
//!
//! For scale: the whole of Denise, DRM, evdev and the widgets is about 840 KB, so
//! the shaping tier is four times the rest of the toolkit put together. It is
//! there because some panels genuinely need it, and off by default because most
//! do not — a temperature readout and a Norwegian name do not need a shaper.
//!
//! The baked tier is the TrueType tier's drawing without its reading: a build
//! script rasterises the face at the sizes the UI uses, and the panel embeds
//! the result as tables and links no parser at all. A product that ships one
//! face wants this; one that lets its user pick a font at run time wants
//! `truetype`, and the two coexist. See [`baked`].
//!
//! # What this is not
//!
//! Not a text editor's model: no bidi cursor movement, no grapheme-cluster
//! segmentation, no line breaking by dictionary. `\n` breaks a line and nothing
//! else does. Those belong to whoever turns this into a document viewer.
// Labels every feature-gated item on docs.rs with the feature it needs. Nightly
// only, and `docsrs` is set by nothing but docs.rs — an ordinary build never
// sees this line.
// `chunks_exact` over `as_chunks`, against clippy 1.98's advice: `as_chunks`
// stabilised in 1.98 and this workspace supports 1.95, so taking the advice
// would trade a style lint for a compile error on every older toolchain. Revisit
// when the MSRV passes 1.98. `unknown_lints` because the lint does not exist
// before 1.98 either, and naming an absent lint is itself a warning.
extern crate alloc;
pub use ;
pub use ;
pub use BitmapSource;
pub use ;
pub use ShapedSource;
pub use ;
pub use TrueTypeSource;
/// Compiles the examples in this crate's README, so they cannot drift from the API
/// they claim to demonstrate. Never built except under `cargo test --doc`.
;