1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
Usage
=====
Install the `htic` package with the provided `setup.py`,
possibly in a [virtual environment](https://docs.python.org/3/tutorial/venv.html):
```
sudo pip3 install . # System-wide
pip3 install --user . # User-local
```
The compiler can be run from the commandline, check its usage with:
```
htic --help
```
Interface
---------
Import `htic` and call the appropriate `to*()` function:
```
import fontforge
import htic
# Open font with FontForge
font = fontforge.open("myfont.sfd")
# Compile instructions and insert them into font
htic.toFontforge("instructions.hti", font)
# Save font with FontForge
font.generate("myfont.ttf")
```
The following `to*()` functions are available:
```
htic.toConsole(sourceFile)
htic.toFontforge(sourceFile, font)
htic.toFontTools(sourceFile, font)
```
Extending
---------
The compiler can be extended to support other font object types.
Search for the `EXTEND` keyword in the code to find the relevant
extension points.
The main task is to add a custom `to*()` function. Check the
existing functions for reference. These functions first pass
the sourcefile name to `parser.parseFile()`, which returns a
`Data` object. This object contains all parsed data in a neutral
format, which can then be written into the font object.
Parsed program blocks (`fpgm`, `prep`, or glyph instructions)
are represented by `Program` objects. Programs can be converted
to human-readable strings with `str(program)` for debugging, or
to binary TrueType code with `bytes(program)`.
|
