Pixel Font Builder
A library that helps create pixel style fonts.
Installation
pip install pixel-font-builder
Usage
import shutil
from datetime import datetime
from examples import build_dir
from pixel_font_builder import FontBuilder, WeightName, SerifStyle, SlantStyle, WidthStyle, Glyph, opentype
def main():
outputs_dir = build_dir.joinpath('create')
if outputs_dir.exists():
shutil.rmtree(outputs_dir)
outputs_dir.mkdir(parents=True)
builder = FontBuilder()
builder.font_metric.font_size = 16
builder.font_metric.horizontal_layout.ascent = 14
builder.font_metric.horizontal_layout.descent = -2
builder.font_metric.vertical_layout.ascent = 8
builder.font_metric.vertical_layout.descent = -8
builder.font_metric.x_height = 7
builder.font_metric.cap_height = 10
builder.font_metric.underline_position = -2
builder.font_metric.underline_thickness = 1
builder.font_metric.strikeout_position = 6
builder.font_metric.strikeout_thickness = 1
builder.meta_info.version = '1.0.0'
builder.meta_info.created_time = datetime.fromisoformat('2024-01-01T00:00:00Z')
builder.meta_info.modified_time = builder.meta_info.created_time
builder.meta_info.family_name = 'My Font'
builder.meta_info.weight_name = WeightName.REGULAR
builder.meta_info.serif_style = SerifStyle.SANS_SERIF
builder.meta_info.slant_style = SlantStyle.NORMAL
builder.meta_info.width_style = WidthStyle.MONOSPACED
builder.meta_info.manufacturer = 'Pixel Font Studio'
builder.meta_info.designer = 'TakWolf'
builder.meta_info.description = 'A pixel font'
builder.meta_info.copyright_info = 'Copyright (c) TakWolf'
builder.meta_info.license_info = 'This Font Software is licensed under the SIL Open Font License, Version 1.1'
builder.meta_info.vendor_url = 'https://github.com/TakWolf/pixel-font-builder'
builder.meta_info.designer_url = 'https://takwolf.com'
builder.meta_info.license_url = 'https://openfontlicense.org'
builder.glyphs.append(Glyph(
name='.notdef',
horizontal_offset=(0, -2),
advance_width=8,
vertical_offset=(-4, 0),
advance_height=16,
bitmap=[
[1, 1, 1, 1, 1, 1, 1, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 0, 0, 0, 0, 0, 0, 1],
[1, 1, 1, 1, 1, 1, 1, 1],
],
))
builder.glyphs.append(Glyph(
name='CAP_LETTER_A',
horizontal_offset=(0, -2),
advance_width=8,
vertical_offset=(-4, 0),
advance_height=16,
bitmap=[
[0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 1, 1, 0, 0, 0],
[0, 0, 1, 0, 0, 1, 0, 0],
[0, 0, 1, 0, 0, 1, 0, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 1, 1, 1, 1, 1, 1, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 1, 0, 0, 0, 0, 1, 0],
[0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0],
],
))
builder.character_mapping.update({
65: 'CAP_LETTER_A',
})
builder.save_otf(outputs_dir.joinpath('my-font.otf'))
builder.save_otf_woff(outputs_dir.joinpath('my-font.otf.woff'))
builder.save_otf_woff2(outputs_dir.joinpath('my-font.otf.woff2'))
builder.save_ttf(outputs_dir.joinpath('my-font.ttf'))
builder.save_ttf_woff(outputs_dir.joinpath('my-font.ttf.woff'))
builder.save_ttf_woff2(outputs_dir.joinpath('my-font.ttf.woff2'))
builder.save_ms_bitmap_ttf(outputs_dir.joinpath('my-font.ms.bitmap.ttf'))
builder.save_otb(outputs_dir.joinpath('my-font.otb'))
builder.save_dfont(outputs_dir.joinpath('my-font.dfont'))
builder.save_bdf(outputs_dir.joinpath('my-font.bdf'))
builder.save_pcf(outputs_dir.joinpath('my-font.pcf'))
builder.meta_info.family_name = 'My Font SquareDot'
builder.opentype_config.outlines_painter = opentype.SquareDotOutlinesPainter()
builder.save_otf(outputs_dir.joinpath('my-font-square_dot.otf'))
builder.save_otf_woff(outputs_dir.joinpath('my-font-square_dot.otf.woff'))
builder.save_otf_woff2(outputs_dir.joinpath('my-font-square_dot.otf.woff2'))
builder.save_ttf(outputs_dir.joinpath('my-font-square_dot.ttf'))
builder.save_ttf_woff(outputs_dir.joinpath('my-font-square_dot.ttf.woff'))
builder.save_ttf_woff2(outputs_dir.joinpath('my-font-square_dot.ttf.woff2'))
builder.meta_info.family_name = 'My Font CircleDot'
builder.opentype_config.outlines_painter = opentype.CircleDotOutlinesPainter()
builder.save_otf(outputs_dir.joinpath('my-font-circle_dot.otf'))
builder.save_otf_woff(outputs_dir.joinpath('my-font-circle_dot.otf.woff'))
builder.save_otf_woff2(outputs_dir.joinpath('my-font-circle_dot.otf.woff2'))
builder.save_ttf(outputs_dir.joinpath('my-font-circle_dot.ttf'))
builder.save_ttf_woff(outputs_dir.joinpath('my-font-circle_dot.ttf.woff'))
builder.save_ttf_woff2(outputs_dir.joinpath('my-font-circle_dot.ttf.woff2'))
if __name__ == '__main__':
main()
Coordinate Systems
Use the same coordinate systems as OpenType.
Horizontal Layout
Vertical Layout
Supported Output Formats
| Format | File Extension |
|---|---|
| OpenType | .otf, .otc |
| TrueType | .ttf, .ttc |
| WOFF File Format 1.0 | .otf.woff, .ttf.woff |
| WOFF File Format 2.0 | .otf.woff2, .ttf.woff2 |
| Microsoft Bitmap Only SFNT | .ms.bitmap.ttf |
| X11 OpenType Bitmap | .otb |
| Macintosh Datafork TrueType | .dfont |
| Glyph Bitmap Distribution Format | .bdf |
| Portable Compiled Format | .pcf |
Dependencies
References
- Microsoft - OpenType Specification
- FreeType Glyph Conventions - Glyph Metrics
- OpenType Feature File Specification
- FontForge - Several formats for bitmap only sfnts
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pixel_font_builder-0.0.55.tar.gz
(21.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pixel_font_builder-0.0.55.tar.gz.
File metadata
- Download URL: pixel_font_builder-0.0.55.tar.gz
- Upload date:
- Size: 21.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
63ef28e08f7d62b51d7e3f2681dbf073347c3523af9b83dacc3b9debdf8768d2
|
|
| MD5 |
b624bc7b0c331ecd71db294b7e25ae31
|
|
| BLAKE2b-256 |
a98f1802d676c7a40c085f404582f11e17038ffebeed2be38050e45806997d2a
|
File details
Details for the file pixel_font_builder-0.0.55-py3-none-any.whl.
File metadata
- Download URL: pixel_font_builder-0.0.55-py3-none-any.whl
- Upload date:
- Size: 36.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
22c6d7ab27eafe51f729b4b4c6ba52e646e22c32b6f7a25fa8b6e2b361ebd95a
|
|
| MD5 |
3e89dc6f7fd72d5efd829f60036e04a4
|
|
| BLAKE2b-256 |
264274cc8eb19cbf843267fa9e03cda95229c5f0d4c19dbfc9928f8b1ffd3e35
|
