fontthing/README.md

# Font thing

A small bitmap font renderer with its own format.

## The format

Introducing *TXTF* a family of text based bitmap font formats.

The first line of a *TXTF* font is the following:

> `TXTF` *mode* *nbcommentlines* *params*

Like

```
TXTF 1 10 5 5 .#
```

The *nbcommentlines* parameter is the number of description or comment
lines placed before the actual font data (not including the
header). In this comment area, you may put stuff like modelines,
copyright information and/or a description of the font.

The *mode* is the specific format in the txtf family this file is in,
the existing mode are as follows

### Mode 1 (Monospace)

> `TXTF` `1` nbcommentlines width height alphabet
> 
> Comment lines
> 
> Data

- *width*: is the number of pixels each character is wide
- *height*: is the number of pixels each character is high
- *alphabet*: 2 characters, the first represents OFF pixels, the second
  represents ON pixels.

Data is then in the following form

> character "*width* * *height* of the alphabet for the character"

whitespace is ignored in character data.

Here is a sample mode 1 font

```
TXTF 1 2 6 6 .#
Some font for the readme
By Annwan
!..#.....#.....#...........#.........
#.#.#..#####..#.#..#####..#.#........
_..............................######
```