Skip to main content

Render text from BMFont bitmap fonts.

Project description

BMText

Render text with BMFont generated bitmap fonts.

Status: The core of this code is reasonably well tested, but it's at an early stage, it's basically just been thrown up online, and you use it at your own risk.

Why???

I wanted kerning, and I wanted support for a widespread bitmap font format. BMFont is used to generate bitmap fonts from Truetype fonts, and the format it uses seems reasonably well supported.

I have vague plans to extend the format slightly to allow pre-rendered glyphs - so characters could be multi-colored or embossed, for example.

Using it

Install it with:

python -m pip install bmtext

Currently the API matches ImageDraw.text as closely as possible (given the limited feature-set).

from PIL import Image
from bmtext.meta import parse_file
from bmtext.pil import BMText

im = Image.new('RGB', (320, 180), color=(160, 160, 255))
drawer = BMText(im)
font = parse_file("tests/fixtures/raleway-30/raleway-thin-32.fnt")
# FIXME: Overlapping glyphs remove part of previous char.
drawer.text((5, 5), "Antidisestablishmentarianism\nThorough\nSHOUTING!!!\nTomato?", font, fill='blue')
im.show()

Sample of rendered text

To Do

  • FNT Compatibility:
    • Handle binary font metadata formats.
    • Test with multiple pages
    • Multiple channel support
    • Outline support (2-pass rendering)
  • Improve error handling:
    • Malformed fnt files
    • Missing characters from font (replace/error)
  • Features:
    • Allow arrangement of pre-rendered characters (rather than single-color alpha characters).
    • Implement textsize
    • Implement alignment
    • Implement anchor
  • More testing:
    • Test with older versions of pillow
  • Port to Python 3.5+ (remove the walrus operator)

Developing

Run the following to install the project (and dev dependencies) into your active virtualenv:

pip install -e .[dev]

Project details


Download files

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

Files for bmtext, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size bmtext-0.0.2-py3-none-any.whl (5.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size bmtext-0.0.2.tar.gz (44.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page