t3hn3rd
466173613f
continuous-integration/drone/push Build is failing
Replace placeholder content in doc/compat/, doc/lvglh/, and doc/toolchain/ with comprehensive documentation derived from the source files. - compat: document Wasuro WASM VM compatibility shims - lvglh: document LVGL v9.2.2 configuration, fonts, and patches - toolchain: document all 13 build pipeline scripts
56 lines
2.6 KiB
Markdown
56 lines
2.6 KiB
Markdown
# lv_font_fa_solid_16.c
|
|
|
|
LVGL bitmap font source for Font Awesome 7 Free Solid at 16 px.
|
|
|
|
## Overview
|
|
|
|
This file contains a pre-rendered bitmap font generated from the Font Awesome 7 Free Solid TrueType font (`Font Awesome 7 Free-Solid-900.ttf`) for use with LVGL. It provides a library of solid-style vector icons rendered as bitmaps, suitable for toolbar buttons, status indicators, navigation elements, and general iconography in the Asuro GUI.
|
|
|
|
The file was generated by the LVGL font converter tool and is approximately 35,800 lines (~1.6 MB) of static bitmap and glyph descriptor data.
|
|
|
|
## Configuration Options / Defines
|
|
|
|
### LV_FONT_FA_SOLID_16
|
|
Value: `1` (default). Acts as a compile-time guard. Set to `0` to exclude this font from the build entirely.
|
|
|
|
## Font Properties
|
|
|
|
| Property | Value |
|
|
|----------|-------|
|
|
| Font family | Font Awesome 7 Free Solid 900 |
|
|
| Size | 16 px |
|
|
| Bits per pixel | 4 (16-level anti-aliasing) |
|
|
| Compression | None (`--no-compress`) |
|
|
| Stride alignment | 1 byte |
|
|
| Data alignment | 1 byte |
|
|
| Line height | 20 px |
|
|
| Baseline | 4 px from bottom |
|
|
| Underline position | 0 |
|
|
| Underline thickness | 0 |
|
|
| Unicode range | 0x0000--0xFFFF |
|
|
| Subpixel rendering | None |
|
|
|
|
## Public Symbol
|
|
|
|
```c
|
|
const lv_font_t lv_font_fa_solid_16;
|
|
```
|
|
|
|
This is the font descriptor exposed for use in LVGL widget styles. Reference it as `&lv_font_fa_solid_16` when assigning icon fonts to labels or buttons. Font Awesome icons are addressed by their Unicode code points (e.g., `LV_SYMBOL_*` constants or raw `\uXXXX` escape sequences).
|
|
|
|
## Generation Command
|
|
|
|
```
|
|
--bpp 4 --size 16 --no-compress --stride 1 --align 1 \
|
|
--font "Font Awesome 7 Free-Solid-900.ttf" --range 0-65535 --format lvgl \
|
|
-o lv_font_fa_solid_16.c
|
|
```
|
|
|
|
## Notes
|
|
|
|
- This is a machine-generated file. Do not edit by hand; regenerate using the LVGL font converter if changes are needed.
|
|
- The full 0--65535 Unicode range includes all Font Awesome solid icons. Since most code points in this range are blank (Font Awesome only defines glyphs for its icon set), the actual rendered glyph count is much smaller than the range suggests, but the descriptor tables still consume significant space.
|
|
- The file is the largest in the `lvglh/` directory at approximately 1.6 MB. If binary size becomes a constraint, the Unicode range should be narrowed to only the icon code points actually used by the Asuro shell.
|
|
- The font includes version-conditional compilation guards for compatibility across LVGL 6.x through 9.x, though Asuro targets LVGL 9.2.2.
|
|
- The `LV_ATTRIBUTE_LARGE_CONST` annotation on the glyph bitmap array allows the linker to place it in an appropriate read-only section.
|