~alcinnz/fontconfig-pure

32350eb896fa7c3579f8b1ea6f6d16cb738c5e5d — Adrian Cochrane 1 year, 3 months ago e7928d3
Add initial README.
1 files changed, 20 insertions(+), 0 deletions(-)

A README.md
A README.md => README.md +20 -0
@@ 0,0 1,20 @@
# FontConfig Pure
[Source Code](https://git.argonaut-constellation.org/~alcinnz/fontconfig-pure) [Issues](https://todo.argonaut-constellation.org/~alcinnz/fontconfig-pure) [Hackage](https://hackage.haskell.org/package/fontconfig-pure)

Pure-functional language bindings to [FontConfig](https://www.freedesktop.org/wiki/Software/fontconfig/). Mostly consists of conversions between common Haskell types & FontConfig's imperative C types.

Queries a database of fonts, both in-memory & on the local filesystem, to find the one most closely matching your desired font-family, style, & size.

## Requirements
* FontConfig 2.13 or greater
* LibStdC++ (for Text dependency)
* Cabal

Cabal can install the rest.

## Use
Please see the Haddock documentation for API usage.

Contains a demo program in `Main.hs`, which can be run via `cabal run`, to query the system font database using standard FontConfig query syntax given in commandline arguments.

There's a tentative expansion with its own testscript which bridges over to Harfbuzz-Pure, & includes a testscript which renders "sphinx of black quartz judge my vow" using the best matching fontfile for your query. This is being held up until a new version of Haskell CSS Syntax is released to Hackage supporting UTF-8 Text.