saymrwulf/xous-core
1
0
Fork 0
mirror of https://github.com/saymrwulf/xous-core.git synced 2026-11-15 08:30:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
xous-core/libs/blitstr2
History
bunnie 1255bf12d9 FLAG DAY: fix all names to harmonize around 'bao1x' 
The code base had evolved through several code names, interim
names, company names and chip names that alternatively did or did
not exist.

Baochip is the definitive name of the company, and the Baochip1x
(full part number BAO1X2S4F-WA) is the definitivey part number of
the SoC. For convenience, the part number is shortened to 'bao1x'
in most feature flags and variable references.

This commit fixes all of the odd names and removes some unmaintained
early targets.
2025-09-18 21:25:51 +08:00
..
codegen fix location of font offsets 2025-02-24 02:28:34 +08:00
src FLAG DAY: fix all names to harmonize around 'bao1x' 2025-09-18 21:25:51 +08:00
Cargo.toml FLAG DAY: fix all names to harmonize around 'bao1x' 2025-09-18 21:25:51 +08:00
LEGAL.md
LICENSE-APACHE
LICENSE-MIT
README.md

README.md

blitstr2

This code is vendored in from https://github.com/samblenny/blitstr2 with permission from the author.

multi-lingual string blitter for 1-bit monochrome (sequel to blitstr)

Maintenance Notes

  • Font files are regenerated by running ruby config_editor.rb followed by go run main.go --write in the /src/blitstr2/codegen directory relative to this README.md file
  • The Go files have been modified to generate the necessary templates for the loader/kernel split of the font tables. The main bit of manual "glue" is at the top of main.rs inside the map_fonts() routine, where the AtomicU32 pointers that hold the final linked location of the font maps are initialized at boot.
  • Font sources are located in src/blitstr2/codegen/src_data, along with various indices and codepoints.
  • Most font sources were generated by https://github.com/samblenny/hd1b_other
  • The latin sets that have a more manual process consisting of taking a screenshot of ResEdit's KCHR screen on a Mac OS 7 emulator via https://archive.org/details/mac_MacOS_7.0.1_compilation and massaging the result into a usable sprite sheet. The only two native font sizes that look good ane 9 and 12 point, which gives a coverage of 9, 12, 18 and 24 point sizes (with pixel doubling).

What's New

Compared to the original version of blitstr, blitstr2:

  • Supports more languages
  • Uses 16x16 pixel size for CJK glyphs instead of 32x32
  • Makes it easier for calling code to calculate size of rendered strings
  • Ignores multi-codepoint grapheme clusters for modern emoji (instead, there is limited support for old-school monochrome bitmap emoji)
  • Focuses on an API to look up glyphs from just one typeface at a time

License

Source code for blitstr2 is dual licensed under the terms of Apache 2.0 or MIT, at your option.

Glyph bitmaps included with blitstr2 have their own copyrights and licenses (OFL-1.1, public domain, Japanese equivalent of public domain).

See LEGAL.md for copyright and license details on embedded glyph bitmaps.