README.md — sigil-freetype

1# sigil-freetype

3FreeType font loading FFI bindings for [Sigil](https://codeberg.org/sigil/sigil).

5## Features

7- FreeType library initialization and cleanup

8- Font face loading from file paths

9- Character size and pixel size configuration

10- Glyph loading and metrics access

11- Character index lookup

13## Usage

15```scheme

16(import (sigil ffi)

17 (freetype))

19(let* ((lib (ft-init-freetype))

20 (face (ft-new-face lib "/path/to/font.ttf" 0)))

21 (ft-set-pixel-sizes face 0 24)

22 (ft-load-char face 65 FT_LOAD_RENDER)

23 ;; Access glyph metrics...

24 (ft-done-face face)

25 (ft-done-freetype lib))

26```

28## Dependencies

30- sigil-stdlib

31- sigil-ffi

33Requires FreeType system library (`libfreetype`).

35## System Prerequisites

37- [FreeType](https://freetype.org/) (`libfreetype`)

39## Development

41```bash

42sigil deps install

43sigil build

44sigil test

45```

47## License

49BSD-3-Clause