panosifier is a Python 3.6+ command line application that edits panose data in fonts. The tool edits the OpenType specification OS/2 table panose fields.
In many cases, you can define these values in your type design source files and rely on the font compiler to write these values into your font instances. However, there are situations where this behavior is not well-defined and differs across font compilers.
An example is the approach to panose data writes in variable font format files. In this case, the OpenType specification is vague, environments where these data are essential are not well-defined, and compilers handle the source file defined panose data differently.
This tool allows you to modify build-time decisions in these situations.
- Install in a Python 3.6+ virtual environment with
pip install panosifier - Define your panose values with a comma-delimited panose value list using the
--panosecommand line option or individually with the ten available OpenType panose field options (seepanosifier --helpfor a list of available options)
See the documentation below for additional details.
This project requires a Python 3.6+ interpreter.
We recommend installation in a Python3 virtual environment.
Use any of the following installation approaches:
$ pip3 install panosifier
$ git clone https://github.com/source-foundry/panosifier.git
$ cd panosifier
$ pip3 install -r requirements.txt .
The following approach installs the project and associated optional developer dependencies so that source changes are available without the need for re-installation.
$ git clone https://github.com/source-foundry/panosifier.git
$ cd panosifier
$ pip3 install --ignore-installed -r requirements.txt -e ".[dev]"
panosifier supports two command line approaches to edit panose data in one or more command line defined font paths:
- Define all 10 OpenType panose fields with an ordered comma-delimited list of integers with the
--panoseoption - Define with individual command line options for one or more of the 10 OpenType panose fields
You can define all panose fields at once with an ordered, comma-delimited list of all 10 OpenType panose values. These must be integer values.
The field order is:
- FamilyType
- SerifStyle
- Weight
- Proportion
- Contrast
- StrokeVariation
- ArmStyle
- LetterForm
- Midline
- XHeight
The following image exemplifies this order in the --panose option definition idiom. Note that the values in this example are not intended to be valid for a font, but rather to demonstrate how the definition order maps to panose definition fields.
There are ten available OpenType panose definitions. Each panose field has a corresponding option in the panosifier tool. These options allow you to define each field individually and make panose definitions explicit in scripted build workflows. Define these options with integer values.
The example below modifies the panose data write in the comma-delimited list section above with new FamilyType and Proportion values of 2 and 9, respectively:
Use panosifier --help to view all available options.
Note: This tool does not perform sanity checks on your definitions and can be used to write invalid definitions in fonts. The tool assumes that you understand how to set these panose values. Please refer to the panose documentation for detailed background.
panosifier reports panose data definitions in the standard output stream at the end of execution.
Contributions are warmly welcomed. A development dependency environment can be installed in editable mode with the developer installation documentation above.
Please use the standard Github pull request approach to propose source changes.
We lint Python source files with flake8. See the Makefile test-lint target for details.
Continuous integration testing is performed on the GitHub Actions service with the pytest toolchain. Test modules are located in the tests directory of the repository.
Perform local Python interpreter version testing with the following command executed from the root of the repository:
$ tox -e [PYTHON INTERPRETER VERSION]
Please see the tox documentation for additional details.
We perform unit test coverage testing with the coverage tool. See the Makefile test-coverage target for details.
panosifier is built with the fantastic free fonttools Python library.
