vfbLib 0.2.0

Tools for converting FontLab Studio 5 (VFB) files.

vfbLib

Converter and deserializer for FontLab Studio 5 VFB files.

FontLab’s own vfb2ufo converter is from 2015, only outputs UFO v2, and contains serious bugs that are never going to be fixed. Its support on macOS is subject to Apple’s mercy (no native support for Apple Silicon).

That’s why a single determined programmer with a hex editor set out to rectify this situation.

Installation

This is a development version. Handle with care. To install from source:

git clone [e-mail]:LucasFonts/vfbLib.git
cd vfbLib
pip install .

Improvements Over vfb2ufo

• Outputs normalized UFO v3
• Outputs FontLab user data (font and glyph level)
• Mark colors are written to the official UFO v3 lib key
• Guideline data is written to the official UFO v3 elements
• Anchors are preserved in composite glyphs
• PostScript hinting is written correctly, but to the Adobe lib key
• Supports more UFO font info attributes:
  • openTypeGaspRangeRecords
  • openTypeHeadLowestRecPPEM
  • openTypeNameRecords
  • openTypeOS2WeightClass is written correctly

Command Line Script Usage

vfb3ufo

Convert a VFB to one UFO per master. Command line options are compatible to FontLab’s vfb2ufo, but not all of them are implemented yet.

$ vfb3ufo MyFile.vfb

will convert the file to MyFile.ufo in the same directory. Existing files will not be overwritten unless you specify the -fo option.

vfb3ufo -h
usage: vfb3ufo [-h] [-p PATH] [-fo] [-ttx] [-64] [-s] [-z] [-m] inputpath [outputpath]

VFB3UFO Converter Copyright (c) 2022 by LucasFonts Build 2022-11-08

positional arguments:
  inputpath             input file path (.vfb)
  outputpath            output file path (.ufo[z])

options:
  -h, --help            show this help message and exit
  -p PATH, --path PATH  output folder
  -fo, --force-overwrite
                        force overwrite

Additional options:

  -m, --minimal         parse only minimal amount of data

Unimplemented options:

  -64, --base64         write GLIF lib 'data' section using base64 (recommended)
  -s, --silent          no display (silent mode)
  -ttx, --ttx           convert binary OpenType Layout data using TTX-like format
  -z, --zip             write UFOZ (compressed UFO)

vfb2json

Generate a representation that closely adheres to the VFB structure.

$ vfb2json MyFile.vfb

will convert the file to MyFile.json in the same directory. Existing files will be overwritten.

We expect this to be mostly used for debugging purposes.

vfb2json -h
usage: vfb2json [-h] [-m] [-p PATH] inputpath

VFB2JSON Converter Copyright (c) 2022 by LucasFonts Build 2022-11-08

positional arguments:
  inputpath             input file path (.vfb)

options:
  -h, --help            show this help message and exit
  -m, --minimal         parse only minimal amount of data
  -p PATH, --path PATH  output folder

Copyright

© 2022 by LucasFonts GmbH, Berlin