Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jeanguyomarch/fontmaker
Generates bitmap fonts for LCD relying on tiny micro-controllers.
https://github.com/jeanguyomarch/fontmaker
Last synced: 27 days ago
JSON representation
Generates bitmap fonts for LCD relying on tiny micro-controllers.
- Host: GitHub
- URL: https://github.com/jeanguyomarch/fontmaker
- Owner: jeanguyomarch
- License: mit
- Created: 2014-12-21T15:31:09.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2020-02-26T17:18:45.000Z (over 4 years ago)
- Last Synced: 2023-08-03T08:38:42.590Z (over 1 year ago)
- Language: C
- Size: 271 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
fontmaker
=========
This command-line utility has been originally developed for the SmartWrist project.
What it does
------------
Fontmaker takes as inputs:
- a TTF file;
- the size font to extract;
- a fontmaker file which indicates what characters must be conteverted to bitmaps.
And it outputs:
- a C source file containing the bitmap font, various information about it and how to extract it (optimized);
- a C header file containing the prototypes of the provided API.
For more info, run `fontmaker --help`.
Requirements
------------
Fontmaker relies on:
- `cmake` as a build system;
- `freetype2` to extract font properties and generate bitmaps from TTF files;
- `flex` to parse the charmap.
Usage
-----
Let's assume:
- `$OUT_C` the C source file to be produced;
- `$OUT_H` the C header file to be produced;
- `$TTF` the TTF file to be used as a basis;
- `$PT` the font size (in pts);
- `$MAP` the fontmaker charmap file.
```
fontmaker --gc "$OUT_C" --gh "$OUT_H" --font-file="$TTF" --map-file="$MAP" --font-size="$PT"
```
Fontmaker Charmap File Format
-----------------------------
Rules:
- `##` starts a comment line;
- whitespace ` ` is always built-in;
- any other character must be separated by a space, tabulation, newline, etc.
Example:
```
## Digits
0 1 2 3 4
5 6 7 8 9
## Some ASCII characters
N e V E R
G o n N A
g i v
y O U
P
## Multi-bytes characters
É Ç é À ∑
```
Have a look at the example in `tests/charmap.fm`.
Build
-----
Fontmaker uses Cmake because it aims at being as portable as possible.
- `mkdir -p build && cd build`
- `cmake ..`
- `make`
Author
------
Jean Guyomarc'h
License
-------
MIT - see `LICENSE.md`.