Skip to main content

A bridge between UFOs and FontTools.

Project description

Travis CI Status Appveyor CI status PyPI Version Codecov Join the chat at https://gitter.im/fonttools-dev/ufo2ft

ufo2ft

ufo2ft (“UFO to FontTools”) is a fork of ufo2fdk whose goal is to generate OpenType font binaries from UFOs without the FDK dependency.

The library provides two functions, compileOTF and compileTTF, which work exactly the same way:

from defcon import Font
from ufo2ft import compileOTF
ufo = Font('MyFont-Regular.ufo')
otf = compileOTF(ufo)
otf.save('MyFont-Regular.otf')

In most cases, the behavior of ufo2ft should match that of ufo2fdk, whose documentation is retained below (and hopefully is still accurate).

Naming Data

As with any OpenType compiler, you have to set the font naming data to a particular standard for your naming to be set correctly. In ufo2fdk, you can get away with setting two naming attributes in your font.info object for simple fonts:

  • familyName: The name for your family. For example, “My Garamond”.

  • styleName: The style name for this particular font. For example, “Display Light Italic”

ufo2fdk will create all of the other naming data based on thse two fields. If you want to use the fully automatic naming system, all of the other name attributes should be set to None in your font. However, if you want to override the automated system at any level, you can specify particular naming attributes and ufo2fdk will honor your settings. You don’t have to set all of the attributes, just the ones you don’t want to be automated. For example, in the family “My Garamond” you have eight weights. It would be nice to style map the italics to the romans for each weight. To do this, in the individual romans and italics, you need to set the style mapping data. This is done through the styleMapFamilyName and styleMapStyleName attributes. In each of your roman and italic pairs you would do this:

My Garamond-Light.ufo

  • familyName = “My Garamond”

  • styleName = “Light”

  • styleMapFamilyName = “My Garamond Display Light”

  • styleMapStyleName = “regular”

My Garamond-Light Italic.ufo

  • familyName = “My Garamond”

  • styleName = “Display Light Italic”

  • styleMapFamilyName = “My Garamond Display Light”

  • styleMapStyleName = “italic”

My Garamond-Book.ufo

  • familyName = “My Garamond”

  • styleName = “Book”

  • styleMapFamilyName = “My Garamond Display Book”

  • styleMapStyleName = “regular”

My Garamond-Book Italic.ufo

  • familyName = “My Garamond”

  • styleName = “Display Book Italic”

  • styleMapFamilyName = “My Garamond Display Book”

  • styleMapStyleName = “italic”

etc.

Additionally, if you have defined any naming data, or any data for that matter, in table definitions within your font’s features that data will be honored.

Feature generation

If your font’s features do not contain kerning/mark/mkmk features, ufo2ft will create them based on your font’s kerning/anchor data.

In addition to Adobe OpenType feature files, ufo2ft also supports the MTI/Monotype format. For example, a GPOS table in this format would be stored within the UFO at data/com.github.googlei18n.ufo2ft.mtiFeatures/GPOS.mti.

Fallbacks

Most of the fallbacks have static values. To see what is set for these, look at fontInfoData.py in the source code.

In some cases, the fallback values are dynamically generated from other data in the info object. These are handled internally with functions.

Merging TTX

If the UFO data directory has a com.github.fonttools.ttx folder with TTX files ending with .ttx, these will be merged in the generated font. The index TTX (generated when using using ttx -s) is not required.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ufo2ft-2.12.3.zip (243.3 kB view details)

Uploaded Source

Built Distribution

ufo2ft-2.12.3-py2.py3-none-any.whl (73.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ufo2ft-2.12.3.zip.

File metadata

  • Download URL: ufo2ft-2.12.3.zip
  • Upload date:
  • Size: 243.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.1

File hashes

Hashes for ufo2ft-2.12.3.zip
Algorithm Hash digest
SHA256 276ffa13a1db3f70aa4ae8f929cb5a9e27fe7ef3a5b6798c14c4f6de832124ef
MD5 f5651d5e90b2280b2c68f8830d0d684c
BLAKE2b-256 683b3df4f1964ad9a1195dfc2cfa74dd2e2b2876e14efdabb28b7f9aed14778f

See more details on using hashes here.

Provenance

File details

Details for the file ufo2ft-2.12.3-py2.py3-none-any.whl.

File metadata

  • Download URL: ufo2ft-2.12.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 73.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.1

File hashes

Hashes for ufo2ft-2.12.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e6ad58753b8bfe071b777ccd6e4d0fb9dab4a8a5aa32e27129cc9ce19900674b
MD5 3afd122532743fba2c268812ad2eec40
BLAKE2b-256 9164ac7b3bc533344ad7806b3602cb748a975f6a81e2bf7aadc622eee663dab2

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page