~alcinnz/fontconfig-pure

ref: 16904dd77d2871124e73621de95a56b2df741842 fontconfig-pure/README.md -rw-r--r-- 1.8 KiB
16904dd7 — Adrian Cochrane Bounds-check exceptions to silence erroneous errors. 1 year, 9 months ago
                                                                                
32350eb8 Adrian Cochrane
a16ba32a Adrian Cochrane
32350eb8 Adrian Cochrane
73bb43f1 Adrian Cochrane
32350eb8 Adrian Cochrane
a16ba32a Adrian Cochrane
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# 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. Includes bridges from [Haskell Stylist](https://hackage.haskell.org/package/stylist) and to both FreeType & (soon) Harfbuzz.

## 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.

## Contributing
Please send patches to our [issue tracker](https://todo.argonaut-constellation.org/~alcinnz/fontconfig-pure) by either:

* Attaching the output of `git format-patch`.
* [git send-email](https://git-send-email.io/) to ~alcinnz/fontconfig-pure@todo.argonaut-constellation.org .
* Linking to your fork elsewhere.

Whichever you find most convenient.

If you'd prefer to not make your email address public please contact alcinnz@argonaut-constellation.org !