#fonts #opentype

bin+lib fea-rs

Tools for working with Adobe OpenType Feature files

4 releases (2 breaking)

0.2.0 Jan 24, 2023
0.1.0 Jan 9, 2023
0.0.1 Dec 2, 2022
0.0.0 Sep 1, 2021

#239 in Text processing

Download history 1/week @ 2022-11-02 1/week @ 2022-11-09 1/week @ 2022-11-16 29/week @ 2022-11-30 3/week @ 2022-12-07 1/week @ 2022-12-14 3/week @ 2022-12-21 86/week @ 2023-01-04 113/week @ 2023-01-11 22/week @ 2023-01-18 40/week @ 2023-01-25

261 downloads per month

MIT/Apache

645KB
15K SLoC

fea-rs

Crates.io docs.rs License License

Parsing and compiling Adobe OpenType feature files.

status: We should be able to compile most inputs. Some generated tables may not be optimal, but should be correct. Obscure syntax may not be supported. Please report bugs.

quickstart

To use this tool to compile OpenType features from a UFO file:

$ cargo run PATH_TO_FONT.ufo -o my_generated_font.ttf

Alternatively, you can provide a path to a FEA file directly, in which case you will also need to pass a path to a file containing the glyph order: one glyph per line, in utf-8.

$ cargo run features.fea --glyph-order glyph_order.txt -o my_font.ttf

development

To run the tests, you will need to ensure that the test-data submodule is up to date. After cloning the repo:

$ git submodule init && git submodule update

architecture sketch

The overall design of this crate is heavily inspired by the design of rust analyzer.

Parsing

Parsing is broken up into a lexing and then a parsing step. Lexing identifies tokens (numbers, strings, identifiers, symbols, keywords) but has no knowledge of the syntax of the FEA language. Parsing takes a stream of tokens, and builds a syntax tree out of them.

The parser is "error recovering": when parsing fails, the parser skips tokens until it finds something that might begin a valid statement in the current context, and then tries again. Errors are collected, and reported at the end.

AST

The AST design is adapted from the AST in rowan, part of rust analyzer. The basic idea is that when constructing an AST node, we ensure that certain things are true about that node's contents. We can then use the type of that node (assigned by us) to cast that node into a concrete type which knows how to interpret that node's contents.

Validation

After building the AST, we perform a validation pass. This checks that statements in the tree comply with the spec: for instance, it checks if a referenced name exists, or if a given statement is allowed in a particular table block. Validation is also 'error recovering'; if something fails to validate we will continue to check the rest of the tree, and report all errors at the end.

If validation succeeds, then compilation should always succeed.

Compilation

After validation, we do a final compilation pass, which walks the tree and assembles the various tables and lookups. This uses fontations to generate tables, which can then be added to a font.

Some general design concepts:

  • in a given 'stage', collect errors as they are encountered and report them at the end. For instance during parsing we will continue parsing after an error has occurred, and report all parse errors once parsing is complete.

Dependencies

~10MB
~204K SLoC