rust-raspberrypi-OS-tutorials/0A_pcscreenfont/README.md
2018-01-06 16:49:26 +01:00

40 lines
1.4 KiB
Markdown

Tutorial 0A - PC Screen Font
============================
Drawing pixmaps is fun, but definitely there's a need to display characters as well. Basicaly fonts
are nothing more than bitmaps for each character. For this tutorial I choosed PC Screen Font format,
the same Linux Console uses.
Lfb.h, lfb.c
------------
`lfb_init()` sets up resolution, depth, and color channel order. Also queries framebuffer's address.
`lfb_print(x,y,s)` displays a string on screen.
Font.psf
--------
The font file. Use any file from /usr/share/kbd/consolefonts. Unicode table is not supported. Translating
characters to glyph index using that table (instead of one-to-one relation) is a homework for you. This font
is generated from the original IBM PC VGA 8x16 Font ROM, and includes 127 glyphs.
Makefile
--------
I've added a new object file, generated from the psf. It's a good example of how to include and reference
a binary file in C. I've used the following command to find out the label:
```sh
$ aarch64-elf-readelf -s font.o
... output removed for clearity ...
2: 0000000000000820 0 NOTYPE GLOBAL DEFAULT 1 _binary_font_psf_end
3: 0000000000000000 0 NOTYPE GLOBAL DEFAULT 1 _binary_font_psf_start
4: 0000000000000820 0 NOTYPE GLOBAL DEFAULT ABS _binary_font_psf_size
```
Main
----
Very simple. We set the resolution and display the string.