Python binding for Fontconfig
C Python
Pull request Compare This branch is 4 commits ahead of Vayn:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
CHANGES.txt
LICENSE.txt
MANIFEST
MANIFEST.in
README.rst
cfontconfig.pxd
factory.pxi
fcmore.h
fontconfig.c
fontconfig.pxi
fontconfig.pyx
setup.py

README.rst

Python-fontconfig

Python bindings for Fontconfig library

Requirement

Tested on

  • Python 2.7.2 (32-bit, 64-bit)
  • Python 3.2.2 (32-bit, 64-bit)
  • Python 3.3.2 (64-bit)

Installation

From PyPI:

>>> pip install Python-fontconfig

or

>>> easy_install Python-fontconfig

From GitHub:

>>> git clone git://github.com/Vayn/python-fontconfig.git
>>> cd python-fontconfig/
>>> python setup.py install

Building C source

>>> python setup.py build_ext -i

Testing

>>> cd test/
>>> python test.py

Usage

>>> import fontconfig
>>> fonts = fontconfig.query(family='ubuntu', lang='en')
>>> fonts
['/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-BI.ttf',
 '/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-L.ttf',
 '/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-LI.ttf',
 '/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-R.ttf',
 '/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-B.ttf',
 '/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-RI.ttf']
>>> font = fontconfig.FcFont(fonts[0])
>>> font
<FcFont: Ubuntu>
>>> font.
font.bestname           font.capability         font.fullname
font.slant              font.count_chars        font.get_languages
font.spacing            font.decorative         font.has_char
font.style              font.family             font.index
font.weight             font.file               font.outline
font.width              font.fontformat         font.print_pattern
font.foundry            font.scalable
>>> font.family
{'en': 'Ubuntu'}
>>> font.bestname
{'en': 'Ubuntu'}
>>> font.foundry
'unknown'
>>> font.fontformat
'TrueType'
>>> font.has_char('A')
True
>>> font.file
'/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-BI.ttf'
>>> fontconfig.fromName('Ubuntu')
<FcFont: Ubuntu>
>>> font = fontconfig.FcFont(font.file)
>>> font.family
{'en': 'Ubuntu'}

To get fonts from a .ttc (TrueType font collection) file:

>>> font = fontconfig.fromName('simsun')
>>> font.count, font.index, font.file, font
(3, 0, '/home/lilydjwg/.fonts/win/simsun.ttc', <FcFont: 宋体>)
>>> font = fontconfig.FcFont(font.file, 1)
>>> font.count, font.index, font.file, font
(3, 1, '/home/lilydjwg/.fonts/win/simsun.ttc', <FcFont: 新宋体>)
>>> fontconfig.query('新宋体', with_index=True)
[('/home/lilydjwg/.fonts/win/simsun.ttc', 1)]

License

This program is released under GPLv3 license, see LICENSE for more detail.